graphql-http 1.6.1 → 1.7.1

package/lib/use/fetch.d.mts

@@ -0,0 +1,40 @@
+import { HandlerOptions, OperationContext } from '../handler';
+/**
+ * The necessary API from the fetch environment for the handler.
+ *
+ * @category Server/fetch
+ */
+export interface FetchAPI {
+    Response: typeof Response;
+    ReadableStream: typeof ReadableStream;
+    TextEncoder: typeof TextEncoder;
+}
+/**
+ * Create a GraphQL over HTTP Protocol 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
+ * isomorphically use it in _any_ environment. See an example:
+ *
+ * ```js
+ * import http from 'http';
+ * import { createServerAdapter } from '@whatwg-node/server'; // yarn add @whatwg-node/server
+ * import { createHandler } from 'graphql-http/lib/use/fetch';
+ * import { schema } from './my-graphql-step';
+ *
+ * // Use this adapter in _any_ environment.
+ * const adapter = createServerAdapter({
+ *   handleRequest: createHandler({ schema }),
+ * });
+ *
+ * const server = http.createServer(adapter);
+ *
+ * server.listen(4000);
+ * console.log('Listening to port 4000');
+ * ```
+ *
+ * @param fetchApi - 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>;

package/lib/use/fetch.d.ts

@@ -0,0 +1,40 @@
+import { HandlerOptions, OperationContext } from '../handler';
+/**
+ * The necessary API from the fetch environment for the handler.
+ *
+ * @category Server/fetch
+ */
+export interface FetchAPI {
+    Response: typeof Response;
+    ReadableStream: typeof ReadableStream;
+    TextEncoder: typeof TextEncoder;
+}
+/**
+ * Create a GraphQL over HTTP Protocol 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
+ * isomorphically use it in _any_ environment. See an example:
+ *
+ * ```js
+ * import http from 'http';
+ * import { createServerAdapter } from '@whatwg-node/server'; // yarn add @whatwg-node/server
+ * import { createHandler } from 'graphql-http/lib/use/fetch';
+ * import { schema } from './my-graphql-step';
+ *
+ * // Use this adapter in _any_ environment.
+ * const adapter = createServerAdapter({
+ *   handleRequest: createHandler({ schema }),
+ * });
+ *
+ * const server = http.createServer(adapter);
+ *
+ * server.listen(4000);
+ * console.log('Listening to port 4000');
+ * ```
+ *
+ * @param fetchApi - 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>;

package/lib/use/fetch.js

@@ -0,0 +1,81 @@
+"use strict";
+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
+ * 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
+ * isomorphically use it in _any_ environment. See an example:
+ *
+ * ```js
+ * import http from 'http';
+ * import { createServerAdapter } from '@whatwg-node/server'; // yarn add @whatwg-node/server
+ * import { createHandler } from 'graphql-http/lib/use/fetch';
+ * import { schema } from './my-graphql-step';
+ *
+ * // Use this adapter in _any_ environment.
+ * const adapter = createServerAdapter({
+ *   handleRequest: createHandler({ schema }),
+ * });
+ *
+ * const server = http.createServer(adapter);
+ *
+ * server.listen(4000);
+ * console.log('Listening to port 4000');
+ * ```
+ *
+ * @param fetchApi - Custom fetch API engine, will use from global scope if left undefined.
+ *
+ * @category Server/fetch
+ */
+function createHandler(options, fetchApi = {}) {
+    const isProd = process.env.NODE_ENV === 'production';
+    const api = {
+        Response: fetchApi.Response || Response,
+        TextEncoder: fetchApi.TextEncoder || TextEncoder,
+        ReadableStream: fetchApi.ReadableStream || ReadableStream,
+    };
+    const handler = (0, handler_1.createHandler)(options);
+    return async function handleRequest(req) {
+        try {
+            const [body, init] = await handler({
+                method: req.method,
+                url: req.url,
+                headers: req.headers,
+                body: () => req.text(),
+                raw: req,
+                context: api,
+            });
+            return new api.Response(body, init);
+        }
+        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) {
+                return new api.Response(null, { status: 500 });
+            }
+            else {
+                return new api.Response(JSON.stringify({
+                    errors: [
+                        err instanceof Error
+                            ? {
+                                message: err.message,
+                                stack: err.stack,
+                            }
+                            : err,
+                    ],
+                }), {
+                    status: 500,
+                    headers: {
+                        'content-type': 'application/json; charset=utf-8',
+                    },
+                });
+            }
+        }
+    };
+}
+exports.createHandler = createHandler;

