@warlock.js/core 4.0.174 → 4.1.3

package/README.md

@@ -2,6 +2,10 @@
 
 A robust nodejs framework for building blazing fast applications.
 
+## Installation
+
+`yarn create warlock my-backend-app`
+
 ## Documentation
 
-Full documentation is available at [official documentation](https://warlock.js.org).
+Full documentation is available at [official documentation](https://warlock.js.org).

package/bin/warlock.js

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
 
-import "./../esm/cli/start.js";
+import "../esm/cli/start.mjs";

package/esm/_virtual/_rolldown/runtime.mjs

@@ -0,0 +1,7 @@
+import { createRequire } from "node:module";
+
+//#region \0rolldown/runtime.js
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+//#endregion
+export { __require };

package/esm/application/app.d.mts

@@ -0,0 +1,16 @@
+import { Router } from "../router/router.mjs";
+import { DataSource } from "@warlock.js/cascade";
+import { FastifyInstance } from "fastify";
+import { Server } from "socket.io";
+
+//#region ../../@warlock.js/core/src/application/app.d.ts
+type RuntimeApplication = {
+  socket: Server;
+  http: FastifyInstance;
+  router: Router;
+  database: DataSource;
+};
+declare const app: RuntimeApplication;
+//#endregion
+export { app };
+//# sourceMappingURL=app.d.mts.map

package/esm/application/app.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/application/app.ts"],"mappings":";;;;;;KAMK,kBAAA;EACH,MAAA,EAAQ,MAAA;EACR,IAAA,EAAM,eAAA;EACN,MAAA,EAAQ,MAAA;EACR,QAAA,EAAU,UAAA;AAAA;AAAA,cAGC,GAAA,EAAK,kBA4BjB"}

package/esm/application/app.mjs

@@ -0,0 +1,36 @@
+import { container } from "../container/index.mjs";
+
+//#region ../../@warlock.js/core/src/application/app.ts
+const app = {
+	/**
+	* Socket Io Instance
+	* Available only if socket.io config file exists
+	*/
+	get socket() {
+		return container.get("socket");
+	},
+	/**
+	* HTTP Server Instance
+	* Available only if http config file exists
+	*/
+	get http() {
+		return container.get("http.server");
+	},
+	/**
+	* Router Instance
+	*/
+	get router() {
+		return container.get("router");
+	},
+	/**
+	* Database Instance
+	* Available only if database config file exists
+	*/
+	get database() {
+		return container.get("database.source");
+	}
+};
+
+//#endregion
+export { app };
+//# sourceMappingURL=app.mjs.map

package/esm/application/app.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/application/app.ts"],"sourcesContent":["import { type DataSource } from \"@warlock.js/cascade\";\nimport { type FastifyInstance } from \"fastify\";\nimport { type Server } from \"socket.io\";\nimport { type Router } from \"../router\";\nimport { container } from \"./../container\";\n\ntype RuntimeApplication = {\n  socket: Server;\n  http: FastifyInstance;\n  router: Router;\n  database: DataSource;\n};\n\nexport const app: RuntimeApplication = {\n  /**\n   * Socket Io Instance\n   * Available only if socket.io config file exists\n   */\n  get socket() {\n    return container.get(\"socket\");\n  },\n  /**\n   * HTTP Server Instance\n   * Available only if http config file exists\n   */\n  get http() {\n    return container.get(\"http.server\");\n  },\n  /**\n   * Router Instance\n   */\n  get router() {\n    return container.get(\"router\");\n  },\n  /**\n   * Database Instance\n   * Available only if database config file exists\n   */\n  get database() {\n    return container.get(\"database.source\");\n  },\n};\n"],"mappings":";;;AAaA,MAAa,MAA0B;;;;;CAKrC,IAAI,SAAS;EACX,OAAO,UAAU,IAAI,QAAQ;CAC/B;;;;;CAKA,IAAI,OAAO;EACT,OAAO,UAAU,IAAI,aAAa;CACpC;;;;CAIA,IAAI,SAAS;EACX,OAAO,UAAU,IAAI,QAAQ;CAC/B;;;;;CAKA,IAAI,WAAW;EACb,OAAO,UAAU,IAAI,iBAAiB;CACxC;AACF"}

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

