@reventlessdev/reventless-local 3.0.0-alpha.159 → 3.0.0-alpha.160

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.160 (2026-07-20)
+
+### Features
+
+* **core:** annotate comp + causationId at the dispatch boundary ([ef6d56d](https://github.com/ReventlessDev/reventless-core/commit/ef6d56d0104dbdb21b7cfbb8f3b2b1ead9787595))
+
+
 # 3.0.0-alpha.159 (2026-07-17)
 
 **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.159",
+  "version": "3.0.0-alpha.160",
   "description": "Local platform for Reventless (in-memory or SQLite backend, for development and testing without AWS)",
   "license": "Apache-2.0",
   "jest": {
@@ -31,16 +31,16 @@
     "graphql-yoga": "^5.21.0",
     "sury": "11.0.0-alpha.4",
     "ws": "^8.18.0",
-    "@reventlessdev/rescript-effect": "0.1.0-alpha.29",
-    "@reventlessdev/rescript-jest": "1.0.0-alpha.9",
     "@reventlessdev/rescript-graphql-yoga": "1.0.0-alpha.24",
+    "@reventlessdev/rescript-effect": "0.1.0-alpha.29",
     "@reventlessdev/rescript-mcp-sdk": "1.0.0-alpha.20",
+    "@reventlessdev/rescript-jest": "1.0.0-alpha.9",
     "@reventlessdev/rescript-pulumi-pulumi": "2.3.0-alpha.17",
-    "@reventlessdev/reventless-core": "3.0.0-alpha.172",
-    "@reventlessdev/reventless-graphql-server": "1.0.0-alpha.19",
-    "@reventlessdev/reventless-gwt": "1.0.0-alpha.119",
+    "@reventlessdev/reventless-core": "3.0.0-alpha.173",
     "@reventlessdev/reventless-infra": "3.0.0-alpha.102",
-    "@reventlessdev/reventless-postgres": "3.0.0-alpha.36",
+    "@reventlessdev/reventless-graphql-server": "1.0.0-alpha.20",
+    "@reventlessdev/reventless-postgres": "3.0.0-alpha.37",
+    "@reventlessdev/reventless-gwt": "1.0.0-alpha.120",
     "@reventlessdev/reventless-spec": "3.0.0-alpha.79"
   },
   "devDependencies": {

package/src/Platform.res.mjs

@@ -761,6 +761,7 @@ function MakeWithConfig(Config) {
     make: LocalRuntimeEnvironment$ReventlessLocal.make,
     groupBySource: LocalRuntimeEnvironment$ReventlessLocal.groupBySource,
     extractCorrelationId: LocalRuntimeEnvironment$ReventlessLocal.extractCorrelationId,
+    extractCausationId: LocalRuntimeEnvironment$ReventlessLocal.extractCausationId,
     asEventHandler: prim => prim,
     asEffectHandler: prim => prim
   })(EventCollectorChannel)({
@@ -769,6 +770,7 @@ function MakeWithConfig(Config) {
     make: LocalRuntimeEnvironment$ReventlessLocal.make,
     groupBySource: LocalRuntimeEnvironment$ReventlessLocal.groupBySource,
     extractCorrelationId: LocalRuntimeEnvironment$ReventlessLocal.extractCorrelationId,
+    extractCausationId: LocalRuntimeEnvironment$ReventlessLocal.extractCausationId,
     asEventHandler: prim => prim,
     asEffectHandler: prim => prim
   })(EventCollectorChannel))(LocalDcbEventLogStorage$ReventlessLocal.Make(Bus))(LocalEventTopicPublisher$ReventlessLocal.Make(Bus))({
@@ -2424,6 +2426,7 @@ function Make($star) {
     make: LocalRuntimeEnvironment$ReventlessLocal.make,
     groupBySource: LocalRuntimeEnvironment$ReventlessLocal.groupBySource,
     extractCorrelationId: LocalRuntimeEnvironment$ReventlessLocal.extractCorrelationId,
+    extractCausationId: LocalRuntimeEnvironment$ReventlessLocal.extractCausationId,
     asEventHandler: prim => prim,
     asEffectHandler: prim => prim
   })(EventCollectorChannel)({
@@ -2432,6 +2435,7 @@ function Make($star) {
     make: LocalRuntimeEnvironment$ReventlessLocal.make,
     groupBySource: LocalRuntimeEnvironment$ReventlessLocal.groupBySource,
     extractCorrelationId: LocalRuntimeEnvironment$ReventlessLocal.extractCorrelationId,
+    extractCausationId: LocalRuntimeEnvironment$ReventlessLocal.extractCausationId,
     asEventHandler: prim => prim,
     asEffectHandler: prim => prim
   })(EventCollectorChannel))(LocalDcbEventLogStorage$ReventlessLocal.Make(Bus))(LocalEventTopicPublisher$ReventlessLocal.Make(Bus))({

package/src/adapter/Runtime/LocalAggregateRuntime_Builder.res

@@ -31,12 +31,18 @@ module Make = (
     // The runtime's handlerRef is unused by the GraphQL resolver path, but we create a proper
     // runtime so the type is satisfied and future callers that need handlerRef will work.
     let resource = commandGenerator->ReventlessCore.Component.toPulumiResource
+    let name =
+      resource.name->ReventlessCore.ComponentType.nameOpt(ReventlessCore.CommandGenerator.componentType)
     let runtime = LocalRuntimeEnvironment.make(
-      ~name=resource.name->ReventlessCore.ComponentType.nameOpt(
-        ReventlessCore.CommandGenerator.componentType,
-      ),
+      ~name,
       ~handler=handler->Pulumi.Output.apply(h =>
-        h->LocalRuntimeEnvironment.asEffectHandler->ReventlessCore.Runtime.runEffectHandler
+        h
+        ->LocalRuntimeEnvironment.asEffectHandler
+        ->ReventlessCore.Runtime.runEffectHandler(
+          ~extractCorrelationId=LocalRuntimeEnvironment.extractCorrelationId,
+          ~extractCausationId=LocalRuntimeEnvironment.extractCausationId,
+          ~comp=name,
+        )
       ),
     )
     connect(~runtime)
@@ -50,10 +56,18 @@ module Make = (
     commandTopic,
   ) => {
     let resource = commandTopic->ReventlessCore.Component.toPulumiResource
+    let name =
+      resource.name->ReventlessCore.ComponentType.nameOpt(ReventlessCore.CommandTopic.componentType)
     let runtime = LocalRuntimeEnvironment.make(
-      ~name=resource.name->ReventlessCore.ComponentType.nameOpt(ReventlessCore.CommandTopic.componentType),
+      ~name,
       ~handler=handler->Pulumi.Output.apply(h =>
-        h->LocalRuntimeEnvironment.asEffectHandler->ReventlessCore.Runtime.runEffectHandler
+        h
+        ->LocalRuntimeEnvironment.asEffectHandler
+        ->ReventlessCore.Runtime.runEffectHandler(
+          ~extractCorrelationId=LocalRuntimeEnvironment.extractCorrelationId,
+          ~extractCausationId=LocalRuntimeEnvironment.extractCausationId,
+          ~comp=name,
+        )
       ),
     )
     connect(~runtime)
@@ -74,7 +88,13 @@ module Make = (
     let runtime = LocalRuntimeEnvironment.make(
       ~name,
       ~handler=handler->Pulumi.Output.apply(h =>
-        h->LocalRuntimeEnvironment.asEffectHandler->ReventlessCore.Runtime.runEffectHandler
+        h
+        ->LocalRuntimeEnvironment.asEffectHandler
+        ->ReventlessCore.Runtime.runEffectHandler(
+          ~extractCorrelationId=LocalRuntimeEnvironment.extractCorrelationId,
+          ~extractCausationId=LocalRuntimeEnvironment.extractCausationId,
+          ~comp=name,
+        )
       ),
     )
     let _connectResources = EventCollectorChannel.connect(

package/src/adapter/Runtime/LocalAggregateRuntime_Builder.res.mjs

@@ -12,11 +12,13 @@ function Make(Bus) {
   return CommandTopicChannel => (EventCollectorChannel => {
     let forCommandGenerator = (handler, connect, param, param$1, commandGenerator) => {
       let resource = Component$ReventlessCore.toPulumiResource(commandGenerator);
-      return connect(LocalRuntimeEnvironment$ReventlessLocal.make(ComponentType$ReventlessCore.nameOpt(resource.__name, CommandGenerator$ReventlessCore.componentType), handler.apply(Runtime$ReventlessCore.runEffectHandler), undefined, undefined, undefined));
+      let name = ComponentType$ReventlessCore.nameOpt(resource.__name, CommandGenerator$ReventlessCore.componentType);
+      return connect(LocalRuntimeEnvironment$ReventlessLocal.make(name, handler.apply(h => Runtime$ReventlessCore.runEffectHandler(LocalRuntimeEnvironment$ReventlessLocal.extractCorrelationId, LocalRuntimeEnvironment$ReventlessLocal.extractCausationId, name, undefined, h)), undefined, undefined, undefined));
     };
     let forCommandTopic = (handler, connect, param, param$1, commandTopic) => {
       let resource = Component$ReventlessCore.toPulumiResource(commandTopic);
-      return connect(LocalRuntimeEnvironment$ReventlessLocal.make(ComponentType$ReventlessCore.nameOpt(resource.__name, CommandTopic$ReventlessCore.componentType), handler.apply(Runtime$ReventlessCore.runEffectHandler), undefined, undefined, undefined));
+      let name = ComponentType$ReventlessCore.nameOpt(resource.__name, CommandTopic$ReventlessCore.componentType);
+      return connect(LocalRuntimeEnvironment$ReventlessLocal.make(name, handler.apply(h => Runtime$ReventlessCore.runEffectHandler(LocalRuntimeEnvironment$ReventlessLocal.extractCorrelationId, LocalRuntimeEnvironment$ReventlessLocal.extractCausationId, name, undefined, h)), undefined, undefined, undefined));
     };
     let forEventCollector = (handler, eventTopics, resources, param, param$1, eventCollector) => {
       let resource = Component$ReventlessCore.toPulumiResource(eventCollector);
@@ -25,7 +27,7 @@ function Make(Bus) {
       let opts = {
         parent: opts_parent
       };
-      let runtime = LocalRuntimeEnvironment$ReventlessLocal.make(name, handler.apply(Runtime$ReventlessCore.runEffectHandler), undefined, undefined, undefined);
+      let runtime = LocalRuntimeEnvironment$ReventlessLocal.make(name, handler.apply(h => Runtime$ReventlessCore.runEffectHandler(LocalRuntimeEnvironment$ReventlessLocal.extractCorrelationId, LocalRuntimeEnvironment$ReventlessLocal.extractCausationId, name, undefined, h)), undefined, undefined, undefined);
       EventCollectorChannel.connect(name, [{
           channel: eventCollector.channel,
           eventTopics: eventTopics,

package/src/adapter/Runtime/LocalEventCollectorRuntime_Builder.res

@@ -30,7 +30,13 @@ module Make = (
     let runtime = LocalRuntimeEnvironment.make(
       ~name,
       ~handler=handler->Pulumi.Output.apply(h =>
-        h->LocalRuntimeEnvironment.asEffectHandler->ReventlessCore.Runtime.runEffectHandler
+        h
+        ->LocalRuntimeEnvironment.asEffectHandler
+        ->ReventlessCore.Runtime.runEffectHandler(
+          ~extractCorrelationId=LocalRuntimeEnvironment.extractCorrelationId,
+          ~extractCausationId=LocalRuntimeEnvironment.extractCausationId,
+          ~comp=name,
+        )
       ),
     )
     let _connectResources = EventCollectorChannel.connect(

package/src/adapter/Runtime/LocalEventCollectorRuntime_Builder.res.mjs

@@ -15,7 +15,7 @@ function Make(Bus) {
       let opts = {
         parent: opts_parent
       };
-      let runtime = LocalRuntimeEnvironment$ReventlessLocal.make(name, handler.apply(Runtime$ReventlessCore.runEffectHandler), undefined, undefined, undefined);
+      let runtime = LocalRuntimeEnvironment$ReventlessLocal.make(name, handler.apply(h => Runtime$ReventlessCore.runEffectHandler(LocalRuntimeEnvironment$ReventlessLocal.extractCorrelationId, LocalRuntimeEnvironment$ReventlessLocal.extractCausationId, name, undefined, h)), undefined, undefined, undefined);
       EventCollectorChannel.connect(name, [{
           channel: eventCollector.channel,
           eventTopics: eventTopics,

package/src/adapter/Runtime/LocalPluginRuntime_Builder.res.mjs

@@ -10,6 +10,7 @@ function Make(Bus) {
     make: LocalRuntimeEnvironment$ReventlessLocal.make,
     groupBySource: LocalRuntimeEnvironment$ReventlessLocal.groupBySource,
     extractCorrelationId: LocalRuntimeEnvironment$ReventlessLocal.extractCorrelationId,
+    extractCausationId: LocalRuntimeEnvironment$ReventlessLocal.extractCausationId,
     asEventHandler: prim => prim,
     asEffectHandler: prim => prim
   })(ECChannel);

package/src/adapter/Runtime/LocalRuntimeEnvironment.res

@@ -41,14 +41,17 @@ let groupBySource = (event: JSON.t) => {
   dict
 }
 
-let extractCorrelationId = (event: event) =>
+let extractMetaField = (event: event, field) =>
   event
   ->JSON.Decode.object
   ->Option.flatMap(obj => obj->Dict.get("meta"))
   ->Option.flatMap(JSON.Decode.object)
-  ->Option.flatMap(meta => meta->Dict.get("correlationId"))
+  ->Option.flatMap(meta => meta->Dict.get(field))
   ->Option.flatMap(JSON.Decode.string)
 
+let extractCorrelationId = (event: event) => event->extractMetaField("correlationId")
+let extractCausationId = (event: event) => event->extractMetaField("causationId")
+
 external asEventHandler: 'a => ReventlessCore.Runtime.eventHandler<event, context, 'r> = "%identity"
 external asEffectHandler: 'a => ReventlessCore.Runtime.effectHandler<event, context, 'r, 'error> =
   "%identity"

package/src/adapter/Runtime/LocalRuntimeEnvironment.res.mjs

@@ -28,13 +28,23 @@ function groupBySource(event) {
   return dict;
 }
 
+function extractMetaField(event, field) {
+  return Stdlib_Option.flatMap(Stdlib_Option.flatMap(Stdlib_Option.flatMap(Stdlib_Option.flatMap(Stdlib_JSON.Decode.object(event), obj => obj["meta"]), Stdlib_JSON.Decode.object), meta => meta[field]), Stdlib_JSON.Decode.string);
+}
+
 function extractCorrelationId(event) {
-  return Stdlib_Option.flatMap(Stdlib_Option.flatMap(Stdlib_Option.flatMap(Stdlib_Option.flatMap(Stdlib_JSON.Decode.object(event), obj => obj["meta"]), Stdlib_JSON.Decode.object), meta => meta["correlationId"]), Stdlib_JSON.Decode.string);
+  return extractMetaField(event, "correlationId");
+}
+
+function extractCausationId(event) {
+  return extractMetaField(event, "causationId");
 }
 
 export {
   make,
   groupBySource,
+  extractMetaField,
   extractCorrelationId,
+  extractCausationId,
 }
 /* effect/Effect Not a pure module */

package/src/components/Aggregate_Builder.res.mjs

@@ -64,6 +64,7 @@ function MakeWithHooks(Bus) {
         make: LocalRuntimeEnvironment$ReventlessLocal.make,
         groupBySource: LocalRuntimeEnvironment$ReventlessLocal.groupBySource,
         extractCorrelationId: LocalRuntimeEnvironment$ReventlessLocal.extractCorrelationId,
+        extractCausationId: LocalRuntimeEnvironment$ReventlessLocal.extractCausationId,
         asEventHandler: prim => prim,
         asEffectHandler: prim => prim
       })({
@@ -110,6 +111,7 @@ function Make(Bus) {
       make: LocalRuntimeEnvironment$ReventlessLocal.make,
       groupBySource: LocalRuntimeEnvironment$ReventlessLocal.groupBySource,
       extractCorrelationId: LocalRuntimeEnvironment$ReventlessLocal.extractCorrelationId,
+      extractCausationId: LocalRuntimeEnvironment$ReventlessLocal.extractCausationId,
       asEventHandler: prim => prim,
       asEffectHandler: prim => prim
     })({

package/src/components/AutomationSlice_Builder.res.mjs

@@ -22,6 +22,7 @@ function Make(Bus) {
     make: LocalRuntimeEnvironment$ReventlessLocal.make,
     groupBySource: LocalRuntimeEnvironment$ReventlessLocal.groupBySource,
     extractCorrelationId: LocalRuntimeEnvironment$ReventlessLocal.extractCorrelationId,
+    extractCausationId: LocalRuntimeEnvironment$ReventlessLocal.extractCausationId,
     asEventHandler: prim => prim,
     asEffectHandler: prim => prim
   })({

package/src/components/ExtensionPoint_Builder.res.mjs

@@ -13,6 +13,7 @@ function Make(Bus) {
     make: LocalRuntimeEnvironment$ReventlessLocal.make,
     groupBySource: LocalRuntimeEnvironment$ReventlessLocal.groupBySource,
     extractCorrelationId: LocalRuntimeEnvironment$ReventlessLocal.extractCorrelationId,
+    extractCausationId: LocalRuntimeEnvironment$ReventlessLocal.extractCausationId,
     asEventHandler: prim => prim,
     asEffectHandler: prim => prim
   })({
@@ -26,6 +27,7 @@ function Make(Bus) {
     make: LocalRuntimeEnvironment$ReventlessLocal.make,
     groupBySource: LocalRuntimeEnvironment$ReventlessLocal.groupBySource,
     extractCorrelationId: LocalRuntimeEnvironment$ReventlessLocal.extractCorrelationId,
+    extractCausationId: LocalRuntimeEnvironment$ReventlessLocal.extractCausationId,
     asEventHandler: prim => prim,
     asEffectHandler: prim => prim
   })({

package/src/components/OutboundTranslationSlice_Builder.res.mjs

@@ -23,6 +23,7 @@ function Make(Bus) {
     make: LocalRuntimeEnvironment$ReventlessLocal.make,
     groupBySource: LocalRuntimeEnvironment$ReventlessLocal.groupBySource,
     extractCorrelationId: LocalRuntimeEnvironment$ReventlessLocal.extractCorrelationId,
+    extractCausationId: LocalRuntimeEnvironment$ReventlessLocal.extractCausationId,
     asEventHandler: prim => prim,
     asEffectHandler: prim => prim
   })({

package/src/components/Plugin_Builder.res.mjs

@@ -31,6 +31,7 @@ function Make(Bus) {
       make: LocalRuntimeEnvironment$ReventlessLocal.make,
       groupBySource: LocalRuntimeEnvironment$ReventlessLocal.groupBySource,
       extractCorrelationId: LocalRuntimeEnvironment$ReventlessLocal.extractCorrelationId,
+      extractCausationId: LocalRuntimeEnvironment$ReventlessLocal.extractCausationId,
       asEventHandler: prim => prim,
       asEffectHandler: prim => prim
     })(EventCollectorChannel)({

package/src/components/ReadModel_Builder.res.mjs

@@ -20,6 +20,7 @@ function Make(Bus) {
     make: LocalRuntimeEnvironment$ReventlessLocal.make,
     groupBySource: LocalRuntimeEnvironment$ReventlessLocal.groupBySource,
     extractCorrelationId: LocalRuntimeEnvironment$ReventlessLocal.extractCorrelationId,
+    extractCausationId: LocalRuntimeEnvironment$ReventlessLocal.extractCausationId,
     asEventHandler: prim => prim,
     asEffectHandler: prim => prim
   })({
@@ -37,6 +38,7 @@ function Make(Bus) {
     make: LocalRuntimeEnvironment$ReventlessLocal.make,
     groupBySource: LocalRuntimeEnvironment$ReventlessLocal.groupBySource,
     extractCorrelationId: LocalRuntimeEnvironment$ReventlessLocal.extractCorrelationId,
+    extractCausationId: LocalRuntimeEnvironment$ReventlessLocal.extractCausationId,
     asEventHandler: prim => prim,
     asEffectHandler: prim => prim
   })({

package/src/components/StateViewSlice_Builder.res.mjs

@@ -26,6 +26,7 @@ function Make(Bus) {
     make: LocalRuntimeEnvironment$ReventlessLocal.make,
     groupBySource: LocalRuntimeEnvironment$ReventlessLocal.groupBySource,
     extractCorrelationId: LocalRuntimeEnvironment$ReventlessLocal.extractCorrelationId,
+    extractCausationId: LocalRuntimeEnvironment$ReventlessLocal.extractCausationId,
     asEventHandler: prim => prim,
     asEffectHandler: prim => prim
   })({

package/src/components/Task_Builder.res.mjs

@@ -15,6 +15,7 @@ function Make(Bus) {
     make: LocalRuntimeEnvironment$ReventlessLocal.make,
     groupBySource: LocalRuntimeEnvironment$ReventlessLocal.groupBySource,
     extractCorrelationId: LocalRuntimeEnvironment$ReventlessLocal.extractCorrelationId,
+    extractCausationId: LocalRuntimeEnvironment$ReventlessLocal.extractCausationId,
     asEventHandler: prim => prim,
     asEffectHandler: prim => prim
   })(LocalTaskBucket$ReventlessLocal);
@@ -26,6 +27,7 @@ function Make(Bus) {
     make: LocalRuntimeEnvironment$ReventlessLocal.make,
     groupBySource: LocalRuntimeEnvironment$ReventlessLocal.groupBySource,
     extractCorrelationId: LocalRuntimeEnvironment$ReventlessLocal.extractCorrelationId,
+    extractCausationId: LocalRuntimeEnvironment$ReventlessLocal.extractCausationId,
     asEventHandler: prim => prim,
     asEffectHandler: prim => prim
   })(EventCollectorChannel)(EventCollectorRuntimeBuilder)(TaskRuntimeBuilder)(LocalTaskBucket$ReventlessLocal)(LocalSideEffectHandler$ReventlessLocal)(Defaults);

package/tests/components/eventcollector/EventCollectorFixtures.res.mjs

@@ -31,6 +31,7 @@ let EventCollectorMaker = EventCollector_Builder$ReventlessCore.Make({
   make: LocalRuntimeEnvironment$ReventlessLocal.make,
   groupBySource: LocalRuntimeEnvironment$ReventlessLocal.groupBySource,
   extractCorrelationId: LocalRuntimeEnvironment$ReventlessLocal.extractCorrelationId,
+  extractCausationId: LocalRuntimeEnvironment$ReventlessLocal.extractCausationId,
   asEventHandler: prim => prim,
   asEffectHandler: prim => prim
 })(LocalEventCollectorChannel$ReventlessLocal.Make(Bus));

package/tests/components/sideeffecthandler/SideEffectHandlerFixtures.res.mjs

@@ -58,6 +58,7 @@ let SpecificEventCollector = EventCollector_Builder$ReventlessCore.Make({
   make: LocalRuntimeEnvironment$ReventlessLocal.make,
   groupBySource: LocalRuntimeEnvironment$ReventlessLocal.groupBySource,
   extractCorrelationId: LocalRuntimeEnvironment$ReventlessLocal.extractCorrelationId,
+  extractCausationId: LocalRuntimeEnvironment$ReventlessLocal.extractCausationId,
   asEventHandler: prim => prim,
   asEffectHandler: prim => prim
 })(EventCollectorCh);
@@ -68,6 +69,7 @@ let SEHBuilder = SideEffectHandler_Builder$ReventlessCore.Make({
   make: LocalRuntimeEnvironment$ReventlessLocal.make,
   groupBySource: LocalRuntimeEnvironment$ReventlessLocal.groupBySource,
   extractCorrelationId: LocalRuntimeEnvironment$ReventlessLocal.extractCorrelationId,
+  extractCausationId: LocalRuntimeEnvironment$ReventlessLocal.extractCausationId,
   asEventHandler: prim => prim,
   asEffectHandler: prim => prim
 })(EventCollectorCh)(SpecificEventCollector)(ECRTBuilder);