@warlock.js/core 4.0.135 → 4.0.137

package/esm/benchmark/benchmark-snapshots.d.ts

@@ -0,0 +1,47 @@
+import type { BenchmarkErrorResult, BenchmarkSnapshotsOptions, BenchmarkSuccessResult } from "./types";
+export declare class BenchmarkSnapshots {
+    private readonly maxSnapshots;
+    private readonly capture;
+    private readonly snapshots;
+    constructor(options?: BenchmarkSnapshotsOptions);
+    /**
+     * Record a raw result. Called automatically by measure() when a snapshotContainer is set.
+     * Respects the `capture` setting — ignores results that don't match.
+     *
+     * @param result - The success or error result to record.
+     *
+     * @example
+     * snapshots.record(result);
+     */
+    record(result: BenchmarkSuccessResult<unknown> | BenchmarkErrorResult): void;
+    /**
+     * Get all snapshots for one operation name.
+     *
+     * @param name - The operation name.
+     * @returns Array of snapshots for the operation.
+     *
+     * @example
+     * snapshots.getSnapshots("db-query");
+     */
+    getSnapshots(name: string): (BenchmarkSuccessResult<unknown> | BenchmarkErrorResult)[];
+    /**
+     * Get all snapshots for all tracked operations.
+     *
+     * @returns A mapping of operation names to their snapshots array.
+     *
+     * @example
+     * snapshots.allSnapshots();
+     */
+    allSnapshots(): Record<string, (BenchmarkSuccessResult<unknown> | BenchmarkErrorResult)[]>;
+    /**
+     * Clear snapshots for one or all operations.
+     *
+     * @param name - Optional operation name. If omitted, clears all snapshots.
+     *
+     * @example
+     * snapshots.reset("db-query");
+     * snapshots.reset();
+     */
+    reset(name?: string): void;
+}
+//# sourceMappingURL=benchmark-snapshots.d.ts.map

package/esm/benchmark/benchmark-snapshots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"benchmark-snapshots.d.ts","sourceRoot":"","sources":["../../src/benchmark/benchmark-snapshots.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,yBAAyB,EACzB,sBAAsB,EACvB,MAAM,SAAS,CAAC;AAEjB,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAGtB;gBAEe,OAAO,CAAC,EAAE,yBAAyB;IAKtD;;;;;;;;OAQG;IACI,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,OAAO,CAAC,GAAG,oBAAoB,GAAG,IAAI;IAkBnF;;;;;;;;OAQG;IACI,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,sBAAsB,CAAC,OAAO,CAAC,GAAG,oBAAoB,CAAC,EAAE;IAI7F;;;;;;;OAOG;IACI,YAAY,IAAI,MAAM,CAC3B,MAAM,EACN,CAAC,sBAAsB,CAAC,OAAO,CAAC,GAAG,oBAAoB,CAAC,EAAE,CAC3D;IAUD;;;;;;;;OAQG;IACI,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;CAOlC"}

package/esm/benchmark/benchmark-snapshots.js