package/lib/use/fetch.mjs

@@ -0,0 +1,77 @@
+import { createHandler as createRawHandler, } from '../handler.mjs';
+/**
+ * Create a GraphQL over HTTP Protocol 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
+ * isomorphically use it in _any_ environment. See an example:
+ *
+ * ```js
+ * import http from 'http';
+ * import { createServerAdapter } from '@whatwg-node/server'; // yarn add @whatwg-node/server
+ * import { createHandler } from 'graphql-http/lib/use/fetch';
+ * import { schema } from './my-graphql-step/index.mjs';
+ *
+ * // Use this adapter in _any_ environment.
+ * const adapter = createServerAdapter({
+ *   handleRequest: createHandler({ schema }),
+ * });
+ *
+ * const server = http.createServer(adapter);
+ *
+ * server.listen(4000);
+ * console.log('Listening to port 4000');
+ * ```
+ *
+ * @param fetchApi - Custom fetch API engine, will use from global scope if left undefined.
+ *
+ * @category Server/fetch
+ */
+export function createHandler(options, fetchApi = {}) {
+    const isProd = process.env.NODE_ENV === 'production';
+    const api = {
+        Response: fetchApi.Response || Response,
+        TextEncoder: fetchApi.TextEncoder || TextEncoder,
+        ReadableStream: fetchApi.ReadableStream || ReadableStream,
+    };
+    const handler = createRawHandler(options);
+    return async function handleRequest(req) {
+        try {
+            const [body, init] = await handler({
+                method: req.method,
+                url: req.url,
+                headers: req.headers,
+                body: () => req.text(),
+                raw: req,
+                context: api,
+            });
+            return new api.Response(body, init);
+        }
+        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) {
+                return new api.Response(null, { status: 500 });
+            }
+            else {
+                return new api.Response(JSON.stringify({
+                    errors: [
+                        err instanceof Error
+                            ? {
+                                message: err.message,
+                                stack: err.stack,
+                            }
+                            : err,
+                    ],
+                }), {
+                    status: 500,
+                    headers: {
+                        'content-type': 'application/json; charset=utf-8',
+                    },
+                });
+            }
+        }
+    };
+}

package/lib/use/node.d.mts

@@ -0,0 +1,21 @@
+/// <reference types="node" />
+import type { IncomingMessage, RequestListener } from 'http';
+import { HandlerOptions, OperationContext } from '../handler';
+/**
+ * Create a GraphQL over HTTP Protocol compliant request handler for
+ * the Node environment.
+ *
+ * ```js
+ * import http from 'http';
+ * import { createHandler } from 'graphql-http/lib/use/node';
+ * import { schema } from './my-graphql-step';
+ *
+ * const server = http.createServer(createHandler({ schema }));
+ *
+ * server.listen(4000);
+ * console.log('Listening to port 4000');
+ * ```
+ *
+ * @category Server/node
+ */
+export declare function createHandler<Context extends OperationContext = undefined>(options: HandlerOptions<IncomingMessage, undefined, Context>): RequestListener;

package/lib/use/node.d.ts

