graphql-http 1.14.0 → 1.16.0

package/README.md

@@ -3,10 +3,12 @@
 
   <h3>graphql-http</h3>
 
-  <h6>Simple, pluggable, zero-dependency, <a href="https://graphql.github.io/graphql-over-http">GraphQL over HTTP Protocol</a> compliant server and client.</h6>
+  <h6>Simple, pluggable, zero-dependency, <a href="https://graphql.github.io/graphql-over-http">GraphQL over HTTP spec</a> compliant server, client and audit suite.</h6>
 
 [![Continuous integration](https://github.com/graphql/graphql-http/workflows/Continuous%20integration/badge.svg)](https://github.com/graphql/graphql-http/actions?query=workflow%3A%22Continuous+integration%22) [![graphql-http](https://img.shields.io/npm/v/graphql-http.svg?label=graphql-http&logo=npm)](https://www.npmjs.com/package/graphql-http)
 
+<i>Quickly check for compliance? Visit <b>[graphql-http.com](https://graphql-http.com)</b>!</i>
+
 <i>Want a full-featured server? See the <b>[servers section](#servers)</b>!</i>
 
 <i>Need subscriptions? Try <b>[graphql-ws](https://github.com/enisdenjo/graphql-ws)</b> or <b>[graphql-sse](https://github.com/enisdenjo/graphql-sse)</b> instead!</i>
@@ -53,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
@@ -84,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/index.d.mts

@@ -1,2 +1,3 @@
 export * from './common';
 export * from './server';
+export * from './render';

package/lib/audits/index.d.ts

@@ -1,2 +1,3 @@
 export * from './common';
 export * from './server';
+export * from './render';

package/lib/audits/index.js

@@ -16,3 +16,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./common"), exports);
 __exportStar(require("./server"), exports);
+__exportStar(require("./render"), exports);

package/lib/audits/index.mjs

@@ -1,2 +1,3 @@
 export * from './common.mjs';
 export * from './server.mjs';
+export * from './render.mjs';

package/lib/audits/render.d.mts

@@ -0,0 +1,8 @@
+import { AuditResult } from './common';
+/**
+ * Renders the provided audit results to well-formatted and valid HTML.
+ *
+ * Do note that the rendered result is not an HTML document, it's rather
+ * just a component with results.
+ */
+export declare function renderAuditResultsToHTML(results: AuditResult[]): Promise<string>;

package/lib/audits/render.d.ts

@@ -0,0 +1,8 @@
+import { AuditResult } from './common';
+/**
+ * Renders the provided audit results to well-formatted and valid HTML.
+ *
+ * Do note that the rendered result is not an HTML document, it's rather
+ * just a component with results.
+ */
+export declare function renderAuditResultsToHTML(results: AuditResult[]): Promise<string>;

package/lib/audits/render.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderAuditResultsToHTML = void 0;
+/**
+ * Renders the provided audit results to well-formatted and valid HTML.
+ *
+ * Do note that the rendered result is not an HTML document, it's rather
+ * just a component with results.
+ */
+async function renderAuditResultsToHTML(results) {
+    const grouped = {
+        total: 0,
+        ok: [],
+        warn: [],
+        error: [],
+    };
+    for (const result of results) {
+        grouped.total++;
+        if (result.status === 'ok') {
+            grouped[result.status].push(result);
+        }
+        else {
+            grouped[result.status].push(result);
+        }
+    }
+    let report = '<i>* This report was auto-generated by graphql-http</i>\n';
+    report += '\n';
+    report += '<h1>GraphQL over HTTP audit report</h1>\n';
+    report += '\n';
+    report += '<ul>\n';
+    report += `<li><b>${grouped.total}</b> audits in total</li>\n`;
+    // font-family: monospace helps render native emojis in HTML
+    if (grouped.ok.length) {
+        report += `<li><span style="font-family: monospace">✅</span> <b>${grouped.ok.length}</b> pass</li>\n`;
+    }
+    if (grouped.warn.length) {
+        // TODO: warning sign is rendered as "⚠️" in markdown instead of the emoji
+        report += `<li><span style="font-family: monospace">⚠️</span> <b>${grouped.warn.length}</b> warnings (optional)</li>\n`;
+    }
+    if (grouped.error.length) {
+        report += `<li><span style="font-family: monospace">❌</span> <b>${grouped.error.length}</b> errors (required)</li>\n`;
+    }
+    report += '</ul>\n';
+    report += '\n';
+    if (grouped.ok.length) {
+        report += '<h2>Passing</h2>\n';
+        report += '<ol>\n';
+        for (const [, result] of grouped.ok.entries()) {
+            report += `<li><code>${result.id}</code> ${result.name}</li>\n`;
+        }
+        report += '</ol>\n';
+        report += '\n';
+    }
+    if (grouped.warn.length) {
+        report += `<h2>Warnings</h2>\n`;
+        report += 'The server <i>SHOULD</i> support these, but is not required.\n';
+        report += '<ol>\n';
+        for (const [, result] of grouped.warn.entries()) {
+            report += await printAuditFail(result);
+        }
+        report += '</ol>\n';
+        report += '\n';
+    }
+    if (grouped.error.length) {
+        report += `<h2>Errors</h2>\n`;
+        report += 'The server <b>MUST</b> support these.\n';
+        report += '<ol>\n';
+        for (const [, result] of grouped.error.entries()) {
+            report += await printAuditFail(result);
+        }
+        report += '</ol>\n';
+    }
+    return report;
+}
+exports.renderAuditResultsToHTML = renderAuditResultsToHTML;
+async function printAuditFail(result) {
+    let report = '';
+    report += `<li><code>${result.id}</code> ${result.name}\n`;
+    report += '<details>\n';
+    report += `<summary>${truncate(result.reason)}</summary>\n`;
+    report += '<pre><code class="lang-json">'; // no "\n" because they count in HTML pre tags
+    const res = result.response;
+    const headers = {};
+    for (const [key, val] of res.headers.entries()) {
+        // some headers change on each run, dont report it
+        if (key === 'date') {
+            headers[key] = '<timestamp>';
+        }
+        else if (['cf-ray', 'server-timing'].includes(key)) {
+            headers[key] = '<omitted>';
+        }
+        else {
+            headers[key] = val;
+        }
+    }
+    let text = '', json;
+    try {
+        text = await res.text();
+        json = JSON.parse(text);
+    }
+    catch (_a) {
+        // noop
+    }
+    const stringified = JSON.stringify({
+        status: res.status,
+        statusText: res.statusText,
+        headers,
+        body: json || ((text === null || text === void 0 ? void 0 : text.length) > 5120 ? '<body is too long>' : text) || null,
+    }, (_k, v) => {
+        if (v != null && typeof v === 'object' && !Array.isArray(v)) {
+            // sort object fields for stable stringify
+            const acc = {};
+            return Object.keys(v)
+                .sort()
+                .reverse() // body on bottom
+                .reduce((acc, k) => {
+                acc[k] = v[k];
+                return acc;
+            }, acc);
+        }
+        return v;
+    }, 2);
+    report += stringified + '\n';
+    report += '</code></pre>\n';
+    report += '</details>\n';
+    report += '</li>\n';
+    return report;
+}
+function truncate(str, len = 1024) {
+    if (str.length > len) {
+        return str.substring(0, len) + '...';
+    }
+    return str;
+}

package/lib/audits/render.mjs

@@ -0,0 +1,130 @@
+/**
+ * Renders the provided audit results to well-formatted and valid HTML.
+ *
+ * Do note that the rendered result is not an HTML document, it's rather
+ * just a component with results.
+ */
+export async function renderAuditResultsToHTML(results) {
+    const grouped = {
+        total: 0,
+        ok: [],
+        warn: [],
+        error: [],
+    };
+    for (const result of results) {
+        grouped.total++;
+        if (result.status === 'ok') {
+            grouped[result.status].push(result);
+        }
+        else {
+            grouped[result.status].push(result);
+        }
+    }
+    let report = '<i>* This report was auto-generated by graphql-http</i>\n';
+    report += '\n';
+    report += '<h1>GraphQL over HTTP audit report</h1>\n';
+    report += '\n';
+    report += '<ul>\n';
+    report += `<li><b>${grouped.total}</b> audits in total</li>\n`;
+    // font-family: monospace helps render native emojis in HTML
+    if (grouped.ok.length) {
+        report += `<li><span style="font-family: monospace">✅</span> <b>${grouped.ok.length}</b> pass</li>\n`;
+    }
+    if (grouped.warn.length) {
+        // TODO: warning sign is rendered as "⚠️" in markdown instead of the emoji
+        report += `<li><span style="font-family: monospace">⚠️</span> <b>${grouped.warn.length}</b> warnings (optional)</li>\n`;
+    }
+    if (grouped.error.length) {
+        report += `<li><span style="font-family: monospace">❌</span> <b>${grouped.error.length}</b> errors (required)</li>\n`;
+    }
+    report += '</ul>\n';
+    report += '\n';
+    if (grouped.ok.length) {
+        report += '<h2>Passing</h2>\n';
+        report += '<ol>\n';
+        for (const [, result] of grouped.ok.entries()) {
+            report += `<li><code>${result.id}</code> ${result.name}</li>\n`;
+        }
+        report += '</ol>\n';
+        report += '\n';
+    }
+    if (grouped.warn.length) {
+        report += `<h2>Warnings</h2>\n`;
+        report += 'The server <i>SHOULD</i> support these, but is not required.\n';
+        report += '<ol>\n';
+        for (const [, result] of grouped.warn.entries()) {
+            report += await printAuditFail(result);
+        }
+        report += '</ol>\n';
+        report += '\n';
+    }
+    if (grouped.error.length) {
+        report += `<h2>Errors</h2>\n`;
+        report += 'The server <b>MUST</b> support these.\n';
+        report += '<ol>\n';
+        for (const [, result] of grouped.error.entries()) {
+            report += await printAuditFail(result);
+        }
+        report += '</ol>\n';
+    }
+    return report;
+}
+async function printAuditFail(result) {
+    let report = '';
+    report += `<li><code>${result.id}</code> ${result.name}\n`;
+    report += '<details>\n';
+    report += `<summary>${truncate(result.reason)}</summary>\n`;
+    report += '<pre><code class="lang-json">'; // no "\n" because they count in HTML pre tags
+    const res = result.response;
+    const headers = {};
+    for (const [key, val] of res.headers.entries()) {
+        // some headers change on each run, dont report it
+        if (key === 'date') {
+            headers[key] = '<timestamp>';
+        }
+        else if (['cf-ray', 'server-timing'].includes(key)) {
+            headers[key] = '<omitted>';
+        }
+        else {
+            headers[key] = val;
+        }
+    }
+    let text = '', json;
+    try {
+        text = await res.text();
+        json = JSON.parse(text);
+    }
+    catch (_a) {
+        // noop
+    }
+    const stringified = JSON.stringify({
+        status: res.status,
+        statusText: res.statusText,
+        headers,
+        body: json || ((text === null || text === void 0 ? void 0 : text.length) > 5120 ? '<body is too long>' : text) || null,
+    }, (_k, v) => {
+        if (v != null && typeof v === 'object' && !Array.isArray(v)) {
+            // sort object fields for stable stringify
+            const acc = {};
+            return Object.keys(v)
+                .sort()
+                .reverse() // body on bottom
+                .reduce((acc, k) => {
+                acc[k] = v[k];
+                return acc;
+            }, acc);
+        }
+        return v;
+    }, 2);
+    report += stringified + '\n';
+    report += '</code></pre>\n';
+    report += '</details>\n';
+    report += '</li>\n';
+    return report;
+}
+function truncate(str, len = 1024) {
+    if (str.length > len) {
+        return str.substring(0, len) + '...';
+    }
+    return str;
+}

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