@reventlessdev/reventless-core 3.0.0-alpha.136 → 3.0.0-alpha.138

package/tests/aggregate/AggregateCacheTest.res.mjs

@@ -0,0 +1,433 @@
+// Generated by ReScript, PLEASE EDIT WITH CARE
+
+import * as S from "sury/src/S.res.mjs";
+import * as Stdlib_Array from "@rescript/runtime/lib/es6/Stdlib_Array.js";
+import * as Id$Reventless from "@reventlessdev/reventless-spec/src/types/Id.res.mjs";
+import * as Effect from "effect/Effect";
+import * as Stream from "effect/Stream";
+import * as Aggregate_Callback$ReventlessCore from "../../src/components/Aggregate/Aggregate_Callback.res.mjs";
+
+S.enableJson();
+
+let name = "CacheTestAggregate";
+
+let commandSchema = S.union([
+  S.schema(s => ({
+    TAG: "Add",
+    name: s.m(S.string)
+  })),
+  S.literal("Checkpoint"),
+  S.literal("Noop")
+]);
+
+let eventSchema = S.union([
+  S.schema(s => ({
+    TAG: "Added",
+    name: s.m(S.string)
+  })),
+  S.schema(s => ({
+    TAG: "CheckpointTaken",
+    count: s.m(S.int)
+  }))
+]);
+
+let errorSchema = S.literal("Never");
+
+let moduleUrl = import.meta.url;
+
+function commandAuthorization(param) {
+  return "AllowAuthenticated";
+}
+
+let AggSpec = {
+  Id: undefined,
+  name: name,
+  commandSchema: commandSchema,
+  eventSchema: eventSchema,
+  errorSchema: errorSchema,
+  moduleUrl: moduleUrl,
+  commandAuthorization: commandAuthorization
+};
+
+let initialState = {
+  names: []
+};
+
+let moduleUrl$1 = import.meta.url;
+
+function evolve(state, event) {
+  if (event.TAG === "Added") {
+    return {
+      names: state.names.concat([event.name])
+    };
+  } else {
+    return state;
+  }
+}
+
+function decide(state, command) {
+  if (typeof command !== "object") {
+    if (command === "Checkpoint") {
+      return {
+        TAG: "Ok",
+        _0: [{
+            TAG: "CheckpointTaken",
+            count: state.names.length
+          }]
+      };
+    } else {
+      return {
+        TAG: "Ok",
+        _0: []
+      };
+    }
+  } else {
+    return {
+      TAG: "Ok",
+      _0: [{
+          TAG: "Added",
+          name: command.name
+        }]
+    };
+  }
+}
+
+let TestBehavior = {
+  Spec: undefined,
+  initialState: initialState,
+  snapshot: undefined,
+  moduleUrl: moduleUrl$1,
+  evolve: evolve,
+  decide: decide
+};
+
+let testMeta = {
+  service: "CacheTestAggregate",
+  time: "2024-01-01T00:00:00Z",
+  ip: "127.0.0.1",
+  user: "test-user",
+  msgId: "msg-1",
+  correlationId: "corr-1"
+};
+
+function makeMockEL() {
+  let storedRef = {
+    contents: []
+  };
+  let appendCount = {
+    contents: 0
+  };
+  let replayCount = {
+    contents: 0
+  };
+  let eventsFor = id => storedRef.contents.filter(e => e.id === id);
+  let appendFn = async (seqNr, id, newEvents) => {
+    appendCount.contents = appendCount.contents + 1 | 0;
+    if (seqNr !== eventsFor(id).length) {
+      return {
+        TAG: "Error",
+        _0: "Conflict"
+      };
+    } else {
+      storedRef.contents = storedRef.contents.concat(newEvents);
+      return {
+        TAG: "Ok",
+        _0: undefined
+      };
+    }
+  };
+  let replayFn = async id => {
+    replayCount.contents = replayCount.contents + 1 | 0;
+    return eventsFor(id).map(e => e.event);
+  };
+  let replayStreamFn = id => {
+    replayCount.contents = replayCount.contents + 1 | 0;
+    return Stream.fromIterable(eventsFor(id).map(e => e.event));
+  };
+  return {
+    appendFn: appendFn,
+    replayFn: replayFn,
+    replayStreamFn: replayStreamFn,
+    getAll: () => storedRef.contents,
+    injectExternal: (id, event) => {
+      storedRef.contents = storedRef.contents.concat([{
+          id: id,
+          meta: testMeta,
+          event: event
+        }]);
+    },
+    appendCallCount: appendCount,
+    replayCallCount: replayCount,
+    reset: () => {
+      storedRef.contents = [];
+      appendCount.contents = 0;
+      replayCount.contents = 0;
+    }
+  };
+}
+
+let mock = makeMockEL();
+
+let name$1 = "CacheMockEventLog";
+
+let Spec = {
+  Id: undefined,
+  name: name$1,
+  eventSchema: eventSchema
+};
+
+function make(param, param$1) {
+  return 0;
+}
+
+let EventLog = {
+  Spec: Spec,
+  make: make
+};
+
+let eventLog_append = mock.appendFn;
+
+let eventLog_replay = mock.replayFn;
+
+function eventLog_replayStream(id, param) {
+  return mock.replayStreamFn(id);
+}
+
+function eventLog_appendStream(_startingSeqNr, _id, stream) {
+  return Stream.runDrain(stream);
+}
+
+async function eventLog_latestSnapshot(param) {
+  return {
+    TAG: "Ok",
+    _0: undefined
+  };
+}
+
+async function eventLog_writeSnapshot(param, param$1) {
+  return {
+    TAG: "Ok",
+    _0: undefined
+  };
+}
+
+let eventLog = {
+  append: eventLog_append,
+  replay: eventLog_replay,
+  replayStream: eventLog_replayStream,
+  appendStream: eventLog_appendStream,
+  latestSnapshot: eventLog_latestSnapshot,
+  writeSnapshot: eventLog_writeSnapshot
+};
+
+let TestOps = {
+  Spec: undefined,
+  EventLog: EventLog,
+  eventLog: eventLog
+};
+
+let TestHandler = Aggregate_Callback$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,
+  errorSchema: errorSchema,
+  commandSchema: commandSchema,
+  moduleUrl: moduleUrl,
+  commandAuthorization: commandAuthorization
+})({
+  initialState: initialState,
+  evolve: evolve,
+  decide: decide,
+  snapshot: undefined,
+  moduleUrl: moduleUrl$1
+})({
+  Spec: {
+    Id: {
+      schema: Id$Reventless.StringPure.schema,
+      make: prim => prim,
+      makeFromString: prim => prim,
+      toString: prim => prim,
+      cmp: Id$Reventless.StringPure.cmp
+    },
+    name: name,
+    eventSchema: eventSchema,
+    errorSchema: errorSchema,
+    commandSchema: commandSchema,
+    moduleUrl: moduleUrl,
+    commandAuthorization: commandAuthorization
+  },
+  EventLog: {
+    Spec: {
+      Id: {
+        schema: Id$Reventless.StringPure.schema,
+        make: prim => prim,
+        makeFromString: prim => prim,
+        toString: prim => prim,
+        cmp: Id$Reventless.StringPure.cmp
+      },
+      name: name$1,
+      eventSchema: eventSchema
+    },
+    make: make
+  },
+  eventLog: eventLog
+});
+
+function makeTopicItem(reference, command) {
+  return {
+    command: {
+      id: "agg-1",
+      meta: testMeta,
+      command: command
+    },
+    reference: reference
+  };
+}
+
+async function run(command) {
+  return await Effect.runPromise(TestHandler.handleCommands(Stream.fromIterable([makeTopicItem("ref", command)])));
+}
+
+globalThis.beforeEach(() => {
+  mock.reset();
+  TestHandler.resetCache();
+});
+
+globalThis.describe("Aggregate_Callback — replay cache:", () => {
+  globalThis.test("warm same-id command skips the replay", async () => {
+    let r1 = await run({
+      TAG: "Add",
+      name: "a"
+    });
+    let r2 = await run({
+      TAG: "Add",
+      name: "b"
+    });
+    globalThis.expect([
+      r1,
+      r2
+    ]).toEqual([
+      [{
+          TAG: "Ok",
+          _0: "ref"
+        }],
+      [{
+          TAG: "Ok",
+          _0: "ref"
+        }]
+    ]);
+    globalThis.expect(mock.replayCallCount.contents).toBe(1);
+    globalThis.expect([
+      mock.appendCallCount.contents,
+      mock.getAll().length
+    ]).toEqual([
+      2,
+      2
+    ]);
+  });
+  globalThis.test("cached fold state equals a cold replay of the log", async () => {
+    await run({
+      TAG: "Add",
+      name: "a"
+    });
+    await run({
+      TAG: "Add",
+      name: "b"
+    });
+    await run({
+      TAG: "Add",
+      name: "c"
+    });
+    await run("Checkpoint");
+    globalThis.expect(mock.replayCallCount.contents).toBe(1);
+    TestHandler.resetCache();
+    await run("Checkpoint");
+    globalThis.expect(mock.replayCallCount.contents).toBe(2);
+    let checkpoints = Stdlib_Array.filterMap(mock.getAll(), e => {
+      let match = e.event;
+      if (match.TAG === "Added") {
+        return;
+      } else {
+        return match.count;
+      }
+    });
+    globalThis.expect(checkpoints).toEqual([
+      3,
+      3
+    ]);
+  });
+  globalThis.test("stale cache conflicts, invalidates, and self-heals", async () => {
+    await run({
+      TAG: "Add",
+      name: "a"
+    });
+    mock.injectExternal("agg-1", {
+      TAG: "Added",
+      name: "external"
+    });
+    let results = await run({
+      TAG: "Add",
+      name: "b"
+    });
+    globalThis.expect(results).toEqual([{
+        TAG: "Ok",
+        _0: "ref"
+      }]);
+    globalThis.expect(mock.replayCallCount.contents).toBe(2);
+    globalThis.expect(mock.getAll().length).toBe(3);
+    await run("Checkpoint");
+    let last = mock.getAll()[3];
+    globalThis.expect(last.event).toEqual({
+      TAG: "CheckpointTaken",
+      count: 3
+    });
+  });
+  globalThis.test("Ok([]) keeps the read snapshot warm", async () => {
+    await run({
+      TAG: "Add",
+      name: "a"
+    });
+    await run("Noop");
+    await run({
+      TAG: "Add",
+      name: "b"
+    });
+    globalThis.expect(mock.replayCallCount.contents).toBe(1);
+    globalThis.expect(mock.getAll().length).toBe(2);
+  });
+  globalThis.test("resetCache forces the next command to replay cold", async () => {
+    await run({
+      TAG: "Add",
+      name: "a"
+    });
+    TestHandler.resetCache();
+    await run({
+      TAG: "Add",
+      name: "b"
+    });
+    globalThis.expect(mock.replayCallCount.contents).toBe(2);
+    globalThis.expect(mock.getAll().length).toBe(2);
+  });
+});
+
+let OuterEventLog;
+
+export {
+  AggSpec,
+  TestBehavior,
+  testMeta,
+  makeMockEL,
+  mock,
+  OuterEventLog,
+  TestOps,
+  TestHandler,
+  makeTopicItem,
+  run,
+}
+/*  Not a pure module */