@@ -0,0 +1,77 @@
+class BenchmarkSnapshots {
+    maxSnapshots;
+    capture;
+    snapshots = new Map();
+    constructor(options) {
+        this.maxSnapshots = options?.maxSnapshots ?? 100;
+        this.capture = options?.capture ?? "error";
+    }
+    /**
+     * Record a raw result. Called automatically by measure() when a snapshotContainer is set.
+     * Respects the `capture` setting — ignores results that don't match.
+     *
+     * @param result - The success or error result to record.
+     *
+     * @example
+     * snapshots.record(result);
+     */
+    record(result) {
+        if (this.capture === "error" && result.success)
+            return;
+        if (this.capture === "value" && !result.success)
+            return;
+        let list = this.snapshots.get(result.name);
+        if (!list) {
+            list = [];
+            this.snapshots.set(result.name, list);
+        }
+        if (list.length >= this.maxSnapshots && this.maxSnapshots > 0) {
+            list.shift(); // Evict oldest
+        }
+        list.push(result);
+    }
+    /**
+     * Get all snapshots for one operation name.
+     *
+     * @param name - The operation name.
+     * @returns Array of snapshots for the operation.
+     *
+     * @example
+     * snapshots.getSnapshots("db-query");
+     */
+    getSnapshots(name) {
+        return this.snapshots.get(name) ?? [];
+    }
+    /**
+     * Get all snapshots for all tracked operations.
+     *
+     * @returns A mapping of operation names to their snapshots array.
+     *
+     * @example
+     * snapshots.allSnapshots();
+     */
+    allSnapshots() {
+        const all = {};
+        for (const [name, list] of this.snapshots.entries()) {
+            all[name] = [...list];
+        }
+        return all;
+    }
+    /**
+     * Clear snapshots for one or all operations.
+     *
+     * @param name - Optional operation name. If omitted, clears all snapshots.
+     *
+     * @example
+     * snapshots.reset("db-query");
+     * snapshots.reset();
+     */
+    reset(name) {
+        if (name) {
+            this.snapshots.delete(name);
+        }
+        else {
+            this.snapshots.clear();
+        }
+    }
+}export{BenchmarkSnapshots};//# sourceMappingURL=benchmark-snapshots.js.map

package/esm/benchmark/benchmark-snapshots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"benchmark-snapshots.js","sources":["../../src/benchmark/benchmark-snapshots.ts"],"sourcesContent":[null],"names":[],"mappings":"MAMa,kBAAkB,CAAA;AACZ,IAAA,YAAY,CAAS;AACrB,IAAA,OAAO,CAA4B;AACnC,IAAA,SAAS,GAAG,IAAI,GAAG,EAGjC,CAAC;AAEJ,IAAA,WAAA,CAAmB,OAAmC,EAAA;QACpD,IAAI,CAAC,YAAY,GAAG,OAAO,EAAE,YAAY,IAAI,GAAG,CAAC;QACjD,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,OAAO,CAAC;KAC5C;AAED;;;;;;;;AAQG;AACI,IAAA,MAAM,CAAC,MAA8D,EAAA;QAC1E,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,IAAI,MAAM,CAAC,OAAO;YAAE,OAAO;QACvD,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO;AAExD,QAAA,IAAI,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAE3C,IAAI,CAAC,IAAI,EAAE;YACT,IAAI,GAAG,EAAE,CAAC;YACV,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AACvC,SAAA;AAED,QAAA,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,GAAG,CAAC,EAAE;AAC7D,YAAA,IAAI,CAAC,KAAK,EAAE,CAAC;AACd,SAAA;AAED,QAAA,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;KACnB;AAED;;;;;;;;AAQG;AACI,IAAA,YAAY,CAAC,IAAY,EAAA;QAC9B,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;KACvC;AAED;;;;;;;AAOG;IACI,YAAY,GAAA;QAIjB,MAAM,GAAG,GAA+E,EAAE,CAAC;AAE3F,QAAA,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE;YACnD,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;AACvB,SAAA;AAED,QAAA,OAAO,GAAG,CAAC;KACZ;AAED;;;;;;;;AAQG;AACI,IAAA,KAAK,CAAC,IAAa,EAAA;AACxB,QAAA,IAAI,IAAI,EAAE;AACR,YAAA,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC7B,SAAA;AAAM,aAAA;AACL,YAAA,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;AACxB,SAAA;KACF;AACF"}

package/esm/benchmark/benchmark.d.ts

