@reventlessdev/online-shop-aggregates-ordering 3.0.0-alpha.227 → 3.0.0-alpha.229

package/CHANGELOG.md

@@ -3,6 +3,38 @@
 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.229 (2026-08-27)
+
+**Note:** Version bump only for package @reventlessdev/online-shop-aggregates-ordering
+
+
+
+
+
+# 3.0.0-alpha.228 (2026-08-27)
+
+### Bug Fixes
+
+* **ppx:** follow a let-bound action array merged into an arm's result ([230c72e](https://github.com/ReventlessDev/reventless-core/commit/230c72e25856d8ed20d0860e742b133b2c672d4a))
+* feat(spec)!: reflect the command direction across a port, both halves ([f2fe258](https://github.com/ReventlessDev/reventless-core/commit/f2fe258d195b74f4a61488edee305665341020ea))
+* feat(spec)!: read the port's translation table off the mapping's arms ([956348a](https://github.com/ReventlessDev/reventless-core/commit/956348a9fcb256cfff9db51809bdc27d73360e6c))
+
+### BREAKING CHANGES
+
+* `ExtensionPointMapping.Mapping` gains `acceptedCommands` and
+`ExtensionMapping.Mapping` gains `issuedCommands`; both are derived, so a
+mapping the ppx can read needs no source change, and one it cannot names itself
+at compile time. Definitions persisted before the two new def fields must be
+re-emitted before a consumer can read them as present — and until then they
+decode as None, which means unknown, not "issues nothing".
+* `ExtensionPointMapping.Mapping` requires `publishedEvents` and
+`ExtensionMapping.Mapping` requires `handledEvents`; the ppx injects both for
+mappings it can read, so app code must build against the matching ppx. Plugin
+definitions persisted before the new fields must be re-emitted before a consumer
+reads them as present.
+
+
+
 # 3.0.0-alpha.227 (2026-08-23)
 
 **Note:** Version bump only for package @reventlessdev/online-shop-aggregates-ordering

package/lib/bs/.compiler.log

@@ -1,2 +1,2 @@
-#Start(1787509261970)
-#Done(1787509267894)
+#Start(1787841657084)
+#Done(1787841661491)

package/lib/bs/compiler-info.json

@@ -4,5 +4,5 @@
   "bsc_hash": "75e3a59c95cc953608fd3dd6ea6ed68141bba4414a20a52f114261b8a48385fa",
   "rescript_config_hash": "4c884bf958b93b21c77764e35498f269b81377cfcc324135f1ab7a1cc5b569cb",
   "runtime_path": "/home/runner/work/reventless-core/reventless-core/node_modules/@rescript/runtime",
-  "generated_at": "1787509267896"
+  "generated_at": "1787841661503"
 }

package/lib/bs/src/Extension/Products_Extension.res

@@ -9,6 +9,7 @@ module Mapping = {
 
   open ExtensionPoint
   open Delegate
+
   let mapIncomingEvent = (_id, event, _meta, _pluginDef, _queryEngine) =>
     switch event {
     | ProductBecameAvailable({productId, name, price}) => [

package/lib/bs/src/Extension/Products_Extension.res.mjs

@@ -25,11 +25,26 @@ function mapIncomingEvent(_id, event, _meta, _pluginDef, _queryEngine) {
   }
 }
 
+let handledEvents = [
+  {
+    name: "ProductBecameAvailable",
+    toCommandTypes: ["Sync"]
+  },
+  {
+    name: "ProductPriceChanged",
+    toCommandTypes: ["UpdatePrice"]
+  }
+];
+
+let issuedCommands = [];
+
 let Mapping = {
   ExtensionPoint: undefined,
   Delegate: undefined,
   mapIncomingEvent: mapIncomingEvent,
   mapOutgoingEvent: undefined,
+  handledEvents: handledEvents,
+  issuedCommands: issuedCommands,
   delegateModuleUrl: CatalogProduct$OrderingPlugin.moduleUrl,
   moduleUrl: "@reventlessdev/online-shop-aggregates-ordering/src/Extension/Products_Extension.res.mjs"
 };

package/lib/bs/src/ExtensionPoint/Orders_ExtensionPointMapping.res

@@ -1,5 +1,5 @@
-// Maps internal Order aggregate events to the stable OrdersExtensionPoint public API.
-// Decomposes a batch OrderPlaced (multiple productIds) into one ItemOrdered per product.
+// Maps internal Order events to the OrdersExtensionPoint public API, one published
+// event per product in a batch.
 @@reventless.spec
 
 module ExtensionPoint = OrderingSpec.Orders_ExtensionPoint

package/lib/bs/src/ExtensionPoint/Orders_ExtensionPointMapping.res.mjs

@@ -37,6 +37,19 @@ let mapOutgoingEvent = (_id, event, _meta, _queryEngine) => {
   }
 };
 
+let publishedEvents = [
+  {
+    name: "ItemOrdered",
+    fromEventTypes: ["Placed"]
+  },
+  {
+    name: "ItemOrderCancelled",
+    fromEventTypes: ["Cancelled"]
+  }
+];
+
+let acceptedCommands = [];
+
 let name = "Orders";
 
 let Id;
@@ -55,5 +68,7 @@ export {
   mapIncomingCommand,
   mapOutgoingEvent,
   moduleUrl,
+  publishedEvents,
+  acceptedCommands,
 }
 /* No side effect */

package/lib/bs/src/Plugin.res.mjs

@@ -143,7 +143,9 @@ function Make(Platform) {
     },
     moduleUrl: Orders_ExtensionPointMapping$OrderingPlugin.moduleUrl,
     mapIncomingCommand: Orders_ExtensionPointMapping$OrderingPlugin.mapIncomingCommand,
-    mapOutgoingEvent: Orders_ExtensionPointMapping$OrderingPlugin.mapOutgoingEvent
+    mapOutgoingEvent: Orders_ExtensionPointMapping$OrderingPlugin.mapOutgoingEvent,
+    publishedEvents: Orders_ExtensionPointMapping$OrderingPlugin.publishedEvents,
+    acceptedCommands: Orders_ExtensionPointMapping$OrderingPlugin.acceptedCommands
   });
   let Products_Extension = Platform.Extension.Make({
     ExtensionPoint: {
@@ -165,7 +167,9 @@ function Make(Platform) {
     moduleUrl: Products_Extension$OrderingPlugin.Mapping.moduleUrl,
     delegateModuleUrl: Products_Extension$OrderingPlugin.Mapping.delegateModuleUrl,
     mapIncomingEvent: Products_Extension$OrderingPlugin.Mapping.mapIncomingEvent,
-    mapOutgoingEvent: Products_Extension$OrderingPlugin.Mapping.mapOutgoingEvent
+    mapOutgoingEvent: Products_Extension$OrderingPlugin.Mapping.mapOutgoingEvent,
+    handledEvents: Products_Extension$OrderingPlugin.Mapping.handledEvents,
+    issuedCommands: Products_Extension$OrderingPlugin.Mapping.issuedCommands
   });
   let pluginStructure = Platform.Plugin.makePluginDefinition("Ordering", [
     CatalogProductAggregate,
@@ -194,7 +198,9 @@ function Make(Platform) {
       },
       moduleUrl: Orders_ExtensionPointMapping$OrderingPlugin.moduleUrl,
       mapIncomingCommand: Orders_ExtensionPointMapping$OrderingPlugin.mapIncomingCommand,
-      mapOutgoingEvent: Orders_ExtensionPointMapping$OrderingPlugin.mapOutgoingEvent
+      mapOutgoingEvent: Orders_ExtensionPointMapping$OrderingPlugin.mapOutgoingEvent,
+      publishedEvents: Orders_ExtensionPointMapping$OrderingPlugin.publishedEvents,
+      acceptedCommands: Orders_ExtensionPointMapping$OrderingPlugin.acceptedCommands
     }], Object.fromEntries([
     [
       "AvailableProducts",

package/lib/bs/tests/Extension/Products_Extension_GWT.res.mjs

@@ -26,7 +26,9 @@ let include = Delegate_GWT$ReventlessGwt.FromExtension({
   moduleUrl: Products_Extension$OrderingPlugin.Mapping.moduleUrl,
   delegateModuleUrl: Products_Extension$OrderingPlugin.Mapping.delegateModuleUrl,
   mapIncomingEvent: Products_Extension$OrderingPlugin.Mapping.mapIncomingEvent,
-  mapOutgoingEvent: Products_Extension$OrderingPlugin.Mapping.mapOutgoingEvent
+  mapOutgoingEvent: Products_Extension$OrderingPlugin.Mapping.mapOutgoingEvent,
+  handledEvents: Products_Extension$OrderingPlugin.Mapping.handledEvents,
+  issuedCommands: Products_Extension$OrderingPlugin.Mapping.issuedCommands
 });
 
 let describe = include.describe;

package/lib/bs/tests/ExtensionPoint/Orders_ExtensionPointMapping_GWT.res.mjs

@@ -25,7 +25,9 @@ let include = Delegate_GWT$ReventlessGwt.FromExtensionPoint({
   },
   moduleUrl: Orders_ExtensionPointMapping$OrderingPlugin.moduleUrl,
   mapIncomingCommand: Orders_ExtensionPointMapping$OrderingPlugin.mapIncomingCommand,
-  mapOutgoingEvent: Orders_ExtensionPointMapping$OrderingPlugin.mapOutgoingEvent
+  mapOutgoingEvent: Orders_ExtensionPointMapping$OrderingPlugin.mapOutgoingEvent,
+  publishedEvents: Orders_ExtensionPointMapping$OrderingPlugin.publishedEvents,
+  acceptedCommands: Orders_ExtensionPointMapping$OrderingPlugin.acceptedCommands
 });
 
 let describe = include.describe;

package/lib/ocaml/.compiler.log

@@ -1,2 +1,2 @@
-#Start(1787509261970)
-#Done(1787509267894)
+#Start(1787841657084)
+#Done(1787841661491)

package/lib/ocaml/Orders_ExtensionPointMapping.res

@@ -1,5 +1,5 @@
-// Maps internal Order aggregate events to the stable OrdersExtensionPoint public API.
-// Decomposes a batch OrderPlaced (multiple productIds) into one ItemOrdered per product.
+// Maps internal Order events to the OrdersExtensionPoint public API, one published
+// event per product in a batch.
 @@reventless.spec
 
 module ExtensionPoint = OrderingSpec.Orders_ExtensionPoint

package/lib/ocaml/Products_Extension.res

@@ -9,6 +9,7 @@ module Mapping = {
 
   open ExtensionPoint
   open Delegate
+
   let mapIncomingEvent = (_id, event, _meta, _pluginDef, _queryEngine) =>
     switch event {
     | ProductBecameAvailable({productId, name, price}) => [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reventlessdev/online-shop-aggregates-ordering",
-  "version": "3.0.0-alpha.227",
+  "version": "3.0.0-alpha.229",
   "description": "Online Shop example — Ordering plugin (Customer & Order aggregates)",
   "license": "Apache-2.0",
   "jest": {
@@ -21,18 +21,18 @@
   },
   "dependencies": {
     "sury": "11.0.0-rc.2",
-    "@reventlessdev/online-shop-aggregates-catalog-spec": "3.0.0-alpha.122",
+    "@reventlessdev/online-shop-aggregates-catalog-spec": "3.0.0-alpha.123",
+    "@reventlessdev/online-shop-aggregates-ordering-spec": "3.0.0-alpha.123",
     "@reventlessdev/rescript-pulumi-pulumi": "2.3.0-alpha.19",
-    "@reventlessdev/reventless-gwt": "1.0.0-alpha.197",
-    "@reventlessdev/online-shop-aggregates-ordering-spec": "3.0.0-alpha.122",
-    "@reventlessdev/reventless-infra": "3.0.0-alpha.151",
-    "@reventlessdev/reventless-local": "3.0.0-alpha.238",
-    "@reventlessdev/reventless-spec": "3.0.0-alpha.123"
+    "@reventlessdev/reventless-gwt": "1.0.0-alpha.198",
+    "@reventlessdev/reventless-infra": "3.0.0-alpha.152",
+    "@reventlessdev/reventless-local": "3.0.0-alpha.240",
+    "@reventlessdev/reventless-spec": "3.0.0-alpha.124"
   },
   "devDependencies": {
     "rescript": "12.3.0",
     "sury-ppx": "11.0.0-rc.2",
-    "@reventlessdev/reventless-ppx": "1.0.0-alpha.73"
+    "@reventlessdev/reventless-ppx": "1.0.0-alpha.74"
   },
   "peerDependencies": {
     "rescript": "12.3.0"

package/src/Extension/Products_Extension.res

@@ -9,6 +9,7 @@ module Mapping = {
 
   open ExtensionPoint
   open Delegate
+
   let mapIncomingEvent = (_id, event, _meta, _pluginDef, _queryEngine) =>
     switch event {
     | ProductBecameAvailable({productId, name, price}) => [

package/src/Extension/Products_Extension.res.mjs

@@ -25,11 +25,26 @@ function mapIncomingEvent(_id, event, _meta, _pluginDef, _queryEngine) {
   }
 }
 
+let handledEvents = [
+  {
+    name: "ProductBecameAvailable",
+    toCommandTypes: ["Sync"]
+  },
+  {
+    name: "ProductPriceChanged",
+    toCommandTypes: ["UpdatePrice"]
+  }
+];
+
+let issuedCommands = [];
+
 let Mapping = {
   ExtensionPoint: undefined,
   Delegate: undefined,
   mapIncomingEvent: mapIncomingEvent,
   mapOutgoingEvent: undefined,
+  handledEvents: handledEvents,
+  issuedCommands: issuedCommands,
   delegateModuleUrl: CatalogProduct$OrderingPlugin.moduleUrl,
   moduleUrl: "@reventlessdev/online-shop-aggregates-ordering/src/Extension/Products_Extension.res.mjs"
 };

package/src/ExtensionPoint/Orders_ExtensionPointMapping.res

@@ -1,5 +1,5 @@
-// Maps internal Order aggregate events to the stable OrdersExtensionPoint public API.
-// Decomposes a batch OrderPlaced (multiple productIds) into one ItemOrdered per product.
+// Maps internal Order events to the OrdersExtensionPoint public API, one published
+// event per product in a batch.
 @@reventless.spec
 
 module ExtensionPoint = OrderingSpec.Orders_ExtensionPoint

package/src/ExtensionPoint/Orders_ExtensionPointMapping.res.mjs

@@ -37,6 +37,19 @@ let mapOutgoingEvent = (_id, event, _meta, _queryEngine) => {
   }
 };
 
+let publishedEvents = [
+  {
+    name: "ItemOrdered",
+    fromEventTypes: ["Placed"]
+  },
+  {
+    name: "ItemOrderCancelled",
+    fromEventTypes: ["Cancelled"]
+  }
+];
+
+let acceptedCommands = [];
+
 let name = "Orders";
 
 let Id;
@@ -55,5 +68,7 @@ export {
   mapIncomingCommand,
   mapOutgoingEvent,
   moduleUrl,
+  publishedEvents,
+  acceptedCommands,
 }
 /* No side effect */

package/src/Plugin.res.mjs

@@ -143,7 +143,9 @@ function Make(Platform) {
     },
     moduleUrl: Orders_ExtensionPointMapping$OrderingPlugin.moduleUrl,
     mapIncomingCommand: Orders_ExtensionPointMapping$OrderingPlugin.mapIncomingCommand,
-    mapOutgoingEvent: Orders_ExtensionPointMapping$OrderingPlugin.mapOutgoingEvent
+    mapOutgoingEvent: Orders_ExtensionPointMapping$OrderingPlugin.mapOutgoingEvent,
+    publishedEvents: Orders_ExtensionPointMapping$OrderingPlugin.publishedEvents,
+    acceptedCommands: Orders_ExtensionPointMapping$OrderingPlugin.acceptedCommands
   });
   let Products_Extension = Platform.Extension.Make({
     ExtensionPoint: {
@@ -165,7 +167,9 @@ function Make(Platform) {
     moduleUrl: Products_Extension$OrderingPlugin.Mapping.moduleUrl,
     delegateModuleUrl: Products_Extension$OrderingPlugin.Mapping.delegateModuleUrl,
     mapIncomingEvent: Products_Extension$OrderingPlugin.Mapping.mapIncomingEvent,
-    mapOutgoingEvent: Products_Extension$OrderingPlugin.Mapping.mapOutgoingEvent
+    mapOutgoingEvent: Products_Extension$OrderingPlugin.Mapping.mapOutgoingEvent,
+    handledEvents: Products_Extension$OrderingPlugin.Mapping.handledEvents,
+    issuedCommands: Products_Extension$OrderingPlugin.Mapping.issuedCommands
   });
   let pluginStructure = Platform.Plugin.makePluginDefinition("Ordering", [
     CatalogProductAggregate,
@@ -194,7 +198,9 @@ function Make(Platform) {
       },
       moduleUrl: Orders_ExtensionPointMapping$OrderingPlugin.moduleUrl,
       mapIncomingCommand: Orders_ExtensionPointMapping$OrderingPlugin.mapIncomingCommand,
-      mapOutgoingEvent: Orders_ExtensionPointMapping$OrderingPlugin.mapOutgoingEvent
+      mapOutgoingEvent: Orders_ExtensionPointMapping$OrderingPlugin.mapOutgoingEvent,
+      publishedEvents: Orders_ExtensionPointMapping$OrderingPlugin.publishedEvents,
+      acceptedCommands: Orders_ExtensionPointMapping$OrderingPlugin.acceptedCommands
     }], Object.fromEntries([
     [
       "AvailableProducts",

package/tests/Extension/Products_Extension_GWT.res.mjs

@@ -26,7 +26,9 @@ let include = Delegate_GWT$ReventlessGwt.FromExtension({
   moduleUrl: Products_Extension$OrderingPlugin.Mapping.moduleUrl,
   delegateModuleUrl: Products_Extension$OrderingPlugin.Mapping.delegateModuleUrl,
   mapIncomingEvent: Products_Extension$OrderingPlugin.Mapping.mapIncomingEvent,
-  mapOutgoingEvent: Products_Extension$OrderingPlugin.Mapping.mapOutgoingEvent
+  mapOutgoingEvent: Products_Extension$OrderingPlugin.Mapping.mapOutgoingEvent,
+  handledEvents: Products_Extension$OrderingPlugin.Mapping.handledEvents,
+  issuedCommands: Products_Extension$OrderingPlugin.Mapping.issuedCommands
 });
 
 let describe = include.describe;

package/tests/ExtensionPoint/Orders_ExtensionPointMapping_GWT.res.mjs

@@ -25,7 +25,9 @@ let include = Delegate_GWT$ReventlessGwt.FromExtensionPoint({
   },
   moduleUrl: Orders_ExtensionPointMapping$OrderingPlugin.moduleUrl,
   mapIncomingCommand: Orders_ExtensionPointMapping$OrderingPlugin.mapIncomingCommand,
-  mapOutgoingEvent: Orders_ExtensionPointMapping$OrderingPlugin.mapOutgoingEvent
+  mapOutgoingEvent: Orders_ExtensionPointMapping$OrderingPlugin.mapOutgoingEvent,
+  publishedEvents: Orders_ExtensionPointMapping$OrderingPlugin.publishedEvents,
+  acceptedCommands: Orders_ExtensionPointMapping$OrderingPlugin.acceptedCommands
 });
 
 let describe = include.describe;