@znight/graphql 0.2.1 → 0.3.0

package/dist/yoga.mjs

@@ -0,0 +1,379 @@
+import { a as Media, f as GraphQLErrorCode, i as notJson, o as negotiate, r as isJsonRequest } from "./http-BWcayUtH.mjs";
+import { ErrorCode, ZnightError } from "@znight/core";
+import { parseByteSize } from "@znight/http";
+import { GraphQLError } from "graphql";
+import { createYoga } from "graphql-yoga";
+// src/transport/fetch.ts
+/** The Web `Request` of the route's request, read under `limit` bytes. */
+function fetchRequest(ctx, limit) {
+	const native = ctx.request;
+	const method = ctx.method;
+	const bodyless = method === "GET" || method === "HEAD";
+	if (native instanceof Request && !native.bodyUsed) {
+		if (bodyless) return native;
+		const length = ctx.headers["content-length"];
+		if (length !== void 0 && ctx.headers["transfer-encoding"] === void 0) {
+			const declared = Number(length);
+			if (Number.isSafeInteger(declared) && declared >= 0 && declared <= limit) return native;
+		}
+	}
+	const url = requestUrl(ctx);
+	const headers = requestHeaders(ctx);
+	if (bodyless) return new Request(url, {
+		method,
+		headers,
+		signal: ctx.signal
+	});
+	return ctx.rawBody().then((body) => new Request(url, {
+		method,
+		headers,
+		body,
+		signal: ctx.signal
+	}));
+}
+/** The absolute URL of the request: the raw target on the request's protocol and host. */
+function requestUrl(ctx) {
+	const host = ctx.headers["host"];
+	const target = ctx.url;
+	if (host !== void 0 && target.startsWith("/") && !target.startsWith("//")) {
+		const url = `${ctx.protocol}://${host}${target}`;
+		if (URL.canParse(url)) return url;
+	}
+	return new URL(target.startsWith("/") ? target.replace(/^\/+/, "/") : `/${target}`, `${ctx.protocol}://localhost`).href;
+}
+function requestHeaders(ctx) {
+	const headers = new Headers();
+	const source = ctx.headers;
+	for (const name in source) {
+		const value = source[name];
+		if (value !== void 0) headers.append(name, value);
+	}
+	return headers;
+}
+// src/yoga.ts
+/** Options of Yoga the engine or `GraphQLPlugin` own (RFC 0009 §4.6): refused by {@link yogaDriver}. */
+const OWNED = [
+	"schema",
+	"context",
+	"graphqlEndpoint",
+	"maskedErrors",
+	"cors",
+	"fetchAPI",
+	"maxRequestBodySize",
+	"parserAndValidationCache",
+	"requestId",
+	"healthCheckEndpoint",
+	"landingPage",
+	"disposeOnProcessTerminate",
+	"batching",
+	"multipart"
+];
+/** Where each owned option comes from, for the ZNIGHT066 hint. */
+const OWNER = {
+	schema: "the engine serves the schema GraphQLPlugin built",
+	context: "resolvers get GraphQLContext; read Yoga's context with yogaContext(ctx)",
+	graphqlEndpoint: "set the path option of GraphQLPlugin",
+	maskedErrors: "the engine masks errors once (exposeErrors, errorMappers)",
+	cors: "set the cors option of HttpPlugin",
+	fetchAPI: "the driver gives Yoga the runtime's own Fetch API",
+	maxRequestBodySize: "set http.bodyLimit of GraphQLPlugin",
+	parserAndValidationCache: "the engine caches documents (the documentCache option of GraphQLPlugin)",
+	requestId: "Yoga uses the request id of HttpPlugin",
+	healthCheckEndpoint: "the driver only serves the GraphQL endpoint",
+	landingPage: "the driver only serves the GraphQL endpoint",
+	disposeOnProcessTerminate: "the application stops Yoga once HttpPlugin drained its requests",
+	batching: "Send one operation per request: the operations of a batch would share the request scope and its GraphQLContext",
+	multipart: "POST bodies are application/json only: form and multipart bodies skip the CORS preflight (CSRF); upload files through an HTTP controller"
+};
+/**
+* The GraphQL Yoga driver (RFC 0009 §5.1): `GraphQLPlugin.configure({ driver: yogaDriver({ plugins }) })`.
+* Yoga handles the protocol and its Envelop plugins; the engine parses, validates and executes
+* (guards, loaders, request scope, masking, the `graphql:operation` hook). Plugins that replace
+* the engine's execution (`useGraphQlJit`) are refused: the operation fails with ZNIGHT066.
+*
+* Like the built-in transport, a `POST` body is `application/json` only (415 otherwise): form,
+* multipart and text bodies, which a cross-site page sends without a CORS preflight, never run
+* an operation (CSRF). Errors thrown outside the engine (by Yoga or an Envelop plugin) are masked
+* like the engine's (`Unexpected error.` unless `exposeErrors`) and logged.
+*
+* ```ts
+* GraphQLPlugin.configure({
+*   guards: [AccessGuard],
+*   driver: yogaDriver({ plugins: [useResponseCache({ session: () => null })] }),
+* })
+* ```
+*/
+function yogaDriver(options = {}) {
+	if (options === null || typeof options !== "object" || Array.isArray(options)) throw invalid("yogaDriver(): expected an options object", ["yogaDriver({ plugins: [...] })"]);
+	for (const key of OWNED) if (options[key] !== void 0) throw invalid(`yogaDriver(): the ${key} option of Yoga is not available with Znight`, [OWNER[key]]);
+	const graphiql = options.graphiql;
+	if (graphiql !== void 0 && (graphiql === null || typeof graphiql !== "object")) throw invalid("yogaDriver(): graphiql takes GraphiQL's options", ["Turn the IDE on or off with the graphiql option of GraphQLPlugin"]);
+	if (options.plugins !== void 0 && !Array.isArray(options.plugins)) throw invalid("yogaDriver(): plugins must be an array of Envelop plugins", []);
+	return new Driver(options);
+}
+/**
+* Yoga's context of an operation received by the Yoga driver (RFC 0009 Q2): `GraphQLContext.serverContext`,
+* typed. For the rare resolver that needs Yoga's `request`, `params` or the context an Envelop
+* plugin extended; the HTTP request is `ctx.http`, the user a request-scoped provider.
+*
+* @throws ZnightError (ZNIGHT066) when the operation did not come through the Yoga driver.
+*/
+function yogaContext(ctx) {
+	const server = ctx?.serverContext;
+	if (server === null || typeof server !== "object" || server.znight === void 0 || server.params === void 0) throw invalid("yogaContext(): the operation was not received by the Yoga driver", ["yogaContext() reads GraphQLContext.serverContext of operations served by yogaDriver()"]);
+	return server;
+}
+const SSE = Object.freeze({ transport: "sse" });
+const DEFAULT_BODY_LIMIT = 1048576;
+var Driver = class {
+	name = "yoga";
+	#options;
+	#yoga;
+	/** Stopped: the application stops, requests that still reach the driver get a 503. */
+	#stopped = false;
+	#get = true;
+	#ide = false;
+	#limit = DEFAULT_BODY_LIMIT;
+	constructor(options) {
+		this.#options = options;
+	}
+	get yoga() {
+		return this.#yoga;
+	}
+	/** `GET` and `POST` on the path (`GET` answers 405 when neither queries over `GET` nor GraphiQL apply). */
+	routes(context) {
+		return [{
+			method: "GET",
+			path: context.path,
+			name: "yoga",
+			handler: this.#getHandler
+		}, {
+			method: "POST",
+			path: context.path,
+			name: "yoga",
+			handler: this.#postHandler
+		}];
+	}
+	start(engine, context) {
+		if (this.#yoga !== void 0) throw invalid("yogaDriver(): this driver already serves an application", ["Create one driver per application: GraphQLPlugin.configure({ driver: yogaDriver() })"]);
+		const settings = engine.settings;
+		const http = settings.http;
+		this.#get = http !== false && http.get;
+		this.#ide = settings.ide;
+		this.#limit = http === false ? DEFAULT_BODY_LIMIT : parseByteSize(http.bodyLimit) ?? DEFAULT_BODY_LIMIT;
+		const { graphiql, plugins = [], logging = false, ...rest } = this.#options;
+		const engineFns = engineFunctions(engine, context.logger);
+		this.#yoga = createYoga({
+			...rest,
+			logging,
+			schema: engine.schema,
+			graphqlEndpoint: settings.path,
+			graphiql: settings.ide ? graphiql ?? true : false,
+			landingPage: false,
+			healthCheckEndpoint: UNREACHABLE,
+			maskedErrors: { maskError: outsideErrors(settings.exposeErrors, context.logger) },
+			batching: false,
+			multipart: false,
+			cors: false,
+			maxRequestBodySize: this.#limit,
+			parserAndValidationCache: false,
+			disposeOnProcessTerminate: false,
+			requestId: {
+				generateRequestId: requestIdOf,
+				trustHeader: false
+			},
+			fetchAPI: fetchApi(),
+			plugins: [
+				engineFns.plugin,
+				...plugins,
+				engineFns.guard
+			]
+		});
+		this.#stopped = false;
+	}
+	/** Called once `HttpPlugin` drained the requests (`GraphQLPlugin.onDispose`). */
+	async stop() {
+		const yoga = this.#yoga;
+		this.#yoga = void 0;
+		this.#stopped = true;
+		await yoga?.dispose();
+	}
+	#handle = (ctx) => {
+		const yoga = this.#yoga;
+		if (yoga === void 0) {
+			if (this.#stopped) return shuttingDown();
+			throw notStarted();
+		}
+		const request = fetchRequest(ctx, this.#limit);
+		const server = { znight: ctx };
+		const response = request instanceof Request ? yoga.fetch(request, server) : request.then((built) => yoga.fetch(built, server));
+		return response instanceof Response ? response : Promise.resolve(response).then(sendable);
+	};
+	/** `POST`: JSON bodies only (the 415 of the built-in transport otherwise: no CSRF). */
+	#postHandler = (ctx) => {
+		const headers = ctx.headers;
+		if (!isJsonRequest(headers["content-type"])) return notJson(jsonMedia(headers["accept"]));
+		return this.#handle(ctx);
+	};
+	/** `GET`: Yoga's, or 405 when queries over `GET` are off (GraphiQL pages still served). */
+	#getHandler = (ctx) => {
+		if (this.#get || this.#ide && acceptsHtml(ctx)) return this.#handle(ctx);
+		return getNotAllowed();
+	};
+};
+/** A path no request reaches: the driver's routes only serve the GraphQL endpoint. */
+const UNREACHABLE = "/.znight/unreachable";
+/**
+* The Fetch API of the runtime: on Node.js, Yoga would otherwise use the ponyfills of
+* `@whatwg-node/fetch`, whose `Response` objects `HttpPlugin` cannot send.
+*/
+function fetchApi() {
+	return {
+		fetch: globalThis.fetch,
+		Request: globalThis.Request,
+		Response: globalThis.Response,
+		Headers: globalThis.Headers,
+		FormData: globalThis.FormData,
+		ReadableStream: globalThis.ReadableStream,
+		WritableStream: globalThis.WritableStream,
+		TransformStream: globalThis.TransformStream,
+		CompressionStream: globalThis.CompressionStream,
+		DecompressionStream: globalThis.DecompressionStream,
+		TextDecoderStream: globalThis.TextDecoderStream,
+		TextEncoderStream: globalThis.TextEncoderStream,
+		Blob: globalThis.Blob,
+		File: globalThis.File,
+		TextEncoder: globalThis.TextEncoder,
+		TextDecoder: globalThis.TextDecoder,
+		URL: globalThis.URL,
+		URLSearchParams: globalThis.URLSearchParams,
+		btoa: globalThis.btoa
+	};
+}
+/**
+* A `Response` `HttpPlugin` recognises: `@hono/node-server` replaces the global `Response` when it
+* starts listening, after Yoga captured the runtime's own; such a response is rebuilt on the
+* global class (same status, headers and body stream).
+*/
+function sendable(response) {
+	if (response instanceof Response) return response;
+	const foreign = response;
+	return new Response(foreign.body, foreign);
+}
+/** The request id of `HttpPlugin` (a UUID for a request handed to `yoga.fetch()` directly). */
+function requestIdOf(payload) {
+	return payload.context.znight?.requestId ?? crypto.randomUUID();
+}
+function acceptsHtml(ctx) {
+	return ctx.headers["accept"]?.includes("text/html") === true;
+}
+/** The JSON type a refusal is written in, like the built-in transport: `application/json` unless the client prefers `application/graphql-response+json`. */
+function jsonMedia(accept) {
+	const media = negotiate(accept, 1 << Media.GraphQLJson | 1 << Media.Json) & 7;
+	return media === Media.None ? Media.Json : media;
+}
+/** A request reaching the driver once it stopped (after `HttpPlugin` drained): 503. */
+function shuttingDown() {
+	return Response.json({ errors: [{
+		message: "The server is shutting down, retry later",
+		extensions: { code: GraphQLErrorCode.ServiceUnavailable }
+	}] }, { status: 503 });
+}
+/**
+* Yoga's `maskError`: the errors of the engine (masked already) and the `GraphQLError`s thrown on
+* purpose (by Yoga or a plugin, with a code) are kept; any other error, thrown outside the engine
+* (an Envelop plugin's hook, Yoga itself), is logged and masked like the engine masks it
+* (`Unexpected error.`, its message with `exposeErrors`). Yoga then answers 500 for a request error.
+*/
+function outsideErrors(expose, logger) {
+	return (error, message) => {
+		if (isOriginalGraphQLError(error)) return error;
+		logger.error("GraphQL: an error was thrown outside the engine (by Yoga or an Envelop plugin)", { err: error });
+		const original = error instanceof Error ? error : new Error(String(error));
+		return new GraphQLError(expose ? original.message : message, {
+			originalError: original,
+			extensions: { code: GraphQLErrorCode.InternalServerError }
+		});
+	};
+}
+/** A `GraphQLError` that wraps no other error: the engine's, or thrown on purpose. */
+function isOriginalGraphQLError(error) {
+	if (!(error instanceof GraphQLError)) return false;
+	const original = error.originalError;
+	return original === void 0 || original === null || isOriginalGraphQLError(original);
+}
+function getNotAllowed() {
+	return Response.json({ errors: [{
+		message: "GraphQL operations are sent with POST on this endpoint",
+		extensions: { code: "BAD_REQUEST" }
+	}] }, {
+		status: 405,
+		headers: { allow: "POST" }
+	});
+}
+/**
+* The Envelop plugins of the engine: one installed before the application's plugins, which makes
+* the engine Yoga's `parse`, `validate`, `execute` and `subscribe` (Envelop's `useEngine`), and a
+* guard installed after them, which refuses an operation that a plugin executed elsewhere
+* (`useGraphQlJit`): its resolvers would not get the `GraphQLContext`. Plugins wrapping the
+* execution (`useResponseCache`) keep working: they call the engine.
+*/
+function engineFunctions(engine, logger) {
+	const parse = engine.parse;
+	const validate = (schema, document, rules) => engine.validate(schema, document, rules);
+	let watching = false;
+	const ran = /* @__PURE__ */ new WeakSet();
+	const execute = (args) => {
+		if (watching) mark(ran, args.contextValue);
+		return engine.execute(args);
+	};
+	const subscribe = (args) => {
+		if (watching) mark(ran, args.contextValue);
+		return engine.subscribe(args, SSE);
+	};
+	let reported = false;
+	const bypassed = () => {
+		const error = invalid("GraphQLPlugin: a Yoga plugin executed the operation instead of the Znight engine (useGraphQlJit?)", ["Remove the plugin: resolvers, guards and loaders only run on the engine"]);
+		if (!reported) {
+			reported = true;
+			logger.error(error.message, { error });
+		}
+		return { errors: [new GraphQLError(error.message, { extensions: { code: "INTERNAL_SERVER_ERROR" } })] };
+	};
+	return {
+		plugin: {
+			onParse: ({ setParseFn }) => setParseFn(parse),
+			onValidate: ({ setValidationFn }) => setValidationFn(validate),
+			onExecute: ({ setExecuteFn }) => setExecuteFn(execute),
+			onSubscribe: ({ setSubscribeFn }) => setSubscribeFn(subscribe)
+		},
+		guard: {
+			onExecute: ({ executeFn, context }) => {
+				if (executeFn === execute) return void 0;
+				watching = true;
+				return { onExecuteDone: ({ setResult }) => {
+					if (!ran.has(context)) setResult(bypassed());
+				} };
+			},
+			onSubscribe: ({ subscribeFn, context }) => {
+				if (subscribeFn === subscribe) return void 0;
+				watching = true;
+				return { onSubscribeResult: ({ setResult }) => {
+					if (!ran.has(context)) setResult(bypassed());
+				} };
+			}
+		}
+	};
+}
+function mark(ran, context) {
+	if (context !== null && typeof context === "object") ran.add(context);
+}
+function notStarted() {
+	return new ZnightError(ErrorCode.LifecycleFailed, "The Yoga driver is not started yet", { hints: ["GraphQLPlugin starts its driver in onBootstrap"] });
+}
+function invalid(message, hints) {
+	return new ZnightError(ErrorCode.InvalidGraphQLSetup, message, { hints: [...hints] });
+}
+export { yogaContext, yogaDriver };
+
+//# sourceMappingURL=yoga.mjs.map

