@alxia/graphql 0.8.3 → 0.9.1

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/dist/index.js.map CHANGED
@@ -1,17 +1,21 @@
1
1
  {
2
2
  "version": 3,
3
- "sources": ["../src/graphql.ts", "../src/handler.ts", "../src/body-refusal.ts", "../src/sandbox.ts", "../src/operation.ts", "../src/ws-operations.ts", "../src/ws-server.ts", "../src/ws.ts"],
3
+ "sources": ["../src/graphql.ts", "../src/endpoint.ts", "../src/handler.ts", "../src/body-refusal.ts", "../src/sandbox.ts", "../src/operation.ts", "../src/parse-limits.ts", "../src/document-cache.ts", "../src/nesting.ts", "../src/ws-operations.ts", "../src/ws-server.ts", "../src/ws.ts"],
4
4
  "sourcesContent": [
5
- "import {\n\ttype Alxia,\n\ttype BaseContext,\n\ttype Empty,\n\tisDev,\n\ttype RoutePath,\n} from '@alxia/core';\nimport type {\n\tGraphQLSchemaWithContext,\n\tYogaInitialContext,\n\tYogaServerOptions,\n} from 'graphql-yoga';\nimport { graphqlHandler, type YogaContext, yogaServers } from './handler';\nimport { reportsOperations } from './operation';\nimport type { SandboxOptions } from './sandbox';\nimport { type GraphQLWsOptions, graphqlSocket } from './ws';\n\n/** The parts of a route's context Yoga 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 Yoga for each request: the context its middlewares built —\n * `user`, `db`, `log`… — with `request`, `url`, `ip` and `set`, through\n * which a resolver sets a cookie or a header on the response.\n */\nexport type ServerContext<Ctx> = Omit<BaseContext & Ctx, RouteOnly>;\n\n/**\n * What an operation over WebSocket adds to its context (`ws` on): the\n * `connectionParams` the client sent when it connected. `undefined` over\n * HTTP, and for a client that sent none.\n */\nexport interface GraphQLWsContext {\n\treadonly connectionParams?: Readonly<Record<string, unknown>>;\n}\n\n/**\n * What a resolver reads as its context: Yoga's own, the app's, what\n * the `context` option adds, and over WebSocket the `connectionParams`. Type a schema with it:\n *\n * ```ts\n * const base = alxia().use(bearer({ jwt }));\n * const schema = createSchema<GraphQLContext<typeof base>>({ ... });\n * ```\n */\nexport type GraphQLContext<App, UserContext = Empty> = App extends {\n\treadonly '~context': infer Ctx;\n}\n\t? YogaInitialContext & ServerContext<Ctx> & GraphQLWsContext & UserContext\n\t: // Not `never`: a schema typed with `never` would let every resolver\n\t\t// read anything until `graphql()` refused it.\n\t\t{\n\t\t\treadonly '~error': 'GraphQLContext needs the type of an app: GraphQLContext<typeof app>';\n\t\t};\n\nexport interface GraphQLOptions<\n\tServerCtx extends YogaContext,\n\tUserCtx extends YogaContext,\n\tPath extends RoutePath,\n\tSchemaCtx = unknown,\n> extends Omit<\n\t\tYogaServerOptions<ServerCtx, UserCtx>,\n\t\t'graphqlEndpoint' | 'cors' | 'schema' | 'graphiql'\n\t> {\n\t/**\n\t * What a browser gets at the endpoint: Yoga's GraphiQL, Apollo Sandbox,\n\t * or nothing. By default, GraphiQL in the serving app's dev alone\n\t * (`isDev`: `alxia({ dev })`, else `NODE_ENV=development`), nothing\n\t * otherwise; `graphiql` or `apollo-sandbox` serves one everywhere.\n\t */\n\treadonly ide?: 'graphiql' | 'apollo-sandbox' | false;\n\t/** GraphiQL's options, Yoga's own, when `ide` is `graphiql`. */\n\treadonly graphiql?: Exclude<\n\t\tYogaServerOptions<ServerCtx, UserCtx>['graphiql'],\n\t\tboolean\n\t>;\n\t/** Apollo Sandbox's options, when `ide` is `apollo-sandbox`. */\n\treadonly sandbox?: SandboxOptions;\n\t/**\n\t * The schema, from Yoga's `createSchema`, Pothos, or any tool that types\n\t * its context. Its context must be one the app builds: a resolver that\n\t * reads `user` behind no middleware that adds one is a compile error.\n\t */\n\treadonly schema: GraphQLSchemaWithContext<SchemaCtx>;\n\t/** Where the endpoint is, under the app's prefix. `/graphql` by default. */\n\treadonly path?: Path;\n\t/**\n\t * Yoga's own CORS. Off by default: `@alxia/cors` answers for the whole\n\t * app, this endpoint included.\n\t */\n\treadonly cors?: YogaServerOptions<ServerCtx, UserCtx>['cors'];\n\t/**\n\t * GraphQL over WebSocket too, the `graphql-transport-ws` protocol of\n\t * Apollo Client's and urql's default link, served by the optional peer\n\t * `graphql-ws` at the endpoint's path: `true`, or where and how often it\n\t * pings. Off by default: subscriptions are served over server-sent\n\t * events, which stay served beside it.\n\t */\n\treadonly ws?: boolean | GraphQLWsOptions;\n}\n\n/**\n * The check Yoga's types leave out: the context the app builds must hold\n * what the schema's resolvers read. A mistake comes back as a `schema`\n * whose type is the message.\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 [GraphQL Yoga](https://the-guild.dev/graphql/yoga-server):\n * `GET` and `POST` at `path`, behind every middleware given to `use` on `app`\n * before it. A guard before it guards it; what the middlewares added is in each\n * resolver's context, typed. Yoga's options pass through — `plugins`\n * (Envelop's and Yoga's), `graphiql`, `maskedErrors`, `batching`… —\n * and subscriptions are served over server-sent events, and over\n * WebSocket too with `ws: true`.\n *\n * ```ts\n * const app = alxia()\n * .use(bearer({ jwt }))\n * .plugin((app) => graphql(app, { schema, plugins: [useDepthLimit()] }));\n * ```\n */\nexport function graphql<\n\tCtx extends object,\n\tPrefix extends string,\n\tSchemaCtx,\n\tUserCtx extends YogaContext = Empty,\n\tconst Path extends RoutePath = '/graphql',\n>(\n\tapp: Alxia<Ctx, Prefix>,\n\toptions: GraphQLOptions<ServerContext<Ctx>, UserCtx, Path, SchemaCtx> &\n\t\tProvidesContext<\n\t\t\tYogaInitialContext & ServerContext<Ctx> & UserCtx,\n\t\t\tSchemaCtx\n\t\t>,\n): Alxia<Ctx, Prefix> {\n\tconst {\n\t\tpath = '/graphql' as Path,\n\t\tcors = false,\n\t\tide,\n\t\tgraphiql,\n\t\tsandbox,\n\t\tws = false,\n\t\t...yogaOptions\n\t} = options;\n\tconst page = graphiql ?? true;\n\tconst yogaAt = yogaServers<UserCtx>({\n\t\t...(yogaOptions as YogaServerOptions<YogaContext, UserCtx>),\n\t\tplugins: [...(yogaOptions.plugins ?? []), reportsOperations()],\n\t\tcors,\n\t\tgraphiql: (ide === undefined\n\t\t\t? (_request: Request, context: object) => isDev(context) && page\n\t\t\t: ide === 'graphiql'\n\t\t\t\t? page\n\t\t\t\t: false) as YogaServerOptions<YogaContext, UserCtx>['graphiql'],\n\t});\n\tconst handler = graphqlHandler(\n\t\tyogaAt,\n\t\tide === 'apollo-sandbox' ? (sandbox ?? {}) : false,\n\t);\n\n\tconst route = app as unknown as {\n\t\tget(path: string, handler: unknown): unknown;\n\t\tpost(path: string, handler: unknown): unknown;\n\t\tws(path: string, ...rest: unknown[]): unknown;\n\t};\n\troute.get(path, handler);\n\troute.post(path, handler);\n\tif (ws !== false) {\n\t\tconst socket = graphqlSocket(yogaAt, path, ws === true ? {} : ws);\n\t\troute.ws(socket.path, socket.middleware, socket.handlers);\n\t}\n\treturn app as never;\n}\n",
6
- "/**\n * The endpoint behind `graphql()`: one Yoga per path it is served at, and\n * the route handler that hands each request to it.\n */\nimport { type BaseContext, type StatusCode, shutdownSignal } from '@alxia/core';\nimport {\n\tcreateYoga,\n\ttype YogaServerInstance,\n\ttype YogaServerOptions,\n} from 'graphql-yoga';\nimport { watchBody, withoutOriginalError } from './body-refusal';\nimport { renderSandbox, SANDBOX_POLICY, type SandboxOptions } from './sandbox';\n\nexport type YogaContext = Record<string, any>;\n\n/** Where Yoga's GraphiQL page loads its files from: one pinned version on unpkg. */\nconst GRAPHIQL_FILES =\n\t/https:\\/\\/unpkg\\.com\\/@graphql-yoga\\/graphiql@[\\w.-]+\\//;\n\n/**\n * What GraphiQL's page may load: its scripts, styles and Monaco's\n * workers from the exact version of `@graphql-yoga/graphiql` the page\n * names, fetched and run as blobs; queries to this server alone; framed\n * by no one. A page that names none (a `renderGraphiQL` of the app's own)\n * gets this server alone. `@alxia/secure-headers` keeps a policy a\n * response already has.\n */\nexport function graphiqlPolicy(html: string): string {\n\tconst files = html.match(GRAPHIQL_FILES)?.[0] ?? '';\n\tconst from = files === '' ? '' : ` ${files}`;\n\treturn [\n\t\t\"default-src 'self'\",\n\t\t`script-src 'self' 'unsafe-inline'${from}`,\n\t\t`style-src 'self' 'unsafe-inline'${from}`,\n\t\t\"img-src 'self' data: https:\",\n\t\t`font-src 'self' data:${from}`,\n\t\t\"worker-src 'self' blob:\",\n\t\t`connect-src 'self'${from}`,\n\t\t\"frame-ancestors 'none'\",\n\t].join('; ');\n}\n\n/**\n * The Yoga serving `endpoint`, created on first use. One per path: a plugin\n * mounted under a prefix serves the same routes at a longer path, and\n * GraphiQL must ask that one.\n */\nexport function yogaServers<UserCtx extends YogaContext>(\n\toptions: Omit<YogaServerOptions<YogaContext, UserCtx>, 'graphqlEndpoint'>,\n): (endpoint: string) => YogaServerInstance<YogaContext, UserCtx> {\n\tconst servers = new Map<string, YogaServerInstance<YogaContext, UserCtx>>();\n\treturn (endpoint) => {\n\t\tlet yoga = servers.get(endpoint);\n\t\tif (yoga === undefined) {\n\t\t\tyoga = createYoga<YogaContext, UserCtx>({\n\t\t\t\t...options,\n\t\t\t\tgraphqlEndpoint: endpoint,\n\t\t\t});\n\t\t\tservers.set(endpoint, yoga);\n\t\t}\n\t\treturn yoga;\n\t};\n}\n\n/**\n * What Yoga is handed as its server context: the route's context — the\n * middlewares' work — minus what a resolver has no use for.\n */\nexport function serverContext(\n\tctx: Record<string, unknown>,\n): Record<string, unknown> {\n\tconst {\n\t\tparams: _params,\n\t\tquery: _query,\n\t\theaders: _headers,\n\t\tcookies: _cookies,\n\t\tbody: _body,\n\t\treply: _reply,\n\t\tredirect: _redirect,\n\t\t...server\n\t} = ctx;\n\treturn server;\n}\n\n/**\n * The handler of the endpoint's `GET` and `POST`: Apollo Sandbox's page to\n * a browser when `sandbox` is not `false`, else the request to Yoga, with\n * the route's context — the middlewares' work, minus what a resolver has no use\n * for — as Yoga's server context.\n */\nexport function graphqlHandler<UserCtx extends YogaContext>(\n\tyogaAt: (endpoint: string) => YogaServerInstance<YogaContext, UserCtx>,\n\tsandbox: SandboxOptions | false,\n) {\n\t// A handler's context: its route is the one it was declared at. Named\n\t// `graphql`, the name the route table `listen` prints in dev shows.\n\treturn async function graphql(\n\t\tctx: Record<string, unknown> & BaseContext & { readonly route: string },\n\t) {\n\t\tconst { reply } = ctx;\n\t\tconst server = serverContext(ctx);\n\t\tif (\n\t\t\tsandbox !== false &&\n\t\t\tctx.request.method === 'GET' &&\n\t\t\tctx.request.headers.get('accept')?.includes('text/html') &&\n\t\t\t!ctx.url.searchParams.has('query')\n\t\t) {\n\t\t\t// A path: the page resolves it against its own address, so behind\n\t\t\t// a TLS proxy the Sandbox asks over https, as the browser did.\n\t\t\treturn reply(200, renderSandbox(ctx.route, sandbox), {\n\t\t\t\theaders: {\n\t\t\t\t\t'content-type': 'text/html;charset=utf-8',\n\t\t\t\t\t'content-security-policy': SANDBOX_POLICY,\n\t\t\t\t},\n\t\t\t});\n\t\t}\n\t\tconst watched = watchBody(ctx.request);\n\t\tconst answered = await yogaAt(ctx.route).fetch(watched.request, server);\n\t\t// Yoga answered a body past `bodyLimit` with its own 400: core's 413\n\t\t// is the answer, in the app's format.\n\t\tconst refusal = watched.refusal();\n\t\tif (refusal !== undefined) {\n\t\t\tvoid answered.body?.cancel();\n\t\t\tthrow refusal;\n\t\t}\n\t\tconst response = await withoutOriginalError(answered);\n\t\tconst headers = new Headers(response.headers);\n\t\tif (\n\t\t\theaders.get('content-type')?.startsWith('text/html') &&\n\t\t\t!headers.has('content-security-policy')\n\t\t) {\n\t\t\t// GraphiQL's page: its policy names the files it loads.\n\t\t\tconst html = await response.text();\n\t\t\theaders.set('content-security-policy', graphiqlPolicy(html));\n\t\t\treturn reply(response.status as StatusCode, html, { headers });\n\t\t}\n\t\tconst body = endedOnShutdown(response, shutdownSignal(ctx));\n\t\treturn reply(response.status as StatusCode, body ?? undefined, {\n\t\t\theaders,\n\t\t});\n\t};\n}\n\n/**\n * A subscription's or an incremental delivery's body, which streams until\n * its reader stops: ended when the app starts shutting down — Yoga's\n * stream cancelled, as when the client leaves, and the client reading its\n * end — so the drain does not wait for it. Any other body finishes within\n * the drain as it is.\n */\nfunction endedOnShutdown(\n\tresponse: Response,\n\tsignal: AbortSignal,\n): ReadableStream<Uint8Array> | null {\n\tconst body = response.body;\n\tconst type = response.headers.get('content-type') ?? '';\n\tif (body === null || !/text\\/event-stream|multipart\\/mixed/.test(type)) {\n\t\treturn body;\n\t}\n\tconst reader = body.getReader();\n\t// The signal lives as long as the process: the listener goes as soon as\n\t// the stream is over, however it ended, or each response would leave one.\n\tconst end = () => {\n\t\tsignal.removeEventListener('abort', end);\n\t\tvoid reader.cancel();\n\t\ttry {\n\t\t\tcontroller.close();\n\t\t} catch {\n\t\t\t// Closed already: the stream had ended.\n\t\t}\n\t};\n\tlet controller: ReadableStreamDefaultController<Uint8Array>;\n\treturn new ReadableStream<Uint8Array>({\n\t\tstart(started) {\n\t\t\tcontroller = started;\n\t\t\tif (signal.aborted) end();\n\t\t\telse signal.addEventListener('abort', end, { once: true });\n\t\t},\n\t\tasync pull(controller) {\n\t\t\tconst result = await reader.read().catch((error: unknown) => {\n\t\t\t\tsignal.removeEventListener('abort', end);\n\t\t\t\tthrow error;\n\t\t\t});\n\t\t\tif (result.done) {\n\t\t\t\tsignal.removeEventListener('abort', end);\n\t\t\t\ttry {\n\t\t\t\t\tcontroller.close();\n\t\t\t\t} catch {\n\t\t\t\t\t// Closed already: the shutdown ended it.\n\t\t\t\t}\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tcontroller.enqueue(result.value);\n\t\t},\n\t\tcancel: (reason) => {\n\t\t\tsignal.removeEventListener('abort', end);\n\t\t\treturn reader.cancel(reason);\n\t\t},\n\t});\n}\n",
7
- "/**\n * Yoga reads the request body itself, and turns any failure of the read\n * into its own 400. A body past core's `bodyLimit` fails the read with a\n * `ContentTooLargeError`; `watchBody` keeps that error, so the handler\n * can throw it again once Yoga has answered, and the app's own boundary\n * answers the 413 in its error format, leaking nothing of Yoga's.\n */\nimport type { ContentTooLargeError } from '@alxia/core';\n\n/**\n * By its name and its limit, not `instanceof`: the copy of core that\n * limited the body may not be the one this package resolves.\n */\nfunction isTooLarge(error: unknown): error is ContentTooLargeError {\n\treturn (\n\t\terror instanceof Error &&\n\t\terror.name === 'ContentTooLargeError' &&\n\t\ttypeof (error as { limit?: unknown }).limit === 'number'\n\t);\n}\n\nexport interface WatchedRequest {\n\t/** The request to hand to Yoga: the same, its body watched. */\n\treadonly request: Request;\n\t/** The `ContentTooLargeError` the body's read failed with, if it did. */\n\trefusal(): ContentTooLargeError | undefined;\n}\n\n/** `request` with its body's failure recorded; a request with no body is as it is. */\nexport function watchBody(request: Request): WatchedRequest {\n\tconst source = request.body;\n\tif (source === null || request.bodyUsed || source.locked) {\n\t\treturn { request, refusal: () => undefined };\n\t}\n\tlet refused: ContentTooLargeError | undefined;\n\tconst reader = source.getReader();\n\tconst body = new ReadableStream<Uint8Array>({\n\t\tasync pull(controller) {\n\t\t\ttry {\n\t\t\t\tconst { value, done } = await reader.read();\n\t\t\t\tif (done) controller.close();\n\t\t\t\telse controller.enqueue(value);\n\t\t\t} catch (error) {\n\t\t\t\tif (isTooLarge(error)) refused = error;\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t},\n\t\tcancel: (reason) => reader.cancel(reason),\n\t});\n\treturn {\n\t\trequest: new Request(request, { body, duplex: 'half' } as RequestInit),\n\t\trefusal: () => refused,\n\t};\n}\n\ninterface Failure {\n\terrors?: { extensions?: Record<string, unknown> }[];\n}\n\n/**\n * Yoga's 400 for a request it cannot read — a body that is not JSON, a\n * query string that is not valid — carries the parser's own error as\n * `extensions.originalError`. A client reads the message and the code, not\n * what a parser said: the response without it, any other as it is.\n */\nexport async function withoutOriginalError(\n\tresponse: Response,\n): Promise<Response> {\n\tconst type = response.headers.get('content-type') ?? '';\n\tif (\n\t\tresponse.status !== 400 ||\n\t\t!/^application\\/(?:[\\w.-]+\\+)?json/.test(type)\n\t) {\n\t\treturn response;\n\t}\n\tconst text = await response.text();\n\tlet failure: Failure;\n\ttry {\n\t\tfailure = JSON.parse(text) as Failure;\n\t} catch {\n\t\treturn new Response(text, response);\n\t}\n\tfor (const error of failure.errors ?? []) {\n\t\tdelete error.extensions?.['originalError'];\n\t}\n\tconst headers = new Headers(response.headers);\n\theaders.delete('content-length');\n\treturn new Response(JSON.stringify(failure), { status: 400, headers });\n}\n",
5
+ "import {\n\ttype Alxia,\n\ttype BaseContext,\n\ttype Empty,\n\tisDev,\n\ttype RoutePath,\n} from '@alxia/core';\nimport type {\n\tGraphQLSchemaWithContext,\n\tYogaInitialContext,\n\tYogaServerOptions,\n} from 'graphql-yoga';\nimport { declareEndpoint } from './endpoint';\nimport { graphqlHandler, type YogaContext, yogaServers } from './handler';\nimport { reportsOperations } from './operation';\nimport {\n\tlimitsParsing,\n\ttype ParseCacheOptions,\n\tparseCaches,\n\tresolveLimits,\n} from './parse-limits';\nimport type { SandboxOptions } from './sandbox';\nimport { type GraphQLWsOptions, graphqlSocket } from './ws';\n\n/** The parts of a route's context Yoga 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 Yoga for each request: the context its middlewares built —\n * `user`, `db`, `log`… — with `request`, `url`, `ip` and `set`, through\n * which a resolver sets a cookie or a header on the response.\n */\nexport type ServerContext<Ctx> = Omit<BaseContext & Ctx, RouteOnly>;\n\n/**\n * What an operation over WebSocket adds to its context (`ws` on): the\n * `connectionParams` the client sent when it connected. `undefined` over\n * HTTP, and for a client that sent none.\n */\nexport interface GraphQLWsContext {\n\treadonly connectionParams?: Readonly<Record<string, unknown>>;\n}\n\n/**\n * What a resolver reads as its context: Yoga's own, the app's, what\n * the `context` option adds, and over WebSocket the `connectionParams`. Type a schema with it:\n *\n * ```ts\n * const base = alxia().use(bearer({ jwt }));\n * const schema = createSchema<GraphQLContext<typeof base>>({ ... });\n * ```\n */\nexport type GraphQLContext<App, UserContext = Empty> = App extends {\n\treadonly '~context': infer Ctx;\n}\n\t? YogaInitialContext & ServerContext<Ctx> & GraphQLWsContext & UserContext\n\t: // Not `never`: a schema typed with `never` would let every resolver\n\t\t// read anything until `graphql()` refused it.\n\t\t{\n\t\t\treadonly '~error': 'GraphQLContext needs the type of an app: GraphQLContext<typeof app>';\n\t\t};\n\nexport interface GraphQLOptions<\n\tServerCtx extends YogaContext,\n\tUserCtx extends YogaContext,\n\tPath extends RoutePath,\n\tSchemaCtx = unknown,\n> extends Omit<\n\t\tYogaServerOptions<ServerCtx, UserCtx>,\n\t\t'graphqlEndpoint' | 'cors' | 'schema' | 'graphiql'\n\t> {\n\t/**\n\t * What a browser gets at the endpoint: Yoga's GraphiQL, Apollo Sandbox,\n\t * or nothing. By default, GraphiQL in the serving app's dev alone\n\t * (`isDev`: `alxia({ dev })`, else `NODE_ENV=development`), nothing\n\t * otherwise; `graphiql` or `apollo-sandbox` serves one everywhere.\n\t */\n\treadonly ide?: 'graphiql' | 'apollo-sandbox' | false;\n\t/** GraphiQL's options, Yoga's own, when `ide` is `graphiql`. */\n\treadonly graphiql?: Exclude<\n\t\tYogaServerOptions<ServerCtx, UserCtx>['graphiql'],\n\t\tboolean\n\t>;\n\t/** Apollo Sandbox's options, when `ide` is `apollo-sandbox`. */\n\treadonly sandbox?: SandboxOptions;\n\t/**\n\t * The schema, from Yoga's `createSchema`, Pothos, or any tool that types\n\t * its context. Its context must be one the app builds: a resolver that\n\t * reads `user` behind no middleware that adds one is a compile error.\n\t */\n\treadonly schema: GraphQLSchemaWithContext<SchemaCtx>;\n\t/** Where the endpoint is, under the app's prefix. `/graphql` by default. */\n\treadonly path?: Path;\n\t/**\n\t * Yoga's own CORS. Off by default: `@alxia/cors` answers for the whole\n\t * app, this endpoint included.\n\t */\n\treadonly cors?: YogaServerOptions<ServerCtx, UserCtx>['cors'];\n\t/**\n\t * GraphQL over WebSocket too, the `graphql-transport-ws` protocol of\n\t * Apollo Client's and urql's default link, served by the optional peer\n\t * `graphql-ws` at the endpoint's path: `true`, or where and how often it\n\t * pings. Off by default: subscriptions are served over server-sent\n\t * events, which stay served beside it.\n\t */\n\treadonly ws?: boolean | GraphQLWsOptions;\n\t/**\n\t * The most tokens a document may hold, 15 000 by default (Apollo\n\t * Router's own), or `false` for no cap. A longer document is refused by\n\t * the parser before anything runs, as Yoga refuses any document it\n\t * cannot parse: `GRAPHQL_PARSE_FAILED`.\n\t */\n\treadonly maxTokens?: number | false;\n\t/**\n\t * The most levels of `{`, `(` and `[` a document may nest, 1 000 by\n\t * default, or `false` for no limit. A deeper document is refused before\n\t * the parser recurses into it, as `GRAPHQL_PARSE_FAILED`: graphql-js\n\t * overflows the stack a few thousand levels down, well under\n\t * `maxTokens`. A document that overflows it anyway is refused the same\n\t * way.\n\t */\n\treadonly maxNesting?: number | false;\n\t/**\n\t * The cache of parsed documents, one per endpoint, weighed by its tokens and bytes:\n\t * `maxBytes` (64 MiB by default), `max` documents (1 024) and `ttl`\n\t * milliseconds (one hour). `false` parses every request. Yoga's own\n\t * `parserAndValidationCache` replaces it, and cannot be given with it.\n\t */\n\treadonly parseCache?: false | ParseCacheOptions;\n\t/**\n\t * The most bytes a `POST` body may hold, over which core answers a 413.\n\t * Without it, the `bodyLimit()` the app declared before `graphql()`\n\t * applies as it is; without that, 1 MiB. An upload through a\n\t * `multipart` mutation needs a larger one.\n\t */\n\treadonly bodyLimit?: number;\n}\n\n/**\n * The check Yoga's types leave out: the context the app builds must hold\n * what the schema's resolvers read. A mistake comes back as a `schema`\n * whose type is the message.\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 [GraphQL Yoga](https://the-guild.dev/graphql/yoga-server):\n * `GET` and `POST` at `path`, behind every middleware given to `use` on `app`\n * before it. A guard before it guards it; what the middlewares added is in each\n * resolver's context, typed. Yoga's options pass through — `plugins`\n * (Envelop's and Yoga's), `graphiql`, `maskedErrors`, `batching`… —\n * and subscriptions are served over server-sent events, and over\n * WebSocket too with `ws: true`.\n *\n * ```ts\n * const app = alxia()\n * .use(bearer({ jwt }))\n * .plugin((app) => graphql(app, { schema, plugins: [useDepthLimit()] }));\n * ```\n */\nexport function graphql<\n\tCtx extends object,\n\tPrefix extends string,\n\tSchemaCtx,\n\tUserCtx extends YogaContext = Empty,\n\tconst Path extends RoutePath = '/graphql',\n>(\n\tapp: Alxia<Ctx, Prefix>,\n\toptions: GraphQLOptions<ServerContext<Ctx>, UserCtx, Path, SchemaCtx> &\n\t\tProvidesContext<\n\t\t\tYogaInitialContext & ServerContext<Ctx> & UserCtx,\n\t\t\tSchemaCtx\n\t\t>,\n): Alxia<Ctx, Prefix> {\n\tconst {\n\t\tpath = '/graphql' as Path,\n\t\tcors = false,\n\t\tide,\n\t\tgraphiql,\n\t\tsandbox,\n\t\tws = false,\n\t\tmaxTokens,\n\t\tmaxNesting,\n\t\tparseCache,\n\t\tbodyLimit,\n\t\t...yogaOptions\n\t} = options;\n\tconst limits = resolveLimits(maxTokens, maxNesting, parseCache, yogaOptions);\n\tconst page = graphiql ?? true;\n\tconst yogaAt = yogaServers<UserCtx>(\n\t\t{\n\t\t\t...(yogaOptions as YogaServerOptions<YogaContext, UserCtx>),\n\t\t\tplugins: [\n\t\t\t\tlimitsParsing(limits.tokens, limits.depth),\n\t\t\t\t...(yogaOptions.plugins ?? []),\n\t\t\t\treportsOperations(),\n\t\t\t],\n\t\t\tcors,\n\t\t\tgraphiql: (ide === undefined\n\t\t\t\t? (_request: Request, context: object) => isDev(context) && page\n\t\t\t\t: ide === 'graphiql'\n\t\t\t\t\t? page\n\t\t\t\t\t: false) as YogaServerOptions<YogaContext, UserCtx>['graphiql'],\n\t\t},\n\t\tyogaOptions.parserAndValidationCache === undefined\n\t\t\t? () => parseCaches(parseCache)\n\t\t\t: undefined,\n\t);\n\tconst handler = graphqlHandler(\n\t\tyogaAt,\n\t\tide === 'apollo-sandbox' ? (sandbox ?? {}) : false,\n\t);\n\n\tdeclareEndpoint(\n\t\tapp as never,\n\t\tpath,\n\t\thandler,\n\t\tbodyLimit,\n\t\tws === false\n\t\t\t? undefined\n\t\t\t: graphqlSocket(yogaAt, path, ws === true ? {} : ws),\n\t);\n\treturn app as never;\n}\n",
6
+ "import type { Alxia } from '@alxia/core';\nimport type { graphqlSocket } from './ws';\n\n/** The body limit of a `POST` when neither the option nor the app gives one: 1 MiB. */\nconst DEFAULT_BODY_LIMIT = 1_048_576;\n\n/** `GET` and `POST` at `path` on `app`, and the WebSocket when `ws` is on. */\nexport function declareEndpoint(\n\tapp: Alxia<never, string>,\n\tpath: string,\n\thandler: unknown,\n\tbodyLimit: number | undefined,\n\tsocket: ReturnType<typeof graphqlSocket> | undefined,\n): void {\n\tconst route = app as unknown as {\n\t\tget(path: string, handler: unknown): unknown;\n\t\tpost(path: string, ...rest: unknown[]): unknown;\n\t\tws(path: string, ...rest: unknown[]): unknown;\n\t};\n\troute.get(path, handler);\n\t// The GET just declared has the POST's scope: the limit an earlier\n\t// `bodyLimit()` gives it is the one the POST keeps.\n\tconst inherited = app.routes.at(-1)?.bodyLimit;\n\troute.post(\n\t\tpath,\n\t\t{ bodyLimit: bodyLimit ?? inherited ?? DEFAULT_BODY_LIMIT },\n\t\thandler,\n\t);\n\tif (socket !== undefined) {\n\t\troute.ws(socket.path, socket.middleware, socket.handlers);\n\t}\n}\n",
7
+ "/**\n * The endpoint behind `graphql()`: one Yoga per path it is served at, and\n * the route handler that hands each request to it.\n */\nimport {\n\ttype BaseContext,\n\ttype StatusCode,\n\tshutdownSignal,\n\tvary,\n} from '@alxia/core';\nimport {\n\tcreateYoga,\n\ttype YogaServerInstance,\n\ttype YogaServerOptions,\n} from 'graphql-yoga';\nimport { watchBody, withoutOriginalError } from './body-refusal';\nimport { renderSandbox, SANDBOX_POLICY, type SandboxOptions } from './sandbox';\n\nexport type YogaContext = Record<string, any>;\n\n/** Where Yoga's GraphiQL page loads its files from: one pinned version on unpkg. */\nconst GRAPHIQL_FILES =\n\t/https:\\/\\/unpkg\\.com\\/@graphql-yoga\\/graphiql@[\\w.-]+\\//;\n\n/**\n * What GraphiQL's page may load: its scripts, styles and Monaco's\n * workers from the exact version of `@graphql-yoga/graphiql` the page\n * names, fetched and run as blobs; queries to this server alone; framed\n * by no one. A page that names none (a `renderGraphiQL` of the app's own)\n * gets this server alone. `@alxia/secure-headers` keeps a policy a\n * response already has.\n */\nexport function graphiqlPolicy(html: string): string {\n\tconst files = html.match(GRAPHIQL_FILES)?.[0] ?? '';\n\tconst from = files === '' ? '' : ` ${files}`;\n\treturn [\n\t\t\"default-src 'self'\",\n\t\t`script-src 'self' 'unsafe-inline'${from}`,\n\t\t`style-src 'self' 'unsafe-inline'${from}`,\n\t\t\"img-src 'self' data: https:\",\n\t\t`font-src 'self' data:${from}`,\n\t\t\"worker-src 'self' blob:\",\n\t\t`connect-src 'self'${from}`,\n\t\t\"frame-ancestors 'none'\",\n\t].join('; ');\n}\n\n/**\n * The Yoga serving `endpoint`, created on first use. One per path: a plugin\n * mounted under a prefix serves the same routes at a longer path, and\n * GraphiQL must ask that one.\n */\nexport function yogaServers<UserCtx extends YogaContext>(\n\toptions: Omit<YogaServerOptions<YogaContext, UserCtx>, 'graphqlEndpoint'>,\n\tcaches?: () => YogaServerOptions<\n\t\tYogaContext,\n\t\tUserCtx\n\t>['parserAndValidationCache'],\n): (endpoint: string) => YogaServerInstance<YogaContext, UserCtx> {\n\tconst servers = new Map<string, YogaServerInstance<YogaContext, UserCtx>>();\n\treturn (endpoint) => {\n\t\tlet yoga = servers.get(endpoint);\n\t\tif (yoga === undefined) {\n\t\t\tyoga = createYoga<YogaContext, UserCtx>({\n\t\t\t\t...options,\n\t\t\t\t...(caches === undefined ? {} : { parserAndValidationCache: caches() }),\n\t\t\t\tgraphqlEndpoint: endpoint,\n\t\t\t});\n\t\t\tservers.set(endpoint, yoga);\n\t\t}\n\t\treturn yoga;\n\t};\n}\n\n/**\n * What Yoga is handed as its server context: the route's context — the\n * middlewares' work — minus what a resolver has no use for.\n */\nexport function serverContext(\n\tctx: Record<string, unknown>,\n): Record<string, unknown> {\n\tconst {\n\t\tparams: _params,\n\t\tquery: _query,\n\t\theaders: _headers,\n\t\tcookies: _cookies,\n\t\tbody: _body,\n\t\treply: _reply,\n\t\tredirect: _redirect,\n\t\t...server\n\t} = ctx;\n\treturn server;\n}\n\n/** Yoga's headers a 413 does not take: they frame or type Yoga's own body. */\nconst REFUSAL_OWN_HEADERS = new Set([\n\t'content-type',\n\t'content-length',\n\t'content-encoding',\n\t'transfer-encoding',\n]);\n\n/**\n * The handler of the endpoint's `GET` and `POST`: Apollo Sandbox's page to\n * a browser when `sandbox` is not `false`, else the request to Yoga, with\n * the route's context — the middlewares' work, minus what a resolver has no use\n * for — as Yoga's server context.\n */\nexport function graphqlHandler<UserCtx extends YogaContext>(\n\tyogaAt: (endpoint: string) => YogaServerInstance<YogaContext, UserCtx>,\n\tsandbox: SandboxOptions | false,\n) {\n\t// A handler's context: its route is the one it was declared at. Named\n\t// `graphql`, the name the route table `listen` prints in dev shows.\n\treturn async function graphql(\n\t\tctx: Record<string, unknown> & BaseContext & { readonly route: string },\n\t) {\n\t\tconst { reply } = ctx;\n\t\tconst server = serverContext(ctx);\n\t\tif (\n\t\t\tsandbox !== false &&\n\t\t\tctx.request.method === 'GET' &&\n\t\t\tctx.request.headers.get('accept')?.includes('text/html') &&\n\t\t\t!ctx.url.searchParams.has('query')\n\t\t) {\n\t\t\t// A path: the page resolves it against its own address, so behind\n\t\t\t// a TLS proxy the Sandbox asks over https, as the browser did.\n\t\t\treturn reply(200, renderSandbox(ctx.route, sandbox), {\n\t\t\t\theaders: {\n\t\t\t\t\t'content-type': 'text/html;charset=utf-8',\n\t\t\t\t\t'content-security-policy': SANDBOX_POLICY,\n\t\t\t\t},\n\t\t\t});\n\t\t}\n\t\tconst watched = watchBody(ctx.request);\n\t\tconst answered = await yogaAt(ctx.route).fetch(watched.request, server);\n\t\t// Yoga answered a body past `bodyLimit` with its own 400: core's 413\n\t\t// is the answer, in the app's format.\n\t\tconst refusal = watched.refusal();\n\t\tif (refusal !== undefined) {\n\t\t\tvoid answered.body?.cancel();\n\t\t\t// What Yoga's plugins set (`cache-control: no-store`…) stays on the\n\t\t\t// 413; its body and framing are core's.\n\t\t\tfor (const [name, value] of answered.headers) {\n\t\t\t\tif (REFUSAL_OWN_HEADERS.has(name)) continue;\n\t\t\t\tif (name === 'set-cookie') ctx.set.headers.append(name, value);\n\t\t\t\telse if (name === 'vary') {\n\t\t\t\t\t// Added to the app's own, as core's `send` does.\n\t\t\t\t\tfor (const part of value.split(',')) vary(ctx.set.headers, part);\n\t\t\t\t} else ctx.set.headers.set(name, value);\n\t\t\t}\n\t\t\tthrow refusal;\n\t\t}\n\t\tconst response = await withoutOriginalError(answered);\n\t\tconst headers = new Headers(response.headers);\n\t\tif (\n\t\t\theaders.get('content-type')?.startsWith('text/html') &&\n\t\t\t!headers.has('content-security-policy')\n\t\t) {\n\t\t\t// GraphiQL's page: its policy names the files it loads.\n\t\t\tconst html = await response.text();\n\t\t\theaders.set('content-security-policy', graphiqlPolicy(html));\n\t\t\treturn reply(response.status as StatusCode, html, { headers });\n\t\t}\n\t\tconst body = endedOnShutdown(response, shutdownSignal(ctx));\n\t\treturn reply(response.status as StatusCode, body ?? undefined, {\n\t\t\theaders,\n\t\t});\n\t};\n}\n\n/**\n * A subscription's or an incremental delivery's body, which streams until\n * its reader stops: ended when the app starts shutting down — Yoga's\n * stream cancelled, as when the client leaves, and the client reading its\n * end — so the drain does not wait for it. Any other body finishes within\n * the drain as it is.\n */\nfunction endedOnShutdown(\n\tresponse: Response,\n\tsignal: AbortSignal,\n): ReadableStream<Uint8Array> | null {\n\tconst body = response.body;\n\tconst type = response.headers.get('content-type') ?? '';\n\tif (body === null || !/text\\/event-stream|multipart\\/mixed/.test(type)) {\n\t\treturn body;\n\t}\n\tconst reader = body.getReader();\n\t// The signal lives as long as the process: the listener goes as soon as\n\t// the stream is over, however it ended, or each response would leave one.\n\tconst end = () => {\n\t\tsignal.removeEventListener('abort', end);\n\t\tvoid reader.cancel();\n\t\ttry {\n\t\t\tcontroller.close();\n\t\t} catch {\n\t\t\t// Closed already: the stream had ended.\n\t\t}\n\t};\n\tlet controller: ReadableStreamDefaultController<Uint8Array>;\n\treturn new ReadableStream<Uint8Array>({\n\t\tstart(started) {\n\t\t\tcontroller = started;\n\t\t\tif (signal.aborted) end();\n\t\t\telse signal.addEventListener('abort', end, { once: true });\n\t\t},\n\t\tasync pull(controller) {\n\t\t\tconst result = await reader.read().catch((error: unknown) => {\n\t\t\t\tsignal.removeEventListener('abort', end);\n\t\t\t\tthrow error;\n\t\t\t});\n\t\t\tif (result.done) {\n\t\t\t\tsignal.removeEventListener('abort', end);\n\t\t\t\ttry {\n\t\t\t\t\tcontroller.close();\n\t\t\t\t} catch {\n\t\t\t\t\t// Closed already: the shutdown ended it.\n\t\t\t\t}\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tcontroller.enqueue(result.value);\n\t\t},\n\t\tcancel: (reason) => {\n\t\t\tsignal.removeEventListener('abort', end);\n\t\t\treturn reader.cancel(reason);\n\t\t},\n\t});\n}\n",
8
+ "/**\n * Yoga reads the request body itself, and turns any failure of the read\n * into its own 400. A body past core's `bodyLimit` fails the read with a\n * `ContentTooLargeError`; `watchBody` keeps that error and hands Yoga its\n * own 413 error in its place, so Yoga logs nothing, and the handler can\n * throw core's again once Yoga has answered: the app's own boundary\n * answers the 413 in its error format, leaking nothing of Yoga's.\n */\nimport type { ContentTooLargeError } from '@alxia/core';\nimport { GraphQLError } from 'graphql';\n\n/**\n * By its name and its limit, not `instanceof`: the copy of core that\n * limited the body may not be the one this package resolves.\n */\nfunction isTooLarge(error: unknown): error is ContentTooLargeError {\n\treturn (\n\t\terror instanceof Error &&\n\t\terror.name === 'ContentTooLargeError' &&\n\t\ttypeof (error as { limit?: unknown }).limit === 'number'\n\t);\n}\n\nexport interface WatchedRequest {\n\t/** The request to hand to Yoga: the same, its body watched. */\n\treadonly request: Request;\n\t/** The `ContentTooLargeError` the body's read failed with, if it did. */\n\trefusal(): ContentTooLargeError | undefined;\n}\n\n/** `request` with its body's failure recorded; a request with no body is as it is. */\nexport function watchBody(request: Request): WatchedRequest {\n\tconst source = request.body;\n\tif (source === null || request.bodyUsed || source.locked) {\n\t\treturn { request, refusal: () => undefined };\n\t}\n\tlet refused: ContentTooLargeError | undefined;\n\tconst reader = source.getReader();\n\tconst body = new ReadableStream<Uint8Array>({\n\t\tasync pull(controller) {\n\t\t\ttry {\n\t\t\t\tconst { value, done } = await reader.read();\n\t\t\t\tif (done) controller.close();\n\t\t\t\telse controller.enqueue(value);\n\t\t\t} catch (error) {\n\t\t\t\tif (!isTooLarge(error)) throw error;\n\t\t\t\trefused = error;\n\t\t\t\t// Yoga's own refusal, which it neither masks nor logs, for\n\t\t\t\t// every content type: the handler answers core's 413 instead.\n\t\t\t\tthrow new GraphQLError('Request body too large', {\n\t\t\t\t\textensions: {\n\t\t\t\t\t\tcode: 'REQUEST_ENTITY_TOO_LARGE',\n\t\t\t\t\t\thttp: { status: 413 },\n\t\t\t\t\t},\n\t\t\t\t});\n\t\t\t}\n\t\t},\n\t\tcancel: (reason) => reader.cancel(reason),\n\t});\n\treturn {\n\t\trequest: new Request(request, { body, duplex: 'half' } as RequestInit),\n\t\trefusal: () => refused,\n\t};\n}\n\ninterface Failure {\n\terrors?: { extensions?: Record<string, unknown> }[];\n}\n\n/**\n * Yoga's 400 for a request it cannot read — a body that is not JSON, a\n * query string that is not valid — carries the parser's own error as\n * `extensions.originalError`. A client reads the message and the code, not\n * what a parser said: the response without it, any other as it is.\n */\nexport async function withoutOriginalError(\n\tresponse: Response,\n): Promise<Response> {\n\tconst type = response.headers.get('content-type') ?? '';\n\tif (\n\t\tresponse.status !== 400 ||\n\t\t!/^application\\/(?:[\\w.-]+\\+)?json/.test(type)\n\t) {\n\t\treturn response;\n\t}\n\tconst text = await response.text();\n\tlet failure: Failure;\n\ttry {\n\t\tfailure = JSON.parse(text) as Failure;\n\t} catch {\n\t\treturn new Response(text, response);\n\t}\n\tfor (const error of failure.errors ?? []) {\n\t\tdelete error.extensions?.['originalError'];\n\t}\n\tconst headers = new Headers(response.headers);\n\theaders.delete('content-length');\n\treturn new Response(JSON.stringify(failure), { status: 400, headers });\n}\n",
8
9
  "/**\n * [Apollo Sandbox](https://www.apollographql.com/docs/graphos/platform/sandbox),\n * embedded: the page a browser gets at the endpoint when the IDE is\n * `apollo-sandbox`. `@nxgt/shared-graphql`'s `renderSandbox`, kept twice: the\n * Sandbox asks the address the page was opened at, as there since\n * nxgt-core#171, but here the page resolves the path itself, so a TLS proxy\n * in front changes nothing.\n */\n\nexport interface SandboxOptions {\n\t/** The page's title. `Sandbox Explorer` by default. */\n\treadonly title?: string;\n\t/** The operation the Sandbox opens with. */\n\treadonly initialDocument?: string;\n\t/** Headers every operation sends, shown and editable in the Sandbox. */\n\treadonly initialHeaders?: Readonly<Record<string, string>>;\n\t/** Whether the Sandbox polls the schema as it changes. On by default. */\n\treadonly pollForSchemaUpdates?: boolean;\n\t/** Whether operations send the browser's cookies: a session cookie. On by default. */\n\treadonly includeCookies?: boolean;\n}\n\n/** What the page loads: the Sandbox's script, its frame, and operations to this server. */\nexport const SANDBOX_POLICY = [\n\t\"default-src 'self'\",\n\t\"script-src 'self' 'unsafe-inline' https://embeddable-sandbox.cdn.apollographql.com\",\n\t\"style-src 'self' 'unsafe-inline'\",\n\t'frame-src https://sandbox.embed.apollographql.com',\n\t\"img-src 'self' data: https:\",\n\t\"connect-src 'self'\",\n].join('; ');\n\n/**\n * The page, its endpoint `endpoint`: a URL, or a path the page resolves\n * against its own address. Every value is escaped into its JavaScript and\n * HTML.\n */\nexport function renderSandbox(\n\tendpoint: string,\n\toptions: SandboxOptions = {},\n): string {\n\tconst config = {\n\t\ttarget: '#sandbox',\n\t\tinitialEndpoint: endpoint,\n\t\tinitialState: {\n\t\t\tincludeCookies: options.includeCookies ?? true,\n\t\t\tpollForSchemaUpdates: options.pollForSchemaUpdates ?? true,\n\t\t\t...(options.initialDocument === undefined\n\t\t\t\t? {}\n\t\t\t\t: { document: options.initialDocument }),\n\t\t\t...(options.initialHeaders === undefined\n\t\t\t\t? {}\n\t\t\t\t: { headers: options.initialHeaders }),\n\t\t},\n\t\thideCookieToggle: false,\n\t\tendpointIsEditable: false,\n\t};\n\treturn `<!doctype html>\n<html lang=\"en\">\n<head>\n<meta charset=\"utf-8\" />\n<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />\n<title>${html(options.title ?? 'Sandbox Explorer')}</title>\n<style>html, body { margin: 0; height: 100%; } #sandbox { position: absolute; inset: 0; }</style>\n</head>\n<body>\n<div id=\"sandbox\"></div>\n<script src=\"https://embeddable-sandbox.cdn.apollographql.com/_latest/embeddable-sandbox.umd.production.min.js\"></script>\n<script>\n{\nconst config = ${script(config)};\nconfig.initialEndpoint = new URL(config.initialEndpoint, location.href).href;\nnew window.EmbeddedSandbox(config);\n}\n</script>\n</body>\n</html>`;\n}\n\nfunction html(text: string): string {\n\treturn text.replace(/[&<>\"']/g, (char) => `&#${char.charCodeAt(0)};`);\n}\n\n/** JSON that cannot close the `<script>` it is written in. */\nfunction script(value: unknown): string {\n\treturn JSON.stringify(value)\n\t\t.replace(/</g, '\\\\u003c')\n\t\t.replace(/>/g, '\\\\u003e')\n\t\t.replace(/\\u2028/g, '\\\\u2028')\n\t\t.replace(/\\u2029/g, '\\\\u2029');\n}\n",
9
10
  "/**\n * The plugin that tells the observers around the endpoint — `@alxia/logger`,\n * `@alxia/telemetry` — which operation each request executes.\n */\nimport { reportOperation } from '@alxia/core';\nimport { getOperationAST } from 'graphql';\nimport type { Plugin } from 'graphql-yoga';\n\ninterface Executed {\n\treadonly document: Parameters<typeof getOperationAST>[0];\n\treadonly operationName?: string | null | undefined;\n\treadonly contextValue: unknown;\n}\n\n/** Reports the operation of `args`: its type, and its name when it has one. */\nfunction report(args: Executed): void {\n\tconst operation = getOperationAST(args.document, args.operationName);\n\tif (operation === undefined || operation === null) return;\n\treportOperation(args.contextValue as object, {\n\t\ttype: operation.operation,\n\t\tname: operation.name?.value,\n\t});\n}\n\n/**\n * A Yoga plugin reporting each operation Yoga executes or subscribes to,\n * through core's `reportOperation`: a batched body reports each of its\n * operations, a request refused before it executes none.\n */\nexport function reportsOperations(): Plugin {\n\treturn {\n\t\tonExecute: ({ args }) => report(args),\n\t\tonSubscribe: ({ args }) => report(args),\n\t};\n}\n",
11
+ "/**\n * What `graphql()` bounds about parsing: the tokens a document may hold,\n * and the cache of what was parsed.\n */\nimport { type DocumentNode, Source, syntaxError } from 'graphql';\nimport type { Plugin, YogaServerOptions } from 'graphql-yoga';\nimport {\n\tboundedCache,\n\ttype Cache,\n\tdocumentWeight,\n\terrorWeight,\n} from './document-cache';\nimport type { YogaContext } from './handler';\nimport { nestingLimit, tooDeepAt } from './nesting';\n\n/** The most tokens a document may hold, unless `maxTokens` says otherwise. */\nexport const DEFAULT_MAX_TOKENS = 15_000;\n\n/** The sizes of the parse cache, of each endpoint. */\nexport interface ParseCacheOptions {\n\t/** The most estimated bytes of parsed documents kept. 64 MiB by default. */\n\treadonly maxBytes?: number;\n\t/** The most documents kept. 1 024 by default. */\n\treadonly max?: number;\n\t/** How long a document is kept, in milliseconds. One hour by default. */\n\treadonly ttl?: number;\n}\n\nconst DEFAULT_BYTES = 64 * 1024 * 1024;\n\nfunction positive(\n\tname: string,\n\tvalue: unknown,\n\twhat: string,\n\talternative = '',\n): number {\n\tif (typeof value === 'number' && Number.isSafeInteger(value) && value > 0) {\n\t\treturn value;\n\t}\n\tthrow new TypeError(\n\t\t`graphql(app, { ${name} }): ${what}, a positive whole number${alternative}; got ${String(value)}`,\n\t);\n}\n\n/** `maxTokens` checked where `graphql()` is declared. */\nexport function tokenLimit(\n\tmaxTokens: number | false | undefined,\n): number | false {\n\tif (maxTokens === undefined) return DEFAULT_MAX_TOKENS;\n\tif (maxTokens === false) return false;\n\treturn positive(\n\t\t'maxTokens',\n\t\tmaxTokens,\n\t\t'maxTokens is the most tokens a document may hold',\n\t\t', or false for none',\n\t);\n}\n\n/** A `RangeError` about the call stack is the stack overflowing, which parsing a nested document can cause. */\nconst overflowed = (error: unknown): boolean =>\n\terror instanceof RangeError && /call stack/i.test(error.message);\n\n/**\n * A Yoga plugin bounding what the parser is given: the tokens of every\n * document (`maxTokens`) and the levels it nests (`maxNesting`, a scan of the\n * source before any recursion). A document the parser still overflows the\n * stack on is refused the same way, never a 500. It wraps the parse function\n * Envelop already holds, never graphql's own `parse`: a second copy of\n * graphql would throw errors Yoga does not recognise, masked as a 500.\n */\nexport function limitsParsing(\n\tmaxTokens: number | false,\n\tmaxNesting: number | false,\n): Plugin {\n\treturn {\n\t\tonParse({ parseFn, setParseFn }) {\n\t\t\tsetParseFn((source, options) => {\n\t\t\t\tconst body = typeof source === 'string' ? source : source.body;\n\t\t\t\tconst refuse = (position: number, why: string) =>\n\t\t\t\t\tsyntaxError(\n\t\t\t\t\t\ttypeof source === 'string' ? new Source(source) : source,\n\t\t\t\t\t\tposition,\n\t\t\t\t\t\twhy,\n\t\t\t\t\t);\n\t\t\t\tif (maxNesting !== false) {\n\t\t\t\t\tconst at = tooDeepAt(body, maxNesting);\n\t\t\t\t\tif (at >= 0) {\n\t\t\t\t\t\tthrow refuse(\n\t\t\t\t\t\t\tat,\n\t\t\t\t\t\t\t`Document is nested more than ${maxNesting} levels deep. Parsing aborted.`,\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\ttry {\n\t\t\t\t\treturn parseFn(\n\t\t\t\t\t\tsource,\n\t\t\t\t\t\tmaxTokens === false ? options : { ...options, maxTokens },\n\t\t\t\t\t);\n\t\t\t\t} catch (error) {\n\t\t\t\t\tif (!overflowed(error)) throw error;\n\t\t\t\t\tthrow refuse(0, 'Document is nested too deeply to parse.');\n\t\t\t\t}\n\t\t\t});\n\t\t},\n\t};\n}\n\n/** What Yoga's `parserAndValidationCache` takes from alxia. */\nexport type ParseCaches =\n\t| false\n\t| {\n\t\t\tdocumentCache: Cache<DocumentNode>;\n\t\t\terrorCache: Cache<unknown>;\n\t };\n\n/** The sizes of a parse cache, checked. */\ninterface CacheSizes {\n\treadonly maxBytes: number;\n\treadonly max: number;\n\treadonly ttl: number;\n}\n\n/** `parseCache` checked where `graphql()` is declared; allocates nothing. */\nfunction cacheSizes(\n\tparseCache: false | ParseCacheOptions | undefined,\n): CacheSizes | false {\n\tif (parseCache === false) return false;\n\tif (\n\t\tparseCache !== undefined &&\n\t\t(typeof parseCache !== 'object' || parseCache === null)\n\t) {\n\t\tthrow new TypeError(\n\t\t\t`graphql(app, { parseCache }): parseCache is an object of cache sizes, or false for none; got ${String(parseCache)}`,\n\t\t);\n\t}\n\tconst given = parseCache ?? {};\n\treturn {\n\t\tmaxBytes: positive(\n\t\t\t'parseCache.maxBytes',\n\t\t\tgiven.maxBytes ?? DEFAULT_BYTES,\n\t\t\t'maxBytes is the most estimated bytes of documents kept',\n\t\t),\n\t\tmax: positive(\n\t\t\t'parseCache.max',\n\t\t\tgiven.max ?? 1024,\n\t\t\t'max is the most documents kept',\n\t\t),\n\t\tttl: positive(\n\t\t\t'parseCache.ttl',\n\t\t\tgiven.ttl ?? 3_600_000,\n\t\t\t'ttl is the milliseconds a document is kept',\n\t\t),\n\t};\n}\n\n/**\n * The limits `graphql()` was given, checked once at declaration: the token\n * cap and the nesting limit, resolved, and the parse cache, which cannot be given beside Yoga's\n * own. Each endpoint's Yoga builds its caches from the same options.\n */\nexport function resolveLimits(\n\tmaxTokens: number | false | undefined,\n\tmaxNesting: number | false | undefined,\n\tparseCache: false | ParseCacheOptions | undefined,\n\tyogaOptions: Pick<\n\t\tYogaServerOptions<YogaContext, YogaContext>,\n\t\t'parserAndValidationCache'\n\t>,\n): { readonly tokens: number | false; readonly depth: number | false } {\n\tconst tokens = tokenLimit(maxTokens);\n\tconst depth = nestingLimit(maxNesting);\n\tif (\n\t\tparseCache !== undefined &&\n\t\tyogaOptions.parserAndValidationCache !== undefined\n\t) {\n\t\tthrow new TypeError(\n\t\t\t\"graphql(app, { parseCache, parserAndValidationCache }): give one: parseCache sizes alxia's bounded cache, parserAndValidationCache replaces it\",\n\t\t);\n\t}\n\tcacheSizes(parseCache);\n\treturn { tokens, depth };\n}\n\n/**\n * The `parserAndValidationCache` of one Yoga: a pair of bounded caches,\n * created per call so each endpoint has its own. `false` gives none.\n */\nexport function parseCaches(\n\tparseCache: false | ParseCacheOptions | undefined,\n): ParseCaches {\n\tconst sizes = cacheSizes(parseCache);\n\tif (sizes === false) return false;\n\tconst { maxBytes, max, ttl } = sizes;\n\tconst documentCache = boundedCache<DocumentNode>({\n\t\tmax,\n\t\tttl,\n\t\tmaxBytes,\n\t\tweigh: (source, document) => documentWeight(source, document),\n\t});\n\tconst errorCache = boundedCache<unknown>({\n\t\tmax,\n\t\tttl,\n\t\tmaxBytes: Math.floor(maxBytes / 8),\n\t\tweigh: (source) => errorWeight(source),\n\t});\n\treturn { documentCache, errorCache };\n}\n",
12
+ "/**\n * The parse cache `graphql()` gives Yoga: a least-recently-used map bounded\n * by entries, by age and by estimated bytes, since a parsed document costs\n * by its tokens and no count of entries bounds that.\n */\nimport { type DocumentNode, type Token, TokenKind } from 'graphql';\n\n/** Yoga's `Cache` contract. */\nexport interface Cache<T> {\n\tget(key: string): T | undefined;\n\tset(key: string, value: T): void;\n}\n\nexport interface BoundedCacheOptions<T> {\n\t/** The most entries kept. */\n\treadonly max: number;\n\t/** How long an entry lives, in milliseconds. */\n\treadonly ttl: number;\n\t/** The most estimated bytes kept, the sum of the weights. */\n\treadonly maxBytes: number;\n\t/** The estimated bytes an entry holds. */\n\treadonly weigh: (key: string, value: T) => number;\n\t/** The clock, in milliseconds; injectable for the specs. */\n\treadonly now?: () => number;\n}\n\ninterface Entry<T> {\n\treadonly value: T;\n\treadonly weight: number;\n\treadonly expires: number;\n}\n\n/**\n * A least-recently-used cache that evicts by `max`, `ttl` and `maxBytes`.\n * An entry heavier than `maxBytes / 8` is not stored and evicts nothing.\n */\nexport function boundedCache<T>(options: BoundedCacheOptions<T>): Cache<T> {\n\tconst { max, ttl, maxBytes, weigh, now = Date.now } = options;\n\tconst entries = new Map<string, Entry<T>>();\n\tlet total = 0;\n\n\tconst drop = (key: string, entry: Entry<T>): void => {\n\t\tentries.delete(key);\n\t\ttotal -= entry.weight;\n\t};\n\n\treturn {\n\t\tget(key) {\n\t\t\tconst entry = entries.get(key);\n\t\t\tif (entry === undefined) return undefined;\n\t\t\tif (entry.expires <= now()) {\n\t\t\t\tdrop(key, entry);\n\t\t\t\treturn undefined;\n\t\t\t}\n\t\t\t// Map keeps insertion order: re-insert to mark it recent.\n\t\t\tentries.delete(key);\n\t\t\tentries.set(key, entry);\n\t\t\treturn entry.value;\n\t\t},\n\t\tset(key, value) {\n\t\t\tconst previous = entries.get(key);\n\t\t\tif (previous !== undefined) drop(key, previous);\n\t\t\tconst weight = weigh(key, value);\n\t\t\tif (weight > maxBytes / 8) return;\n\t\t\tentries.set(key, { value, weight, expires: now() + ttl });\n\t\t\ttotal += weight;\n\t\t\tfor (const [oldest, entry] of entries) {\n\t\t\t\tif (entries.size <= max && total <= maxBytes) break;\n\t\t\t\tdrop(oldest, entry);\n\t\t\t}\n\t\t},\n\t};\n}\n\n/** The measured upper bound of a parsed token's heap cost, in bytes. */\nconst BYTES_PER_TOKEN = 512;\n\n/** The bytes counted per source character: the source key, plus a token's value. */\nconst BYTES_PER_CHAR = 4;\n\n/**\n * The bytes counted per source character of a string literal with escapes.\n * graphql 16 builds its value with `+=`, once per escape, which in\n * JavaScriptCore leaves a rope the token and its node keep alive. Measured\n * without the flatten: 31.6 B per source char for `\\n`, 28 for `Ā\\n`, 13.7\n * for `Ā`; 32 covers them.\n */\nconst BYTES_PER_ESCAPED_CHAR = 32;\n\n/** The bytes counted per source character of a document without `loc`: 4 + 32. */\nconst BYTES_PER_CHAR_NO_LOC = BYTES_PER_CHAR + BYTES_PER_ESCAPED_CHAR;\n\n/**\n * The last character read to flatten a string. The JIT removes a read whose\n * result nobody uses, and the flatten with it, so the result is stored.\n */\nlet flattened = 0;\n\n/**\n * The tokens the lexer linked for a document, comments included (graphql's\n * `tokenCount` and `maxTokens` skip comments, yet `loc.startToken` keeps the\n * whole chain alive), and the extra bytes of its escaped string literals.\n * Undefined when the document has no `loc`.\n */\nfunction chainWalk(\n\tdocument: DocumentNode,\n): { tokens: number; extra: number } | undefined {\n\tconst first = document.loc?.startToken;\n\tif (first === undefined) return undefined;\n\tlet tokens = 0;\n\tlet extra = 0;\n\tfor (let token: Token | null = first; token !== null; token = token.next) {\n\t\ttokens++;\n\t\t// A string with escapes has a value shorter than its source span (minus\n\t\t// the two quotes). Its rope is charged by the span, and flattened as an\n\t\t// optimisation: reading a character flattens it in place (the token and\n\t\t// the node share it). A raw literal or a block string is already flat or\n\t\t// a substring of the key, and flattening would copy it out. Keep\n\t\t// `flattened` used: see above.\n\t\tif (\n\t\t\ttoken.kind === TokenKind.STRING &&\n\t\t\ttoken.value.length < token.end - token.start - 2\n\t\t) {\n\t\t\textra += BYTES_PER_ESCAPED_CHAR * (token.end - token.start);\n\t\t\tif (token.value.length > 0) flattened = token.value.charCodeAt(0);\n\t\t}\n\t}\n\t// Read here so the writes above are not dead code.\n\treturn { tokens, extra: extra + (flattened & 0) };\n}\n\n/**\n * A parsed document's estimated bytes: every token the lexer linked,\n * comments included, plus the source as the key and as token values, plus\n * 32 B per char of escaped string literals. Without `loc` (`noLocation`),\n * nothing tells where the strings are: `tokenCount` and 36 B per char stand\n * in; without `tokenCount` (older graphql), the source's length does.\n */\nexport function documentWeight(source: string, document: DocumentNode): number {\n\tconst walk = chainWalk(document);\n\tif (walk !== undefined) {\n\t\treturn (\n\t\t\tBYTES_PER_TOKEN * walk.tokens +\n\t\t\tBYTES_PER_CHAR * source.length +\n\t\t\twalk.extra\n\t\t);\n\t}\n\tconst tokenCount = (document as { tokenCount?: number }).tokenCount;\n\tif (typeof tokenCount !== 'number') {\n\t\treturn Math.max(256, BYTES_PER_CHAR_NO_LOC) * source.length;\n\t}\n\treturn BYTES_PER_TOKEN * tokenCount + BYTES_PER_CHAR_NO_LOC * source.length;\n}\n\n/** A parse error's estimated bytes: its source as the key, and the error (1 024 B). */\nexport function errorWeight(source: string): number {\n\treturn BYTES_PER_CHAR * source.length + 1024;\n}\n",
13
+ "/**\n * How deep a document may nest. graphql-js parses by recursion, one set of\n * frames per `{`, `(` or `[`, so a document a few thousand levels deep\n * overflows the stack (a `RangeError`) long before `maxTokens` stops it,\n * and Yoga answers that with a 500. A linear scan of the source counts the\n * nesting first, without recursing.\n */\n\n/** The most levels of `{`, `(` and `[` a document may nest, unless `maxNesting` says otherwise. */\nexport const DEFAULT_MAX_NESTING = 1000;\n\n/** `maxNesting` checked where `graphql()` is declared. */\nexport function nestingLimit(\n\tmaxNesting: number | false | undefined,\n): number | false {\n\tif (maxNesting === undefined) return DEFAULT_MAX_NESTING;\n\tif (maxNesting === false) return false;\n\tif (typeof maxNesting === 'number' && Number.isSafeInteger(maxNesting)) {\n\t\tif (maxNesting > 0) return maxNesting;\n\t}\n\tthrow new TypeError(\n\t\t`graphql(app, { maxNesting }): maxNesting is the most levels of { ( [ a document may nest, a positive whole number, or false for none; got ${String(maxNesting)}`,\n\t);\n}\n\nconst QUOTE = 34; // \"\nconst BACKSLASH = 92;\nconst HASH = 35; // #\nconst LF = 10;\nconst CR = 13;\n\n/**\n * The offset of the first bracket that nests `body` deeper than `max`\n * levels, or -1. Brackets inside strings, block strings and comments are\n * text, not nesting; an unbalanced closing bracket is left to the parser.\n */\nexport function tooDeepAt(body: string, max: number): number {\n\tlet depth = 0;\n\tconst end = body.length;\n\tfor (let i = 0; i < end; i++) {\n\t\tconst code = body.charCodeAt(i);\n\t\tif (code === 123 || code === 40 || code === 91) {\n\t\t\t// { ( [\n\t\t\tif (++depth > max) return i;\n\t\t} else if (code === 125 || code === 41 || code === 93) {\n\t\t\t// } ) ]\n\t\t\tif (depth > 0) depth--;\n\t\t} else if (code === HASH) {\n\t\t\twhile (i + 1 < end) {\n\t\t\t\tconst next = body.charCodeAt(i + 1);\n\t\t\t\tif (next === LF || next === CR) break;\n\t\t\t\ti++;\n\t\t\t}\n\t\t} else if (code === QUOTE) {\n\t\t\tif (body.startsWith('\"\"\"', i)) {\n\t\t\t\ti += 3;\n\t\t\t\twhile (i < end) {\n\t\t\t\t\tif (body.startsWith('\\\\\"\"\"', i)) i += 4;\n\t\t\t\t\telse if (body.startsWith('\"\"\"', i)) break;\n\t\t\t\t\telse i++;\n\t\t\t\t}\n\t\t\t\ti += 2;\n\t\t\t} else {\n\t\t\t\ti++;\n\t\t\t\twhile (i < end) {\n\t\t\t\t\tconst inString = body.charCodeAt(i);\n\t\t\t\t\tif (inString === BACKSLASH) i += 2;\n\t\t\t\t\telse if (inString === QUOTE || inString === LF || inString === CR) {\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t} else i++;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\treturn -1;\n}\n",
10
14
  "/**\n * Each operation of a socket, from its `subscribe` to its end, told to the\n * observers around the socket's upgrade — `@alxia/logger`,\n * `@alxia/telemetry` — through core's `startOperation`: its type and name,\n * then whether it ended with errors.\n */\nimport { type OperationOutcome, startOperation } from '@alxia/core';\nimport { type DocumentNode, getOperationAST } from 'graphql';\nimport type { ServerOptions } from 'graphql-ws';\n\n/** An operation started, until it ends. */\ninterface Open {\n\treadonly end: (outcome: OperationOutcome) => void;\n\toutcome: OperationOutcome;\n}\n\n/** The operations of one socket, by their `graphql-ws` id. */\nexport class SocketOperations {\n\treadonly #ctx: object;\n\treadonly #open = new Map<string, Open>();\n\n\t/** `ctx`: the socket's context, which carries its upgrade's observers. */\n\tconstructor(ctx: object) {\n\t\tthis.#ctx = ctx;\n\t}\n\n\t/** The operation `id` starts: the one of `document` that `operationName` names. */\n\tbegin(\n\t\tid: string,\n\t\tdocument: DocumentNode,\n\t\toperationName: string | null | undefined,\n\t): void {\n\t\t// graphql-ws closes a socket that reuses an open id; end it all the same.\n\t\tthis.end(id);\n\t\tconst operation = getOperationAST(document, operationName);\n\t\tif (operation === undefined || operation === null) return;\n\t\tconst end = startOperation(this.#ctx, {\n\t\t\ttype: operation.operation,\n\t\t\tname: operation.name?.value,\n\t\t});\n\t\tthis.#open.set(id, { end, outcome: 'ok' });\n\t}\n\n\t/** The operation `id` answered with errors: a result's `errors`, or an error message. */\n\tfailed(id: string): void {\n\t\tconst open = this.#open.get(id);\n\t\tif (open !== undefined) open.outcome = 'errors';\n\t}\n\n\t/** The operation `id` ended: completed, stopped by its client, or failed. */\n\tend(id: string): void {\n\t\tconst open = this.#open.get(id);\n\t\tif (open === undefined) return;\n\t\tthis.#open.delete(id);\n\t\topen.end(open.outcome);\n\t}\n\n\t/**\n\t * The socket closed: an operation still open then is one whose run threw,\n\t * which `graphql-ws` answers by closing the socket, and ends with errors.\n\t */\n\tclosed(): void {\n\t\tfor (const id of [...this.#open.keys()]) {\n\t\t\tthis.failed(id);\n\t\t\tthis.end(id);\n\t\t}\n\t}\n}\n\n/** What `graphql-ws` keeps of each socket for its hooks: its operations. */\ninterface Followed {\n\treadonly operations: SocketOperations;\n}\n\n/**\n * `graphql-ws`'s hooks that follow each operation: a result with errors\n * marks it, an error message ends it, and so does its completion — sent,\n * stopped by the client, or cut by the socket's close.\n */\nexport function following<E extends Followed>(): Pick<\n\tServerOptions<Record<string, unknown> | undefined, E>,\n\t'onNext' | 'onError' | 'onComplete'\n> {\n\treturn {\n\t\tonNext({ extra }, id, _payload, _args, result) {\n\t\t\tif (result.errors !== undefined && result.errors.length > 0) {\n\t\t\t\textra.operations.failed(id);\n\t\t\t}\n\t\t},\n\t\tonError({ extra }, id) {\n\t\t\textra.operations.failed(id);\n\t\t\textra.operations.end(id);\n\t\t},\n\t\tonComplete({ extra }, id) {\n\t\t\textra.operations.end(id);\n\t\t},\n\t};\n}\n",
11
15
  "/**\n * `graphql-ws`'s server options for a socket route: each operation parsed,\n * validated, executed and subscribed through the endpoint's Yoga, and\n * followed to its end for the observers around the upgrade.\n */\nimport type { BaseContext } from '@alxia/core';\nimport type { ServerOptions, SubscribePayload } from 'graphql-ws';\nimport type { YogaInitialContext, YogaServerInstance } from 'graphql-yoga';\nimport { serverContext, type YogaContext } from './handler';\nimport { following, type SocketOperations } from './ws-operations';\n\n/**\n * What `graphql-ws` keeps of each socket: the context its upgrade built,\n * the request each of its operations reads as Yoga's `request`, and its\n * operations, told to the upgrade's observers.\n */\nexport interface Extra {\n\treadonly ctx: Record<string, unknown> & BaseContext;\n\treadonly request: Request;\n\treadonly operations: SocketOperations;\n}\n\n/** The rest of each operation, run by the functions Yoga's envelop gave it. */\ninterface Enveloped {\n\treadonly execute: (args: never) => unknown;\n\treadonly subscribe: (args: never) => unknown;\n}\n\n/** Where the socket route is, and the endpoint whose Yoga it runs. */\nexport interface Paths {\n\treadonly endpoint: string;\n\treadonly socket: string;\n}\n\n/**\n * The Yoga of the endpoint a socket route serves: the HTTP one, so its\n * plugins are set up once. The socket's route is its full path, the\n * prefix of each app it is mounted into included, then its own `path`.\n */\nfunction endpointOf(route: string, paths: Paths): string {\n\t// A path of `/` adds nothing to a prefix: `/api` + `/` is `/api`.\n\tconst own = paths.socket === '/' ? '' : paths.socket;\n\tconst at = paths.endpoint === '/' ? '' : paths.endpoint;\n\treturn route.slice(0, route.length - own.length) + at || '/';\n}\n\n/**\n * `graphql-ws`'s options: each operation parsed, validated, executed and\n * subscribed through Yoga's envelop, with the context the upgrade built,\n * the operation's `params` and the client's `connectionParams`.\n */\nexport function serverOptions<UserCtx extends YogaContext>(\n\tyogaAt: (endpoint: string) => YogaServerInstance<YogaContext, UserCtx>,\n\tpaths: Paths,\n): ServerOptions<Record<string, unknown> | undefined, Extra> {\n\t// Each operation's envelop, found by its context: one object per\n\t// operation, which the root resolvers' `parent` is not.\n\tconst enveloped = new WeakMap<object, Enveloped>();\n\tconst of = (args: { contextValue?: unknown }) =>\n\t\tenveloped.get(args.contextValue as object) as Enveloped;\n\treturn {\n\t\texecute: (args) => of(args).execute(args as never) as never,\n\t\tsubscribe: (args) => of(args).subscribe(args as never) as never,\n\t\t...following<Extra>(),\n\t\tasync onSubscribe(context, id, params: SubscribePayload) {\n\t\t\tconst { ctx, request } = context.extra;\n\t\t\tconst initial = {\n\t\t\t\t...serverContext(ctx),\n\t\t\t\trequest,\n\t\t\t\tparams,\n\t\t\t\tconnectionParams: context.connectionParams,\n\t\t\t} as unknown as YogaInitialContext & YogaContext;\n\t\t\tconst { schema, execute, subscribe, contextFactory, parse, validate } =\n\t\t\t\tyogaAt(endpointOf(ctx.route as string, paths)).getEnveloped(initial);\n\t\t\tlet document: ReturnType<typeof parse>;\n\t\t\ttry {\n\t\t\t\tdocument = parse(params.query);\n\t\t\t} catch (error) {\n\t\t\t\treturn [error as never];\n\t\t\t}\n\t\t\tcontext.extra.operations.begin(id, document, params.operationName);\n\t\t\tconst errors = validate(schema, document);\n\t\t\tif (errors.length > 0) return errors;\n\t\t\tconst contextValue = await contextFactory();\n\t\t\tenveloped.set(contextValue, { execute, subscribe });\n\t\t\treturn {\n\t\t\t\tschema,\n\t\t\t\tdocument,\n\t\t\t\toperationName: params.operationName,\n\t\t\t\tvariableValues: params.variables,\n\t\t\t\tcontextValue,\n\t\t\t};\n\t\t},\n\t};\n}\n",
12
16
  "/**\n * GraphQL over WebSocket, the `graphql-transport-ws` protocol of\n * `graphql-ws`, on a socket route of the app: the upgrade runs the app's\n * middlewares, each operation runs through Yoga's envelop — its plugins,\n * its `context` — and is told to the observers around the upgrade\n * (`ws-operations.ts`, through `ws-server.ts`'s options), and the app's shutdown closes the sockets with 1001.\n */\nimport type { BaseContext, NextFunction, RoutePath, Socket } from '@alxia/core';\nimport type { Server } from 'graphql-ws';\nimport type { YogaServerInstance } from 'graphql-yoga';\nimport type { YogaContext } from './handler';\nimport { SocketOperations } from './ws-operations';\nimport { type Extra, type Paths, serverOptions } from './ws-server';\n\n/** `graphql(app, { ws })`: GraphQL over WebSocket beside the HTTP endpoint. */\nexport interface GraphQLWsOptions {\n\t/**\n\t * Where a client opens its socket, under the app's prefix. The\n\t * endpoint's own path by default: one URL, `http(s)://` for queries and\n\t * server-sent events, `ws(s)://` for the socket.\n\t */\n\treadonly path?: RoutePath;\n\t/**\n\t * Milliseconds between the WebSocket pings the server sends each open\n\t * socket, so a proxy does not close an idle subscription. `12_000` by\n\t * default, as `graphql-ws`'s own server for Node; `false` for none.\n\t */\n\treadonly keepAlive?: number | false;\n}\n\ntype Module = typeof import('graphql-ws');\n\n/** What the missing optional peer is answered with: the package to add. */\nexport const MISSING_PEER =\n\t'@alxia/graphql: graphql(app, { ws }) serves GraphQL over WebSocket with the optional peer graphql-ws, which is not installed: bun add graphql-ws';\n\n/** `graphql-ws`, imported once; a missing peer rejects with `MISSING_PEER`. */\nfunction loader(): () => Promise<Module> {\n\tlet loading: Promise<Module> | undefined;\n\treturn () => {\n\t\tloading ??= import('graphql-ws').catch((cause: unknown) => {\n\t\t\tthrow new Error(MISSING_PEER, { cause });\n\t\t});\n\t\treturn loading;\n\t};\n}\n\n/** The subprotocol the upgrade request offers that `graphql-ws` serves, or `''`. */\nfunction chosen(module: Module, request: Request): string {\n\tconst offered = request.headers.get('sec-websocket-protocol') ?? '';\n\treturn module.handleProtocols(offered) || '';\n}\n\n/**\n * The request an operation over the socket reads: the upgrade's URL and\n * headers, as a `POST`, which it is to Yoga — a `GET` may not run a\n * mutation, and the upgrade is one — its signal aborted when the socket\n * closes.\n */\nfunction operationRequest(upgrade: Request, signal: AbortSignal): Request {\n\treturn new Request(upgrade.url, {\n\t\tmethod: 'POST',\n\t\theaders: upgrade.headers,\n\t\tsignal,\n\t});\n}\n\n/** `keepAlive` checked where `graphql()` is declared: a positive number of milliseconds, or `false`. */\nfunction pingEvery(keepAlive: number | false | undefined): number | false {\n\tif (keepAlive === undefined) return 12_000;\n\tif (keepAlive === false) return false;\n\tif (Number.isFinite(keepAlive) && keepAlive > 0) return keepAlive;\n\tthrow new TypeError(\n\t\t`graphql(app, { ws: { keepAlive: ${keepAlive} } }): keepAlive is the milliseconds between pings, a positive number, or false for none`,\n\t);\n}\n\n/** What one socket holds: the message handler `graphql-ws` registered, its end, its pings. */\ninterface Client {\n\tonMessage?: (data: string) => Promise<void>;\n\tclosed?: (code?: number, reason?: string) => Promise<void>;\n\tpings?: ReturnType<typeof setInterval>;\n\treadonly gone: AbortController;\n\treadonly operations: SocketOperations;\n}\n\n/**\n * The socket route's middleware and handlers: the upgrade loads\n * `graphql-ws` and names the subprotocol it serves in the `101`; each\n * open socket is a `graphql-ws` client, ended when it closes.\n */\nexport function graphqlSocket<UserCtx extends YogaContext>(\n\tyogaAt: (endpoint: string) => YogaServerInstance<YogaContext, UserCtx>,\n\tendpoint: string,\n\toptions: GraphQLWsOptions,\n) {\n\tconst paths: Paths = { endpoint, socket: options.path ?? endpoint };\n\tconst keepAlive = pingEvery(options.keepAlive);\n\tconst load = loader();\n\tlet module: Module | undefined;\n\tlet server: Server<Extra> | undefined;\n\tconst clients = new WeakMap<object, Client>();\n\n\t// Named `graphqlWs`, the name the route table shows.\n\tasync function graphqlWs(ctx: BaseContext, next: NextFunction) {\n\t\tmodule ??= await load();\n\t\tserver ??= module.makeServer(serverOptions(yogaAt, paths));\n\t\tconst protocol = chosen(module, ctx.request);\n\t\tif (protocol !== '')\n\t\t\tctx.set.headers.set('sec-websocket-protocol', protocol);\n\t\treturn next();\n\t}\n\n\ttype GraphQLSocket = Socket<Record<string, unknown> & BaseContext, unknown>;\n\tconst handlers = {\n\t\topen(socket: GraphQLSocket) {\n\t\t\tconst raw = socket.raw;\n\t\t\tconst client: Client = {\n\t\t\t\tgone: new AbortController(),\n\t\t\t\toperations: new SocketOperations(socket.data),\n\t\t\t};\n\t\t\tclients.set(raw, client);\n\t\t\t// The upgrade loaded both: a socket opens behind its middleware alone.\n\t\t\tconst graphqlWsServer = server as NonNullable<typeof server>;\n\t\t\tclient.closed = graphqlWsServer.opened(\n\t\t\t\t{\n\t\t\t\t\t// Anything else is closed by graphql-ws: 4406, Subprotocol not acceptable.\n\t\t\t\t\tprotocol: chosen(module as Module, socket.data.request),\n\t\t\t\t\tsend: (data: string) => {\n\t\t\t\t\t\tif (raw.readyState === 1) raw.sendText(data);\n\t\t\t\t\t},\n\t\t\t\t\tclose: (code?: number, reason?: string) => raw.close(code, reason),\n\t\t\t\t\tonMessage: (handle: (data: string) => Promise<void>) => {\n\t\t\t\t\t\tclient.onMessage = handle;\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tctx: socket.data,\n\t\t\t\t\trequest: operationRequest(socket.data.request, client.gone.signal),\n\t\t\t\t\toperations: client.operations,\n\t\t\t\t},\n\t\t\t);\n\t\t\tif (keepAlive !== false) {\n\t\t\t\tclient.pings = setInterval(() => raw.ping(), keepAlive);\n\t\t\t}\n\t\t},\n\t\tasync message(socket: GraphQLSocket, message: unknown) {\n\t\t\tconst data =\n\t\t\t\ttypeof message === 'string'\n\t\t\t\t\t? message\n\t\t\t\t\t: new TextDecoder().decode(message as Uint8Array);\n\t\t\tawait clients.get(socket.raw)?.onMessage?.(data);\n\t\t},\n\t\tasync close(socket: GraphQLSocket, code: number, reason: string) {\n\t\t\tconst client = clients.get(socket.raw);\n\t\t\tif (client === undefined) return;\n\t\t\tclearInterval(client.pings);\n\t\t\tclients.delete(socket.raw);\n\t\t\tclient.gone.abort();\n\t\t\tawait client.closed?.(code, reason);\n\t\t\tclient.operations.closed();\n\t\t},\n\t};\n\treturn { path: paths.socket, middleware: graphqlWs, handlers };\n}\n"
13
17
  ],
14
- "mappings": "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",
15
- "debugId": "DFFFDD9B5123148464756E2164756E21",
18
+ "mappings": ";AAAA;AAAA;AAAA;;;ACIA,IAAM,qBAAqB;AAGpB,SAAS,eAAe,CAC9B,KACA,MACA,SACA,WACA,QACO;AAAA,EACP,MAAM,QAAQ;AAAA,EAKd,MAAM,IAAI,MAAM,OAAO;AAAA,EAGvB,MAAM,YAAY,IAAI,OAAO,GAAG,EAAE,GAAG;AAAA,EACrC,MAAM,KACL,MACA,EAAE,WAAW,aAAa,aAAa,mBAAmB,GAC1D,OACD;AAAA,EACA,IAAI,WAAW,WAAW;AAAA,IACzB,MAAM,GAAG,OAAO,MAAM,OAAO,YAAY,OAAO,QAAQ;AAAA,EACzD;AAAA;;;AC1BD;AAAA;AAAA;AAAA;AAMA;AAAA;AAAA;;;ACDA;AAMA,SAAS,UAAU,CAAC,OAA+C;AAAA,EAClE,OACC,iBAAiB,SACjB,MAAM,SAAS,0BACf,OAAQ,MAA8B,UAAU;AAAA;AAY3C,SAAS,SAAS,CAAC,SAAkC;AAAA,EAC3D,MAAM,SAAS,QAAQ;AAAA,EACvB,IAAI,WAAW,QAAQ,QAAQ,YAAY,OAAO,QAAQ;AAAA,IACzD,OAAO,EAAE,SAAS,SAAS,MAAG;AAAA,MAAG;AAAA,MAAU;AAAA,EAC5C;AAAA,EACA,IAAI;AAAA,EACJ,MAAM,SAAS,OAAO,UAAU;AAAA,EAChC,MAAM,OAAO,IAAI,eAA2B;AAAA,SACrC,KAAI,CAAC,YAAY;AAAA,MACtB,IAAI;AAAA,QACH,QAAQ,OAAO,SAAS,MAAM,OAAO,KAAK;AAAA,QAC1C,IAAI;AAAA,UAAM,WAAW,MAAM;AAAA,QACtB;AAAA,qBAAW,QAAQ,KAAK;AAAA,QAC5B,OAAO,OAAO;AAAA,QACf,IAAI,CAAC,WAAW,KAAK;AAAA,UAAG,MAAM;AAAA,QAC9B,UAAU;AAAA,QAGV,MAAM,IAAI,aAAa,0BAA0B;AAAA,UAChD,YAAY;AAAA,YACX,MAAM;AAAA,YACN,MAAM,EAAE,QAAQ,IAAI;AAAA,UACrB;AAAA,QACD,CAAC;AAAA;AAAA;AAAA,IAGH,QAAQ,CAAC,WAAW,OAAO,OAAO,MAAM;AAAA,EACzC,CAAC;AAAA,EACD,OAAO;AAAA,IACN,SAAS,IAAI,QAAQ,SAAS,EAAE,MAAM,QAAQ,OAAO,CAAgB;AAAA,IACrE,SAAS,MAAM;AAAA,EAChB;AAAA;AAaD,eAAsB,oBAAoB,CACzC,UACoB;AAAA,EACpB,MAAM,OAAO,SAAS,QAAQ,IAAI,cAAc,KAAK;AAAA,EACrD,IACC,SAAS,WAAW,OACpB,CAAC,mCAAmC,KAAK,IAAI,GAC5C;AAAA,IACD,OAAO;AAAA,EACR;AAAA,EACA,MAAM,OAAO,MAAM,SAAS,KAAK;AAAA,EACjC,IAAI;AAAA,EACJ,IAAI;AAAA,IACH,UAAU,KAAK,MAAM,IAAI;AAAA,IACxB,MAAM;AAAA,IACP,OAAO,IAAI,SAAS,MAAM,QAAQ;AAAA;AAAA,EAEnC,WAAW,SAAS,QAAQ,UAAU,CAAC,GAAG;AAAA,IACzC,OAAO,MAAM,aAAa;AAAA,EAC3B;AAAA,EACA,MAAM,UAAU,IAAI,QAAQ,SAAS,OAAO;AAAA,EAC5C,QAAQ,OAAO,gBAAgB;AAAA,EAC/B,OAAO,IAAI,SAAS,KAAK,UAAU,OAAO,GAAG,EAAE,QAAQ,KAAK,QAAQ,CAAC;AAAA;;;AC1E/D,IAAM,iBAAiB;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACD,EAAE,KAAK,IAAI;AAOJ,SAAS,aAAa,CAC5B,UACA,UAA0B,CAAC,GAClB;AAAA,EACT,MAAM,SAAS;AAAA,IACd,QAAQ;AAAA,IACR,iBAAiB;AAAA,IACjB,cAAc;AAAA,MACb,gBAAgB,QAAQ,kBAAkB;AAAA,MAC1C,sBAAsB,QAAQ,wBAAwB;AAAA,SAClD,QAAQ,oBAAoB,YAC7B,CAAC,IACD,EAAE,UAAU,QAAQ,gBAAgB;AAAA,SACnC,QAAQ,mBAAmB,YAC5B,CAAC,IACD,EAAE,SAAS,QAAQ,eAAe;AAAA,IACtC;AAAA,IACA,kBAAkB;AAAA,IAClB,oBAAoB;AAAA,EACrB;AAAA,EACA,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA,SAKC,KAAK,QAAQ,SAAS,kBAAkB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,iBAQhC,OAAO,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAS9B,SAAS,IAAI,CAAC,MAAsB;AAAA,EACnC,OAAO,KAAK,QAAQ,YAAY,CAAC,SAAS,KAAK,KAAK,WAAW,CAAC,IAAI;AAAA;AAIrE,SAAS,MAAM,CAAC,OAAwB;AAAA,EACvC,OAAO,KAAK,UAAU,KAAK,EACzB,QAAQ,MAAM,SAAS,EACvB,QAAQ,MAAM,SAAS,EACvB,QAAQ,WAAW,SAAS,EAC5B,QAAQ,WAAW,SAAS;AAAA;;;AFpE/B,IAAM,iBACL;AAUM,SAAS,cAAc,CAAC,MAAsB;AAAA,EACpD,MAAM,QAAQ,KAAK,MAAM,cAAc,IAAI,MAAM;AAAA,EACjD,MAAM,OAAO,UAAU,KAAK,KAAK,IAAI;AAAA,EACrC,OAAO;AAAA,IACN;AAAA,IACA,oCAAoC;AAAA,IACpC,mCAAmC;AAAA,IACnC;AAAA,IACA,wBAAwB;AAAA,IACxB;AAAA,IACA,qBAAqB;AAAA,IACrB;AAAA,EACD,EAAE,KAAK,IAAI;AAAA;AAQL,SAAS,WAAwC,CACvD,SACA,QAIiE;AAAA,EACjE,MAAM,UAAU,IAAI;AAAA,EACpB,OAAO,CAAC,aAAa;AAAA,IACpB,IAAI,OAAO,QAAQ,IAAI,QAAQ;AAAA,IAC/B,IAAI,SAAS,WAAW;AAAA,MACvB,OAAO,WAAiC;AAAA,WACpC;AAAA,WACC,WAAW,YAAY,CAAC,IAAI,EAAE,0BAA0B,OAAO,EAAE;AAAA,QACrE,iBAAiB;AAAA,MAClB,CAAC;AAAA,MACD,QAAQ,IAAI,UAAU,IAAI;AAAA,IAC3B;AAAA,IACA,OAAO;AAAA;AAAA;AAQF,SAAS,aAAa,CAC5B,KAC0B;AAAA,EAC1B;AAAA,IACC,QAAQ;AAAA,IACR,OAAO;AAAA,IACP,SAAS;AAAA,IACT,SAAS;AAAA,IACT,MAAM;AAAA,IACN,OAAO;AAAA,IACP,UAAU;AAAA,OACP;AAAA,MACA;AAAA,EACJ,OAAO;AAAA;AAIR,IAAM,sBAAsB,IAAI,IAAI;AAAA,EACnC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACD,CAAC;AAQM,SAAS,cAA2C,CAC1D,QACA,SACC;AAAA,EAGD,OAAO,eAAe,OAAO,CAC5B,KACC;AAAA,IACD,QAAQ,UAAU;AAAA,IAClB,MAAM,SAAS,cAAc,GAAG;AAAA,IAChC,IACC,YAAY,SACZ,IAAI,QAAQ,WAAW,SACvB,IAAI,QAAQ,QAAQ,IAAI,QAAQ,GAAG,SAAS,WAAW,KACvD,CAAC,IAAI,IAAI,aAAa,IAAI,OAAO,GAChC;AAAA,MAGD,OAAO,MAAM,KAAK,cAAc,IAAI,OAAO,OAAO,GAAG;AAAA,QACpD,SAAS;AAAA,UACR,gBAAgB;AAAA,UAChB,2BAA2B;AAAA,QAC5B;AAAA,MACD,CAAC;AAAA,IACF;AAAA,IACA,MAAM,UAAU,UAAU,IAAI,OAAO;AAAA,IACrC,MAAM,WAAW,MAAM,OAAO,IAAI,KAAK,EAAE,MAAM,QAAQ,SAAS,MAAM;AAAA,IAGtE,MAAM,UAAU,QAAQ,QAAQ;AAAA,IAChC,IAAI,YAAY,WAAW;AAAA,MACrB,SAAS,MAAM,OAAO;AAAA,MAG3B,YAAY,MAAM,UAAU,SAAS,SAAS;AAAA,QAC7C,IAAI,oBAAoB,IAAI,IAAI;AAAA,UAAG;AAAA,QACnC,IAAI,SAAS;AAAA,UAAc,IAAI,IAAI,QAAQ,OAAO,MAAM,KAAK;AAAA,QACxD,SAAI,SAAS,QAAQ;AAAA,UAEzB,WAAW,QAAQ,MAAM,MAAM,GAAG;AAAA,YAAG,KAAK,IAAI,IAAI,SAAS,IAAI;AAAA,QAChE,EAAO;AAAA,cAAI,IAAI,QAAQ,IAAI,MAAM,KAAK;AAAA,MACvC;AAAA,MACA,MAAM;AAAA,IACP;AAAA,IACA,MAAM,WAAW,MAAM,qBAAqB,QAAQ;AAAA,IACpD,MAAM,UAAU,IAAI,QAAQ,SAAS,OAAO;AAAA,IAC5C,IACC,QAAQ,IAAI,cAAc,GAAG,WAAW,WAAW,KACnD,CAAC,QAAQ,IAAI,yBAAyB,GACrC;AAAA,MAED,MAAM,OAAO,MAAM,SAAS,KAAK;AAAA,MACjC,QAAQ,IAAI,2BAA2B,eAAe,IAAI,CAAC;AAAA,MAC3D,OAAO,MAAM,SAAS,QAAsB,MAAM,EAAE,QAAQ,CAAC;AAAA,IAC9D;AAAA,IACA,MAAM,OAAO,gBAAgB,UAAU,eAAe,GAAG,CAAC;AAAA,IAC1D,OAAO,MAAM,SAAS,QAAsB,QAAQ,WAAW;AAAA,MAC9D;AAAA,IACD,CAAC;AAAA;AAAA;AAWH,SAAS,eAAe,CACvB,UACA,QACoC;AAAA,EACpC,MAAM,OAAO,SAAS;AAAA,EACtB,MAAM,OAAO,SAAS,QAAQ,IAAI,cAAc,KAAK;AAAA,EACrD,IAAI,SAAS,QAAQ,CAAC,sCAAsC,KAAK,IAAI,GAAG;AAAA,IACvE,OAAO;AAAA,EACR;AAAA,EACA,MAAM,SAAS,KAAK,UAAU;AAAA,EAG9B,MAAM,MAAM,MAAM;AAAA,IACjB,OAAO,oBAAoB,SAAS,GAAG;AAAA,IAClC,OAAO,OAAO;AAAA,IACnB,IAAI;AAAA,MACH,WAAW,MAAM;AAAA,MAChB,MAAM;AAAA;AAAA,EAIT,IAAI;AAAA,EACJ,OAAO,IAAI,eAA2B;AAAA,IACrC,KAAK,CAAC,SAAS;AAAA,MACd,aAAa;AAAA,MACb,IAAI,OAAO;AAAA,QAAS,IAAI;AAAA,MACnB;AAAA,eAAO,iBAAiB,SAAS,KAAK,EAAE,MAAM,KAAK,CAAC;AAAA;AAAA,SAEpD,KAAI,CAAC,YAAY;AAAA,MACtB,MAAM,SAAS,MAAM,OAAO,KAAK,EAAE,MAAM,CAAC,UAAmB;AAAA,QAC5D,OAAO,oBAAoB,SAAS,GAAG;AAAA,QACvC,MAAM;AAAA,OACN;AAAA,MACD,IAAI,OAAO,MAAM;AAAA,QAChB,OAAO,oBAAoB,SAAS,GAAG;AAAA,QACvC,IAAI;AAAA,UACH,WAAW,MAAM;AAAA,UAChB,MAAM;AAAA,QAGR;AAAA,MACD;AAAA,MACA,WAAW,QAAQ,OAAO,KAAK;AAAA;AAAA,IAEhC,QAAQ,CAAC,WAAW;AAAA,MACnB,OAAO,oBAAoB,SAAS,GAAG;AAAA,MACvC,OAAO,OAAO,OAAO,MAAM;AAAA;AAAA,EAE7B,CAAC;AAAA;;;AG9NF;AACA;AAUA,SAAS,MAAM,CAAC,MAAsB;AAAA,EACrC,MAAM,YAAY,gBAAgB,KAAK,UAAU,KAAK,aAAa;AAAA,EACnE,IAAI,cAAc,aAAa,cAAc;AAAA,IAAM;AAAA,EACnD,gBAAgB,KAAK,cAAwB;AAAA,IAC5C,MAAM,UAAU;AAAA,IAChB,MAAM,UAAU,MAAM;AAAA,EACvB,CAAC;AAAA;AAQK,SAAS,iBAAiB,GAAW;AAAA,EAC3C,OAAO;AAAA,IACN,WAAW,GAAG,WAAW,OAAO,IAAI;AAAA,IACpC,aAAa,GAAG,WAAW,OAAO,IAAI;AAAA,EACvC;AAAA;;;AC7BD;;;ACCA;AA+BO,SAAS,YAAe,CAAC,SAA2C;AAAA,EAC1E,QAAQ,KAAK,KAAK,UAAU,OAAO,MAAM,KAAK,QAAQ;AAAA,EACtD,MAAM,UAAU,IAAI;AAAA,EACpB,IAAI,QAAQ;AAAA,EAEZ,MAAM,OAAO,CAAC,KAAa,UAA0B;AAAA,IACpD,QAAQ,OAAO,GAAG;AAAA,IAClB,SAAS,MAAM;AAAA;AAAA,EAGhB,OAAO;AAAA,IACN,GAAG,CAAC,KAAK;AAAA,MACR,MAAM,QAAQ,QAAQ,IAAI,GAAG;AAAA,MAC7B,IAAI,UAAU;AAAA,QAAW;AAAA,MACzB,IAAI,MAAM,WAAW,IAAI,GAAG;AAAA,QAC3B,KAAK,KAAK,KAAK;AAAA,QACf;AAAA,MACD;AAAA,MAEA,QAAQ,OAAO,GAAG;AAAA,MAClB,QAAQ,IAAI,KAAK,KAAK;AAAA,MACtB,OAAO,MAAM;AAAA;AAAA,IAEd,GAAG,CAAC,KAAK,OAAO;AAAA,MACf,MAAM,WAAW,QAAQ,IAAI,GAAG;AAAA,MAChC,IAAI,aAAa;AAAA,QAAW,KAAK,KAAK,QAAQ;AAAA,MAC9C,MAAM,SAAS,MAAM,KAAK,KAAK;AAAA,MAC/B,IAAI,SAAS,WAAW;AAAA,QAAG;AAAA,MAC3B,QAAQ,IAAI,KAAK,EAAE,OAAO,QAAQ,SAAS,IAAI,IAAI,IAAI,CAAC;AAAA,MACxD,SAAS;AAAA,MACT,YAAY,QAAQ,UAAU,SAAS;AAAA,QACtC,IAAI,QAAQ,QAAQ,OAAO,SAAS;AAAA,UAAU;AAAA,QAC9C,KAAK,QAAQ,KAAK;AAAA,MACnB;AAAA;AAAA,EAEF;AAAA;AAID,IAAM,kBAAkB;AAGxB,IAAM,iBAAiB;AASvB,IAAM,yBAAyB;AAG/B,IAAM,wBAAwB,iBAAiB;AAM/C,IAAI,YAAY;AAQhB,SAAS,SAAS,CACjB,UACgD;AAAA,EAChD,MAAM,QAAQ,SAAS,KAAK;AAAA,EAC5B,IAAI,UAAU;AAAA,IAAW;AAAA,EACzB,IAAI,SAAS;AAAA,EACb,IAAI,QAAQ;AAAA,EACZ,SAAS,QAAsB,MAAO,UAAU,MAAM,QAAQ,MAAM,MAAM;AAAA,IACzE;AAAA,IAOA,IACC,MAAM,SAAS,UAAU,UACzB,MAAM,MAAM,SAAS,MAAM,MAAM,MAAM,QAAQ,GAC9C;AAAA,MACD,SAAS,0BAA0B,MAAM,MAAM,MAAM;AAAA,MACrD,IAAI,MAAM,MAAM,SAAS;AAAA,QAAG,YAAY,MAAM,MAAM,WAAW,CAAC;AAAA,IACjE;AAAA,EACD;AAAA,EAEA,OAAO,EAAE,QAAQ,OAAO,SAAS,YAAY,GAAG;AAAA;AAU1C,SAAS,cAAc,CAAC,QAAgB,UAAgC;AAAA,EAC9E,MAAM,OAAO,UAAU,QAAQ;AAAA,EAC/B,IAAI,SAAS,WAAW;AAAA,IACvB,OACC,kBAAkB,KAAK,SACvB,iBAAiB,OAAO,SACxB,KAAK;AAAA,EAEP;AAAA,EACA,MAAM,aAAc,SAAqC;AAAA,EACzD,IAAI,OAAO,eAAe,UAAU;AAAA,IACnC,OAAO,KAAK,IAAI,KAAK,qBAAqB,IAAI,OAAO;AAAA,EACtD;AAAA,EACA,OAAO,kBAAkB,aAAa,wBAAwB,OAAO;AAAA;AAI/D,SAAS,WAAW,CAAC,QAAwB;AAAA,EACnD,OAAO,iBAAiB,OAAO,SAAS;AAAA;;;ACnJlC,IAAM,sBAAsB;AAG5B,SAAS,YAAY,CAC3B,YACiB;AAAA,EACjB,IAAI,eAAe;AAAA,IAAW,OAAO;AAAA,EACrC,IAAI,eAAe;AAAA,IAAO,OAAO;AAAA,EACjC,IAAI,OAAO,eAAe,YAAY,OAAO,cAAc,UAAU,GAAG;AAAA,IACvE,IAAI,aAAa;AAAA,MAAG,OAAO;AAAA,EAC5B;AAAA,EACA,MAAM,IAAI,UACT,6IAA6I,OAAO,UAAU,GAC/J;AAAA;AAGD,IAAM,QAAQ;AACd,IAAM,YAAY;AAClB,IAAM,OAAO;AACb,IAAM,KAAK;AACX,IAAM,KAAK;AAOJ,SAAS,SAAS,CAAC,MAAc,KAAqB;AAAA,EAC5D,IAAI,QAAQ;AAAA,EACZ,MAAM,MAAM,KAAK;AAAA,EACjB,SAAS,IAAI,EAAG,IAAI,KAAK,KAAK;AAAA,IAC7B,MAAM,OAAO,KAAK,WAAW,CAAC;AAAA,IAC9B,IAAI,SAAS,OAAO,SAAS,MAAM,SAAS,IAAI;AAAA,MAE/C,IAAI,EAAE,QAAQ;AAAA,QAAK,OAAO;AAAA,IAC3B,EAAO,SAAI,SAAS,OAAO,SAAS,MAAM,SAAS,IAAI;AAAA,MAEtD,IAAI,QAAQ;AAAA,QAAG;AAAA,IAChB,EAAO,SAAI,SAAS,MAAM;AAAA,MACzB,OAAO,IAAI,IAAI,KAAK;AAAA,QACnB,MAAM,OAAO,KAAK,WAAW,IAAI,CAAC;AAAA,QAClC,IAAI,SAAS,MAAM,SAAS;AAAA,UAAI;AAAA,QAChC;AAAA,MACD;AAAA,IACD,EAAO,SAAI,SAAS,OAAO;AAAA,MAC1B,IAAI,KAAK,WAAW,OAAO,CAAC,GAAG;AAAA,QAC9B,KAAK;AAAA,QACL,OAAO,IAAI,KAAK;AAAA,UACf,IAAI,KAAK,WAAW,SAAS,CAAC;AAAA,YAAG,KAAK;AAAA,UACjC,SAAI,KAAK,WAAW,OAAO,CAAC;AAAA,YAAG;AAAA,UAC/B;AAAA;AAAA,QACN;AAAA,QACA,KAAK;AAAA,MACN,EAAO;AAAA,QACN;AAAA,QACA,OAAO,IAAI,KAAK;AAAA,UACf,MAAM,WAAW,KAAK,WAAW,CAAC;AAAA,UAClC,IAAI,aAAa;AAAA,YAAW,KAAK;AAAA,UAC5B,SAAI,aAAa,SAAS,aAAa,MAAM,aAAa,IAAI;AAAA,YAClE;AAAA,UACD,EAAO;AAAA;AAAA,QACR;AAAA;AAAA,IAEF;AAAA,EACD;AAAA,EACA,OAAO;AAAA;;;AF1DD,IAAM,qBAAqB;AAYlC,IAAM,gBAAgB,KAAK,OAAO;AAElC,SAAS,QAAQ,CAChB,MACA,OACA,MACA,cAAc,IACL;AAAA,EACT,IAAI,OAAO,UAAU,YAAY,OAAO,cAAc,KAAK,KAAK,QAAQ,GAAG;AAAA,IAC1E,OAAO;AAAA,EACR;AAAA,EACA,MAAM,IAAI,UACT,kBAAkB,YAAY,gCAAgC,oBAAoB,OAAO,KAAK,GAC/F;AAAA;AAIM,SAAS,UAAU,CACzB,WACiB;AAAA,EACjB,IAAI,cAAc;AAAA,IAAW,OAAO;AAAA,EACpC,IAAI,cAAc;AAAA,IAAO,OAAO;AAAA,EAChC,OAAO,SACN,aACA,WACA,oDACA,qBACD;AAAA;AAID,IAAM,aAAa,CAAC,UACnB,iBAAiB,cAAc,cAAc,KAAK,MAAM,OAAO;AAUzD,SAAS,aAAa,CAC5B,WACA,YACS;AAAA,EACT,OAAO;AAAA,IACN,OAAO,GAAG,SAAS,cAAc;AAAA,MAChC,WAAW,CAAC,QAAQ,YAAY;AAAA,QAC/B,MAAM,OAAO,OAAO,WAAW,WAAW,SAAS,OAAO;AAAA,QAC1D,MAAM,SAAS,CAAC,UAAkB,QACjC,YACC,OAAO,WAAW,WAAW,IAAI,OAAO,MAAM,IAAI,QAClD,UACA,GACD;AAAA,QACD,IAAI,eAAe,OAAO;AAAA,UACzB,MAAM,KAAK,UAAU,MAAM,UAAU;AAAA,UACrC,IAAI,MAAM,GAAG;AAAA,YACZ,MAAM,OACL,IACA,gCAAgC,0CACjC;AAAA,UACD;AAAA,QACD;AAAA,QACA,IAAI;AAAA,UACH,OAAO,QACN,QACA,cAAc,QAAQ,UAAU,KAAK,SAAS,UAAU,CACzD;AAAA,UACC,OAAO,OAAO;AAAA,UACf,IAAI,CAAC,WAAW,KAAK;AAAA,YAAG,MAAM;AAAA,UAC9B,MAAM,OAAO,GAAG,yCAAyC;AAAA;AAAA,OAE1D;AAAA;AAAA,EAEH;AAAA;AAmBD,SAAS,UAAU,CAClB,YACqB;AAAA,EACrB,IAAI,eAAe;AAAA,IAAO,OAAO;AAAA,EACjC,IACC,eAAe,cACd,OAAO,eAAe,YAAY,eAAe,OACjD;AAAA,IACD,MAAM,IAAI,UACT,gGAAgG,OAAO,UAAU,GAClH;AAAA,EACD;AAAA,EACA,MAAM,QAAQ,cAAc,CAAC;AAAA,EAC7B,OAAO;AAAA,IACN,UAAU,SACT,uBACA,MAAM,YAAY,eAClB,wDACD;AAAA,IACA,KAAK,SACJ,kBACA,MAAM,OAAO,MACb,gCACD;AAAA,IACA,KAAK,SACJ,kBACA,MAAM,OAAO,SACb,4CACD;AAAA,EACD;AAAA;AAQM,SAAS,aAAa,CAC5B,WACA,YACA,YACA,aAIsE;AAAA,EACtE,MAAM,SAAS,WAAW,SAAS;AAAA,EACnC,MAAM,QAAQ,aAAa,UAAU;AAAA,EACrC,IACC,eAAe,aACf,YAAY,6BAA6B,WACxC;AAAA,IACD,MAAM,IAAI,UACT,gJACD;AAAA,EACD;AAAA,EACA,WAAW,UAAU;AAAA,EACrB,OAAO,EAAE,QAAQ,MAAM;AAAA;AAOjB,SAAS,WAAW,CAC1B,YACc;AAAA,EACd,MAAM,QAAQ,WAAW,UAAU;AAAA,EACnC,IAAI,UAAU;AAAA,IAAO,OAAO;AAAA,EAC5B,QAAQ,UAAU,KAAK,QAAQ;AAAA,EAC/B,MAAM,gBAAgB,aAA2B;AAAA,IAChD;AAAA,IACA;AAAA,IACA;AAAA,IACA,OAAO,CAAC,QAAQ,aAAa,eAAe,QAAQ,QAAQ;AAAA,EAC7D,CAAC;AAAA,EACD,MAAM,aAAa,aAAsB;AAAA,IACxC;AAAA,IACA;AAAA,IACA,UAAU,KAAK,MAAM,WAAW,CAAC;AAAA,IACjC,OAAO,CAAC,WAAW,YAAY,MAAM;AAAA,EACtC,CAAC;AAAA,EACD,OAAO,EAAE,eAAe,WAAW;AAAA;;;AGvMpC;AACA,4BAA4B;AAAA;AAUrB,MAAM,iBAAiB;AAAA,EACpB;AAAA,EACA,QAAQ,IAAI;AAAA,EAGrB,WAAW,CAAC,KAAa;AAAA,IACxB,KAAK,OAAO;AAAA;AAAA,EAIb,KAAK,CACJ,IACA,UACA,eACO;AAAA,IAEP,KAAK,IAAI,EAAE;AAAA,IACX,MAAM,YAAY,iBAAgB,UAAU,aAAa;AAAA,IACzD,IAAI,cAAc,aAAa,cAAc;AAAA,MAAM;AAAA,IACnD,MAAM,MAAM,eAAe,KAAK,MAAM;AAAA,MACrC,MAAM,UAAU;AAAA,MAChB,MAAM,UAAU,MAAM;AAAA,IACvB,CAAC;AAAA,IACD,KAAK,MAAM,IAAI,IAAI,EAAE,KAAK,SAAS,KAAK,CAAC;AAAA;AAAA,EAI1C,MAAM,CAAC,IAAkB;AAAA,IACxB,MAAM,OAAO,KAAK,MAAM,IAAI,EAAE;AAAA,IAC9B,IAAI,SAAS;AAAA,MAAW,KAAK,UAAU;AAAA;AAAA,EAIxC,GAAG,CAAC,IAAkB;AAAA,IACrB,MAAM,OAAO,KAAK,MAAM,IAAI,EAAE;AAAA,IAC9B,IAAI,SAAS;AAAA,MAAW;AAAA,IACxB,KAAK,MAAM,OAAO,EAAE;AAAA,IACpB,KAAK,IAAI,KAAK,OAAO;AAAA;AAAA,EAOtB,MAAM,GAAS;AAAA,IACd,WAAW,MAAM,CAAC,GAAG,KAAK,MAAM,KAAK,CAAC,GAAG;AAAA,MACxC,KAAK,OAAO,EAAE;AAAA,MACd,KAAK,IAAI,EAAE;AAAA,IACZ;AAAA;AAEF;AAYO,SAAS,SAA6B,GAG3C;AAAA,EACD,OAAO;AAAA,IACN,MAAM,GAAG,SAAS,IAAI,UAAU,OAAO,QAAQ;AAAA,MAC9C,IAAI,OAAO,WAAW,aAAa,OAAO,OAAO,SAAS,GAAG;AAAA,QAC5D,MAAM,WAAW,OAAO,EAAE;AAAA,MAC3B;AAAA;AAAA,IAED,OAAO,GAAG,SAAS,IAAI;AAAA,MACtB,MAAM,WAAW,OAAO,EAAE;AAAA,MAC1B,MAAM,WAAW,IAAI,EAAE;AAAA;AAAA,IAExB,UAAU,GAAG,SAAS,IAAI;AAAA,MACzB,MAAM,WAAW,IAAI,EAAE;AAAA;AAAA,EAEzB;AAAA;;;ACzDD,SAAS,UAAU,CAAC,OAAe,OAAsB;AAAA,EAExD,MAAM,MAAM,MAAM,WAAW,MAAM,KAAK,MAAM;AAAA,EAC9C,MAAM,KAAK,MAAM,aAAa,MAAM,KAAK,MAAM;AAAA,EAC/C,OAAO,MAAM,MAAM,GAAG,MAAM,SAAS,IAAI,MAAM,IAAI,MAAM;AAAA;AAQnD,SAAS,aAA0C,CACzD,QACA,OAC4D;AAAA,EAG5D,MAAM,YAAY,IAAI;AAAA,EACtB,MAAM,KAAK,CAAC,SACX,UAAU,IAAI,KAAK,YAAsB;AAAA,EAC1C,OAAO;AAAA,IACN,SAAS,CAAC,SAAS,GAAG,IAAI,EAAE,QAAQ,IAAa;AAAA,IACjD,WAAW,CAAC,SAAS,GAAG,IAAI,EAAE,UAAU,IAAa;AAAA,OAClD,UAAiB;AAAA,SACd,YAAW,CAAC,SAAS,IAAI,QAA0B;AAAA,MACxD,QAAQ,KAAK,YAAY,QAAQ;AAAA,MACjC,MAAM,UAAU;AAAA,WACZ,cAAc,GAAG;AAAA,QACpB;AAAA,QACA;AAAA,QACA,kBAAkB,QAAQ;AAAA,MAC3B;AAAA,MACA,QAAQ,QAAQ,SAAS,WAAW,gBAAgB,OAAO,aAC1D,OAAO,WAAW,IAAI,OAAiB,KAAK,CAAC,EAAE,aAAa,OAAO;AAAA,MACpE,IAAI;AAAA,MACJ,IAAI;AAAA,QACH,WAAW,MAAM,OAAO,KAAK;AAAA,QAC5B,OAAO,OAAO;AAAA,QACf,OAAO,CAAC,KAAc;AAAA;AAAA,MAEvB,QAAQ,MAAM,WAAW,MAAM,IAAI,UAAU,OAAO,aAAa;AAAA,MACjE,MAAM,SAAS,SAAS,QAAQ,QAAQ;AAAA,MACxC,IAAI,OAAO,SAAS;AAAA,QAAG,OAAO;AAAA,MAC9B,MAAM,eAAe,MAAM,eAAe;AAAA,MAC1C,UAAU,IAAI,cAAc,EAAE,SAAS,UAAU,CAAC;AAAA,MAClD,OAAO;AAAA,QACN;AAAA,QACA;AAAA,QACA,eAAe,OAAO;AAAA,QACtB,gBAAgB,OAAO;AAAA,QACvB;AAAA,MACD;AAAA;AAAA,EAEF;AAAA;;;AC5DM,IAAM,eACZ;AAGD,SAAS,MAAM,GAA0B;AAAA,EACxC,IAAI;AAAA,EACJ,OAAO,MAAM;AAAA,IACZ,YAAmB,qBAAc,MAAM,CAAC,UAAmB;AAAA,MAC1D,MAAM,IAAI,MAAM,cAAc,EAAE,MAAM,CAAC;AAAA,KACvC;AAAA,IACD,OAAO;AAAA;AAAA;AAKT,SAAS,MAAM,CAAC,QAAgB,SAA0B;AAAA,EACzD,MAAM,UAAU,QAAQ,QAAQ,IAAI,wBAAwB,KAAK;AAAA,EACjE,OAAO,OAAO,gBAAgB,OAAO,KAAK;AAAA;AAS3C,SAAS,gBAAgB,CAAC,SAAkB,QAA8B;AAAA,EACzE,OAAO,IAAI,QAAQ,QAAQ,KAAK;AAAA,IAC/B,QAAQ;AAAA,IACR,SAAS,QAAQ;AAAA,IACjB;AAAA,EACD,CAAC;AAAA;AAIF,SAAS,SAAS,CAAC,WAAuD;AAAA,EACzE,IAAI,cAAc;AAAA,IAAW,OAAO;AAAA,EACpC,IAAI,cAAc;AAAA,IAAO,OAAO;AAAA,EAChC,IAAI,OAAO,SAAS,SAAS,KAAK,YAAY;AAAA,IAAG,OAAO;AAAA,EACxD,MAAM,IAAI,UACT,mCAAmC,mGACpC;AAAA;AAiBM,SAAS,aAA0C,CACzD,QACA,UACA,SACC;AAAA,EACD,MAAM,QAAe,EAAE,UAAU,QAAQ,QAAQ,QAAQ,SAAS;AAAA,EAClE,MAAM,YAAY,UAAU,QAAQ,SAAS;AAAA,EAC7C,MAAM,OAAO,OAAO;AAAA,EACpB,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,MAAM,UAAU,IAAI;AAAA,EAGpB,eAAe,SAAS,CAAC,KAAkB,MAAoB;AAAA,IAC9D,WAAW,MAAM,KAAK;AAAA,IACtB,WAAW,OAAO,WAAW,cAAc,QAAQ,KAAK,CAAC;AAAA,IACzD,MAAM,WAAW,OAAO,QAAQ,IAAI,OAAO;AAAA,IAC3C,IAAI,aAAa;AAAA,MAChB,IAAI,IAAI,QAAQ,IAAI,0BAA0B,QAAQ;AAAA,IACvD,OAAO,KAAK;AAAA;AAAA,EAIb,MAAM,WAAW;AAAA,IAChB,IAAI,CAAC,QAAuB;AAAA,MAC3B,MAAM,MAAM,OAAO;AAAA,MACnB,MAAM,SAAiB;AAAA,QACtB,MAAM,IAAI;AAAA,QACV,YAAY,IAAI,iBAAiB,OAAO,IAAI;AAAA,MAC7C;AAAA,MACA,QAAQ,IAAI,KAAK,MAAM;AAAA,MAEvB,MAAM,kBAAkB;AAAA,MACxB,OAAO,SAAS,gBAAgB,OAC/B;AAAA,QAEC,UAAU,OAAO,QAAkB,OAAO,KAAK,OAAO;AAAA,QACtD,MAAM,CAAC,SAAiB;AAAA,UACvB,IAAI,IAAI,eAAe;AAAA,YAAG,IAAI,SAAS,IAAI;AAAA;AAAA,QAE5C,OAAO,CAAC,MAAe,WAAoB,IAAI,MAAM,MAAM,MAAM;AAAA,QACjE,WAAW,CAAC,WAA4C;AAAA,UACvD,OAAO,YAAY;AAAA;AAAA,MAErB,GACA;AAAA,QACC,KAAK,OAAO;AAAA,QACZ,SAAS,iBAAiB,OAAO,KAAK,SAAS,OAAO,KAAK,MAAM;AAAA,QACjE,YAAY,OAAO;AAAA,MACpB,CACD;AAAA,MACA,IAAI,cAAc,OAAO;AAAA,QACxB,OAAO,QAAQ,YAAY,MAAM,IAAI,KAAK,GAAG,SAAS;AAAA,MACvD;AAAA;AAAA,SAEK,QAAO,CAAC,QAAuB,SAAkB;AAAA,MACtD,MAAM,OACL,OAAO,YAAY,WAChB,UACA,IAAI,YAAY,EAAE,OAAO,OAAqB;AAAA,MAClD,MAAM,QAAQ,IAAI,OAAO,GAAG,GAAG,YAAY,IAAI;AAAA;AAAA,SAE1C,MAAK,CAAC,QAAuB,MAAc,QAAgB;AAAA,MAChE,MAAM,SAAS,QAAQ,IAAI,OAAO,GAAG;AAAA,MACrC,IAAI,WAAW;AAAA,QAAW;AAAA,MAC1B,cAAc,OAAO,KAAK;AAAA,MAC1B,QAAQ,OAAO,OAAO,GAAG;AAAA,MACzB,OAAO,KAAK,MAAM;AAAA,MAClB,MAAM,OAAO,SAAS,MAAM,MAAM;AAAA,MAClC,OAAO,WAAW,OAAO;AAAA;AAAA,EAE3B;AAAA,EACA,OAAO,EAAE,MAAM,MAAM,QAAQ,YAAY,WAAW,SAAS;AAAA;;;AXYvD,SAAS,OAMf,CACA,KACA,SAKqB;AAAA,EACrB;AAAA,IACC,OAAO;AAAA,IACP,OAAO;AAAA,IACP;AAAA,IACA;AAAA,IACA;AAAA,IACA,KAAK;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,OACG;AAAA,MACA;AAAA,EACJ,MAAM,SAAS,cAAc,WAAW,YAAY,YAAY,WAAW;AAAA,EAC3E,MAAM,OAAO,YAAY;AAAA,EACzB,MAAM,SAAS,YACd;AAAA,OACK;AAAA,IACJ,SAAS;AAAA,MACR,cAAc,OAAO,QAAQ,OAAO,KAAK;AAAA,MACzC,GAAI,YAAY,WAAW,CAAC;AAAA,MAC5B,kBAAkB;AAAA,IACnB;AAAA,IACA;AAAA,IACA,UAAW,QAAQ,YAChB,CAAC,UAAmB,YAAoB,MAAM,OAAO,KAAK,OAC1D,QAAQ,aACP,OACA;AAAA,EACL,GACA,YAAY,6BAA6B,YACtC,MAAM,YAAY,UAAU,IAC5B,SACJ;AAAA,EACA,MAAM,UAAU,eACf,QACA,QAAQ,mBAAoB,WAAW,CAAC,IAAK,KAC9C;AAAA,EAEA,gBACC,KACA,MACA,SACA,WACA,OAAO,QACJ,YACA,cAAc,QAAQ,MAAM,OAAO,OAAO,CAAC,IAAI,EAAE,CACrD;AAAA,EACA,OAAO;AAAA;",
19
+ "debugId": "01B66A2C6AD2881F64756E2164756E21",
16
20
  "names": []
17
21
  }
