observability-toolkit 2.0.0 → 2.1.0

package/dist/lib/observability/metrics.test.js

@@ -0,0 +1,191 @@
+/**
+ * Tests for OTel metrics module
+ */
+import { describe, it, beforeEach, afterEach } from 'vitest';
+import * as assert from 'node:assert';
+import { initializeMetrics, resetMetricsForTesting, isMetricsEnabled, recordCacheHit, recordCacheMiss, recordCacheEviction, recordQueryDuration, recordCircuitBreakerState, recordRateLimitRejection, } from './metrics.js';
+import { MAX_NANOSECOND_FRACTION } from '../core/units.js';
+import { COUNT_FIFTY, COUNT_HUNDRED, COUNT_TWO_HUNDRED, } from '../../test-helpers/test-constants.js';
+describe('metrics module', () => {
+    const originalEnv = process.env.OTEL_ENABLED;
+    beforeEach(() => {
+        resetMetricsForTesting();
+        delete process.env.OTEL_ENABLED;
+    });
+    afterEach(() => {
+        resetMetricsForTesting();
+        if (originalEnv !== undefined) {
+            process.env.OTEL_ENABLED = originalEnv;
+        }
+        else {
+            delete process.env.OTEL_ENABLED;
+        }
+    });
+    describe('initializeMetrics', () => {
+        it('should skip initialization when OTEL_ENABLED is not set', async () => {
+            await initializeMetrics();
+            assert.strictEqual(isMetricsEnabled(), false);
+        });
+        it('should skip initialization when OTEL_ENABLED is false', async () => {
+            process.env.OTEL_ENABLED = 'false';
+            await initializeMetrics();
+            assert.strictEqual(isMetricsEnabled(), false);
+        });
+        it('should be idempotent - multiple calls are no-ops', async () => {
+            await initializeMetrics();
+            await initializeMetrics();
+            await initializeMetrics();
+            // Should not throw
+            assert.strictEqual(isMetricsEnabled(), false);
+        });
+        it('should initialize when OTEL_ENABLED is true', async () => {
+            process.env.OTEL_ENABLED = 'true';
+            await initializeMetrics();
+            // Metrics should be enabled if OTel API is available
+            // Note: In test environment without full OTel setup, this may still be false
+            // but the initialization should complete without error
+        });
+    });
+    describe('recording functions - disabled state', () => {
+        beforeEach(async () => {
+            // Ensure metrics are not enabled
+            delete process.env.OTEL_ENABLED;
+            resetMetricsForTesting();
+            await initializeMetrics();
+        });
+        it('recordCacheHit should be a no-op when disabled', () => {
+            // Should not throw
+            assert.doesNotThrow(() => recordCacheHit('traces'));
+            assert.doesNotThrow(() => recordCacheHit('logs'));
+            assert.doesNotThrow(() => recordCacheHit('metrics'));
+        });
+        it('recordCacheMiss should be a no-op when disabled', () => {
+            assert.doesNotThrow(() => recordCacheMiss('traces'));
+            assert.doesNotThrow(() => recordCacheMiss('logs'));
+        });
+        it('recordCacheEviction should be a no-op when disabled', () => {
+            assert.doesNotThrow(() => recordCacheEviction('traces'));
+        });
+        it('recordQueryDuration should be a no-op when disabled', () => {
+            assert.doesNotThrow(() => recordQueryDuration('traces', COUNT_HUNDRED));
+            assert.doesNotThrow(() => recordQueryDuration('logs', COUNT_FIFTY, 'local'));
+            assert.doesNotThrow(() => recordQueryDuration('metrics', COUNT_TWO_HUNDRED, 'signoz'));
+        });
+        it('recordCircuitBreakerState should be a no-op when disabled', () => {
+            assert.doesNotThrow(() => recordCircuitBreakerState('local-file-io', 'closed'));
+            assert.doesNotThrow(() => recordCircuitBreakerState('signoz-api', 'open'));
+            assert.doesNotThrow(() => recordCircuitBreakerState('test', 'half-open'));
+        });
+        it('recordRateLimitRejection should be a no-op when disabled', () => {
+            assert.doesNotThrow(() => recordRateLimitRejection('tool'));
+            assert.doesNotThrow(() => recordRateLimitRejection('signoz-api'));
+        });
+    });
+    describe('recording functions - with various inputs', () => {
+        beforeEach(() => {
+            resetMetricsForTesting();
+        });
+        it('should handle unknown cache type', () => {
+            assert.doesNotThrow(() => recordCacheHit('unknown'));
+            assert.doesNotThrow(() => recordCacheMiss('unknown'));
+            assert.doesNotThrow(() => recordCacheEviction('unknown'));
+        });
+        it('should handle all valid cache types', () => {
+            assert.doesNotThrow(() => recordCacheHit('traces'));
+            assert.doesNotThrow(() => recordCacheMiss('logs'));
+            assert.doesNotThrow(() => recordCacheEviction('metrics'));
+        });
+        it('should handle zero duration', () => {
+            assert.doesNotThrow(() => recordQueryDuration('traces', 0));
+        });
+        it('should handle negative duration', () => {
+            // Negative durations shouldn't happen but shouldn't crash
+            assert.doesNotThrow(() => recordQueryDuration('traces', -1));
+        });
+        it('should handle very large duration values', () => {
+            assert.doesNotThrow(() => recordQueryDuration('traces', MAX_NANOSECOND_FRACTION));
+        });
+        it('should handle all circuit breaker states', () => {
+            assert.doesNotThrow(() => recordCircuitBreakerState('test', 'closed'));
+            assert.doesNotThrow(() => recordCircuitBreakerState('test', 'half-open'));
+            assert.doesNotThrow(() => recordCircuitBreakerState('test', 'open'));
+        });
+    });
+    describe('resetMetricsForTesting', () => {
+        it('should reset initialization state', async () => {
+            process.env.OTEL_ENABLED = 'false';
+            await initializeMetrics();
+            resetMetricsForTesting();
+            // After reset, initialization should run again
+            await initializeMetrics();
+            // Should complete without error
+        });
+    });
+    describe('isMetricsEnabled', () => {
+        it('should return false before initialization', () => {
+            resetMetricsForTesting();
+            assert.strictEqual(isMetricsEnabled(), false);
+        });
+        it('should return false when disabled', async () => {
+            delete process.env.OTEL_ENABLED;
+            await initializeMetrics();
+            assert.strictEqual(isMetricsEnabled(), false);
+        });
+    });
+    describe('metric labels', () => {
+        it('should accept valid cache types', () => {
+            const validTypes = ['traces', 'logs', 'metrics', 'llmEvents', 'evaluations', 'unknown'];
+            for (const type of validTypes) {
+                assert.doesNotThrow(() => recordCacheHit(type));
+                assert.doesNotThrow(() => recordCacheMiss(type));
+                assert.doesNotThrow(() => recordCacheEviction(type));
+            }
+        });
+        it('should accept valid query types', () => {
+            const validTypes = ['traces', 'logs', 'metrics', 'llm_events', 'evaluations'];
+            for (const type of validTypes) {
+                assert.doesNotThrow(() => recordQueryDuration(type, COUNT_HUNDRED));
+            }
+        });
+        it('should accept valid backends', () => {
+            assert.doesNotThrow(() => recordQueryDuration('traces', COUNT_HUNDRED, 'local'));
+            assert.doesNotThrow(() => recordQueryDuration('traces', COUNT_HUNDRED, 'signoz'));
+        });
+    });
+});
+describe('metrics integration', () => {
+    const originalEnv = process.env.OTEL_ENABLED;
+    beforeEach(() => {
+        resetMetricsForTesting();
+    });
+    afterEach(() => {
+        resetMetricsForTesting();
+        if (originalEnv !== undefined) {
+            process.env.OTEL_ENABLED = originalEnv;
+        }
+        else {
+            delete process.env.OTEL_ENABLED;
+        }
+    });
+    it('should gracefully handle OTel API import failure', async () => {
+        // Mock import to simulate failure
+        process.env.OTEL_ENABLED = 'true';
+        // Even if OTel import fails internally, it should not throw
+        await initializeMetrics();
+        // Recording functions should still be safe to call
+        assert.doesNotThrow(() => recordCacheHit('traces'));
+    });
+    it('should support concurrent recording calls', async () => {
+        await initializeMetrics();
+        // Simulate concurrent calls
+        const calls = [];
+        for (let i = 0; i < COUNT_HUNDRED; i++) {
+            calls.push(Promise.resolve().then(() => recordCacheHit('traces')));
+            calls.push(Promise.resolve().then(() => recordCacheMiss('logs')));
+            calls.push(Promise.resolve().then(() => recordQueryDuration('metrics', i)));
+        }
+        await Promise.all(calls);
+        // Should complete without errors
+    });
+});
+//# sourceMappingURL=metrics.test.js.map

