@reventlessdev/reventless-local 3.0.0-alpha.113

package/tests/components/eventlog/EventLogTest.res

@@ -0,0 +1,53 @@
+// Integration tests for EventLog_Builder with in-memory adapters.
+
+open JestGlobals
+open EventLogFixtures
+
+describe("EventLog (in-memory)", () => {
+  let _ = beforeAllAsync(async () => {
+    let _ = await eventLog->ReventlessCore.Component.operations->TestRunner.resolve
+  })
+
+  let _ = beforeEach(() => reset())
+
+  testPromise("append stores events and replay returns them", async () => {
+    let ops = await eventLog->ReventlessCore.Component.operations->TestRunner.resolve
+    let event = ItemEventLogSpec.ItemCreated({name: "Widget"})
+    let event' = makeEvent'("item-1", event)
+    let _ = await ops.append(0, "item-1", [event'])
+    let replayed = await ops.replay("item-1")
+    expect(replayed->Array.length)->toBe(1)
+    let first = replayed->Array.getUnsafe(0)
+    expect(first)->toEqual(event)
+  })
+
+  testPromise("append publishes event to event topic", async () => {
+    let ops = await eventLog->ReventlessCore.Component.operations->TestRunner.resolve
+    let event' = makeEvent'("pub-1", ItemEventLogSpec.ItemCreated({name: "Widget"}))
+    let _ = await ops.append(0, "pub-1", [event'])
+    expect(capturedTopicEventCount.contents)->toBe(1)
+  })
+
+  testPromise("replay returns empty array for unknown id", async () => {
+    let ops = await eventLog->ReventlessCore.Component.operations->TestRunner.resolve
+    let events = await ops.replay("unknown-id")
+    expect(events->Array.length)->toBe(0)
+  })
+
+  testPromise("multiple appends accumulate events", async () => {
+    let ops = await eventLog->ReventlessCore.Component.operations->TestRunner.resolve
+    let _ = await ops.append(0, "agg-1", [makeEvent'("agg-1", ItemEventLogSpec.ItemCreated({name: "First"}))])
+    let _ = await ops.append(1, "agg-1", [makeEvent'("agg-1", ItemEventLogSpec.ItemDeleted({id: "agg-1"}))])
+    let replayed = await ops.replay("agg-1")
+    expect(replayed->Array.length)->toBe(2)
+  })
+
+  testPromise("separate aggregates have independent event logs", async () => {
+    let ops = await eventLog->ReventlessCore.Component.operations->TestRunner.resolve
+    let _ = await ops.append(0, "agg-A", [makeEvent'("agg-A", ItemEventLogSpec.ItemCreated({name: "A"}))])
+    let _ = await ops.append(0, "agg-B", [makeEvent'("agg-B", ItemEventLogSpec.ItemDeleted({id: "B"}))])
+    let eventsA = await ops.replay("agg-A")
+    let eventsB = await ops.replay("agg-B")
+    expect((eventsA->Array.length, eventsB->Array.length))->toEqual((1, 1))
+  })
+})

package/tests/components/eventlog/EventLogTest.res.mjs

@@ -0,0 +1,74 @@
+// Generated by ReScript, PLEASE EDIT WITH CARE
+
+import * as Component$ReventlessCore from "@reventlessdev/reventless-core/src/components/Component.res.mjs";
+import * as TestRunner$ReventlessLocal from "../../../src/test/TestRunner.res.mjs";
+import * as EventLogFixtures$ReventlessLocal from "./EventLogFixtures.res.mjs";
+
+globalThis.describe("EventLog (in-memory)", () => {
+  globalThis.beforeAll(async () => {
+    await TestRunner$ReventlessLocal.resolve(Component$ReventlessCore.operations(EventLogFixtures$ReventlessLocal.eventLog));
+  });
+  globalThis.beforeEach(() => EventLogFixtures$ReventlessLocal.reset());
+  globalThis.test("append stores events and replay returns them", async () => {
+    let ops = await TestRunner$ReventlessLocal.resolve(Component$ReventlessCore.operations(EventLogFixtures$ReventlessLocal.eventLog));
+    let event = {
+      TAG: "ItemCreated",
+      name: "Widget"
+    };
+    let event$p = EventLogFixtures$ReventlessLocal.makeEvent$p("item-1", event);
+    await ops.append(0, "item-1", [event$p]);
+    let replayed = await ops.replay("item-1");
+    globalThis.expect(replayed.length).toBe(1);
+    let first = replayed[0];
+    globalThis.expect(first).toEqual(event);
+  });
+  globalThis.test("append publishes event to event topic", async () => {
+    let ops = await TestRunner$ReventlessLocal.resolve(Component$ReventlessCore.operations(EventLogFixtures$ReventlessLocal.eventLog));
+    let event$p = EventLogFixtures$ReventlessLocal.makeEvent$p("pub-1", {
+      TAG: "ItemCreated",
+      name: "Widget"
+    });
+    await ops.append(0, "pub-1", [event$p]);
+    globalThis.expect(EventLogFixtures$ReventlessLocal.capturedTopicEventCount.contents).toBe(1);
+  });
+  globalThis.test("replay returns empty array for unknown id", async () => {
+    let ops = await TestRunner$ReventlessLocal.resolve(Component$ReventlessCore.operations(EventLogFixtures$ReventlessLocal.eventLog));
+    let events = await ops.replay("unknown-id");
+    globalThis.expect(events.length).toBe(0);
+  });
+  globalThis.test("multiple appends accumulate events", async () => {
+    let ops = await TestRunner$ReventlessLocal.resolve(Component$ReventlessCore.operations(EventLogFixtures$ReventlessLocal.eventLog));
+    await ops.append(0, "agg-1", [EventLogFixtures$ReventlessLocal.makeEvent$p("agg-1", {
+        TAG: "ItemCreated",
+        name: "First"
+      })]);
+    await ops.append(1, "agg-1", [EventLogFixtures$ReventlessLocal.makeEvent$p("agg-1", {
+        TAG: "ItemDeleted",
+        id: "agg-1"
+      })]);
+    let replayed = await ops.replay("agg-1");
+    globalThis.expect(replayed.length).toBe(2);
+  });
+  globalThis.test("separate aggregates have independent event logs", async () => {
+    let ops = await TestRunner$ReventlessLocal.resolve(Component$ReventlessCore.operations(EventLogFixtures$ReventlessLocal.eventLog));
+    await ops.append(0, "agg-A", [EventLogFixtures$ReventlessLocal.makeEvent$p("agg-A", {
+        TAG: "ItemCreated",
+        name: "A"
+      })]);
+    await ops.append(0, "agg-B", [EventLogFixtures$ReventlessLocal.makeEvent$p("agg-B", {
+        TAG: "ItemDeleted",
+        id: "B"
+      })]);
+    let eventsA = await ops.replay("agg-A");
+    let eventsB = await ops.replay("agg-B");
+    globalThis.expect([
+      eventsA.length,
+      eventsB.length
+    ]).toEqual([
+      1,
+      1
+    ]);
+  });
+});
+
+/*  Not a pure module */

package/tests/components/eventtopic/EventTopicFixtures.res

@@ -0,0 +1,47 @@
+// Integration test fixtures for EventTopic builder (in-memory).
+
+open TestFixtures
+
+module ItemEventTopicSpec = {
+  module Id = Reventless.Id.StringPure
+  let name = "TestItemEventTopic"
+
+  @schema
+  type event = | ItemPublished({name: string}) | ItemRemoved({id: string})
+}
+
+// ─────────────────────────────────────────────────────────────
+// Bus and Pulumi setup
+// ─────────────────────────────────────────────────────────────
+
+module Bus = LocalBus.Make()
+
+// Subscribe before building to capture published events
+let capturedEventCount: ref<int> = ref(0)
+// Topic name in bus = make name ++ ComponentType.toName(EventTopic) = "TestItemEventTopic" ++ "EventTopic"
+let _ = Bus.subscribeToEvents("TestItemEventTopicEventTopic", async (_, _, _) => {
+  capturedEventCount := capturedEventCount.contents + 1
+})
+
+let _ = TestRunner.setup()
+
+// ─────────────────────────────────────────────────────────────
+// Build EventTopic using in-memory publisher
+// ─────────────────────────────────────────────────────────────
+
+module EventTopicMaker = ReventlessCore.EventTopic_Builder.Make(
+  ItemEventTopicSpec,
+  LocalEventTopicPublisher.Make(Bus),
+)
+
+let eventTopic = EventTopicMaker.make(~name="TestItemEventTopic", ~storageResources=[])
+
+let makeEvent' = (id, event) => ({
+  Reventless.Message.id,
+  meta: testMeta,
+  event,
+}: Reventless.Message.event'<string, ItemEventTopicSpec.event>)
+
+let reset = () => {
+  capturedEventCount := 0
+}

package/tests/components/eventtopic/EventTopicFixtures.res.mjs

@@ -0,0 +1,77 @@
+// Generated by ReScript, PLEASE EDIT WITH CARE
+
+import * as S from "sury/src/S.res.mjs";
+import * as Id$Reventless from "@reventlessdev/reventless-spec/src/types/Id.res.mjs";
+import * as LocalBus$ReventlessLocal from "../../../src/adapter/LocalBus.res.mjs";
+import * as TestRunner$ReventlessLocal from "../../../src/test/TestRunner.res.mjs";
+import * as TestFixtures$ReventlessLocal from "../../TestFixtures.res.mjs";
+import * as EventTopic_Builder$ReventlessCore from "@reventlessdev/reventless-core/src/components/EventTopic/EventTopic_Builder.res.mjs";
+import * as LocalEventTopicPublisher$ReventlessLocal from "../../../src/adapter/EventTopic/LocalEventTopicPublisher.res.mjs";
+
+let name = "TestItemEventTopic";
+
+let eventSchema = S.union([
+  S.schema(s => ({
+    TAG: "ItemPublished",
+    name: s.m(S.string)
+  })),
+  S.schema(s => ({
+    TAG: "ItemRemoved",
+    id: s.m(S.string)
+  }))
+]);
+
+let ItemEventTopicSpec = {
+  Id: undefined,
+  name: name,
+  eventSchema: eventSchema
+};
+
+let Bus = LocalBus$ReventlessLocal.Make({});
+
+let capturedEventCount = {
+  contents: 0
+};
+
+Bus.subscribeToEvents("TestItemEventTopicEventTopic", async (param, param$1, param$2) => {
+  capturedEventCount.contents = capturedEventCount.contents + 1 | 0;
+});
+
+TestRunner$ReventlessLocal.setup();
+
+let EventTopicMaker = EventTopic_Builder$ReventlessCore.Make({
+  Id: {
+    schema: Id$Reventless.StringPure.schema,
+    make: prim => prim,
+    makeFromString: prim => prim,
+    toString: prim => prim,
+    cmp: Id$Reventless.StringPure.cmp
+  },
+  name: name,
+  eventSchema: eventSchema
+})(LocalEventTopicPublisher$ReventlessLocal.Make(Bus));
+
+let eventTopic = EventTopicMaker.make("TestItemEventTopic", [], undefined);
+
+function makeEvent$p(id, event) {
+  return {
+    id: id,
+    meta: TestFixtures$ReventlessLocal.testMeta,
+    event: event
+  };
+}
+
+function reset() {
+  capturedEventCount.contents = 0;
+}
+
+export {
+  ItemEventTopicSpec,
+  Bus,
+  capturedEventCount,
+  EventTopicMaker,
+  eventTopic,
+  makeEvent$p,
+  reset,
+}
+/* eventSchema Not a pure module */

package/tests/components/eventtopic/EventTopicStreamFixtures.res

@@ -0,0 +1,27 @@
+// Fixtures for EventTopic.publishJsonStream tests (Phase I).
+
+module ItemStreamSpec = {
+  module Id = Reventless.Id.StringPure
+  let name = "StreamEvtItem"
+
+  @schema
+  type event = | ItemPublished({name: string}) | ItemRemoved({id: string})
+}
+
+module StreamEvtBus = LocalBus.Make()
+
+let _ = TestRunner.setup()
+
+// Topic name = make name ++ "EventTopic" = "StreamEvtTopic" ++ "EventTopic"
+let received: ref<int> = ref(0)
+let _ = StreamEvtBus.subscribeToEvents("StreamEvtTopicEventTopic", async (_, _, _) => {
+  received := received.contents + 1
+})
+
+module StreamEvtTopicMaker = ReventlessCore.EventTopic_Builder.Make(
+  ItemStreamSpec,
+  LocalEventTopicPublisher.Make(StreamEvtBus),
+)
+
+let evtTopic = StreamEvtTopicMaker.make(~name="StreamEvtTopic", ~storageResources=[])
+

package/tests/components/eventtopic/EventTopicStreamFixtures.res.mjs

@@ -0,0 +1,62 @@
+// Generated by ReScript, PLEASE EDIT WITH CARE
+
+import * as S from "sury/src/S.res.mjs";
+import * as Id$Reventless from "@reventlessdev/reventless-spec/src/types/Id.res.mjs";
+import * as LocalBus$ReventlessLocal from "../../../src/adapter/LocalBus.res.mjs";
+import * as TestRunner$ReventlessLocal from "../../../src/test/TestRunner.res.mjs";
+import * as EventTopic_Builder$ReventlessCore from "@reventlessdev/reventless-core/src/components/EventTopic/EventTopic_Builder.res.mjs";
+import * as LocalEventTopicPublisher$ReventlessLocal from "../../../src/adapter/EventTopic/LocalEventTopicPublisher.res.mjs";
+
+let name = "StreamEvtItem";
+
+let eventSchema = S.union([
+  S.schema(s => ({
+    TAG: "ItemPublished",
+    name: s.m(S.string)
+  })),
+  S.schema(s => ({
+    TAG: "ItemRemoved",
+    id: s.m(S.string)
+  }))
+]);
+
+let ItemStreamSpec = {
+  Id: undefined,
+  name: name,
+  eventSchema: eventSchema
+};
+
+let StreamEvtBus = LocalBus$ReventlessLocal.Make({});
+
+TestRunner$ReventlessLocal.setup();
+
+let received = {
+  contents: 0
+};
+
+StreamEvtBus.subscribeToEvents("StreamEvtTopicEventTopic", async (param, param$1, param$2) => {
+  received.contents = received.contents + 1 | 0;
+});
+
+let StreamEvtTopicMaker = EventTopic_Builder$ReventlessCore.Make({
+  Id: {
+    schema: Id$Reventless.StringPure.schema,
+    make: prim => prim,
+    makeFromString: prim => prim,
+    toString: prim => prim,
+    cmp: Id$Reventless.StringPure.cmp
+  },
+  name: name,
+  eventSchema: eventSchema
+})(LocalEventTopicPublisher$ReventlessLocal.Make(StreamEvtBus));
+
+let evtTopic = StreamEvtTopicMaker.make("StreamEvtTopic", [], undefined);
+
+export {
+  ItemStreamSpec,
+  StreamEvtBus,
+  received,
+  StreamEvtTopicMaker,
+  evtTopic,
+}
+/* eventSchema Not a pure module */

package/tests/components/eventtopic/EventTopicStreamTest.res

@@ -0,0 +1,35 @@
+// Tests for EventTopic.publishJsonStream (Phase I of effect-stream-integration plan).
+// Verifies that a Stream<publishJsonStreamItem> drives publishing without collecting into an array.
+
+open TestFixtures
+open JestGlobals
+open EventTopicStreamFixtures
+
+describe("EventTopic.publishJsonStream", () => {
+  let _ = beforeAllAsync(async () => {
+    let _ = await evtTopic->ReventlessCore.Component.operations->TestRunner.resolve
+  })
+
+  let _ = beforeEach(() => {
+    received := 0
+  })
+
+  testPromise("streams 2 events to all subscribers", async () => {
+    let ops = await evtTopic->ReventlessCore.Component.operations->TestRunner.resolve
+    let stream = [
+      ({service: "svc", meta: testMeta, json: JSON.parseOrThrow("{\"ev\":1}")}: ReventlessInfra.EventTopic.publishJsonStreamItem),
+      {service: "svc", meta: testMeta, json: JSON.parseOrThrow("{\"ev\":2}")},
+    ]->Stream.fromIterable
+    let _ = await ops.publishJsonStream(stream)->Effect.runPromise
+    let _ = await Promise.resolve()
+    let _ = await Promise.resolve()
+    expect(received.contents)->toBe(2)
+  })
+
+  testPromise("empty stream publishes nothing to subscribers", async () => {
+    let ops = await evtTopic->ReventlessCore.Component.operations->TestRunner.resolve
+    let _ = await ops.publishJsonStream(Stream.empty)->Effect.runPromise
+    let _ = await Promise.resolve()
+    expect(received.contents)->toBe(0)
+  })
+})

package/tests/components/eventtopic/EventTopicStreamTest.res.mjs

@@ -0,0 +1,44 @@
+// Generated by ReScript, PLEASE EDIT WITH CARE
+
+import * as Effect from "effect/Effect";
+import * as Stream from "effect/Stream";
+import * as Component$ReventlessCore from "@reventlessdev/reventless-core/src/components/Component.res.mjs";
+import * as TestRunner$ReventlessLocal from "../../../src/test/TestRunner.res.mjs";
+import * as TestFixtures$ReventlessLocal from "../../TestFixtures.res.mjs";
+import * as EventTopicStreamFixtures$ReventlessLocal from "./EventTopicStreamFixtures.res.mjs";
+
+globalThis.describe("EventTopic.publishJsonStream", () => {
+  globalThis.beforeAll(async () => {
+    await TestRunner$ReventlessLocal.resolve(Component$ReventlessCore.operations(EventTopicStreamFixtures$ReventlessLocal.evtTopic));
+  });
+  globalThis.beforeEach(() => {
+    EventTopicStreamFixtures$ReventlessLocal.received.contents = 0;
+  });
+  globalThis.test("streams 2 events to all subscribers", async () => {
+    let ops = await TestRunner$ReventlessLocal.resolve(Component$ReventlessCore.operations(EventTopicStreamFixtures$ReventlessLocal.evtTopic));
+    let stream = Stream.fromIterable([
+      {
+        service: "svc",
+        meta: TestFixtures$ReventlessLocal.testMeta,
+        json: JSON.parse("{\"ev\":1}")
+      },
+      {
+        service: "svc",
+        meta: TestFixtures$ReventlessLocal.testMeta,
+        json: JSON.parse("{\"ev\":2}")
+      }
+    ]);
+    await Effect.runPromise(ops.publishJsonStream(stream));
+    await Promise.resolve();
+    await Promise.resolve();
+    globalThis.expect(EventTopicStreamFixtures$ReventlessLocal.received.contents).toBe(2);
+  });
+  globalThis.test("empty stream publishes nothing to subscribers", async () => {
+    let ops = await TestRunner$ReventlessLocal.resolve(Component$ReventlessCore.operations(EventTopicStreamFixtures$ReventlessLocal.evtTopic));
+    await Effect.runPromise(ops.publishJsonStream(Stream.empty));
+    await Promise.resolve();
+    globalThis.expect(EventTopicStreamFixtures$ReventlessLocal.received.contents).toBe(0);
+  });
+});
+
+/*  Not a pure module */

package/tests/components/eventtopic/EventTopicTest.res

@@ -0,0 +1,35 @@
+// Integration tests for EventTopic_Builder with in-memory publisher.
+
+open JestGlobals
+open EventTopicFixtures
+
+describe("EventTopic (in-memory)", () => {
+  let _ = beforeAllAsync(async () => {
+    let _ = await eventTopic->ReventlessCore.Component.operations->TestRunner.resolve
+  })
+
+  let _ = beforeEach(() => reset())
+
+  testPromise("publish sends event to bus subscribers", async () => {
+    let ops = await eventTopic->ReventlessCore.Component.operations->TestRunner.resolve
+    let event' = makeEvent'("item-1", ItemEventTopicSpec.ItemPublished({name: "Widget"}))
+    await ops.publish([event'])
+    expect(capturedEventCount.contents)->toBe(1)
+  })
+
+  testPromise("publish multiple events notifies subscribers for each", async () => {
+    let ops = await eventTopic->ReventlessCore.Component.operations->TestRunner.resolve
+    let events = [
+      makeEvent'("item-1", ItemEventTopicSpec.ItemPublished({name: "Widget"})),
+      makeEvent'("item-2", ItemEventTopicSpec.ItemRemoved({id: "item-2"})),
+    ]
+    await ops.publish(events)
+    expect(capturedEventCount.contents)->toBe(2)
+  })
+
+  testPromise("publish empty array does not notify subscribers", async () => {
+    let ops = await eventTopic->ReventlessCore.Component.operations->TestRunner.resolve
+    await ops.publish([])
+    expect(capturedEventCount.contents)->toBe(0)
+  })
+})

package/tests/components/eventtopic/EventTopicTest.res.mjs

@@ -0,0 +1,43 @@
+// Generated by ReScript, PLEASE EDIT WITH CARE
+
+import * as Component$ReventlessCore from "@reventlessdev/reventless-core/src/components/Component.res.mjs";
+import * as TestRunner$ReventlessLocal from "../../../src/test/TestRunner.res.mjs";
+import * as EventTopicFixtures$ReventlessLocal from "./EventTopicFixtures.res.mjs";
+
+globalThis.describe("EventTopic (in-memory)", () => {
+  globalThis.beforeAll(async () => {
+    await TestRunner$ReventlessLocal.resolve(Component$ReventlessCore.operations(EventTopicFixtures$ReventlessLocal.eventTopic));
+  });
+  globalThis.beforeEach(() => EventTopicFixtures$ReventlessLocal.reset());
+  globalThis.test("publish sends event to bus subscribers", async () => {
+    let ops = await TestRunner$ReventlessLocal.resolve(Component$ReventlessCore.operations(EventTopicFixtures$ReventlessLocal.eventTopic));
+    let event$p = EventTopicFixtures$ReventlessLocal.makeEvent$p("item-1", {
+      TAG: "ItemPublished",
+      name: "Widget"
+    });
+    await ops.publish([event$p]);
+    globalThis.expect(EventTopicFixtures$ReventlessLocal.capturedEventCount.contents).toBe(1);
+  });
+  globalThis.test("publish multiple events notifies subscribers for each", async () => {
+    let ops = await TestRunner$ReventlessLocal.resolve(Component$ReventlessCore.operations(EventTopicFixtures$ReventlessLocal.eventTopic));
+    let events = [
+      EventTopicFixtures$ReventlessLocal.makeEvent$p("item-1", {
+        TAG: "ItemPublished",
+        name: "Widget"
+      }),
+      EventTopicFixtures$ReventlessLocal.makeEvent$p("item-2", {
+        TAG: "ItemRemoved",
+        id: "item-2"
+      })
+    ];
+    await ops.publish(events);
+    globalThis.expect(EventTopicFixtures$ReventlessLocal.capturedEventCount.contents).toBe(2);
+  });
+  globalThis.test("publish empty array does not notify subscribers", async () => {
+    let ops = await TestRunner$ReventlessLocal.resolve(Component$ReventlessCore.operations(EventTopicFixtures$ReventlessLocal.eventTopic));
+    await ops.publish([]);
+    globalThis.expect(EventTopicFixtures$ReventlessLocal.capturedEventCount.contents).toBe(0);
+  });
+});
+
+/*  Not a pure module */

package/tests/components/extensionpoint/ExtensionPointFixtures.res

@@ -0,0 +1,145 @@
+// Fixtures for ExtensionPoint integration tests.
+// Verifies that dispatching a command to the EP channel calls publishToAggregates.
+
+open TestFixtures
+
+S.enableJson()
+
+// ─────────────────────────────────────────────────────────────
+// Isolated bus + Pulumi mock mode
+// ─────────────────────────────────────────────────────────────
+
+module Bus = LocalBus.Make()
+let _ = TestRunner.setup()
+
+// ─────────────────────────────────────────────────────────────
+// ExtensionPoint spec
+// EP CommandTopic channel = Spec.name ++ "ExtPoint" ++ "CmdTopic" = "TestEPExtPointCmdTopic"
+// ─────────────────────────────────────────────────────────────
+
+module TestEPSpec = {
+  let name = "TestEP"
+
+  @schema
+  type command = | Forward({targetId: string})
+
+  @schema
+  type event = | TEPNoEvent // unused — mapOutgoingEvent = None
+
+  @schema
+  type directive = | TEPNoDirective // unused — mapIncomingCommand only uses PublishCommand
+
+  let moduleUrl: string = %raw(`import.meta.url`)
+}
+
+// ─────────────────────────────────────────────────────────────
+// Target aggregate spec (receives forwarded commands)
+// ─────────────────────────────────────────────────────────────
+
+module DelegateAggSpec = {
+  module Id = Reventless.Id.StringPure
+  let name = "TargetAgg"
+
+  @schema
+  type command = | Execute({targetId: string})
+
+  @schema
+  type event = | Executed({targetId: string}) // unused but required by Aggregate.Spec
+
+  @schema
+  type error = | TEAggNoError // unused but required by Aggregate.Spec
+
+  let moduleUrl: string = %raw(`import.meta.url`)
+}
+
+// ─────────────────────────────────────────────────────────────
+// Mapping: Forward → Execute
+// ─────────────────────────────────────────────────────────────
+
+module ForwardMapping = {
+  module ExtensionPoint = TestEPSpec
+  module Delegate = DelegateAggSpec
+
+  let moduleUrl = "test:ExtensionPointFixtures:ForwardMapping"
+
+  let mapIncomingCommand = (
+    _id: string,
+    cmd: TestEPSpec.command,
+    _meta: Reventless.Message.meta,
+  ): array<ReventlessInfra.ExtensionPointMapping.commandAction<DelegateAggSpec.command, TestEPSpec.directive>> =>
+    switch cmd {
+    | Forward({targetId}) =>
+      let execCmd = DelegateAggSpec.Execute({targetId: targetId})
+      [ReventlessInfra.ExtensionPointMapping.PublishCommand(targetId, execCmd)]
+    }
+
+  let mapOutgoingEvent: option<
+    ReventlessInfra.ExtensionPointMapping.mapOutgoingEvent<
+      DelegateAggSpec.event,
+      TestEPSpec.event,
+      TestEPSpec.directive,
+    >,
+  > = None
+}
+
+// ─────────────────────────────────────────────────────────────
+// Pre-compiled mapping (Spec + Impl → T)
+// ─────────────────────────────────────────────────────────────
+
+module TestEPMapping1 = ReventlessInfra.ExtensionPointMapping.Make(ForwardMapping)
+
+// ─────────────────────────────────────────────────────────────
+// Mappings collection satisfying ExtensionPoint.Mappings
+// ─────────────────────────────────────────────────────────────
+
+module TestEPMappings = {
+  module Spec = TestEPSpec
+  module type Mapping = ReventlessInfra.ExtensionPointMapping.T with module ExtensionPoint := TestEPSpec
+  let name = "TestEPMappings"
+  let moduleUrl: string = %raw(`import.meta.url`)
+  let mappings: array<module(Mapping)> = [module(TestEPMapping1)]
+}
+
+// ─────────────────────────────────────────────────────────────
+// In-memory ExtensionPoint builder
+// ─────────────────────────────────────────────────────────────
+
+module EPBuilderWithBus = ExtensionPoint_Builder.Make(Bus)
+module TestEP = EPBuilderWithBus.Make(TestEPSpec, TestEPMappings)
+
+// ─────────────────────────────────────────────────────────────
+// Captured state
+// ─────────────────────────────────────────────────────────────
+
+let capturedCmds: ref<array<Reventless.Message.commandJson>> = ref([])
+
+// ─────────────────────────────────────────────────────────────
+// Mock infrastructure
+// ─────────────────────────────────────────────────────────────
+
+let mockPublishFn: ReventlessInfra.CommandTopic.publishJsons = async cmds => {
+  capturedCmds := capturedCmds.contents->Array.concat(cmds)
+}
+
+// ─────────────────────────────────────────────────────────────
+// Build ExtensionPoint component
+// ─────────────────────────────────────────────────────────────
+
+let ep = TestEP.make(
+  ~aggregateResources=Dict.fromArray([("TargetAgg", [])]),
+  ~publishToAggregates=Dict.fromArray([("TargetAgg", mockPublishFn)]),
+  ~scheduler=mockScheduler,
+  ~queryEngine=mockQueryEngine,
+  ~resourceNaming=mockResourceNaming,
+  ~opts=None,
+)
+
+// ─────────────────────────────────────────────────────────────
+// Test meta + helpers
+// ─────────────────────────────────────────────────────────────
+
+let testMeta = makeTestMeta(~service="TestEP")
+
+let resetMocks = () => {
+  capturedCmds := []
+}