@brightchain/brightchain-api-lib 0.0.1

package/src/lib/availability/heartbeatMonitor.js

@@ -0,0 +1,375 @@
+"use strict";
+/**
+ * @fileoverview Heartbeat Monitor Implementation
+ *
+ * Implements peer connectivity monitoring through periodic heartbeat messages.
+ * Detects network partitions when all peers become unreachable and
+ * triggers reconnection events when peers become available again.
+ *
+ * @see Requirements 7.1, 7.2, 7.5, 7.6
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HeartbeatMonitor = exports.DEFAULT_HEARTBEAT_CONFIG = void 0;
+// Re-export DEFAULT_HEARTBEAT_CONFIG from brightchain-lib for convenience
+var brightchain_lib_1 = require("@brightchain/brightchain-lib");
+Object.defineProperty(exports, "DEFAULT_HEARTBEAT_CONFIG", { enumerable: true, get: function () { return brightchain_lib_1.DEFAULT_HEARTBEAT_CONFIG; } });
+/**
+ * Default heartbeat configuration values (local copy for use in this module).
+ */
+const defaultHeartbeatConfig = {
+    intervalMs: 5000,
+    timeoutMs: 2000,
+    missedThreshold: 3,
+};
+/**
+ * Heartbeat Monitor Implementation
+ *
+ * Monitors peer connectivity using periodic heartbeat messages.
+ * Detects network partitions when all peers become unreachable and
+ * triggers reconnection events when peers become available again.
+ *
+ * @see Requirements 7.1, 7.2, 7.5, 7.6
+ */
+class HeartbeatMonitor {
+    /**
+     * Create a new HeartbeatMonitor.
+     *
+     * @param transport - Transport for sending heartbeat pings
+     * @param config - Heartbeat configuration (uses defaults if not provided)
+     */
+    constructor(transport, config = defaultHeartbeatConfig) {
+        this.transport = transport;
+        this.config = config;
+        /**
+         * Map of peer ID to heartbeat state.
+         */
+        this.peerStates = new Map();
+        /**
+         * Registered connectivity event handlers.
+         */
+        this.handlers = new Set();
+        /**
+         * Heartbeat interval timer handle.
+         */
+        this.heartbeatTimer = null;
+        /**
+         * Whether the monitor is currently running.
+         */
+        this.running = false;
+        /**
+         * Whether we are currently in a partition state (all peers unreachable).
+         */
+        this.inPartition = false;
+    }
+    /**
+     * Start the heartbeat monitor.
+     * Begins sending periodic heartbeat pings to all known peers.
+     *
+     * @see Requirements 7.1
+     */
+    start() {
+        if (this.running) {
+            return;
+        }
+        this.running = true;
+        this.heartbeatTimer = setInterval(() => {
+            this.sendHeartbeats().catch(() => {
+                // Ignore heartbeat errors - they're handled per-peer
+            });
+        }, this.config.intervalMs);
+        // Send initial heartbeats immediately
+        this.sendHeartbeats().catch(() => {
+            // Ignore initial heartbeat errors
+        });
+    }
+    /**
+     * Stop the heartbeat monitor.
+     * Stops sending heartbeats and clears all tracking state.
+     */
+    stop() {
+        if (!this.running) {
+            return;
+        }
+        this.running = false;
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = null;
+        }
+    }
+    /**
+     * Check if the monitor is currently running.
+     *
+     * @returns True if the monitor is active
+     */
+    isRunning() {
+        return this.running;
+    }
+    /**
+     * Check if a specific peer is currently reachable.
+     *
+     * @param peerId - The peer ID to check
+     * @returns True if the peer is reachable (responding to heartbeats)
+     * @see Requirements 7.5
+     */
+    isPeerReachable(peerId) {
+        const state = this.peerStates.get(peerId);
+        return state?.reachable ?? false;
+    }
+    /**
+     * Get all peers that are currently reachable.
+     *
+     * @returns Array of peer IDs that are responding to heartbeats
+     * @see Requirements 7.5
+     */
+    getReachablePeers() {
+        const reachable = [];
+        for (const [peerId, state] of this.peerStates) {
+            if (state.reachable) {
+                reachable.push(peerId);
+            }
+        }
+        return reachable;
+    }
+    /**
+     * Get all peers that are currently unreachable.
+     *
+     * @returns Array of peer IDs that have exceeded the missed threshold
+     * @see Requirements 7.5
+     */
+    getUnreachablePeers() {
+        const unreachable = [];
+        for (const [peerId, state] of this.peerStates) {
+            if (!state.reachable) {
+                unreachable.push(peerId);
+            }
+        }
+        return unreachable;
+    }
+    /**
+     * Get the number of consecutive missed heartbeats for a peer.
+     *
+     * @param peerId - The peer ID to check
+     * @returns Number of missed heartbeats, or 0 if peer is unknown
+     */
+    getMissedCount(peerId) {
+        return this.peerStates.get(peerId)?.missedCount ?? 0;
+    }
+    /**
+     * Add a peer to be monitored.
+     *
+     * @param peerId - The peer ID to start monitoring
+     */
+    addPeer(peerId) {
+        if (!this.peerStates.has(peerId)) {
+            this.peerStates.set(peerId, {
+                missedCount: 0,
+                reachable: true, // Assume reachable until proven otherwise
+            });
+        }
+    }
+    /**
+     * Remove a peer from monitoring.
+     *
+     * @param peerId - The peer ID to stop monitoring
+     */
+    removePeer(peerId) {
+        this.peerStates.delete(peerId);
+    }
+    /**
+     * Get all peers being monitored.
+     *
+     * @returns Array of all peer IDs being monitored
+     */
+    getMonitoredPeers() {
+        return Array.from(this.peerStates.keys());
+    }
+    /**
+     * Subscribe to connectivity change events.
+     *
+     * @param handler - Function to call when connectivity changes
+     * @see Requirements 7.2, 7.5, 7.7
+     */
+    onConnectivityChange(handler) {
+        this.handlers.add(handler);
+    }
+    /**
+     * Remove a connectivity change handler.
+     *
+     * @param handler - The handler to remove
+     */
+    offConnectivityChange(handler) {
+        this.handlers.delete(handler);
+    }
+    /**
+     * Record a successful heartbeat response from a peer.
+     * Called when a pong is received in response to a ping.
+     *
+     * @param peerId - The peer that responded
+     * @param latencyMs - Round-trip latency in milliseconds
+     */
+    recordHeartbeatResponse(peerId, latencyMs) {
+        let state = this.peerStates.get(peerId);
+        if (!state) {
+            state = {
+                missedCount: 0,
+                reachable: true,
+            };
+            this.peerStates.set(peerId, state);
+        }
+        const wasUnreachable = !state.reachable;
+        state.missedCount = 0;
+        state.reachable = true;
+        state.lastLatencyMs = latencyMs;
+        state.lastSuccessAt = new Date();
+        // Emit peer_connected if peer was previously unreachable
+        if (wasUnreachable) {
+            this.emitEvent({
+                type: 'peer_connected',
+                peerId,
+                timestamp: new Date(),
+            });
+            // Check if we're exiting partition mode
+            this.checkPartitionExit();
+        }
+    }
+    /**
+     * Get the last recorded latency for a peer.
+     *
+     * @param peerId - The peer ID to check
+     * @returns Last recorded latency in milliseconds, or undefined if unknown
+     */
+    getLastLatency(peerId) {
+        return this.peerStates.get(peerId)?.lastLatencyMs;
+    }
+    /**
+     * Get the current configuration.
+     *
+     * @returns The heartbeat configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Send heartbeats to all monitored peers.
+     * @private
+     */
+    async sendHeartbeats() {
+        const peers = this.getMonitoredPeers();
+        if (peers.length === 0) {
+            return;
+        }
+        const heartbeatPromises = peers.map((peerId) => this.sendHeartbeatToPeer(peerId));
+        await Promise.all(heartbeatPromises);
+    }
+    /**
+     * Send a heartbeat to a specific peer and handle the response.
+     * @private
+     */
+    async sendHeartbeatToPeer(peerId) {
+        try {
+            const latencyMs = await this.transport.sendPing(peerId);
+            this.recordHeartbeatResponse(peerId, latencyMs);
+        }
+        catch {
+            // Heartbeat failed - record missed
+            this.recordMissedHeartbeat(peerId);
+        }
+    }
+    /**
+     * Record a missed heartbeat for a peer.
+     * @private
+     */
+    recordMissedHeartbeat(peerId) {
+        let state = this.peerStates.get(peerId);
+        if (!state) {
+            state = {
+                missedCount: 0,
+                reachable: true,
+            };
+            this.peerStates.set(peerId, state);
+        }
+        state.missedCount++;
+        // Check if peer has exceeded missed threshold
+        if (state.reachable && state.missedCount >= this.config.missedThreshold) {
+            state.reachable = false;
+            this.emitEvent({
+                type: 'peer_disconnected',
+                peerId,
+                timestamp: new Date(),
+            });
+            // Check if all peers are now unreachable (partition)
+            this.checkPartitionEntry();
+        }
+    }
+    /**
+     * Check if we should enter partition mode (all peers unreachable).
+     * @private
+     */
+    checkPartitionEntry() {
+        if (this.inPartition) {
+            return; // Already in partition
+        }
+        const monitoredPeers = this.getMonitoredPeers();
+        if (monitoredPeers.length === 0) {
+            return; // No peers to monitor
+        }
+        const reachablePeers = this.getReachablePeers();
+        if (reachablePeers.length === 0) {
+            // All peers are unreachable - enter partition mode
+            this.inPartition = true;
+            this.emitEvent({
+                type: 'all_disconnected',
+                timestamp: new Date(),
+            });
+        }
+    }
+    /**
+     * Check if we should exit partition mode (at least one peer reachable).
+     * @private
+     */
+    checkPartitionExit() {
+        if (!this.inPartition) {
+            return; // Not in partition
+        }
+        const reachablePeers = this.getReachablePeers();
+        if (reachablePeers.length > 0) {
+            // At least one peer is reachable - exit partition mode
+            this.inPartition = false;
+            this.emitEvent({
+                type: 'some_reconnected',
+                timestamp: new Date(),
+            });
+        }
+    }
+    /**
+     * Emit a connectivity event to all handlers.
+     * @private
+     */
+    emitEvent(event) {
+        for (const handler of this.handlers) {
+            try {
+                handler(event);
+            }
+            catch {
+                // Ignore handler errors to prevent one handler from affecting others
+            }
+        }
+    }
+    /**
+     * Check if currently in partition mode.
+     *
+     * @returns True if all peers are unreachable
+     */
+    isInPartition() {
+        return this.inPartition;
+    }
+    /**
+     * Clear all peer states (for testing).
+     */
+    clearPeers() {
+        this.peerStates.clear();
+        this.inPartition = false;
+    }
+}
+exports.HeartbeatMonitor = HeartbeatMonitor;
+//# sourceMappingURL=heartbeatMonitor.js.map

