@optimystic/db-p2p 0.0.1

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

@@ -0,0 +1,23 @@
+import type { IRawStorage } from './i-raw-storage.js';
+export interface StorageCapacity {
+    total: number;
+    used: number;
+    available: number;
+}
+export interface StorageMonitorConfig {
+    totalBytes?: number;
+    usedBytes?: number;
+    availableBytes?: number;
+}
+/**
+ * Monitors storage capacity for ring selection.
+ * Provides estimates based on storage backend or supplied overrides.
+ */
+export declare class StorageMonitor {
+    private readonly storage;
+    private readonly config;
+    constructor(storage: IRawStorage, config?: StorageMonitorConfig);
+    getCapacity(): Promise<StorageCapacity>;
+    private estimateUsedSpace;
+}
+//# sourceMappingURL=storage-monitor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage-monitor.d.ts","sourceRoot":"","sources":["../../../src/storage/storage-monitor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,qBAAa,cAAc;IAEzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,OAAO,EAAE,WAAW,EACpB,MAAM,GAAE,oBAAyB;IAG7C,WAAW,IAAI,OAAO,CAAC,eAAe,CAAC;YA8B/B,iBAAiB;CAG/B"}

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

@@ -0,0 +1,40 @@
+/**
+ * Monitors storage capacity for ring selection.
+ * Provides estimates based on storage backend or supplied overrides.
+ */
+export class StorageMonitor {
+    storage;
+    config;
+    constructor(storage, config = {}) {
+        this.storage = storage;
+        this.config = config;
+    }
+    async getCapacity() {
+        const defaultTotal = 10 * 1024 * 1024 * 1024; // 10GB default
+        const total = this.config.totalBytes ?? defaultTotal;
+        const usedOverride = this.config.usedBytes;
+        const availableOverride = this.config.availableBytes;
+        if (usedOverride !== undefined ||
+            availableOverride !== undefined ||
+            this.config.totalBytes !== undefined) {
+            const used = usedOverride ?? Math.max(0, total - (availableOverride ?? total));
+            const available = availableOverride ?? Math.max(0, total - used);
+            return {
+                total,
+                used: Math.min(total, Math.max(0, used)),
+                available: Math.max(0, Math.min(total, available))
+            };
+        }
+        const used = await this.estimateUsedSpace();
+        const available = Math.max(0, total - used);
+        return {
+            total,
+            used,
+            available
+        };
+    }
+    async estimateUsedSpace() {
+        return 0; // TODO: Implement actual space calculation
+    }
+}
+//# sourceMappingURL=storage-monitor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage-monitor.js","sourceRoot":"","sources":["../../../src/storage/storage-monitor.ts"],"names":[],"mappings":"AAcA;;;GAGG;AACH,MAAM,OAAO,cAAc;IAER;IACA;IAFlB,YACkB,OAAoB,EACpB,SAA+B,EAAE;QADjC,YAAO,GAAP,OAAO,CAAa;QACpB,WAAM,GAAN,MAAM,CAA2B;IAChD,CAAC;IAEJ,KAAK,CAAC,WAAW;QAChB,MAAM,YAAY,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,eAAe;QAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,YAAY,CAAC;QACrD,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;QAC3C,MAAM,iBAAiB,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC;QAErD,IACC,YAAY,KAAK,SAAS;YAC1B,iBAAiB,KAAK,SAAS;YAC/B,IAAI,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,EACnC,CAAC;YACF,MAAM,IAAI,GAAG,YAAY,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,iBAAiB,IAAI,KAAK,CAAC,CAAC,CAAC;YAC/E,MAAM,SAAS,GAAG,iBAAiB,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,CAAC;YACjE,OAAO;gBACN,KAAK;gBACL,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;gBACxC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;aAClD,CAAC;QACH,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,CAAC;QAE5C,OAAO;YACN,KAAK;YACL,IAAI;YACJ,SAAS;SACT,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,iBAAiB;QAC9B,OAAO,CAAC,CAAC,CAAC,2CAA2C;IACtD,CAAC;CACD"}

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

