@warlock.js/core 4.0.156 → 4.0.158

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@warlock.js/core",
-    "version": "4.0.156",
+    "version": "4.0.158",
     "description": "A robust nodejs framework for building blazing fast applications",
     "main": "./esm/index.js",
     "bin": {
@@ -31,12 +31,12 @@
         "pluralize-esm": "^9.0.5",
         "@mongez/supportive-is": "^2.0.4",
         "@mongez/time-wizard": "^1.0.6",
-        "@warlock.js/auth": "4.0.156",
-        "@warlock.js/cache": "4.0.156",
-        "@warlock.js/cascade": "4.0.156",
-        "@warlock.js/context": "4.0.156",
-        "@warlock.js/logger": "4.0.156",
-        "@warlock.js/seal": "4.0.156",
+        "@warlock.js/auth": "4.0.158",
+        "@warlock.js/cache": "4.0.158",
+        "@warlock.js/cascade": "4.0.158",
+        "@warlock.js/context": "4.0.158",
+        "@warlock.js/logger": "4.0.158",
+        "@warlock.js/seal": "4.0.158",
         "axios": "^1.14.0",
         "chokidar": "^5.0.0",
         "dayjs": "^1.11.19",

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

@@ -1,27 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,68 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,94 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

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

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

@@ -1 +0,0 @@
-{"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

@@ -1,47 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,77 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,25 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

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

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

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

package/esm/benchmark/benchmark.js

@@ -1,120 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,14 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,29 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

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

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

@@ -1 +0,0 @@
-{"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

@@ -1,5 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

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

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

@@ -1 +0,0 @@
-{"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

@@ -1,7 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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"}