@reventlessdev/reventless-spec 3.0.0-alpha.94 → 3.0.0-alpha.96

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.96 (2026-08-02)
+
+### Bug Fixes
+
+* **spec:** add Offload.toJson to serialize a payload as untagged wire JSON ([6a4c60f](https://github.com/ReventlessDev/reventless-core/commit/6a4c60f606dd6657082981acf75a90070099bf29))
+
+
+# 3.0.0-alpha.95 (2026-08-02)
+
+**Note:** Version bump only for package @reventlessdev/reventless-spec
+
+
+
+
+
 # 3.0.0-alpha.94 (2026-08-02)
 
 ### Features

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reventlessdev/reventless-spec",
-  "version": "3.0.0-alpha.94",
+  "version": "3.0.0-alpha.96",
   "description": "Specifications for Reventless",
   "license": "Apache-2.0",
   "bin": {
@@ -21,7 +21,7 @@
     "sury": "11.0.0-alpha.4",
     "sury-ppx": "11.0.0-alpha.2",
     "yaml": "^2.8.3",
-    "@reventlessdev/rescript-node": "2.0.0-alpha.0"
+    "@reventlessdev/rescript-node": "2.0.0-alpha.1"
   },
   "devDependencies": {
     "rescript": "12.3.0",

package/src/semantic/Offload.res

@@ -146,6 +146,14 @@ let optionSchema = (
     ~payload=StoredIn({plugin, store}),
   )
 
+/** Serialize a payload to its **untagged** wire JSON: `Inline` becomes the bare
+    inner value's JSON, `Offloaded` becomes `{"$offload": {...}}`. Used where a
+    payload must be stored as a plain JSON blob rather than the ReScript variant —
+    e.g. the plugin read model, whose DynamoDB write path marshals the raw value
+    and would otherwise persist the variant's runtime `{TAG, _0}` shape. */
+let toJson = (inner: S.t<'a>, payload: payload<'a>): JSON.t =>
+  payload->S.reverseConvertToJsonOrThrow(schema(inner))
+
 /** The inline value, if this payload is `Inline`. `None` for `Offloaded` — a
     caller that must handle both arms uses `resolve` (async, fetches the ref); a
     caller that only ever sees inline values (a test, or a path where offloading

package/src/semantic/Offload.res.mjs

@@ -81,6 +81,10 @@ function optionSchema(plugin, store, inner) {
   });
 }
 
+function toJson(inner, payload) {
+  return S.reverseConvertToJsonOrThrow(payload, schema(inner));
+}
+
 function getInline(payload) {
   if (payload.TAG === "Inline") {
     return Primitive_option.some(payload._0);
@@ -148,6 +152,7 @@ export {
   schema,
   forStore,
   optionSchema,
+  toJson,
   getInline,
   prepare,
   resolve,