@reventlessdev/reventless-local 3.0.0-alpha.113

package/tests/components/readmodel/ReadModelFixtures.res.mjs

@@ -0,0 +1,169 @@
+// Generated by ReScript, PLEASE EDIT WITH CARE
+
+import * as S from "sury/src/S.res.mjs";
+import * as Stream from "@reventlessdev/rescript-effect/src/Stream.res.mjs";
+import * as Id$Reventless from "@reventlessdev/reventless-spec/src/types/Id.res.mjs";
+import * as Effect from "effect/Effect";
+import * as Pulumi from "@pulumi/pulumi";
+import * as Message$Reventless from "@reventlessdev/reventless-spec/src/types/Message.res.mjs";
+import * as ReadModel$Reventless from "@reventlessdev/reventless-spec/src/components/ReadModel.res.mjs";
+import * as Projection$Reventless from "@reventlessdev/reventless-spec/src/types/Projection.res.mjs";
+import * as Adapter$ReventlessInfra from "@reventlessdev/reventless-infra/src/adapter/Adapter.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 ReadModel_Builder$ReventlessLocal from "../../../src/components/ReadModel_Builder.res.mjs";
+
+let name = "TestItemReadModel";
+
+let moduleUrl = import.meta.url;
+
+let stateSchema = S.schema(s => ({
+  name: s.m(S.string)
+}));
+
+let config = ReadModel$Reventless.config(undefined, undefined, undefined);
+
+let ItemReadModelSpec = {
+  Id: undefined,
+  name: name,
+  moduleUrl: moduleUrl,
+  stateSchema: stateSchema,
+  config: config,
+  subIdConfig: undefined,
+  authorization: "AllowAuthenticated",
+  visibility: "Public"
+};
+
+let name$1 = "TestItemEventTopic";
+
+let eventSchema = S.schema(s => ({
+  TAG: "ItemCreated",
+  name: s.m(S.string)
+}));
+
+let ItemEventSource = {
+  Id: undefined,
+  name: name$1,
+  eventSchema: eventSchema
+};
+
+function project(msg) {
+  let match = msg.event;
+  return {
+    TAG: "Create",
+    _0: msg.id,
+    _1: {
+      name: match.name
+    }
+  };
+}
+
+let ItemMapping = Projection$Reventless.Mapping.Make({
+  Id: Id$Reventless.$$String,
+  name: name$1,
+  eventSchema: eventSchema
+})({
+  Id: Id$Reventless.$$String,
+  name: name,
+  stateSchema: stateSchema,
+  subIdConfig: undefined
+})({
+  project: project
+});
+
+Projection$Reventless.Mappings.Make({
+  Id: Id$Reventless.$$String,
+  name: name,
+  stateSchema: stateSchema,
+  subIdConfig: undefined
+});
+
+let moduleUrl$1 = import.meta.url;
+
+let mappings = [ItemMapping];
+
+let ItemMappings = {
+  moduleUrl: moduleUrl$1,
+  mappings: mappings
+};
+
+let topicName = "TestItemEventTopic";
+
+let topicResource = Adapter$ReventlessInfra.make(Pulumi.output(topicName), Pulumi.output(topicName), Pulumi.output(topicName), Pulumi.output("memory:InMemory"), undefined, undefined, undefined, undefined, undefined, undefined);
+
+let allEventTopics = Object.fromEntries([[
+    topicName,
+    {
+      resources: [topicResource]
+    }
+  ]]);
+
+let Bus = LocalBus$ReventlessLocal.Make({});
+
+TestRunner$ReventlessLocal.setup();
+
+let ReadModelMaker = ReadModel_Builder$ReventlessLocal.Make(Bus);
+
+let ItemReadModel = ReadModelMaker.Make({
+  Id: Id$Reventless.$$String,
+  name: name,
+  moduleUrl: moduleUrl,
+  stateSchema: stateSchema,
+  config: config,
+  subIdConfig: undefined,
+  authorization: "AllowAuthenticated",
+  visibility: "Public"
+})(ItemMappings);
+
+let rm = ItemReadModel.make(undefined, undefined, allEventTopics, undefined);
+
+let testMeta = TestFixtures$ReventlessLocal.makeTestMeta("TestItemEventTopic");
+
+async function publishItemCreated(id, name) {
+  let eventJson = Object.fromEntries([
+    [
+      "id",
+      id
+    ],
+    [
+      "meta",
+      S.reverseConvertToJsonOrThrow(testMeta, Message$Reventless.metaSchema)
+    ],
+    [
+      "event",
+      S.reverseConvertToJsonOrThrow({
+        TAG: "ItemCreated",
+        name: name
+      }, eventSchema)
+    ]
+  ]);
+  return await Bus.publishEvent(topicName, "test", testMeta, eventJson);
+}
+
+async function loadState(id) {
+  let ops = Bus.getQueryDb("TestItemReadModel");
+  if (ops === undefined) {
+    return [];
+  }
+  let states = await Effect.runPromise(Effect.catchAll(Stream.runCollect(ops.loadStream(id)), param => Effect.succeed([])));
+  return states.map(json => S.parseJsonOrThrow(json, stateSchema));
+}
+
+export {
+  ItemReadModelSpec,
+  ItemEventSource,
+  ItemMapping,
+  ItemMappings,
+  topicName,
+  topicResource,
+  allEventTopics,
+  Bus,
+  ReadModelMaker,
+  ItemReadModel,
+  rm,
+  testMeta,
+  publishItemCreated,
+  loadState,
+}
+/* moduleUrl Not a pure module */