@@ -0,0 +1,18 @@
1
+ /**
2
+ * How deep a document may nest. graphql-js parses by recursion, one set of
3
+ * frames per `{`, `(` or `[`, so a document a few thousand levels deep
4
+ * overflows the stack (a `RangeError`) long before `maxTokens` stops it,
5
+ * and Yoga answers that with a 500. A linear scan of the source counts the
6
+ * nesting first, without recursing.
7
+ */
8
+ /** The most levels of `{`, `(` and `[` a document may nest, unless `maxNesting` says otherwise. */
9
+ export declare const DEFAULT_MAX_NESTING = 1000;
10
+ /** `maxNesting` checked where `graphql()` is declared. */
11
+ export declare function nestingLimit(maxNesting: number | false | undefined): number | false;
12
+ /**
13
+ * The offset of the first bracket that nests `body` deeper than `max`
14
+ * levels, or -1. Brackets inside strings, block strings and comments are
15
+ * text, not nesting; an unbalanced closing bracket is left to the parser.
16
+ */
17
+ export declare function tooDeepAt(body: string, max: number): number;
18
+ //# sourceMappingURL=nesting.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"nesting.d.ts","sourceRoot":"","sources":["../src/nesting.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,mGAAmG;AACnG,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC,0DAA0D;AAC1D,wBAAgB,YAAY,CAC3B,UAAU,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,GACpC,MAAM,GAAG,KAAK,CAShB;AAQD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAuC3D"}
@@ -0,0 +1,50 @@
1
+ /**
2
+ * What `graphql()` bounds about parsing: the tokens a document may hold,
3
+ * and the cache of what was parsed.
4
+ */
5
+ import { type DocumentNode } from 'graphql';
6
+ import type { Plugin, YogaServerOptions } from 'graphql-yoga';
7
+ import { type Cache } from './document-cache';
8
+ import type { YogaContext } from './handler';
9
+ /** The most tokens a document may hold, unless `maxTokens` says otherwise. */
10
+ export declare const DEFAULT_MAX_TOKENS = 15000;
11
+ /** The sizes of the parse cache, of each endpoint. */
12
+ export interface ParseCacheOptions {
13
+ /** The most estimated bytes of parsed documents kept. 64 MiB by default. */
14
+ readonly maxBytes?: number;
15
+ /** The most documents kept. 1 024 by default. */
16
+ readonly max?: number;
17
+ /** How long a document is kept, in milliseconds. One hour by default. */
18
+ readonly ttl?: number;
19
+ }
20
+ /** `maxTokens` checked where `graphql()` is declared. */
21
+ export declare function tokenLimit(maxTokens: number | false | undefined): number | false;
22
+ /**
23
+ * A Yoga plugin bounding what the parser is given: the tokens of every
24
+ * document (`maxTokens`) and the levels it nests (`maxNesting`, a scan of the
25
+ * source before any recursion). A document the parser still overflows the
26
+ * stack on is refused the same way, never a 500. It wraps the parse function
27
+ * Envelop already holds, never graphql's own `parse`: a second copy of
28
+ * graphql would throw errors Yoga does not recognise, masked as a 500.
29
+ */
30
+ export declare function limitsParsing(maxTokens: number | false, maxNesting: number | false): Plugin;
31
+ /** What Yoga's `parserAndValidationCache` takes from alxia. */
32
+ export type ParseCaches = false | {
33
+ documentCache: Cache<DocumentNode>;
34
+ errorCache: Cache<unknown>;
35
+ };
36
+ /**
37
+ * The limits `graphql()` was given, checked once at declaration: the token
38
+ * cap and the nesting limit, resolved, and the parse cache, which cannot be given beside Yoga's
39
+ * own. Each endpoint's Yoga builds its caches from the same options.
40
+ */
41
+ export declare function resolveLimits(maxTokens: number | false | undefined, maxNesting: number | false | undefined, parseCache: false | ParseCacheOptions | undefined, yogaOptions: Pick<YogaServerOptions<YogaContext, YogaContext>, 'parserAndValidationCache'>): {
42
+ readonly tokens: number | false;
43
+ readonly depth: number | false;
44
+ };
45
+ /**
46
+ * The `parserAndValidationCache` of one Yoga: a pair of bounded caches,
47
+ * created per call so each endpoint has its own. `false` gives none.
48
+ */
49
+ export declare function parseCaches(parseCache: false | ParseCacheOptions | undefined): ParseCaches;
50
+ //# sourceMappingURL=parse-limits.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"parse-limits.d.ts","sourceRoot":"","sources":["../src/parse-limits.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,KAAK,YAAY,EAAuB,MAAM,SAAS,CAAC;AACjE,OAAO,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAEN,KAAK,KAAK,EAGV,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG7C,8EAA8E;AAC9E,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAEzC,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IACjC,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,iDAAiD;IACjD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACtB;AAkBD,yDAAyD;AACzD,wBAAgB,UAAU,CACzB,SAAS,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,GACnC,MAAM,GAAG,KAAK,CAShB;AAMD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC5B,SAAS,EAAE,MAAM,GAAG,KAAK,EACzB,UAAU,EAAE,MAAM,GAAG,KAAK,GACxB,MAAM,CAgCR;AAED,+DAA+D;AAC/D,MAAM,MAAM,WAAW,GACpB,KAAK,GACL;IACA,aAAa,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IACnC,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CAC1B,CAAC;AA0CL;;;;GAIG;AACH,wBAAgB,aAAa,CAC5B,SAAS,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,EACrC,UAAU,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,EACtC,UAAU,EAAE,KAAK,GAAG,iBAAiB,GAAG,SAAS,EACjD,WAAW,EAAE,IAAI,CAChB,iBAAiB,CAAC,WAAW,EAAE,WAAW,CAAC,EAC3C,0BAA0B,CAC1B,GACC;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAAA;CAAE,CAarE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAC1B,UAAU,EAAE,KAAK,GAAG,iBAAiB,GAAG,SAAS,GAC/C,WAAW,CAiBb"}
package/docs/README.md CHANGED
@@ -12,7 +12,7 @@ a realistic example for each.
12
12
  | [The typed context](guide/context.md) | typing a schema with the app's context, reading `user` or a database handle in a resolver, setting a cookie, adding per-request loaders, or reading the `missing …` compile error |
