observability-toolkit 1.8.4 → 2.0.0

package/dist/lib/circuit-breaker.test.js

@@ -0,0 +1,263 @@
+import { describe, it, before, after, beforeEach } from 'node:test';
+import * as assert from 'node:assert';
+import { CircuitBreaker } from './circuit-breaker.js';
+describe('CircuitBreaker', () => {
+    describe('initial state', () => {
+        it('should start in closed state', () => {
+            const breaker = new CircuitBreaker();
+            assert.strictEqual(breaker.getState(), 'closed');
+            assert.strictEqual(breaker.getFailureCount(), 0);
+        });
+        it('should allow requests when closed', () => {
+            const breaker = new CircuitBreaker();
+            assert.strictEqual(breaker.canRequest(), true);
+        });
+    });
+    describe('failure handling', () => {
+        it('should track consecutive failures', () => {
+            const breaker = new CircuitBreaker({ maxFailures: 3 });
+            breaker.recordFailure();
+            assert.strictEqual(breaker.getFailureCount(), 1);
+            assert.strictEqual(breaker.getState(), 'closed');
+            breaker.recordFailure();
+            assert.strictEqual(breaker.getFailureCount(), 2);
+            assert.strictEqual(breaker.getState(), 'closed');
+        });
+        it('should open after maxFailures consecutive failures', () => {
+            const breaker = new CircuitBreaker({ maxFailures: 3 });
+            breaker.recordFailure();
+            breaker.recordFailure();
+            breaker.recordFailure();
+            assert.strictEqual(breaker.getState(), 'open');
+            assert.strictEqual(breaker.getFailureCount(), 3);
+        });
+        it('should reject requests when open', () => {
+            const breaker = new CircuitBreaker({ maxFailures: 3 });
+            breaker.recordFailure();
+            breaker.recordFailure();
+            breaker.recordFailure();
+            assert.strictEqual(breaker.canRequest(), false);
+        });
+    });
+    describe('success handling', () => {
+        it('should reset failure count on success', () => {
+            const breaker = new CircuitBreaker({ maxFailures: 3 });
+            breaker.recordFailure();
+            breaker.recordFailure();
+            assert.strictEqual(breaker.getFailureCount(), 2);
+            breaker.recordSuccess();
+            assert.strictEqual(breaker.getFailureCount(), 0);
+            assert.strictEqual(breaker.getState(), 'closed');
+        });
+        it('should stay closed after partial failures followed by success', () => {
+            const breaker = new CircuitBreaker({ maxFailures: 3 });
+            breaker.recordFailure();
+            breaker.recordFailure();
+            breaker.recordSuccess();
+            breaker.recordFailure();
+            breaker.recordFailure();
+            // Should still be closed (only 2 consecutive failures)
+            assert.strictEqual(breaker.getState(), 'closed');
+        });
+    });
+    describe('half-open state', () => {
+        let originalDateNow;
+        let currentTime;
+        before(() => {
+            originalDateNow = Date.now;
+        });
+        beforeEach(() => {
+            currentTime = 1000000;
+            Date.now = () => currentTime;
+        });
+        after(() => {
+            Date.now = originalDateNow;
+        });
+        it('should transition to half-open after reset timeout', () => {
+            const breaker = new CircuitBreaker({ maxFailures: 3, resetMs: 60000 });
+            // Open the circuit
+            breaker.recordFailure();
+            breaker.recordFailure();
+            breaker.recordFailure();
+            assert.strictEqual(breaker.getState(), 'open');
+            // Advance time past reset period
+            currentTime += 61000;
+            // Should transition to half-open and allow request
+            assert.strictEqual(breaker.canRequest(), true);
+            assert.strictEqual(breaker.getState(), 'half-open');
+        });
+        it('should close on success in half-open state', () => {
+            const breaker = new CircuitBreaker({ maxFailures: 3, resetMs: 60000 });
+            // Open the circuit
+            breaker.recordFailure();
+            breaker.recordFailure();
+            breaker.recordFailure();
+            // Advance time and allow half-open
+            currentTime += 61000;
+            breaker.canRequest();
+            assert.strictEqual(breaker.getState(), 'half-open');
+            // Success should close the circuit
+            breaker.recordSuccess();
+            assert.strictEqual(breaker.getState(), 'closed');
+            assert.strictEqual(breaker.getFailureCount(), 0);
+        });
+        it('should reopen on failure in half-open state', () => {
+            const breaker = new CircuitBreaker({ maxFailures: 3, resetMs: 60000 });
+            // Open the circuit
+            breaker.recordFailure();
+            breaker.recordFailure();
+            breaker.recordFailure();
+            // Advance time and allow half-open
+            currentTime += 61000;
+            breaker.canRequest();
+            assert.strictEqual(breaker.getState(), 'half-open');
+            // Failure should reopen
+            breaker.recordFailure();
+            assert.strictEqual(breaker.getState(), 'open');
+        });
+        it('should not allow request before reset timeout', () => {
+            const breaker = new CircuitBreaker({ maxFailures: 3, resetMs: 60000 });
+            // Open the circuit
+            breaker.recordFailure();
+            breaker.recordFailure();
+            breaker.recordFailure();
+            assert.strictEqual(breaker.getState(), 'open');
+            // Advance time but not past reset period
+            currentTime += 30000;
+            assert.strictEqual(breaker.canRequest(), false);
+            assert.strictEqual(breaker.getState(), 'open');
+        });
+    });
+    describe('reset', () => {
+        it('should reset to initial state', () => {
+            const breaker = new CircuitBreaker({ maxFailures: 3 });
+            // Open the circuit
+            breaker.recordFailure();
+            breaker.recordFailure();
+            breaker.recordFailure();
+            assert.strictEqual(breaker.getState(), 'open');
+            // Reset
+            breaker.reset();
+            assert.strictEqual(breaker.getState(), 'closed');
+            assert.strictEqual(breaker.getFailureCount(), 0);
+            assert.strictEqual(breaker.canRequest(), true);
+        });
+        it('should reset halfOpenRequestInFlight flag', () => {
+            const originalDateNow = Date.now;
+            let currentTime = 1000000;
+            Date.now = () => currentTime;
+            try {
+                const breaker = new CircuitBreaker({ maxFailures: 3, resetMs: 60000 });
+                // Open and transition to half-open
+                breaker.recordFailure();
+                breaker.recordFailure();
+                breaker.recordFailure();
+                currentTime += 61000;
+                breaker.canRequest();
+                // Flag should be set
+                assert.strictEqual(breaker.isHalfOpenRequestInFlight(), true);
+                // Reset should clear it
+                breaker.reset();
+                assert.strictEqual(breaker.isHalfOpenRequestInFlight(), false);
+            }
+            finally {
+                Date.now = originalDateNow;
+            }
+        });
+    });
+    describe('half-open race condition prevention (H2)', () => {
+        let originalDateNow;
+        let currentTime;
+        before(() => {
+            originalDateNow = Date.now;
+        });
+        beforeEach(() => {
+            currentTime = 1000000;
+            Date.now = () => currentTime;
+        });
+        after(() => {
+            Date.now = originalDateNow;
+        });
+        it('should only allow one request through during half-open state', () => {
+            const breaker = new CircuitBreaker({ maxFailures: 3, resetMs: 60000 });
+            // Open the circuit
+            breaker.recordFailure();
+            breaker.recordFailure();
+            breaker.recordFailure();
+            // Advance time past reset period
+            currentTime += 61000;
+            // First request should be allowed (transitions to half-open)
+            assert.strictEqual(breaker.canRequest(), true);
+            assert.strictEqual(breaker.getState(), 'half-open');
+            assert.strictEqual(breaker.isHalfOpenRequestInFlight(), true);
+            // Second concurrent request should be rejected
+            assert.strictEqual(breaker.canRequest(), false);
+            assert.strictEqual(breaker.getState(), 'half-open');
+        });
+        it('should clear halfOpenRequestInFlight on success', () => {
+            const breaker = new CircuitBreaker({ maxFailures: 3, resetMs: 60000 });
+            // Open and transition to half-open
+            breaker.recordFailure();
+            breaker.recordFailure();
+            breaker.recordFailure();
+            currentTime += 61000;
+            breaker.canRequest();
+            assert.strictEqual(breaker.isHalfOpenRequestInFlight(), true);
+            // Success should clear the flag
+            breaker.recordSuccess();
+            assert.strictEqual(breaker.isHalfOpenRequestInFlight(), false);
+            assert.strictEqual(breaker.getState(), 'closed');
+        });
+        it('should clear halfOpenRequestInFlight on failure', () => {
+            const breaker = new CircuitBreaker({ maxFailures: 3, resetMs: 60000 });
+            // Open and transition to half-open
+            breaker.recordFailure();
+            breaker.recordFailure();
+            breaker.recordFailure();
+            currentTime += 61000;
+            breaker.canRequest();
+            assert.strictEqual(breaker.isHalfOpenRequestInFlight(), true);
+            // Failure should clear the flag
+            breaker.recordFailure();
+            assert.strictEqual(breaker.isHalfOpenRequestInFlight(), false);
+            assert.strictEqual(breaker.getState(), 'open');
+        });
+        it('should allow next request after half-open failure and timeout', () => {
+            const breaker = new CircuitBreaker({ maxFailures: 3, resetMs: 60000 });
+            // Open the circuit
+            breaker.recordFailure();
+            breaker.recordFailure();
+            breaker.recordFailure();
+            // First half-open attempt
+            currentTime += 61000;
+            assert.strictEqual(breaker.canRequest(), true);
+            breaker.recordFailure();
+            // Should be open again
+            assert.strictEqual(breaker.getState(), 'open');
+            // Wait for another reset period
+            currentTime += 61000;
+            // Should allow another half-open request
+            assert.strictEqual(breaker.canRequest(), true);
+            assert.strictEqual(breaker.getState(), 'half-open');
+        });
+    });
+    describe('configuration', () => {
+        it('should use custom maxFailures', () => {
+            const breaker = new CircuitBreaker({ maxFailures: 5 });
+            breaker.recordFailure();
+            breaker.recordFailure();
+            breaker.recordFailure();
+            assert.strictEqual(breaker.getState(), 'closed');
+            breaker.recordFailure();
+            breaker.recordFailure();
+            assert.strictEqual(breaker.getState(), 'open');
+        });
+        it('should use custom name in logging', () => {
+            const breaker = new CircuitBreaker({ name: 'test-breaker' });
+            // Name is used internally for logging, verify it doesn't throw
+            breaker.recordFailure();
+            breaker.recordSuccess();
+        });
+    });
+});
+//# sourceMappingURL=circuit-breaker.test.js.map

