@requence/event-sourcing 1.0.3 → 1.1.0

package/dist/errors.d.ts

@@ -6,6 +6,12 @@ export declare class ConcurrencyError extends Error {
         id: string;
     }, expectedVersion: number, actualVersion: number);
 }
+export declare class CheckpointConcurrencyError extends Error {
+    readonly checkpointType: 'projection' | 'processManager';
+    readonly name: string;
+    readonly expectedVersion: number | null;
+    constructor(checkpointType: 'projection' | 'processManager', name: string, expectedVersion: number | null);
+}
 export declare class ValidationError extends Error {
     readonly zodError: z.ZodError;
     constructor(message: string, zodError: z.ZodError);

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,QAAQ,CAAA;AAEtB,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAErE,qBAAa,gBAAiB,SAAQ,KAAK;gBAEvC,QAAQ,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EACxC,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM;CAMxB;AAED,qBAAa,eAAgB,SAAQ,KAAK;aAGtB,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBADpC,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,CAAC,CAAC,QAAQ;CAIvC;AAED,qBAAa,oBAAqB,SAAQ,eAAe;CAAG;AAE5D,qBAAa,iBAAkB,SAAQ,KAAK;CAAG;AAE/C,qBAAa,YAAY,CAAC,CAAC,SAAS,KAAK,CAAE,SAAQ,KAAK;aAEpC,iBAAiB,EAAE,MAAM;aACzB,WAAW,EAAE,MAAM;aACnB,QAAQ,EAAE,MAAM;aAChB,aAAa,EAAE,CAAC;gBAHhB,iBAAiB,EAAE,MAAM,EACzB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,CAAC;CAMnC;AAED,qBAAa,yBAA0B,SAAQ,KAAK;aAGhC,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE;aAClD,KAAK,EAAE,WAAW,CAAC,GAAG,CAAC;gBAFvC,OAAO,EAAE,MAAM,EACC,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,EAClD,KAAK,EAAE,WAAW,CAAC,GAAG,CAAC;CAI1C;AAED,qBAAa,mBAAoB,SAAQ,KAAK;CAAG;AAEjD,qBAAa,eAAgB,SAAQ,KAAK;CAAG;AAE7C,qBAAa,oCAAoC,CAC/C,CAAC,SAAS,KAAK,CACf,SAAQ,KAAK;aAEK,UAAU,EAAE,MAAM;aAClB,YAAY,EAAE,MAAM;aACpB,KAAK,EAAE,eAAe;aACtB,aAAa,EAAE,CAAC;gBAHhB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,eAAe,EACtB,aAAa,EAAE,CAAC;CAMnC;AAED,qBAAa,wCAAwC,CACnD,CAAC,SAAS,KAAK,CACf,SAAQ,KAAK;aAEK,cAAc,EAAE,MAAM;aACtB,YAAY,EAAE,MAAM;aACpB,KAAK,EAAE,eAAe;aACtB,aAAa,EAAE,CAAC;gBAHhB,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,eAAe,EACtB,aAAa,EAAE,CAAC;CAMnC"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,QAAQ,CAAA;AAEtB,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAErE,qBAAa,gBAAiB,SAAQ,KAAK;gBAEvC,QAAQ,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EACxC,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM;CAMxB;AAED,qBAAa,0BAA2B,SAAQ,KAAK;aAEjC,cAAc,EAAE,YAAY,GAAG,gBAAgB;aAC/C,IAAI,EAAE,MAAM;aACZ,eAAe,EAAE,MAAM,GAAG,IAAI;gBAF9B,cAAc,EAAE,YAAY,GAAG,gBAAgB,EAC/C,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,MAAM,GAAG,IAAI;CAMjD;AAED,qBAAa,eAAgB,SAAQ,KAAK;aAGtB,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBADpC,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,CAAC,CAAC,QAAQ;CAIvC;AAED,qBAAa,oBAAqB,SAAQ,eAAe;CAAG;AAE5D,qBAAa,iBAAkB,SAAQ,KAAK;CAAG;AAE/C,qBAAa,YAAY,CAAC,CAAC,SAAS,KAAK,CAAE,SAAQ,KAAK;aAEpC,iBAAiB,EAAE,MAAM;aACzB,WAAW,EAAE,MAAM;aACnB,QAAQ,EAAE,MAAM;aAChB,aAAa,EAAE,CAAC;gBAHhB,iBAAiB,EAAE,MAAM,EACzB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,CAAC;CAMnC;AAED,qBAAa,yBAA0B,SAAQ,KAAK;aAGhC,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE;aAClD,KAAK,EAAE,WAAW,CAAC,GAAG,CAAC;gBAFvC,OAAO,EAAE,MAAM,EACC,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,EAClD,KAAK,EAAE,WAAW,CAAC,GAAG,CAAC;CAI1C;AAED,qBAAa,mBAAoB,SAAQ,KAAK;CAAG;AAEjD,qBAAa,eAAgB,SAAQ,KAAK;CAAG;AAE7C,qBAAa,oCAAoC,CAC/C,CAAC,SAAS,KAAK,CACf,SAAQ,KAAK;aAEK,UAAU,EAAE,MAAM;aAClB,YAAY,EAAE,MAAM;aACpB,KAAK,EAAE,eAAe;aACtB,aAAa,EAAE,CAAC;gBAHhB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,eAAe,EACtB,aAAa,EAAE,CAAC;CAMnC;AAED,qBAAa,wCAAwC,CACnD,CAAC,SAAS,KAAK,CACf,SAAQ,KAAK;aAEK,cAAc,EAAE,MAAM;aACtB,YAAY,EAAE,MAAM;aACpB,KAAK,EAAE,eAAe;aACtB,aAAa,EAAE,CAAC;gBAHhB,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,eAAe,EACtB,aAAa,EAAE,CAAC;CAMnC"}

