@olane/o-node 0.7.48 → 0.7.50

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,EAAE,UAAU,EAAU,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAEL,WAAW,EAGX,QAAQ,EACR,SAAS,EACV,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAEV,iBAAiB,EAClB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,qBAAa,eAAgB,SAAQ,WAAW;IAKlC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,qBAAqB;IAJrD,aAAa,EAAE,UAAU,CAAC;IACjC,SAAS,CAAC,aAAa,EAAE,aAAa,CAAC;IACvC,SAAS,CAAC,WAAW,EAAE,iBAAiB,CAAC;gBAEV,MAAM,EAAE,qBAAqB;IAQ5D,IAAI,YAAY,qCAEf;IAED,IAAI,UAAU,wCAEb;IAED;;OAEG;IACH,IAAI,gBAAgB,IAAI,qBAAqB,CAE5C;IAED,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAMzC,iBAAiB,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAkBnD,YAAY,IAAI,OAAO,CAAC,qBAAqB,CAAC;IA6BpD,IAAI,OAAO,IAAI,qBAAqB,EAAE,CAcrC;IAEK,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC;IA6C/C,YAAY,CAAC,MAAM,EAAE,qBAAqB;IAI1C,KAAK,CAAC,KAAK,EAAE,KAAK;IAMlB,KAAK;CAKZ"}
+{"version":3,"file":"o-node-connection.d.ts","sourceRoot":"","sources":["../../../src/connection/o-node-connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAU,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAEL,WAAW,EAGX,QAAQ,EACR,SAAS,EACV,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAEV,iBAAiB,EAClB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,qBAAa,eAAgB,SAAQ,WAAW;IAKlC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,qBAAqB;IAJrD,aAAa,EAAE,UAAU,CAAC;IACjC,SAAS,CAAC,aAAa,EAAE,aAAa,CAAC;IACvC,SAAS,CAAC,WAAW,EAAE,iBAAiB,CAAC;gBAEV,MAAM,EAAE,qBAAqB;IAO5D,IAAI,YAAY,qCAEf;IAED,IAAI,UAAU,wCAEb;IAED;;OAEG;IACH,IAAI,gBAAgB,IAAI,qBAAqB,CAE5C;IAED,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAMzC,iBAAiB,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAiBnD,YAAY,IAAI,OAAO,CAAC,qBAAqB,CAAC;IA6BpD,IAAI,OAAO,IAAI,qBAAqB,EAAE,CAcrC;IAEK,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC;IA6C/C,YAAY,CAAC,MAAM,EAAE,qBAAqB;IAI1C,KAAK,CAAC,KAAK,EAAE,KAAK;IAMlB,KAAK;CAKZ"}

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

@@ -8,7 +8,6 @@ export class oNodeConnection extends oConnection {
         this.p2pConnection = config.p2pConnection;
         this.streamHandler = new StreamHandler(this.logger);
         this.reusePolicy = config.reusePolicy ?? 'none';
-        console.log('oNodeConnection constructor', this.reusePolicy);
     }
     get remotePeerId() {
         return this.p2pConnection.remotePeer;
@@ -28,7 +27,6 @@ export class oNodeConnection extends oConnection {
         });
     }
     async getOrCreateStream() {
-        console.log('getOrCreateStream', this.reusePolicy);
         if (this.reusePolicy === 'reuse') {
             this.logger.debug('Reusing stream...');
             // search for streams that allow re-use

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

@@ -1,6 +1,7 @@
 import { oAddress, NodeState, oNotificationManager } from '@olane/o-core';
 import { oNodeAddress } from '../router/o-node.address.js';
 import { oNodeConfig } from './o-node.config.js';
+import { oRegistrationManager } from '../managers/o-registration.manager.js';
 /**
  * Interface for nodes that support reconnection management.
  * This interface defines the contract that oReconnectionManager needs
@@ -23,10 +24,18 @@ export interface IReconnectableNode {
      * The notification manager for subscribing to events
      */
     notificationManager: oNotificationManager;
+    /**
+     * The registration manager for tracking registration state
+     */
+    registrationManager: oRegistrationManager;
     /**
      * Register with the parent node
      */
     registerParent(): Promise<void>;
+    /**
+     * Register with the leader's global registry
+     */
+    registerLeader(): Promise<void>;
     /**
      * Register with the leader's global registry
      */

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

@@ -1 +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"}
+{"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;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAE7E;;;;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,mBAAmB,EAAE,oBAAoB,CAAC;IAE1C;;OAEG;IACH,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhC;;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-registrable-node.d.ts

@@ -0,0 +1,75 @@
+import { oAddress, NodeType } from '@olane/o-core';
+import { PeerId } from '@olane/o-config';
+import { oNodeAddress } from '../router/o-node.address.js';
+import { oNodeConfig } from './o-node.config.js';
+import { oNodeTransport } from '../router/o-node.transport.js';
+import { oNodeHierarchyManager } from '../o-node.hierarchy-manager.js';
+export interface IReconnectionManager {
+    waitForParentAndReconnect(): Promise<void>;
+}
+/**
+ * Interface for nodes that support registration management.
+ * This interface defines the contract that oRegistrationManager needs
+ * to perform registration operations.
+ */
+export interface IRegistrableNode {
+    /**
+     * The node's configuration
+     */
+    config: oNodeConfig;
+    /**
+     * The node's current address
+     */
+    address: oNodeAddress;
+    /**
+     * The node's static address (without dynamic transports)
+     */
+    staticAddress: oNodeAddress;
+    /**
+     * The leader address (null for leader nodes)
+     */
+    leader: oNodeAddress | null;
+    /**
+     * The parent address (null for root nodes)
+     */
+    parent: oNodeAddress | null;
+    /**
+     * The node type (LEADER, CLIENT, etc.)
+     */
+    type: NodeType;
+    /**
+     * The node's peer ID
+     */
+    peerId: PeerId;
+    /**
+     * The node's current transports
+     */
+    transports: oNodeTransport[];
+    /**
+     * The node's protocols
+     */
+    protocols: string[];
+    /**
+     * Hierarchy manager for tracking parent/child/leader relationships
+     */
+    hierarchyManager: oNodeHierarchyManager;
+    /**
+     * Reconnection manager for handling parent discovery
+     */
+    reconnectionManager?: IReconnectionManager;
+    /**
+     * Execute a method on another node
+     */
+    use(address: oAddress, data?: {
+        method?: string;
+        params?: {
+            [key: string]: any;
+        };
+        id?: string;
+    }): Promise<any>;
+    /**
+     * Set keep-alive tag for a peer connection
+     */
+    setKeepAliveTag(address: oNodeAddress): Promise<void>;
+}
+//# sourceMappingURL=i-registrable-node.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"i-registrable-node.d.ts","sourceRoot":"","sources":["../../../src/interfaces/i-registrable-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAGvE,MAAM,WAAW,oBAAoB;IACnC,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,MAAM,EAAE,WAAW,CAAC;IAEpB;;OAEG;IACH,OAAO,EAAE,YAAY,CAAC;IAEtB;;OAEG;IACH,aAAa,EAAE,YAAY,CAAC;IAE5B;;OAEG;IACH,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAE5B;;OAEG;IACH,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAE5B;;OAEG;IACH,IAAI,EAAE,QAAQ,CAAC;IAEf;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,UAAU,EAAE,cAAc,EAAE,CAAC;IAE7B;;OAEG;IACH,SAAS,EAAE,MAAM,EAAE,CAAC;IAEpB;;OAEG;IACH,gBAAgB,EAAE,qBAAqB,CAAC;IAExC;;OAEG;IACH,mBAAmB,CAAC,EAAE,oBAAoB,CAAC;IAE3C;;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;IAEhB;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD"}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"o-reconnection.manager.d.ts","sourceRoot":"","sources":["../../../src/managers/o-reconnection.manager.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EASR,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAI3E,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,yBAAyB,EAAE,MAAM,CAAC;IAClC,yBAAyB,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,oBAAqB,SAAQ,OAAO;IAI7C,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,MAAM;IAJhB,OAAO,CAAC,YAAY,CAAS;gBAGnB,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,kBAAkB;IAMpC,OAAO,CAAC,mBAAmB;IAyBrB,mBAAmB,CAAC,KAAK,EAAE,GAAG;YAoBtB,wBAAwB;YAaxB,wBAAwB;YAexB,wBAAwB;IAehC,mBAAmB;YAgDX,2BAA2B;YAiB3B,iBAAiB;IAkB/B;;;OAGG;YACW,yBAAyB;IAiFvC;;OAEG;IACG,yBAAyB;IA4G/B,OAAO,CAAC,yBAAyB;IAajC,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,qBAAqB;IAK7B,OAAO,CAAC,KAAK;CAGd"}
+{"version":3,"file":"o-reconnection.manager.d.ts","sourceRoot":"","sources":["../../../src/managers/o-reconnection.manager.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EASR,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAI3E,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,yBAAyB,EAAE,MAAM,CAAC;IAClC,yBAAyB,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,oBAAqB,SAAQ,OAAO;IAI7C,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,MAAM;IAJhB,OAAO,CAAC,YAAY,CAAS;gBAGnB,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,kBAAkB;IAMpC,OAAO,CAAC,mBAAmB;IAyBrB,mBAAmB,CAAC,KAAK,EAAE,GAAG;YAmCtB,wBAAwB;YAaxB,wBAAwB;YAexB,wBAAwB;IAehC,mBAAmB;YAgDX,2BAA2B;YAiB3B,iBAAiB;IAkB/B;;;OAGG;YACW,yBAAyB;IAyFvC;;OAEG;IACG,yBAAyB;IAoH/B,OAAO,CAAC,yBAAyB;IAajC,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,qBAAqB;IAK7B,OAAO,CAAC,KAAK;CAGd"}

package/dist/src/managers/o-reconnection.manager.js

@@ -32,17 +32,32 @@ export class oReconnectionManager extends oObject {
     }
     async handleNodeConnected(event) {
         const connectedEvent = event;
+        const nodeAddress = connectedEvent.nodeAddress;
         // if leader is back online re-register
-        if (connectedEvent.nodeAddress.toString() === oAddress.leader().toString()) {
-            // the leader is back online, let's re-register & tell sub-graphs to re-register
-            await this.node.useSelf({
-                method: 'register_leader',
-                params: {},
-            });
+        if (nodeAddress.toString() === oAddress.leader().toString()) {
+            // Check if we can register with leader (not already registering or registered)
+            if (this.node.registrationManager.canRegisterLeader()) {
+                this.logger.info('Leader connected - registering with registry');
+                // the leader is back online, let's re-register & tell sub-graphs to re-register
+                await this.node.useSelf({
+                    method: 'register_leader',
+                    params: {},
+                });
+            }
+            else {
+                this.logger.debug(`Leader already ${this.node.registrationManager.getStatus().leader} - skipping re-registration`);
+            }
         }
-        if (connectedEvent.nodeAddress.toString() === this.node.config.parent?.value) {
-            // connect to the parent and register
-            await this.node.registerParent();
+        if (nodeAddress.toString() === this.node.config.parent?.value) {
+            // Check if we can register with parent (not already registering or registered)
+            if (this.node.registrationManager.canRegisterParent()) {
+                this.logger.info('Parent connected - registering with parent');
+                // connect to the parent and register
+                await this.node.registerParent();
+            }
+            else {
+                this.logger.debug(`Parent already ${this.node.registrationManager.getStatus().parent} - skipping re-registration`);
+            }
         }
     }
     async handleConnectionDegraded(event) {
@@ -160,11 +175,17 @@ export class oReconnectionManager extends oObject {
                 // Leader is back! Now re-register with parent and registry
                 this.logger.info(`Leader is back online after ${elapsedMinutes}m, re-registering...`);
                 try {
+                    // Reset registration states before re-registering
+                    this.node.registrationManager.resetParentState();
+                    this.node.registrationManager.resetLeaderState();
                     // Register with parent (leader)
                     await this.node.registerParent();
-                    // Force re-registration with registry by resetting the flag
-                    this.node.didRegister = false;
-                    await this.node.register();
+                    // Register with registry
+                    await this.node.registerLeader();
+                    // Verify registration was successful
+                    if (!this.node.registrationManager.isFullyRegistered()) {
+                        throw new Error('Registration incomplete after reconnection');
+                    }
                     // Success!
                     this.reconnecting = false;
                     this.logger.info(`Successfully reconnected to leader and re-registered after ${elapsedMinutes}m`);
@@ -228,10 +249,16 @@ export class oReconnectionManager extends oObject {
                     this.node.config.parent = new oNodeAddress(parentAddress, parentTransports.map((value) => new oNodeTransport(value)));
                     // Attempt to register with parent and re-register with registry
                     try {
+                        // Reset registration states before re-registering
+                        this.node.registrationManager.resetParentState();
+                        this.node.registrationManager.resetLeaderState();
                         await this.tryDirectParentReconnection();
-                        // Force re-registration with registry by resetting the flag
-                        this.node.didRegister = false;
-                        await this.node.register();
+                        // Register with registry
+                        await this.node.registerLeader();
+                        // Verify registration was successful
+                        if (!this.node.registrationManager.isFullyRegistered()) {
+                            throw new Error('Registration incomplete after reconnection');
+                        }
                         // Success!
                         this.reconnecting = false;
                         this.logger.info(`Successfully reconnected to parent and re-registered after ${elapsedMinutes}m of discovery attempts`);

package/dist/src/managers/o-registration.manager.d.ts

@@ -0,0 +1,79 @@
+import { oObject } from '@olane/o-core';
+import { IRegistrableNode } from '../interfaces/i-registrable-node.js';
+export type RegistrationState = 'not_registered' | 'registering' | 'registered' | 'failed';
+export interface RegistrationStatus {
+    parent: RegistrationState;
+    leader: RegistrationState;
+    parentError?: string;
+    leaderError?: string;
+}
+/**
+ * Registration Manager
+ *
+ * Manages the registration state for parent and leader connections.
+ * Provides stateful tracking and prevents concurrent registration attempts.
+ *
+ * State Transitions:
+ * - not_registered → registering (when starting registration)
+ * - registering → registered (on success)
+ * - registering → failed (on error)
+ * - failed → registering (on retry)
+ * - registered → not_registered (on explicit reset)
+ */
+export declare class oRegistrationManager extends oObject {
+    private node;
+    private parentState;
+    private leaderState;
+    private parentError?;
+    private leaderError?;
+    constructor(node: IRegistrableNode);
+    /**
+     * Check if parent registration can be attempted
+     * Returns false if already registering or registered
+     */
+    canRegisterParent(): boolean;
+    /**
+     * Check if leader registration can be attempted
+     * Returns false if already registering or registered
+     */
+    canRegisterLeader(): boolean;
+    /**
+     * Check if parent is currently registered
+     */
+    isParentRegistered(): boolean;
+    /**
+     * Check if leader is currently registered
+     */
+    isLeaderRegistered(): boolean;
+    /**
+     * Check if both parent and leader are registered
+     */
+    isFullyRegistered(): boolean;
+    /**
+     * Reset parent registration state to not_registered
+     */
+    resetParentState(): void;
+    /**
+     * Reset leader registration state to not_registered
+     */
+    resetLeaderState(): void;
+    /**
+     * Reset all registration states
+     */
+    resetAll(): void;
+    /**
+     * Get current registration status
+     */
+    getStatus(): RegistrationStatus;
+    /**
+     * Register with parent node
+     * Manages state transitions and prevents concurrent attempts
+     */
+    registerParent(): Promise<void>;
+    /**
+     * Register with leader's global registry
+     * Manages state transitions and prevents concurrent attempts
+     */
+    registerLeader(): Promise<void>;
+}
+//# sourceMappingURL=o-registration.manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"o-registration.manager.d.ts","sourceRoot":"","sources":["../../../src/managers/o-registration.manager.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EAIR,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAGvE,MAAM,MAAM,iBAAiB,GACzB,gBAAgB,GAChB,aAAa,GACb,YAAY,GACZ,QAAQ,CAAC;AAEb,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,oBAAqB,SAAQ,OAAO;IAMnC,OAAO,CAAC,IAAI;IALxB,OAAO,CAAC,WAAW,CAAuC;IAC1D,OAAO,CAAC,WAAW,CAAuC;IAC1D,OAAO,CAAC,WAAW,CAAC,CAAQ;IAC5B,OAAO,CAAC,WAAW,CAAC,CAAQ;gBAER,IAAI,EAAE,gBAAgB;IAI1C;;;OAGG;IACH,iBAAiB,IAAI,OAAO;IAM5B;;;OAGG;IACH,iBAAiB,IAAI,OAAO;IAM5B;;OAEG;IACH,kBAAkB,IAAI,OAAO;IAI7B;;OAEG;IACH,kBAAkB,IAAI,OAAO;IAI7B;;OAEG;IACH,iBAAiB,IAAI,OAAO;IAe5B;;OAEG;IACH,gBAAgB,IAAI,IAAI;IAMxB;;OAEG;IACH,gBAAgB,IAAI,IAAI;IAMxB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAKhB;;OAEG;IACH,SAAS,IAAI,kBAAkB;IAS/B;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAsFrC;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;CAwDtC"}

package/dist/src/managers/o-registration.manager.js

@@ -0,0 +1,226 @@
+import { oObject, oAddress, NodeType, } from '@olane/o-core';
+import { oNodeAddress } from '../router/o-node.address.js';
+/**
+ * Registration Manager
+ *
+ * Manages the registration state for parent and leader connections.
+ * Provides stateful tracking and prevents concurrent registration attempts.
+ *
+ * State Transitions:
+ * - not_registered → registering (when starting registration)
+ * - registering → registered (on success)
+ * - registering → failed (on error)
+ * - failed → registering (on retry)
+ * - registered → not_registered (on explicit reset)
+ */
+export class oRegistrationManager extends oObject {
+    constructor(node) {
+        super();
+        this.node = node;
+        this.parentState = 'not_registered';
+        this.leaderState = 'not_registered';
+    }
+    /**
+     * Check if parent registration can be attempted
+     * Returns false if already registering or registered
+     */
+    canRegisterParent() {
+        return (this.parentState !== 'registering' && this.parentState !== 'registered');
+    }
+    /**
+     * Check if leader registration can be attempted
+     * Returns false if already registering or registered
+     */
+    canRegisterLeader() {
+        return (this.leaderState !== 'registering' && this.leaderState !== 'registered');
+    }
+    /**
+     * Check if parent is currently registered
+     */
+    isParentRegistered() {
+        return this.parentState === 'registered';
+    }
+    /**
+     * Check if leader is currently registered
+     */
+    isLeaderRegistered() {
+        return this.leaderState === 'registered';
+    }
+    /**
+     * Check if both parent and leader are registered
+     */
+    isFullyRegistered() {
+        // For leader nodes, only check leader state
+        if (this.node.type === NodeType.LEADER) {
+            return true;
+        }
+        // For nodes without parent, only check leader
+        if (!this.node.config.parent) {
+            return this.isLeaderRegistered();
+        }
+        // For regular nodes, check both
+        return this.isParentRegistered() && this.isLeaderRegistered();
+    }
+    /**
+     * Reset parent registration state to not_registered
+     */
+    resetParentState() {
+        this.logger.debug('Resetting parent registration state');
+        this.parentState = 'not_registered';
+        this.parentError = undefined;
+    }
+    /**
+     * Reset leader registration state to not_registered
+     */
+    resetLeaderState() {
+        this.logger.debug('Resetting leader registration state');
+        this.leaderState = 'not_registered';
+        this.leaderError = undefined;
+    }
+    /**
+     * Reset all registration states
+     */
+    resetAll() {
+        this.resetParentState();
+        this.resetLeaderState();
+    }
+    /**
+     * Get current registration status
+     */
+    getStatus() {
+        return {
+            parent: this.parentState,
+            leader: this.leaderState,
+            parentError: this.parentError?.message,
+            leaderError: this.leaderError?.message,
+        };
+    }
+    /**
+     * Register with parent node
+     * Manages state transitions and prevents concurrent attempts
+     */
+    async registerParent() {
+        if (this.node.type === NodeType.LEADER) {
+            this.logger.debug('Skipping parent registration, node is leader');
+            return;
+        }
+        if (!this.node.parent) {
+            this.logger.warn('No parent configured, skipping registration');
+            return;
+        }
+        // Check if we can register (not already registering or registered)
+        if (!this.canRegisterParent()) {
+            this.logger.debug(`Cannot register parent, current state: ${this.parentState}`);
+            return;
+        }
+        this.logger.info('Registering with parent...', {
+            parent: this.node.parent.toString(),
+            currentState: this.parentState,
+        });
+        // Transition to registering state
+        this.parentState = 'registering';
+        this.parentError = undefined;
+        try {
+            // Check if parent has transports
+            if (!this.node.parent?.libp2pTransports?.length) {
+                this.logger.debug('Parent has no transports, waiting for reconnection & leader ack');
+                if (this.node.parent?.toString() === oAddress.leader().toString()) {
+                    this.node.parent.setTransports(this.node.leader?.libp2pTransports || []);
+                }
+                else {
+                    this.logger.debug('Waiting for parent and reconnecting...');
+                    // Reset state since we're delegating to reconnection manager
+                    this.parentState = 'not_registered';
+                    if (this.node.reconnectionManager) {
+                        await this.node.reconnectionManager.waitForParentAndReconnect();
+                    }
+                    else {
+                        throw new Error('Parent has no transports and no reconnection manager available');
+                    }
+                    // If we get here, reconnection was successful and registration is complete
+                    return;
+                }
+            }
+            // Register with parent via child_register call
+            await this.node.use(new oNodeAddress(this.node.config.parent.value), {
+                method: 'child_register',
+                params: {
+                    address: this.node.address.toString(),
+                    transports: this.node.transports.map((t) => t.toString()),
+                    peerId: this.node.peerId.toString(),
+                    _token: this.node.config.joinToken,
+                },
+            });
+            // Set keep-alive tag for parent connection
+            await this.node.setKeepAliveTag(this.node.parent);
+            // Add parent to hierarchy manager
+            this.node.hierarchyManager.addParent(this.node.parent);
+            // Success - transition to registered state
+            this.parentState = 'registered';
+            this.logger.info('Successfully registered with parent', {
+                parent: this.node.parent.toString(),
+            });
+        }
+        catch (error) {
+            // Failure - transition to failed state
+            this.parentState = 'failed';
+            this.parentError = error instanceof Error ? error : new Error(String(error));
+            this.logger.error('Failed to register with parent:', {
+                parent: this.node.parent?.toString(),
+                error: this.parentError.message,
+            });
+            throw error;
+        }
+    }
+    /**
+     * Register with leader's global registry
+     * Manages state transitions and prevents concurrent attempts
+     */
+    async registerLeader() {
+        if (!this.node.leader) {
+            this.logger.warn('No leader defined, skipping registration');
+            return;
+        }
+        // Check if we can register (not already registering or registered)
+        if (!this.canRegisterLeader()) {
+            this.logger.debug(`Cannot register leader, current state: ${this.leaderState}`);
+            return;
+        }
+        this.logger.info('Registering with leader registry...', {
+            leader: this.node.leader.toString(),
+            currentState: this.leaderState,
+        });
+        // Transition to registering state
+        this.leaderState = 'registering';
+        this.leaderError = undefined;
+        try {
+            const address = oAddress.registry();
+            const params = {
+                method: 'commit',
+                params: {
+                    peerId: this.node.peerId.toString(),
+                    address: this.node.address.toString(),
+                    protocols: this.node.protocols,
+                    transports: this.node.transports,
+                    staticAddress: this.node.staticAddress.toString(),
+                },
+            };
+            await this.node.use(address, params);
+            // Set keep-alive tag for leader connection
+            await this.node.setKeepAliveTag(this.node.leader);
+            // Success - transition to registered state
+            this.leaderState = 'registered';
+            this.logger.info('Successfully registered with leader registry');
+        }
+        catch (error) {
+            // Failure - transition to failed state
+            this.leaderState = 'failed';
+            this.leaderError = error instanceof Error ? error : new Error(String(error));
+            this.logger.error('Failed to register with leader:', {
+                leader: this.node.leader?.toString(),
+                error: this.leaderError.message,
+            });
+            throw error;
+        }
+    }
+}

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

@@ -11,6 +11,7 @@ import { oToolBase } from '@olane/o-tool';
 import { oConnectionHeartbeatManager } from './managers/o-connection-heartbeat.manager.js';
 import { oNodeConnectionConfig } from './connection/index.js';
 import { oReconnectionManager } from './managers/o-reconnection.manager.js';
+import { oRegistrationManager } from './managers/o-registration.manager.js';
 import { LockManager } from './utils/lock-manager.js';
 export declare class oNode extends oToolBase {
     peerId: PeerId;
@@ -21,7 +22,7 @@ export declare class oNode extends oToolBase {
     hierarchyManager: oNodeHierarchyManager;
     connectionHeartbeatManager?: oConnectionHeartbeatManager;
     protected reconnectionManager?: oReconnectionManager;
-    protected didRegister: boolean;
+    registrationManager: oRegistrationManager;
     protected hooksStartFinished: any[];
     protected hooksInitFinished: any[];
     protected lockManager: LockManager;
@@ -35,6 +36,7 @@ export declare class oNode extends oToolBase {
     get staticAddress(): oNodeAddress;
     get parentTransports(): oNodeTransport[];
     get transports(): oNodeTransport[];
+    get protocols(): string[];
     unregister(): Promise<void>;
     setKeepAliveTag(address: oNodeAddress): Promise<void>;
     registerParent(): Promise<void>;

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

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

package/dist/src/o-node.js

@@ -3,7 +3,7 @@ import { v4 as uuidv4 } from 'uuid';
 import { oNodeRouter } from './router/o-node.router.js';
 import { oNodeHierarchyManager } from './o-node.hierarchy-manager.js';
 import { oNodeTransport } from './router/o-node.transport.js';
-import { CoreUtils, NodeState, NodeType, oAddress, RestrictedAddresses, } from '@olane/o-core';
+import { CoreUtils, NodeState, NodeType, RestrictedAddresses, } from '@olane/o-core';
 import { oNodeAddress } from './router/o-node.address.js';
 import { oNodeConnectionManager } from './connection/o-node-connection.manager.js';
 import { oNodeResolver } from './router/resolvers/o-node.resolver.js';
@@ -11,11 +11,11 @@ import { oMethodResolver, oToolBase } from '@olane/o-tool';
 import { oLeaderResolverFallback } from './router/index.js';
 import { oNodeNotificationManager } from './o-node.notification-manager.js';
 import { oReconnectionManager } from './managers/o-reconnection.manager.js';
+import { oRegistrationManager } from './managers/o-registration.manager.js';
 import { LockManager } from './utils/lock-manager.js';
 export class oNode extends oToolBase {
     constructor(config) {
         super(config);
-        this.didRegister = false;
         this.hooksStartFinished = [];
         this.hooksInitFinished = [];
         this.lockManager = new LockManager();
@@ -58,6 +58,9 @@ export class oNode extends oToolBase {
             .getMultiaddrs()
             .map((multiaddr) => new oNodeTransport(multiaddr.toString()));
     }
+    get protocols() {
+        return this.p2pNode ? this.p2pNode.getProtocols() : [];
+    }
     async unregister() {
         this.logger.debug('Unregistering node...');
         if (this.type === NodeType.LEADER) {
@@ -134,72 +137,20 @@ export class oNode extends oToolBase {
         }
     }
     async registerParent() {
-        if (this.type === NodeType.LEADER) {
-            this.logger.debug('Skipping parent registration, node is leader');
-            return;
-        }
-        if (!this.parent) {
-            this.logger.warn('no parent, skipping registration');
-            return;
-        }
-        if (!this.parent?.libp2pTransports?.length) {
-            this.logger.debug('Parent has no transports, waiting for reconnection & leader ack');
-            if (this.parent?.toString() === oAddress.leader().toString()) {
-                this.parent.setTransports(this.leader?.libp2pTransports || []);
-            }
-            else {
-                this.logger.debug('Waiting for parent and reconnecting... hello');
-                await this.reconnectionManager?.waitForParentAndReconnect();
-            }
-        }
-        // if no parent transports, register with the parent to get them
-        // TODO: should we remove the transports check to make this more consistent?
-        if (this.config.parent) {
-            this.logger.debug('Registering node with parent...', this.config.parent?.toString());
-            // avoid transports to ensure we do not try direct connection, we need to route via the leader for proper access controls
-            await this.use(new oNodeAddress(this.config.parent.value), {
-                method: 'child_register',
-                params: {
-                    address: this.address.toString(),
-                    transports: this.transports.map((t) => t.toString()),
-                    peerId: this.peerId.toString(),
-                    _token: this.config.joinToken,
-                },
-            });
-            this.setKeepAliveTag(this.parent);
-            this.hierarchyManager.addParent(this.parent);
-        }
+        return await this.registrationManager.registerParent();
     }
     async registerLeader() {
-        this.logger.info('Register leader called...');
-        if (!this.leader) {
-            this.logger.warn('No leader defined, skipping registration');
-            return;
-        }
-        const address = oAddress.registry();
-        const params = {
-            method: 'commit',
-            params: {
-                peerId: this.peerId.toString(),
-                address: this.address.toString(),
-                protocols: this.p2pNode.getProtocols(),
-                transports: this.transports,
-                staticAddress: this.staticAddress.toString(),
-            },
-        };
-        await this.use(address, params);
-        this.setKeepAliveTag(this.leader);
+        return await this.registrationManager.registerLeader();
     }
     async register() {
         if (this.type === NodeType.LEADER) {
             this.logger.debug('Skipping registration, node is leader');
             return;
         }
-        if (this.didRegister) {
+        if (this.registrationManager.isFullyRegistered()) {
             this.logger.debug('Node already registered, skipping registration');
             return;
         }
-        this.didRegister = true;
         this.logger.debug('Registering node...');
         await this.registerParent();
         // register with the leader global registry
@@ -470,6 +421,7 @@ export class oNode extends oToolBase {
             parentDiscoveryIntervalMs: 5000,
             parentDiscoveryMaxDelayMs: 20000,
         });
+        this.registrationManager = new oRegistrationManager(this);
         // need to wait until our libpp2 node is initialized before calling super.initialize
         await super.initialize();
         this.logger.debug('Node initialized!', this.transports.map((t) => t.toString()));
@@ -522,8 +474,10 @@ export class oNode extends oToolBase {
      * Called at the end of teardown()
      */
     resetState() {
-        // Reset registration flag
-        this.didRegister = false;
+        // Reset registration states
+        if (this.registrationManager) {
+            this.registrationManager.resetAll();
+        }
         // Clear all locks
         this.lockManager.clearAll();
         // Clear peer references
@@ -533,6 +487,7 @@ export class oNode extends oToolBase {
         this.connectionManager = undefined;
         this.connectionHeartbeatManager = undefined;
         this.reconnectionManager = undefined;
+        this.registrationManager = undefined;
         // Reset address to staticAddress with no transports
         this.address = new oNodeAddress(this.staticAddress.value, []);
         // Reset hierarchy manager

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

@@ -1 +1 @@
-{"version":3,"file":"o-node.tool.d.ts","sourceRoot":"","sources":["../../src/o-node.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAoB,MAAM,eAAe,CAAC;AAErE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;;AAMrD;;;;GAIG;AACH,qBAAa,SAAU,SAAQ,cAAkB;IAC/C,OAAO,CAAC,aAAa,CAAiB;IAEhC,mBAAmB,CAAC,OAAO,EAAE,QAAQ;IAsBrC,cAAc,CAAC,OAAO,EAAE,QAAQ;IAoBhC,mBAAmB;IAWnB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,iBAAiB,CACrB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,IAAI,CAAC;IAIV,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,UAAU,EACtB,KAAK,CAAC,EAAE,OAAO,GACd,OAAO,CAAC,IAAI,CAAC;IAyCV,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC;IAQ9B,oBAAoB,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC;CAiC5D"}
+{"version":3,"file":"o-node.tool.d.ts","sourceRoot":"","sources":["../../src/o-node.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAoB,MAAM,eAAe,CAAC;AAErE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;;AAMrD;;;;GAIG;AACH,qBAAa,SAAU,SAAQ,cAAkB;IAC/C,OAAO,CAAC,aAAa,CAAiB;IAEhC,mBAAmB,CAAC,OAAO,EAAE,QAAQ;IAuBrC,cAAc,CAAC,OAAO,EAAE,QAAQ;IAsBhC,mBAAmB;IAWnB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,iBAAiB,CACrB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,IAAI,CAAC;IAIV,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,UAAU,EACtB,KAAK,CAAC,EAAE,OAAO,GACd,OAAO,CAAC,IAAI,CAAC;IAyCV,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC;IAQ9B,oBAAoB,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC;CAiC5D"}

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

@@ -25,6 +25,7 @@ export class oNodeTool extends oTool(oServerNode) {
         await this.p2pNode.handle(reuseProtocol, this.handleStreamReuse.bind(this), {
             maxInboundStreams: 10000,
             maxOutboundStreams: maxOutboundsStreams,
+            runOnLimitedConnection: this.config.runOnLimitedConnection,
         });
         this.logger.debug('Handled protocol reuse: ' + reuseProtocol);
     }
@@ -40,10 +41,12 @@ export class oNodeTool extends oTool(oServerNode) {
         this.logger.debug('Handling protocol: ' + address.protocol, {
             maxInboundStreams: 10000,
             maxOutboundStreams: maxOutboundsStreams,
+            runOnLimitedConnection: this.config.runOnLimitedConnection,
         });
         await this.p2pNode.handle(address.protocol, this.handleStream.bind(this), {
             maxInboundStreams: 10000,
             maxOutboundStreams: maxOutboundsStreams,
+            runOnLimitedConnection: this.config.runOnLimitedConnection,
         });
         await this.handleProtocolReuse(address);
     }
@@ -66,20 +69,20 @@ export class oNodeTool extends oTool(oServerNode) {
     async handleStream(stream, connection, reuse) {
         if (reuse) {
             this.logger.debug('Handle stream with reuse = true');
+            // record inbound connection to manager
+            const remoteAddress = await ConnectionUtils.addressFromConnection({
+                currentNode: this,
+                connection: connection,
+            });
+            this.connectionManager.answer({
+                nextHopAddress: remoteAddress,
+                address: remoteAddress,
+                callerAddress: this.address,
+                p2pConnection: connection,
+                reuse,
+                // requestHandler: this.execute.bind(this), TODO: do we need this?
+            });
         }
-        // record inbound connection to manager
-        const remoteAddress = await ConnectionUtils.addressFromConnection({
-            currentNode: this,
-            connection: connection,
-        });
-        this.connectionManager.answer({
-            nextHopAddress: remoteAddress,
-            address: remoteAddress,
-            callerAddress: this.address,
-            p2pConnection: connection,
-            reuse,
-            // requestHandler: this.execute.bind(this), TODO: do we need this?
-        });
         // Use StreamHandler for consistent stream handling
         // This follows libp2p v3 best practices for length-prefixed streaming
         await this.streamHandler.handleIncomingStream(stream, connection, async (request, stream) => {

package/dist/src/utils/connection.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connection.utils.d.ts","sourceRoot":"","sources":["../../../src/utils/connection.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA2B,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAuB,OAAO,EAAE,MAAM,eAAe,CAAC;AAI7D,qBAAa,eAAgB,SAAQ,OAAO;IAC1C;;;OAGG;mBACkB,kBAAkB;WAmCnB,qBAAqB,CAAC,OAAO,EAAE;QACjD,WAAW,EAAE,GAAG,CAAC;QACjB,UAAU,EAAE,UAAU,CAAC;KACxB;CA8DF"}
+{"version":3,"file":"connection.utils.d.ts","sourceRoot":"","sources":["../../../src/utils/connection.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA2B,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAuB,OAAO,EAAE,MAAM,eAAe,CAAC;AAI7D,qBAAa,eAAgB,SAAQ,OAAO;IAC1C;;;OAGG;mBACkB,kBAAkB;WAgCnB,qBAAqB,CAAC,OAAO,EAAE;QACjD,WAAW,EAAE,GAAG,CAAC;QACjB,UAAU,EAAE,UAAU,CAAC;KACxB;CA0DF"}

package/dist/src/utils/connection.utils.js

@@ -17,7 +17,6 @@ export class ConnectionUtils extends oObject {
             });
             // Check if peer exists and has sufficient protocol information
             if (remotePeer && remotePeer.protocols.length > MIN_PROTOCOLS) {
-                console.log(`Peer found in store after ${attempt} attempts (${attempt * RETRY_DELAY_MS}ms)`);
                 return remotePeer;
             }
             // Wait before next retry
@@ -41,7 +40,6 @@ export class ConnectionUtils extends oObject {
             if (!originAddress) {
                 throw new Error('Origin address is not configured');
             }
-            console.log('Deriving address from connection protocols:', remotePeer.protocols);
             const oProtocol = remotePeer.protocols.find((p) => p.startsWith('/o/') &&
                 p.includes(currentNode?.address?.protocol) === false);
             if (!oProtocol) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@olane/o-node",
-  "version": "0.7.48",
+  "version": "0.7.50",
   "type": "module",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",
@@ -40,7 +40,7 @@
   "devDependencies": {
     "@eslint/eslintrc": "^3.3.1",
     "@eslint/js": "^9.29.0",
-    "@olane/o-test": "0.7.48",
+    "@olane/o-test": "0.7.50",
     "@tsconfig/node20": "^20.1.6",
     "@types/jest": "^30.0.0",
     "@types/json5": "^2.2.0",
@@ -60,13 +60,13 @@
     "typescript": "5.4.5"
   },
   "dependencies": {
-    "@olane/o-config": "0.7.48",
-    "@olane/o-core": "0.7.48",
-    "@olane/o-protocol": "0.7.48",
-    "@olane/o-tool": "0.7.48",
+    "@olane/o-config": "0.7.50",
+    "@olane/o-core": "0.7.50",
+    "@olane/o-protocol": "0.7.50",
+    "@olane/o-tool": "0.7.50",
     "debug": "^4.4.1",
     "dotenv": "^16.5.0",
     "json5": "^2.2.3"
   },
-  "gitHead": "1810818bb9682b586e9db2febcc2a89da5057449"
+  "gitHead": "55f5464185ef16a164fa23dc46c0c08b317419a0"
 }