@olane/o-node 0.7.55 → 0.7.56

package/dist/src/connection/interfaces/stream-init-message.d.ts

@@ -1,64 +0,0 @@
-/**
- * Message sent by limited connection clients to identify their dedicated persistent streams
- * This allows the receiver to identify which streams to use for bidirectional communication
- */
-export interface StreamInitMessage {
-    /**
-     * Message type identifier
-     */
-    type: 'stream-init';
-    /**
-     * Role of this stream
-     * - 'reader': Dedicated reader stream for receiving requests from receiver
-     * - 'writer': Dedicated writer stream for sending responses back to receiver
-     * - 'standard': Standard request-response stream
-     */
-    role: 'reader' | 'writer' | 'standard';
-    /**
-     * Timestamp when the stream was created
-     */
-    timestamp: number;
-    /**
-     * Optional connection identifier for correlation
-     */
-    connectionId?: string;
-}
-/**
- * Type guard to check if a message is a StreamInitMessage
- */
-export declare function isStreamInitMessage(message: any): message is StreamInitMessage;
-/**
- * Acknowledgment message sent by receiver in response to stream-init
- * This confirms that the receiver has processed and registered the stream
- */
-export interface StreamInitAckMessage {
-    /**
-     * Message type identifier
-     */
-    type: 'stream-init-ack';
-    /**
-     * Status of the initialization
-     */
-    status: 'success' | 'error';
-    /**
-     * The stream ID that was registered
-     */
-    streamId: string;
-    /**
-     * The role that was registered
-     */
-    role: 'reader' | 'writer' | 'standard';
-    /**
-     * Optional error message if status is 'error'
-     */
-    error?: string;
-    /**
-     * Timestamp when the ack was sent
-     */
-    timestamp: number;
-}
-/**
- * Type guard to check if a message is a StreamInitAckMessage
- */
-export declare function isStreamInitAckMessage(message: any): message is StreamInitAckMessage;
-//# sourceMappingURL=stream-init-message.d.ts.map

package/dist/src/connection/interfaces/stream-init-message.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"stream-init-message.d.ts","sourceRoot":"","sources":["../../../../src/connection/interfaces/stream-init-message.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,IAAI,EAAE,aAAa,CAAC;IAEpB;;;;;OAKG;IACH,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;IAEvC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,IAAI,iBAAiB,CAM9E;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,IAAI,EAAE,iBAAiB,CAAC;IAExB;;OAEG;IACH,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAE5B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;IAEvC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,GAAG,GACX,OAAO,IAAI,oBAAoB,CAQjC"}

package/dist/src/connection/interfaces/stream-init-message.js

@@ -1,18 +0,0 @@
-/**
- * Type guard to check if a message is a StreamInitMessage
- */
-export function isStreamInitMessage(message) {
-    return (message?.type === 'stream-init' &&
-        (message.role === 'reader' || message.role === 'writer' || message.role === 'standard') &&
-        typeof message.timestamp === 'number');
-}
-/**
- * Type guard to check if a message is a StreamInitAckMessage
- */
-export function isStreamInitAckMessage(message) {
-    return (message?.type === 'stream-init-ack' &&
-        (message.status === 'success' || message.status === 'error') &&
-        typeof message.streamId === 'string' &&
-        (message.role === 'reader' || message.role === 'writer' || message.role === 'standard') &&
-        typeof message.timestamp === 'number');
-}

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

@@ -1,8 +0,0 @@
-import type { Connection } from '@libp2p/interface';
-export interface StreamManagerConfig {
-    /**
-     * The libp2p connection this manager handles streams for
-     */
-    p2pConnection: Connection;
-}
-//# sourceMappingURL=stream-manager.config.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"stream-manager.config.d.ts","sourceRoot":"","sources":["../../../../src/connection/interfaces/stream-manager.config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,aAAa,EAAE,UAAU,CAAC;CAC3B"}

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