package/dist/errors.js

@@ -1,4 +1,5 @@
 import {
+  CheckpointConcurrencyError,
   CommandError,
   ConcurrencyError,
   EventValidationError,
@@ -9,7 +10,7 @@ import {
   RefreshingSkipError,
   ReplaySkipError,
   ValidationError
-} from "./chunk-qdczt68t.js";
+} from "./chunk-391m4mfp.js";
 export {
   ValidationError,
   ReplaySkipError,
@@ -20,7 +21,8 @@ export {
   InfiniteLoopError,
   EventValidationError,
   ConcurrencyError,
-  CommandError
+  CommandError,
+  CheckpointConcurrencyError
 };
 
-//# debugId=42D38D47B374FF0964756E2164756E21
+//# debugId=1EBB5F2728E5435464756E2164756E21

package/dist/errors.js.map

@@ -4,6 +4,6 @@
   "sourcesContent": [
   ],
   "mappings": "",
-  "debugId": "42D38D47B374FF0964756E2164756E21",
+  "debugId": "1EBB5F2728E5435464756E2164756E21",
   "names": []
 }

package/dist/index.js

@@ -4,35 +4,37 @@ import {
 } from "./chunk-jd4q8fcf.js";
 import {
   createEventStore
-} from "./chunk-8pchcyvm.js";
-import {
-  getEventListenerInfo,
-  isInsideEventListener
-} from "./chunk-24xjphpk.js";
-import"./chunk-ty9bhdvx.js";
+} from "./chunk-04wqxaqs.js";
 import"./chunk-gq80tgvf.js";
 import {
   createAggregateRoot
-} from "./chunk-6n3jfg84.js";
-import"./chunk-z388cd25.js";
-import {
-  getProjectionInfo,
-  isInsideProjection
-} from "./chunk-8ev7sb2v.js";
+} from "./chunk-r601d5jm.js";
 import {
   getProcessManagerInfo,
   isInsideProcessManager
-} from "./chunk-13wtyj2h.js";
+} from "./chunk-smy8mxvr.js";
 import"./chunk-6q8mr1sg.js";
-import"./chunk-pmfzjavb.js";
-import {
-  skipReplay
-} from "./chunk-x90g388y.js";
-import"./chunk-zf3x573k.js";
 import {
   skipRefreshing
-} from "./chunk-9psg50cb.js";
+} from "./chunk-6yrb30rx.js";
+import"./chunk-tfy01fah.js";
 import {
+  getProjectionInfo,
+  isInsideProjection
+} from "./chunk-th14wxh8.js";
+import"./chunk-yn2sjcg3.js";
+import"./chunk-8qn1nqnh.js";
+import"./chunk-ty9bhdvx.js";
+import"./chunk-z388cd25.js";
+import {
+  getEventListenerInfo,
+  isInsideEventListener
+} from "./chunk-24xjphpk.js";
+import {
+  skipReplay
+} from "./chunk-2fe8jjdc.js";
+import {
+  CheckpointConcurrencyError,
   CommandError,
   ConcurrencyError,
   EventValidationError,
@@ -43,8 +45,7 @@ import {
   RefreshingSkipError,
   ReplaySkipError,
   ValidationError
-} from "./chunk-qdczt68t.js";
-import"./chunk-tfy01fah.js";
+} from "./chunk-391m4mfp.js";
 export {
   skipReplay,
   skipRefreshing,
@@ -67,7 +68,8 @@ export {
   InfiniteLoopError,
   EventValidationError,
   ConcurrencyError,
-  CommandError
+  CommandError,
+  CheckpointConcurrencyError
 };
 
-//# debugId=5B4FCC65AE37B9EF64756E2164756E21
+//# debugId=6C4703510F84795D64756E2164756E21

package/dist/index.js.map

@@ -4,6 +4,6 @@
   "sourcesContent": [
   ],
   "mappings": "",
-  "debugId": "5B4FCC65AE37B9EF64756E2164756E21",
+  "debugId": "6C4703510F84795D64756E2164756E21",
   "names": []
 }