package/dist/lib/observability/metrics.test.js.map

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

package/dist/lib/observability/observability-test-constants.d.ts

@@ -0,0 +1,34 @@
+import { PERCENTILE } from '../core/units.js';
+export declare const OBS_TEST_COUNT_SEVENTY: number;
+export declare const OBS_TEST_COUNT_EIGHTY: number;
+export declare const OBS_TEST_COUNT_NINETY_FIVE = PERCENTILE.P95;
+export declare const OBS_TEST_COUNT_ONE_FIFTY: number;
+export declare const OBS_TEST_COUNT_FIFTEEN_THOUSAND: number;
+export declare const OBS_TEST_COUNT_TWENTY_THOUSAND: number;
+export declare const OBS_TEST_COUNT_MAX_FOR_FIFTEEN_THOUSAND_RANGE: number;
+export declare const OBS_TEST_COUNT_FOUR_THOUSAND: number;
+export declare const OBS_TEST_COUNT_NINE_THOUSAND_NINE_HUNDRED_NINETY_NINE = 9999;
+export declare const OBS_TEST_COUNT_NINETY_NINE_THOUSAND_NINE_HUNDRED_NINETY_NINE = 99999;
+export declare const OBS_TEST_COUNT_ONE_HUNDRED_THOUSAND: number;
+export declare const OBS_TEST_COUNT_ONE_HUNDRED_FIFTY_THOUSAND: number;
+export declare const OBS_TEST_COUNT_TWO_HUNDRED_THOUSAND: number;
+export declare const OBS_TEST_VALUE_FIFTY_FIVE = 55;
+export declare const OBS_TEST_VALUE_SEVENTY_FIVE = 75;
+export declare const OBS_TEST_VALUE_P50_LOW = 49;
+export declare const OBS_TEST_VALUE_P50_HIGH = 52;
+export declare const OBS_TEST_VALUE_P95_LOW = 93;
+export declare const OBS_TEST_VALUE_P95_HIGH = 97;
+export declare const OBS_TEST_VALUE_FIVE_HUNDRED = 500;
+export declare const OBS_TEST_NEGATIVE_FIVE: number;
+export declare const OBS_TEST_NEGATIVE_TEN = -10;
+export declare const OBS_TEST_FLOAT_ZERO_POINT_FIVE = 0.5;
+export declare const OBS_TEST_FLOAT_TWO_POINT_FIVE = 2.5;
+export declare const OBS_TEST_FLOAT_THREE_POINT_FIVE = 3.5;
+export declare const OBS_TEST_FLOAT_SEVEN_POINT_FIVE = 7.5;
+export declare const OBS_TEST_EXPECTED_MEAN_FOR_FIFTEEN_THOUSAND = 7499.5;
+export declare const OBS_TEST_EXPECTED_P50_FOR_FIFTEEN_THOUSAND = 7500;
+export declare const OBS_TEST_RESERVOIR_TOLERANCE_RATIO = 0.1;
+export declare const OBS_TEST_BINARY_SEARCH_BUCKETS: readonly [10, 20, 30, 40, 50, 60, number, number, 90, 100];
+export declare const OBS_TEST_SMALL_BUCKETS: readonly [100, 200, 300];
+export declare const OBS_TEST_CAPACITY_BUCKETS: readonly [1000, 5000, 10000];
+//# sourceMappingURL=observability-test-constants.d.ts.map

