observability-toolkit 1.8.5 → 2.1.0

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

@@ -0,0 +1,385 @@
+/**
+ * Tests for Response Time Histogram
+ */
+import { describe, it } from 'vitest';
+import * as assert from 'node:assert';
+import { Histogram, DEFAULT_LATENCY_BUCKETS } from './histogram.js';
+import { LATENCY_HISTOGRAM_BUCKETS_MS } from './histogram-bucket-constants.js';
+import { DEFAULT_LIMIT_10, P_VALUE_STRICT, SAMPLE_SIZE_100, COUNT_FIFTEEN, COUNT_FIVE, COUNT_FIVE_THOUSAND, COUNT_FIFTY, COUNT_SIX, COUNT_SEVEN, COUNT_SIXTY, COUNT_THOUSAND, COUNT_THREE, COUNT_THIRTY, COUNT_TWO, COUNT_TWO_HUNDRED, COUNT_TWENTY, COUNT_TWENTY_FIVE, VALUE_FORTY_TWO, } from '../../test-helpers/test-constants.js';
+import { OBS_TEST_BINARY_SEARCH_BUCKETS, OBS_TEST_CAPACITY_BUCKETS, OBS_TEST_COUNT_FIFTEEN_THOUSAND, OBS_TEST_COUNT_FOUR_THOUSAND, OBS_TEST_COUNT_MAX_FOR_FIFTEEN_THOUSAND_RANGE, OBS_TEST_COUNT_NINE_THOUSAND_NINE_HUNDRED_NINETY_NINE, OBS_TEST_COUNT_NINETY_FIVE, OBS_TEST_COUNT_NINETY_NINE_THOUSAND_NINE_HUNDRED_NINETY_NINE, OBS_TEST_COUNT_ONE_FIFTY, OBS_TEST_COUNT_ONE_HUNDRED_FIFTY_THOUSAND, OBS_TEST_COUNT_ONE_HUNDRED_THOUSAND, OBS_TEST_COUNT_TWENTY_THOUSAND, OBS_TEST_COUNT_TWO_HUNDRED_THOUSAND, OBS_TEST_EXPECTED_MEAN_FOR_FIFTEEN_THOUSAND, OBS_TEST_EXPECTED_P50_FOR_FIFTEEN_THOUSAND, OBS_TEST_FLOAT_SEVEN_POINT_FIVE, OBS_TEST_FLOAT_THREE_POINT_FIVE, OBS_TEST_FLOAT_TWO_POINT_FIVE, OBS_TEST_FLOAT_ZERO_POINT_FIVE, OBS_TEST_NEGATIVE_FIVE, OBS_TEST_NEGATIVE_TEN, OBS_TEST_RESERVOIR_TOLERANCE_RATIO, OBS_TEST_SMALL_BUCKETS, OBS_TEST_VALUE_FIFTY_FIVE, OBS_TEST_VALUE_FIVE_HUNDRED, OBS_TEST_VALUE_P50_HIGH, OBS_TEST_VALUE_P50_LOW, OBS_TEST_VALUE_P95_HIGH, OBS_TEST_VALUE_P95_LOW, OBS_TEST_VALUE_SEVENTY_FIVE, } from './observability-test-constants.js';
+describe('Histogram', () => {
+    describe('bucket counting', () => {
+        it('counts values in correct buckets', () => {
+            const histogram = new Histogram([DEFAULT_LIMIT_10, COUNT_FIFTY, SAMPLE_SIZE_100]);
+            histogram.observe(COUNT_FIVE); // bucket 0 (<=10)
+            histogram.observe(DEFAULT_LIMIT_10); // bucket 0 (<=10)
+            histogram.observe(COUNT_TWENTY_FIVE); // bucket 1 (<=50)
+            histogram.observe(OBS_TEST_VALUE_SEVENTY_FIVE); // bucket 2 (<=SAMPLE_SIZE_100)
+            histogram.observe(OBS_TEST_COUNT_ONE_FIFTY); // bucket 3 (+Inf)
+            const buckets = histogram.getBuckets();
+            assert.deepStrictEqual(buckets.counts, [COUNT_TWO, 1, 1, 1]);
+            assert.strictEqual(buckets.count, COUNT_FIVE);
+        });
+        it('handles boundary values correctly', () => {
+            const histogram = new Histogram([DEFAULT_LIMIT_10, COUNT_FIFTY, SAMPLE_SIZE_100]);
+            histogram.observe(DEFAULT_LIMIT_10); // bucket 0 (<=10)
+            histogram.observe(COUNT_FIFTY); // bucket 1 (<=50)
+            histogram.observe(SAMPLE_SIZE_100); // bucket 2 (<=SAMPLE_SIZE_100)
+            const buckets = histogram.getBuckets();
+            assert.deepStrictEqual(buckets.counts, [1, 1, 1, 0]);
+        });
+    });
+    describe('binary search assignment', () => {
+        it('assigns values using efficient binary search', () => {
+            const histogram = new Histogram([...OBS_TEST_BINARY_SEARCH_BUCKETS]);
+            // Values at boundaries
+            histogram.observe(DEFAULT_LIMIT_10);
+            histogram.observe(COUNT_FIFTY);
+            histogram.observe(SAMPLE_SIZE_100);
+            // Values between boundaries
+            histogram.observe(COUNT_FIFTEEN);
+            histogram.observe(OBS_TEST_VALUE_FIFTY_FIVE);
+            histogram.observe(OBS_TEST_COUNT_NINETY_FIVE);
+            const buckets = histogram.getBuckets();
+            assert.strictEqual(buckets.count, COUNT_SIX);
+            // bucket 0: 10; bucket 1: 15; bucket 4: 50; bucket 5: 55; bucket 9: 95, 100
+            assert.strictEqual(buckets.counts[0], 1);
+            assert.strictEqual(buckets.counts[1], 1);
+            assert.strictEqual(buckets.counts[4], 1);
+            assert.strictEqual(buckets.counts[5], 1);
+            assert.strictEqual(buckets.counts[9], COUNT_TWO);
+        });
+        it('handles values smaller than first bucket', () => {
+            const histogram = new Histogram([...OBS_TEST_SMALL_BUCKETS]);
+            histogram.observe(1);
+            histogram.observe(COUNT_FIFTY);
+            const buckets = histogram.getBuckets();
+            assert.strictEqual(buckets.counts[0], COUNT_TWO);
+        });
+    });
+    describe('percentile calculation', () => {
+        it('calculates p50 (median) correctly', () => {
+            const histogram = new Histogram();
+            for (let i = 1; i <= SAMPLE_SIZE_100; i++) {
+                histogram.observe(i);
+            }
+            const stats = histogram.getStats();
+            // Median of 1-100 should be around 50-51
+            assert.ok(stats.p50 >= OBS_TEST_VALUE_P50_LOW && stats.p50 <= OBS_TEST_VALUE_P50_HIGH, `p50 was ${stats.p50}`);
+        });
+        it('calculates p95 correctly', () => {
+            const histogram = new Histogram();
+            for (let i = 1; i <= SAMPLE_SIZE_100; i++) {
+                histogram.observe(i);
+            }
+            const stats = histogram.getStats();
+            // 95th percentile of 1-100 should be around 95
+            assert.ok(stats.p95 >= OBS_TEST_VALUE_P95_LOW && stats.p95 <= OBS_TEST_VALUE_P95_HIGH, `p95 was ${stats.p95}`);
+        });
+        it('calculates p99 correctly', () => {
+            const histogram = new Histogram();
+            for (let i = 1; i <= SAMPLE_SIZE_100; i++) {
+                histogram.observe(i);
+            }
+            const stats = histogram.getStats();
+            // 99th percentile of 1-100 should be around 99
+            assert.ok(stats.p99 >= OBS_TEST_VALUE_P95_HIGH && stats.p99 <= SAMPLE_SIZE_100, `p99 was ${stats.p99}`);
+        });
+        it('uses linear interpolation for percentiles', () => {
+            const histogram = new Histogram();
+            histogram.observe(DEFAULT_LIMIT_10);
+            histogram.observe(COUNT_TWENTY);
+            const stats = histogram.getStats();
+            // DDSketch does not interpolate between two values; p50 falls in one bucket
+            assert.ok(stats.p50 >= DEFAULT_LIMIT_10 * 0.95 && stats.p50 <= COUNT_TWENTY * 1.05, `p50 ${stats.p50} should be between ${DEFAULT_LIMIT_10} and ${COUNT_TWENTY}`);
+        });
+    });
+    describe('min/max/mean calculation', () => {
+        it('tracks minimum value', () => {
+            const histogram = new Histogram();
+            histogram.observe(SAMPLE_SIZE_100);
+            histogram.observe(COUNT_FIFTY);
+            histogram.observe(COUNT_TWO_HUNDRED);
+            histogram.observe(COUNT_FIVE);
+            const stats = histogram.getStats();
+            assert.strictEqual(stats.min, COUNT_FIVE);
+        });
+        it('tracks maximum value', () => {
+            const histogram = new Histogram();
+            histogram.observe(SAMPLE_SIZE_100);
+            histogram.observe(COUNT_FIFTY);
+            histogram.observe(COUNT_TWO_HUNDRED);
+            histogram.observe(COUNT_FIVE);
+            const stats = histogram.getStats();
+            assert.strictEqual(stats.max, COUNT_TWO_HUNDRED);
+        });
+        it('calculates mean correctly', () => {
+            const histogram = new Histogram();
+            histogram.observe(DEFAULT_LIMIT_10);
+            histogram.observe(COUNT_TWENTY);
+            histogram.observe(COUNT_THIRTY);
+            const stats = histogram.getStats();
+            assert.strictEqual(stats.mean, COUNT_TWENTY);
+        });
+        it('calculates sum correctly', () => {
+            const histogram = new Histogram();
+            histogram.observe(DEFAULT_LIMIT_10);
+            histogram.observe(COUNT_TWENTY);
+            histogram.observe(COUNT_THIRTY);
+            const buckets = histogram.getBuckets();
+            assert.strictEqual(buckets.sum, COUNT_SIXTY);
+        });
+    });
+    describe('reservoir sampling at capacity', () => {
+        it('maintains representative sample at capacity', () => {
+            const histogram = new Histogram();
+            // Add 15,000 values (exceeds 10,000 reservoir limit)
+            for (let i = 0; i < OBS_TEST_COUNT_FIFTEEN_THOUSAND; i++) {
+                histogram.observe(i);
+            }
+            const stats = histogram.getStats();
+            assert.strictEqual(stats.count, OBS_TEST_COUNT_FIFTEEN_THOUSAND);
+            assert.strictEqual(stats.min, 0);
+            assert.strictEqual(stats.max, OBS_TEST_COUNT_MAX_FOR_FIFTEEN_THOUSAND_RANGE);
+            // Mean should be close to 7499.5 (center of 0-14999)
+            const expectedMean = OBS_TEST_EXPECTED_MEAN_FOR_FIFTEEN_THOUSAND;
+            assert.ok(Math.abs(stats.mean - expectedMean) < 1, `Mean was ${stats.mean}, expected ${expectedMean}`);
+            // Percentiles should be within 5% accuracy as per acceptance criteria
+            const expectedP50 = OBS_TEST_EXPECTED_P50_FOR_FIFTEEN_THOUSAND;
+            const tolerance = expectedP50 * OBS_TEST_RESERVOIR_TOLERANCE_RATIO; // 10% tolerance for reservoir sampling
+            assert.ok(Math.abs(stats.p50 - expectedP50) < tolerance, `p50 was ${stats.p50}, expected ~${expectedP50}`);
+        });
+        it('continues counting accurately beyond reservoir capacity', () => {
+            const histogram = new Histogram([...OBS_TEST_CAPACITY_BUCKETS]);
+            for (let i = 0; i < OBS_TEST_COUNT_TWENTY_THOUSAND; i++) {
+                histogram.observe(i);
+            }
+            const buckets = histogram.getBuckets();
+            assert.strictEqual(buckets.count, OBS_TEST_COUNT_TWENTY_THOUSAND);
+            // bucket 0: 0-1000 (1001 values)
+            // bucket 1: 1001-5000 (4000 values)
+            // bucket 2: 5001-10000 (5000 values)
+            // bucket 3: 10001-19999 (9999 values)
+            assert.strictEqual(buckets.counts[0], COUNT_THOUSAND + 1);
+            assert.strictEqual(buckets.counts[1], OBS_TEST_COUNT_FOUR_THOUSAND);
+            assert.strictEqual(buckets.counts[2], COUNT_FIVE_THOUSAND);
+            assert.strictEqual(buckets.counts[3], OBS_TEST_COUNT_NINE_THOUSAND_NINE_HUNDRED_NINETY_NINE);
+        });
+    });
+    describe('reset clears all data', () => {
+        it('resets all statistics', () => {
+            const histogram = new Histogram();
+            histogram.observe(DEFAULT_LIMIT_10);
+            histogram.observe(COUNT_FIFTY);
+            histogram.observe(SAMPLE_SIZE_100);
+            histogram.reset();
+            const stats = histogram.getStats();
+            assert.strictEqual(stats.count, 0);
+            assert.strictEqual(stats.min, 0);
+            assert.strictEqual(stats.max, 0);
+            assert.strictEqual(stats.mean, 0);
+            assert.strictEqual(stats.p50, 0);
+            assert.strictEqual(stats.p95, 0);
+            assert.strictEqual(stats.p99, 0);
+        });
+        it('resets bucket counts', () => {
+            const histogram = new Histogram([DEFAULT_LIMIT_10, COUNT_FIFTY, SAMPLE_SIZE_100]);
+            histogram.observe(COUNT_FIVE);
+            histogram.observe(COUNT_TWENTY_FIVE);
+            histogram.observe(OBS_TEST_VALUE_SEVENTY_FIVE);
+            histogram.reset();
+            const buckets = histogram.getBuckets();
+            assert.deepStrictEqual(buckets.counts, [0, 0, 0, 0]);
+            assert.strictEqual(buckets.sum, 0);
+            assert.strictEqual(buckets.count, 0);
+        });
+        it('allows new observations after reset', () => {
+            const histogram = new Histogram();
+            histogram.observe(SAMPLE_SIZE_100);
+            histogram.reset();
+            histogram.observe(COUNT_FIFTY);
+            const stats = histogram.getStats();
+            assert.strictEqual(stats.count, 1);
+            assert.strictEqual(stats.min, COUNT_FIFTY);
+            assert.strictEqual(stats.max, COUNT_FIFTY);
+            assert.strictEqual(stats.mean, COUNT_FIFTY);
+        });
+    });
+    describe('empty histogram returns zeros', () => {
+        it('returns zero stats when no observations', () => {
+            const histogram = new Histogram();
+            const stats = histogram.getStats();
+            assert.strictEqual(stats.min, 0);
+            assert.strictEqual(stats.max, 0);
+            assert.strictEqual(stats.mean, 0);
+            assert.strictEqual(stats.p50, 0);
+            assert.strictEqual(stats.p95, 0);
+            assert.strictEqual(stats.p99, 0);
+            assert.strictEqual(stats.count, 0);
+        });
+        it('returns zero bucket counts when no observations', () => {
+            const histogram = new Histogram([DEFAULT_LIMIT_10, COUNT_FIFTY, SAMPLE_SIZE_100]);
+            const buckets = histogram.getBuckets();
+            assert.deepStrictEqual(buckets.counts, [0, 0, 0, 0]);
+            assert.strictEqual(buckets.sum, 0);
+            assert.strictEqual(buckets.count, 0);
+        });
+    });
+    describe('custom bucket boundaries', () => {
+        it('accepts custom boundaries', () => {
+            const histogram = new Histogram([1, COUNT_FIVE, DEFAULT_LIMIT_10, COUNT_TWENTY_FIVE]);
+            histogram.observe(OBS_TEST_FLOAT_ZERO_POINT_FIVE);
+            histogram.observe(COUNT_THREE);
+            histogram.observe(COUNT_SEVEN);
+            histogram.observe(COUNT_FIFTEEN);
+            histogram.observe(SAMPLE_SIZE_100);
+            const buckets = histogram.getBuckets();
+            assert.deepStrictEqual(buckets.buckets, [1, COUNT_FIVE, DEFAULT_LIMIT_10, COUNT_TWENTY_FIVE]);
+            assert.deepStrictEqual(buckets.counts, [1, 1, 1, 1, 1]);
+        });
+        it('sorts unsorted boundaries', () => {
+            const histogram = new Histogram([SAMPLE_SIZE_100, DEFAULT_LIMIT_10, COUNT_FIFTY]);
+            const buckets = histogram.getBuckets();
+            assert.deepStrictEqual(buckets.buckets, [DEFAULT_LIMIT_10, COUNT_FIFTY, SAMPLE_SIZE_100]);
+        });
+        it('uses default buckets when none provided', () => {
+            const histogram = new Histogram();
+            const buckets = histogram.getBuckets();
+            assert.deepStrictEqual(buckets.buckets, DEFAULT_LATENCY_BUCKETS);
+        });
+    });
+    describe('constructor validation', () => {
+        it('throws error for negative bucket boundaries', () => {
+            assert.throws(() => new Histogram([DEFAULT_LIMIT_10, OBS_TEST_NEGATIVE_FIVE, SAMPLE_SIZE_100]), new RegExp(`Invalid bucket boundary: ${OBS_TEST_NEGATIVE_FIVE}\\. Boundaries must be finite non-negative numbers`));
+        });
+        it('throws error for NaN bucket boundary', () => {
+            assert.throws(() => new Histogram([DEFAULT_LIMIT_10, NaN, SAMPLE_SIZE_100]), /Invalid bucket boundary: NaN\. Boundaries must be finite non-negative numbers/);
+        });
+        it('throws error for Infinity bucket boundary', () => {
+            assert.throws(() => new Histogram([DEFAULT_LIMIT_10, Infinity, SAMPLE_SIZE_100]), /Invalid bucket boundary: Infinity\. Boundaries must be finite non-negative numbers/);
+        });
+        it('throws error for -Infinity bucket boundary', () => {
+            assert.throws(() => new Histogram([DEFAULT_LIMIT_10, -Infinity, SAMPLE_SIZE_100]), /Invalid bucket boundary: -Infinity\. Boundaries must be finite non-negative numbers/);
+        });
+        it('accepts zero as valid bucket boundary', () => {
+            const histogram = new Histogram([0, DEFAULT_LIMIT_10, COUNT_FIFTY]);
+            const buckets = histogram.getBuckets();
+            assert.deepStrictEqual(buckets.buckets, [0, DEFAULT_LIMIT_10, COUNT_FIFTY]);
+        });
+        it('accepts valid positive boundaries', () => {
+            const histogram = new Histogram([1, COUNT_FIVE, DEFAULT_LIMIT_10, SAMPLE_SIZE_100]);
+            const buckets = histogram.getBuckets();
+            assert.deepStrictEqual(buckets.buckets, [1, COUNT_FIVE, DEFAULT_LIMIT_10, SAMPLE_SIZE_100]);
+        });
+    });
+    describe('single value histogram', () => {
+        it('handles single observation correctly', () => {
+            const histogram = new Histogram();
+            histogram.observe(VALUE_FORTY_TWO);
+            const stats = histogram.getStats();
+            assert.strictEqual(stats.min, VALUE_FORTY_TWO);
+            assert.strictEqual(stats.max, VALUE_FORTY_TWO);
+            assert.strictEqual(stats.mean, VALUE_FORTY_TWO);
+            // DDSketch uses relative error; approximate match for percentiles
+            assert.ok(Math.abs(stats.p50 - VALUE_FORTY_TWO) < VALUE_FORTY_TWO * 0.05, `p50 ${stats.p50} should approximate ${VALUE_FORTY_TWO}`);
+            assert.ok(Math.abs(stats.p95 - VALUE_FORTY_TWO) < VALUE_FORTY_TWO * 0.05, `p95 ${stats.p95} should approximate ${VALUE_FORTY_TWO}`);
+            assert.ok(Math.abs(stats.p99 - VALUE_FORTY_TWO) < VALUE_FORTY_TWO * 0.05, `p99 ${stats.p99} should approximate ${VALUE_FORTY_TWO}`);
+            assert.strictEqual(stats.count, 1);
+        });
+        it('places single value in correct bucket', () => {
+            const histogram = new Histogram([DEFAULT_LIMIT_10, COUNT_FIFTY, SAMPLE_SIZE_100]);
+            histogram.observe(OBS_TEST_VALUE_SEVENTY_FIVE);
+            const buckets = histogram.getBuckets();
+            assert.deepStrictEqual(buckets.counts, [0, 0, 1, 0]);
+        });
+    });
+    describe('large values (>max bucket)', () => {
+        it('places values larger than max bucket in +Inf bucket', () => {
+            const histogram = new Histogram([DEFAULT_LIMIT_10, COUNT_FIFTY, SAMPLE_SIZE_100]);
+            histogram.observe(OBS_TEST_VALUE_FIVE_HUNDRED);
+            histogram.observe(COUNT_THOUSAND);
+            histogram.observe(OBS_TEST_COUNT_NINETY_NINE_THOUSAND_NINE_HUNDRED_NINETY_NINE);
+            const buckets = histogram.getBuckets();
+            assert.strictEqual(buckets.counts[3], COUNT_THREE); // +Inf bucket
+        });
+        it('tracks large values in statistics', () => {
+            const histogram = new Histogram([DEFAULT_LIMIT_10, COUNT_FIFTY, SAMPLE_SIZE_100]);
+            histogram.observe(OBS_TEST_COUNT_ONE_HUNDRED_THOUSAND);
+            histogram.observe(OBS_TEST_COUNT_TWO_HUNDRED_THOUSAND);
+            const stats = histogram.getStats();
+            assert.strictEqual(stats.min, OBS_TEST_COUNT_ONE_HUNDRED_THOUSAND);
+            assert.strictEqual(stats.max, OBS_TEST_COUNT_TWO_HUNDRED_THOUSAND);
+            assert.strictEqual(stats.mean, OBS_TEST_COUNT_ONE_HUNDRED_FIFTY_THOUSAND);
+        });
+    });
+    describe('negative value rejection', () => {
+        it('ignores negative values', () => {
+            const histogram = new Histogram();
+            histogram.observe(OBS_TEST_NEGATIVE_TEN);
+            histogram.observe(-1);
+            histogram.observe(COUNT_FIFTY);
+            const stats = histogram.getStats();
+            assert.strictEqual(stats.count, 1);
+            assert.strictEqual(stats.min, COUNT_FIFTY);
+            assert.strictEqual(stats.max, COUNT_FIFTY);
+        });
+    });
+    describe('zero values', () => {
+        it('accepts zero as valid value', () => {
+            const histogram = new Histogram([DEFAULT_LIMIT_10, COUNT_FIFTY, SAMPLE_SIZE_100]);
+            histogram.observe(0);
+            const stats = histogram.getStats();
+            assert.strictEqual(stats.count, 1);
+            assert.strictEqual(stats.min, 0);
+            assert.strictEqual(stats.max, 0);
+            const buckets = histogram.getBuckets();
+            assert.strictEqual(buckets.counts[0], 1);
+        });
+    });
+    describe('floating point values', () => {
+        it('handles floating point values correctly', () => {
+            const histogram = new Histogram([1, COUNT_FIVE, DEFAULT_LIMIT_10]);
+            histogram.observe(OBS_TEST_FLOAT_ZERO_POINT_FIVE);
+            histogram.observe(OBS_TEST_FLOAT_TWO_POINT_FIVE);
+            histogram.observe(OBS_TEST_FLOAT_SEVEN_POINT_FIVE);
+            const stats = histogram.getStats();
+            assert.strictEqual(stats.count, COUNT_THREE);
+            assert.strictEqual(stats.min, OBS_TEST_FLOAT_ZERO_POINT_FIVE);
+            assert.strictEqual(stats.max, OBS_TEST_FLOAT_SEVEN_POINT_FIVE);
+            assert.ok(Math.abs(stats.mean - OBS_TEST_FLOAT_THREE_POINT_FIVE) < P_VALUE_STRICT);
+        });
+    });
+    describe('getCount convenience method', () => {
+        it('returns total observation count', () => {
+            const histogram = new Histogram();
+            histogram.observe(DEFAULT_LIMIT_10);
+            histogram.observe(COUNT_TWENTY);
+            histogram.observe(COUNT_THIRTY);
+            assert.strictEqual(histogram.getCount(), COUNT_THREE);
+        });
+        it('returns zero for empty histogram', () => {
+            const histogram = new Histogram();
+            assert.strictEqual(histogram.getCount(), 0);
+        });
+    });
+    describe('DEFAULT_LATENCY_BUCKETS export', () => {
+        it('exports correct default buckets', () => {
+            assert.deepStrictEqual(DEFAULT_LATENCY_BUCKETS, LATENCY_HISTOGRAM_BUCKETS_MS);
+        });
+    });
+    describe('concurrent observations simulation', () => {
+        it('handles rapid sequential observations', () => {
+            const histogram = new Histogram();
+            // Simulate 1000 rapid observations
+            for (let i = 0; i < COUNT_THOUSAND; i++) {
+                histogram.observe(Math.random() * SAMPLE_SIZE_100);
+            }
+            const stats = histogram.getStats();
+            assert.strictEqual(stats.count, COUNT_THOUSAND);
+            assert.ok(stats.min >= 0);
+            assert.ok(stats.max <= SAMPLE_SIZE_100);
+            assert.ok(stats.mean >= 0 && stats.mean <= SAMPLE_SIZE_100);
+        });
+    });
+});
+//# sourceMappingURL=histogram.test.js.map

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

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