package/tests/components/readmodel/ReadModelTest.res

@@ -0,0 +1,46 @@
+// E2E tests for ReadModel_Builder.
+// Verifies the full publish → EventCollector → projection → QueryDb pipeline.
+
+open JestGlobals
+open ReadModelFixtures
+
+describe("ReadModel E2E", () => {
+  // Force Output chain resolution so EventCollectorChannel subscription is registered
+  // before the first test runs.
+  //
+  // Two resolves are needed:
+  //   1. rm.operations chain — triggers the outer queryDb.operations.apply(...) which
+  //      calls EventCollectorChannel.connect() as a side effect.
+  //   2. topicResource.name — resolves the inner resource.name.apply(...) inside connect,
+  //      which registers the Bus.subscribeToEvents handler.
+  let _ = beforeAllAsync(async () => {
+    let _ = await rm->ItemReadModel.operations->TestRunner.resolve
+    let _ = await topicResource.name->TestRunner.resolve
+  })
+
+  testPromise("ItemCreated event projects into ReadModel state", async () => {
+    let _ = await publishItemCreated("item-1", "Widget")
+    let states = await loadState("item-1")
+    expect(states->Array.length)->toBe(1)
+    let state = states->Array.getUnsafe(0)
+    expect(state.name)->toBe("Widget")
+  })
+
+  testPromise("query for unknown ID returns empty", async () => {
+    let states = await loadState("unknown-id")
+    expect(states->Array.length)->toBe(0)
+  })
+
+  testPromise("multiple events project independently", async () => {
+    let _ = await publishItemCreated("item-2", "Gadget")
+    let _ = await publishItemCreated("item-3", "Doohickey")
+    let states2 = await loadState("item-2")
+    let states3 = await loadState("item-3")
+    expect(states2->Array.length)->toBe(1)
+    expect(states3->Array.length)->toBe(1)
+    let state2 = states2->Array.getUnsafe(0)
+    let state3 = states3->Array.getUnsafe(0)
+    expect(state2.name)->toBe("Gadget")
+    expect(state3.name)->toBe("Doohickey")
+  })
+})

package/tests/components/readmodel/ReadModelTest.res.mjs