@@ -0,0 +1,30 @@
+//#region ../../@warlock.js/core/src/application/application-config-types.d.ts
+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[];
+};
+//#endregion
+export { AppConfigurations };
+//# sourceMappingURL=application-config-types.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"application-config-types.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/application/application-config-types.ts"],"mappings":";KAAY,iBAAA;EAAA;;;EAIV,OAAA;EAAA;;;;;EAMA,UAAA;EAcW;;;;;EARX,OAAA;;;;EAIA,QAAA;;;;EAIA,WAAA;AAAA"}

package/esm/application/application.d.mts

@@ -0,0 +1,72 @@
+import { Environment } from "../utils/environment.mjs";
+
+//#region ../../@warlock.js/core/src/application/application.d.ts
+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 | null;
+  /**
+   * 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;
+}
+//#endregion
+export { Application };
+//# sourceMappingURL=application.d.mts.map

package/esm/application/application.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/application/application.ts"],"mappings":";;;cAIa,WAAA;;AAAb;;kBAIyB,SAAA,EAAS,IAAA;EAAA;;;EAAA,OAKlB,eAAA;EAiC+B;;;EAAA,WA5B3B,OAAA,CAAA;EAAA;;;EAAA,OAOJ,kBAAA,CAAmB,QAAA;EAcf;;;EAAA,WAPA,MAAA,CAAA;EAcW;;;EAAA,WAPX,WAAA,CAAA,GAAe,WAAA;EAmCf;;;EAAA,OA5BJ,cAAA,CAAe,GAAA,EAAK,WAAA;EAwDhB;;;EAAA,WAjDA,YAAA,CAAA;;;;aAOA,aAAA,CAAA;;;;aAOA,MAAA,CAAA;;;;aAOA,QAAA,CAAA;;;;aAOA,OAAA,CAAA;;;;aAOA,OAAA,CAAA;;;;aAOA,WAAA,CAAA;;;;aAOA,WAAA,CAAA;;;;aAOA,UAAA,CAAA;AAAA"}

package/esm/application/application.mjs

@@ -0,0 +1,98 @@
+import { environment, setEnvironment } from "../utils/environment.mjs";
+import { appPath, publicPath, rootPath, srcPath, storagePath, uploadsPath } from "../utils/paths.mjs";
+import { getFrameworkVersion } from "../utils/framework-vesion.mjs";
+
+//#region ../../@warlock.js/core/src/application/application.ts
+var Application = class {
+	static {
+		this.startedAt = /* @__PURE__ */ new Date(Date.now() - process.uptime() * 1e3);
+	}
+	/**
+	* 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() * 1e3;
+	}
+	/**
+	* 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();
+	}
+};
+
+//#endregion
+export { Application };
+//# sourceMappingURL=application.mjs.map

package/esm/application/application.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"application.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/application/application.ts"],"sourcesContent":["import { environment, setEnvironment, type Environment } from \"../utils/environment\";\nimport { getFrameworkVersion } from \"../utils/framework-vesion\";\nimport { appPath, publicPath, rootPath, srcPath, storagePath, uploadsPath } from \"../utils/paths\";\n\nexport class Application {\n  /**\n   * Project start time regarding the process start time\n   */\n  public static readonly startedAt = new Date(Date.now() - process.uptime() * 1000);\n\n  /**\n   * Runtime strategy\n   */\n  public static runtimeStrategy: \"production\" | \"development\";\n\n  /**\n   * Get framework version\n   */\n  public static get version() {\n    return getFrameworkVersion();\n  }\n\n  /**\n   * Set the runtime strategy\n   */\n  public static setRuntimeStrategy(strategy: \"production\" | \"development\") {\n    this.runtimeStrategy = strategy;\n  }\n\n  /**\n   * Get project uptime in milliseconds\n   */\n  public static get uptime(): number {\n    return process.uptime() * 1000;\n  }\n\n  /**\n   * Get the current environment\n   */\n  public static get environment(): Environment {\n    return environment();\n  }\n\n  /**\n   * Set the current environment\n   */\n  public static setEnvironment(env: Environment) {\n    setEnvironment(env);\n  }\n\n  /**\n   * Check if the application is running in production environment\n   */\n  public static get isProduction(): boolean {\n    return this.environment === \"production\";\n  }\n\n  /**\n   * Check if the application is running in development environment\n   */\n  public static get isDevelopment(): boolean {\n    return this.environment === \"development\";\n  }\n\n  /**\n   * Check if the application is running in test environment\n   */\n  public static get isTest(): boolean {\n    return this.environment === \"test\";\n  }\n\n  /**\n   * Get the root path\n   */\n  public static get rootPath(): string {\n    return rootPath();\n  }\n\n  /**\n   * Get the src path\n   */\n  public static get srcPath(): string {\n    return srcPath();\n  }\n\n  /**\n   * Get the app path\n   */\n  public static get appPath(): string {\n    return appPath();\n  }\n\n  /**\n   * Get the storage path\n   */\n  public static get storagePath(): string {\n    return storagePath();\n  }\n\n  /**\n   * Get the uploads path\n   */\n  public static get uploadsPath(): string {\n    return uploadsPath();\n  }\n\n  /**\n   * Get the public path\n   */\n  public static get publicPath(): string {\n    return publicPath();\n  }\n}\n"],"mappings":";;;;;AAIA,IAAa,cAAb,MAAyB;;mCAIY,IAAI,KAAK,KAAK,IAAI,IAAI,QAAQ,OAAO,IAAI,GAAI;;;;;CAUhF,WAAkB,UAAU;EAC1B,OAAO,oBAAoB;CAC7B;;;;CAKA,OAAc,mBAAmB,UAAwC;EACvE,KAAK,kBAAkB;CACzB;;;;CAKA,WAAkB,SAAiB;EACjC,OAAO,QAAQ,OAAO,IAAI;CAC5B;;;;CAKA,WAAkB,cAA2B;EAC3C,OAAO,YAAY;CACrB;;;;CAKA,OAAc,eAAe,KAAkB;EAC7C,eAAe,GAAG;CACpB;;;;CAKA,WAAkB,eAAwB;EACxC,OAAO,KAAK,gBAAgB;CAC9B;;;;CAKA,WAAkB,gBAAyB;EACzC,OAAO,KAAK,gBAAgB;CAC9B;;;;CAKA,WAAkB,SAAkB;EAClC,OAAO,KAAK,gBAAgB;CAC9B;;;;CAKA,WAAkB,WAAmB;EACnC,OAAO,SAAS;CAClB;;;;CAKA,WAAkB,UAAkB;EAClC,OAAO,QAAQ;CACjB;;;;CAKA,WAAkB,UAAkB;EAClC,OAAO,QAAQ;CACjB;;;;CAKA,WAAkB,cAAsB;EACtC,OAAO,YAAY;CACrB;;;;CAKA,WAAkB,cAAsB;EACtC,OAAO,YAAY;CACrB;;;;CAKA,WAAkB,aAAqB;EACrC,OAAO,WAAW;CACpB;AACF"}

