@brightchain/brightchain-api-lib 0.0.1

package/src/lib/availability/gossipService.js

@@ -0,0 +1,271 @@
+"use strict";
+/**
+ * @fileoverview Gossip Service Implementation
+ *
+ * Implements gossip-based block announcements across the network.
+ * Supports announcement batching, TTL decrement on forwarding,
+ * and fanout to random peers.
+ *
+ * @see Requirements 6.1, 6.2, 6.3, 6.4, 6.5, 6.6
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GossipService = exports.DEFAULT_GOSSIP_CONFIG = void 0;
+// Re-export DEFAULT_GOSSIP_CONFIG from brightchain-lib for convenience
+var brightchain_lib_1 = require("@brightchain/brightchain-lib");
+Object.defineProperty(exports, "DEFAULT_GOSSIP_CONFIG", { enumerable: true, get: function () { return brightchain_lib_1.DEFAULT_GOSSIP_CONFIG; } });
+/**
+ * Default gossip configuration values (local copy for use in this module).
+ */
+const defaultGossipConfig = {
+    fanout: 3,
+    defaultTtl: 3,
+    batchIntervalMs: 1000,
+    maxBatchSize: 100,
+};
+/**
+ * Gossip Service Implementation
+ *
+ * Handles gossip-based block announcements across the network.
+ * Implements batching, TTL management, and random peer selection.
+ *
+ * @see Requirements 6.1, 6.2, 6.3, 6.4, 6.5, 6.6
+ */
+class GossipService {
+    /**
+     * Create a new GossipService.
+     *
+     * @param peerProvider - Provider for peer management operations
+     * @param config - Gossip configuration (uses defaults if not provided)
+     */
+    constructor(peerProvider, config = defaultGossipConfig) {
+        this.peerProvider = peerProvider;
+        this.config = config;
+        /**
+         * Pending announcements waiting to be batched and sent.
+         */
+        this.pendingAnnouncements = [];
+        /**
+         * Registered announcement handlers.
+         */
+        this.handlers = new Set();
+        /**
+         * Batch timer handle.
+         */
+        this.batchTimer = null;
+        /**
+         * Whether the service is running.
+         */
+        this.running = false;
+    }
+    /**
+     * Announce a new block to the network.
+     *
+     * @param blockId - The block ID to announce
+     * @see Requirements 6.1
+     */
+    async announceBlock(blockId) {
+        const announcement = {
+            type: 'add',
+            blockId,
+            nodeId: this.peerProvider.getLocalNodeId(),
+            timestamp: new Date(),
+            ttl: this.config.defaultTtl,
+        };
+        this.queueAnnouncement(announcement);
+    }
+    /**
+     * Announce block removal to the network.
+     *
+     * @param blockId - The block ID being removed
+     * @see Requirements 6.5
+     */
+    async announceRemoval(blockId) {
+        const announcement = {
+            type: 'remove',
+            blockId,
+            nodeId: this.peerProvider.getLocalNodeId(),
+            timestamp: new Date(),
+            ttl: this.config.defaultTtl,
+        };
+        this.queueAnnouncement(announcement);
+    }
+    /**
+     * Handle an incoming block announcement from a peer.
+     * Notifies handlers and optionally forwards with decremented TTL.
+     *
+     * @param announcement - The received announcement
+     * @see Requirements 6.2, 6.4
+     */
+    async handleAnnouncement(announcement) {
+        // Notify all registered handlers
+        for (const handler of this.handlers) {
+            try {
+                handler(announcement);
+            }
+            catch {
+                // Ignore handler errors to prevent one handler from affecting others
+            }
+        }
+        // Forward with decremented TTL if TTL > 0
+        if (announcement.ttl > 0) {
+            const forwardedAnnouncement = {
+                ...announcement,
+                ttl: announcement.ttl - 1,
+            };
+            this.queueAnnouncement(forwardedAnnouncement);
+        }
+    }
+    /**
+     * Subscribe to announcement events.
+     *
+     * @param handler - Function to call when an announcement is received
+     * @see Requirements 6.2
+     */
+    onAnnouncement(handler) {
+        this.handlers.add(handler);
+    }
+    /**
+     * Remove an announcement handler.
+     *
+     * @param handler - The handler to remove
+     */
+    offAnnouncement(handler) {
+        this.handlers.delete(handler);
+    }
+    /**
+     * Get pending announcements that have not yet been sent.
+     *
+     * @returns Array of pending announcements
+     * @see Requirements 6.6
+     */
+    getPendingAnnouncements() {
+        return [...this.pendingAnnouncements];
+    }
+    /**
+     * Immediately flush all pending announcements.
+     *
+     * @see Requirements 6.6
+     */
+    async flushAnnouncements() {
+        if (this.pendingAnnouncements.length === 0) {
+            return;
+        }
+        // Get connected peers
+        const connectedPeers = this.peerProvider.getConnectedPeerIds();
+        if (connectedPeers.length === 0) {
+            // No peers to send to, clear pending
+            this.pendingAnnouncements = [];
+            return;
+        }
+        // Select random peers for fanout
+        const selectedPeers = this.selectRandomPeers(connectedPeers, this.config.fanout);
+        // Split announcements into batches
+        const batches = this.splitIntoBatches(this.pendingAnnouncements, this.config.maxBatchSize);
+        // Clear pending before sending to avoid duplicates on retry
+        this.pendingAnnouncements = [];
+        // Send batches to selected peers
+        const sendPromises = [];
+        for (const peerId of selectedPeers) {
+            for (const batch of batches) {
+                sendPromises.push(this.peerProvider.sendAnnouncementBatch(peerId, batch).catch(() => {
+                    // Ignore send errors - best effort delivery
+                }));
+            }
+        }
+        await Promise.all(sendPromises);
+    }
+    /**
+     * Start the gossip service.
+     */
+    start() {
+        if (this.running) {
+            return;
+        }
+        this.running = true;
+        this.batchTimer = setInterval(() => {
+            this.flushAnnouncements().catch(() => {
+                // Ignore flush errors
+            });
+        }, this.config.batchIntervalMs);
+    }
+    /**
+     * Stop the gossip service.
+     */
+    async stop() {
+        if (!this.running) {
+            return;
+        }
+        this.running = false;
+        if (this.batchTimer) {
+            clearInterval(this.batchTimer);
+            this.batchTimer = null;
+        }
+        // Flush any remaining announcements
+        await this.flushAnnouncements();
+    }
+    /**
+     * Get the current configuration.
+     *
+     * @returns The gossip configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Queue an announcement for batching.
+     *
+     * @param announcement - The announcement to queue
+     */
+    queueAnnouncement(announcement) {
+        this.pendingAnnouncements.push(announcement);
+        // If we've reached max batch size, flush immediately
+        if (this.pendingAnnouncements.length >= this.config.maxBatchSize) {
+            this.flushAnnouncements().catch(() => {
+                // Ignore flush errors
+            });
+        }
+    }
+    /**
+     * Select random peers from the available peers.
+     *
+     * @param peers - Available peer IDs
+     * @param count - Number of peers to select
+     * @returns Selected peer IDs
+     * @see Requirements 6.3
+     */
+    selectRandomPeers(peers, count) {
+        if (peers.length <= count) {
+            return [...peers];
+        }
+        // Fisher-Yates shuffle and take first `count` elements
+        const shuffled = [...peers];
+        for (let i = shuffled.length - 1; i > 0; i--) {
+            const j = Math.floor(Math.random() * (i + 1));
+            [shuffled[i], shuffled[j]] = [shuffled[j], shuffled[i]];
+        }
+        return shuffled.slice(0, count);
+    }
+    /**
+     * Split announcements into batches of maximum size.
+     *
+     * @param announcements - Announcements to split
+     * @param maxSize - Maximum batch size
+     * @returns Array of batches
+     * @see Requirements 6.6
+     */
+    splitIntoBatches(announcements, maxSize) {
+        const batches = [];
+        for (let i = 0; i < announcements.length; i += maxSize) {
+            batches.push(announcements.slice(i, i + maxSize));
+        }
+        return batches;
+    }
+    /**
+     * Clear all pending announcements (for testing).
+     */
+    clearPending() {
+        this.pendingAnnouncements = [];
+    }
+}
+exports.GossipService = GossipService;
+//# sourceMappingURL=gossipService.js.map

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

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

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

