@warlock.js/core 4.1.14 → 4.2.0

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

@@ -2,7 +2,7 @@ import { fireLifecycleEvent, globalEventsCallbacksMap } from "./use-case-events.
 import { BadSchemaUseCaseError } from "./use-case.errors.mjs";
 import { v } from "@warlock.js/seal";
 
-//#region ../../@warlock.js/core/src/use-cases/use-case-pipeline.ts
+//#region ../@warlock.js/core/src/use-cases/use-case-pipeline.ts
 /**
 * Runs the pre-handler pipeline in order:
 * onExecuting event → guards → validation → before middleware.

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

@@ -1 +1 @@
-{"version":3,"file":"use-case-pipeline.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/use-cases/use-case-pipeline.ts"],"sourcesContent":["import type { ObjectValidator } from \"@warlock.js/seal\";\r\nimport { v } from \"@warlock.js/seal\";\r\nimport type {\r\n  UseCaseBeforeMiddleware,\r\n  UseCaseContext,\r\n  UseCaseGuard,\r\n  UseCaseOnExecutingContext,\r\n} from \"./types\";\r\nimport { fireLifecycleEvent, globalEventsCallbacksMap } from \"./use-case-events\";\r\nimport { BadSchemaUseCaseError } from \"./use-case.errors\";\r\n\r\nexport type PipelineOptions<Input> = {\r\n  name: string;\r\n  id: string;\r\n  data: Input;\r\n  ctx: UseCaseContext;\r\n  startedAt: Date;\r\n  schema?: ObjectValidator;\r\n  guards?: UseCaseGuard<Input>[];\r\n  before?: UseCaseBeforeMiddleware<Input>[];\r\n  /** Invocation-level onExecuting override */\r\n  onExecuting?: (ctx: UseCaseOnExecutingContext) => void;\r\n  /** Use-case-level onExecuting */\r\n  ucOnExecuting?: (ctx: UseCaseOnExecutingContext) => void;\r\n};\r\n\r\n/**\r\n * Runs the pre-handler pipeline in order:\r\n * onExecuting event → guards → validation → before middleware.\r\n *\r\n * Returns the validated, transformed data ready for the handler. The handler is\r\n * invoked by the caller so retry/benchmark can wrap it in isolation — keeping\r\n * guards, validation, and onExecuting from re-running on each retry attempt.\r\n *\r\n * Throws on guard failure or validation failure.\r\n *\r\n * @example\r\n * const data = await runPipeline({ name, id, data, ctx, startedAt, schema, guards, before });\r\n */\r\nexport async function runPipeline<Input>(opts: PipelineOptions<Input>): Promise<Input> {\r\n  const { name, id, ctx, startedAt, schema, guards, before, onExecuting, ucOnExecuting } = opts;\r\n  let data = opts.data;\r\n\r\n  await fireLifecycleEvent<UseCaseOnExecutingContext>(\r\n    { name, id, data, schema, ctx, startedAt },\r\n    {\r\n      invocation: onExecuting ? [onExecuting] : undefined,\r\n      useCase: ucOnExecuting ? [ucOnExecuting] : undefined,\r\n      global: globalEventsCallbacksMap.onExecuting.length\r\n        ? globalEventsCallbacksMap.onExecuting\r\n        : undefined,\r\n    },\r\n  );\r\n\r\n  if (guards) {\r\n    for (const guard of guards) {\r\n      await guard(Object.freeze(data) as Readonly<Input>, ctx);\r\n    }\r\n  }\r\n\r\n  if (schema) {\r\n    const result = await v.validate(schema, data);\r\n\r\n    if (!result.isValid) {\r\n      throw new BadSchemaUseCaseError(result);\r\n    }\r\n\r\n    data = result.data;\r\n  }\r\n\r\n  let transformed = data;\r\n\r\n  if (before) {\r\n    for (const middleware of before) {\r\n      transformed = await middleware(transformed, ctx);\r\n    }\r\n  }\r\n\r\n  return transformed;\r\n}\r\n"],"mappings":";;;;;;;;;;;;;;;;;;AAuCA,eAAsB,YAAmB,MAA8C;CACrF,MAAM,EAAE,MAAM,IAAI,KAAK,WAAW,QAAQ,QAAQ,QAAQ,aAAa,kBAAkB;CACzF,IAAI,OAAO,KAAK;CAEhB,MAAM,mBACJ;EAAE;EAAM;EAAI;EAAM;EAAQ;EAAK;CAAU,GACzC;EACE,YAAY,cAAc,CAAC,WAAW,IAAI;EAC1C,SAAS,gBAAgB,CAAC,aAAa,IAAI;EAC3C,QAAQ,yBAAyB,YAAY,SACzC,yBAAyB,cACzB;CACN,CACF;CAEA,IAAI,QACF,KAAK,MAAM,SAAS,QAClB,MAAM,MAAM,OAAO,OAAO,IAAI,GAAsB,GAAG;CAI3D,IAAI,QAAQ;EACV,MAAM,SAAS,MAAM,EAAE,SAAS,QAAQ,IAAI;EAE5C,IAAI,CAAC,OAAO,SACV,MAAM,IAAI,sBAAsB,MAAM;EAGxC,OAAO,OAAO;CAChB;CAEA,IAAI,cAAc;CAElB,IAAI,QACF,KAAK,MAAM,cAAc,QACvB,cAAc,MAAM,WAAW,aAAa,GAAG;CAInD,OAAO;AACT"}
+{"version":3,"file":"use-case-pipeline.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/use-cases/use-case-pipeline.ts"],"sourcesContent":["import type { ObjectValidator } from \"@warlock.js/seal\";\r\nimport { v } from \"@warlock.js/seal\";\r\nimport type {\r\n  UseCaseBeforeMiddleware,\r\n  UseCaseContext,\r\n  UseCaseGuard,\r\n  UseCaseOnExecutingContext,\r\n} from \"./types\";\r\nimport { fireLifecycleEvent, globalEventsCallbacksMap } from \"./use-case-events\";\r\nimport { BadSchemaUseCaseError } from \"./use-case.errors\";\r\n\r\nexport type PipelineOptions<Input> = {\r\n  name: string;\r\n  id: string;\r\n  data: Input;\r\n  ctx: UseCaseContext;\r\n  startedAt: Date;\r\n  schema?: ObjectValidator;\r\n  guards?: UseCaseGuard<Input>[];\r\n  before?: UseCaseBeforeMiddleware<Input>[];\r\n  /** Invocation-level onExecuting override */\r\n  onExecuting?: (ctx: UseCaseOnExecutingContext) => void;\r\n  /** Use-case-level onExecuting */\r\n  ucOnExecuting?: (ctx: UseCaseOnExecutingContext) => void;\r\n};\r\n\r\n/**\r\n * Runs the pre-handler pipeline in order:\r\n * onExecuting event → guards → validation → before middleware.\r\n *\r\n * Returns the validated, transformed data ready for the handler. The handler is\r\n * invoked by the caller so retry/benchmark can wrap it in isolation — keeping\r\n * guards, validation, and onExecuting from re-running on each retry attempt.\r\n *\r\n * Throws on guard failure or validation failure.\r\n *\r\n * @example\r\n * const data = await runPipeline({ name, id, data, ctx, startedAt, schema, guards, before });\r\n */\r\nexport async function runPipeline<Input>(opts: PipelineOptions<Input>): Promise<Input> {\r\n  const { name, id, ctx, startedAt, schema, guards, before, onExecuting, ucOnExecuting } = opts;\r\n  let data = opts.data;\r\n\r\n  await fireLifecycleEvent<UseCaseOnExecutingContext>(\r\n    { name, id, data, schema, ctx, startedAt },\r\n    {\r\n      invocation: onExecuting ? [onExecuting] : undefined,\r\n      useCase: ucOnExecuting ? [ucOnExecuting] : undefined,\r\n      global: globalEventsCallbacksMap.onExecuting.length\r\n        ? globalEventsCallbacksMap.onExecuting\r\n        : undefined,\r\n    },\r\n  );\r\n\r\n  if (guards) {\r\n    for (const guard of guards) {\r\n      await guard(Object.freeze(data) as Readonly<Input>, ctx);\r\n    }\r\n  }\r\n\r\n  if (schema) {\r\n    const result = await v.validate(schema, data);\r\n\r\n    if (!result.isValid) {\r\n      throw new BadSchemaUseCaseError(result);\r\n    }\r\n\r\n    data = result.data;\r\n  }\r\n\r\n  let transformed = data;\r\n\r\n  if (before) {\r\n    for (const middleware of before) {\r\n      transformed = await middleware(transformed, ctx);\r\n    }\r\n  }\r\n\r\n  return transformed;\r\n}\r\n"],"mappings":";;;;;;;;;;;;;;;;;;AAuCA,eAAsB,YAAmB,MAA8C;CACrF,MAAM,EAAE,MAAM,IAAI,KAAK,WAAW,QAAQ,QAAQ,QAAQ,aAAa,kBAAkB;CACzF,IAAI,OAAO,KAAK;CAEhB,MAAM,mBACJ;EAAE;EAAM;EAAI;EAAM;EAAQ;EAAK;CAAU,GACzC;EACE,YAAY,cAAc,CAAC,WAAW,IAAI;EAC1C,SAAS,gBAAgB,CAAC,aAAa,IAAI;EAC3C,QAAQ,yBAAyB,YAAY,SACzC,yBAAyB,cACzB;CACN,CACF;CAEA,IAAI,QACF,KAAK,MAAM,SAAS,QAClB,MAAM,MAAM,OAAO,OAAO,IAAI,GAAsB,GAAG;CAI3D,IAAI,QAAQ;EACV,MAAM,SAAS,MAAM,EAAE,SAAS,QAAQ,IAAI;EAE5C,IAAI,CAAC,OAAO,SACV,MAAM,IAAI,sBAAsB,MAAM;EAGxC,OAAO,OAAO;CAChB;CAEA,IAAI,cAAc;CAElB,IAAI,QACF,KAAK,MAAM,cAAc,QACvB,cAAc,MAAM,WAAW,aAAa,GAAG;CAInD,OAAO;AACT"}

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

