@reventlessdev/reventless-graphql-server 1.0.0-alpha.2 → 1.0.0-alpha.3

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/CHANGELOG.md CHANGED
@@ -3,6 +3,14 @@
3
3
  All notable changes to this project will be documented in this file.
4
4
  See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
5
5
 
6
+ # 1.0.0-alpha.3 (2026-07-11)
7
+
8
+ **Note:** Version bump only for package @reventlessdev/reventless-graphql-server
9
+
10
+
11
+
12
+
13
+
6
14
  # 1.0.0-alpha.2 (2026-07-11)
7
15
 
8
16
  **Note:** Version bump only for package @reventlessdev/reventless-graphql-server
package/README.md ADDED
@@ -0,0 +1,68 @@
1
+ [![npm](https://img.shields.io/npm/v/@reventlessdev/reventless-graphql-server.svg?label=npm)](https://www.npmjs.com/package/@reventlessdev/reventless-graphql-server)
2
+ [![License: Apache-2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
3
+ [![Docs](https://img.shields.io/badge/docs-reventless.dev-blue)](https://docs.reventless.dev)
4
+
5
+ # @reventlessdev/reventless-graphql-server
6
+
7
+ > ⚠️ **Alpha.** APIs and on-disk formats can change without notice between releases.
8
+ > Pin exact versions and expect breaking changes.
9
+
10
+ A **transport-neutral GraphQL server runtime** shared across
11
+ [Reventless](https://docs.reventless.dev) — a spec-driven, event-sourced CQRS
12
+ framework written in [ReScript](https://rescript-lang.org). It stands up
13
+ [Yoga](https://the-guild.dev/graphql/yoga-server)-backed GraphQL servers from
14
+ stitched SDL fragments plus a resolver map, with an optional `graphql-ws`
15
+ WebSocket endpoint and a subscription fan-out bridge over a pluggable PubSub
16
+ backend.
17
+
18
+ ## What it provides
19
+
20
+ Two ReScript modules:
21
+
22
+ - **`GraphQL_ServerInstance`** — a server-instance factory. Each instance keeps an
23
+ isolated registry, so a backend can stand up one or more independent servers
24
+ from SDL fragments + a resolver dict, exposed over HTTP with an optional
25
+ `graphql-ws` WebSocket transport for subscriptions. Includes registry
26
+ diagnostics (registered type/field/resolver inventories and SDL-vs-resolver
27
+ mismatch reporting).
28
+ - **`GraphQL_SubscriptionBridge`** — transport-neutral wiring between a server
29
+ instance and a PubSub backend for `graphql-ws` fan-out. The topic vocabulary is
30
+ fixed to core's generated subscription SDL (raw event-stream and state-changed
31
+ fields), but the PubSub instance is a *parameter*: an in-process server passes
32
+ `createPubSub()`, a multi-process gateway passes a cross-process implementation
33
+ of the same interface.
34
+
35
+ ## Where it fits
36
+
37
+ `reventless-graphql-server` builds on
38
+ [`@reventlessdev/reventless-core`](https://www.npmjs.com/package/@reventlessdev/reventless-core)
39
+ (for the subscription-schema topic vocabulary and logging) and the framework's
40
+ `graphql-yoga` bindings. It is the reusable serving layer that storage/deployment
41
+ adapters and local platforms wire their generated schema and resolvers into; it
42
+ holds no domain or storage logic of its own.
43
+
44
+ ## Install
45
+
46
+ ```bash
47
+ pnpm add @reventlessdev/reventless-graphql-server
48
+ ```
49
+
50
+ Register it as a ReScript dependency in `rescript.json`:
51
+
52
+ ```json
53
+ {
54
+ "dependencies": ["@reventlessdev/reventless-graphql-server"]
55
+ }
56
+ ```
57
+
58
+ Requires ReScript `^12.3.0` (peer dependency).
59
+
60
+ ## Links
61
+
62
+ - 📚 Documentation — [docs.reventless.dev](https://docs.reventless.dev)
63
+ - 📦 Repository — [ReventlessDev/reventless-core](https://github.com/ReventlessDev/reventless-core)
64
+ - 📋 [Changelog](./CHANGELOG.md)
65
+
66
+ ## License
67
+
68
+ [Apache-2.0](https://opensource.org/licenses/Apache-2.0)
package/package.json CHANGED
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "name": "@reventlessdev/reventless-graphql-server",
3
- "version": "1.0.0-alpha.2",
3
+ "version": "1.0.0-alpha.3",
4
4
  "description": "Transport-neutral GraphQL server runtime for Reventless: schema-from-fragments, resolver registration, an HTTP + graphql-ws listener, and a subscription fan-out bridge with a pluggable PubSub backend",
5
5
  "license": "Apache-2.0",
6
6
  "dependencies": {
7
- "@reventlessdev/rescript-graphql-yoga": "1.0.0-alpha.19",
8
- "@reventlessdev/reventless-core": "3.0.0-alpha.155"
7
+ "@reventlessdev/rescript-graphql-yoga": "1.0.0-alpha.20",
8
+ "@reventlessdev/reventless-core": "3.0.0-alpha.156"
9
9
  },
10
10
  "devDependencies": {
11
11
  "rescript": "^12.3.0"