package/src/lib/availability/heartbeatMonitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeatMonitor.js","sourceRoot":"","sources":["../../../../../brightchain-api-lib/src/lib/availability/heartbeatMonitor.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AASH,0EAA0E;AAC1E,gEAAwE;AAA/D,2HAAA,wBAAwB,OAAA;AAEjC;;GAEG;AACH,MAAM,sBAAsB,GAAoB;IAC9C,UAAU,EAAE,IAAI;IAChB,SAAS,EAAE,IAAI;IACf,eAAe,EAAE,CAAC;CACnB,CAAC;AAyCF;;;;;;;;GAQG;AACH,MAAa,gBAAgB;IA0B3B;;;;;OAKG;IACH,YACmB,SAA8B,EAC9B,SAA0B,sBAAsB;QADhD,cAAS,GAAT,SAAS,CAAqB;QAC9B,WAAM,GAAN,MAAM,CAA0C;QAjCnE;;WAEG;QACK,eAAU,GAAoC,IAAI,GAAG,EAAE,CAAC;QAEhE;;WAEG;QACK,aAAQ,GAAkC,IAAI,GAAG,EAAE,CAAC;QAE5D;;WAEG;QACK,mBAAc,GAA0C,IAAI,CAAC;QAErE;;WAEG;QACK,YAAO,GAAG,KAAK,CAAC;QAExB;;WAEG;QACK,gBAAW,GAAG,KAAK,CAAC;IAWzB,CAAC;IAEJ;;;;;OAKG;IACH,KAAK;QACH,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,cAAc,GAAG,WAAW,CAAC,GAAG,EAAE;YACrC,IAAI,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;gBAC/B,qDAAqD;YACvD,CAAC,CAAC,CAAC;QACL,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAE3B,sCAAsC;QACtC,IAAI,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;YAC/B,kCAAkC;QACpC,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,IAAI;QACF,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QAErB,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,aAAa,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACnC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC7B,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;;;;;OAMG;IACH,eAAe,CAAC,MAAc;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1C,OAAO,KAAK,EAAE,SAAS,IAAI,KAAK,CAAC;IACnC,CAAC;IAED;;;;;OAKG;IACH,iBAAiB;QACf,MAAM,SAAS,GAAa,EAAE,CAAC;QAC/B,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAC9C,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;gBACpB,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;;OAKG;IACH,mBAAmB;QACjB,MAAM,WAAW,GAAa,EAAE,CAAC;QACjC,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAC9C,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;gBACrB,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;;;;OAKG;IACH,cAAc,CAAC,MAAc;QAC3B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,WAAW,IAAI,CAAC,CAAC;IACvD,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,MAAc;QACpB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACjC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE;gBAC1B,WAAW,EAAE,CAAC;gBACd,SAAS,EAAE,IAAI,EAAE,0CAA0C;aAC5D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,UAAU,CAAC,MAAc;QACvB,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACH,iBAAiB;QACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;OAKG;IACH,oBAAoB,CAAC,OAAiC;QACpD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACH,qBAAqB,CAAC,OAAiC;QACrD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAED;;;;;;OAMG;IACH,uBAAuB,CAAC,MAAc,EAAE,SAAiB;QACvD,IAAI,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG;gBACN,WAAW,EAAE,CAAC;gBACd,SAAS,EAAE,IAAI;aAChB,CAAC;YACF,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACrC,CAAC;QAED,MAAM,cAAc,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC;QAExC,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC;QACtB,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;QACvB,KAAK,CAAC,aAAa,GAAG,SAAS,CAAC;QAChC,KAAK,CAAC,aAAa,GAAG,IAAI,IAAI,EAAE,CAAC;QAEjC,yDAAyD;QACzD,IAAI,cAAc,EAAE,CAAC;YACnB,IAAI,CAAC,SAAS,CAAC;gBACb,IAAI,EAAE,gBAAgB;gBACtB,MAAM;gBACN,SAAS,EAAE,IAAI,IAAI,EAAE;aACtB,CAAC,CAAC;YAEH,wCAAwC;YACxC,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC5B,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,cAAc,CAAC,MAAc;QAC3B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;IACpD,CAAC;IAED;;;;OAIG;IACH,SAAS;QACP,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,cAAc;QAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO;QACT,CAAC;QAED,MAAM,iBAAiB,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAC7C,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CACjC,CAAC;QAEF,MAAM,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACvC,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,mBAAmB,CAAC,MAAc;QAC9C,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACxD,IAAI,CAAC,uBAAuB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAClD,CAAC;QAAC,MAAM,CAAC;YACP,mCAAmC;YACnC,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,qBAAqB,CAAC,MAAc;QAC1C,IAAI,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG;gBACN,WAAW,EAAE,CAAC;gBACd,SAAS,EAAE,IAAI;aAChB,CAAC;YACF,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACrC,CAAC;QAED,KAAK,CAAC,WAAW,EAAE,CAAC;QAEpB,8CAA8C;QAC9C,IAAI,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,WAAW,IAAI,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;YACxE,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC;YAExB,IAAI,CAAC,SAAS,CAAC;gBACb,IAAI,EAAE,mBAAmB;gBACzB,MAAM;gBACN,SAAS,EAAE,IAAI,IAAI,EAAE;aACtB,CAAC,CAAC;YAEH,qDAAqD;YACrD,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC7B,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,mBAAmB;QACzB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,OAAO,CAAC,uBAAuB;QACjC,CAAC;QAED,MAAM,cAAc,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAChD,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,OAAO,CAAC,sBAAsB;QAChC,CAAC;QAED,MAAM,cAAc,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAChD,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,mDAAmD;YACnD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;YAExB,IAAI,CAAC,SAAS,CAAC;gBACb,IAAI,EAAE,kBAAkB;gBACxB,SAAS,EAAE,IAAI,IAAI,EAAE;aACtB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,kBAAkB;QACxB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,OAAO,CAAC,mBAAmB;QAC7B,CAAC;QAED,MAAM,cAAc,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAChD,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,uDAAuD;YACvD,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;YAEzB,IAAI,CAAC,SAAS,CAAC;gBACb,IAAI,EAAE,kBAAkB;gBACxB,SAAS,EAAE,IAAI,IAAI,EAAE;aACtB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,SAAS,CAAC,KAAwB;QACxC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,IAAI,CAAC;gBACH,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC;YAAC,MAAM,CAAC;gBACP,qEAAqE;YACvE,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,UAAU;QACR,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;IAC3B,CAAC;CACF;AAnYD,4CAmYC"}

