@warlock.js/core 4.0.161 → 4.0.163

package/esm/application/application-config-types.d.ts

@@ -0,0 +1,27 @@
+export type AppConfigurations = {
+    /**
+     * App name
+     */
+    appName?: string;
+    /**
+     * Default locale code
+     *
+     * @default en
+     */
+    localeCode?: string;
+    /**
+     * Application base URL
+     *
+     * @default localhost:
+     */
+    baseUrl?: string;
+    /**
+     * Application timezone
+     */
+    timezone?: string;
+    /**
+     * Locale Codes list
+     */
+    localeCodes?: string[];
+};
+//# sourceMappingURL=application-config-types.d.ts.map

package/esm/application/application-config-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-config-types.d.ts","sourceRoot":"","sources":["../../src/application/application-config-types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC"}

package/esm/application/application.d.ts

@@ -0,0 +1,68 @@
+import { type Environment } from "../utils/environment";
+export declare class Application {
+    /**
+     * Project start time regarding the process start time
+     */
+    static readonly startedAt: Date;
+    /**
+     * Runtime strategy
+     */
+    static runtimeStrategy: "production" | "development";
+    /**
+     * Get framework version
+     */
+    static get version(): string;
+    /**
+     * Set the runtime strategy
+     */
+    static setRuntimeStrategy(strategy: "production" | "development"): void;
+    /**
+     * Get project uptime in milliseconds
+     */
+    static get uptime(): number;
+    /**
+     * Get the current environment
+     */
+    static get environment(): Environment;
+    /**
+     * Set the current environment
+     */
+    static setEnvironment(env: Environment): void;
+    /**
+     * Check if the application is running in production environment
+     */
+    static get isProduction(): boolean;
+    /**
+     * Check if the application is running in development environment
+     */
+    static get isDevelopment(): boolean;
+    /**
+     * Check if the application is running in test environment
+     */
+    static get isTest(): boolean;
+    /**
+     * Get the root path
+     */
+    static get rootPath(): string;
+    /**
+     * Get the src path
+     */
+    static get srcPath(): string;
+    /**
+     * Get the app path
+     */
+    static get appPath(): string;
+    /**
+     * Get the storage path
+     */
+    static get storagePath(): string;
+    /**
+     * Get the uploads path
+     */
+    static get uploadsPath(): string;
+    /**
+     * Get the public path
+     */
+    static get publicPath(): string;
+}
+//# sourceMappingURL=application.d.ts.map

package/esm/application/application.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../../src/application/application.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAIrF,qBAAa,WAAW;IACtB;;OAEG;IACH,gBAAuB,SAAS,OAAkD;IAElF;;OAEG;IACH,OAAc,eAAe,EAAE,YAAY,GAAG,aAAa,CAAC;IAE5D;;OAEG;IACH,WAAkB,OAAO,WAExB;IAED;;OAEG;WACW,kBAAkB,CAAC,QAAQ,EAAE,YAAY,GAAG,aAAa;IAIvE;;OAEG;IACH,WAAkB,MAAM,IAAI,MAAM,CAEjC;IAED;;OAEG;IACH,WAAkB,WAAW,IAAI,WAAW,CAE3C;IAED;;OAEG;WACW,cAAc,CAAC,GAAG,EAAE,WAAW;IAI7C;;OAEG;IACH,WAAkB,YAAY,IAAI,OAAO,CAExC;IAED;;OAEG;IACH,WAAkB,aAAa,IAAI,OAAO,CAEzC;IAED;;OAEG;IACH,WAAkB,MAAM,IAAI,OAAO,CAElC;IAED;;OAEG;IACH,WAAkB,QAAQ,IAAI,MAAM,CAEnC;IAED;;OAEG;IACH,WAAkB,OAAO,IAAI,MAAM,CAElC;IAED;;OAEG;IACH,WAAkB,OAAO,IAAI,MAAM,CAElC;IAED;;OAEG;IACH,WAAkB,WAAW,IAAI,MAAM,CAEtC;IAED;;OAEG;IACH,WAAkB,WAAW,IAAI,MAAM,CAEtC;IAED;;OAEG;IACH,WAAkB,UAAU,IAAI,MAAM,CAErC;CACF"}

package/esm/application/application.js

