@warlock.js/core 4.0.174 → 4.1.2

package/esm/use-cases/use-case.errors.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-case.errors.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/use-cases/use-case.errors.ts"],"mappings":";;;;cAGa,qBAAA,SAA8B,SAAS;cAC/B,MAAA,EAAQ,gBAAA;AAAA"}

package/esm/use-cases/use-case.errors.mjs

@@ -0,0 +1,15 @@
+import { HttpError } from "../http/errors/errors.mjs";
+
+//#region ../../@warlock.js/core/src/use-cases/use-case.errors.ts
+var BadSchemaUseCaseError = class extends HttpError {
+	constructor(result) {
+		super(400, `Invalid input data`, {
+			code: "BAD_SCHEMA_USE_CASE",
+			errors: result.errors
+		});
+	}
+};
+
+//#endregion
+export { BadSchemaUseCaseError };
+//# sourceMappingURL=use-case.errors.mjs.map

package/esm/use-cases/use-case.errors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-case.errors.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/use-cases/use-case.errors.ts"],"sourcesContent":["import type { ValidationResult } from \"@warlock.js/seal\";\nimport { HttpError } from \"../http/errors/errors\";\n\nexport class BadSchemaUseCaseError extends HttpError {\n  public constructor(result: ValidationResult) {\n    super(400, `Invalid input data`, {\n      code: \"BAD_SCHEMA_USE_CASE\",\n      errors: result.errors,\n    });\n  }\n}\n"],"mappings":";;;AAGA,IAAa,wBAAb,cAA2C,UAAU;CACnD,AAAO,YAAY,QAA0B;EAC3C,MAAM,KAAK,sBAAsB;GAC/B,MAAM;GACN,QAAQ,OAAO;EACjB,CAAC;CACH;AACF"}

package/esm/use-cases/use-case.mjs

@@ -0,0 +1,138 @@
+import { config } from "../config/config-getter.mjs";
+import "../config/index.mjs";
+import { measure } from "../benchmark/benchmark.mjs";
+import "../benchmark/index.mjs";
+import { broadcastUseCaseResult } from "./use-case-broadcast.mjs";
+import { fireLifecycleEvent, globalEventsCallbacksMap } from "./use-case-events.mjs";
+import { runPipeline } from "./use-case-pipeline.mjs";
+import { $registerUseCase, $unregisterUseCase, addUseCaseHistory, increaseUseCaseFailedCalls, increaseUseCaseSuccessCalls } from "./use-cases-registry.mjs";
+import { log } from "@warlock.js/logger";
+import { Random, except, retry } from "@mongez/reinforcements";
+
+//#region ../../@warlock.js/core/src/use-cases/use-case.ts
+const defaultUseCaseOptions = { benchmark: true };
+function useCase(options) {
+	const { name, handler, schema, guards, before, after, onExecuting, onCompleted, onError } = options;
+	const useCaseConfig = config.get("use-cases", defaultUseCaseOptions);
+	const benchmark = options.benchmark ?? useCaseConfig?.benchmark ?? true;
+	const retryConfig = options.retry ?? useCaseConfig?.retry;
+	const broadcast = options.broadcast;
+	const broadcastConfig = useCaseConfig?.broadcast;
+	const logEnabled = useCaseConfig?.log === true;
+	$registerUseCase(name, {
+		...options,
+		calls: {
+			success: 0,
+			failed: 0,
+			total: 0
+		}
+	});
+	const useCaseHandler = async (data, { ctx = {}, id = `uc-${name}-` + Random.string(), onExecuting: invocationOnExecuting, onCompleted: invocationOnCompleted, onError: invocationOnError } = {}) => {
+		ctx.schema = schema;
+		ctx.id = id;
+		const startedAt = /* @__PURE__ */ new Date();
+		let output;
+		let error;
+		let benchmarkResult;
+		let currentRetry = 0;
+		if (logEnabled) log.debug("use-cases", name, "executing", { id });
+		try {
+			const transformed = await runPipeline({
+				name,
+				id,
+				data,
+				ctx,
+				startedAt,
+				schema,
+				guards,
+				before,
+				onExecuting: invocationOnExecuting,
+				ucOnExecuting: onExecuting
+			});
+			const runHandler = async () => {
+				if (!benchmark) return handler(transformed, ctx);
+				const measured = await measure(name, () => handler(transformed, ctx), benchmark === true ? void 0 : benchmark);
+				benchmarkResult = {
+					latency: measured.latency,
+					state: measured.state
+				};
+				if (!measured.success) throw measured.error;
+				return measured.value;
+			};
+			output = retryConfig ? await retry(runHandler, {
+				...retryConfig,
+				onError: (retryError, attempt) => {
+					currentRetry = attempt;
+					retryConfig.onError?.(retryError, attempt);
+				}
+			}) : await runHandler();
+		} catch (err) {
+			error = err;
+		}
+		const endedAt = /* @__PURE__ */ new Date();
+		if (!error && after && output !== void 0) for (const middleware of after) try {
+			await middleware(output, ctx);
+		} catch (afterError) {
+			log.error("use-cases", name, "after middleware failed", { error: afterError });
+		}
+		const snapshot = {
+			output,
+			ctx,
+			startedAt,
+			endedAt,
+			id,
+			name,
+			retries: retryConfig ? {
+				attempts: retryConfig.attempts ?? 3,
+				delay: retryConfig.delay,
+				currentRetry
+			} : void 0,
+			benchmarkResult,
+			calls: 0
+		};
+		if (error) {
+			snapshot.calls = increaseUseCaseFailedCalls(name);
+			if (logEnabled) log.error("use-cases", name, "failed", {
+				id,
+				error
+			});
+			await fireLifecycleEvent({
+				...except(snapshot, ["output"]),
+				error
+			}, {
+				invocation: invocationOnError ? [invocationOnError] : void 0,
+				useCase: onError ? [onError] : void 0,
+				global: globalEventsCallbacksMap.onError.length ? globalEventsCallbacksMap.onError : void 0
+			});
+			throw error;
+		}
+		snapshot.calls = increaseUseCaseSuccessCalls(name);
+		if (logEnabled) log.debug("use-cases", name, "completed", {
+			id,
+			latency: benchmarkResult?.latency
+		});
+		await addUseCaseHistory(name, snapshot);
+		await fireLifecycleEvent(snapshot, {
+			invocation: invocationOnCompleted ? [invocationOnCompleted] : void 0,
+			useCase: onCompleted ? [onCompleted] : void 0,
+			global: globalEventsCallbacksMap.onCompleted.length ? globalEventsCallbacksMap.onCompleted : void 0
+		});
+		await broadcastUseCaseResult({
+			name,
+			id,
+			output,
+			result: snapshot,
+			broadcast,
+			config: broadcastConfig
+		});
+		return output;
+	};
+	useCaseHandler.$cleanup = () => {
+		$unregisterUseCase(name);
+	};
+	return useCaseHandler;
+}
+
+//#endregion
+export { useCase };
+//# sourceMappingURL=use-case.mjs.map