@@ -1,7 +1,7 @@
 import { UseCase, UseCaseContext, UseCaseHandler, UseCaseWithSchema } from "./types.mjs";
 import { Infer, ObjectValidator } from "@warlock.js/seal";
 
-//#region ../../@warlock.js/core/src/use-cases/use-case.d.ts
+//#region ../@warlock.js/core/src/use-cases/use-case.d.ts
 /**
  * Defines and registers a use case.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"use-case.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/use-cases/use-case.ts"],"mappings":";;;;;;AAwDA;;;;;;;;;;;;;;;;;;;;;;;;iBAAgB,OAAA,wBAEC,eAAA,cACH,cAAA,GAAiB,cAAA,CAAA,CAC7B,OAAA,EAAS,iBAAA,CAAkB,MAAA,EAAQ,MAAA,EAAQ,GAAA,IAAO,cAAA,CAAe,MAAA,EAAQ,KAAA,CAAM,MAAA;AAAA,iBACjE,OAAA,wCAA+C,cAAA,GAAiB,cAAA,CAAA,CAC9E,OAAA,EAAS,OAAA,CAAQ,MAAA,EAAQ,KAAA,EAAO,GAAA,IAC/B,cAAA,CAAe,MAAA,EAAQ,KAAA"}
+{"version":3,"file":"use-case.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/use-cases/use-case.ts"],"mappings":";;;;;;AAwDA;;;;;;;;;;;;;;;;;;;;;;;;iBAAgB,OAAA,wBAEC,eAAA,cACH,cAAA,GAAiB,cAAA,EAC7B,OAAA,EAAS,iBAAA,CAAkB,MAAA,EAAQ,MAAA,EAAQ,GAAA,IAAO,cAAA,CAAe,MAAA,EAAQ,KAAA,CAAM,MAAA;AAAA,iBACjE,OAAA,wCAA+C,cAAA,GAAiB,cAAA,EAC9E,OAAA,EAAS,OAAA,CAAQ,MAAA,EAAQ,KAAA,EAAO,GAAA,IAC/B,cAAA,CAAe,MAAA,EAAQ,KAAA"}

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

@@ -1,7 +1,7 @@
 import { HttpError } from "../http/errors/errors.mjs";
 import { ValidationResult } from "@warlock.js/seal";
 
-//#region ../../@warlock.js/core/src/use-cases/use-case.errors.d.ts
+//#region ../@warlock.js/core/src/use-cases/use-case.errors.d.ts
 declare class BadSchemaUseCaseError extends HttpError {
   constructor(result: ValidationResult);
 }

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

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

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

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

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

@@ -9,7 +9,7 @@ import { $registerUseCase, $unregisterUseCase, addUseCaseHistory, increaseUseCas
 import { log } from "@warlock.js/logger";
 import { Random, except, retry } from "@mongez/reinforcements";
 
-//#region ../../@warlock.js/core/src/use-cases/use-case.ts
+//#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;

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

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

@@ -1,6 +1,6 @@
 import { RegisteredUseCase, UseCase, UseCaseResult } from "./types.mjs";
 
-//#region ../../@warlock.js/core/src/use-cases/use-cases-registry.d.ts
+//#region ../@warlock.js/core/src/use-cases/use-cases-registry.d.ts
 /**
  * Register a use case
  */

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

@@ -1 +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"}
+{"version":3,"file":"use-cases-registry.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/use-cases/use-cases-registry.ts"],"mappings":";;;;;AAaA;iBAAgB,gBAAA,gBACd,IAAA,UACA,OAAA,EAAS,iBAAA,CAAkB,MAAA,EAAQ,KAAA;;;;iBAgBrB,kBAAA,CAAmB,IAAY;;;;iBAS/B,UAAA,gBAA0B,IAAA,WACJ,OAAA,CAAQ,MAAA,EAAQ,KAAA;;;;iBAMtC,WAAA,IAAW,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

@@ -3,7 +3,7 @@ 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
+//#region ../@warlock.js/core/src/use-cases/use-cases-registry.ts
 /**
 * Store registered use cases
 */

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

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

@@ -1,4 +1,4 @@
-//#region ../../@warlock.js/core/src/utils/app-log.d.ts
+//#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>;

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

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

@@ -1,6 +1,6 @@
 import { log } from "@warlock.js/logger";
 
-//#region ../../@warlock.js/core/src/utils/app-log.ts
+//#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),

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

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

@@ -2,7 +2,7 @@ import { DatabaseLogModel } from "../database/models/database-log/database-log.m
 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
