@znight/graphql 0.0.0 → 0.2.0

package/dist/testing.d.mts

@@ -0,0 +1,101 @@
+import { f as LoaderKey, m as LoaderValue, r as BatchLoader, t as BatchLoad } from "./types-CgbV9LjD.mjs";
+import { GraphQLFormattedError } from "graphql";
+import { MockFunction, TestApp } from "@znight/testing";
+/** An operation for {@link executeOperation} and {@link subscribeOperation}. */
+export interface OperationRequest {
+  readonly query: string;
+  readonly variables?: Readonly<Record<string, unknown>>;
+  readonly operationName?: string;
+  readonly extensions?: Readonly<Record<string, unknown>>;
+  /**
+   * Request headers (`x-api-key`, `accept`...), merged over the defaults (`content-type:
+   * application/json`, and `accept: application/graphql-response+json, application/json;q=0.9`
+   * or `text/event-stream`). Ignored without HTTP transport.
+   */
+  readonly headers?: Readonly<Record<string, string>>;
+}
+/** A GraphQL result: `data`, `errors` and `extensions` when present. */
+export interface OperationResult<TData = Record<string, unknown>> {
+  readonly data?: TData | null;
+  readonly errors?: readonly GraphQLFormattedError[];
+  readonly extensions?: Readonly<Record<string, unknown>>;
+}
+/** What {@link executeOperation} resolves with. */
+export interface OperationResponse<TData = Record<string, unknown>> extends OperationResult<TData> {
+  /**
+   * The HTTP status: 200 for an executed operation (field errors included), 400 for a request
+   * error (the default `accept` is `application/graphql-response+json`), 403 for an HTTP guard...
+   * Without HTTP transport, the status the endpoint would answer.
+   */
+  readonly status: number;
+  readonly headers: Readonly<Record<string, string | readonly string[] | undefined>>;
+  /** The raw body (an HTTP error body is not a GraphQL result: `data` and `errors` are then absent). */
+  readonly body: string;
+}
+/** Options of {@link OperationStream.next}. */
+export interface OperationStreamWaitOptions {
+  /** Maximum wait for the next result (ms). Default 2 000. */
+  readonly timeoutMs?: number;
+}
+/**
+ * The results of {@link subscribeOperation}, one per `next` event. Ends after `complete` (or the
+ * single result of a query, or a request error). `return()` disconnects: the server sees a client
+ * abort (`ctx.signal`, then the source's `return()`).
+ */
+export interface OperationStream<TData = Record<string, unknown>> extends AsyncIterableIterator<OperationResult<TData>>, AsyncDisposable {
+  /** HTTP status of the stream (200), or of a request error (400, 405, 503...). */
+  readonly status: number;
+  readonly headers: Readonly<Record<string, string | readonly string[] | undefined>>;
+  /** The next result. Rejects when none arrives within `timeoutMs` (2 000 ms by default). */
+  next(options?: OperationStreamWaitOptions): Promise<IteratorResult<OperationResult<TData>, undefined>>;
+  /** Ends the stream (disconnects). */
+  return(): Promise<IteratorResult<OperationResult<TData>, undefined>>;
+}
+/** The application `executeOperation()` and `subscribeOperation()` run against: a `TestApp`. */
+export type GraphQLTestApp = Pick<TestApp, "app" | "inject" | "injectStream">;
+/**
+ * Executes a query or a mutation through the whole HTTP pipeline (`app.inject()`: `POST` on the
+ * endpoint), or through `GraphQLPlugin` without HTTP transport.
+ *
+ * ```ts
+ * const res = await executeOperation(app, { query: '{ books { title } }', headers: { 'x-api-key': KEY } })
+ * expect(res.status).toBe(200)
+ * expect(res.errors).toBeUndefined()
+ * ```
+ */
+export declare function executeOperation<TData = Record<string, unknown>>(app: GraphQLTestApp, request: OperationRequest): Promise<OperationResponse<TData>>;
+/**
+ * Starts an operation as a stream: GraphQL over SSE in memory (`app.injectStream()`: `POST` with
+ * `accept: text/event-stream`), or `GraphQLPlugin.subscribe()` without HTTP transport (no HTTP
+ * guards then). Resolves once the subscription is established: its source has started (a resolver
+ * written as an async generator has subscribed to the PubSub, when it subscribes before its first
+ * `await`), so events published from then on
+ * are received, even before the first `next()`.
+ *
+ * ```ts
+ * await using events = await subscribeOperation(app, { query: 'subscription { bookAdded { title } }' })
+ * await executeOperation(app, { query: ADD_DUNE })
+ * expect((await events.next()).value).toEqual({ data: { bookAdded: { title: 'Dune' } } })
+ * ```
+ */
+export declare function subscribeOperation<TData = Record<string, unknown>>(app: GraphQLTestApp, request: OperationRequest): Promise<OperationStream<TData>>;
+/** Options of {@link fakeLoader}: what a key resolves to. */
+export type FakeLoaderValues<K, V> = Readonly<Record<string, V | Error>> | ReadonlyMap<K, V | Error> | ((key: K) => V | Error | Promise<V | Error>);
+/** A `Loader<L>` built by {@link fakeLoader}: `load` and `loadMany` are spies. */
+export interface FakeLoader<K, V> extends BatchLoader<K, V> {
+  readonly load: MockFunction<(key: K) => Promise<V>> & ((key: K) => Promise<V>);
+  readonly loadMany: MockFunction<(keys: readonly K[]) => Promise<(V | Error)[]>> & ((keys: readonly K[]) => Promise<(V | Error)[]>);
+}
+/**
+ * A `Loader<L>` for unit tests of resolvers (with `TestBed`), answering from `values` (a record by
+ * key, a map, or a function of the key; an `Error` value fails that key). `load` and `loadMany` are
+ * spies; a missing key rejects.
+ *
+ * ```ts
+ * const authors = fakeLoader<AuthorsById>({ [herbert.id]: herbert })
+ * expect(await instance.author(dune, authors)).toBe(herbert)
+ * expect(authors.load).toHaveBeenCalledWith(herbert.id)
+ * ```
+ */
+export declare function fakeLoader<L extends BatchLoad<unknown, unknown>>(values: FakeLoaderValues<LoaderKey<L>, LoaderValue<L>>): FakeLoader<LoaderKey<L>, LoaderValue<L>>;
+//# sourceMappingURL=testing.d.mts.map