@@ -0,0 +1,25 @@
+import type { BenchmarkErrorResult, BenchmarkOptions, BenchmarkSuccessResult } from "./types";
+/**
+ * Measure the execution time of a function and classify its performance.
+ *
+ * When `enabled` is false, fn() is still called but no timing runs and no hooks fire.
+ * A zeroed SuccessResult is returned to keep the return type stable for all callers.
+ *
+ * @example
+ * ```ts
+ * const result = await measure("db-query", () => db.query("SELECT 1"), {
+ *   latencyRange: { excellent: 100, poor: 500 },
+ *   onComplete: (r) => metrics.record(r.latency),
+ *   onError:    (r) => logger.error("query failed", r.error),
+ *   onFinish:   (r) => logger.info(`${r.name} took ${r.latency}ms`),
+ * });
+ *
+ * if (isSuccessResult(result)) {
+ *   console.log(result.value);
+ * } else {
+ *   console.error(result.error);
+ * }
+ * ```
+ */
+export declare function measure<T>(name: string, fn: () => T | Promise<T>, options?: BenchmarkOptions<T>): Promise<BenchmarkSuccessResult<T> | BenchmarkErrorResult>;
+//# sourceMappingURL=benchmark.d.ts.map

package/esm/benchmark/benchmark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"benchmark.d.ts","sourceRoot":"","sources":["../../src/benchmark/benchmark.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACvB,MAAM,SAAS,CAAC;AAmBjB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,OAAO,CAAC,CAAC,EAC7B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EACxB,OAAO,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC5B,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC,GAAG,oBAAoB,CAAC,CAkG3D"}

package/esm/benchmark/benchmark.example.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=benchmark.example.d.ts.map

package/esm/benchmark/benchmark.example.d.ts.map

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

package/esm/benchmark/benchmark.js

@@ -0,0 +1,120 @@
+import {config}from'../config/config-getter.js';import'../config/config-handlers.js';/**
+ * Classifies latency into "excellent", "good", or "poor" based on thresholds.
+ *
+ * @example
+ * latencyState(80, { excellent: 100, poor: 500 })  // "excellent"
+ * latencyState(300, { excellent: 100, poor: 500 }) // "good"
+ * latencyState(600, { excellent: 100, poor: 500 }) // "poor"
+ */
+function latencyState(latency, range) {
+    if (latency <= range.excellent)
+        return "excellent";
+    if (latency >= range.poor)
+        return "poor";
+    return "good";
+}
+/**
+ * Measure the execution time of a function and classify its performance.
+ *
+ * When `enabled` is false, fn() is still called but no timing runs and no hooks fire.
+ * A zeroed SuccessResult is returned to keep the return type stable for all callers.
+ *
+ * @example
+ * ```ts
+ * const result = await measure("db-query", () => db.query("SELECT 1"), {
+ *   latencyRange: { excellent: 100, poor: 500 },
+ *   onComplete: (r) => metrics.record(r.latency),
+ *   onError:    (r) => logger.error("query failed", r.error),
+ *   onFinish:   (r) => logger.info(`${r.name} took ${r.latency}ms`),
+ * });
+ *
+ * if (isSuccessResult(result)) {
+ *   console.log(result.value);
+ * } else {
+ *   console.error(result.error);
+ * }
+ * ```
+ */
+async function measure(name, fn, options) {
+    // Fast path: disabled — call fn() and return a zeroed success wrapper.
+    // No timing, no hooks. Re-throws if fn() throws.
+    if (options?.enabled === false) {
+        const value = await fn();
+        return {
+            name,
+            success: true,
+            value,
+            latency: 0,
+            state: "excellent",
+            tags: options.tags,
+            startedAt: new Date(),
+            endedAt: new Date(),
+        };
+    }
+    // Resolve latency range from inline options or global config
+    const benchmarkConfig = config.get("benchmark");
+    const latencyRange = options?.latencyRange ?? benchmarkConfig?.latencyRange;
+    const startedAt = new Date();
+    const startTime = performance.now();
+    const profiler = options?.profiler ?? benchmarkConfig?.profiler;
+    const snapshotContainer = options?.snapshotContainer ?? benchmarkConfig?.snapshotContainer;
+    try {
+        const value = await fn();
+        const endTime = performance.now();
+        const latency = Math.round(endTime - startTime);
+        const state = latencyRange ? latencyState(latency, latencyRange) : "good";
+        const result = {
+            name,
+            success: true,
+            value,
+            latency,
+            state,
+            tags: options?.tags,
+            startedAt,
+            endedAt: new Date(),
+        };
+        if (profiler) {
+            profiler.record(result);
+        }
+        if (snapshotContainer) {
+            snapshotContainer.record(result);
+        }
+        options?.onComplete?.(result);
+        options?.onFinish?.(result);
+        return result;
+    }
+    catch (thrown) {
+        // Decide whether to benchmark this error or just re-throw immediately
+        const shouldBenchmark = options?.shouldBenchmarkError
+            ? options.shouldBenchmarkError(thrown)
+            : true;
+        if (!shouldBenchmark) {
+            throw thrown;
+        }
+        // Capture timing even on failure — a 30s timeout is very different from a 2ms crash
+        const endTime = performance.now();
+        const latency = Math.round(endTime - startTime);
+        const state = latencyRange ? latencyState(latency, latencyRange) : "poor";
+        // Normalize thrown value to something consistent
+        const error = thrown instanceof Error ? thrown : new Error(String(thrown));
+        const result = {
+            name,
+            success: false,
+            error,
+            latency,
+            state,
+            tags: options?.tags,
+            startedAt,
+            endedAt: new Date(),
+        };
+        if (profiler) {
+            profiler.record(result);
+        }
+        if (snapshotContainer) {
+            snapshotContainer.record(result);
+        }
+        options?.onError?.(result);
+        options?.onFinish?.(result);
+        return result;
+    }
+}export{measure};//# sourceMappingURL=benchmark.js.map

