actor-ts 0.9.1 → 0.11.0

package/dist/persistence/replicated/VectorClock.js

@@ -20,10 +20,10 @@ export class VectorClock {
     /** Component-wise max — used after observing a remote event. */
     merge(other) {
         const next = new Map(this.entries);
-        for (const [r, v] of other.entries) {
-            const ours = next.get(r) ?? 0;
-            if (v > ours)
-                next.set(r, v);
+        for (const [replicaId, version] of other.entries) {
+            const ours = next.get(replicaId) ?? 0;
+            if (version > ours)
+                next.set(replicaId, version);
         }
         return new VectorClock(next);
     }
@@ -42,12 +42,12 @@ export class VectorClock {
         const keys = new Set([...this.entries.keys(), ...other.entries.keys()]);
         let lt = false;
         let gt = false;
-        for (const k of keys) {
-            const a = this.get(k);
-            const b = other.get(k);
-            if (a < b)
+        for (const replicaId of keys) {
+            const ours = this.get(replicaId);
+            const theirs = other.get(replicaId);
+            if (ours < theirs)
                 lt = true;
-            else if (a > b)
+            else if (ours > theirs)
                 gt = true;
             if (lt && gt)
                 return 'concurrent';
@@ -64,15 +64,15 @@ export class VectorClock {
     isConcurrentWith(other) { return this.compareTo(other) === 'concurrent'; }
     toJSON() {
         const out = {};
-        for (const [k, v] of this.entries)
-            out[k] = v;
+        for (const [replicaId, version] of this.entries)
+            out[replicaId] = version;
         return out;
     }
     toString() {
         const pairs = [];
         const sorted = Array.from(this.entries.keys()).sort();
-        for (const k of sorted)
-            pairs.push(`${k}=${this.entries.get(k)}`);
+        for (const replicaId of sorted)
+            pairs.push(`${replicaId}=${this.entries.get(replicaId)}`);
         return `VC{${pairs.join(', ')}}`;
     }
 }

package/dist/persistence/replicated/VectorClock.js.map

@@ -1 +1 @@
-{"version":3,"file":"VectorClock.js","sourceRoot":"","sources":["../../../src/persistence/replicated/VectorClock.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"VectorClock.js","sourceRoot":"","sources":["../../../src/persistence/replicated/VectorClock.ts"],"names":[],"mappings":"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"}

package/dist/persistence/snapshot-stores/CachedSnapshotStore.d.ts

@@ -1,22 +1,14 @@
-import type { Cache } from '../../cache/Cache.js';
 import type { Snapshot } from '../JournalTypes.js';
 import type { PersistenceOptions } from '../PersistenceOptions.js';
 import type { SnapshotStore } from '../SnapshotStore.js';
 import { type Option } from '../../util/Option.js';
-export interface CachedSnapshotStoreOptions {
-    /** Backing cache — typically Redis in production. */
-    readonly cache: Cache;
-    /** Cache TTL in milliseconds.  Default: 5 minutes. */
-    readonly ttlMs?: number;
-    /** Key prefix (default: `'snap:'`) prevents collisions in shared caches. */
-    readonly keyPrefix?: string;
-}
+import type { CachedSnapshotStoreOptions } from './CachedSnapshotStoreOptions.js';
 export declare class CachedSnapshotStore implements SnapshotStore {
     private readonly underlying;
     private readonly cache;
     private readonly ttlMs;
     private readonly keyPrefix;
-    constructor(underlying: SnapshotStore, opts: CachedSnapshotStoreOptions);
+    constructor(underlying: SnapshotStore, options: CachedSnapshotStoreOptions);
     save<S>(pid: string, seq: number, state: S, options?: PersistenceOptions): Promise<Snapshot<S>>;
     loadLatest<S>(pid: string, options?: PersistenceOptions): Promise<Option<Snapshot<S>>>;
     loadBefore<S>(pid: string, seq: number, options?: PersistenceOptions): Promise<Option<Snapshot<S>>>;

package/dist/persistence/snapshot-stores/CachedSnapshotStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CachedSnapshotStore.d.ts","sourceRoot":"","sources":["../../../src/persistence/snapshot-stores/CachedSnapshotStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAc,KAAK,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAoC/D,MAAM,WAAW,0BAA0B;IACzC,qDAAqD;IACrD,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,sDAAsD;IACtD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,4EAA4E;IAC5E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AASD,qBAAa,mBAAoB,YAAW,aAAa;IAMrD,OAAO,CAAC,QAAQ,CAAC,UAAU;IAL7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAGhB,UAAU,EAAE,aAAa,EAC1C,IAAI,EAAE,0BAA0B;IAU5B,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAO/F,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAUtF,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAKnG,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B,OAAO,CAAC,MAAM;CAGf"}
+{"version":3,"file":"CachedSnapshotStore.d.ts","sourceRoot":"","sources":["../../../src/persistence/snapshot-stores/CachedSnapshotStore.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAc,KAAK,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,KAAK,EAAE,0BAA0B,EAAkC,MAAM,iCAAiC,CAAC;AA8ClH,qBAAa,mBAAoB,YAAW,aAAa;IAMrD,OAAO,CAAC,QAAQ,CAAC,UAAU;IAL7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAGhB,UAAU,EAAE,aAAa,EAC1C,OAAO,EAAE,0BAA0B;IAS/B,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAO/F,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAUtF,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAKnG,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B,OAAO,CAAC,MAAM;CAGf"}

package/dist/persistence/snapshot-stores/CachedSnapshotStore.js

@@ -1,4 +1,5 @@
 import { none, some } from '../../util/Option.js';
+import { CachedSnapshotStoreOptionsValidator } from './CachedSnapshotStoreOptions.js';
 /**
  * Read-through cache decorator for any `SnapshotStore`.  Targets the hot
  * `loadLatest` path that fires whenever a sharded entity wakes up — at
@@ -26,8 +27,11 @@ import { none, some } from '../../util/Option.js';
  * min) — short enough that stale reads after a missed invalidation
  * never matter, long enough to absorb cold-start storms.
  *
- *   const cassandra = new CassandraSnapshotStore({...});
- *   const cached    = new CachedSnapshotStore(cassandra, { cache, ttlMs: 5 * 60_000 });
+ *   const cassandra = new CassandraSnapshotStore(...);
+ *   const cached    = new CachedSnapshotStore(
+ *     cassandra,
+ *     CachedSnapshotStoreOptions.create().withCache(cache).withTtlMs(5 * 60_000),
+ *   );
  *   ext.setSnapshotStore(cached);
  */
 const DEFAULT_TTL_MS = 5 * 60_000;
@@ -36,14 +40,13 @@ export class CachedSnapshotStore {
     cache;
     ttlMs;
     keyPrefix;
-    constructor(underlying, opts) {
+    constructor(underlying, options) {
         this.underlying = underlying;
-        this.cache = opts.cache;
-        this.ttlMs = opts.ttlMs ?? DEFAULT_TTL_MS;
-        if (!Number.isFinite(this.ttlMs) || this.ttlMs <= 0) {
-            throw new Error(`CachedSnapshotStore: ttlMs must be a positive finite number, got ${this.ttlMs}`);
-        }
-        this.keyPrefix = opts.keyPrefix ?? 'snap:';
+        const resolvedOptions = options;
+        new CachedSnapshotStoreOptionsValidator().validate(resolvedOptions);
+        this.cache = resolvedOptions.cache;
+        this.ttlMs = resolvedOptions.ttlMs ?? DEFAULT_TTL_MS;
+        this.keyPrefix = resolvedOptions.keyPrefix ?? 'snap:';
     }
     async save(pid, seq, state, options) {
         const written = await this.underlying.save(pid, seq, state, options);

package/dist/persistence/snapshot-stores/CachedSnapshotStore.js.map

@@ -1 +1 @@
-{"version":3,"file":"CachedSnapshotStore.js","sourceRoot":"","sources":["../../../src/persistence/snapshot-stores/CachedSnapshotStore.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAe,MAAM,sBAAsB,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,MAAM,cAAc,GAAG,CAAC,GAAG,MAAM,CAAC;AAkBlC,MAAM,OAAO,mBAAmB;IAMX;IALF,KAAK,CAAQ;IACb,KAAK,CAAS;IACd,SAAS,CAAS;IAEnC,YACmB,UAAyB,EAC1C,IAAgC;QADf,eAAU,GAAV,UAAU,CAAe;QAG1C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,cAAc,CAAC;QAC1C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,oEAAoE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QACpG,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,OAAO,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,IAAI,CAAI,GAAW,EAAE,GAAW,EAAE,KAAQ,EAAE,OAA4B;QAC5E,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAI,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACxE,2EAA2E;QAC3E,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1C,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,UAAU,CAAI,GAAW,EAAE,OAA4B;QAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAoB,GAAG,CAAC,CAAC;QACzD,IAAI,GAAG,CAAC,MAAM,EAAE;YAAE,OAAO,IAAI,CAAC,GAAG,CAAC,KAAoB,CAAC,CAAC;QACxD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,CAAI,GAAG,EAAE,OAAO,CAAC,CAAC;QAClE,IAAI,OAAO,CAAC,MAAM,EAAE;YAAE,OAAO,IAAI,CAAC;QAClC,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAoB,GAAG,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACxE,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,UAAU,CAAI,GAAW,EAAE,GAAW,EAAE,OAA4B;QACxE,8BAA8B;QAC9B,OAAO,IAAI,CAAC,UAAU,CAAC,UAAU,CAAI,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW,EAAE,KAAa;QACrC,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACzC,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC;QAChC,iEAAiE;QACjE,gDAAgD;IAClD,CAAC;IAEO,MAAM,CAAC,GAAW;QACxB,OAAO,GAAG,IAAI,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC;IACnC,CAAC;CACF"}
+{"version":3,"file":"CachedSnapshotStore.js","sourceRoot":"","sources":["../../../src/persistence/snapshot-stores/CachedSnapshotStore.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAe,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,mCAAmC,EAAE,MAAM,iCAAiC,CAAC;AAGtF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,MAAM,cAAc,GAAG,CAAC,GAAG,MAAM,CAAC;AASlC,MAAM,OAAO,mBAAmB;IAMX;IALF,KAAK,CAAQ;IACb,KAAK,CAAS;IACd,SAAS,CAAS;IAEnC,YACmB,UAAyB,EAC1C,OAAmC;QADlB,eAAU,GAAV,UAAU,CAAe;QAG1C,MAAM,eAAe,GAAI,OAA0C,CAAC;QACpE,IAAI,mCAAmC,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;QACpE,IAAI,CAAC,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC;QACnC,IAAI,CAAC,KAAK,GAAG,eAAe,CAAC,KAAK,IAAI,cAAc,CAAC;QACrD,IAAI,CAAC,SAAS,GAAG,eAAe,CAAC,SAAS,IAAI,OAAO,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,IAAI,CAAI,GAAW,EAAE,GAAW,EAAE,KAAQ,EAAE,OAA4B;QAC5E,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAI,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACxE,2EAA2E;QAC3E,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1C,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,UAAU,CAAI,GAAW,EAAE,OAA4B;QAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAoB,GAAG,CAAC,CAAC;QACzD,IAAI,GAAG,CAAC,MAAM,EAAE;YAAE,OAAO,IAAI,CAAC,GAAG,CAAC,KAAoB,CAAC,CAAC;QACxD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,CAAI,GAAG,EAAE,OAAO,CAAC,CAAC;QAClE,IAAI,OAAO,CAAC,MAAM,EAAE;YAAE,OAAO,IAAI,CAAC;QAClC,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAoB,GAAG,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACxE,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,UAAU,CAAI,GAAW,EAAE,GAAW,EAAE,OAA4B;QACxE,8BAA8B;QAC9B,OAAO,IAAI,CAAC,UAAU,CAAC,UAAU,CAAI,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW,EAAE,KAAa;QACrC,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACzC,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC;QAChC,iEAAiE;QACjE,gDAAgD;IAClD,CAAC;IAEO,MAAM,CAAC,GAAW;QACxB,OAAO,GAAG,IAAI,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC;IACnC,CAAC;CACF"}

package/dist/persistence/snapshot-stores/CachedSnapshotStoreOptions.d.ts

@@ -0,0 +1,47 @@
+import type { Cache } from '../../cache/Cache.js';
+import { OptionsBuilder } from '../../util/OptionsBuilder.js';
+import { OptionsValidator } from '../../util/OptionsValidator.js';
+export interface CachedSnapshotStoreOptionsType {
+    /** Backing cache — typically Redis in production. */
+    readonly cache: Cache;
+    /** Cache TTL in milliseconds.  Default: 5 minutes. */
+    readonly ttlMs?: number;
+    /** Key prefix (default: `'snap:'`) prevents collisions in shared caches. */
+    readonly keyPrefix?: string;
+}
+/**
+ * Fluent builder for {@link CachedSnapshotStoreOptionsType}.  The `cache` is
+ * required:
+ *
+ *     new CachedSnapshotStore(
+ *       underlying,
+ *       CachedSnapshotStoreOptions.create().withCache(cache).withTtlMs(5 * 60_000),
+ *     )
+ */
+export declare class CachedSnapshotStoreOptionsBuilder extends OptionsBuilder<CachedSnapshotStoreOptionsType> {
+    /** Start a fresh builder.  Equivalent to `new CachedSnapshotStoreOptionsBuilder()`. */
+    static create(): CachedSnapshotStoreOptionsBuilder;
+    /** Backing cache — typically Redis in production. */
+    withCache(cache: Cache): this;
+    /** Cache TTL in milliseconds.  Default: 5 minutes. */
+    withTtlMs(ttlMs: number): this;
+    /** Key prefix (default: `'snap:'`) — prevents collisions in shared caches. */
+    withKeyPrefix(keyPrefix: string): this;
+}
+/**
+ * Validates resolved {@link CachedSnapshotStoreOptionsType} settings — the
+ * backing `cache` is required and `ttlMs` (when set) must be a positive
+ * duration.
+ */
+export declare class CachedSnapshotStoreOptionsValidator extends OptionsValidator<CachedSnapshotStoreOptionsType> {
+    constructor();
+    protected rules(s: Partial<CachedSnapshotStoreOptionsType>): void;
+}
+/**
+ * Accepted input for the cached snapshot-store constructor: the fluent
+ * {@link CachedSnapshotStoreOptionsBuilder} OR a plain {@link CachedSnapshotStoreOptionsType} object.
+ */
+export type CachedSnapshotStoreOptions = CachedSnapshotStoreOptionsBuilder | Partial<CachedSnapshotStoreOptionsType>;
+/** Value alias so `CachedSnapshotStoreOptions.create()` / `new CachedSnapshotStoreOptions()` resolve to the builder. */
+export declare const CachedSnapshotStoreOptions: typeof CachedSnapshotStoreOptionsBuilder;
+//# sourceMappingURL=CachedSnapshotStoreOptions.d.ts.map

package/dist/persistence/snapshot-stores/CachedSnapshotStoreOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CachedSnapshotStoreOptions.d.ts","sourceRoot":"","sources":["../../../src/persistence/snapshot-stores/CachedSnapshotStoreOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE,MAAM,WAAW,8BAA8B;IAC7C,qDAAqD;IACrD,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,sDAAsD;IACtD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,4EAA4E;IAC5E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,qBAAa,iCAAkC,SAAQ,cAAc,CAAC,8BAA8B,CAAC;IACnG,uFAAuF;IACvF,MAAM,CAAC,MAAM,IAAI,iCAAiC;IAIlD,qDAAqD;IACrD,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAI7B,sDAAsD;IACtD,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI9B,8EAA8E;IAC9E,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAGvC;AAED;;;;GAIG;AACH,qBAAa,mCAAoC,SAAQ,gBAAgB,CAAC,8BAA8B,CAAC;;IAIvG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,8BAA8B,CAAC,GAAG,IAAI;CAIlE;AAED;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAAG,iCAAiC,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAAC;AACrH,wHAAwH;AACxH,eAAO,MAAM,0BAA0B,0CAAoC,CAAC"}

package/dist/persistence/snapshot-stores/CachedSnapshotStoreOptions.js

@@ -0,0 +1,47 @@
+import { OptionsBuilder } from '../../util/OptionsBuilder.js';
+import { OptionsValidator } from '../../util/OptionsValidator.js';
+/**
+ * Fluent builder for {@link CachedSnapshotStoreOptionsType}.  The `cache` is
+ * required:
+ *
+ *     new CachedSnapshotStore(
+ *       underlying,
+ *       CachedSnapshotStoreOptions.create().withCache(cache).withTtlMs(5 * 60_000),
+ *     )
+ */
+export class CachedSnapshotStoreOptionsBuilder extends OptionsBuilder {
+    /** Start a fresh builder.  Equivalent to `new CachedSnapshotStoreOptionsBuilder()`. */
+    static create() {
+        return new CachedSnapshotStoreOptionsBuilder();
+    }
+    /** Backing cache — typically Redis in production. */
+    withCache(cache) {
+        return this.set('cache', cache);
+    }
+    /** Cache TTL in milliseconds.  Default: 5 minutes. */
+    withTtlMs(ttlMs) {
+        return this.set('ttlMs', ttlMs);
+    }
+    /** Key prefix (default: `'snap:'`) — prevents collisions in shared caches. */
+    withKeyPrefix(keyPrefix) {
+        return this.set('keyPrefix', keyPrefix);
+    }
+}
+/**
+ * Validates resolved {@link CachedSnapshotStoreOptionsType} settings — the
+ * backing `cache` is required and `ttlMs` (when set) must be a positive
+ * duration.
+ */
+export class CachedSnapshotStoreOptionsValidator extends OptionsValidator {
+    constructor() {
+        super('CachedSnapshotStoreOptions');
+    }
+    rules(s) {
+        if (s.cache === undefined)
+            this.fail('cache', 'is required (call withCache())');
+        this.positiveNumber('ttlMs');
+    }
+}
+/** Value alias so `CachedSnapshotStoreOptions.create()` / `new CachedSnapshotStoreOptions()` resolve to the builder. */
+export const CachedSnapshotStoreOptions = CachedSnapshotStoreOptionsBuilder;
+//# sourceMappingURL=CachedSnapshotStoreOptions.js.map

package/dist/persistence/snapshot-stores/CachedSnapshotStoreOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CachedSnapshotStoreOptions.js","sourceRoot":"","sources":["../../../src/persistence/snapshot-stores/CachedSnapshotStoreOptions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAWlE;;;;;;;;GAQG;AACH,MAAM,OAAO,iCAAkC,SAAQ,cAA8C;IACnG,uFAAuF;IACvF,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,iCAAiC,EAAE,CAAC;IACjD,CAAC;IAED,qDAAqD;IACrD,SAAS,CAAC,KAAY;QACpB,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,sDAAsD;IACtD,SAAS,CAAC,KAAa;QACrB,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,8EAA8E;IAC9E,aAAa,CAAC,SAAiB;QAC7B,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAC1C,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,mCAAoC,SAAQ,gBAAgD;IACvG;QACE,KAAK,CAAC,4BAA4B,CAAC,CAAC;IACtC,CAAC;IACS,KAAK,CAAC,CAA0C;QACxD,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,gCAAgC,CAAC,CAAC;QAChF,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;CACF;AAOD,wHAAwH;AACxH,MAAM,CAAC,MAAM,0BAA0B,GAAG,iCAAiC,CAAC"}

package/dist/persistence/snapshot-stores/CassandraSnapshotStore.d.ts

@@ -2,17 +2,7 @@ import { type Snapshot } from '../JournalTypes.js';
 import type { PersistenceOptions } from '../PersistenceOptions.js';
 import type { SnapshotStore } from '../SnapshotStore.js';
 import { type Option } from '../../util/Option.js';
-import { type CassandraClientLike, type CassandraConnection } from '../journals/CassandraClient.js';
-export interface CassandraSnapshotStoreOptions extends CassandraConnection {
-    /** Table name; default `snapshots`. */
-    readonly snapshotsTable?: string;
-    /** Maximum number of snapshots kept per pid.  `<= 0` = keep all.  Default: 3. */
-    readonly keepN?: number;
-    /** Auto-create the snapshots table on first connect. */
-    readonly autoCreateTables?: boolean;
-    /** Pre-built client — bypass internal construction (share with journal). */
-    readonly client?: CassandraClientLike;
-}
+import type { CassandraSnapshotStoreOptions } from './CassandraSnapshotStoreOptions.js';
 /**
  * SnapshotStore backed by Cassandra/Scylla.  Schema mirrors the journal:
  * clustered on `sequence_nr DESC` so `loadLatest` is a single-row read.

package/dist/persistence/snapshot-stores/CassandraSnapshotStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CassandraSnapshotStore.d.ts","sourceRoot":"","sources":["../../../src/persistence/snapshot-stores/CassandraSnapshotStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAc,KAAK,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACzB,MAAM,gCAAgC,CAAC;AAExC,MAAM,WAAW,6BAA8B,SAAQ,mBAAmB;IACxE,uCAAuC;IACvC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,iFAAiF;IACjF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC;CACvC;AASD;;;;GAIG;AACH,qBAAa,sBAAuB,YAAW,aAAa;IAC1D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;IACxD,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,OAAO,EAAE,6BAA6B;IAO5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAetB,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAkBhG,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAUvF,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAUpG,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAajD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAU5B,OAAO,KAAK,KAAK,GAAiE;IAClF,OAAO,CAAC,SAAS;IAEjB,OAAO,CAAC,aAAa;YAUP,UAAU;YAkBV,aAAa;YAKb,YAAY;CAW3B"}
+{"version":3,"file":"CassandraSnapshotStore.d.ts","sourceRoot":"","sources":["../../../src/persistence/snapshot-stores/CassandraSnapshotStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAc,KAAK,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAO/D,OAAO,KAAK,EAAE,6BAA6B,EAAqC,MAAM,oCAAoC,CAAC;AAS3H;;;;GAIG;AACH,qBAAa,sBAAuB,YAAW,aAAa;IAC1D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6C;IACrE,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,OAAO,EAAE,6BAA6B;IAO5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAetB,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAkBhG,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAUvF,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAUpG,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAajD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAU5B,OAAO,KAAK,KAAK,GAAiE;IAClF,OAAO,CAAC,SAAS;IAEjB,OAAO,CAAC,aAAa;YAUP,UAAU;YAkBV,aAAa;YAKb,YAAY;CAW3B"}

package/dist/persistence/snapshot-stores/CassandraSnapshotStore.js

@@ -15,9 +15,9 @@ export class CassandraSnapshotStore {
     keepN;
     constructor(options) {
         this.options = options;
-        this.client = options.client ?? undefined;
-        this.ownsClient = !options.client;
-        this.keepN = options.keepN ?? 3;
+        this.client = this.options.client ?? undefined;
+        this.ownsClient = !this.options.client;
+        this.keepN = this.options.keepN ?? 3;
     }
     async start() {
         if (this.started)

package/dist/persistence/snapshot-stores/CassandraSnapshotStore.js.map

@@ -1 +1 @@
-{"version":3,"file":"CassandraSnapshotStore.js","sourceRoot":"","sources":["../../../src/persistence/snapshot-stores/CassandraSnapshotStore.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"CassandraSnapshotStore.js","sourceRoot":"","sources":["../../../src/persistence/snapshot-stores/CassandraSnapshotStore.ts"],"names":[],"mappings":"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"}

package/dist/persistence/snapshot-stores/CassandraSnapshotStoreOptions.d.ts

@@ -0,0 +1,61 @@
+import { OptionsBuilder } from '../../util/OptionsBuilder.js';
+import type { CassandraClientLike, CassandraConnection } from '../journals/CassandraClient.js';
+export interface CassandraSnapshotStoreOptionsType extends CassandraConnection {
+    /** Table name; default `snapshots`. */
+    readonly snapshotsTable?: string;
+    /** Maximum number of snapshots kept per pid.  `<= 0` = keep all.  Default: 3. */
+    readonly keepN?: number;
+    /** Auto-create the snapshots table on first connect. */
+    readonly autoCreateTables?: boolean;
+    /** Pre-built client — bypass internal construction (share with journal). */
+    readonly client?: CassandraClientLike;
+}
+/**
+ * Fluent builder for {@link CassandraSnapshotStoreOptionsType}:
+ *
+ *     new CassandraSnapshotStore(
+ *       CassandraSnapshotStoreOptions.create()
+ *         .withContactPoints(['10.0.0.1'])
+ *         .withKeyspace('app')
+ *         .withKeepN(5),
+ *     )
+ *
+ * Carries `withX` methods for the shared {@link CassandraConnection}
+ * fields too — the connection mixin is not built on its own.
+ */
+export declare class CassandraSnapshotStoreOptionsBuilder extends OptionsBuilder<CassandraSnapshotStoreOptionsType> {
+    /** Start a fresh builder.  Equivalent to `new CassandraSnapshotStoreOptionsBuilder()`. */
+    static create(): CassandraSnapshotStoreOptionsBuilder;
+    /** Node(s) to seed the cluster topology from. */
+    withContactPoints(contactPoints: ReadonlyArray<string>): this;
+    /** Local DC — required for DCAwareRoundRobinPolicy.  Defaults to `datacenter1`. */
+    withLocalDataCenter(localDataCenter: string): this;
+    /** Keyspace to `USE` after connect.  Must already exist, or pass `withAutoCreateKeyspace(true)`. */
+    withKeyspace(keyspace: string): this;
+    /** Username/password for PLAIN auth. */
+    withCredentials(username: string, password: string): this;
+    /** Port — defaults to 9042. */
+    withPort(port: number): this;
+    /** If true, create the keyspace on startup (simple strategy, rf=1). */
+    withAutoCreateKeyspace(autoCreateKeyspace?: boolean): this;
+    /** Replication options used by autoCreateKeyspace.  Ignored otherwise. */
+    withReplication(replication: NonNullable<CassandraSnapshotStoreOptionsType['replication']>): this;
+    /** CQL consistency level for all reads and writes.  Default `LOCAL_QUORUM` (6). */
+    withConsistency(consistency: number): this;
+    /** Table name; default `snapshots`. */
+    withSnapshotsTable(snapshotsTable: string): this;
+    /** Maximum number of snapshots kept per pid.  `<= 0` = keep all.  Default: 3. */
+    withKeepN(keepN: number): this;
+    /** Auto-create the snapshots table on first connect. */
+    withAutoCreateTables(autoCreateTables?: boolean): this;
+    /** Pre-built client — bypass internal construction (share with journal). */
+    withClient(client: CassandraClientLike): this;
+}
+/**
+ * Accepted input for the Cassandra snapshot-store constructor: the fluent
+ * {@link CassandraSnapshotStoreOptionsBuilder} OR a plain {@link CassandraSnapshotStoreOptionsType} object.
+ */
+export type CassandraSnapshotStoreOptions = CassandraSnapshotStoreOptionsBuilder | Partial<CassandraSnapshotStoreOptionsType>;
+/** Value alias so `CassandraSnapshotStoreOptions.create()` / `new CassandraSnapshotStoreOptions()` resolve to the builder. */
+export declare const CassandraSnapshotStoreOptions: typeof CassandraSnapshotStoreOptionsBuilder;
+//# sourceMappingURL=CassandraSnapshotStoreOptions.d.ts.map

package/dist/persistence/snapshot-stores/CassandraSnapshotStoreOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CassandraSnapshotStoreOptions.d.ts","sourceRoot":"","sources":["../../../src/persistence/snapshot-stores/CassandraSnapshotStoreOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAE/F,MAAM,WAAW,iCAAkC,SAAQ,mBAAmB;IAC5E,uCAAuC;IACvC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,iFAAiF;IACjF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC;CACvC;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,oCAAqC,SAAQ,cAAc,CAAC,iCAAiC,CAAC;IACzG,0FAA0F;IAC1F,MAAM,CAAC,MAAM,IAAI,oCAAoC;IAMrD,iDAAiD;IACjD,iBAAiB,CAAC,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI;IAI7D,mFAAmF;IACnF,mBAAmB,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI;IAIlD,oGAAoG;IACpG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIpC,wCAAwC;IACxC,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIzD,+BAA+B;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI5B,uEAAuE;IACvE,sBAAsB,CAAC,kBAAkB,UAAO,GAAG,IAAI;IAIvD,0EAA0E;IAC1E,eAAe,CAAC,WAAW,EAAE,WAAW,CAAC,iCAAiC,CAAC,aAAa,CAAC,CAAC,GAAG,IAAI;IAIjG,mFAAmF;IACnF,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAM1C,uCAAuC;IACvC,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;IAIhD,iFAAiF;IACjF,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI9B,wDAAwD;IACxD,oBAAoB,CAAC,gBAAgB,UAAO,GAAG,IAAI;IAInD,4EAA4E;IAC5E,UAAU,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;CAG9C;AAED;;;GAGG;AACH,MAAM,MAAM,6BAA6B,GAAG,oCAAoC,GAAG,OAAO,CAAC,iCAAiC,CAAC,CAAC;AAC9H,8HAA8H;AAC9H,eAAO,MAAM,6BAA6B,6CAAuC,CAAC"}

package/dist/persistence/snapshot-stores/CassandraSnapshotStoreOptions.js

@@ -0,0 +1,73 @@
+import { OptionsBuilder } from '../../util/OptionsBuilder.js';
+/**
+ * Fluent builder for {@link CassandraSnapshotStoreOptionsType}:
+ *
+ *     new CassandraSnapshotStore(
+ *       CassandraSnapshotStoreOptions.create()
+ *         .withContactPoints(['10.0.0.1'])
+ *         .withKeyspace('app')
+ *         .withKeepN(5),
+ *     )
+ *
+ * Carries `withX` methods for the shared {@link CassandraConnection}
+ * fields too — the connection mixin is not built on its own.
+ */
+export class CassandraSnapshotStoreOptionsBuilder extends OptionsBuilder {
+    /** Start a fresh builder.  Equivalent to `new CassandraSnapshotStoreOptionsBuilder()`. */
+    static create() {
+        return new CassandraSnapshotStoreOptionsBuilder();
+    }
+    /* --- shared CassandraConnection fields --- */
+    /** Node(s) to seed the cluster topology from. */
+    withContactPoints(contactPoints) {
+        return this.set('contactPoints', contactPoints);
+    }
+    /** Local DC — required for DCAwareRoundRobinPolicy.  Defaults to `datacenter1`. */
+    withLocalDataCenter(localDataCenter) {
+        return this.set('localDataCenter', localDataCenter);
+    }
+    /** Keyspace to `USE` after connect.  Must already exist, or pass `withAutoCreateKeyspace(true)`. */
+    withKeyspace(keyspace) {
+        return this.set('keyspace', keyspace);
+    }
+    /** Username/password for PLAIN auth. */
+    withCredentials(username, password) {
+        return this.set('credentials', { username, password });
+    }
+    /** Port — defaults to 9042. */
+    withPort(port) {
+        return this.set('port', port);
+    }
+    /** If true, create the keyspace on startup (simple strategy, rf=1). */
+    withAutoCreateKeyspace(autoCreateKeyspace = true) {
+        return this.set('autoCreateKeyspace', autoCreateKeyspace);
+    }
+    /** Replication options used by autoCreateKeyspace.  Ignored otherwise. */
+    withReplication(replication) {
+        return this.set('replication', replication);
+    }
+    /** CQL consistency level for all reads and writes.  Default `LOCAL_QUORUM` (6). */
+    withConsistency(consistency) {
+        return this.set('consistency', consistency);
+    }
+    /* --- snapshot-store-specific fields --- */
+    /** Table name; default `snapshots`. */
+    withSnapshotsTable(snapshotsTable) {
+        return this.set('snapshotsTable', snapshotsTable);
+    }
+    /** Maximum number of snapshots kept per pid.  `<= 0` = keep all.  Default: 3. */
+    withKeepN(keepN) {
+        return this.set('keepN', keepN);
+    }
+    /** Auto-create the snapshots table on first connect. */
+    withAutoCreateTables(autoCreateTables = true) {
+        return this.set('autoCreateTables', autoCreateTables);
+    }
+    /** Pre-built client — bypass internal construction (share with journal). */
+    withClient(client) {
+        return this.set('client', client);
+    }
+}
+/** Value alias so `CassandraSnapshotStoreOptions.create()` / `new CassandraSnapshotStoreOptions()` resolve to the builder. */
+export const CassandraSnapshotStoreOptions = CassandraSnapshotStoreOptionsBuilder;
+//# sourceMappingURL=CassandraSnapshotStoreOptions.js.map

package/dist/persistence/snapshot-stores/CassandraSnapshotStoreOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CassandraSnapshotStoreOptions.js","sourceRoot":"","sources":["../../../src/persistence/snapshot-stores/CassandraSnapshotStoreOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAc9D;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,oCAAqC,SAAQ,cAAiD;IACzG,0FAA0F;IAC1F,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,oCAAoC,EAAE,CAAC;IACpD,CAAC;IAED,+CAA+C;IAE/C,iDAAiD;IACjD,iBAAiB,CAAC,aAAoC;QACpD,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;IAClD,CAAC;IAED,mFAAmF;IACnF,mBAAmB,CAAC,eAAuB;QACzC,OAAO,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,eAAe,CAAC,CAAC;IACtD,CAAC;IAED,oGAAoG;IACpG,YAAY,CAAC,QAAgB;QAC3B,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,wCAAwC;IACxC,eAAe,CAAC,QAAgB,EAAE,QAAgB;QAChD,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,+BAA+B;IAC/B,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,uEAAuE;IACvE,sBAAsB,CAAC,kBAAkB,GAAG,IAAI;QAC9C,OAAO,IAAI,CAAC,GAAG,CAAC,oBAAoB,EAAE,kBAAkB,CAAC,CAAC;IAC5D,CAAC;IAED,0EAA0E;IAC1E,eAAe,CAAC,WAA0E;QACxF,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IAC9C,CAAC;IAED,mFAAmF;IACnF,eAAe,CAAC,WAAmB;QACjC,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IAC9C,CAAC;IAED,4CAA4C;IAE5C,uCAAuC;IACvC,kBAAkB,CAAC,cAAsB;QACvC,OAAO,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;IACpD,CAAC;IAED,iFAAiF;IACjF,SAAS,CAAC,KAAa;QACrB,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,wDAAwD;IACxD,oBAAoB,CAAC,gBAAgB,GAAG,IAAI;QAC1C,OAAO,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,CAAC;IACxD,CAAC;IAED,4EAA4E;IAC5E,UAAU,CAAC,MAA2B;QACpC,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;CACF;AAOD,8HAA8H;AAC9H,MAAM,CAAC,MAAM,6BAA6B,GAAG,oCAAoC,CAAC"}

package/dist/persistence/snapshot-stores/MariaDbSnapshotStore.d.ts

@@ -0,0 +1,30 @@
+import { type Snapshot } from '../JournalTypes.js';
+import type { PersistenceOptions } from '../PersistenceOptions.js';
+import type { SnapshotStore } from '../SnapshotStore.js';
+import { type Option } from '../../util/Option.js';
+import type { MariaDbSnapshotStoreOptions } from './MariaDbSnapshotStoreOptions.js';
+/**
+ * SnapshotStore backed by MariaDB / MySQL (`mariadb`).  Sibling of
+ * `PostgresSnapshotStore` with the MariaDB dialect: `ON DUPLICATE KEY
+ * UPDATE` upsert and a derived-table-wrapped `keepN` prune (MySQL/MariaDB
+ * reject `LIMIT` inside a bare `IN (SELECT …)` against the same table).
+ */
+export declare class MariaDbSnapshotStore implements SnapshotStore {
+    private readonly options;
+    private readonly table;
+    private readonly keepN;
+    private readonly autoCreate;
+    private pool;
+    private initPromise;
+    private closed;
+    constructor(options?: MariaDbSnapshotStoreOptions);
+    save<S>(pid: string, seq: number, state: S, _options?: PersistenceOptions): Promise<Snapshot<S>>;
+    loadLatest<S>(pid: string, _options?: PersistenceOptions): Promise<Option<Snapshot<S>>>;
+    loadBefore<S>(pid: string, seq: number, _options?: PersistenceOptions): Promise<Option<Snapshot<S>>>;
+    delete(pid: string, toSeq: number): Promise<void>;
+    close(): Promise<void>;
+    private toSnapshot;
+    private ensureOpen;
+    private init;
+}
+//# sourceMappingURL=MariaDbSnapshotStore.d.ts.map

package/dist/persistence/snapshot-stores/MariaDbSnapshotStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MariaDbSnapshotStore.d.ts","sourceRoot":"","sources":["../../../src/persistence/snapshot-stores/MariaDbSnapshotStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAc,KAAK,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAO/D,OAAO,KAAK,EAAE,2BAA2B,EAAmC,MAAM,kCAAkC,CAAC;AASrH;;;;;GAKG;AACH,qBAAa,oBAAqB,YAAW,aAAa;IACxD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAC1D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IAErC,OAAO,CAAC,IAAI,CAAgC;IAC5C,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,GAAE,2BAAgC;IAQ/C,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAwBhG,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAUvF,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAUpG,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B,OAAO,CAAC,UAAU;YASJ,UAAU;YAQV,IAAI;CAenB"}

package/dist/persistence/snapshot-stores/MariaDbSnapshotStore.js

@@ -0,0 +1,102 @@
+import { JournalError } from '../JournalTypes.js';
+import { none, some } from '../../util/Option.js';
+import { assertSafeIdentifier, buildMariaDbPool, rowsOf, } from '../journals/MariaDbClient.js';
+/**
+ * SnapshotStore backed by MariaDB / MySQL (`mariadb`).  Sibling of
+ * `PostgresSnapshotStore` with the MariaDB dialect: `ON DUPLICATE KEY
+ * UPDATE` upsert and a derived-table-wrapped `keepN` prune (MySQL/MariaDB
+ * reject `LIMIT` inside a bare `IN (SELECT …)` against the same table).
+ */
+export class MariaDbSnapshotStore {
+    options;
+    table;
+    keepN;
+    autoCreate;
+    pool = null;
+    initPromise = null;
+    closed = false;
+    constructor(options = {}) {
+        const resolvedOptions = options;
+        this.options = resolvedOptions;
+        this.table = assertSafeIdentifier(resolvedOptions.snapshotsTable ?? 'snapshots', 'snapshots table');
+        this.keepN = resolvedOptions.keepN ?? 3;
+        this.autoCreate = resolvedOptions.autoCreateTables ?? true;
+    }
+    async save(pid, seq, state, _options) {
+        const pool = await this.ensureOpen();
+        const now = Date.now();
+        try {
+            await pool.query(`INSERT INTO ${this.table}(persistence_id, sequence_nr, payload, timestamp) VALUES (?, ?, ?, ?)
+         ON DUPLICATE KEY UPDATE payload = VALUES(payload), timestamp = VALUES(timestamp)`, [pid, seq, JSON.stringify(state), now]);
+            if (this.keepN > 0) {
+                await pool.query(`DELETE FROM ${this.table} WHERE persistence_id = ? AND sequence_nr NOT IN (
+             SELECT resolvedOptions FROM (
+               SELECT sequence_nr AS resolvedOptions FROM ${this.table} WHERE persistence_id = ? ORDER BY sequence_nr DESC LIMIT ?
+             ) AS keep)`, [pid, pid, this.keepN]);
+            }
+            return { persistenceId: pid, sequenceNr: seq, state, timestamp: now };
+        }
+        catch (e) {
+            throw new JournalError(`MariaDbSnapshotStore.save failed: ${e.message}`, e);
+        }
+    }
+    async loadLatest(pid, _options) {
+        const pool = await this.ensureOpen();
+        const rows = rowsOf(await pool.query(`SELECT persistence_id, sequence_nr, payload, timestamp FROM ${this.table} WHERE persistence_id = ? ORDER BY sequence_nr DESC LIMIT 1`, [pid]));
+        const row = rows[0];
+        return row ? some(this.toSnapshot(row)) : none;
+    }
+    async loadBefore(pid, seq, _options) {
+        const pool = await this.ensureOpen();
+        const rows = rowsOf(await pool.query(`SELECT persistence_id, sequence_nr, payload, timestamp FROM ${this.table} WHERE persistence_id = ? AND sequence_nr < ? ORDER BY sequence_nr DESC LIMIT 1`, [pid, seq]));
+        const row = rows[0];
+        return row ? some(this.toSnapshot(row)) : none;
+    }
+    async delete(pid, toSeq) {
+        const pool = await this.ensureOpen();
+        await pool.query(`DELETE FROM ${this.table} WHERE persistence_id = ? AND sequence_nr <= ?`, [pid, toSeq]);
+    }
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        try {
+            await this.pool?.end();
+        }
+        catch { /* ignore */ }
+        this.pool = null;
+    }
+    /* --------------------------- internals -------------------------------- */
+    toSnapshot(row) {
+        return {
+            persistenceId: row.persistence_id,
+            sequenceNr: Number(row.sequence_nr),
+            state: JSON.parse(row.payload),
+            timestamp: Number(row.timestamp),
+        };
+    }
+    async ensureOpen() {
+        if (this.closed)
+            throw new JournalError('MariaDbSnapshotStore is closed');
+        if (this.pool)
+            return this.pool;
+        if (!this.initPromise)
+            this.initPromise = this.init();
+        await this.initPromise;
+        return this.pool;
+    }
+    async init() {
+        const pool = await buildMariaDbPool(this.options);
+        if (this.autoCreate) {
+            await pool.query(`CREATE TABLE IF NOT EXISTS ${this.table} (
+           persistence_id VARCHAR(255) NOT NULL,
+           sequence_nr    BIGINT NOT NULL,
+           payload        LONGTEXT NOT NULL,
+           timestamp      BIGINT NOT NULL,
+           PRIMARY KEY (persistence_id, sequence_nr)
+         )`);
+        }
+        this.pool = pool;
+    }
+}
+//# sourceMappingURL=MariaDbSnapshotStore.js.map