13
13
  | [Yoga's plugins and options](guide/yoga.md) | adding Yoga or Envelop plugins, exposing or masking errors, batching, serving subscriptions, or calling the endpoint from another origin |
14
14
  | [GraphQL over WebSocket](guide/websockets.md) | serving Apollo Client's, urql's or `graphql-ws`'s WebSocket clients with `ws: true`, guarding the upgrade, reading `connectionParams`, the subprotocol, closing the sockets on shutdown, or testing a subscription over a socket |
15
- | [Harden it for production](guide/production.md) | putting a GraphQL API on the internet: rate limiting the endpoint, depth limits, introspection off outside development, masked errors and the errors a client may read, a body limit, CSRF for a cookie session, persisted operations |
15
+ | [Harden it for production](guide/production.md) | putting a GraphQL API on the internet: rate limiting the endpoint, depth limits, the token cap, the nesting cap, the parse cache and the body limit, introspection off outside development, masked errors and the errors a client may read, a body limit, CSRF for a cookie session, persisted operations |
16
16
  | [GraphiQL and Apollo Sandbox](guide/ide.md) | choosing the IDE a browser gets, configuring it, keeping it working under a strict `Content-Security-Policy`, or serving it outside dev with `ide: 'graphiql'` |
17
17
  | [Testing the endpoint](guide/testing.md) | testing a GraphQL app without a server: `graphqlClient`, an auth header, a custom path, `GET`, persisted operations, the CSRF header, a typed document, the HTTP status of a 400 or a 413 |
18
18
  | [Troubleshooting](troubleshooting.md) | something went wrong and you have the message |
@@ -55,6 +55,10 @@ routes on `base` and returns it.
55
55
  | `graphiql` | Yoga's `GraphiQLOptions` | Yoga's | GraphiQL's options, when `ide` is `'graphiql'`. |
56
56
  | `sandbox` | `SandboxOptions` | — | Apollo Sandbox's options, when `ide` is `'apollo-sandbox'`. |
57
57
  | `ws` | `boolean \| { path?, keepAlive? }` | `false` | GraphQL over WebSocket too, with the optional peer `graphql-ws`: see [GraphQL over WebSocket](websockets.md). |
58
+ | `maxTokens` | `number \| false` | `15_000` | The most tokens a document may hold; a longer one is refused as `GRAPHQL_PARSE_FAILED`. `false` for no cap. Anything but a positive whole number throws where `graphql()` is declared: see [Cap what a request costs](production.md#cap-what-a-request-costs). |
59
+ | `maxNesting` | `number \| false` | `1_000` | The most levels of `{`, `(` and `[` a document may nest; a deeper one is refused as `GRAPHQL_PARSE_FAILED` before the parser recurses into it, instead of overflowing the stack as a 500. `false` for no limit. Anything but a positive whole number throws where `graphql()` is declared: see [Cap what a request costs](production.md#cap-what-a-request-costs). |
60
+ | `parseCache` | `false \| { maxBytes?, max?, ttl? }` | 64 MiB, 1 024 documents, 3 600 000 ms | The cache of parsed documents, one per endpoint, bounded by estimated bytes. `false` parses every request. Cannot be given with Yoga's `parserAndValidationCache`, which replaces it. |
61
+ | `bodyLimit` | `number` | the app's earlier `bodyLimit()`, else `1_048_576` (1 MiB) | The most bytes a `POST` body may hold; past it core answers a 413, in the app's error format. A whole number of bytes, else core's `TypeError` where `graphql()` is declared. A `multipart` upload needs a larger one: see [Cap what a request costs](production.md#cap-what-a-request-costs). |
58
62
  | `cors` | Yoga's `cors` | `false` | Yoga's own CORS. Off: use `@alxia/cors` for the whole app instead ([Yoga's plugins and options](yoga.md#cors)). |
59
63
  | every other Yoga option | | Yoga's | `plugins`, `context`, `maskedErrors`, `batching`, `logging`… passed to `createYoga` as they are: see [Yoga's plugins and options](yoga.md). |
60
64
 
@@ -117,22 +117,119 @@ export function notFound(what: string): GraphQLError {
117
117
  }
118
118
  ```
119
119
 
120
- ## Cap the body
120
+ ## Cap what a request costs
121
+
122
+ Yoga parses a document before any resolver guard runs, and a parsed
123
+ document stays in a cache. Both are bounded by default, by the document's
124
+ **tokens**: the words, names and punctuation the parser reads. Measured on
125
+ graphql 16 and 17, a parsed token costs between 178 and 509 bytes of heap
126
+ whatever its shape (4 000 aliases, one-character fields, nested lists,
127
+ directives), where the cost per character swings from 58 to 254. So the
128
+ count of tokens is the weight, and 512 bytes per token the upper estimate: a
129
+ document of 15 000 tokens parses to 7.7 MB at most (15 000 × 512 B); a
130
+ measured heavy document of about 12 000 tokens weighs about 6 MB.
131
+
132
+ The cache weighs a document as its tokens (comments included) × 512 B, plus
133
+ 4 B per source character, plus 32 B per source character of string literals
134
+ with escapes (`\n`, `\u00e9`), whose value graphql 16 builds as a rope; or
135
+ 36 B per character in all when the document has no locations (`noLocation`),
136
+ since nothing then tells where the strings are. A location-less document of
137
+ 1 MB weighs over 8 MiB and is not cached. The weight is an estimate by
138
+ design, not an exact measure.
139
+
140
+ Yoga's validation results for a cached document (up to about 100 errors
141
+ each) sit outside the weight, bounded at roughly 70 KB per document.
142
+
143
+ `maxTokens` does not count comments, yet a
144
+ parsed document keeps all of them alive: a 750 KB body of `#` lines holds
145
+ about 19.6 MB (one `#` per line, `#\n`: each comment becomes a token the
146
+ document keeps), so it weighs more than the cache keeps and is parsed again
147
+ each time instead of cached.
148
+
149
+ - **`maxTokens`, 15 000 by default** (Apollo Router's own limit). The
150
+ introspection query is 163 tokens and a large screen query with its
151
+ fragments a few thousand, so a client written for a federated graph passes.
152
+ A longer one is
153
+ refused before it runs, as any document the parser cannot read is:
154
+ `GRAPHQL_PARSE_FAILED`, `Syntax Error: Document contains more than 15000
155
+ tokens. Parsing aborted.` (graphql 16 words it `more that`), HTTP 400 under
156
+ `application/graphql-response+json` and 200 under `application/json`,
157
+ never logged. It applies to `POST`, `GET`, each operation of a batch and
158
+ each operation over WebSocket. `maxTokens: false` turns it off; a plugin of
159
+ yours that sets its own parse function replaces it.
160
+ - **`maxNesting`, 1 000 by default.** graphql-js parses by recursion, so a
161
+ document nested a few thousand levels deep (`{ a { a { …`, `[[[…`) overflows
162
+ the stack while it is still well under `maxTokens`, and would answer a 500
163
+ `Unexpected error.` and log it. alxia scans the source for the nesting of
164
+ `{`, `(` and `[` first, linearly and ignoring strings, block strings and
165
+ comments, and refuses a deeper document as `GRAPHQL_PARSE_FAILED`,
166
+ `Syntax Error: Document is nested more than 1000 levels deep. Parsing
167
+ aborted.`, with the same status and no log as `maxTokens`. A document that
168
+ overflows the stack anyway (`maxNesting: false`, or a limit raised too far)
169
+ is refused as `Syntax Error: Document is nested too deeply to parse.`
170
+ `maxNesting: false` turns the scan off; a real query nests a dozen levels.
171
+ It counts `{`, `(` and `[` together, arguments and lists included, so it
172
+ is not a selection-depth rule; use a validation rule for that
173
+ ([Limit depth and complexity](#limit-depth-and-complexity)).
174
+ - **`parseCache`**, a least-recently-used cache per endpoint, weighed in
175
+ bytes: `maxBytes` (64 MiB), `max` documents (1 024) and `ttl` (one hour).
176
+ A document heavier than an eighth of `maxBytes` is not kept and is parsed
177
+ again each time. Yoga's own cache holds up to 1 024 documents whatever their
178
+ size, which is gigabytes for distinct large queries. `parseCache: false`
179
+ keeps nothing. An app with its own cache store gives Yoga's
180
+ `parserAndValidationCache`, which replaces this one, and must bound it
181
+ too; giving both throws where `graphql()` is declared.
182
+
183
+ ```ts
184
+ graphql(app, {
185
+ schema,
186
+ maxTokens: 20_000,
187
+ parseCache: { maxBytes: 32 * 1024 * 1024 },
188
+ });
189
+ ```
190
+
191
+ ### The body
121
192
 
122
193
  Yoga reads the whole body of a `POST` before it parses it, so a megabyte of
123
- JSON costs a megabyte of memory. Core's `bodyLimit(bytes)` caps every route
124
- declared after it: the bytes are counted as they arrive, and reading stops
125
- at the limit. A query is a few kilobytes: 100 KiB is generous. A mutation
126
- that takes a file by `multipart` needs a larger limit on a route of its own.
127
-
128
- Put the call before `graphql(...)`, as in [Together](#together). Yoga reads
129
- the body itself and would report a body it could not read as `400`, `POST
130
- body sent invalid JSON.`; `@alxia/graphql` throws core's `ContentTooLargeError`
131
- again instead, so a client gets the 413 a plain route answers, in the app's
132
- error format (`application/problem+json` under `errors: 'problem'`), with a
133
- `Content-Length` or without one (a chunked body). Whatever else Yoga cannot
134
- parse is still its 400, and its parser's own error is never sent
135
- (`extensions.originalError` is removed).
194
+ JSON costs a megabyte of memory. The `POST` route has a body limit, counted
195
+ as the bytes arrive:
196
+
197
+ - **`bodyLimit`, 1 MiB by default.** Give the option to `graphql()`, or
198
+ declare core's `bodyLimit(bytes)` before it: that limit is kept as it is,
199
+ and the option wins over it. A query is a few kilobytes, so for an API that
200
+ takes no uploads, 100 KiB is generous. A mutation that takes a file by
201
+ `multipart` needs a larger limit, in the option. A plugin app mounted
202
+ under a prefix keeps the limit of its own scope; the outer app's
203
+ `bodyLimit()` does not reach it.
204
+ - **The 413.** Yoga would report a body it could not read as `400`, `POST
205
+ body sent invalid JSON.`; `@alxia/graphql` throws core's
206
+ `ContentTooLargeError` again instead, so a client gets the 413 a plain
207
+ route answers, in the app's error format (`application/problem+json` under
208
+ `errors: 'problem'`), with a `Content-Length` or without one (a chunked
209
+ body). It carries the headers Yoga's plugins set, such as a
210
+ `Cache-Control: no-store` from an `onResponse` hook. Headers merge by
211
+ name: `Vary` is merged with the app's own, `Set-Cookie` is appended, and any
212
+ other header Yoga sets overwrites the app's header of the same name (Yoga's
213
+ `Content-Type`, `Content-Length`, `Content-Encoding` and `Transfer-Encoding`
214
+ are never carried). A form-urlencoded or
215
+ `application/graphql` body past the limit is refused the same way and logs
216
+ nothing. Whatever else Yoga cannot parse is still its 400, and its
217
+ parser's own error is never sent (`extensions.originalError` is removed).
218
+ - **Order.** The body is read by the endpoint, after every middleware
219
+ declared before it, `bodyLimit()` included: those still run for an
220
+ oversized body. Declare the cheap observers first and the costly
221
+ middlewares (a session lookup, a database call) as late as you can. A
222
+ refusal answered before Yoga runs cannot carry Yoga's headers: set the ones
223
+ every response needs in a middleware.
224
+
225
+ ```ts
226
+ graphql(app, {
227
+ schema,
228
+ maxTokens: 20_000,
229
+ parseCache: { maxBytes: 32 * 1024 * 1024 },
230
+ bodyLimit: 100 * 1024,
231
+ });
232
+ ```
136
233
 
137
234
  ## CSRF for a cookie-authenticated API
138
235
 
@@ -193,6 +290,10 @@ export const persisted: Plugin = usePersistedOperations({
193
290
 
194
291
  ## Together
195
292
 
293
+ `maxTokens`, `maxNesting` and `parseCache` need no line here: their defaults apply. The
294
+ `bodyLimit()` below is the app's own and is kept; without it the `POST` takes
295
+ 1 MiB.
296
+
196
297
  ```ts no-check
197
298
  // file: src/production.ts
198
299
  import { logger } from '@alxia/logger';
@@ -190,7 +190,20 @@ An error stays GraphQL's. A resolver's arrives in a `next` message with
190
190
  `errors[]` — masked to `Unexpected error.` unless `maskedErrors` says
191
191
  otherwise — and the subscription goes on or completes as over HTTP. A
192
192
  query that does not parse or validate is answered with an `error`
193
- message, the protocol's, and the socket stays open.
193
+ message, the protocol's, and the socket stays open. `maxTokens` applies to
194
+ each operation: a `subscribe` message holding a longer document gets that
195
+ `error`, `Document contains more than 15000 tokens`. `maxNesting` applies to
196
+ each `subscribe` operation the same way: a document nested deeper gets an
197
+ `error` message carrying `GRAPHQL_PARSE_FAILED`, the socket stays open and
198
+ nothing is logged.
199
+
200
+ `bodyLimit` does not reach the socket: a `subscribe` message is bounded by
201
+ Bun's `maxPayloadLength` (16 MiB by default), not by the 1 MiB a `POST` body
202
+ may hold. The parse cache and `maxTokens` still apply to its document, but
203
+ `maxTokens` does not count comments: a large comment-only message still
204
+ costs its parse, and only `maxPayloadLength` bounds it. A
205
+ configurable limit for WebSocket messages is on the
206
+ [roadmap](../roadmap.md).
194
207
 
195
208
  ## Shutdown
196
209
 
package/docs/roadmap.md CHANGED
@@ -11,14 +11,34 @@ Nothing in progress.
11
11
 
12
12
  ## Next
13
13
 
14
- Nothing scheduled yet.
14
+ - **A declared oversize body refused where `bodyLimit()` stands.** Today the
15
+ body is read, and refused, by the endpoint, after every middleware declared
16
+ before it. Core would answer a `Content-Length` past the limit at the
17
+ `bodyLimit()` call, so the middlewares after it never run for such a
18
+ request. It lives in `@alxia/core`.
15
19
 
16
20
  ## Later
17
21
 
18
- Nothing scheduled yet.
22
+ - **Weighing validation results.** Yoga keeps the validation errors of a
23
+ cached document (up to about 100) outside the parse cache's weight, at
24
+ roughly 70 KB per document; the weight could count them.
25
+ - **A configurable WebSocket message limit.** A `subscribe` message over the
26
+ socket is bounded by Bun's `maxPayloadLength` (16 MiB by default), not by
27
+ `bodyLimit`. A `ws` option would set the limit the way `bodyLimit` does
28
+ for a `POST`.
19
29
 
20
30
  ## Shipped
21
31
 
32
+ ### 0.9.0
33
+
34
+ - **Bounded parsing.** A document may hold 15 000 tokens (`maxTokens`, `false`
35
+ to opt out); a longer one is refused as `GRAPHQL_PARSE_FAILED`. The parse
36
+ cache is bounded by weight, 64 MiB per endpoint (`parseCache`), in place of
37
+ Yoga's, which has no size bound. A `POST` body may hold 1 MiB (`bodyLimit`)
38
+ unless the app declared its own limit; the 413 keeps the headers Yoga's
39
+ plugins set and logs nothing. A query over 15 000 tokens and an upload past
40
+ 1 MiB need an option ([production guide](guide/production.md#cap-what-a-request-costs)).
41
+
22
42
  ### 0.8.0
23
43
 
24
44
  - **`GET` and persisted operations in the test client.** `graphqlClient`