actor-ts 0.9.0

package/dist/persistence/ReplicatedEventSourcedActor.js

@@ -0,0 +1,430 @@
+import { Actor } from '../Actor.js';
+import { DistributedPubSubId } from '../cluster/pubsub/index.js';
+import { Publish, Subscribe, } from '../cluster/pubsub/Messages.js';
+import { PersistenceExtensionId } from './PersistenceExtension.js';
+import { LastWriterWinsResolver, } from './replicated/ConflictResolver.js';
+import { VectorClock } from './replicated/VectorClock.js';
+const REPLICATED_TAG = 'replicated-es';
+function topicFor(persistenceId) {
+    return `replicated-es:${persistenceId}`;
+}
+/**
+ * Per-system live-pid registry (#58).  `ReplicatedEventSourcedActor`
+ * relies on being the **single writer** for its `persistenceId` on
+ * the local node — `_appendOne` reads `highestSeq` and `append` in
+ * one mailbox tick under that assumption.  Two actors with the same
+ * pid on the same node violate it: their journal appends race, the
+ * second silently drops with `JournalConcurrencyError`, in-memory
+ * state diverges between the two instances.
+ *
+ * The registry catches this at preStart: the second actor sees the
+ * pid already taken and throws.  `WeakMap`-keyed by `ActorSystem`
+ * so tests with disposable systems don't leak registrations.  The
+ * inner `Set` is mutated as actors register / unregister.
+ */
+const livePidsBySystem = new WeakMap();
+function getLivePidsForSystem(system) {
+    let set = livePidsBySystem.get(system);
+    if (!set) {
+        set = new Set();
+        livePidsBySystem.set(system, set);
+    }
+    return set;
+}
+export class ReplicatedEventSourcedActor extends Actor {
+    cluster;
+    /** Resolver consulted only as the deterministic order comparator. */
+    resolver() { return new LastWriterWinsResolver(); }
+    /**
+     * How often the underlying DistributedPubSub mediator gossips its
+     * subscription set.  Default 250 ms — tight enough that fresh
+     * actors reach a steady-state cross-replica delivery within a
+     * second, slow enough not to flood small clusters.  Override in
+     * tests for snappier convergence.
+     */
+    pubsubGossipIntervalMs() { return 250; }
+    /**
+     * Snapshot policy — return true after applying an event to take a
+     * snapshot of current state.  Default: never snapshot, full journal
+     * is replayed on every restart.
+     *
+     * The `seqNr` argument is the running TOTAL count of events the
+     * actor has observed (own + remote), not just locally-issued ones —
+     * "snapshot every 100 events from any source" is the natural unit.
+     * Re-uses the shared `SnapshotPolicy` helper from `PersistentActor`,
+     * so `everyNEvents(N)` works the same way it does for classic
+     * event-sourced actors.
+     */
+    snapshotPolicy() { return () => false; }
+    /** Recovery hook — called after the local journal has been replayed. */
+    onRecoveryComplete(_state) { }
+    /**
+     * Optional lease (#89) — when this returns a non-null `Lease`, the
+     * actor goes into single-writer mode: only the lease holder may
+     * `persist`, observers passively apply replicated events from
+     * peers.  Default `null` = multi-master semantics (every replica
+     * can persist; vector clocks reconcile concurrent writes).
+     *
+     * Use cases the multi-master default doesn't fit:
+     *
+     *   - **Non-replayable side effects** — charging a credit card,
+     *     emitting an external webhook, sending an email.  The
+     *     framework can't dedupe these for you; restricting writes to
+     *     a single replica ensures the side effect fires once.
+     *   - **Heartbeat / external-rate actors** — N replicas pushing
+     *     beats to a downstream multiplies the rate; the lease binds
+     *     the active emitter to one replica at a time.
+     *
+     * Mechanics: `preStart` calls `lease.acquire()`.  On success the
+     * actor is a holder and persist works normally; on failure it's an
+     * observer (every `persist` call throws).  Lease loss flips the
+     * actor to observer mode and invokes {@link onLeaseLost}; recovery
+     * is restart-driven for this v1.
+     */
+    lease() { return null; }
+    /**
+     * Hook invoked when this replica unexpectedly loses its lease
+     * (TTL expired, another holder took over, backend failure).  The
+     * actor is already in observer mode by the time this fires — use
+     * the hook to stop downstream side-effect processing, page an
+     * operator, etc.  Default is a no-op.
+     */
+    onLeaseLost(_reason) { }
+    /* ------------------------------ internals ----------------------------- */
+    _state;
+    _vc = VectorClock.empty();
+    /** Strict order: every observed event, deduped, sorted via resolver. */
+    _events = [];
+    _seenIds = new Set();
+    _journal;
+    _snapshotStore;
+    _mediator = null;
+    _localSeq = 0;
+    /** Journal seq up to which we've absorbed events.  Updated on each
+     *  successful `_appendOne`; persisted as part of the snapshot so
+     *  recovery only re-reads the post-snapshot delta. */
+    _journalSeq = 0;
+    /** Total observed events count — snapshot policy operates on this. */
+    _observedCount = 0;
+    /** Guard so concurrent absorbs don't issue overlapping snapshot saves. */
+    _snapshotInFlight = false;
+    /** Optional lease this actor holds (or attempted to hold).  See `lease()`. */
+    _lease = null;
+    /**
+     * `true` when this replica may issue new `persist` calls.  Without a
+     * lease configured the default is `true` (multi-master); with a
+     * lease, this flips based on `acquire` outcome and `onLost` events.
+     */
+    _isLeaseHolder = true;
+    _leaseUnsubLost = null;
+    constructor(cluster) {
+        super();
+        this.cluster = cluster;
+    }
+    /** Current state — updated after every event apply. */
+    get state() { return this._state; }
+    /**
+     * Whether this replica currently holds the configured lease (#89).
+     * Always `true` when no lease is configured (multi-master mode);
+     * dynamic when a lease IS configured — flips to `false` on
+     * `acquire` failure or `onLost` notification.  Use to gate
+     * side-effect logic in `onCommand`.
+     */
+    get isLeaseHolder() { return this._isLeaseHolder; }
+    async preStart() {
+        // Single-writer-per-pid invariant (#58).  Two ReplicatedEventSourcedActors
+        // with the same persistenceId on the same node race their
+        // `_appendOne` calls; the second silently drops via
+        // JournalConcurrencyError and in-memory state diverges.  Catch
+        // it loudly at preStart.
+        const livePids = getLivePidsForSystem(this.system);
+        if (livePids.has(this.persistenceId)) {
+            throw new Error(`ReplicatedEventSourcedActor: another live actor on this node already holds persistenceId '${this.persistenceId}'. ` +
+                `Each replicated actor must own a unique persistenceId per node — cross-replica multi-writer is the entire ` +
+                `point of replication, but on a single node the journal append path assumes single-writer.`);
+        }
+        livePids.add(this.persistenceId);
+        // Optional lease acquisition (#89).  We try once at preStart; on
+        // success we register an `onLost` handler so a TTL expiry / fence
+        // flips us to observer mode.  On failure we silently enter
+        // observer mode — the user's `onCommand` either skips side-
+        // effecting work via `isLeaseHolder` or hits the explicit throw
+        // inside `persist`.
+        this._lease = this.lease();
+        if (this._lease) {
+            const acquired = await this._lease.acquire();
+            this._isLeaseHolder = acquired;
+            if (acquired) {
+                this._leaseUnsubLost = this._lease.onLost((reason) => {
+                    this._isLeaseHolder = false;
+                    this.log.warn(`ReplicatedEventSourcedActor '${this.persistenceId}': lease lost — entering observer mode`, { reason });
+                    try {
+                        const result = this.onLeaseLost(reason);
+                        if (result instanceof Promise) {
+                            result.catch((e) => this.log.warn('onLeaseLost threw', e));
+                        }
+                    }
+                    catch (e) {
+                        this.log.warn('onLeaseLost threw', e);
+                    }
+                });
+            }
+            else {
+                this.log.info(`ReplicatedEventSourcedActor '${this.persistenceId}': could not acquire lease — entering observer mode`);
+            }
+        }
+        this._state = this.initialState();
+        const ext = this.system.extension(PersistenceExtensionId);
+        this._journal = ext.journal;
+        this._snapshotStore = ext.snapshotStore;
+        // 1. Try to load a snapshot.  If present, seed every in-memory
+        //    field from it so we don't have to re-fold the journal
+        //    history that produced it.
+        let journalReplayFrom = 1;
+        const snapshotOpt = await this._snapshotStore
+            .loadLatest(this.persistenceId);
+        if (snapshotOpt.isSome()) {
+            const snap = snapshotOpt.value.state;
+            this._state = snap.state;
+            this._vc = VectorClock.fromData(snap.vc);
+            this._seenIds = new Set(snap.seenIds);
+            this._events = [...snap.events];
+            this._localSeq = snap.localSeq;
+            this._journalSeq = snap.journalSeqAtSnapshot;
+            this._observedCount = snap.events.length;
+            journalReplayFrom = snap.journalSeqAtSnapshot + 1;
+        }
+        // 2. Read post-snapshot journal delta and absorb anything not
+        //    already accounted for by `_seenIds`.  Without a snapshot
+        //    `journalReplayFrom = 1` and this is the same full-replay
+        //    path as before.
+        const delta = await this._journal.read(this.persistenceId, journalReplayFrom);
+        for (const pe of delta) {
+            // Track the journal seq cursor so a snapshot taken later
+            // records the right `journalSeqAtSnapshot`.
+            if (pe.sequenceNr > this._journalSeq)
+                this._journalSeq = pe.sequenceNr;
+            this._absorb(pe.event, /* persistLocally= */ false, /* broadcast= */ false);
+        }
+        // 3. Subscribe to the cross-replica topic.  The Subscribe message
+        //    is delivered to the mediator via tell(); the actor mailbox is
+        //    ours, so when remote events arrive they land in onReceive.
+        //
+        //    We pass `gossipIntervalMs: this.pubsubGossipIntervalMs()` —
+        //    default 250 ms — so subscription state propagates fast enough
+        //    that the first user-issued persist a few hundred ms after
+        //    construction reaches peer replicas.  Tests can dial this
+        //    tighter; production should leave the default.
+        const pubsub = this.system.extension(DistributedPubSubId).start(this.cluster, { gossipIntervalMs: this.pubsubGossipIntervalMs() });
+        this._mediator = pubsub;
+        pubsub.tell(new Subscribe(topicFor(this.persistenceId), this.self));
+        await this.onRecoveryComplete(this._state);
+    }
+    postStop() {
+        // Release the live-pid registration so a fresh actor with the
+        // same persistenceId can take over (e.g. after a graceful stop
+        // + re-spawn).  Must run on every termination path, including
+        // restart-after-failure where preRestart calls postStop before
+        // a new instance gets preStart.
+        const livePids = livePidsBySystem.get(this.system);
+        livePids?.delete(this.persistenceId);
+        // Release the lease if held (#89) — a clean exit lets a follower
+        // acquire faster than waiting for the TTL to expire.  Fire-and-
+        // forget; lease backends typically tolerate "owner gone" via TTL
+        // anyway so a failure to release is not fatal.
+        this._leaseUnsubLost?.();
+        this._leaseUnsubLost = null;
+        if (this._lease && this._isLeaseHolder) {
+            void this._lease.release().catch(() => { });
+        }
+        this._lease = null;
+    }
+    async onReceive(msg) {
+        // Ignore PubSub ack frames — they're informational.
+        if (msg && typeof msg === 'object' && msg.subscribe instanceof Subscribe) {
+            return;
+        }
+        if (this._isEnvelope(msg)) {
+            this._handleRemote(msg);
+            return;
+        }
+        await this.onCommand(this._state, msg);
+    }
+    /**
+     * Persist a fresh local event.  Increments this replica's VC
+     * component, appends to the journal tagged `replicated-es`, applies
+     * to local state, and broadcasts to peer replicas.
+     *
+     * When a lease is configured (#89) and this replica is NOT the
+     * holder, throws — the actor is in observer mode and writes must
+     * route to the holder.  Users that don't want the throw can gate
+     * on `isLeaseHolder` before calling `persist`.
+     */
+    async persist(event, cb) {
+        if (this._lease && !this._isLeaseHolder) {
+            throw new Error(`ReplicatedEventSourcedActor '${this.persistenceId}': cannot persist — ` +
+                `this replica is in observer mode (lease held by another replica or lost). ` +
+                `Gate calls on \`this.isLeaseHolder\` to avoid this.`);
+        }
+        this._localSeq += 1;
+        this._vc = this._vc.tick(this.replicaId);
+        const envelope = {
+            persistenceId: this.persistenceId,
+            replica: this.replicaId,
+            seqAtReplica: this._localSeq,
+            vc: this._vc.toJSON(),
+            timestamp: Date.now(),
+            event,
+        };
+        await this._appendOne(envelope);
+        this._absorb(envelope, /* persistLocally= */ false, /* broadcast= */ true);
+        cb?.(this._state);
+    }
+    /**
+     * Append exactly one envelope to the local journal.  We read the
+     * current highestSeq inside the same actor mailbox tick so the
+     * `expectedSeq` argument is always accurate — the actor is the
+     * single writer to its own persistenceId, so no other coroutine
+     * can interleave between the read and the append.
+     *
+     * Updates `_journalSeq` so the next snapshot records the
+     * just-appended journal position.
+     */
+    async _appendOne(envelope) {
+        const head = await this._journal.highestSeq(this.persistenceId);
+        const written = await this._journal.append(this.persistenceId, [envelope], head, [REPLICATED_TAG]);
+        const lastWrittenSeq = written[written.length - 1]?.sequenceNr ?? head + 1;
+        if (lastWrittenSeq > this._journalSeq)
+            this._journalSeq = lastWrittenSeq;
+    }
+    /* ----------------------------- absorb event --------------------------- */
+    _handleRemote(envelope) {
+        if (envelope.persistenceId !== this.persistenceId)
+            return; // not for us
+        if (envelope.replica === this.replicaId)
+            return; // our own broadcast — ignore
+        void this._absorb(envelope, /* persistLocally= */ true, /* broadcast= */ false);
+    }
+    /**
+     * Insert an envelope into the canonical event list, dedupe by
+     * (replica, seqAtReplica), refold state from the divergence point.
+     *
+     * `persistLocally` controls whether we also append the event to
+     * our local journal (true for events received from peers; false
+     * for replays + own broadcasts since those are already on disk).
+     *
+     * `broadcast` controls whether we publish the event to PubSub
+     * (true only for fresh local persists).
+     */
+    _absorb(envelope, persistLocally, broadcast) {
+        const id = `${envelope.replica}#${envelope.seqAtReplica}`;
+        if (this._seenIds.has(id))
+            return;
+        this._seenIds.add(id);
+        // Fast path: envelope sorts after every existing event → just append.
+        const last = this._events[this._events.length - 1];
+        const insertIndex = last && this._compare(envelope, last) > 0
+            ? this._events.length
+            : this._findInsertIndex(envelope);
+        this._events.splice(insertIndex, 0, envelope);
+        if (insertIndex === this._events.length - 1) {
+            // Append-only — apply just this event to current state.
+            this._state = this.onEvent(this._state, envelope.event);
+        }
+        else {
+            // Out-of-order arrival — refold from initial state to keep
+            // the canonical sort intact.  Cheap as long as N stays small;
+            // gossip usually delivers in order so this is rare.
+            this._state = this.initialState();
+            for (const e of this._events)
+                this._state = this.onEvent(this._state, e.event);
+        }
+        this._vc = this._vc.merge(VectorClock.fromData(envelope.vc));
+        this._observedCount += 1;
+        if (persistLocally) {
+            // Append remote events to OUR local journal so a recovery from
+            // disk replays the full causal history.  Single-writer (us) per
+            // pid means we can read highestSeq + append in one mailbox
+            // tick without races.
+            void this._appendOne(envelope).catch((err) => {
+                this.log.warn(`replicated-es: failed to persist remote event from ${envelope.replica}#${envelope.seqAtReplica}`, err);
+            });
+        }
+        if (broadcast && this._mediator) {
+            this._mediator.tell(new Publish(topicFor(this.persistenceId), envelope));
+        }
+        // Snapshot policy check — fire AFTER state has been updated and
+        // VC merged so the snapshot we save is fully consistent.
+        const policy = this.snapshotPolicy();
+        if (policy(this._observedCount, this._state, envelope.event)) {
+            this._maybeSaveSnapshot();
+        }
+    }
+    /* ----------------------------- snapshotting --------------------------- */
+    /**
+     * Force a snapshot of the current state.  Useful for tests + manual
+     * compaction.  Returns the saved snapshot or `null` if a save was
+     * already in flight.
+     */
+    async saveSnapshot() {
+        return this._saveSnapshotNow();
+    }
+    /**
+     * Triggered by the policy check in `_absorb`.  Fire-and-forget so
+     * the actor's mailbox doesn't block on disk I/O; the in-flight
+     * guard prevents overlapping saves.  Recovery is correct even if a
+     * mid-save crash drops the snapshot — we just fall back to the
+     * previous snapshot or full replay.
+     */
+    _maybeSaveSnapshot() {
+        if (this._snapshotInFlight)
+            return;
+        this._snapshotInFlight = true;
+        void this._saveSnapshotNow().finally(() => {
+            this._snapshotInFlight = false;
+        });
+    }
+    async _saveSnapshotNow() {
+        const snapshot = {
+            state: this._state,
+            vc: this._vc.toJSON(),
+            seenIds: Array.from(this._seenIds),
+            events: [...this._events],
+            localSeq: this._localSeq,
+            journalSeqAtSnapshot: this._journalSeq,
+            takenBy: this.replicaId,
+            takenAt: Date.now(),
+        };
+        try {
+            await this._snapshotStore.save(this.persistenceId, this._journalSeq, snapshot);
+        }
+        catch (err) {
+            this.log.warn(`replicated-es: snapshot save failed`, err);
+        }
+    }
+    _findInsertIndex(envelope) {
+        // Linear scan — for small histories this is cheaper than a
+        // binary search's branch overhead.  Swap for binary if profiling
+        // says so.
+        for (let i = 0; i < this._events.length; i++) {
+            if (this._compare(envelope, this._events[i]) < 0)
+                return i;
+        }
+        return this._events.length;
+    }
+    _compare(a, b) {
+        if (a.timestamp !== b.timestamp)
+            return a.timestamp - b.timestamp;
+        if (a.replica !== b.replica)
+            return a.replica < b.replica ? -1 : 1;
+        return a.seqAtReplica - b.seqAtReplica;
+    }
+    _isEnvelope(x) {
+        return !!x && typeof x === 'object'
+            && x.persistenceId === this.persistenceId
+            && typeof x.seqAtReplica === 'number';
+    }
+}
+export { LastWriterWinsResolver, CustomMergeResolver } from './replicated/ConflictResolver.js';
+export { VectorClock };
+//# sourceMappingURL=ReplicatedEventSourcedActor.js.map