package/dist/yoga.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"yoga.mjs","names":[],"sources":["../src/transport/fetch.ts","../src/yoga.ts"],"sourcesContent":["/**\n * The Fetch bridge of route-mounted drivers (RFC 0009 §4.4, Q10): the Web `Request` a Fetch server\n * (GraphQL Yoga) handles, built from the `HttpContext` of the route. Internal to `@znight/graphql`\n * (a candidate for `@znight/http` once a second user appears).\n *\n * - On `honoAdapter()` the native request already is a Web `Request`: it is handed over as is when\n *   its body was not read and cannot exceed the route's body limit (a `GET`, or a declared\n *   `content-length` within the limit), so nothing is copied.\n * - Otherwise (Node-style adapters, chunked bodies) a `Request` is built from the method, the URL,\n *   the headers and the body read by `ctx.rawBody()`: the route's body limit then answers with\n *   `HttpPlugin`'s 413 on every adapter, before the server sees the request. GraphQL servers buffer\n *   the body to parse it anyway, so reading it first costs no extra copy of note.\n */\nimport type { HttpContext } from '@znight/http'\n\n/** The Web `Request` of the route's request, read under `limit` bytes. */\nexport function fetchRequest(ctx: HttpContext, limit: number): Request | Promise<Request> {\n  const native = ctx.request\n  const method = ctx.method\n  const bodyless = method === 'GET' || method === 'HEAD'\n  if (native instanceof Request && !native.bodyUsed) {\n    if (bodyless) return native\n    const length = ctx.headers['content-length']\n    if (length !== undefined && ctx.headers['transfer-encoding'] === undefined) {\n      // past the limit, ctx.rawBody() below rejects with HttpPlugin's own 413\n      const declared = Number(length)\n      if (Number.isSafeInteger(declared) && declared >= 0 && declared <= limit) return native\n    }\n  }\n  const url = requestUrl(ctx)\n  const headers = requestHeaders(ctx)\n  if (bodyless) return new Request(url, { method, headers, signal: ctx.signal })\n  return ctx.rawBody().then(body => new Request(url, { method, headers, body, signal: ctx.signal }))\n}\n\n/** The absolute URL of the request: the raw target on the request's protocol and host. */\nfunction requestUrl(ctx: HttpContext): string {\n  const host = ctx.headers['host']\n  const target = ctx.url\n  if (host !== undefined && target.startsWith('/') && !target.startsWith('//')) {\n    const url = `${ctx.protocol}://${host}${target}`\n    if (URL.canParse(url)) return url\n  }\n  // no host header, or one a URL cannot hold: the path and query string still route the request\n  return new URL(target.startsWith('/') ? target.replace(/^\\/+/, '/') : `/${target}`, `${ctx.protocol}://localhost`)\n    .href\n}\n\nfunction requestHeaders(ctx: HttpContext): Headers {\n  const headers = new Headers()\n  const source = ctx.headers\n  for (const name in source) {\n    const value = source[name]\n    if (value !== undefined) headers.append(name, value)\n  }\n  return headers\n}\n","/**\n * `@znight/graphql/yoga`: the GraphQL Yoga driver (RFC 0009 §5.1). GraphQL Yoga 6 serves the schema\n * of `GraphQLPlugin` (its protocol, Envelop plugins, GraphiQL, SSE subscriptions) and hands every\n * document to Znight's engine, which parses it through its document cache, validates it with its\n * limits, and executes it with the application's guards, loaders, request scope, error masking and\n * hook. Mounted as plugin routes of `HttpPlugin`: the HTTP pipeline (request scope, hooks, guards,\n * CORS, security headers, drain) wraps every request, on every adapter, on Node.js and Bun.\n *\n * Needs `graphql-yoga` (an optional peer dependency of `@znight/graphql`), only loaded by this entry.\n */\nimport type { CoreLogger } from '@znight/core'\nimport type { HttpContext } from '@znight/http'\nimport type { DocumentNode, ExecutionArgs, ExecutionResult, GraphQLSchema, ValidationRule } from 'graphql'\nimport type {\n  GraphiQLOptions,\n  YogaInitialContext,\n  Plugin as YogaPlugin,\n  YogaServerInstance,\n  YogaServerOptions,\n} from 'graphql-yoga'\nimport type { GraphQLDriver, GraphQLDriverContext, GraphQLDriverRoute, GraphQLDriverRoutesContext } from './driver.ts'\nimport type { EngineExecuteOptions, GraphQLEngine } from './engine.ts'\nimport type { GraphQLContext } from './types.ts'\n\nimport { ErrorCode, ZnightError } from '@znight/core'\nimport { parseByteSize } from '@znight/http'\nimport { GraphQLError } from 'graphql'\nimport { createYoga } from 'graphql-yoga'\n\nimport { GraphQLErrorCode } from './errors.ts'\nimport { MEDIA, Media, type MediaKind, negotiate } from './transport/accept.ts'\nimport { fetchRequest } from './transport/fetch.ts'\nimport { isJsonRequest, notJson } from './transport/http.ts'\n\n/** The server context the driver gives Yoga: the `HttpContext` of the route, as `znight`. */\nexport interface YogaServerContext {\n  readonly znight: HttpContext\n}\n\n/**\n * Yoga's context of an operation: its initial context (`request`, `params`, `log`) and the server\n * context of the driver. What {@link yogaContext} returns.\n */\nexport type YogaContext = YogaInitialContext & YogaServerContext\n\n/** Options of Yoga the engine or `GraphQLPlugin` own (RFC 0009 §4.6): refused by {@link yogaDriver}. */\nconst OWNED = [\n  'schema',\n  'context',\n  'graphqlEndpoint',\n  'maskedErrors',\n  'cors',\n  'fetchAPI',\n  'maxRequestBodySize',\n  'parserAndValidationCache',\n  'requestId',\n  'healthCheckEndpoint',\n  'landingPage',\n  'disposeOnProcessTerminate',\n  'batching',\n  'multipart',\n] as const\n\n/** Where each owned option comes from, for the ZNIGHT066 hint. */\nconst OWNER: Readonly<Record<(typeof OWNED)[number], string>> = {\n  schema: 'the engine serves the schema GraphQLPlugin built',\n  context: \"resolvers get GraphQLContext; read Yoga's context with yogaContext(ctx)\",\n  graphqlEndpoint: 'set the path option of GraphQLPlugin',\n  maskedErrors: 'the engine masks errors once (exposeErrors, errorMappers)',\n  cors: 'set the cors option of HttpPlugin',\n  fetchAPI: \"the driver gives Yoga the runtime's own Fetch API\",\n  maxRequestBodySize: 'set http.bodyLimit of GraphQLPlugin',\n  parserAndValidationCache: 'the engine caches documents (the documentCache option of GraphQLPlugin)',\n  requestId: 'Yoga uses the request id of HttpPlugin',\n  healthCheckEndpoint: 'the driver only serves the GraphQL endpoint',\n  landingPage: 'the driver only serves the GraphQL endpoint',\n  disposeOnProcessTerminate: 'the application stops Yoga once HttpPlugin drained its requests',\n  batching:\n    'Send one operation per request: the operations of a batch would share the request scope and its GraphQLContext',\n  multipart:\n    'POST bodies are application/json only: form and multipart bodies skip the CORS preflight (CSRF); upload files through an HTTP controller',\n}\n\n/**\n * Options of {@link yogaDriver}: Yoga's own (`plugins`, `logging`, `allowedHeaders`...), except\n * those the engine, `GraphQLPlugin` or `HttpPlugin` own: the schema, the context, the endpoint\n * (`path`), masking (`exposeErrors`), CORS, the body limit (`http.bodyLimit`), the document cache,\n * the request id and the IDE switch (`graphiql`); and those the driver refuses: `batching` (one\n * operation per request scope) and `multipart` (JSON bodies only, see {@link yogaDriver}). Yoga's\n * `logging` is off unless set: requests and operations are logged by Znight.\n */\nexport interface YogaDriverOptions\n  extends Omit<YogaServerOptions<YogaServerContext, Record<string, unknown>>, (typeof OWNED)[number] | 'graphiql'> {\n  /**\n   * GraphiQL's options (title, default query...), when the `graphiql` option of `GraphQLPlugin` is\n   * on (it decides whether the IDE is served).\n   */\n  readonly graphiql?: GraphiQLOptions\n}\n\n/** A GraphQL Yoga driver: `GraphQLPlugin.configure({ driver: yogaDriver() })`. */\nexport interface YogaDriver extends GraphQLDriver {\n  readonly name: 'yoga'\n  /** The Yoga server, once started (`undefined` before `start()` and after `stop()`). */\n  readonly yoga: YogaServerInstance<YogaServerContext, Record<string, unknown>> | undefined\n}\n\n/**\n * The GraphQL Yoga driver (RFC 0009 §5.1): `GraphQLPlugin.configure({ driver: yogaDriver({ plugins }) })`.\n * Yoga handles the protocol and its Envelop plugins; the engine parses, validates and executes\n * (guards, loaders, request scope, masking, the `graphql:operation` hook). Plugins that replace\n * the engine's execution (`useGraphQlJit`) are refused: the operation fails with ZNIGHT066.\n *\n * Like the built-in transport, a `POST` body is `application/json` only (415 otherwise): form,\n * multipart and text bodies, which a cross-site page sends without a CORS preflight, never run\n * an operation (CSRF). Errors thrown outside the engine (by Yoga or an Envelop plugin) are masked\n * like the engine's (`Unexpected error.` unless `exposeErrors`) and logged.\n *\n * ```ts\n * GraphQLPlugin.configure({\n *   guards: [AccessGuard],\n *   driver: yogaDriver({ plugins: [useResponseCache({ session: () => null })] }),\n * })\n * ```\n */\nexport function yogaDriver(options: YogaDriverOptions = {}): YogaDriver {\n  if (options === null || typeof options !== 'object' || Array.isArray(options)) {\n    throw invalid('yogaDriver(): expected an options object', ['yogaDriver({ plugins: [...] })'])\n  }\n  for (const key of OWNED) {\n    if ((options as Record<string, unknown>)[key] !== undefined) {\n      throw invalid(`yogaDriver(): the ${key} option of Yoga is not available with Znight`, [OWNER[key]])\n    }\n  }\n  const graphiql: unknown = options.graphiql\n  if (graphiql !== undefined && (graphiql === null || typeof graphiql !== 'object')) {\n    throw invalid(\"yogaDriver(): graphiql takes GraphiQL's options\", [\n      'Turn the IDE on or off with the graphiql option of GraphQLPlugin',\n    ])\n  }\n  if (options.plugins !== undefined && !Array.isArray(options.plugins)) {\n    throw invalid('yogaDriver(): plugins must be an array of Envelop plugins', [])\n  }\n  return new Driver(options)\n}\n\n/**\n * Yoga's context of an operation received by the Yoga driver (RFC 0009 Q2): `GraphQLContext.serverContext`,\n * typed. For the rare resolver that needs Yoga's `request`, `params` or the context an Envelop\n * plugin extended; the HTTP request is `ctx.http`, the user a request-scoped provider.\n *\n * @throws ZnightError (ZNIGHT066) when the operation did not come through the Yoga driver.\n */\nexport function yogaContext<TContext extends Record<string, unknown> = Record<string, unknown>>(\n  ctx: GraphQLContext,\n): YogaContext & TContext {\n  const server = ctx?.serverContext as Partial<YogaContext> | undefined\n  if (server === null || typeof server !== 'object' || server.znight === undefined || server.params === undefined) {\n    throw invalid('yogaContext(): the operation was not received by the Yoga driver', [\n      'yogaContext() reads GraphQLContext.serverContext of operations served by yogaDriver()',\n    ])\n  }\n  return server as YogaContext & TContext\n}\n\n// ------------------------------------------------------------------------------------------------\n\ntype Yoga = YogaServerInstance<YogaServerContext, Record<string, unknown>>\n\nconst SSE: EngineExecuteOptions = Object.freeze({ transport: 'sse' })\nconst DEFAULT_BODY_LIMIT = 1024 * 1024\n\nclass Driver implements YogaDriver {\n  readonly name = 'yoga' as const\n  readonly #options: YogaDriverOptions\n  #yoga: Yoga | undefined\n  /** Stopped: the application stops, requests that still reach the driver get a 503. */\n  #stopped = false\n  #get = true\n  #ide = false\n  #limit = DEFAULT_BODY_LIMIT\n\n  constructor(options: YogaDriverOptions) {\n    this.#options = options\n  }\n\n  get yoga(): Yoga | undefined {\n    return this.#yoga\n  }\n\n  /** `GET` and `POST` on the path (`GET` answers 405 when neither queries over `GET` nor GraphiQL apply). */\n  routes(context: GraphQLDriverRoutesContext): readonly GraphQLDriverRoute[] {\n    return [\n      { method: 'GET', path: context.path, name: 'yoga', handler: this.#getHandler },\n      { method: 'POST', path: context.path, name: 'yoga', handler: this.#postHandler },\n    ]\n  }\n\n  start(engine: GraphQLEngine, context: GraphQLDriverContext): void {\n    if (this.#yoga !== undefined) {\n      throw invalid('yogaDriver(): this driver already serves an application', [\n        'Create one driver per application: GraphQLPlugin.configure({ driver: yogaDriver() })',\n      ])\n    }\n    const settings = engine.settings\n    const http = settings.http\n    this.#get = http !== false && http.get\n    this.#ide = settings.ide\n    this.#limit = http === false ? DEFAULT_BODY_LIMIT : (parseByteSize(http.bodyLimit) ?? DEFAULT_BODY_LIMIT)\n    const { graphiql, plugins = [], logging = false, ...rest } = this.#options\n    const engineFns = engineFunctions(engine, context.logger)\n    this.#yoga = createYoga<YogaServerContext, Record<string, unknown>>({\n      ...rest,\n      logging,\n      schema: engine.schema,\n      graphqlEndpoint: settings.path,\n      graphiql: settings.ide ? (graphiql ?? true) : false,\n      landingPage: false,\n      healthCheckEndpoint: UNREACHABLE,\n      // the engine masked its errors (kept as they are); those thrown outside of it are masked here\n      maskedErrors: { maskError: outsideErrors(settings.exposeErrors, context.logger) },\n      batching: false,\n      multipart: false,\n      cors: false, // HttpPlugin's CORS\n      maxRequestBodySize: this.#limit,\n      parserAndValidationCache: false, // the engine's document cache\n      disposeOnProcessTerminate: false,\n      requestId: { generateRequestId: requestIdOf, trustHeader: false },\n      fetchAPI: fetchApi(),\n      plugins: [engineFns.plugin, ...plugins, engineFns.guard],\n    })\n    this.#stopped = false\n  }\n\n  /** Called once `HttpPlugin` drained the requests (`GraphQLPlugin.onDispose`). */\n  async stop(): Promise<void> {\n    const yoga = this.#yoga\n    this.#yoga = undefined\n    this.#stopped = true\n    await yoga?.dispose()\n  }\n\n  readonly #handle = (ctx: HttpContext): Response | Promise<Response> => {\n    const yoga = this.#yoga\n    if (yoga === undefined) {\n      if (this.#stopped) return shuttingDown()\n      throw notStarted()\n    }\n    const request = fetchRequest(ctx, this.#limit)\n    const server: YogaServerContext = { znight: ctx }\n    const response =\n      request instanceof Request ? yoga.fetch(request, server) : request.then(built => yoga.fetch(built, server))\n    return response instanceof Response ? response : Promise.resolve(response).then(sendable)\n  }\n\n  /** `POST`: JSON bodies only (the 415 of the built-in transport otherwise: no CSRF). */\n  readonly #postHandler = (ctx: HttpContext): unknown => {\n    const headers = ctx.headers\n    if (!isJsonRequest(headers['content-type'])) return notJson(jsonMedia(headers['accept']))\n    return this.#handle(ctx)\n  }\n\n  /** `GET`: Yoga's, or 405 when queries over `GET` are off (GraphiQL pages still served). */\n  readonly #getHandler = (ctx: HttpContext): Response | Promise<Response> => {\n    if (this.#get || (this.#ide && acceptsHtml(ctx))) return this.#handle(ctx)\n    return getNotAllowed()\n  }\n}\n\n/** A path no request reaches: the driver's routes only serve the GraphQL endpoint. */\nconst UNREACHABLE = '/.znight/unreachable'\n\n/**\n * The Fetch API of the runtime: on Node.js, Yoga would otherwise use the ponyfills of\n * `@whatwg-node/fetch`, whose `Response` objects `HttpPlugin` cannot send.\n */\nfunction fetchApi(): Record<string, unknown> {\n  return {\n    fetch: globalThis.fetch,\n    Request: globalThis.Request,\n    Response: globalThis.Response,\n    Headers: globalThis.Headers,\n    FormData: globalThis.FormData,\n    ReadableStream: globalThis.ReadableStream,\n    WritableStream: globalThis.WritableStream,\n    TransformStream: globalThis.TransformStream,\n    CompressionStream: globalThis.CompressionStream,\n    DecompressionStream: globalThis.DecompressionStream,\n    TextDecoderStream: globalThis.TextDecoderStream,\n    TextEncoderStream: globalThis.TextEncoderStream,\n    Blob: globalThis.Blob,\n    File: globalThis.File,\n    TextEncoder: globalThis.TextEncoder,\n    TextDecoder: globalThis.TextDecoder,\n    URL: globalThis.URL,\n    URLSearchParams: globalThis.URLSearchParams,\n    btoa: globalThis.btoa,\n  }\n}\n\n/**\n * A `Response` `HttpPlugin` recognises: `@hono/node-server` replaces the global `Response` when it\n * starts listening, after Yoga captured the runtime's own; such a response is rebuilt on the\n * global class (same status, headers and body stream).\n */\nfunction sendable(response: Response): Response {\n  if (response instanceof Response) return response\n  const foreign: { readonly body: ReadableStream<Uint8Array> | null } & ResponseInit = response\n  return new Response(foreign.body, foreign)\n}\n\n/** The request id of `HttpPlugin` (a UUID for a request handed to `yoga.fetch()` directly). */\nfunction requestIdOf(payload: { readonly context: Partial<YogaServerContext> }): string {\n  return payload.context.znight?.requestId ?? crypto.randomUUID()\n}\n\nfunction acceptsHtml(ctx: HttpContext): boolean {\n  return ctx.headers['accept']?.includes('text/html') === true\n}\n\n/** The JSON type a refusal is written in, like the built-in transport: `application/json` unless the client prefers `application/graphql-response+json`. */\nfunction jsonMedia(accept: string | undefined): MediaKind {\n  const media = (negotiate(accept, (1 << Media.GraphQLJson) | (1 << Media.Json)) & MEDIA) as MediaKind\n  return media === Media.None ? Media.Json : media\n}\n\n/** A request reaching the driver once it stopped (after `HttpPlugin` drained): 503. */\nfunction shuttingDown(): Response {\n  return Response.json(\n    {\n      errors: [\n        {\n          message: 'The server is shutting down, retry later',\n          extensions: { code: GraphQLErrorCode.ServiceUnavailable },\n        },\n      ],\n    },\n    { status: 503 },\n  )\n}\n\n/**\n * Yoga's `maskError`: the errors of the engine (masked already) and the `GraphQLError`s thrown on\n * purpose (by Yoga or a plugin, with a code) are kept; any other error, thrown outside the engine\n * (an Envelop plugin's hook, Yoga itself), is logged and masked like the engine masks it\n * (`Unexpected error.`, its message with `exposeErrors`). Yoga then answers 500 for a request error.\n */\nfunction outsideErrors(expose: boolean, logger: CoreLogger): (error: unknown, message: string) => Error {\n  return (error, message) => {\n    if (isOriginalGraphQLError(error)) return error\n    logger.error('GraphQL: an error was thrown outside the engine (by Yoga or an Envelop plugin)', { err: error })\n    const original = error instanceof Error ? error : new Error(String(error))\n    return new GraphQLError(expose ? original.message : message, {\n      originalError: original,\n      extensions: { code: GraphQLErrorCode.InternalServerError },\n    })\n  }\n}\n\n/** A `GraphQLError` that wraps no other error: the engine's, or thrown on purpose. */\nfunction isOriginalGraphQLError(error: unknown): error is GraphQLError {\n  if (!(error instanceof GraphQLError)) return false\n  const original = error.originalError\n  return original === undefined || original === null || isOriginalGraphQLError(original)\n}\n\nfunction getNotAllowed(): Response {\n  return Response.json(\n    {\n      errors: [\n        { message: 'GraphQL operations are sent with POST on this endpoint', extensions: { code: 'BAD_REQUEST' } },\n      ],\n    },\n    { status: 405, headers: { allow: 'POST' } },\n  )\n}\n\n/** Envelop's onExecute payload (the part the driver reads). */\ninterface ExecutePayload {\n  readonly executeFn: unknown\n  readonly context: unknown\n  setExecuteFn(fn: (args: ExecutionArgs) => unknown): void\n}\n\ninterface SubscribePayload {\n  readonly subscribeFn: unknown\n  readonly context: unknown\n  setSubscribeFn(fn: (args: ExecutionArgs) => unknown): void\n}\n\ninterface ResultPayload {\n  readonly result: unknown\n  setResult(result: ExecutionResult): void\n}\n\n/**\n * The Envelop plugins of the engine: one installed before the application's plugins, which makes\n * the engine Yoga's `parse`, `validate`, `execute` and `subscribe` (Envelop's `useEngine`), and a\n * guard installed after them, which refuses an operation that a plugin executed elsewhere\n * (`useGraphQlJit`): its resolvers would not get the `GraphQLContext`. Plugins wrapping the\n * execution (`useResponseCache`) keep working: they call the engine.\n */\nfunction engineFunctions(engine: GraphQLEngine, logger: CoreLogger): { plugin: YogaPlugin; guard: YogaPlugin } {\n  const parse = engine.parse\n  const validate = (schema: GraphQLSchema, document: DocumentNode, rules?: readonly ValidationRule[]) =>\n    engine.validate(schema, document, rules)\n  // marks the contexts the engine ran, once a plugin wrapped or replaced the execution\n  let watching = false\n  const ran = new WeakSet<object>()\n  const execute = (args: ExecutionArgs): unknown => {\n    if (watching) mark(ran, args.contextValue)\n    return engine.execute(args)\n  }\n  const subscribe = (args: ExecutionArgs): unknown => {\n    if (watching) mark(ran, args.contextValue)\n    return engine.subscribe(args, SSE)\n  }\n  let reported = false\n  const bypassed = (): ExecutionResult => {\n    const error = invalid(\n      'GraphQLPlugin: a Yoga plugin executed the operation instead of the Znight engine (useGraphQlJit?)',\n      ['Remove the plugin: resolvers, guards and loaders only run on the engine'],\n    )\n    if (!reported) {\n      reported = true\n      logger.error(error.message, { error })\n    }\n    return { errors: [new GraphQLError(error.message, { extensions: { code: 'INTERNAL_SERVER_ERROR' } })] }\n  }\n  const plugin = {\n    onParse: ({ setParseFn }: { setParseFn(fn: unknown): void }) => setParseFn(parse),\n    onValidate: ({ setValidationFn }: { setValidationFn(fn: unknown): void }) => setValidationFn(validate),\n    onExecute: ({ setExecuteFn }: ExecutePayload) => setExecuteFn(execute),\n    onSubscribe: ({ setSubscribeFn }: SubscribePayload) => setSubscribeFn(subscribe),\n  }\n  const guard = {\n    onExecute: ({ executeFn, context }: ExecutePayload) => {\n      if (executeFn === execute) return undefined\n      watching = true\n      return {\n        onExecuteDone: ({ setResult }: ResultPayload) => {\n          if (!ran.has(context as object)) setResult(bypassed())\n        },\n      }\n    },\n    onSubscribe: ({ subscribeFn, context }: SubscribePayload) => {\n      if (subscribeFn === subscribe) return undefined\n      watching = true\n      return {\n        onSubscribeResult: ({ setResult }: ResultPayload) => {\n          if (!ran.has(context as object)) setResult(bypassed())\n        },\n      }\n    },\n  }\n  return { plugin: plugin as YogaPlugin, guard: guard as YogaPlugin }\n}\n\nfunction mark(ran: WeakSet<object>, context: unknown): void {\n  if (context !== null && typeof context === 'object') ran.add(context)\n}\n\nfunction notStarted(): ZnightError {\n  return new ZnightError(ErrorCode.LifecycleFailed, 'The Yoga driver is not started yet', {\n    hints: ['GraphQLPlugin starts its driver in onBootstrap'],\n  })\n}\n\nfunction invalid(message: string, hints: readonly string[]): ZnightError {\n  return new ZnightError(ErrorCode.InvalidGraphQLSetup, message, { hints: [...hints] })\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@znight/graphql",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Znight GraphQL: code-first GraphQL whose schema is derived from TypeScript types at build time, on graphql-js 17",
   "license": "MIT",
   "author": "Ugho STEPHAN",
@@ -11,7 +11,7 @@
     "directory": "packages/graphql"
   },
   "bugs": "https://github.com/znight-org/znight/issues",