@@ -0,0 +1,36 @@
+// Generated by ReScript, PLEASE EDIT WITH CARE
+
+import * as TestRunner$ReventlessLocal from "../../../src/test/TestRunner.res.mjs";
+import * as ReadModelFixtures$ReventlessLocal from "./ReadModelFixtures.res.mjs";
+
+globalThis.describe("ReadModel E2E", () => {
+  globalThis.beforeAll(async () => {
+    await TestRunner$ReventlessLocal.resolve(ReadModelFixtures$ReventlessLocal.ItemReadModel.operations(ReadModelFixtures$ReventlessLocal.rm));
+    await TestRunner$ReventlessLocal.resolve(ReadModelFixtures$ReventlessLocal.topicResource.name);
+  });
+  globalThis.test("ItemCreated event projects into ReadModel state", async () => {
+    await ReadModelFixtures$ReventlessLocal.publishItemCreated("item-1", "Widget");
+    let states = await ReadModelFixtures$ReventlessLocal.loadState("item-1");
+    globalThis.expect(states.length).toBe(1);
+    let state = states[0];
+    globalThis.expect(state.name).toBe("Widget");
+  });
+  globalThis.test("query for unknown ID returns empty", async () => {
+    let states = await ReadModelFixtures$ReventlessLocal.loadState("unknown-id");
+    globalThis.expect(states.length).toBe(0);
+  });
+  globalThis.test("multiple events project independently", async () => {
+    await ReadModelFixtures$ReventlessLocal.publishItemCreated("item-2", "Gadget");
+    await ReadModelFixtures$ReventlessLocal.publishItemCreated("item-3", "Doohickey");
+    let states2 = await ReadModelFixtures$ReventlessLocal.loadState("item-2");
+    let states3 = await ReadModelFixtures$ReventlessLocal.loadState("item-3");
+    globalThis.expect(states2.length).toBe(1);
+    globalThis.expect(states3.length).toBe(1);
+    let state2 = states2[0];
+    let state3 = states3[0];
+    globalThis.expect(state2.name).toBe("Gadget");
+    globalThis.expect(state3.name).toBe("Doohickey");
+  });
+});
+
+/*  Not a pure module */

package/tests/components/scheduler/SchedulerFixtures.res

@@ -0,0 +1,59 @@
+// Fixtures for Scheduler component integration tests.
+// Uses LocalScheduledPublisher + Scheduler_Builder to verify schedule lifecycle.
+
+open TestFixtures
+open JestGlobals
+
+// Activate Pulumi mock mode (must be called before any Component.make)
+let _ = TestRunner.setup()
+
+// ─────────────────────────────────────────────────────────────
+// Isolated bus + scheduled publisher + scheduler maker
+// ─────────────────────────────────────────────────────────────
+
+module Bus = LocalBus.Make()
+module SP = LocalScheduledPublisher.Make(Bus)
+module SchedulerMaker = ReventlessCore.Scheduler_Builder.Make(SP)
+
+// ─────────────────────────────────────────────────────────────
+// Build the scheduler component (shared across tests)
+// ─────────────────────────────────────────────────────────────
+
+let scheduler = SchedulerMaker.make()
+
+// ─────────────────────────────────────────────────────────────
+// Helper: resolved Adapter.resolvedResource for a named bus topic
+// ─────────────────────────────────────────────────────────────
+
+let makeTopicResource = (name: string): ReventlessInfra.Adapter.resolvedResource => {
+  name,
+  id: name,
+  urn: name,
+  resourceInfo: NoInfo,
+  service: "memory:InMemory",
+  role: "",
+  region: "",
+  resourceType: "",
+  configuration: Dict.make(),
+  tags: Dict.make(),
+}
+
+let _ = beforeAll(() => {
+  jest->useFakeTimers
+})
+
+let _ = afterAll(() => {
+  SP.reset()
+  jest->useRealTimers
+})
+
+// ─────────────────────────────────────────────────────────────
+// Resolve scheduler operations once for all tests
+// ─────────────────────────────────────────────────────────────
+
+let schedulerOps: ref<option<ReventlessInfra.Scheduler.operations>> = ref(None)
+
+let _ = beforeAllAsync(async () => {
+  let ops = await scheduler->ReventlessCore.Component.operations->TestRunner.resolve
+  schedulerOps := Some(ops)
+})

package/tests/components/scheduler/SchedulerFixtures.res.mjs