@@ -0,0 +1,17 @@
+import type { IRepo, MessageOptions, BlockId, CommitRequest, CommitResult, GetBlockResults, PendRequest, PendResult, ActionBlocks, BlockGets, PendValidationHook } from "@optimystic/db-core";
+import type { IBlockStorage } from "./i-block-storage.js";
+export type StorageRepoOptions = {
+    /** Optional hook to validate transactions in PendRequests */
+    validatePend?: PendValidationHook;
+};
+export declare class StorageRepo implements IRepo {
+    private readonly createBlockStorage;
+    private readonly validatePend?;
+    constructor(createBlockStorage: (blockId: BlockId) => IBlockStorage, options?: StorageRepoOptions);
+    get({ blockIds, context }: BlockGets, options?: MessageOptions): Promise<GetBlockResults>;
+    pend(request: PendRequest, _options?: MessageOptions): Promise<PendResult>;
+    cancel(actionRef: ActionBlocks, _options?: MessageOptions): Promise<void>;
+    commit(request: CommitRequest, options?: MessageOptions): Promise<CommitResult>;
+    private internalCommit;
+}
+//# sourceMappingURL=storage-repo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage-repo.d.ts","sourceRoot":"","sources":["../../../src/storage/storage-repo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EACzG,SAAS,EAGnB,kBAAkB,EAClB,MAAM,qBAAqB,CAAC;AAM7B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,MAAM,kBAAkB,GAAG;IAChC,6DAA6D;IAC7D,YAAY,CAAC,EAAE,kBAAkB,CAAC;CAClC,CAAC;AAEF,qBAAa,WAAY,YAAW,KAAK;IAIvC,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IAHpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAqB;gBAGjC,kBAAkB,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,aAAa,EACxE,OAAO,CAAC,EAAE,kBAAkB;IAKvB,GAAG,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAoDzF,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IA+F1E,MAAM,CAAC,SAAS,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzE,MAAM,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;YAmFvE,cAAc;CAmC5B"}

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