package/esm/application/index.d.mts

@@ -0,0 +1,3 @@
+import { app } from "./app.mjs";
+import { Application } from "./application.mjs";
+import { AppConfigurations } from "./application-config-types.mjs";

package/esm/application/index.mjs

@@ -0,0 +1,4 @@
+import { app } from "./app.mjs";
+import { Application } from "./application.mjs";
+
+export {  };

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

@@ -0,0 +1,51 @@
+import { BenchmarkErrorResult, BenchmarkSnapshotsOptions, BenchmarkSuccessResult } from "./types.mjs";
+
+//#region ../../@warlock.js/core/src/benchmark/benchmark-snapshots.d.ts
+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;
+}
+//#endregion
+export { BenchmarkSnapshots };
+//# sourceMappingURL=benchmark-snapshots.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"benchmark-snapshots.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/benchmark/benchmark-snapshots.ts"],"mappings":";;;cAMa,kBAAA;EAAA,iBACM,YAAA;EAAA,iBACA,OAAA;EAAA,iBACA,SAAA;cAKE,OAAA,GAAU,yBAAA;EAAA;;;;;;;;;EActB,MAAA,CAAO,MAAA,EAAQ,sBAAA,YAAkC,oBAAA;EArBvC;;;;;;;;;EAgDV,YAAA,CAAa,IAAA,YAAgB,sBAAA,YAAkC,oBAAA;EAA/D;;;;;;;;EAYA,YAAA,CAAA,GAAgB,MAAA,UAEpB,sBAAA,YAAkC,oBAAA;EAoBxB;;AAAa;;;;;;;EAAnB,KAAA,CAAM,IAAA;AAAA"}

