@alxia/graphql 0.18.0 → 0.18.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -13,7 +13,7 @@ bun add -d typescript
13
13
  bun add @graxia/envelop @envelop/depth-limit # install yourself to use Envelop plugins
14
14
  ```
15
15
 
16
- `@graxia/core` (`^0.10.0`), `@graxia/graphiql` (`^0.2.4`) and `graphql` (17.1 or later) are peers:
16
+ `@graxia/core` (`^0.10.0 || ^0.11.0`), `@graxia/graphiql` (`^0.2.4`) and `graphql` (17.1 or later) are peers:
17
17
  the package declares no dependency. `@graxia/graphiql` serves the IDE and is
18
18
  required. CSRF protection is graxia's default (on): a `GET` needs one of the
19
19
  `x-graphql-csrf`, `graphql-require-preflight`, `apollo-require-preflight` or
package/dist/index.js CHANGED
@@ -154,7 +154,9 @@ import {
154
154
  startOperation
155
155
  } from "@alxia/core";
156
156
  import { createStateKey, definePlugin } from "@graxia/core";
157
- import { getOperationAST } from "graphql";
157
+ import {
158
+ getOperationAST
159
+ } from "graphql";
158
160
  var nameKey = createStateKey("alxia-operation-name");
159
161
  var openKey = createStateKey("alxia-operation-open");
160
162
  function describe(document, name) {
@@ -164,6 +166,44 @@ function describe(document, name) {
164
166
  return { type: operation.operation, name: operation.name?.value };
165
167
  }
166
168
  var isStream = (result) => typeof result === "object" && result !== null && (Symbol.asyncIterator in result);
169
+ var isIncremental = (result) => typeof result === "object" && result !== null && ("initialResult" in result) && typeof result.subsequentResults?.next === "function";
170
+ var carriesErrors = (chunk) => {
171
+ if (typeof chunk !== "object" || chunk === null)
172
+ return false;
173
+ const payload = chunk;
174
+ if (Array.isArray(payload.errors) && payload.errors.length > 0)
175
+ return true;
176
+ return [payload.incremental, payload.completed].some((entries) => Array.isArray(entries) && entries.some((entry) => typeof entry === "object" && entry !== null && Array.isArray(entry.errors) && entry.errors.length > 0));
177
+ };
178
+ function observed(chunks, progress, end) {
179
+ const wrapped = {
180
+ async next() {
181
+ try {
182
+ const step = await chunks.next();
183
+ if (step.done === true)
184
+ end(progress.outcome);
185
+ else if (carriesErrors(step.value))
186
+ progress.outcome = "errors";
187
+ return step;
188
+ } catch (error) {
189
+ progress.outcome = "errors";
190
+ end("errors");
191
+ throw error;
192
+ }
193
+ },
194
+ return(value) {
195
+ end(progress.outcome);
196
+ return chunks.return(value);
197
+ },
198
+ throw(error) {
199
+ return chunks.throw(error);
200
+ },
201
+ [Symbol.asyncIterator]() {
202
+ return wrapped;
203
+ }
204
+ };
205
+ return wrapped;
206
+ }
167
207
  var failed = (result) => typeof result === "object" && result !== null && ("errors" in result) ? "errors" : "ok";
168
208
  function reportsOperations() {
169
209
  return definePlugin({
@@ -187,7 +227,22 @@ function reportsOperations() {
187
227
  return;
188
228
  reportOperation(contextValue, report);
189
229
  const end = startOperation(contextValue, report);
190
- return ({ result }) => end(failed(result));
230
+ return ({ result, setResult }) => {
231
+ if (!isIncremental(result))
232
+ return end(failed(result));
233
+ const progress = {
234
+ outcome: carriesErrors(result.initialResult) ? "errors" : "ok"
235
+ };
236
+ const signal = contextValue.signal;
237
+ const onAbort = () => finish(progress.outcome);
238
+ const finish = (outcome) => {
239
+ signal?.removeEventListener("abort", onAbort);
240
+ end(outcome);
241
+ };
242
+ signal?.addEventListener("abort", onAbort, { once: true });
243
+ const subsequentResults = observed(result.subsequentResults, progress, finish);
244
+ setResult({ ...result, subsequentResults });
245
+ };
191
246
  },
192
247
  onSubscribe: ({ args, state }) => {
193
248
  const { document, operationName, contextValue } = args;
@@ -562,5 +617,5 @@ export {
562
617
  oncePerRequest
563
618
  };
564
619
 
565
- //# debugId=32A986800C6A89D964756E2164756E21
620
+ //# debugId=30AF2FD9C538C31F64756E2164756E21
566
621
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -6,7 +6,7 @@
6
6
  "/** What bounds a stream, and what keeps it authorized. All durations in ms. */\nexport interface BoundedStreamOptions {\n\t/** The stream ends, cleanly, after this long without an event. */\n\tidleMs: number;\n\t/** The stream ends, cleanly, this long after it began, however chatty. */\n\ttotalMs: number;\n\t/** `check` runs at least this often, also while no event comes. */\n\tcheckEveryMs: number;\n\t/**\n\t * Before an event is yielded, `check` runs when the last check is at least\n\t * this old. Default `0`: every event is checked. Raise it when events come\n\t * in bursts and one check per event would cost more than the delay of a\n\t * revocation it saves.\n\t */\n\tcheckDebounceMs?: number;\n\t/** Throws to refuse (a session that ended, a role that was lost). */\n\tcheck: () => Promise<void> | void;\n\t/** Turns what `check` (or the source) threw into the error the stream throws. Default: rethrown as is. */\n\tmapError?: (error: unknown) => unknown;\n\t/** Aborted when the client leaves: the stream ends and releases the source. */\n\tsignal?: AbortSignal;\n}\n\ntype Woke<T> =\n\t| { kind: 'read'; result: IteratorResult<T> }\n\t| { kind: 'failed'; error: unknown }\n\t| { kind: 'timer' }\n\t| { kind: 'interrupted' };\n\nconst DONE = { done: true, value: undefined } as const;\n\n/**\n * `source` bounded by an idle and a total lifetime and re-checked while it\n * lives, to return as a subscription's `subscribe` result.\n *\n * It ends, without an error, when the source ends, on the idle bound, on the\n * total bound and on `signal`'s abort. It throws `mapError(error)` (the\n * error itself by default) when `check` fails, or when the source does. The\n * source's `return()` is called at once on the consumer's `return()` (a\n * client that disconnected) and on any end, even while a read is pending: the\n * iterator is written by hand because a generator's `return()` waits behind a\n * pending `next()`. Read it one `next()` at a time, as `for await` does. No\n * timer outlives a step.\n */\nexport function boundedStream<T>(\n\tsource: AsyncIterable<T> | AsyncIterator<T>,\n\toptions: BoundedStreamOptions,\n): AsyncIterableIterator<T> {\n\tconst { idleMs, totalMs, checkEveryMs, check, signal } = options;\n\tconst debounceMs = options.checkDebounceMs ?? 0;\n\tconst mapError = options.mapError ?? ((error: unknown) => error);\n\tconst iterator: AsyncIterator<T> =\n\t\tSymbol.asyncIterator in source\n\t\t\t? (source as AsyncIterable<T>)[Symbol.asyncIterator]()\n\t\t\t: (source as AsyncIterator<T>);\n\n\tconst startedAt = Date.now();\n\tlet lastEventAt = startedAt;\n\tlet lastCheckAt = startedAt;\n\tlet finished = false;\n\tlet interrupt: (() => void) | undefined;\n\tlet pending: Promise<IteratorResult<T>> | undefined;\n\tlet released: Promise<void> | undefined;\n\n\tconst release = (): Promise<void> => {\n\t\tfinished = true;\n\t\tinterrupt?.();\n\t\treleased ??= (async () => {\n\t\t\ttry {\n\t\t\t\tawait iterator.return?.(undefined);\n\t\t\t} catch {}\n\t\t})();\n\t\treturn released;\n\t};\n\n\tconst onAbort = () => void release();\n\tif (signal?.aborted) void release();\n\telse signal?.addEventListener('abort', onAbort, { once: true });\n\tconst detach = () => signal?.removeEventListener('abort', onAbort);\n\n\tconst checked = async () => {\n\t\tawait check();\n\t\tlastCheckAt = Date.now();\n\t};\n\n\t// Waits for the source, the nearest bound or the abort, whichever is first.\n\tconst wait = (read: Promise<IteratorResult<T>>, ms: number) =>\n\t\tnew Promise<Woke<T>>((resolve) => {\n\t\t\tconst settle = (woke: Woke<T>) => {\n\t\t\t\tclearTimeout(timer);\n\t\t\t\tinterrupt = undefined;\n\t\t\t\tresolve(woke);\n\t\t\t};\n\t\t\tconst timer = setTimeout(() => settle({ kind: 'timer' }), ms);\n\t\t\tinterrupt = () => settle({ kind: 'interrupted' });\n\t\t\tread.then(\n\t\t\t\t(result) => settle({ kind: 'read', result }),\n\t\t\t\t(error: unknown) => settle({ kind: 'failed', error }),\n\t\t\t);\n\t\t});\n\n\tconst step = async (): Promise<IteratorResult<T>> => {\n\t\tfor (;;) {\n\t\t\tif (finished) return DONE;\n\t\t\tconst t = Date.now();\n\t\t\tconst left = [totalMs - (t - startedAt), idleMs - (t - lastEventAt)];\n\t\t\tif (Math.min(...left) <= 0) {\n\t\t\t\tawait release();\n\t\t\t\treturn DONE;\n\t\t\t}\n\t\t\tconst dueIn = checkEveryMs - (t - lastCheckAt);\n\t\t\tif (dueIn <= 0) {\n\t\t\t\tawait checked();\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (!pending) {\n\t\t\t\tpending = iterator.next();\n\t\t\t\tpending.catch(() => {});\n\t\t\t}\n\t\t\tconst woke = await wait(pending, Math.max(1, Math.min(dueIn, ...left)));\n\t\t\tif (woke.kind === 'interrupted') {\n\t\t\t\tawait release();\n\t\t\t\treturn DONE;\n\t\t\t}\n\t\t\tif (woke.kind === 'timer') continue;\n\t\t\tpending = undefined;\n\t\t\tif (woke.kind === 'failed') throw woke.error;\n\t\t\tif (woke.result.done) {\n\t\t\t\tawait release();\n\t\t\t\treturn DONE;\n\t\t\t}\n\t\t\tlastEventAt = Date.now();\n\t\t\tif (lastEventAt - lastCheckAt >= debounceMs) await checked();\n\t\t\tif (finished) return DONE;\n\t\t\treturn { done: false, value: woke.result.value };\n\t\t}\n\t};\n\n\tconst stream: AsyncIterableIterator<T> = {\n\t\t[Symbol.asyncIterator]: () => stream,\n\t\tnext: async () => {\n\t\t\ttry {\n\t\t\t\tconst result = await step();\n\t\t\t\tif (result.done) detach();\n\t\t\t\treturn result;\n\t\t\t} catch (error) {\n\t\t\t\tawait release();\n\t\t\t\tdetach();\n\t\t\t\tthrow mapError(error);\n\t\t\t}\n\t\t},\n\t\treturn: async () => {\n\t\t\tawait release();\n\t\t\tdetach();\n\t\t\treturn DONE;\n\t\t},\n\t};\n\treturn stream;\n}\n",
7
7
  "import type { Empty } from '@alxia/core';\nimport { createGraxia, type GraxiaOptions } from '@graxia/core';\nimport type { GraphQLSchema } from 'graphql';\nimport { graxiaOptions, type LegacyOptions } from './options';\n\n/** What an in-process call asks for: a GraphQL-over-HTTP request's parameters. */\nexport interface ExecutorRequest {\n\treadonly query: string;\n\treadonly operationName?: string | undefined;\n\treadonly variables?: Readonly<Record<string, unknown>> | undefined;\n}\n\n/** A plain, JSON-shaped error, as the route answers it. */\nexport interface ExecutorError {\n\treadonly message: string;\n\treadonly path?: readonly (string | number)[];\n\treadonly locations?: readonly { line: number; column: number }[];\n\treadonly extensions?: Readonly<Record<string, unknown>>;\n}\n\n/** The answer: `data` and `errors`, as the endpoint's JSON body. */\nexport interface ExecutorResult {\n\treadonly data?: unknown;\n\treadonly errors?: readonly ExecutorError[];\n}\n\n/** Per call: the signal that stops the operation, as a client leaving does. */\nexport interface ExecutorCall {\n\t/**\n\t * An aborted signal, before the call or while it runs, resolves to\n\t * `{ errors: [{ extensions: { code: 'OPERATION_ABORTED' } }] }`: it never rejects.\n\t */\n\treadonly signal?: AbortSignal;\n}\n\nexport interface GraphQLExecutorOptions<SchemaCtx = unknown>\n\textends Omit<\n\t\t\tGraxiaOptions<any, GraphQLSchema, any, any>,\n\t\t\t'path' | 'schema' | 'subscriptions' | 'context' | 'plugins'\n\t\t>,\n\t\tLegacyOptions {\n\treadonly schema: GraphQLSchema & { readonly '~context'?: SchemaCtx };\n\treadonly context?: GraxiaOptions['context'];\n\treadonly plugins?: GraxiaOptions['plugins'];\n}\n\n/** Runs one operation in process. */\nexport type GraphQLExecutor<ServerCtx> = ((\n\trequest: ExecutorRequest,\n\tcontext: ServerCtx,\n\tcall?: ExecutorCall,\n) => Promise<ExecutorResult>) & {\n\t/** Releases what the instance holds (plugins' `onDispose`, in-flight operations). A call after it rejects. */\n\tdispose(): Promise<void>;\n};\n\n/** A `GraphQLError` as its plain shape; an error that is already plain stays. */\nfunction plain(error: { toJSON?: () => ExecutorError }): ExecutorError {\n\treturn typeof error.toJSON === 'function'\n\t\t? error.toJSON()\n\t\t: (error as ExecutorError);\n}\n\n/** Runs a GraphQL operation in the process, through `graxia.execute`. Queries and mutations only (graxia refuses a subscription). */\nexport function graphqlExecutor<\n\tSchemaCtx,\n\tServerCtx = Omit<SchemaCtx, 'signal'>,\n>(options: GraphQLExecutorOptions<SchemaCtx>): GraphQLExecutor<ServerCtx> {\n\tconst graxia = createGraxia({\n\t\t...graxiaOptions(\n\t\t\t{ ...options, ide: false },\n\t\t\t{ ws: false, caller: 'graphqlExecutor(' },\n\t\t),\n\t\tcsrf: false,\n\t\tsubscriptions: { sse: false, ws: false },\n\t} as never);\n\tconst run = async (\n\t\trequest: ExecutorRequest,\n\t\tcontext: ServerCtx,\n\t\tcall?: ExecutorCall,\n\t): Promise<ExecutorResult> => {\n\t\tconst body = await (graxia.execute as any)({\n\t\t\tdocument: request.query,\n\t\t\t...(request.operationName !== undefined && {\n\t\t\t\toperationName: request.operationName,\n\t\t\t}),\n\t\t\t...(request.variables !== undefined && {\n\t\t\t\tvariables: request.variables,\n\t\t\t}),\n\t\t\t...(call?.signal !== undefined && { signal: call.signal }),\n\t\t\tserverContext: context,\n\t\t});\n\t\treturn {\n\t\t\t...(body.data !== undefined && { data: body.data }),\n\t\t\t...(body.errors !== undefined && {\n\t\t\t\terrors: body.errors.map(plain),\n\t\t\t}),\n\t\t};\n\t};\n\treturn Object.assign(run, { dispose: () => graxia.dispose() });\n}\nexport type { Empty };\n",
8
8
  "/** The IDE of `graphql()`: graxia's GraphiQL or Apollo Sandbox plugin, from alxia's `ide` options. */\n\nimport type { GraxiaPlugin } from '@graxia/core';\nimport {\n\ttype ApolloSandboxOptions,\n\tapolloSandbox,\n\ttype GraphiQLOptions,\n\tgraphiql,\n\ttype SandboxInitialState,\n} from '@graxia/graphiql';\nimport type { SandboxOptions } from './sandbox';\n\n/**\n * The requests the endpoint handler has seen, with the app's dev flag at the\n * moment of each: what the IDE's `enabled` function reads, since graxia hands\n * it the `Request` alone.\n */\nexport type DevOfRequest = WeakMap<Request, boolean>;\n\nexport interface ExplorerOptions {\n\treadonly ide?: 'graphiql' | 'apollo-sandbox' | false | undefined;\n\treadonly graphiql?: GraphiQLOptions | false | undefined;\n\treadonly sandbox?: SandboxOptions | undefined;\n}\n\n/** Defined, by key, so an unset option leaves the default of the plugin alone. */\nfunction defined<T extends object>(\n\tvalues: { [K in keyof T]?: T[K] | undefined },\n): T {\n\treturn Object.fromEntries(\n\t\tObject.entries(values).filter(([, value]) => value !== undefined),\n\t) as T;\n}\n\nfunction sandboxPlugin(\n\tsandbox: SandboxOptions | undefined,\n): GraxiaPlugin<any, any> {\n\tconst options: ApolloSandboxOptions = {\n\t\tenabled: true,\n\t\t...defined<ApolloSandboxOptions>({ title: sandbox?.title }),\n\t\tinitialState: defined<SandboxInitialState>({\n\t\t\tdocument: sandbox?.initialDocument,\n\t\t\theaders: sandbox?.initialHeaders as Record<string, string> | undefined,\n\t\t\tincludeCookies: sandbox?.includeCookies,\n\t\t}),\n\t};\n\treturn apolloSandbox(options) as GraxiaPlugin<any, any>;\n}\n\n/**\n * The IDE plugins: Sandbox for `ide: 'apollo-sandbox'`, nothing for\n * `ide: false` or `graphiql: false`, GraphiQL otherwise. By default GraphiQL\n * answers while the serving app is in dev (`alxia({ dev })`, else\n * `NODE_ENV=development`, read per request from `devs`, which the endpoint\n * handler fills), and everywhere under `ide: 'graphiql'`.\n */\nexport function explorerPlugins(\n\toptions: ExplorerOptions,\n\tdevs: DevOfRequest,\n): GraxiaPlugin<any, any>[] {\n\tconst { ide, graphiql: graphiqlOptions, sandbox } = options;\n\tif (ide === 'apollo-sandbox') return [sandboxPlugin(sandbox)];\n\tif (ide === false || graphiqlOptions === false) return [];\n\treturn [\n\t\tgraphiql({\n\t\t\tenabled:\n\t\t\t\tide === 'graphiql' ? true : (request) => devs.get(request) === true,\n\t\t\t...graphiqlOptions,\n\t\t}) as GraxiaPlugin<any, any>,\n\t];\n}\n",
9
- "/**\n * The plugin that tells the observers around the endpoint — `@alxia/logger`,\n * `@alxia/telemetry` — which operation graxia runs. Over HTTP it reports the\n * request's operation (`reportOperation`). Over a WebSocket, whose upgrade\n * was answered long before, it starts and ends each operation\n * (`startOperation`) from graxia's `onExecute` and `onSubscribe` hooks and\n * the operation's `signal`, as graxia's guide to observing each socket\n * operation describes; a document refused by validation never executes, so\n * `onValidate` tells that one, finding the socket through the `serverContext`\n * graxia gives it. A throwing subscription source reaches `onResultChunk` as\n * an error chunk, which ends the operation with errors.\n */\nimport {\n\ttype OperationOutcome,\n\treportOperation,\n\tstartOperation,\n} from '@alxia/core';\nimport { createStateKey, definePlugin } from '@graxia/core';\nimport { type DocumentNode, getOperationAST } from 'graphql';\n\ntype Report = Parameters<typeof reportOperation>[1];\n\nconst nameKey = createStateKey<string | null>('alxia-operation-name');\nconst openKey = createStateKey<{ outcome: OperationOutcome }>(\n\t'alxia-operation-open',\n);\n\ninterface Executed {\n\treadonly document: DocumentNode;\n\treadonly operationName?: string | null | undefined;\n\treadonly contextValue: unknown;\n}\n\nfunction describe(\n\tdocument: DocumentNode,\n\tname: string | null | undefined,\n): Report | undefined {\n\tconst operation = getOperationAST(document, name);\n\tif (operation === undefined || operation === null) return undefined;\n\treturn { type: operation.operation, name: operation.name?.value };\n}\n\nconst isStream = (result: unknown): boolean =>\n\ttypeof result === 'object' &&\n\tresult !== null &&\n\tSymbol.asyncIterator in result;\n\nconst failed = (result: unknown): OperationOutcome =>\n\ttypeof result === 'object' && result !== null && 'errors' in result\n\t\t? 'errors'\n\t\t: 'ok';\n\n/** A graxia plugin reporting each operation graxia executes or subscribes to. */\nexport function reportsOperations() {\n\treturn definePlugin({\n\t\tname: 'alxia-report-operations',\n\t\tonParse: ({ params, state }) => {\n\t\t\tstate.set(nameKey, params.operationName ?? null);\n\t\t},\n\t\tonValidate: ({ document, serverContext, state }) => {\n\t\t\treturn ({ errors }) => {\n\t\t\t\tif (errors === undefined || errors.length === 0) return;\n\t\t\t\tconst report = describe(document, state.get(nameKey));\n\t\t\t\tif (report !== undefined)\n\t\t\t\t\tstartOperation(serverContext, report)('errors');\n\t\t\t};\n\t\t},\n\t\tonExecute: ({ args }) => {\n\t\t\tconst { document, operationName, contextValue } = args as Executed;\n\t\t\tconst report = describe(document, operationName);\n\t\t\tif (report === undefined) return;\n\t\t\treportOperation(contextValue as object, report);\n\t\t\tconst end = startOperation(contextValue as object, report);\n\t\t\treturn ({ result }) => end(failed(result));\n\t\t},\n\t\tonSubscribe: ({ args, state }) => {\n\t\t\tconst { document, operationName, contextValue } = args as Executed;\n\t\t\tconst report = describe(document, operationName);\n\t\t\tif (report === undefined) return;\n\t\t\tconst context = contextValue as { signal?: AbortSignal };\n\t\t\treportOperation(context, report);\n\t\t\tconst end = startOperation(context, report);\n\t\t\tconst open = { outcome: 'ok' as OperationOutcome };\n\t\t\tstate.set(openKey, open);\n\t\t\tcontext.signal?.addEventListener('abort', () => end(open.outcome), {\n\t\t\t\tonce: true,\n\t\t\t});\n\t\t\t// A stream is created; a refusal arrives as a result, not a stream.\n\t\t\treturn ({ result }) => {\n\t\t\t\tif (isStream(result)) return;\n\t\t\t\topen.outcome = failed(result);\n\t\t\t\tend(open.outcome);\n\t\t\t};\n\t\t},\n\t\tonResultChunk: ({ chunk, state }) => {\n\t\t\tconst open = state.get(openKey);\n\t\t\tif (open !== undefined && failed(chunk) === 'errors') {\n\t\t\t\topen.outcome = 'errors';\n\t\t\t}\n\t\t},\n\t});\n}\n",
9
+ "/**\n * The plugin that tells the observers around the endpoint — `@alxia/logger`,\n * `@alxia/telemetry` — which operation graxia runs. Over HTTP it reports the\n * request's operation (`reportOperation`). Over a WebSocket, whose upgrade\n * was answered long before, it starts and ends each operation\n * (`startOperation`) from graxia's `onExecute` and `onSubscribe` hooks and\n * the operation's `signal`, as graxia's guide to observing each socket\n * operation describes; a document refused by validation never executes, so\n * `onValidate` tells that one, finding the socket through the `serverContext`\n * graxia gives it. A throwing subscription source reaches `onResultChunk` as\n * an error chunk, which ends the operation with errors. Under `@defer` and\n * `@stream` over a socket, the operation ends with its last payload, with\n * `errors` when one carried errors, or once with the outcome so far when its\n * client leaves.\n */\nimport {\n\ttype OperationOutcome,\n\treportOperation,\n\tstartOperation,\n} from '@alxia/core';\nimport { createStateKey, definePlugin } from '@graxia/core';\nimport {\n\ttype DocumentNode,\n\ttype ExperimentalIncrementalExecutionResults,\n\tgetOperationAST,\n\ttype LegacyExperimentalIncrementalExecutionResults,\n} from 'graphql';\n\ntype Report = Parameters<typeof reportOperation>[1];\n\nconst nameKey = createStateKey<string | null>('alxia-operation-name');\nconst openKey = createStateKey<{ outcome: OperationOutcome }>(\n\t'alxia-operation-open',\n);\n\ninterface Executed {\n\treadonly document: DocumentNode;\n\treadonly operationName?: string | null | undefined;\n\treadonly contextValue: unknown;\n}\n\nfunction describe(\n\tdocument: DocumentNode,\n\tname: string | null | undefined,\n): Report | undefined {\n\tconst operation = getOperationAST(document, name);\n\tif (operation === undefined || operation === null) return undefined;\n\treturn { type: operation.operation, name: operation.name?.value };\n}\n\nconst isStream = (result: unknown): boolean =>\n\ttypeof result === 'object' &&\n\tresult !== null &&\n\tSymbol.asyncIterator in result;\n\ntype IncrementalResults =\n\t| ExperimentalIncrementalExecutionResults\n\t| LegacyExperimentalIncrementalExecutionResults;\n\n/** An `@defer`/`@stream` result: its first payload, then the rest (graxia's own guard). */\nconst isIncremental = (result: unknown): result is IncrementalResults =>\n\ttypeof result === 'object' &&\n\tresult !== null &&\n\t'initialResult' in result &&\n\ttypeof (result as { subsequentResults?: { next?: unknown } })\n\t\t.subsequentResults?.next === 'function';\n\n/** A payload with errors: its own, or one of its `incremental` or `completed` entries. */\nconst carriesErrors = (chunk: unknown): boolean => {\n\tif (typeof chunk !== 'object' || chunk === null) return false;\n\tconst payload = chunk as {\n\t\terrors?: unknown;\n\t\tincremental?: unknown;\n\t\tcompleted?: unknown;\n\t};\n\tif (Array.isArray(payload.errors) && payload.errors.length > 0) return true;\n\treturn [payload.incremental, payload.completed].some(\n\t\t(entries) =>\n\t\t\tArray.isArray(entries) &&\n\t\t\tentries.some(\n\t\t\t\t(entry) =>\n\t\t\t\t\ttypeof entry === 'object' &&\n\t\t\t\t\tentry !== null &&\n\t\t\t\t\tArray.isArray((entry as { errors?: unknown }).errors) &&\n\t\t\t\t\t(entry as { errors: unknown[] }).errors.length > 0,\n\t\t\t),\n\t);\n};\n\n/**\n * `chunks`, ending the operation once: when it is done, when a payload\n * rejects (`errors`), or when its client leaves (`return`), with the outcome\n * so far. A plain iterator and not a generator, so that `return()` reaches\n * `chunks` at once even while a `next()` is pending, as graxia's source needs.\n */\nfunction observed<Chunks extends AsyncGenerator<unknown, void, void>>(\n\tchunks: Chunks,\n\tprogress: { outcome: OperationOutcome },\n\tend: (outcome: OperationOutcome) => void,\n): Chunks {\n\tconst wrapped = {\n\t\tasync next() {\n\t\t\ttry {\n\t\t\t\tconst step = await chunks.next();\n\t\t\t\tif (step.done === true) end(progress.outcome);\n\t\t\t\telse if (carriesErrors(step.value)) progress.outcome = 'errors';\n\t\t\t\treturn step;\n\t\t\t} catch (error) {\n\t\t\t\tprogress.outcome = 'errors';\n\t\t\t\tend('errors');\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t},\n\t\treturn(value?: void) {\n\t\t\tend(progress.outcome);\n\t\t\treturn chunks.return(value);\n\t\t},\n\t\tthrow(error?: unknown) {\n\t\t\treturn chunks.throw(error);\n\t\t},\n\t\t[Symbol.asyncIterator]() {\n\t\t\treturn wrapped;\n\t\t},\n\t};\n\t// graphql's generator type also asks for `Symbol.asyncDispose`, which\n\t// graxia never calls: the cast stands for that one member.\n\treturn wrapped as unknown as Chunks;\n}\n\nconst failed = (result: unknown): OperationOutcome =>\n\ttypeof result === 'object' && result !== null && 'errors' in result\n\t\t? 'errors'\n\t\t: 'ok';\n\n/** A graxia plugin reporting each operation graxia executes or subscribes to. */\nexport function reportsOperations() {\n\treturn definePlugin({\n\t\tname: 'alxia-report-operations',\n\t\tonParse: ({ params, state }) => {\n\t\t\tstate.set(nameKey, params.operationName ?? null);\n\t\t},\n\t\tonValidate: ({ document, serverContext, state }) => {\n\t\t\treturn ({ errors }) => {\n\t\t\t\tif (errors === undefined || errors.length === 0) return;\n\t\t\t\tconst report = describe(document, state.get(nameKey));\n\t\t\t\tif (report !== undefined)\n\t\t\t\t\tstartOperation(serverContext, report)('errors');\n\t\t\t};\n\t\t},\n\t\tonExecute: ({ args }) => {\n\t\t\tconst { document, operationName, contextValue } = args as Executed;\n\t\t\tconst report = describe(document, operationName);\n\t\t\tif (report === undefined) return;\n\t\t\treportOperation(contextValue as object, report);\n\t\t\tconst end = startOperation(contextValue as object, report);\n\t\t\treturn ({ result, setResult }) => {\n\t\t\t\tif (!isIncremental(result)) return end(failed(result));\n\t\t\t\t// `@defer`/`@stream`: the operation lasts until its last payload, or\n\t\t\t\t// until its client leaves.\n\t\t\t\tconst progress = {\n\t\t\t\t\toutcome: carriesErrors(result.initialResult)\n\t\t\t\t\t\t? ('errors' as const)\n\t\t\t\t\t\t: ('ok' as const),\n\t\t\t\t};\n\t\t\t\tconst signal = (contextValue as { signal?: AbortSignal }).signal;\n\t\t\t\tconst onAbort = () => finish(progress.outcome);\n\t\t\t\tconst finish = (outcome: OperationOutcome) => {\n\t\t\t\t\tsignal?.removeEventListener('abort', onAbort);\n\t\t\t\t\tend(outcome);\n\t\t\t\t};\n\t\t\t\tsignal?.addEventListener('abort', onAbort, { once: true });\n\t\t\t\tconst subsequentResults = observed(\n\t\t\t\t\tresult.subsequentResults,\n\t\t\t\t\tprogress,\n\t\t\t\t\tfinish,\n\t\t\t\t);\n\t\t\t\t// The spread of a union keeps both formats' members apart, so\n\t\t\t\t// TypeScript cannot see the result as one of them again.\n\t\t\t\tsetResult({ ...result, subsequentResults } as typeof result);\n\t\t\t};\n\t\t},\n\t\tonSubscribe: ({ args, state }) => {\n\t\t\tconst { document, operationName, contextValue } = args as Executed;\n\t\t\tconst report = describe(document, operationName);\n\t\t\tif (report === undefined) return;\n\t\t\tconst context = contextValue as { signal?: AbortSignal };\n\t\t\treportOperation(context, report);\n\t\t\tconst end = startOperation(context, report);\n\t\t\tconst open = { outcome: 'ok' as OperationOutcome };\n\t\t\tstate.set(openKey, open);\n\t\t\tcontext.signal?.addEventListener('abort', () => end(open.outcome), {\n\t\t\t\tonce: true,\n\t\t\t});\n\t\t\t// A stream is created; a refusal arrives as a result, not a stream.\n\t\t\treturn ({ result }) => {\n\t\t\t\tif (isStream(result)) return;\n\t\t\t\topen.outcome = failed(result);\n\t\t\t\tend(open.outcome);\n\t\t\t};\n\t\t},\n\t\tonResultChunk: ({ chunk, state }) => {\n\t\t\tconst open = state.get(openKey);\n\t\t\tif (open !== undefined && failed(chunk) === 'errors') {\n\t\t\t\topen.outcome = 'errors';\n\t\t\t}\n\t\t},\n\t});\n}\n",
10
10
  "/** The options of the Yoga endpoint that no longer exist, refused with the fix. */\nexport interface RemovedOptions {\n\t/** Removed: unexpected failures go to graxia's `onUnexpected` (`console.error`, off in production); log requests with `@alxia/logger`. */\n\treadonly logging?: never;\n\t/** Removed: graxia generates its own `x-request-id` and never echoes the client's; the app's own id is `@alxia/core`'s. */\n\treadonly requestId?: never;\n\t/** Removed: mount `@alxia/cors` on the app before `graphql()`. */\n\treadonly cors?: never;\n\t/** Removed with `sameOrigin()`: use `csrf: { sameOrigin: true }` (off by default; the CSRF header check is on). */\n\treadonly sameOrigin?: never;\n}\n\nconst FIXES: Readonly<Record<string, string>> = {\n\tlogging:\n\t\t\"`logging` was Yoga's. Unexpected failures go to graxia's `onUnexpected` (console.error by default, off in production); log requests with `@alxia/logger`\",\n\trequestId:\n\t\t\"`requestId` was Yoga's. Graxia generates its own `x-request-id` and never echoes the client's; the app's own id is `@alxia/core`'s\",\n\tcors: '`cors` is gone. Mount `@alxia/cors` on the app before `graphql()`',\n\tsameOrigin:\n\t\t'`sameOrigin` is gone. Use `csrf: { sameOrigin: true }` (off by default; the CSRF header check is on)',\n};\n\n/** Throws, where `graphql()` is declared, for an option that was removed. */\nexport function rejectRemoved(\n\toptions: object,\n\tcaller: 'graphql(app' | 'graphqlExecutor(' = 'graphql(app',\n): void {\n\tfor (const name of Object.keys(FIXES)) {\n\t\tif (\n\t\t\tname in options &&\n\t\t\t(options as Record<string, unknown>)[name] !== undefined\n\t\t) {\n\t\t\tconst call =\n\t\t\t\tcaller === 'graphql(app'\n\t\t\t\t\t? `graphql(app, { ${name} })`\n\t\t\t\t\t: `graphqlExecutor({ ${name} })`;\n\t\t\tthrow new TypeError(`${call}: ${FIXES[name]}`);\n\t\t}\n\t}\n}\n",
11
11
  "/**\n * What `graphql()` and `graphqlExecutor()` share: alxia's options mapped\n * onto `createGraxia`'s, the legacy names (`maxTokens`, `maxNesting`,\n * `parseCache`, `maskedErrors`) kept, and the operation reporter.\n */\nimport type { GraxiaOptions } from '@graxia/core';\nimport {\n\ttype DevOfRequest,\n\ttype ExplorerOptions,\n\texplorerPlugins,\n} from './explorer';\nimport { reportsOperations } from './operation';\nimport { rejectRemoved } from './removed';\n\nexport type { RemovedOptions } from './removed';\n\n/** The cache sizes of the parse cache: graxia's `caches.parse`. */\nexport interface ParseCacheOptions {\n\t/** graxia's `caches.parse.maxBytes`: the estimated bytes of sources kept (64 MiB by default). */\n\treadonly maxBytes?: number;\n\treadonly max?: number;\n\t/** Milliseconds. */\n\treadonly ttl?: number;\n}\n\nexport interface LegacyOptions {\n\t/** @deprecated Use `limits: { tokens }`. Works until the next minor. */\n\treadonly maxTokens?: number | false;\n\t/** @deprecated Use `limits: { nesting }`. Works until the next minor. */\n\treadonly maxNesting?: number | false;\n\t/** @deprecated Use `caches: { parse }`, or `caches: false`. Works until the next minor. */\n\treadonly parseCache?: false | ParseCacheOptions;\n\t/** `false` is graxia's `maskErrors: false`. */\n\treadonly maskedErrors?: boolean;\n}\n\ninterface Wiring {\n\t/** Filled by the endpoint handler; the executor serves no page and gives none. */\n\treadonly devs?: DevOfRequest | undefined;\n\treadonly ws: false | { keepAlive?: number | false | undefined };\n\treadonly bodyLimit?: number | undefined;\n\t/** Whose name an error carries. */\n\treadonly caller?: 'graphqlExecutor(' | undefined;\n}\n\ntype Limits = NonNullable<GraxiaOptions['limits']>;\ntype Caches = GraxiaOptions['caches'];\ntype Subscriptions = NonNullable<GraxiaOptions['subscriptions']>;\n\nfunction limitsOf(\n\tlegacy: {\n\t\treadonly maxTokens: number | false | undefined;\n\t\treadonly maxNesting: number | false | undefined;\n\t},\n\tbodyLimit: number | undefined,\n\tlimits: GraxiaOptions['limits'],\n): Limits {\n\treturn {\n\t\t...(legacy.maxTokens === undefined ? {} : { tokens: legacy.maxTokens }),\n\t\t...(legacy.maxNesting === undefined ? {} : { nesting: legacy.maxNesting }),\n\t\t...(bodyLimit === undefined ? {} : { bodyBytes: bodyLimit }),\n\t\t...limits,\n\t};\n}\n\nfunction cachesOf(\n\tparseCache: LegacyOptions['parseCache'],\n\tcaches: Caches,\n): Caches {\n\tif (caches !== undefined) return caches;\n\tif (parseCache === undefined || parseCache === false) {\n\t\treturn parseCache === false ? false : undefined;\n\t}\n\treturn {\n\t\tparse: {\n\t\t\t...(parseCache.maxBytes === undefined\n\t\t\t\t? {}\n\t\t\t\t: { maxBytes: parseCache.maxBytes }),\n\t\t\t...(parseCache.max === undefined ? {} : { max: parseCache.max }),\n\t\t\t...(parseCache.ttl === undefined ? {} : { ttlMs: parseCache.ttl }),\n\t\t},\n\t};\n}\n\nfunction subscriptionsOf(ws: Wiring['ws']): Subscriptions {\n\tif (ws === false) return { sse: true, ws: false };\n\tconst { keepAlive } = ws;\n\tif (keepAlive === undefined) return { sse: true, ws: true };\n\treturn {\n\t\tsse: true,\n\t\tws: { keepAliveMs: keepAlive === false ? 0 : Math.ceil(keepAlive) },\n\t};\n}\n\n/**\n * @alxia/telemetry spans the operations; graxia's own operation span would\n * double it, so only its step spans (parse, validate, execute) stay, as\n * children of the active host span. The default is merged under a given\n * `telemetry` object, so one that sets only `resolverSpans` keeps it; `false`\n * turns every span off.\n */\nfunction telemetryOf(telemetry: GraxiaOptions['telemetry']) {\n\tif (telemetry === false) return false;\n\treturn { operationSpans: false, ...telemetry };\n}\n\nexport function graxiaOptions(options: object, wiring: Wiring): GraxiaOptions {\n\trejectRemoved(options, wiring.caller);\n\tconst {\n\t\tmaxTokens,\n\t\tmaxNesting,\n\t\tparseCache,\n\t\tmaskedErrors,\n\t\tide,\n\t\tgraphiql,\n\t\tsandbox,\n\t\tpath: _path,\n\t\tws: _ws,\n\t\tbodyLimit: _bodyLimit,\n\t\tplugins = [],\n\t\tlimits,\n\t\tcaches,\n\t\ttelemetry,\n\t\t...rest\n\t} = options as GraxiaOptions &\n\t\tLegacyOptions &\n\t\tExplorerOptions & {\n\t\t\tpath?: unknown;\n\t\t\tws?: unknown;\n\t\t\tbodyLimit?: unknown;\n\t\t};\n\treturn {\n\t\t...rest,\n\t\ttelemetry: telemetryOf(telemetry),\n\t\tpath: false,\n\t\tplugins: [\n\t\t\t...plugins,\n\t\t\t...explorerPlugins(\n\t\t\t\t{ ide, graphiql, sandbox },\n\t\t\t\twiring.devs ?? new WeakMap(),\n\t\t\t),\n\t\t\treportsOperations(),\n\t\t],\n\t\tlimits: limitsOf({ maxTokens, maxNesting }, wiring.bodyLimit, limits),\n\t\tcaches: cachesOf(parseCache, caches),\n\t\t...(maskedErrors === false ? { maskErrors: false } : {}),\n\t\tsubscriptions: subscriptionsOf(wiring.ws),\n\t} as GraxiaOptions;\n}\n",
12
12
  "import type { Alxia, BaseContext, Empty, RoutePath } from '@alxia/core';\nimport {\n\ttype ContextInit,\n\ttype ContextOf,\n\ttype CoreContext,\n\tcreateGraxia,\n\ttype GraxiaOptions,\n\ttype GraxiaPlugin,\n} from '@graxia/core';\nimport type { GraphiQLOptions } from '@graxia/graphiql';\nimport type { GraphQLSchema } from 'graphql';\nimport { declareEndpoint } from './endpoint';\nimport type { DevOfRequest } from './explorer';\nimport { graphqlHandler } from './handler';\nimport {\n\tgraxiaOptions,\n\ttype LegacyOptions,\n\ttype RemovedOptions,\n} from './options';\nimport type { SandboxOptions } from './sandbox';\nimport { checkKeepAlive, type GraphQLWsOptions, graphqlSocket } from './ws';\n\n/** The parts of a route's context graxia owns, or that mean nothing to a resolver. */\ntype RouteOnly =\n\t| 'params'\n\t| 'query'\n\t| 'headers'\n\t| 'cookies'\n\t| 'body'\n\t| 'reply'\n\t| 'redirect';\n\n/**\n * What alxia hands graxia for each request as its `serverContext`: the\n * context its middlewares built with `request`, `url`, `ip` and `set`.\n */\nexport type ServerContext<Ctx> = Omit<BaseContext & Ctx, RouteOnly>;\n\n/** What an operation over WebSocket adds to its context: the client's `connectionParams`. */\nexport interface GraphQLWsContext {\n\treadonly connectionParams?: Readonly<Record<string, unknown>>;\n}\n\n/**\n * What a resolver reads as its context: graxia's `signal`, the app's, what\n * the `context` option adds, and over WebSocket the `connectionParams`.\n */\nexport type GraphQLContext<App, UserContext = Empty> = App extends {\n\treadonly '~context': infer Ctx;\n}\n\t? CoreContext & ServerContext<Ctx> & GraphQLWsContext & UserContext\n\t: {\n\t\t\treadonly '~error': 'GraphQLContext needs the type of an app: GraphQLContext<typeof app>';\n\t\t};\n\ntype Passed =\n\t| 'path'\n\t| 'schema'\n\t| 'context'\n\t| 'subscriptions'\n\t| 'plugins'\n\t| 'limits'\n\t| 'caches';\n\nexport interface GraphQLOptions<\n\tCtx,\n\tPath extends RoutePath,\n\tSchemaCtx = unknown,\n\tMade extends object = object,\n\tPlugins extends readonly GraxiaPlugin<any, any>[] = readonly GraxiaPlugin<\n\t\tany,\n\t\tany\n\t>[],\n> extends Omit<\n\t\t\tGraxiaOptions<ServerContext<Ctx>, GraphQLSchema, any, Made>,\n\t\t\tPassed\n\t\t>,\n\t\tLegacyOptions,\n\t\tRemovedOptions {\n\treadonly schema: GraphQLSchema & { readonly '~context'?: SchemaCtx };\n\treadonly context?: (\n\t\tinit: ContextInit<ServerContext<Ctx>>,\n\t) => Made | Promise<Made>;\n\treadonly plugins?: Plugins;\n\treadonly limits?: GraxiaOptions['limits'];\n\treadonly caches?: GraxiaOptions['caches'];\n\treadonly ide?: 'graphiql' | 'apollo-sandbox' | false;\n\treadonly graphiql?: GraphiQLOptions | false;\n\treadonly sandbox?: SandboxOptions;\n\treadonly path?: Path;\n\treadonly ws?: boolean | GraphQLWsOptions;\n\treadonly bodyLimit?: number;\n}\n\n/**\n * The parameter of a `context` factory that reads the app's `serverContext`,\n * typed from the app: `context: ({ serverContext }: GraphQLContextInit<typeof app>) => …`,\n * with no `['~context']` to write.\n */\nexport type GraphQLContextInit<App> = App extends {\n\treadonly '~context': infer Ctx;\n}\n\t? ContextInit<ServerContext<Ctx>>\n\t: {\n\t\t\treadonly '~error': 'GraphQLContextInit needs the type of an app: GraphQLContextInit<typeof app>';\n\t\t};\n\ntype ProvidesContext<Provided, Required> = Provided extends Required\n\t? unknown\n\t: {\n\t\t\treadonly schema: `the schema's resolvers read a context the app does not build: missing ${Exclude<\n\t\t\t\tkeyof Required,\n\t\t\t\tkeyof Provided\n\t\t\t> &\n\t\t\t\tstring}`;\n\t\t};\n\n/**\n * A GraphQL endpoint on `app`, served by `@graxia/core`: `GET` and `POST`\n * at `path`, behind every middleware given to `use` on `app` before it.\n */\nexport function graphql<\n\tCtx extends object,\n\tPrefix extends string,\n\tSchemaCtx,\n\tMade extends object = Empty,\n\tconst Path extends RoutePath = '/graphql',\n\tconst Plugins extends readonly GraxiaPlugin<\n\t\tany,\n\t\tany\n\t>[] = readonly GraxiaPlugin<any, any>[],\n>(\n\tapp: Alxia<Ctx, Prefix>,\n\toptions: GraphQLOptions<Ctx, Path, SchemaCtx, Made, Plugins> &\n\t\tProvidesContext<\n\t\t\tCoreContext & ServerContext<Ctx> & Made & ContextOf<Plugins>,\n\t\t\tSchemaCtx\n\t\t>,\n): Alxia<Ctx, Prefix> {\n\tconst { path = '/graphql' as Path, ws = false, bodyLimit } = options;\n\tif (typeof ws === 'object') checkKeepAlive(ws);\n\tconst devs: DevOfRequest = new WeakMap();\n\tdeclareEndpoint(app as never, path, bodyLimit, (bodyBytes) => {\n\t\tconst graxia = createGraxia(\n\t\t\tgraxiaOptions(options, {\n\t\t\t\tdevs,\n\t\t\t\tws: ws === false ? false : ws === true ? {} : ws,\n\t\t\t\tbodyLimit: bodyBytes,\n\t\t\t}) as never,\n\t\t);\n\t\tapp.onStop(() => graxia.dispose());\n\t\treturn {\n\t\t\thandler: graphqlHandler(graxia, devs) as never,\n\t\t\tsocket:\n\t\t\t\tws === false\n\t\t\t\t\t? undefined\n\t\t\t\t\t: graphqlSocket(graxia, path, ws === true ? {} : ws),\n\t\t};\n\t});\n\treturn app as never;\n}\n",