package/src/lib/availability/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @fileoverview Availability module exports
+ *
+ * This module provides implementations for block availability tracking,
+ * discovery, and network partition handling.
+ */
+export * from './availabilityMetrics';
+export * from './availabilityService';
+export * from './blockRegistry';
+export * from './configValidation';
+export * from './discoveryProtocol';
+export * from './gossipService';
+export * from './heartbeatMonitor';
+export * from './reconciliationService';
+//# sourceMappingURL=index.d.ts.map

package/src/lib/availability/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../brightchain-api-lib/src/lib/availability/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC"}

package/src/lib/availability/index.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * @fileoverview Availability module exports
+ *
+ * This module provides implementations for block availability tracking,
+ * discovery, and network partition handling.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./availabilityMetrics"), exports);
+tslib_1.__exportStar(require("./availabilityService"), exports);
+tslib_1.__exportStar(require("./blockRegistry"), exports);
+tslib_1.__exportStar(require("./configValidation"), exports);
+tslib_1.__exportStar(require("./discoveryProtocol"), exports);
+tslib_1.__exportStar(require("./gossipService"), exports);
+tslib_1.__exportStar(require("./heartbeatMonitor"), exports);
+tslib_1.__exportStar(require("./reconciliationService"), exports);
+//# sourceMappingURL=index.js.map