package/dist/lib/observability/observability-test-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability-test-constants.d.ts","sourceRoot":"","sources":["../../../src/lib/observability/observability-test-constants.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,eAAO,MAAM,sBAAsB,QAA0B,CAAC;AAC9D,eAAO,MAAM,qBAAqB,QAA0B,CAAC;AAC7D,eAAO,MAAM,0BAA0B,iBAAiB,CAAC;AACzD,eAAO,MAAM,wBAAwB,QAA8B,CAAC;AACpE,eAAO,MAAM,+BAA+B,QAAiC,CAAC;AAC9E,eAAO,MAAM,8BAA8B,QAAgC,CAAC;AAC5E,eAAO,MAAM,6CAA6C,QAAsC,CAAC;AACjG,eAAO,MAAM,4BAA4B,QAA8B,CAAC;AACxE,eAAO,MAAM,qDAAqD,OAAQ,CAAC;AAC3E,eAAO,MAAM,4DAA4D,QAAS,CAAC;AACnF,eAAO,MAAM,mCAAmC,QAAiC,CAAC;AAClF,eAAO,MAAM,yCAAyC,QAA4C,CAAC;AACnG,eAAO,MAAM,mCAAmC,QAAqC,CAAC;AAEtF,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAC5C,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAC9C,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAC/C,eAAO,MAAM,sBAAsB,QAAc,CAAC;AAClD,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAClD,eAAO,MAAM,6BAA6B,MAAM,CAAC;AACjD,eAAO,MAAM,+BAA+B,MAAM,CAAC;AACnD,eAAO,MAAM,+BAA+B,MAAM,CAAC;AAEnD,eAAO,MAAM,2CAA2C,SAAU,CAAC;AACnE,eAAO,MAAM,0CAA0C,OAAQ,CAAC;AAChE,eAAO,MAAM,kCAAkC,MAAM,CAAC;AAEtD,eAAO,MAAM,8BAA8B,4DAWjC,CAAC;AAEX,eAAO,MAAM,sBAAsB,0BAIzB,CAAC;AAEX,eAAO,MAAM,yBAAyB,8BAI5B,CAAC"}