package/dist/persistence/ReplicatedEventSourcedActor.js.map

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

package/dist/persistence/SnapshotStore.d.ts

@@ -0,0 +1,31 @@
+import type { Snapshot } from './JournalTypes.js';
+import type { PersistenceOptions } from './PersistenceOptions.js';
+import type { Option } from '../util/Option.js';
+/**
+ * Pluggable snapshot store.  Snapshots short-circuit recovery by fast-
+ * forwarding the state machine to a known point, so replay only needs
+ * to apply events newer than the snapshot.
+ */
+export interface SnapshotStore {
+    /**
+     * Persist a snapshot at `seq` — typically the seq of the latest event
+     * applied.  Optional `options` carry per-call preferences from the
+     * caller (e.g. compression/encryption set on the actor).  Stores that
+     * cannot honour them silently ignore the field.
+     */
+    save<S = unknown>(pid: string, seq: number, state: S, options?: PersistenceOptions): Promise<Snapshot<S>>;
+    /**
+     * Load the newest snapshot for `pid`, or None if none exist.
+     * `options.encryption` is required when client-side encryption was
+     * used at write time — the store has no other way to obtain the
+     * master key.  Stores that don't encrypt ignore the field.
+     */
+    loadLatest<S = unknown>(pid: string, options?: PersistenceOptions): Promise<Option<Snapshot<S>>>;
+    /** Load the newest snapshot with `sequenceNr < seq`, or None. */
+    loadBefore<S = unknown>(pid: string, seq: number, options?: PersistenceOptions): Promise<Option<Snapshot<S>>>;
+    /** Delete snapshots up to and including `toSeq`.  Useful for pruning. */
+    delete(pid: string, toSeq: number): Promise<void>;
+    /** Best-effort teardown. */
+    close?(): Promise<void>;
+}
+//# sourceMappingURL=SnapshotStore.d.ts.map

