@alxia/graphql 0.8.0 → 0.8.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/docs/roadmap.md +27 -20
  2. package/package.json +6 -6
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
- - **GraphiQL in dev alone, under a pinned policy.** Without `ide`, a
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.0",
3
+ "version": "0.8.2",
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.1",
51
- "@alxia/logger": "^0.6.6",
52
- "@alxia/telemetry": "^0.7.3",
50
+ "@alxia/core": "^0.15.0",
51
+ "@alxia/logger": "^0.6.7",
52
+ "@alxia/telemetry": "^0.7.5",
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.1",
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.1",
64
+ "@alxia/core": "^0.15.0",
65
65
  "graphql": "^16.11.0 || ^17.0.0",
66
66
  "graphql-ws": "^6.1.0",
67
67
  "graphql-yoga": "^5.16.0",