@olane/o-core 0.7.12-alpha.22 → 0.7.12-alpha.24

package/dist/src/connection/interfaces/connection-manager.config.d.ts

@@ -1,3 +1,15 @@
 export interface oConnectionManagerConfig {
+    /**
+     * Default timeout in milliseconds for reading response data from a stream.
+     * Can be overridden per connection.
+     * Default: 120000 (2 minutes)
+     */
+    defaultReadTimeoutMs?: number;
+    /**
+     * Default timeout in milliseconds for waiting for stream buffer to drain when backpressure occurs.
+     * Can be overridden per connection.
+     * Default: 30000 (30 seconds)
+     */
+    defaultDrainTimeoutMs?: number;
 }
 //# sourceMappingURL=connection-manager.config.d.ts.map

package/dist/src/connection/interfaces/connection-manager.config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connection-manager.config.d.ts","sourceRoot":"","sources":["../../../../src/connection/interfaces/connection-manager.config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;CAAG"}
+{"version":3,"file":"connection-manager.config.d.ts","sourceRoot":"","sources":["../../../../src/connection/interfaces/connection-manager.config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC"}

package/dist/src/connection/interfaces/connection-send-params.interface.d.ts

@@ -4,5 +4,6 @@ export interface ConnectionSendParams {
         [key: string]: unknown;
     };
     id?: string;
+    isStream?: boolean;
 }
 //# sourceMappingURL=connection-send-params.interface.d.ts.map