@@ -0,0 +1,21 @@
+/// <reference types="node" />
+import type { IncomingMessage, RequestListener } from 'http';
+import { HandlerOptions, OperationContext } from '../handler';
+/**
+ * Create a GraphQL over HTTP Protocol compliant request handler for
+ * the Node environment.
+ *
+ * ```js
+ * import http from 'http';
+ * import { createHandler } from 'graphql-http/lib/use/node';
+ * import { schema } from './my-graphql-step';
+ *
+ * const server = http.createServer(createHandler({ schema }));
+ *
+ * server.listen(4000);
+ * console.log('Listening to port 4000');
+ * ```
+ *
+ * @category Server/node
+ */
+export declare function createHandler<Context extends OperationContext = undefined>(options: HandlerOptions<IncomingMessage, undefined, Context>): RequestListener;

package/lib/use/node.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 Protocol compliant request handler for
+ * the Node environment.
+ *
+ * ```js
+ * import http from 'http';
+ * import { createHandler } from 'graphql-http/lib/use/node';
+ * import { schema } from './my-graphql-step';
+ *
+ * const server = http.createServer(createHandler({ schema }));
+ *
+ * server.listen(4000);
+ * console.log('Listening to port 4000');
+ * ```
+ *
+ * @category Server/node
+ */
+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/node.mjs

@@ -0,0 +1,68 @@
+import { createHandler as createRawHandler, } from '../handler.mjs';
+/**
+ * Create a GraphQL over HTTP Protocol compliant request handler for
+ * the Node environment.
+ *
+ * ```js
+ * import http from 'http';
+ * import { createHandler } from 'graphql-http/lib/use/node';
+ * 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/node
+ */
+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,
+                    ],
+                }));
+            }
+        }
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "graphql-http",
-  "version": "1.6.1",
+  "version": "1.7.1",
   "description": "Simple, pluggable, zero-dependency, GraphQL over HTTP Protocol compliant server and client",
   "keywords": [
     "graphql",
@@ -16,15 +16,15 @@
   ],
   "author": "Denis Badurina <badurinadenis@gmail.com>",
   "license": "MIT",
-  "homepage": "https://github.com/enisdenjo/graphql-http#readme",
+  "homepage": "https://github.com/graphql/graphql-http#readme",
   "repository": {
     "type": "git",
-    "url": "https://github.com/enisdenjo/graphql-http.git"
+    "url": "https://github.com/graphql/graphql-http.git"
   },
   "engines": {
     "node": ">=12"
   },
-  "packageManager": "yarn@3.2.3",
+  "packageManager": "yarn@3.2.4",
   "main": "lib/index.js",
   "module": "lib/index.mjs",
   "browser": "umd/graphql-http.js",
@@ -35,6 +35,26 @@
       "types": "./lib/index.d.ts",
       "browser": "./umd/graphql-http.js"
     },
+    "./lib/use/fetch": {
+      "types": "./lib/use/fetch.d.ts",
+      "require": "./lib/use/fetch.js",
+      "import": "./lib/use/fetch.mjs"
+    },
+    "./lib/use/node": {
+      "types": "./lib/use/node.d.ts",
+      "require": "./lib/use/node.js",
+      "import": "./lib/use/node.mjs"
+    },
+    "./lib/use/express": {
+      "types": "./lib/use/express.d.ts",
+      "require": "./lib/use/express.js",
+      "import": "./lib/use/express.mjs"
+    },
+    "./lib/use/fastify": {
+      "types": "./lib/use/fastify.d.ts",
+      "require": "./lib/use/fastify.js",
+      "import": "./lib/use/fastify.mjs"
+    },
     "./package.json": "./package.json"
   },
   "types": "lib/index.d.ts",