+//#region ../@warlock.js/core/src/utils/database-log.d.ts
 type DatabaseLogOptions = BasicLogConfigurations & {
   /**
    * Model to use for logging

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

@@ -1 +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"}
+{"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,IAAS,UAAA,CAAW,KAAA;EAAA;;;EAOlB,GAAA,CAAI,GAAA,EAAK,WAAA,GAAW,OAAA;AAAA"}

package/esm/utils/database-log.mjs

@@ -2,7 +2,7 @@ import { DatabaseLogModel } from "../database/models/database-log/database-log.m
 import "../database/models/database-log/index.mjs";
 import { LogChannel } from "@warlock.js/logger";
 
-//#region ../../@warlock.js/core/src/utils/database-log.ts
+//#region ../@warlock.js/core/src/utils/database-log.ts
 var DatabaseLog = class extends LogChannel {
 	constructor(..._args) {
 		super(..._args);

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

@@ -1 +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"}
+{"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,CAAC,CAAC,QAAQ,aAAa;EAErD,IAAI,CAAC,KAAK,eAAe,GAAG,GAAG;EAE/B,MAAM,OAAmB;GACvB;GACA;GACA,SAAS;GACT;GACA,uBAAM,IAAI,KAAK,EAAC,CAAC,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,EAAC,CAAC;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

@@ -1,4 +1,4 @@
-//#region ../../@warlock.js/core/src/utils/environment.d.ts
+//#region ../@warlock.js/core/src/utils/environment.d.ts
 type Environment = "development" | "production" | "test";
 declare function environment(): Environment;
 declare function setEnvironment(env: Environment): void;

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

@@ -1 +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"}
+{"version":3,"file":"environment.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/utils/environment.ts"],"mappings":";KAAY,WAAA;AAAA,iBAEI,WAAA,IAAe,WAAW;AAAA,iBAI1B,cAAA,CAAe,GAAgB,EAAX,WAAW"}

package/esm/utils/environment.mjs

@@ -1,4 +1,4 @@
-//#region ../../@warlock.js/core/src/utils/environment.ts
+//#region ../@warlock.js/core/src/utils/environment.ts
 function environment() {
 	return process.env.NODE_ENV || "development";
 }

package/esm/utils/environment.mjs.map

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

@@ -1,24 +1,15 @@
 import { getJsonFileAsync } from "@warlock.js/fs";
 import path from "node:path";
 
-//#region ../../@warlock.js/core/src/utils/framework-vesion.ts
+//#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 };
+export { getFrameworkVersion };
 //# sourceMappingURL=framework-vesion.mjs.map

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

@@ -1 +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"}
+{"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;AAiBnC,SAAgB,sBAAqC;CACnD,OAAO;AACT"}

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

@@ -1,4 +1,4 @@
-//#region ../../@warlock.js/core/src/utils/get-localized.d.ts
+//#region ../@warlock.js/core/src/utils/get-localized.d.ts
 type LocalizedObject = {
   localeCode: string;
   value: any;

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

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

@@ -1,6 +1,6 @@
 import { useRequestStore } from "../http/context/request-context.mjs";
 
-//#region ../../@warlock.js/core/src/utils/get-localized.ts
+//#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

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

@@ -1 +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"}
+{"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,CAAC,CAAC,SAAS,cAAc;CAGxD,IAAI,MAAM,QAAQ,MAAM,GACtB,OAAO,OAAO,MAAM,UAAU,MAAM,eAAe,UAAU,CAAC,GAAG;CAGnE,OAAO;AACT"}

package/esm/utils/paths.d.mts

@@ -1,4 +1,4 @@
-//#region ../../@warlock.js/core/src/utils/paths.d.ts
+//#region ../@warlock.js/core/src/utils/paths.d.ts
 /**
  * Get root path or join the given paths to the root path
  */

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

@@ -1 +1 @@
-{"version":3,"file":"paths.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/utils/paths.ts"],"mappings":";;AAMA;;iBAAgB,QAAA,CAAA,GAAY,KAAK;;AAAA;AAOjC;iBAAgB,OAAA,CAAA,GAAW,KAAK;;;AAAA;AAShC;;iBAAgB,WAAA,CAAY,YAAiB;;AAAA;AAS7C;;;iBAAgB,WAAA,CAAY,YAAiB;AAAA;AAgB7C;;;;AAhB6C,iBAgB7B,UAAA,CAAW,YAAiB;AAS5C;;;;AAA2C;AAA3C,iBAAgB,SAAA,CAAU,YAAiB;;;;iBAO3B,OAAA,CAAQ,YAAiB;AAOzC;;;AAAA,iBAAgB,QAAA,CAAS,YAAiB;AAAA;AAO1C;;AAP0C,iBAO1B,QAAA,CAAS,YAAiB;AAAA,iBAS1B,YAAA,CAAa,QAAgB;AATH;AAS1C;;;AAT0C,iBAiB1B,WAAA,CAAA,GAAe,IAAI;AARU;AAQ7C;;AAR6C,iBAe7B,UAAA,CAAA,GAAc,IAAI;AAAA,cAIrB,KAAA"}
+{"version":3,"file":"paths.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/utils/paths.ts"],"mappings":";;AAMA;;iBAAgB,QAAA,IAAY,KAAK;;AAAA;AAOjC;iBAAgB,OAAA,IAAW,KAAK;;;AAAA;AAShC;;iBAAgB,WAAA,CAAY,YAAiB;;AAAA;AAS7C;;;iBAAgB,WAAA,CAAY,YAAiB;AAAA;AAgB7C;;;;AAhB6C,iBAgB7B,UAAA,CAAW,YAAiB;AAS5C;;;;AAA2C;AAA3C,iBAAgB,SAAA,CAAU,YAAiB;;;;iBAO3B,OAAA,CAAQ,YAAiB;AAOzC;;;AAAA,iBAAgB,QAAA,CAAS,YAAiB;AAAA;AAO1C;;AAP0C,iBAO1B,QAAA,CAAS,YAAiB;AAAA,iBAS1B,YAAA,CAAa,QAAgB;AATH;AAS1C;;;AAT0C,iBAiB1B,WAAA,IAAe,IAAI;AARU;AAQ7C;;AAR6C,iBAe7B,UAAA,IAAc,IAAI;AAAA,cAIrB,KAAA"}

package/esm/utils/paths.mjs

@@ -1,7 +1,7 @@
 import config from "@mongez/config";
 import path from "path";
 
-//#region ../../@warlock.js/core/src/utils/paths.ts
+//#region ../@warlock.js/core/src/utils/paths.ts
 /**
 * Get root path or join the given paths to the root path
 */