package/dist/lib/observability/indexer.d.ts

@@ -0,0 +1,114 @@
+/**
+ * File-level indexing for JSONL telemetry files
+ *
+ * Generates .idx sidecar files containing line-level metadata for fast filtering.
+ * Index files are JSON with metadata + array of index entries pointing to line numbers.
+ */
+import { z } from 'zod';
+export declare const telemetryTypeSchema: z.ZodEnum<{
+    metrics: "metrics";
+    traces: "traces";
+    logs: "logs";
+    evaluations: "evaluations";
+    "llm-events": "llm-events";
+}>;
+export declare const indexEntrySchema: z.ZodObject<{
+    lineNumber: z.ZodInt;
+    timestamp: z.ZodInt;
+    traceId: z.ZodOptional<z.ZodString>;
+    spanName: z.ZodOptional<z.ZodString>;
+    serviceName: z.ZodOptional<z.ZodString>;
+    severity: z.ZodOptional<z.ZodString>;
+    metricName: z.ZodOptional<z.ZodString>;
+    agentId: z.ZodOptional<z.ZodString>;
+    toolName: z.ZodOptional<z.ZodString>;
+    operationName: z.ZodOptional<z.ZodString>;
+    evaluationName: z.ZodOptional<z.ZodString>;
+    scoreLabel: z.ZodOptional<z.ZodString>;
+    responseId: z.ZodOptional<z.ZodString>;
+    evaluator: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const fileIndexSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    sourceFile: z.ZodString;
+    sourceMtime: z.ZodNumber;
+    entries: z.ZodArray<z.ZodObject<{
+        lineNumber: z.ZodInt;
+        timestamp: z.ZodInt;
+        traceId: z.ZodOptional<z.ZodString>;
+        spanName: z.ZodOptional<z.ZodString>;
+        serviceName: z.ZodOptional<z.ZodString>;
+        severity: z.ZodOptional<z.ZodString>;
+        metricName: z.ZodOptional<z.ZodString>;
+        agentId: z.ZodOptional<z.ZodString>;
+        toolName: z.ZodOptional<z.ZodString>;
+        operationName: z.ZodOptional<z.ZodString>;
+        evaluationName: z.ZodOptional<z.ZodString>;
+        scoreLabel: z.ZodOptional<z.ZodString>;
+        responseId: z.ZodOptional<z.ZodString>;
+        evaluator: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const indexQueryOptionsSchema: z.ZodObject<{
+    traceId: z.ZodOptional<z.ZodString>;
+    spanName: z.ZodOptional<z.ZodString>;
+    serviceName: z.ZodOptional<z.ZodString>;
+    severity: z.ZodOptional<z.ZodString>;
+    metricName: z.ZodOptional<z.ZodString>;
+    agentId: z.ZodOptional<z.ZodString>;
+    toolName: z.ZodOptional<z.ZodString>;
+    operationName: z.ZodOptional<z.ZodString>;
+    evaluationName: z.ZodOptional<z.ZodString>;
+    scoreLabel: z.ZodOptional<z.ZodString>;
+    responseId: z.ZodOptional<z.ZodString>;
+    evaluator: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Telemetry data types supported by indexing */
+export type TelemetryType = z.infer<typeof telemetryTypeSchema>;
+/** Individual index entry pointing to a line in the source JSONL file */
+export type IndexEntry = z.infer<typeof indexEntrySchema>;
+/** Complete index file structure */
+export type FileIndex = z.infer<typeof fileIndexSchema>;
+/** Filter criteria for querying an index */
+export type IndexQueryOptions = z.infer<typeof indexQueryOptionsSchema>;
+/**
+ * Get the index file path for a given JSONL file
+ * For .jsonl.gz files, strips .gz before adding .idx
+ * (so traces.jsonl.gz -> traces.jsonl.idx, not traces.jsonl.gz.idx)
+ */
+export declare function getIndexPath(jsonlPath: string): string;
+/**
+ * Read an index file if it exists
+ * Returns null if file doesn't exist or is invalid
+ */
+export declare function readIndex(idxPath: string): FileIndex | null;
+/**
+ * Check if an index is stale (source file has been modified)
+ */
+export declare function isIndexStale(index: FileIndex, sourcePath: string): boolean;
+/**
+ * Build an index for a JSONL file
+ * Handles both plain .jsonl and gzip compressed .jsonl.gz files
+ */
+export declare function buildIndex(jsonlPath: string, type: TelemetryType): Promise<FileIndex>;
+/**
+ * Build and write an index for a JSONL file
+ */
+export declare function buildAndWriteIndex(jsonlPath: string, type: TelemetryType): Promise<FileIndex>;
+/**
+ * Get or build an index for a JSONL file
+ * Returns cached index if valid, otherwise builds and caches a new one
+ */
+export declare function getOrBuildIndex(jsonlPath: string, type: TelemetryType): Promise<FileIndex | null>;
+/**
+ * Get line numbers matching the query from an index
+ * Returns null if no filters can be applied (full scan needed)
+ */
+export declare function queryIndex(index: FileIndex, options: IndexQueryOptions): number[] | null;
+/**
+ * Read specific lines from a file by line numbers
+ * Returns records in the order of the line numbers provided
+ * Handles both plain .jsonl and gzip compressed .jsonl.gz files
+ */
+export declare function readLinesByNumber<T>(filePath: string, lineNumbers: number[], schema?: z.Schema<T>): Promise<T[]>;
+//# sourceMappingURL=indexer.d.ts.map

package/dist/lib/observability/indexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexer.d.ts","sourceRoot":"","sources":["../../../src/lib/observability/indexer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiBxB,eAAO,MAAM,mBAAmB;;;;;;EAAqE,CAAC;AAEtG,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;iBAiB3B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;iBAK1B,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;iBAelC,CAAC;AAEH,iDAAiD;AACjD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,yEAAyE;AACzE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,oCAAoC;AACpC,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,4CAA4C;AAC5C,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAkB3D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAQ1E;AA6GD;;;GAGG;AACH,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC,CA0D3F;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,SAAS,CAAC,CAKpB;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAe3B;AAGD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,EAAE,GAAG,IAAI,CA0FxF;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EAAE,EACrB,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,EAAE,CAAC,CA4Cd"}