@olane/o-node 0.7.12-alpha.3 → 0.7.12-alpha.31

package/dist/src/connection/o-node-connection.d.ts

@@ -1,11 +1,10 @@
-import { Connection, Stream } from '@olane/o-config';
+import { Connection } from '@olane/o-config';
 import { oConnection, oRequest, oResponse } from '@olane/o-core';
 import { oNodeConnectionConfig } from './interfaces/o-node-connection.config.js';
 export declare class oNodeConnection extends oConnection {
     protected readonly config: oNodeConnectionConfig;
     p2pConnection: Connection;
     constructor(config: oNodeConnectionConfig);
-    read(source: Stream): Promise<any>;
     validate(): void;
     transmit(request: oRequest): Promise<oResponse>;
     close(): Promise<void>;

package/dist/src/connection/o-node-connection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"o-node-connection.d.ts","sourceRoot":"","sources":["../../../src/connection/o-node-connection.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EAIV,MAAM,EAEP,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,WAAW,EAGX,QAAQ,EACR,SAAS,EACV,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AAEjF,qBAAa,eAAgB,SAAQ,WAAW;IAGlC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,qBAAqB;IAFrD,aAAa,EAAE,UAAU,CAAC;gBAEF,MAAM,EAAE,qBAAqB;IAKtD,IAAI,CAAC,MAAM,EAAE,MAAM;IAWzB,QAAQ;IAOF,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC;IAyC/C,KAAK;CAKZ"}
+{"version":3,"file":"o-node-connection.d.ts","sourceRoot":"","sources":["../../../src/connection/o-node-connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAEL,WAAW,EAGX,QAAQ,EACR,SAAS,EACV,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AAEjF,qBAAa,eAAgB,SAAQ,WAAW;IAGlC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,qBAAqB;IAFrD,aAAa,EAAE,UAAU,CAAC;gBAEF,MAAM,EAAE,qBAAqB;IAK5D,QAAQ;IAOF,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC;IA6D/C,KAAK;CAKZ"}

package/dist/src/connection/o-node-connection.js

@@ -1,20 +1,10 @@
-import { Uint8ArrayList, byteStream, } from '@olane/o-config';
-import { oConnection, oError, oErrorCodes, oResponse, } from '@olane/o-core';
+import { CoreUtils, oConnection, oError, oErrorCodes, oResponse, } from '@olane/o-core';
 export class oNodeConnection extends oConnection {
     constructor(config) {
         super(config);
         this.config = config;
         this.p2pConnection = config.p2pConnection;
     }
-    async read(source) {
-        const bytes = byteStream(source);
-        const output = await bytes.read({
-            signal: AbortSignal.timeout(120000), // 2 min timeout
-        });
-        const outputObj = output instanceof Uint8ArrayList ? output.subarray() : output;
-        const jsonStr = new TextDecoder().decode(outputObj);
-        return JSON.parse(jsonStr);
-    }
     validate() {
         if (this.config.p2pConnection.status !== 'open') {
             throw new Error('Connection is not valid');
@@ -33,14 +23,31 @@ export class oNodeConnection extends oConnection {
             if (stream.status === 'reset') {
                 throw new oError(oErrorCodes.CONNECTION_LIMIT_REACHED, 'Connection limit reached');
             }
-            // Send the data
-            await stream.send(new TextEncoder().encode(request.toString()));
-            const res = await this.read(stream);
-            await stream.close();
-            // process the response
-            const response = new oResponse({
-                ...res.result,
+            // Send the data with backpressure handling (libp2p v3 best practice)
+            const data = new TextEncoder().encode(request.toString());
+            const sent = stream.send(data);
+            let lastResponse;
+            await new Promise((resolve, reject) => {
+                // TODO: add timeout
+                stream.addEventListener('message', async (event) => {
+                    const response = await CoreUtils.processStreamResponse(event);
+                    this.emitter.emit('chunk', response);
+                    // marked as the last chunk let's close
+                    if (response.result._last || !response.result._isStreaming) {
+                        lastResponse = response;
+                        await stream.close();
+                        resolve(true);
+                    }
+                });
             });
+            // If send() returns false, wait for the stream to drain before continuing
+            if (!sent) {
+                this.logger.debug('Stream buffer full, waiting for drain...');
+                await stream.onDrain({
+                    signal: AbortSignal.timeout(this.config.drainTimeoutMs ?? 30000),
+                }); // Default: 30 second timeout
+            }
+            const response = oResponse.fromJSON(lastResponse);
             return response;
         }
         catch (error) {

package/dist/src/connection/o-node-connection.manager.d.ts

@@ -4,9 +4,11 @@ import { oNodeConnectionManagerConfig } from './interfaces/o-node-connection-man
 import { oNodeConnection } from './o-node-connection.js';
 export declare class oNodeConnectionManager extends oConnectionManager {
     private p2pNode;
+    private defaultReadTimeoutMs?;
+    private defaultDrainTimeoutMs?;
     constructor(config: oNodeConnectionManagerConfig);
     /**
-     * Connect to a given address
+     * Connect to a given address with exponential backoff retry
      * @param address - The address to connect to
      * @returns The connection object
      */

package/dist/src/connection/o-node-connection.manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"o-node-connection.manager.d.ts","sourceRoot":"","sources":["../../../src/connection/o-node-connection.manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,4BAA4B,EAAE,MAAM,kDAAkD,CAAC;AAEhG,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,qBAAa,sBAAuB,SAAQ,kBAAkB;IAC5D,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,4BAA4B;IAKhD;;;;OAIG;IACG,OAAO,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC;IAkDlE,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO;IAIpC,mBAAmB,CAAC,OAAO,EAAE,QAAQ,GAAG,WAAW,GAAG,IAAI;CAe3D"}
+{"version":3,"file":"o-node-connection.manager.d.ts","sourceRoot":"","sources":["../../../src/connection/o-node-connection.manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,4BAA4B,EAAE,MAAM,kDAAkD,CAAC;AAEhG,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,qBAAa,sBAAuB,SAAQ,kBAAkB;IAC5D,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,oBAAoB,CAAC,CAAS;IACtC,OAAO,CAAC,qBAAqB,CAAC,CAAS;gBAE3B,MAAM,EAAE,4BAA4B;IAOhD;;;;OAIG;IACG,OAAO,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC;IA+FlE,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO;IAIpC,mBAAmB,CAAC,OAAO,EAAE,QAAQ,GAAG,WAAW,GAAG,IAAI;CAe3D"}

package/dist/src/connection/o-node-connection.manager.js

@@ -4,14 +4,16 @@ export class oNodeConnectionManager extends oConnectionManager {
     constructor(config) {
         super(config);
         this.p2pNode = config.p2pNode;
+        this.defaultReadTimeoutMs = config.defaultReadTimeoutMs;
+        this.defaultDrainTimeoutMs = config.defaultDrainTimeoutMs;
     }
     /**
-     * Connect to a given address
+     * Connect to a given address with exponential backoff retry
      * @param address - The address to connect to
      * @returns The connection object
      */
     async connect(config) {
-        const { address, nextHopAddress, callerAddress } = config;
+        const { address, nextHopAddress, callerAddress, readTimeoutMs, drainTimeoutMs, } = config;
         // check if we already have a connection to this address
         // TODO: how can we enable caching of connections & connection lifecycles
         if (this.isCached(nextHopAddress)) {
@@ -26,25 +28,48 @@ export class oNodeConnectionManager extends oConnectionManager {
                 this.cache.delete(nextHopAddress.toString());
             }
         }
-        // first time setup connection
-        try {
-            const p2pConnection = await this.p2pNode.dial(nextHopAddress.libp2pTransports.map((ma) => ma.toMultiaddr()));
-            const connection = new oNodeConnection({
-                nextHopAddress: nextHopAddress,
-                address: address,
-                p2pConnection: p2pConnection,
-                callerAddress: callerAddress,
-            });
-            // this.cache.set(nextHopAddress.toString(), connection);
-            return connection;
-        }
-        catch (error) {
-            this.logger.error(`[${callerAddress?.toString() || 'unknown'}] Error connecting to address! Next hop:` +
-                nextHopAddress +
-                ' With Address:' +
-                address.toString(), error);
-            throw error;
+        // Retry configuration for handling transient connection failures
+        const MAX_RETRIES = 3;
+        const BASE_DELAY_MS = 1000; // Start with 1 second
+        const MAX_DELAY_MS = 10000; // Cap at 10 seconds
+        // first time setup connection with retry logic
+        let lastError;
+        for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+            try {
+                if (attempt > 0) {
+                    // Calculate exponential backoff delay: 1s, 2s, 4s, 8s (capped at MAX_DELAY_MS)
+                    const delay = Math.min(BASE_DELAY_MS * Math.pow(2, attempt - 1), MAX_DELAY_MS);
+                    this.logger.debug(`Retry attempt ${attempt}/${MAX_RETRIES} for ${nextHopAddress.toString()} after ${delay}ms delay`);
+                    await new Promise((resolve) => setTimeout(resolve, delay));
+                }
+                const p2pConnection = await this.p2pNode.dial(nextHopAddress.libp2pTransports.map((ma) => ma.toMultiaddr()));
+                const connection = new oNodeConnection({
+                    nextHopAddress: nextHopAddress,
+                    address: address,
+                    p2pConnection: p2pConnection,
+                    callerAddress: callerAddress,
+                    readTimeoutMs: readTimeoutMs ?? this.defaultReadTimeoutMs,
+                    drainTimeoutMs: drainTimeoutMs ?? this.defaultDrainTimeoutMs,
+                    isStream: config.isStream ?? false,
+                });
+                if (attempt > 0) {
+                    this.logger.info(`Successfully connected to ${nextHopAddress.toString()} on retry attempt ${attempt}`);
+                }
+                // this.cache.set(nextHopAddress.toString(), connection);
+                return connection;
+            }
+            catch (error) {
+                lastError = error;
+                this.logger.warn(`[${callerAddress?.toString() || 'unknown'}] Connection attempt ${attempt + 1}/${MAX_RETRIES + 1} failed for ${nextHopAddress.toString()}:`, error);
+                // Don't retry on the last attempt
+                if (attempt === MAX_RETRIES) {
+                    break;
+                }
+            }
         }
+        // All retries exhausted
+        this.logger.error(`[${callerAddress?.toString() || 'unknown'}] Failed to connect after ${MAX_RETRIES + 1} attempts to address! Next hop: ${nextHopAddress} With Address: ${address.toString()}`, lastError);
+        throw lastError;
     }
     isCached(address) {
         return this.cache.has(address.toString());

package/dist/src/connection/o-stream.request.d.ts

@@ -0,0 +1,11 @@
+import { Request, RequestId } from '@olane/o-protocol';
+import { oRequest } from '@olane/o-core';
+import { Stream } from '@olane/o-config';
+export declare class oStreamRequest extends oRequest {
+    stream: Stream;
+    constructor(config: Request & {
+        id: RequestId;
+        stream: Stream;
+    });
+}
+//# sourceMappingURL=o-stream.request.d.ts.map

package/dist/src/connection/o-stream.request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"o-stream.request.d.ts","sourceRoot":"","sources":["../../../src/connection/o-stream.request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,MAAM,EAAE,MAAM,CAAC;gBACH,MAAM,EAAE,OAAO,GAAG;QAAE,EAAE,EAAE,SAAS,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;CAIhE"}

package/dist/src/connection/o-stream.request.js

@@ -0,0 +1,7 @@
+import { oRequest } from '@olane/o-core';
+export class oStreamRequest extends oRequest {
+    constructor(config) {
+        super(config);
+        this.stream = config.stream;
+    }
+}

package/dist/src/index.d.ts

@@ -1,5 +1,5 @@
 export * from './o-node.js';
-export * from './utils/network.utils.js';
+export * from './utils/index.js';
 export * from './o-node.hierarchy-manager.js';
 export * from './interfaces/o-node.config.js';
 export * from './connection/index.js';
@@ -7,4 +7,5 @@ export * from './o-node.tool.js';
 export * from './nodes/index.js';
 export * from './interfaces/o-node.tool-config.js';
 export * from './router/index.js';
+export * from './connection/o-stream.request.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oCAAoC,CAAC;AACnD,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oCAAoC,CAAC;AACnD,cAAc,mBAAmB,CAAC;AAClC,cAAc,kCAAkC,CAAC"}

package/dist/src/index.js

@@ -1,5 +1,5 @@
 export * from './o-node.js';
-export * from './utils/network.utils.js';
+export * from './utils/index.js';
 export * from './o-node.hierarchy-manager.js';
 export * from './interfaces/o-node.config.js';
 export * from './connection/index.js';
@@ -7,3 +7,4 @@ export * from './o-node.tool.js';
 export * from './nodes/index.js';
 export * from './interfaces/o-node.tool-config.js';
 export * from './router/index.js';
+export * from './connection/o-stream.request.js';

package/dist/src/interfaces/i-heartbeatable-node.d.ts

@@ -0,0 +1,49 @@
+import { oNotificationManager } from '@olane/o-core';
+import { Libp2p } from '@olane/o-config';
+import { oNodeAddress } from '../router/o-node.address.js';
+/**
+ * Interface for nodes that support connection heartbeat monitoring.
+ * This interface defines the contract that oConnectionHeartbeatManager needs
+ * to access live hierarchy state without holding stale references.
+ */
+export interface IHeartbeatableNode {
+    /**
+     * The node's current address
+     */
+    address: oNodeAddress;
+    /**
+     * The notification manager for emitting heartbeat events
+     */
+    notificationManager: oNotificationManager;
+    /**
+     * The underlying libp2p node for ping operations
+     */
+    p2pNode: Libp2p;
+    /**
+     * The current parent address (with live transport updates)
+     * @returns Parent address or null if no parent
+     */
+    parent: oNodeAddress | null;
+    /**
+     * Get the current list of leader addresses
+     * @returns Array of leader addresses (empty if this node is the leader)
+     */
+    getLeaders(): oNodeAddress[];
+    /**
+     * Get the current list of parent addresses
+     * @returns Array of parent addresses
+     */
+    getParents(): oNodeAddress[];
+    /**
+     * Get the current list of child addresses
+     * @returns Array of child addresses
+     */
+    getChildren(): oNodeAddress[];
+    /**
+     * Remove a child from the hierarchy
+     * @param childAddress The address of the child to remove
+     */
+    removeChild(childAddress: oNodeAddress): void;
+    use(param1: any, param2: any): Promise<any>;
+}
+//# sourceMappingURL=i-heartbeatable-node.d.ts.map

package/dist/src/interfaces/i-heartbeatable-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-heartbeatable-node.d.ts","sourceRoot":"","sources":["../../../src/interfaces/i-heartbeatable-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE3D;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,OAAO,EAAE,YAAY,CAAC;IAEtB;;OAEG;IACH,mBAAmB,EAAE,oBAAoB,CAAC;IAE1C;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAE5B;;;OAGG;IACH,UAAU,IAAI,YAAY,EAAE,CAAC;IAE7B;;;OAGG;IACH,UAAU,IAAI,YAAY,EAAE,CAAC;IAE7B;;;OAGG;IACH,WAAW,IAAI,YAAY,EAAE,CAAC;IAE9B;;;OAGG;IACH,WAAW,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAE9C,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CAC7C"}

package/dist/src/interfaces/i-heartbeatable-node.js

@@ -0,0 +1 @@
+export {};

package/dist/src/interfaces/i-reconnectable-node.d.ts

@@ -0,0 +1,46 @@
+import { oAddress, NodeState, oNotificationManager } from '@olane/o-core';
+import { oNodeAddress } from '../router/o-node.address.js';
+import { oNodeConfig } from './o-node.config.js';
+/**
+ * Interface for nodes that support reconnection management.
+ * This interface defines the contract that oReconnectionManager needs
+ * to perform reconnection operations without creating a circular dependency.
+ */
+export interface IReconnectableNode {
+    /**
+     * The node's configuration
+     */
+    config: oNodeConfig;
+    /**
+     * The node's current address
+     */
+    address: oNodeAddress;
+    /**
+     * The node's current state
+     */
+    state: NodeState;
+    /**
+     * The notification manager for subscribing to events
+     */
+    notificationManager: oNotificationManager;
+    /**
+     * Register with the parent node
+     */
+    registerParent(): Promise<void>;
+    /**
+     * Register with the leader's global registry
+     */
+    register(): Promise<void>;
+    useSelf(request?: any): Promise<any>;
+    /**
+     * Execute a method on another node
+     */
+    use(address: oAddress, data?: {
+        method?: string;
+        params?: {
+            [key: string]: any;
+        };
+        id?: string;
+    }): Promise<any>;
+}
+//# sourceMappingURL=i-reconnectable-node.d.ts.map

package/dist/src/interfaces/i-reconnectable-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-reconnectable-node.d.ts","sourceRoot":"","sources":["../../../src/interfaces/i-reconnectable-node.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,SAAS,EACT,oBAAoB,EAErB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,MAAM,EAAE,WAAW,CAAC;IAEpB;;OAEG;IACH,OAAO,EAAE,YAAY,CAAC;IAEtB;;OAEG;IACH,KAAK,EAAE,SAAS,CAAC;IAEjB;;OAEG;IACH,mBAAmB,EAAE,oBAAoB,CAAC;IAE1C;;OAEG;IACH,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhC;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAErC;;OAEG;IACH,GAAG,CACD,OAAO,EAAE,QAAQ,EACjB,IAAI,CAAC,EAAE;QACL,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;SAAE,CAAC;QAChC,EAAE,CAAC,EAAE,MAAM,CAAC;KACb,GACA,OAAO,CAAC,GAAG,CAAC,CAAC;CACjB"}

package/dist/src/interfaces/i-reconnectable-node.js

@@ -0,0 +1 @@
+export {};

package/dist/src/interfaces/o-node.config.d.ts

@@ -3,5 +3,47 @@ import { oNodeAddress } from '../router/o-node.address.js';
 export interface oNodeConfig extends oCoreConfig {
     leader: oNodeAddress | null;
     parent: oNodeAddress | null;
+    /**
+     * Connection heartbeat configuration (libp2p-native pings)
+     * Detects dead connections via periodic pings using libp2p's ping service
+     */
+    connectionHeartbeat?: {
+        enabled?: boolean;
+        intervalMs?: number;
+        timeoutMs?: number;
+        failureThreshold?: number;
+        checkChildren?: boolean;
+        checkParent?: boolean;
+        checkLeader?: boolean;
+    };
+    /**
+     * Automatic reconnection configuration
+     * Handles parent connection failures and attempts to reconnect
+     */
+    reconnection?: {
+        enabled?: boolean;
+        maxAttempts?: number;
+        baseDelayMs?: number;
+        maxDelayMs?: number;
+        useLeaderFallback?: boolean;
+        parentDiscoveryIntervalMs?: number;
+        parentDiscoveryMaxDelayMs?: number;
+    };
+    /**
+     * Connection timeout configuration
+     * Controls timeouts for stream read and drain operations in connections
+     */
+    connectionTimeouts?: {
+        /**
+         * Timeout in milliseconds for reading response data from a stream
+         * Default: 120000 (2 minutes)
+         */
+        readTimeoutMs?: number;
+        /**
+         * Timeout in milliseconds for waiting for stream buffer to drain when backpressure occurs
+         * Default: 30000 (30 seconds)
+         */
+        drainTimeoutMs?: number;
+    };
 }
 //# sourceMappingURL=o-node.config.d.ts.map

package/dist/src/interfaces/o-node.config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"o-node.config.d.ts","sourceRoot":"","sources":["../../../src/interfaces/o-node.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE3D,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC9C,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;CAC7B"}
+{"version":3,"file":"o-node.config.d.ts","sourceRoot":"","sources":["../../../src/interfaces/o-node.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE3D,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC9C,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAE5B;;;OAGG;IACH,mBAAmB,CAAC,EAAE;QACpB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,CAAC;IAEF;;;OAGG;IACH,YAAY,CAAC,EAAE;QACb,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAC5B,yBAAyB,CAAC,EAAE,MAAM,CAAC;QACnC,yBAAyB,CAAC,EAAE,MAAM,CAAC;KACpC,CAAC;IAEF;;;OAGG;IACH,kBAAkB,CAAC,EAAE;QACnB;;;WAGG;QACH,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB;;;WAGG;QACH,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;CACH"}

package/dist/src/managers/o-connection-heartbeat.manager.d.ts

@@ -0,0 +1,62 @@
+import { oObject } from '@olane/o-core';
+import { oNodeAddress } from '../router/o-node.address.js';
+import { IHeartbeatableNode } from '../interfaces/i-heartbeatable-node.js';
+export interface HeartbeatConfig {
+    enabled: boolean;
+    intervalMs: number;
+    timeoutMs: number;
+    failureThreshold: number;
+    checkChildren: boolean;
+    checkParent: boolean;
+    checkLeader: boolean;
+}
+export interface ConnectionHealth {
+    address: oNodeAddress;
+    peerId: string;
+    lastSuccessfulPing: number;
+    consecutiveFailures: number;
+    averageLatency: number;
+    status: 'healthy' | 'degraded' | 'dead';
+}
+/**
+ * Connection Heartbeat Manager
+ *
+ * Uses libp2p's native ping service to detect dead connections early.
+ * Continuously pings parent and children to ensure they're alive.
+ *
+ * How it works:
+ * - Every `intervalMs`, pings all tracked connections
+ * - If ping fails, increments failure counter
+ * - After `failureThreshold` failures, marks connection as dead
+ * - Emits events for degraded/recovered/dead connections
+ * - Automatically removes dead children from hierarchy
+ * - Emits ParentDisconnectedEvent when parent dies (triggers reconnection)
+ */
+export declare class oConnectionHeartbeatManager extends oObject {
+    private node;
+    private config;
+    private heartbeatInterval?;
+    private healthMap;
+    constructor(node: IHeartbeatableNode, config: HeartbeatConfig);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private performHeartbeatCycle;
+    private doPing;
+    private pingTarget;
+    private handleConnectionDead;
+    private emitConnectionDegradedEvent;
+    private emitConnectionRecoveredEvent;
+    /**
+     * Get current health status of all connections
+     */
+    getHealthStatus(): ConnectionHealth[];
+    /**
+     * Get health status for specific address
+     */
+    getConnectionHealth(address: oNodeAddress): ConnectionHealth | undefined;
+    /**
+     * Get current configuration
+     */
+    getConfig(): HeartbeatConfig;
+}
+//# sourceMappingURL=o-connection-heartbeat.manager.d.ts.map

package/dist/src/managers/o-connection-heartbeat.manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"o-connection-heartbeat.manager.d.ts","sourceRoot":"","sources":["../../../src/managers/o-connection-heartbeat.manager.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EAOR,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAE3E,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;CACzC;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,2BAA4B,SAAQ,OAAO;IAKpD,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,MAAM;IALhB,OAAO,CAAC,iBAAiB,CAAC,CAAiB;IAC3C,OAAO,CAAC,SAAS,CAAuC;gBAG9C,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,eAAe;IAK3B,KAAK;IAqBL,IAAI;YAQI,qBAAqB;IAyCnC,OAAO,CAAC,MAAM;YASA,UAAU;IAuFxB,OAAO,CAAC,oBAAoB;IAyD5B,OAAO,CAAC,2BAA2B;IAmBnC,OAAO,CAAC,4BAA4B;IAiBpC;;OAEG;IACH,eAAe,IAAI,gBAAgB,EAAE;IAIrC;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,gBAAgB,GAAG,SAAS;IAIxE;;OAEG;IACH,SAAS,IAAI,eAAe;CAG7B"}