package/esm/utils/paths.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"paths.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/utils/paths.ts"],"sourcesContent":["import config from \"@mongez/config\";\r\nimport path from \"path\";\r\n\r\n/**\r\n * Get root path or join the given paths to the root path\r\n */\r\nexport function rootPath(...paths: string[]) {\r\n  return path.resolve(process.cwd(), ...paths);\r\n}\r\n\r\n/**\r\n * Get src directory path or join the given paths to the src directory path\r\n */\r\nexport function srcPath(...paths: string[]) {\r\n  return rootPath(\"src\", ...paths);\r\n}\r\n\r\n/**\r\n * Get the absolute path to the storage folder to the given path\r\n *\r\n * If no path is given, it will return the absolute path to the storage folder\r\n */\r\nexport function storagePath(relativePath = \"\") {\r\n  return rootPath(\"storage\", relativePath);\r\n}\r\n\r\n/**\r\n * Get the absolute path to the uploads folder to the given path\r\n *\r\n * If no path is given, it will return the absolute path to the uploads folder\r\n */\r\nexport function uploadsPath(relativePath = \"\") {\r\n  const configPath = config.get(\"uploads.root\");\r\n  if (!configPath) {\r\n    return rootPath(\"storage\", \"uploads\", relativePath);\r\n  }\r\n\r\n  return typeof configPath === \"function\"\r\n    ? configPath(relativePath)\r\n    : path.resolve(configPath, relativePath);\r\n}\r\n\r\n/**\r\n * Get the absolute path to the public folder to the given path\r\n *\r\n * If no path is given, it will return the absolute path to the public folder\r\n */\r\nexport function publicPath(relativePath = \"\") {\r\n  return rootPath(\"public\", relativePath);\r\n}\r\n\r\n/**\r\n * Get the absolute path to the cache folder to the given path\r\n *\r\n * If no path is given, it will return the absolute path to the cache folder\r\n */\r\nexport function cachePath(relativePath = \"\") {\r\n  return rootPath(\"storage\", \"cache\", relativePath);\r\n}\r\n\r\n/**\r\n * App path\r\n */\r\nexport function appPath(relativePath = \"\") {\r\n  return rootPath(\"src/app\", relativePath);\r\n}\r\n\r\n/**\r\n * Get logs directory path\r\n */\r\nexport function logsPath(relativePath = \"\") {\r\n  return rootPath(\"storage/logs\", relativePath);\r\n}\r\n\r\n/**\r\n * Get a temp path\r\n */\r\nexport function tempPath(relativePath = \"\") {\r\n  return rootPath(\"storage/tmp\", relativePath);\r\n}\r\n\r\n/**\r\n * Remove any invalid characters from the file path using regex\r\n * It should accept any language character, numbers, and the following characters: _ - .\r\n */\r\nconst invalidCharsRegex = /[<>:\"/\\\\|?*]/g; // Regex to match invalid characters\r\nexport function sanitizePath(filePath: string) {\r\n  return filePath.replace(invalidCharsRegex, \"\"); // Replace invalid characters with an empty string\r\n}\r\n\r\n/**\r\n * Warlock path\r\n * PLEASE DO NOT add any files in this directory as it may be deleted\r\n */\r\nexport function warlockPath(...path: string[]) {\r\n  return rootPath(\".warlock\", ...path);\r\n}\r\n\r\n/**\r\n * Get config directory path\r\n */\r\nexport function configPath(...path: string[]) {\r\n  return rootPath(\"src/config\", ...path);\r\n}\r\n\r\nexport const paths = {\r\n  root: rootPath,\r\n  src: srcPath,\r\n  storage: storagePath,\r\n  logs: logsPath,\r\n  uploads: uploadsPath,\r\n  public: publicPath,\r\n  cache: cachePath,\r\n  app: appPath,\r\n  temp: tempPath,\r\n  warlock: warlockPath,\r\n  config: configPath,\r\n  sanitize: sanitizePath,\r\n};\r\n"],"mappings":";;;;;;;AAMA,SAAgB,SAAS,GAAG,OAAiB;CAC3C,OAAO,KAAK,QAAQ,QAAQ,IAAI,GAAG,GAAG,KAAK;AAC7C;;;;AAKA,SAAgB,QAAQ,GAAG,OAAiB;CAC1C,OAAO,SAAS,OAAO,GAAG,KAAK;AACjC;;;;;;AAOA,SAAgB,YAAY,eAAe,IAAI;CAC7C,OAAO,SAAS,WAAW,YAAY;AACzC;;;;;;AAOA,SAAgB,YAAY,eAAe,IAAI;CAC7C,MAAM,aAAa,OAAO,IAAI,cAAc;CAC5C,IAAI,CAAC,YACH,OAAO,SAAS,WAAW,WAAW,YAAY;CAGpD,OAAO,OAAO,eAAe,aACzB,WAAW,YAAY,IACvB,KAAK,QAAQ,YAAY,YAAY;AAC3C;;;;;;AAOA,SAAgB,WAAW,eAAe,IAAI;CAC5C,OAAO,SAAS,UAAU,YAAY;AACxC;;;;;;AAOA,SAAgB,UAAU,eAAe,IAAI;CAC3C,OAAO,SAAS,WAAW,SAAS,YAAY;AAClD;;;;AAKA,SAAgB,QAAQ,eAAe,IAAI;CACzC,OAAO,SAAS,WAAW,YAAY;AACzC;;;;AAKA,SAAgB,SAAS,eAAe,IAAI;CAC1C,OAAO,SAAS,gBAAgB,YAAY;AAC9C;;;;AAKA,SAAgB,SAAS,eAAe,IAAI;CAC1C,OAAO,SAAS,eAAe,YAAY;AAC7C;;;;;AAMA,MAAM,oBAAoB;AAC1B,SAAgB,aAAa,UAAkB;CAC7C,OAAO,SAAS,QAAQ,mBAAmB,EAAE;AAC/C;;;;;AAMA,SAAgB,YAAY,GAAG,MAAgB;CAC7C,OAAO,SAAS,YAAY,GAAG,IAAI;AACrC;;;;AAKA,SAAgB,WAAW,GAAG,MAAgB;CAC5C,OAAO,SAAS,cAAc,GAAG,IAAI;AACvC;AAEA,MAAa,QAAQ;CACnB,MAAM;CACN,KAAK;CACL,SAAS;CACT,MAAM;CACN,SAAS;CACT,QAAQ;CACR,OAAO;CACP,KAAK;CACL,MAAM;CACN,SAAS;CACT,QAAQ;CACR,UAAU;AACZ"}
+{"version":3,"file":"paths.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/utils/paths.ts"],"sourcesContent":["import config from \"@mongez/config\";\r\nimport path from \"path\";\r\n\r\n/**\r\n * Get root path or join the given paths to the root path\r\n */\r\nexport function rootPath(...paths: string[]) {\r\n  return path.resolve(process.cwd(), ...paths);\r\n}\r\n\r\n/**\r\n * Get src directory path or join the given paths to the src directory path\r\n */\r\nexport function srcPath(...paths: string[]) {\r\n  return rootPath(\"src\", ...paths);\r\n}\r\n\r\n/**\r\n * Get the absolute path to the storage folder to the given path\r\n *\r\n * If no path is given, it will return the absolute path to the storage folder\r\n */\r\nexport function storagePath(relativePath = \"\") {\r\n  return rootPath(\"storage\", relativePath);\r\n}\r\n\r\n/**\r\n * Get the absolute path to the uploads folder to the given path\r\n *\r\n * If no path is given, it will return the absolute path to the uploads folder\r\n */\r\nexport function uploadsPath(relativePath = \"\") {\r\n  const configPath = config.get(\"uploads.root\");\r\n  if (!configPath) {\r\n    return rootPath(\"storage\", \"uploads\", relativePath);\r\n  }\r\n\r\n  return typeof configPath === \"function\"\r\n    ? configPath(relativePath)\r\n    : path.resolve(configPath, relativePath);\r\n}\r\n\r\n/**\r\n * Get the absolute path to the public folder to the given path\r\n *\r\n * If no path is given, it will return the absolute path to the public folder\r\n */\r\nexport function publicPath(relativePath = \"\") {\r\n  return rootPath(\"public\", relativePath);\r\n}\r\n\r\n/**\r\n * Get the absolute path to the cache folder to the given path\r\n *\r\n * If no path is given, it will return the absolute path to the cache folder\r\n */\r\nexport function cachePath(relativePath = \"\") {\r\n  return rootPath(\"storage\", \"cache\", relativePath);\r\n}\r\n\r\n/**\r\n * App path\r\n */\r\nexport function appPath(relativePath = \"\") {\r\n  return rootPath(\"src/app\", relativePath);\r\n}\r\n\r\n/**\r\n * Get logs directory path\r\n */\r\nexport function logsPath(relativePath = \"\") {\r\n  return rootPath(\"storage/logs\", relativePath);\r\n}\r\n\r\n/**\r\n * Get a temp path\r\n */\r\nexport function tempPath(relativePath = \"\") {\r\n  return rootPath(\"storage/tmp\", relativePath);\r\n}\r\n\r\n/**\r\n * Remove any invalid characters from the file path using regex\r\n * It should accept any language character, numbers, and the following characters: _ - .\r\n */\r\nconst invalidCharsRegex = /[<>:\"/\\\\|?*]/g; // Regex to match invalid characters\r\nexport function sanitizePath(filePath: string) {\r\n  return filePath.replace(invalidCharsRegex, \"\"); // Replace invalid characters with an empty string\r\n}\r\n\r\n/**\r\n * Warlock path\r\n * PLEASE DO NOT add any files in this directory as it may be deleted\r\n */\r\nexport function warlockPath(...path: string[]) {\r\n  return rootPath(\".warlock\", ...path);\r\n}\r\n\r\n/**\r\n * Get config directory path\r\n */\r\nexport function configPath(...path: string[]) {\r\n  return rootPath(\"src/config\", ...path);\r\n}\r\n\r\nexport const paths = {\r\n  root: rootPath,\r\n  src: srcPath,\r\n  storage: storagePath,\r\n  logs: logsPath,\r\n  uploads: uploadsPath,\r\n  public: publicPath,\r\n  cache: cachePath,\r\n  app: appPath,\r\n  temp: tempPath,\r\n  warlock: warlockPath,\r\n  config: configPath,\r\n  sanitize: sanitizePath,\r\n};\r\n"],"mappings":";;;;;;;AAMA,SAAgB,SAAS,GAAG,OAAiB;CAC3C,OAAO,KAAK,QAAQ,QAAQ,IAAI,GAAG,GAAG,KAAK;AAC7C;;;;AAKA,SAAgB,QAAQ,GAAG,OAAiB;CAC1C,OAAO,SAAS,OAAO,GAAG,KAAK;AACjC;;;;;;AAOA,SAAgB,YAAY,eAAe,IAAI;CAC7C,OAAO,SAAS,WAAW,YAAY;AACzC;;;;;;AAOA,SAAgB,YAAY,eAAe,IAAI;CAC7C,MAAM,aAAa,OAAO,IAAI,cAAc;CAC5C,IAAI,CAAC,YACH,OAAO,SAAS,WAAW,WAAW,YAAY;CAGpD,OAAO,OAAO,eAAe,aACzB,WAAW,YAAY,IACvB,KAAK,QAAQ,YAAY,YAAY;AAC3C;;;;;;AAOA,SAAgB,WAAW,eAAe,IAAI;CAC5C,OAAO,SAAS,UAAU,YAAY;AACxC;;;;;;AAOA,SAAgB,UAAU,eAAe,IAAI;CAC3C,OAAO,SAAS,WAAW,SAAS,YAAY;AAClD;;;;AAKA,SAAgB,QAAQ,eAAe,IAAI;CACzC,OAAO,SAAS,WAAW,YAAY;AACzC;;;;AAKA,SAAgB,SAAS,eAAe,IAAI;CAC1C,OAAO,SAAS,gBAAgB,YAAY;AAC9C;;;;AAKA,SAAgB,SAAS,eAAe,IAAI;CAC1C,OAAO,SAAS,eAAe,YAAY;AAC7C;;;;;AAMA,MAAM,oBAAoB;AAC1B,SAAgB,aAAa,UAAkB;CAC7C,OAAO,SAAS,QAAQ,mBAAmB,EAAE;AAC/C;;;;;AAMA,SAAgB,YAAY,GAAG,MAAgB;CAC7C,OAAO,SAAS,YAAY,GAAG,IAAI;AACrC;;;;AAKA,SAAgB,WAAW,GAAG,MAAgB;CAC5C,OAAO,SAAS,cAAc,GAAG,IAAI;AACvC;AAEA,MAAa,QAAQ;CACnB,MAAM;CACN,KAAK;CACL,SAAS;CACT,MAAM;CACN,SAAS;CACT,QAAQ;CACR,OAAO;CACP,KAAK;CACL,MAAM;CACN,SAAS;CACT,QAAQ;CACR,UAAU;AACZ"}