package/dist/persistence/SnapshotStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SnapshotStore.d.ts","sourceRoot":"","sources":["../../src/persistence/SnapshotStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,IAAI,CAAC,CAAC,GAAG,OAAO,EACd,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,EACR,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAExB;;;;;OAKG;IACH,UAAU,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEjG,iEAAiE;IACjE,UAAU,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAE9G,yEAAyE;IACzE,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElD,4BAA4B;IAC5B,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB"}

package/dist/persistence/SnapshotStore.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SnapshotStore.js.map

package/dist/persistence/SnapshotStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SnapshotStore.js","sourceRoot":"","sources":["../../src/persistence/SnapshotStore.ts"],"names":[],"mappings":""}

package/dist/persistence/durable-state-stores/InMemoryDurableStateStore.d.ts

@@ -0,0 +1,14 @@
+import { type DurableStateRecord, type DurableStateStore } from '../DurableStateStore.js';
+import type { PersistenceOptions } from '../PersistenceOptions.js';
+import { type Option } from '../../util/Option.js';
+/**
+ * Reference Durable State store backed by a JS Map.  Useful for tests and
+ * single-process development; swap for a SQLite/Cassandra store in production.
+ */
+export declare class InMemoryDurableStateStore implements DurableStateStore {
+    private readonly records;
+    upsert<S>(persistenceId: string, expectedRevision: number, state: S, _options?: PersistenceOptions): Promise<DurableStateRecord<S>>;
+    load<S>(persistenceId: string, _options?: PersistenceOptions): Promise<Option<DurableStateRecord<S>>>;
+    delete(persistenceId: string): Promise<void>;
+}
+//# sourceMappingURL=InMemoryDurableStateStore.d.ts.map