package/esm/benchmark/benchmark.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"benchmark.js","sources":["../../src/benchmark/benchmark.ts"],"sourcesContent":[null],"names":[],"mappings":"qFAQA;;;;;;;AAOG;AACH,SAAS,YAAY,CACnB,OAAe,EACf,KAA0C,EAAA;AAE1C,IAAA,IAAI,OAAO,IAAI,KAAK,CAAC,SAAS;AAAE,QAAA,OAAO,WAAW,CAAC;AACnD,IAAA,IAAI,OAAO,IAAI,KAAK,CAAC,IAAI;AAAE,QAAA,OAAO,MAAM,CAAC;AACzC,IAAA,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;AAqBG;AACI,eAAe,OAAO,CAC3B,IAAY,EACZ,EAAwB,EACxB,OAA6B,EAAA;;;AAI7B,IAAA,IAAI,OAAO,EAAE,OAAO,KAAK,KAAK,EAAE;AAC9B,QAAA,MAAM,KAAK,GAAG,MAAM,EAAE,EAAE,CAAC;QACzB,OAAO;YACL,IAAI;AACJ,YAAA,OAAO,EAAE,IAAI;YACb,KAAK;AACL,YAAA,OAAO,EAAE,CAAC;AACV,YAAA,KAAK,EAAE,WAAW;YAClB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,OAAO,EAAE,IAAI,IAAI,EAAE;SACpB,CAAC;AACH,KAAA;;IAGD,MAAM,eAAe,GAAG,MAAM,CAAC,GAAG,CAA0B,WAAW,CAAC,CAAC;IACzE,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,IAAI,eAAe,EAAE,YAAY,CAAC;AAE5E,IAAA,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;AAC7B,IAAA,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IACpC,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,eAAe,EAAE,QAAQ,CAAC;IAChE,MAAM,iBAAiB,GAAG,OAAO,EAAE,iBAAiB,IAAI,eAAe,EAAE,iBAAiB,CAAC;IAE3F,IAAI;AACF,QAAA,MAAM,KAAK,GAAG,MAAM,EAAE,EAAE,CAAC;AAEzB,QAAA,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;AAChD,QAAA,MAAM,KAAK,GAAG,YAAY,GAAG,YAAY,CAAC,OAAO,EAAE,YAAY,CAAC,GAAG,MAAM,CAAC;AAE1E,QAAA,MAAM,MAAM,GAA8B;YACxC,IAAI;AACJ,YAAA,OAAO,EAAE,IAAI;YACb,KAAK;YACL,OAAO;YACP,KAAK;YACL,IAAI,EAAE,OAAO,EAAE,IAAI;YACnB,SAAS;YACT,OAAO,EAAE,IAAI,IAAI,EAAE;SACpB,CAAC;AAEF,QAAA,IAAI,QAAQ,EAAE;AACZ,YAAA,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACzB,SAAA;AAED,QAAA,IAAI,iBAAiB,EAAE;AACrB,YAAA,iBAAiB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAClC,SAAA;AAED,QAAA,OAAO,EAAE,UAAU,GAAG,MAAM,CAAC,CAAC;AAC9B,QAAA,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC,CAAC;AAE5B,QAAA,OAAO,MAAM,CAAC;AACf,KAAA;AAAC,IAAA,OAAO,MAAM,EAAE;;AAEf,QAAA,MAAM,eAAe,GAAG,OAAO,EAAE,oBAAoB;AACnD,cAAE,OAAO,CAAC,oBAAoB,CAAC,MAAM,CAAC;cACpC,IAAI,CAAC;QAET,IAAI,CAAC,eAAe,EAAE;AACpB,YAAA,MAAM,MAAM,CAAC;AACd,SAAA;;AAGD,QAAA,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;AAChD,QAAA,MAAM,KAAK,GAAG,YAAY,GAAG,YAAY,CAAC,OAAO,EAAE,YAAY,CAAC,GAAG,MAAM,CAAC;;QAG1E,MAAM,KAAK,GAAG,MAAM,YAAY,KAAK,GAAG,MAAM,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;AAE3E,QAAA,MAAM,MAAM,GAAyB;YACnC,IAAI;AACJ,YAAA,OAAO,EAAE,KAAK;YACd,KAAK;YACL,OAAO;YACP,KAAK;YACL,IAAI,EAAE,OAAO,EAAE,IAAI;YACnB,SAAS;YACT,OAAO,EAAE,IAAI,IAAI,EAAE;SACpB,CAAC;AAEF,QAAA,IAAI,QAAQ,EAAE;AACZ,YAAA,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACzB,SAAA;AAED,QAAA,IAAI,iBAAiB,EAAE;AACrB,YAAA,iBAAiB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAClC,SAAA;AAED,QAAA,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC;AAC3B,QAAA,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC,CAAC;AAE5B,QAAA,OAAO,MAAM,CAAC;AACf,KAAA;AACH"}