package/esm/use-cases/use-case.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-case.mjs","names":["runWithRetry"],"sources":["../../../../../../@warlock.js/core/src/use-cases/use-case.ts"],"sourcesContent":["import { except, Random, retry as runWithRetry } from \"@mongez/reinforcements\";\r\nimport { log } from \"@warlock.js/logger\";\r\nimport type { Infer, ObjectValidator } from \"@warlock.js/seal\";\r\nimport { measure } from \"../benchmark\";\r\nimport { config } from \"../config\";\r\nimport type {\r\n  UseCase,\r\n  UseCaseConfigurations,\r\n  UseCaseContext,\r\n  UseCaseErrorResult,\r\n  UseCaseHandler,\r\n  UseCaseResult,\r\n  UseCaseRuntimeOptions,\r\n  UseCaseWithSchema,\r\n} from \"./types\";\r\nimport { broadcastUseCaseResult } from \"./use-case-broadcast\";\r\nimport { fireLifecycleEvent, globalEventsCallbacksMap } from \"./use-case-events\";\r\nimport { runPipeline } from \"./use-case-pipeline\";\r\nimport {\r\n  $registerUseCase,\r\n  $unregisterUseCase,\r\n  addUseCaseHistory,\r\n  increaseUseCaseFailedCalls,\r\n  increaseUseCaseSuccessCalls,\r\n} from \"./use-cases-registry\";\r\n\r\nconst defaultUseCaseOptions: UseCaseConfigurations = {\r\n  benchmark: true,\r\n};\r\n\r\n/**\r\n * Defines and registers a use case.\r\n *\r\n * A use case is a named, observable, optionally benchmarked unit of business logic.\r\n * The returned handler is a typed async function you call with the input data.\r\n *\r\n * Execution order: onExecuting → guards → validation → before → handler → after →\r\n * onCompleted → broadcast. Retry and benchmark wrap the **handler** only.\r\n *\r\n * When a `schema` is provided, the handler's input is inferred from it — no manual\r\n * `Input` generic needed.\r\n *\r\n * @example\r\n * export const createOrderUseCase = useCase({\r\n *   name: \"create_order\",\r\n *   schema: createOrderSchema,           // handler `data` is inferred from this\r\n *   guards: [authGuard],\r\n *   handler: async (data, ctx) => orderService.create(data),\r\n *   after: [sendConfirmationEmail],\r\n *   retry: { attempts: 3, delay: 500, backoff: \"exponential\" },\r\n *   broadcast: true,\r\n * });\r\n *\r\n * // In a controller:\r\n * const output = await createOrderUseCase({ ...validated, user_id: req.user.id });\r\n */\r\nexport function useCase<\r\n  Output,\r\n  Schema extends ObjectValidator,\r\n  Ctx extends UseCaseContext = UseCaseContext,\r\n>(options: UseCaseWithSchema<Output, Schema, Ctx>): UseCaseHandler<Output, Infer<Schema>>;\r\nexport function useCase<Output = any, Input = any, Ctx extends UseCaseContext = UseCaseContext>(\r\n  options: UseCase<Output, Input, Ctx>,\r\n): UseCaseHandler<Output, Input>;\r\nexport function useCase<Output = any, Input = any>(\r\n  options: UseCase<Output, Input>,\r\n): UseCaseHandler<Output, Input> {\r\n  const { name, handler, schema, guards, before, after, onExecuting, onCompleted, onError } =\r\n    options;\r\n\r\n  // Merge per-use-case options with global config defaults\r\n  const useCaseConfig = config.get<UseCaseConfigurations>(\"use-cases\", defaultUseCaseOptions);\r\n  const benchmark = options.benchmark ?? useCaseConfig?.benchmark ?? true;\r\n  const retryConfig = options.retry ?? useCaseConfig?.retry;\r\n  const broadcast = options.broadcast;\r\n  const broadcastConfig = useCaseConfig?.broadcast;\r\n  const logEnabled = useCaseConfig?.log === true;\r\n\r\n  $registerUseCase(name, {\r\n    ...options,\r\n    calls: { success: 0, failed: 0, total: 0 },\r\n  });\r\n\r\n  const useCaseHandler = async (\r\n    data: Input,\r\n    {\r\n      ctx = {},\r\n      id = `uc-${name}-` + Random.string(),\r\n      onExecuting: invocationOnExecuting,\r\n      onCompleted: invocationOnCompleted,\r\n      onError: invocationOnError,\r\n    }: UseCaseRuntimeOptions = {},\r\n  ): Promise<Output> => {\r\n    ctx.schema = schema;\r\n    ctx.id = id;\r\n\r\n    const startedAt = new Date();\r\n    let output: Output | undefined;\r\n    let error: Error | undefined;\r\n    let benchmarkResult: { latency: number; state: \"excellent\" | \"good\" | \"poor\" } | undefined;\r\n    let currentRetry = 0;\r\n\r\n    if (logEnabled) {\r\n      log.debug(\"use-cases\", name, \"executing\", { id });\r\n    }\r\n\r\n    try {\r\n      const transformed = await runPipeline<Input>({\r\n        name,\r\n        id,\r\n        data,\r\n        ctx,\r\n        startedAt,\r\n        schema,\r\n        guards,\r\n        before,\r\n        onExecuting: invocationOnExecuting,\r\n        ucOnExecuting: onExecuting,\r\n      });\r\n\r\n      // Benchmark wraps ONLY the handler (per attempt) so latency reflects business\r\n      // logic — not the guard/validation prelude, and not the retry backoff delays.\r\n      const runHandler = async (): Promise<Output> => {\r\n        if (!benchmark) {\r\n          return handler(transformed, ctx);\r\n        }\r\n\r\n        const measured = await measure(\r\n          name,\r\n          () => handler(transformed, ctx),\r\n          benchmark === true ? undefined : benchmark,\r\n        );\r\n\r\n        benchmarkResult = { latency: measured.latency, state: measured.state };\r\n\r\n        // measure() never throws — it returns an error result. Re-throw so retry\r\n        // and the outer catch handle failures uniformly.\r\n        if (!measured.success) {\r\n          throw measured.error;\r\n        }\r\n\r\n        return measured.value;\r\n      };\r\n\r\n      output = retryConfig\r\n        ? await runWithRetry(runHandler, {\r\n            ...retryConfig,\r\n            onError: (retryError, attempt) => {\r\n              currentRetry = attempt;\r\n              retryConfig.onError?.(retryError, attempt);\r\n            },\r\n          })\r\n        : await runHandler();\r\n    } catch (err) {\r\n      error = err as Error;\r\n    }\r\n\r\n    const endedAt = new Date();\r\n\r\n    // After middleware — fire-and-forget side effects, only on success\r\n    if (!error && after && output !== undefined) {\r\n      for (const middleware of after) {\r\n        try {\r\n          await middleware(output, ctx);\r\n        } catch (afterError) {\r\n          log.error(\"use-cases\", name, \"after middleware failed\", { error: afterError });\r\n        }\r\n      }\r\n    }\r\n\r\n    const snapshot: UseCaseResult<Output> = {\r\n      output,\r\n      ctx,\r\n      startedAt,\r\n      endedAt,\r\n      id,\r\n      name,\r\n      retries: retryConfig\r\n        ? { attempts: retryConfig.attempts ?? 3, delay: retryConfig.delay, currentRetry }\r\n        : undefined,\r\n      benchmarkResult,\r\n      // Set per-branch below so the counter reflects the actual outcome —\r\n      // a failure must never increment the success tally.\r\n      calls: 0,\r\n    };\r\n\r\n    if (error) {\r\n      snapshot.calls = increaseUseCaseFailedCalls(name);\r\n\r\n      if (logEnabled) {\r\n        log.error(\"use-cases\", name, \"failed\", { id, error });\r\n      }\r\n\r\n      await fireLifecycleEvent<UseCaseErrorResult>(\r\n        { ...except(snapshot, [\"output\"]), error },\r\n        {\r\n          invocation: invocationOnError ? [invocationOnError] : undefined,\r\n          useCase: onError ? [onError] : undefined,\r\n          global: globalEventsCallbacksMap.onError.length\r\n            ? globalEventsCallbacksMap.onError\r\n            : undefined,\r\n        },\r\n      );\r\n\r\n      throw error;\r\n    }\r\n\r\n    snapshot.calls = increaseUseCaseSuccessCalls(name);\r\n\r\n    if (logEnabled) {\r\n      log.debug(\"use-cases\", name, \"completed\", { id, latency: benchmarkResult?.latency });\r\n    }\r\n\r\n    await addUseCaseHistory(name, snapshot);\r\n\r\n    await fireLifecycleEvent<UseCaseResult<Output>>(snapshot, {\r\n      invocation: invocationOnCompleted ? [invocationOnCompleted] : undefined,\r\n      useCase: onCompleted ? [onCompleted] : undefined,\r\n      global: globalEventsCallbacksMap.onCompleted.length\r\n        ? globalEventsCallbacksMap.onCompleted\r\n        : undefined,\r\n    });\r\n\r\n    await broadcastUseCaseResult({\r\n      name,\r\n      id,\r\n      output: output!,\r\n      result: snapshot,\r\n      broadcast,\r\n      config: broadcastConfig,\r\n    });\r\n\r\n    return output!;\r\n  };\r\n\r\n  useCaseHandler.$cleanup = () => {\r\n    $unregisterUseCase(name);\r\n  };\r\n\r\n  return useCaseHandler;\r\n}\r\n"],"mappings":"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"}