package/dist/persistence/durable-state-stores/InMemoryDurableStateStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryDurableStateStore.d.ts","sourceRoot":"","sources":["../../../src/persistence/durable-state-stores/InMemoryDurableStateStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEjE;;;GAGG;AACH,qBAAa,yBAA0B,YAAW,iBAAiB;IACjE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkD;IAEpE,MAAM,CAAC,CAAC,EACZ,aAAa,EAAE,MAAM,EACrB,gBAAgB,EAAE,MAAM,EACxB,KAAK,EAAE,CAAC,EACR,QAAQ,CAAC,EAAE,kBAAkB,GAC5B,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;IAgB3B,IAAI,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;IAIrG,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGnD"}

package/dist/persistence/durable-state-stores/InMemoryDurableStateStore.js

@@ -0,0 +1,31 @@
+import { DurableStateConcurrencyError, } from '../DurableStateStore.js';
+import { fromNullable } from '../../util/Option.js';
+/**
+ * Reference Durable State store backed by a JS Map.  Useful for tests and
+ * single-process development; swap for a SQLite/Cassandra store in production.
+ */
+export class InMemoryDurableStateStore {
+    records = new Map();
+    async upsert(persistenceId, expectedRevision, state, _options) {
+        const current = this.records.get(persistenceId);
+        const actual = current?.revision ?? 0;
+        if (actual !== expectedRevision) {
+            throw new DurableStateConcurrencyError(persistenceId, expectedRevision, actual);
+        }
+        const record = {
+            persistenceId,
+            revision: actual + 1,
+            state,
+            timestamp: Date.now(),
+        };
+        this.records.set(persistenceId, record);
+        return record;
+    }
+    async load(persistenceId, _options) {
+        return fromNullable(this.records.get(persistenceId));
+    }
+    async delete(persistenceId) {
+        this.records.delete(persistenceId);
+    }
+}
+//# sourceMappingURL=InMemoryDurableStateStore.js.map