@@ -0,0 +1,63 @@
+// Generated by ReScript, PLEASE EDIT WITH CARE
+
+import * as Globals from "@jest/globals";
+import * as Component$ReventlessCore from "@reventlessdev/reventless-core/src/components/Component.res.mjs";
+import * as LocalBus$ReventlessLocal from "../../../src/adapter/LocalBus.res.mjs";
+import * as TestRunner$ReventlessLocal from "../../../src/test/TestRunner.res.mjs";
+import * as Scheduler_Builder$ReventlessCore from "@reventlessdev/reventless-core/src/components/Scheduler/Scheduler_Builder.res.mjs";
+import * as LocalScheduledPublisher$ReventlessLocal from "../../../src/adapter/Scheduler/LocalScheduledPublisher.res.mjs";
+
+TestRunner$ReventlessLocal.setup();
+
+let Bus = LocalBus$ReventlessLocal.Make({});
+
+let SP = LocalScheduledPublisher$ReventlessLocal.Make(Bus);
+
+let SchedulerMaker = Scheduler_Builder$ReventlessCore.Make({
+  make: SP.make
+});
+
+let scheduler = SchedulerMaker.make(undefined);
+
+function makeTopicResource(name) {
+  return {
+    name: name,
+    id: name,
+    urn: name,
+    resourceInfo: "NoInfo",
+    service: "memory:InMemory",
+    role: "",
+    region: "",
+    resourceType: "",
+    configuration: {},
+    tags: {}
+  };
+}
+
+globalThis.beforeAll(() => {
+  Globals.jest.useFakeTimers();
+});
+
+globalThis.afterAll(() => {
+  SP.reset();
+  Globals.jest.useRealTimers();
+});
+
+let schedulerOps = {
+  contents: undefined
+};
+
+globalThis.beforeAll(async () => {
+  let ops = await TestRunner$ReventlessLocal.resolve(Component$ReventlessCore.operations(scheduler));
+  schedulerOps.contents = ops;
+});
+
+export {
+  Bus,
+  SP,
+  SchedulerMaker,
+  scheduler,
+  makeTopicResource,
+  schedulerOps,
+}
+/*  Not a pure module */

package/tests/components/scheduler/SchedulerTest.res

@@ -0,0 +1,76 @@
+// Integration tests for Scheduler_Builder (in-memory).
+// Verifies that createSchedule fires events and deleteSchedule prevents firing.
+// Adapter-level timer tests are in adapter/ScheduledPublisherTest.res.
+
+open TestFixtures
+open JestGlobals
+open SchedulerFixtures
+
+describe("Scheduler_Builder.Make:", () => {
+  let _ = afterEach(() => SP.reset())
+
+  describe("createSchedule:", () => {
+    testPromise("recurring schedule fires event on each interval advance", async () => {
+      let ops = schedulerOps.contents->Option.getUnsafe
+      let count = ref(0)
+      Bus.subscribeToEvents("sched-recurring", async (_, _, _) => {
+        count := count.contents + 1
+      })
+      // createSchedule async body has no await — setInterval registered synchronously
+      let _ = ops.createSchedule(
+        [makeTopicResource("sched-recurring")],
+        {name: "test-recurring", rate: Reventless.Schedule.Minutes(1), payload: "{}"},
+      )
+      // Two microtask ticks: publishEvent uses Effect.all(concurrency=unbounded) which forks
+      // child fibers via startFork — one tick runs the child fiber (Queue.offer),
+      // a second tick runs the drain fiber callback.
+      jest->advanceTimersByTime(60 * 1000)
+      let _ = await Promise.resolve(())
+      let _ = await Promise.resolve(())
+      expect(count.contents)->toBe(1)
+      jest->advanceTimersByTime(60 * 1000)
+      let _ = await Promise.resolve(())
+      let _ = await Promise.resolve(())
+      expect(count.contents)->toBe(2)
+    })
+
+    testPromise("single-shot schedule fires once then stops", async () => {
+      let ops = schedulerOps.contents->Option.getUnsafe
+      let count = ref(0)
+      Bus.subscribeToEvents("sched-single", async (_, _, _) => {
+        count := count.contents + 1
+      })
+      let _ = ops.createSchedule(
+        [makeTopicResource("sched-single")],
+        {
+          name: "test-single",
+          rate: Reventless.Schedule.Single(2024, 1, 1, 0, 0),
+          payload: "{}",
+        },
+      )
+      jest->advanceTimersByTime(0)
+      let _ = await Promise.resolve(())
+      let _ = await Promise.resolve(())
+      expect(count.contents)->toBe(1)
+      jest->advanceTimersByTime(60 * 1000)
+      expect(count.contents)->toBe(1) // No further firing
+    })
+  })
+
+  describe("deleteSchedule:", () => {
+    testPromise("deleted schedule does not fire after deletion", async () => {
+      let ops = schedulerOps.contents->Option.getUnsafe
+      let count = ref(0)
+      Bus.subscribeToEvents("sched-delete", async (_, _, _) => {
+        count := count.contents + 1
+      })
+      let _ = ops.createSchedule(
+        [makeTopicResource("sched-delete")],
+        {name: "test-delete", rate: Reventless.Schedule.Minutes(2), payload: "{}"},
+      )
+      let _ = ops.deleteSchedule([], "test-delete")
+      jest->advanceTimersByTime(2 * 60 * 1000)
+      expect(count.contents)->toBe(0)
+    })
+  })
+})

