@optimystic/db-p2p 0.0.1

package/dist/src/cluster/partition-detector.d.ts

@@ -0,0 +1,59 @@
+export interface PeerStatus {
+    peerId: string;
+    lastSeen: number;
+    lastGoodbye?: number;
+    consecutiveFailures: number;
+}
+/**
+ * Detects potential network partitions by tracking peer health,
+ * goodbye messages, and sudden mass unreachability events.
+ */
+export declare class PartitionDetector {
+    private peerStatuses;
+    private readonly unreachableThreshold;
+    private readonly rapidChurnThreshold;
+    private readonly rapidChurnWindow;
+    private readonly peerTimeoutMs;
+    /**
+     * Record successful communication with a peer
+     */
+    recordSuccess(peerId: string): void;
+    /**
+     * Record failed communication attempt with a peer
+     */
+    recordFailure(peerId: string): void;
+    /**
+     * Record explicit goodbye message from a peer
+     */
+    recordGoodbye(peerId: string): void;
+    /**
+     * Detect if we're likely in a network partition
+     * Returns true if sudden mass unreachability or rapid goodbye rate
+     */
+    detectPartition(): boolean;
+    /**
+     * Get list of currently unreachable peers
+     */
+    getUnreachablePeers(): string[];
+    /**
+     * Get recent goodbye messages within the specified window
+     */
+    private getRecentGoodbyes;
+    /**
+     * Clean up peer records that haven't been seen recently
+     */
+    private cleanupOldPeers;
+    /**
+     * Get statistics for monitoring
+     */
+    getStatistics(): {
+        totalPeers: number;
+        unreachable: number;
+        recentGoodbyes: number;
+    };
+    /**
+     * Reset all tracked peer states (useful for testing)
+     */
+    reset(): void;
+}
+//# sourceMappingURL=partition-detector.d.ts.map

package/dist/src/cluster/partition-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"partition-detector.d.ts","sourceRoot":"","sources":["../../../src/cluster/partition-detector.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;CAC5B;AAED;;;GAGG;AACH,qBAAa,iBAAiB;IAC7B,OAAO,CAAC,YAAY,CAAsC;IAC1D,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAK;IAC1C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAK;IACzC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IAEvC;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAmBnC;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAgBnC;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAiBnC;;;OAGG;IACH,eAAe,IAAI,OAAO;IAkB1B;;OAEG;IACH,mBAAmB,IAAI,MAAM,EAAE;IAM/B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;IACH,aAAa,IAAI;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;KACvB;IAWD;;OAEG;IACH,KAAK,IAAI,IAAI;CAGb"}

package/dist/src/cluster/partition-detector.js

