@alxia/graphql 0.13.3 → 0.14.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +18 -1
- package/dist/executor.d.ts +66 -0
- package/dist/executor.d.ts.map +1 -0
- package/dist/graphql.d.ts +2 -2
- package/dist/graphql.d.ts.map +1 -1
- package/dist/index.d.ts +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +92 -49
- package/dist/index.js.map +7 -5
- package/dist/yoga.d.ts +12 -0
- package/dist/yoga.d.ts.map +1 -0
- package/docs/README.md +1 -0
- package/docs/guide/executor.md +60 -0
- package/docs/roadmap.md +1 -0
- package/docs/troubleshooting.md +14 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -310,6 +310,21 @@ app.listen({ port: 4000 });
|
|
|
310
310
|
|
|
311
311
|
See [the endpoint guide](https://github.com/softistx/alxia/blob/develop/packages/graphql/docs/guide/endpoint.md#errors-health-and-shutdown).
|
|
312
312
|
|
|
313
|
+
## In process
|
|
314
|
+
|
|
315
|
+
`graphqlExecutor(options)` runs a query or a mutation in the process, with the
|
|
316
|
+
same plugins, limits, parse cache and error masking as `graphql()`, and a
|
|
317
|
+
server context you pass: for an MCP tool or a job, not a browser.
|
|
318
|
+
|
|
319
|
+
```ts
|
|
320
|
+
import { graphqlExecutor } from '@alxia/graphql';
|
|
321
|
+
|
|
322
|
+
const execute = graphqlExecutor({ schema, plugins: [useAuth()] });
|
|
323
|
+
const { data, errors } = await execute({ query: '{ me { id } }' }, { viewer });
|
|
324
|
+
```
|
|
325
|
+
|
|
326
|
+
See [the guide](https://github.com/softistx/alxia/blob/develop/packages/graphql/docs/guide/executor.md).
|
|
327
|
+
|
|
313
328
|
## Testing
|
|
314
329
|
|
|
315
330
|
`graphqlClient` from `@alxia/graphql/testing` sends operations to the app
|
|
@@ -343,6 +358,8 @@ See
|
|
|
343
358
|
| export | |
|
|
344
359
|
| --- | --- |
|
|
345
360
|
| `graphql(app, options)` | the endpoint: `schema`, `path`, `ide`, `sandbox`, `ws`, `maxTokens`, `maxNesting`, `parseCache`, `bodyLimit`, and every Yoga option |
|
|
361
|
+
| `graphqlExecutor(options)` | `(request: { query, operationName?, variables? }, context, { signal? }?) => Promise<{ data?, errors? }>`: a query or mutation in process, through the options of `graphql()` without the route's (`path`, `ide`, `ws`, `bodyLimit`, `cors`) |
|
|
362
|
+
| `ExecutorRequest`, `ExecutorResult`, `ExecutorError`, `ExecutorCall`, `GraphQLExecutor`, `GraphQLExecutorOptions` | its types |
|
|
346
363
|
| `GraphQLWsOptions` | `ws`'s options: `path`, `keepAlive` |
|
|
347
364
|
| `GraphQLWsContext` | what an operation over WebSocket adds to the context: `connectionParams` |
|
|
348
365
|
| `renderSandbox(endpoint, options?)`, `SANDBOX_POLICY` | the Sandbox page, and the policy it loads under |
|
|
@@ -359,7 +376,7 @@ See
|
|
|
359
376
|
|
|
360
377
|
## Documentation
|
|
361
378
|
|
|
362
|
-
- [Guide](https://github.com/softistx/alxia/tree/develop/packages/graphql/docs): a page per area — mounting the endpoint, the typed context, Yoga's plugins and options, GraphQL over WebSocket, GraphiQL and Apollo Sandbox, and [hardening an API for production](https://github.com/softistx/alxia/blob/develop/packages/graphql/docs/guide/production.md) (rate limits, depth limits, introspection, errors, body size, CSRF, persisted operations).
|
|
379
|
+
- [Guide](https://github.com/softistx/alxia/tree/develop/packages/graphql/docs): a page per area — mounting the endpoint, the typed context, Yoga's plugins and options, GraphQL over WebSocket, running operations in process, GraphiQL and Apollo Sandbox, and [hardening an API for production](https://github.com/softistx/alxia/blob/develop/packages/graphql/docs/guide/production.md) (rate limits, depth limits, introspection, errors, body size, CSRF, persisted operations).
|
|
363
380
|
- [Troubleshooting](https://github.com/softistx/alxia/blob/develop/packages/graphql/docs/troubleshooting.md): an error message, and what to do about it.
|
|
364
381
|
- [Roadmap](https://github.com/softistx/alxia/blob/develop/packages/graphql/docs/roadmap.md): what is coming, and what is not planned.
|
|
365
382
|
- [Recipes](https://github.com/softistx/alxia/blob/develop/docs/recipes/README.md): [A GraphQL API](https://github.com/softistx/alxia/blob/develop/docs/recipes/graphql-api.md), [Authenticate requests](https://github.com/softistx/alxia/blob/develop/docs/recipes/authentication.md), [Test an alxia app](https://github.com/softistx/alxia/blob/develop/docs/recipes/testing.md), [Health checks and graceful shutdown](https://github.com/softistx/alxia/blob/develop/docs/recipes/health-and-shutdown.md), and more.
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
import type { Empty } from '@alxia/core';
|
|
2
|
+
import type { GraphQLSchemaWithContext, YogaInitialContext, YogaServerOptions } from 'graphql-yoga';
|
|
3
|
+
import type { YogaContext } from './handler';
|
|
4
|
+
import type { ParseCacheOptions } from './parse-limits';
|
|
5
|
+
/** What an in-process call asks for: a GraphQL-over-HTTP request's parameters. */
|
|
6
|
+
export interface ExecutorRequest {
|
|
7
|
+
readonly query: string;
|
|
8
|
+
readonly operationName?: string | undefined;
|
|
9
|
+
readonly variables?: Readonly<Record<string, unknown>> | undefined;
|
|
10
|
+
}
|
|
11
|
+
/** A plain, JSON-shaped error, as the route answers it. */
|
|
12
|
+
export interface ExecutorError {
|
|
13
|
+
readonly message: string;
|
|
14
|
+
readonly path?: readonly (string | number)[];
|
|
15
|
+
readonly locations?: readonly {
|
|
16
|
+
line: number;
|
|
17
|
+
column: number;
|
|
18
|
+
}[];
|
|
19
|
+
readonly extensions?: Readonly<Record<string, unknown>>;
|
|
20
|
+
}
|
|
21
|
+
/** The answer: `data` and `errors`, as the endpoint's JSON body. */
|
|
22
|
+
export interface ExecutorResult {
|
|
23
|
+
readonly data?: unknown;
|
|
24
|
+
readonly errors?: readonly ExecutorError[];
|
|
25
|
+
}
|
|
26
|
+
/** Per call: the signal that stops the operation, as a client leaving does. */
|
|
27
|
+
export interface ExecutorCall {
|
|
28
|
+
readonly signal?: AbortSignal;
|
|
29
|
+
}
|
|
30
|
+
/**
|
|
31
|
+
* The options of `graphqlExecutor()`: those of `graphql()` that mean
|
|
32
|
+
* something without a route. Put an HTTP-only plugin (a client-header
|
|
33
|
+
* check, `cache-control`) in the route's list and not here.
|
|
34
|
+
*/
|
|
35
|
+
export interface GraphQLExecutorOptions<ServerCtx extends YogaContext, UserCtx extends YogaContext, SchemaCtx = unknown> extends Omit<YogaServerOptions<ServerCtx, UserCtx>, 'graphqlEndpoint' | 'cors' | 'schema' | 'graphiql' | 'landingPage' | 'parserAndValidationCache'> {
|
|
36
|
+
/** The schema, as for `graphql()`. */
|
|
37
|
+
readonly schema: GraphQLSchemaWithContext<SchemaCtx>;
|
|
38
|
+
/** At most this many tokens in a document, 15 000 by default, or `false`. */
|
|
39
|
+
readonly maxTokens?: number | false;
|
|
40
|
+
/** At most this many levels of `{`, `(` and `[`, 1 000 by default, or `false`. */
|
|
41
|
+
readonly maxNesting?: number | false;
|
|
42
|
+
/** The cache of parsed documents, this executor's own. `false` parses every call. */
|
|
43
|
+
readonly parseCache?: false | ParseCacheOptions;
|
|
44
|
+
}
|
|
45
|
+
/** Runs one operation in process. */
|
|
46
|
+
export type GraphQLExecutor<ServerCtx> = (request: ExecutorRequest, context: ServerCtx, call?: ExecutorCall) => Promise<ExecutorResult>;
|
|
47
|
+
/**
|
|
48
|
+
* Runs a GraphQL operation in the process, through the same Yoga setup as
|
|
49
|
+
* `graphql()` — its plugins, `maxTokens`, `maxNesting`, the parse cache, the
|
|
50
|
+
* masking of errors — with a server context the caller gives, and no HTTP
|
|
51
|
+
* route in between. For a caller that is not a browser: an MCP tool, a job.
|
|
52
|
+
* Queries and mutations only.
|
|
53
|
+
*
|
|
54
|
+
* ```ts
|
|
55
|
+
* const execute = graphqlExecutor({ schema, plugins: [useJanus(...)] });
|
|
56
|
+
* const { data, errors } = await execute(
|
|
57
|
+
* { query: '{ me { id } }' },
|
|
58
|
+
* { viewer, services },
|
|
59
|
+
* );
|
|
60
|
+
* ```
|
|
61
|
+
*
|
|
62
|
+
* It does not run `graphql()`'s middlewares: the context is whatever is
|
|
63
|
+
* passed. It keeps its own parse cache, apart from the route's.
|
|
64
|
+
*/
|
|
65
|
+
export declare function graphqlExecutor<SchemaCtx, UserCtx extends YogaContext = Empty, ServerCtx = Omit<SchemaCtx, keyof YogaInitialContext>>(options: GraphQLExecutorOptions<YogaContext, UserCtx, SchemaCtx>): GraphQLExecutor<ServerCtx>;
|
|
66
|
+
//# sourceMappingURL=executor.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EACX,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGxD,kFAAkF;AAClF,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CACnE;AAED,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACjE,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACxD;AAED,oEAAoE;AACpE,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;CAC3C;AAED,+EAA+E;AAC/E,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB,CACtC,SAAS,SAAS,WAAW,EAC7B,OAAO,SAAS,WAAW,EAC3B,SAAS,GAAG,OAAO,CAClB,SAAQ,IAAI,CACZ,iBAAiB,CAAC,SAAS,EAAE,OAAO,CAAC,EACnC,iBAAiB,GACjB,MAAM,GACN,QAAQ,GACR,UAAU,GACV,aAAa,GACb,0BAA0B,CAC5B;IACD,sCAAsC;IACtC,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC,SAAS,CAAC,CAAC;IACrD,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACpC,kFAAkF;IAClF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACrC,qFAAqF;IACrF,QAAQ,CAAC,UAAU,CAAC,EAAE,KAAK,GAAG,iBAAiB,CAAC;CAChD;AAED,qCAAqC;AACrC,MAAM,MAAM,eAAe,CAAC,SAAS,IAAI,CACxC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,SAAS,EAClB,IAAI,CAAC,EAAE,YAAY,KACf,OAAO,CAAC,cAAc,CAAC,CAAC;AAY7B;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAC9B,SAAS,EACT,OAAO,SAAS,WAAW,GAAG,KAAK,EACnC,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,kBAAkB,CAAC,EAErD,OAAO,EAAE,sBAAsB,CAAC,WAAW,EAAE,OAAO,EAAE,SAAS,CAAC,GAC9D,eAAe,CAAC,SAAS,CAAC,CAuC5B"}
|
package/dist/graphql.d.ts
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import type { Alxia, BaseContext, Empty, RoutePath } from '@alxia/core';
|
|
2
2
|
import type { GraphQLSchemaWithContext, YogaInitialContext, YogaServerOptions } from 'graphql-yoga';
|
|
3
3
|
import { type YogaContext } from './handler';
|
|
4
|
-
import {
|
|
4
|
+
import type { ParseCacheOptions } from './parse-limits';
|
|
5
5
|
import type { SandboxOptions } from './sandbox';
|
|
6
6
|
import { type GraphQLWsOptions } from './ws';
|
|
7
7
|
/** The parts of a route's context Yoga owns, or that mean nothing to a resolver. */
|
package/dist/graphql.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"graphql.d.ts","sourceRoot":"","sources":["../src/graphql.ts"],"names":[],"mappings":"AAAA,OAAO,
|
|
1
|
+
{"version":3,"file":"graphql.d.ts","sourceRoot":"","sources":["../src/graphql.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,KAAK,EACX,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,KAAK,gBAAgB,EAAiB,MAAM,MAAM,CAAC;AAG5D,oFAAoF;AACpF,KAAK,SAAS,GACX,QAAQ,GACR,OAAO,GACP,SAAS,GACT,SAAS,GACT,MAAM,GACN,OAAO,GACP,UAAU,CAAC;AAEd;;;;GAIG;AACH,MAAM,MAAM,aAAa,CAAC,GAAG,IAAI,IAAI,CAAC,WAAW,GAAG,GAAG,EAAE,SAAS,CAAC,CAAC;AAEpE;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC9D;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,KAAK,IAAI,GAAG,SAAS;IAClE,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,CAAC;CAC/B,GACE,kBAAkB,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,gBAAgB,GAAG,WAAW,GAGzE;IACC,QAAQ,CAAC,QAAQ,EAAE,qEAAqE,CAAC;CACzF,CAAC;AAEJ,MAAM,WAAW,cAAc,CAC9B,SAAS,SAAS,WAAW,EAC7B,OAAO,SAAS,WAAW,EAC3B,IAAI,SAAS,SAAS,EACtB,SAAS,GAAG,OAAO,CAClB,SAAQ,IAAI,CACZ,iBAAiB,CAAC,SAAS,EAAE,OAAO,CAAC,EACrC,iBAAiB,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAClD;IACD;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,UAAU,GAAG,gBAAgB,GAAG,KAAK,CAAC;IACrD,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAC1B,iBAAiB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,UAAU,CAAC,EACjD,OAAO,CACP,CAAC;IACF,gEAAgE;IAChE,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;IAClC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC,SAAS,CAAC,CAAC;IACrD,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,iBAAiB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;IAC9D;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAAC;IACzC;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACpC;;;;;;;OAOG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACrC;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,KAAK,GAAG,iBAAiB,CAAC;IAChD;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;GAIG;AACH,KAAK,eAAe,CAAC,QAAQ,EAAE,QAAQ,IAAI,QAAQ,SAAS,QAAQ,GACjE,OAAO,GACP;IACA,QAAQ,CAAC,MAAM,EAAE,yEAAyE,OAAO,CAChG,MAAM,QAAQ,EACd,MAAM,QAAQ,CACd,GACA,MAAM,EAAE,CAAC;CACV,CAAC;AAEJ;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CACtB,GAAG,SAAS,MAAM,EAClB,MAAM,SAAS,MAAM,EACrB,SAAS,EACT,OAAO,SAAS,WAAW,GAAG,KAAK,EACnC,KAAK,CAAC,IAAI,SAAS,SAAS,GAAG,UAAU,EAEzC,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,EACvB,OAAO,EAAE,cAAc,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,GACpE,eAAe,CACd,kBAAkB,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,OAAO,EACjD,SAAS,CACT,GACA,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CA2BpB"}
|
package/dist/index.d.ts
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
export { type BoundedStreamOptions, boundedStream } from './bounded-stream';
|
|
2
|
+
export { type ExecutorCall, type ExecutorError, type ExecutorRequest, type ExecutorResult, type GraphQLExecutor, type GraphQLExecutorOptions, graphqlExecutor, } from './executor';
|
|
2
3
|
export { type GraphQLContext, type GraphQLOptions, type GraphQLWsContext, graphql, type ServerContext, } from './graphql';
|
|
3
4
|
export { clearRequestCache, freshPerMutation, oncePerRequest, } from './once-per-request';
|
|
4
5
|
export { renderSandbox, SANDBOX_POLICY, type SandboxOptions } from './sandbox';
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,oBAAoB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EACN,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,OAAO,EACP,KAAK,aAAa,GAClB,MAAM,WAAW,CAAC;AACnB,OAAO,EACN,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,GACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAC/E,YAAY,EAAE,gBAAgB,EAAE,MAAM,MAAM,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,oBAAoB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EACN,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,eAAe,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EACN,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,OAAO,EACP,KAAK,aAAa,GAClB,MAAM,WAAW,CAAC;AACnB,OAAO,EACN,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,GACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAC/E,YAAY,EAAE,gBAAgB,EAAE,MAAM,MAAM,CAAC"}
|
package/dist/index.js
CHANGED
|
@@ -105,26 +105,8 @@ function boundedStream(source, options) {
|
|
|
105
105
|
};
|
|
106
106
|
return stream;
|
|
107
107
|
}
|
|
108
|
-
// src/
|
|
109
|
-
import {
|
|
110
|
-
isDev
|
|
111
|
-
} from "@alxia/core";
|
|
112
|
-
|
|
113
|
-
// src/endpoint.ts
|
|
114
|
-
var DEFAULT_BODY_LIMIT = 1048576;
|
|
115
|
-
function declareEndpoint(app, path, handler, bodyLimit, socket) {
|
|
116
|
-
const route = app;
|
|
117
|
-
route.get(path, handler);
|
|
118
|
-
const inherited = app.routes.at(-1)?.bodyLimit;
|
|
119
|
-
const own = bodyLimit ?? (inherited === undefined ? DEFAULT_BODY_LIMIT : undefined);
|
|
120
|
-
if (own === undefined)
|
|
121
|
-
route.post(path, handler);
|
|
122
|
-
else
|
|
123
|
-
route.post(path, { bodyLimit: own }, handler);
|
|
124
|
-
if (socket !== undefined) {
|
|
125
|
-
route.ws(socket.path, socket.middleware, socket.handlers);
|
|
126
|
-
}
|
|
127
|
-
}
|
|
108
|
+
// src/yoga.ts
|
|
109
|
+
import { isDev } from "@alxia/core";
|
|
128
110
|
|
|
129
111
|
// src/handler.ts
|
|
130
112
|
import {
|
|
@@ -628,6 +610,93 @@ function parseCaches(parseCache) {
|
|
|
628
610
|
return { documentCache, errorCache };
|
|
629
611
|
}
|
|
630
612
|
|
|
613
|
+
// src/yoga.ts
|
|
614
|
+
function yogaFor(yogaOptions, page) {
|
|
615
|
+
const { maxTokens, maxNesting, parseCache, ...rest } = yogaOptions;
|
|
616
|
+
const { cors, ide, graphiql } = page;
|
|
617
|
+
const limits = resolveLimits(maxTokens, maxNesting, parseCache, rest);
|
|
618
|
+
const shown = graphiql ?? true;
|
|
619
|
+
return yogaServers({
|
|
620
|
+
...rest,
|
|
621
|
+
...rest["logging"] === undefined ? { logging: "warn" } : {},
|
|
622
|
+
...untrustedRequestId(rest),
|
|
623
|
+
plugins: [
|
|
624
|
+
limitsParsing(limits.tokens, limits.depth),
|
|
625
|
+
...rest["plugins"] ?? [],
|
|
626
|
+
reportsOperations()
|
|
627
|
+
],
|
|
628
|
+
cors,
|
|
629
|
+
graphiql: ide === undefined ? (_request, context) => isDev(context) && shown : ide === "graphiql" ? shown : false
|
|
630
|
+
}, rest["parserAndValidationCache"] === undefined ? () => parseCaches(parseCache) : undefined);
|
|
631
|
+
}
|
|
632
|
+
function untrustedRequestId(options) {
|
|
633
|
+
const { requestId } = options;
|
|
634
|
+
if (requestId === undefined)
|
|
635
|
+
return { requestId: false };
|
|
636
|
+
if (requestId === true)
|
|
637
|
+
return { requestId: { trustHeader: false } };
|
|
638
|
+
if (typeof requestId === "object" && requestId !== null) {
|
|
639
|
+
return { requestId: { trustHeader: false, ...requestId } };
|
|
640
|
+
}
|
|
641
|
+
return {};
|
|
642
|
+
}
|
|
643
|
+
|
|
644
|
+
// src/executor.ts
|
|
645
|
+
var SUBSCRIPTION_REFUSED = {
|
|
646
|
+
errors: [
|
|
647
|
+
{
|
|
648
|
+
message: "graphqlExecutor runs queries and mutations, not a subscription.",
|
|
649
|
+
extensions: { code: "SUBSCRIPTION_NOT_SUPPORTED" }
|
|
650
|
+
}
|
|
651
|
+
]
|
|
652
|
+
};
|
|
653
|
+
function graphqlExecutor(options) {
|
|
654
|
+
const yoga = yogaFor(options, { cors: false, ide: false })("/graphql");
|
|
655
|
+
return async (request, context, call) => {
|
|
656
|
+
const response = await yoga.fetch(new Request("http://in-process/graphql", {
|
|
657
|
+
method: "POST",
|
|
658
|
+
headers: {
|
|
659
|
+
"content-type": "application/json",
|
|
660
|
+
accept: "application/json, text/event-stream"
|
|
661
|
+
},
|
|
662
|
+
body: JSON.stringify({
|
|
663
|
+
query: request.query,
|
|
664
|
+
...request.operationName !== undefined && {
|
|
665
|
+
operationName: request.operationName
|
|
666
|
+
},
|
|
667
|
+
...request.variables !== undefined && {
|
|
668
|
+
variables: request.variables
|
|
669
|
+
}
|
|
670
|
+
}),
|
|
671
|
+
...call?.signal !== undefined && { signal: call.signal }
|
|
672
|
+
}), context);
|
|
673
|
+
if (/text\/event-stream|multipart\/mixed/.test(response.headers.get("content-type") ?? "")) {
|
|
674
|
+
response.body?.cancel();
|
|
675
|
+
return SUBSCRIPTION_REFUSED;
|
|
676
|
+
}
|
|
677
|
+
const body = await response.json();
|
|
678
|
+
return {
|
|
679
|
+
...body.data !== undefined && { data: body.data },
|
|
680
|
+
...body.errors !== undefined && { errors: body.errors }
|
|
681
|
+
};
|
|
682
|
+
};
|
|
683
|
+
}
|
|
684
|
+
// src/endpoint.ts
|
|
685
|
+
var DEFAULT_BODY_LIMIT = 1048576;
|
|
686
|
+
function declareEndpoint(app, path, handler, bodyLimit, socket) {
|
|
687
|
+
const route = app;
|
|
688
|
+
route.get(path, handler);
|
|
689
|
+
const inherited = app.routes.at(-1)?.bodyLimit;
|
|
690
|
+
const own = bodyLimit ?? (inherited === undefined ? DEFAULT_BODY_LIMIT : undefined);
|
|
691
|
+
if (own === undefined)
|
|
692
|
+
route.post(path, handler);
|
|
693
|
+
else
|
|
694
|
+
route.post(path, { bodyLimit: own }, handler);
|
|
695
|
+
if (socket !== undefined) {
|
|
696
|
+
route.ws(socket.path, socket.middleware, socket.handlers);
|
|
697
|
+
}
|
|
698
|
+
}
|
|
699
|
+
|
|
631
700
|
// src/ws-operations.ts
|
|
632
701
|
import { startOperation } from "@alxia/core";
|
|
633
702
|
import { getOperationAST as getOperationAST2 } from "graphql";
|
|
@@ -831,41 +900,14 @@ function graphql(app, options) {
|
|
|
831
900
|
graphiql,
|
|
832
901
|
sandbox,
|
|
833
902
|
ws = false,
|
|
834
|
-
maxTokens,
|
|
835
|
-
maxNesting,
|
|
836
|
-
parseCache,
|
|
837
903
|
bodyLimit,
|
|
838
904
|
...yogaOptions
|
|
839
905
|
} = options;
|
|
840
|
-
const
|
|
841
|
-
const page = graphiql ?? true;
|
|
842
|
-
const yogaAt = yogaServers({
|
|
843
|
-
...yogaOptions,
|
|
844
|
-
...yogaOptions.logging === undefined ? { logging: "warn" } : {},
|
|
845
|
-
...untrustedRequestId(yogaOptions),
|
|
846
|
-
plugins: [
|
|
847
|
-
limitsParsing(limits.tokens, limits.depth),
|
|
848
|
-
...yogaOptions.plugins ?? [],
|
|
849
|
-
reportsOperations()
|
|
850
|
-
],
|
|
851
|
-
cors,
|
|
852
|
-
graphiql: ide === undefined ? (_request, context) => isDev(context) && page : ide === "graphiql" ? page : false
|
|
853
|
-
}, yogaOptions.parserAndValidationCache === undefined ? () => parseCaches(parseCache) : undefined);
|
|
906
|
+
const yogaAt = yogaFor(yogaOptions, { cors, ide, graphiql });
|
|
854
907
|
const handler = graphqlHandler(yogaAt, ide === "apollo-sandbox" ? sandbox ?? {} : false);
|
|
855
908
|
declareEndpoint(app, path, handler, bodyLimit, ws === false ? undefined : graphqlSocket(yogaAt, path, ws === true ? {} : ws));
|
|
856
909
|
return app;
|
|
857
910
|
}
|
|
858
|
-
function untrustedRequestId(options) {
|
|
859
|
-
const { requestId } = options;
|
|
860
|
-
if (requestId === undefined)
|
|
861
|
-
return { requestId: false };
|
|
862
|
-
if (requestId === true)
|
|
863
|
-
return { requestId: { trustHeader: false } };
|
|
864
|
-
if (typeof requestId === "object" && requestId !== null) {
|
|
865
|
-
return { requestId: { trustHeader: false, ...requestId } };
|
|
866
|
-
}
|
|
867
|
-
return {};
|
|
868
|
-
}
|
|
869
911
|
// src/once-per-request.ts
|
|
870
912
|
var caches = new WeakMap;
|
|
871
913
|
function oncePerRequest(request, key, load) {
|
|
@@ -915,9 +957,10 @@ export {
|
|
|
915
957
|
clearRequestCache,
|
|
916
958
|
freshPerMutation,
|
|
917
959
|
graphql,
|
|
960
|
+
graphqlExecutor,
|
|
918
961
|
oncePerRequest,
|
|
919
962
|
renderSandbox
|
|
920
963
|
};
|
|
921
964
|
|
|
922
|
-
//# debugId=
|
|
965
|
+
//# debugId=FDEC24A5238C11E064756E2164756E21
|
|
923
966
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1,10 +1,9 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
|
-
"sources": ["../src/bounded-stream.ts", "../src/
|
|
3
|
+
"sources": ["../src/bounded-stream.ts", "../src/yoga.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/executor.ts", "../src/endpoint.ts", "../src/ws-operations.ts", "../src/ws-server.ts", "../src/ws.ts", "../src/graphql.ts", "../src/once-per-request.ts"],
|
|
4
4
|
"sourcesContent": [
|
|
5
5
|
"/** What bounds a stream, and what keeps it authorized. All durations in ms. */\nexport interface BoundedStreamOptions {\n\t/** The stream ends, cleanly, after this long without an event. */\n\tidleMs: number;\n\t/** The stream ends, cleanly, this long after it began, however chatty. */\n\ttotalMs: number;\n\t/** `check` runs at least this often, also while no event comes. */\n\tcheckEveryMs: number;\n\t/**\n\t * Before an event is yielded, `check` runs when the last check is at least\n\t * this old. Default `0`: every event is checked. Raise it when events come\n\t * in bursts and one check per event would cost more than the delay of a\n\t * revocation it saves.\n\t */\n\tcheckDebounceMs?: number;\n\t/** Throws to refuse (a session that ended, a role that was lost). */\n\tcheck: () => Promise<void> | void;\n\t/** Turns what `check` (or the source) threw into the error the stream throws. Default: rethrown as is. */\n\tmapError?: (error: unknown) => unknown;\n\t/** Aborted when the client leaves: the stream ends and releases the source. */\n\tsignal?: AbortSignal;\n}\n\ntype Woke<T> =\n\t| { kind: 'read'; result: IteratorResult<T> }\n\t| { kind: 'failed'; error: unknown }\n\t| { kind: 'timer' }\n\t| { kind: 'interrupted' };\n\nconst DONE = { done: true, value: undefined } as const;\n\n/**\n * `source` bounded by an idle and a total lifetime and re-checked while it\n * lives, to return as a subscription's `subscribe` result.\n *\n * It ends, without an error, when the source ends, on the idle bound, on the\n * total bound and on `signal`'s abort. It throws `mapError(error)` (the\n * error itself by default) when `check` fails, or when the source does. The\n * source's `return()` is called at once on the consumer's `return()` (a\n * client that disconnected) and on any end, even while a read is pending: the\n * iterator is written by hand because a generator's `return()` waits behind a\n * pending `next()`. Read it one `next()` at a time, as `for await` does. No\n * timer outlives a step.\n */\nexport function boundedStream<T>(\n\tsource: AsyncIterable<T> | AsyncIterator<T>,\n\toptions: BoundedStreamOptions,\n): AsyncIterableIterator<T> {\n\tconst { idleMs, totalMs, checkEveryMs, check, signal } = options;\n\tconst debounceMs = options.checkDebounceMs ?? 0;\n\tconst mapError = options.mapError ?? ((error: unknown) => error);\n\tconst iterator: AsyncIterator<T> =\n\t\tSymbol.asyncIterator in source\n\t\t\t? (source as AsyncIterable<T>)[Symbol.asyncIterator]()\n\t\t\t: (source as AsyncIterator<T>);\n\n\tconst startedAt = Date.now();\n\tlet lastEventAt = startedAt;\n\tlet lastCheckAt = startedAt;\n\tlet finished = false;\n\tlet interrupt: (() => void) | undefined;\n\tlet pending: Promise<IteratorResult<T>> | undefined;\n\tlet released: Promise<void> | undefined;\n\n\tconst release = (): Promise<void> => {\n\t\tfinished = true;\n\t\tinterrupt?.();\n\t\treleased ??= (async () => {\n\t\t\ttry {\n\t\t\t\tawait iterator.return?.(undefined);\n\t\t\t} catch {}\n\t\t})();\n\t\treturn released;\n\t};\n\n\tconst onAbort = () => void release();\n\tif (signal?.aborted) void release();\n\telse signal?.addEventListener('abort', onAbort, { once: true });\n\tconst detach = () => signal?.removeEventListener('abort', onAbort);\n\n\tconst checked = async () => {\n\t\tawait check();\n\t\tlastCheckAt = Date.now();\n\t};\n\n\t// Waits for the source, the nearest bound or the abort, whichever is first.\n\tconst wait = (read: Promise<IteratorResult<T>>, ms: number) =>\n\t\tnew Promise<Woke<T>>((resolve) => {\n\t\t\tconst settle = (woke: Woke<T>) => {\n\t\t\t\tclearTimeout(timer);\n\t\t\t\tinterrupt = undefined;\n\t\t\t\tresolve(woke);\n\t\t\t};\n\t\t\tconst timer = setTimeout(() => settle({ kind: 'timer' }), ms);\n\t\t\tinterrupt = () => settle({ kind: 'interrupted' });\n\t\t\tread.then(\n\t\t\t\t(result) => settle({ kind: 'read', result }),\n\t\t\t\t(error: unknown) => settle({ kind: 'failed', error }),\n\t\t\t);\n\t\t});\n\n\tconst step = async (): Promise<IteratorResult<T>> => {\n\t\tfor (;;) {\n\t\t\tif (finished) return DONE;\n\t\t\tconst t = Date.now();\n\t\t\tconst left = [totalMs - (t - startedAt), idleMs - (t - lastEventAt)];\n\t\t\tif (Math.min(...left) <= 0) {\n\t\t\t\tawait release();\n\t\t\t\treturn DONE;\n\t\t\t}\n\t\t\tconst dueIn = checkEveryMs - (t - lastCheckAt);\n\t\t\tif (dueIn <= 0) {\n\t\t\t\tawait checked();\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (!pending) {\n\t\t\t\tpending = iterator.next();\n\t\t\t\tpending.catch(() => {});\n\t\t\t}\n\t\t\tconst woke = await wait(pending, Math.max(1, Math.min(dueIn, ...left)));\n\t\t\tif (woke.kind === 'interrupted') {\n\t\t\t\tawait release();\n\t\t\t\treturn DONE;\n\t\t\t}\n\t\t\tif (woke.kind === 'timer') continue;\n\t\t\tpending = undefined;\n\t\t\tif (woke.kind === 'failed') throw woke.error;\n\t\t\tif (woke.result.done) {\n\t\t\t\tawait release();\n\t\t\t\treturn DONE;\n\t\t\t}\n\t\t\tlastEventAt = Date.now();\n\t\t\tif (lastEventAt - lastCheckAt >= debounceMs) await checked();\n\t\t\tif (finished) return DONE;\n\t\t\treturn { done: false, value: woke.result.value };\n\t\t}\n\t};\n\n\tconst stream: AsyncIterableIterator<T> = {\n\t\t[Symbol.asyncIterator]: () => stream,\n\t\tnext: async () => {\n\t\t\ttry {\n\t\t\t\tconst result = await step();\n\t\t\t\tif (result.done) detach();\n\t\t\t\treturn result;\n\t\t\t} catch (error) {\n\t\t\t\tawait release();\n\t\t\t\tdetach();\n\t\t\t\tthrow mapError(error);\n\t\t\t}\n\t\t},\n\t\treturn: async () => {\n\t\t\tawait release();\n\t\t\tdetach();\n\t\t\treturn DONE;\n\t\t},\n\t};\n\treturn stream;\n}\n",
|
|
6
|
-
"import {
|
|
7
|
-
"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: a limit an earlier\n\t// `bodyLimit()` gives it is the one the POST keeps, and core refuses a\n\t// declared oversize body where that `bodyLimit()` stands, so the POST\n\t// passes no option of its own then (a route's own option would move the\n\t// refusal to the head of its steps).\n\tconst inherited = app.routes.at(-1)?.bodyLimit;\n\tconst own =\n\t\tbodyLimit ?? (inherited === undefined ? DEFAULT_BODY_LIMIT : undefined);\n\tif (own === undefined) route.post(path, handler);\n\telse route.post(path, { bodyLimit: own }, handler);\n\tif (socket !== undefined) {\n\t\troute.ws(socket.path, socket.middleware, socket.handlers);\n\t}\n}\n",
|
|
6
|
+
"import { isDev } from '@alxia/core';\nimport type { YogaServerOptions } from 'graphql-yoga';\nimport { type YogaContext, yogaServers } from './handler';\nimport { reportsOperations } from './operation';\nimport {\n\tlimitsParsing,\n\ttype ParseCacheOptions,\n\tparseCaches,\n\tresolveLimits,\n} from './parse-limits';\n\n/**\n * The Yoga behind an endpoint, from the options `graphql()` and\n * `graphqlExecutor()` share: the limits, the parse cache, the logging and\n * request id defaults, and `reportsOperations`. One Yoga per path.\n */\nexport function yogaFor<UserCtx extends YogaContext>(\n\tyogaOptions: object,\n\tpage: {\n\t\treadonly cors: unknown;\n\t\treadonly ide?: 'graphiql' | 'apollo-sandbox' | false | undefined;\n\t\treadonly graphiql?: unknown | undefined;\n\t},\n) {\n\tconst { maxTokens, maxNesting, parseCache, ...rest } = yogaOptions as Record<\n\t\tstring,\n\t\tany\n\t> & {\n\t\treadonly maxTokens?: number | false;\n\t\treadonly maxNesting?: number | false;\n\t\treadonly parseCache?: false | ParseCacheOptions;\n\t};\n\tconst { cors, ide, graphiql } = page;\n\tconst limits = resolveLimits(maxTokens, maxNesting, parseCache, rest);\n\tconst shown = graphiql ?? true;\n\treturn yogaServers<UserCtx>(\n\t\t{\n\t\t\t...(rest as YogaServerOptions<YogaContext, UserCtx>),\n\t\t\t...(rest['logging'] === undefined ? { logging: 'warn' } : {}),\n\t\t\t...untrustedRequestId(rest),\n\t\t\tplugins: [\n\t\t\t\tlimitsParsing(limits.tokens, limits.depth),\n\t\t\t\t...(rest['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) && shown\n\t\t\t\t: ide === 'graphiql'\n\t\t\t\t\t? shown\n\t\t\t\t\t: false) as YogaServerOptions<YogaContext, UserCtx>['graphiql'],\n\t\t} as never,\n\t\trest['parserAndValidationCache'] === undefined\n\t\t\t? () => parseCaches(parseCache)\n\t\t\t: undefined,\n\t);\n}\n\n/**\n * Yoga 6 reads the client's `x-request-id`, answers with it and tags its\n * logger with it: log forging. Off by default (the app issues its own id);\n * an app that turns Yoga's id on keeps `trustHeader: false` unless it sets it.\n */\nfunction untrustedRequestId(options: object): object {\n\tconst { requestId } = options as { requestId?: unknown };\n\tif (requestId === undefined) return { requestId: false };\n\tif (requestId === true) return { requestId: { trustHeader: false } };\n\tif (typeof requestId === 'object' && requestId !== null) {\n\t\treturn { requestId: { trustHeader: false, ...requestId } };\n\t}\n\treturn {};\n}\n",
|
|
8
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",
|
|
9
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",
|
|
10
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",
|
|
@@ -12,12 +11,15 @@
|
|
|
12
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",
|
|
13
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",
|
|
14
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",
|
|
14
|
+
"import type { Empty } from '@alxia/core';\nimport type {\n\tGraphQLSchemaWithContext,\n\tYogaInitialContext,\n\tYogaServerOptions,\n} from 'graphql-yoga';\nimport type { YogaContext } from './handler';\nimport type { ParseCacheOptions } from './parse-limits';\nimport { yogaFor } from './yoga';\n\n/** What an in-process call asks for: a GraphQL-over-HTTP request's parameters. */\nexport interface ExecutorRequest {\n\treadonly query: string;\n\treadonly operationName?: string | undefined;\n\treadonly variables?: Readonly<Record<string, unknown>> | undefined;\n}\n\n/** A plain, JSON-shaped error, as the route answers it. */\nexport interface ExecutorError {\n\treadonly message: string;\n\treadonly path?: readonly (string | number)[];\n\treadonly locations?: readonly { line: number; column: number }[];\n\treadonly extensions?: Readonly<Record<string, unknown>>;\n}\n\n/** The answer: `data` and `errors`, as the endpoint's JSON body. */\nexport interface ExecutorResult {\n\treadonly data?: unknown;\n\treadonly errors?: readonly ExecutorError[];\n}\n\n/** Per call: the signal that stops the operation, as a client leaving does. */\nexport interface ExecutorCall {\n\treadonly signal?: AbortSignal;\n}\n\n/**\n * The options of `graphqlExecutor()`: those of `graphql()` that mean\n * something without a route. Put an HTTP-only plugin (a client-header\n * check, `cache-control`) in the route's list and not here.\n */\nexport interface GraphQLExecutorOptions<\n\tServerCtx extends YogaContext,\n\tUserCtx extends YogaContext,\n\tSchemaCtx = unknown,\n> extends Omit<\n\t\tYogaServerOptions<ServerCtx, UserCtx>,\n\t\t| 'graphqlEndpoint'\n\t\t| 'cors'\n\t\t| 'schema'\n\t\t| 'graphiql'\n\t\t| 'landingPage'\n\t\t| 'parserAndValidationCache'\n\t> {\n\t/** The schema, as for `graphql()`. */\n\treadonly schema: GraphQLSchemaWithContext<SchemaCtx>;\n\t/** At most this many tokens in a document, 15 000 by default, or `false`. */\n\treadonly maxTokens?: number | false;\n\t/** At most this many levels of `{`, `(` and `[`, 1 000 by default, or `false`. */\n\treadonly maxNesting?: number | false;\n\t/** The cache of parsed documents, this executor's own. `false` parses every call. */\n\treadonly parseCache?: false | ParseCacheOptions;\n}\n\n/** Runs one operation in process. */\nexport type GraphQLExecutor<ServerCtx> = (\n\trequest: ExecutorRequest,\n\tcontext: ServerCtx,\n\tcall?: ExecutorCall,\n) => Promise<ExecutorResult>;\n\nconst SUBSCRIPTION_REFUSED: ExecutorResult = {\n\terrors: [\n\t\t{\n\t\t\tmessage:\n\t\t\t\t'graphqlExecutor runs queries and mutations, not a subscription.',\n\t\t\textensions: { code: 'SUBSCRIPTION_NOT_SUPPORTED' },\n\t\t},\n\t],\n};\n\n/**\n * Runs a GraphQL operation in the process, through the same Yoga setup as\n * `graphql()` — its plugins, `maxTokens`, `maxNesting`, the parse cache, the\n * masking of errors — with a server context the caller gives, and no HTTP\n * route in between. For a caller that is not a browser: an MCP tool, a job.\n * Queries and mutations only.\n *\n * ```ts\n * const execute = graphqlExecutor({ schema, plugins: [useJanus(...)] });\n * const { data, errors } = await execute(\n * { query: '{ me { id } }' },\n * { viewer, services },\n * );\n * ```\n *\n * It does not run `graphql()`'s middlewares: the context is whatever is\n * passed. It keeps its own parse cache, apart from the route's.\n */\nexport function graphqlExecutor<\n\tSchemaCtx,\n\tUserCtx extends YogaContext = Empty,\n\tServerCtx = Omit<SchemaCtx, keyof YogaInitialContext>,\n>(\n\toptions: GraphQLExecutorOptions<YogaContext, UserCtx, SchemaCtx>,\n): GraphQLExecutor<ServerCtx> {\n\tconst yoga = yogaFor<UserCtx>(options, { cors: false, ide: false })(\n\t\t'/graphql',\n\t);\n\treturn async (request, context, call) => {\n\t\tconst response = await yoga.fetch(\n\t\t\tnew Request('http://in-process/graphql', {\n\t\t\t\tmethod: 'POST',\n\t\t\t\theaders: {\n\t\t\t\t\t'content-type': 'application/json',\n\t\t\t\t\taccept: 'application/json, text/event-stream',\n\t\t\t\t},\n\t\t\t\tbody: JSON.stringify({\n\t\t\t\t\tquery: request.query,\n\t\t\t\t\t...(request.operationName !== undefined && {\n\t\t\t\t\t\toperationName: request.operationName,\n\t\t\t\t\t}),\n\t\t\t\t\t...(request.variables !== undefined && {\n\t\t\t\t\t\tvariables: request.variables,\n\t\t\t\t\t}),\n\t\t\t\t}),\n\t\t\t\t...(call?.signal !== undefined && { signal: call.signal }),\n\t\t\t}),\n\t\t\tcontext as never,\n\t\t);\n\t\tif (\n\t\t\t/text\\/event-stream|multipart\\/mixed/.test(\n\t\t\t\tresponse.headers.get('content-type') ?? '',\n\t\t\t)\n\t\t) {\n\t\t\tvoid response.body?.cancel();\n\t\t\treturn SUBSCRIPTION_REFUSED;\n\t\t}\n\t\tconst body = (await response.json()) as ExecutorResult;\n\t\treturn {\n\t\t\t...(body.data !== undefined && { data: body.data }),\n\t\t\t...(body.errors !== undefined && { errors: body.errors }),\n\t\t};\n\t};\n}\n",
|
|
15
|
+
"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: a limit an earlier\n\t// `bodyLimit()` gives it is the one the POST keeps, and core refuses a\n\t// declared oversize body where that `bodyLimit()` stands, so the POST\n\t// passes no option of its own then (a route's own option would move the\n\t// refusal to the head of its steps).\n\tconst inherited = app.routes.at(-1)?.bodyLimit;\n\tconst own =\n\t\tbodyLimit ?? (inherited === undefined ? DEFAULT_BODY_LIMIT : undefined);\n\tif (own === undefined) route.post(path, handler);\n\telse route.post(path, { bodyLimit: own }, handler);\n\tif (socket !== undefined) {\n\t\troute.ws(socket.path, socket.middleware, socket.handlers);\n\t}\n}\n",
|
|
15
16
|
"/**\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",
|
|
16
17
|
"/**\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",
|
|
17
18
|
"/**\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",
|
|
19
|
+
"import type { Alxia, BaseContext, Empty, RoutePath } from '@alxia/core';\nimport type {\n\tGraphQLSchemaWithContext,\n\tYogaInitialContext,\n\tYogaServerOptions,\n} from 'graphql-yoga';\nimport { declareEndpoint } from './endpoint';\nimport { graphqlHandler, type YogaContext } from './handler';\nimport type { ParseCacheOptions } from './parse-limits';\nimport type { SandboxOptions } from './sandbox';\nimport { type GraphQLWsOptions, graphqlSocket } from './ws';\nimport { yogaFor } from './yoga';\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\tbodyLimit,\n\t\t...yogaOptions\n\t} = options;\n\tconst yogaAt = yogaFor<UserCtx>(yogaOptions, { cors, ide, graphiql });\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",
|
|
18
20
|
"const caches = new WeakMap<object, Map<string, unknown>>();\n\n/**\n * A value loaded at most once per request and key. `request` is any object\n * that lives as long as the request (the resolvers' context); the cache is\n * released with it. A `load` that throws, or returns a promise that rejects,\n * is not kept, so the next call tries again.\n */\nexport function oncePerRequest<T>(\n\trequest: object,\n\tkey: string,\n\tload: () => T,\n): T {\n\tlet cache = caches.get(request);\n\tif (!cache) {\n\t\tcache = new Map();\n\t\tcaches.set(request, cache);\n\t}\n\tif (cache.has(key)) return cache.get(key) as T;\n\tconst loaded = load();\n\tcache.set(key, loaded);\n\tif (loaded instanceof Promise) {\n\t\tconst mine = cache;\n\t\tloaded.catch(() => {\n\t\t\tif (mine.get(key) === loaded) mine.delete(key);\n\t\t});\n\t}\n\treturn loaded;\n}\n\n/**\n * Forgets what `oncePerRequest` kept for this request, so the next call for\n * any key loads again. A call to `oncePerRequest` already in flight keeps its\n * own value; only later calls see the empty cache.\n */\nexport function clearRequestCache(request: object): void {\n\tcaches.delete(request);\n}\n\n/**\n * A mutation's root fields run one after the other in one request, and one\n * may change what a later one reads. `freshPerMutation(resolvers)` returns\n * the resolvers with every function of `Mutation` wrapped to call\n * `clearRequestCache(context)` before it runs: each root mutation field starts\n * with an empty cache, its own sub-fields share it, and a query (no wrapped\n * field) keeps one cache for the whole request. Other types are untouched.\n */\nexport function freshPerMutation<R extends object>(resolvers: R): R {\n\tconst mutation = (resolvers as { Mutation?: unknown }).Mutation as\n\t\t| Record<string, unknown>\n\t\t| undefined;\n\tif (!mutation) return resolvers;\n\tconst wrapped: Record<string, unknown> = {};\n\tfor (const [name, field] of Object.entries(mutation)) {\n\t\tif (typeof field !== 'function') {\n\t\t\twrapped[name] = field;\n\t\t\tcontinue;\n\t\t}\n\t\twrapped[name] = function (\n\t\t\tthis: unknown,\n\t\t\tparent: unknown,\n\t\t\targs: unknown,\n\t\t\tcontext: unknown,\n\t\t\tinfo: unknown,\n\t\t) {\n\t\t\tif (typeof context === 'object' && context !== null) {\n\t\t\t\tclearRequestCache(context);\n\t\t\t}\n\t\t\treturn field.call(this, parent, args, context, info);\n\t\t};\n\t}\n\treturn { ...resolvers, Mutation: wrapped };\n}\n"
|
|
19
21
|
],
|
|
20
|
-
"mappings": "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",
|
|
21
|
-
"debugId": "
|
|
22
|
+
"mappings": "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",
|
|
23
|
+
"debugId": "FDEC24A5238C11E064756E2164756E21",
|
|
22
24
|
"names": []
|
|
23
25
|
}
|
package/dist/yoga.d.ts
ADDED
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import { type YogaContext } from './handler';
|
|
2
|
+
/**
|
|
3
|
+
* The Yoga behind an endpoint, from the options `graphql()` and
|
|
4
|
+
* `graphqlExecutor()` share: the limits, the parse cache, the logging and
|
|
5
|
+
* request id defaults, and `reportsOperations`. One Yoga per path.
|
|
6
|
+
*/
|
|
7
|
+
export declare function yogaFor<UserCtx extends YogaContext>(yogaOptions: object, page: {
|
|
8
|
+
readonly cors: unknown;
|
|
9
|
+
readonly ide?: 'graphiql' | 'apollo-sandbox' | false | undefined;
|
|
10
|
+
readonly graphiql?: unknown | undefined;
|
|
11
|
+
}): (endpoint: string) => import("graphql-yoga").YogaServerInstance<YogaContext, UserCtx>;
|
|
12
|
+
//# sourceMappingURL=yoga.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"yoga.d.ts","sourceRoot":"","sources":["../src/yoga.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,WAAW,EAAe,MAAM,WAAW,CAAC;AAS1D;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,OAAO,SAAS,WAAW,EAClD,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE;IACL,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,UAAU,GAAG,gBAAgB,GAAG,KAAK,GAAG,SAAS,CAAC;IACjE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACxC,yFAkCD"}
|
package/docs/README.md
CHANGED
|
@@ -12,6 +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 a value loaded once per request (`oncePerRequest`, emptied per root mutation field by `freshPerMutation`), 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, bounding them with `boundedStream`, 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
|
+
| [Running operations in process](guide/executor.md) | calling the schema from an MCP tool, a job or a script with `graphqlExecutor`: the same plugins, limits and error masking as the route, a server context you pass, a signal, what it leaves out |
|
|
15
16
|
| [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
17
|
| [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
18
|
| [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 |
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
# Running operations in process
|
|
2
|
+
|
|
3
|
+
`graphqlExecutor(options)` runs a query or a mutation inside the process,
|
|
4
|
+
without a route or a socket. Use it when the caller is not a browser: an MCP
|
|
5
|
+
tool that serves GraphQL to a model, a background job, a script. It builds the
|
|
6
|
+
same Yoga as `graphql()` from the same options, so the plugins, the token and
|
|
7
|
+
nesting limits, the parse cache and the masking of errors apply as they do on
|
|
8
|
+
the route. The server context is the one you pass.
|
|
9
|
+
|
|
10
|
+
```ts
|
|
11
|
+
import { graphqlExecutor } from '@alxia/graphql';
|
|
12
|
+
|
|
13
|
+
const execute = graphqlExecutor({
|
|
14
|
+
schema,
|
|
15
|
+
plugins: [useAuth()], // the route's plugins, minus the HTTP-only ones
|
|
16
|
+
maxTokens: 5_000,
|
|
17
|
+
logging: 'warn',
|
|
18
|
+
});
|
|
19
|
+
|
|
20
|
+
const { data, errors } = await execute(
|
|
21
|
+
{
|
|
22
|
+
query: 'query ($id: ID!) { user(id: $id) { name } }',
|
|
23
|
+
variables: { id: '1' },
|
|
24
|
+
},
|
|
25
|
+
{ viewer, services }, // what a resolver reads as its context
|
|
26
|
+
{ signal }, // optional: stops the operation, as a client leaving does
|
|
27
|
+
);
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
## What it takes
|
|
31
|
+
|
|
32
|
+
| Argument | |
|
|
33
|
+
| --- | --- |
|
|
34
|
+
| `request` | `{ query, operationName?, variables? }` |
|
|
35
|
+
| `context` | the server context: what the resolvers read, in place of what the app's middlewares would have built. Typed by `graphqlExecutor<ServerCtx>` |
|
|
36
|
+
| `call.signal` | an `AbortSignal` that stops the operation |
|
|
37
|
+
|
|
38
|
+
It answers `{ data?, errors? }`, plain JSON as the endpoint's body would be:
|
|
39
|
+
a GraphQL error is in `errors`, not thrown. A rejected `signal` rejects the
|
|
40
|
+
promise.
|
|
41
|
+
|
|
42
|
+
## Its options
|
|
43
|
+
|
|
44
|
+
`schema`, `plugins`, `maskedErrors` (on by default), `maxTokens` (15 000),
|
|
45
|
+
`maxNesting` (1 000), `parseCache` (64 MiB, 1 024 documents, one hour; `false`
|
|
46
|
+
for none), `logging` and Yoga's other options. Not `path`, `ide`, `ws`, `bodyLimit` or
|
|
47
|
+
`cors`: they belong to a route.
|
|
48
|
+
|
|
49
|
+
## What it does not do
|
|
50
|
+
|
|
51
|
+
- It does not run the app's middlewares (`use(...)`): the context is what you
|
|
52
|
+
pass. Build it as the middlewares would.
|
|
53
|
+
- A plugin that only makes sense over HTTP (a check of a client header,
|
|
54
|
+
`cache-control: no-store`) goes in the route's `plugins` and not in the
|
|
55
|
+
executor's. Share the rest in one array.
|
|
56
|
+
- It runs queries and mutations. A subscription is answered with an error
|
|
57
|
+
whose code is `SUBSCRIPTION_NOT_SUPPORTED`.
|
|
58
|
+
- Its parse cache is its own, apart from the route's.
|
|
59
|
+
|
|
60
|
+
See also: [Yoga's plugins and options](yoga.md), [the typed context](context.md).
|
package/docs/roadmap.md
CHANGED
|
@@ -27,6 +27,7 @@ Nothing scheduled yet.
|
|
|
27
27
|
|
|
28
28
|
### Unreleased
|
|
29
29
|
|
|
30
|
+
- **`graphqlExecutor(options)`.** A query or a mutation run in process through the same Yoga setup as `graphql()` (plugins, token and nesting limits, parse cache, error masking), with a server context the caller gives, for an MCP tool or a job ([guide](guide/executor.md)).
|
|
30
31
|
- **A client's `x-request-id` is never believed on Yoga 6.** The endpoint turns Yoga's request id off (`requestId: false`), so the header is neither echoed nor logged; an app that turns it on keeps `trustHeader: false`. Yoga 6's per-request "Request processed" INFO line is off by default too: `logging` defaults to `'warn'` ([troubleshooting](troubleshooting.md#x-request-id-echoed-or-request-processed-logged-on-yoga-6)).
|
|
31
32
|
- **`graphql-yoga` 6 accepted as a peer.** The range is `^5.16.0 || ^6.0.0`; CI runs the specs on both majors. A custom `logging` on Yoga 6 must be a `@graphql-hive/logger` `Logger` ([troubleshooting](troubleshooting.md#logchild-is-not-a-function)).
|
|
32
33
|
|
package/docs/troubleshooting.md
CHANGED
|
@@ -37,6 +37,7 @@ symptom.
|
|
|
37
37
|
- [`405 {"errors":[{"message":"Can only perform a mutation operation from a POST request."}]}`](#405-errorsmessagecan-only-perform-a-mutation-operation-from-a-post-request)
|
|
38
38
|
- [`406` with an empty body](#406-with-an-empty-body)
|
|
39
39
|
- [`413 {"error":"content_too_large", …}`](#413-errorcontent_too_large--on-post-graphql)
|
|
40
|
+
- [`graphqlExecutor runs queries and mutations, not a subscription.`](#graphqlexecutor-runs-queries-and-mutations-not-a-subscription)
|
|
40
41
|
- [`Syntax Error: Document contains more than 15000 tokens. Parsing aborted.`](#syntax-error-document-contains-more-than-15000-tokens-parsing-aborted)
|
|
41
42
|
- [`Syntax Error: Document is nested more than 1000 levels deep. Parsing aborted.`](#syntax-error-document-is-nested-more-than-1000-levels-deep-parsing-aborted)
|
|
42
43
|
- [`Syntax Error: Document is nested too deeply to parse.`](#syntax-error-document-is-nested-too-deeply-to-parse)
|
|
@@ -324,6 +325,19 @@ graphql(app, { schema, parseCache: { maxBytes: 16 * 1024 * 1024 } });
|
|
|
324
325
|
|
|
325
326
|
## Responses
|
|
326
327
|
|
|
328
|
+
### `graphqlExecutor runs queries and mutations, not a subscription.`
|
|
329
|
+
|
|
330
|
+
**When:** `graphqlExecutor(...)` is given a document whose operation is a
|
|
331
|
+
subscription; the answer is `{ errors: [{ extensions: { code:
|
|
332
|
+
'SUBSCRIPTION_NOT_SUPPORTED' } }] }`.
|
|
333
|
+
|
|
334
|
+
**Why:** the executor answers once, with the endpoint's JSON body. A
|
|
335
|
+
subscription streams.
|
|
336
|
+
|
|
337
|
+
**Fix:** serve the subscription through `graphql(app, { schema })` (SSE, or
|
|
338
|
+
`ws: true`), and use the executor for queries and mutations
|
|
339
|
+
([guide](guide/executor.md)).
|
|
340
|
+
|
|
327
341
|
### `Syntax Error: Document contains more than 15000 tokens. Parsing aborted.`
|
|
328
342
|
|
|
329
343
|
**When:** a query is answered with `GRAPHQL_PARSE_FAILED` (400 under
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@alxia/graphql",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.14.0",
|
|
4
4
|
"description": "GraphQL for alxia with GraphQL Yoga: its plugins, subscriptions over SSE or WebSocket (graphql-ws) and GraphiQL, behind the app's hooks, its resolvers reading the app's typed context",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|