package/esm/benchmark/benchmark-snapshots.mjs

@@ -0,0 +1,70 @@
+//#region ../../@warlock.js/core/src/benchmark/benchmark-snapshots.ts
+var BenchmarkSnapshots = class {
+	constructor(options) {
+		this.snapshots = /* @__PURE__ */ new Map();
+		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();
+		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();
+	}
+};
+
+//#endregion
+export { BenchmarkSnapshots };
+//# sourceMappingURL=benchmark-snapshots.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"benchmark-snapshots.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/benchmark/benchmark-snapshots.ts"],"sourcesContent":["import type {\n  BenchmarkErrorResult,\n  BenchmarkSnapshotsOptions,\n  BenchmarkSuccessResult,\n} from \"./types\";\n\nexport class BenchmarkSnapshots {\n  private readonly maxSnapshots: number;\n  private readonly capture: \"error\" | \"value\" | \"all\";\n  private readonly snapshots = new Map<\n    string,\n    (BenchmarkSuccessResult<unknown> | BenchmarkErrorResult)[]\n  >();\n\n  public constructor(options?: BenchmarkSnapshotsOptions) {\n    this.maxSnapshots = options?.maxSnapshots ?? 100;\n    this.capture = options?.capture ?? \"error\";\n  }\n\n  /**\n   * Record a raw result. Called automatically by measure() when a snapshotContainer is set.\n   * Respects the `capture` setting — ignores results that don't match.\n   *\n   * @param result - The success or error result to record.\n   *\n   * @example\n   * snapshots.record(result);\n   */\n  public record(result: BenchmarkSuccessResult<unknown> | BenchmarkErrorResult): void {\n    if (this.capture === \"error\" && result.success) return;\n    if (this.capture === \"value\" && !result.success) return;\n\n    let list = this.snapshots.get(result.name);\n\n    if (!list) {\n      list = [];\n      this.snapshots.set(result.name, list);\n    }\n\n    if (list.length >= this.maxSnapshots && this.maxSnapshots > 0) {\n      list.shift(); // Evict oldest\n    }\n\n    list.push(result);\n  }\n\n  /**\n   * Get all snapshots for one operation name.\n   *\n   * @param name - The operation name.\n   * @returns Array of snapshots for the operation.\n   *\n   * @example\n   * snapshots.getSnapshots(\"db-query\");\n   */\n  public getSnapshots(name: string): (BenchmarkSuccessResult<unknown> | BenchmarkErrorResult)[] {\n    return this.snapshots.get(name) ?? [];\n  }\n\n  /**\n   * Get all snapshots for all tracked operations.\n   *\n   * @returns A mapping of operation names to their snapshots array.\n   *\n   * @example\n   * snapshots.allSnapshots();\n   */\n  public allSnapshots(): Record<\n    string,\n    (BenchmarkSuccessResult<unknown> | BenchmarkErrorResult)[]\n  > {\n    const all: Record<string, (BenchmarkSuccessResult<unknown> | BenchmarkErrorResult)[]> = {};\n\n    for (const [name, list] of this.snapshots.entries()) {\n      all[name] = [...list];\n    }\n\n    return all;\n  }\n\n  /**\n   * Clear snapshots for one or all operations.\n   *\n   * @param name - Optional operation name. If omitted, clears all snapshots.\n   *\n   * @example\n   * snapshots.reset(\"db-query\");\n   * snapshots.reset();\n   */\n  public reset(name?: string): void {\n    if (name) {\n      this.snapshots.delete(name);\n    } else {\n      this.snapshots.clear();\n    }\n  }\n}\n"],"mappings":";AAMA,IAAa,qBAAb,MAAgC;CAQ9B,AAAO,YAAY,SAAqC;mCAL3B,IAAI,IAG/B;EAGA,KAAK,eAAe,SAAS,gBAAgB;EAC7C,KAAK,UAAU,SAAS,WAAW;CACrC;;;;;;;;;;CAWA,AAAO,OAAO,QAAsE;EAClF,IAAI,KAAK,YAAY,WAAW,OAAO,SAAS;EAChD,IAAI,KAAK,YAAY,WAAW,CAAC,OAAO,SAAS;EAEjD,IAAI,OAAO,KAAK,UAAU,IAAI,OAAO,IAAI;EAEzC,IAAI,CAAC,MAAM;GACT,OAAO,CAAC;GACR,KAAK,UAAU,IAAI,OAAO,MAAM,IAAI;EACtC;EAEA,IAAI,KAAK,UAAU,KAAK,gBAAgB,KAAK,eAAe,GAC1D,KAAK,MAAM;EAGb,KAAK,KAAK,MAAM;CAClB;;;;;;;;;;CAWA,AAAO,aAAa,MAA0E;EAC5F,OAAO,KAAK,UAAU,IAAI,IAAI,KAAK,CAAC;CACtC;;;;;;;;;CAUA,AAAO,eAGL;EACA,MAAM,MAAkF,CAAC;EAEzF,KAAK,MAAM,CAAC,MAAM,SAAS,KAAK,UAAU,QAAQ,GAChD,IAAI,QAAQ,CAAC,GAAG,IAAI;EAGtB,OAAO;CACT;;;;;;;;;;CAWA,AAAO,MAAM,MAAqB;EAChC,IAAI,MACF,KAAK,UAAU,OAAO,IAAI;OAE1B,KAAK,UAAU,MAAM;CAEzB;AACF"}

