grafserv 0.0.1-0.2 → 0.0.1-0.21

package/dist/interfaces.d.ts

@@ -1,15 +1,14 @@
 /// <reference types="node" />
-/// <reference types="node" />
 import "graphile-config";
-import type { GraphQLSchema } from "graphql";
-import type { IncomingMessage } from "node:http";
-import type { Socket } from "node:net";
-export declare type ContextCallback = (graphqlRequestContext: GraphileConfig.GraphQLRequestContext) => object;
-export interface ServerParams {
-    schema: GraphQLSchema;
-    resolvedPreset: GraphileConfig.ResolvedPreset;
-}
-export interface ServerOptions {
+import type { PromiseOrDirect } from "grafast";
+import type { AsyncExecutionResult, ExecutionResult, GraphQLError, GraphQLSchema } from "graphql";
+import type { OptionsFromConfig } from "./options";
+export type ContextCallback = (requestContext: Grafast.RequestContext) => Grafast.Context;
+export interface GrafservConfig {
+    schema: GraphQLSchema | PromiseLike<GraphQLSchema>;
+    preset?: GraphileConfig.Preset;
+}
+export interface GrafservOptions {
     /** Port number to listen on */
     port?: number;
     /** Host to listen on */
@@ -18,6 +17,8 @@ export interface ServerOptions {
     graphqlPath?: string;
     /** The path at which the GraphQL event stream would be made available; usually /graphql/stream */
     eventStreamRoute?: string;
+    /** If true, allow GraphQL over GET requests. This has security ramifications, exercise caution. */
+    graphqlOverGET?: boolean;
     graphiql?: boolean;
     /** If true, then we will render GraphiQL on GET requests to the /graphql endpoint */
     graphiqlOnGraphQLGET?: boolean;
@@ -25,25 +26,177 @@ export interface ServerOptions {
     graphiqlPath?: string;
     /** Set true to enable watch mode */
     watch?: boolean;
-    /** The length, in bytes, for the largest request body that the server will accept */
+    /** The length, in bytes, for the largest request body that grafserv will accept */
     maxRequestLength?: number;
+    /** How long (in milliseconds) should we wait for a schema promise to resolve before sending a failure to the client? */
+    schemaWaitTime?: number;
+    /**
+     * Use grafast 'string' optimization - response will be partially stringified
+     * already, use `stringifyPayload` before sending to the user
+     *
+     * @remarks
+     *
+     * This is a `grafserv` option rather than a `grafast` option because the
+     * server is responsible for stringifying the body before sending it to the
+     * user, via `stringifyPayload`. If we were to make this a `grafast` option
+     * then everything using grafast would be affected by it, and code expecting
+     * objects would break.
+     */
+    outputDataAsString?: boolean;
+    /**
+     * Temporary hack to allow easy testing with graphql-http.com
+     */
+    dangerouslyAllowAllCORSRequests?: boolean;
+    /**
+     * Should we enable a websockets transport if available?
+     */
+    websockets?: boolean;
+    /**
+     * If you would like to customize the way in which errors are masked, you may
+     * pass your own error masking function here. You can also import
+     * `defaultMaskError` from `grafserv`.
+     */
+    maskError?: (error: GraphQLError) => GraphQLError;
 }
 declare global {
-    namespace GraphileConfig {
-        /**
-         * Details about the incoming GraphQL request - e.g. if it was sent over an
-         * HTTP request, the request itself so headers can be interrogated.
-         *
-         * It's anticipated this will be expanded via declaration merging, e.g. if
-         * your server is Koa then a `koaCtx` might be added.
-         */
-        interface GraphQLRequestContext {
-            httpRequest?: IncomingMessage;
-            socket?: Socket;
+    namespace Grafast {
+        interface RequestContext {
+            http?: NormalizedRequestDigest;
         }
+    }
+    namespace GraphileConfig {
         interface Preset {
-            server?: ServerOptions;
+            /**
+             * Configuration options for Grafserv
+             */
+            grafserv?: GrafservOptions;
         }
     }
 }
+export interface GrafservBodyBuffer {
+    type: "buffer";
+    buffer: Buffer;
+}
+export interface GrafservBodyText {
+    type: "text";
+    text: string;
+}
+export interface GrafservBodyJSON {
+    type: "json";
+    json: JSONValue;
+}
+export type GrafservBody = GrafservBodyBuffer | GrafservBodyText | GrafservBodyJSON;
+export declare const $$normalizedHeaders: unique symbol;
+export interface RequestDigest {
+    method: "HEAD" | "GET" | "POST" | string;
+    httpVersionMajor: number;
+    httpVersionMinor: number;
+    isSecure: boolean;
+    path: string;
+    headers: Record<string, string>;
+    getQueryParams: () => PromiseOrDirect<Record<string, string | string[]>>;
+    getBody(): PromiseOrDirect<GrafservBody>;
+    requestContext: Partial<Grafast.RequestContext>;
+    preferJSON?: boolean;
+    [$$normalizedHeaders]?: any;
+}
+export interface NormalizedRequestDigest extends RequestDigest {
+    method: "GET" | "POST" | string;
+    preferJSON: boolean;
+    /**
+     * As 'headers', but with the keys lowercased
+     * @internal
+     */
+    [$$normalizedHeaders]: Record<string, string>;
+    getHeader(name: string): string | undefined;
+    /** @deprecated use getHeader unless the original case is essential. */
+    headers: Record<string, string>;
+}
+interface IHandlerResult {
+    type: string;
+    request: NormalizedRequestDigest;
+    dynamicOptions: OptionsFromConfig;
+    statusCode?: number;
+}
+export interface HTMLHandlerResult extends IHandlerResult {
+    type: "html";
+    payload: Buffer;
+}
+export interface TextHandlerResult extends IHandlerResult {
+    type: "text";
+    payload: Buffer;
+}
+export interface GraphQLHandlerResult extends IHandlerResult {
+    type: "graphql";
+    contentType: string;
+    payload: ExecutionResult;
+    outputDataAsString?: boolean;
+}
+/** @see {@link https://github.com/glasser/graphql-over-http/blob/dac9638459bb17dd3ade889334fc2fadee9d11e5/rfcs/IncrementalDelivery.md} */
+export interface GraphQLIncrementalHandlerResult extends IHandlerResult {
+    type: "graphqlIncremental";
+    iterator: AsyncGenerator<AsyncExecutionResult, void, undefined>;
+    outputDataAsString?: boolean;
+}
+export interface NoContentHandlerResult extends IHandlerResult {
+    type: "noContent";
+}
+export interface EventStreamEvent {
+    /** The name of the event. Use simple names. Don't put newlines in it! */
+    event: string;
+    /** The data for this event. We'll automatically split this on newlines for you */
+    data?: string;
+    id?: string;
+    /** integer number of milliseconds indicating how long to wait before reconnecting if connection is lost */
+    retry?: number;
+}
+export interface EventStreamHeandlerResult extends IHandlerResult {
+    type: "event-stream";
+    payload: AsyncIterable<EventStreamEvent>;
+}
+export type HandlerResult = HTMLHandlerResult | GraphQLHandlerResult | GraphQLIncrementalHandlerResult | TextHandlerResult | EventStreamHeandlerResult | NoContentHandlerResult;
+export type SchemaChangeEvent = {
+    event: "change";
+    data: "schema";
+};
+export type JSONValue = null | boolean | number | string | JSONValue[] | JSONObject;
+export interface JSONObject {
+    [key: string]: JSONValue;
+}
+export interface ErrorResult {
+    type: "error";
+    statusCode: number;
+    headers: Record<string, string>;
+    error: Error & {
+        statusCode?: number;
+        safeMessage?: boolean;
+    };
+}
+export interface BufferResult {
+    type: "buffer";
+    statusCode: number;
+    headers: Record<string, string>;
+    buffer: Buffer;
+}
+export interface JSONResult {
+    type: "json";
+    statusCode: number;
+    headers: Record<string, string>;
+    json: JSONValue;
+}
+export interface BufferStreamResult {
+    type: "bufferStream";
+    statusCode: number;
+    headers: Record<string, string>;
+    /** If true, setNoDelay, etc */
+    lowLatency: boolean;
+    bufferIterator: AsyncGenerator<Buffer, void, undefined>;
+}
+export interface NoContentResult {
+    type: "noContent";
+    statusCode: 204;
+    headers: Record<string, string>;
+}
+export type Result = ErrorResult | BufferResult | JSONResult | BufferStreamResult | NoContentResult;
+export {};
 //# sourceMappingURL=interfaces.d.ts.map

package/dist/interfaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":";;AAAA,OAAO,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,oBAAY,eAAe,GAAG,CAC5B,qBAAqB,EAAE,cAAc,CAAC,qBAAqB,KACxD,MAAM,CAAC;AAEZ,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,aAAa,CAAC;IACtB,cAAc,EAAE,cAAc,CAAC,cAAc,CAAC;CAC/C;AAED,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kGAAkG;IAClG,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qFAAqF;IACrF,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,oCAAoC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,qFAAqF;IACrF,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,cAAc,CAAC;QACvB;;;;;;WAMG;QACH,UAAU,qBAAqB;YAE7B,WAAW,CAAC,EAAE,eAAe,CAAC;YAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;SACjB;QACD,UAAU,MAAM;YACd,MAAM,CAAC,EAAE,aAAa,CAAC;SACxB;KACF;CACF"}
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":"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"}

package/dist/interfaces.js

@@ -1,4 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.$$normalizedHeaders = void 0;
 require("graphile-config");
+exports.$$normalizedHeaders = Symbol("normalizedHeaders");
 //# sourceMappingURL=interfaces.js.map

package/dist/interfaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":";;AAAA,2BAAyB"}
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":";;;AAAA,2BAAyB;AAuHZ,QAAA,mBAAmB,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC"}

package/dist/mapIterator.d.ts

@@ -0,0 +1,2 @@
+export declare function mapIterator<T, U>(iterable: AsyncIterable<T>, cb: (payload: T) => U, end?: () => U, initial?: () => U): AsyncGenerator<U>;
+//# sourceMappingURL=mapIterator.d.ts.map

package/dist/mapIterator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapIterator.d.ts","sourceRoot":"","sources":["../src/mapIterator.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,CAAC,EAAE,CAAC,EAC9B,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,EACrB,GAAG,CAAC,EAAE,MAAM,CAAC,EACb,OAAO,CAAC,EAAE,MAAM,CAAC,GAChB,cAAc,CAAC,CAAC,CAAC,CA0DnB"}

package/dist/mapIterator.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapIterator = void 0;
+function mapIterator(iterable, cb, end, initial) {
+    const iterator = iterable[Symbol.asyncIterator]();
+    /**
+     * -1 - starting
+     * 0 - normal
+     * 1 - ending
+     * 2 - ended
+     */
+    let status = -1;
+    const mappedIterator = {
+        next() {
+            if (status === -1) {
+                status = 0;
+                if (typeof initial === "function") {
+                    return Promise.resolve({ value: initial(), done: false });
+                }
+            }
+            if (status === 1) {
+                status = 2;
+            }
+            // NO 'else' here!
+            if (status === 2) {
+                return Promise.resolve({ value: undefined, done: true });
+            }
+            const next = iterator.next();
+            return next.then((v) => {
+                if (v.done) {
+                    if (v.value !== undefined) {
+                        throw new Error("Invalid assumption; tell Benjie he did bad.");
+                    }
+                    if (end) {
+                        status = 1;
+                        return { value: end(), done: false };
+                    }
+                    else {
+                        status = 2;
+                        return { value: undefined, done: true };
+                    }
+                }
+                else {
+                    return { value: cb(v.value), done: false };
+                }
+            });
+        },
+        return(value) {
+            status = 2;
+            iterator.return?.(value);
+            return Promise.resolve({ value: undefined, done: true });
+        },
+        throw(error) {
+            status = 2;
+            iterator.throw?.(error);
+            return Promise.reject(error);
+        },
+        [Symbol.asyncIterator]() {
+            return this;
+        },
+    };
+    return mappedIterator;
+}
+exports.mapIterator = mapIterator;
+//# sourceMappingURL=mapIterator.js.map

package/dist/mapIterator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapIterator.js","sourceRoot":"","sources":["../src/mapIterator.ts"],"names":[],"mappings":";;;AAAA,SAAgB,WAAW,CACzB,QAA0B,EAC1B,EAAqB,EACrB,GAAa,EACb,OAAiB;IAEjB,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;IAClD;;;;;OAKG;IACH,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC;IAChB,MAAM,cAAc,GAAsB;QACxC,IAAI;YACF,IAAI,MAAM,KAAK,CAAC,CAAC,EAAE;gBACjB,MAAM,GAAG,CAAC,CAAC;gBACX,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE;oBACjC,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;iBAC3D;aACF;YACD,IAAI,MAAM,KAAK,CAAC,EAAE;gBAChB,MAAM,GAAG,CAAC,CAAC;aACZ;YACD,kBAAkB;YAClB,IAAI,MAAM,KAAK,CAAC,EAAE;gBAChB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;aAC1D;YACD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;gBACrB,IAAI,CAAC,CAAC,IAAI,EAAE;oBACV,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,EAAE;wBACzB,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;qBAChE;oBACD,IAAI,GAAG,EAAE;wBACP,MAAM,GAAG,CAAC,CAAC;wBACX,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;qBACtC;yBAAM;wBACL,MAAM,GAAG,CAAC,CAAC;wBACX,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;qBACzC;iBACF;qBAAM;oBACL,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;iBAC5C;YACH,CAAC,CAAC,CAAC;QACL,CAAC;QACD,MAAM,CAAC,KAAK;YACV,MAAM,GAAG,CAAC,CAAC;YACX,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC;YACzB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,KAAK,CAAC,KAAK;YACT,MAAM,GAAG,CAAC,CAAC;YACX,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;YACxB,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;QACD,CAAC,MAAM,CAAC,aAAa,CAAC;YACpB,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;IAEF,OAAO,cAAc,CAAC;AACxB,CAAC;AA/DD,kCA+DC"}

package/dist/middleware/graphiql.d.ts

@@ -1,4 +1,4 @@
-import type { ServerParams } from "../interfaces.js";
-import type { HandlerResult } from "./interfaces.js";
-export declare function makeGraphiQLHandler(_params: ServerParams): () => Promise<HandlerResult>;
+import type { HandlerResult, NormalizedRequestDigest } from "../interfaces.js";
+import type { OptionsFromConfig } from "../options.js";
+export declare function makeGraphiQLHandler(_resolvedPreset: GraphileConfig.ResolvedPreset, dynamicOptions: OptionsFromConfig): (request: NormalizedRequestDigest) => Promise<HandlerResult>;
 //# sourceMappingURL=graphiql.d.ts.map

package/dist/middleware/graphiql.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graphiql.d.ts","sourceRoot":"","sources":["../../src/middleware/graphiql.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAMrD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,SACtC,QAAQ,aAAa,CAAC,CAWxC"}
+{"version":3,"file":"graphiql.d.ts","sourceRoot":"","sources":["../../src/middleware/graphiql.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAOvD,wBAAgB,mBAAmB,CACjC,eAAe,EAAE,cAAc,CAAC,cAAc,EAC9C,cAAc,EAAE,iBAAiB,aAEV,uBAAuB,KAAG,QAAQ,aAAa,CAAC,CAsBxE"}

package/dist/middleware/graphiql.js

@@ -4,16 +4,26 @@ exports.makeGraphiQLHandler = void 0;
 const ruruServer = import("ruru/server");
 let ruruHTML = undefined;
 // TODO: use a specific version of mermaid
-function makeGraphiQLHandler(_params) {
-    return async () => {
+function makeGraphiQLHandler(_resolvedPreset, dynamicOptions) {
+    return async (request) => {
         if (!ruruHTML) {
             ruruHTML = (await ruruServer).ruruHTML;
         }
-        const config = {};
+        const config = {
+            endpoint: dynamicOptions.graphqlPath,
+            // TODO: websocket endpoint
+            debugTools: dynamicOptions.explain === true
+                ? ["explain", "plan"]
+                : dynamicOptions.explain === false
+                    ? []
+                    : dynamicOptions.explain,
+        };
         return {
             statusCode: 200,
+            request,
+            dynamicOptions,
             type: "html",
-            payload: ruruHTML(config),
+            payload: Buffer.from(ruruHTML(config), "utf8"),
         };
     };
 }

package/dist/middleware/graphiql.js.map

@@ -1 +1 @@
-{"version":3,"file":"graphiql.js","sourceRoot":"","sources":["../../src/middleware/graphiql.ts"],"names":[],"mappings":";;;AAGA,MAAM,UAAU,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;AACzC,IAAI,QAAQ,GAAuD,SAAS,CAAC;AAE7E,0CAA0C;AAC1C,SAAgB,mBAAmB,CAAC,OAAqB;IACvD,OAAO,KAAK,IAA4B,EAAE;QACxC,IAAI,CAAC,QAAQ,EAAE;YACb,QAAQ,GAAG,CAAC,MAAM,UAAU,CAAC,CAAC,QAAQ,CAAC;SACxC;QACD,MAAM,MAAM,GAAG,EAAE,CAAC;QAClB,OAAO;YACL,UAAU,EAAE,GAAG;YACf,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC;SAC1B,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAZD,kDAYC"}
+{"version":3,"file":"graphiql.js","sourceRoot":"","sources":["../../src/middleware/graphiql.ts"],"names":[],"mappings":";;;AAGA,MAAM,UAAU,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;AAEzC,IAAI,QAAQ,GAAiC,SAAS,CAAC;AAEvD,0CAA0C;AAC1C,SAAgB,mBAAmB,CACjC,eAA8C,EAC9C,cAAiC;IAEjC,OAAO,KAAK,EAAE,OAAgC,EAA0B,EAAE;QACxE,IAAI,CAAC,QAAQ,EAAE;YACb,QAAQ,GAAG,CAAC,MAAM,UAAU,CAAC,CAAC,QAAQ,CAAC;SACxC;QACD,MAAM,MAAM,GAAoC;YAC9C,QAAQ,EAAE,cAAc,CAAC,WAAW;YACpC,2BAA2B;YAC3B,UAAU,EACR,cAAc,CAAC,OAAO,KAAK,IAAI;gBAC7B,CAAC,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC;gBACrB,CAAC,CAAC,cAAc,CAAC,OAAO,KAAK,KAAK;oBAClC,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAE,cAAc,CAAC,OAAiB;SACxC,CAAC;QACF,OAAO;YACL,UAAU,EAAE,GAAG;YACf,OAAO;YACP,cAAc;YACd,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;SAC/C,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AA1BD,kDA0BC"}

package/dist/middleware/graphql.d.ts

@@ -1,4 +1,9 @@
-import type { ServerParams } from "../interfaces.js";
-import type { HandlerResult } from "./interfaces.js";
-export declare const makeGraphQLHandler: (params: ServerParams) => (resolvedPreset: GraphileConfig.ResolvedPreset, ctx: GraphileConfig.GraphQLRequestContext, body: unknown) => Promise<HandlerResult>;
+import type { PromiseOrDirect } from "grafast";
+import type { GraphQLSchema } from "graphql";
+import type { HandlerResult, NormalizedRequestDigest } from "../interfaces.js";
+import type { OptionsFromConfig } from "../options.js";
+export declare const APPLICATION_JSON = "application/json;charset=utf-8";
+export declare const APPLICATION_GRAPHQL_RESPONSE_JSON = "application/graphql-response+json;charset=utf-8";
+export declare const TEXT_HTML = "text/html;charset=utf-8";
+export declare const makeGraphQLHandler: (resolvedPreset: GraphileConfig.ResolvedPreset, dynamicOptions: OptionsFromConfig, schemaOrPromise: PromiseOrDirect<GraphQLSchema> | null) => (request: NormalizedRequestDigest, graphiqlHandler?: ((request: NormalizedRequestDigest) => Promise<HandlerResult | null>) | undefined) => Promise<HandlerResult | null>;
 //# sourceMappingURL=graphql.d.ts.map

package/dist/middleware/graphql.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graphql.d.ts","sourceRoot":"","sources":["../../src/middleware/graphql.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAqErD,eAAO,MAAM,kBAAkB,WAAY,YAAY,sBAMnC,eAAe,cAAc,OACxC,eAAe,qBAAqB,QACnC,OAAO,KACZ,QAAQ,aAAa,CA4DzB,CAAC"}
+{"version":3,"file":"graphql.d.ts","sourceRoot":"","sources":["../../src/middleware/graphql.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAQ/C,OAAO,KAAK,EAA+B,aAAa,EAAE,MAAM,SAAS,CAAC;AAW1E,OAAO,KAAK,EAEV,aAAa,EAEb,uBAAuB,EACxB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AA0PvD,eAAO,MAAM,gBAAgB,mCAAmC,CAAC;AACjE,eAAO,MAAM,iCAAiC,oDACK,CAAC;AACpD,eAAO,MAAM,SAAS,4BAA4B,CAAC;AAiBnD,eAAO,MAAM,kBAAkB,mBACb,eAAe,cAAc,kBAC7B,iBAAiB,mBAChB,gBAAgB,aAAa,CAAC,GAAG,IAAI,eAmD3C,uBAAuB,+BAErB,uBAAuB,KAC7B,QAAQ,aAAa,GAAG,IAAI,CAAC,kBACjC,QAAQ,aAAa,GAAG,IAAI,CA+LhC,CAAC"}