package/dist/src/connection/interfaces/connection-send-params.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connection-send-params.interface.d.ts","sourceRoot":"","sources":["../../../../src/connection/interfaces/connection-send-params.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QACP,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,EAAE,CAAC,EAAE,MAAM,CAAC;CACb"}
+{"version":3,"file":"connection-send-params.interface.d.ts","sourceRoot":"","sources":["../../../../src/connection/interfaces/connection-send-params.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QACP,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB"}

package/dist/src/connection/interfaces/connection.config.d.ts

@@ -3,5 +3,16 @@ export interface oConnectionConfig {
     nextHopAddress: oAddress;
     callerAddress?: oAddress;
     address: oAddress;
+    /**
+     * 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;
+    isStream?: boolean;
 }
 //# sourceMappingURL=connection.config.d.ts.map

package/dist/src/connection/interfaces/connection.config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connection.config.d.ts","sourceRoot":"","sources":["../../../../src/connection/interfaces/connection.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAErD,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,QAAQ,CAAC;IACzB,aAAa,CAAC,EAAE,QAAQ,CAAC;IACzB,OAAO,EAAE,QAAQ,CAAC;CACnB"}
+{"version":3,"file":"connection.config.d.ts","sourceRoot":"","sources":["../../../../src/connection/interfaces/connection.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAErD,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,QAAQ,CAAC;IACzB,aAAa,CAAC,EAAE,QAAQ,CAAC;IACzB,OAAO,EAAE,QAAQ,CAAC;IAClB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB"}

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

@@ -4,13 +4,16 @@ import { oResponse } from './o-response.js';
 import { ConnectionSendParams } from './interfaces/connection-send-params.interface.js';
 import { oObject } from '../core/o-object.js';
 import { oConnectionConfig } from './interfaces/connection.config.js';
+import { EventEmitter } from 'events';
 export declare abstract class oConnection extends oObject {
     protected readonly config: oConnectionConfig;
     readonly id: string;
     readonly address: oAddress;
     readonly nextHopAddress: oAddress;
     readonly callerAddress: oAddress | undefined;
+    protected readonly emitter: EventEmitter;
     constructor(config: oConnectionConfig);
+    onChunk(listener: (response: oResponse) => void): void;
     validate(): void;
     createRequest(method: string, params: ConnectionSendParams): oRequest;
     abstract transmit(request: oRequest): Promise<oResponse>;

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

@@ -1 +1 @@
-{"version":3,"file":"o-connection.d.ts","sourceRoot":"","sources":["../../../src/connection/o-connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,kDAAkD,CAAC;AAExF,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAEtE,8BAAsB,WAAY,SAAQ,OAAO;IAMnC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,iBAAiB;IALxD,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,SAAgB,OAAO,EAAE,QAAQ,CAAC;IAClC,SAAgB,cAAc,EAAE,QAAQ,CAAC;IACzC,SAAgB,aAAa,EAAE,QAAQ,GAAG,SAAS,CAAC;gBAErB,MAAM,EAAE,iBAAiB;IAgBxD,QAAQ,IAAI,IAAI;IAMhB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,QAAQ;IAarE,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC;IAElD,IAAI,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,CAAC;IAOpD,KAAK;CAGZ"}
+{"version":3,"file":"o-connection.d.ts","sourceRoot":"","sources":["../../../src/connection/o-connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,kDAAkD,CAAC;AAExF,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,8BAAsB,WAAY,SAAQ,OAAO;IAOnC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,iBAAiB;IANxD,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,SAAgB,OAAO,EAAE,QAAQ,CAAC;IAClC,SAAgB,cAAc,EAAE,QAAQ,CAAC;IACzC,SAAgB,aAAa,EAAE,QAAQ,GAAG,SAAS,CAAC;IACpD,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAsB;gBAE/B,MAAM,EAAE,iBAAiB;IAgBxD,OAAO,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,SAAS,KAAK,IAAI;IAI/C,QAAQ,IAAI,IAAI;IAMhB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,QAAQ;IAcrE,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC;IAElD,IAAI,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,CAAC;IAMpD,KAAK;CAGZ"}

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

@@ -2,10 +2,12 @@ import { oRequest } from './o-request.js';
 import { oProtocolMethods } from '@olane/o-protocol';
 import { v4 as uuidv4 } from 'uuid';
 import { oObject } from '../core/o-object.js';
+import { EventEmitter } from 'events';
 export class oConnection extends oObject {
     constructor(config) {
         super();
         this.config = config;
+        this.emitter = new EventEmitter();
         this.id = uuidv4();
         this.address = config.address;
         this.nextHopAddress = config.nextHopAddress;
@@ -17,6 +19,9 @@ export class oConnection extends oObject {
             ']:' +
             this.id);
     }
+    onChunk(listener) {
+        this.emitter.addListener('chunk', listener);
+    }
     validate() {
         if (!this.address || !this.nextHopAddress || !this.callerAddress) {
             throw new Error('Connection configuration is invalid');
@@ -29,6 +34,7 @@ export class oConnection extends oObject {
                 _connectionId: this.id,
                 _requestMethod: method,
                 _callerAddress: this.callerAddress?.value,
+                _isStream: this.config.isStream || false,
                 ...params,
             },
             id: params.id || uuidv4(),
@@ -37,8 +43,7 @@ export class oConnection extends oObject {
     async send(data) {
         // proxy through the router tool
         const request = this.createRequest(oProtocolMethods.ROUTE, data);
-        const result = await this.transmit(request);
-        return result;
+        return this.transmit(request);
     }
     async close() {
         this.logger.debug('Closing connection...');

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

@@ -16,6 +16,7 @@ import { oRouter } from '../router/o-router.js';
 import { oRequest } from '../connection/o-request.js';
 import { oNotificationManager } from './lib/o-notification.manager.js';
 import { oNotificationEvent, EventFilter, NotificationHandler, Subscription } from './lib/events/index.js';
+import { oConnectionConfig } from '../connection/index.js';
 export declare abstract class oCore extends oObject {
     readonly config: oCoreConfig;
     address: oAddress;
@@ -32,6 +33,15 @@ export declare abstract class oCore extends oObject {
     get isLeader(): boolean;
     get leader(): oAddress | null;
     abstract configureTransports(): any[];
+    useStream(address: oAddress, data: {
+        method?: string;
+        params?: {
+            [key: string]: any;
+        };
+        id?: string;
+    }, options: {
+        onChunk?: (chunk: oResponse) => void;
+    }): Promise<oResponse>;
     useDirect(address: oAddress, data?: {
         method?: string;
         params?: {
@@ -100,6 +110,10 @@ export declare abstract class oCore extends oObject {
         id?: string;
     }, options?: {
         noRouting?: boolean;
+        readTimeoutMs?: number;
+        drainTimeoutMs?: number;
+        isStream?: boolean;
+        onChunk?: (chunk: oResponse) => void;
     }): Promise<oResponse>;
     abstract execute(request: oRequest): Promise<any>;
     useSelf(data?: {
@@ -115,10 +129,13 @@ export declare abstract class oCore extends oObject {
             [key: string]: any;
         };
         id?: string;
+    }, options?: {
+        isStream?: boolean;
+        onChunk?: (chunk: oResponse) => void;
     }): Promise<oResponse>;
     addChildNode(node: oCore): void;
     removeChildNode(node: oCore): void;
-    abstract connect(nextHopAddress: oAddress, targetAddress: oAddress): Promise<oConnection>;
+    abstract connect(config: oConnectionConfig): Promise<oConnection>;
     abstract initializeRouter(): void;
     abstract unregister(): Promise<void>;
     abstract register(): Promise<void>;

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

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

package/dist/src/core/o-core.js

@@ -30,6 +30,12 @@ export class oCore extends oObject {
     get leader() {
         return this.isLeader ? this.address : this.config?.leader || null;
     }
+    async useStream(address, data, options) {
+        return this.use(address, data, {
+            isStream: true,
+            onChunk: options.onChunk,
+        });
+    }
     async useDirect(address, data) {
         return this.use(address, data, { noRouting: true });
     }
@@ -109,13 +115,29 @@ export class oCore extends oObject {
         if (nextHopAddress.toStaticAddress().equals(this.address.toStaticAddress())) {
             return this.useSelf(data);
         }
-        const connection = await this.connect(nextHopAddress, targetAddress);
+        const connection = await this.connect({
+            nextHopAddress: nextHopAddress,
+            address: targetAddress,
+            callerAddress: this.address,
+            readTimeoutMs: options?.readTimeoutMs,
+            drainTimeoutMs: options?.drainTimeoutMs,
+            isStream: options?.isStream,
+        });
+        if (options?.isStream) {
+            connection.onChunk((response) => {
+                options.onChunk?.(response);
+            });
+        }
         // communicate the payload to the target node
         const response = await connection.send({
             address: targetAddress?.toString() || '',
             payload: data || {},
             id: data?.id,
         });
+        // we handle streaming response differently
+        if (options?.isStream) {
+            return response;
+        }
         // if there is an error, throw it to continue to bubble up
         if (response.result.error) {
             this.logger.error('response.result.error', JSON.stringify(response.result.error, null, 2));
@@ -157,7 +179,7 @@ export class oCore extends oObject {
         }
         return CoreUtils.buildResponse(request, result, result?.error);
     }
-    async useChild(childAddress, data) {
+    async useChild(childAddress, data, options) {
         if (!this.isRunning) {
             throw new Error('Node is not running');
         }
@@ -171,7 +193,11 @@ export class oCore extends oObject {
                 childAddress.setTransports(child?.transports || []);
             }
         }
-        const connection = await this.connect(childAddress, childAddress);
+        const connection = await this.connect({
+            nextHopAddress: childAddress,
+            address: childAddress,
+            callerAddress: this.address,
+        });
         // communicate the payload to the target node
         const response = await connection.send({
             address: childAddress?.toString() || '',

package/dist/src/error/enums/codes.error.d.ts

@@ -14,6 +14,7 @@ export declare enum oErrorCodes {
     TRANSPORT_NOT_SUPPORTED = 1013,
     FAILED_TO_DIAL_TARGET = 1014,
     INVALID_CAPABILITY = 1015,
-    CONNECTION_LIMIT_REACHED = 1016
+    CONNECTION_LIMIT_REACHED = 1016,
+    TIMEOUT = 1017
 }
 //# sourceMappingURL=codes.error.d.ts.map

package/dist/src/error/enums/codes.error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codes.error.d.ts","sourceRoot":"","sources":["../../../../src/error/enums/codes.error.ts"],"names":[],"mappings":"AAAA,oBAAY,WAAW;IACrB,OAAO,OAAO;IACd,SAAS,OAAO;IAChB,eAAe,OAAO;IACtB,cAAc,OAAO;IACrB,cAAc,OAAO;IACrB,kBAAkB,OAAO;IACzB,kBAAkB,OAAO;IACzB,gBAAgB,OAAO;IACvB,eAAe,OAAO;IACtB,aAAa,OAAO;IACpB,cAAc,OAAO;IACrB,mBAAmB,OAAO;IAC1B,uBAAuB,OAAO;IAC9B,qBAAqB,OAAO;IAC5B,kBAAkB,OAAO;IACzB,wBAAwB,OAAO;CAChC"}
+{"version":3,"file":"codes.error.d.ts","sourceRoot":"","sources":["../../../../src/error/enums/codes.error.ts"],"names":[],"mappings":"AAAA,oBAAY,WAAW;IACrB,OAAO,OAAO;IACd,SAAS,OAAO;IAChB,eAAe,OAAO;IACtB,cAAc,OAAO;IACrB,cAAc,OAAO;IACrB,kBAAkB,OAAO;IACzB,kBAAkB,OAAO;IACzB,gBAAgB,OAAO;IACvB,eAAe,OAAO;IACtB,aAAa,OAAO;IACpB,cAAc,OAAO;IACrB,mBAAmB,OAAO;IAC1B,uBAAuB,OAAO;IAC9B,qBAAqB,OAAO;IAC5B,kBAAkB,OAAO;IACzB,wBAAwB,OAAO;IAC/B,OAAO,OAAO;CACf"}

package/dist/src/error/enums/codes.error.js

@@ -16,4 +16,5 @@ export var oErrorCodes;
     oErrorCodes[oErrorCodes["FAILED_TO_DIAL_TARGET"] = 1014] = "FAILED_TO_DIAL_TARGET";
     oErrorCodes[oErrorCodes["INVALID_CAPABILITY"] = 1015] = "INVALID_CAPABILITY";
     oErrorCodes[oErrorCodes["CONNECTION_LIMIT_REACHED"] = 1016] = "CONNECTION_LIMIT_REACHED";
+    oErrorCodes[oErrorCodes["TIMEOUT"] = 1017] = "TIMEOUT";
 })(oErrorCodes || (oErrorCodes = {}));

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

@@ -0,0 +1,11 @@
+/**
+ * Streaming functionality for o-core
+ *
+ * This module provides transport-agnostic abstractions for streaming operations
+ * that can be used by o-node, o-client, o-browser, and other implementations.
+ */
+export { IStreamTransport, StreamStatus, StreamTransportConfig, } from './stream-transport.interface.js';
+export { StreamConfig, DEFAULT_STREAM_CONFIG, mergeStreamConfig, } from './stream-config.js';
+export { ProtocolBuilder, ParsedStreamChunk, } from './protocol-builder.js';
+export { StreamHandlerBase, StreamHandlerState, StreamHandlerOptions, } from './stream-handler.base.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/streaming/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,qBAAqB,GACtB,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,eAAe,EACf,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC"}

package/dist/src/streaming/index.js

@@ -0,0 +1,14 @@
+/**
+ * Streaming functionality for o-core
+ *
+ * This module provides transport-agnostic abstractions for streaming operations
+ * that can be used by o-node, o-client, o-browser, and other implementations.
+ */
+// Stream transport interface and types
+export { StreamStatus, } from './stream-transport.interface.js';
+// Stream configuration
+export { DEFAULT_STREAM_CONFIG, mergeStreamConfig, } from './stream-config.js';
+// Protocol builder for JSON-RPC streaming messages
+export { ProtocolBuilder, } from './protocol-builder.js';
+// Base stream handler class
+export { StreamHandlerBase, StreamHandlerState, } from './stream-handler.base.js';

package/dist/src/streaming/protocol-builder.d.ts

@@ -0,0 +1,62 @@
+import { JSONRPCStreamChunk, RequestId, ConnectionId, oRequest } from '@olane/o-protocol';
+/**
+ * Parsed streaming chunk data
+ */
+export interface ParsedStreamChunk {
+    data: unknown;
+    sequence: number;
+    isLast: boolean;
+    connectionId: ConnectionId;
+    requestMethod: string;
+}
+/**
+ * Builder class for constructing and parsing JSON-RPC streaming protocol messages.
+ * Provides type-safe message construction and parsing for streaming responses.
+ */
+export declare class ProtocolBuilder {
+    /**
+     * Build a JSON-RPC streaming chunk message
+     * @param data - The data payload for this chunk
+     * @param sequence - The sequence number of this chunk (starts at 1)
+     * @param isLast - Whether this is the final chunk in the stream
+     * @param requestId - The JSON-RPC request ID this chunk is responding to
+     * @param connectionId - The connection ID from the original request
+     * @param requestMethod - The method name from the original request
+     * @returns A complete JSON-RPC streaming chunk message
+     */
+    static buildStreamChunk(data: unknown, sequence: number, isLast: boolean, requestId: RequestId, connectionId: ConnectionId, requestMethod: string): JSONRPCStreamChunk;
+    /**
+     * Build a streaming chunk from an oRequest object
+     * @param data - The data payload for this chunk
+     * @param sequence - The sequence number of this chunk
+     * @param isLast - Whether this is the final chunk
+     * @param request - The original oRequest
+     * @returns A complete JSON-RPC streaming chunk message
+     */
+    static buildStreamChunkFromRequest(data: unknown, sequence: number, isLast: boolean, request: oRequest): JSONRPCStreamChunk;
+    /**
+     * Parse a JSON-RPC response to extract streaming chunk data
+     * @param message - The parsed JSON-RPC message
+     * @returns Parsed chunk data if this is a streaming response, null otherwise
+     */
+    static parseStreamChunk(message: any): ParsedStreamChunk | null;
+    /**
+     * Check if a message is a streaming response
+     * @param message - The message to check
+     * @returns true if the message is a streaming response
+     */
+    static isStreamingResponse(message: any): boolean;
+    /**
+     * Encode a message to UTF-8 bytes for transmission
+     * @param message - The message to encode
+     * @returns UTF-8 encoded bytes
+     */
+    static encodeMessage(message: JSONRPCStreamChunk): Uint8Array;
+    /**
+     * Decode UTF-8 bytes to a JSON message
+     * @param data - The UTF-8 encoded data
+     * @returns Parsed JSON message
+     */
+    static decodeMessage(data: Uint8Array): any;
+}
+//# sourceMappingURL=protocol-builder.d.ts.map

package/dist/src/streaming/protocol-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-builder.d.ts","sourceRoot":"","sources":["../../../src/streaming/protocol-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAElB,SAAS,EACT,YAAY,EAEZ,QAAQ,EACT,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,YAAY,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC1B;;;;;;;;;OASG;WACW,gBAAgB,CAC5B,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,YAAY,EAC1B,aAAa,EAAE,MAAM,GACpB,kBAAkB;IAiBrB;;;;;;;OAOG;WACW,2BAA2B,CACvC,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,QAAQ,GAChB,kBAAkB;IAWrB;;;;OAIG;WACW,gBAAgB,CAAC,OAAO,EAAE,GAAG,GAAG,iBAAiB,GAAG,IAAI;IAgBtE;;;;OAIG;WACW,mBAAmB,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO;IAaxD;;;;OAIG;WACW,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,UAAU;IAIpE;;;;OAIG;WACW,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,GAAG;CAInD"}

package/dist/src/streaming/protocol-builder.js

@@ -0,0 +1,93 @@
+import { JSONRPC_VERSION, } from '@olane/o-protocol';
+/**
+ * Builder class for constructing and parsing JSON-RPC streaming protocol messages.
+ * Provides type-safe message construction and parsing for streaming responses.
+ */
+export class ProtocolBuilder {
+    /**
+     * Build a JSON-RPC streaming chunk message
+     * @param data - The data payload for this chunk
+     * @param sequence - The sequence number of this chunk (starts at 1)
+     * @param isLast - Whether this is the final chunk in the stream
+     * @param requestId - The JSON-RPC request ID this chunk is responding to
+     * @param connectionId - The connection ID from the original request
+     * @param requestMethod - The method name from the original request
+     * @returns A complete JSON-RPC streaming chunk message
+     */
+    static buildStreamChunk(data, sequence, isLast, requestId, connectionId, requestMethod) {
+        const result = {
+            _connectionId: connectionId,
+            _requestMethod: requestMethod,
+            _streaming: true,
+            _sequence: sequence,
+            _isLast: isLast,
+            _data: data,
+        };
+        return {
+            jsonrpc: JSONRPC_VERSION,
+            id: requestId,
+            result,
+        };
+    }
+    /**
+     * Build a streaming chunk from an oRequest object
+     * @param data - The data payload for this chunk
+     * @param sequence - The sequence number of this chunk
+     * @param isLast - Whether this is the final chunk
+     * @param request - The original oRequest
+     * @returns A complete JSON-RPC streaming chunk message
+     */
+    static buildStreamChunkFromRequest(data, sequence, isLast, request) {
+        return this.buildStreamChunk(data, sequence, isLast, request.id, request.params._connectionId, request.method);
+    }
+    /**
+     * Parse a JSON-RPC response to extract streaming chunk data
+     * @param message - The parsed JSON-RPC message
+     * @returns Parsed chunk data if this is a streaming response, null otherwise
+     */
+    static parseStreamChunk(message) {
+        if (!this.isStreamingResponse(message)) {
+            return null;
+        }
+        const result = message.result;
+        return {
+            data: result._data,
+            sequence: result._sequence,
+            isLast: result._isLast,
+            connectionId: result._connectionId,
+            requestMethod: result._requestMethod,
+        };
+    }
+    /**
+     * Check if a message is a streaming response
+     * @param message - The message to check
+     * @returns true if the message is a streaming response
+     */
+    static isStreamingResponse(message) {
+        return (message &&
+            typeof message === 'object' &&
+            message.result &&
+            typeof message.result === 'object' &&
+            message.result._streaming === true &&
+            typeof message.result._sequence === 'number' &&
+            typeof message.result._isLast === 'boolean' &&
+            '_data' in message.result);
+    }
+    /**
+     * Encode a message to UTF-8 bytes for transmission
+     * @param message - The message to encode
+     * @returns UTF-8 encoded bytes
+     */
+    static encodeMessage(message) {
+        return new TextEncoder().encode(JSON.stringify(message));
+    }
+    /**
+     * Decode UTF-8 bytes to a JSON message
+     * @param data - The UTF-8 encoded data
+     * @returns Parsed JSON message
+     */
+    static decodeMessage(data) {
+        const text = new TextDecoder().decode(data);
+        return JSON.parse(text);
+    }
+}

package/dist/src/streaming/stream-config.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Configuration options for streaming operations
+ */
+export interface StreamConfig {
+    /**
+     * Timeout in milliseconds for waiting to read the first chunk
+     * @default 120000 (2 minutes)
+     */
+    readTimeoutMs: number;
+    /**
+     * Timeout in milliseconds for drain operations when handling backpressure
+     * @default 30000 (30 seconds)
+     */
+    drainTimeoutMs: number;
+    /**
+     * Maximum size of a single chunk in bytes (optional)
+     * If not set, chunks can be any size
+     */
+    maxChunkSize?: number;
+    /**
+     * Enable metrics tracking for streaming operations
+     * @default true
+     */
+    enableMetrics?: boolean;
+}
+/**
+ * Default configuration for streaming operations
+ */
+export declare const DEFAULT_STREAM_CONFIG: StreamConfig;
+/**
+ * Merge user config with defaults
+ * @param userConfig - Partial user configuration
+ * @returns Complete configuration with defaults applied
+ */
+export declare function mergeStreamConfig(userConfig?: Partial<StreamConfig>): StreamConfig;
+//# sourceMappingURL=stream-config.d.ts.map

package/dist/src/streaming/stream-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-config.d.ts","sourceRoot":"","sources":["../../../src/streaming/stream-config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,YAInC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GACjC,YAAY,CAKd"}

package/dist/src/streaming/stream-config.js

@@ -0,0 +1,19 @@
+/**
+ * Default configuration for streaming operations
+ */
+export const DEFAULT_STREAM_CONFIG = {
+    readTimeoutMs: 120000, // 2 minutes
+    drainTimeoutMs: 30000, // 30 seconds
+    enableMetrics: true,
+};
+/**
+ * Merge user config with defaults
+ * @param userConfig - Partial user configuration
+ * @returns Complete configuration with defaults applied
+ */
+export function mergeStreamConfig(userConfig) {
+    return {
+        ...DEFAULT_STREAM_CONFIG,
+        ...userConfig,
+    };
+}

package/dist/src/streaming/stream-handler.base.d.ts

@@ -0,0 +1,85 @@
+import { oError } from '../error/o-error.js';
+import { oRequest } from '@olane/o-protocol';
+/**
+ * State machine states for streaming operations
+ */
+export declare enum StreamHandlerState {
+    IDLE = "idle",
+    STREAMING = "streaming",
+    COMPLETED = "completed",
+    ERROR = "error"
+}
+/**
+ * Options for stream handler operations
+ */
+export interface StreamHandlerOptions {
+    /**
+     * Enable metrics tracking
+     */
+    enableMetrics?: boolean;
+}
+/**
+ * Abstract base class for handling streaming operations.
+ * Provides transport-agnostic AsyncGenerator iteration, chunk sequencing,
+ * error handling, and state management.
+ *
+ * Implementations must provide the sendChunk method for transport-specific
+ * chunk transmission.
+ */
+export declare abstract class StreamHandlerBase {
+    protected state: StreamHandlerState;
+    protected currentSequence: number;
+    protected options: StreamHandlerOptions;
+    constructor(options?: StreamHandlerOptions);
+    /**
+     * Get the current state of the stream handler
+     */
+    getState(): StreamHandlerState;
+    /**
+     * Get the current sequence number
+     */
+    getCurrentSequence(): number;
+    /**
+     * Abstract method that implementations must provide to send a chunk.
+     * This method should handle the actual transmission using the specific transport.
+     *
+     * @param chunk - The data chunk to send
+     * @param sequence - The sequence number of this chunk
+     * @param isLast - Whether this is the final chunk
+     * @param request - The original request
+     */
+    protected abstract sendChunk(chunk: unknown, sequence: number, isLast: boolean, request: oRequest): Promise<void>;
+    /**
+     * Optional hook called when streaming starts
+     */
+    protected onStreamStart?(request: oRequest): void;
+    /**
+     * Optional hook called when streaming completes successfully
+     */
+    protected onStreamComplete?(request: oRequest, totalChunks: number): void;
+    /**
+     * Optional hook called when streaming encounters an error
+     */
+    protected onStreamError?(request: oRequest, error: oError): void;
+    /**
+     * Handle streaming of an AsyncGenerator.
+     * Iterates through the generator, sends each chunk with proper sequencing,
+     * and handles errors appropriately.
+     *
+     * @param generator - The AsyncGenerator to stream
+     * @param request - The original request
+     * @returns Promise that resolves when streaming is complete
+     */
+    handleStream(generator: AsyncGenerator<any>, request: oRequest): Promise<void>;
+    /**
+     * Convert any error to an oError instance
+     * @param error - The error to convert
+     * @returns An oError instance
+     */
+    protected convertToOError(error: unknown): oError;
+    /**
+     * Reset the handler state for reuse
+     */
+    reset(): void;
+}
+//# sourceMappingURL=stream-handler.base.d.ts.map

package/dist/src/streaming/stream-handler.base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-handler.base.d.ts","sourceRoot":"","sources":["../../../src/streaming/stream-handler.base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C;;GAEG;AACH,oBAAY,kBAAkB;IAC5B,IAAI,SAAS;IACb,SAAS,cAAc;IACvB,SAAS,cAAc;IACvB,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,8BAAsB,iBAAiB;IACrC,SAAS,CAAC,KAAK,EAAE,kBAAkB,CAA2B;IAC9D,SAAS,CAAC,eAAe,EAAE,MAAM,CAAK;IACtC,SAAS,CAAC,OAAO,EAAE,oBAAoB,CAAC;gBAE5B,OAAO,GAAE,oBAAyB;IAO9C;;OAEG;IACI,QAAQ,IAAI,kBAAkB;IAIrC;;OAEG;IACI,kBAAkB,IAAI,MAAM;IAInC;;;;;;;;OAQG;IACH,SAAS,CAAC,QAAQ,CAAC,SAAS,CAC1B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,QAAQ,GAChB,OAAO,CAAC,IAAI,CAAC;IAEhB;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,CAAC,OAAO,EAAE,QAAQ,GAAG,IAAI;IAEjD;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAEzE;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAEhE;;;;;;;;OAQG;IACU,YAAY,CACvB,SAAS,EAAE,cAAc,CAAC,GAAG,CAAC,EAC9B,OAAO,EAAE,QAAQ,GAChB,OAAO,CAAC,IAAI,CAAC;IAqDhB;;;;OAIG;IACH,SAAS,CAAC,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;IAoBjD;;OAEG;IACI,KAAK,IAAI,IAAI;CAIrB"}

package/dist/src/streaming/stream-handler.base.js

@@ -0,0 +1,112 @@
+import { oError } from '../error/o-error.js';
+import { oErrorCodes } from '../error/enums/codes.error.js';
+/**
+ * State machine states for streaming operations
+ */
+export var StreamHandlerState;
+(function (StreamHandlerState) {
+    StreamHandlerState["IDLE"] = "idle";
+    StreamHandlerState["STREAMING"] = "streaming";
+    StreamHandlerState["COMPLETED"] = "completed";
+    StreamHandlerState["ERROR"] = "error";
+})(StreamHandlerState || (StreamHandlerState = {}));
+/**
+ * Abstract base class for handling streaming operations.
+ * Provides transport-agnostic AsyncGenerator iteration, chunk sequencing,
+ * error handling, and state management.
+ *
+ * Implementations must provide the sendChunk method for transport-specific
+ * chunk transmission.
+ */
+export class StreamHandlerBase {
+    constructor(options = {}) {
+        this.state = StreamHandlerState.IDLE;
+        this.currentSequence = 0;
+        this.options = {
+            enableMetrics: true,
+            ...options,
+        };
+    }
+    /**
+     * Get the current state of the stream handler
+     */
+    getState() {
+        return this.state;
+    }
+    /**
+     * Get the current sequence number
+     */
+    getCurrentSequence() {
+        return this.currentSequence;
+    }
+    /**
+     * Handle streaming of an AsyncGenerator.
+     * Iterates through the generator, sends each chunk with proper sequencing,
+     * and handles errors appropriately.
+     *
+     * @param generator - The AsyncGenerator to stream
+     * @param request - The original request
+     * @returns Promise that resolves when streaming is complete
+     */
+    async handleStream(generator, request) {
+        this.state = StreamHandlerState.STREAMING;
+        this.currentSequence = 0;
+        // Call optional hook
+        if (this.onStreamStart) {
+            this.onStreamStart(request);
+        }
+        try {
+            // Iterate through the generator and send each chunk
+            for await (const chunk of generator) {
+                this.currentSequence++;
+                await this.sendChunk(chunk, this.currentSequence, false, request);
+            }
+            // Send final empty chunk to signal completion
+            await this.sendChunk(null, this.currentSequence, true, request);
+            this.state = StreamHandlerState.COMPLETED;
+            // Call optional hook
+            if (this.onStreamComplete) {
+                this.onStreamComplete(request, this.currentSequence);
+            }
+        }
+        catch (error) {
+            this.state = StreamHandlerState.ERROR;
+            // Convert error to oError if needed
+            const oErrorInstance = this.convertToOError(error);
+            // Call optional hook
+            if (this.onStreamError) {
+                this.onStreamError(request, oErrorInstance);
+            }
+            // Send error as final chunk
+            try {
+                await this.sendChunk(oErrorInstance.toJSON(), this.currentSequence, true, request);
+            }
+            catch (sendError) {
+                console.error('Failed to send error chunk:', sendError);
+                throw oErrorInstance;
+            }
+            throw oErrorInstance;
+        }
+    }
+    /**
+     * Convert any error to an oError instance
+     * @param error - The error to convert
+     * @returns An oError instance
+     */
+    convertToOError(error) {
+        if (error instanceof oError) {
+            return error;
+        }
+        if (error instanceof Error) {
+            return new oError(oErrorCodes.UNKNOWN, error.message, { stack: error.stack });
+        }
+        return new oError(oErrorCodes.UNKNOWN, String(error), { originalError: error });
+    }
+    /**
+     * Reset the handler state for reuse
+     */
+    reset() {
+        this.state = StreamHandlerState.IDLE;
+        this.currentSequence = 0;
+    }
+}

package/dist/src/streaming/stream-transport.interface.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Stream status states
+ */
+export declare enum StreamStatus {
+    OPEN = "open",
+    CLOSING = "closing",
+    CLOSED = "closed",
+    RESET = "reset"
+}
+/**
+ * Transport-agnostic interface for stream operations.
+ * Implementations can use libp2p, WebSockets, HTTP/2, or any other streaming transport.
+ */
+export interface IStreamTransport {
+    /**
+     * Send data through the stream with backpressure handling
+     * @param data - The data to send (UTF-8 encoded bytes)
+     * @returns Promise that resolves when data is sent (handles backpressure internally)
+     */
+    send(data: Uint8Array): Promise<void>;
+    /**
+     * Set up a message handler for incoming data
+     * @param handler - Callback function to handle incoming messages
+     */
+    onMessage(handler: (data: Uint8Array) => void): void;
+    /**
+     * Remove the message handler
+     */
+    removeMessageHandler(): void;
+    /**
+     * Close the stream and clean up resources
+     * @returns Promise that resolves when stream is closed
+     */
+    close(): Promise<void>;
+    /**
+     * Get the current status of the stream
+     * @returns The current stream status
+     */
+    getStatus(): StreamStatus;
+    /**
+     * Check if the stream is in a usable state
+     * @returns true if stream can send/receive data
+     */
+    isOpen(): boolean;
+}
+/**
+ * Configuration options for stream transport operations
+ */
+export interface StreamTransportConfig {
+    /**
+     * Timeout in milliseconds for drain operations when handling backpressure
+     * @default 30000 (30 seconds)
+     */
+    drainTimeoutMs?: number;
+    /**
+     * Maximum time in milliseconds to wait for the first message
+     * @default 120000 (2 minutes)
+     */
+    readTimeoutMs?: number;
+}
+//# sourceMappingURL=stream-transport.interface.d.ts.map

package/dist/src/streaming/stream-transport.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-transport.interface.d.ts","sourceRoot":"","sources":["../../../src/streaming/stream-transport.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,YAAY;IACtB,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,KAAK,UAAU;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtC;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAAC;IAErD;;OAEG;IACH,oBAAoB,IAAI,IAAI,CAAC;IAE7B;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;;OAGG;IACH,SAAS,IAAI,YAAY,CAAC;IAE1B;;;OAGG;IACH,MAAM,IAAI,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/src/streaming/stream-transport.interface.js

@@ -0,0 +1,10 @@
+/**
+ * Stream status states
+ */
+export var StreamStatus;
+(function (StreamStatus) {
+    StreamStatus["OPEN"] = "open";
+    StreamStatus["CLOSING"] = "closing";
+    StreamStatus["CLOSED"] = "closed";
+    StreamStatus["RESET"] = "reset";
+})(StreamStatus || (StreamStatus = {}));

package/dist/src/utils/core.utils.d.ts

@@ -1,4 +1,4 @@
-import { Stream, StreamMessageEvent } from '@olane/o-config';
+import { Stream } from '@olane/o-config';
 import { oAddress } from '../router/o-address.js';
 import { oResponse } from '../connection/o-response.js';
 import { oRequest } from '../connection/o-request.js';
@@ -25,7 +25,10 @@ export declare class CoreUtils {
     static phraseToSeed(phrase: string): string;
     static childAddress(parentAddress: oAddress, childAddress: oAddress): oAddress;
     static sendResponse(response: oResponse, stream: Stream): Promise<void>;
-    static processStream(event: StreamMessageEvent): Promise<oRequest>;
+    static sendStreamResponse(response: oResponse, stream: Stream): Promise<void>;
+    static processStream(event: any): Promise<any>;
+    static processStreamRequest(event: any): Promise<oRequest>;
+    static processStreamResponse(event: any): Promise<oResponse>;
     static toCID(data: any): Promise<CID>;
 }
 //# sourceMappingURL=core.utils.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"core.utils.d.ts","sourceRoot":"","sources":["../../../src/utils/core.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,MAAM,EAGN,kBAAkB,EACnB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAInC,qBAAa,SAAS;WACP,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC;IAK3C,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;WAkBvD,WAAW,CAAC,MAAM,EAAE;QAC/B,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;QACrC,OAAO,CAAC,EAAE,QAAQ,CAAC;QACnB,IAAI,EAAE,GAAG,CAAC;QACV,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,OAAO,CAAC;IA4BpB,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,GAAG,SAAS;WAe9D,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAQ3D;;;;;;OAMG;WACW,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU;WAO7C,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;WAOpC,YAAY,CACxB,aAAa,EAAE,QAAQ,EACvB,YAAY,EAAE,QAAQ,GACrB,QAAQ;WAIS,YAAY,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM;WAahD,aAAa,CAC/B,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,QAAQ,CAAC;WAMA,KAAK,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;CAMnD"}
+{"version":3,"file":"core.utils.d.ts","sourceRoot":"","sources":["../../../src/utils/core.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,MAAM,EAGP,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAInC,qBAAa,SAAS;WACP,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC;IAK3C,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;WAkBvD,WAAW,CAAC,MAAM,EAAE;QAC/B,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;QACrC,OAAO,CAAC,EAAE,QAAQ,CAAC;QACnB,IAAI,EAAE,GAAG,CAAC;QACV,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,OAAO,CAAC;IA4BpB,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,GAAG,SAAS;WAe9D,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAQ3D;;;;;;OAMG;WACW,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU;WAO7C,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;WAOpC,YAAY,CACxB,aAAa,EAAE,QAAQ,EACvB,YAAY,EAAE,QAAQ,GACrB,QAAQ;WAIS,YAAY,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM;WAahD,kBAAkB,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM;WAQtD,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;WAMvC,oBAAoB,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC;WAKnD,qBAAqB,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC;WAKrD,KAAK,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;CAMnD"}

package/dist/src/utils/core.utils.js

@@ -100,9 +100,23 @@ export class CoreUtils {
             console.error('Error sending response: ', error);
         }
     }
+    static async sendStreamResponse(response, stream) {
+        if (stream.status !== 'open') {
+            throw new Error('Stream is not open');
+        }
+        await stream.send(new TextEncoder().encode(response.toString()));
+    }
     static async processStream(event) {
         const bytes = event.data instanceof Uint8ArrayList ? event.data.subarray() : event.data;
-        return new oRequest(JSON.parse(new TextDecoder().decode(bytes)));
+        return JSON.parse(new TextDecoder().decode(bytes));
+    }
+    static async processStreamRequest(event) {
+        const req = await CoreUtils.processStream(event);
+        return new oRequest(req);
+    }
+    static async processStreamResponse(event) {
+        const res = await CoreUtils.processStream(event);
+        return new oResponse(res);
     }
     static async toCID(data) {
         const bytes = json.encode(data);

package/dist/src/utils/streaming.utils.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Type guard to check if a value is an AsyncGenerator
+ * @param value - The value to check
+ * @returns true if the value is an AsyncGenerator
+ */
+export declare function isAsyncGenerator(value: any): value is AsyncGenerator;
+/**
+ * Safely iterate through an AsyncGenerator with error handling
+ * @param generator - The AsyncGenerator to iterate
+ * @param onChunk - Callback for each chunk
+ * @param onError - Optional error handler
+ * @returns Promise that resolves when iteration is complete
+ */
+export declare function iterateAsyncGenerator<T>(generator: AsyncGenerator<T>, onChunk: (chunk: T) => Promise<void> | void, onError?: (error: unknown) => void): Promise<void>;
+/**
+ * Collect all chunks from an AsyncGenerator into an array
+ * Useful for testing or converting streaming responses to non-streaming
+ * @param generator - The AsyncGenerator to collect from
+ * @returns Promise resolving to array of all chunks
+ */
+export declare function collectStreamChunks<T>(generator: AsyncGenerator<T>): Promise<T[]>;
+//# sourceMappingURL=streaming.utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.utils.d.ts","sourceRoot":"","sources":["../../../src/utils/streaming.utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,cAAc,CAMpE;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CAAC,CAAC,EAC3C,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,EAC5B,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,EAC3C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GACjC,OAAO,CAAC,IAAI,CAAC,CAYf;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,GAC3B,OAAO,CAAC,CAAC,EAAE,CAAC,CAMd"}

package/dist/src/utils/streaming.utils.js

@@ -0,0 +1,45 @@
+/**
+ * Type guard to check if a value is an AsyncGenerator
+ * @param value - The value to check
+ * @returns true if the value is an AsyncGenerator
+ */
+export function isAsyncGenerator(value) {
+    return (value != null &&
+        typeof value === 'object' &&
+        typeof value[Symbol.asyncIterator] === 'function');
+}
+/**
+ * Safely iterate through an AsyncGenerator with error handling
+ * @param generator - The AsyncGenerator to iterate
+ * @param onChunk - Callback for each chunk
+ * @param onError - Optional error handler
+ * @returns Promise that resolves when iteration is complete
+ */
+export async function iterateAsyncGenerator(generator, onChunk, onError) {
+    try {
+        for await (const chunk of generator) {
+            await onChunk(chunk);
+        }
+    }
+    catch (error) {
+        if (onError) {
+            onError(error);
+        }
+        else {
+            throw error;
+        }
+    }
+}
+/**
+ * Collect all chunks from an AsyncGenerator into an array
+ * Useful for testing or converting streaming responses to non-streaming
+ * @param generator - The AsyncGenerator to collect from
+ * @returns Promise resolving to array of all chunks
+ */
+export async function collectStreamChunks(generator) {
+    const chunks = [];
+    for await (const chunk of generator) {
+        chunks.push(chunk);
+    }
+    return chunks;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@olane/o-core",
-  "version": "0.7.12-alpha.22",
+  "version": "0.7.12-alpha.24",
   "type": "module",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",
@@ -8,6 +8,14 @@
     ".": {
       "types": "./dist/src/index.d.ts",
       "default": "./dist/src/index.js"
+    },
+    "./streaming": {
+      "types": "./dist/src/streaming/index.d.ts",
+      "default": "./dist/src/streaming/index.js"
+    },
+    "./utils/streaming.utils": {
+      "types": "./dist/src/utils/streaming.utils.d.ts",
+      "default": "./dist/src/utils/streaming.utils.js"
     }
   },
   "files": [
@@ -55,11 +63,11 @@
     "typescript": "^5.8.3"
   },
   "dependencies": {
-    "@olane/o-protocol": "0.7.12-alpha.22",
+    "@olane/o-protocol": "0.7.12-alpha.24",
     "chalk": "^5.4.1",
     "debug": "^4.4.1",
     "dotenv": "^16.5.0",
     "multiformats": "^13.3.7"
   },
-  "gitHead": "8224ba551626751995e60a2064243a5976588d6d"
+  "gitHead": "ac75e0acc3a0a232a5cdeb9271060d90cf1e5a2c"
 }