package/esm/benchmark/benchmark.d.mts

@@ -0,0 +1,29 @@
+import { BenchmarkErrorResult, BenchmarkOptions, BenchmarkSuccessResult } from "./types.mjs";
+
+//#region ../../@warlock.js/core/src/benchmark/benchmark.d.ts
+/**
+ * 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 (result.success) {
+ *   console.log(result.value);
+ * } else {
+ *   console.error(result.error);
+ * }
+ * ```
+ */
+declare function measure<T>(name: string, fn: () => T | Promise<T>, options?: BenchmarkOptions<T>): Promise<BenchmarkSuccessResult<T> | BenchmarkErrorResult>;
+//#endregion
+export { measure };
+//# sourceMappingURL=benchmark.d.mts.map

package/esm/benchmark/benchmark.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"benchmark.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/benchmark/benchmark.ts"],"mappings":";;;;;AA+CA;;;;;;;;;;;;;;;;;;;;iBAAsB,OAAA,GAAA,CACpB,IAAA,UACA,EAAA,QAAU,CAAA,GAAI,OAAA,CAAQ,CAAA,GACtB,OAAA,GAAU,gBAAA,CAAiB,CAAA,IAC1B,OAAA,CAAQ,sBAAA,CAAuB,CAAA,IAAK,oBAAA"}