package/src/lib/availability/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../brightchain-api-lib/src/lib/availability/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,gEAAsC;AACtC,gEAAsC;AACtC,0DAAgC;AAChC,6DAAmC;AACnC,8DAAoC;AACpC,0DAAgC;AAChC,6DAAmC;AACnC,kEAAwC"}

package/src/lib/availability/reconciliationService.d.ts

@@ -0,0 +1,237 @@
+/**
+ * @fileoverview Reconciliation Service Implementation
+ *
+ * Implements state synchronization after network reconnection.
+ * Handles manifest exchange, pending sync queue processing,
+ * orphan resolution, and conflict resolution using last-write-wins.
+ *
+ * @see Requirements 9.1, 9.2, 9.3, 9.4, 9.5, 9.6, 9.7, 9.8
+ */
+import { BlockManifest, IReconciliationService, PendingSyncItem, ReconciliationConfig, ReconciliationEventHandler, ReconciliationResult, SyncVectorEntry } from '@brightchain/brightchain-lib';
+/**
+ * Interface for peer manifest operations.
+ * Abstracts network communication for reconciliation.
+ */
+export interface IManifestProvider {
+    /**
+     * Get the local node ID.
+     */
+    getLocalNodeId(): string;
+    /**
+     * Get the local manifest.
+     */
+    getLocalManifest(): BlockManifest;
+    /**
+     * Get manifest from a peer.
+     *
+     * @param peerId - The peer to get manifest from
+     * @param sinceTimestamp - Optional timestamp to get changes since
+     * @param timeoutMs - Timeout in milliseconds
+     */
+    getPeerManifest(peerId: string, sinceTimestamp?: Date, timeoutMs?: number): Promise<BlockManifest>;
+    /**
+     * Update location metadata for a block.
+     *
+     * @param blockId - The block ID to update
+     * @param nodeId - The node ID that has the block
+     * @param timestamp - When the block was seen
+     */
+    updateBlockLocation(blockId: string, nodeId: string, timestamp: Date): Promise<void>;
+    /**
+     * Get the current availability state of a block.
+     *
+     * @param blockId - The block ID to check
+     * @returns 'local' | 'remote' | 'cached' | 'orphaned' | 'unknown'
+     */
+    getBlockAvailabilityState(blockId: string): Promise<'local' | 'remote' | 'cached' | 'orphaned' | 'unknown'>;
+    /**
+     * Update block availability state.
+     *
+     * @param blockId - The block ID to update
+     * @param state - The new state
+     */
+    updateBlockAvailabilityState(blockId: string, state: 'local' | 'remote' | 'cached' | 'orphaned' | 'unknown'): Promise<void>;
+    /**
+     * Get all orphaned block IDs.
+     */
+    getOrphanedBlockIds(): Promise<string[]>;
+    /**
+     * Send a pending sync item to a peer.
+     *
+     * @param peerId - The peer to send to
+     * @param item - The sync item to send
+     */
+    sendSyncItem(peerId: string, item: PendingSyncItem): Promise<void>;
+    /**
+     * Get connected peer IDs.
+     */
+    getConnectedPeerIds(): string[];
+    /**
+     * Get the timestamp of a block's last modification.
+     *
+     * @param blockId - The block ID to check
+     * @param nodeId - The node to check
+     */
+    getBlockTimestamp(blockId: string, nodeId: string): Promise<Date | null>;
+}
+/**
+ * Reconciliation Service Implementation
+ *
+ * Handles state synchronization after network reconnection.
+ * Implements manifest exchange, pending sync queue processing,
+ * orphan resolution, and conflict resolution.
+ *
+ * @see Requirements 9.1, 9.2, 9.3, 9.4, 9.5, 9.6, 9.7, 9.8
+ */
+export declare class ReconciliationService implements IReconciliationService {
+    private readonly manifestProvider;
+    private readonly config;
+    /**
+     * Sync vectors for each peer.
+     */
+    private readonly syncVectors;
+    /**
+     * Pending sync queue.
+     */
+    private pendingSyncQueue;
+    /**
+     * Event handlers.
+     */
+    private readonly eventHandlers;
+    /**
+     * Base path for persistence.
+     */
+    private readonly basePath;
+    /**
+     * Create a new ReconciliationService.
+     *
+     * @param manifestProvider - Provider for manifest operations
+     * @param basePath - Base path for persistence files
+     * @param config - Reconciliation configuration
+     */
+    constructor(manifestProvider: IManifestProvider, basePath: string, config?: ReconciliationConfig);
+    /**
+     * Start reconciliation with reconnected peers.
+     *
+     * @param peerIds - Array of peer IDs to reconcile with
+     * @returns Promise resolving to reconciliation result
+     * @see Requirements 9.1, 9.2, 9.3, 9.4, 9.5, 9.6, 9.7
+     */
+    reconcile(peerIds: string[]): Promise<ReconciliationResult>;
+    /**
+     * Reconcile with a single peer.
+     */
+    private reconcileWithPeer;
+    /**
+     * Resolve orphaned blocks by checking if any reconnected peers have them.
+     */
+    private resolveOrphanedBlocks;
+    /**
+     * Get the sync vector entry for a specific peer.
+     *
+     * @param peerId - The peer ID to get sync vector for
+     * @returns The sync vector entry or null if not found
+     */
+    getSyncVector(peerId: string): SyncVectorEntry | null;
+    /**
+     * Get all sync vector entries.
+     *
+     * @returns Map of peer IDs to sync vector entries
+     */
+    getAllSyncVectors(): Map<string, SyncVectorEntry>;
+    /**
+     * Update the sync vector for a peer after successful synchronization.
+     *
+     * @param peerId - The peer ID to update
+     * @param timestamp - The timestamp of the sync
+     * @param manifestChecksum - The checksum of the peer's manifest
+     */
+    updateSyncVector(peerId: string, timestamp: Date, manifestChecksum: string): void;
+    /**
+     * Initialize sync vector for a new peer.
+     *
+     * @param peerId - The peer ID to initialize
+     */
+    initializeSyncVector(peerId: string): void;
+    /**
+     * Get the pending sync queue.
+     *
+     * @returns Array of pending sync items
+     */
+    getPendingSyncQueue(): PendingSyncItem[];
+    /**
+     * Add an item to the pending sync queue.
+     *
+     * @param item - The item to add to the queue
+     */
+    addToPendingSyncQueue(item: PendingSyncItem): void;
+    /**
+     * Process the pending sync queue.
+     *
+     * @returns Promise that resolves when queue is processed
+     */
+    processPendingSyncQueue(): Promise<void>;
+    /**
+     * Clear the pending sync queue.
+     */
+    clearPendingSyncQueue(): void;
+    /**
+     * Persist sync vectors to disk.
+     *
+     * @returns Promise that resolves when persistence is complete
+     */
+    persistSyncVectors(): Promise<void>;
+    /**
+     * Load sync vectors from disk.
+     *
+     * @returns Promise that resolves when loading is complete
+     */
+    loadSyncVectors(): Promise<void>;
+    /**
+     * Persist pending sync queue to disk.
+     *
+     * @returns Promise that resolves when persistence is complete
+     */
+    persistPendingSyncQueue(): Promise<void>;
+    /**
+     * Load pending sync queue from disk.
+     *
+     * @returns Promise that resolves when loading is complete
+     */
+    loadPendingSyncQueue(): Promise<void>;
+    /**
+     * Subscribe to reconciliation events.
+     *
+     * @param handler - Function to call when events occur
+     */
+    onEvent(handler: ReconciliationEventHandler): void;
+    /**
+     * Remove a reconciliation event handler.
+     *
+     * @param handler - The handler to remove
+     */
+    offEvent(handler: ReconciliationEventHandler): void;
+    /**
+     * Get the current configuration.
+     *
+     * @returns The reconciliation configuration
+     */
+    getConfig(): ReconciliationConfig;
+    /**
+     * Emit an event to all handlers.
+     */
+    private emitEvent;
+    /**
+     * Ensure the directory for a file path exists.
+     */
+    private ensureDirectoryExists;
+    /**
+     * Split an array into chunks.
+     */
+    private chunkArray;
+    /**
+     * Clear all state (for testing).
+     */
+    clear(): void;
+}
+//# sourceMappingURL=reconciliationService.d.ts.map

package/src/lib/availability/reconciliationService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconciliationService.d.ts","sourceRoot":"","sources":["../../../../../brightchain-api-lib/src/lib/availability/reconciliationService.ts"],"names":[],"mappings":"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"}