@olane/o-node 0.7.12-alpha.4 → 0.7.12-alpha.41

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

@@ -0,0 +1 @@
+{"version":3,"file":"node-stream-handler.d.ts","sourceRoot":"","sources":["../../../src/streaming/node-stream-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EAErB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,oBAAoB;IACpE;;OAEG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,iBAAiB;IACtD,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,SAAS,CAAwB;IACzC,OAAO,CAAC,WAAW,CAA2B;gBAG5C,SAAS,EAAE,qBAAqB,EAChC,OAAO,GAAE,wBAA6B;IAWxC;;OAEG;IACI,eAAe,IAAI,MAAM;IAIhC;;OAEG;IACI,aAAa,IAAI,MAAM;IAI9B;;OAEG;IACI,YAAY,IAAI,IAAI;IAK3B;;OAEG;cACa,SAAS,CACvB,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,QAAQ,GAChB,OAAO,CAAC,IAAI,CAAC;IA0BhB;;OAEG;cACgB,aAAa,CAAC,OAAO,EAAE,QAAQ,GAAG,IAAI;IAOzD;;OAEG;cACgB,gBAAgB,CACjC,OAAO,EAAE,QAAQ,EACjB,WAAW,EAAE,MAAM,GAClB,IAAI;IASP;;OAEG;cACgB,aAAa,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAUrE;;OAEG;IACI,KAAK,IAAI,IAAI;IAOpB;;;OAGG;WACW,MAAM,CAClB,SAAS,EAAE,qBAAqB,EAChC,OAAO,CAAC,EAAE,wBAAwB,GACjC,iBAAiB;CAGrB"}

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

@@ -0,0 +1,101 @@
+import { StreamHandlerBase, ProtocolBuilder, } from '@olane/o-core';
+/**
+ * o-node specific implementation of StreamHandlerBase.
+ * Integrates with libp2p streams and tracks metrics for o-node tools.
+ */
+export class NodeStreamHandler extends StreamHandlerBase {
+    constructor(transport, options = {}) {
+        super(options);
+        this.successCount = 0;
+        this.errorCount = 0;
+        this.transport = transport;
+        this.nodeOptions = {
+            trackSuccessCount: true,
+            trackErrorCount: true,
+            ...options,
+        };
+    }
+    /**
+     * Get the success count (number of chunks successfully sent)
+     */
+    getSuccessCount() {
+        return this.successCount;
+    }
+    /**
+     * Get the error count
+     */
+    getErrorCount() {
+        return this.errorCount;
+    }
+    /**
+     * Reset metrics
+     */
+    resetMetrics() {
+        this.successCount = 0;
+        this.errorCount = 0;
+    }
+    /**
+     * Implementation of sendChunk using libp2p transport and protocol builder
+     */
+    async sendChunk(chunk, sequence, isLast, request) {
+        // Build the JSON-RPC streaming chunk message
+        const message = ProtocolBuilder.buildStreamChunkFromRequest(chunk, sequence, isLast, request);
+        // Encode the message to bytes
+        const encoded = ProtocolBuilder.encodeMessage(message);
+        // Send through the transport (handles backpressure)
+        await this.transport.send(encoded);
+        // Track metrics if enabled
+        if (this.nodeOptions.trackSuccessCount) {
+            this.successCount++;
+        }
+        // Close the stream if this is the last chunk
+        if (isLast) {
+            await this.transport.close();
+        }
+    }
+    /**
+     * Hook: Called when streaming starts
+     */
+    onStreamStart(request) {
+        // Reset metrics for this stream
+        if (this.nodeOptions.enableMetrics) {
+            this.resetMetrics();
+        }
+    }
+    /**
+     * Hook: Called when streaming completes successfully
+     */
+    onStreamComplete(request, totalChunks) {
+        // Log completion if metrics enabled
+        if (this.nodeOptions.enableMetrics) {
+            console.log(`Stream completed for ${request.method}: ${totalChunks} chunks sent`);
+        }
+    }
+    /**
+     * Hook: Called when streaming encounters an error
+     */
+    onStreamError(request, error) {
+        // Track error count
+        if (this.nodeOptions.trackErrorCount) {
+            this.errorCount++;
+        }
+        // Log error
+        console.error(`Stream error for ${request.method}:`, error);
+    }
+    /**
+     * Reset the handler for reuse with a new transport
+     */
+    reset() {
+        // Call parent reset
+        this.state = 0; // Reset state (IDLE)
+        this.currentSequence = 0;
+        this.resetMetrics();
+    }
+    /**
+     * Create a new NodeStreamHandler with a different transport
+     * (useful for handling multiple streams)
+     */
+    static create(transport, options) {
+        return new NodeStreamHandler(transport, options);
+    }
+}

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

@@ -0,0 +1,33 @@
+import { Stream } from '@olane/o-config';
+import { oRequest, StreamTransportConfig } from '@olane/o-core';
+/**
+ * Client-side streaming orchestration for o-node.
+ * Manages chunk queues, backpressure, timeouts, and provides both
+ * callback and AsyncGenerator interfaces for streaming responses.
+ */
+export declare class oNodeStreamingClient {
+    /**
+     * Transmit a request via streaming and receive chunks through a callback.
+     * This method handles the full streaming lifecycle including timeouts,
+     * chunk sequencing, and cleanup.
+     *
+     * @param stream The libp2p stream to use for communication
+     * @param request The request to send
+     * @param onChunk Callback invoked for each chunk received
+     * @param config Optional transport configuration
+     * @returns Promise that resolves when the stream completes
+     */
+    streamRequest(stream: Stream, request: oRequest, onChunk: (chunk: any, sequence: number, isLast: boolean) => void, config?: StreamTransportConfig): Promise<void>;
+    /**
+     * Transmit a request via streaming and receive chunks as an AsyncGenerator.
+     * This enables true streaming by yielding chunks as they arrive, not buffering them all first.
+     * Manages chunk queue with backpressure coordination between chunk arrival and consumption.
+     *
+     * @param stream The libp2p stream to use for communication
+     * @param request The request to send
+     * @param config Optional transport configuration
+     * @returns AsyncGenerator that yields chunks as they arrive
+     */
+    streamAsGenerator(stream: Stream, request: oRequest, config?: StreamTransportConfig): AsyncGenerator<any, void, unknown>;
+}
+//# sourceMappingURL=o-node-streaming-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"o-node-streaming-client.d.ts","sourceRoot":"","sources":["../../../src/streaming/o-node-streaming-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAGL,QAAQ,EAER,qBAAqB,EACtB,MAAM,eAAe,CAAC;AAGvB;;;;GAIG;AACH,qBAAa,oBAAoB;IAC/B;;;;;;;;;;OAUG;IACG,aAAa,CACjB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,EAChE,MAAM,CAAC,EAAE,qBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC;IAgEhB;;;;;;;;;OASG;IACI,iBAAiB,CACtB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,QAAQ,EACjB,MAAM,CAAC,EAAE,qBAAqB,GAC7B,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC;CA2DtC"}

package/dist/src/streaming/o-node-streaming-client.js

@@ -0,0 +1,130 @@
+import { oError, oErrorCodes, ProtocolBuilder, } from '@olane/o-core';
+import { Libp2pStreamTransport } from './libp2p-stream-transport.js';
+/**
+ * Client-side streaming orchestration for o-node.
+ * Manages chunk queues, backpressure, timeouts, and provides both
+ * callback and AsyncGenerator interfaces for streaming responses.
+ */
+export class oNodeStreamingClient {
+    /**
+     * Transmit a request via streaming and receive chunks through a callback.
+     * This method handles the full streaming lifecycle including timeouts,
+     * chunk sequencing, and cleanup.
+     *
+     * @param stream The libp2p stream to use for communication
+     * @param request The request to send
+     * @param onChunk Callback invoked for each chunk received
+     * @param config Optional transport configuration
+     * @returns Promise that resolves when the stream completes
+     */
+    async streamRequest(stream, request, onChunk, config) {
+        // Create transport abstraction
+        const transport = new Libp2pStreamTransport(stream, config);
+        // Send the request using the transport
+        const data = new TextEncoder().encode(request.toString());
+        await transport.send(data);
+        // Set up to receive multiple chunks
+        return new Promise((resolve, reject) => {
+            // Set up timeout for receiving first chunk
+            const timeout = setTimeout(async () => {
+                transport.removeMessageHandler();
+                await transport.close();
+                reject(new oError(oErrorCodes.TIMEOUT, 'Timeout waiting for streaming response'));
+            }, config?.readTimeoutMs ?? 120000);
+            let timeoutCleared = false;
+            const messageHandler = async (data) => {
+                // Clear timeout on first message
+                if (!timeoutCleared) {
+                    clearTimeout(timeout);
+                    timeoutCleared = true;
+                }
+                try {
+                    const response = ProtocolBuilder.decodeMessage(data);
+                    // Try to parse as streaming chunk
+                    const chunk = ProtocolBuilder.parseStreamChunk(response);
+                    if (chunk) {
+                        // Streaming response
+                        onChunk(chunk.data, chunk.sequence, chunk.isLast);
+                        if (chunk.isLast) {
+                            transport.removeMessageHandler();
+                            await transport.close();
+                            resolve();
+                        }
+                    }
+                    else {
+                        // Non-streaming response (fallback for compatibility)
+                        onChunk(response.result, 1, true);
+                        transport.removeMessageHandler();
+                        await transport.close();
+                        resolve();
+                    }
+                }
+                catch (error) {
+                    transport.removeMessageHandler();
+                    await transport.close();
+                    reject(error);
+                }
+            };
+            transport.onMessage(messageHandler);
+        });
+    }
+    /**
+     * Transmit a request via streaming and receive chunks as an AsyncGenerator.
+     * This enables true streaming by yielding chunks as they arrive, not buffering them all first.
+     * Manages chunk queue with backpressure coordination between chunk arrival and consumption.
+     *
+     * @param stream The libp2p stream to use for communication
+     * @param request The request to send
+     * @param config Optional transport configuration
+     * @returns AsyncGenerator that yields chunks as they arrive
+     */
+    async *streamAsGenerator(stream, request, config) {
+        const chunkQueue = [];
+        let streamComplete = false;
+        let streamError = null;
+        let resolveNextChunk = null;
+        // Start streaming in the background using callback pattern
+        const transmitPromise = this.streamRequest(stream, request, (chunk, sequence, isLast) => {
+            chunkQueue.push({ chunk, sequence, isLast });
+            if (isLast) {
+                streamComplete = true;
+            }
+            // Notify that a new chunk is available
+            if (resolveNextChunk) {
+                resolveNextChunk();
+                resolveNextChunk = null;
+            }
+        }, config).catch((error) => {
+            streamError = error;
+            // Notify of error
+            if (resolveNextChunk) {
+                resolveNextChunk();
+                resolveNextChunk = null;
+            }
+        });
+        // Yield chunks as they arrive
+        while (!streamComplete && !streamError) {
+            if (chunkQueue.length > 0) {
+                const { chunk } = chunkQueue.shift();
+                yield chunk;
+            }
+            else {
+                // Wait for next chunk
+                await new Promise((resolve) => {
+                    resolveNextChunk = resolve;
+                });
+            }
+        }
+        // Yield any remaining chunks
+        while (chunkQueue.length > 0) {
+            const { chunk } = chunkQueue.shift();
+            yield chunk;
+        }
+        // Wait for transmit to complete
+        await transmitPromise;
+        // If there was an error, throw it
+        if (streamError) {
+            throw streamError;
+        }
+    }
+}

package/dist/src/utils/circuit-breaker.d.ts

@@ -0,0 +1,107 @@
+import { oObject } from '@olane/o-core';
+export declare enum CircuitState {
+    CLOSED = "CLOSED",// Normal operation, requests pass through
+    OPEN = "OPEN",// Circuit broken, requests fast-fail
+    HALF_OPEN = "HALF_OPEN"
+}
+export interface CircuitBreakerConfig {
+    failureThreshold: number;
+    openTimeoutMs: number;
+    halfOpenMaxAttempts: number;
+    enabled: boolean;
+}
+export interface CircuitStats {
+    state: CircuitState;
+    consecutiveFailures: number;
+    totalFailures: number;
+    totalSuccesses: number;
+    lastFailureTime?: number;
+    lastSuccessTime?: number;
+    openedAt?: number;
+}
+/**
+ * Circuit Breaker Pattern Implementation
+ *
+ * Prevents cascading failures by "breaking the circuit" when a service
+ * experiences persistent failures. This allows the system to fail fast
+ * rather than wasting resources on retries that are likely to fail.
+ *
+ * States:
+ * - CLOSED: Normal operation, all requests pass through
+ * - OPEN: Circuit broken due to failures, requests fail immediately
+ * - HALF_OPEN: Testing recovery, limited requests allowed
+ *
+ * Flow:
+ * 1. CLOSED -> OPEN: After N consecutive failures
+ * 2. OPEN -> HALF_OPEN: After timeout period
+ * 3. HALF_OPEN -> CLOSED: After successful request
+ * 4. HALF_OPEN -> OPEN: After failure in recovery
+ *
+ * @example
+ * ```typescript
+ * const breaker = new CircuitBreaker('registry', {
+ *   failureThreshold: 3,
+ *   openTimeoutMs: 30000,
+ *   halfOpenMaxAttempts: 1,
+ *   enabled: true,
+ * });
+ *
+ * // Before making request
+ * if (!breaker.shouldAllowRequest()) {
+ *   throw new Error('Circuit breaker is open');
+ * }
+ *
+ * try {
+ *   const result = await makeRequest();
+ *   breaker.recordSuccess();
+ *   return result;
+ * } catch (error) {
+ *   breaker.recordFailure();
+ *   throw error;
+ * }
+ * ```
+ */
+export declare class CircuitBreaker extends oObject {
+    private readonly serviceName;
+    private readonly config;
+    private state;
+    private consecutiveFailures;
+    private totalFailures;
+    private totalSuccesses;
+    private lastFailureTime?;
+    private lastSuccessTime?;
+    private openedAt?;
+    private halfOpenAttempts;
+    constructor(serviceName: string, config: CircuitBreakerConfig);
+    /**
+     * Check if a request should be allowed through the circuit breaker
+     * @returns true if request should proceed, false if should fast-fail
+     */
+    shouldAllowRequest(): boolean;
+    /**
+     * Record a successful request
+     */
+    recordSuccess(): void;
+    /**
+     * Record a failed request
+     */
+    recordFailure(): void;
+    /**
+     * Get current statistics
+     */
+    getStats(): CircuitStats;
+    /**
+     * Get current circuit state
+     */
+    getState(): CircuitState;
+    /**
+     * Force reset the circuit breaker to CLOSED state
+     * Use with caution - mainly for testing or manual recovery
+     */
+    reset(): void;
+    /**
+     * Transition to a new state
+     */
+    private transitionTo;
+}
+//# sourceMappingURL=circuit-breaker.d.ts.map

package/dist/src/utils/circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../../src/utils/circuit-breaker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,oBAAY,YAAY;IACtB,MAAM,WAAW,CAAE,0CAA0C;IAC7D,IAAI,SAAS,CAAE,qCAAqC;IACpD,SAAS,cAAc;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,YAAY,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,qBAAa,cAAe,SAAQ,OAAO;IAWvC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAXzB,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,mBAAmB,CAAa;IACxC,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,eAAe,CAAC,CAAS;IACjC,OAAO,CAAC,eAAe,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,gBAAgB,CAAa;gBAGlB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,oBAAoB;IAW/C;;;OAGG;IACH,kBAAkB,IAAI,OAAO;IA2C7B;;OAEG;IACH,aAAa,IAAI,IAAI;IAkBrB;;OAEG;IACH,aAAa,IAAI,IAAI;IA+BrB;;OAEG;IACH,QAAQ,IAAI,YAAY;IAYxB;;OAEG;IACH,QAAQ,IAAI,YAAY;IAIxB;;;OAGG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,OAAO,CAAC,YAAY;CAOrB"}

package/dist/src/utils/circuit-breaker.js

@@ -0,0 +1,175 @@
+import { oObject } from '@olane/o-core';
+export var CircuitState;
+(function (CircuitState) {
+    CircuitState["CLOSED"] = "CLOSED";
+    CircuitState["OPEN"] = "OPEN";
+    CircuitState["HALF_OPEN"] = "HALF_OPEN";
+})(CircuitState || (CircuitState = {}));
+/**
+ * Circuit Breaker Pattern Implementation
+ *
+ * Prevents cascading failures by "breaking the circuit" when a service
+ * experiences persistent failures. This allows the system to fail fast
+ * rather than wasting resources on retries that are likely to fail.
+ *
+ * States:
+ * - CLOSED: Normal operation, all requests pass through
+ * - OPEN: Circuit broken due to failures, requests fail immediately
+ * - HALF_OPEN: Testing recovery, limited requests allowed
+ *
+ * Flow:
+ * 1. CLOSED -> OPEN: After N consecutive failures
+ * 2. OPEN -> HALF_OPEN: After timeout period
+ * 3. HALF_OPEN -> CLOSED: After successful request
+ * 4. HALF_OPEN -> OPEN: After failure in recovery
+ *
+ * @example
+ * ```typescript
+ * const breaker = new CircuitBreaker('registry', {
+ *   failureThreshold: 3,
+ *   openTimeoutMs: 30000,
+ *   halfOpenMaxAttempts: 1,
+ *   enabled: true,
+ * });
+ *
+ * // Before making request
+ * if (!breaker.shouldAllowRequest()) {
+ *   throw new Error('Circuit breaker is open');
+ * }
+ *
+ * try {
+ *   const result = await makeRequest();
+ *   breaker.recordSuccess();
+ *   return result;
+ * } catch (error) {
+ *   breaker.recordFailure();
+ *   throw error;
+ * }
+ * ```
+ */
+export class CircuitBreaker extends oObject {
+    constructor(serviceName, config) {
+        super();
+        this.serviceName = serviceName;
+        this.config = config;
+        this.state = CircuitState.CLOSED;
+        this.consecutiveFailures = 0;
+        this.totalFailures = 0;
+        this.totalSuccesses = 0;
+        this.halfOpenAttempts = 0;
+        this.logger.debug(`Circuit breaker initialized for ${serviceName}:`, `threshold=${config.failureThreshold},`, `timeout=${config.openTimeoutMs}ms,`, `enabled=${config.enabled}`);
+    }
+    /**
+     * Check if a request should be allowed through the circuit breaker
+     * @returns true if request should proceed, false if should fast-fail
+     */
+    shouldAllowRequest() {
+        if (!this.config.enabled) {
+            return true;
+        }
+        const now = Date.now();
+        switch (this.state) {
+            case CircuitState.CLOSED:
+                return true;
+            case CircuitState.OPEN:
+                // Check if timeout period has elapsed
+                if (this.openedAt &&
+                    now - this.openedAt >= this.config.openTimeoutMs) {
+                    this.logger.info(`Circuit breaker for ${this.serviceName} entering HALF_OPEN state`);
+                    this.transitionTo(CircuitState.HALF_OPEN);
+                    this.halfOpenAttempts = 0;
+                    return true;
+                }
+                // Circuit still open, fast-fail
+                this.logger.debug(`Circuit breaker for ${this.serviceName} is OPEN, rejecting request`);
+                return false;
+            case CircuitState.HALF_OPEN:
+                // Allow limited attempts in HALF_OPEN state
+                if (this.halfOpenAttempts < this.config.halfOpenMaxAttempts) {
+                    this.halfOpenAttempts++;
+                    return true;
+                }
+                this.logger.debug(`Circuit breaker for ${this.serviceName} HALF_OPEN max attempts reached`);
+                return false;
+        }
+    }
+    /**
+     * Record a successful request
+     */
+    recordSuccess() {
+        if (!this.config.enabled) {
+            return;
+        }
+        this.totalSuccesses++;
+        this.lastSuccessTime = Date.now();
+        this.consecutiveFailures = 0;
+        if (this.state === CircuitState.HALF_OPEN) {
+            this.logger.info(`Circuit breaker for ${this.serviceName} recovered, closing circuit`);
+            this.transitionTo(CircuitState.CLOSED);
+            this.halfOpenAttempts = 0;
+        }
+    }
+    /**
+     * Record a failed request
+     */
+    recordFailure() {
+        if (!this.config.enabled) {
+            return;
+        }
+        this.totalFailures++;
+        this.consecutiveFailures++;
+        this.lastFailureTime = Date.now();
+        if (this.state === CircuitState.HALF_OPEN) {
+            this.logger.warn(`Circuit breaker for ${this.serviceName} failed in HALF_OPEN, reopening circuit`);
+            this.transitionTo(CircuitState.OPEN);
+            this.openedAt = Date.now();
+            this.halfOpenAttempts = 0;
+            return;
+        }
+        if (this.state === CircuitState.CLOSED &&
+            this.consecutiveFailures >= this.config.failureThreshold) {
+            this.logger.error(`Circuit breaker for ${this.serviceName} opening after ${this.consecutiveFailures} consecutive failures`);
+            this.transitionTo(CircuitState.OPEN);
+            this.openedAt = Date.now();
+        }
+    }
+    /**
+     * Get current statistics
+     */
+    getStats() {
+        return {
+            state: this.state,
+            consecutiveFailures: this.consecutiveFailures,
+            totalFailures: this.totalFailures,
+            totalSuccesses: this.totalSuccesses,
+            lastFailureTime: this.lastFailureTime,
+            lastSuccessTime: this.lastSuccessTime,
+            openedAt: this.openedAt,
+        };
+    }
+    /**
+     * Get current circuit state
+     */
+    getState() {
+        return this.state;
+    }
+    /**
+     * Force reset the circuit breaker to CLOSED state
+     * Use with caution - mainly for testing or manual recovery
+     */
+    reset() {
+        this.logger.info(`Circuit breaker for ${this.serviceName} manually reset`);
+        this.transitionTo(CircuitState.CLOSED);
+        this.consecutiveFailures = 0;
+        this.halfOpenAttempts = 0;
+        this.openedAt = undefined;
+    }
+    /**
+     * Transition to a new state
+     */
+    transitionTo(newState) {
+        const oldState = this.state;
+        this.state = newState;
+        this.logger.debug(`Circuit breaker for ${this.serviceName}: ${oldState} -> ${newState}`);
+    }
+}

package/dist/src/utils/circuit-breaker.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=circuit-breaker.test.d.ts.map

package/dist/src/utils/circuit-breaker.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.test.d.ts","sourceRoot":"","sources":["../../../src/utils/circuit-breaker.test.ts"],"names":[],"mappings":""}