@@ -0,0 +1,204 @@
+/**
+ * @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
+ */
+import { ConnectivityEventHandler, HeartbeatConfig, IHeartbeatMonitor } from '@brightchain/brightchain-lib';
+export { DEFAULT_HEARTBEAT_CONFIG } from '@brightchain/brightchain-lib';
+/**
+ * Interface for heartbeat transport operations.
+ * Abstracts the underlying transport mechanism (WebSocket, etc.).
+ */
+export interface IHeartbeatTransport {
+    /**
+     * Send a ping to a peer.
+     *
+     * @param peerId - The peer to ping
+     * @returns Promise that resolves with latency in ms, or rejects on timeout/error
+     */
+    sendPing(peerId: string): Promise<number>;
+}
+/**
+ * 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
+ */
+export declare class HeartbeatMonitor implements IHeartbeatMonitor {
+    private readonly transport;
+    private readonly config;
+    /**
+     * Map of peer ID to heartbeat state.
+     */
+    private peerStates;
+    /**
+     * Registered connectivity event handlers.
+     */
+    private handlers;
+    /**
+     * Heartbeat interval timer handle.
+     */
+    private heartbeatTimer;
+    /**
+     * Whether the monitor is currently running.
+     */
+    private running;
+    /**
+     * Whether we are currently in a partition state (all peers unreachable).
+     */
+    private inPartition;
+    /**
+     * Create a new HeartbeatMonitor.
+     *
+     * @param transport - Transport for sending heartbeat pings
+     * @param config - Heartbeat configuration (uses defaults if not provided)
+     */
+    constructor(transport: IHeartbeatTransport, config?: HeartbeatConfig);
+    /**
+     * Start the heartbeat monitor.
+     * Begins sending periodic heartbeat pings to all known peers.
+     *
+     * @see Requirements 7.1
+     */
+    start(): void;
+    /**
+     * Stop the heartbeat monitor.
+     * Stops sending heartbeats and clears all tracking state.
+     */
+    stop(): void;
+    /**
+     * Check if the monitor is currently running.
+     *
+     * @returns True if the monitor is active
+     */
+    isRunning(): boolean;
+    /**
+     * 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: string): boolean;
+    /**
+     * Get all peers that are currently reachable.
+     *
+     * @returns Array of peer IDs that are responding to heartbeats
+     * @see Requirements 7.5
+     */
+    getReachablePeers(): string[];
+    /**
+     * Get all peers that are currently unreachable.
+     *
+     * @returns Array of peer IDs that have exceeded the missed threshold
+     * @see Requirements 7.5
+     */
+    getUnreachablePeers(): string[];
+    /**
+     * 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: string): number;
+    /**
+     * Add a peer to be monitored.
+     *
+     * @param peerId - The peer ID to start monitoring
+     */
+    addPeer(peerId: string): void;
+    /**
+     * Remove a peer from monitoring.
+     *
+     * @param peerId - The peer ID to stop monitoring
+     */
+    removePeer(peerId: string): void;
+    /**
+     * Get all peers being monitored.
+     *
+     * @returns Array of all peer IDs being monitored
+     */
+    getMonitoredPeers(): string[];
+    /**
+     * Subscribe to connectivity change events.
+     *
+     * @param handler - Function to call when connectivity changes
+     * @see Requirements 7.2, 7.5, 7.7
+     */
+    onConnectivityChange(handler: ConnectivityEventHandler): void;
+    /**
+     * Remove a connectivity change handler.
+     *
+     * @param handler - The handler to remove
+     */
+    offConnectivityChange(handler: ConnectivityEventHandler): void;
+    /**
+     * 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: string, latencyMs: number): void;
+    /**
+     * 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: string): number | undefined;
+    /**
+     * Get the current configuration.
+     *
+     * @returns The heartbeat configuration
+     */
+    getConfig(): HeartbeatConfig;
+    /**
+     * Send heartbeats to all monitored peers.
+     * @private
+     */
+    private sendHeartbeats;
+    /**
+     * Send a heartbeat to a specific peer and handle the response.
+     * @private
+     */
+    private sendHeartbeatToPeer;
+    /**
+     * Record a missed heartbeat for a peer.
+     * @private
+     */
+    private recordMissedHeartbeat;
+    /**
+     * Check if we should enter partition mode (all peers unreachable).
+     * @private
+     */
+    private checkPartitionEntry;
+    /**
+     * Check if we should exit partition mode (at least one peer reachable).
+     * @private
+     */
+    private checkPartitionExit;
+    /**
+     * Emit a connectivity event to all handlers.
+     * @private
+     */
+    private emitEvent;
+    /**
+     * Check if currently in partition mode.
+     *
+     * @returns True if all peers are unreachable
+     */
+    isInPartition(): boolean;
+    /**
+     * Clear all peer states (for testing).
+     */
+    clearPeers(): void;
+}
+//# sourceMappingURL=heartbeatMonitor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeatMonitor.d.ts","sourceRoot":"","sources":["../../../../../brightchain-api-lib/src/lib/availability/heartbeatMonitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAEL,wBAAwB,EACxB,eAAe,EACf,iBAAiB,EAClB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAWxE;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3C;AA2BD;;;;;;;;GAQG;AACH,qBAAa,gBAAiB,YAAW,iBAAiB;IAiCtD,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAjCzB;;OAEG;IACH,OAAO,CAAC,UAAU,CAA8C;IAEhE;;OAEG;IACH,OAAO,CAAC,QAAQ,CAA4C;IAE5D;;OAEG;IACH,OAAO,CAAC,cAAc,CAA+C;IAErE;;OAEG;IACH,OAAO,CAAC,OAAO,CAAS;IAExB;;OAEG;IACH,OAAO,CAAC,WAAW,CAAS;IAE5B;;;;;OAKG;gBAEgB,SAAS,EAAE,mBAAmB,EAC9B,MAAM,GAAE,eAAwC;IAGnE;;;;;OAKG;IACH,KAAK,IAAI,IAAI;IAkBb;;;OAGG;IACH,IAAI,IAAI,IAAI;IAaZ;;;;OAIG;IACH,SAAS,IAAI,OAAO;IAIpB;;;;;;OAMG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAKxC;;;;;OAKG;IACH,iBAAiB,IAAI,MAAM,EAAE;IAU7B;;;;;OAKG;IACH,mBAAmB,IAAI,MAAM,EAAE;IAU/B;;;;;OAKG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAItC;;;;OAIG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAS7B;;;;OAIG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIhC;;;;OAIG;IACH,iBAAiB,IAAI,MAAM,EAAE;IAI7B;;;;;OAKG;IACH,oBAAoB,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI;IAI7D;;;;OAIG;IACH,qBAAqB,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI;IAI9D;;;;;;OAMG;IACH,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IA8BhE;;;;;OAKG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIlD;;;;OAIG;IACH,SAAS,IAAI,eAAe;IAI5B;;;OAGG;YACW,cAAc;IAa5B;;;OAGG;YACW,mBAAmB;IAUjC;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IA2B7B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAsB3B;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAiB1B;;;OAGG;IACH,OAAO,CAAC,SAAS;IAUjB;;;;OAIG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,UAAU,IAAI,IAAI;CAInB"}