package/esm/benchmark/channels/console.channel.d.ts

@@ -0,0 +1,14 @@
+import type { BenchmarkChannel, BenchmarkStats } from "../types";
+export declare class ConsoleChannel implements BenchmarkChannel {
+    /**
+     * Pretty-prints a stats table per operation on onFlush().
+     *
+     * @param stats - Aggregated stats for all tracked operations.
+     *
+     * @example
+     * const channel = new ConsoleChannel();
+     * channel.onFlush({ "db-query": { p50: 10, count: 100, ... } });
+     */
+    onFlush(stats: Record<string, BenchmarkStats>): void;
+}
+//# sourceMappingURL=console.channel.d.ts.map

package/esm/benchmark/channels/console.channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.channel.d.ts","sourceRoot":"","sources":["../../../src/benchmark/channels/console.channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAEjE,qBAAa,cAAe,YAAW,gBAAgB;IACrD;;;;;;;;OAQG;IACI,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,IAAI;CAoB5D"}

package/esm/benchmark/channels/console.channel.js

@@ -0,0 +1,29 @@
+class ConsoleChannel {
+    /**
+     * Pretty-prints a stats table per operation on onFlush().
+     *
+     * @param stats - Aggregated stats for all tracked operations.
+     *
+     * @example
+     * const channel = new ConsoleChannel();
+     * channel.onFlush({ "db-query": { p50: 10, count: 100, ... } });
+     */
+    onFlush(stats) {
+        const tableData = {};
+        for (const [name, operationStats] of Object.entries(stats)) {
+            tableData[name] = {
+                "p50 (ms)": operationStats.p50,
+                "p90 (ms)": operationStats.p90,
+                "p95 (ms)": operationStats.p95,
+                "p99 (ms)": operationStats.p99,
+                "Avg (ms)": operationStats.avg,
+                "Min (ms)": operationStats.min,
+                "Max (ms)": operationStats.max,
+                "Error Rate": `${(operationStats.errorRate * 100).toFixed(2)}%`,
+                Errors: operationStats.errors,
+                Count: operationStats.count,
+            };
+        }
+        console.table(tableData);
+    }
+}export{ConsoleChannel};//# sourceMappingURL=console.channel.js.map

