@olane/o-client-limited 0.7.50 → 0.7.51

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

@@ -1,10 +1,41 @@
 import { oNodeConnection } from '@olane/o-node';
 import type { oNodeConnectionConfig } from '@olane/o-node';
 /**
- * oLimitedConnection extends oNodeConnection with stream reuse enabled
+ * oLimitedConnection extends oNodeConnection with stream reuse and pool management.
+ *
  * This is optimized for limited connections where creating new streams is expensive
+ * (mobile clients, browsers, resource-constrained environments).
+ *
+ * Stream Pool Architecture (10 streams total):
+ * - Stream 0: Dedicated background reader for incoming requests
+ * - Streams 1-9: Round-robin pool for outgoing request-response cycles
+ *
+ * Features:
+ * - Automatic recovery when dedicated reader fails
+ * - Health monitoring of all pooled streams
+ * - Automatic stream replacement on failure
+ * - Event emission for monitoring (reader-failed, stream-replaced, etc.)
+ *
+ * Default Behavior:
+ * - Uses 'reuse' stream policy by default
+ * - Automatically initializes pool manager on first stream request
  */
 export declare class oLimitedConnection extends oNodeConnection {
+    private streamPoolManager?;
+    private poolInitialized;
     constructor(config: oNodeConnectionConfig);
+    /**
+     * Initialize the stream pool manager
+     */
+    private initializePoolManager;
+    getOrCreateStream(): Promise<any>;
+    /**
+     * Get stream pool statistics
+     */
+    getPoolStats(): import("@olane/o-node").StreamPoolStats | undefined;
+    /**
+     * Override close to cleanup pool manager
+     */
+    close(): Promise<void>;
 }
 //# sourceMappingURL=o-limited-connection.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"o-limited-connection.d.ts","sourceRoot":"","sources":["../../../src/connection/o-limited-connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE3D;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,eAAe;gBACzC,MAAM,EAAE,qBAAqB;CAQ1C"}
+{"version":3,"file":"o-limited-connection.d.ts","sourceRoot":"","sources":["../../../src/connection/o-limited-connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAqB,MAAM,eAAe,CAAC;AACnE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,kBAAmB,SAAQ,eAAe;IACrD,OAAO,CAAC,iBAAiB,CAAC,CAAoB;IAC9C,OAAO,CAAC,eAAe,CAAS;gBAEpB,MAAM,EAAE,qBAAqB;IASzC;;OAEG;YACW,qBAAqB;IAqC7B,iBAAiB,IAAI,OAAO,CAAC,GAAG,CAAC;IAevC;;OAEG;IACH,YAAY;IAIZ;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAY7B"}

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

@@ -1,7 +1,23 @@
-import { oNodeConnection } from '@olane/o-node';
+import { oNodeConnection, StreamPoolManager } from '@olane/o-node';
 /**
- * oLimitedConnection extends oNodeConnection with stream reuse enabled
+ * oLimitedConnection extends oNodeConnection with stream reuse and pool management.
+ *
  * This is optimized for limited connections where creating new streams is expensive
+ * (mobile clients, browsers, resource-constrained environments).
+ *
+ * Stream Pool Architecture (10 streams total):
+ * - Stream 0: Dedicated background reader for incoming requests
+ * - Streams 1-9: Round-robin pool for outgoing request-response cycles
+ *
+ * Features:
+ * - Automatic recovery when dedicated reader fails
+ * - Health monitoring of all pooled streams
+ * - Automatic stream replacement on failure
+ * - Event emission for monitoring (reader-failed, stream-replaced, etc.)
+ *
+ * Default Behavior:
+ * - Uses 'reuse' stream policy by default
+ * - Automatically initializes pool manager on first stream request
  */
 export class oLimitedConnection extends oNodeConnection {
     constructor(config) {
@@ -10,6 +26,69 @@ export class oLimitedConnection extends oNodeConnection {
             ...config,
             reusePolicy: reusePolicy,
         });
+        this.poolInitialized = false;
         this.reusePolicy = reusePolicy;
     }
+    /**
+     * Initialize the stream pool manager
+     */
+    async initializePoolManager() {
+        if (this.poolInitialized || this.streamPoolManager) {
+            return;
+        }
+        this.logger.debug('Initializing stream pool manager');
+        this.streamPoolManager = new StreamPoolManager({
+            poolSize: 10,
+            readerStreamIndex: 0,
+            streamHandler: this.streamHandler,
+            p2pConnection: this.p2pConnection,
+            requestHandler: this.config.requestHandler,
+            createStream: async () => {
+                return await super.getOrCreateStream();
+            },
+        });
+        // Set up event listeners for monitoring
+        this.streamPoolManager.on('reader-failed', (data) => {
+            this.logger.warn('Stream pool reader failed', data);
+        });
+        this.streamPoolManager.on('reader-recovered', (data) => {
+            this.logger.info('Stream pool reader recovered', data);
+        });
+        this.streamPoolManager.on('stream-replaced', (data) => {
+            this.logger.info('Stream replaced in pool', data);
+        });
+        await this.streamPoolManager.initialize();
+        this.poolInitialized = true;
+        this.logger.info('Stream pool manager initialized successfully');
+    }
+    async getOrCreateStream() {
+        if (this.reusePolicy === 'reuse') {
+            // Initialize pool manager on first call
+            if (!this.poolInitialized) {
+                await this.initializePoolManager();
+            }
+            // Delegate to pool manager for stream selection
+            return await this.streamPoolManager.getStream();
+        }
+        // Fallback to default behavior if reuse is not enabled
+        return super.getOrCreateStream();
+    }
+    /**
+     * Get stream pool statistics
+     */
+    getPoolStats() {
+        return this.streamPoolManager?.getStats();
+    }
+    /**
+     * Override close to cleanup pool manager
+     */
+    async close() {
+        this.logger.debug('Closing connection and stream pool manager');
+        if (this.streamPoolManager) {
+            await this.streamPoolManager.close();
+            this.streamPoolManager = undefined;
+        }
+        this.poolInitialized = false;
+        await super.close();
+    }
 }