@@ -0,0 +1,94 @@
+import {environment,setEnvironment}from'../utils/environment.js';import {getFrameworkVersion}from'../utils/framework-vesion.js';import {rootPath,srcPath,appPath,storagePath,uploadsPath,publicPath}from'../utils/paths.js';class Application {
+    /**
+     * Project start time regarding the process start time
+     */
+    static startedAt = new Date(Date.now() - process.uptime() * 1000);
+    /**
+     * Runtime strategy
+     */
+    static runtimeStrategy;
+    /**
+     * Get framework version
+     */
+    static get version() {
+        return getFrameworkVersion();
+    }
+    /**
+     * Set the runtime strategy
+     */
+    static setRuntimeStrategy(strategy) {
+        this.runtimeStrategy = strategy;
+    }
+    /**
+     * Get project uptime in milliseconds
+     */
+    static get uptime() {
+        return process.uptime() * 1000;
+    }
+    /**
+     * Get the current environment
+     */
+    static get environment() {
+        return environment();
+    }
+    /**
+     * Set the current environment
+     */
+    static setEnvironment(env) {
+        setEnvironment(env);
+    }
+    /**
+     * Check if the application is running in production environment
+     */
+    static get isProduction() {
+        return this.environment === "production";
+    }
+    /**
+     * Check if the application is running in development environment
+     */
+    static get isDevelopment() {
+        return this.environment === "development";
+    }
+    /**
+     * Check if the application is running in test environment
+     */
+    static get isTest() {
+        return this.environment === "test";
+    }
+    /**
+     * Get the root path
+     */
+    static get rootPath() {
+        return rootPath();
+    }
+    /**
+     * Get the src path
+     */
+    static get srcPath() {
+        return srcPath();
+    }
+    /**
+     * Get the app path
+     */
+    static get appPath() {
+        return appPath();
+    }
+    /**
+     * Get the storage path
+     */
+    static get storagePath() {
+        return storagePath();
+    }
+    /**
+     * Get the uploads path
+     */
+    static get uploadsPath() {
+        return uploadsPath();
+    }
+    /**
+     * Get the public path
+     */
+    static get publicPath() {
+        return publicPath();
+    }
+}export{Application};//# sourceMappingURL=application.js.map

package/esm/application/application.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application.js","sources":["../../src/application/application.ts"],"sourcesContent":[null],"names":[],"mappings":"kOAIa,WAAW,CAAA;AACtB;;AAEG;AACI,IAAA,OAAgB,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;AAElF;;AAEG;IACI,OAAO,eAAe,CAA+B;AAE5D;;AAEG;AACI,IAAA,WAAW,OAAO,GAAA;QACvB,OAAO,mBAAmB,EAAE,CAAC;KAC9B;AAED;;AAEG;IACI,OAAO,kBAAkB,CAAC,QAAsC,EAAA;AACrE,QAAA,IAAI,CAAC,eAAe,GAAG,QAAQ,CAAC;KACjC;AAED;;AAEG;AACI,IAAA,WAAW,MAAM,GAAA;AACtB,QAAA,OAAO,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;KAChC;AAED;;AAEG;AACI,IAAA,WAAW,WAAW,GAAA;QAC3B,OAAO,WAAW,EAAE,CAAC;KACtB;AAED;;AAEG;IACI,OAAO,cAAc,CAAC,GAAgB,EAAA;QAC3C,cAAc,CAAC,GAAG,CAAC,CAAC;KACrB;AAED;;AAEG;AACI,IAAA,WAAW,YAAY,GAAA;AAC5B,QAAA,OAAO,IAAI,CAAC,WAAW,KAAK,YAAY,CAAC;KAC1C;AAED;;AAEG;AACI,IAAA,WAAW,aAAa,GAAA;AAC7B,QAAA,OAAO,IAAI,CAAC,WAAW,KAAK,aAAa,CAAC;KAC3C;AAED;;AAEG;AACI,IAAA,WAAW,MAAM,GAAA;AACtB,QAAA,OAAO,IAAI,CAAC,WAAW,KAAK,MAAM,CAAC;KACpC;AAED;;AAEG;AACI,IAAA,WAAW,QAAQ,GAAA;QACxB,OAAO,QAAQ,EAAE,CAAC;KACnB;AAED;;AAEG;AACI,IAAA,WAAW,OAAO,GAAA;QACvB,OAAO,OAAO,EAAE,CAAC;KAClB;AAED;;AAEG;AACI,IAAA,WAAW,OAAO,GAAA;QACvB,OAAO,OAAO,EAAE,CAAC;KAClB;AAED;;AAEG;AACI,IAAA,WAAW,WAAW,GAAA;QAC3B,OAAO,WAAW,EAAE,CAAC;KACtB;AAED;;AAEG;AACI,IAAA,WAAW,WAAW,GAAA;QAC3B,OAAO,WAAW,EAAE,CAAC;KACtB;AAED;;AAEG;AACI,IAAA,WAAW,UAAU,GAAA;QAC1B,OAAO,UAAU,EAAE,CAAC;KACrB;"}

package/esm/application/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./application";
+export * from "./application-config-types";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/application/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,4BAA4B,CAAC"}

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":"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"}

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"}