package/esm/utils/promise-all-object.d.mts

@@ -1,4 +1,4 @@
-//#region ../../@warlock.js/core/src/utils/promise-all-object.d.ts
+//#region ../@warlock.js/core/src/utils/promise-all-object.d.ts
 /**
  * Resolve all of the given promises in the object and return the results as an object.
  * This is more convenient than using `Promise.all` and then mapping the results back to the keys.

package/esm/utils/promise-all-object.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"promise-all-object.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/utils/promise-all-object.ts"],"mappings":";;AAIA;;;iBAAsB,gBAAA,WAA2B,MAAA,SAAe,OAAA,OAAA,CAC9D,QAAA,EAAU,CAAA,GACT,OAAA,eAAsB,CAAA,GAAI,CAAA,CAAE,CAAA,UAAW,OAAA,YAAmB,CAAA"}
+{"version":3,"file":"promise-all-object.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/utils/promise-all-object.ts"],"mappings":";;AAIA;;;iBAAsB,gBAAA,WAA2B,MAAA,SAAe,OAAA,QAC9D,QAAA,EAAU,CAAA,GACT,OAAA,eAAsB,CAAA,GAAI,CAAA,CAAE,CAAA,UAAW,OAAA,YAAmB,CAAA"}

package/esm/utils/promise-all-object.mjs

@@ -1,4 +1,4 @@
-//#region ../../@warlock.js/core/src/utils/promise-all-object.ts
+//#region ../@warlock.js/core/src/utils/promise-all-object.ts
 /**
 * Resolve all of the given promises in the object and return the results as an object.
 * This is more convenient than using `Promise.all` and then mapping the results back to the keys.

package/esm/utils/promise-all-object.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"promise-all-object.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/utils/promise-all-object.ts"],"sourcesContent":["/**\n * Resolve all of the given promises in the object and return the results as an object.\n * This is more convenient than using `Promise.all` and then mapping the results back to the keys.\n */\nexport async function promiseAllObject<T extends Record<string, Promise<any>>>(\n  promises: T,\n): Promise<{ [K in keyof T]: T[K] extends Promise<infer U> ? U : never }> {\n  const results = await Promise.all(Object.values(promises));\n  const keys = Object.keys(promises);\n\n  return keys.reduce(\n    (result, key, index) => {\n      (result as any)[key] = results[index];\n      return result;\n    },\n    {} as { [K in keyof T]: T[K] extends Promise<infer U> ? U : never },\n  );\n}\n"],"mappings":";;;;;AAIA,eAAsB,iBACpB,UACwE;CACxE,MAAM,UAAU,MAAM,QAAQ,IAAI,OAAO,OAAO,QAAQ,CAAC;CAGzD,OAFa,OAAO,KAAK,QAEf,EAAE,QACT,QAAQ,KAAK,UAAU;EACtB,AAAC,OAAe,OAAO,QAAQ;EAC/B,OAAO;CACT,GACA,CAAC,CACH;AACF"}
+{"version":3,"file":"promise-all-object.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/utils/promise-all-object.ts"],"sourcesContent":["/**\n * Resolve all of the given promises in the object and return the results as an object.\n * This is more convenient than using `Promise.all` and then mapping the results back to the keys.\n */\nexport async function promiseAllObject<T extends Record<string, Promise<any>>>(\n  promises: T,\n): Promise<{ [K in keyof T]: T[K] extends Promise<infer U> ? U : never }> {\n  const results = await Promise.all(Object.values(promises));\n  const keys = Object.keys(promises);\n\n  return keys.reduce(\n    (result, key, index) => {\n      (result as any)[key] = results[index];\n      return result;\n    },\n    {} as { [K in keyof T]: T[K] extends Promise<infer U> ? U : never },\n  );\n}\n"],"mappings":";;;;;AAIA,eAAsB,iBACpB,UACwE;CACxE,MAAM,UAAU,MAAM,QAAQ,IAAI,OAAO,OAAO,QAAQ,CAAC;CAGzD,OAFa,OAAO,KAAK,QAEf,CAAC,CAAC,QACT,QAAQ,KAAK,UAAU;EACtB,AAAC,OAAe,OAAO,QAAQ;EAC/B,OAAO;CACT,GACA,CAAC,CACH;AACF"}

