feat: graphql headers handling, extract http create server from awili…

…x, middleware mocking enabled

docs/14-graphql.md

@@ -0,0 +1,16 @@
+## GraphQL
+
+#### GraphQL headers
+In order to use headers in GraphQl query, once you created GraphQL handler, you can use context param:
+
+for example 
+```
+export const meQuery = async (parent: any, args: any, context: QueryContext) => {
+  const token = ((context as any).req as Request).get("authorization")?.split(" ").at(1); // express Request
+
+  const { result } = await context.queryBus.execute(new MeQuery({ token }));
+  return result;
+};
+```
+
+REMEMBER: req param must be added in ApolloServer context setup

src/app/app.ts

@@ -36,7 +36,8 @@ async function createApp({
   const apolloServer = new ApolloServer({
     typeDefs,
     resolvers,
-    context: () => ({
+    context: ({ req }) => ({
+      req,
       commandBus,
       queryBus,
     }),

src/container.ts

@@ -1,9 +1,6 @@
-import { asFunction, asValue, AwilixContainer, createContainer as createAwilixContainer, InjectionMode } from "awilix";
-import http from "http";
+import { AwilixContainer, createContainer as createAwilixContainer, InjectionMode } from "awilix";
 import { DataSource } from "typeorm";
-import { createApp } from "./app/app";
 import { AppConfig, appConfigFactory } from "./config/app";
-
 import { registerCommonDependencies } from "./container/common";
 import { registerDatabase } from "./container/database";
 import { loadEnvs } from "./config/env";
@@ -37,15 +34,5 @@ export async function createContainer(dependencies?: ContainerDependencies): Pro
   await registerSubscribers(container);
   await registerDatabase(container, dependencies);
 
-  container.register({
-    app: asFunction(createApp).singleton(),
-  });
-
-  const { app } = container.cradle;
-
-  container.register({
-    server: asValue(http.createServer(await app)),
-  });
-
   return container;
-}
+}

src/container/common.ts

@@ -6,6 +6,7 @@ import { createLogger, restrictFromProduction } from "@tshio/logger";
 import { AppConfig } from "../config/app";
 import { cacheClient } from "../tools/cache-client";
 import { createRouter } from "../app/router";
+import { createApp } from "../app/app";
 
 export async function registerCommonDependencies(appConfig: AppConfig, container: AwilixContainer) {
   await cacheClient.connect();
@@ -23,6 +24,7 @@ export async function registerCommonDependencies(appConfig: AppConfig, container
       .classic()
       .singleton()
       .inject(() => ({ throwOnFailure: false })),
+    app: asFunction(createApp).singleton(),
   });
 
   return container;

src/index.ts

@@ -1,4 +1,5 @@
 import "express-async-errors";
+import http from "http";
 import { createContainer } from "./container";
 
 (async () => {
@@ -15,7 +16,9 @@ import { createContainer } from "./container";
     process.exit(1);
   });
 
-  const { server, port } = container.cradle;
-  server.listen(port);
+  const { port, app } = container.cradle;
+
+  http.createServer(await app).listen(port);
+
   container.cradle.logger.info(`listening on port: ${port}`);
 })();