package/tests/components/scheduler/SchedulerTest.res.mjs

@@ -0,0 +1,86 @@
+// Generated by ReScript, PLEASE EDIT WITH CARE
+
+import * as Globals from "@jest/globals";
+import * as SchedulerFixtures$ReventlessLocal from "./SchedulerFixtures.res.mjs";
+
+globalThis.describe("Scheduler_Builder.Make:", () => {
+  globalThis.afterEach(() => SchedulerFixtures$ReventlessLocal.SP.reset());
+  globalThis.describe("createSchedule:", () => {
+    globalThis.test("recurring schedule fires event on each interval advance", async () => {
+      let ops = SchedulerFixtures$ReventlessLocal.schedulerOps.contents;
+      let count = {
+        contents: 0
+      };
+      SchedulerFixtures$ReventlessLocal.Bus.subscribeToEvents("sched-recurring", async (param, param$1, param$2) => {
+        count.contents = count.contents + 1 | 0;
+      });
+      ops.createSchedule([SchedulerFixtures$ReventlessLocal.makeTopicResource("sched-recurring")], {
+        name: "test-recurring",
+        rate: {
+          TAG: "Minutes",
+          _0: 1
+        },
+        payload: "{}"
+      });
+      Globals.jest.advanceTimersByTime(60000);
+      await Promise.resolve();
+      await Promise.resolve();
+      globalThis.expect(count.contents).toBe(1);
+      Globals.jest.advanceTimersByTime(60000);
+      await Promise.resolve();
+      await Promise.resolve();
+      globalThis.expect(count.contents).toBe(2);
+    });
+    globalThis.test("single-shot schedule fires once then stops", async () => {
+      let ops = SchedulerFixtures$ReventlessLocal.schedulerOps.contents;
+      let count = {
+        contents: 0
+      };
+      SchedulerFixtures$ReventlessLocal.Bus.subscribeToEvents("sched-single", async (param, param$1, param$2) => {
+        count.contents = count.contents + 1 | 0;
+      });
+      ops.createSchedule([SchedulerFixtures$ReventlessLocal.makeTopicResource("sched-single")], {
+        name: "test-single",
+        rate: {
+          TAG: "Single",
+          _0: 2024,
+          _1: 1,
+          _2: 1,
+          _3: 0,
+          _4: 0
+        },
+        payload: "{}"
+      });
+      Globals.jest.advanceTimersByTime(0);
+      await Promise.resolve();
+      await Promise.resolve();
+      globalThis.expect(count.contents).toBe(1);
+      Globals.jest.advanceTimersByTime(60000);
+      globalThis.expect(count.contents).toBe(1);
+    });
+  });
+  globalThis.describe("deleteSchedule:", () => {
+    globalThis.test("deleted schedule does not fire after deletion", async () => {
+      let ops = SchedulerFixtures$ReventlessLocal.schedulerOps.contents;
+      let count = {
+        contents: 0
+      };
+      SchedulerFixtures$ReventlessLocal.Bus.subscribeToEvents("sched-delete", async (param, param$1, param$2) => {
+        count.contents = count.contents + 1 | 0;
+      });
+      ops.createSchedule([SchedulerFixtures$ReventlessLocal.makeTopicResource("sched-delete")], {
+        name: "test-delete",
+        rate: {
+          TAG: "Minutes",
+          _0: 2
+        },
+        payload: "{}"
+      });
+      ops.deleteSchedule([], "test-delete");
+      Globals.jest.advanceTimersByTime(120000);
+      globalThis.expect(count.contents).toBe(0);
+    });
+  });
+});
+
+/*  Not a pure module */

package/tests/components/sideeffecthandler/SideEffectHandlerFixtures.res