package/dist/persistence/durable-state-stores/InMemoryDurableStateStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryDurableStateStore.js","sourceRoot":"","sources":["../../../src/persistence/durable-state-stores/InMemoryDurableStateStore.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,GAG7B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,YAAY,EAAe,MAAM,sBAAsB,CAAC;AAEjE;;;GAGG;AACH,MAAM,OAAO,yBAAyB;IACnB,OAAO,GAAG,IAAI,GAAG,EAAuC,CAAC;IAE1E,KAAK,CAAC,MAAM,CACV,aAAqB,EACrB,gBAAwB,EACxB,KAAQ,EACR,QAA6B;QAE7B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,OAAO,EAAE,QAAQ,IAAI,CAAC,CAAC;QACtC,IAAI,MAAM,KAAK,gBAAgB,EAAE,CAAC;YAChC,MAAM,IAAI,4BAA4B,CAAC,aAAa,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC;QAClF,CAAC;QACD,MAAM,MAAM,GAA0B;YACpC,aAAa;YACb,QAAQ,EAAE,MAAM,GAAG,CAAC;YACpB,KAAK;YACL,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;QACF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,MAAqC,CAAC,CAAC;QACvE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,IAAI,CAAI,aAAqB,EAAE,QAA6B;QAChE,OAAO,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAsC,CAAC,CAAC;IAC5F,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,aAAqB;QAChC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IACrC,CAAC;CACF"}