package/esm/utils/queue.d.mts

@@ -1,4 +1,4 @@
-//#region ../../@warlock.js/core/src/utils/queue.d.ts
+//#region ../@warlock.js/core/src/utils/queue.d.ts
 /**
  * A utility class for managing a queue of operations.
  * Allows enqueuing values and executing a function when the queue reaches a certain size or after a specified interval.

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

@@ -1 +1 @@
-{"version":3,"file":"queue.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/utils/queue.ts"],"mappings":";;AAKA;;;;cAAa,KAAA;EAqDU;EAAA,QAnDb,KAAA;EAmDc;EAAA,iBAhDL,OAAA;EAHT;EAAA,iBAMS,QAAA;EAAA;EAAA,iBAGA,SAAA;EAGT;EAAA,QAAA,KAAA;EAMS;EAAA,iBAHA,iBAAA;;mBAGA,SAAA;EAcH;EAAA,QAXN,WAAA;EAWN;;;;;;;;cAAA,SAAA,GAAY,KAAA,EAAO,CAAA,OAAQ,OAAA,QAC3B,iBAAA,uBACA,YAAA,sBACA,SAAA,UACA,OAAA;EAyCY;;AAAO;;;;EA1Bd,OAAA,CAAQ,IAAA,EAAM,CAAA;;;;UAcb,UAAA;;;;;UAYM,OAAA;AAAA"}
+{"version":3,"file":"queue.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/utils/queue.ts"],"mappings":";;AAKA;;;;cAAa,KAAA;EAqDU;EAAA,QAnDb,KAAA;EAmDc;EAAA,iBAhDL,OAAA;EAHT;EAAA,iBAMS,QAAA;EAAA;EAAA,iBAGA,SAAA;EAGT;EAAA,QAAA,KAAA;EAMS;EAAA,iBAHA,iBAAA;;mBAGA,SAAA;EAcH;EAAA,QAXN,WAAA;EAWN;;;;;;;;cAAA,SAAA,GAAY,KAAA,EAAO,CAAA,OAAQ,OAAA,QAC3B,iBAAA,uBACA,YAAA,sBACA,SAAA,UACA,OAAA;EAyCY;;AAAO;;;;EA1Bd,OAAA,CAAQ,IAAA,EAAM,CAAA;;;;UAcb,UAAA;;;;;UAYM,OAAA;AAAA"}

package/esm/utils/queue.mjs

@@ -1,4 +1,4 @@
-//#region ../../@warlock.js/core/src/utils/queue.ts
+//#region ../@warlock.js/core/src/utils/queue.ts
 /**
 * A utility class for managing a queue of operations.
 * Allows enqueuing values and executing a function when the queue reaches a certain size or after a specified interval.

package/esm/utils/queue.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"queue.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/utils/queue.ts"],"sourcesContent":["/**\n * A utility class for managing a queue of operations.\n * Allows enqueuing values and executing a function when the queue reaches a certain size or after a specified interval.\n * Supports both parallel and sequential execution of the queued operations.\n */\nexport class Queue<T> {\n  /** The items currently in the queue. */\n  private items: T[] = [];\n\n  /** The maximum size of the queue before triggering execution. */\n  private readonly maxSize?: number;\n\n  /** The interval in milliseconds after which the queue will be executed if not already triggered by size. */\n  private readonly interval: number;\n\n  /** The function to execute with the items in the queue. */\n  private readonly executeFn: (items: T[]) => Promise<void>;\n\n  /** Timer for managing the interval-based execution. */\n  private timer: NodeJS.Timeout | null = null;\n\n  /** Flag to determine if execution should be parallel or sequential. */\n  private readonly executeInParallel: boolean;\n\n  /** The batch size for processing items. */\n  private readonly batchSize: number;\n\n  /** Whether the current queue is busy executing */\n  private isExecuting = false;\n\n  /**\n   * Constructs a new Queue instance.\n   * @param executeFn - The function to execute with the items in the queue.\n   * @param maxSize - The maximum number of items before the queue is executed.\n   * @param executeEvery - The time in milliseconds after which the queue is executed if not already triggered.\n   * @param executeInParallel - Whether to execute the function in parallel or sequentially.\n   * @param batchSize - The number of items to process in each batch.\n   */\n  public constructor(\n    executeFn: (items: T[]) => Promise<void>,\n    executeInParallel: boolean = true,\n    executeEvery: number = 5000,\n    batchSize: number,\n    maxSize?: number,\n  ) {\n    this.executeFn = executeFn;\n    this.maxSize = maxSize;\n    this.interval = executeEvery;\n    this.executeInParallel = executeInParallel;\n    this.batchSize = batchSize;\n  }\n\n  /**\n   * Adds an item to the queue.\n   * Triggers execution if the queue reaches the maximum size.\n   * Starts a timer if not already running.\n   * @param item - The item to add to the queue.\n   */\n  public enqueue(item: T): void {\n    this.items.push(item);\n    if (this.maxSize && this.items.length >= this.maxSize) {\n      this.execute();\n    }\n\n    if (!this.timer) {\n      this.startTimer();\n    }\n  }\n\n  /**\n   * Starts a timer to execute the queue after the specified interval.\n   */\n  private startTimer(): void {\n    this.timer = setInterval(() => {\n      if (this.items.length > 0) {\n        this.execute();\n      }\n    }, this.interval);\n  }\n\n  /**\n   * Executes the function with the current items in the queue.\n   * Processes items in batches and resets the timer.\n   */\n  private async execute(): Promise<void> {\n    if (this.timer) {\n      clearInterval(this.timer);\n      this.timer = null;\n    }\n\n    this.isExecuting = true;\n\n    // Now there are couple scenarios:\n    // 1. Batch size has value, we need to check if its going to be executed in parallel or sequentially\n    // 2. Batch size is not provided, we will execute all items in a single call\n    if (this.batchSize) {\n      const itemsToProcess = this.items.splice(0, this.batchSize);\n      if (this.executeInParallel) {\n        await Promise.all(itemsToProcess.map(item => this.executeFn([item])));\n      } else {\n        for (const item of itemsToProcess) {\n          await this.executeFn([item]);\n        }\n      }\n    }\n\n    this.isExecuting = false;\n  }\n}\n"],"mappings":";;;;;;AAKA,IAAa,QAAb,MAAsB;;;;;;;;;CAiCpB,AAAO,YACL,WACA,oBAA6B,MAC7B,eAAuB,KACvB,WACA,SACA;eArCmB,CAAC;eAYiB;qBASjB;EAiBpB,KAAK,YAAY;EACjB,KAAK,UAAU;EACf,KAAK,WAAW;EAChB,KAAK,oBAAoB;EACzB,KAAK,YAAY;CACnB;;;;;;;CAQA,AAAO,QAAQ,MAAe;EAC5B,KAAK,MAAM,KAAK,IAAI;EACpB,IAAI,KAAK,WAAW,KAAK,MAAM,UAAU,KAAK,SAC5C,KAAK,QAAQ;EAGf,IAAI,CAAC,KAAK,OACR,KAAK,WAAW;CAEpB;;;;CAKA,AAAQ,aAAmB;EACzB,KAAK,QAAQ,kBAAkB;GAC7B,IAAI,KAAK,MAAM,SAAS,GACtB,KAAK,QAAQ;EAEjB,GAAG,KAAK,QAAQ;CAClB;;;;;CAMA,MAAc,UAAyB;EACrC,IAAI,KAAK,OAAO;GACd,cAAc,KAAK,KAAK;GACxB,KAAK,QAAQ;EACf;EAEA,KAAK,cAAc;EAKnB,IAAI,KAAK,WAAW;GAClB,MAAM,iBAAiB,KAAK,MAAM,OAAO,GAAG,KAAK,SAAS;GAC1D,IAAI,KAAK,mBACP,MAAM,QAAQ,IAAI,eAAe,KAAI,SAAQ,KAAK,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;QAEpE,KAAK,MAAM,QAAQ,gBACjB,MAAM,KAAK,UAAU,CAAC,IAAI,CAAC;EAGjC;EAEA,KAAK,cAAc;CACrB;AACF"}
+{"version":3,"file":"queue.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/utils/queue.ts"],"sourcesContent":["/**\n * A utility class for managing a queue of operations.\n * Allows enqueuing values and executing a function when the queue reaches a certain size or after a specified interval.\n * Supports both parallel and sequential execution of the queued operations.\n */\nexport class Queue<T> {\n  /** The items currently in the queue. */\n  private items: T[] = [];\n\n  /** The maximum size of the queue before triggering execution. */\n  private readonly maxSize?: number;\n\n  /** The interval in milliseconds after which the queue will be executed if not already triggered by size. */\n  private readonly interval: number;\n\n  /** The function to execute with the items in the queue. */\n  private readonly executeFn: (items: T[]) => Promise<void>;\n\n  /** Timer for managing the interval-based execution. */\n  private timer: NodeJS.Timeout | null = null;\n\n  /** Flag to determine if execution should be parallel or sequential. */\n  private readonly executeInParallel: boolean;\n\n  /** The batch size for processing items. */\n  private readonly batchSize: number;\n\n  /** Whether the current queue is busy executing */\n  private isExecuting = false;\n\n  /**\n   * Constructs a new Queue instance.\n   * @param executeFn - The function to execute with the items in the queue.\n   * @param maxSize - The maximum number of items before the queue is executed.\n   * @param executeEvery - The time in milliseconds after which the queue is executed if not already triggered.\n   * @param executeInParallel - Whether to execute the function in parallel or sequentially.\n   * @param batchSize - The number of items to process in each batch.\n   */\n  public constructor(\n    executeFn: (items: T[]) => Promise<void>,\n    executeInParallel: boolean = true,\n    executeEvery: number = 5000,\n    batchSize: number,\n    maxSize?: number,\n  ) {\n    this.executeFn = executeFn;\n    this.maxSize = maxSize;\n    this.interval = executeEvery;\n    this.executeInParallel = executeInParallel;\n    this.batchSize = batchSize;\n  }\n\n  /**\n   * Adds an item to the queue.\n   * Triggers execution if the queue reaches the maximum size.\n   * Starts a timer if not already running.\n   * @param item - The item to add to the queue.\n   */\n  public enqueue(item: T): void {\n    this.items.push(item);\n    if (this.maxSize && this.items.length >= this.maxSize) {\n      this.execute();\n    }\n\n    if (!this.timer) {\n      this.startTimer();\n    }\n  }\n\n  /**\n   * Starts a timer to execute the queue after the specified interval.\n   */\n  private startTimer(): void {\n    this.timer = setInterval(() => {\n      if (this.items.length > 0) {\n        this.execute();\n      }\n    }, this.interval);\n  }\n\n  /**\n   * Executes the function with the current items in the queue.\n   * Processes items in batches and resets the timer.\n   */\n  private async execute(): Promise<void> {\n    if (this.timer) {\n      clearInterval(this.timer);\n      this.timer = null;\n    }\n\n    this.isExecuting = true;\n\n    // Now there are couple scenarios:\n    // 1. Batch size has value, we need to check if its going to be executed in parallel or sequentially\n    // 2. Batch size is not provided, we will execute all items in a single call\n    if (this.batchSize) {\n      const itemsToProcess = this.items.splice(0, this.batchSize);\n      if (this.executeInParallel) {\n        await Promise.all(itemsToProcess.map(item => this.executeFn([item])));\n      } else {\n        for (const item of itemsToProcess) {\n          await this.executeFn([item]);\n        }\n      }\n    }\n\n    this.isExecuting = false;\n  }\n}\n"],"mappings":";;;;;;AAKA,IAAa,QAAb,MAAsB;;;;;;;;;CAiCpB,AAAO,YACL,WACA,oBAA6B,MAC7B,eAAuB,KACvB,WACA,SACA;eArCmB,CAAC;eAYiB;qBASjB;EAiBpB,KAAK,YAAY;EACjB,KAAK,UAAU;EACf,KAAK,WAAW;EAChB,KAAK,oBAAoB;EACzB,KAAK,YAAY;CACnB;;;;;;;CAQA,AAAO,QAAQ,MAAe;EAC5B,KAAK,MAAM,KAAK,IAAI;EACpB,IAAI,KAAK,WAAW,KAAK,MAAM,UAAU,KAAK,SAC5C,KAAK,QAAQ;EAGf,IAAI,CAAC,KAAK,OACR,KAAK,WAAW;CAEpB;;;;CAKA,AAAQ,aAAmB;EACzB,KAAK,QAAQ,kBAAkB;GAC7B,IAAI,KAAK,MAAM,SAAS,GACtB,KAAK,QAAQ;EAEjB,GAAG,KAAK,QAAQ;CAClB;;;;;CAMA,MAAc,UAAyB;EACrC,IAAI,KAAK,OAAO;GACd,cAAc,KAAK,KAAK;GACxB,KAAK,QAAQ;EACf;EAEA,KAAK,cAAc;EAKnB,IAAI,KAAK,WAAW;GAClB,MAAM,iBAAiB,KAAK,MAAM,OAAO,GAAG,KAAK,SAAS;GAC1D,IAAI,KAAK,mBACP,MAAM,QAAQ,IAAI,eAAe,KAAI,SAAQ,KAAK,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;QAEpE,KAAK,MAAM,QAAQ,gBACjB,MAAM,KAAK,UAAU,CAAC,IAAI,CAAC;EAGjC;EAEA,KAAK,cAAc;CACrB;AACF"}

package/esm/utils/sleep.d.mts

@@ -1,4 +1,4 @@
-//#region ../../@warlock.js/core/src/utils/sleep.d.ts
+//#region ../@warlock.js/core/src/utils/sleep.d.ts
 declare function sleep(ms: number): Promise<unknown>;
 //#endregion
 export { sleep };

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

@@ -1 +1 @@
-{"version":3,"file":"sleep.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/utils/sleep.ts"],"mappings":";iBAAgB,KAAA,CAAM,EAAA,WAAU,OAAA"}
+{"version":3,"file":"sleep.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/utils/sleep.ts"],"mappings":";iBAAgB,KAAA,CAAM,EAAA,WAAU,OAAA"}