package/esm/use-cases/use-cases-registry.d.mts

@@ -0,0 +1,41 @@
+import { RegisteredUseCase, UseCase, UseCaseResult } from "./types.mjs";
+
+//#region ../../@warlock.js/core/src/use-cases/use-cases-registry.d.ts
+/**
+ * Register a use case
+ */
+declare function $registerUseCase<Output, Input>(name: string, useCase: RegisteredUseCase<Output, Input>): void;
+/**
+ * Unregister a use case
+ */
+declare function $unregisterUseCase(name: string): void;
+/**
+ * Get a use case
+ */
+declare function getUseCase<Output, Input>(name: string): UseCase<Output, Input> | undefined;
+/**
+ * Get all use cases
+ */
+declare function getUseCases(): Map<string, RegisteredUseCase>;
+/**
+ * Increase use case success calls
+ */
+declare function increaseUseCaseSuccessCalls(name: string): number;
+/**
+ * Increase use case failed calls
+ */
+declare function increaseUseCaseFailedCalls(name: string): number;
+/**
+ * Get use case history from cache.
+ *
+ * Prunes ids whose entries have expired so the list can't accumulate dead refs.
+ */
+declare function getUseCaseHistory(name: string): Promise<UseCaseResult<any>[]>;
+/**
+ * Add use case history to cache, capping the per-use-case list so it can't grow
+ * unbounded — oldest entries (and their ids) are evicted past MAX_HISTORY_ENTRIES.
+ */
+declare function addUseCaseHistory(name: string, result: UseCaseResult<any>): Promise<void>;
+//#endregion
+export { $registerUseCase, $unregisterUseCase, addUseCaseHistory, getUseCase, getUseCaseHistory, getUseCases, increaseUseCaseFailedCalls, increaseUseCaseSuccessCalls };
+//# sourceMappingURL=use-cases-registry.d.mts.map

package/esm/use-cases/use-cases-registry.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-cases-registry.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/use-cases/use-cases-registry.ts"],"mappings":";;;;;AAaA;iBAAgB,gBAAA,eAAA,CACd,IAAA,UACA,OAAA,EAAS,iBAAA,CAAkB,MAAA,EAAQ,KAAA;;;;iBAgBrB,kBAAA,CAAmB,IAAY;;;;iBAS/B,UAAA,eAAA,CAA0B,IAAA,WACJ,OAAA,CAAQ,MAAA,EAAQ,KAAA;;;;iBAMtC,WAAA,CAAA,GAAW,GAAA,SAAA,iBAAA;;;AAhCgB;iBAuC3B,2BAAA,CAA4B,IAAY;;;;iBAexC,0BAAA,CAA2B,IAAY;AA7BvD;;;;;AAAA,iBAwDsB,iBAAA,CAAkB,IAAA,WAAe,OAAO,CAAC,aAAA;;;;;iBA8BzC,iBAAA,CAAkB,IAAA,UAAc,MAAA,EAAQ,aAAA,QAAkB,OAAA"}