package/dist/lib/circuit-breaker.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.test.js","sourceRoot":"","sources":["../../src/lib/circuit-breaker.test.ts"],"names":[],"mappings":"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"}

package/dist/lib/confident-export.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Confident AI export functionality for evaluation results
+ *
+ * Exports evaluation results to Confident AI via OTLP HTTP format.
+ * Confident AI uses OpenTelemetry traces with custom attributes for
+ * evaluation correlation, thread tracking, and metric collection support.
+ */
+import { type OTLPKeyValue, type OTLPSpanEvent } from './otlp-export.js';
+import type { EvaluationResult } from '../backends/index.js';
+/**
+ * Confident AI configuration for export
+ */
+export interface ConfidentConfig {
+    endpoint: string;
+    apiKey: string;
+    batchSize: number;
+    timeoutMs: number;
+    environment: 'production' | 'development' | 'staging' | 'testing';
+    /** Optional metric collection name for online evaluation */
+    metricCollection?: string;
+}
+/**
+ * Result of a Confident AI export operation
+ */
+export interface ConfidentExportResult {
+    success: boolean;
+    evaluationsExported: number;
+    batches: number;
+    failed: number;
+    durationMs: number;
+    errors?: string[];
+}
+/**
+ * OTLP Trace export format for Confident AI
+ */
+interface OTLPTraceExport {
+    resourceSpans: Array<{
+        resource: {
+            attributes: OTLPKeyValue[];
+        };
+        scopeSpans: Array<{
+            scope?: {
+                name: string;
+                version?: string;
+            };
+            spans: Array<{
+                traceId: string;
+                spanId: string;
+                name: string;
+                kind: number;
+                startTimeUnixNano: string;
+                endTimeUnixNano: string;
+                status?: {
+                    code: number;
+                };
+                attributes?: OTLPKeyValue[];
+                events?: OTLPSpanEvent[];
+            }>;
+        }>;
+    }>;
+}
+/**
+ * Validate and sanitize a URL for Confident AI.
+ * Only allows HTTPS URLs to external hosts.
+ */
+export declare function validateConfidentUrl(url: string): string;
+/**
+ * Validate Confident AI configuration.
+ * Returns validated config or throws an error with details.
+ */
+export declare function validateConfidentConfig(overrides?: Partial<ConfidentConfig>): ConfidentConfig;
+/**
+ * Create API key header for Confident AI.
+ *
+ * Confident AI uses x-confident-api-key header for authentication.
+ *
+ * @param apiKey - Confident AI API key (e.g., "confident_us...")
+ * @returns Header value for x-confident-api-key
+ */
+export declare function createConfidentAuthHeader(apiKey: string): string;
+/**
+ * Convert evaluations to OTLP trace format for Confident AI export.
+ *
+ * Groups evaluations by traceId and creates one span per trace group,
+ * with Confident AI-specific attributes for thread tracking and
+ * evaluation correlation.
+ *
+ * @param evaluations - Array of evaluation results to convert
+ * @param config - Confident AI configuration
+ * @returns OTLP trace export structure ready for HTTP POST to /v1/traces
+ */
+export declare function evaluationsToConfidentTraces(evaluations: EvaluationResult[], config: ConfidentConfig): OTLPTraceExport;
+/**
+ * Export evaluations to Confident AI via OTLP HTTP.
+ * Batches evaluations and sends sequentially to avoid overwhelming the endpoint.
+ *
+ * Security: Re-validates endpoint before each batch to prevent DNS rebinding attacks.
+ */
+export declare function exportToConfident(evaluations: EvaluationResult[], config: ConfidentConfig): Promise<ConfidentExportResult>;
+export {};
+//# sourceMappingURL=confident-export.d.ts.map