@@ -0,0 +1,129 @@
+/**
+ * Detects potential network partitions by tracking peer health,
+ * goodbye messages, and sudden mass unreachability events.
+ */
+export class PartitionDetector {
+    peerStatuses = new Map();
+    unreachableThreshold = 3; // consecutive failures
+    rapidChurnThreshold = 5; // peers
+    rapidChurnWindow = 10000; // 10 seconds
+    peerTimeoutMs = 60000; // 1 minute
+    /**
+     * Record successful communication with a peer
+     */
+    recordSuccess(peerId) {
+        const now = Date.now();
+        const status = this.peerStatuses.get(peerId);
+        if (status) {
+            status.lastSeen = now;
+            status.consecutiveFailures = 0;
+        }
+        else {
+            this.peerStatuses.set(peerId, {
+                peerId,
+                lastSeen: now,
+                consecutiveFailures: 0
+            });
+        }
+        // Clean up old peer records
+        this.cleanupOldPeers();
+    }
+    /**
+     * Record failed communication attempt with a peer
+     */
+    recordFailure(peerId) {
+        const now = Date.now();
+        const status = this.peerStatuses.get(peerId);
+        if (status) {
+            status.consecutiveFailures++;
+            status.lastSeen = now;
+        }
+        else {
+            this.peerStatuses.set(peerId, {
+                peerId,
+                lastSeen: now,
+                consecutiveFailures: 1
+            });
+        }
+    }
+    /**
+     * Record explicit goodbye message from a peer
+     */
+    recordGoodbye(peerId) {
+        const now = Date.now();
+        const status = this.peerStatuses.get(peerId);
+        if (status) {
+            status.lastGoodbye = now;
+            status.lastSeen = now;
+        }
+        else {
+            this.peerStatuses.set(peerId, {
+                peerId,
+                lastSeen: now,
+                lastGoodbye: now,
+                consecutiveFailures: 0
+            });
+        }
+    }
+    /**
+     * Detect if we're likely in a network partition
+     * Returns true if sudden mass unreachability or rapid goodbye rate
+     */
+    detectPartition() {
+        const now = Date.now();
+        // Count recent goodbyes
+        const recentGoodbyes = this.getRecentGoodbyes(this.rapidChurnWindow);
+        // Count unreachable peers
+        const unreachable = Array.from(this.peerStatuses.values()).filter(s => s.consecutiveFailures >= this.unreachableThreshold
+            && !s.lastGoodbye // Exclude peers that said goodbye
+        );
+        // Sudden mass unreachability suggests partition
+        const totalChurn = recentGoodbyes.length + unreachable.length;
+        return totalChurn >= this.rapidChurnThreshold;
+    }
+    /**
+     * Get list of currently unreachable peers
+     */
+    getUnreachablePeers() {
+        return Array.from(this.peerStatuses.values())
+            .filter(s => s.consecutiveFailures >= this.unreachableThreshold && !s.lastGoodbye)
+            .map(s => s.peerId);
+    }
+    /**
+     * Get recent goodbye messages within the specified window
+     */
+    getRecentGoodbyes(windowMs) {
+        const cutoff = Date.now() - windowMs;
+        return Array.from(this.peerStatuses.values()).filter(s => s.lastGoodbye && s.lastGoodbye > cutoff);
+    }
+    /**
+     * Clean up peer records that haven't been seen recently
+     */
+    cleanupOldPeers() {
+        const cutoff = Date.now() - this.peerTimeoutMs;
+        for (const [peerId, status] of this.peerStatuses.entries()) {
+            if (status.lastSeen < cutoff) {
+                this.peerStatuses.delete(peerId);
+            }
+        }
+    }
+    /**
+     * Get statistics for monitoring
+     */
+    getStatistics() {
+        const unreachable = this.getUnreachablePeers().length;
+        const recentGoodbyes = this.getRecentGoodbyes(this.rapidChurnWindow).length;
+        return {
+            totalPeers: this.peerStatuses.size,
+            unreachable,
+            recentGoodbyes
+        };
+    }
+    /**
+     * Reset all tracked peer states (useful for testing)
+     */
+    reset() {
+        this.peerStatuses.clear();
+    }
+}
+//# sourceMappingURL=partition-detector.js.map

package/dist/src/cluster/partition-detector.js.map

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

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

