@warlock.js/core 5.29.0 → 5.31.0

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

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

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

@@ -1,6 +1,6 @@
 import { RegisteredUseCase, UseCaseResult } from "./types.mjs";
 
-//#region ../core/src/use-cases/use-cases-registry.d.ts
+//#region ../../packages/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":["../../../../../../../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;;;;;;;AAhBJ;iBA+B3B,UAAA,gBAA0B,IAAA,WACJ,iBAAA,CAAkB,MAAA,EAAQ,KAAA;;;;iBAMhD,WAAA,IAAW,GAAA,SAAA,iBAAA;AAP3B;;;AAAA,iBAcgB,2BAAA,CAA4B,IAAY;;;;iBAexC,0BAAA,CAA2B,IAAY;;;;;;iBA2BjC,iBAAA,CAAkB,IAAA,WAAe,OAAO,CAAC,aAAA;;AAvDM;AAMrE;;iBA+EsB,iBAAA,CAAkB,IAAA,UAAc,MAAA,EAAQ,aAAA,QAAkB,OAAA"}
+{"version":3,"file":"use-cases-registry.d.mts","names":[],"sources":["../../../../../../../../packages/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;;;;;;;AAhBJ;iBA+B3B,UAAA,gBAA0B,IAAA,WACJ,iBAAA,CAAkB,MAAA,EAAQ,KAAA;;;;iBAMhD,WAAA,IAAW,GAAA,SAAA,iBAAA;AAP3B;;;AAAA,iBAcgB,2BAAA,CAA4B,IAAY;;;;iBAexC,0BAAA,CAA2B,IAAY;;;;;;iBA2BjC,iBAAA,CAAkB,IAAA,WAAe,OAAO,CAAC,aAAA;;AAvDM;AAMrE;;iBA+EsB,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 ../core/src/use-cases/use-cases-registry.ts
+//#region ../../packages/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":["../../../../../../../core/src/use-cases/use-cases-registry.ts"],"sourcesContent":["import { cache } from \"@warlock.js/cache\";\nimport { log } from \"@warlock.js/logger\";\nimport { config } from \"../config\";\nimport { type RegisteredUseCase, type UseCaseConfigurations, type UseCaseResult } from \"./types\";\n\n/**\n * Store registered use cases\n */\nconst useCaseRegister = new Map<string, RegisteredUseCase>();\n\n/**\n * Register a use case\n */\nexport function $registerUseCase<Output, Input>(\n  name: string,\n  useCase: RegisteredUseCase<Output, Input>,\n) {\n  if (useCaseRegister.has(name) && process.env.NODE_ENV !== \"production\") {\n    log.warn(\"use-cases\", \"registering\", `Use case \"${name}\" is already registered. Overwriting.`);\n  }\n\n  useCaseRegister.set(name, useCase);\n}\n\n/**\n * Unregister a use case.\n *\n * Dropping the history namespace is best-effort: `$cleanup` is synchronous, so the\n * async cache removal is fire-and-forget with a `.catch` guard — a rejecting cache\n * driver must never turn cleanup into an unhandled rejection.\n */\nexport function $unregisterUseCase(name: string) {\n  useCaseRegister.delete(name);\n\n  Promise.resolve(cache.removeNamespace(`use-case:history:${name}`)).catch((error) => {\n    log.error(\"use-cases\", name, \"history namespace removal failed\", { error });\n  });\n}\n\n/**\n * Get a use case.\n *\n * Returns the `RegisteredUseCase` shape — including the runtime `calls` counters\n * the registry actually stores — so consumers can read call stats without an\n * ad-hoc cast.\n */\nexport function getUseCase<Output, Input>(name: string) {\n  return useCaseRegister.get(name) as RegisteredUseCase<Output, Input> | undefined;\n}\n\n/**\n * Get all use cases\n */\nexport function getUseCases() {\n  return useCaseRegister;\n}\n\n/**\n * Increase use case success calls\n */\nexport function increaseUseCaseSuccessCalls(name: string): number {\n  const useCase = useCaseRegister.get(name);\n  if (useCase) {\n    useCase.calls.success++;\n    useCase.calls.total++;\n\n    return useCase.calls.success;\n  }\n\n  return 0;\n}\n\n/**\n * Increase use case failed calls\n */\nexport function increaseUseCaseFailedCalls(name: string): number {\n  const useCase = useCaseRegister.get(name);\n  if (useCase) {\n    useCase.calls.failed++;\n    useCase.calls.total++;\n\n    return useCase.calls.failed;\n  }\n\n  return 0;\n}\n\n/**\n * Resolve the history cache TTL (seconds) from config.\n * `false` means \"use the cache driver's default\", represented as `undefined`.\n */\nfunction resolveHistoryTtl(useCaseConfig?: UseCaseConfigurations): number | undefined {\n  const ttlConfig = useCaseConfig?.history?.ttl ?? 3600; // 1 hour default\n\n  return ttlConfig === false ? undefined : ttlConfig;\n}\n\n/**\n * Get use case history from cache.\n *\n * Prunes ids whose entries have expired so the list can't accumulate dead refs.\n */\nexport async function getUseCaseHistory(name: string): Promise<UseCaseResult<any>[]> {\n  const listKey = `use-case:history:${name}:list`;\n  const ids = (await cache.get<string[]>(listKey)) || [];\n\n  const entries = await Promise.all(\n    ids.map(async (id: string) => ({\n      id,\n      result: await cache.get<UseCaseResult<any>>(`use-case:history:${name}:${id}`),\n    })),\n  );\n\n  const liveEntries = entries.filter((entry) => Boolean(entry.result));\n\n  if (liveEntries.length !== ids.length) {\n    const useCaseConfig = config.get<UseCaseConfigurations>(\"use-cases\");\n\n    await cache.set(\n      listKey,\n      liveEntries.map((entry) => entry.id),\n      resolveHistoryTtl(useCaseConfig),\n    );\n  }\n\n  return liveEntries.map((entry) => entry.result) as UseCaseResult<any>[];\n}\n\n/**\n * Add use case history to cache, capping the per-use-case list so it can't grow\n * unbounded — oldest entries (and their ids) are evicted past MAX_HISTORY_ENTRIES.\n */\nexport async function addUseCaseHistory(name: string, result: UseCaseResult<any>) {\n  const useCaseConfig = config.get<UseCaseConfigurations>(\"use-cases\");\n\n  // On by default outside production; opt in to production with `history.enabled: true`.\n  const enabled = useCaseConfig?.history?.enabled ?? process.env.NODE_ENV !== \"production\";\n\n  if (!enabled) return;\n\n  const previous = historyWrites.get(name) ?? Promise.resolve();\n  const current = previous.catch(() => undefined).then(() => writeHistory(name, result));\n\n  historyWrites.set(name, current);\n\n  try {\n    await current;\n  } finally {\n    if (historyWrites.get(name) === current) {\n      historyWrites.delete(name);\n    }\n  }\n}\n\n/**\n * Per-use-case write chain so the list read-modify-write never interleaves\n * within a process (keeps the cap enforced under concurrency).\n */\nconst historyWrites = new Map<string, Promise<unknown>>();\n\nasync function writeHistory(name: string, result: UseCaseResult<any>) {\n  const useCaseConfig = config.get<UseCaseConfigurations>(\"use-cases\");\n  const ttl = resolveHistoryTtl(useCaseConfig);\n  const maxEntries = useCaseConfig?.history?.maxEntries ?? 100;\n  const key = `use-case:history:${name}:${result.id}`;\n  const listKey = `use-case:history:${name}:list`;\n\n  // Store a projection only: `output` and `ctx` (tokens, payloads) never reach the cache.\n  const projection = { ...result, output: undefined, ctx: undefined } as unknown as UseCaseResult<any>;\n\n  await cache.set(key, projection, ttl);\n\n  const list = (await cache.get<string[]>(listKey)) || [];\n\n  list.push(result.id);\n\n  while (list.length > maxEntries) {\n    const evictedId = list.shift();\n\n    if (evictedId) {\n      await cache.remove(`use-case:history:${name}:${evictedId}`);\n    }\n  }\n\n  await cache.set(listKey, list, ttl);\n}\n"],"mappings":"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"}
+{"version":3,"file":"use-cases-registry.mjs","names":[],"sources":["../../../../../../../../packages/core/src/use-cases/use-cases-registry.ts"],"sourcesContent":["import { cache } from \"@warlock.js/cache\";\nimport { log } from \"@warlock.js/logger\";\nimport { config } from \"../config\";\nimport { type RegisteredUseCase, type UseCaseConfigurations, type UseCaseResult } from \"./types\";\n\n/**\n * Store registered use cases\n */\nconst useCaseRegister = new Map<string, RegisteredUseCase>();\n\n/**\n * Register a use case\n */\nexport function $registerUseCase<Output, Input>(\n  name: string,\n  useCase: RegisteredUseCase<Output, Input>,\n) {\n  if (useCaseRegister.has(name) && process.env.NODE_ENV !== \"production\") {\n    log.warn(\"use-cases\", \"registering\", `Use case \"${name}\" is already registered. Overwriting.`);\n  }\n\n  useCaseRegister.set(name, useCase);\n}\n\n/**\n * Unregister a use case.\n *\n * Dropping the history namespace is best-effort: `$cleanup` is synchronous, so the\n * async cache removal is fire-and-forget with a `.catch` guard — a rejecting cache\n * driver must never turn cleanup into an unhandled rejection.\n */\nexport function $unregisterUseCase(name: string) {\n  useCaseRegister.delete(name);\n\n  Promise.resolve(cache.removeNamespace(`use-case:history:${name}`)).catch((error) => {\n    log.error(\"use-cases\", name, \"history namespace removal failed\", { error });\n  });\n}\n\n/**\n * Get a use case.\n *\n * Returns the `RegisteredUseCase` shape — including the runtime `calls` counters\n * the registry actually stores — so consumers can read call stats without an\n * ad-hoc cast.\n */\nexport function getUseCase<Output, Input>(name: string) {\n  return useCaseRegister.get(name) as RegisteredUseCase<Output, Input> | undefined;\n}\n\n/**\n * Get all use cases\n */\nexport function getUseCases() {\n  return useCaseRegister;\n}\n\n/**\n * Increase use case success calls\n */\nexport function increaseUseCaseSuccessCalls(name: string): number {\n  const useCase = useCaseRegister.get(name);\n  if (useCase) {\n    useCase.calls.success++;\n    useCase.calls.total++;\n\n    return useCase.calls.success;\n  }\n\n  return 0;\n}\n\n/**\n * Increase use case failed calls\n */\nexport function increaseUseCaseFailedCalls(name: string): number {\n  const useCase = useCaseRegister.get(name);\n  if (useCase) {\n    useCase.calls.failed++;\n    useCase.calls.total++;\n\n    return useCase.calls.failed;\n  }\n\n  return 0;\n}\n\n/**\n * Resolve the history cache TTL (seconds) from config.\n * `false` means \"use the cache driver's default\", represented as `undefined`.\n */\nfunction resolveHistoryTtl(useCaseConfig?: UseCaseConfigurations): number | undefined {\n  const ttlConfig = useCaseConfig?.history?.ttl ?? 3600; // 1 hour default\n\n  return ttlConfig === false ? undefined : ttlConfig;\n}\n\n/**\n * Get use case history from cache.\n *\n * Prunes ids whose entries have expired so the list can't accumulate dead refs.\n */\nexport async function getUseCaseHistory(name: string): Promise<UseCaseResult<any>[]> {\n  const listKey = `use-case:history:${name}:list`;\n  const ids = (await cache.get<string[]>(listKey)) || [];\n\n  const entries = await Promise.all(\n    ids.map(async (id: string) => ({\n      id,\n      result: await cache.get<UseCaseResult<any>>(`use-case:history:${name}:${id}`),\n    })),\n  );\n\n  const liveEntries = entries.filter((entry) => Boolean(entry.result));\n\n  if (liveEntries.length !== ids.length) {\n    const useCaseConfig = config.get<UseCaseConfigurations>(\"use-cases\");\n\n    await cache.set(\n      listKey,\n      liveEntries.map((entry) => entry.id),\n      resolveHistoryTtl(useCaseConfig),\n    );\n  }\n\n  return liveEntries.map((entry) => entry.result) as UseCaseResult<any>[];\n}\n\n/**\n * Add use case history to cache, capping the per-use-case list so it can't grow\n * unbounded — oldest entries (and their ids) are evicted past MAX_HISTORY_ENTRIES.\n */\nexport async function addUseCaseHistory(name: string, result: UseCaseResult<any>) {\n  const useCaseConfig = config.get<UseCaseConfigurations>(\"use-cases\");\n\n  // On by default outside production; opt in to production with `history.enabled: true`.\n  const enabled = useCaseConfig?.history?.enabled ?? process.env.NODE_ENV !== \"production\";\n\n  if (!enabled) return;\n\n  const previous = historyWrites.get(name) ?? Promise.resolve();\n  const current = previous.catch(() => undefined).then(() => writeHistory(name, result));\n\n  historyWrites.set(name, current);\n\n  try {\n    await current;\n  } finally {\n    if (historyWrites.get(name) === current) {\n      historyWrites.delete(name);\n    }\n  }\n}\n\n/**\n * Per-use-case write chain so the list read-modify-write never interleaves\n * within a process (keeps the cap enforced under concurrency).\n */\nconst historyWrites = new Map<string, Promise<unknown>>();\n\nasync function writeHistory(name: string, result: UseCaseResult<any>) {\n  const useCaseConfig = config.get<UseCaseConfigurations>(\"use-cases\");\n  const ttl = resolveHistoryTtl(useCaseConfig);\n  const maxEntries = useCaseConfig?.history?.maxEntries ?? 100;\n  const key = `use-case:history:${name}:${result.id}`;\n  const listKey = `use-case:history:${name}:list`;\n\n  // Store a projection only: `output` and `ctx` (tokens, payloads) never reach the cache.\n  const projection = {\n    ...result,\n    output: undefined,\n    ctx: undefined,\n  } as unknown as UseCaseResult<any>;\n\n  await cache.set(key, projection, ttl);\n\n  const list = (await cache.get<string[]>(listKey)) || [];\n\n  list.push(result.id);\n\n  while (list.length > maxEntries) {\n    const evictedId = list.shift();\n\n    if (evictedId) {\n      await cache.remove(`use-case:history:${name}:${evictedId}`);\n    }\n  }\n\n  await cache.set(listKey, list, ttl);\n}\n"],"mappings":"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"}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"app-log.d.mts","names":[],"sources":["../../../../../../../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":["../../../../../../../../packages/core/src/utils/app-log.ts"],"mappings":";cAEa,MAAA;yBACU,OAAA,0CAAiB,MAAA;0BAChB,OAAA,0CAAiB,MAAA;yBAClB,OAAA,0CAAiB,MAAA;0BAChB,OAAA,0CAAiB,MAAA;4BACf,OAAA,0CAAiB,MAAA;AAAA"}

package/esm/utils/app-log.mjs

@@ -1,6 +1,6 @@
 import { log } from "@warlock.js/logger";
 
-//#region ../core/src/utils/app-log.ts
+//#region ../../packages/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":["../../../../../../../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) => 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,YAAoB,IAAI,QAAQ,OAAO,QAAQ,OAAO;AAClF"}
+{"version":3,"file":"app-log.mjs","names":[],"sources":["../../../../../../../../packages/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) => 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,YAAoB,IAAI,QAAQ,OAAO,QAAQ,OAAO;AAClF"}

package/esm/utils/clock.d.mts

@@ -0,0 +1,33 @@
+//#region ../../packages/core/src/utils/clock.d.ts
+/**
+ * The application clock.
+ *
+ * Read the current time through `clock` instead of `new Date()` / `Date.now()`
+ * where a test needs to control it: tokens that expire, "created 5 minutes
+ * ago", scheduled cut-offs. In the test environment the test kit swaps the
+ * source for a frozen one (`clockFake` from `@warlock.js/core/tests`); in
+ * every other environment it is the system clock.
+ *
+ * Only code that reads `clock` is affected — the global `Date` and timers are
+ * never patched, so a fake clock cannot stall `setTimeout` or a driver.
+ *
+ * @example
+ * import { clock } from "@warlock.js/core";
+ *
+ * const expiresAt = new Date(clock.timestamp() + 15 * 60_000);
+ */
+type ClockSource = {
+  /** Milliseconds since the Unix epoch. */now(): number;
+};
+declare const clock: {
+  /** The current time as a `Date`. */now(): Date; /** The current time in milliseconds since the Unix epoch. */
+  timestamp(): number;
+};
+/**
+ * Replace the clock's source, or restore the system clock with `undefined`.
+ * The test kit's `clockFake` is built on this.
+ */
+declare function setClockSource(next: ClockSource | undefined): void;
+//#endregion
+export { ClockSource, clock, setClockSource };
+//# sourceMappingURL=clock.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clock.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/utils/clock.ts"],"mappings":";;AAiBA;;;;AAEK;AAeL;;;;;;;;;AAgBA;;KAjCY,WAAA;EAiCyB,yCA/BnC,GAAG;AAAA;AAAA,cAeQ,KAAA;6CAEJ,IAAI;;;;;;;iBAcG,cAAA,CAAe,IAA6B,EAAvB,WAAW"}

package/esm/utils/clock.mjs

@@ -0,0 +1,27 @@
+//#region ../../packages/core/src/utils/clock.ts
+const systemClock = { now: () => Date.now() };
+const SOURCE_KEY = Symbol.for("warlock.core.clockSource");
+function source() {
+	return globalThis[SOURCE_KEY] ?? systemClock;
+}
+const clock = {
+	/** The current time as a `Date`. */
+	now() {
+		return new Date(source().now());
+	},
+	/** The current time in milliseconds since the Unix epoch. */
+	timestamp() {
+		return source().now();
+	}
+};
+/**
+* Replace the clock's source, or restore the system clock with `undefined`.
+* The test kit's `clockFake` is built on this.
+*/
+function setClockSource(next) {
+	globalThis[SOURCE_KEY] = next;
+}
+
+//#endregion
+export { clock, setClockSource };
+//# sourceMappingURL=clock.mjs.map

package/esm/utils/clock.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.mjs","names":[],"sources":["../../../../../../../../packages/core/src/utils/clock.ts"],"sourcesContent":["/**\n * The application clock.\n *\n * Read the current time through `clock` instead of `new Date()` / `Date.now()`\n * where a test needs to control it: tokens that expire, \"created 5 minutes\n * ago\", scheduled cut-offs. In the test environment the test kit swaps the\n * source for a frozen one (`clockFake` from `@warlock.js/core/tests`); in\n * every other environment it is the system clock.\n *\n * Only code that reads `clock` is affected — the global `Date` and timers are\n * never patched, so a fake clock cannot stall `setTimeout` or a driver.\n *\n * @example\n * import { clock } from \"@warlock.js/core\";\n *\n * const expiresAt = new Date(clock.timestamp() + 15 * 60_000);\n */\nexport type ClockSource = {\n  /** Milliseconds since the Unix epoch. */\n  now(): number;\n};\n\nconst systemClock: ClockSource = { now: () => Date.now() };\n\n// On `globalThis` so the framework loaded twice in one Vitest worker (native\n// and through vite-node) still reads one source.\nconst SOURCE_KEY = Symbol.for(\"warlock.core.clockSource\");\n\ntype SourceHolder = { [SOURCE_KEY]?: ClockSource };\n\nfunction source(): ClockSource {\n  return (globalThis as SourceHolder)[SOURCE_KEY] ?? systemClock;\n}\n\nexport const clock = {\n  /** The current time as a `Date`. */\n  now(): Date {\n    return new Date(source().now());\n  },\n\n  /** The current time in milliseconds since the Unix epoch. */\n  timestamp(): number {\n    return source().now();\n  },\n};\n\n/**\n * Replace the clock's source, or restore the system clock with `undefined`.\n * The test kit's `clockFake` is built on this.\n */\nexport function setClockSource(next: ClockSource | undefined): void {\n  (globalThis as SourceHolder)[SOURCE_KEY] = next;\n}\n"],"mappings":";AAsBA,MAAM,cAA2B,EAAE,WAAW,KAAK,IAAI,EAAE;AAIzD,MAAM,aAAa,OAAO,IAAI,0BAA0B;AAIxD,SAAS,SAAsB;CAC7B,OAAQ,WAA4B,eAAe;AACrD;AAEA,MAAa,QAAQ;;CAEnB,MAAY;EACV,OAAO,IAAI,KAAK,OAAO,CAAC,CAAC,IAAI,CAAC;CAChC;;CAGA,YAAoB;EAClB,OAAO,OAAO,CAAC,CAAC,IAAI;CACtB;AACF;;;;;AAMA,SAAgB,eAAe,MAAqC;CAClE,AAAC,WAA4B,cAAc;AAC7C"}

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 ../core/src/utils/database-log.d.ts
+//#region ../../packages/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":["../../../../../../../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"}
+{"version":3,"file":"database-log.d.mts","names":[],"sources":["../../../../../../../../packages/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 ../core/src/utils/database-log.ts
+//#region ../../packages/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":["../../../../../../../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    }\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;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":["../../../../../../../../packages/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    }\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;EAEA,IAAI;GACF,MAAM,KAAK,MAAM,OAAO,IAAI;EAC9B,SAAS,OAAO;GACd,QAAQ,IAAI,SAAS,KAAK;EAC5B;CACF;AACF"}

package/esm/utils/detect-environment-overrides.mjs

@@ -1,6 +1,6 @@
 import { existsSync, readFileSync } from "node:fs";
 
-//#region ../core/src/utils/detect-environment-overrides.ts
+//#region ../../packages/core/src/utils/detect-environment-overrides.ts
 /**
 * Minimal `KEY=VALUE` line parser: `#` comments, blank lines, and one layer
 * of surrounding quotes.

package/esm/utils/detect-environment-overrides.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"detect-environment-overrides.mjs","names":[],"sources":["../../../../../../../core/src/utils/detect-environment-overrides.ts"],"sourcesContent":["import { existsSync, readFileSync } from \"node:fs\";\n\n/**\n * One `.env` key whose file value lost to an ambient `process.env` value that\n * was already set before the file was read.\n */\nexport type EnvironmentOverride = {\n  key: string;\n  effectiveValue: string;\n  fileValue: string;\n};\n\n/**\n * Minimal `KEY=VALUE` line parser: `#` comments, blank lines, and one layer\n * of surrounding quotes.\n *\n * Deliberately NOT `@mongez/dotenv`'s own `parseLine` / `parseValue`: those\n * live in the same module as `loadEnv`, and `tests/unit/utils/load-environment.test.ts`\n * replaces that whole module with `vi.mock(\"@mongez/dotenv\", () => ({ loadEnv:\n * ... }))`. Importing any other named export from `@mongez/dotenv` here would\n * resolve to `undefined` under that mock and crash detection during those\n * tests. Comments, blank lines and a surrounding quote pair are the entire\n * feature set this comparison needs — the actual load still goes through the\n * real `@mongez/dotenv` parser via `loadEnv()`.\n */\nfunction parseEnvLine(line: string): [string, string] | undefined {\n  const trimmed = line.trim();\n\n  if (!trimmed || trimmed.startsWith(\"#\") || !trimmed.includes(\"=\")) {\n    return undefined;\n  }\n\n  const separatorIndex = trimmed.indexOf(\"=\");\n  const key = trimmed.slice(0, separatorIndex).trim();\n  let value = trimmed.slice(separatorIndex + 1).trim();\n\n  const quote = value[0];\n\n  if (\n    (quote === '\"' || quote === \"'\" || quote === \"`\") &&\n    value.length > 1 &&\n    value.endsWith(quote)\n  ) {\n    value = value.slice(1, -1);\n  }\n\n  return [key, value];\n}\n\n/**\n * Which of the given `.env` files' keys lost to a value the ambient process\n * environment already carried.\n *\n * `snapshot` must be captured BEFORE `loadEnv()` runs: the loader writes into\n * `process.env` for every key the file supplies, so a snapshot taken\n * afterwards can no longer tell an ambient override from a value the loader\n * itself just wrote.\n *\n * `files` should be given in the same order `loadEnv()` actually reads them\n * (`.env.shared` first, then the applicable `.env`/`.env.<NODE_ENV>`), so a\n * key declared in more than one file resolves to the value the real loader\n * would have used absent any ambient override.\n */\nexport function detectEnvironmentOverrides(\n  files: string[],\n  snapshot: NodeJS.ProcessEnv,\n): EnvironmentOverride[] {\n  const fileValues = new Map<string, string>();\n\n  for (const file of files) {\n    if (!existsSync(file)) {\n      continue;\n    }\n\n    const lines = readFileSync(file, \"utf8\").split(/\\r\\n|\\n/);\n\n    for (const line of lines) {\n      const parsed = parseEnvLine(line);\n\n      if (!parsed) {\n        continue;\n      }\n\n      fileValues.set(parsed[0], parsed[1]);\n    }\n  }\n\n  const overrides: EnvironmentOverride[] = [];\n\n  for (const [key, fileValue] of fileValues) {\n    if (!Object.prototype.hasOwnProperty.call(snapshot, key)) {\n      continue;\n    }\n\n    const effectiveValue = snapshot[key] as string;\n\n    if (effectiveValue !== fileValue) {\n      overrides.push({ key, effectiveValue, fileValue });\n    }\n  }\n\n  return overrides;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAyBA,SAAS,aAAa,MAA4C;CAChE,MAAM,UAAU,KAAK,KAAK;CAE1B,IAAI,CAAC,WAAW,QAAQ,WAAW,GAAG,KAAK,CAAC,QAAQ,SAAS,GAAG,GAC9D;CAGF,MAAM,iBAAiB,QAAQ,QAAQ,GAAG;CAC1C,MAAM,MAAM,QAAQ,MAAM,GAAG,cAAc,CAAC,CAAC,KAAK;CAClD,IAAI,QAAQ,QAAQ,MAAM,iBAAiB,CAAC,CAAC,CAAC,KAAK;CAEnD,MAAM,QAAQ,MAAM;CAEpB,KACG,UAAU,QAAO,UAAU,OAAO,UAAU,QAC7C,MAAM,SAAS,KACf,MAAM,SAAS,KAAK,GAEpB,QAAQ,MAAM,MAAM,GAAG,EAAE;CAG3B,OAAO,CAAC,KAAK,KAAK;AACpB;;;;;;;;;;;;;;;AAgBA,SAAgB,2BACd,OACA,UACuB;CACvB,MAAM,6BAAa,IAAI,IAAoB;CAE3C,KAAK,MAAM,QAAQ,OAAO;EACxB,IAAI,CAAC,WAAW,IAAI,GAClB;EAGF,MAAM,QAAQ,aAAa,MAAM,MAAM,CAAC,CAAC,MAAM,SAAS;EAExD,KAAK,MAAM,QAAQ,OAAO;GACxB,MAAM,SAAS,aAAa,IAAI;GAEhC,IAAI,CAAC,QACH;GAGF,WAAW,IAAI,OAAO,IAAI,OAAO,EAAE;EACrC;CACF;CAEA,MAAM,YAAmC,CAAC;CAE1C,KAAK,MAAM,CAAC,KAAK,cAAc,YAAY;EACzC,IAAI,CAAC,OAAO,UAAU,eAAe,KAAK,UAAU,GAAG,GACrD;EAGF,MAAM,iBAAiB,SAAS;EAEhC,IAAI,mBAAmB,WACrB,UAAU,KAAK;GAAE;GAAK;GAAgB;EAAU,CAAC;CAErD;CAEA,OAAO;AACT"}
+{"version":3,"file":"detect-environment-overrides.mjs","names":[],"sources":["../../../../../../../../packages/core/src/utils/detect-environment-overrides.ts"],"sourcesContent":["import { existsSync, readFileSync } from \"node:fs\";\n\n/**\n * One `.env` key whose file value lost to an ambient `process.env` value that\n * was already set before the file was read.\n */\nexport type EnvironmentOverride = {\n  key: string;\n  effectiveValue: string;\n  fileValue: string;\n};\n\n/**\n * Minimal `KEY=VALUE` line parser: `#` comments, blank lines, and one layer\n * of surrounding quotes.\n *\n * Deliberately NOT `@mongez/dotenv`'s own `parseLine` / `parseValue`: those\n * live in the same module as `loadEnv`, and `tests/unit/utils/load-environment.test.ts`\n * replaces that whole module with `vi.mock(\"@mongez/dotenv\", () => ({ loadEnv:\n * ... }))`. Importing any other named export from `@mongez/dotenv` here would\n * resolve to `undefined` under that mock and crash detection during those\n * tests. Comments, blank lines and a surrounding quote pair are the entire\n * feature set this comparison needs — the actual load still goes through the\n * real `@mongez/dotenv` parser via `loadEnv()`.\n */\nfunction parseEnvLine(line: string): [string, string] | undefined {\n  const trimmed = line.trim();\n\n  if (!trimmed || trimmed.startsWith(\"#\") || !trimmed.includes(\"=\")) {\n    return undefined;\n  }\n\n  const separatorIndex = trimmed.indexOf(\"=\");\n  const key = trimmed.slice(0, separatorIndex).trim();\n  let value = trimmed.slice(separatorIndex + 1).trim();\n\n  const quote = value[0];\n\n  if (\n    (quote === '\"' || quote === \"'\" || quote === \"`\") &&\n    value.length > 1 &&\n    value.endsWith(quote)\n  ) {\n    value = value.slice(1, -1);\n  }\n\n  return [key, value];\n}\n\n/**\n * Which of the given `.env` files' keys lost to a value the ambient process\n * environment already carried.\n *\n * `snapshot` must be captured BEFORE `loadEnv()` runs: the loader writes into\n * `process.env` for every key the file supplies, so a snapshot taken\n * afterwards can no longer tell an ambient override from a value the loader\n * itself just wrote.\n *\n * `files` should be given in the same order `loadEnv()` actually reads them\n * (`.env.shared` first, then the applicable `.env`/`.env.<NODE_ENV>`), so a\n * key declared in more than one file resolves to the value the real loader\n * would have used absent any ambient override.\n */\nexport function detectEnvironmentOverrides(\n  files: string[],\n  snapshot: NodeJS.ProcessEnv,\n): EnvironmentOverride[] {\n  const fileValues = new Map<string, string>();\n\n  for (const file of files) {\n    if (!existsSync(file)) {\n      continue;\n    }\n\n    const lines = readFileSync(file, \"utf8\").split(/\\r\\n|\\n/);\n\n    for (const line of lines) {\n      const parsed = parseEnvLine(line);\n\n      if (!parsed) {\n        continue;\n      }\n\n      fileValues.set(parsed[0], parsed[1]);\n    }\n  }\n\n  const overrides: EnvironmentOverride[] = [];\n\n  for (const [key, fileValue] of fileValues) {\n    if (!Object.prototype.hasOwnProperty.call(snapshot, key)) {\n      continue;\n    }\n\n    const effectiveValue = snapshot[key] as string;\n\n    if (effectiveValue !== fileValue) {\n      overrides.push({ key, effectiveValue, fileValue });\n    }\n  }\n\n  return overrides;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAyBA,SAAS,aAAa,MAA4C;CAChE,MAAM,UAAU,KAAK,KAAK;CAE1B,IAAI,CAAC,WAAW,QAAQ,WAAW,GAAG,KAAK,CAAC,QAAQ,SAAS,GAAG,GAC9D;CAGF,MAAM,iBAAiB,QAAQ,QAAQ,GAAG;CAC1C,MAAM,MAAM,QAAQ,MAAM,GAAG,cAAc,CAAC,CAAC,KAAK;CAClD,IAAI,QAAQ,QAAQ,MAAM,iBAAiB,CAAC,CAAC,CAAC,KAAK;CAEnD,MAAM,QAAQ,MAAM;CAEpB,KACG,UAAU,QAAO,UAAU,OAAO,UAAU,QAC7C,MAAM,SAAS,KACf,MAAM,SAAS,KAAK,GAEpB,QAAQ,MAAM,MAAM,GAAG,EAAE;CAG3B,OAAO,CAAC,KAAK,KAAK;AACpB;;;;;;;;;;;;;;;AAgBA,SAAgB,2BACd,OACA,UACuB;CACvB,MAAM,6BAAa,IAAI,IAAoB;CAE3C,KAAK,MAAM,QAAQ,OAAO;EACxB,IAAI,CAAC,WAAW,IAAI,GAClB;EAGF,MAAM,QAAQ,aAAa,MAAM,MAAM,CAAC,CAAC,MAAM,SAAS;EAExD,KAAK,MAAM,QAAQ,OAAO;GACxB,MAAM,SAAS,aAAa,IAAI;GAEhC,IAAI,CAAC,QACH;GAGF,WAAW,IAAI,OAAO,IAAI,OAAO,EAAE;EACrC;CACF;CAEA,MAAM,YAAmC,CAAC;CAE1C,KAAK,MAAM,CAAC,KAAK,cAAc,YAAY;EACzC,IAAI,CAAC,OAAO,UAAU,eAAe,KAAK,UAAU,GAAG,GACrD;EAGF,MAAM,iBAAiB,SAAS;EAEhC,IAAI,mBAAmB,WACrB,UAAU,KAAK;GAAE;GAAK;GAAgB;EAAU,CAAC;CAErD;CAEA,OAAO;AACT"}

package/esm/utils/environment.d.mts

@@ -1,4 +1,4 @@
-//#region ../core/src/utils/environment.d.ts
+//#region ../../packages/core/src/utils/environment.d.ts
 type Environment = "development" | "production" | "test";
 /**
  * How the framework hosts your code — the dev server (watcher + HMR) or the

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

@@ -1 +1 @@
-{"version":3,"file":"environment.d.mts","names":[],"sources":["../../../../../../../core/src/utils/environment.ts"],"mappings":";KAAY,WAAA;AAAZ;;;;AAAA,KAMY,eAAA;AAAA,iBAEI,WAAA,IAAe,WAAW;AAAA,iBAI1B,cAAA,CAAe,GAAgB,EAAX,WAAW"}
+{"version":3,"file":"environment.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/utils/environment.ts"],"mappings":";KAAY,WAAA;AAAZ;;;;AAAA,KAMY,eAAA;AAAA,iBAEI,WAAA,IAAe,WAAW;AAAA,iBAI1B,cAAA,CAAe,GAAgB,EAAX,WAAW"}

package/esm/utils/environment.mjs

@@ -1,4 +1,4 @@
-//#region ../core/src/utils/environment.ts
+//#region ../../packages/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":["../../../../../../../core/src/utils/environment.ts"],"sourcesContent":["export type Environment = \"development\" | \"production\" | \"test\";\n\n/**\n * How the framework hosts your code — the dev server (watcher + HMR) or the\n * bundled production output. A separate axis from {@link Environment}.\n */\nexport type RuntimeStrategy = \"production\" | \"development\";\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":";AAQA,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":["../../../../../../../../packages/core/src/utils/environment.ts"],"sourcesContent":["export type Environment = \"development\" | \"production\" | \"test\";\n\n/**\n * How the framework hosts your code — the dev server (watcher + HMR) or the\n * bundled production output. A separate axis from {@link Environment}.\n */\nexport type RuntimeStrategy = \"production\" | \"development\";\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":";AAQA,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,7 +1,7 @@
 import path from "node:path";
 import { getJsonFileAsync } from "@warlock.js/fs";
 
-//#region ../core/src/utils/framework-vesion.ts
+//#region ../../packages/core/src/utils/framework-vesion.ts
 /**
 * Cached version string
 */
@@ -11,7 +11,7 @@ let cachedVersion = null;
 */
 async function getWarlockVersion() {
 	if (cachedVersion) return cachedVersion;
-	const version = (await getJsonFileAsync(path.join(import.meta.dirname, "./../../package.json"))).version.replace(/\^|\~/g, "");
+	const version = (await getJsonFileAsync(path.join(import.meta.dirname, "./../../package.json"))).version.replace(/\^|~/g, "");
 	cachedVersion = version;
 	return version;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"framework-vesion.mjs","names":[],"sources":["../../../../../../../core/src/utils/framework-vesion.ts"],"sourcesContent":["import { getJsonFileAsync } from \"@warlock.js/fs\";\nimport path from \"node:path\";\n\n/**\n * Cached version string\n */\nlet cachedVersion: string | null = null;\n\n/**\n * Get the framework version from package.json (cached)\n */\nexport async function getWarlockVersion(): Promise<string> {\n  if (cachedVersion) return cachedVersion;\n\n  const frameworkPackageJson = (await getJsonFileAsync(\n    path.join(import.meta.dirname, \"./../../package.json\"),\n  )) as { version: string };\n\n  const version = frameworkPackageJson.version.replace(/\\^|\\~/g, \"\");\n  cachedVersion = version;\n  return version;\n}\n\nexport function getFrameworkVersion(): string | null {\n  return cachedVersion;\n}\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,EAEoC,CAAC,QAAQ,QAAQ,UAAU,EAAE;CACjE,gBAAgB;CAChB,OAAO;AACT;AAEA,SAAgB,sBAAqC;CACnD,OAAO;AACT"}
+{"version":3,"file":"framework-vesion.mjs","names":[],"sources":["../../../../../../../../packages/core/src/utils/framework-vesion.ts"],"sourcesContent":["import { getJsonFileAsync } from \"@warlock.js/fs\";\nimport path from \"node:path\";\n\n/**\n * Cached version string\n */\nlet cachedVersion: string | null = null;\n\n/**\n * Get the framework version from package.json (cached)\n */\nexport async function getWarlockVersion(): Promise<string> {\n  if (cachedVersion) return cachedVersion;\n\n  const frameworkPackageJson = (await getJsonFileAsync(\n    path.join(import.meta.dirname, \"./../../package.json\"),\n  )) as { version: string };\n\n  const version = frameworkPackageJson.version.replace(/\\^|~/g, \"\");\n  cachedVersion = version;\n  return version;\n}\n\nexport function getFrameworkVersion(): string | null {\n  return cachedVersion;\n}\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,EAEoC,CAAC,QAAQ,QAAQ,SAAS,EAAE;CAChE,gBAAgB;CAChB,OAAO;AACT;AAEA,SAAgB,sBAAqC;CACnD,OAAO;AACT"}

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

@@ -1,4 +1,4 @@
-//#region ../core/src/utils/get-localized.d.ts
+//#region ../../packages/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":["../../../../../../../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":["../../../../../../../../packages/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 ../core/src/utils/get-localized.ts
+//#region ../../packages/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":["../../../../../../../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"}
+{"version":3,"file":"get-localized.mjs","names":[],"sources":["../../../../../../../../packages/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/ids.d.mts

@@ -0,0 +1,32 @@
+//#region ../../packages/core/src/utils/ids.d.ts
+/**
+ * Identifier generation the test kit can make deterministic.
+ *
+ * Generate ids through `ids` instead of calling `crypto.randomUUID()` directly
+ * where a test needs to predict them (a snapshot, a file name, a link). In the
+ * test environment `idsFake` from `@warlock.js/core/tests` replaces the source
+ * with a numbered sequence; in every other environment the values come from
+ * `node:crypto`.
+ *
+ * @example
+ * import { ids } from "@warlock.js/core";
+ *
+ * const reference = ids.uuid();
+ * const resetToken = ids.token(48);
+ */
+type IdsSource = {
+  /** A version 4 UUID. */uuid(): string; /** A URL-safe random string of exactly `length` characters. */
+  token(length: number): string;
+};
+declare const ids: {
+  /** A version 4 UUID. */uuid(): string; /** A URL-safe random string, 32 characters unless `length` says otherwise. */
+  token(length?: number): string;
+};
+/**
+ * Replace the id source, or restore `node:crypto` with `undefined`.
+ * The test kit's `idsFake` is built on this.
+ */
+declare function setIdsSource(next: IdsSource | undefined): void;
+//#endregion
+export { IdsSource, ids, setIdsSource };
+//# sourceMappingURL=ids.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/utils/ids.ts"],"mappings":";;AAiBA;;;;;;;;AAIsB;AAmBtB;;;;;KAvBY,SAAA;0BAEV,IAAA;EAEA,KAAA,CAAM,MAAA;AAAA;AAAA,cAmBK,GAAA;EAoBsB;;;;;;;iBAAnB,YAAA,CAAa,IAA2B,EAArB,SAAS"}

package/esm/utils/ids.mjs

@@ -0,0 +1,33 @@
+import { randomBytes, randomUUID } from "node:crypto";
+
+//#region ../../packages/core/src/utils/ids.ts
+const cryptoIds = {
+	uuid: () => randomUUID(),
+	token: (length) => randomBytes(Math.ceil(length * 3 / 4) + 1).toString("base64url").slice(0, length)
+};
+const SOURCE_KEY = Symbol.for("warlock.core.idsSource");
+function source() {
+	return globalThis[SOURCE_KEY] ?? cryptoIds;
+}
+const ids = {
+	/** A version 4 UUID. */
+	uuid() {
+		return source().uuid();
+	},
+	/** A URL-safe random string, 32 characters unless `length` says otherwise. */
+	token(length = 32) {
+		if (!Number.isInteger(length) || length < 1) throw new RangeError(`ids.token(length) needs a positive integer, got ${String(length)}.`);
+		return source().token(length);
+	}
+};
+/**
+* Replace the id source, or restore `node:crypto` with `undefined`.
+* The test kit's `idsFake` is built on this.
+*/
+function setIdsSource(next) {
+	globalThis[SOURCE_KEY] = next;
+}
+
+//#endregion
+export { ids, setIdsSource };
+//# sourceMappingURL=ids.mjs.map

package/esm/utils/ids.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.mjs","names":[],"sources":["../../../../../../../../packages/core/src/utils/ids.ts"],"sourcesContent":["import { randomBytes, randomUUID } from \"node:crypto\";\n\n/**\n * Identifier generation the test kit can make deterministic.\n *\n * Generate ids through `ids` instead of calling `crypto.randomUUID()` directly\n * where a test needs to predict them (a snapshot, a file name, a link). In the\n * test environment `idsFake` from `@warlock.js/core/tests` replaces the source\n * with a numbered sequence; in every other environment the values come from\n * `node:crypto`.\n *\n * @example\n * import { ids } from \"@warlock.js/core\";\n *\n * const reference = ids.uuid();\n * const resetToken = ids.token(48);\n */\nexport type IdsSource = {\n  /** A version 4 UUID. */\n  uuid(): string;\n  /** A URL-safe random string of exactly `length` characters. */\n  token(length: number): string;\n};\n\nconst cryptoIds: IdsSource = {\n  uuid: () => randomUUID(),\n  token: (length) =>\n    randomBytes(Math.ceil((length * 3) / 4) + 1)\n      .toString(\"base64url\")\n      .slice(0, length),\n};\n\nconst SOURCE_KEY = Symbol.for(\"warlock.core.idsSource\");\n\ntype SourceHolder = { [SOURCE_KEY]?: IdsSource };\n\nfunction source(): IdsSource {\n  return (globalThis as SourceHolder)[SOURCE_KEY] ?? cryptoIds;\n}\n\nexport const ids = {\n  /** A version 4 UUID. */\n  uuid(): string {\n    return source().uuid();\n  },\n\n  /** A URL-safe random string, 32 characters unless `length` says otherwise. */\n  token(length = 32): string {\n    if (!Number.isInteger(length) || length < 1) {\n      throw new RangeError(`ids.token(length) needs a positive integer, got ${String(length)}.`);\n    }\n\n    return source().token(length);\n  },\n};\n\n/**\n * Replace the id source, or restore `node:crypto` with `undefined`.\n * The test kit's `idsFake` is built on this.\n */\nexport function setIdsSource(next: IdsSource | undefined): void {\n  (globalThis as SourceHolder)[SOURCE_KEY] = next;\n}\n"],"mappings":";;;AAwBA,MAAM,YAAuB;CAC3B,YAAY,WAAW;CACvB,QAAQ,WACN,YAAY,KAAK,KAAM,SAAS,IAAK,CAAC,IAAI,CAAC,CAAC,CACzC,SAAS,WAAW,CAAC,CACrB,MAAM,GAAG,MAAM;AACtB;AAEA,MAAM,aAAa,OAAO,IAAI,wBAAwB;AAItD,SAAS,SAAoB;CAC3B,OAAQ,WAA4B,eAAe;AACrD;AAEA,MAAa,MAAM;;CAEjB,OAAe;EACb,OAAO,OAAO,CAAC,CAAC,KAAK;CACvB;;CAGA,MAAM,SAAS,IAAY;EACzB,IAAI,CAAC,OAAO,UAAU,MAAM,KAAK,SAAS,GACxC,MAAM,IAAI,WAAW,mDAAmD,OAAO,MAAM,EAAE,EAAE;EAG3F,OAAO,OAAO,CAAC,CAAC,MAAM,MAAM;CAC9B;AACF;;;;;AAMA,SAAgB,aAAa,MAAmC;CAC9D,AAAC,WAA4B,cAAc;AAC7C"}

package/esm/utils/index.d.mts

@@ -1,12 +1,15 @@
 import { LocalizedObject, getLocalized } from "./get-localized.mjs";
 import { Environment, RuntimeStrategy, environment, setEnvironment } from "./environment.mjs";
 import { appLog } from "./app-log.mjs";
+import { ClockSource, clock, setClockSource } from "./clock.mjs";
 import { DatabaseLog, DatabaseLogOptions } from "./database-log.mjs";
+import { IdsSource, ids, setIdsSource } from "./ids.mjs";
 import { Path } from "./normalized-path.mjs";
 import { fetchLatestVersion } from "./npm-registry.mjs";
 import { appPath, cachePath, configPath, logsPath, paths, publicPath, rootPath, sanitizePath, srcPath, storagePath, tempPath, uploadsPath, warlockPath } from "./paths.mjs";
 import { promiseAllObject } from "./promise-all-object.mjs";
 import { Queue } from "./queue.mjs";
+import { JavaScriptRuntime, JavaScriptRuntimeName, SUPPORTED_RUNTIMES_DOCS_URL, assertNodeOnlyCommand, describeJavaScriptRuntime, detectJavaScriptRuntime, nodeOnlyCommandError, unverifiedBuildRuntimeNotice } from "./runtime.mjs";
 import { sleep } from "./sleep.mjs";
 import { sluggable } from "./sluggable.mjs";
 import { toJson } from "./to-json.mjs";

package/esm/utils/index.mjs

@@ -1,12 +1,15 @@
 import { appLog } from "./app-log.mjs";
+import { clock, setClockSource } from "./clock.mjs";
 import { DatabaseLog } from "./database-log.mjs";
 import { environment, setEnvironment } from "./environment.mjs";
 import { getLocalized } from "./get-localized.mjs";
+import { ids, setIdsSource } from "./ids.mjs";
 import { Path } from "./normalized-path.mjs";
 import { fetchLatestVersion } from "./npm-registry.mjs";
 import { appPath, cachePath, configPath, logsPath, paths, publicPath, rootPath, sanitizePath, srcPath, storagePath, tempPath, uploadsPath, warlockPath } from "./paths.mjs";
 import { promiseAllObject } from "./promise-all-object.mjs";
 import { Queue } from "./queue.mjs";
+import { SUPPORTED_RUNTIMES_DOCS_URL, assertNodeOnlyCommand, describeJavaScriptRuntime, detectJavaScriptRuntime, nodeOnlyCommandError, unverifiedBuildRuntimeNotice } from "./runtime.mjs";
 import { sleep } from "./sleep.mjs";
 import { sluggable } from "./sluggable.mjs";
 import { toJson } from "./to-json.mjs";

package/esm/utils/is-test-file.mjs

@@ -1,4 +1,4 @@
-//#region ../core/src/utils/is-test-file.ts
+//#region ../../packages/core/src/utils/is-test-file.ts
 /** `foo.spec.ts`, `foo.test.tsx`, `foo.spec.mjs` … — a file only a test runner can load. */
 const TEST_FILE = /\.(spec|test)\.[cm]?[jt]sx?$/;
 /**

package/esm/utils/is-test-file.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"is-test-file.mjs","names":[],"sources":["../../../../../../../core/src/utils/is-test-file.ts"],"sourcesContent":["/** `foo.spec.ts`, `foo.test.tsx`, `foo.spec.mjs` … — a file only a test runner can load. */\nconst TEST_FILE = /\\.(spec|test)\\.[cm]?[jt]sx?$/;\n\n/**\n * Whether a path names a test file. Folder-scanning commands (`warlock seed`,\n * `warlock migrate`) skip these: a spec that sits beside the seeder it tests\n * calls `vi.mock()` at import time, which throws outside Vitest.\n */\nexport function isTestFile(filePath: string): boolean {\n  return TEST_FILE.test(filePath);\n}\n"],"mappings":";;AACA,MAAM,YAAY;;;;;;AAOlB,SAAgB,WAAW,UAA2B;CACpD,OAAO,UAAU,KAAK,QAAQ;AAChC"}
+{"version":3,"file":"is-test-file.mjs","names":[],"sources":["../../../../../../../../packages/core/src/utils/is-test-file.ts"],"sourcesContent":["/** `foo.spec.ts`, `foo.test.tsx`, `foo.spec.mjs` … — a file only a test runner can load. */\nconst TEST_FILE = /\\.(spec|test)\\.[cm]?[jt]sx?$/;\n\n/**\n * Whether a path names a test file. Folder-scanning commands (`warlock seed`,\n * `warlock migrate`) skip these: a spec that sits beside the seeder it tests\n * calls `vi.mock()` at import time, which throws outside Vitest.\n */\nexport function isTestFile(filePath: string): boolean {\n  return TEST_FILE.test(filePath);\n}\n"],"mappings":";;AACA,MAAM,YAAY;;;;;;AAOlB,SAAgB,WAAW,UAA2B;CACpD,OAAO,UAAU,KAAK,QAAQ;AAChC"}

package/esm/utils/load-environment.mjs

@@ -5,7 +5,7 @@ import { loadEnv } from "@mongez/dotenv";
 import path from "node:path";
 import { existsSync } from "node:fs";
 
-//#region ../core/src/utils/load-environment.ts
+//#region ../../packages/core/src/utils/load-environment.ts
 /**
 * Core's env precedence policy, in one place because two callers load env:
 * this module at boot, and the dev server when an `.env` file changes.

package/esm/utils/load-environment.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"load-environment.mjs","names":[],"sources":["../../../../../../../core/src/utils/load-environment.ts"],"sourcesContent":["import { loadEnv, type EnvLoaderOptions } from \"@mongez/dotenv\";\nimport { existsSync } from \"node:fs\";\nimport path from \"node:path\";\nimport { detectEnvironmentOverrides } from \"./detect-environment-overrides\";\nimport { recordEnvironmentOverrides } from \"./recorded-environment-overrides\";\nimport { reportEnvironmentOverrides } from \"./report-environment-overrides\";\n\n/**\n * Core's env precedence policy, in one place because two callers load env:\n * this module at boot, and the dev server when an `.env` file changes.\n *\n * `@mongez/dotenv` defaults to `precedence: \"file-wins\"`, which is backwards.\n * The `.env` file is a checked-in DEFAULT; a variable already exported into\n * `process.env` is the deliberate, situational override — a second instance on\n * another port, CI pointed at another database, a container's configuration.\n * Under the default, `PORT=6060 warlock dev` produced a server on the `.env`\n * file's 3000 and said nothing. A default that silently beats an explicit\n * instruction is the wrong way round, so core opts into `process-wins`:\n * the file supplies only the keys the environment does not already carry.\n *\n * EMPTY STRING — `FOO=` in the environment counts as SET, and wins, so the\n * file's value is discarded and `env(\"FOO\")` returns `\"\"`. Chosen over\n * \"empty means absent\" because the loader cannot tell a deliberate blanking\n * from an accident, and only one of the two readings is expressible: an\n * operator who wants the file's value can unset the variable, whereas under\n * \"empty means absent\" an operator who wants a blank value has no way to ask\n * for one. It also matches POSIX (an exported empty variable is set), dotenv,\n * dotenv-flow and Vite. Note the consequence: a blank export beats the second\n * argument too, so `env(\"FOO\", \"fallback\")` yields `\"\"`, not the fallback.\n *\n * Keys this loader itself wrote are tracked by the library and are NOT treated\n * as process-provided, so editing `.env` during a dev session still takes\n * effect on reload rather than being pinned by the previous load's own writes.\n */\nexport const environmentLoaderOptions: EnvLoaderOptions = {\n  precedence: \"process-wins\",\n};\n\n/**\n * The files `loadEnv()` will look for, in the order it considers them.\n *\n * Mirrors `@mongez/dotenv`'s own resolution — `.env.shared` first, then\n * `.env.<NODE_ENV>` if it exists, else plain `.env` — because the presence\n * check has to ask the same question the loader is about to ask.\n */\nfunction candidateEnvFiles(directory: string): string[] {\n  const files = [path.join(directory, \".env\"), path.join(directory, \".env.shared\")];\n\n  if (process.env.NODE_ENV) {\n    files.push(path.join(directory, `.env.${process.env.NODE_ENV}`));\n  }\n\n  return files;\n}\n\n/**\n * The files `loadEnv()` will actually read, in its own read order.\n *\n * Differs from {@link candidateEnvFiles}, which lists every candidate to\n * answer \"is there anything to load at all\". `loadEnv()` itself only ever\n * reads `.env.shared` (if present) plus ONE of `.env.<NODE_ENV>` /\n * `.env` — the NODE_ENV-specific file when it exists, `.env` otherwise —\n * never both. Override detection has to mirror that exactly, or a key\n * declared only in a file `loadEnv()` would not have touched could be\n * reported as having \"lost\" a comparison it was never actually part of.\n */\nfunction resolveLoadedEnvFiles(directory: string): string[] {\n  const files: string[] = [];\n  const sharedFile = path.join(directory, \".env.shared\");\n\n  if (existsSync(sharedFile)) {\n    files.push(sharedFile);\n  }\n\n  const nodeEnvFile = process.env.NODE_ENV\n    ? path.join(directory, `.env.${process.env.NODE_ENV}`)\n    : undefined;\n  const derivedFile =\n    nodeEnvFile && existsSync(nodeEnvFile) ? nodeEnvFile : path.join(directory, \".env\");\n\n  if (existsSync(derivedFile)) {\n    files.push(derivedFile);\n  }\n\n  return files;\n}\n\n/**\n * Whether this process has already loaded its env files.\n *\n * Two callers reach here on a bootstrapping command — the CLI preload phase and\n * `bootstrap()` — and `loadEnv()` defaults to `override: true`, so a second pass\n * re-parses the same files and re-writes `process.env`. Anything set in between\n * (a `warlock.config.ts` module body, a config file, an orchestrator) would be\n * silently clobbered by the later load. Same shape as the defect where a\n * caller's test-server port was overwritten by a re-read of `.env`.\n *\n * A deliberate reload is still possible and still used: the dev server calls\n * `loadEnv()` directly when an `.env` file changes on disk, which is a reload\n * the user asked for rather than an accidental second pass.\n */\nlet environmentLoaded = false;\n\n/**\n * Load `.env` files when there are any, and do nothing when there are not.\n *\n * Loads at most **once per process** — see {@link environmentLoaded}.\n *\n * `@mongez/dotenv`'s `loadEnvFile` **throws** when the file is absent. That was\n * survivable while only `dev` loaded env; now that every command loads it —\n * because `warlock.config.ts` calls `env()` in its module body and had been\n * evaluated against an empty store under every command — an unguarded call\n * would turn \"this project has no .env\" from a non-event into a hard failure\n * of `warlock build`. A project without a `.env` is legitimate: config files\n * carry defaults, and containers inject their own variables.\n *\n * The guard lives here rather than waiting on a fix in `@mongez/dotenv`: core\n * decides its own env policy and must not depend on another package's release\n * schedule to avoid crashing a working build.\n */\nexport async function loadEnvironmentFiles(directory: string = process.cwd()): Promise<void> {\n  if (environmentLoaded) {\n    return;\n  }\n\n  const hasEnvFile = candidateEnvFiles(directory).some((file) => existsSync(file));\n\n  if (!hasEnvFile) {\n    // Not latched: a project may create its `.env` between a command's preload\n    // and its bootstrap, and there is nothing to protect from a second override\n    // when the first pass loaded nothing.\n    return;\n  }\n\n  environmentLoaded = true;\n\n  // Snapshot BEFORE `loadEnv()` runs: the loader writes into `process.env` for\n  // every key its files supply, so a snapshot taken afterwards could no\n  // longer distinguish an ambient override from a value the loader itself\n  // just wrote — see `detectEnvironmentOverrides`.\n  const processEnvironmentSnapshot = { ...process.env };\n\n  // The precedence itself is correct (see `environmentLoaderOptions` above);\n  // the defect this guards against is the SILENCE — `.env` losing to an\n  // ambient value with no diagnostic at all.\n  const overrides = detectEnvironmentOverrides(\n    resolveLoadedEnvFiles(directory),\n    processEnvironmentSnapshot,\n  );\n\n  // Print the overrides here AND retain them: a later point in the boot (the\n  // port-collision reporter) needs to know an ambient `HTTP_PORT` beat `.env`\n  // to avoid advising a rebuild that the env var would just override again —\n  // see `recorded-environment-overrides.ts` (finding 8782b840).\n  recordEnvironmentOverrides(overrides);\n  reportEnvironmentOverrides(overrides);\n\n  // `dir` has to be forwarded: `loadEnv()` defaults it to `process.cwd()`, so\n  // without this the existence check above asks about `directory` while the\n  // load itself reads somewhere else entirely. Identical in production, where\n  // `directory` IS `process.cwd()`.\n  await loadEnv(undefined, { ...environmentLoaderOptions, dir: directory });\n}\n\n/**\n * Forget that env has been loaded, so the next call loads again.\n *\n * @internal For tests, which run many boots inside one process.\n */\nexport function resetLoadedEnvironment(): void {\n  environmentLoaded = false;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,MAAa,2BAA6C,EACxD,YAAY,eACd;;;;;;;;AASA,SAAS,kBAAkB,WAA6B;CACtD,MAAM,QAAQ,CAAC,KAAK,KAAK,WAAW,MAAM,GAAG,KAAK,KAAK,WAAW,aAAa,CAAC;CAEhF,IAAI,QAAQ,IAAI,UACd,MAAM,KAAK,KAAK,KAAK,WAAW,QAAQ,QAAQ,IAAI,UAAU,CAAC;CAGjE,OAAO;AACT;;;;;;;;;;;;AAaA,SAAS,sBAAsB,WAA6B;CAC1D,MAAM,QAAkB,CAAC;CACzB,MAAM,aAAa,KAAK,KAAK,WAAW,aAAa;CAErD,IAAI,WAAW,UAAU,GACvB,MAAM,KAAK,UAAU;CAGvB,MAAM,cAAc,QAAQ,IAAI,WAC5B,KAAK,KAAK,WAAW,QAAQ,QAAQ,IAAI,UAAU,IACnD;CACJ,MAAM,cACJ,eAAe,WAAW,WAAW,IAAI,cAAc,KAAK,KAAK,WAAW,MAAM;CAEpF,IAAI,WAAW,WAAW,GACxB,MAAM,KAAK,WAAW;CAGxB,OAAO;AACT;;;;;;;;;;;;;;;AAgBA,IAAI,oBAAoB;;;;;;;;;;;;;;;;;;AAmBxB,eAAsB,qBAAqB,YAAoB,QAAQ,IAAI,GAAkB;CAC3F,IAAI,mBACF;CAKF,IAAI,CAFe,kBAAkB,SAAS,CAAC,CAAC,MAAM,SAAS,WAAW,IAAI,CAEhE,GAIZ;CAGF,oBAAoB;CAMpB,MAAM,6BAA6B,EAAE,GAAG,QAAQ,IAAI;CAKpD,MAAM,YAAY,2BAChB,sBAAsB,SAAS,GAC/B,0BACF;CAMA,2BAA2B,SAAS;CACpC,2BAA2B,SAAS;CAMpC,MAAM,QAAQ,QAAW;EAAE,GAAG;EAA0B,KAAK;CAAU,CAAC;AAC1E"}
+{"version":3,"file":"load-environment.mjs","names":[],"sources":["../../../../../../../../packages/core/src/utils/load-environment.ts"],"sourcesContent":["import { loadEnv, type EnvLoaderOptions } from \"@mongez/dotenv\";\nimport { existsSync } from \"node:fs\";\nimport path from \"node:path\";\nimport { detectEnvironmentOverrides } from \"./detect-environment-overrides\";\nimport { recordEnvironmentOverrides } from \"./recorded-environment-overrides\";\nimport { reportEnvironmentOverrides } from \"./report-environment-overrides\";\n\n/**\n * Core's env precedence policy, in one place because two callers load env:\n * this module at boot, and the dev server when an `.env` file changes.\n *\n * `@mongez/dotenv` defaults to `precedence: \"file-wins\"`, which is backwards.\n * The `.env` file is a checked-in DEFAULT; a variable already exported into\n * `process.env` is the deliberate, situational override — a second instance on\n * another port, CI pointed at another database, a container's configuration.\n * Under the default, `PORT=6060 warlock dev` produced a server on the `.env`\n * file's 3000 and said nothing. A default that silently beats an explicit\n * instruction is the wrong way round, so core opts into `process-wins`:\n * the file supplies only the keys the environment does not already carry.\n *\n * EMPTY STRING — `FOO=` in the environment counts as SET, and wins, so the\n * file's value is discarded and `env(\"FOO\")` returns `\"\"`. Chosen over\n * \"empty means absent\" because the loader cannot tell a deliberate blanking\n * from an accident, and only one of the two readings is expressible: an\n * operator who wants the file's value can unset the variable, whereas under\n * \"empty means absent\" an operator who wants a blank value has no way to ask\n * for one. It also matches POSIX (an exported empty variable is set), dotenv,\n * dotenv-flow and Vite. Note the consequence: a blank export beats the second\n * argument too, so `env(\"FOO\", \"fallback\")` yields `\"\"`, not the fallback.\n *\n * Keys this loader itself wrote are tracked by the library and are NOT treated\n * as process-provided, so editing `.env` during a dev session still takes\n * effect on reload rather than being pinned by the previous load's own writes.\n */\nexport const environmentLoaderOptions: EnvLoaderOptions = {\n  precedence: \"process-wins\",\n};\n\n/**\n * The files `loadEnv()` will look for, in the order it considers them.\n *\n * Mirrors `@mongez/dotenv`'s own resolution — `.env.shared` first, then\n * `.env.<NODE_ENV>` if it exists, else plain `.env` — because the presence\n * check has to ask the same question the loader is about to ask.\n */\nfunction candidateEnvFiles(directory: string): string[] {\n  const files = [path.join(directory, \".env\"), path.join(directory, \".env.shared\")];\n\n  if (process.env.NODE_ENV) {\n    files.push(path.join(directory, `.env.${process.env.NODE_ENV}`));\n  }\n\n  return files;\n}\n\n/**\n * The files `loadEnv()` will actually read, in its own read order.\n *\n * Differs from {@link candidateEnvFiles}, which lists every candidate to\n * answer \"is there anything to load at all\". `loadEnv()` itself only ever\n * reads `.env.shared` (if present) plus ONE of `.env.<NODE_ENV>` /\n * `.env` — the NODE_ENV-specific file when it exists, `.env` otherwise —\n * never both. Override detection has to mirror that exactly, or a key\n * declared only in a file `loadEnv()` would not have touched could be\n * reported as having \"lost\" a comparison it was never actually part of.\n */\nfunction resolveLoadedEnvFiles(directory: string): string[] {\n  const files: string[] = [];\n  const sharedFile = path.join(directory, \".env.shared\");\n\n  if (existsSync(sharedFile)) {\n    files.push(sharedFile);\n  }\n\n  const nodeEnvFile = process.env.NODE_ENV\n    ? path.join(directory, `.env.${process.env.NODE_ENV}`)\n    : undefined;\n  const derivedFile =\n    nodeEnvFile && existsSync(nodeEnvFile) ? nodeEnvFile : path.join(directory, \".env\");\n\n  if (existsSync(derivedFile)) {\n    files.push(derivedFile);\n  }\n\n  return files;\n}\n\n/**\n * Whether this process has already loaded its env files.\n *\n * Two callers reach here on a bootstrapping command — the CLI preload phase and\n * `bootstrap()` — and `loadEnv()` defaults to `override: true`, so a second pass\n * re-parses the same files and re-writes `process.env`. Anything set in between\n * (a `warlock.config.ts` module body, a config file, an orchestrator) would be\n * silently clobbered by the later load. Same shape as the defect where a\n * caller's test-server port was overwritten by a re-read of `.env`.\n *\n * A deliberate reload is still possible and still used: the dev server calls\n * `loadEnv()` directly when an `.env` file changes on disk, which is a reload\n * the user asked for rather than an accidental second pass.\n */\nlet environmentLoaded = false;\n\n/**\n * Load `.env` files when there are any, and do nothing when there are not.\n *\n * Loads at most **once per process** — see {@link environmentLoaded}.\n *\n * `@mongez/dotenv`'s `loadEnvFile` **throws** when the file is absent. That was\n * survivable while only `dev` loaded env; now that every command loads it —\n * because `warlock.config.ts` calls `env()` in its module body and had been\n * evaluated against an empty store under every command — an unguarded call\n * would turn \"this project has no .env\" from a non-event into a hard failure\n * of `warlock build`. A project without a `.env` is legitimate: config files\n * carry defaults, and containers inject their own variables.\n *\n * The guard lives here rather than waiting on a fix in `@mongez/dotenv`: core\n * decides its own env policy and must not depend on another package's release\n * schedule to avoid crashing a working build.\n */\nexport async function loadEnvironmentFiles(directory: string = process.cwd()): Promise<void> {\n  if (environmentLoaded) {\n    return;\n  }\n\n  const hasEnvFile = candidateEnvFiles(directory).some((file) => existsSync(file));\n\n  if (!hasEnvFile) {\n    // Not latched: a project may create its `.env` between a command's preload\n    // and its bootstrap, and there is nothing to protect from a second override\n    // when the first pass loaded nothing.\n    return;\n  }\n\n  environmentLoaded = true;\n\n  // Snapshot BEFORE `loadEnv()` runs: the loader writes into `process.env` for\n  // every key its files supply, so a snapshot taken afterwards could no\n  // longer distinguish an ambient override from a value the loader itself\n  // just wrote — see `detectEnvironmentOverrides`.\n  const processEnvironmentSnapshot = { ...process.env };\n\n  // The precedence itself is correct (see `environmentLoaderOptions` above);\n  // the defect this guards against is the SILENCE — `.env` losing to an\n  // ambient value with no diagnostic at all.\n  const overrides = detectEnvironmentOverrides(\n    resolveLoadedEnvFiles(directory),\n    processEnvironmentSnapshot,\n  );\n\n  // Print the overrides here AND retain them: a later point in the boot (the\n  // port-collision reporter) needs to know an ambient `HTTP_PORT` beat `.env`\n  // to avoid advising a rebuild that the env var would just override again —\n  // see `recorded-environment-overrides.ts` (finding 8782b840).\n  recordEnvironmentOverrides(overrides);\n  reportEnvironmentOverrides(overrides);\n\n  // `dir` has to be forwarded: `loadEnv()` defaults it to `process.cwd()`, so\n  // without this the existence check above asks about `directory` while the\n  // load itself reads somewhere else entirely. Identical in production, where\n  // `directory` IS `process.cwd()`.\n  await loadEnv(undefined, { ...environmentLoaderOptions, dir: directory });\n}\n\n/**\n * Forget that env has been loaded, so the next call loads again.\n *\n * @internal For tests, which run many boots inside one process.\n */\nexport function resetLoadedEnvironment(): void {\n  environmentLoaded = false;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,MAAa,2BAA6C,EACxD,YAAY,eACd;;;;;;;;AASA,SAAS,kBAAkB,WAA6B;CACtD,MAAM,QAAQ,CAAC,KAAK,KAAK,WAAW,MAAM,GAAG,KAAK,KAAK,WAAW,aAAa,CAAC;CAEhF,IAAI,QAAQ,IAAI,UACd,MAAM,KAAK,KAAK,KAAK,WAAW,QAAQ,QAAQ,IAAI,UAAU,CAAC;CAGjE,OAAO;AACT;;;;;;;;;;;;AAaA,SAAS,sBAAsB,WAA6B;CAC1D,MAAM,QAAkB,CAAC;CACzB,MAAM,aAAa,KAAK,KAAK,WAAW,aAAa;CAErD,IAAI,WAAW,UAAU,GACvB,MAAM,KAAK,UAAU;CAGvB,MAAM,cAAc,QAAQ,IAAI,WAC5B,KAAK,KAAK,WAAW,QAAQ,QAAQ,IAAI,UAAU,IACnD;CACJ,MAAM,cACJ,eAAe,WAAW,WAAW,IAAI,cAAc,KAAK,KAAK,WAAW,MAAM;CAEpF,IAAI,WAAW,WAAW,GACxB,MAAM,KAAK,WAAW;CAGxB,OAAO;AACT;;;;;;;;;;;;;;;AAgBA,IAAI,oBAAoB;;;;;;;;;;;;;;;;;;AAmBxB,eAAsB,qBAAqB,YAAoB,QAAQ,IAAI,GAAkB;CAC3F,IAAI,mBACF;CAKF,IAAI,CAFe,kBAAkB,SAAS,CAAC,CAAC,MAAM,SAAS,WAAW,IAAI,CAEhE,GAIZ;CAGF,oBAAoB;CAMpB,MAAM,6BAA6B,EAAE,GAAG,QAAQ,IAAI;CAKpD,MAAM,YAAY,2BAChB,sBAAsB,SAAS,GAC/B,0BACF;CAMA,2BAA2B,SAAS;CACpC,2BAA2B,SAAS;CAMpC,MAAM,QAAQ,QAAW;EAAE,GAAG;EAA0B,KAAK;CAAU,CAAC;AAC1E"}