package/tests/aggregate/AggregateCallbackTest.res

@@ -1,7 +1,10 @@
 open JestGlobals
 open AggregateFixtures
 
-let _ = beforeEach(() => mock.reset())
+let _ = beforeEach(() => {
+  mock.reset()
+  TestHandler.resetCache()
+})
 
 describe("Aggregate_Callback.handleCommands:", () => {
   describe("single command — new aggregate", () => {

package/tests/aggregate/AggregateCallbackTest.res.mjs

@@ -4,7 +4,10 @@ import * as Effect from "effect/Effect";
 import * as Stream from "effect/Stream";
 import * as AggregateFixtures$ReventlessCore from "./AggregateFixtures.res.mjs";
 
-globalThis.beforeEach(() => AggregateFixtures$ReventlessCore.mock.reset());
+globalThis.beforeEach(() => {
+  AggregateFixtures$ReventlessCore.mock.reset();
+  AggregateFixtures$ReventlessCore.TestHandler.resetCache();
+});
 
 globalThis.describe("Aggregate_Callback.handleCommands:", () => {
   globalThis.describe("single command — new aggregate", () => {

package/tests/aggregate/AggregateCausationTest.res

@@ -8,7 +8,10 @@
 open JestGlobals
 open AggregateFixtures
 
-let _ = beforeEach(() => mock.reset())
+let _ = beforeEach(() => {
+  mock.reset()
+  TestHandler.resetCache()
+})
 
 describe("Aggregate_Callback causation propagation:", () => {
   testPromise("event.meta.causationId = command.meta.msgId", async () => {

package/tests/aggregate/AggregateCausationTest.res.mjs

@@ -4,7 +4,10 @@ import * as Effect from "effect/Effect";
 import * as Stream from "effect/Stream";
 import * as AggregateFixtures$ReventlessCore from "./AggregateFixtures.res.mjs";
 
-globalThis.beforeEach(() => AggregateFixtures$ReventlessCore.mock.reset());
+globalThis.beforeEach(() => {
+  AggregateFixtures$ReventlessCore.mock.reset();
+  AggregateFixtures$ReventlessCore.TestHandler.resetCache();
+});
 
 globalThis.describe("Aggregate_Callback causation propagation:", () => {
   globalThis.test("event.meta.causationId = command.meta.msgId", async () => {

package/tests/aggregate/AggregateConflictTest.res

@@ -27,6 +27,10 @@ module TestBehavior = {
 
   let initialState = {name: ""}
 
+  // Hand-written behavior (no @@reventless.behavior PPX) — satisfy the
+  // Behavior.T snapshot field manually.
+  let snapshot = None
+
   let moduleUrl: string = %raw(`import.meta.url`)
 
   let evolve = (_state: state, event: AggSpec.event): state =>
@@ -116,8 +120,10 @@ module TestOps = {
     type operations = {
       append: (int, string, array<Message.event'<string, AggSpec.event>>) => promise<result<unit, EventLog.appendError>>,
       replay: string => promise<array<AggSpec.event>>,
-      replayStream: string => Stream.t<AggSpec.event, string, unit>,
+      replayStream: (string, ~fromSeq: int=?) => Stream.t<AggSpec.event, string, unit>,
       appendStream: (int, string, Stream.t<AggSpec.event, string, unit>) => Effect.t<unit, string, unit>,
+      latestSnapshot: string => promise<result<option<EventLog.snapshot>, string>>,
+      writeSnapshot: (string, EventLog.snapshot) => promise<result<unit, string>>,
     }
     type component = Component.t<OuterEventLog.t, OuterEventLog.outputs, operations>
     let make = (~name as _: string, ~opts as _=?): component => Obj.magic(0)
@@ -125,8 +131,10 @@ module TestOps = {
   let eventLog: EventLog.operations = {
     append: mock.appendFn,
     replay: mock.replayFn,
-    replayStream: mock.replayStreamFn,
+    replayStream: (id, ~fromSeq as _=?) => mock.replayStreamFn(id),
     appendStream: (_startingSeqNr, _id, stream) => stream->Stream.runDrain,
+    latestSnapshot: async _ => Ok(None),
+    writeSnapshot: async (_, _) => Ok(),
   }
 }
 
@@ -152,7 +160,10 @@ let makeTopicItem = (reference, command): CommandTopic.topicItem<
   reference,
 }
 
-let _ = beforeEach(() => mock.reset())
+let _ = beforeEach(() => {
+  mock.reset()
+  TestHandler.resetCache()
+})
 
 describe("Aggregate_Callback — conflict retry:", () => {
   testPromise("1 conflict retries and succeeds", async () => {

package/tests/aggregate/AggregateConflictTest.res.mjs

@@ -63,6 +63,7 @@ function decide(_state, command) {
 let TestBehavior = {
   Spec: undefined,
   initialState: initialState,
+  snapshot: undefined,
   moduleUrl: moduleUrl$1,
   evolve: evolve,
   decide: decide
@@ -145,17 +146,35 @@ let eventLog_append = mock.appendFn;
 
 let eventLog_replay = mock.replayFn;
 
-let eventLog_replayStream = mock.replayStreamFn;
+function eventLog_replayStream(id, param) {
+  return mock.replayStreamFn(id);
+}
 
 function eventLog_appendStream(_startingSeqNr, _id, stream) {
   return Stream.runDrain(stream);
 }
 
+async function eventLog_latestSnapshot(param) {
+  return {
+    TAG: "Ok",
+    _0: undefined
+  };
+}
+
+async function eventLog_writeSnapshot(param, param$1) {
+  return {
+    TAG: "Ok",
+    _0: undefined
+  };
+}
+
 let eventLog = {
   append: eventLog_append,
   replay: eventLog_replay,
   replayStream: eventLog_replayStream,
-  appendStream: eventLog_appendStream
+  appendStream: eventLog_appendStream,
+  latestSnapshot: eventLog_latestSnapshot,
+  writeSnapshot: eventLog_writeSnapshot
 };
 
 let TestOps = {
@@ -182,6 +201,7 @@ let TestHandler = Aggregate_Callback$ReventlessCore.Make({
   initialState: initialState,
   evolve: evolve,
   decide: decide,
+  snapshot: undefined,
   moduleUrl: moduleUrl$1
 })({
   Spec: {
@@ -236,7 +256,10 @@ function makeTopicItem(reference, command) {
   };
 }
 
-globalThis.beforeEach(() => mock.reset());
+globalThis.beforeEach(() => {
+  mock.reset();
+  TestHandler.resetCache();
+});
 
 globalThis.describe("Aggregate_Callback — conflict retry:", () => {
   globalThis.test("1 conflict retries and succeeds", async () => {

package/tests/aggregate/AggregateFixtures.res

@@ -38,6 +38,10 @@ module TestBehavior = {
 
   let initialState = NotCreated
 
+  // Hand-written behavior (no @@reventless.behavior PPX) — satisfy the
+  // Behavior.T snapshot field manually.
+  let snapshot = None
+
   let moduleUrl: string = %raw(`import.meta.url`)
 
   let evolve = (_state: state, event: AggSpec.event): state =>
@@ -131,8 +135,10 @@ module TestOps = {
         array<Message.event'<string, AggSpec.event>>,
       ) => promise<result<unit, EventLog.appendError>>,
       replay: string => promise<array<AggSpec.event>>,
-      replayStream: string => Stream.t<AggSpec.event, string, unit>,
+      replayStream: (string, ~fromSeq: int=?) => Stream.t<AggSpec.event, string, unit>,
       appendStream: (int, string, Stream.t<AggSpec.event, string, unit>) => Effect.t<unit, string, unit>,
+      latestSnapshot: string => promise<result<option<EventLog.snapshot>, string>>,
+      writeSnapshot: (string, EventLog.snapshot) => promise<result<unit, string>>,
     }
     type component = Component.t<OuterEventLog.t, OuterEventLog.outputs, operations>
     // Never called — satisfies module type only
@@ -141,8 +147,10 @@ module TestOps = {
   let eventLog: EventLog.operations = {
     append: mock.appendFn,
     replay: mock.replayFn,
-    replayStream: mock.replayStreamFn,
+    replayStream: (id, ~fromSeq as _=?) => mock.replayStreamFn(id),
     appendStream: (_startingSeqNr, _id, stream) => stream->Stream.runDrain,
+    latestSnapshot: async _ => Ok(None),
+    writeSnapshot: async (_, _) => Ok(),
   }
 }
 

package/tests/aggregate/AggregateFixtures.res.mjs

@@ -112,6 +112,7 @@ let TestBehavior = {
   Spec: undefined,
   stateSchema: stateSchema,
   initialState: "NotCreated",
+  snapshot: undefined,
   moduleUrl: moduleUrl$1,
   evolve: evolve,
   decide: decide
@@ -180,17 +181,35 @@ let eventLog_append = mock.appendFn;
 
 let eventLog_replay = mock.replayFn;
 
-let eventLog_replayStream = mock.replayStreamFn;
+function eventLog_replayStream(id, param) {
+  return mock.replayStreamFn(id);
+}
 
 function eventLog_appendStream(_startingSeqNr, _id, stream) {
   return Stream.runDrain(stream);
 }
 
+async function eventLog_latestSnapshot(param) {
+  return {
+    TAG: "Ok",
+    _0: undefined
+  };
+}
+
+async function eventLog_writeSnapshot(param, param$1) {
+  return {
+    TAG: "Ok",
+    _0: undefined
+  };
+}
+
 let eventLog = {
   append: eventLog_append,
   replay: eventLog_replay,
   replayStream: eventLog_replayStream,
-  appendStream: eventLog_appendStream
+  appendStream: eventLog_appendStream,
+  latestSnapshot: eventLog_latestSnapshot,
+  writeSnapshot: eventLog_writeSnapshot
 };
 
 let TestOps = {
@@ -217,6 +236,7 @@ let TestHandler = Aggregate_Callback$ReventlessCore.Make({
   initialState: "NotCreated",
   evolve: evolve,
   decide: decide,
+  snapshot: undefined,
   moduleUrl: moduleUrl$1
 })({
   Spec: {

package/tests/aggregate/AggregateRejectionTest.res

@@ -7,7 +7,10 @@
 open JestGlobals
 open AggregateFixtures
 
-let _ = beforeEach(() => mock.reset())
+let _ = beforeEach(() => {
+  mock.reset()
+  TestHandler.resetCache()
+})
 
 // Captures whatever flows through CommandTopic_Helpers.reportRejected during a test.
 let capturedRejections: ref<array<(string, CommandTopic_Helpers.rejectedResult)>> = ref([])

package/tests/aggregate/AggregateRejectionTest.res.mjs

@@ -5,7 +5,10 @@ import * as Stream from "effect/Stream";
 import * as AggregateFixtures$ReventlessCore from "./AggregateFixtures.res.mjs";
 import * as CommandTopic_Helpers$ReventlessCore from "../../src/components/CommandTopic/CommandTopic_Helpers.res.mjs";
 
-globalThis.beforeEach(() => AggregateFixtures$ReventlessCore.mock.reset());
+globalThis.beforeEach(() => {
+  AggregateFixtures$ReventlessCore.mock.reset();
+  AggregateFixtures$ReventlessCore.TestHandler.resetCache();
+});
 
 let capturedRejections = {
   contents: []