package/esm/utils/sleep.mjs

@@ -1,4 +1,4 @@
-//#region ../../@warlock.js/core/src/utils/sleep.ts
+//#region ../@warlock.js/core/src/utils/sleep.ts
 function sleep(ms) {
 	return new Promise((resolve) => setTimeout(resolve, ms));
 }

package/esm/utils/sleep.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"sleep.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/utils/sleep.ts"],"sourcesContent":["export function sleep(ms: number) {\n  return new Promise(resolve => setTimeout(resolve, ms));\n}\n"],"mappings":";AAAA,SAAgB,MAAM,IAAY;CAChC,OAAO,IAAI,SAAQ,YAAW,WAAW,SAAS,EAAE,CAAC;AACvD"}
+{"version":3,"file":"sleep.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/utils/sleep.ts"],"sourcesContent":["export function sleep(ms: number) {\n  return new Promise(resolve => setTimeout(resolve, ms));\n}\n"],"mappings":";AAAA,SAAgB,MAAM,IAAY;CAChC,OAAO,IAAI,SAAQ,YAAW,WAAW,SAAS,EAAE,CAAC;AACvD"}

package/esm/utils/sluggable.d.mts

@@ -1,6 +1,6 @@
 import { Model } from "@warlock.js/cascade";
 
-//#region ../../@warlock.js/core/src/utils/sluggable.d.ts
+//#region ../@warlock.js/core/src/utils/sluggable.d.ts
 /**
  * Used for model castings
  */

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