@@ -15,7 +15,7 @@
15
15
  "/**\n * GraphQL over WebSocket: the `graphql-transport-ws` protocol is graxia's.\n * alxia owns `Bun.serve`'s websocket handler, so the route's middleware asks\n * `graxia.upgrade` for the socket's data through a stand-in server that only\n * captures it, and each socket's events are handed to `graxia.websocket`.\n * graxia's `maxPayloadBytes` (1 MiB) is applied by `graxia.serve`, which\n * alxia does not use: a message is bounded by Bun's `maxPayloadLength` (16 MiB\n * by default), as the WebSocket guide says.\n */\nimport type { BaseContext, NextFunction, RoutePath, Socket } from '@alxia/core';\nimport type { Graxia } from '@graxia/core';\nimport { serverContext } from './handler';\n\nexport interface GraphQLWsOptions {\n\t/** Where a client opens its socket. The endpoint's own path by default. */\n\treadonly path?: RoutePath;\n\t/** Milliseconds between pings, or `false` for none. */\n\treadonly keepAlive?: number | false;\n}\n\nconst KEY = 'graxiaSocket';\n\n/** Refuses, where `graphql()` is declared, a `keepAlive` that would ping in a loop. */\nexport function checkKeepAlive(options: GraphQLWsOptions): void {\n\tconst { keepAlive } = options;\n\tif (keepAlive === undefined || keepAlive === false) return;\n\tconst valid =\n\t\ttypeof keepAlive === 'number' &&\n\t\tNumber.isFinite(keepAlive) &&\n\t\tkeepAlive > 0 &&\n\t\tkeepAlive <= 2 ** 31 - 1;\n\tif (!valid) {\n\t\tthrow new TypeError(\n\t\t\t`graphql(app, { ws: { keepAlive: ${keepAlive} } }): keepAlive is the milliseconds between pings, a positive number up to ${2 ** 31 - 1}, or false for none`,\n\t\t);\n\t}\n}\n\nexport function graphqlSocket(\n\tgraxia: Graxia<any>,\n\tendpoint: string,\n\toptions: GraphQLWsOptions,\n) {\n\tasync function graphqlWs(ctx: BaseContext, next: NextFunction) {\n\t\tlet captured: { data: object; headers: HeadersInit } | undefined;\n\t\tconst standIn = {\n\t\t\tupgrade(\n\t\t\t\t_request: Request,\n\t\t\t\tgiven: { data: object; headers: HeadersInit },\n\t\t\t) {\n\t\t\t\tcaptured = given;\n\t\t\t\treturn true;\n\t\t\t},\n\t\t};\n\t\tconst host = serverContext(ctx as never);\n\t\tconst refused = await (graxia.upgrade as any)(ctx.request, standIn, host);\n\t\tif (refused !== undefined || captured === undefined) return refused;\n\t\tfor (const [name, value] of new Headers(captured.headers)) {\n\t\t\tctx.set.headers.set(name, value);\n\t\t}\n\t\treturn next({ [KEY]: captured.data } as never);\n\t}\n\ttype GraphQLSocket = Socket<Record<string, any> & BaseContext, unknown>;\n\tconst handlers = {\n\t\topen(socket: GraphQLSocket) {\n\t\t\tObject.assign(socket.raw.data as object, socket.data[KEY]);\n\t\t\tgraxia.websocket.open?.(socket.raw as never);\n\t\t},\n\t\tasync message(socket: GraphQLSocket, message: unknown) {\n\t\t\tawait graxia.websocket.message?.(socket.raw as never, message as never);\n\t\t},\n\t\tasync close(socket: GraphQLSocket, code: number, reason: string) {\n\t\t\tawait graxia.websocket.close?.(socket.raw as never, code, reason);\n\t\t},\n\t\tdrain(socket: GraphQLSocket) {\n\t\t\tgraxia.websocket.drain?.(socket.raw as never);\n\t\t},\n\t};\n\treturn { path: options.path ?? endpoint, middleware: graphqlWs, handlers };\n}\n",