@@ -0,0 +1,267 @@
+import { Latches, transformForBlockId, applyTransform, groupBy, concatTransform, emptyTransforms, blockIdsForTransforms, transformsFromTransform } from "@optimystic/db-core";
+import { asyncIteratorToArray } from "../it-utility.js";
+export class StorageRepo {
+    createBlockStorage;
+    validatePend;
+    constructor(createBlockStorage, options) {
+        this.createBlockStorage = createBlockStorage;
+        this.validatePend = options?.validatePend;
+    }
+    async get({ blockIds, context }, options) {
+        const distinctBlockIds = Array.from(new Set(blockIds));
+        const results = await Promise.all(distinctBlockIds.map(async (blockId) => {
+            const blockStorage = this.createBlockStorage(blockId);
+            // Ensure that all outstanding transactions in the context are committed
+            if (context) {
+                const latest = await blockStorage.getLatest();
+                const missing = latest
+                    ? context.committed.filter(c => c.rev > latest.rev)
+                    : context.committed;
+                for (const { actionId, rev } of missing.sort((a, b) => a.rev - b.rev)) {
+                    const pending = await blockStorage.getPendingTransaction(actionId);
+                    if (pending) {
+                        await this.internalCommit(blockId, actionId, rev, blockStorage);
+                    }
+                }
+            }
+            const blockRev = await blockStorage.getBlock(context?.rev);
+            if (!blockRev) {
+                return [blockId, { state: {} }];
+            }
+            // Include pending action if requested
+            if (context?.actionId !== undefined) {
+                const pendingTransform = await blockStorage.getPendingTransaction(context.actionId);
+                if (!pendingTransform) {
+                    throw new Error(`Pending action ${context.actionId} not found`);
+                }
+                const block = applyTransform(blockRev.block, pendingTransform);
+                return [blockId, {
+                        block,
+                        state: {
+                            latest: await blockStorage.getLatest(),
+                            pendings: [context.actionId]
+                        }
+                    }];
+            }
+            const pendings = await asyncIteratorToArray(blockStorage.listPendingTransactions());
+            return [blockId, {
+                    block: blockRev.block,
+                    state: {
+                        latest: await blockStorage.getLatest(),
+                        pendings
+                    }
+                }];
+        }));
+        return Object.fromEntries(results);
+    }
+    async pend(request, _options) {
+        // Validate transaction if present and validation hook is configured
+        if (this.validatePend && request.transaction && request.operationsHash) {
+            const validationResult = await this.validatePend(request.transaction, request.operationsHash);
+            if (!validationResult.valid) {
+                return {
+                    success: false,
+                    reason: validationResult.reason ?? 'Transaction validation failed'
+                };
+            }
+        }
+        const blockIds = blockIdsForTransforms(request.transforms);
+        const pendings = [];
+        const missing = [];
+        // Potential race condition: A concurrent commit operation could complete
+        // between the conflict checks (latest.rev, listPendingTransactions) and the
+        // savePendingTransaction call below. This pend operation might succeed based on
+        // stale information, but the subsequent commit for this pend would likely
+        // fail correctly later if a conflict arose. Locking here could make the initial
+        // check more accurate but adds overhead. The current approach prioritizes
+        // letting the commit be the final arbiter.
+        for (const blockId of blockIds) {
+            const blockStorage = this.createBlockStorage(blockId);
+            const transforms = transformForBlockId(request.transforms, blockId);
+            // First handle any pending actions
+            const pending = await asyncIteratorToArray(blockStorage.listPendingTransactions());
+            pendings.push(...pending.map(actionId => ({ blockId, actionId })));
+            // Handle any conflicting revisions
+            if (request.rev !== undefined || transforms.insert) {
+                const latest = await blockStorage.getLatest();
+                if (latest && latest.rev >= (request.rev ?? 0)) {
+                    const transforms = await asyncIteratorToArray(blockStorage.listRevisions(request.rev ?? 0, latest.rev));
+                    for (const actionRev of transforms) {
+                        const transform = await blockStorage.getTransaction(actionRev.actionId);
+                        if (!transform) {
+                            throw new Error(`Missing action ${actionRev.actionId} for block ${blockId}`);
+                        }
+                        missing.push({
+                            actionId: actionRev.actionId,
+                            rev: actionRev.rev,
+                            transforms: transformsFromTransform(transform, blockId)
+                        });
+                    }
+                }
+            }
+        }
+        if (missing.length) {
+            return {
+                success: false,
+                missing
+            };
+        }
+        if (pendings.length > 0) {
+            if (request.policy === 'f') { // Fail on pending actions
+                return { success: false, pending: pendings };
+            }
+            else if (request.policy === 'r') { // Return populated pending actions
+                return {
+                    success: false,
+                    pending: await Promise.all(pendings.map(async (action) => {
+                        const blockStorage = this.createBlockStorage(action.blockId);
+                        return {
+                            blockId: action.blockId,
+                            actionId: action.actionId,
+                            transform: (await blockStorage.getPendingTransaction(action.actionId))
+                                ?? (await blockStorage.getTransaction(action.actionId)) // Possible that since enumeration, the action has been promoted
+                        };
+                    }))
+                };
+            }
+        }
+        // Simultaneously save pending action for each block
+        // Note: that this is not atomic, after we checked for conflicts and pending actions
+        // new pending or committed actions may have been added.  This is okay, because
+        // this check during pend is conservative.
+        await Promise.all(blockIds.map(blockId => {
+            const blockStorage = this.createBlockStorage(blockId);
+            const blockTransform = transformForBlockId(request.transforms, blockId);
+            return blockStorage.savePendingTransaction(request.actionId, blockTransform);
+        }));
+        return {
+            success: true,
+            pending: pendings,
+            blockIds
+        };
+    }
+    async cancel(actionRef, _options) {
+        await Promise.all(actionRef.blockIds.map(blockId => {
+            const blockStorage = this.createBlockStorage(blockId);
+            return blockStorage.deletePendingTransaction(actionRef.actionId);
+        }));
+    }
+    async commit(request, options) {
+        const uniqueBlockIds = Array.from(new Set(request.blockIds)).sort();
+        const releases = [];
+        try {
+            // Acquire locks sequentially based on sorted IDs to prevent deadlocks
+            for (const id of uniqueBlockIds) {
+                const lockId = `StorageRepo.commit:${id}`;
+                const release = await Latches.acquire(lockId);
+                releases.push(release);
+            }
+            // --- Start of Critical Section ---
+            const blockStorages = request.blockIds.map(blockId => ({
+                blockId,
+                storage: this.createBlockStorage(blockId)
+            }));
+            // Check for stale revisions and collect missing actions
+            const missedCommits = [];
+            for (const { blockId, storage } of blockStorages) {
+                const latest = await storage.getLatest();
+                if (latest && latest.rev >= request.rev) {
+                    const transforms = [];
+                    for await (const actionRev of storage.listRevisions(request.rev, latest.rev)) {
+                        const transform = await storage.getTransaction(actionRev.actionId);
+                        if (!transform) {
+                            throw new Error(`Missing action ${actionRev.actionId} for block ${blockId}`);
+                        }
+                        transforms.push({
+                            actionId: actionRev.actionId,
+                            rev: actionRev.rev,
+                            transform
+                        });
+                    }
+                    missedCommits.push({ blockId, transforms }); // Push, even if transforms is empty, because we want to reject the older version
+                }
+            }
+            if (missedCommits.length) {
+                return {
+                    success: false,
+                    missing: perBlockActionTransformsToPerAction(missedCommits)
+                };
+            }
+            // Check for missing pending actions
+            const missingPends = [];
+            for (const { blockId, storage } of blockStorages) {
+                const pendingAction = await storage.getPendingTransaction(request.actionId);
+                if (!pendingAction) {
+                    missingPends.push({ blockId, actionId: request.actionId });
+                }
+            }
+            if (missingPends.length) {
+                throw new Error(`Pending action ${request.actionId} not found for block(s): ${missingPends.map(p => p.blockId).join(', ')}`);
+            }
+            // Commit the action for each block
+            // This loop will execute atomically for all blocks due to the acquired locks
+            for (const { blockId, storage } of blockStorages) {
+                try {
+                    // internalCommit will throw if it encounters an issue
+                    await this.internalCommit(blockId, request.actionId, request.rev, storage);
+                }
+                catch (err) {
+                    // TODO: Recover as best we can. Rollback or handle partial commit? For now, return failure.
+                    return {
+                        success: false,
+                        reason: err instanceof Error ? err.message : 'Unknown error during commit'
+                    };
+                }
+            }
+        }
+        finally {
+            // Release locks in reverse order of acquisition
+            releases.reverse().forEach(release => release());
+        }
+        return { success: true };
+    }
+    async internalCommit(blockId, actionId, rev, storage) {
+        // Note: This method is called within the locked critical section of commit()
+        // So, operations like getPendingTransaction, getLatest, getBlock, saveMaterializedBlock,
+        // saveRevision, promotePendingTransaction, setLatest are protected against
+        // concurrent commits for the *same blockId*.
+        const transform = await storage.getPendingTransaction(actionId);
+        // No need to check if !transform here, as the caller (commit) already verified this.
+        // If it's null here, it indicates a logic error or race condition bypassed the lock (unlikely).
+        if (!transform) {
+            throw new Error(`Consistency Error: Pending action ${actionId} disappeared for block ${blockId} within critical section.`);
+        }
+        // Get prior materialized block if it exists
+        const latest = await storage.getLatest();
+        const priorBlock = latest
+            ? (await storage.getBlock(latest.rev))?.block
+            : undefined;
+        // Apply transform and save materialized block
+        // applyTransform handles undefined priorBlock correctly for inserts
+        const newBlock = applyTransform(priorBlock, transform);
+        if (newBlock) {
+            await storage.saveMaterializedBlock(actionId, newBlock);
+        }
+        // Save revision and promote action *before* updating latest
+        // This ensures that if the process crashes between these steps,
+        // the 'latest' pointer doesn't point to a revision that hasn't been fully recorded.
+        await storage.saveRevision(rev, actionId);
+        await storage.promotePendingTransaction(actionId);
+        // Update latest revision *last*
+        await storage.setLatest({ actionId, rev });
+    }
+}
+/** Converts list of missing actions per block into a list of missing actions across blocks. */
+function perBlockActionTransformsToPerAction(missing) {
+    const missingFlat = missing.flatMap(({ blockId, transforms }) => transforms.map(transform => ({ blockId, transform })));
+    const missingByActionId = groupBy(missingFlat, ({ transform }) => transform.actionId);
+    return Object.entries(missingByActionId).map(([actionId, items]) => items.reduce((acc, { blockId, transform }) => {
+        concatTransform(acc.transforms, blockId, transform.transform);
+        return acc;
+    }, {
+        actionId: actionId,
+        rev: items[0].transform.rev, // Assumption: all missing actionIds share the same revision
+        transforms: emptyTransforms()
+    }));
+}
+//# sourceMappingURL=storage-repo.js.map

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

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