package/esm/benchmark/benchmark.mjs

@@ -0,0 +1,101 @@
+import { config } from "../config/config-getter.mjs";
+import "../config/index.mjs";
+
+//#region ../../@warlock.js/core/src/benchmark/benchmark.ts
+/**
+* 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 (result.success) {
+*   console.log(result.value);
+* } else {
+*   console.error(result.error);
+* }
+* ```
+*/
+async function measure(name, fn, options) {
+	if (options?.enabled === false) return {
+		name,
+		success: true,
+		value: await fn(),
+		latency: 0,
+		state: "excellent",
+		tags: options.tags,
+		startedAt: /* @__PURE__ */ new Date(),
+		endedAt: /* @__PURE__ */ new Date()
+	};
+	const benchmarkConfig = config.get("benchmark");
+	const latencyRange = options?.latencyRange ?? benchmarkConfig?.latencyRange;
+	const startedAt = /* @__PURE__ */ 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 result = {
+			name,
+			success: true,
+			value,
+			latency,
+			state: latencyRange ? latencyState(latency, latencyRange) : "good",
+			tags: options?.tags,
+			startedAt,
+			endedAt: /* @__PURE__ */ new Date()
+		};
+		if (profiler) profiler.record(result);
+		if (snapshotContainer) snapshotContainer.record(result);
+		options?.onComplete?.(result);
+		options?.onFinish?.(result);
+		return result;
+	} catch (thrown) {
+		if (!(options?.shouldBenchmarkError ? options.shouldBenchmarkError(thrown) : true)) throw thrown;
+		const endTime = performance.now();
+		const latency = Math.round(endTime - startTime);
+		const state = latencyRange ? latencyState(latency, latencyRange) : "poor";
+		const result = {
+			name,
+			success: false,
+			error: thrown instanceof Error ? thrown : new Error(String(thrown)),
+			latency,
+			state,
+			tags: options?.tags,
+			startedAt,
+			endedAt: /* @__PURE__ */ new Date()
+		};
+		if (profiler) profiler.record(result);
+		if (snapshotContainer) snapshotContainer.record(result);
+		options?.onError?.(result);
+		options?.onFinish?.(result);
+		return result;
+	}
+}
+
+//#endregion
+export { measure };
+//# sourceMappingURL=benchmark.mjs.map