16
16
  "const caches = new WeakMap<object, Map<string, unknown>>();\n\n/**\n * A value loaded at most once per request and key. `request` is any object\n * that lives as long as the request (the resolvers' context); the cache is\n * released with it. A `load` that throws, or returns a promise that rejects,\n * is not kept, so the next call tries again.\n */\nexport function oncePerRequest<T>(\n\trequest: object,\n\tkey: string,\n\tload: () => T,\n): T {\n\tlet cache = caches.get(request);\n\tif (!cache) {\n\t\tcache = new Map();\n\t\tcaches.set(request, cache);\n\t}\n\tif (cache.has(key)) return cache.get(key) as T;\n\tconst loaded = load();\n\tcache.set(key, loaded);\n\tif (loaded instanceof Promise) {\n\t\tconst mine = cache;\n\t\tloaded.catch(() => {\n\t\t\tif (mine.get(key) === loaded) mine.delete(key);\n\t\t});\n\t}\n\treturn loaded;\n}\n\n/**\n * Forgets what `oncePerRequest` kept for this request, so the next call for\n * any key loads again. A call to `oncePerRequest` already in flight keeps its\n * own value; only later calls see the empty cache.\n */\nexport function clearRequestCache(request: object): void {\n\tcaches.delete(request);\n}\n\n/**\n * A mutation's root fields run one after the other in one request, and one\n * may change what a later one reads. `freshPerMutation(resolvers)` returns\n * the resolvers with every function of `Mutation` wrapped to call\n * `clearRequestCache(context)` before it runs: each root mutation field starts\n * with an empty cache, its own sub-fields share it, and a query (no wrapped\n * field) keeps one cache for the whole request. Other types are untouched.\n *\n * It returns the same type it was given: an array of maps (what\n * `createSchema` takes for `resolvers`) stays an array, each map wrapped on its\n * own, so graxia still merges them (a field defined twice throws there) and\n * each map stays checked.\n */\nexport function freshPerMutation<R extends object>(resolvers: R): R;\nexport function freshPerMutation(\n\tresolvers: object | readonly object[],\n): unknown {\n\tif (Array.isArray(resolvers)) {\n\t\treturn resolvers.map((map: object) => freshPerMutation(map));\n\t}\n\treturn wrapMutation(resolvers);\n}\n\nfunction wrapMutation<R extends object>(resolvers: R): R {\n\tconst mutation = (resolvers as { Mutation?: unknown }).Mutation as\n\t\t| Record<string, unknown>\n\t\t| undefined;\n\tif (!mutation) return resolvers;\n\tconst wrapped: Record<string, unknown> = {};\n\tfor (const [name, field] of Object.entries(mutation)) {\n\t\tif (typeof field !== 'function') {\n\t\t\twrapped[name] = field;\n\t\t\tcontinue;\n\t\t}\n\t\twrapped[name] = function (\n\t\t\tthis: unknown,\n\t\t\tparent: unknown,\n\t\t\targs: unknown,\n\t\t\tcontext: unknown,\n\t\t\tinfo: unknown,\n\t\t) {\n\t\t\tif (typeof context === 'object' && context !== null) {\n\t\t\t\tclearRequestCache(context);\n\t\t\t}\n\t\t\treturn field.call(this, parent, args, context, info);\n\t\t};\n\t}\n\treturn { ...resolvers, Mutation: wrapped };\n}\n"
