@optimystic/db-p2p 0.14.1 → 0.16.3

package/dist/src/storage/memory-storage.d.ts

@@ -1,60 +1,22 @@
-import type { BlockId, IBlock, Transform, ActionId, ActionRev } from "@optimystic/db-core";
-import type { BlockMetadata } from "./struct.js";
-import type { IRawStorage } from "./i-raw-storage.js";
-export declare class MemoryRawStorage implements IRawStorage {
-    private metadata;
-    private revisions;
-    private pendingActions;
-    private actions;
-    private materializedBlocks;
-    private getRevisionKey;
-    private getActionKey;
-    /**
-     * Retrieves metadata for a block.
-     *
-     * @pitfall **MUST return a clone** - `BlockStorage.setLatest` mutates the returned
-     * metadata in place (`meta.latest = latest`) before calling `saveMetadata`. Returning
-     * the stored reference leaks that mutation into RAM even when a subsequent
-     * `saveMetadata` call fails, masking mid-commit crashes that a persistent store
-     * (file/sqlite/leveldb) would surface correctly.
-     * @see docs/internals.md "Storage Returns References" pitfall
-     */
-    getMetadata(blockId: BlockId): Promise<BlockMetadata | undefined>;
-    /**
-     * Stores metadata for a block.
-     *
-     * @pitfall **MUST store a clone** - callers may continue mutating the metadata object
-     * after saving; storing the reference lets those mutations corrupt persisted state.
-     * @see docs/internals.md "Storage Returns References" pitfall
-     */
-    saveMetadata(blockId: BlockId, metadata: BlockMetadata): Promise<void>;
-    getRevision(blockId: BlockId, rev: number): Promise<ActionId | undefined>;
-    saveRevision(blockId: BlockId, rev: number, actionId: ActionId): Promise<void>;
-    listRevisions(blockId: BlockId, startRev: number, endRev: number): AsyncIterable<ActionRev>;
-    getPendingTransaction(blockId: BlockId, actionId: ActionId): Promise<Transform | undefined>;
-    savePendingTransaction(blockId: BlockId, actionId: ActionId, transform: Transform): Promise<void>;
-    deletePendingTransaction(blockId: BlockId, actionId: ActionId): Promise<void>;
-    listPendingTransactions(blockId: BlockId): AsyncIterable<ActionId>;
-    getTransaction(blockId: BlockId, actionId: ActionId): Promise<Transform | undefined>;
-    saveTransaction(blockId: BlockId, actionId: ActionId, transform: Transform): Promise<void>;
-    /**
-     * Retrieves a materialized block at a specific revision.
-     *
-     * @pitfall **MUST return a clone** - `applyTransform()` mutates blocks in place.
-     * If we return the stored reference, mutations corrupt ALL revisions that share
-     * the same underlying object.
-     * @see docs/internals.md "Storage Returns References" pitfall
-     */
-    getMaterializedBlock(blockId: BlockId, actionId: ActionId): Promise<IBlock | undefined>;
-    /**
-     * Stores a materialized block at a specific revision.
-     *
-     * @pitfall **MUST store a clone** - callers may continue mutating the block after saving.
-     * If we store the reference, those mutations corrupt the stored data.
-     * @see docs/internals.md "Storage Returns References" pitfall
-     */
-    saveMaterializedBlock(blockId: BlockId, actionId: ActionId, block?: IBlock): Promise<void>;
-    promotePendingTransaction(blockId: BlockId, actionId: ActionId): Promise<void>;
-    getApproximateBytesUsed(): Promise<number>;
+import { KvRawStorage } from "./kv-raw-storage.js";
+/**
+ * In-memory {@link IRawStorage}, now a thin shell over the shared
+ * {@link KvRawStorage} kernel backed by a {@link MemoryStoreDriver}.
+ *
+ * @pitfall The old hand-rolled version had to `structuredClone` on every get and
+ * put — otherwise callers mutating a returned/stored object corrupted the store
+ * (see docs/internals.md "Storage Returns References"). That discipline is GONE
+ * and must not be reintroduced: values cross the driver boundary as
+ * `Uint8Array` produced by `JSON`-encode and consumed by `JSON`-decode, so every
+ * read decodes a fresh object and every write stored an independent byte
+ * snapshot BY CONSTRUCTION. The clone-on-store / clone-on-read invariant is now
+ * structural, not a rule. The conformance suite asserts it so a future driver
+ * that shortcuts the byte boundary is caught.
+ *
+ * The name is kept stable so existing imports (`from '@optimystic/db-p2p'`)
+ * continue to resolve.
+ */
+export declare class MemoryRawStorage extends KvRawStorage {
+    constructor();
 }
 //# sourceMappingURL=memory-storage.d.ts.map

package/dist/src/storage/memory-storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-storage.d.ts","sourceRoot":"","sources":["../../../src/storage/memory-storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC3F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,qBAAa,gBAAiB,YAAW,WAAW;IACnD,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,cAAc,CAAgC;IACtD,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,kBAAkB,CAA6B;IAEvD,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,YAAY;IAIpB;;;;;;;;;OASG;IACG,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;IAKvE;;;;;;OAMG;IACG,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAItE,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IAIzE,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7E,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC;IAsB5F,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAI3F,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjG,wBAAwB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5E,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,CAAC,QAAQ,CAAC;IASnE,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAIpF,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhG;;;;;;;OAOG;IACG,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAM7F;;;;;;OAMG;IACG,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU1F,yBAAyB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAS9E,uBAAuB,IAAI,OAAO,CAAC,MAAM,CAAC;CAmBhD"}
+{"version":3,"file":"memory-storage.d.ts","sourceRoot":"","sources":["../../../src/storage/memory-storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;;CAIjD"}

package/dist/src/storage/memory-storage.js

@@ -1,151 +1,25 @@
-export class MemoryRawStorage {
-    metadata = new Map();
-    revisions = new Map(); // blockId:rev -> actionId
-    pendingActions = new Map(); // blockId:actionId -> transform
-    actions = new Map(); // blockId:actionId -> transform
-    materializedBlocks = new Map(); // blockId:actionId -> block
-    getRevisionKey(blockId, rev) {
-        return `${blockId}:${rev}`;
-    }
-    getActionKey(blockId, actionId) {
-        return `${blockId}:${actionId}`;
-    }
-    /**
-     * Retrieves metadata for a block.
-     *
-     * @pitfall **MUST return a clone** - `BlockStorage.setLatest` mutates the returned
-     * metadata in place (`meta.latest = latest`) before calling `saveMetadata`. Returning
-     * the stored reference leaks that mutation into RAM even when a subsequent
-     * `saveMetadata` call fails, masking mid-commit crashes that a persistent store
-     * (file/sqlite/leveldb) would surface correctly.
-     * @see docs/internals.md "Storage Returns References" pitfall
-     */
-    async getMetadata(blockId) {
-        const meta = this.metadata.get(blockId);
-        return meta ? structuredClone(meta) : undefined;
-    }
-    /**
-     * Stores metadata for a block.
-     *
-     * @pitfall **MUST store a clone** - callers may continue mutating the metadata object
-     * after saving; storing the reference lets those mutations corrupt persisted state.
-     * @see docs/internals.md "Storage Returns References" pitfall
-     */
-    async saveMetadata(blockId, metadata) {
-        this.metadata.set(blockId, structuredClone(metadata));
-    }
-    async getRevision(blockId, rev) {
-        return this.revisions.get(this.getRevisionKey(blockId, rev));
-    }
-    async saveRevision(blockId, rev, actionId) {
-        this.revisions.set(this.getRevisionKey(blockId, rev), actionId);
-    }
-    async *listRevisions(blockId, startRev, endRev) {
-        const ascending = startRev <= endRev;
-        const actualStart = ascending ? startRev : endRev;
-        const actualEnd = ascending ? endRev : startRev;
-        const results = [];
-        for (let rev = actualStart; rev <= actualEnd; rev++) {
-            const actionId = this.revisions.get(this.getRevisionKey(blockId, rev));
-            if (actionId) {
-                results.push({ rev, actionId });
-            }
-        }
-        if (!ascending) {
-            results.reverse();
-        }
-        for (const result of results) {
-            yield result;
-        }
-    }
-    async getPendingTransaction(blockId, actionId) {
-        return this.pendingActions.get(this.getActionKey(blockId, actionId));
-    }
-    async savePendingTransaction(blockId, actionId, transform) {
-        // Clone transform to prevent external modifications from affecting stored data
-        this.pendingActions.set(this.getActionKey(blockId, actionId), structuredClone(transform));
-    }
-    async deletePendingTransaction(blockId, actionId) {
-        this.pendingActions.delete(this.getActionKey(blockId, actionId));
-    }
-    async *listPendingTransactions(blockId) {
-        const prefix = `${blockId}:`;
-        for (const [key] of Array.from(this.pendingActions.entries())) {
-            if (key.startsWith(prefix)) {
-                yield key.substring(prefix.length);
-            }
-        }
-    }
-    async getTransaction(blockId, actionId) {
-        return this.actions.get(this.getActionKey(blockId, actionId));
-    }
-    async saveTransaction(blockId, actionId, transform) {
-        this.actions.set(this.getActionKey(blockId, actionId), transform);
-    }
-    /**
-     * Retrieves a materialized block at a specific revision.
-     *
-     * @pitfall **MUST return a clone** - `applyTransform()` mutates blocks in place.
-     * If we return the stored reference, mutations corrupt ALL revisions that share
-     * the same underlying object.
-     * @see docs/internals.md "Storage Returns References" pitfall
-     */
-    async getMaterializedBlock(blockId, actionId) {
-        const block = this.materializedBlocks.get(this.getActionKey(blockId, actionId));
-        // Clone to prevent external mutations from affecting stored data
-        return block ? structuredClone(block) : undefined;
-    }
-    /**
-     * Stores a materialized block at a specific revision.
-     *
-     * @pitfall **MUST store a clone** - callers may continue mutating the block after saving.
-     * If we store the reference, those mutations corrupt the stored data.
-     * @see docs/internals.md "Storage Returns References" pitfall
-     */
-    async saveMaterializedBlock(blockId, actionId, block) {
-        const key = this.getActionKey(blockId, actionId);
-        if (block) {
-            // Clone to prevent external mutations from affecting stored data
-            this.materializedBlocks.set(key, structuredClone(block));
-        }
-        else {
-            this.materializedBlocks.delete(key);
-        }
-    }
-    async promotePendingTransaction(blockId, actionId) {
-        const key = this.getActionKey(blockId, actionId);
-        const transform = this.pendingActions.get(key);
-        if (transform) {
-            this.actions.set(key, transform);
-            this.pendingActions.delete(key);
-        }
-    }
-    async getApproximateBytesUsed() {
-        let total = 0;
-        for (const [blockId, meta] of this.metadata) {
-            total += blockId.length + jsonByteSize(meta);
-        }
-        for (const [key, actionId] of this.revisions) {
-            total += key.length + actionId.length;
-        }
-        for (const [key, transform] of this.pendingActions) {
-            total += key.length + jsonByteSize(transform);
-        }
-        for (const [key, transform] of this.actions) {
-            total += key.length + jsonByteSize(transform);
-        }
-        for (const [key, block] of this.materializedBlocks) {
-            total += key.length + jsonByteSize(block);
-        }
-        return total;
-    }
-}
-function jsonByteSize(value) {
-    try {
-        return JSON.stringify(value)?.length ?? 0;
-    }
-    catch {
-        return 0;
+import { KvRawStorage } from "./kv-raw-storage.js";
+import { MemoryStoreDriver } from "./memory-store-driver.js";
+/**
+ * In-memory {@link IRawStorage}, now a thin shell over the shared
+ * {@link KvRawStorage} kernel backed by a {@link MemoryStoreDriver}.
+ *
+ * @pitfall The old hand-rolled version had to `structuredClone` on every get and
+ * put — otherwise callers mutating a returned/stored object corrupted the store
+ * (see docs/internals.md "Storage Returns References"). That discipline is GONE
+ * and must not be reintroduced: values cross the driver boundary as
+ * `Uint8Array` produced by `JSON`-encode and consumed by `JSON`-decode, so every
+ * read decodes a fresh object and every write stored an independent byte
+ * snapshot BY CONSTRUCTION. The clone-on-store / clone-on-read invariant is now
+ * structural, not a rule. The conformance suite asserts it so a future driver
+ * that shortcuts the byte boundary is caught.
+ *
+ * The name is kept stable so existing imports (`from '@optimystic/db-p2p'`)
+ * continue to resolve.
+ */
+export class MemoryRawStorage extends KvRawStorage {
+    constructor() {
+        super(new MemoryStoreDriver());
     }
 }
 //# sourceMappingURL=memory-storage.js.map

package/dist/src/storage/memory-storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"memory-storage.js","sourceRoot":"","sources":["../../../src/storage/memory-storage.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"memory-storage.js","sourceRoot":"","sources":["../../../src/storage/memory-storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,gBAAiB,SAAQ,YAAY;IACjD;QACC,KAAK,CAAC,IAAI,iBAAiB,EAAE,CAAC,CAAC;IAChC,CAAC;CACD"}

package/dist/src/storage/memory-store-driver.d.ts

@@ -0,0 +1,39 @@
+import type { BlockId, ActionId } from "@optimystic/db-core";
+import type { RawStoreDriver } from "./raw-store-driver.js";
+/**
+ * In-memory {@link RawStoreDriver}: the five logical block-storage stores as
+ * `Map`s of `Uint8Array` values. `KvRawStorage` hands this driver bytes produced
+ * by `JSON`-encode and reads them back via `JSON`-decode, so every get yields a
+ * fresh object and every save stored an independent byte snapshot BY
+ * CONSTRUCTION — the old `structuredClone`-on-every-get/put discipline is now
+ * structural, not a rule a maintainer has to remember. The driver therefore
+ * stores the byte reference directly: those bytes are never mutated by the
+ * kernel or exposed to callers as a mutable handle.
+ */
+export declare class MemoryStoreDriver implements RawStoreDriver {
+    private readonly metadata;
+    private readonly revisions;
+    private readonly pending;
+    private readonly transactions;
+    private readonly materialized;
+    private revisionKey;
+    private actionKey;
+    getMetadata(blockId: BlockId): Promise<Uint8Array | undefined>;
+    putMetadata(blockId: BlockId, value: Uint8Array): Promise<void>;
+    getRevision(blockId: BlockId, rev: number): Promise<Uint8Array | undefined>;
+    putRevision(blockId: BlockId, rev: number, value: Uint8Array): Promise<void>;
+    rangeRevisions(blockId: BlockId, lo: number, hi: number, reverse: boolean): AsyncIterable<[number, Uint8Array]>;
+    getPending(blockId: BlockId, actionId: ActionId): Promise<Uint8Array | undefined>;
+    putPending(blockId: BlockId, actionId: ActionId, value: Uint8Array): Promise<void>;
+    deletePending(blockId: BlockId, actionId: ActionId): Promise<void>;
+    listPendingActionIds(blockId: BlockId): AsyncIterable<ActionId>;
+    getTransaction(blockId: BlockId, actionId: ActionId): Promise<Uint8Array | undefined>;
+    putTransaction(blockId: BlockId, actionId: ActionId, value: Uint8Array): Promise<void>;
+    getMaterialized(blockId: BlockId, actionId: ActionId): Promise<Uint8Array | undefined>;
+    putMaterialized(blockId: BlockId, actionId: ActionId, value: Uint8Array): Promise<void>;
+    deleteMaterialized(blockId: BlockId, actionId: ActionId): Promise<void>;
+    promote(blockId: BlockId, actionId: ActionId): Promise<void>;
+    listBlockIds(): AsyncIterable<BlockId>;
+    approximateBytesUsed(): Promise<number>;
+}
+//# sourceMappingURL=memory-store-driver.d.ts.map

package/dist/src/storage/memory-store-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store-driver.d.ts","sourceRoot":"","sources":["../../../src/storage/memory-store-driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;;;;;;;GASG;AACH,qBAAa,iBAAkB,YAAW,cAAc;IACvD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAC3D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiC;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiC;IAC9D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiC;IAE9D,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,SAAS;IAMX,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAI9D,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/D,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAI3E,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3E,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,aAAa,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAqBhH,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAIjF,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlF,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjE,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,CAAC,QAAQ,CAAC;IAiBhE,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAIrF,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAMtF,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAItF,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvF,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAMvE,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAY3D,YAAY,IAAI,aAAa,CAAC,OAAO,CAAC;IAUvC,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC;CAY7C"}

package/dist/src/storage/memory-store-driver.js

@@ -0,0 +1,129 @@
+/**
+ * In-memory {@link RawStoreDriver}: the five logical block-storage stores as
+ * `Map`s of `Uint8Array` values. `KvRawStorage` hands this driver bytes produced
+ * by `JSON`-encode and reads them back via `JSON`-decode, so every get yields a
+ * fresh object and every save stored an independent byte snapshot BY
+ * CONSTRUCTION — the old `structuredClone`-on-every-get/put discipline is now
+ * structural, not a rule a maintainer has to remember. The driver therefore
+ * stores the byte reference directly: those bytes are never mutated by the
+ * kernel or exposed to callers as a mutable handle.
+ */
+export class MemoryStoreDriver {
+    metadata = new Map();
+    revisions = new Map(); // `${blockId}:${rev}` -> actionId bytes
+    pending = new Map(); // `${blockId}:${actionId}` -> transform bytes
+    transactions = new Map();
+    materialized = new Map();
+    revisionKey(blockId, rev) {
+        return `${blockId}:${rev}`;
+    }
+    actionKey(blockId, actionId) {
+        return `${blockId}:${actionId}`;
+    }
+    // --- metadata ---
+    async getMetadata(blockId) {
+        return this.metadata.get(blockId);
+    }
+    async putMetadata(blockId, value) {
+        this.metadata.set(blockId, value);
+    }
+    // --- revisions ---
+    async getRevision(blockId, rev) {
+        return this.revisions.get(this.revisionKey(blockId, rev));
+    }
+    async putRevision(blockId, rev, value) {
+        this.revisions.set(this.revisionKey(blockId, rev), value);
+    }
+    async *rangeRevisions(blockId, lo, hi, reverse) {
+        // Drain into an array before yielding (drain-before-yield contract): the
+        // consumer awaits between yields, and a Map has no live cursor to pin, but
+        // this keeps the memory driver's semantics identical to the native backends.
+        const results = [];
+        for (let rev = lo; rev <= hi; rev++) {
+            const value = this.revisions.get(this.revisionKey(blockId, rev));
+            if (value !== undefined) {
+                results.push([rev, value]);
+            }
+        }
+        if (reverse) {
+            results.reverse();
+        }
+        for (const result of results) {
+            yield result;
+        }
+    }
+    // --- pending ---
+    async getPending(blockId, actionId) {
+        return this.pending.get(this.actionKey(blockId, actionId));
+    }
+    async putPending(blockId, actionId, value) {
+        this.pending.set(this.actionKey(blockId, actionId), value);
+    }
+    async deletePending(blockId, actionId) {
+        this.pending.delete(this.actionKey(blockId, actionId));
+    }
+    async *listPendingActionIds(blockId) {
+        const prefix = `${blockId}:`;
+        // Snapshot before yielding (drain-before-yield): a concurrent putPending during
+        // the scan must not invalidate a live map iterator.
+        const ids = [];
+        for (const key of Array.from(this.pending.keys())) {
+            if (key.startsWith(prefix)) {
+                ids.push(key.substring(prefix.length));
+            }
+        }
+        for (const id of ids) {
+            yield id;
+        }
+    }
+    // --- transactions ---
+    async getTransaction(blockId, actionId) {
+        return this.transactions.get(this.actionKey(blockId, actionId));
+    }
+    async putTransaction(blockId, actionId, value) {
+        this.transactions.set(this.actionKey(blockId, actionId), value);
+    }
+    // --- materialized ---
+    async getMaterialized(blockId, actionId) {
+        return this.materialized.get(this.actionKey(blockId, actionId));
+    }
+    async putMaterialized(blockId, actionId, value) {
+        this.materialized.set(this.actionKey(blockId, actionId), value);
+    }
+    async deleteMaterialized(blockId, actionId) {
+        this.materialized.delete(this.actionKey(blockId, actionId));
+    }
+    // --- promote (atomic move; synchronous Map ops make it indivisible here) ---
+    async promote(blockId, actionId) {
+        const key = this.actionKey(blockId, actionId);
+        const value = this.pending.get(key);
+        if (value === undefined) {
+            throw new Error(`Pending action ${actionId} not found for block ${blockId}`);
+        }
+        this.transactions.set(key, value);
+        this.pending.delete(key);
+    }
+    // --- optional passthroughs ---
+    async *listBlockIds() {
+        // Snapshot the keys before yielding so a concurrent putMetadata during the scan
+        // doesn't invalidate a live map iterator. Fresh in-memory storage is empty, so at
+        // real process startup this yields nothing — it exists so the seed path can be
+        // unit-tested against a pre-populated store.
+        for (const blockId of Array.from(this.metadata.keys())) {
+            yield blockId;
+        }
+    }
+    async approximateBytesUsed() {
+        let total = 0;
+        for (const [blockId, value] of this.metadata) {
+            total += blockId.length + value.byteLength;
+        }
+        for (const store of [this.revisions, this.pending, this.transactions, this.materialized]) {
+            for (const [key, value] of store) {
+                total += key.length + value.byteLength;
+            }
+        }
+        return total;
+    }
+}
+//# sourceMappingURL=memory-store-driver.js.map

package/dist/src/storage/memory-store-driver.js.map

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

package/dist/src/storage/raw-store-codec.d.ts

@@ -0,0 +1,10 @@
+import type { ActionId } from "@optimystic/db-core";
+/** JSON-encode a value (`BlockMetadata` / `Transform` / `IBlock`) to UTF-8 bytes. */
+export declare function encodeJson<T>(value: T): Uint8Array;
+/** Decode UTF-8 JSON bytes back into a value. Callers guard the miss (`undefined`) first. */
+export declare function decodeJson<T>(bytes: Uint8Array): T;
+/** Encode an `ActionId` string to UTF-8 bytes (stored as the revisions-store value). */
+export declare function encodeActionId(actionId: ActionId): Uint8Array;
+/** Decode UTF-8 bytes back into an `ActionId` string. */
+export declare function decodeActionId(bytes: Uint8Array): ActionId;
+//# sourceMappingURL=raw-store-codec.d.ts.map

package/dist/src/storage/raw-store-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-store-codec.d.ts","sourceRoot":"","sources":["../../../src/storage/raw-store-codec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAuBpD,qFAAqF;AACrF,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,UAAU,CAElD;AAED,6FAA6F;AAC7F,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,GAAG,CAAC,CAElD;AAED,wFAAwF;AACxF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,UAAU,CAE7D;AAED,yDAAyD;AACzD,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,QAAQ,CAE1D"}

package/dist/src/storage/raw-store-codec.js

@@ -0,0 +1,36 @@
+/**
+ * Value codec shared by every `KvRawStorage`-backed store. Values cross the
+ * `RawStoreDriver` boundary as `Uint8Array`, so this module is the single place
+ * that turns `BlockMetadata`/`Transform`/`IBlock` (via JSON) and the `ActionId`
+ * string (via UTF-8) into bytes and back.
+ *
+ * Because a get always decodes fresh bytes into a NEW object and a save always
+ * encodes an independent byte copy, the clone-on-store / clone-on-read invariant
+ * that in-memory storage used to enforce by hand (`structuredClone`) is now
+ * structural for kernel-backed stores — see docs/internals.md "Storage Returns
+ * References".
+ *
+ * Round-trip fidelity matters for `BlockMetadata`: an open-ended `RevisionRange`
+ * is encoded `[E]` (one element, upper bound `undefined`). `JSON.stringify([5])`
+ * → `"[5]"` → `JSON.parse` → `[5]`, so the open-ended encoding survives byte-exact.
+ * Do NOT normalize ranges here.
+ */
+const encoder = new TextEncoder();
+const decoder = new TextDecoder();
+/** JSON-encode a value (`BlockMetadata` / `Transform` / `IBlock`) to UTF-8 bytes. */
+export function encodeJson(value) {
+    return encoder.encode(JSON.stringify(value));
+}
+/** Decode UTF-8 JSON bytes back into a value. Callers guard the miss (`undefined`) first. */
+export function decodeJson(bytes) {
+    return JSON.parse(decoder.decode(bytes));
+}
+/** Encode an `ActionId` string to UTF-8 bytes (stored as the revisions-store value). */
+export function encodeActionId(actionId) {
+    return encoder.encode(actionId);
+}
+/** Decode UTF-8 bytes back into an `ActionId` string. */
+export function decodeActionId(bytes) {
+    return decoder.decode(bytes);
+}
+//# sourceMappingURL=raw-store-codec.js.map

package/dist/src/storage/raw-store-codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-store-codec.js","sourceRoot":"","sources":["../../../src/storage/raw-store-codec.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;AAClC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;AAElC,qFAAqF;AACrF,MAAM,UAAU,UAAU,CAAI,KAAQ;IACrC,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,UAAU,CAAI,KAAiB;IAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAM,CAAC;AAC/C,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,cAAc,CAAC,QAAkB;IAChD,OAAO,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,cAAc,CAAC,KAAiB;IAC/C,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAa,CAAC;AAC1C,CAAC"}

package/dist/src/storage/raw-store-driver.d.ts

@@ -0,0 +1,69 @@
+import type { BlockId, ActionId } from "@optimystic/db-core";
+/**
+ * Bytes-valued, per-logical-store driver surface. Each backend implements the
+ * five block-storage stores (metadata, revisions, pending, transactions,
+ * materialized) over its native mechanism (LevelDB tag-ranges, five SQLite
+ * tables, five IndexedDB object stores, five filesystem subdirectories, five
+ * in-memory maps). `KvRawStorage` layers all JSON serialization and call
+ * orchestration on top — drivers never (de)serialize values and never see the
+ * `BlockMetadata`/`Transform`/`IBlock` types. Drivers speak only
+ * `Uint8Array`/`BlockId`/`ActionId`/`number`.
+ *
+ * ### Iteration semantics (drain-before-yield)
+ *
+ * `rangeRevisions` and `listPendingActionIds` return an `AsyncIterable`, but a
+ * driver MUST drain its native cursor/iterator into memory BEFORE yielding to
+ * the consumer. A live LevelDB iterator, IndexedDB transaction, or SQLite
+ * cursor must not straddle the consumer's `await`s: IndexedDB auto-commits an
+ * idle transaction, SQLite would hold its mutex slot, and LevelDB pins native
+ * resources. The kernel encodes this as a contract (not a shared implementation)
+ * because the drain is backend-specific. The conformance suite exercises it by
+ * interleaving other awaits between yielded items.
+ *
+ * ### Promote atomicity
+ *
+ * `promote` is the ONLY cross-key atomic operation the kernel requires. Every
+ * other write is a single put/delete. Each backend satisfies `promote` with its
+ * native atomic mechanism (LevelDB batch, SQLite transaction, IndexedDB
+ * readwrite transaction, filesystem rename); the kernel never assumes an
+ * atomicity a backend cannot deliver.
+ */
+export interface RawStoreDriver {
+    getMetadata(blockId: BlockId): Promise<Uint8Array | undefined>;
+    putMetadata(blockId: BlockId, value: Uint8Array): Promise<void>;
+    getRevision(blockId: BlockId, rev: number): Promise<Uint8Array | undefined>;
+    putRevision(blockId: BlockId, rev: number, value: Uint8Array): Promise<void>;
+    /**
+     * Yield `[rev, value]` for every present rev in `[lo, hi]` (both inclusive),
+     * ascending when `reverse` is false, descending when `reverse` is true. The
+     * driver MUST drain any native cursor into memory before yielding — see the
+     * "drain-before-yield" contract above.
+     */
+    rangeRevisions(blockId: BlockId, lo: number, hi: number, reverse: boolean): AsyncIterable<[number, Uint8Array]>;
+    getPending(blockId: BlockId, actionId: ActionId): Promise<Uint8Array | undefined>;
+    putPending(blockId: BlockId, actionId: ActionId, value: Uint8Array): Promise<void>;
+    deletePending(blockId: BlockId, actionId: ActionId): Promise<void>;
+    /** Yield each present pending actionId for the block. MUST drain before yielding (see above). */
+    listPendingActionIds(blockId: BlockId): AsyncIterable<ActionId>;
+    getTransaction(blockId: BlockId, actionId: ActionId): Promise<Uint8Array | undefined>;
+    putTransaction(blockId: BlockId, actionId: ActionId, value: Uint8Array): Promise<void>;
+    getMaterialized(blockId: BlockId, actionId: ActionId): Promise<Uint8Array | undefined>;
+    putMaterialized(blockId: BlockId, actionId: ActionId, value: Uint8Array): Promise<void>;
+    deleteMaterialized(blockId: BlockId, actionId: ActionId): Promise<void>;
+    /**
+     * Atomically move `pending(blockId, actionId)` → `transactions(blockId, actionId)`:
+     * write the transactions entry and remove the pending entry as one indivisible
+     * step (batch / DB transaction / rename). A crash must leave exactly one of the
+     * two states, never both/neither. Throw
+     * `Pending action <actionId> not found for block <blockId>` when no pending
+     * entry exists. This is the ONLY cross-key atomic operation the kernel requires.
+     */
+    promote(blockId: BlockId, actionId: ActionId): Promise<void>;
+    /** Optional — enumerate block ids with durable metadata (startup seed). Passed through by the kernel. */
+    listBlockIds?(): AsyncIterable<BlockId>;
+    /** Optional — best cheap byte estimate. Passed through by the kernel. */
+    approximateBytesUsed?(): Promise<number>;
+    /** Optional — release the underlying handle. */
+    close?(): Promise<void>;
+}
+//# sourceMappingURL=raw-store-driver.d.ts.map

package/dist/src/storage/raw-store-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-store-driver.d.ts","sourceRoot":"","sources":["../../../src/storage/raw-store-driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,WAAW,cAAc;IAE9B,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IAC/D,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAGhE,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IAC5E,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E;;;;;OAKG;IACH,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,aAAa,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IAGhH,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IAClF,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnF,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,iGAAiG;IACjG,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAGhE,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IACtF,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAGvF,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IACvF,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxF,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExE;;;;;;;OAOG;IACH,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7D,yGAAyG;IACzG,YAAY,CAAC,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;IACxC,yEAAyE;IACzE,oBAAoB,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,gDAAgD;IAChD,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}

package/dist/src/storage/raw-store-driver.js

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

package/dist/src/storage/raw-store-driver.js.map

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

package/dist/src/storage/restoration-coordinator-v2.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"restoration-coordinator-v2.d.ts","sourceRoot":"","sources":["../../../src/storage/restoration-coordinator-v2.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGxE;;;;;;;;GAQG;AACH,qBAAa,sBAAsB;IASjC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,iFAAiF;IACjF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;IAZ7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAKtB;gBAGgB,WAAW,EAAE,oBAAoB,EACjC,WAAW,EAAE,YAAY,EACzB,cAAc,EAAE,MAAM;IACvC,iFAAiF;IAChE,UAAU,CAAC,EAAE,MAAM,YAAA;IAGrC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAsC;IAE1D;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAkDhF;;OAEG;IACH,qBAAqB,IAAI,eAAe;IAMxC;;OAEG;YACW,cAAc;IAM5B;;OAEG;IACH,OAAO,CAAC,cAAc;IAKtB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAczB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAmB1B;;OAEG;YACW,SAAS;IAiBvB;;OAEG;IACH,OAAO,CAAC,aAAa;IAerB;;OAEG;IACH,UAAU,IAAI;QACb,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnC,iBAAiB,EAAE,MAAM,CAAC;KAC1B;CAGD"}
+{"version":3,"file":"restoration-coordinator-v2.d.ts","sourceRoot":"","sources":["../../../src/storage/restoration-coordinator-v2.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGxE;;;;;;;;GAQG;AACH,qBAAa,sBAAsB;IASjC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,iFAAiF;IACjF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;IAZ7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAKtB;gBAGgB,WAAW,EAAE,oBAAoB,EACjC,WAAW,EAAE,YAAY,EACzB,cAAc,EAAE,MAAM;IACvC,iFAAiF;IAChE,UAAU,CAAC,EAAE,MAAM,YAAA;IAGrC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAsC;IAE1D;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAkDhF;;OAEG;IACH,qBAAqB,IAAI,eAAe;IAMxC;;OAEG;YACW,cAAc;IAM5B;;OAEG;IACH,OAAO,CAAC,cAAc;IAKtB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAczB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAmB1B;;OAEG;YACW,SAAS;IAiBvB;;OAEG;IACH,OAAO,CAAC,aAAa;IAarB;;OAEG;IACH,UAAU,IAAI;QACb,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnC,iBAAiB,EAAE,MAAM,CAAC;KAC1B;CAGD"}

package/dist/src/storage/restoration-coordinator-v2.js

@@ -160,7 +160,7 @@ export class RestorationCoordinator {
             .reduce((sum, c) => sum + c, 0);
         const prevTotal = this.metrics.averageDurationMs * (totalSuccesses - 1);
         this.metrics.averageDurationMs = (prevTotal + durationMs) / totalSuccesses;
-        console.log(`[Ring ${ringDepth}] Successfully restored block ${blockId} in ${durationMs}ms`);
+        this.log('[Ring %d] Successfully restored block %s in %dms', ringDepth, blockId, durationMs);
     }
     /**
      * Get restoration metrics for monitoring.