package/esm/use-cases/use-cases-registry.mjs

@@ -0,0 +1,110 @@
+import { config } from "../config/config-getter.mjs";
+import "../config/index.mjs";
+import { log } from "@warlock.js/logger";
+import { cache } from "@warlock.js/cache";
+
+//#region ../../@warlock.js/core/src/use-cases/use-cases-registry.ts
+/**
+* Store registered use cases
+*/
+const useCaseRegister = /* @__PURE__ */ new Map();
+/**
+* Register a use case
+*/
+function $registerUseCase(name, useCase) {
+	if (useCaseRegister.has(name) && process.env.NODE_ENV !== "production") log.warn("use-cases", "registering", `Use case "${name}" is already registered. Overwriting.`);
+	useCaseRegister.set(name, useCase);
+}
+/**
+* Unregister a use case
+*/
+function $unregisterUseCase(name) {
+	useCaseRegister.delete(name);
+	cache.removeNamespace(`use-case:history:${name}`);
+}
+/**
+* Get a use case
+*/
+function getUseCase(name) {
+	return useCaseRegister.get(name);
+}
+/**
+* Get all use cases
+*/
+function getUseCases() {
+	return useCaseRegister;
+}
+/**
+* Increase use case success calls
+*/
+function increaseUseCaseSuccessCalls(name) {
+	const useCase = useCaseRegister.get(name);
+	if (useCase) {
+		useCase.calls.success++;
+		useCase.calls.total++;
+		return useCase.calls.success;
+	}
+	return 0;
+}
+/**
+* Increase use case failed calls
+*/
+function increaseUseCaseFailedCalls(name) {
+	const useCase = useCaseRegister.get(name);
+	if (useCase) {
+		useCase.calls.failed++;
+		useCase.calls.total++;
+		return useCase.calls.failed;
+	}
+	return 0;
+}
+/**
+* Resolve the history cache TTL (seconds) from config.
+* `false` means "use the cache driver's default", represented as `undefined`.
+*/
+function resolveHistoryTtl(useCaseConfig) {
+	const ttlConfig = useCaseConfig?.history?.ttl ?? 3600;
+	return ttlConfig === false ? void 0 : ttlConfig;
+}
+/**
+* Get use case history from cache.
+*
+* Prunes ids whose entries have expired so the list can't accumulate dead refs.
+*/
+async function getUseCaseHistory(name) {
+	const listKey = `use-case:history:${name}:list`;
+	const ids = await cache.get(listKey) || [];
+	const liveEntries = (await Promise.all(ids.map(async (id) => ({
+		id,
+		result: await cache.get(`use-case:history:${name}:${id}`)
+	})))).filter((entry) => Boolean(entry.result));
+	if (liveEntries.length !== ids.length) {
+		const useCaseConfig = config.get("use-cases");
+		await cache.set(listKey, liveEntries.map((entry) => entry.id), resolveHistoryTtl(useCaseConfig));
+	}
+	return liveEntries.map((entry) => entry.result);
+}
+/**
+* Add use case history to cache, capping the per-use-case list so it can't grow
+* unbounded — oldest entries (and their ids) are evicted past MAX_HISTORY_ENTRIES.
+*/
+async function addUseCaseHistory(name, result) {
+	const useCaseConfig = config.get("use-cases");
+	if (useCaseConfig?.history?.enabled === false) return;
+	const ttl = resolveHistoryTtl(useCaseConfig);
+	const maxEntries = useCaseConfig?.history?.maxEntries ?? 100;
+	const key = `use-case:history:${name}:${result.id}`;
+	const listKey = `use-case:history:${name}:list`;
+	await cache.set(key, result, ttl);
+	const list = await cache.get(listKey) || [];
+	list.push(result.id);
+	while (list.length > maxEntries) {
+		const evictedId = list.shift();
+		if (evictedId) await cache.remove(`use-case:history:${name}:${evictedId}`);
+	}
+	await cache.set(listKey, list, ttl);
+}
+
+//#endregion
+export { $registerUseCase, $unregisterUseCase, addUseCaseHistory, getUseCase, getUseCaseHistory, getUseCases, increaseUseCaseFailedCalls, increaseUseCaseSuccessCalls };
+//# sourceMappingURL=use-cases-registry.mjs.map