17
17
  ],
18
- "mappings": "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",
19
- "debugId": "32A986800C6A89D964756E2164756E21",
18
+ "mappings": "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",
19
+ "debugId": "30AF2FD9C538C31F64756E2164756E21",
20
20
  "names": []
21
21
  }
@@ -1 +1 @@
1
- {"version":3,"file":"operation.d.ts","sourceRoot":"","sources":["../src/operation.ts"],"names":[],"mappings":"AAoDA,iFAAiF;AACjF,wBAAgB,iBAAiB,oGAgDhC"}
1
+ {"version":3,"file":"operation.d.ts","sourceRoot":"","sources":["../src/operation.ts"],"names":[],"mappings":"AAsIA,iFAAiF;AACjF,wBAAgB,iBAAiB,oGAwEhC"}
@@ -174,6 +174,10 @@ const app = alxia()
174
174
  `subscription OnNote`, with `graphql.operation.name` and
175
175
  `graphql.operation.type`, an error when answered with errors. No span
176
176
  lasts as long as the socket.
177
+ - Under `@defer` and `@stream` over a socket, an operation lasts until its
178
+ last payload (`hasNext: false`), not its first, and ends with errors when a
179
+ deferred fragment or a streamed item failed. It ends once, with the outcome
180
+ so far, when its client leaves.
177
181
  - An error is an operation answered with errors: a resolver that threw
