@alxia/graphql 0.8.0 → 0.8.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/docs/roadmap.md +27 -20
- package/package.json +5 -5
package/docs/roadmap.md
CHANGED
|
@@ -7,26 +7,7 @@ number on it. Every release, with each change it made, is in
|
|
|
7
7
|
|
|
8
8
|
## Now
|
|
9
9
|
|
|
10
|
-
|
|
11
|
-
browser gets GraphiQL only while the serving app is in dev
|
|
12
|
-
(`NODE_ENV=development`, or `alxia({ dev: true })`); `ide: 'graphiql'`
|
|
13
|
-
serves it everywhere. Its `Content-Security-Policy` allows the one
|
|
14
|
-
pinned `@graphql-yoga/graphiql` folder it loads from, the Monaco workers
|
|
15
|
-
included, and no frame ([IDE guide](guide/ide.md)).
|
|
16
|
-
- **Subscriptions drained on shutdown.** When the app starts shutting
|
|
17
|
-
down — `SIGTERM`, `SIGINT`, `stop()` — a subscription over server-sent
|
|
18
|
-
events ends, so `@alxia/core`'s drain answers the queries in flight and
|
|
19
|
-
exits without waiting for it; `health()` probes mount beside the
|
|
20
|
-
endpoint, and GraphQL errors stay in `errors[]` under core's problem
|
|
21
|
-
details ([endpoint guide](guide/endpoint.md#errors-health-and-shutdown)).
|
|
22
|
-
- **GraphQL over WebSocket.** `ws: true` serves the endpoint over
|
|
23
|
-
WebSocket too, with the `graphql-transport-ws` protocol of `graphql-ws`
|
|
24
|
-
— Apollo Client's and urql's default — beside server-sent events: the
|
|
25
|
-
upgrade runs the app's middlewares, so a guard refuses the socket and a
|
|
26
|
-
resolver reads what they added; each operation runs through Yoga's
|
|
27
|
-
plugins, with the client's `connectionParams` in its context; a
|
|
28
|
-
shutdown closes the sockets with 1001 and completes their subscriptions
|
|
29
|
-
([WebSocket guide](guide/websockets.md)).
|
|
10
|
+
Nothing in progress.
|
|
30
11
|
|
|
31
12
|
## Next
|
|
32
13
|
|
|
@@ -60,6 +41,32 @@ Nothing scheduled yet.
|
|
|
60
41
|
|
|
61
42
|
- **The operation, told to the observers.** Each operation the endpoint executes is reported to the middlewares around it: `@alxia/logger` writes `operationName` and `operationType` on the request's line, `@alxia/telemetry` names its span `query GetNotes` with `graphql.operation.name` and `graphql.operation.type`. A batched body is one line and one span, `batch`, with every name ([endpoint guide](guide/endpoint.md#the-operation-in-the-log-and-the-trace)).
|
|
62
43
|
|
|
44
|
+
### 0.4.0
|
|
45
|
+
|
|
46
|
+
- **GraphQL over WebSocket.** `ws: true` serves the endpoint over
|
|
47
|
+
WebSocket too, with the `graphql-transport-ws` protocol of `graphql-ws`
|
|
48
|
+
— Apollo Client's and urql's default — beside server-sent events: the
|
|
49
|
+
upgrade runs the app's middlewares, so a guard refuses the socket and a
|
|
50
|
+
resolver reads what they added; each operation runs through Yoga's
|
|
51
|
+
plugins, with the client's `connectionParams` in its context; a
|
|
52
|
+
shutdown closes the sockets with 1001 and completes their subscriptions
|
|
53
|
+
([WebSocket guide](guide/websockets.md)).
|
|
54
|
+
|
|
55
|
+
### 0.3.0
|
|
56
|
+
|
|
57
|
+
- **GraphiQL in dev alone, under a pinned policy.** Without `ide`, a
|
|
58
|
+
browser gets GraphiQL only while the serving app is in dev
|
|
59
|
+
(`NODE_ENV=development`, or `alxia({ dev: true })`); `ide: 'graphiql'`
|
|
60
|
+
serves it everywhere. Its `Content-Security-Policy` allows the one
|
|
61
|
+
pinned `@graphql-yoga/graphiql` folder it loads from, the Monaco workers
|
|
62
|
+
included, and no frame ([IDE guide](guide/ide.md)).
|
|
63
|
+
- **Subscriptions drained on shutdown.** When the app starts shutting
|
|
64
|
+
down — `SIGTERM`, `SIGINT`, `stop()` — a subscription over server-sent
|
|
65
|
+
events ends, so `@alxia/core`'s drain answers the queries in flight and
|
|
66
|
+
exits without waiting for it; `health()` probes mount beside the
|
|
67
|
+
endpoint, and GraphQL errors stay in `errors[]` under core's problem
|
|
68
|
+
details ([endpoint guide](guide/endpoint.md#errors-health-and-shutdown)).
|
|
69
|
+
|
|
63
70
|
### 0.1.0
|
|
64
71
|
|
|
65
72
|
- **GraphQL Yoga as a route.** `graphql(app, options)` serves a schema at
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@alxia/graphql",
|
|
3
|
-
"version": "0.8.
|
|
3
|
+
"version": "0.8.1",
|
|
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",
|
|
@@ -47,13 +47,13 @@
|
|
|
47
47
|
]
|
|
48
48
|
},
|
|
49
49
|
"devDependencies": {
|
|
50
|
-
"@alxia/core": "^0.14.
|
|
50
|
+
"@alxia/core": "^0.14.2",
|
|
51
51
|
"@alxia/logger": "^0.6.6",
|
|
52
|
-
"@alxia/telemetry": "^0.7.
|
|
52
|
+
"@alxia/telemetry": "^0.7.4",
|
|
53
53
|
"@envelop/depth-limit": "^7.2.1",
|
|
54
54
|
"@graphql-yoga/plugin-csrf-prevention": "^3.24.2",
|
|
55
55
|
"@graphql-yoga/plugin-persisted-operations": "^3.24.2",
|
|
56
|
-
"@nxgt/telemetry": "^0.2.
|
|
56
|
+
"@nxgt/telemetry": "^0.2.2",
|
|
57
57
|
"@types/bun": "^1.4.2",
|
|
58
58
|
"dataloader": "^2.2.3",
|
|
59
59
|
"graphql": "^16.11.0",
|
|
@@ -61,7 +61,7 @@
|
|
|
61
61
|
"graphql-yoga": "^5.16.0"
|
|
62
62
|
},
|
|
63
63
|
"peerDependencies": {
|
|
64
|
-
"@alxia/core": "^0.14.
|
|
64
|
+
"@alxia/core": "^0.14.2",
|
|
65
65
|
"graphql": "^16.11.0 || ^17.0.0",
|
|
66
66
|
"graphql-ws": "^6.1.0",
|
|
67
67
|
"graphql-yoga": "^5.16.0",
|