package/esm/use-cases/use-cases-registry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-cases-registry.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/use-cases/use-cases-registry.ts"],"sourcesContent":["import { cache } from \"@warlock.js/cache\";\r\nimport { log } from \"@warlock.js/logger\";\r\nimport { config } from \"../config\";\r\nimport { RegisteredUseCase, UseCase, UseCaseConfigurations, UseCaseResult } from \"./types\";\r\n\r\n/**\r\n * Store registered use cases\r\n */\r\nconst useCaseRegister = new Map<string, RegisteredUseCase>();\r\n\r\n/**\r\n * Register a use case\r\n */\r\nexport function $registerUseCase<Output, Input>(\r\n  name: string,\r\n  useCase: RegisteredUseCase<Output, Input>,\r\n) {\r\n  if (useCaseRegister.has(name) && process.env.NODE_ENV !== \"production\") {\r\n    log.warn(\r\n      \"use-cases\",\r\n      \"registering\",\r\n      `Use case \"${name}\" is already registered. Overwriting.`,\r\n    );\r\n  }\r\n\r\n  useCaseRegister.set(name, useCase);\r\n}\r\n\r\n/**\r\n * Unregister a use case\r\n */\r\nexport function $unregisterUseCase(name: string) {\r\n  useCaseRegister.delete(name);\r\n\r\n  cache.removeNamespace(`use-case:history:${name}`);\r\n}\r\n\r\n/**\r\n * Get a use case\r\n */\r\nexport function getUseCase<Output, Input>(name: string) {\r\n  return useCaseRegister.get(name) as UseCase<Output, Input> | undefined;\r\n}\r\n\r\n/**\r\n * Get all use cases\r\n */\r\nexport function getUseCases() {\r\n  return useCaseRegister;\r\n}\r\n\r\n/**\r\n * Increase use case success calls\r\n */\r\nexport function increaseUseCaseSuccessCalls(name: string): number {\r\n  const useCase = useCaseRegister.get(name);\r\n  if (useCase) {\r\n    useCase.calls.success++;\r\n    useCase.calls.total++;\r\n\r\n    return useCase.calls.success;\r\n  }\r\n\r\n  return 0;\r\n}\r\n\r\n/**\r\n * Increase use case failed calls\r\n */\r\nexport function increaseUseCaseFailedCalls(name: string): number {\r\n  const useCase = useCaseRegister.get(name);\r\n  if (useCase) {\r\n    useCase.calls.failed++;\r\n    useCase.calls.total++;\r\n\r\n    return useCase.calls.failed;\r\n  }\r\n\r\n  return 0;\r\n}\r\n\r\n/**\r\n * Resolve the history cache TTL (seconds) from config.\r\n * `false` means \"use the cache driver's default\", represented as `undefined`.\r\n */\r\nfunction resolveHistoryTtl(useCaseConfig?: UseCaseConfigurations): number | undefined {\r\n  const ttlConfig = useCaseConfig?.history?.ttl ?? 3600; // 1 hour default\r\n\r\n  return ttlConfig === false ? undefined : ttlConfig;\r\n}\r\n\r\n/**\r\n * Get use case history from cache.\r\n *\r\n * Prunes ids whose entries have expired so the list can't accumulate dead refs.\r\n */\r\nexport async function getUseCaseHistory(name: string): Promise<UseCaseResult<any>[]> {\r\n  const listKey = `use-case:history:${name}:list`;\r\n  const ids = (await cache.get<string[]>(listKey)) || [];\r\n\r\n  const entries = await Promise.all(\r\n    ids.map(async (id: string) => ({\r\n      id,\r\n      result: await cache.get<UseCaseResult<any>>(`use-case:history:${name}:${id}`),\r\n    })),\r\n  );\r\n\r\n  const liveEntries = entries.filter((entry) => Boolean(entry.result));\r\n\r\n  if (liveEntries.length !== ids.length) {\r\n    const useCaseConfig = config.get<UseCaseConfigurations>(\"use-cases\");\r\n\r\n    await cache.set(\r\n      listKey,\r\n      liveEntries.map((entry) => entry.id),\r\n      resolveHistoryTtl(useCaseConfig),\r\n    );\r\n  }\r\n\r\n  return liveEntries.map((entry) => entry.result) as UseCaseResult<any>[];\r\n}\r\n\r\n/**\r\n * Add use case history to cache, capping the per-use-case list so it can't grow\r\n * unbounded — oldest entries (and their ids) are evicted past MAX_HISTORY_ENTRIES.\r\n */\r\nexport async function addUseCaseHistory(name: string, result: UseCaseResult<any>) {\r\n  const useCaseConfig = config.get<UseCaseConfigurations>(\"use-cases\");\r\n\r\n  if (useCaseConfig?.history?.enabled === false) return;\r\n\r\n  const ttl = resolveHistoryTtl(useCaseConfig);\r\n  const maxEntries = useCaseConfig?.history?.maxEntries ?? 100;\r\n  const key = `use-case:history:${name}:${result.id}`;\r\n  const listKey = `use-case:history:${name}:list`;\r\n\r\n  await cache.set(key, result, ttl);\r\n\r\n  const list = (await cache.get<string[]>(listKey)) || [];\r\n\r\n  list.push(result.id);\r\n\r\n  while (list.length > maxEntries) {\r\n    const evictedId = list.shift();\r\n\r\n    if (evictedId) {\r\n      await cache.remove(`use-case:history:${name}:${evictedId}`);\r\n    }\r\n  }\r\n\r\n  await cache.set(listKey, list, ttl);\r\n}\r\n"],"mappings":";;;;;;;;;AAQA,MAAM,kCAAkB,IAAI,IAA+B;;;;AAK3D,SAAgB,iBACd,MACA,SACA;CACA,IAAI,gBAAgB,IAAI,IAAI,KAAK,QAAQ,IAAI,aAAa,cACxD,IAAI,KACF,aACA,eACA,aAAa,KAAK,sCACpB;CAGF,gBAAgB,IAAI,MAAM,OAAO;AACnC;;;;AAKA,SAAgB,mBAAmB,MAAc;CAC/C,gBAAgB,OAAO,IAAI;CAE3B,MAAM,gBAAgB,oBAAoB,MAAM;AAClD;;;;AAKA,SAAgB,WAA0B,MAAc;CACtD,OAAO,gBAAgB,IAAI,IAAI;AACjC;;;;AAKA,SAAgB,cAAc;CAC5B,OAAO;AACT;;;;AAKA,SAAgB,4BAA4B,MAAsB;CAChE,MAAM,UAAU,gBAAgB,IAAI,IAAI;CACxC,IAAI,SAAS;EACX,QAAQ,MAAM;EACd,QAAQ,MAAM;EAEd,OAAO,QAAQ,MAAM;CACvB;CAEA,OAAO;AACT;;;;AAKA,SAAgB,2BAA2B,MAAsB;CAC/D,MAAM,UAAU,gBAAgB,IAAI,IAAI;CACxC,IAAI,SAAS;EACX,QAAQ,MAAM;EACd,QAAQ,MAAM;EAEd,OAAO,QAAQ,MAAM;CACvB;CAEA,OAAO;AACT;;;;;AAMA,SAAS,kBAAkB,eAA2D;CACpF,MAAM,YAAY,eAAe,SAAS,OAAO;CAEjD,OAAO,cAAc,QAAQ,SAAY;AAC3C;;;;;;AAOA,eAAsB,kBAAkB,MAA6C;CACnF,MAAM,UAAU,oBAAoB,KAAK;CACzC,MAAM,MAAO,MAAM,MAAM,IAAc,OAAO,KAAM,CAAC;CASrD,MAAM,eAAc,MAPE,QAAQ,IAC5B,IAAI,IAAI,OAAO,QAAgB;EAC7B;EACA,QAAQ,MAAM,MAAM,IAAwB,oBAAoB,KAAK,GAAG,IAAI;CAC9E,EAAE,CACJ,GAE4B,QAAQ,UAAU,QAAQ,MAAM,MAAM,CAAC;CAEnE,IAAI,YAAY,WAAW,IAAI,QAAQ;EACrC,MAAM,gBAAgB,OAAO,IAA2B,WAAW;EAEnE,MAAM,MAAM,IACV,SACA,YAAY,KAAK,UAAU,MAAM,EAAE,GACnC,kBAAkB,aAAa,CACjC;CACF;CAEA,OAAO,YAAY,KAAK,UAAU,MAAM,MAAM;AAChD;;;;;AAMA,eAAsB,kBAAkB,MAAc,QAA4B;CAChF,MAAM,gBAAgB,OAAO,IAA2B,WAAW;CAEnE,IAAI,eAAe,SAAS,YAAY,OAAO;CAE/C,MAAM,MAAM,kBAAkB,aAAa;CAC3C,MAAM,aAAa,eAAe,SAAS,cAAc;CACzD,MAAM,MAAM,oBAAoB,KAAK,GAAG,OAAO;CAC/C,MAAM,UAAU,oBAAoB,KAAK;CAEzC,MAAM,MAAM,IAAI,KAAK,QAAQ,GAAG;CAEhC,MAAM,OAAQ,MAAM,MAAM,IAAc,OAAO,KAAM,CAAC;CAEtD,KAAK,KAAK,OAAO,EAAE;CAEnB,OAAO,KAAK,SAAS,YAAY;EAC/B,MAAM,YAAY,KAAK,MAAM;EAE7B,IAAI,WACF,MAAM,MAAM,OAAO,oBAAoB,KAAK,GAAG,WAAW;CAE9D;CAEA,MAAM,MAAM,IAAI,SAAS,MAAM,GAAG;AACpC"}