178
182
  (in `errors[]`), a document that does not validate, a subscription that
179
183
  failed. A message that does not parse names no operation, and is not
@@ -186,7 +190,8 @@ const app = alxia()
186
190
  they do.
187
191
 
188
192
  `graphql()` tells them with core's `startOperation`, from a graxia plugin on
189
- `onExecute` and `onSubscribe` (a query or mutation ends with its result, a
193
+ `onExecute` and `onSubscribe` (a query or mutation ends with its result, an
194
+ `@defer`/`@stream` one with its last payload, a
190
195
  subscription when its `signal` aborts), and they subscribe
191
196
  during the upgrade with `onOperation`: no package imports another
192
197
  ([core's plugin guide](https://github.com/softistx/alxia/blob/develop/packages/core/docs/guide/writing-a-plugin.md)).
@@ -26,7 +26,7 @@ bun add graphql@^17.1.0
26
26
 
27
27
  | Before | After |
28
28
  | --- | --- |
29
- | `graphql-yoga` | `@graxia/core` `^0.10.0` (0.10 sets the HTTP status from errors again) |
29
+ | `graphql-yoga` | `@graxia/core` `^0.10.0 \|\| ^0.11.0` (0.10 sets the HTTP status from errors again) |
30
30
  | `graphql-ws` (for `ws`) | nothing: graxia speaks `graphql-transport-ws` |
31
31
  | bundled GraphiQL of Yoga | `@graxia/graphiql` `^0.2.4` (required) |
32
32
  | Envelop plugins | not a peer: install `@graxia/envelop` yourself to use Envelop plugins |
@@ -63,6 +63,12 @@ cast is needed. A field defined twice **throws** a `GraxiaConfigError` naming
63
63
  (Yoga's tools let the last one win). `freshPerMutation` takes the same array
64
64
  and returns an array, each map wrapped on its own.
65
65
 
66
+ `createSchema` also adds the `@cost` and `@listSize` directives (for the
67
+ operation cost) and, unless `incremental: false`, `@defer` and `@stream` to the
68
+ schema (a directive the SDL already declares is kept). A `schema.graphql`
69
+ printed from the Yoga schema, or a snapshot of it, no longer matches: print it
70
+ again from the new schema and commit the result.
71
+
66
72
  ```ts
67
73
  // file: src/schema-maps.ts
68
74
  import { createSchema } from '@graxia/core';
@@ -126,14 +132,10 @@ export const plugins = [fromEnvelop([useDepthLimit({ maxDepth: 8 })])];
126
132
  ```
127
133
 
128
134
  **Janus.** `useJanus()` was a Yoga plugin. Use `@softistx/janus-graphql`
129
- `>=0.36.0` and its `/graxia` entry, `janusGraxia(options)`, in `plugins`.
135
+ `^0.36.2` (or later) and its `/graxia` entry, `janusGraxia(options)`, in `plugins`.
130
136
  `fromEnvelop` refuses the old plugin at boot, since it relies on Yoga's
131
137
  `onResponse` hook; wrapping it is not a way around.
132
138
 
133
- <!-- Temporary, until nxgt-janus#1003 is released -->
134
- `@softistx/janus-graphql` 0.36.0 still declares `@graxia/core ^0.9.0`; expect a
135
- peer warning until its next release.
136
-
137
139
  ```diff
138
140
  -import { useJanus } from '@softistx/janus-graphql';
139
141
  +import { janusGraxia } from '@softistx/janus-graphql/graxia';
@@ -152,6 +154,9 @@ Many Yoga plugins have a graxia option now: depth, aliases and cost limits
152
154
  `respond(new Response(null, { status: 401 }))` answers; a `throw` is an
153
155
  unexpected failure and answers 500. `onResponse` has no `respond`: it
154
156
  replaces the response with `setResponse`.
157
+ - **`respond` stops the plugins after it.** Once a plugin answers with
158
+ `respond`, the later plugins' hooks of that stage do not run. Put the plugins
159
+ that only add headers or record something before the ones that may refuse.
155
160
  - **Per-operation checks go in `onParams`.** `onRequest` runs for every
156
161
  request that reaches the endpoint, the GraphiQL page's `GET` included, so a
157
162
  check there blocks the IDE too.
@@ -167,6 +172,51 @@ export const refuse = (headers?: Headers): Response =>
167
172
  new Response(null, { status: 401, ...(headers ? { headers } : {}) });
168
173
  ```
169
174
 
175
+ - **`setResult` in the after-hook of `onValidate` is refused.** An Envelop
176
+ plugin (through `@graxia/envelop`) that calls `setResult` there gets a
177
+ `GraxiaConfigError`, by design. Call `setResult` in `onValidate` itself, or
178
+ add validation rules (`addValidationRule`, or `setValidationFn` to wrap the rules) instead of rewriting the
179
+ result afterwards. See `@graxia/envelop`'s
180
+ [troubleshooting](https://github.com/softistx/graxia/blob/develop/packages/envelop/docs/troubleshooting.md)
181
+ ("calls setResult in the after-hook of onValidate…") and the hook table of
182
+ its [Envelop guide](https://github.com/softistx/graxia/blob/develop/packages/envelop/docs/guide/envelop.md).
183
+ - **Variable-coercion errors carry `extensions.code: 'BAD_USER_INPUT'`**
184
+ from graxia. Errors graphql raises before any field runs (a bad
185
+ variable, an unknown operation name) are stamped with it when they have no
186
+ code of their own. App code or specs that reshape those errors into a code of
187
+ their own, or assert the old absence of a code, must accept `BAD_USER_INPUT`.
188
+ - **graxia's operation limits are on by default.** `limits` caps `depth` (12),
189
+ `aliases` (30), `directives` (50), `rootFields` (20) and `cost` (5 000). An
190
+ app that already has its own depth, alias, root-field or cost rules (or specs
191
+ that probe their thresholds) turns graxia's off, or aligns the two:
192
+
193
+ ```ts
194
+ // file: src/limits.ts
195
+ import type { OperationLimits } from '@graxia/core';
196
+
197
+ // Turn off what the app's own rules already enforce…
198
+ export const off: OperationLimits = {
199
+ depth: false,
200
+ aliases: false,
201
+ rootFields: false,
202
+ directives: false,
203
+ cost: false,
204
+ };
205
+
206
+ // …or keep graxia's and align the numbers.
207
+ export const aligned: OperationLimits = { depth: 8, cost: { max: 2_000 } };
208
+ // Pass one of them as `createGraxia({ …, limits: off })`.
209
+ ```
210
+
211
+ - **A hard-coded `status: 400` on validation refusals is redundant under
212
+ `application/graphql-response+json`.** graxia honours
213
+ `extensions.http.status`, and a validation failure already answers 400 for a
214
+ client that accepts `application/graphql-response+json`; for plain
215
+ `application/json` the unchanged default is 200. Keep an explicit status only
216
+ to force a code for plain JSON clients, and set it as
217
+ `extensions: { http: { status: 400 } }` on the error rather than in a layer
218
+ around the server.
219
+
170
220
  ## Options
171
221
 
172
222
  | Option | Now |
@@ -204,6 +254,10 @@ that offers no subprotocol now gets an HTTP 400 at the upgrade. See
204
254
  no pings ([troubleshooting](troubleshooting.md#typeerror-graphqlapp--ws--keepalive-0---keepalive-is-the-milliseconds-between-pings-a-positive-number-up-to-2147483647-or-false-for-none)).
205
255
  - A binary frame is refused: the socket closes with `4400`, so send text
206
256
  frames ([troubleshooting](troubleshooting.md#a-websocket-closes-with-4400-after-the-first-message)).
257
+ - A subscription sent as a plain JSON `POST` (no `Accept: text/event-stream`)
258
+ is refused with a `SUBSCRIPTION_NOT_SUPPORTED` error whose message names the
259
+ transports that are on. Clients must send `Accept: text/event-stream` or use
260
+ the WebSocket.
207
261
 
208
262
  ## IDE
209
263
 
@@ -217,9 +271,10 @@ GraphiQL comes from `@graxia/graphiql`, a required peer; `ide`, `graphiql` and
217
271
  `@graxia/core` (or a `GraphQLError`) for what a client may read.
218
272
  - `extensions.http.status` and `extensions.http.headers` on an error set the
219
273
  HTTP response again, as under Yoga (`@graxia/core` 0.10, graxia#147), for a
220
- single operation answered as plain JSON; a subscription that fails before
221
- its first event is not covered yet (graxia#150)
222
- <!-- Temporary, until graxia#150 -->. `errorHttp: false` turns it off:
274
+ single operation answered as plain JSON. The first event of a subscription
275
+ refused before its stream opens honours it too, from `@graxia/core` 0.11.0:
276
+ the answer is an event-stream response carrying the status and headers;
277
+ `spec: true` drops the status there, as in Yoga. `errorHttp: false` turns it off:
223
278
  the media type decides and `extensions` are untouched. The app's layers still
224
279
  answer an auth error before.
225
280
  - Server code reading `error.extensions['http']` needs index access once
@@ -266,18 +321,26 @@ prefix, `GraphQLContext<typeof app>`, `oncePerRequest`, `freshPerMutation`,
266
321
  2. Swap the peers: remove `graphql-yoga` and `graphql-ws`, add `@graxia/core`,
267
322
  `@graxia/graphiql`; add `@graxia/envelop` only to use Envelop plugins.
268
323
  3. Import `createSchema` from `@graxia/core` and curry it: `createSchema<Ctx>()({ … })`;
269
- pass several resolver maps as an array, not a cast.
324
+ pass several resolver maps as an array, not a cast; print `schema.graphql`
325
+ again (graxia adds `@cost`, `@listSize` and, unless `incremental: false`,
326
+ `@defer`, `@stream`).
270
327
  4. Annotate the `context` option's argument with `ServerContext`, and read the
271
328
  app's values from `serverContext`.
272
- 5. Rewrite each Yoga plugin (`definePlugin`) or wrap it (`fromEnvelop`).
329
+ 5. Rewrite each Yoga plugin (`definePlugin`) or wrap it (`fromEnvelop`), the
330
+ plugins that only add headers before the ones that `respond`.
273
331
  6. Rename `maxTokens`, `maxNesting`, `parseCache` and `maskedErrors` to
274
332
  `limits`, `caches` and `maskErrors`.
275
333
  7. Replace `sameOrigin()`, `renderSandbox`, `logging`, `requestId` and `cors`.
276
334
  8. Send a CSRF header from every client that uses `GET` or a non-JSON `POST`.
277
335
  9. Match refusals by their code, not by Yoga's messages.
278
336
  10. Write `ws: { keepAlive: false }` instead of `keepAlive: 0`, send text frames
279
- over WebSocket, and read `OPERATION_ABORTED` from an aborted executor call.
337
+ over WebSocket, send subscriptions with `Accept: text/event-stream` (or over
338
+ WebSocket), and read `OPERATION_ABORTED` from an aborted executor call.
280
339
  11. Call `await executor.dispose()` when a `graphqlExecutor` is done (a spec's
281
340
  `afterAll`, a job's shutdown).
282
- 12. Run the app's specs, then `graphqlClient` against a few refusals (an
341
+ 12. Replace `setResult` in an `onValidate` after-hook, accept
342
+ `extensions.code: 'BAD_USER_INPUT'` on variable errors, turn off or align
343
+ graxia's default `limits` with the app's own, and drop a redundant
344
+ hard-coded `status: 400`.
345
+ 13. Run the app's specs, then `graphqlClient` against a few refusals (an
283
346
  oversized body, a mutation over `GET`, a missing header).
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@alxia/graphql",
3
- "version": "0.18.0",
3
+ "version": "0.18.2",
4
4
  "description": "GraphQL for alxia served by @graxia/core: its plugins, subscriptions over SSE or WebSocket and GraphiQL, behind the app's hooks, its resolvers reading the app's typed context",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -52,9 +52,9 @@
52
52
  "@alxia/telemetry": "^0.9.4",
53
53
  "@envelop/core": "^6.0.1",
54
54
  "@envelop/depth-limit": "^7.2.1",
55
- "@graxia/core": "^0.10.0",
56
- "@graxia/envelop": "^0.1.4",
57
- "@graxia/graphiql": "^0.2.4",
55
+ "@graxia/core": "^0.11.0",
56
+ "@graxia/envelop": "^0.1.5",
57
+ "@graxia/graphiql": "^0.2.5",
58
58
  "@softistx/telemetry": "^0.5.0",
59
59
  "@types/bun": "^1.4.4",
60
60
  "dataloader": "^2.2.3",
@@ -64,7 +64,7 @@
64
64
  "@alxia/core": "^0.27.0",
65
65
  "graphql": "^17.1.0",
66
66
  "typescript": "^6.0.3 || ^7.0.0",
67
- "@graxia/core": "^0.10.0",
67
+ "@graxia/core": "^0.10.0 || ^0.11.0",
68
68
  "@graxia/graphiql": "^0.2.4"
69
69
  }
70
70
  }