package/esm/benchmark/channels/console.channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.channel.js","sources":["../../../src/benchmark/channels/console.channel.ts"],"sourcesContent":[null],"names":[],"mappings":"MAEa,cAAc,CAAA;AACzB;;;;;;;;AAQG;AACI,IAAA,OAAO,CAAC,KAAqC,EAAA;QAClD,MAAM,SAAS,GAAwB,EAAE,CAAC;AAE1C,QAAA,KAAK,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;YAC1D,SAAS,CAAC,IAAI,CAAC,GAAG;gBAChB,UAAU,EAAE,cAAc,CAAC,GAAG;gBAC9B,UAAU,EAAE,cAAc,CAAC,GAAG;gBAC9B,UAAU,EAAE,cAAc,CAAC,GAAG;gBAC9B,UAAU,EAAE,cAAc,CAAC,GAAG;gBAC9B,UAAU,EAAE,cAAc,CAAC,GAAG;gBAC9B,UAAU,EAAE,cAAc,CAAC,GAAG;gBAC9B,UAAU,EAAE,cAAc,CAAC,GAAG;AAC9B,gBAAA,YAAY,EAAE,CAAA,EAAG,CAAC,cAAc,CAAC,SAAS,GAAG,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,CAAG,CAAA,CAAA;gBAC/D,MAAM,EAAE,cAAc,CAAC,MAAM;gBAC7B,KAAK,EAAE,cAAc,CAAC,KAAK;aAC5B,CAAC;AACH,SAAA;AAED,QAAA,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;KAC1B;AACF"}

package/esm/benchmark/channels/index.d.ts

@@ -0,0 +1,3 @@
+export { ConsoleChannel } from "./console.channel";
+export { NoopChannel } from "./noop.channel";
+//# sourceMappingURL=index.d.ts.map

package/esm/benchmark/channels/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/benchmark/channels/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/esm/benchmark/channels/noop.channel.d.ts

@@ -0,0 +1,5 @@
+import type { BenchmarkChannel } from "../types";
+export declare class NoopChannel implements BenchmarkChannel {
+    onFlush(): void;
+}
+//# sourceMappingURL=noop.channel.d.ts.map

package/esm/benchmark/channels/noop.channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop.channel.d.ts","sourceRoot":"","sources":["../../../src/benchmark/channels/noop.channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD,qBAAa,WAAY,YAAW,gBAAgB;IAC3C,OAAO,IAAI,IAAI;CACvB"}

package/esm/benchmark/channels/noop.channel.js

@@ -0,0 +1,3 @@
+class NoopChannel {
+    onFlush() { }
+}export{NoopChannel};//# sourceMappingURL=noop.channel.js.map

package/esm/benchmark/channels/noop.channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop.channel.js","sources":["../../../src/benchmark/channels/noop.channel.ts"],"sourcesContent":[null],"names":[],"mappings":"MAEa,WAAW,CAAA;AACf,IAAA,OAAO,MAAW;AAC1B"}