package/esm/utils/app-log.d.mts

@@ -0,0 +1,11 @@
+//#region ../../@warlock.js/core/src/utils/app-log.d.ts
+declare const appLog: {
+  info: (module: string, message: string) => Promise<import("@warlock.js/logger").Logger>;
+  error: (module: string, message: string) => Promise<import("@warlock.js/logger").Logger>;
+  warn: (module: string, message: string) => Promise<import("@warlock.js/logger").Logger>;
+  debug: (module: string, message: string) => Promise<import("@warlock.js/logger").Logger>;
+  success: (module: string, message: string) => Promise<import("@warlock.js/logger").Logger>;
+};
+//#endregion
+export { appLog };
+//# sourceMappingURL=app-log.d.mts.map

package/esm/utils/app-log.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-log.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/utils/app-log.ts"],"mappings":";cAEa,MAAA;yBACU,OAAA,aAAiB,OAAA,8BAAA,MAAA;0BAChB,OAAA,aAAiB,OAAA,8BAAA,MAAA;yBAClB,OAAA,aAAiB,OAAA,8BAAA,MAAA;0BAChB,OAAA,aAAiB,OAAA,8BAAA,MAAA;4BACf,OAAA,aAAiB,OAAA,8BAAA,MAAA;AAAA"}

package/esm/utils/app-log.mjs

@@ -0,0 +1,14 @@
+import { log } from "@warlock.js/logger";
+
+//#region ../../@warlock.js/core/src/utils/app-log.ts
+const appLog = {
+	info: (module, message) => log.info("app", module, message),
+	error: (module, message) => log.error("app", module, message),
+	warn: (module, message) => log.warn("app", module, message),
+	debug: (module, message) => log.debug("app", module, message),
+	success: (module, message) => log.success("app", module, message)
+};
+
+//#endregion
+export { appLog };
+//# sourceMappingURL=app-log.mjs.map

package/esm/utils/app-log.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-log.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/utils/app-log.ts"],"sourcesContent":["import { log } from \"@warlock.js/logger\";\n\nexport const appLog = {\n  info: (module: string, message: string) => log.info(\"app\", module, message),\n  error: (module: string, message: string) => log.error(\"app\", module, message),\n  warn: (module: string, message: string) => log.warn(\"app\", module, message),\n  debug: (module: string, message: string) => log.debug(\"app\", module, message),\n  success: (module: string, message: string) =>\n    log.success(\"app\", module, message),\n};\n"],"mappings":";;;AAEA,MAAa,SAAS;CACpB,OAAO,QAAgB,YAAoB,IAAI,KAAK,OAAO,QAAQ,OAAO;CAC1E,QAAQ,QAAgB,YAAoB,IAAI,MAAM,OAAO,QAAQ,OAAO;CAC5E,OAAO,QAAgB,YAAoB,IAAI,KAAK,OAAO,QAAQ,OAAO;CAC1E,QAAQ,QAAgB,YAAoB,IAAI,MAAM,OAAO,QAAQ,OAAO;CAC5E,UAAU,QAAgB,YACxB,IAAI,QAAQ,OAAO,QAAQ,OAAO;AACtC"}

package/esm/utils/database-log.d.mts

@@ -0,0 +1,28 @@
+import { DatabaseLogModel } from "../database/models/database-log/database-log.mjs";
+import { ChildModel, Model } from "@warlock.js/cascade";
+import { BasicLogConfigurations, LogChannel, LogContract, LoggingData } from "@warlock.js/logger";
+
+//#region ../../@warlock.js/core/src/utils/database-log.d.ts
+type DatabaseLogOptions = BasicLogConfigurations & {
+  /**
+   * Model to use for logging
+   */
+  model?: typeof DatabaseLogModel;
+};
+declare class DatabaseLog extends LogChannel<DatabaseLogOptions> implements LogContract {
+  /**
+   * {@inheritdoc}
+   */
+  name: string;
+  /**
+   * Database model
+   */
+  get model(): ChildModel<Model>;
+  /**
+   * {@inheritdoc}
+   */
+  log(log: LoggingData): Promise<void>;
+}
+//#endregion
+export { DatabaseLog, DatabaseLogOptions };
+//# sourceMappingURL=database-log.d.mts.map

package/esm/utils/database-log.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-log.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/utils/database-log.ts"],"mappings":";;;;;KAKY,kBAAA,GAAqB,sBAAA;;AAAjC;;EAIE,KAAA,UAAe,gBAAgB;AAAA;AAAA,cAGpB,WAAA,SAAoB,UAAA,CAAW,kBAAA,aAA+B,WAAA;EAHzE;;;EAOO,IAAA;EAJI;;;EAAA,IASA,KAAA,CAAA,GAAS,UAAA,CAAW,KAAA;EAAA;;;EAOlB,GAAA,CAAI,GAAA,EAAK,WAAA,GAAW,OAAA;AAAA"}

package/esm/utils/database-log.mjs

