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

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.203 (2026-08-02)
+
+### Bug Fixes
+
+* **core:** run the offload hook at graph-construction, not inside .apply ([5a102f1](https://github.com/ReventlessDev/reventless-core/commit/5a102f149d6d218cdeeb28dbf9bded1d6fb1252e))
+
+
+# 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.203",
   "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-fast-csv": "2.0.0-alpha.1",
     "@reventlessdev/rescript-hash-object": "1.2.0-alpha.14",
     "@reventlessdev/rescript-jest": "1.0.0-alpha.10",
-    "@reventlessdev/rescript-node": "2.0.0-alpha.0",
+    "@reventlessdev/rescript-node": "2.0.0-alpha.1",
     "@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/rescript-ssh2": "2.0.0-alpha.1",
+    "@reventlessdev/reventless-infra": "3.0.0-alpha.120",
     "@reventlessdev/reventless-interop": "3.0.0-alpha.30",
-    "@reventlessdev/reventless-spec": "3.0.0-alpha.93"
+    "@reventlessdev/rescript-uuid": "2.0.0-alpha.0",
+    "@reventlessdev/reventless-spec": "3.0.0-alpha.95"
   },
   "devDependencies": {
     "rescript": "12.3.0",

package/src/plugin/component/Plugin_Builder.res

@@ -606,6 +606,32 @@ module Make = (
       | None => Pulumi.Output.make()
       }
 
+      // 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. Computed
+      // HERE, at graph-construction time — both values are concrete and the hook
+      // (which creates the object resource) MUST run outside the Pulumi.Output.apply
+      // below: a resource cannot be created inside .apply, and an apply callback is
+      // skipped entirely on `pulumi preview` when its inputs are still unknown.
+      // 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")
+        )
+
       (
         (interstackAdminExtensionPoints, localAdminResolvedEP, schemaPushed)->Pulumi.Output.all3,
         aggregateResources->Pulumi.Output.allDict,
@@ -769,9 +795,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";
@@ -420,6 +421,22 @@ function Make(Spec) {
         });
         let pushSchema = Spec.hooks.preResolversSchemaHook;
         let schemaPushed = pushSchema !== undefined ? pushSchema(extra$1, version, apiSchemaFragment) : Pulumi.output();
+        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 builderOutputs = Pulumi.all([
           Pulumi.all([
             interstackAdminExtensionPoints,
@@ -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);