graphql-http 1.15.0 → 1.17.0

package/README.md

@@ -55,7 +55,7 @@ const schema = new GraphQLSchema({
 
 ```js
 import http from 'http';
-import { createHandler } from 'graphql-http/lib/use/node';
+import { createHandler } from 'graphql-http/lib/use/http';
 import { schema } from './previous-step';
 
 // Create the GraphQL over HTTP Node request handler
@@ -86,7 +86,7 @@ $ openssl req -x509 -newkey rsa:2048 -nodes -sha256 -subj '/CN=localhost' \
 ```js
 import fs from 'fs';
 import http2 from 'http2';
-import { createHandler } from 'graphql-http/lib/use/node';
+import { createHandler } from 'graphql-http/lib/use/http2';
 import { schema } from './previous-step';
 
 // Create the GraphQL over HTTP Node request handler
@@ -736,6 +736,36 @@ for (const audit of serverAudits({
 
 </details>
 
+<details id="audit-deno">
+<summary><a href="#audit-deno">🔗</a> Audit for servers usage in <a href="https://deno.land">Deno</a> environment</summary>
+
+```ts
+import { serverAudits } from 'npm:graphql-http';
+
+for (const audit of serverAudits({
+  url: 'http://localhost:4000/graphql',
+  fetchFn: fetch,
+})) {
+  Deno.test(audit.name, async () => {
+    const result = await audit.fn();
+    if (result.status === 'error') {
+      throw result.reason;
+    }
+    if (result.status === 'warn') {
+      console.warn(result.reason); // or throw if you want full compliance (warnings are not requirements)
+    }
+    // Avoid leaking resources
+    if ('body' in result && result.body instanceof ReadableStream) {
+      await result.body.cancel();
+    }
+  });
+}
+```
+
+Put the above contents in a file and run it with `deno test --allow-net`.
+
+</details>
+
 ## Only [GraphQL over HTTP](https://graphql.github.io/graphql-over-http/)
 
 This is the official [GraphQL over HTTP spec](https://graphql.github.io/graphql-over-http/) reference implementation and as such follows the specification strictly without any additional features (like file uploads, @stream/@defer directives and subscriptions).
@@ -744,7 +774,9 @@ Having said this, graphql-http is mostly aimed for library authors and simple se
 
 ## [Servers](/implementations)
 
-If you want a feature-full server with bleeding edge technologies, you're recommended to use one of the following.
+If you want a feature-full server with bleeding edge technologies, you're recommended to use one of the following servers.
+
+Their compliance with the [GraphQL over HTTP spec](https://graphql.github.io/graphql-over-http) is checked automatically and updated regularly.
 
 <!-- <ServersTable> -->
 <!-- prettier-ignore-start -->
@@ -768,16 +800,11 @@ Check the [docs folder](docs/) out for [TypeDoc](https://typedoc.org) generated
 
 ## [Audits](implementations/)
 
-Inspect audits of other implementations in the [implementations folder](implementations/). Adding your implementation is very welcome!
+Inspect audits of other implementations in the [implementations folder](implementations).
+Adding your implementation is very welcome, [see how](CONTRIBUTING.md#adding-implementations)!
 
 ## Want to help?
 
-File a bug, contribute with code, or improve documentation? Read up on our guidelines below and drive development with `yarn test --watch` away!
-
-This repository is managed by EasyCLA. Project participants must sign the free [GraphQL Specification Membership agreement](https://preview-spec-membership.graphql.org) before making a contribution. You only need to do this one time, and it can be signed by [individual contributors](http://individual-spec-membership.graphql.org/) or their [employers](http://corporate-spec-membership.graphql.org/).
-
-To initiate the signature process please open a PR against this repo. The EasyCLA bot will block the merge if we still need a membership agreement from you.
-
-You can find [detailed information here](https://github.com/graphql/graphql-wg/tree/main/membership). If you have issues, please email [operations@graphql.org](mailto:operations@graphql.org).
+File a bug, contribute with code, or improve documentation? [Read more in CONTRIBUTING.md](CONTRIBUTING.md).
 
 If your company benefits from GraphQL and you would like to provide essential financial support for the systems and people that power our community, please also consider membership in the [GraphQL Foundation](https://foundation.graphql.org/join).

package/lib/audits/utils.js

@@ -114,22 +114,25 @@ function ressert(res) {
         bodyAsExecutionResult: {
             data: {
                 async toBe(val) {
+                    const clonedRes = res.clone(); // allow the body to be re-read
                     const body = await assertBodyAsExecutionResult(res);
                     if (body.data !== val) {
-                        throw new AuditError(res, `Response body execution result data is not "${val}"`);
+                        throw new AuditError(clonedRes, `Response body execution result data is not "${val}"`);
                     }
                 },
             },
             async toHaveProperty(key) {
+                const clonedRes = res.clone(); // allow the body to be re-read
                 const body = await assertBodyAsExecutionResult(res);
                 if (!(key in body)) {
-                    throw new AuditError(res, `Response body execution result does not have a property "${key}"`);
+                    throw new AuditError(clonedRes, `Response body execution result does not have a property "${key}"`);
                 }
             },
             async notToHaveProperty(key) {
+                const clonedRes = res.clone(); // allow the body to be re-read
                 const body = await assertBodyAsExecutionResult(res);
                 if (key in body) {
-                    throw new AuditError(res, `Response body execution result has a property "${key}"`);
+                    throw new AuditError(clonedRes, `Response body execution result has a property "${key}"`);
                 }
             },
         },

package/lib/audits/utils.mjs

@@ -95,22 +95,25 @@ export function ressert(res) {
         bodyAsExecutionResult: {
             data: {
                 async toBe(val) {
+                    const clonedRes = res.clone(); // allow the body to be re-read
                     const body = await assertBodyAsExecutionResult(res);
                     if (body.data !== val) {
-                        throw new AuditError(res, `Response body execution result data is not "${val}"`);
+                        throw new AuditError(clonedRes, `Response body execution result data is not "${val}"`);
                     }
                 },
             },
             async toHaveProperty(key) {
+                const clonedRes = res.clone(); // allow the body to be re-read
                 const body = await assertBodyAsExecutionResult(res);
                 if (!(key in body)) {
-                    throw new AuditError(res, `Response body execution result does not have a property "${key}"`);
+                    throw new AuditError(clonedRes, `Response body execution result does not have a property "${key}"`);
                 }
             },
             async notToHaveProperty(key) {
+                const clonedRes = res.clone(); // allow the body to be re-read
                 const body = await assertBodyAsExecutionResult(res);
                 if (key in body) {
-                    throw new AuditError(res, `Response body execution result has a property "${key}"`);
+                    throw new AuditError(clonedRes, `Response body execution result has a property "${key}"`);
                 }
             },
         },

package/lib/handler.d.mts

@@ -228,7 +228,7 @@ export interface HandlerOptions<RequestRaw = unknown, RequestContext = unknown,
  */
 export type Handler<RequestRaw = unknown, RequestContext = unknown> = (req: Request<RequestRaw, RequestContext>) => Promise<Response>;
 /**
- * Makes a GraphQL over HTTP Protocol compliant server handler. The handler can
+ * Makes a GraphQL over HTTP spec compliant server handler. The handler can
  * be used with your favourite server library.
  *
  * Beware that the handler resolves only after the whole operation completes.
@@ -291,7 +291,7 @@ export declare function createHandler<RequestRaw = unknown, RequestContext = unk
 export type AcceptableMediaType = 'application/graphql-response+json' | 'application/json';
 /**
  * Inspects the request and detects the appropriate/acceptable Media-Type
- * looking at the `Accept` header while complying with the GraphQL over HTTP Protocol.
+ * looking at the `Accept` header while complying with the GraphQL over HTTP spec.
  *
  * @category Server
  */
@@ -302,7 +302,7 @@ export declare function getAcceptableMediaType(acceptHeader: string | null | und
  * If the first argument is an `ExecutionResult`, the operation will be treated as "successful".
  *
  * If the first argument is _any_ object without the `data` field, it will be treated as an error (as per the spec)
- * and the response will be constructed with the help of `acceptedMediaType` complying with the GraphQL over HTTP Protocol.
+ * and the response will be constructed with the help of `acceptedMediaType` complying with the GraphQL over HTTP spec.
  *
  * @category Server
  */

package/lib/handler.d.ts

@@ -228,7 +228,7 @@ export interface HandlerOptions<RequestRaw = unknown, RequestContext = unknown,
  */
 export type Handler<RequestRaw = unknown, RequestContext = unknown> = (req: Request<RequestRaw, RequestContext>) => Promise<Response>;
 /**
- * Makes a GraphQL over HTTP Protocol compliant server handler. The handler can
+ * Makes a GraphQL over HTTP spec compliant server handler. The handler can
  * be used with your favourite server library.
  *
  * Beware that the handler resolves only after the whole operation completes.
@@ -291,7 +291,7 @@ export declare function createHandler<RequestRaw = unknown, RequestContext = unk
 export type AcceptableMediaType = 'application/graphql-response+json' | 'application/json';
 /**
  * Inspects the request and detects the appropriate/acceptable Media-Type
- * looking at the `Accept` header while complying with the GraphQL over HTTP Protocol.
+ * looking at the `Accept` header while complying with the GraphQL over HTTP spec.
  *
  * @category Server
  */
@@ -302,7 +302,7 @@ export declare function getAcceptableMediaType(acceptHeader: string | null | und
  * If the first argument is an `ExecutionResult`, the operation will be treated as "successful".
  *
  * If the first argument is _any_ object without the `data` field, it will be treated as an error (as per the spec)
- * and the response will be constructed with the help of `acceptedMediaType` complying with the GraphQL over HTTP Protocol.
+ * and the response will be constructed with the help of `acceptedMediaType` complying with the GraphQL over HTTP spec.
  *
  * @category Server
  */

package/lib/handler.js

@@ -21,7 +21,7 @@ function isResponse(val) {
 }
 exports.isResponse = isResponse;
 /**
- * Makes a GraphQL over HTTP Protocol compliant server handler. The handler can
+ * Makes a GraphQL over HTTP spec compliant server handler. The handler can
  * be used with your favourite server library.
  *
  * Beware that the handler resolves only after the whole operation completes.
@@ -291,7 +291,7 @@ function createHandler(options) {
 exports.createHandler = createHandler;
 /**
  * Inspects the request and detects the appropriate/acceptable Media-Type
- * looking at the `Accept` header while complying with the GraphQL over HTTP Protocol.
+ * looking at the `Accept` header while complying with the GraphQL over HTTP spec.
  *
  * @category Server
  */
@@ -328,7 +328,7 @@ exports.getAcceptableMediaType = getAcceptableMediaType;
  * If the first argument is an `ExecutionResult`, the operation will be treated as "successful".
  *
  * If the first argument is _any_ object without the `data` field, it will be treated as an error (as per the spec)
- * and the response will be constructed with the help of `acceptedMediaType` complying with the GraphQL over HTTP Protocol.
+ * and the response will be constructed with the help of `acceptedMediaType` complying with the GraphQL over HTTP spec.
  *
  * @category Server
  */

package/lib/handler.mjs

@@ -17,7 +17,7 @@ export function isResponse(val) {
         isObject(val[1]));
 }
 /**
- * Makes a GraphQL over HTTP Protocol compliant server handler. The handler can
+ * Makes a GraphQL over HTTP spec compliant server handler. The handler can
  * be used with your favourite server library.
  *
  * Beware that the handler resolves only after the whole operation completes.
@@ -286,7 +286,7 @@ export function createHandler(options) {
 }
 /**
  * Inspects the request and detects the appropriate/acceptable Media-Type
- * looking at the `Accept` header while complying with the GraphQL over HTTP Protocol.
+ * looking at the `Accept` header while complying with the GraphQL over HTTP spec.
  *
  * @category Server
  */
@@ -322,7 +322,7 @@ export function getAcceptableMediaType(acceptHeader) {
  * If the first argument is an `ExecutionResult`, the operation will be treated as "successful".
  *
  * If the first argument is _any_ object without the `data` field, it will be treated as an error (as per the spec)
- * and the response will be constructed with the help of `acceptedMediaType` complying with the GraphQL over HTTP Protocol.
+ * and the response will be constructed with the help of `acceptedMediaType` complying with the GraphQL over HTTP spec.
  *
  * @category Server
  */

package/lib/use/express.d.mts

@@ -1,7 +1,21 @@
-import type { Request, Handler } from 'express';
-import { HandlerOptions, OperationContext } from '../handler';
+import type { Request, Response, Handler } from 'express';
+import { HandlerOptions as RawHandlerOptions, OperationContext } from '../handler';
 /**
- * Create a GraphQL over HTTP Protocol compliant request handler for
+ * The context in the request for the handler.
+ *
+ * @category Server/express
+ */
+export interface RequestContext {
+    res: Response;
+}
+/**
+ * Handler options when using the express adapter.
+ *
+ * @category Server/express
+ */
+export type HandlerOptions<Context extends OperationContext = undefined> = RawHandlerOptions<Request, RequestContext, Context>;
+/**
+ * Create a GraphQL over HTTP spec compliant request handler for
  * the express framework.
  *
  * ```js
@@ -18,4 +32,4 @@ import { HandlerOptions, OperationContext } from '../handler';
  *
  * @category Server/express
  */
-export declare function createHandler<Context extends OperationContext = undefined>(options: HandlerOptions<Request, undefined, Context>): Handler;
+export declare function createHandler<Context extends OperationContext = undefined>(options: HandlerOptions<Context>): Handler;

package/lib/use/express.d.ts

@@ -1,7 +1,21 @@
-import type { Request, Handler } from 'express';
-import { HandlerOptions, OperationContext } from '../handler';
+import type { Request, Response, Handler } from 'express';
+import { HandlerOptions as RawHandlerOptions, OperationContext } from '../handler';
 /**
- * Create a GraphQL over HTTP Protocol compliant request handler for
+ * The context in the request for the handler.
+ *
+ * @category Server/express
+ */
+export interface RequestContext {
+    res: Response;
+}
+/**
+ * Handler options when using the express adapter.
+ *
+ * @category Server/express
+ */
+export type HandlerOptions<Context extends OperationContext = undefined> = RawHandlerOptions<Request, RequestContext, Context>;
+/**
+ * Create a GraphQL over HTTP spec compliant request handler for
  * the express framework.
  *
  * ```js
@@ -18,4 +32,4 @@ import { HandlerOptions, OperationContext } from '../handler';
  *
  * @category Server/express
  */
-export declare function createHandler<Context extends OperationContext = undefined>(options: HandlerOptions<Request, undefined, Context>): Handler;
+export declare function createHandler<Context extends OperationContext = undefined>(options: HandlerOptions<Context>): Handler;

package/lib/use/express.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createHandler = void 0;
 const handler_1 = require("../handler");
 /**
- * Create a GraphQL over HTTP Protocol compliant request handler for
+ * Create a GraphQL over HTTP spec compliant request handler for
  * the express framework.
  *
  * ```js
@@ -41,7 +41,7 @@ function createHandler(options) {
                     });
                 },
                 raw: req,
-                context: undefined,
+                context: { res },
             });
             res.writeHead(init.status, init.statusText, init.headers).end(body);
         }

package/lib/use/express.mjs

@@ -1,6 +1,6 @@
 import { createHandler as createRawHandler, } from '../handler.mjs';
 /**
- * Create a GraphQL over HTTP Protocol compliant request handler for
+ * Create a GraphQL over HTTP spec compliant request handler for
  * the express framework.
  *
  * ```js
@@ -38,7 +38,7 @@ export function createHandler(options) {
                     });
                 },
                 raw: req,
-                context: undefined,
+                context: { res },
             });
             res.writeHead(init.status, init.statusText, init.headers).end(body);
         }

package/lib/use/fastify.d.mts

@@ -1,7 +1,21 @@
-import type { FastifyRequest, RouteHandler } from 'fastify';
-import { HandlerOptions, OperationContext } from '../handler';
+import type { FastifyRequest, FastifyReply, RouteHandler } from 'fastify';
+import { HandlerOptions as RawHandlerOptions, OperationContext } from '../handler';
 /**
- * Create a GraphQL over HTTP Protocol compliant request handler for
+ * The context in the request for the handler.
+ *
+ * @category Server/fastify
+ */
+export interface RequestContext {
+    reply: FastifyReply;
+}
+/**
+ * Handler options when using the fastify adapter.
+ *
+ * @category Server/fastify
+ */
+export type HandlerOptions<Context extends OperationContext = undefined> = RawHandlerOptions<FastifyRequest, RequestContext, Context>;
+/**
+ * Create a GraphQL over HTTP spec compliant request handler for
  * the fastify framework.
  *
  * ```js
@@ -18,4 +32,4 @@ import { HandlerOptions, OperationContext } from '../handler';
  *
  * @category Server/fastify
  */
-export declare function createHandler<Context extends OperationContext = undefined>(options: HandlerOptions<FastifyRequest, undefined, Context>): RouteHandler;
+export declare function createHandler<Context extends OperationContext = undefined>(options: HandlerOptions<Context>): RouteHandler;

package/lib/use/fastify.d.ts

@@ -1,7 +1,21 @@
-import type { FastifyRequest, RouteHandler } from 'fastify';
-import { HandlerOptions, OperationContext } from '../handler';
+import type { FastifyRequest, FastifyReply, RouteHandler } from 'fastify';
+import { HandlerOptions as RawHandlerOptions, OperationContext } from '../handler';
 /**
- * Create a GraphQL over HTTP Protocol compliant request handler for
+ * The context in the request for the handler.
+ *
+ * @category Server/fastify
+ */
+export interface RequestContext {
+    reply: FastifyReply;
+}
+/**
+ * Handler options when using the fastify adapter.
+ *
+ * @category Server/fastify
+ */
+export type HandlerOptions<Context extends OperationContext = undefined> = RawHandlerOptions<FastifyRequest, RequestContext, Context>;
+/**
+ * Create a GraphQL over HTTP spec compliant request handler for
  * the fastify framework.
  *
  * ```js
@@ -18,4 +32,4 @@ import { HandlerOptions, OperationContext } from '../handler';
  *
  * @category Server/fastify
  */
-export declare function createHandler<Context extends OperationContext = undefined>(options: HandlerOptions<FastifyRequest, undefined, Context>): RouteHandler;
+export declare function createHandler<Context extends OperationContext = undefined>(options: HandlerOptions<Context>): RouteHandler;

package/lib/use/fastify.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createHandler = void 0;
 const handler_1 = require("../handler");
 /**
- * Create a GraphQL over HTTP Protocol compliant request handler for
+ * Create a GraphQL over HTTP spec compliant request handler for
  * the fastify framework.
  *
  * ```js
@@ -32,7 +32,7 @@ function createHandler(options) {
                 // eslint-disable-next-line @typescript-eslint/no-explicit-any
                 body: req.body,
                 raw: req,
-                context: undefined,
+                context: { reply },
             });
             reply
                 .status(init.status)

package/lib/use/fastify.mjs

@@ -1,6 +1,6 @@
 import { createHandler as createRawHandler, } from '../handler.mjs';
 /**
- * Create a GraphQL over HTTP Protocol compliant request handler for
+ * Create a GraphQL over HTTP spec compliant request handler for
  * the fastify framework.
  *
  * ```js
@@ -29,7 +29,7 @@ export function createHandler(options) {
                 // eslint-disable-next-line @typescript-eslint/no-explicit-any
                 body: req.body,
                 raw: req,
-                context: undefined,
+                context: { reply },
             });
             reply
                 .status(init.status)

package/lib/use/fetch.d.mts

@@ -1,4 +1,4 @@
-import { HandlerOptions, OperationContext } from '../handler';
+import { HandlerOptions as RawHandlerOptions, OperationContext } from '../handler';
 /**
  * The necessary API from the fetch environment for the handler.
  *
@@ -10,7 +10,13 @@ export interface FetchAPI {
     TextEncoder: typeof TextEncoder;
 }
 /**
- * Create a GraphQL over HTTP Protocol compliant request handler for
+ * Handler options when using the fetch adapter.
+ *
+ * @category Server/fetch
+ */
+export type HandlerOptions<Context extends OperationContext = undefined> = RawHandlerOptions<Request, FetchAPI, Context>;
+/**
+ * Create a GraphQL over HTTP spec compliant request handler for
  * a fetch environment like Deno, Bun, CloudFlare Workers, Lambdas, etc.
  *
  * You can use [@whatwg-node/server](https://github.com/ardatan/whatwg-node/tree/master/packages/server) to create a server adapter and
@@ -33,8 +39,8 @@ export interface FetchAPI {
  * console.log('Listening to port 4000');
  * ```
  *
- * @param fetchApi - Custom fetch API engine, will use from global scope if left undefined.
+ * @param reqCtx - Custom fetch API engine, will use from global scope if left undefined.
  *
  * @category Server/fetch
  */
-export declare function createHandler<Context extends OperationContext = undefined>(options: HandlerOptions<Request, FetchAPI, Context>, fetchApi?: Partial<FetchAPI>): (req: Request) => Promise<Response>;
+export declare function createHandler<Context extends OperationContext = undefined>(options: HandlerOptions<Context>, reqCtx?: Partial<FetchAPI>): (req: Request) => Promise<Response>;

package/lib/use/fetch.d.ts

@@ -1,4 +1,4 @@
-import { HandlerOptions, OperationContext } from '../handler';
+import { HandlerOptions as RawHandlerOptions, OperationContext } from '../handler';
 /**
  * The necessary API from the fetch environment for the handler.
  *
@@ -10,7 +10,13 @@ export interface FetchAPI {
     TextEncoder: typeof TextEncoder;
 }
 /**
- * Create a GraphQL over HTTP Protocol compliant request handler for
+ * Handler options when using the fetch adapter.
+ *
+ * @category Server/fetch
+ */
+export type HandlerOptions<Context extends OperationContext = undefined> = RawHandlerOptions<Request, FetchAPI, Context>;
+/**
+ * Create a GraphQL over HTTP spec compliant request handler for
  * a fetch environment like Deno, Bun, CloudFlare Workers, Lambdas, etc.
  *
  * You can use [@whatwg-node/server](https://github.com/ardatan/whatwg-node/tree/master/packages/server) to create a server adapter and
@@ -33,8 +39,8 @@ export interface FetchAPI {
  * console.log('Listening to port 4000');
  * ```
  *
- * @param fetchApi - Custom fetch API engine, will use from global scope if left undefined.
+ * @param reqCtx - Custom fetch API engine, will use from global scope if left undefined.
  *
  * @category Server/fetch
  */
-export declare function createHandler<Context extends OperationContext = undefined>(options: HandlerOptions<Request, FetchAPI, Context>, fetchApi?: Partial<FetchAPI>): (req: Request) => Promise<Response>;
+export declare function createHandler<Context extends OperationContext = undefined>(options: HandlerOptions<Context>, reqCtx?: Partial<FetchAPI>): (req: Request) => Promise<Response>;

package/lib/use/fetch.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createHandler = void 0;
 const handler_1 = require("../handler");
 /**
- * Create a GraphQL over HTTP Protocol compliant request handler for
+ * Create a GraphQL over HTTP spec compliant request handler for
  * a fetch environment like Deno, Bun, CloudFlare Workers, Lambdas, etc.
  *
  * You can use [@whatwg-node/server](https://github.com/ardatan/whatwg-node/tree/master/packages/server) to create a server adapter and
@@ -26,16 +26,16 @@ const handler_1 = require("../handler");
  * console.log('Listening to port 4000');
  * ```
  *
- * @param fetchApi - Custom fetch API engine, will use from global scope if left undefined.
+ * @param reqCtx - Custom fetch API engine, will use from global scope if left undefined.
  *
  * @category Server/fetch
  */
-function createHandler(options, fetchApi = {}) {
+function createHandler(options, reqCtx = {}) {
     const isProd = process.env.NODE_ENV === 'production';
     const api = {
-        Response: fetchApi.Response || Response,
-        TextEncoder: fetchApi.TextEncoder || TextEncoder,
-        ReadableStream: fetchApi.ReadableStream || ReadableStream,
+        Response: reqCtx.Response || Response,
+        TextEncoder: reqCtx.TextEncoder || TextEncoder,
+        ReadableStream: reqCtx.ReadableStream || ReadableStream,
     };
     const handler = (0, handler_1.createHandler)(options);
     return async function handleRequest(req) {

package/lib/use/fetch.mjs

@@ -1,6 +1,6 @@
 import { createHandler as createRawHandler, } from '../handler.mjs';
 /**
- * Create a GraphQL over HTTP Protocol compliant request handler for
+ * Create a GraphQL over HTTP spec compliant request handler for
  * a fetch environment like Deno, Bun, CloudFlare Workers, Lambdas, etc.
  *
  * You can use [@whatwg-node/server](https://github.com/ardatan/whatwg-node/tree/master/packages/server) to create a server adapter and
@@ -23,16 +23,16 @@ import { createHandler as createRawHandler, } from '../handler.mjs';
  * console.log('Listening to port 4000');
  * ```
  *
- * @param fetchApi - Custom fetch API engine, will use from global scope if left undefined.
+ * @param reqCtx - Custom fetch API engine, will use from global scope if left undefined.
  *
  * @category Server/fetch
  */
-export function createHandler(options, fetchApi = {}) {
+export function createHandler(options, reqCtx = {}) {
     const isProd = process.env.NODE_ENV === 'production';
     const api = {
-        Response: fetchApi.Response || Response,
-        TextEncoder: fetchApi.TextEncoder || TextEncoder,
-        ReadableStream: fetchApi.ReadableStream || ReadableStream,
+        Response: reqCtx.Response || Response,
+        TextEncoder: reqCtx.TextEncoder || TextEncoder,
+        ReadableStream: reqCtx.ReadableStream || ReadableStream,
     };
     const handler = createRawHandler(options);
     return async function handleRequest(req) {

package/lib/use/http.d.mts

@@ -0,0 +1,35 @@
+/// <reference types="node" />
+import type { IncomingMessage, ServerResponse } from 'http';
+import { HandlerOptions as RawHandlerOptions, OperationContext } from '../handler';
+/**
+ * The context in the request for the handler.
+ *
+ * @category Server/http
+ */
+export interface RequestContext {
+    res: ServerResponse;
+}
+/**
+ * Handler options when using the http adapter.
+ *
+ * @category Server/http
+ */
+export type HandlerOptions<Context extends OperationContext = undefined> = RawHandlerOptions<IncomingMessage, RequestContext, Context>;
+/**
+ * Create a GraphQL over HTTP spec compliant request handler for
+ * the Node environment http module.
+ *
+ * ```js
+ * import http from 'http';
+ * import { createHandler } from 'graphql-http/lib/use/http';
+ * import { schema } from './my-graphql-step';
+ *
+ * const server = http.createServer(createHandler({ schema }));
+ *
+ * server.listen(4000);
+ * console.log('Listening to port 4000');
+ * ```
+ *
+ * @category Server/http
+ */
+export declare function createHandler<Context extends OperationContext = undefined>(options: HandlerOptions<Context>): (req: IncomingMessage, res: ServerResponse) => Promise<void>;

package/lib/use/http.d.ts

@@ -0,0 +1,35 @@
+/// <reference types="node" />
+import type { IncomingMessage, ServerResponse } from 'http';
+import { HandlerOptions as RawHandlerOptions, OperationContext } from '../handler';
+/**
+ * The context in the request for the handler.
+ *
+ * @category Server/http
+ */
+export interface RequestContext {
+    res: ServerResponse;
+}
+/**
+ * Handler options when using the http adapter.
+ *
+ * @category Server/http
+ */
+export type HandlerOptions<Context extends OperationContext = undefined> = RawHandlerOptions<IncomingMessage, RequestContext, Context>;
+/**
+ * Create a GraphQL over HTTP spec compliant request handler for
+ * the Node environment http module.
+ *
+ * ```js
+ * import http from 'http';
+ * import { createHandler } from 'graphql-http/lib/use/http';
+ * import { schema } from './my-graphql-step';
+ *
+ * const server = http.createServer(createHandler({ schema }));
+ *
+ * server.listen(4000);
+ * console.log('Listening to port 4000');
+ * ```
+ *
+ * @category Server/http
+ */
+export declare function createHandler<Context extends OperationContext = undefined>(options: HandlerOptions<Context>): (req: IncomingMessage, res: ServerResponse) => Promise<void>;