-  "keywords": ["znight", "graphql", "code-first", "dataloader", "subscriptions", "sse"],
+  "keywords": ["znight", "graphql", "code-first", "dataloader", "subscriptions", "sse", "yoga"],
   "type": "module",
   "sideEffects": false,
   "engines": {
@@ -33,6 +33,11 @@
       "types": "./dist/testing.d.mts",
       "default": "./dist/testing.mjs"
     },
+    "./yoga": {
+      "@znight/source": "./src/yoga.ts",
+      "types": "./dist/yoga.d.mts",
+      "default": "./dist/yoga.mjs"
+    },
     "./package.json": "./package.json"
   },
   "types": "./dist/index.d.mts",
@@ -40,20 +45,22 @@
   "scripts": {
     "build": "tsdown",
     "typecheck": "tsc --noEmit && tsc --noEmit -p test",
-    "test": "bun test --conditions=@znight/source test"
+    "test": "bun test --conditions=@znight/source test",
+    "test:integration": "ZNIGHT_INTEGRATION=1 bun test --conditions=@znight/source --timeout 180000 test/recipes/redis-pubsub.integration.test.ts"
   },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@znight/core": "0.2.1",
+    "@znight/core": "0.3.0",
     "dataloader": "^2.2.3"
   },
   "peerDependencies": {
-    "@znight/http": "^0.2.1",
-    "@znight/compiler": "^0.2.1",
-    "@znight/testing": "^0.2.1",
-    "graphql": "^17.0.2"
+    "@znight/http": "^0.3.0",
+    "@znight/compiler": "^0.3.0",
+    "@znight/testing": "^0.3.0",
+    "graphql": "^17.0.2",
+    "graphql-yoga": "^6.0.1"
   },
   "peerDependenciesMeta": {
     "@znight/compiler": {
@@ -61,15 +68,22 @@
     },
     "@znight/testing": {
       "optional": true
+    },
+    "graphql-yoga": {
+      "optional": true
     }
   },
   "devDependencies": {
-    "@znight/http": "0.2.1",
-    "@znight/compiler": "0.2.1",
-    "@znight/testing": "0.2.1",
+    "@testcontainers/redis": "12.2.1",
+    "@znight/compiler": "0.3.0",
+    "@znight/http": "0.3.0",
+    "@znight/testing": "0.3.0",
     "graphql": "17.0.2",
     "graphql-http": "1.23.1",
     "graphql-sse": "2.6.3",
+    "graphql-yoga": "6.0.1",
+    "ioredis": "6.0.0",
+    "testcontainers": "12.2.1",
     "valibot": "1.5.0",
     "zod": "4.6.7"
   },