package/dist/memory/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAWjE,OAAO,KAAK,EACV,UAAU,EACV,0CAA0C,EAC1C,cAAc,EACd,UAAU,EACX,MAAM,wBAAwB,CAAA;AAC/B,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEjD,MAAM,MAAM,gBAAgB,GAAG,CAC7B,MAAM,EAAE,eAAe,EAAE,KACtB,YAAY,CAAC,IAAI,CAAC,CAAA;AAEvB,UAAU,sBAAsB,CAAC,IAAI,SAAS,gBAAgB;IAC5D,cAAc,EAAE,IAAI,EAAE,CAAA;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,gBAAgB,CAAC,EAAE,0CAA0C,CAAC,IAAI,CAAC,CAAC,kBAAkB,CAAC,CAAA;IACvF,kBAAkB,CAAC,EAAE,UAAU,CAAA;IAC/B,uBAAuB,CAAC,EAAE,UAAU,CAAA;IACpC,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;CACpC;AAED,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,IAAI,SAAS,gBAAgB,EAAE,EACpE,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,uBAAuB,EACvB,gBAAgB,EAChB,QAAQ,GACT,EAAE,sBAAsB,CAAC,IAAI,CAAC,GAAG,UAAU,CAC1C,cAAc,CAAC,IAAI,CAAC,EACpB,IAAI,EACJ,IAAI,CACL,CAkLA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAWjE,OAAO,KAAK,EACV,UAAU,EACV,0CAA0C,EAC1C,cAAc,EACd,UAAU,EACX,MAAM,wBAAwB,CAAA;AAC/B,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEjD,MAAM,MAAM,gBAAgB,GAAG,CAC7B,MAAM,EAAE,eAAe,EAAE,KACtB,YAAY,CAAC,IAAI,CAAC,CAAA;AAEvB,UAAU,sBAAsB,CAAC,IAAI,SAAS,gBAAgB;IAC5D,cAAc,EAAE,IAAI,EAAE,CAAA;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,gBAAgB,CAAC,EAAE,0CAA0C,CAAC,IAAI,CAAC,CAAC,kBAAkB,CAAC,CAAA;IACvF,kBAAkB,CAAC,EAAE,UAAU,CAAA;IAC/B,uBAAuB,CAAC,EAAE,UAAU,CAAA;IACpC,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;CACpC;AAED,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,IAAI,SAAS,gBAAgB,EAAE,EACpE,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,uBAAuB,EACvB,gBAAgB,EAChB,QAAQ,GACT,EAAE,sBAAsB,CAAC,IAAI,CAAC,GAAG,UAAU,CAC1C,cAAc,CAAC,IAAI,CAAC,EACpB,IAAI,EACJ,IAAI,CACL,CA0LA"}

package/dist/memory/index.js

@@ -4,25 +4,25 @@ import {
 } from "../chunk-jd4q8fcf.js";
 import {
   createEventStore
-} from "../chunk-8pchcyvm.js";
-import"../chunk-24xjphpk.js";
-import"../chunk-ty9bhdvx.js";
+} from "../chunk-04wqxaqs.js";
 import"../chunk-gq80tgvf.js";
 import {
   createAggregateRoot
-} from "../chunk-6n3jfg84.js";
-import"../chunk-z388cd25.js";
-import"../chunk-8ev7sb2v.js";
-import"../chunk-13wtyj2h.js";
+} from "../chunk-r601d5jm.js";
+import"../chunk-smy8mxvr.js";
 import"../chunk-6q8mr1sg.js";