package/dist/lib/observability/observability-test-constants.js

@@ -0,0 +1,55 @@
+import { DEFAULT_LIMIT_10, SAMPLE_SIZE_100, COUNT_EIGHT, COUNT_FIFTEEN, COUNT_FIVE, COUNT_FIFTY, COUNT_FOUR, COUNT_FORTY, COUNT_HUNDRED, COUNT_NINETY, COUNT_SEVEN, COUNT_SIXTY, COUNT_TEN, COUNT_THIRTY, COUNT_THOUSAND, COUNT_TWENTY, COUNT_TWO_HUNDRED, COUNT_THREE_HUNDRED, COUNT_FIVE_THOUSAND, } from '../../test-helpers/test-constants.js';
+import { MAX_RESULTS_IN_MEMORY, } from '../core/constants.js';
+import { PERCENTILE } from '../core/units.js';
+export const OBS_TEST_COUNT_SEVENTY = COUNT_SEVEN * COUNT_TEN;
+export const OBS_TEST_COUNT_EIGHTY = COUNT_EIGHT * COUNT_TEN;
+export const OBS_TEST_COUNT_NINETY_FIVE = PERCENTILE.P95;
+export const OBS_TEST_COUNT_ONE_FIFTY = COUNT_HUNDRED + COUNT_FIFTY;
+export const OBS_TEST_COUNT_FIFTEEN_THOUSAND = COUNT_FIFTEEN * COUNT_THOUSAND;
+export const OBS_TEST_COUNT_TWENTY_THOUSAND = COUNT_TWENTY * COUNT_THOUSAND;
+export const OBS_TEST_COUNT_MAX_FOR_FIFTEEN_THOUSAND_RANGE = OBS_TEST_COUNT_FIFTEEN_THOUSAND - 1;
+export const OBS_TEST_COUNT_FOUR_THOUSAND = COUNT_FOUR * COUNT_THOUSAND;
+export const OBS_TEST_COUNT_NINE_THOUSAND_NINE_HUNDRED_NINETY_NINE = 9_999;
+export const OBS_TEST_COUNT_NINETY_NINE_THOUSAND_NINE_HUNDRED_NINETY_NINE = 99_999;
+export const OBS_TEST_COUNT_ONE_HUNDRED_THOUSAND = COUNT_HUNDRED * COUNT_THOUSAND;
+export const OBS_TEST_COUNT_ONE_HUNDRED_FIFTY_THOUSAND = OBS_TEST_COUNT_ONE_FIFTY * COUNT_THOUSAND;
+export const OBS_TEST_COUNT_TWO_HUNDRED_THOUSAND = COUNT_TWO_HUNDRED * COUNT_THOUSAND;
+export const OBS_TEST_VALUE_FIFTY_FIVE = 55;
+export const OBS_TEST_VALUE_SEVENTY_FIVE = 75;
+export const OBS_TEST_VALUE_P50_LOW = 49;
+export const OBS_TEST_VALUE_P50_HIGH = 52;
+export const OBS_TEST_VALUE_P95_LOW = 93;
+export const OBS_TEST_VALUE_P95_HIGH = 97;
+export const OBS_TEST_VALUE_FIVE_HUNDRED = 500;
+export const OBS_TEST_NEGATIVE_FIVE = -COUNT_FIVE;
+export const OBS_TEST_NEGATIVE_TEN = -10;
+export const OBS_TEST_FLOAT_ZERO_POINT_FIVE = 0.5;
+export const OBS_TEST_FLOAT_TWO_POINT_FIVE = 2.5;
+export const OBS_TEST_FLOAT_THREE_POINT_FIVE = 3.5;
+export const OBS_TEST_FLOAT_SEVEN_POINT_FIVE = 7.5;
+export const OBS_TEST_EXPECTED_MEAN_FOR_FIFTEEN_THOUSAND = 7_499.5;
+export const OBS_TEST_EXPECTED_P50_FOR_FIFTEEN_THOUSAND = 7_500;
+export const OBS_TEST_RESERVOIR_TOLERANCE_RATIO = 0.1;
+export const OBS_TEST_BINARY_SEARCH_BUCKETS = [
+    DEFAULT_LIMIT_10,
+    COUNT_TWENTY,
+    COUNT_THIRTY,
+    COUNT_FORTY,
+    COUNT_FIFTY,
+    COUNT_SIXTY,
+    OBS_TEST_COUNT_SEVENTY,
+    OBS_TEST_COUNT_EIGHTY,
+    COUNT_NINETY,
+    SAMPLE_SIZE_100,
+];
+export const OBS_TEST_SMALL_BUCKETS = [
+    SAMPLE_SIZE_100,
+    COUNT_TWO_HUNDRED,
+    COUNT_THREE_HUNDRED,
+];
+export const OBS_TEST_CAPACITY_BUCKETS = [
+    COUNT_THOUSAND,
+    COUNT_FIVE_THOUSAND,
+    MAX_RESULTS_IN_MEMORY,
+];
+//# sourceMappingURL=observability-test-constants.js.map