@@ -0,0 +1,133 @@
+// Fixtures for SideEffectHandler integration tests.
+// Publishes an event to the bus and verifies the side effect execute function is called.
+
+open TestFixtures
+
+S.enableJson()
+
+// ─────────────────────────────────────────────────────────────
+// Isolated bus + Pulumi mock mode
+// ─────────────────────────────────────────────────────────────
+
+module Bus = LocalBus.Make()
+let _ = TestRunner.setup()
+
+// ─────────────────────────────────────────────────────────────
+// Source event spec
+// ─────────────────────────────────────────────────────────────
+
+module TestSEHSource = {
+  module Id = Reventless.Id.StringPure
+  let name = "TestSEHSource"
+
+  @schema
+  type event = | OrderPlaced({orderId: string})
+}
+
+// ─────────────────────────────────────────────────────────────
+// Captured state
+// ─────────────────────────────────────────────────────────────
+
+// Each entry: (aggregateId, orderId)
+let capturedOrders: ref<array<(string, string)>> = ref([])
+
+// ─────────────────────────────────────────────────────────────
+// Side effect implementation
+// ─────────────────────────────────────────────────────────────
+
+module TestSideEffect = {
+  module Source = TestSEHSource
+  let moduleUrl: string = %raw(`import.meta.url`)
+
+  let execute = async (
+    id: TestSEHSource.Id.t,
+    _meta: Reventless.Message.meta,
+    event: TestSEHSource.event,
+    _queryEngine: Reventless.QueryEngine.operations,
+  ) => {
+    switch event {
+    | OrderPlaced({orderId}) =>
+      capturedOrders := capturedOrders.contents->Array.concat([(id, orderId)])
+    }
+  }
+}
+
+// ─────────────────────────────────────────────────────────────
+// EventCollector wiring (core EventCollector_Builder + in-memory adapters)
+// ─────────────────────────────────────────────────────────────
+
+module EventCollectorCh = LocalEventCollectorChannel.Make(Bus)
+module SpecificEventCollector = ReventlessCore.EventCollector_Builder.Make(
+  LocalRuntimeEnvironment,
+  EventCollectorCh,
+)
+module ECRTBuilder = LocalEventCollectorRuntime_Builder.Make(Bus, EventCollectorCh)
+
+module SEHBuilder = ReventlessCore.SideEffectHandler_Builder.Make(
+  LocalRuntimeEnvironment,
+  EventCollectorCh,
+  SpecificEventCollector,
+  ECRTBuilder,
+)
+
+// ─────────────────────────────────────────────────────────────
+// allEventTopics — keyed by Source.name, resource.name = bus topic key
+// ─────────────────────────────────────────────────────────────
+
+let topicName = "TestSEHSource"
+let topicResource: ReventlessInfra.Adapter.resource = ReventlessInfra.Adapter.make(
+  ~name=topicName->Pulumi.Output.make,
+  ~id=topicName->Pulumi.Output.make,
+  ~urn=topicName->Pulumi.Output.make,
+  ~service="memory:InMemory"->Pulumi.Output.make,
+)
+
+let allEventTopics: ReventlessInfra.EventTopic.allOutputs = Dict.fromArray([
+  ("TestSEHSource", {ReventlessInfra.EventTopic.resources: [topicResource]}),
+])
+
+// ─────────────────────────────────────────────────────────────
+// Build SideEffectHandler component
+// ─────────────────────────────────────────────────────────────
+
+let sideEffects: array<module(Reventless.SideEffect.T)> = [module(TestSideEffect)]
+
+let seh = SEHBuilder.make(
+  ~name="TestSEH",
+  ~sideEffects,
+  ~allEventTopics,
+  ~allCommandTopics=Pulumi.Output.make(Dict.make()),
+  ~queryEngine=mockQueryEngine,
+  ~scheduler=mockScheduler,
+  ~resourceNaming=mockResourceNaming,
+)
+
+// ─────────────────────────────────────────────────────────────
+// Test meta
+// ─────────────────────────────────────────────────────────────
+
+let testMeta = makeTestMeta(~service="TestSEHSource")
+
+// ─────────────────────────────────────────────────────────────
+// Publish helper — emits {id, meta, event} to the bus topic
+// meta.service must match TestSEHSource.name for the callback to route correctly
+// ─────────────────────────────────────────────────────────────
+
+let publishOrderPlaced = async (id, orderId) => {
+  let eventJson = JSON.Encode.object(
+    Dict.fromArray([
+      ("id", id->JSON.Encode.string),
+      ("meta", testMeta->S.reverseConvertToJsonOrThrow(Reventless.Message.metaSchema)),
+      (
+        "event",
+        TestSEHSource.OrderPlaced({orderId: orderId})
+        ->S.reverseConvertToJsonOrThrow(TestSEHSource.eventSchema),
+      ),
+    ]),
+  )
+  await Bus.publishEvent(topicName, "TestSEHSource", testMeta, eventJson)
+}
+
+let resetMocks = () => {
+  capturedOrders := []
+}