@@ -0,0 +1,49 @@
+import type { Startable, Logger, IncomingStreamData } from '@libp2p/interface';
+import type { ICluster } from '@optimystic/db-core';
+interface BaseComponents {
+    logger: {
+        forComponent: (name: string) => Logger;
+    };
+    registrar: {
+        handle: (protocol: string, handler: (data: IncomingStreamData) => void, options: any) => Promise<void>;
+        unhandle: (protocol: string) => Promise<void>;
+    };
+}
+export interface ClusterServiceComponents extends BaseComponents {
+    cluster: ICluster;
+}
+export interface ClusterServiceInit {
+    protocol?: string;
+    protocolPrefix?: string;
+    maxInboundStreams?: number;
+    maxOutboundStreams?: number;
+    logPrefix?: string;
+    kBucketSize?: number;
+    configuredClusterSize?: number;
+    allowClusterDownsize?: boolean;
+    clusterSizeTolerance?: number;
+}
+export declare function clusterService(init?: ClusterServiceInit): (components: ClusterServiceComponents) => ClusterService;
+/**
+ * A libp2p service that handles cluster protocol messages
+ */
+export declare class ClusterService implements Startable {
+    private readonly protocol;
+    private readonly maxInboundStreams;
+    private readonly maxOutboundStreams;
+    private readonly log;
+    private readonly cluster;
+    private readonly components;
+    private running;
+    private readonly k;
+    private readonly configuredClusterSize;
+    private readonly allowDownsize;
+    private readonly sizeTolerance;
+    constructor(components: ClusterServiceComponents, init?: ClusterServiceInit);
+    readonly [Symbol.toStringTag] = "@libp2p/cluster";
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private handleIncomingStream;
+}
+export {};
+//# sourceMappingURL=service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/cluster/service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,KAAK,EAAE,QAAQ,EAAiB,MAAM,qBAAqB,CAAC;AAOnE,UAAU,cAAc;IACvB,MAAM,EAAE;QAAE,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;KAAE,CAAC;IACnD,SAAS,EAAE;QACV,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,IAAI,EAAE,OAAO,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QACvG,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;KAC7C,CAAA;CACD;AAED,MAAM,WAAW,wBAAyB,SAAQ,cAAc;IAC/D,OAAO,EAAE,QAAQ,CAAA;CACjB;AAED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,wBAAgB,cAAc,CAAC,IAAI,GAAE,kBAAuB,GAAG,CAAC,UAAU,EAAE,wBAAwB,KAAK,cAAc,CAEtH;AAED;;GAEG;AACH,qBAAa,cAAe,YAAW,SAAS;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAW;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA2B;IACtD,OAAO,CAAC,OAAO,CAAU;IACxB,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;IAC/C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IACxC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;gBAE5B,UAAU,EAAE,wBAAwB,EAAE,IAAI,GAAE,kBAAuB;IAc/E,QAAQ,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,qBAAqB;IAE5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAatB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B,OAAO,CAAC,oBAAoB;CA+D5B"}

package/dist/src/cluster/service.js