@@ -1,210 +0,0 @@
-/// <reference types="node" />
-import { EventEmitter } from 'events';
-import type { Connection, Stream } from '@libp2p/interface';
-import { oObject, oRequest, oResponse } from '@olane/o-core';
-import type { oRouterRequest, oConnection } from '@olane/o-core';
-import { oNodeStream } from './o-node-stream.js';
-import { StreamManagerConfig } from './interfaces/stream-manager.config.js';
-import type { StreamHandlerConfig } from './stream-handler.config.js';
-import { StreamManagerEvent, StreamManagerEventData } from './stream-manager.events.js';
-import { StreamInitMessage } from './interfaces/stream-init-message.js';
-/**
- * oNodeStreamManager handles the lifecycle and tracking of streams for a single connection.
- * Features:
- * - Tracks all streams by ID
- * - Creates new streams on demand
- * - Manages stream lifecycle (cleanup after use)
- * - Provides events for monitoring
- * - No reuse at base layer (extensible in subclasses)
- */
-export declare class oNodeStreamManager extends oObject {
-    readonly config: StreamManagerConfig;
-    private streams;
-    protected eventEmitter: EventEmitter;
-    isInitialized: boolean;
-    private p2pConnection;
-    private activeStreamHandlers;
-    protected callerReaderStream?: Stream;
-    protected callerWriterStream?: Stream;
-    private streamMonitoringIntervals;
-    private id;
-    constructor(config: StreamManagerConfig);
-    /**
-     * Initialize the stream manager
-     */
-    initialize(): Promise<void>;
-    /**
-     * Gets or creates a stream for the connection
-     * Always creates a new stream (no reuse at base layer)
-     *
-     * For limited connections (where caller has identified a reader stream):
-     * - If callerReaderStream exists, wrap and return it for sending requests
-     * - Otherwise, create new stream as normal
-     *
-     * @param protocol - The protocol string for the stream
-     * @param remoteAddress - The remote address for the stream
-     * @param config - Stream handler configuration
-     * @returns Wrapped stream
-     */
-    getOrCreateStream(protocol: string, remoteAddress: any, config?: StreamHandlerConfig): Promise<oNodeStream>;
-    /**
-     * Creates a new stream from the connection
-     *
-     * @param protocol - The protocol string for the stream
-     * @param remoteAddress - The remote address for the stream
-     * @param config - Stream handler configuration
-     * @returns Wrapped stream
-     */
-    createStream(protocol: string, remoteAddress: any, config?: StreamHandlerConfig): Promise<oNodeStream>;
-    /**
-     * Releases and cleans up a stream
-     *
-     * @param streamId - The ID of the stream to release
-     */
-    releaseStream(streamId: string): Promise<void>;
-    /**
-     * Gets all tracked streams
-     *
-     * @returns Array of wrapped streams
-     */
-    getAllStreams(): oNodeStream[];
-    /**
-     * Gets a stream by its ID
-     * Checks persistent caller streams (reader/writer) and tracked streams
-     *
-     * @param streamId - The ID of the stream to retrieve
-     * @returns The libp2p Stream or undefined if not found
-     */
-    getStreamById(streamId: string): Stream | undefined;
-    /**
-     * Sets up monitoring for stream closure and emits events when detected
-     * Periodically checks stream status and cleans up when stream closes
-     *
-     * @param stream - The stream to monitor
-     * @param role - The role of the stream ('reader' or 'writer')
-     */
-    private setupStreamCloseMonitoring;
-    /**
-     * Emits an async event and waits for the first listener to return a result
-     * This enables event-based request handling with async responses
-     */
-    private emitAsync;
-    /**
-     * Detects if a decoded message is a request
-     * Requests have a 'method' field and no 'result' field
-     */
-    isRequest(message: any): boolean;
-    /**
-     * Detects if a decoded message is a response
-     * Responses have a 'result' field and no 'method' field
-     */
-    isResponse(message: any): boolean;
-    /**
-     * Detects if a decoded message is a stream initialization message
-     * Uses the imported type guard from stream-init-message.ts
-     */
-    isStreamInit(message: any): message is StreamInitMessage;
-    /**
-     * Handles a stream initialization message
-     * Stores reference to caller's reader stream for bidirectional communication
-     * Sends acknowledgment back to confirm stream registration
-     *
-     * @param message - The decoded stream init message
-     * @param stream - The stream that sent the message
-     */
-    protected handleStreamInitMessage(message: StreamInitMessage, stream: Stream): Promise<void>;
-    /**
-     * Extracts and parses JSON from various formats including:
-     * - Already parsed objects
-     * - Plain JSON
-     * - Markdown code blocks (```json ... ``` or ``` ... ```)
-     * - Mixed content with explanatory text
-     * - JSON5 format (trailing commas, comments, unquoted keys, etc.)
-     *
-     * @param decoded - The decoded string that may contain JSON, or an already parsed object
-     * @returns Parsed JSON object
-     * @throws Error if JSON parsing fails even with JSON5 fallback
-     */
-    protected extractAndParseJSON(decoded: string | any): any;
-    /**
-     * Sends data through a stream using length-prefixed encoding (libp2p v3 best practice)
-     * Each message is automatically prefixed with a varint indicating the message length
-     * This ensures proper message boundaries and eliminates concatenation issues
-     *
-     * @param stream - The stream to send data through
-     * @param data - The data to send
-     * @param config - Configuration for timeout and other options
-     */
-    sendLengthPrefixed(stream: Stream, data: Uint8Array, config?: StreamHandlerConfig): Promise<void>;
-    /**
-     * Tracks an active stream handler
-     */
-    private trackStreamHandler;
-    /**
-     * Untracks a stream handler
-     */
-    private untrackStreamHandler;
-    /**
-     * Handles an incoming stream on the server side using length-prefixed protocol
-     * Uses async read loops instead of event listeners (libp2p v3 best practice)
-     * Processes complete messages with proper boundaries
-     *
-     * @param stream - The incoming stream
-     * @param connection - The connection the stream belongs to
-     */
-    handleIncomingStream(stream: Stream, connection: Connection): Promise<void>;
-    /**
-     * Determines which stream to use for sending the response
-     * Checks for _streamId in request params and routes accordingly
-     *
-     * @param request - The incoming request
-     * @param defaultStream - The stream the request came on (fallback)
-     * @returns The stream to use for the response
-     */
-    protected getResponseStream(request: oRequest, defaultStream: Stream): Stream;
-    /**
-     * Handles a request message by emitting an event and sending response
-     *
-     * @param message - The decoded request message
-     * @param stream - The stream to send the response on
-     * @param connection - The connection the stream belongs to
-     */
-    protected handleRequestMessage(message: any, stream: Stream, connection: Connection): Promise<void>;
-    /**
-     * Handles an outgoing stream on the client side using length-prefixed protocol
-     * Uses async read loops to process responses with proper message boundaries
-     *
-     * @param stream - The outgoing stream
-     * @param emitter - Event emitter for chunk events
-     * @param config - Configuration including abort signal
-     * @param requestId - Optional request ID to filter responses (for stream reuse scenarios)
-     * @returns Promise that resolves with the final response
-     */
-    handleOutgoingStream(stream: Stream, emitter: EventEmitter, config?: StreamHandlerConfig, requestId?: string | number): Promise<oResponse>;
-    /**
-     * Forwards a request to the next hop and relays response chunks back
-     * This implements the middleware/proxy pattern for intermediate nodes
-     *
-     * @param request - The router request to forward
-     * @param incomingStream - The stream to send responses back on
-     * @param dialFn - Function to dial the next hop connection
-     */
-    forwardRequest(request: oRouterRequest, incomingStream: Stream, dialFn: (address: string) => Promise<oConnection>): Promise<void>;
-    /**
-     * Close the stream manager and cleanup resources
-     */
-    close(): Promise<void>;
-    /**
-     * Add event listener
-     */
-    on<K extends StreamManagerEvent>(event: K | string, listener: (data: StreamManagerEventData[K]) => void): void;
-    /**
-     * Remove event listener
-     */
-    off<K extends StreamManagerEvent>(event: K | string, listener: (data: StreamManagerEventData[K]) => void): void;
-    /**
-     * Emit event
-     */
-    private emit;
-}
-//# sourceMappingURL=o-node-stream.manager.d.ts.map

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

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