package/esm/benchmark/benchmark.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"benchmark.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/benchmark/benchmark.ts"],"sourcesContent":["import { config } from \"../config\";\nimport type {\n  BenchmarkConfigurations,\n  BenchmarkErrorResult,\n  BenchmarkOptions,\n  BenchmarkSuccessResult,\n} from \"./types\";\n\n/**\n * Classifies latency into \"excellent\", \"good\", or \"poor\" based on thresholds.\n *\n * @example\n * latencyState(80, { excellent: 100, poor: 500 })  // \"excellent\"\n * latencyState(300, { excellent: 100, poor: 500 }) // \"good\"\n * latencyState(600, { excellent: 100, poor: 500 }) // \"poor\"\n */\nfunction latencyState(\n  latency: number,\n  range: { excellent: number; poor: number },\n): \"excellent\" | \"good\" | \"poor\" {\n  if (latency <= range.excellent) return \"excellent\";\n  if (latency >= range.poor) return \"poor\";\n  return \"good\";\n}\n\n/**\n * Measure the execution time of a function and classify its performance.\n *\n * When `enabled` is false, fn() is still called but no timing runs and no hooks fire.\n * A zeroed SuccessResult is returned to keep the return type stable for all callers.\n *\n * @example\n * ```ts\n * const result = await measure(\"db-query\", () => db.query(\"SELECT 1\"), {\n *   latencyRange: { excellent: 100, poor: 500 },\n *   onComplete: (r) => metrics.record(r.latency),\n *   onError:    (r) => logger.error(\"query failed\", r.error),\n *   onFinish:   (r) => logger.info(`${r.name} took ${r.latency}ms`),\n * });\n *\n * if (result.success) {\n *   console.log(result.value);\n * } else {\n *   console.error(result.error);\n * }\n * ```\n */\nexport async function measure<T>(\n  name: string,\n  fn: () => T | Promise<T>,\n  options?: BenchmarkOptions<T>,\n): Promise<BenchmarkSuccessResult<T> | BenchmarkErrorResult> {\n  // Fast path: disabled — call fn() and return a zeroed success wrapper.\n  // No timing, no hooks. Re-throws if fn() throws.\n  if (options?.enabled === false) {\n    const value = await fn();\n    return {\n      name,\n      success: true,\n      value,\n      latency: 0,\n      state: \"excellent\",\n      tags: options.tags,\n      startedAt: new Date(),\n      endedAt: new Date(),\n    };\n  }\n\n  // Resolve latency range from inline options or global config\n  const benchmarkConfig = config.get<BenchmarkConfigurations>(\"benchmark\");\n  const latencyRange = options?.latencyRange ?? benchmarkConfig?.latencyRange;\n\n  const startedAt = new Date();\n  const startTime = performance.now();\n  const profiler = options?.profiler ?? benchmarkConfig?.profiler;\n  const snapshotContainer = options?.snapshotContainer ?? benchmarkConfig?.snapshotContainer;\n\n  try {\n    const value = await fn();\n\n    const endTime = performance.now();\n    const latency = Math.round(endTime - startTime);\n    const state = latencyRange ? latencyState(latency, latencyRange) : \"good\";\n\n    const result: BenchmarkSuccessResult<T> = {\n      name,\n      success: true,\n      value,\n      latency,\n      state,\n      tags: options?.tags,\n      startedAt,\n      endedAt: new Date(),\n    };\n\n    if (profiler) {\n      profiler.record(result);\n    }\n\n    if (snapshotContainer) {\n      snapshotContainer.record(result);\n    }\n\n    options?.onComplete?.(result);\n    options?.onFinish?.(result);\n\n    return result;\n  } catch (thrown) {\n    // Decide whether to benchmark this error or just re-throw immediately\n    const shouldBenchmark = options?.shouldBenchmarkError\n      ? options.shouldBenchmarkError(thrown)\n      : true;\n\n    if (!shouldBenchmark) {\n      throw thrown;\n    }\n\n    // Capture timing even on failure — a 30s timeout is very different from a 2ms crash\n    const endTime = performance.now();\n    const latency = Math.round(endTime - startTime);\n    const state = latencyRange ? latencyState(latency, latencyRange) : \"poor\";\n\n    // Normalize thrown value to something consistent\n    const error = thrown instanceof Error ? thrown : new Error(String(thrown));\n\n    const result: BenchmarkErrorResult = {\n      name,\n      success: false,\n      error,\n      latency,\n      state,\n      tags: options?.tags,\n      startedAt,\n      endedAt: new Date(),\n    };\n\n    if (profiler) {\n      profiler.record(result);\n    }\n\n    if (snapshotContainer) {\n      snapshotContainer.record(result);\n    }\n\n    options?.onError?.(result);\n    options?.onFinish?.(result);\n\n    return result;\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAgBA,SAAS,aACP,SACA,OAC+B;CAC/B,IAAI,WAAW,MAAM,WAAW,OAAO;CACvC,IAAI,WAAW,MAAM,MAAM,OAAO;CAClC,OAAO;AACT;;;;;;;;;;;;;;;;;;;;;;;AAwBA,eAAsB,QACpB,MACA,IACA,SAC2D;CAG3D,IAAI,SAAS,YAAY,OAEvB,OAAO;EACL;EACA,SAAS;EACT,aAJkB,GAAG;EAKrB,SAAS;EACT,OAAO;EACP,MAAM,QAAQ;EACd,2BAAW,IAAI,KAAK;EACpB,yBAAS,IAAI,KAAK;CACpB;CAIF,MAAM,kBAAkB,OAAO,IAA6B,WAAW;CACvE,MAAM,eAAe,SAAS,gBAAgB,iBAAiB;CAE/D,MAAM,4BAAY,IAAI,KAAK;CAC3B,MAAM,YAAY,YAAY,IAAI;CAClC,MAAM,WAAW,SAAS,YAAY,iBAAiB;CACvD,MAAM,oBAAoB,SAAS,qBAAqB,iBAAiB;CAEzE,IAAI;EACF,MAAM,QAAQ,MAAM,GAAG;EAEvB,MAAM,UAAU,YAAY,IAAI;EAChC,MAAM,UAAU,KAAK,MAAM,UAAU,SAAS;EAG9C,MAAM,SAAoC;GACxC;GACA,SAAS;GACT;GACA;GACA,OAPY,eAAe,aAAa,SAAS,YAAY,IAAI;GAQjE,MAAM,SAAS;GACf;GACA,yBAAS,IAAI,KAAK;EACpB;EAEA,IAAI,UACF,SAAS,OAAO,MAAM;EAGxB,IAAI,mBACF,kBAAkB,OAAO,MAAM;EAGjC,SAAS,aAAa,MAAM;EAC5B,SAAS,WAAW,MAAM;EAE1B,OAAO;CACT,SAAS,QAAQ;EAMf,IAAI,EAJoB,SAAS,uBAC7B,QAAQ,qBAAqB,MAAM,IACnC,OAGF,MAAM;EAIR,MAAM,UAAU,YAAY,IAAI;EAChC,MAAM,UAAU,KAAK,MAAM,UAAU,SAAS;EAC9C,MAAM,QAAQ,eAAe,aAAa,SAAS,YAAY,IAAI;EAKnE,MAAM,SAA+B;GACnC;GACA,SAAS;GACT,OALY,kBAAkB,QAAQ,SAAS,IAAI,MAAM,OAAO,MAAM,CAAC;GAMvE;GACA;GACA,MAAM,SAAS;GACf;GACA,yBAAS,IAAI,KAAK;EACpB;EAEA,IAAI,UACF,SAAS,OAAO,MAAM;EAGxB,IAAI,mBACF,kBAAkB,OAAO,MAAM;EAGjC,SAAS,UAAU,MAAM;EACzB,SAAS,WAAW,MAAM;EAE1B,OAAO;CACT;AACF"}

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

@@ -0,0 +1,18 @@
+import { BenchmarkChannel, BenchmarkStats } from "../types.mjs";
+
+//#region ../../@warlock.js/core/src/benchmark/channels/console.channel.d.ts
+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;
+}
+//#endregion
+export { ConsoleChannel };
+//# sourceMappingURL=console.channel.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"console.channel.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/benchmark/channels/console.channel.ts"],"mappings":";;;cAEa,cAAA,YAA0B,gBAAA;;AAAvC;;;;;;;;EAUS,OAAA,CAAQ,KAAA,EAAO,MAAA,SAAe,cAAA;AAAA"}

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

@@ -0,0 +1,32 @@
+//#region ../../@warlock.js/core/src/benchmark/channels/console.channel.ts
+var ConsoleChannel = class {
+	/**
+	* 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);
+	}
+};
+
+//#endregion
+export { ConsoleChannel };
+//# sourceMappingURL=console.channel.mjs.map