package/dist/lib/observability/observability-test-constants.js.map

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

package/dist/lib/observability/opentelemetry-resources.test.d.ts

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

package/dist/lib/observability/opentelemetry-resources.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opentelemetry-resources.test.d.ts","sourceRoot":"","sources":["../../../src/lib/observability/opentelemetry-resources.test.ts"],"names":[],"mappings":""}

package/dist/lib/observability/opentelemetry-resources.test.js

@@ -0,0 +1,19 @@
+import { test } from 'node:test';
+import assert from 'node:assert';
+test('resourceFromAttributes type declaration', async (t) => {
+    // Verify the function is actually available and callable
+    const resourcesModule = await import('@opentelemetry/resources');
+    await t.test('resourceFromAttributes is exported', () => {
+        assert.ok('resourceFromAttributes' in resourcesModule, 'resourceFromAttributes should be exported from @opentelemetry/resources');
+        assert.strictEqual(typeof resourcesModule.resourceFromAttributes, 'function', 'resourceFromAttributes should be a function');
+    });
+    await t.test('resourceFromAttributes creates a valid resource', () => {
+        const resource = resourcesModule.resourceFromAttributes({
+            'service.name': 'test-service',
+            'service.version': '1.0.0',
+        });
+        assert.ok(resource, 'should return a resource object');
+        assert.ok(typeof resource.attributes === 'object', 'resource should have attributes property');
+    });
+});
+//# sourceMappingURL=opentelemetry-resources.test.js.map