@@ -62,41 +82,45 @@
     "release": "semantic-release"
   },
   "workspaces": [
-    "implementations/*"
+    "implementations/**/*"
   ],
   "peerDependencies": {
     "graphql": ">=0.11 <=16"
   },
   "devDependencies": {
-    "@babel/core": "^7.18.13",
+    "@babel/core": "^7.20.2",
     "@babel/plugin-proposal-class-properties": "^7.18.6",
     "@babel/plugin-proposal-nullish-coalescing-operator": "^7.18.6",
-    "@babel/plugin-proposal-object-rest-spread": "^7.18.9",
+    "@babel/plugin-proposal-object-rest-spread": "^7.20.2",
     "@babel/plugin-proposal-optional-chaining": "^7.18.9",
-    "@babel/preset-env": "^7.18.10",
+    "@babel/preset-env": "^7.20.2",
     "@babel/preset-typescript": "^7.18.6",
-    "@rollup/plugin-typescript": "^8.4.0",
+    "@rollup/plugin-typescript": "^9.0.2",
     "@semantic-release/changelog": "^6.0.1",
     "@semantic-release/git": "^10.0.1",
-    "@types/jest": "^29.0.0",
-    "@typescript-eslint/eslint-plugin": "^5.36.1",
-    "@typescript-eslint/parser": "^5.36.1",
-    "babel-jest": "^29.0.1",
-    "eslint": "^8.23.0",
+    "@types/express": "^4.17.14",
+    "@types/jest": "^29.2.2",
+    "@typescript-eslint/eslint-plugin": "^5.42.1",
+    "@typescript-eslint/parser": "^5.42.1",
+    "@whatwg-node/fetch": "^0.5.1",
+    "babel-jest": "^29.3.0",
+    "eslint": "^8.27.0",
     "eslint-config-prettier": "^8.5.0",
     "eslint-plugin-prettier": "^4.2.1",
+    "express": "^4.18.2",
+    "fastify": "^4.9.2",
     "graphql": "^16.6.0",
-    "jest": "^29.0.1",
-    "jest-jasmine2": "^29.0.1",
+    "jest": "^29.3.0",
+    "jest-jasmine2": "^29.3.0",
     "node-fetch": "^3.2.10",
     "prettier": "^2.7.1",
-    "rollup": "^2.79.0",
+    "rollup": "^3.2.5",
     "rollup-plugin-terser": "^7.0.2",
     "semantic-release": "^19.0.5",
-    "tslib": "^2.4.0",
-    "typedoc": "^0.23.13",
-    "typedoc-plugin-markdown": "^3.13.5",
-    "typescript": "^4.8.2"
+    "tslib": "^2.4.1",
+    "typedoc": "^0.23.20",
+    "typedoc-plugin-markdown": "^3.13.6",
+    "typescript": "^4.8.4"
   },
   "resolutions": {
     "npm/libnpmversion": "^3.0.6"

package/umd/graphql-http.js

@@ -185,6 +185,4 @@
     exports.NetworkError = NetworkError;
     exports.createClient = createClient;
 
-    Object.defineProperty(exports, '__esModule', { value: true });
-
 }));

package/umd/graphql-http.min.js