package/dist/src/storage/struct.d.ts

@@ -0,0 +1,29 @@
+import type { BlockId, IBlock, ActionId, ActionRev, ActionTransform, ActionTransforms } from "@optimystic/db-core";
+export type RevisionRange = [
+    /** Inclusive start */
+    startRev: number,
+    /** Exclusive end, or open-ended if undefined */
+    endRev?: number
+];
+export type BlockMetadata = {
+    ranges: RevisionRange[];
+    /** Latest revision - present if the repo is not empty */
+    latest?: ActionRev;
+};
+export type ArchiveRevisions = Record<number, {
+    action: ActionTransform;
+    block?: IBlock;
+}>;
+export type BlockArchive = {
+    blockId: BlockId;
+    /** Revisions in this archive */
+    revisions: ArchiveRevisions;
+    /** Explicit range covered by this archive since revisions may be sparse */
+    range: RevisionRange;
+    /** Pending actions - present if this range is open-ended */
+    pending?: Record<ActionId, ActionTransforms>;
+};
+/** Should return a BlockRepo with the given rev (materialized) if given,
+ * else (no rev) at least the latest revision and any given pending transactions */
+export type RestoreCallback = (blockId: BlockId, rev?: number) => Promise<BlockArchive | undefined>;
+//# sourceMappingURL=struct.d.ts.map