package/dist/lib/confident-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confident-export.d.ts","sourceRoot":"","sources":["../../src/lib/confident-export.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,OAAO,EAAoB,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC3F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAa7D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,YAAY,GAAG,aAAa,GAAG,SAAS,GAAG,SAAS,CAAC;IAClE,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,UAAU,eAAe;IACvB,aAAa,EAAE,KAAK,CAAC;QACnB,QAAQ,EAAE;YAAE,UAAU,EAAE,YAAY,EAAE,CAAA;SAAE,CAAC;QACzC,UAAU,EAAE,KAAK,CAAC;YAChB,KAAK,CAAC,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,OAAO,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC;YAC3C,KAAK,EAAE,KAAK,CAAC;gBACX,OAAO,EAAE,MAAM,CAAC;gBAChB,MAAM,EAAE,MAAM,CAAC;gBACf,IAAI,EAAE,MAAM,CAAC;gBACb,IAAI,EAAE,MAAM,CAAC;gBACb,iBAAiB,EAAE,MAAM,CAAC;gBAC1B,eAAe,EAAE,MAAM,CAAC;gBACxB,MAAM,CAAC,EAAE;oBAAE,IAAI,EAAE,MAAM,CAAA;iBAAE,CAAC;gBAC1B,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;gBAC5B,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;aAC1B,CAAC,CAAC;SACJ,CAAC,CAAC;KACJ,CAAC,CAAC;CACJ;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,CAgD7F;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,gBAAgB,EAAE,EAC/B,MAAM,EAAE,eAAe,GACtB,eAAe,CA0NjB;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,gBAAgB,EAAE,EAC/B,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,qBAAqB,CAAC,CAkIhC"}