@reventlessdev/reventless-core 3.0.0-alpha.201 → 3.0.0-alpha.202

package/CHANGELOG.md

@@ -3,6 +3,14 @@
 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.202 (2026-08-02)
+
+### Features
+
+* **core:** deploy-time offload hook seam for plugin payloads ([7f970eb](https://github.com/ReventlessDev/reventless-core/commit/7f970eb449765e781559c6596ee49dd74b9451bc))
+* **spec:** make plugin structure/apiSchemaFragment offloadable payloads ([a0391bf](https://github.com/ReventlessDev/reventless-core/commit/a0391bf26f91035460cbf90f52d105a1003414c3))
+
+
 # 3.0.0-alpha.201 (2026-08-02)
 
 ### Features

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reventlessdev/reventless-core",
-  "version": "3.0.0-alpha.201",
+  "version": "3.0.0-alpha.202",
   "description": "Core package for Reventless framework",
   "license": "Apache-2.0",
   "jest": {
@@ -28,17 +28,17 @@
   "dependencies": {
     "sury": "11.0.0-alpha.4",
     "uuid": "^13.0.0",
-    "@reventlessdev/rescript-fast-csv": "2.0.0-alpha.0",
     "@reventlessdev/rescript-effect": "0.1.0-alpha.32",
     "@reventlessdev/rescript-hash-object": "1.2.0-alpha.14",
+    "@reventlessdev/rescript-fast-csv": "2.0.0-alpha.0",
     "@reventlessdev/rescript-jest": "1.0.0-alpha.10",
     "@reventlessdev/rescript-node": "2.0.0-alpha.0",
     "@reventlessdev/rescript-pulumi-pulumi": "2.3.0-alpha.18",
-    "@reventlessdev/rescript-ssh2": "2.0.0-alpha.0",
-    "@reventlessdev/reventless-infra": "3.0.0-alpha.118",
     "@reventlessdev/rescript-uuid": "2.0.0-alpha.0",
-    "@reventlessdev/reventless-interop": "3.0.0-alpha.30",
-    "@reventlessdev/reventless-spec": "3.0.0-alpha.93"
+    "@reventlessdev/rescript-ssh2": "2.0.0-alpha.0",
+    "@reventlessdev/reventless-infra": "3.0.0-alpha.119",
+    "@reventlessdev/reventless-spec": "3.0.0-alpha.94",
+    "@reventlessdev/reventless-interop": "3.0.0-alpha.30"
   },
   "devDependencies": {
     "rescript": "12.3.0",

package/src/plugin/component/Plugin_Builder.res

@@ -738,6 +738,31 @@ module Make = (
         // so reading it inside the async callback would always yield "Domain".
         let capturedDeployTarget = Spec.hooks.deployTarget.contents
 
+        // Offload the two large pluginDefinition fields at deploy time when a
+        // provider offers an object store (AWS writes a content-addressed object
+        // and returns a reference); unset locally, so they stay Inline. Both
+        // values are concrete here, so the hook — and the object write it does —
+        // runs at graph-construction time, before the Pulumi.Output.apply below
+        // (a resource cannot be created inside .apply). Unconditional: these
+        // fields are always large enough to be worth offloading.
+        let toPayload = (value, ~schema, ~store) =>
+          switch Plugin_Helpers.offloadHook.contents {
+          | Some(hook) =>
+            Reventless.Offload.Offloaded(
+              hook(~store, ~bytes=value->S.reverseConvertToJsonStringOrThrow(schema)),
+            )
+          | None => Reventless.Offload.Inline(value)
+          }
+        let apiSchemaFragmentPayload = toPayload(
+          apiSchemaFragment,
+          ~schema=Reventless.Plugin.apiSchemaFragmentSchema,
+          ~store="pluginApiFragments",
+        )
+        let structurePayload =
+          pluginStructure->Option.map(s =>
+            toPayload(s, ~schema=Reventless.Plugin.pluginStructureSchema, ~store="pluginStructures")
+          )
+
         // DCB EventLog definition — Some when this plugin has a DcbEventLog
         // component, None otherwise. Admin's manageSubscriptions reads this to
         // provision cross-plugin SNS subscriptions from peer plugins' DCB
@@ -769,9 +794,9 @@ module Make = (
             extensions: extensionsDefinitions,
             eventCollector: eventCollectorUrn,
             extensionProtocols: [],
-            apiSchemaFragment: Some(apiSchemaFragment),
+            apiSchemaFragment: Some(apiSchemaFragmentPayload),
             apiTarget: Some(capturedDeployTarget),
-            structure: pluginStructure,
+            structure: structurePayload,
             dcbEventLog: dcbEventLogDef,
             // Business role from the deploy-time metadata registry (set via
             // registerPluginMetadata). Unset → Domain. Rides the handshake to the

package/src/plugin/component/Plugin_Builder.res.mjs

@@ -8,6 +8,7 @@ import * as Belt_SetString from "@rescript/runtime/lib/es6/Belt_SetString.js";
 import * as Stdlib_JsError from "@rescript/runtime/lib/es6/Stdlib_JsError.js";
 import * as Primitive_option from "@rescript/runtime/lib/es6/Primitive_option.js";
 import * as DcbTag$Reventless from "@reventlessdev/reventless-spec/src/components/DcbTag.res.mjs";
+import * as Plugin$Reventless from "@reventlessdev/reventless-spec/src/components/Plugin.res.mjs";
 import * as Logger$ReventlessCore from "../../util/Logger.res.mjs";
 import * as Plugin$ReventlessCore from "./Plugin.res.mjs";
 import * as StackReference$Pulumi from "@reventlessdev/rescript-pulumi-pulumi/src/StackReference.res.mjs";
@@ -486,6 +487,22 @@ function Make(Spec) {
           let match$3 = EventCollectorHelper.make(childName, eventTopics, opts);
           let eventCollector = match$3[0];
           let capturedDeployTarget = Spec.hooks.deployTarget.contents;
+          let toPayload = (value, schema, store) => {
+            let hook = Plugin_Helpers$ReventlessCore.offloadHook.contents;
+            if (hook !== undefined) {
+              return {
+                TAG: "Offloaded",
+                _0: hook(store, S.reverseConvertToJsonStringOrThrow(value, schema, undefined))
+              };
+            } else {
+              return {
+                TAG: "Inline",
+                _0: value
+              };
+            }
+          };
+          let apiSchemaFragmentPayload = toPayload(apiSchemaFragment, Plugin$Reventless.apiSchemaFragmentSchema, "pluginApiFragments");
+          let structurePayload = Stdlib_Option.map(pluginStructure, s => toPayload(s, Plugin$Reventless.pluginStructureSchema, "pluginStructures"));
           let dcbOutputs$1 = dcbResult.dcbEventLogOutputs;
           let dcbEventLogDef;
           if (dcbOutputs$1 !== undefined) {
@@ -509,9 +526,9 @@ function Make(Spec) {
             extensions: extensionsDefinitions,
             eventCollector: param[1],
             extensionProtocols: [],
-            apiSchemaFragment: apiSchemaFragment,
+            apiSchemaFragment: apiSchemaFragmentPayload,
             apiTarget: capturedDeployTarget,
-            structure: pluginStructure,
+            structure: structurePayload,
             dcbEventLog: param[2],
             kind: Stdlib_Option.getOr(Stdlib_Option.flatMap(Plugin_Helpers$ReventlessCore.pluginMetadataRegistry.contents, m => m.kind), "Domain")
           }));

package/src/plugin/component/Plugin_Helpers.res

@@ -785,6 +785,27 @@ let clearOnPluginDeployed = () => {
   onPluginDeployedHook.contents = None
 }
 
+// ---------------------------------------------------------------------------
+// Deploy-time offload hook — content-addresses a large pluginDefinition field
+// to an object store and returns the reference. Set by a provider that can
+// write objects (AWS creates a BucketObject); unset on the local platform, so
+// the fields stay Inline. `bytes` is the already-serialized JSON of the value;
+// the provider hashes it, stores it at `sha256/<hash>`, and returns the ref.
+// Fired synchronously at graph-construction time (the value is concrete and a
+// resource cannot be created inside a Pulumi.Output.apply).
+// ---------------------------------------------------------------------------
+let offloadHook: ref<option<(~store: string, ~bytes: string) => Reventless.Offload.offloadedRef>> = ref(
+  None,
+)
+
+let registerOffload = (hook: (~store: string, ~bytes: string) => Reventless.Offload.offloadedRef) => {
+  offloadHook.contents = Some(hook)
+}
+
+let clearOffload = () => {
+  offloadHook.contents = None
+}
+
 // ---------------------------------------------------------------------------
 // Platform-deployed hook — fires after deployPlatform / makePlatform
 // completes, providing platform-level metadata with resolved values.

package/src/plugin/component/Plugin_Helpers.res.mjs

@@ -418,6 +418,18 @@ function clearOnPluginDeployed() {
   onPluginDeployedHook.contents = undefined;
 }
 
+let offloadHook = {
+  contents: undefined
+};
+
+function registerOffload(hook) {
+  offloadHook.contents = hook;
+}
+
+function clearOffload() {
+  offloadHook.contents = undefined;
+}
+
 let onPlatformDeployedHook = {
   contents: undefined
 };
@@ -1015,6 +1027,9 @@ export {
   onPluginDeployedHook,
   registerOnPluginDeployed,
   clearOnPluginDeployed,
+  offloadHook,
+  registerOffload,
+  clearOffload,
   onPlatformDeployedHook,
   lastPlatformDeployedInfo,
   registerOnPlatformDeployed,

package/src/plugin/lifecycle/PluginsReadModelSpec.res

@@ -24,13 +24,15 @@ type state = {
   extensions: array<Reventless.Plugin.extensionDefinition>,
   status: status,
   statusChange: Message.statusChange,
-  apiSchemaFragment: @s.matches(Reventless.Plugin.apiSchemaFragmentOptionSchema) option<Reventless.Plugin.apiSchemaFragment>,
+  apiSchemaFragment: @s.matches(Reventless.Plugin.apiSchemaFragmentOffloadSchema)
+    option<Reventless.Offload.payload<Reventless.Plugin.apiSchemaFragment>>,
   // API target for split-API schema routing. Absent/None means "Domain" (backward compat).
   // "Platform" → excluded from DomainApi runtime schema stitching in updateApiSchema.
   apiTarget?: string,
   // Plugin structure (component metadata) — surfaced via Platform_ComponentDefinitions.
   // None for older plugins whose protocol version did not carry the field.
-  structure: @s.matches(Reventless.Plugin.pluginStructureOptionSchema) option<Reventless.Plugin.pluginStructure>,
+  structure: @s.matches(Reventless.Plugin.pluginStructureOffloadSchema)
+    option<Reventless.Offload.payload<Reventless.Plugin.pluginStructure>>,
   // DCB EventLog definition for plugins that bundle a DcbEventLog component.
   // Admin's manageSubscriptions uses this to wire cross-plugin SNS subscriptions
   // from this plugin's DCB topic → peer EventCollectors (and vice-versa). None
@@ -72,9 +74,9 @@ type queryResult = {
   extensionNames: array<string>,
   extensions: array<Reventless.Plugin.extensionDefinition>,
   status: status,
-  apiSchemaFragment: option<Reventless.Plugin.apiSchemaFragment>,
+  apiSchemaFragment: option<Reventless.Offload.payload<Reventless.Plugin.apiSchemaFragment>>,
   apiTarget?: string,
-  structure: option<Reventless.Plugin.pluginStructure>,
+  structure: option<Reventless.Offload.payload<Reventless.Plugin.pluginStructure>>,
   dcbEventLog: option<Reventless.Plugin.dcbEventLogDefinition>,
   kind: option<Reventless.Plugin.pluginKind>,
 }

package/src/plugin/lifecycle/PluginsReadModelSpec.res.mjs

@@ -23,9 +23,9 @@ let stateSchema = S.schema(s => ({
   extensions: s.m(S.array(Plugin$Reventless.extensionDefinitionSchema)),
   status: s.m(statusSchema),
   statusChange: s.m(Message$ReventlessCore.statusChangeSchema),
-  apiSchemaFragment: s.m(Plugin$Reventless.apiSchemaFragmentOptionSchema),
+  apiSchemaFragment: s.m(Plugin$Reventless.apiSchemaFragmentOffloadSchema),
   apiTarget: s.m(S.option(S.string)),
-  structure: s.m(Plugin$Reventless.pluginStructureOptionSchema),
+  structure: s.m(Plugin$Reventless.pluginStructureOffloadSchema),
   dcbEventLog: s.m(Plugin$Reventless.dcbEventLogOptionSchema),
   kind: s.m(S.option(Plugin$Reventless.pluginKindSchema)),
   otherConnectedVersions: s.m(S.array(Plugin$Reventless.versionSchema))

package/tests/message/MessageTest.res

@@ -109,7 +109,7 @@ describe("Message should", () => {
       extensionProtocols: [],
       apiSchemaFragment: None,
       apiTarget: None,
-      structure: Some({
+      structure: Some(Reventless.Offload.Inline({
         readModels: [],
         stateViewSlices: [],
         stateChangeSlices: [],
@@ -132,7 +132,7 @@ describe("Message should", () => {
         extensionPoints: None,
         requiredStores: None,
         requiredStoreDeclarations: None,
-      }),
+      })),
       dcbEventLog: None,
       kind: Domain,
     }
@@ -186,7 +186,8 @@ describe("Message should", () => {
         },
       )->toBe("Domain")
       expect(d.apiSchemaFragment->Option.isNone)->toBe(true)
-      let structure: Reventless.Plugin.pluginStructure = d.structure->Option.getOrThrow
+      let structure: Reventless.Plugin.pluginStructure =
+        d.structure->Option.flatMap(Reventless.Offload.getInline)->Option.getOrThrow
       let agg = structure.aggregates->Array.getUnsafe(0)
       expect(agg.events->Array.length)->toBe(0)
       expect(agg.chapter->Option.isNone)->toBe(true)

package/tests/message/MessageTest.res.mjs

@@ -2,6 +2,7 @@
 
 import * as S from "sury/src/S.res.mjs";
 import * as Stdlib_Option from "@rescript/runtime/lib/es6/Stdlib_Option.js";
+import * as Offload$Reventless from "@reventlessdev/reventless-spec/src/semantic/Offload.res.mjs";
 import * as Message$ReventlessCore from "../../src/Message.res.mjs";
 import * as PluginSpec$ReventlessCore from "../../src/plugin/lifecycle/PluginSpec.res.mjs";
 
@@ -100,26 +101,29 @@ globalThis.describe("Message should", () => {
       apiSchemaFragment: undefined,
       apiTarget: undefined,
       structure: {
-        readModels: [],
-        stateViewSlices: [],
-        stateChangeSlices: [],
-        aggregates: [{
-            name: "Order",
-            commands: [],
-            producedEventTypes: [],
-            consumedEventTypes: [],
-            linkedViews: [],
-            consistencyRead: undefined,
-            events: [],
-            chapter: undefined
-          }],
-        automationSlices: [],
-        outboundTranslationSlices: [],
-        inboundTranslationSlices: [],
-        extensions: [],
-        extensionPoints: undefined,
-        requiredStores: undefined,
-        requiredStoreDeclarations: undefined
+        TAG: "Inline",
+        _0: {
+          readModels: [],
+          stateViewSlices: [],
+          stateChangeSlices: [],
+          aggregates: [{
+              name: "Order",
+              commands: [],
+              producedEventTypes: [],
+              consumedEventTypes: [],
+              linkedViews: [],
+              consistencyRead: undefined,
+              events: [],
+              chapter: undefined
+            }],
+          automationSlices: [],
+          outboundTranslationSlices: [],
+          inboundTranslationSlices: [],
+          extensions: [],
+          extensionPoints: undefined,
+          requiredStores: undefined,
+          requiredStoreDeclarations: undefined
+        }
       },
       dcbEventLog: undefined,
       kind: "Domain"
@@ -169,7 +173,7 @@ globalThis.describe("Message should", () => {
       tmp = match === "Domain" ? "Domain" : "other";
       globalThis.expect(tmp).toBe("Domain");
       globalThis.expect(Stdlib_Option.isNone(d$1.apiSchemaFragment)).toBe(true);
-      let structure = Stdlib_Option.getOrThrow(d$1.structure, undefined);
+      let structure = Stdlib_Option.getOrThrow(Stdlib_Option.flatMap(d$1.structure, Offload$Reventless.getInline), undefined);
       let agg = structure.aggregates[0];
       globalThis.expect(agg.events.length).toBe(0);
       globalThis.expect(Stdlib_Option.isNone(agg.chapter)).toBe(true);