package/esm/benchmark/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./benchmark";
+export { BenchmarkSnapshots } from "./benchmark-snapshots";
+export { ConsoleChannel } from "./channels/console.channel";
+export { NoopChannel } from "./channels/noop.channel";
+export { BenchmarkProfiler } from "./profiler";
+export type { BenchmarkChannel, BenchmarkConfigurations, BenchmarkErrorResult, BenchmarkOptions, BenchmarkProfilerOptions, BenchmarkResult, BenchmarkSnapshotsOptions, BenchmarkStats, BenchmarkSuccessResult, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/esm/benchmark/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/benchmark/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,YAAY,EACV,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,EAChB,wBAAwB,EACxB,eAAe,EACf,yBAAyB,EACzB,cAAc,EACd,sBAAsB,GACvB,MAAM,SAAS,CAAC"}

package/esm/benchmark/profiler.d.ts

@@ -0,0 +1,63 @@
+import type { BenchmarkErrorResult, BenchmarkProfilerOptions, BenchmarkStats, BenchmarkSuccessResult } from "./types";
+export declare class BenchmarkProfiler {
+    private readonly maxSamples;
+    private readonly channels;
+    private readonly entries;
+    private interval?;
+    constructor(options?: BenchmarkProfilerOptions);
+    /**
+     * Record one measurement result. Called automatically by measure() when a profiler is set.
+     *
+     * @param result - The success or error result from measure()
+     *
+     * @example
+     * profiler.record(result);
+     */
+    record(result: BenchmarkSuccessResult<unknown> | BenchmarkErrorResult): void;
+    /**
+     * Get aggregated stats for one operation name.
+     * Computes p50/p95/p99 by sorting the ring buffer on demand.
+     *
+     * @param name - The operation name to get stats for.
+     * @returns Stats object or undefined if no data yet.
+     *
+     * @example
+     * const stats = profiler.stats("db-query");
+     */
+    stats(name: string): BenchmarkStats | undefined;
+    /**
+     * Get stats for all tracked operations.
+     *
+     * @returns A record mapping operation names to their stats.
+     *
+     * @example
+     * const all = profiler.allStats();
+     */
+    allStats(): Record<string, BenchmarkStats>;
+    /**
+     * Send allStats() to all registered channels.
+     *
+     * @example
+     * await profiler.flush();
+     */
+    flush(): Promise<void>;
+    /**
+     * Clear ring buffer for one or all operations.
+     * Does NOT reset unbounded total/error counters.
+     *
+     * @param name - Optional operation name. If omitted, clears all ring buffers.
+     *
+     * @example
+     * profiler.reset("db-query");
+     * profiler.reset();
+     */
+    reset(name?: string): void;
+    /**
+     * Dispose the profiler, clearing its auto-flush interval.
+     *
+     * @example
+     * profiler.dispose();
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=profiler.d.ts.map

package/esm/benchmark/profiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiler.d.ts","sourceRoot":"","sources":["../../src/benchmark/profiler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,oBAAoB,EACpB,wBAAwB,EACxB,cAAc,EACd,sBAAsB,EACvB,MAAM,SAAS,CAAC;AAWjB,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,QAAQ,CAAC,CAAiC;gBAE/B,OAAO,CAAC,EAAE,wBAAwB;IAYrD;;;;;;;OAOG;IACI,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,OAAO,CAAC,GAAG,oBAAoB,GAAG,IAAI;IAmCnF;;;;;;;;;OASG;IACI,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IA4BtD;;;;;;;OAOG;IACI,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC;IAWjD;;;;;OAKG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IASnC;;;;;;;;;OASG;IACI,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAejC;;;;;OAKG;IACI,OAAO,IAAI,IAAI;CAMvB"}

package/esm/benchmark/profiler.js

@@ -0,0 +1,155 @@
+import {NoopChannel}from'./channels/noop.channel.js';class BenchmarkProfiler {
+    maxSamples;
+    channels;
+    entries = new Map();
+    interval;
+    constructor(options) {
+        this.maxSamples = options?.maxSamples ?? 1000;
+        this.channels = options?.channels ?? [new NoopChannel()];
+        if (options?.flushEvery) {
+            this.interval = setInterval(() => {
+                // We use void to explicitly ignore the promise, as this is a background interval
+                void this.flush();
+            }, options.flushEvery);
+        }
+    }
+    /**
+     * Record one measurement result. Called automatically by measure() when a profiler is set.
+     *
+     * @param result - The success or error result from measure()
+     *
+     * @example
+     * profiler.record(result);
+     */
+    record(result) {
+        let entry = this.entries.get(result.name);
+        if (!entry) {
+            entry = {
+                latencies: [],
+                sum: 0,
+                total: 0,
+                errors: 0,
+                firstSeenAt: result.startedAt,
+                lastSeenAt: result.endedAt,
+            };
+            this.entries.set(result.name, entry);
+        }
+        entry.latencies.push(result.latency);
+        entry.sum += result.latency;
+        if (entry.latencies.length > this.maxSamples) {
+            const removed = entry.latencies.shift();
+            if (removed !== undefined) {
+                entry.sum -= removed;
+            }
+        }
+        entry.total += 1;
+        if (!result.success) {
+            entry.errors += 1;
+        }
+        entry.lastSeenAt = result.endedAt;
+    }
+    /**
+     * Get aggregated stats for one operation name.
+     * Computes p50/p95/p99 by sorting the ring buffer on demand.
+     *
+     * @param name - The operation name to get stats for.
+     * @returns Stats object or undefined if no data yet.
+     *
+     * @example
+     * const stats = profiler.stats("db-query");
+     */
+    stats(name) {
+        const entry = this.entries.get(name);
+        if (!entry || entry.latencies.length === 0)
+            return undefined;
+        const latencies = [...entry.latencies].sort((a, b) => a - b);
+        const count = latencies.length;
+        const getP = (percentile) => {
+            const index = Math.min(count - 1, Math.floor(count * percentile));
+            return latencies[index];
+        };
+        return {
+            p50: getP(0.5),
+            p90: getP(0.9),
+            p95: getP(0.95),
+            p99: getP(0.99),
+            avg: Math.round((entry.sum / count) * 100) / 100,
+            min: latencies[0],
+            max: latencies[count - 1],
+            count: entry.total,
+            errors: entry.errors,
+            errorRate: Math.round((entry.errors / entry.total) * 100) / 100,
+            firstSeenAt: entry.firstSeenAt,
+            lastSeenAt: entry.lastSeenAt,
+        };
+    }
+    /**
+     * Get stats for all tracked operations.
+     *
+     * @returns A record mapping operation names to their stats.
+     *
+     * @example
+     * const all = profiler.allStats();
+     */
+    allStats() {
+        const all = {};
+        for (const name of this.entries.keys()) {
+            const operationStats = this.stats(name);
+            if (operationStats) {
+                all[name] = operationStats;
+            }
+        }
+        return all;
+    }
+    /**
+     * Send allStats() to all registered channels.
+     *
+     * @example
+     * await profiler.flush();
+     */
+    async flush() {
+        const stats = this.allStats();
+        if (Object.keys(stats).length === 0)
+            return;
+        for (const channel of this.channels) {
+            await channel.onFlush(stats);
+        }
+    }
+    /**
+     * Clear ring buffer for one or all operations.
+     * Does NOT reset unbounded total/error counters.
+     *
+     * @param name - Optional operation name. If omitted, clears all ring buffers.
+     *
+     * @example
+     * profiler.reset("db-query");
+     * profiler.reset();
+     */
+    reset(name) {
+        if (name) {
+            const entry = this.entries.get(name);
+            if (entry) {
+                entry.latencies = [];
+                entry.sum = 0;
+            }
+        }
+        else {
+            for (const entry of this.entries.values()) {
+                entry.latencies = [];
+                entry.sum = 0;
+            }
+        }
+    }
+    /**
+     * Dispose the profiler, clearing its auto-flush interval.
+     *
+     * @example
+     * profiler.dispose();
+     */
+    dispose() {
+        if (this.interval) {
+            clearInterval(this.interval);
+            this.interval = undefined;
+        }
+    }
+}export{BenchmarkProfiler};//# sourceMappingURL=profiler.js.map

package/esm/benchmark/profiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiler.js","sources":["../../src/benchmark/profiler.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}