package/dist/lib/observability/opentelemetry-resources.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opentelemetry-resources.test.js","sourceRoot":"","sources":["../../../src/lib/observability/opentelemetry-resources.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,IAAI,CAAC,yCAAyC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;IAC1D,yDAAyD;IACzD,MAAM,eAAe,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;IAEjE,MAAM,CAAC,CAAC,IAAI,CAAC,oCAAoC,EAAE,GAAG,EAAE;QACtD,MAAM,CAAC,EAAE,CACP,wBAAwB,IAAI,eAAe,EAC3C,yEAAyE,CAC1E,CAAC;QACF,MAAM,CAAC,WAAW,CAChB,OAAO,eAAe,CAAC,sBAAsB,EAC7C,UAAU,EACV,6CAA6C,CAC9C,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,CAAC,IAAI,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACnE,MAAM,QAAQ,GAAG,eAAe,CAAC,sBAAsB,CAAC;YACtD,cAAc,EAAE,cAAc;YAC9B,iBAAiB,EAAE,OAAO;SAC3B,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,iCAAiC,CAAC,CAAC;QACvD,MAAM,CAAC,EAAE,CACP,OAAO,QAAQ,CAAC,UAAU,KAAK,QAAQ,EACvC,0CAA0C,CAC3C,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/lib/observability/parse-stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-stats.d.ts","sourceRoot":"","sources":["../../../src/lib/observability/parse-stats.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAaH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,gBAAgB,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,UAAU,EAAE,cAAc,EAAE,CAAC;CAC9B;AAKD;;;;;GAKG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IAEvC;;;;OAIG;gBACS,eAAe,SAA6B,EAAE,aAAa,SAAmC;IAK1G;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA+BxB;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAOrC;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAOrC;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAOnC;;;OAGG;IACH,WAAW,CACT,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,IAAI;IAsBP;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAItD;;OAEG;IACH,iBAAiB,IAAI,mBAAmB;IAuCxC;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,gBAAgB,IAAI,MAAM,CAE7B;CACF;AAQD;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,iBAAiB,CAK9D;AAED;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,IAAI,CAKnD"}

package/dist/lib/observability/parse-stats.js

