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

package/CHANGELOG.md

@@ -3,6 +3,13 @@
 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.204 (2026-08-02)
+
+### Bug Fixes
+
+* **core:** store offloaded plugin structure untagged in the read model ([9036991](https://github.com/ReventlessDev/reventless-core/commit/9036991d9fbc7bbb01157fa58be1702ea4ba36d1))
+
+
 # 3.0.0-alpha.203 (2026-08-02)
 
 ### Bug Fixes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reventlessdev/reventless-core",
-  "version": "3.0.0-alpha.203",
+  "version": "3.0.0-alpha.204",
   "description": "Core package for Reventless framework",
   "license": "Apache-2.0",
   "jest": {
@@ -31,14 +31,14 @@
     "@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.1",
-    "@reventlessdev/rescript-pulumi-pulumi": "2.3.0-alpha.18",
+    "@reventlessdev/rescript-jest": "1.0.0-alpha.10",
     "@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/rescript-pulumi-pulumi": "2.3.0-alpha.18",
     "@reventlessdev/rescript-uuid": "2.0.0-alpha.0",
-    "@reventlessdev/reventless-spec": "3.0.0-alpha.95"
+    "@reventlessdev/reventless-infra": "3.0.0-alpha.121",
+    "@reventlessdev/reventless-interop": "3.0.0-alpha.30",
+    "@reventlessdev/reventless-spec": "3.0.0-alpha.96"
   },
   "devDependencies": {
     "rescript": "12.3.0",

package/src/plugin/lifecycle/PluginsProjection.res

@@ -54,8 +54,17 @@ let displayState = (
     extensions: def.extensions,
     status,
     statusChange,
-    apiSchemaFragment: def.apiSchemaFragment,
-    structure: def.structure,
+    // Store the offloadable fields as their untagged wire JSON (bare value, or an
+    // `{$offload: {...}}` reference), not the `Offload.payload` variant: the QueryDb
+    // write path marshals the raw ReScript value, so a variant would land in DynamoDB
+    // as `{TAG, _0}`. The ComponentDefinitions Lambda then reads structure back and
+    // resolves the sentinel.
+    apiSchemaFragment: def.apiSchemaFragment->Option.map(
+      Reventless.Offload.toJson(Reventless.Plugin.apiSchemaFragmentSchema, _),
+    ),
+    structure: def.structure->Option.map(
+      Reventless.Offload.toJson(Reventless.Plugin.pluginStructureSchema, _),
+    ),
     dcbEventLog: def.dcbEventLog,
     // A freshly projected row always knows its kind (the definition carries it as a
     // mandatory field). `option` here is purely for rows persisted before `kind`

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

@@ -3,6 +3,8 @@
 import * as Stdlib_Array from "@rescript/runtime/lib/es6/Stdlib_Array.js";
 import * as Id$Reventless from "@reventlessdev/reventless-spec/src/types/Id.res.mjs";
 import * as Stdlib_Option from "@rescript/runtime/lib/es6/Stdlib_Option.js";
+import * as Plugin$Reventless from "@reventlessdev/reventless-spec/src/components/Plugin.res.mjs";
+import * as Offload$Reventless from "@reventlessdev/reventless-spec/src/semantic/Offload.res.mjs";
 import * as Plugin$ReventlessCore from "../component/Plugin.res.mjs";
 import * as Projection$Reventless from "@reventlessdev/reventless-spec/src/types/Projection.res.mjs";
 import * as PluginSpec$ReventlessCore from "./PluginSpec.res.mjs";
@@ -70,8 +72,8 @@ function displayState(def, status, statusChange, otherConnectedVersions) {
   let base_extensionPointNames = def.extensionPoints.map(extensionPoint => extensionPoint.name);
   let base_extensionNames = def.extensions.map(extension => extension.extensionPointName);
   let base_extensions = def.extensions;
-  let base_apiSchemaFragment = def.apiSchemaFragment;
-  let base_structure = def.structure;
+  let base_apiSchemaFragment = Stdlib_Option.map(def.apiSchemaFragment, __x => Offload$Reventless.toJson(Plugin$Reventless.apiSchemaFragmentSchema, __x));
+  let base_structure = Stdlib_Option.map(def.structure, __x => Offload$Reventless.toJson(Plugin$Reventless.pluginStructureSchema, __x));
   let base_dcbEventLog = def.dcbEventLog;
   let base_kind = def.kind;
   let base_otherConnectedVersions = without(otherConnectedVersions, def.version);

package/src/plugin/lifecycle/PluginsReadModelSpec.res

@@ -24,15 +24,22 @@ type state = {
   extensions: array<Reventless.Plugin.extensionDefinition>,
   status: status,
   statusChange: Message.statusChange,
-  apiSchemaFragment: @s.matches(Reventless.Plugin.apiSchemaFragmentOffloadSchema)
-    option<Reventless.Offload.payload<Reventless.Plugin.apiSchemaFragment>>,
+  // Stored as the **untagged** offload wire JSON (a bare fragment, or an
+  // `{$offload: {...}}` reference) — NOT the `Offload.payload` variant. The QueryDb
+  // write path marshals the raw ReScript value straight to DynamoDB without
+  // sury-encoding through this field's schema, so a variant would persist as its
+  // runtime `{TAG, _0}` shape and no reader could parse it. UI-excluded
+  // (PluginBaseFragment.pluginUIOnlyExcludeFields), so JSON.t typing costs no
+  // GraphQL consumer. PluginsProjection.displayState writes it via Offload.toJson.
+  apiSchemaFragment: option<JSON.t>,
   // 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.pluginStructureOffloadSchema)
-    option<Reventless.Offload.payload<Reventless.Plugin.pluginStructure>>,
+  // None for older plugins whose protocol version did not carry the field. Same
+  // untagged-JSON storage as apiSchemaFragment above; the ComponentDefinitions
+  // Lambda detects the `$offload` sentinel and resolves it from S3.
+  structure: option<JSON.t>,
   // 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
@@ -74,9 +81,9 @@ type queryResult = {
   extensionNames: array<string>,
   extensions: array<Reventless.Plugin.extensionDefinition>,
   status: status,
-  apiSchemaFragment: option<Reventless.Offload.payload<Reventless.Plugin.apiSchemaFragment>>,
+  apiSchemaFragment: option<JSON.t>,
   apiTarget?: string,
-  structure: option<Reventless.Offload.payload<Reventless.Plugin.pluginStructure>>,
+  structure: option<JSON.t>,
   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.apiSchemaFragmentOffloadSchema),
+  apiSchemaFragment: s.m(S.option(S.json)),
   apiTarget: s.m(S.option(S.string)),
-  structure: s.m(Plugin$Reventless.pluginStructureOffloadSchema),
+  structure: s.m(S.option(S.json)),
   dcbEventLog: s.m(Plugin$Reventless.dcbEventLogOptionSchema),
   kind: s.m(S.option(Plugin$Reventless.pluginKindSchema)),
   otherConnectedVersions: s.m(S.array(Plugin$Reventless.versionSchema))