package/dist/persistence/durable-state-stores/ObjectStorageDurableStateStore.d.ts

@@ -0,0 +1,27 @@
+import { type ObjectStorageBackend } from '../object-storage/ObjectStorageBackend.js';
+import { type CompressionConfig, type CompressionResolver, type EncryptionConfig, type EncryptionResolver } from '../object-storage/PluginConfig.js';
+import { type DurableStateRecord, type DurableStateStore } from '../DurableStateStore.js';
+import type { PersistenceOptions } from '../PersistenceOptions.js';
+import { type Option } from '../../util/Option.js';
+export interface ObjectStorageDurableStateStoreOptions {
+    readonly backend: ObjectStorageBackend;
+    readonly prefix?: string;
+    readonly compression?: CompressionConfig | CompressionResolver;
+    readonly encryption?: EncryptionConfig | EncryptionResolver;
+}
+export declare class ObjectStorageDurableStateStore implements DurableStateStore {
+    private readonly backend;
+    private readonly prefix;
+    private readonly compression;
+    private readonly encryption;
+    private readonly etagCache;
+    constructor(opts: ObjectStorageDurableStateStoreOptions);
+    load<S>(pid: string, options?: PersistenceOptions): Promise<Option<DurableStateRecord<S>>>;
+    upsert<S>(pid: string, expectedRevision: number, state: S, options?: PersistenceOptions): Promise<DurableStateRecord<S>>;
+    delete(pid: string): Promise<void>;
+    close(): Promise<void>;
+    /** Test hook — drop the cached ETag for a pid (simulates actor restart). */
+    forgetEtagForTest(pid: string): void;
+    private keyFor;
+}
+//# sourceMappingURL=ObjectStorageDurableStateStore.d.ts.map

package/dist/persistence/durable-state-stores/ObjectStorageDurableStateStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectStorageDurableStateStore.d.ts","sourceRoot":"","sources":["../../../src/persistence/durable-state-stores/ObjectStorageDurableStateStore.ts"],"names":[],"mappings":"AAOA,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACxB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAc,KAAK,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAuB/D,MAAM,WAAW,qCAAqC;IACpD,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,iBAAiB,GAAG,mBAAmB,CAAC;IAC/D,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,GAAG,kBAAkB,CAAC;CAC7D;AAOD,qBAAa,8BAA+B,YAAW,iBAAiB;IACtE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsD;IAClF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoD;IAC/E,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkC;gBAEhD,IAAI,EAAE,qCAAqC;IAOjD,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;IAyB1F,MAAM,CAAC,CAAC,EACZ,GAAG,EAAE,MAAM,EACX,gBAAgB,EAAE,MAAM,EACxB,KAAK,EAAE,CAAC,EACR,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;IAqF3B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,4EAA4E;IAC5E,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAMpC,OAAO,CAAC,MAAM;CAGf"}