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

package/CHANGELOG.md

@@ -3,6 +3,21 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# 1.0.0-alpha.4 (2026-07-12)
+
+### Features
+
+* **api:** neutralize core-emitted SDL — [@aws](https://github.com/aws)_subscribe moves to the AWS adapter (Phase 2a) ([9b27ec8](https://github.com/ReventlessDev/reventless-core/commit/9b27ec8f6ab2b7453b1c50b9891e89781ec3b31a))
+
+
+# 1.0.0-alpha.3 (2026-07-11)
+
+**Note:** Version bump only for package @reventlessdev/reventless-graphql-server
+
+
+
+
+
 # 1.0.0-alpha.2 (2026-07-11)
 
 **Note:** Version bump only for package @reventlessdev/reventless-graphql-server

package/README.md

@@ -0,0 +1,68 @@
+[![npm](https://img.shields.io/npm/v/@reventlessdev/reventless-graphql-server.svg?label=npm)](https://www.npmjs.com/package/@reventlessdev/reventless-graphql-server)
+[![License: Apache-2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+[![Docs](https://img.shields.io/badge/docs-reventless.dev-blue)](https://docs.reventless.dev)
+
+# @reventlessdev/reventless-graphql-server
+
+> ⚠️ **Alpha.** APIs and on-disk formats can change without notice between releases.
+> Pin exact versions and expect breaking changes.
+
+A **transport-neutral GraphQL server runtime** shared across
+[Reventless](https://docs.reventless.dev) — a spec-driven, event-sourced CQRS
+framework written in [ReScript](https://rescript-lang.org). It stands up
+[Yoga](https://the-guild.dev/graphql/yoga-server)-backed GraphQL servers from
+stitched SDL fragments plus a resolver map, with an optional `graphql-ws`
+WebSocket endpoint and a subscription fan-out bridge over a pluggable PubSub
+backend.
+
+## What it provides
+
+Two ReScript modules:
+
+- **`GraphQL_ServerInstance`** — a server-instance factory. Each instance keeps an
+  isolated registry, so a backend can stand up one or more independent servers
+  from SDL fragments + a resolver dict, exposed over HTTP with an optional
+  `graphql-ws` WebSocket transport for subscriptions. Includes registry
+  diagnostics (registered type/field/resolver inventories and SDL-vs-resolver
+  mismatch reporting).
+- **`GraphQL_SubscriptionBridge`** — transport-neutral wiring between a server
+  instance and a PubSub backend for `graphql-ws` fan-out. The topic vocabulary is
+  fixed to core's generated subscription SDL (raw event-stream and state-changed
+  fields), but the PubSub instance is a *parameter*: an in-process server passes
+  `createPubSub()`, a multi-process gateway passes a cross-process implementation
+  of the same interface.
+
+## Where it fits
+
+`reventless-graphql-server` builds on
+[`@reventlessdev/reventless-core`](https://www.npmjs.com/package/@reventlessdev/reventless-core)
+(for the subscription-schema topic vocabulary and logging) and the framework's
+`graphql-yoga` bindings. It is the reusable serving layer that storage/deployment
+adapters and local platforms wire their generated schema and resolvers into; it
+holds no domain or storage logic of its own.
+
+## Install
+
+```bash
+pnpm add @reventlessdev/reventless-graphql-server
+```
+
+Register it as a ReScript dependency in `rescript.json`:
+
+```json
+{
+  "dependencies": ["@reventlessdev/reventless-graphql-server"]
+}
+```
+
+Requires ReScript `^12.3.0` (peer dependency).
+
+## Links
+
+- 📚 Documentation — [docs.reventless.dev](https://docs.reventless.dev)
+- 📦 Repository — [ReventlessDev/reventless-core](https://github.com/ReventlessDev/reventless-core)
+- 📋 [Changelog](./CHANGELOG.md)
+
+## License
+
+[Apache-2.0](https://opensource.org/licenses/Apache-2.0)

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@reventlessdev/reventless-graphql-server",
-  "version": "1.0.0-alpha.2",
+  "version": "1.0.0-alpha.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",
   "license": "Apache-2.0",
   "dependencies": {
-    "@reventlessdev/rescript-graphql-yoga": "1.0.0-alpha.19",
-    "@reventlessdev/reventless-core": "3.0.0-alpha.155"
+    "@reventlessdev/reventless-core": "3.0.0-alpha.157",
+    "@reventlessdev/rescript-graphql-yoga": "1.0.0-alpha.20"
   },
   "devDependencies": {
     "rescript": "^12.3.0"

package/src/GraphQL_SubscriptionBridge.res

@@ -54,8 +54,9 @@ type subscriptionEntry = {
  *   The bus→PubSub bridge for each source must already be wired (by the
  *   backend) so the topics carry payloads before this registers subscribers.
  *
- * `sdlFields`: the `subscriptions` SDL field strings from the plugin fragment
- *   (after stripping `@aws_subscribe` directives — not valid in yoga).
+ * `sdlFields`: the `subscriptions` SDL field strings from the plugin fragment.
+ *   Core emits provider-neutral subscription SDL (no provider directives), so
+ *   the fields register as-is.
  *
  * `pubSub`: the backend's PubSub instance; the resolvers subscribe on it.
  */
@@ -66,12 +67,6 @@ let registerAll = (
   ~sourceBEntries: array<subscriptionEntry>,
   ~pubSub: YG.pubSub,
 ) => {
-  // Strip @aws_subscribe directives — only valid in AppSync, not yoga
-  let cleanedFields =
-    sdlFields->Array.map(field =>
-      field->String.split("\n")->Array.filter(line => !(line->String.includes("@aws_subscribe")))->Array.join("\n")
-    )
-
   let resolvers: dict<YG.resolverFn> = Dict.make()
 
   sourceAEntries->Array.forEach(({fieldName, topic}) => {
@@ -81,7 +76,7 @@ let registerAll = (
     resolvers->Dict.set(fieldName, makeFieldResolver(~pubSub, topic))
   })
 
-  server.registerSubscriptions(~sdlFields=cleanedFields, ~resolvers)
+  server.registerSubscriptions(~sdlFields, ~resolvers)
 
   // Inject scalar AWSJSON so yoga accepts it in Source A event log types
   server.registerTypes(~sdlTypes=["scalar AWSJSON"])

package/src/GraphQL_SubscriptionBridge.res.mjs

@@ -17,7 +17,6 @@ function makeFieldResolver(pubSub, topic) {
 }
 
 function registerAll(server, sdlFields, sourceAEntries, sourceBEntries, pubSub) {
-  let cleanedFields = sdlFields.map(field => field.split("\n").filter(line => !line.includes("@aws_subscribe")).join("\n"));
   let resolvers = {};
   sourceAEntries.forEach(param => {
     resolvers[param.fieldName] = makeFieldResolver(pubSub, param.topic);
@@ -25,7 +24,7 @@ function registerAll(server, sdlFields, sourceAEntries, sourceBEntries, pubSub)
   sourceBEntries.forEach(param => {
     resolvers[param.fieldName] = makeFieldResolver(pubSub, param.topic);
   });
-  server.registerSubscriptions(cleanedFields, resolvers);
+  server.registerSubscriptions(sdlFields, resolvers);
   server.registerTypes(["scalar AWSJSON"]);
 }