@@ -1 +1 @@
-{"version":3,"file":"sluggable.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/utils/sluggable.ts"],"mappings":";;;;;AAMA;iBAAgB,SAAA,CAAU,YAAA,UAAsB,cAAA,aACtC,KAAA,EAAO,KAAK"}
+{"version":3,"file":"sluggable.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/utils/sluggable.ts"],"mappings":";;;;;AAMA;iBAAgB,SAAA,CAAU,YAAA,UAAsB,cAAA,aACtC,KAAA,EAAO,KAAK"}

package/esm/utils/sluggable.mjs

@@ -1,6 +1,6 @@
 import slug from "@mongez/slug";
 
-//#region ../../@warlock.js/core/src/utils/sluggable.ts
+//#region ../@warlock.js/core/src/utils/sluggable.ts
 /**
 * Used for model castings
 */

package/esm/utils/sluggable.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"sluggable.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/utils/sluggable.ts"],"sourcesContent":["import slug from \"@mongez/slug\";\nimport type { Model } from \"@warlock.js/cascade\";\n\n/**\n * Used for model castings\n */\nexport function sluggable(generateFrom: string, slugLocaleCode = \"en\") {\n  return (model: Model) => {\n    let value = model.get(generateFrom);\n\n    if (!value) return \"\";\n\n    if (Array.isArray(value)) {\n      value = (value as any[]).find((value) => value.localeCode === slugLocaleCode)?.value;\n    }\n\n    const slugFunction = (slug as any).default || slug;\n\n    return slugFunction(String(value));\n  };\n}\n"],"mappings":";;;;;;AAMA,SAAgB,UAAU,cAAsB,iBAAiB,MAAM;CACrE,QAAQ,UAAiB;EACvB,IAAI,QAAQ,MAAM,IAAI,YAAY;EAElC,IAAI,CAAC,OAAO,OAAO;EAEnB,IAAI,MAAM,QAAQ,KAAK,GACrB,QAAS,MAAgB,MAAM,UAAU,MAAM,eAAe,cAAc,GAAG;EAKjF,QAFsB,KAAa,WAAW,MAE1B,OAAO,KAAK,CAAC;CACnC;AACF"}
+{"version":3,"file":"sluggable.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/utils/sluggable.ts"],"sourcesContent":["import slug from \"@mongez/slug\";\nimport type { Model } from \"@warlock.js/cascade\";\n\n/**\n * Used for model castings\n */\nexport function sluggable(generateFrom: string, slugLocaleCode = \"en\") {\n  return (model: Model) => {\n    let value = model.get(generateFrom);\n\n    if (!value) return \"\";\n\n    if (Array.isArray(value)) {\n      value = (value as any[]).find((value) => value.localeCode === slugLocaleCode)?.value;\n    }\n\n    const slugFunction = (slug as any).default || slug;\n\n    return slugFunction(String(value));\n  };\n}\n"],"mappings":";;;;;;AAMA,SAAgB,UAAU,cAAsB,iBAAiB,MAAM;CACrE,QAAQ,UAAiB;EACvB,IAAI,QAAQ,MAAM,IAAI,YAAY;EAElC,IAAI,CAAC,OAAO,OAAO;EAEnB,IAAI,MAAM,QAAQ,KAAK,GACrB,QAAS,MAAgB,MAAM,UAAU,MAAM,eAAe,cAAc,CAAC,EAAE;EAKjF,QAFsB,KAAa,WAAW,KAE3B,CAAC,OAAO,KAAK,CAAC;CACnC;AACF"}

package/esm/utils/to-json.d.mts

@@ -1,4 +1,4 @@
-//#region ../../@warlock.js/core/src/utils/to-json.d.ts
+//#region ../@warlock.js/core/src/utils/to-json.d.ts
 declare function toJson(value: any): Promise<any>;
 //#endregion
 export { toJson };

package/esm/utils/to-json.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"to-json.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/utils/to-json.ts"],"mappings":";iBAEsB,MAAA,CAAO,KAAA,QAAa,OAAO"}
+{"version":3,"file":"to-json.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/utils/to-json.ts"],"mappings":";iBAEsB,MAAA,CAAO,KAAA,QAAa,OAAO"}

package/esm/utils/to-json.mjs

@@ -1,6 +1,6 @@
 import { isIterable, isPlainObject, isScalar } from "@mongez/supportive-is";
 
-//#region ../../@warlock.js/core/src/utils/to-json.ts
+//#region ../@warlock.js/core/src/utils/to-json.ts
 async function toJson(value) {
 	if (!value || isScalar(value)) return value;
 	if (value.toJSON) return await value.toJSON();