-import"../chunk-pmfzjavb.js";
-import"../chunk-x90g388y.js";
-import"../chunk-zf3x573k.js";
-import"../chunk-9psg50cb.js";
+import"../chunk-6yrb30rx.js";
+import"../chunk-tfy01fah.js";
+import"../chunk-th14wxh8.js";
+import"../chunk-yn2sjcg3.js";
+import"../chunk-8qn1nqnh.js";
+import"../chunk-ty9bhdvx.js";
+import"../chunk-z388cd25.js";
+import"../chunk-24xjphpk.js";
+import"../chunk-2fe8jjdc.js";
 import {
   ConcurrencyError
-} from "../chunk-qdczt68t.js";
-import"../chunk-tfy01fah.js";
+} from "../chunk-391m4mfp.js";
 
 // src/memory/index.ts
 function createEventStore2({
@@ -102,7 +102,7 @@ function createEventStore2({
           }
         }
       },
-      upsert(checkpoint) {
+      upsert(checkpoint, expectedVersion) {
         let persisted;
         for (const c of checkpoints) {
           if (c.type === checkpoint.type && c.name === checkpoint.name) {
@@ -111,11 +111,16 @@ function createEventStore2({
           }
         }
         if (persisted) {
+          if (expectedVersion === null || persisted.version !== expectedVersion) {
+            return false;
+          }
           persisted.lastEventPosition = checkpoint.lastEventPosition;
           persisted.metadata = checkpoint.metadata;
+          persisted.version = checkpoint.version;
         } else {
-          checkpoints.add(checkpoint);
+          checkpoints.add({ ...checkpoint });
         }
+        return true;
       },
       delete(type, name) {
         for (const checkpoint of checkpoints) {
@@ -175,4 +180,4 @@ export {
   createAggregateRoot
 };
 
-//# debugId=94478E1EDE4A6DEF64756E2164756E21
+//# debugId=DB351FF2D489173564756E2164756E21

package/dist/memory/index.js.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../src/memory/index.ts"],
   "sourcesContent": [
-    "import type { AnyAggregateRoot } from '../createAggregateRoot.ts'\nimport type { Checkpoint } from '../createCheckpointApi.ts'\nimport {\n  type AggregateRootSnapshot,\n  ConcurrencyError,\n  type Event,\n  type ProjectionSnapshot,\n  createEventStore as createBaseEventStore,\n  isStreamEvents,\n  isStreamId,\n} from '../index.ts'\nimport type {\n  EventStore,\n  EventStoreParamsWithAggregateRootSnapshots,\n  EventsFromRoot,\n  OnProgress,\n} from '../createEventStore.ts'\nimport type { BaseOutputEvent, MaybePromise } from '../utilityTypes.js'\n\nexport { createAggregateRoot } from '../index.ts'\n\nexport type OnEventsAppended = (\n  events: BaseOutputEvent[],\n) => MaybePromise<void>\n\ninterface MemoryEventStoreParams<Root extends AnyAggregateRoot> {\n  aggregateRoots: Root[]\n  autoInit?: boolean\n  postProcessEvent?: EventStoreParamsWithAggregateRootSnapshots<Root>['postProcessEvent']\n  onProjectionReplay?: OnProgress\n  onProcessManagerRefresh?: OnProgress\n  onEventsAppended?: OnEventsAppended\n}\n\nexport function createEventStore<const Root extends AnyAggregateRoot>({\n  aggregateRoots,\n  postProcessEvent,\n  onProjectionReplay,\n  onProcessManagerRefresh,\n  onEventsAppended,\n  autoInit,\n}: MemoryEventStoreParams<Root>): EventStore<\n  EventsFromRoot<Root>,\n  Root,\n  true\n> {\n  const events: Event[] = []\n  const checkpoints = new Set<Checkpoint>()\n  const aggregateRootSnapshots = new Map<string, AggregateRootSnapshot>()\n  const projectionSnapshots = new Set<ProjectionSnapshot>()\n  const projectionAppliedCount = new Map<string, number>()\n\n  return createBaseEventStore({\n    aggregateRoots,\n    postProcessEvent,\n    onProjectionReplay,\n    onProcessManagerRefresh,\n    autoInit,\n\n    async *loadEvents(select, range) {\n      let streamTypes: string[] | null = null\n      let streamIds: string[] | null = null\n      let eventTypes: string[] | null = null\n\n      if (select) {\n        const selects = Array.isArray(select) ? select : [select]\n        streamTypes = selects.map((select) => select.stream)\n        streamIds = selects\n          .map((select) => (isStreamId(select) ? select.id : null))\n          .filter(Boolean) as string[]\n        eventTypes = selects.flatMap((select) =>\n          isStreamEvents(select) ? select.events : [],\n        )\n      }\n\n      const filteredEvents = events.filter((event) => {\n        if (streamTypes?.length && !streamTypes.includes(event.streamType)) {\n          return false\n        }\n\n        if (streamIds?.length && !streamIds.includes(event.streamId)) {\n          return false\n        }\n\n        if (eventTypes?.length && !eventTypes.includes(event.type)) {\n          return false\n        }\n\n        if (range?.from && event.position < range.from) {\n          return false\n        }\n\n        if (range?.to && event.position > range.to) {\n          return false\n        }\n\n        return true\n      })\n\n      for (const event of filteredEvents) {\n        yield event\n      }\n    },\n\n    appendEvents({ id, stream }, newEvents, expectedVersion) {\n      const lastEvent = events.findLast(\n        (e) => e.streamId === id && e.streamType === stream,\n      )\n\n      const currentVersion = lastEvent?.streamVersion ?? 0\n\n      if (currentVersion !== expectedVersion) {\n        throw new ConcurrencyError(\n          { id, stream },\n          expectedVersion,\n          currentVersion,\n        )\n      }\n\n      const extendedEvents: Event[] = newEvents.map((event, index) => ({\n        ...event,\n        createdAt: new Date(),\n        position: events.length + index,\n        streamId: id,\n        streamType: stream,\n        streamVersion: expectedVersion + index + 1,\n      }))\n\n      events.push(...extendedEvents)\n      onEventsAppended?.(extendedEvents)\n      return extendedEvents\n    },\n\n    checkpoint: {\n      get(type, name) {\n        for (const checkpoint of checkpoints) {\n          if (checkpoint.type === type && checkpoint.name === name) {\n            return checkpoint\n          }\n        }\n      },\n      upsert(checkpoint) {\n        let persisted: Checkpoint | undefined\n        for (const c of checkpoints) {\n          if (c.type === checkpoint.type && c.name === checkpoint.name) {\n            persisted = c\n            break\n          }\n        }\n\n        if (persisted) {\n          persisted.lastEventPosition = checkpoint.lastEventPosition\n          persisted.metadata = checkpoint.metadata\n        } else {\n          checkpoints.add(checkpoint)\n        }\n      },\n      delete(type, name) {\n        for (const checkpoint of checkpoints) {\n          if (checkpoint.type === type && checkpoint.name === name) {\n            checkpoints.delete(checkpoint)\n          }\n        }\n      },\n    },\n\n    projectionSnapshot: {\n      put(snapshot) {\n        projectionSnapshots.add(snapshot)\n      },\n      get(select) {\n        return Array.from(projectionSnapshots)\n          .toReversed()\n          .find(\n            (snapshot) =>\n              snapshot.projectionId === select.id &&\n              snapshot.projectionType === select.projection,\n          )\n      },\n      delete(target, fromPosition) {\n        for (const snapshot of projectionSnapshots) {\n          if (target.id && snapshot.projectionId !== target.id) {\n            continue\n          }\n\n          if (snapshot.projectionType !== target.projection) {\n            continue\n          }\n\n          if (fromPosition && snapshot.lastEventPosition < fromPosition) {\n            continue\n          }\n\n          projectionSnapshots.delete(snapshot)\n        }\n      },\n      incrementAppliedCount(select) {\n        const key = `${select.projection}-${select.id}`\n        const nextCount = (projectionAppliedCount.get(key) ?? 0) + 1\n        projectionAppliedCount.set(key, nextCount)\n        return nextCount\n      },\n    },\n\n    aggregateRootSnapshot: {\n      put(snapshot) {\n        aggregateRootSnapshots.set(\n          `${snapshot.streamType}:${snapshot.streamId}`,\n          snapshot,\n        )\n      },\n      get(select) {\n        return aggregateRootSnapshots.get(`${select.stream}:${select.id}`)\n      },\n      delete(target, fromStreamVersion) {\n        const key = `${target.stream}:${target.id}`\n        const snapshot = aggregateRootSnapshots.get(key)\n        if (snapshot && snapshot.streamVersion > fromStreamVersion) {\n          aggregateRootSnapshots.delete(key)\n        }\n      },\n    },\n  }) as any\n}\n"
+    "import type { AnyAggregateRoot } from '../createAggregateRoot.ts'\nimport type { Checkpoint } from '../createCheckpointApi.ts'\nimport {\n  type AggregateRootSnapshot,\n  ConcurrencyError,\n  type Event,\n  type ProjectionSnapshot,\n  createEventStore as createBaseEventStore,\n  isStreamEvents,\n  isStreamId,\n} from '../index.ts'\nimport type {\n  EventStore,\n  EventStoreParamsWithAggregateRootSnapshots,\n  EventsFromRoot,\n  OnProgress,\n} from '../createEventStore.ts'\nimport type { BaseOutputEvent, MaybePromise } from '../utilityTypes.js'\n\nexport { createAggregateRoot } from '../index.ts'\n\nexport type OnEventsAppended = (\n  events: BaseOutputEvent[],\n) => MaybePromise<void>\n\ninterface MemoryEventStoreParams<Root extends AnyAggregateRoot> {\n  aggregateRoots: Root[]\n  autoInit?: boolean\n  postProcessEvent?: EventStoreParamsWithAggregateRootSnapshots<Root>['postProcessEvent']\n  onProjectionReplay?: OnProgress\n  onProcessManagerRefresh?: OnProgress\n  onEventsAppended?: OnEventsAppended\n}\n\nexport function createEventStore<const Root extends AnyAggregateRoot>({\n  aggregateRoots,\n  postProcessEvent,\n  onProjectionReplay,\n  onProcessManagerRefresh,\n  onEventsAppended,\n  autoInit,\n}: MemoryEventStoreParams<Root>): EventStore<\n  EventsFromRoot<Root>,\n  Root,\n  true\n> {\n  const events: Event[] = []\n  const checkpoints = new Set<Checkpoint>()\n  const aggregateRootSnapshots = new Map<string, AggregateRootSnapshot>()\n  const projectionSnapshots = new Set<ProjectionSnapshot>()\n  const projectionAppliedCount = new Map<string, number>()\n\n  return createBaseEventStore({\n    aggregateRoots,\n    postProcessEvent,\n    onProjectionReplay,\n    onProcessManagerRefresh,\n    autoInit,\n\n    async *loadEvents(select, range) {\n      let streamTypes: string[] | null = null\n      let streamIds: string[] | null = null\n      let eventTypes: string[] | null = null\n\n      if (select) {\n        const selects = Array.isArray(select) ? select : [select]\n        streamTypes = selects.map((select) => select.stream)\n        streamIds = selects\n          .map((select) => (isStreamId(select) ? select.id : null))\n          .filter(Boolean) as string[]\n        eventTypes = selects.flatMap((select) =>\n          isStreamEvents(select) ? select.events : [],\n        )\n      }\n\n      const filteredEvents = events.filter((event) => {\n        if (streamTypes?.length && !streamTypes.includes(event.streamType)) {\n          return false\n        }\n\n        if (streamIds?.length && !streamIds.includes(event.streamId)) {\n          return false\n        }\n\n        if (eventTypes?.length && !eventTypes.includes(event.type)) {\n          return false\n        }\n\n        if (range?.from && event.position < range.from) {\n          return false\n        }\n\n        if (range?.to && event.position > range.to) {\n          return false\n        }\n\n        return true\n      })\n\n      for (const event of filteredEvents) {\n        yield event\n      }\n    },\n\n    appendEvents({ id, stream }, newEvents, expectedVersion) {\n      const lastEvent = events.findLast(\n        (e) => e.streamId === id && e.streamType === stream,\n      )\n\n      const currentVersion = lastEvent?.streamVersion ?? 0\n\n      if (currentVersion !== expectedVersion) {\n        throw new ConcurrencyError(\n          { id, stream },\n          expectedVersion,\n          currentVersion,\n        )\n      }\n\n      const extendedEvents: Event[] = newEvents.map((event, index) => ({\n        ...event,\n        createdAt: new Date(),\n        position: events.length + index,\n        streamId: id,\n        streamType: stream,\n        streamVersion: expectedVersion + index + 1,\n      }))\n\n      events.push(...extendedEvents)\n      onEventsAppended?.(extendedEvents)\n      return extendedEvents\n    },\n\n    checkpoint: {\n      get(type, name) {\n        for (const checkpoint of checkpoints) {\n          if (checkpoint.type === type && checkpoint.name === name) {\n            return checkpoint\n          }\n        }\n      },\n      upsert(checkpoint, expectedVersion) {\n        let persisted: Checkpoint | undefined\n        for (const c of checkpoints) {\n          if (c.type === checkpoint.type && c.name === checkpoint.name) {\n            persisted = c\n            break\n          }\n        }\n\n        if (persisted) {\n          // Compare-and-swap: reject the write when another writer advanced the\n          // checkpoint, or when the caller expected to create a fresh one.\n          if (expectedVersion === null || persisted.version !== expectedVersion) {\n            return false\n          }\n          persisted.lastEventPosition = checkpoint.lastEventPosition\n          persisted.metadata = checkpoint.metadata\n          persisted.version = checkpoint.version\n        } else {\n          checkpoints.add({ ...checkpoint })\n        }\n\n        return true\n      },\n      delete(type, name) {\n        for (const checkpoint of checkpoints) {\n          if (checkpoint.type === type && checkpoint.name === name) {\n            checkpoints.delete(checkpoint)\n          }\n        }\n      },\n    },\n\n    projectionSnapshot: {\n      put(snapshot) {\n        projectionSnapshots.add(snapshot)\n      },\n      get(select) {\n        return Array.from(projectionSnapshots)\n          .toReversed()\n          .find(\n            (snapshot) =>\n              snapshot.projectionId === select.id &&\n              snapshot.projectionType === select.projection,\n          )\n      },\n      delete(target, fromPosition) {\n        for (const snapshot of projectionSnapshots) {\n          if (target.id && snapshot.projectionId !== target.id) {\n            continue\n          }\n\n          if (snapshot.projectionType !== target.projection) {\n            continue\n          }\n\n          if (fromPosition && snapshot.lastEventPosition < fromPosition) {\n            continue\n          }\n\n          projectionSnapshots.delete(snapshot)\n        }\n      },\n      incrementAppliedCount(select) {\n        const key = `${select.projection}-${select.id}`\n        const nextCount = (projectionAppliedCount.get(key) ?? 0) + 1\n        projectionAppliedCount.set(key, nextCount)\n        return nextCount\n      },\n    },\n\n    aggregateRootSnapshot: {\n      put(snapshot) {\n        aggregateRootSnapshots.set(\n          `${snapshot.streamType}:${snapshot.streamId}`,\n          snapshot,\n        )\n      },\n      get(select) {\n        return aggregateRootSnapshots.get(`${select.stream}:${select.id}`)\n      },\n      delete(target, fromStreamVersion) {\n        const key = `${target.stream}:${target.id}`\n        const snapshot = aggregateRootSnapshots.get(key)\n        if (snapshot && snapshot.streamVersion > fromStreamVersion) {\n          aggregateRootSnapshots.delete(key)\n        }\n      },\n    },\n  }) as any\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "94478E1EDE4A6DEF64756E2164756E21",
+  "mappings": "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",
+  "debugId": "DB351FF2D489173564756E2164756E21",
   "names": []
 }

package/dist/refresh.js

@@ -2,8 +2,8 @@ import {
   isRefreshing,
   skipRefreshing,
   withRefreshing
-} from "./chunk-9psg50cb.js";
-import"./chunk-qdczt68t.js";
+} from "./chunk-6yrb30rx.js";
+import"./chunk-391m4mfp.js";
 export {
   withRefreshing,
   skipRefreshing,

package/dist/replay.js

@@ -2,8 +2,8 @@ import {
   isReplaying,
   skipReplay,
   withReplaying
-} from "./chunk-x90g388y.js";
-import"./chunk-qdczt68t.js";
+} from "./chunk-2fe8jjdc.js";
+import"./chunk-391m4mfp.js";
 export {
   withReplaying,
   skipReplay,

package/dist/snapshotGenerator.js

@@ -1,7 +1,7 @@
 import {
   createSnapshotGenerator
-} from "./chunk-pmfzjavb.js";
-import"./chunk-qdczt68t.js";
+} from "./chunk-8qn1nqnh.js";
+import"./chunk-391m4mfp.js";
 export {
   createSnapshotGenerator as default
 };

package/dist/tests/setup.d.ts

@@ -45,6 +45,7 @@ export declare function setupEventStore<const Root extends AnyAggregateRoot>(agg
         type: "projection" | "processManager";
         name: string;
         metadata: Record<string, any>;
+        version: number;
     }>;
     pseudoEventStore: Event[];
     pseudoAggregateRootSnapshotStore: Map<string, {

package/dist/tests/setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/tests/setup.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAEjE,OAAO,EAGL,KAAK,KAAK,EAMX,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,wBAAgB,mBAAmB;;;;;;;;;;;;;;;;;iBAehB,MAAM;gBAGP,MAAM;;;;;;;;;;;;;IAIvB;AAED,wBAAgB,eAAe,CAAC,KAAK,CAAC,IAAI,SAAS,gBAAgB,EACjE,aAAa,EAAE,IAAI,GAAG,IAAI,EAAE,EAC5B,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,KAAK,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,WAAW,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyL9E"}
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/tests/setup.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAEjE,OAAO,EAGL,KAAK,KAAK,EAMX,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,wBAAgB,mBAAmB;;;;;;;;;;;;;;;;;iBAehB,MAAM;gBAGP,MAAM;;;;;;;;;;;;;IAIvB;AAED,wBAAgB,eAAe,CAAC,KAAK,CAAC,IAAI,SAAS,gBAAgB,EACjE,aAAa,EAAE,IAAI,GAAG,IAAI,EAAE,EAC5B,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,KAAK,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,WAAW,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmM9E"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@requence/event-sourcing",
-  "version": "1.0.3",
+  "version": "1.1.0",
   "description": "Event sourcing primitives — aggregate roots, projections, process managers, and event listeners",
   "type": "module",
   "sideEffects": false,

package/src/createCheckpointApi.ts

@@ -1,7 +1,7 @@
 import z from 'zod/v4'
 
 import type { LoadEvents } from './createEventStore.ts'
-import { ValidationError } from './errors.ts'
+import { CheckpointConcurrencyError, ValidationError } from './errors.ts'
 import type {
   BaseOutputEvent,
   MaybePromise,
@@ -13,6 +13,7 @@ const checkpointSchema = z.object({
   type: z.enum(['projection', 'processManager']),
   name: z.string(),
   metadata: z.record(z.string(), z.any()),
+  version: z.int(),
 })
 
 export type Checkpoint = z.output<typeof checkpointSchema>
@@ -26,7 +27,19 @@ export type CheckpointMethods = {
     type: 'projection' | 'processManager',
     name: string,
   ) => MaybePromise<void>
-  upsert: (checkpoint: Checkpoint) => MaybePromise<void>
+  /**
+   * Persist a checkpoint using optimistic concurrency control.
+   *
+   * The write must only succeed if the currently stored version equals
+   * `expectedVersion` (or, when `expectedVersion` is `null`, if no checkpoint
+   * exists yet). `checkpoint.version` holds the version to store on success.
+   * Return `true` when the write was applied and `false` when it was rejected
+   * because another writer had advanced the checkpoint in the meantime.
+   */
+  upsert: (
+    checkpoint: Checkpoint,
+    expectedVersion: number | null,
+  ) => MaybePromise<boolean>
 }
 
 export function createCheckpointApi(
@@ -39,18 +52,81 @@ export function createCheckpointApi(
     applyAfter?: (event: BaseOutputEvent) => MaybePromise<void>
   },
 ) {
+  // In-memory view of the persisted checkpoint version. `null` means "no
+  // checkpoint has been written yet". It is kept in sync with the store on
+  // every load/upsert so optimistic-concurrency writes can detect when another
+  // instance has advanced the same checkpoint.
+  let version: number | null = null
+
   const api = {
     relatedStreamEvents: params.relatedStreamEvents,
     async clear() {
       await params.delete(params.type, params.name)
+      version = null
     },
-    async upsert(event: BaseOutputEvent, metadata: Record<string, any> = {}) {
-      await params.upsert({
-        lastEventPosition: event.position,
-        type: params.type,
-        name: params.name,
-        metadata,
-      })
+    /**
+     * Load the persisted checkpoint and sync the local version. Returns the
+     * raw checkpoint (or `null`), so callers can rehydrate their own state
+     * (e.g. a process manager reloading its folded state) from it.
+     */
+    async load() {
+      const checkpoint = await params.get(params.type, params.name)
+      version = checkpoint?.version ?? null
+      return checkpoint ?? null
+    },
+    /**
+     * Persist the checkpoint position (and optional metadata) for the given
+     * event.
+     *
+     * - `'cas'` (compare-and-swap): the write must land on top of the exact
+     *   version we last observed. If another writer advanced the checkpoint,
+     *   the local version is refreshed and a {@link CheckpointConcurrencyError}
+     *   is thrown so the caller can re-fold its state and retry. Used for
+     *   process managers that fold state into the checkpoint.
+     * - `'monotonic'` (default): retries on conflict, skipping the write once
+     *   the stored position already covers this event. Safe for cursors with
+     *   no derived state (projections, stateless/after-effect writes).
+     */
+    async upsert(
+      event: BaseOutputEvent,
+      metadata: Record<string, any> = {},
+      mode: 'cas' | 'monotonic' = 'monotonic',
+    ) {
+      while (true) {
+        const expectedVersion = version
+        const nextVersion = (expectedVersion ?? -1) + 1
+        const committed = await params.upsert(
+          {
+            lastEventPosition: event.position,
+            type: params.type,
+            name: params.name,
+            metadata,
+            version: nextVersion,
+          },
+          expectedVersion,
+        )
+
+        if (committed) {
+          version = nextVersion
+          return
+        }
+
+        // Another writer advanced this checkpoint. Refresh our view of it.
+        const current = await api.load()
+
+        if (mode === 'cas') {
+          throw new CheckpointConcurrencyError(
+            params.type,
+            params.name,
+            expectedVersion,
+          )
+        }
+
+        // monotonic: the stored cursor already covers this event, nothing to do.
+        if (current && current.lastEventPosition >= event.position) {
+          return
+        }
+      }
     },
     async rehydrated(
       options: {
@@ -59,7 +135,7 @@ export function createCheckpointApi(
         onProgress?: (index: number, event: BaseOutputEvent) => void
       } = {},
     ) {
-      const checkpoint = await params.get(params.type, params.name)
+      const checkpoint = await api.load()
       let startPosition = 0
       if (checkpoint) {
         const result = checkpointSchema.safeParse(checkpoint)

package/src/createEventStore.ts

@@ -172,7 +172,7 @@ export function createEventStore<const Root extends AnyAggregateRoot>(
 
   let exclusiveEmitEventsChain: Promise<any> = Promise.resolve()
   const emitEvents: EmitEvents = async (events) => {
-    exclusiveEmitEventsChain = exclusiveEmitEventsChain.then(async () => {
+    const result = exclusiveEmitEventsChain.then(async () => {
       await Promise.all(processManagers.values().map((pm) => pm.beginSession()))
 
       try {
@@ -200,7 +200,16 @@ export function createEventStore<const Root extends AnyAggregateRoot>(
       }
     })
 
-    return exclusiveEmitEventsChain
+    // Advance the serialization chain but swallow this operation's outcome so a
+    // rejection is delivered only to its own caller. Chaining the next op onto a
+    // rejected promise would skip its callback and re-propagate the stale error,
+    // permanently poisoning every subsequent emit for the life of the process.
+    exclusiveEmitEventsChain = result.then(
+      () => undefined,
+      () => undefined,
+    )
+
+    return result
   }
 
   const loadEvents: LoadEvents = (select, range) => {
@@ -215,7 +224,7 @@ export function createEventStore<const Root extends AnyAggregateRoot>(
     expectedVersion,
   ) => {
     assertInitializing()
-    exclusiveAppendEventsChain = exclusiveAppendEventsChain.then(async () => {
+    const result = exclusiveAppendEventsChain.then(async () => {
       if (events.length === 0) {
         return []
       }
@@ -241,7 +250,17 @@ export function createEventStore<const Root extends AnyAggregateRoot>(
       return params.appendEvents(streamId, processedEvents, expectedVersion)
     })
 
-    return exclusiveAppendEventsChain
+    // Advance the serialization chain but swallow this operation's outcome so a
+    // rejection is delivered only to its own caller. Chaining the next append
+    // onto a rejected promise would skip its callback and re-propagate the stale
+    // error, permanently poisoning every subsequent append for the life of the
+    // process (a single ConcurrencyError would take down all writes).
+    exclusiveAppendEventsChain = result.then(
+      () => undefined,
+      () => undefined,
+    )
+
+    return result
   }
 
   for (const aggregateRoot of params.aggregateRoots as unknown as InternalAggregateRootApi[]) {