package/dist/src/storage/struct.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"struct.d.ts","sourceRoot":"","sources":["../../../src/storage/struct.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEnH,MAAM,MAAM,aAAa,GAAG;IAC3B,sBAAsB;IACtB,QAAQ,EAAE,MAAM;IAChB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM;CACf,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAE3B,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,yDAAyD;IACzD,MAAM,CAAC,EAAE,SAAS,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE3F,MAAM,MAAM,YAAY,GAAG;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,gCAAgC;IAChC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,2EAA2E;IAC3E,KAAK,EAAE,aAAa,CAAC;IACrB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;CAC7C,CAAA;AAED;mFACmF;AACnF,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC"}

package/dist/src/storage/struct.js

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

package/dist/src/storage/struct.js.map

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

package/dist/src/sync/client.d.ts

@@ -0,0 +1,27 @@
+import type { PeerId } from '@libp2p/interface';
+import type { IPeerNetwork } from '@optimystic/db-core';
+import { ProtocolClient } from '../protocol-client.js';
+import { type SyncRequest, type SyncResponse } from './protocol.js';
+/**
+ * Client for sending sync requests to remote peers.
+ *
+ * Used by storage tiers to request missing blocks from other nodes in the network.
+ * Extends ProtocolClient for consistent error handling and timeout behavior.
+ */
+export declare class SyncClient extends ProtocolClient {
+    private readonly protocol;
+    constructor(peerId: PeerId, peerNetwork: IPeerNetwork, protocolPrefix?: string);
+    /**
+     * Request a block from the remote peer.
+     *
+     * @param request - Sync request specifying block and options
+     * @returns Response with archive if successful
+     * @throws Error if request fails or times out
+     */
+    requestBlock(request: SyncRequest): Promise<SyncResponse>;
+    /**
+     * Get the protocol string used by this client.
+     */
+    getProtocol(): string;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/src/sync/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/sync/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAqB,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAEvF;;;;;GAKG;AACH,qBAAa,UAAW,SAAQ,cAAc;IAC7C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAGjC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,YAAY,EACzB,cAAc,GAAE,MAAW;IAM5B;;;;;;OAMG;IACG,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAI/D;;OAEG;IACH,WAAW,IAAI,MAAM;CAGrB"}

package/dist/src/sync/client.js

@@ -0,0 +1,32 @@
+import { ProtocolClient } from '../protocol-client.js';
+import { buildSyncProtocol } from './protocol.js';
+/**
+ * Client for sending sync requests to remote peers.
+ *
+ * Used by storage tiers to request missing blocks from other nodes in the network.
+ * Extends ProtocolClient for consistent error handling and timeout behavior.
+ */
+export class SyncClient extends ProtocolClient {
+    protocol;
+    constructor(peerId, peerNetwork, protocolPrefix = '') {
+        super(peerId, peerNetwork);
+        this.protocol = buildSyncProtocol(protocolPrefix);
+    }
+    /**
+     * Request a block from the remote peer.
+     *
+     * @param request - Sync request specifying block and options
+     * @returns Response with archive if successful
+     * @throws Error if request fails or times out
+     */
+    async requestBlock(request) {
+        return await this.processMessage(request, this.protocol);
+    }
+    /**
+     * Get the protocol string used by this client.
+     */
+    getProtocol() {
+        return this.protocol;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/src/sync/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/sync/client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAuC,MAAM,eAAe,CAAC;AAEvF;;;;;GAKG;AACH,MAAM,OAAO,UAAW,SAAQ,cAAc;IAC5B,QAAQ,CAAS;IAElC,YACC,MAAc,EACd,WAAyB,EACzB,iBAAyB,EAAE;QAE3B,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,iBAAiB,CAAC,cAAc,CAAC,CAAC;IACnD,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,YAAY,CAAC,OAAoB;QACtC,OAAO,MAAM,IAAI,CAAC,cAAc,CAAe,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxE,CAAC;IAED;;OAEG;IACH,WAAW;QACV,OAAO,IAAI,CAAC,QAAQ,CAAC;IACtB,CAAC;CACD"}

package/dist/src/sync/protocol.d.ts

@@ -0,0 +1,58 @@
+import type { BlockId } from '@optimystic/db-core';
+import type { BlockArchive } from '../storage/struct.js';
+/**
+ * Request to sync a specific block or revision from a peer.
+ *
+ * This protocol is used for block restoration across storage tiers,
+ * allowing nodes to request missing blocks from cluster peers or storage rings.
+ */
+export interface SyncRequest {
+    /** Block ID to retrieve */
+    blockId: BlockId;
+    /**
+     * Optional specific revision to retrieve.
+     * If undefined, retrieve the latest available revision.
+     */
+    rev?: number;
+    /**
+     * If true, include pending transactions in the response.
+     * Typically true when requesting latest state, false for historical revisions.
+     */
+    includePending?: boolean;
+    /**
+     * Maximum number of revisions to return.
+     * Prevents excessive response sizes.
+     * @default 100
+     */
+    maxRevisions?: number;
+    /**
+     * Optional hint about which tier is requesting (for logging/metrics).
+     * Values: 'ring-zulu', 'ring-0', 'ring-N', etc.
+     */
+    requestingTier?: string;
+}
+/**
+ * Response containing block archive data.
+ */
+export interface SyncResponse {
+    /** True if the peer has the requested data */
+    success: boolean;
+    /** Block archive if found */
+    archive?: BlockArchive;
+    /** Error message if unsuccessful */
+    error?: string;
+    /** Peer ID of responder (for tracking/metrics) */
+    responderId?: string;
+}
+/** Sync protocol prefix - namespaced under db-p2p */
+export declare const SYNC_PROTOCOL_PREFIX = "/db-p2p/sync/";
+/** Sync protocol version */
+export declare const SYNC_PROTOCOL_VERSION = "1.0.0";
+/**
+ * Builds the full protocol string for the sync protocol.
+ *
+ * @param protocolPrefix - Optional prefix (e.g., '/optimystic/testnet')
+ * @returns Full protocol string
+ */
+export declare const buildSyncProtocol: (protocolPrefix?: string) => string;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/src/sync/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../src/sync/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC3B,2BAA2B;IAC3B,OAAO,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAC;IAEjB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,YAAY,CAAC;IAEvB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qDAAqD;AACrD,eAAO,MAAM,oBAAoB,kBAAkB,CAAC;AAEpD,4BAA4B;AAC5B,eAAO,MAAM,qBAAqB,UAAU,CAAC;AAE7C;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,iBAAgB,MAAW,KAAG,MACG,CAAC"}

package/dist/src/sync/protocol.js

@@ -0,0 +1,12 @@
+/** Sync protocol prefix - namespaced under db-p2p */
+export const SYNC_PROTOCOL_PREFIX = '/db-p2p/sync/';
+/** Sync protocol version */
+export const SYNC_PROTOCOL_VERSION = '1.0.0';
+/**
+ * Builds the full protocol string for the sync protocol.
+ *
+ * @param protocolPrefix - Optional prefix (e.g., '/optimystic/testnet')
+ * @returns Full protocol string
+ */
+export const buildSyncProtocol = (protocolPrefix = '') => `${protocolPrefix}${SYNC_PROTOCOL_PREFIX}${SYNC_PROTOCOL_VERSION}`;
+//# sourceMappingURL=protocol.js.map

package/dist/src/sync/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../../src/sync/protocol.ts"],"names":[],"mappings":"AAwDA,qDAAqD;AACrD,MAAM,CAAC,MAAM,oBAAoB,GAAG,eAAe,CAAC;AAEpD,4BAA4B;AAC5B,MAAM,CAAC,MAAM,qBAAqB,GAAG,OAAO,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,iBAAyB,EAAE,EAAU,EAAE,CACxE,GAAG,cAAc,GAAG,oBAAoB,GAAG,qBAAqB,EAAE,CAAC"}

package/dist/src/sync/service.d.ts

@@ -0,0 +1,62 @@
+import type { ComponentLogger, Startable } from '@libp2p/interface';
+import type { IRepo } from '@optimystic/db-core';
+export interface SyncServiceInit {
+    protocolPrefix?: string;
+}
+export interface SyncServiceComponents {
+    logger: ComponentLogger;
+    registrar: {
+        handle: (...args: any[]) => Promise<void>;
+        unhandle: (...args: any[]) => Promise<void>;
+    };
+    repo: IRepo;
+}
+/**
+ * Service for handling incoming sync requests from other cluster peers.
+ *
+ * Listens on the sync protocol and responds to block requests by:
+ * 1. Extracting the block from local storage
+ * 2. Building a BlockArchive with requested revisions
+ * 3. Sending the response back to the requester
+ *
+ * This is the server-side of the block restoration mechanism.
+ */
+export declare class SyncService implements Startable {
+    private readonly components;
+    private running;
+    private readonly log;
+    private readonly protocol;
+    private readonly repo;
+    private readonly registrar;
+    constructor(components: SyncServiceComponents, init?: SyncServiceInit);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /**
+     * Handle an incoming sync request stream.
+     */
+    private handleSyncRequest;
+    /**
+     * Read and parse a sync request from the stream.
+     */
+    private readRequest;
+    /**
+     * Send a sync response to the stream.
+     */
+    private sendResponse;
+    /**
+     * Build a block archive from local storage.
+     *
+     * @param blockId - Block to retrieve
+     * @param rev - Optional specific revision
+     * @param includePending - Whether to include pending transactions
+     * @param maxRevisions - Maximum number of revisions to include
+     * @returns BlockArchive if found, undefined otherwise
+     */
+    private buildArchive;
+}
+/**
+ * Factory function for creating a SyncService.
+ * Follows the libp2p service pattern.
+ */
+export declare const syncService: (init?: SyncServiceInit) => (components: SyncServiceComponents) => SyncService;
+//# sourceMappingURL=service.d.ts.map

package/dist/src/sync/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/sync/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAU,MAAM,mBAAmB,CAAC;AAC5E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAOjD,MAAM,WAAW,eAAe;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACrC,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,EAAE;QAAE,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;IACtG,IAAI,EAAE,KAAK,CAAC;CACZ;AAID;;;;;;;;;GASG;AACH,qBAAa,WAAY,YAAW,SAAS;IAQ3C,OAAO,CAAC,QAAQ,CAAC,UAAU;IAP5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAQ;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6F;gBAGrG,UAAU,EAAE,qBAAqB,EAClD,IAAI,GAAE,eAAoB;IAQrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAWtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B;;OAEG;YACW,iBAAiB;IA4D/B;;OAEG;YACW,WAAW;IAqBzB;;OAEG;YACW,YAAY;IAW1B;;;;;;;;OAQG;YACW,YAAY;CA6C1B;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,OAAM,eAAoB,MACpD,YAAY,qBAAqB,gBAAsC,CAAC"}