package/dist/testing.mjs

@@ -0,0 +1,306 @@
+import { n as endpointOf, r as executorOf } from "./plugin-BdBxr5NQ.mjs";
+import { parseSseStream } from "@znight/http";
+import { resolveMockFn } from "@znight/testing";
+// src/testing.ts
+const DEFAULT_TIMEOUT_MS = 2e3;
+const RESPONSE_ACCEPT = "application/graphql-response+json, application/json;q=0.9";
+const DONE = Object.freeze({
+	done: true,
+	value: void 0
+});
+/**
+* Executes a query or a mutation through the whole HTTP pipeline (`app.inject()`: `POST` on the
+* endpoint), or through `GraphQLPlugin` without HTTP transport.
+*
+* ```ts
+* const res = await executeOperation(app, { query: '{ books { title } }', headers: { 'x-api-key': KEY } })
+* expect(res.status).toBe(200)
+* expect(res.errors).toBeUndefined()
+* ```
+*/
+async function executeOperation(app, request) {
+	const plugin = graphqlPlugin(app, "executeOperation()");
+	const body = operationBody(request, "executeOperation()");
+	const endpoint = endpointOf(plugin);
+	if (endpoint === void 0) {
+		const response = await executorOf(plugin).execute(body);
+		return {
+			...pick(response.result),
+			status: response.status,
+			headers: { ...response.headers },
+			body: JSON.stringify(response.result)
+		};
+	}
+	const response = await app.inject({
+		method: "POST",
+		url: endpoint,
+		headers: headers(request, RESPONSE_ACCEPT),
+		body: JSON.stringify(body)
+	});
+	return {
+		...parseResult(response.body),
+		status: response.status,
+		headers: response.headers,
+		body: response.body
+	};
+}
+/**
+* Starts an operation as a stream: GraphQL over SSE in memory (`app.injectStream()`: `POST` with
+* `accept: text/event-stream`), or `GraphQLPlugin.subscribe()` without HTTP transport (no HTTP
+* guards then). Resolves once the subscription is established: its source has started (a resolver
+* written as an async generator has subscribed to the PubSub, when it subscribes before its first
+* `await`), so events published from then on
+* are received, even before the first `next()`.
+*
+* ```ts
+* await using events = await subscribeOperation(app, { query: 'subscription { bookAdded { title } }' })
+* await executeOperation(app, { query: ADD_DUNE })
+* expect((await events.next()).value).toEqual({ data: { bookAdded: { title: 'Dune' } } })
+* ```
+*/
+async function subscribeOperation(app, request) {
+	const plugin = graphqlPlugin(app, "subscribeOperation()");
+	const body = operationBody(request, "subscribeOperation()");
+	const endpoint = endpointOf(plugin);
+	const label = describeOperation(body.query);
+	if (endpoint === void 0) {
+		const outcome = await executorOf(plugin).subscribe(body);
+		if ("status" in outcome) return new SingleResult(outcome.status, {}, pick(outcome.result));
+		return new Results(200, {}, directSource(outcome), label);
+	}
+	const response = await app.injectStream({
+		method: "POST",
+		url: endpoint,
+		headers: headers(request, "text/event-stream"),
+		body: JSON.stringify(body)
+	});
+	const type = response.headers["content-type"];
+	if (typeof type !== "string" || !type.startsWith("text/event-stream")) {
+		const text = await new Response(response.body).text();
+		return new SingleResult(response.status, response.headers, parseResult(text));
+	}
+	return new Results(response.status, response.headers, sseSource(parseSseStream(response.body)), label);
+}
+/**
+* A `Loader<L>` for unit tests of resolvers (with `TestBed`), answering from `values` (a record by
+* key, a map, or a function of the key; an `Error` value fails that key). `load` and `loadMany` are
+* spies; a missing key rejects.
+*
+* ```ts
+* const authors = fakeLoader<AuthorsById>({ [herbert.id]: herbert })
+* expect(await instance.author(dune, authors)).toBe(herbert)
+* expect(authors.load).toHaveBeenCalledWith(herbert.id)
+* ```
+*/
+function fakeLoader(values) {
+	const resolve = lookup(values);
+	const cache = /* @__PURE__ */ new Map();
+	const loadOne = (key) => {
+		const cached = cache.get(key);
+		if (cached !== void 0) return cached;
+		const loaded = Promise.resolve().then(() => resolve(key)).then((value) => value instanceof Error ? Promise.reject(value) : value);
+		cache.set(key, loaded);
+		return loaded;
+	};
+	const create = resolveMockFn().create;
+	return {
+		load: create((key) => loadOne(key)),
+		loadMany: create((keys) => Promise.all(keys.map((key) => loadOne(key).catch((error) => asError(error))))),
+		clear(key) {
+			cache.delete(key);
+			return this;
+		},
+		clearAll() {
+			cache.clear();
+			return this;
+		},
+		prime(key, value) {
+			if (!cache.has(key)) {
+				const primed = value instanceof Error ? Promise.reject(value) : Promise.resolve(value);
+				primed.catch(() => void 0);
+				cache.set(key, primed);
+			}
+			return this;
+		}
+	};
+}
+function graphqlPlugin(app, what) {
+	const plugin = app?.app?.getPlugin("graphql");
+	if (plugin === void 0) throw new TypeError(`${what} expects a TestApp whose plugins include GraphQLPlugin.configure()`);
+	return plugin;
+}
+function operationBody(request, what) {
+	if (request === null || typeof request !== "object" || typeof request.query !== "string") throw new TypeError(`${what} expects { query, variables?, operationName?, extensions?, headers? }`);
+	return {
+		query: request.query,
+		...request.variables === void 0 ? {} : { variables: request.variables },
+		...request.operationName === void 0 ? {} : { operationName: request.operationName },
+		...request.extensions === void 0 ? {} : { extensions: request.extensions }
+	};
+}
+/** The request headers: the defaults, then the operation's (names lower-cased, so they replace the defaults). */
+function headers(request, accept) {
+	const result = {
+		"content-type": "application/json",
+		accept
+	};
+	for (const [name, value] of Object.entries(request.headers ?? {})) result[name.toLowerCase()] = value;
+	return result;
+}
+function pick(result) {
+	return {
+		..."data" in result ? { data: result.data } : {},
+		...result.errors === void 0 ? {} : { errors: result.errors },
+		...result.extensions === void 0 ? {} : { extensions: result.extensions }
+	};
+}
+/** The GraphQL result of a body; `{}` when it is not one (an HTTP error body, a page). */
+function parseResult(body) {
+	let parsed;
+	try {
+		parsed = JSON.parse(body);
+	} catch {
+		return {};
+	}
+	if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) return {};
+	const result = parsed;
+	if (!("data" in result) && !Array.isArray(result.errors)) return {};
+	return pick(result);
+}
+function describeOperation(query) {
+	const text = query.replace(/\s+/g, " ").trim();
+	return text.length > 60 ? `${text.slice(0, 60)}…` : text;
+}
+function asError(error) {
+	return error instanceof Error ? error : new Error(String(error));
+}
+function lookup(values) {
+	if (typeof values === "function") return values;
+	if (values instanceof Map) return (key) => values.has(key) ? values.get(key) : missing(key);
+	const record = values;
+	return (key) => Object.hasOwn(record, String(key)) ? record[String(key)] : missing(key);
+}
+function missing(key) {
+	return /* @__PURE__ */ new Error(`fakeLoader(): no value for the key ${JSON.stringify(key) ?? String(key)}`);
+}
+function directSource(stream) {
+	return {
+		next: async () => {
+			const step = await stream.next();
+			return step.done === true ? void 0 : step.value;
+		},
+		close: async () => {
+			await stream.return();
+		}
+	};
+}
+/** The `next` events of an event stream, until `complete` (comments, `retry` and other events skipped). */
+function sseSource(items) {
+	return {
+		next: async () => {
+			for (;;) {
+				const step = await items.next();
+				if (step.done === true) return void 0;
+				const item = step.value;
+				if (item.type !== "event") continue;
+				if (item.event === "complete") return void 0;
+				if (item.event === "next") return JSON.parse(item.data);
+			}
+		},
+		close: async () => {
+			await items.return?.();
+		}
+	};
+}
+/** The stream of a subscription (or of a query sent as a stream). */
+var Results = class {
+	status;
+	headers;
+	#source;
+	#label;
+	/** A read still pending after a timeout: the next call waits for it, so no result is lost. */
+	#pending;
+	#ended = false;
+	constructor(status, headers, source, label) {
+		this.status = status;
+		this.headers = headers;
+		this.#source = source;
+		this.#label = label;
+	}
+	async next(options = {}) {
+		if (this.#ended) return DONE;
+		const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+		this.#pending ??= this.#source.next();
+		const pending = this.#pending;
+		let timer;
+		const timeout = new Promise((resolve) => {
+			timer = setTimeout(() => resolve(TIMEOUT), timeoutMs);
+		});
+		let result;
+		try {
+			result = await Promise.race([pending, timeout]);
+		} catch (error) {
+			this.#pending = void 0;
+			await this.return();
+			throw error;
+		} finally {
+			clearTimeout(timer);
+		}
+		if (result === TIMEOUT) throw new Error(`subscribeOperation(): no result within ${timeoutMs} ms for ${this.#label}`);
+		this.#pending = void 0;
+		if (result === void 0) {
+			await this.return();
+			return DONE;
+		}
+		return {
+			done: false,
+			value: pick(result)
+		};
+	}
+	async return() {
+		if (!this.#ended) {
+			this.#ended = true;
+			await this.#source.close();
+		}
+		return DONE;
+	}
+	[Symbol.asyncIterator]() {
+		return this;
+	}
+	[Symbol.asyncDispose]() {
+		return this.return().then(() => void 0);
+	}
+};
+const TIMEOUT = Symbol("timeout");
+/** A request error (or a query's result without HTTP transport): one result, then the end. */
+var SingleResult = class {
+	status;
+	headers;
+	#result;
+	constructor(status, headers, result) {
+		this.status = status;
+		this.headers = headers;
+		this.#result = result;
+	}
+	next() {
+		const result = this.#result;
+		this.#result = void 0;
+		return Promise.resolve(result === void 0 ? DONE : {
+			done: false,
+			value: result
+		});
+	}
+	return() {
+		this.#result = void 0;
+		return Promise.resolve(DONE);
+	}
+	[Symbol.asyncIterator]() {
+		return this;
+	}
+	[Symbol.asyncDispose]() {
+		return Promise.resolve();
+	}
+};
+export { executeOperation, fakeLoader, subscribeOperation };
+
+//# sourceMappingURL=testing.mjs.map

package/dist/testing.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.mjs","names":[],"sources":["../src/testing.ts"],"sourcesContent":["/**\n * `@znight/graphql/testing`: test helpers for GraphQL applications (RFC 0005 §5.12).\n *\n * - `executeOperation()` sends an operation through the whole HTTP pipeline of a `TestApp`\n *   (`app.inject()`: guards, hooks, every adapter) or, without HTTP transport, through\n *   `GraphQLPlugin.execute()`;\n * - `subscribeOperation()` streams an operation over GraphQL over SSE in memory, or through\n *   `GraphQLPlugin.subscribe()` without HTTP transport;\n * - `fakeLoader()` builds a `Loader<L>` whose `load` / `loadMany` are spies of the running test\n *   framework (`bun:test`, Vitest, Jest, or the built-in spy of `@znight/testing`).\n *\n * Needs `@znight/testing` (an optional peer dependency of `@znight/graphql`).\n */\nimport type { Plugin } from '@znight/core'\nimport type { SseItem } from '@znight/http'\nimport type { MockFunction, TestApp } from '@znight/testing'\nimport type { FormattedExecutionResult, GraphQLFormattedError } from 'graphql'\nimport type { GraphQLRequest, GraphQLResultStream } from './execution.ts'\nimport type { BatchLoad, BatchLoader, LoaderKey, LoaderValue } from './types.ts'\n\nimport { parseSseStream } from '@znight/http'\nimport { resolveMockFn } from '@znight/testing'\n\nimport { endpointOf, executorOf, type GraphQLPlugin } from './plugin.ts'\n\n/** An operation for {@link executeOperation} and {@link subscribeOperation}. */\nexport interface OperationRequest {\n  readonly query: string\n  readonly variables?: Readonly<Record<string, unknown>>\n  readonly operationName?: string\n  readonly extensions?: Readonly<Record<string, unknown>>\n  /**\n   * Request headers (`x-api-key`, `accept`...), merged over the defaults (`content-type:\n   * application/json`, and `accept: application/graphql-response+json, application/json;q=0.9`\n   * or `text/event-stream`). Ignored without HTTP transport.\n   */\n  readonly headers?: Readonly<Record<string, string>>\n}\n\n/** A GraphQL result: `data`, `errors` and `extensions` when present. */\nexport interface OperationResult<TData = Record<string, unknown>> {\n  readonly data?: TData | null\n  readonly errors?: readonly GraphQLFormattedError[]\n  readonly extensions?: Readonly<Record<string, unknown>>\n}\n\n/** What {@link executeOperation} resolves with. */\nexport interface OperationResponse<TData = Record<string, unknown>> extends OperationResult<TData> {\n  /**\n   * The HTTP status: 200 for an executed operation (field errors included), 400 for a request\n   * error (the default `accept` is `application/graphql-response+json`), 403 for an HTTP guard...\n   * Without HTTP transport, the status the endpoint would answer.\n   */\n  readonly status: number\n  readonly headers: Readonly<Record<string, string | readonly string[] | undefined>>\n  /** The raw body (an HTTP error body is not a GraphQL result: `data` and `errors` are then absent). */\n  readonly body: string\n}\n\n/** Options of {@link OperationStream.next}. */\nexport interface OperationStreamWaitOptions {\n  /** Maximum wait for the next result (ms). Default 2 000. */\n  readonly timeoutMs?: number\n}\n\n/**\n * The results of {@link subscribeOperation}, one per `next` event. Ends after `complete` (or the\n * single result of a query, or a request error). `return()` disconnects: the server sees a client\n * abort (`ctx.signal`, then the source's `return()`).\n */\nexport interface OperationStream<TData = Record<string, unknown>>\n  extends AsyncIterableIterator<OperationResult<TData>>,\n    AsyncDisposable {\n  /** HTTP status of the stream (200), or of a request error (400, 405, 503...). */\n  readonly status: number\n  readonly headers: Readonly<Record<string, string | readonly string[] | undefined>>\n  /** The next result. Rejects when none arrives within `timeoutMs` (2 000 ms by default). */\n  next(options?: OperationStreamWaitOptions): Promise<IteratorResult<OperationResult<TData>, undefined>>\n  /** Ends the stream (disconnects). */\n  return(): Promise<IteratorResult<OperationResult<TData>, undefined>>\n}\n\n/** The application `executeOperation()` and `subscribeOperation()` run against: a `TestApp`. */\nexport type GraphQLTestApp = Pick<TestApp, 'app' | 'inject' | 'injectStream'>\n\nconst DEFAULT_TIMEOUT_MS = 2_000\nconst RESPONSE_ACCEPT = 'application/graphql-response+json, application/json;q=0.9'\nconst DONE: IteratorResult<never, undefined> = Object.freeze({ done: true, value: undefined })\n\n/**\n * Executes a query or a mutation through the whole HTTP pipeline (`app.inject()`: `POST` on the\n * endpoint), or through `GraphQLPlugin` without HTTP transport.\n *\n * ```ts\n * const res = await executeOperation(app, { query: '{ books { title } }', headers: { 'x-api-key': KEY } })\n * expect(res.status).toBe(200)\n * expect(res.errors).toBeUndefined()\n * ```\n */\nexport async function executeOperation<TData = Record<string, unknown>>(\n  app: GraphQLTestApp,\n  request: OperationRequest,\n): Promise<OperationResponse<TData>> {\n  const plugin = graphqlPlugin(app, 'executeOperation()')\n  const body = operationBody(request, 'executeOperation()')\n  const endpoint = endpointOf(plugin)\n  if (endpoint === undefined) {\n    const response = await executorOf(plugin).execute(body)\n    return {\n      ...pick<TData>(response.result),\n      status: response.status,\n      headers: { ...response.headers },\n      body: JSON.stringify(response.result),\n    }\n  }\n  const response = await app.inject({\n    method: 'POST',\n    url: endpoint,\n    headers: headers(request, RESPONSE_ACCEPT),\n    body: JSON.stringify(body),\n  })\n  return {\n    ...parseResult<TData>(response.body),\n    status: response.status,\n    headers: response.headers,\n    body: response.body,\n  }\n}\n\n/**\n * Starts an operation as a stream: GraphQL over SSE in memory (`app.injectStream()`: `POST` with\n * `accept: text/event-stream`), or `GraphQLPlugin.subscribe()` without HTTP transport (no HTTP\n * guards then). Resolves once the subscription is established: its source has started (a resolver\n * written as an async generator has subscribed to the PubSub, when it subscribes before its first\n * `await`), so events published from then on\n * are received, even before the first `next()`.\n *\n * ```ts\n * await using events = await subscribeOperation(app, { query: 'subscription { bookAdded { title } }' })\n * await executeOperation(app, { query: ADD_DUNE })\n * expect((await events.next()).value).toEqual({ data: { bookAdded: { title: 'Dune' } } })\n * ```\n */\nexport async function subscribeOperation<TData = Record<string, unknown>>(\n  app: GraphQLTestApp,\n  request: OperationRequest,\n): Promise<OperationStream<TData>> {\n  const plugin = graphqlPlugin(app, 'subscribeOperation()')\n  const body = operationBody(request, 'subscribeOperation()')\n  const endpoint = endpointOf(plugin)\n  const label = describeOperation(body.query)\n  if (endpoint === undefined) {\n    const outcome = await executorOf(plugin).subscribe(body)\n    if ('status' in outcome) return new SingleResult(outcome.status, {}, pick<TData>(outcome.result))\n    return new Results<TData>(200, {}, directSource(outcome), label)\n  }\n  const response = await app.injectStream({\n    method: 'POST',\n    url: endpoint,\n    headers: headers(request, 'text/event-stream'),\n    body: JSON.stringify(body),\n  })\n  const type = response.headers['content-type']\n  if (typeof type !== 'string' || !type.startsWith('text/event-stream')) {\n    const text = await new Response(response.body).text()\n    return new SingleResult(response.status, response.headers, parseResult<TData>(text))\n  }\n  return new Results<TData>(response.status, response.headers, sseSource(parseSseStream(response.body)), label)\n}\n\n/** Options of {@link fakeLoader}: what a key resolves to. */\nexport type FakeLoaderValues<K, V> =\n  | Readonly<Record<string, V | Error>>\n  | ReadonlyMap<K, V | Error>\n  | ((key: K) => V | Error | Promise<V | Error>)\n\n/** A `Loader<L>` built by {@link fakeLoader}: `load` and `loadMany` are spies. */\nexport interface FakeLoader<K, V> extends BatchLoader<K, V> {\n  readonly load: MockFunction<(key: K) => Promise<V>> & ((key: K) => Promise<V>)\n  readonly loadMany: MockFunction<(keys: readonly K[]) => Promise<(V | Error)[]>> &\n    ((keys: readonly K[]) => Promise<(V | Error)[]>)\n}\n\n/**\n * A `Loader<L>` for unit tests of resolvers (with `TestBed`), answering from `values` (a record by\n * key, a map, or a function of the key; an `Error` value fails that key). `load` and `loadMany` are\n * spies; a missing key rejects.\n *\n * ```ts\n * const authors = fakeLoader<AuthorsById>({ [herbert.id]: herbert })\n * expect(await instance.author(dune, authors)).toBe(herbert)\n * expect(authors.load).toHaveBeenCalledWith(herbert.id)\n * ```\n */\nexport function fakeLoader<L extends BatchLoad<unknown, unknown>>(\n  values: FakeLoaderValues<LoaderKey<L>, LoaderValue<L>>,\n): FakeLoader<LoaderKey<L>, LoaderValue<L>> {\n  type K = LoaderKey<L>\n  type V = LoaderValue<L>\n  const resolve = lookup<K, V>(values)\n  const cache = new Map<unknown, Promise<V>>()\n  const loadOne = (key: K): Promise<V> => {\n    const cached = cache.get(key)\n    if (cached !== undefined) return cached\n    const loaded = Promise.resolve()\n      .then(() => resolve(key))\n      .then(value => (value instanceof Error ? Promise.reject(value) : value))\n    cache.set(key, loaded)\n    return loaded\n  }\n  const create = resolveMockFn().create\n  const load = create((key: K) => loadOne(key)) as FakeLoader<K, V>['load']\n  const loadMany = create((keys: readonly K[]) =>\n    Promise.all(keys.map(key => loadOne(key).catch((error: unknown) => asError(error)))),\n  ) as FakeLoader<K, V>['loadMany']\n  const loader: FakeLoader<K, V> = {\n    load,\n    loadMany,\n    clear(key: K) {\n      cache.delete(key)\n      return this\n    },\n    clearAll() {\n      cache.clear()\n      return this\n    },\n    prime(key: K, value: V | PromiseLike<V> | Error) {\n      if (!cache.has(key)) {\n        const primed = value instanceof Error ? Promise.reject(value) : Promise.resolve(value)\n        primed.catch(() => undefined)\n        cache.set(key, primed)\n      }\n      return this\n    },\n  }\n  return loader\n}\n\n// ------------------------------------------------------------------------------------------------\n\nfunction graphqlPlugin(app: GraphQLTestApp, what: string): GraphQLPlugin {\n  const plugin = app?.app?.getPlugin<Plugin>('graphql')\n  if (plugin === undefined) {\n    throw new TypeError(`${what} expects a TestApp whose plugins include GraphQLPlugin.configure()`)\n  }\n  return plugin as GraphQLPlugin\n}\n\nfunction operationBody(request: OperationRequest, what: string): GraphQLRequest {\n  if (request === null || typeof request !== 'object' || typeof request.query !== 'string') {\n    throw new TypeError(`${what} expects { query, variables?, operationName?, extensions?, headers? }`)\n  }\n  return {\n    query: request.query,\n    ...(request.variables === undefined ? {} : { variables: request.variables }),\n    ...(request.operationName === undefined ? {} : { operationName: request.operationName }),\n    ...(request.extensions === undefined ? {} : { extensions: request.extensions }),\n  }\n}\n\n/** The request headers: the defaults, then the operation's (names lower-cased, so they replace the defaults). */\nfunction headers(request: OperationRequest, accept: string): Record<string, string> {\n  const result: Record<string, string> = { 'content-type': 'application/json', accept }\n  for (const [name, value] of Object.entries(request.headers ?? {})) result[name.toLowerCase()] = value\n  return result\n}\n\nfunction pick<TData>(result: FormattedExecutionResult): OperationResult<TData> {\n  return {\n    ...('data' in result ? { data: result.data as TData | null } : {}),\n    ...(result.errors === undefined ? {} : { errors: result.errors }),\n    ...(result.extensions === undefined ? {} : { extensions: result.extensions }),\n  }\n}\n\n/** The GraphQL result of a body; `{}` when it is not one (an HTTP error body, a page). */\nfunction parseResult<TData>(body: string): OperationResult<TData> {\n  let parsed: unknown\n  try {\n    parsed = JSON.parse(body)\n  } catch {\n    return {}\n  }\n  if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) return {}\n  const result = parsed as FormattedExecutionResult\n  if (!('data' in result) && !Array.isArray(result.errors)) return {}\n  return pick<TData>(result)\n}\n\nfunction describeOperation(query: string): string {\n  const text = query.replace(/\\s+/g, ' ').trim()\n  return text.length > 60 ? `${text.slice(0, 60)}…` : text\n}\n\nfunction asError(error: unknown): Error {\n  return error instanceof Error ? error : new Error(String(error))\n}\n\nfunction lookup<K, V>(values: FakeLoaderValues<K, V>): (key: K) => V | Error | Promise<V | Error> {\n  if (typeof values === 'function') return values\n  if (values instanceof Map) {\n    return key => (values.has(key) ? (values.get(key) as V | Error) : missing(key))\n  }\n  const record = values as Readonly<Record<string, V | Error>>\n  return key => (Object.hasOwn(record, String(key)) ? (record[String(key)] as V | Error) : missing(key))\n}\n\nfunction missing(key: unknown): Error {\n  return new Error(`fakeLoader(): no value for the key ${JSON.stringify(key) ?? String(key)}`)\n}\n\n/** A source of results: `undefined` when it ended. */\ninterface ResultSource {\n  next(): Promise<FormattedExecutionResult | undefined>\n  close(): Promise<void>\n}\n\nfunction directSource(stream: GraphQLResultStream): ResultSource {\n  return {\n    next: async () => {\n      const step = await stream.next()\n      return step.done === true ? undefined : step.value\n    },\n    close: async () => {\n      await stream.return()\n    },\n  }\n}\n\n/** The `next` events of an event stream, until `complete` (comments, `retry` and other events skipped). */\nfunction sseSource(items: AsyncIterableIterator<SseItem>): ResultSource {\n  return {\n    next: async () => {\n      for (;;) {\n        const step = await items.next()\n        if (step.done === true) return undefined\n        const item = step.value\n        if (item.type !== 'event') continue\n        if (item.event === 'complete') return undefined\n        if (item.event === 'next') return JSON.parse(item.data) as FormattedExecutionResult\n      }\n    },\n    close: async () => {\n      await items.return?.()\n    },\n  }\n}\n\n/** The stream of a subscription (or of a query sent as a stream). */\nclass Results<TData> implements OperationStream<TData> {\n  readonly status: number\n  readonly headers: Readonly<Record<string, string | readonly string[] | undefined>>\n  readonly #source: ResultSource\n  readonly #label: string\n  /** A read still pending after a timeout: the next call waits for it, so no result is lost. */\n  #pending: Promise<FormattedExecutionResult | undefined> | undefined\n  #ended = false\n\n  constructor(\n    status: number,\n    headers: Readonly<Record<string, string | readonly string[] | undefined>>,\n    source: ResultSource,\n    label: string,\n  ) {\n    this.status = status\n    this.headers = headers\n    this.#source = source\n    this.#label = label\n  }\n\n  async next(options: OperationStreamWaitOptions = {}): Promise<IteratorResult<OperationResult<TData>, undefined>> {\n    if (this.#ended) return DONE\n    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS\n    this.#pending ??= this.#source.next()\n    const pending = this.#pending\n    let timer: ReturnType<typeof setTimeout> | undefined\n    const timeout = new Promise<typeof TIMEOUT>(resolve => {\n      timer = setTimeout(() => resolve(TIMEOUT), timeoutMs)\n    })\n    let result: FormattedExecutionResult | undefined | typeof TIMEOUT\n    try {\n      result = await Promise.race([pending, timeout])\n    } catch (error) {\n      this.#pending = undefined\n      await this.return()\n      throw error\n    } finally {\n      clearTimeout(timer)\n    }\n    if (result === TIMEOUT) {\n      throw new Error(`subscribeOperation(): no result within ${timeoutMs} ms for ${this.#label}`)\n    }\n    this.#pending = undefined\n    if (result === undefined) {\n      await this.return()\n      return DONE\n    }\n    return { done: false, value: pick<TData>(result) }\n  }\n\n  async return(): Promise<IteratorResult<OperationResult<TData>, undefined>> {\n    if (!this.#ended) {\n      this.#ended = true\n      await this.#source.close()\n    }\n    return DONE\n  }\n\n  [Symbol.asyncIterator](): OperationStream<TData> {\n    return this\n  }\n\n  [Symbol.asyncDispose](): Promise<void> {\n    return this.return().then(() => undefined)\n  }\n}\n\nconst TIMEOUT: unique symbol = Symbol('timeout')\n\n/** A request error (or a query's result without HTTP transport): one result, then the end. */\nclass SingleResult<TData> implements OperationStream<TData> {\n  readonly status: number\n  readonly headers: Readonly<Record<string, string | readonly string[] | undefined>>\n  #result: OperationResult<TData> | undefined\n\n  constructor(\n    status: number,\n    headers: Readonly<Record<string, string | readonly string[] | undefined>>,\n    result: OperationResult<TData>,\n  ) {\n    this.status = status\n    this.headers = headers\n    this.#result = result\n  }\n\n  next(): Promise<IteratorResult<OperationResult<TData>, undefined>> {\n    const result = this.#result\n    this.#result = undefined\n    return Promise.resolve(result === undefined ? DONE : { done: false, value: result })\n  }\n\n  return(): Promise<IteratorResult<OperationResult<TData>, undefined>> {\n    this.#result = undefined\n    return Promise.resolve(DONE)\n  }\n\n  [Symbol.asyncIterator](): OperationStream<TData> {\n    return this\n  }\n\n  [Symbol.asyncDispose](): Promise<void> {\n    return Promise.resolve()\n  }\n}\n"],"mappings":"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"}