@@ -1 +1 @@
-!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).graphqlHttp={})}(this,(function(e){"use strict";class t extends Error{constructor(e){let t,r;var o;(function(e){return"object"==typeof e&&null!==e})(o=e)&&"boolean"==typeof o.ok&&"number"==typeof o.status&&"string"==typeof o.statusText?(r=e,t="Server responded with "+e.status+": "+e.statusText):t=e instanceof Error?e.message:String(e),super(t),this.name=this.constructor.name,this.response=r}}e.NetworkError=t,e.createClient=function(e){const{credentials:r="same-origin",referrer:o,referrerPolicy:n,shouldRetry:s=(()=>!1)}=e,i=e.fetchFn||fetch,a=e.abortControllerImpl||AbortController,c=(()=>{let e=!1;const t=[];return{get disposed(){return e},onDispose:r=>e?(setTimeout((()=>r()),0),()=>{}):(t.push(r),()=>{t.splice(t.indexOf(r),1)}),dispose(){if(!e){e=!0;for(const e of[...t])e()}}}})();return{subscribe(p,l){if(c.disposed)throw new Error("Client has been disposed");const f=new a,u=c.onDispose((()=>{u(),f.abort()}));return(async()=>{var a;let c=null,u=0;for(;;){if(c){const e=await s(c,u);if(f.signal.aborted)return;if(!e)throw c;u++}try{const s="function"==typeof e.url?await e.url(p):e.url;if(f.signal.aborted)return;const c="function"==typeof e.headers?await e.headers():null!==(a=e.headers)&&void 0!==a?a:{};if(f.signal.aborted)return;let u;try{u=await i(s,{signal:f.signal,method:"POST",headers:Object.assign(Object.assign({},c),{"content-type":"application/json; charset=utf-8",accept:"application/graphql-response+json, application/json"}),credentials:r,referrer:o,referrerPolicy:n,body:JSON.stringify(p)})}catch(e){throw new t(e)}if(!u.ok)throw new t(u);if(!u.body)throw new Error("Missing response body");const d=u.headers.get("content-type");if(!d)throw new Error("Missing response content-type");if(!d.includes("application/graphql-response+json")&&!d.includes("application/json"))throw new Error(`Unsupported response content-type ${d}`);const h=await u.json();return l.next(h),f.abort()}catch(e){if(f.signal.aborted)return;if(!(e instanceof t))throw e;c=e}}})().then((()=>l.complete())).catch((e=>l.error(e))),()=>f.abort()},dispose(){c.dispose()}}},Object.defineProperty(e,"__esModule",{value:!0})}));
+!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).graphqlHttp={})}(this,(function(e){"use strict";class t extends Error{constructor(e){let t,r;var o;(function(e){return"object"==typeof e&&null!==e})(o=e)&&"boolean"==typeof o.ok&&"number"==typeof o.status&&"string"==typeof o.statusText?(r=e,t="Server responded with "+e.status+": "+e.statusText):t=e instanceof Error?e.message:String(e),super(t),this.name=this.constructor.name,this.response=r}}e.NetworkError=t,e.createClient=function(e){const{credentials:r="same-origin",referrer:o,referrerPolicy:n,shouldRetry:s=(()=>!1)}=e,i=e.fetchFn||fetch,a=e.abortControllerImpl||AbortController,c=(()=>{let e=!1;const t=[];return{get disposed(){return e},onDispose:r=>e?(setTimeout((()=>r()),0),()=>{}):(t.push(r),()=>{t.splice(t.indexOf(r),1)}),dispose(){if(!e){e=!0;for(const e of[...t])e()}}}})();return{subscribe(p,l){if(c.disposed)throw new Error("Client has been disposed");const f=new a,u=c.onDispose((()=>{u(),f.abort()}));return(async()=>{var a;let c=null,u=0;for(;;){if(c){const e=await s(c,u);if(f.signal.aborted)return;if(!e)throw c;u++}try{const s="function"==typeof e.url?await e.url(p):e.url;if(f.signal.aborted)return;const c="function"==typeof e.headers?await e.headers():null!==(a=e.headers)&&void 0!==a?a:{};if(f.signal.aborted)return;let u;try{u=await i(s,{signal:f.signal,method:"POST",headers:Object.assign(Object.assign({},c),{"content-type":"application/json; charset=utf-8",accept:"application/graphql-response+json, application/json"}),credentials:r,referrer:o,referrerPolicy:n,body:JSON.stringify(p)})}catch(e){throw new t(e)}if(!u.ok)throw new t(u);if(!u.body)throw new Error("Missing response body");const d=u.headers.get("content-type");if(!d)throw new Error("Missing response content-type");if(!d.includes("application/graphql-response+json")&&!d.includes("application/json"))throw new Error(`Unsupported response content-type ${d}`);const h=await u.json();return l.next(h),f.abort()}catch(e){if(f.signal.aborted)return;if(!(e instanceof t))throw e;c=e}}})().then((()=>l.complete())).catch((e=>l.error(e))),()=>f.abort()},dispose(){c.dispose()}}}}));