@reventlessdev/reventless-local 3.0.0-alpha.138 → 3.0.0-alpha.140

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.
 
+# 3.0.0-alpha.140 (2026-07-11)
+
+**Note:** Version bump only for package @reventlessdev/reventless-local
+
+
+
+
+
+# 3.0.0-alpha.139 (2026-07-11)
+
+### Features
+
+* **graphql-server:** promote reusable GraphQL server runtime into shared package ([53dd0d5](https://github.com/ReventlessDev/reventless-core/commit/53dd0d54585dcc10d75322a76050aa8c06cec4fb))
+
+
 # 3.0.0-alpha.138 (2026-07-11)
 
 **Note:** Version bump only for package @reventlessdev/reventless-local

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reventlessdev/reventless-local",
-  "version": "3.0.0-alpha.138",
+  "version": "3.0.0-alpha.140",
   "description": "Local platform for Reventless (in-memory or SQLite backend, for development and testing without AWS)",
   "license": "Apache-2.0",
   "jest": {
@@ -31,16 +31,17 @@
     "graphql-yoga": "^5.21.0",
     "sury": "11.0.0-alpha.4",
     "ws": "^8.18.0",
-    "@reventlessdev/rescript-effect": "0.1.0-alpha.25",
-    "@reventlessdev/rescript-graphql-yoga": "1.0.0-alpha.18",
+    "@reventlessdev/rescript-effect": "0.1.0-alpha.26",
+    "@reventlessdev/rescript-graphql-yoga": "1.0.0-alpha.19",
     "@reventlessdev/rescript-jest": "1.0.0-alpha.6",
-    "@reventlessdev/rescript-mcp-sdk": "1.0.0-alpha.17",
     "@reventlessdev/rescript-pulumi-pulumi": "2.3.0-alpha.14",
-    "@reventlessdev/reventless-gwt": "1.0.0-alpha.99",
-    "@reventlessdev/reventless-infra": "3.0.0-alpha.95",
-    "@reventlessdev/reventless-spec": "3.0.0-alpha.73",
-    "@reventlessdev/reventless-postgres": "3.0.0-alpha.18",
-    "@reventlessdev/reventless-core": "3.0.0-alpha.154"
+    "@reventlessdev/rescript-mcp-sdk": "1.0.0-alpha.17",
+    "@reventlessdev/reventless-core": "3.0.0-alpha.155",
+    "@reventlessdev/reventless-graphql-server": "1.0.0-alpha.2",
+    "@reventlessdev/reventless-gwt": "1.0.0-alpha.100",
+    "@reventlessdev/reventless-infra": "3.0.0-alpha.96",
+    "@reventlessdev/reventless-postgres": "3.0.0-alpha.19",
+    "@reventlessdev/reventless-spec": "3.0.0-alpha.74"
   },
   "devDependencies": {
     "rescript": "^12.3.0",

package/rescript.json

@@ -29,6 +29,7 @@
     "@reventlessdev/rescript-pulumi-pulumi",
     "@reventlessdev/rescript-graphql-yoga",
     "@reventlessdev/rescript-mcp-sdk",
+    "@reventlessdev/reventless-graphql-server",
     "@reventlessdev/reventless-infra",
     "@reventlessdev/reventless-spec",
     "@reventlessdev/reventless-core",

package/src/Platform.res

@@ -21,7 +21,7 @@ let log = ReventlessCore.Logger.fromEnv()
 
 // Module-level ref to hold the platform GraphQL server instance in split mode.
 // Populated by makePlatform when splitApi=true.
-let platformGraphQLRef: ref<option<GraphQL_ServerInstance.t>> = ref(None)
+let platformGraphQLRef: ref<option<ReventlessGraphqlServer.GraphQL_ServerInstance.t>> = ref(None)
 let getPlatformGraphQL = () => platformGraphQLRef.contents
 
 // Module-level ref to hold the platform MCP server instance in split mode.
@@ -144,7 +144,7 @@ module MakeWithConfig = (
 
   // Track which GraphQL servers have had admin schema (Plugin queries/mutations) registered.
   // Prevents double-registration when makePlatform and deployPlugin both target the same server.
-  let adminRegisteredServers: ref<array<GraphQL_ServerInstance.t>> = ref([])
+  let adminRegisteredServers: ref<array<ReventlessGraphqlServer.GraphQL_ServerInstance.t>> = ref([])
 
   // Relay support record for domain QueryDbs (platform QueryDbs pass None).
   let domainRelaySupport: QueryDbResolvers_GraphQL.relaySupport = {
@@ -157,7 +157,7 @@ module MakeWithConfig = (
   // Resolve the active GraphQL server based on current deploy target.
   // In unified mode always routes to DomainGraphQL_Server (single server).
   // In split mode routes based on currentDeployTarget.
-  let resolveTargetGraphQL = (): GraphQL_ServerInstance.t =>
+  let resolveTargetGraphQL = (): ReventlessGraphqlServer.GraphQL_ServerInstance.t =>
     if !Config.splitApi {
       DomainGraphQL_Server.asInterface
     } else {

package/src/adapter/Api/LocalGraphQL_SubscriptionResolvers.res

@@ -1,5 +1,12 @@
 // LocalGraphQL_SubscriptionResolvers.res
-// WebSocket subscription resolvers for Sources A and B (in-memory / yoga).
+// In-process wiring of the local event bus into the promoted, transport-neutral
+// GraphQL subscription bridge (`ReventlessGraphqlServer.GraphQL_SubscriptionBridge`).
+//
+// The generic pieces — topic naming, the field-resolver builder, `registerAll`,
+// and the `@aws_subscribe` stripping — live in core-adjacent
+// `GraphQL_SubscriptionBridge`, parameterized over a PubSub instance. This
+// module supplies the in-process `GraphqlYoga.createPubSub()` singleton and the
+// Bus→PubSub glue that is specific to the local in-process backend:
 //
 // Source A (raw event stream): subscribes to Bus.subscribeToEvents for each event log
 //   topic and publishes the event envelope to a yoga PubSub channel.
@@ -11,15 +18,17 @@
 //   after each successful command. This is left as future work — currently mutations do
 //   not cross-post to the subscription PubSub in-memory.
 //
-// Usage: call `setup` once per server build, then `registerAll` to wire into the GraphQL
-//   server instance. Both must be called before the server starts.
-//
-// Note: `scalar AWSJSON` is injected here so yoga accepts the AppSync scalar used in
-//   Source A event log types. It serialises as a plain string.
+// Usage: wire the bridges (bridgeSourceA / bridgeSourceB), then `registerAll` to
+//   wire subscriptions into the GraphQL server instance. Both must be called
+//   before the server starts.
 
 module YG = GraphqlYoga
+module Bridge = ReventlessGraphqlServer.GraphQL_SubscriptionBridge
 
 // ── PubSub instance ───────────────────────────────────────────────────────────
+// The single in-process PubSub used by every local server. Cross-process
+// delivery is not a concern in-memory, so this is byte-identical to the pre-
+// promotion behavior: one process, one PubSub, topics disambiguate channels.
 
 let pubSub: ref<option<YG.pubSub>> = ref(None)
 
@@ -32,13 +41,10 @@ let getPubSub = () =>
     ps
   }
 
-// ── Topic naming ──────────────────────────────────────────────────────────────
-// Matches the field names generated by Plugin_SubscriptionSchema:
-//   Source A: on{DisplayName}EventLog_eventAppended
-//   Source B: on{ReturnTypeName}_stateChanged
+// ── Topic naming (re-exported from the promoted bridge) ────────────────────────
 
-let sourceATopic = (displayName: string) => `on${displayName}EventLog_eventAppended`
-let sourceBTopic = (returnTypeName: string) => `on${returnTypeName}_stateChanged`
+let sourceATopic = Bridge.sourceATopic
+let sourceBTopic = Bridge.sourceBTopic
 
 // ── Bridge: Bus → PubSub ──────────────────────────────────────────────────────
 
@@ -73,26 +79,14 @@ let bridgeSourceB = (
   })
 }
 
-// ── Subscription resolver builder ─────────────────────────────────────────────
-//
-// Builds the yoga subscription resolver object for one field:
-//   { subscribe: (_root, _args) => pubSub.subscribe(topic), resolve: x => x }
-//
-// The resolver dict value is typed as JSON.t (the generic resolverFn) and cast via
-// Obj.magic — yoga's createSchema accepts { subscribe, resolve } objects for the
-// Subscription type, not plain functions. This is safe at runtime.
+// ── Subscription resolver builder (delegates to the promoted bridge) ───────────
 
-let makeFieldResolver = (topic: string): YG.resolverFn => {
-  let ps = getPubSub()
-  Obj.magic({
-    "subscribe": (_root: JSON.t, _args: JSON.t, _ctx: JSON.t) => ps->YG.pubSubSubscribe(topic),
-    "resolve": (payload: JSON.t) => payload,
-  })
-}
+let makeFieldResolver = (topic: string): YG.resolverFn =>
+  Bridge.makeFieldResolver(~pubSub=getPubSub(), topic)
 
-// ── Public API ────────────────────────────────────────────────────────────────
+// ── Public API (delegates to the promoted bridge, binding the local PubSub) ────
 
-type subscriptionEntry = {
+type subscriptionEntry = Bridge.subscriptionEntry = {
   fieldName: string,
   topic: string,
 }
@@ -110,36 +104,15 @@ type subscriptionEntry = {
  *   (after stripping `@aws_subscribe` directives — not valid in yoga).
  */
 let registerAll = (
-  ~server: GraphQL_ServerInstance.t,
+  ~server: ReventlessGraphqlServer.GraphQL_ServerInstance.t,
   ~sdlFields: array<string>,
   ~sourceAEntries: array<subscriptionEntry>,
   ~sourceBEntries: array<subscriptionEntry>,
-) => {
-  // 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}) => {
-    resolvers->Dict.set(fieldName, makeFieldResolver(topic))
-  })
-  sourceBEntries->Array.forEach(({fieldName, topic}) => {
-    resolvers->Dict.set(fieldName, makeFieldResolver(topic))
-  })
-
-  server.registerSubscriptions(~sdlFields=cleanedFields, ~resolvers)
-
-  // Inject scalar AWSJSON so yoga accepts it in Source A event log types
-  server.registerTypes(~sdlTypes=["scalar AWSJSON"])
-}
+) => Bridge.registerAll(~server, ~sdlFields, ~sourceAEntries, ~sourceBEntries, ~pubSub=getPubSub())
 
 /** Publish a payload to a named PubSub topic (for Source C mutation resolvers). */
-let publish = (topic: string, payload: JSON.t) => {
-  getPubSub()->YG.pubSubPublish(topic, payload)
-}
+let publish = (topic: string, payload: JSON.t) =>
+  Bridge.publish(~pubSub=getPubSub(), topic, payload)
 
 let reset = () => {
   pubSub.contents = None

package/src/adapter/Api/LocalGraphQL_SubscriptionResolvers.res.mjs

@@ -2,6 +2,7 @@
 
 import * as GraphqlYoga from "graphql-yoga";
 import * as Primitive_option from "@rescript/runtime/lib/es6/Primitive_option.js";
+import * as GraphQL_SubscriptionBridge$ReventlessGraphqlServer from "@reventlessdev/reventless-graphql-server/src/GraphQL_SubscriptionBridge.res.mjs";
 
 let pubSub = {
   contents: undefined
@@ -17,17 +18,9 @@ function getPubSub() {
   return ps$1;
 }
 
-function sourceATopic(displayName) {
-  return `on` + displayName + `EventLog_eventAppended`;
-}
-
-function sourceBTopic(returnTypeName) {
-  return `on` + returnTypeName + `_stateChanged`;
-}
-
 function bridgeSourceA(subscribeToEvents, displayName, busTopicName) {
   let ps = getPubSub();
-  let yogaTopic = sourceATopic(displayName);
+  let yogaTopic = GraphQL_SubscriptionBridge$ReventlessGraphqlServer.sourceATopic(displayName);
   subscribeToEvents(busTopicName, async (_service, _meta, json) => {
     ps.publish(yogaTopic, json);
   });
@@ -35,35 +28,22 @@ function bridgeSourceA(subscribeToEvents, displayName, busTopicName) {
 
 function bridgeSourceB(subscribeToStateChanges, readModelName, returnTypeName) {
   let ps = getPubSub();
-  let yogaTopic = sourceBTopic(returnTypeName);
+  let yogaTopic = GraphQL_SubscriptionBridge$ReventlessGraphqlServer.sourceBTopic(returnTypeName);
   subscribeToStateChanges(readModelName, state => {
     ps.publish(yogaTopic, state);
   });
 }
 
 function makeFieldResolver(topic) {
-  let ps = getPubSub();
-  return {
-    subscribe: (_root, _args, _ctx) => ps.subscribe(topic),
-    resolve: payload => payload
-  };
+  return GraphQL_SubscriptionBridge$ReventlessGraphqlServer.makeFieldResolver(getPubSub(), topic);
 }
 
 function registerAll(server, sdlFields, sourceAEntries, sourceBEntries) {
-  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(param.topic);
-  });
-  sourceBEntries.forEach(param => {
-    resolvers[param.fieldName] = makeFieldResolver(param.topic);
-  });
-  server.registerSubscriptions(cleanedFields, resolvers);
-  server.registerTypes(["scalar AWSJSON"]);
+  GraphQL_SubscriptionBridge$ReventlessGraphqlServer.registerAll(server, sdlFields, sourceAEntries, sourceBEntries, getPubSub());
 }
 
 function publish(topic, payload) {
-  getPubSub().publish(topic, payload);
+  GraphQL_SubscriptionBridge$ReventlessGraphqlServer.publish(getPubSub(), topic, payload);
 }
 
 function reset() {
@@ -72,8 +52,15 @@ function reset() {
 
 let YG;
 
+let Bridge;
+
+let sourceATopic = GraphQL_SubscriptionBridge$ReventlessGraphqlServer.sourceATopic;
+
+let sourceBTopic = GraphQL_SubscriptionBridge$ReventlessGraphqlServer.sourceBTopic;
+
 export {
   YG,
+  Bridge,
   pubSub,
   getPubSub,
   sourceATopic,

package/src/adapter/CommandGenerator/CommandGeneratorResolvers_GraphQL.res

@@ -104,7 +104,7 @@ let capitalize = s =>
 
 let commandResultSdl = GraphQL_FragmentGenerator.commandResultSdlTypes->Array.join("\n\n")
 
-let ensureCommandResultTypes = (server: GraphQL_ServerInstance.t) => {
+let ensureCommandResultTypes = (server: ReventlessGraphqlServer.GraphQL_ServerInstance.t) => {
   if !(server.buildSdl()->String.includes("CommandAccepted")) {
     server.registerTypes(~sdlTypes=[commandResultSdl])
   }
@@ -167,7 +167,7 @@ let register = (
   ~fields: array<string>,
   ~commandSchema: S.t<unknown>,
   ~commandAuthorization: unknown => Reventless.Authorization.permission,
-  ~server: GraphQL_ServerInstance.t,
+  ~server: ReventlessGraphqlServer.GraphQL_ServerInstance.t,
 ) => {
   ensureCommandResultTypes(server)
   // Aggregate commands target a specific instance — prepend id: ID!
@@ -193,7 +193,7 @@ let register = (
     | _ => false
     }
     let commandName = extractCommandName(field)
-    let resolver: GraphQL_ServerInstance.resolverFn = async (_root, args, ctx) => {
+    let resolver: ReventlessGraphqlServer.GraphQL_ServerInstance.resolverFn = async (_root, args, ctx) => {
       switch handlerRef.contents {
       | Some(generateCommand) =>
         switch checkPluginStatus(~field) {
@@ -234,7 +234,7 @@ let registerDcb = (
   ~fieldName: string,
   ~commandSchema: S.t<unknown>,
   ~commandAuthorization: unknown => Reventless.Authorization.permission,
-  ~server: GraphQL_ServerInstance.t,
+  ~server: ReventlessGraphqlServer.GraphQL_ServerInstance.t,
 ) => {
   ensureCommandResultTypes(server)
   // Derive the constructor from the field name's trailing `_` segment (mirrors the
@@ -256,7 +256,7 @@ let registerDcb = (
   let handlerRef = ref(None)
   handlerRefs->Dict.set(fieldName, handlerRef)
 
-  let resolver: GraphQL_ServerInstance.resolverFn = async (_root, args, ctx) => {
+  let resolver: ReventlessGraphqlServer.GraphQL_ServerInstance.resolverFn = async (_root, args, ctx) => {
     switch handlerRef.contents {
     | Some(generateCommand) =>
       switch checkPluginStatus(~field=fieldName) {

package/src/adapter/CommandGenerator/InboundTranslationResolvers_GraphQL.res

@@ -23,7 +23,7 @@ let pendingQueueRegistry: dict<ref<array<pendingCall>>> = Dict.make()
 // Phase 1: Register SDL + resolver stub synchronously (before server starts).
 // Also pre-registers a queuing forwarder in receiveRegistry so callers can
 // invoke receive immediately; calls are parked until bindReceive drains them.
-let register = (~fieldName: string, ~externalInputSchema: S.t<unknown>, ~server: GraphQL_ServerInstance.t) => {
+let register = (~fieldName: string, ~externalInputSchema: S.t<unknown>, ~server: ReventlessGraphqlServer.GraphQL_ServerInstance.t) => {
   let sdlFields = switch GraphQL_FragmentGenerator.deriveMutationFieldFromObject(
     ~fieldName,
     ~collectedTypes=[],
@@ -45,7 +45,7 @@ let register = (~fieldName: string, ~externalInputSchema: S.t<unknown>, ~server:
     })
   receiveRegistry->Dict.set(fieldName, queuingReceive)
 
-  let resolver: GraphQL_ServerInstance.resolverFn = async (_root, args, _ctx) => {
+  let resolver: ReventlessGraphqlServer.GraphQL_ServerInstance.resolverFn = async (_root, args, _ctx) => {
     let inputJson: JSON.t = args->Obj.magic
     let receive = receiveRegistry->Dict.getUnsafe(fieldName)
     let result = await receive(inputJson)

package/src/adapter/DomainGraphQL_Server.res

@@ -153,7 +153,7 @@ let _dispatch = (req: nodeRequest, res: nodeResponse, yoga: YG.yoga, getSdl: uni
 // `Auth_GraphqlContext.buildAuthContext` flattens headers into a lowercase
 // dict, runs them through `LocalAuth.authenticate`, and attaches the
 // resolved identity to the resolver context. Lifted into its own module so
-// the split-mode admin server (`GraphQL_ServerInstance`) enforces the same
+// the split-mode admin server (`ReventlessGraphqlServer.GraphQL_ServerInstance`) enforces the same
 // bearer-token rules instead of leaving admin queries wide open.
 
 let buildAuthContext = Auth_GraphqlContext.buildAuthContext
@@ -301,7 +301,7 @@ ${mutations}
   base ++ subscriptionsSdl
 }
 
-// `~contextFactory` is accepted to satisfy the `GraphQL_ServerInstance.t`
+// `~contextFactory` is accepted to satisfy the `ReventlessGraphqlServer.GraphQL_ServerInstance.t`
 // interface but ignored — the data server always wires `buildAuthContext`
 // internally so the bearer-token rules + /__inmemory/login + /sdl dispatch
 // stay consistent across callers.
@@ -444,7 +444,7 @@ let printLiveSdl = () =>
   | None => log.info(~comp="GraphQL:Domain", "no active schema")
   }
 
-type diagnostics = GraphQL_ServerInstance.diagnostics
+type diagnostics = ReventlessGraphqlServer.GraphQL_ServerInstance.diagnostics
 
 let extractFieldName = (sdlField: string): string => {
   let trimmed = sdlField->String.trim
@@ -544,10 +544,10 @@ let printDiagnostics = () => {
   }
 }
 
-// -- GraphQL_ServerInstance.t interface ----------------------------------
-// Exposes this singleton as a GraphQL_ServerInstance.t for use by
+// -- ReventlessGraphqlServer.GraphQL_ServerInstance.t interface ----------------------------------
+// Exposes this singleton as a ReventlessGraphqlServer.GraphQL_ServerInstance.t for use by
 // resolveTargetGraphQL() in Platform.res (mirrors AWS resolveTargetApi() pattern).
-let asInterface: GraphQL_ServerInstance.t = {
+let asInterface: ReventlessGraphqlServer.GraphQL_ServerInstance.t = {
   registerMutations,
   registerQueries,
   registerSubscriptions,

package/src/adapter/PlatformGraphQL_Server.res

@@ -1,7 +1,7 @@
 // Platform (admin-facing) in-memory GraphQL server — singleton.
 // Serves admin/core operations on a separate port in split mode (port 4001).
 //
-// Uses the same GraphQL_ServerInstance factory as the generic instance,
+// Uses the same ReventlessGraphqlServer.GraphQL_ServerInstance factory as the generic instance,
 // but is exposed as a named singleton so Platform.res can reference it
 // directly (mirroring the AWS PlatformAPI resource pattern).
 //
@@ -22,14 +22,14 @@
 // — without the wrapper, anonymous callers could trigger admin mutations
 // (Plugin_Activate / _Deactivate, etc.) just by hitting the platform port.
 
-let instance: GraphQL_ServerInstance.t = GraphQL_ServerInstance.make(~label="GraphQL:Platform")
+let instance: ReventlessGraphqlServer.GraphQL_ServerInstance.t = ReventlessGraphqlServer.GraphQL_ServerInstance.make(~label="GraphQL:Platform")
 
 // Wrap a resolver dict so every value enforces the Admin group. Keys are
 // preserved; resolvers fall through to the underlying instance once the
 // group check passes.
 let wrapAdmin = (
-  resolvers: dict<GraphQL_ServerInstance.resolverFn>,
-): dict<GraphQL_ServerInstance.resolverFn> => {
+  resolvers: dict<ReventlessGraphqlServer.GraphQL_ServerInstance.resolverFn>,
+): dict<ReventlessGraphqlServer.GraphQL_ServerInstance.resolverFn> => {
   let wrapped = Dict.make()
   resolvers->Dict.toArray->Array.forEach(((k, v)) =>
     wrapped->Dict.set(k, Auth_GraphqlContext.requireGroup(~group="Admin", v))
@@ -54,10 +54,10 @@ let getSchema = instance.getSchema
 let diagnostics = instance.diagnostics
 let printDiagnostics = instance.printDiagnostics
 
-// Expose as GraphQL_ServerInstance.t for resolveTargetGraphQL() in Platform.res.
+// Expose as ReventlessGraphqlServer.GraphQL_ServerInstance.t for resolveTargetGraphQL() in Platform.res.
 // `registerQueries` is the wrapped version so admin auth fires regardless of
 // whether callers reach the singleton directly or through `asInterface`.
-let asInterface: GraphQL_ServerInstance.t = {
+let asInterface: ReventlessGraphqlServer.GraphQL_ServerInstance.t = {
   registerMutations,
   registerQueries,
   registerSubscriptions,

package/src/adapter/PlatformGraphQL_Server.res.mjs

@@ -1,9 +1,9 @@
 // Generated by ReScript, PLEASE EDIT WITH CARE
 
 import * as Auth_GraphqlContext$ReventlessLocal from "./Auth/Auth_GraphqlContext.res.mjs";
-import * as GraphQL_ServerInstance$ReventlessLocal from "./GraphQL_ServerInstance.res.mjs";
+import * as GraphQL_ServerInstance$ReventlessGraphqlServer from "@reventlessdev/reventless-graphql-server/src/GraphQL_ServerInstance.res.mjs";
 
-let instance = GraphQL_ServerInstance$ReventlessLocal.make("GraphQL:Platform");
+let instance = GraphQL_ServerInstance$ReventlessGraphqlServer.make("GraphQL:Platform");
 
 function wrapAdmin(resolvers) {
   let wrapped = {};

package/src/adapter/QueryDb/QueryDbResolvers_GraphQL.res

@@ -57,7 +57,7 @@ module Make = (Bus: LocalBus.T) => {
   // -- Module-level server and relay refs ------------------------------------
   // Set by Platform.res before component construction runs so the make function
   // can pick up the correct target server and relay support (mirrors AWS ~api pattern).
-  let serverRef: ref<GraphQL_ServerInstance.t> = ref(DomainGraphQL_Server.asInterface)
+  let serverRef: ref<ReventlessGraphqlServer.GraphQL_ServerInstance.t> = ref(DomainGraphQL_Server.asInterface)
   let relayRef: ref<option<relaySupport>> = ref(Some({
     encodeGlobalId: DomainGraphQL_Server.encodeGlobalId,
     registerNodeType: DomainGraphQL_Server.registerNodeType,
@@ -183,7 +183,7 @@ module Make = (Bus: LocalBus.T) => {
     } else {
       `  ${singleQueryName}: ${returnTypeName}`
     }
-    let byIdResolver: GraphQL_ServerInstance.resolverFn = async (_root, args, ctx) => {
+    let byIdResolver: ReventlessGraphqlServer.GraphQL_ServerInstance.resolverFn = async (_root, args, ctx) => {
       switch await runInterceptor(~ctx, ~args) {
       | Deny(_) => JSON.Encode.null
       | Allow =>
@@ -222,9 +222,9 @@ module Make = (Bus: LocalBus.T) => {
     } else {
       []
     }
-    let byIdsResolverEntry: option<(string, GraphQL_ServerInstance.resolverFn)> =
+    let byIdsResolverEntry: option<(string, ReventlessGraphqlServer.GraphQL_ServerInstance.resolverFn)> =
       if includeIdParam && subIdField === None {
-        let resolver: GraphQL_ServerInstance.resolverFn = async (_root, args, ctx) => {
+        let resolver: ReventlessGraphqlServer.GraphQL_ServerInstance.resolverFn = async (_root, args, ctx) => {
           switch await runInterceptor(~ctx, ~args) {
           | Deny(_) => []->JSON.Encode.array
           | Allow =>
@@ -295,7 +295,7 @@ module Make = (Bus: LocalBus.T) => {
         }
       }
 
-    let (listSdl, listResolver): (array<string>, GraphQL_ServerInstance.resolverFn) = if connectionSpec {
+    let (listSdl, listResolver): (array<string>, ReventlessGraphqlServer.GraphQL_ServerInstance.resolverFn) = if connectionSpec {
       // Relay Connection spec format
       let filterTypeName = returnTypeName ++ "Filter"
       let orderByTypes = GraphQL_FragmentGenerator.deriveConnectionOrderByType(
@@ -315,7 +315,7 @@ module Make = (Bus: LocalBus.T) => {
           ~hasOrderBy,
         ),
       ]
-      let resolver: GraphQL_ServerInstance.resolverFn = async (_root, args, ctx) => {
+      let resolver: ReventlessGraphqlServer.GraphQL_ServerInstance.resolverFn = async (_root, args, ctx) => {
         switch await runInterceptor(~ctx, ~args) {
         | Deny(_) =>
           Obj.magic({
@@ -355,7 +355,7 @@ module Make = (Bus: LocalBus.T) => {
     } else {
       // Legacy AppSync-style format
       let sdl = [`  ${listQueryName}(nextToken: String, limit: Int): ${pluralTypeName}!`]
-      let resolver: GraphQL_ServerInstance.resolverFn = async (_root, args, ctx) => {
+      let resolver: ReventlessGraphqlServer.GraphQL_ServerInstance.resolverFn = async (_root, args, ctx) => {
         switch await runInterceptor(~ctx, ~args) {
         | Deny(_) => Obj.magic({"nextToken": Nullable.null, "scannedCount": 0, "items": []})
         | Allow =>
@@ -383,9 +383,9 @@ module Make = (Bus: LocalBus.T) => {
       [`  ${singleQueryName}Items(id: ID!, filter: ${filterTypeName}, first: Int, after: String, last: Int, before: String): ${connectionTypeName}!`]
     | None => []
     }
-    let itemsResolvers: array<(string, GraphQL_ServerInstance.resolverFn)> = switch subIdField {
+    let itemsResolvers: array<(string, ReventlessGraphqlServer.GraphQL_ServerInstance.resolverFn)> = switch subIdField {
     | Some(sf) =>
-      let resolver: GraphQL_ServerInstance.resolverFn = async (_root, args, ctx) => {
+      let resolver: ReventlessGraphqlServer.GraphQL_ServerInstance.resolverFn = async (_root, args, ctx) => {
         let emptyConn = Obj.magic({
           "edges": [],
           "pageInfo": {
@@ -498,12 +498,12 @@ module Make = (Bus: LocalBus.T) => {
     let indexSdlFields = indexes->Array.map((ic: Reventless.ReadModel.indexConfig) =>
       `  ${singleQueryName}By${cap(ic.index)}(${ic.index}: String!): [String]`
     )
-    let indexResolvers: array<(string, GraphQL_ServerInstance.resolverFn)> = indexes->Array.map(
+    let indexResolvers: array<(string, ReventlessGraphqlServer.GraphQL_ServerInstance.resolverFn)> = indexes->Array.map(
       (ic: Reventless.ReadModel.indexConfig) => {
         let index = ic.index
         let resolverName = singleQueryName ++ "By" ++ cap(index)
         let filterField = ic.idField->Option.getOr(index)
-        let resolver: GraphQL_ServerInstance.resolverFn = async (_root, args, ctx) => {
+        let resolver: ReventlessGraphqlServer.GraphQL_ServerInstance.resolverFn = async (_root, args, ctx) => {
           switch await runInterceptor(~ctx, ~args) {
           | Deny(_) => []->JSON.Encode.array
           | Allow =>

package/tests/SplitApiFixtures.res

@@ -1,16 +1,16 @@
 // Fixtures for split API mode integration tests.
 // Tests the split routing logic directly using GraphQL_Server (singleton)
-// and GraphQL_ServerInstance (factory) without importing Platform or MCP,
+// and ReventlessGraphqlServer.GraphQL_ServerInstance (factory) without importing Platform or MCP,
 // which avoids ESM compatibility issues with Jest.
 //
 // This mirrors what Platform.makePlatform does in split mode:
-// - Admin schema → GraphQL_ServerInstance (isolated admin server)
+// - Admin schema → ReventlessGraphqlServer.GraphQL_ServerInstance (isolated admin server)
 // - Plugin schema → GraphQL_Server singleton (plugin server)
 
 let _ = TestRunner.setup()
 
 // Helper to extract resolver key from an SDL field string.
-// Mirrors GraphQL_ServerInstance.extractFieldName.
+// Mirrors ReventlessGraphqlServer.GraphQL_ServerInstance.extractFieldName.
 let extractSdlFieldName = (sdlField: string): string => {
   let trimmed = sdlField->String.trim
   trimmed
@@ -28,7 +28,7 @@ let extractSdlFieldName = (sdlField: string): string => {
 // Create admin GraphQL instance (mirrors Platform split mode)
 // ─────────────────────────────────────────────────────────────
 
-let adminGraphQL = GraphQL_ServerInstance.make(~label="GraphQL:Admin")
+let adminGraphQL = ReventlessGraphqlServer.GraphQL_ServerInstance.make(~label="GraphQL:Admin")
 
 // Build admin SDL — authoritative source for field names.
 let baseParts = ReventlessCore.GraphQL_Stitcher.decode(ReventlessCore.AdminApi.baseFragment(~cloner=true))

package/tests/SplitApiFixtures.res.mjs

@@ -6,7 +6,7 @@ import * as TestRunner$ReventlessLocal from "../src/test/TestRunner.res.mjs";
 import * as GraphQL_Server$ReventlessLocal from "../src/adapter/GraphQL_Server.res.mjs";
 import * as GraphQL_Stitcher$ReventlessCore from "@reventlessdev/reventless-core/src/components/Api/GraphQL_Stitcher.res.mjs";
 import * as PluginBaseFragment$ReventlessCore from "@reventlessdev/reventless-core/src/plugin/api/PluginBaseFragment.res.mjs";
-import * as GraphQL_ServerInstance$ReventlessLocal from "../src/adapter/GraphQL_ServerInstance.res.mjs";
+import * as GraphQL_ServerInstance$ReventlessGraphqlServer from "@reventlessdev/reventless-graphql-server/src/GraphQL_ServerInstance.res.mjs";
 
 TestRunner$ReventlessLocal.setup();
 
@@ -15,7 +15,7 @@ function extractSdlFieldName(sdlField) {
   return Stdlib_Option.getOr(Stdlib_Option.getOr(trimmed.split("(")[0], "").trim().split(":")[0], "").trim();
 }
 
-let adminGraphQL = GraphQL_ServerInstance$ReventlessLocal.make("GraphQL:Admin");
+let adminGraphQL = GraphQL_ServerInstance$ReventlessGraphqlServer.make("GraphQL:Admin");
 
 let baseParts = GraphQL_Stitcher$ReventlessCore.decode(AdminApi$ReventlessCore.baseFragment(true));
 

package/tests/SplitApiTest.res

@@ -3,11 +3,11 @@
 // with no cross-contamination.
 //
 // Tests the split routing pattern used by Platform.makePlatform(splitApi=true):
-// - Admin schema → GraphQL_ServerInstance (dedicated admin server)
+// - Admin schema → ReventlessGraphqlServer.GraphQL_ServerInstance (dedicated admin server)
 // - Plugin schema → GraphQL_Server singleton (default plugin server)
 //
 // MCP split is structurally identical (MCP_ServerInstance mirrors
-// GraphQL_ServerInstance) but is not tested here due to Jest ESM
+// ReventlessGraphqlServer.GraphQL_ServerInstance) but is not tested here due to Jest ESM
 // compatibility issues with the MCP SDK dependency chain.
 
 open JestGlobals