package/dist/src/o-limited.tool.d.ts

@@ -1,15 +1,8 @@
 import { oNodeConnection, oNodeConnectionConfig, oNodeTool } from '@olane/o-node';
 import { oNodeConfig } from '@olane/o-node';
 export declare class oLimitedTool extends oNodeTool {
-    protected backgroundReaders: Map<string, boolean>;
     constructor(config: oNodeConfig);
     connect(config: oNodeConnectionConfig): Promise<oNodeConnection>;
-    /**
-     * Start a background reader on the stream to handle incoming requests.
-     * Uses handleIncomingStream which runs a persistent while loop,
-     * allowing the stream to receive multiple messages over its lifetime.
-     */
-    private startBackgroundReader;
     initConnectionManager(): Promise<void>;
 }
 //# sourceMappingURL=o-limited.tool.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"o-limited.tool.d.ts","sourceRoot":"","sources":["../../src/o-limited.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,SAAS,EACV,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAI5C,qBAAa,YAAa,SAAQ,SAAS;IACzC,SAAS,CAAC,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAa;gBAElD,MAAM,EAAE,WAAW;IAUzB,OAAO,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IA2BtE;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IA8CvB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ7C"}
+{"version":3,"file":"o-limited.tool.d.ts","sourceRoot":"","sources":["../../src/o-limited.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,SAAS,EACV,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,qBAAa,YAAa,SAAQ,SAAS;gBAC7B,MAAM,EAAE,WAAW;IAUzB,OAAO,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IAkBhE,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ7C"}

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

@@ -9,7 +9,6 @@ export class oLimitedTool extends oNodeTool {
                 listeners: config.network?.listeners || [], // default to no listeners
             },
         });
-        this.backgroundReaders = new Map();
     }
     async connect(config) {
         this.handleProtocol(config.nextHopAddress).catch((error) => {
@@ -17,51 +16,14 @@ export class oLimitedTool extends oNodeTool {
         });
         // Inject requestHandler to enable bidirectional stream processing
         // This allows incoming router requests to be processed through the tool's execute method
+        // The StreamPoolManager (in oLimitedConnection) will use this handler for the dedicated reader
         const configWithHandler = {
             ...config,
             requestHandler: this.execute.bind(this),
         };
         const connection = await super.connect(configWithHandler);
-        // Hook postTransmit to start background reader for reuse streams
-        const originalPostTransmit = connection.postTransmit.bind(connection);
-        connection.postTransmit = async (stream) => {
-            // Start background reader for bidirectional communication on reuse streams
-            if (connection.reusePolicy === 'reuse') {
-                this.startBackgroundReader(stream, connection);
-            }
-            await originalPostTransmit(stream);
-        };
         return connection;
     }
-    /**
-     * Start a background reader on the stream to handle incoming requests.
-     * Uses handleIncomingStream which runs a persistent while loop,
-     * allowing the stream to receive multiple messages over its lifetime.
-     */
-    startBackgroundReader(stream, connection) {
-        const streamId = stream.p2pStream?.id || stream.id;
-        // Don't start duplicate readers for the same stream
-        if (this.backgroundReaders.get(streamId)) {
-            this.logger.debug('Background reader already running for stream:', streamId);
-            return;
-        }
-        this.backgroundReaders.set(streamId, true);
-        this.logger.debug('Starting background reader for stream:', streamId);
-        // Get the raw p2p stream
-        const p2pStream = stream.p2pStream || stream;
-        // Use the connection's streamHandler to handle incoming requests
-        const streamHandler = connection.streamHandler;
-        // Start the persistent read loop in the background
-        streamHandler
-            .handleIncomingStream(p2pStream, connection.p2pConnection, async (request, s) => {
-            this.logger.debug('Background reader received request:', request.method);
-            return this.execute(request, s);
-        })
-            .catch((error) => {
-            this.logger.debug('Background reader exited:', error?.message || 'stream closed');
-            this.backgroundReaders.delete(streamId);
-        });
-    }
     async initConnectionManager() {
         this.connectionManager = new oLimitedConnectionManager({
             p2pNode: this.p2pNode,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@olane/o-client-limited",
-  "version": "0.7.50",
+  "version": "0.7.51",
   "type": "module",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",
@@ -53,13 +53,13 @@
     "typescript": "5.4.5"
   },
   "dependencies": {
-    "@olane/o-config": "0.7.50",
-    "@olane/o-core": "0.7.50",
-    "@olane/o-node": "0.7.50",
-    "@olane/o-protocol": "0.7.50",
-    "@olane/o-tool": "0.7.50",
+    "@olane/o-config": "0.7.51",
+    "@olane/o-core": "0.7.51",
+    "@olane/o-node": "0.7.51",
+    "@olane/o-protocol": "0.7.51",
+    "@olane/o-tool": "0.7.51",
     "debug": "^4.4.1",
     "dotenv": "^16.5.0"
   },
-  "gitHead": "55f5464185ef16a164fa23dc46c0c08b317419a0"
+  "gitHead": "f770a110369cb9791d9e9208c7a084feecbb9b2c"
 }