graphql-http 1.15.0 → 1.16.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

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,13 @@
 import type { Request, Handler } from 'express';
-import { HandlerOptions, OperationContext } from '../handler';
+import { HandlerOptions as RawHandlerOptions, OperationContext } from '../handler';
 /**
- * Create a GraphQL over HTTP Protocol compliant request handler for
+ * Handler options when using the express adapter.
+ *
+ * @category Server/express
+ */
+export type HandlerOptions<Context extends OperationContext = undefined> = RawHandlerOptions<Request, undefined, Context>;
+/**
+ * Create a GraphQL over HTTP spec compliant request handler for
  * the express framework.
  *
  * ```js
@@ -18,4 +24,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,13 @@
 import type { Request, Handler } from 'express';
-import { HandlerOptions, OperationContext } from '../handler';
+import { HandlerOptions as RawHandlerOptions, OperationContext } from '../handler';
 /**
- * Create a GraphQL over HTTP Protocol compliant request handler for
+ * Handler options when using the express adapter.
+ *
+ * @category Server/express
+ */
+export type HandlerOptions<Context extends OperationContext = undefined> = RawHandlerOptions<Request, undefined, Context>;
+/**
+ * Create a GraphQL over HTTP spec compliant request handler for
  * the express framework.
  *
  * ```js
@@ -18,4 +24,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

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

package/lib/use/fastify.d.mts

@@ -1,7 +1,13 @@
 import type { FastifyRequest, RouteHandler } from 'fastify';
-import { HandlerOptions, OperationContext } from '../handler';
+import { HandlerOptions as RawHandlerOptions, OperationContext } from '../handler';
 /**
- * Create a GraphQL over HTTP Protocol compliant request handler for
+ * Handler options when using the fastify adapter.
+ *
+ * @category Server/fastify
+ */
+export type HandlerOptions<Context extends OperationContext = undefined> = RawHandlerOptions<FastifyRequest, undefined, Context>;
+/**
+ * Create a GraphQL over HTTP spec compliant request handler for
  * the fastify framework.
  *
  * ```js
@@ -18,4 +24,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,13 @@
 import type { FastifyRequest, RouteHandler } from 'fastify';
-import { HandlerOptions, OperationContext } from '../handler';
+import { HandlerOptions as RawHandlerOptions, OperationContext } from '../handler';
 /**
- * Create a GraphQL over HTTP Protocol compliant request handler for
+ * Handler options when using the fastify adapter.
+ *
+ * @category Server/fastify
+ */
+export type HandlerOptions<Context extends OperationContext = undefined> = RawHandlerOptions<FastifyRequest, undefined, Context>;
+/**
+ * Create a GraphQL over HTTP spec compliant request handler for
  * the fastify framework.
  *
  * ```js
@@ -18,4 +24,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

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

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,27 @@
+/// <reference types="node" />
+import type { IncomingMessage, ServerResponse } from 'http';
+import { HandlerOptions as RawHandlerOptions, OperationContext } from '../handler';
+/**
+ * Handler options when using the http adapter.
+ *
+ * @category Server/http
+ */
+export type HandlerOptions<Context extends OperationContext = undefined> = RawHandlerOptions<IncomingMessage, undefined, 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,27 @@
+/// <reference types="node" />
+import type { IncomingMessage, ServerResponse } from 'http';
+import { HandlerOptions as RawHandlerOptions, OperationContext } from '../handler';
+/**
+ * Handler options when using the http adapter.
+ *
+ * @category Server/http
+ */
+export type HandlerOptions<Context extends OperationContext = undefined> = RawHandlerOptions<IncomingMessage, undefined, 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.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createHandler = void 0;
+const handler_1 = require("../handler");
+/**
+ * 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
+ */
+function createHandler(options) {
+    const isProd = process.env.NODE_ENV === 'production';
+    const handle = (0, handler_1.createHandler)(options);
+    return async function requestListener(req, res) {
+        try {
+            if (!req.url) {
+                throw new Error('Missing request URL');
+            }
+            if (!req.method) {
+                throw new Error('Missing request method');
+            }
+            const [body, init] = await handle({
+                url: req.url,
+                method: req.method,
+                headers: req.headers,
+                body: () => new Promise((resolve) => {
+                    let body = '';
+                    req.on('data', (chunk) => (body += chunk));
+                    req.on('end', () => resolve(body));
+                }),
+                raw: req,
+                context: undefined,
+            });
+            res.writeHead(init.status, init.statusText, init.headers).end(body);
+        }
+        catch (err) {
+            // The handler shouldnt throw errors.
+            // If you wish to handle them differently, consider implementing your own request handler.
+            console.error('Internal error occurred during request handling. ' +
+                'Please check your implementation.', err);
+            if (isProd) {
+                res.writeHead(500).end();
+            }
+            else {
+                res
+                    .writeHead(500, { 'content-type': 'application/json; charset=utf-8' })
+                    .end(JSON.stringify({
+                    errors: [
+                        err instanceof Error
+                            ? {
+                                message: err.message,
+                                stack: err.stack,
+                            }
+                            : err,
+                    ],
+                }));
+            }
+        }
+    };
+}
+exports.createHandler = createHandler;

package/lib/use/http.mjs

@@ -0,0 +1,68 @@
+import { createHandler as createRawHandler, } from '../handler.mjs';
+/**
+ * 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/index.mjs';
+ *
+ * const server = http.createServer(createHandler({ schema }));
+ *
+ * server.listen(4000);
+ * console.log('Listening to port 4000');
+ * ```
+ *
+ * @category Server/http
+ */
+export function createHandler(options) {
+    const isProd = process.env.NODE_ENV === 'production';
+    const handle = createRawHandler(options);
+    return async function requestListener(req, res) {
+        try {
+            if (!req.url) {
+                throw new Error('Missing request URL');
+            }
+            if (!req.method) {
+                throw new Error('Missing request method');
+            }
+            const [body, init] = await handle({
+                url: req.url,
+                method: req.method,
+                headers: req.headers,
+                body: () => new Promise((resolve) => {
+                    let body = '';
+                    req.on('data', (chunk) => (body += chunk));
+                    req.on('end', () => resolve(body));
+                }),
+                raw: req,
+                context: undefined,
+            });
+            res.writeHead(init.status, init.statusText, init.headers).end(body);
+        }
+        catch (err) {
+            // The handler shouldnt throw errors.
+            // If you wish to handle them differently, consider implementing your own request handler.
+            console.error('Internal error occurred during request handling. ' +
+                'Please check your implementation.', err);
+            if (isProd) {
+                res.writeHead(500).end();
+            }
+            else {
+                res
+                    .writeHead(500, { 'content-type': 'application/json; charset=utf-8' })
+                    .end(JSON.stringify({
+                    errors: [
+                        err instanceof Error
+                            ? {
+                                message: err.message,
+                                stack: err.stack,
+                            }
+                            : err,
+                    ],
+                }));
+            }
+        }
+    };
+}