@@ -0,0 +1,207 @@
+/**
+ * Parse failure statistics tracking for JSONL files.
+ *
+ * Tracks parse success/failure/empty counts per file with LRU eviction.
+ * Used by streamJsonl() to provide visibility into malformed JSONL data.
+ *
+ * ## Features
+ * - Per-file tracking with success/failure/empty counters
+ * - LRU eviction when exceeding maxTrackedFiles (default: 100)
+ * - Aggregate statistics across all tracked files
+ * - Worst files identification by skip rate
+ *
+ * @example
+ * ```typescript
+ * const tracker = new ParseStatsTracker();
+ * tracker.recordSuccess('/path/to/file.jsonl');
+ * tracker.recordFailure('/path/to/file.jsonl');
+ * const stats = tracker.getAggregateStats();
+ * console.log(`Success rate: ${(stats.parseSuccessRate * 100).toFixed(1)}%`);
+ * ```
+ */
+import { createLogger } from '../core/logger.js';
+import { DEFAULT_QUERY_RESULT_LIMIT, WORST_FILES_LIMIT, } from '../core/constants.js';
+import { PERCENT_MULTIPLIER, } from '../core/units.js';
+const logger = createLogger('parse-stats');
+/** Default threshold for logging warnings about parse failures */
+const DEFAULT_WARN_THRESHOLD_SKIP_RATE = 0.1; // 10% skip rate
+/**
+ * Tracks JSONL parse statistics with LRU eviction.
+ *
+ * Uses Map insertion order for LRU behavior - oldest entries
+ * are evicted first when capacity is reached.
+ */
+export class ParseStatsTracker {
+    stats = new Map();
+    maxTrackedFiles;
+    warnThreshold;
+    /**
+     * Create a new ParseStatsTracker.
+     * @param maxTrackedFiles - Maximum files to track before LRU eviction (default: 100)
+     * @param warnThreshold - Skip rate threshold for warnings (0-1, default: 0.1 = 10%)
+     */
+    constructor(maxTrackedFiles = DEFAULT_QUERY_RESULT_LIMIT, warnThreshold = DEFAULT_WARN_THRESHOLD_SKIP_RATE) {
+        this.maxTrackedFiles = maxTrackedFiles;
+        this.warnThreshold = warnThreshold;
+    }
+    /**
+     * Get or create stats entry for a file, handling LRU eviction.
+     */
+    getOrCreateStats(filePath) {
+        let fileStats = this.stats.get(filePath);
+        if (fileStats) {
+            // Move to end for LRU (delete and re-add)
+            this.stats.delete(filePath);
+            this.stats.set(filePath, fileStats);
+            return fileStats;
+        }
+        // LRU eviction if at capacity
+        if (this.stats.size >= this.maxTrackedFiles) {
+            const firstKey = this.stats.keys().next().value;
+            if (firstKey !== undefined) {
+                this.stats.delete(firstKey);
+            }
+        }
+        // Create new stats entry
+        fileStats = {
+            filePath,
+            totalLines: 0,
+            parsedLines: 0,
+            skippedLines: 0,
+            emptyLines: 0,
+            lastUpdated: Date.now(),
+        };
+        this.stats.set(filePath, fileStats);
+        return fileStats;
+    }
+    /**
+     * Record a successful JSON parse for a file.
+     */
+    recordSuccess(filePath) {
+        const fileStats = this.getOrCreateStats(filePath);
+        fileStats.parsedLines++;
+        fileStats.totalLines++;
+        fileStats.lastUpdated = Date.now();
+    }
+    /**
+     * Record a failed JSON parse (malformed line) for a file.
+     */
+    recordFailure(filePath) {
+        const fileStats = this.getOrCreateStats(filePath);
+        fileStats.skippedLines++;
+        fileStats.totalLines++;
+        fileStats.lastUpdated = Date.now();
+    }
+    /**
+     * Record an empty line for a file.
+     */
+    recordEmpty(filePath) {
+        const fileStats = this.getOrCreateStats(filePath);
+        fileStats.emptyLines++;
+        fileStats.totalLines++;
+        fileStats.lastUpdated = Date.now();
+    }
+    /**
+     * Record a batch of parse results for a file.
+     * More efficient than individual calls when processing is complete.
+     */
+    recordBatch(filePath, parsed, skipped, empty) {
+        const fileStats = this.getOrCreateStats(filePath);
+        fileStats.parsedLines += parsed;
+        fileStats.skippedLines += skipped;
+        fileStats.emptyLines += empty;
+        fileStats.totalLines += parsed + skipped + empty;
+        fileStats.lastUpdated = Date.now();
+        // Log warning if skip rate exceeds threshold
+        const totalProcessed = fileStats.parsedLines + fileStats.skippedLines;
+        if (totalProcessed > 0) {
+            const skipRate = fileStats.skippedLines / totalProcessed;
+            if (skipRate >= this.warnThreshold && skipped > 0) {
+                logger.warn('High parse failure rate detected', {
+                    file: filePath,
+                    skipRate: Math.round(skipRate * PERCENT_MULTIPLIER),
+                    skippedLines: fileStats.skippedLines,
+                });
+            }
+        }
+    }
+    /**
+     * Get stats for a specific file.
+     */
+    getStats(filePath) {
+        return this.stats.get(filePath);
+    }
+    /**
+     * Get aggregate statistics across all tracked files.
+     */
+    getAggregateStats() {
+        let totalLines = 0;
+        let totalParsed = 0;
+        let totalSkipped = 0;
+        const allStats = [];
+        for (const fileStats of this.stats.values()) {
+            totalLines += fileStats.totalLines;
+            totalParsed += fileStats.parsedLines;
+            totalSkipped += fileStats.skippedLines;
+            allStats.push(fileStats);
+        }
+        // Calculate success rate (exclude empty lines from rate calculation)
+        const totalProcessed = totalParsed + totalSkipped;
+        const parseSuccessRate = totalProcessed > 0 ? totalParsed / totalProcessed : 1;
+        // Find worst files by skip rate
+        const worstFiles = allStats
+            .filter(s => s.parsedLines + s.skippedLines > 0) // Only files with actual data
+            .map(s => ({
+            ...s,
+            skipRate: s.skippedLines / (s.parsedLines + s.skippedLines),
+        }))
+            .sort((a, b) => b.skipRate - a.skipRate)
+            .slice(0, WORST_FILES_LIMIT)
+            .map(({ skipRate: _, ...s }) => s); // Remove internal skipRate field
+        return {
+            totalFiles: this.stats.size,
+            totalLines,
+            totalParsed,
+            totalSkipped,
+            parseSuccessRate,
+            worstFiles,
+        };
+    }
+    /**
+     * Reset all tracked statistics.
+     */
+    reset() {
+        this.stats.clear();
+    }
+    /**
+     * Get the number of files currently being tracked.
+     */
+    get trackedFileCount() {
+        return this.stats.size;
+    }
+}
+/**
+ * Global singleton tracker instance for use by backends.
+ * Backends can also create their own instances if isolation is needed.
+ */
+let globalTracker = null;
+/**
+ * Get the global ParseStatsTracker instance.
+ * Creates a new instance if none exists.
+ */
+export function getGlobalParseStatsTracker() {
+    if (!globalTracker) {
+        globalTracker = new ParseStatsTracker();
+    }
+    return globalTracker;
+}
+/**
+ * Reset the global tracker (useful for testing).
+ */
+export function resetGlobalParseStatsTracker() {
+    if (globalTracker) {
+        globalTracker.reset();
+    }
+    globalTracker = null;
+}
+//# sourceMappingURL=parse-stats.js.map

package/dist/lib/observability/parse-stats.js.map

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

package/dist/lib/observability/parse-stats.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-stats.test.d.ts","sourceRoot":"","sources":["../../../src/lib/observability/parse-stats.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}