@@ -0,0 +1,48 @@
+import { DatabaseLogModel } from "../database/models/database-log/database-log.mjs";
+import "../database/models/database-log/index.mjs";
+import { LogChannel } from "@warlock.js/logger";
+
+//#region ../../@warlock.js/core/src/utils/database-log.ts
+var DatabaseLog = class extends LogChannel {
+	constructor(..._args) {
+		super(..._args);
+		this.name = "database";
+	}
+	/**
+	* Database model
+	*/
+	get model() {
+		return this.config("model") ?? DatabaseLogModel;
+	}
+	/**
+	* {@inheritdoc}
+	*/
+	async log(log) {
+		const { module, action, message, type: level } = log;
+		if (!this.model.getDataSource().driver?.isConnected) return;
+		if (!this.shouldBeLogged(log)) return;
+		const data = {
+			module,
+			action,
+			content: message,
+			level,
+			date: (/* @__PURE__ */ new Date()).toISOString()
+		};
+		if (message instanceof Error) {
+			data.stack = message.stack;
+			data.content = message.message;
+		} else {
+			data.content = message;
+			data.stack = (/* @__PURE__ */ new Error()).stack;
+		}
+		try {
+			await this.model.create(data);
+		} catch (error) {
+			console.log("Error", error);
+		}
+	}
+};
+
+//#endregion
+export { DatabaseLog };
+//# sourceMappingURL=database-log.mjs.map

package/esm/utils/database-log.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-log.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/utils/database-log.ts"],"sourcesContent":["import type { ChildModel, Model } from \"@warlock.js/cascade\";\nimport type { BasicLogConfigurations, LoggingData } from \"@warlock.js/logger\";\nimport { LogChannel, type LogContract, type LogMessage } from \"@warlock.js/logger\";\nimport { DatabaseLogModel } from \"../database/models/database-log\";\n\nexport type DatabaseLogOptions = BasicLogConfigurations & {\n  /**\n   * Model to use for logging\n   */\n  model?: typeof DatabaseLogModel;\n};\n\nexport class DatabaseLog extends LogChannel<DatabaseLogOptions> implements LogContract {\n  /**\n   * {@inheritdoc}\n   */\n  public name = \"database\";\n\n  /**\n   * Database model\n   */\n  public get model(): ChildModel<Model> {\n    return this.config(\"model\") ?? DatabaseLogModel;\n  }\n\n  /**\n   * {@inheritdoc}\n   */\n  public async log(log: LoggingData) {\n    const { module, action, message, type: level } = log;\n\n    if (!this.model.getDataSource().driver?.isConnected) return;\n\n    if (!this.shouldBeLogged(log)) return;\n\n    const data: LogMessage = {\n      module,\n      action,\n      content: message,\n      level,\n      date: new Date().toISOString(),\n    };\n\n    if (message instanceof Error) {\n      data.stack = message.stack;\n      data.content = message.message;\n    } else {\n      data.content = message;\n      data.stack = new Error().stack;\n    }\n\n    try {\n      await this.model.create(data);\n    } catch (error) {\n      console.log(\"Error\", error);\n    }\n  }\n}\n"],"mappings":";;;;;AAYA,IAAa,cAAb,cAAiC,WAAsD;;;cAIvE;;;;;CAKd,IAAW,QAA2B;EACpC,OAAO,KAAK,OAAO,OAAO,KAAK;CACjC;;;;CAKA,MAAa,IAAI,KAAkB;EACjC,MAAM,EAAE,QAAQ,QAAQ,SAAS,MAAM,UAAU;EAEjD,IAAI,CAAC,KAAK,MAAM,cAAc,EAAE,QAAQ,aAAa;EAErD,IAAI,CAAC,KAAK,eAAe,GAAG,GAAG;EAE/B,MAAM,OAAmB;GACvB;GACA;GACA,SAAS;GACT;GACA,uBAAM,IAAI,KAAK,GAAE,YAAY;EAC/B;EAEA,IAAI,mBAAmB,OAAO;GAC5B,KAAK,QAAQ,QAAQ;GACrB,KAAK,UAAU,QAAQ;EACzB,OAAO;GACL,KAAK,UAAU;GACf,KAAK,yBAAQ,IAAI,MAAM,GAAE;EAC3B;EAEA,IAAI;GACF,MAAM,KAAK,MAAM,OAAO,IAAI;EAC9B,SAAS,OAAO;GACd,QAAQ,IAAI,SAAS,KAAK;EAC5B;CACF;AACF"}

package/esm/utils/environment.d.mts

@@ -0,0 +1,7 @@
+//#region ../../@warlock.js/core/src/utils/environment.d.ts
+type Environment = "development" | "production" | "test";
+declare function environment(): Environment;
+declare function setEnvironment(env: Environment): void;
+//#endregion
+export { Environment, environment, setEnvironment };
+//# sourceMappingURL=environment.d.mts.map

package/esm/utils/environment.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/utils/environment.ts"],"mappings":";KAAY,WAAA;AAAA,iBAEI,WAAA,CAAA,GAAe,WAAW;AAAA,iBAI1B,cAAA,CAAe,GAAgB,EAAX,WAAW"}

package/esm/utils/environment.mjs

@@ -0,0 +1,11 @@
+//#region ../../@warlock.js/core/src/utils/environment.ts
+function environment() {
+	return process.env.NODE_ENV || "development";
+}
+function setEnvironment(env) {
+	process.env.NODE_ENV = env;
+}
+
+//#endregion
+export { environment, setEnvironment };
+//# sourceMappingURL=environment.mjs.map

package/esm/utils/environment.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/utils/environment.ts"],"sourcesContent":["export type Environment = \"development\" | \"production\" | \"test\";\n\nexport function environment(): Environment {\n  return (process.env.NODE_ENV as Environment) || \"development\";\n}\n\nexport function setEnvironment(env: Environment) {\n  process.env.NODE_ENV = env;\n}\n"],"mappings":";AAEA,SAAgB,cAA2B;CACzC,OAAQ,QAAQ,IAAI,YAA4B;AAClD;AAEA,SAAgB,eAAe,KAAkB;CAC/C,QAAQ,IAAI,WAAW;AACzB"}

package/esm/utils/framework-vesion.mjs

@@ -0,0 +1,24 @@
+import { getJsonFileAsync } from "@warlock.js/fs";
+import path from "node:path";
+
+//#region ../../@warlock.js/core/src/utils/framework-vesion.ts
+/**
+* Cached version string
+*/
+let cachedVersion = null;
+/**
+* Get the framework version from package.json (cached)
+*/
+async function getWarlockVersion() {
+	if (cachedVersion) return cachedVersion;
+	const version = (await getJsonFileAsync(path.join(import.meta.dirname, "./../../package.json"))).version.replace(/\^|\~/g, "");
+	cachedVersion = version;
+	return version;
+}
+function getFrameworkVersion() {
+	return cachedVersion;
+}
+
+//#endregion
+export { getFrameworkVersion, getWarlockVersion };
+//# sourceMappingURL=framework-vesion.mjs.map