@@ -0,0 +1,107 @@
+import { pipe } from 'it-pipe';
+import { decode as lpDecode, encode as lpEncode } from 'it-length-prefixed';
+export function clusterService(init = {}) {
+    return (components) => new ClusterService(components, init);
+}
+/**
+ * A libp2p service that handles cluster protocol messages
+ */
+export class ClusterService {
+    protocol;
+    maxInboundStreams;
+    maxOutboundStreams;
+    log;
+    cluster;
+    components;
+    running;
+    k;
+    configuredClusterSize;
+    allowDownsize;
+    sizeTolerance;
+    constructor(components, init = {}) {
+        this.components = components;
+        this.protocol = init.protocol ?? (init.protocolPrefix ?? '/db-p2p') + '/cluster/1.0.0';
+        this.maxInboundStreams = init.maxInboundStreams ?? 32;
+        this.maxOutboundStreams = init.maxOutboundStreams ?? 64;
+        this.log = components.logger.forComponent(init.logPrefix ?? 'db-p2p:cluster');
+        this.cluster = components.cluster;
+        this.running = false;
+        this.k = init.kBucketSize ?? 10;
+        this.configuredClusterSize = init.configuredClusterSize ?? 10;
+        this.allowDownsize = init.allowClusterDownsize ?? true;
+        this.sizeTolerance = init.clusterSizeTolerance ?? 0.5;
+    }
+    [Symbol.toStringTag] = '@libp2p/cluster';
+    async start() {
+        if (this.running) {
+            return;
+        }
+        await this.components.registrar.handle(this.protocol, this.handleIncomingStream.bind(this), {
+            maxInboundStreams: this.maxInboundStreams,
+            maxOutboundStreams: this.maxOutboundStreams
+        });
+        this.running = true;
+    }
+    async stop() {
+        if (!this.running) {
+            return;
+        }
+        await this.components.registrar.unhandle(this.protocol);
+        this.running = false;
+    }
+    handleIncomingStream(data) {
+        const { stream, connection } = data;
+        const peerId = connection.remotePeer;
+        const processStream = async function* (source) {
+            for await (const msg of source) {
+                // Decode the message
+                const decoded = new TextDecoder().decode(msg.subarray());
+                const message = JSON.parse(decoded);
+                // Process the operation
+                let response;
+                if (message.operation === 'update') {
+                    // Use message.record.message as key source; this is RepoMessage carrying block IDs
+                    const tailId = (message.record?.message?.commit?.tailId ?? message.record?.message?.pend) ? Object.keys(message.record.message.pend.transforms)[0] : undefined;
+                    // TEMPORARY: Disable cluster membership check to fix empty promises issue
+                    // The membership check was causing peers to return redirect responses
+                    // instead of processing cluster updates, leading to empty promise arrays.
+                    // TODO: Re-enable and fix cluster membership logic for proper DHT routing
+                    response = await this.cluster.update(message.record);
+                }
+                else {
+                    throw new Error(`Unknown operation: ${message.operation}`);
+                }
+                // Encode and yield the response
+                if (message.operation === 'update') {
+                    const rec = response;
+                    this.log('cluster-service:pre-serialize', {
+                        messageHash: rec?.messageHash,
+                        responseType: typeof response,
+                        hasPromises: 'promises' in (rec ?? {}),
+                        hasCommits: 'commits' in (rec ?? {}),
+                        promiseKeys: Object.keys(rec?.promises ?? {}),
+                        commitKeys: Object.keys(rec?.commits ?? {}),
+                        promiseValues: rec?.promises,
+                        commitValues: rec?.commits
+                    });
+                }
+                const serialized = JSON.stringify(response);
+                if (message.operation === 'update') {
+                    const deserialized = JSON.parse(serialized);
+                    this.log('cluster-service:post-serialize', {
+                        messageHash: deserialized?.messageHash,
+                        promiseKeys: Object.keys(deserialized?.promises ?? {}),
+                        commitKeys: Object.keys(deserialized?.commits ?? {})
+                    });
+                }
+                yield new TextEncoder().encode(serialized);
+            }
+        };
+        Promise.resolve().then(async () => {
+            await pipe(stream, (source) => lpDecode(source), processStream.bind(this), (source) => lpEncode(source), stream);
+        }).catch((err) => {
+            this.log.error('error handling cluster protocol message from %p - %e', peerId, err);
+        });
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/src/cluster/service.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,29 @@
+export * from "./cluster/client.js";
+export * from "./cluster/cluster-repo.js";
+export * from "./cluster/service.js";
+export * from "./protocol-client.js";
+export * from "./repo/client.js";
+export * from "./repo/cluster-coordinator.js";
+export * from "./repo/coordinator-repo.js";
+export * from "./repo/service.js";
+export * from "./storage/block-storage.js";
+export * from "./storage/file-storage.js";
+export * from "./storage/memory-storage.js";
+export * from "./storage/i-block-storage.js";
+export * from "./storage/i-raw-storage.js";
+export * from "./storage/storage-repo.js";
+export * from "./storage/restoration-coordinator-v2.js";
+export * from "./storage/ring-selector.js";
+export * from "./storage/storage-monitor.js";
+export * from "./storage/arachnode-fret-adapter.js";
+export * from "./sync/protocol.js";
+export * from "./sync/client.js";
+export * from "./sync/service.js";
+export * from "./it-utility.js";
+export * from "./libp2p-key-network.js";
+export * from "./libp2p-node.js";
+export * from "./routing/responsibility.js";
+export * from "./routing/libp2p-known-peers.js";
+export * from "./network/network-manager-service.js";
+export * from "./network/get-network-manager.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yCAAyC,CAAC;AACxD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qCAAqC,CAAC;AACpD,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,sCAAsC,CAAC;AACrD,cAAc,kCAAkC,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,29 @@
+export * from "./cluster/client.js";
+export * from "./cluster/cluster-repo.js";
+export * from "./cluster/service.js";
+export * from "./protocol-client.js";
+export * from "./repo/client.js";
+export * from "./repo/cluster-coordinator.js";
+export * from "./repo/coordinator-repo.js";
+export * from "./repo/service.js";
+export * from "./storage/block-storage.js";
+export * from "./storage/file-storage.js";
+export * from "./storage/memory-storage.js";
+export * from "./storage/i-block-storage.js";
+export * from "./storage/i-raw-storage.js";
+export * from "./storage/storage-repo.js";
+export * from "./storage/restoration-coordinator-v2.js";
+export * from "./storage/ring-selector.js";
+export * from "./storage/storage-monitor.js";
+export * from "./storage/arachnode-fret-adapter.js";
+export * from "./sync/protocol.js";
+export * from "./sync/client.js";
+export * from "./sync/service.js";
+export * from "./it-utility.js";
+export * from "./libp2p-key-network.js";
+export * from "./libp2p-node.js";
+export * from "./routing/responsibility.js";
+export * from "./routing/libp2p-known-peers.js";
+export * from "./network/network-manager-service.js";
+export * from "./network/get-network-manager.js";
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yCAAyC,CAAC;AACxD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qCAAqC,CAAC;AACpD,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,sCAAsC,CAAC;AACrD,cAAc,kCAAkC,CAAC"}

package/dist/src/it-utility.d.ts

@@ -0,0 +1,4 @@
+export declare function first<T>(createIterable: (signal: AbortSignal) => AsyncIterable<T>, onEmpty?: () => T, timeoutMs?: number): Promise<T>;
+export declare function asyncIteratorToArray<T>(iterator: AsyncIterable<T>): Promise<T[]>;
+export declare function reduce<TP, TC>(iter: IterableIterator<TC>, each: (prior: TP, current: TC, index: number) => TP, start: TP): TP;
+//# sourceMappingURL=it-utility.d.ts.map

package/dist/src/it-utility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"it-utility.d.ts","sourceRoot":"","sources":["../../src/it-utility.ts"],"names":[],"mappings":"AAAA,wBAAsB,KAAK,CAAC,CAAC,EAC5B,cAAc,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,aAAa,CAAC,CAAC,CAAC,EACzD,OAAO,GAAE,MAAM,CAA+C,EAC9D,SAAS,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,CAAC,CAAC,CAYZ;AAED,wBAAsB,oBAAoB,CAAC,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAMtF;AAED,wBAAgB,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,gBAAgB,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,MAQxH"}

package/dist/src/it-utility.js

@@ -0,0 +1,32 @@
+export async function first(createIterable, onEmpty = () => { throw new Error('No items found'); }, timeoutMs) {
+    const controller = new AbortController();
+    const timer = typeof timeoutMs === 'number' ? setTimeout(() => controller.abort(), timeoutMs) : undefined;
+    try {
+        for await (const item of createIterable(controller.signal)) {
+            return item;
+        }
+        return onEmpty();
+    }
+    finally {
+        if (timer !== undefined)
+            clearTimeout(timer);
+        controller.abort();
+    }
+}
+export async function asyncIteratorToArray(iterator) {
+    const result = [];
+    for await (const item of iterator) {
+        result.push(item);
+    }
+    return result;
+}
+export function reduce(iter, each, start) {
+    let prior = start;
+    let i = 0;
+    for (let current of iter) {
+        prior = each(prior, current, i);
+        ++i;
+    }
+    return prior;
+}
+//# sourceMappingURL=it-utility.js.map

package/dist/src/it-utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"it-utility.js","sourceRoot":"","sources":["../../src/it-utility.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,KAAK,UAAU,KAAK,CAC1B,cAAyD,EACzD,UAAmB,GAAG,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAA,CAAC,CAAC,EAC9D,SAAkB;IAElB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1G,IAAI,CAAC;QACJ,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,cAAc,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5D,OAAO,IAAI,CAAC;QACb,CAAC;QACD,OAAO,OAAO,EAAE,CAAC;IAClB,CAAC;YAAS,CAAC;QACV,IAAI,KAAK,KAAK,SAAS;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QAC7C,UAAU,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;AACF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAI,QAA0B;IACvE,MAAM,MAAM,GAAQ,EAAE,CAAC;IACvB,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC;AAED,MAAM,UAAU,MAAM,CAAS,IAA0B,EAAE,IAAmD,EAAE,KAAS;IACxH,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;QAC1B,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;QAChC,EAAE,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC"}

package/dist/src/libp2p-key-network.d.ts

@@ -0,0 +1,59 @@
+import type { AbortOptions, Libp2p, PeerId, Stream } from "@libp2p/interface";
+import type { ClusterPeers, FindCoordinatorOptions, IKeyNetwork, IPeerNetwork } from "@optimystic/db-core";
+/**
+ * Configuration options for self-coordination behavior
+ */
+export interface SelfCoordinationConfig {
+    /** Time (ms) after last connection before allowing self-coordination. Default: 30000 */
+    gracePeriodMs?: number;
+    /** Threshold for suspicious network shrinkage (0-1). >50% drop is suspicious. Default: 0.5 */
+    shrinkageThreshold?: number;
+    /** Allow self-coordination at all. Default: true (for testing). Set false in production. */
+    allowSelfCoordination?: boolean;
+}
+/**
+ * Decision result from self-coordination guard
+ */
+export interface SelfCoordinationDecision {
+    allow: boolean;
+    reason: 'bootstrap-node' | 'partition-detected' | 'suspicious-shrinkage' | 'grace-period-not-elapsed' | 'extended-isolation' | 'disabled';
+    warn?: boolean;
+}
+export declare class Libp2pKeyPeerNetwork implements IKeyNetwork, IPeerNetwork {
+    private readonly libp2p;
+    private readonly clusterSize;
+    private readonly selfCoordinationConfig;
+    private networkHighWaterMark;
+    private lastConnectedTime;
+    constructor(libp2p: Libp2p, clusterSize?: number, selfCoordinationConfig?: SelfCoordinationConfig);
+    private readonly coordinatorCache;
+    private static readonly MAX_CACHE_ENTRIES;
+    private readonly log;
+    private toCacheKey;
+    /**
+     * Set up connection event tracking to update high water mark and last connected time.
+     */
+    private setupConnectionTracking;
+    /**
+     * Update network high water mark and last connected time.
+     * Called on new connections.
+     */
+    private updateNetworkObservations;
+    /**
+     * Determine if self-coordination should be allowed based on network observations.
+     *
+     * Principle: If we've ever seen a larger network, assume our connectivity is the problem,
+     * not the network shrinking.
+     */
+    shouldAllowSelfCoordination(): SelfCoordinationDecision;
+    recordCoordinator(key: Uint8Array, peerId: PeerId, ttlMs?: number): void;
+    private getCachedCoordinator;
+    connect(peerId: PeerId, protocol: string, _options?: AbortOptions): Promise<Stream>;
+    private getFret;
+    private getNeighborIdsForKey;
+    findCoordinator(key: Uint8Array, _options?: Partial<FindCoordinatorOptions>): Promise<PeerId>;
+    private getConnectedAddrsByPeer;
+    private parseMultiaddrs;
+    findCluster(key: Uint8Array): Promise<ClusterPeers>;
+}
+//# sourceMappingURL=libp2p-key-network.d.ts.map

package/dist/src/libp2p-key-network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"libp2p-key-network.d.ts","sourceRoot":"","sources":["../../src/libp2p-key-network.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE9E,OAAO,KAAK,EAAE,YAAY,EAAE,sBAAsB,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAS3G;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC,wFAAwF;IACxF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8FAA8F;IAC9F,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,4FAA4F;IAC5F,qBAAqB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACxC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,gBAAgB,GAAG,oBAAoB,GAAG,sBAAsB,GAAG,0BAA0B,GAAG,oBAAoB,GAAG,UAAU,CAAC;IAC1I,IAAI,CAAC,EAAE,OAAO,CAAC;CACf;AAED,qBAAa,oBAAqB,YAAW,WAAW,EAAE,YAAY;IAMpE,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAN7B,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAmC;IAC1E,OAAO,CAAC,oBAAoB,CAAK;IACjC,OAAO,CAAC,iBAAiB,CAAc;gBAGrB,MAAM,EAAE,MAAM,EACd,WAAW,GAAE,MAAW,EACzC,sBAAsB,CAAC,EAAE,sBAAsB;IAWhD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAqD;IACtF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAO;IAChD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqC;IAEzD,OAAO,CAAC,UAAU;IAElB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAM/B;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IAwBjC;;;;;OAKG;IACH,2BAA2B,IAAI,wBAAwB;IAwDhD,iBAAiB,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,SAAiB,GAAG,IAAI;IAcvF,OAAO,CAAC,oBAAoB;IAQ5B,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IASnF,OAAO,CAAC,OAAO;YAMD,oBAAoB;IAO5B,eAAe,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAiFnG,OAAO,CAAC,uBAAuB;IAW/B,OAAO,CAAC,eAAe;IAQjB,WAAW,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC;CAiCzD"}