package/esm/utils/framework-vesion.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-vesion.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/utils/framework-vesion.ts"],"sourcesContent":["import { getJsonFileAsync } from \"@warlock.js/fs\";\r\nimport path from \"node:path\";\r\n\r\n/**\r\n * Cached version string\r\n */\r\nlet cachedVersion: string | null = null;\r\n\r\n/**\r\n * Get the framework version from package.json (cached)\r\n */\r\nexport async function getWarlockVersion(): Promise<string> {\r\n  if (cachedVersion) return cachedVersion;\r\n\r\n  const frameworkPackageJson = (await getJsonFileAsync(\r\n    path.join(import.meta.dirname, \"./../../package.json\"),\r\n  )) as { version: string };\r\n\r\n  const version = frameworkPackageJson.version.replace(/\\^|\\~/g, \"\");\r\n  cachedVersion = version;\r\n  return version;\r\n}\r\n\r\nexport function getFrameworkVersion(): string | null {\r\n  return cachedVersion;\r\n}\r\n"],"mappings":";;;;;;;AAMA,IAAI,gBAA+B;;;;AAKnC,eAAsB,oBAAqC;CACzD,IAAI,eAAe,OAAO;CAM1B,MAAM,WAAU,MAJoB,iBAClC,KAAK,KAAK,OAAO,KAAK,SAAS,sBAAsB,CACvD,GAEqC,QAAQ,QAAQ,UAAU,EAAE;CACjE,gBAAgB;CAChB,OAAO;AACT;AAEA,SAAgB,sBAAqC;CACnD,OAAO;AACT"}

package/esm/utils/get-localized.d.mts

@@ -0,0 +1,13 @@
+//#region ../../@warlock.js/core/src/utils/get-localized.d.ts
+type LocalizedObject = {
+  localeCode: string;
+  value: any;
+};
+/**
+ * Get localized value based on the given locale code
+ * If the locale code is not given and the function is called within a request context, it will get the current locale code
+ */
+declare function getLocalized(values: LocalizedObject[], localeCode?: string, key?: string): any;
+//#endregion
+export { LocalizedObject, getLocalized };
+//# sourceMappingURL=get-localized.d.mts.map

package/esm/utils/get-localized.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-localized.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/utils/get-localized.ts"],"mappings":";KAEY,eAAA;EACV,UAAA;EACA,KAAK;AAAA;;AAAA;AAOP;;iBAAgB,YAAA,CAAa,MAAA,EAAQ,eAAe,IAAI,UAAA,WAAqB,GAAA"}

package/esm/utils/get-localized.mjs

@@ -0,0 +1,17 @@
+import { useRequestStore } from "../http/context/request-context.mjs";
+
+//#region ../../@warlock.js/core/src/utils/get-localized.ts
+/**
+* Get localized value based on the given locale code
+* If the locale code is not given and the function is called within a request context, it will get the current locale code
+*/
+function getLocalized(values, localeCode, key = "value") {
+	if (!values) return values;
+	if (!localeCode) localeCode = useRequestStore().request?.getLocaleCode();
+	if (Array.isArray(values)) return values.find((value) => value.localeCode === localeCode)?.[key];
+	return values;
+}
+
+//#endregion
+export { getLocalized };
+//# sourceMappingURL=get-localized.mjs.map

package/esm/utils/get-localized.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-localized.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/utils/get-localized.ts"],"sourcesContent":["import { useRequestStore } from \"../http/context/request-context\";\n\nexport type LocalizedObject = {\n  localeCode: string;\n  value: any;\n};\n\n/**\n * Get localized value based on the given locale code\n * If the locale code is not given and the function is called within a request context, it will get the current locale code\n */\nexport function getLocalized(values: LocalizedObject[], localeCode?: string, key = \"value\") {\n  if (!values) return values;\n\n  if (!localeCode) {\n    localeCode = useRequestStore().request?.getLocaleCode();\n  }\n\n  if (Array.isArray(values)) {\n    return values.find((value) => value.localeCode === localeCode)?.[key as keyof LocalizedObject];\n  }\n\n  return values;\n}\n"],"mappings":";;;;;;;AAWA,SAAgB,aAAa,QAA2B,YAAqB,MAAM,SAAS;CAC1F,IAAI,CAAC,QAAQ,OAAO;CAEpB,IAAI,CAAC,YACH,aAAa,gBAAgB,EAAE,SAAS,cAAc;CAGxD,IAAI,MAAM,QAAQ,MAAM,GACtB,OAAO,OAAO,MAAM,UAAU,MAAM,eAAe,UAAU,IAAI;CAGnE,OAAO;AACT"}

package/esm/utils/index.d.mts

@@ -0,0 +1,11 @@
+import { LocalizedObject, getLocalized } from "./get-localized.mjs";
+import { Environment, environment, setEnvironment } from "./environment.mjs";
+import { appLog } from "./app-log.mjs";
+import { DatabaseLog, DatabaseLogOptions } from "./database-log.mjs";
+import { appPath, cachePath, configPath, logsPath, paths, publicPath, rootPath, sanitizePath, srcPath, storagePath, tempPath, uploadsPath, warlockPath } from "./paths.mjs";
+import { promiseAllObject } from "./promise-all-object.mjs";
+import { Queue } from "./queue.mjs";
+import { sleep } from "./sleep.mjs";
+import { sluggable } from "./sluggable.mjs";
+import { toJson } from "./to-json.mjs";
+import { assetsUrl, publicUrl, setBaseUrl, uploadsUrl, url } from "./urls.mjs";

package/esm/utils/index.mjs

@@ -0,0 +1,13 @@
+import { appLog } from "./app-log.mjs";
+import { DatabaseLog } from "./database-log.mjs";
+import { environment, setEnvironment } from "./environment.mjs";
+import { getLocalized } from "./get-localized.mjs";
+import { appPath, cachePath, configPath, logsPath, paths, publicPath, rootPath, sanitizePath, srcPath, storagePath, tempPath, uploadsPath, warlockPath } from "./paths.mjs";
+import { promiseAllObject } from "./promise-all-object.mjs";
+import { Queue } from "./queue.mjs";
+import { sleep } from "./sleep.mjs";
+import { sluggable } from "./sluggable.mjs";
+import { toJson } from "./to-json.mjs";
+import { assetsUrl, publicUrl, setBaseUrl, uploadsUrl, url } from "./urls.mjs";
+
+export {  };