stratal 0.0.16 → 0.0.18

package/dist/{command-BvCOD6df.mjs → command-DjGqCYHv.mjs}

@@ -1,4 +1,4 @@
-import { a as green, n as cyan, o as red, r as dim, s as yellow, t as bold } from "./colors-DJaRDXoS.mjs";
+import { a as green, n as cyan, o as red, r as dim, s as yellow, t as bold } from "./colors-BTAnQRGU.mjs";
 import "reflect-metadata";
 //#region src/quarry/constants.ts
 /**
@@ -13,7 +13,7 @@ const COMMAND_INTERNALS = Symbol.for("stratal:command:internals");
 *
 * Quarry catches this in `call()` and puts the message into `CommandResult.errors`.
 * Does NOT extend `ApplicationError` (which requires i18n keys + error codes).
-* Not routed through GlobalErrorHandler.
+* Not routed through ExceptionHandler.
 */
 var CommandError = class extends Error {
 	constructor(message) {
@@ -184,10 +184,13 @@ var Command = class {
 	async call(name, input) {
 		const internals = this[COMMAND_INTERNALS];
 		if (!internals.quarry) throw new CommandError("Cannot call commands: Quarry reference not set");
-		return internals.quarry.call(name, input);
+		const result = await internals.quarry.call(name, input);
+		internals.output.push(...result.output);
+		internals.errors.push(...result.errors);
+		return result;
 	}
 };
 //#endregion
 export { CommandError as n, COMMAND_INTERNALS as r, Command as t };
 
-//# sourceMappingURL=command-BvCOD6df.mjs.map
+//# sourceMappingURL=command-DjGqCYHv.mjs.map

package/dist/command-DjGqCYHv.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-DjGqCYHv.mjs","names":[],"sources":["../src/quarry/constants.ts","../src/quarry/errors/command.error.ts","../src/quarry/command.ts"],"sourcesContent":["/**\n * Symbol key for storing internal mutable state on Command instances.\n * Keeps internal state hidden from user-facing autocomplete.\n */\nexport const COMMAND_INTERNALS = Symbol.for('stratal:command:internals')\n","/**\n * User-facing command error with a plain English message.\n *\n * Quarry catches this in `call()` and puts the message into `CommandResult.errors`.\n * Does NOT extend `ApplicationError` (which requires i18n keys + error codes).\n * Not routed through ExceptionHandler.\n */\nexport class CommandError extends Error {\n  constructor(message: string) {\n    super(message)\n    this.name = 'CommandError'\n  }\n}\n","import 'reflect-metadata'\n\nimport { bold, cyan, dim, green, red, yellow } from './colors'\nimport { COMMAND_INTERNALS } from './constants'\nimport { CommandError } from './errors/command.error'\nimport type { CommandInput, CommandInternals, CommandResult } from './types'\n\n/**\n * Abstract base class for Quarry commands.\n *\n * Subclasses define a static `command` signature string and implement `handle()`.\n *\n * @example\n * ```typescript\n * export class GreetCommand extends Command {\n *   static command = 'greet {name : The name to greet} {--loud}'\n *   static description = 'Greet someone'\n *\n *   async handle(): Promise<void> {\n *     const name = this.string('name')\n *     const loud = this.boolean('loud')\n *     this.info(loud ? `HELLO, ${name.toUpperCase()}!` : `Hello, ${name}!`)\n *   }\n * }\n * ```\n */\nexport abstract class Command {\n  /**\n   * Laravel-style command signature string.\n   *\n   * **Command names:**\n   * - `'greet'` — flat command (`quarry greet`)\n   * - `'task add'` — subcommand hierarchy via spaces (`quarry task add`)\n   * - `'task:add'` — namespaced flat command via colons (`quarry task:add`)\n   *\n   * **Arguments:**\n   * - `{name}` — required argument\n   * - `{name?}` — optional argument\n   * - `{name=default}` — argument with default value\n   * - `{name*}` — array/variadic argument\n   * - `{name : description}` — argument with description\n   *\n   * **Options:**\n   * - `{--flag}` — boolean flag\n   * - `{--name=}` — option that accepts a value\n   * - `{--name=default}` — option with default value\n   * - `{--name=*}` — array option (multiple values)\n   * - `{--A|name}` — option with single-char alias\n   * - `{--name= : description}` — option with description\n   *\n   * @example\n   * ```typescript\n   * // Namespaced flat command: `quarry users:create ...`\n   * static command = 'users:create {email : The user email} {--A|admin} {--R|role= : Assign a role}'\n   *\n   * // Subcommand hierarchy: `quarry users create ...`\n   * static command = 'users create {email : The user email} {--A|admin} {--R|role= : Assign a role}'\n   * ```\n   */\n  static command: string\n  /** Human-readable description */\n  static description?: string\n  /** Alternative command names */\n  static aliases?: string[];\n\n  [COMMAND_INTERNALS]: CommandInternals\n\n  constructor() {\n    this[COMMAND_INTERNALS] = {\n      inputs: {},\n      output: [],\n      errors: [],\n      exitCode: 0,\n      quarry: null,\n    }\n  }\n\n  /**\n   * Implement this method with the command's logic.\n   * Return a number to set the exit code, or void for exit code 0.\n   */\n  // eslint-disable-next-line @typescript-eslint/no-invalid-void-type\n  abstract handle(): number | void | Promise<number | void>\n\n  // ── Input Accessors ──────────────────────────────────────────────\n\n  /**\n   * Get an input value with generic type.\n   */\n  input<T>(name: string): T {\n    return this[COMMAND_INTERNALS].inputs[name] as T\n  }\n\n  /**\n   * Get a string input. Throws CommandError if present but not a string.\n   */\n  string(name: string): string {\n    const value = this[COMMAND_INTERNALS].inputs[name]\n    if (value === undefined || value === null) {\n      return ''\n    }\n    if (typeof value !== 'string') {\n      throw new CommandError(`Input \"${name}\" expected a string, got ${typeof value}`)\n    }\n    return value\n  }\n\n  /**\n   * Get a boolean input. Throws CommandError if present but not a boolean.\n   */\n  boolean(name: string): boolean {\n    const value = this[COMMAND_INTERNALS].inputs[name]\n    if (value === undefined || value === null) {\n      return false\n    }\n    if (typeof value !== 'boolean') {\n      throw new CommandError(`Input \"${name}\" expected a boolean, got ${typeof value}`)\n    }\n    return value\n  }\n\n  /**\n   * Get a number input. Coerces strings to numbers. Throws CommandError on NaN.\n   */\n  number(name: string): number {\n    const value = this[COMMAND_INTERNALS].inputs[name]\n    if (value === undefined || value === null) {\n      return 0\n    }\n    const num = typeof value === 'string' ? Number(value) : value\n    if (typeof num !== 'number' || Number.isNaN(num)) {\n      throw new CommandError(`Input \"${name}\" expected a number, got ${typeof value}`)\n    }\n    return num\n  }\n\n  /**\n   * Get an array input. Throws CommandError if present but not an array.\n   */\n  array(name: string): string[] {\n    const value = this[COMMAND_INTERNALS].inputs[name]\n    if (value === undefined || value === null) {\n      return []\n    }\n    if (!Array.isArray(value)) {\n      throw new CommandError(`Input \"${name}\" expected an array, got ${typeof value}`)\n    }\n    return value as string[]\n  }\n\n  // ── Output Helpers ───────────────────────────────────────────────\n\n  /** Write an informational message to output */\n  info(message: string): void {\n    this[COMMAND_INTERNALS].output.push(cyan(message))\n  }\n\n  /** Write a success message to output */\n  success(message: string): void {\n    this[COMMAND_INTERNALS].output.push(`${green(bold('✔'))} ${green(message)}`)\n  }\n\n  /** Write a warning message to output */\n  warn(message: string): void {\n    this[COMMAND_INTERNALS].output.push(`${yellow(bold('⚠'))} ${yellow(message)}`)\n  }\n\n  /** Write an error message to errors */\n  error(message: string): void {\n    this[COMMAND_INTERNALS].errors.push(red(message))\n  }\n\n  /** Write a plain line to output */\n  line(message?: string): void {\n    this[COMMAND_INTERNALS].output.push(message ?? '')\n  }\n\n  /** Write an empty line to output */\n  newLine(): void {\n    this[COMMAND_INTERNALS].output.push('')\n  }\n\n  /** Write a comment-style line to output */\n  comment(message: string): void {\n    this[COMMAND_INTERNALS].output.push(dim(`// ${message}`))\n  }\n\n  /** Write a formatted table to output */\n  table(headers: string[], rows: string[][]): void {\n    const colWidths = headers.map((h, i) => {\n      const maxRow = rows.reduce((max, row) => Math.max(max, (row[i] ?? '').length), 0)\n      return Math.max(h.length, maxRow)\n    })\n\n    const formatRow = (cells: string[]) =>\n      cells.map((cell, i) => cell.padEnd(colWidths[i])).join('  ')\n\n    this[COMMAND_INTERNALS].output.push(bold(formatRow(headers)))\n    this[COMMAND_INTERNALS].output.push(dim(colWidths.map((w) => '-'.repeat(w)).join('  ')))\n    for (const row of rows) {\n      this[COMMAND_INTERNALS].output.push(formatRow(row))\n    }\n  }\n\n  /** Write an error message and set exit code */\n  fail(message: string, exitCode = 1): void {\n    this[COMMAND_INTERNALS].errors.push(`${red(bold('✖'))} ${red(message)}`)\n    this[COMMAND_INTERNALS].exitCode = exitCode\n  }\n\n  // ── Command Calling ──────────────────────────────────────────────\n\n  /**\n   * Call another command from within this command.\n   * Delegates to Quarry.call() via internal reference.\n   */\n  async call(name: string, input?: CommandInput): Promise<CommandResult> {\n    const internals = this[COMMAND_INTERNALS]\n    if (!internals.quarry) {\n      throw new CommandError('Cannot call commands: Quarry reference not set')\n    }\n    const result = await internals.quarry.call(name, input)\n\n    // Forward child output/errors into parent (like Clipanion context switches)\n    internals.output.push(...result.output)\n    internals.errors.push(...result.errors)\n\n    return result\n  }\n}\n"],"mappings":"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"}

package/dist/config/index.d.mts

@@ -1,5 +1,5 @@
-import { dt as OnInitialize, it as DynamicModule, lt as ModuleContext, ot as FactoryProvider } from "../index-BJWm863C.mjs";
-import { o as z } from "../index-DVhdhLvE.mjs";
+import { Sn as OnInitialize, gn as FactoryProvider, mn as DynamicModule, yn as ModuleContext } from "../index-BrmS34sa.mjs";
+import { o as z } from "../index-Dfpd_ypO.mjs";
 import { InjectionToken } from "tsyringe";
 
 //#region src/config/config.tokens.d.ts

package/dist/config/index.mjs

@@ -1,17 +1,18 @@
-import { S as ApplicationError, b as ERROR_CODES, s as Scope } from "../errors-CtCi1wn6.mjs";
-import { i as Transient, l as DI_TOKENS, t as __decorate } from "../decorate-D5j-d9_z.mjs";
-import "../logger-BR1-s1Um.mjs";
-import { r as Module } from "../module-BgdxxzBe.mjs";
-import "../events-CXl-o1Ad.mjs";
-import "../colors-DJaRDXoS.mjs";
-import "../command-BvCOD6df.mjs";
-import "../is-command-BfCgWAcQ.mjs";
-import "../is-seeder-CebjZCDn.mjs";
-import "../middleware-C0Ebzswy.mjs";
-import "../router-context-BEJe9HEB.mjs";
+import { A as Scope, H as ApplicationError, k as ERROR_CODES } from "../errors--RBIvDXr.mjs";
+import { a as __decorate, f as DI_TOKENS, p as Transient } from "../logger-c0ftIK4G.mjs";
+import { S as Module } from "../module-C3YZ-kZN.mjs";
 //#region src/config/config.tokens.ts
 const CONFIG_TOKENS = { ConfigService: Symbol.for("stratal:config:service") };
 //#endregion
+//#region src/config/config.types.ts
+var ConfigValidationError = class extends Error {
+	constructor(message, errors) {
+		super(message);
+		this.errors = errors;
+		this.name = "ConfigValidationError";
+	}
+};
+//#endregion
 //#region src/config/errors/config-module-not-initialized.error.ts
 /**
 * Error thrown when ConfigModule's onInitialize runs but forRoot() was never called.
@@ -38,15 +39,6 @@ var ConfigNotInitializedError = class extends ApplicationError {
 	}
 };
 //#endregion
-//#region src/config/config.types.ts
-var ConfigValidationError = class extends Error {
-	constructor(message, errors) {
-		super(message);
-		this.errors = errors;
-		this.name = "ConfigValidationError";
-	}
-};
-//#endregion
 //#region src/config/services/config.service.ts
 let ConfigService = class ConfigService {
 	originalConfig;

package/dist/config/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/config/config.tokens.ts","../../src/config/errors/config-module-not-initialized.error.ts","../../src/config/errors/config-not-initialized.error.ts","../../src/config/config.types.ts","../../src/config/services/config.service.ts","../../src/config/config.module.ts","../../src/config/register-as.ts"],"sourcesContent":["export const CONFIG_TOKENS = {\n\tConfigService: Symbol.for('stratal:config:service'),\n} as const\n","import { ApplicationError, ERROR_CODES } from '../../errors'\n\n/**\n * Error thrown when ConfigModule's onInitialize runs but forRoot() was never called.\n *\n * This means the module was imported without calling ConfigModule.forRoot({ load: [...] }).\n */\nexport class ConfigModuleNotInitializedError extends ApplicationError {\n  constructor() {\n    super(\n      'errors.configModuleNotInitialized',\n      ERROR_CODES.SYSTEM.CONFIG_MODULE_NOT_INITIALIZED\n    )\n  }\n}\n","import { ERROR_CODES } from '../../errors'\nimport { ApplicationError } from '../../errors'\n\n/**\n * ConfigNotInitializedError\n *\n * Thrown when attempting to access ConfigService before it has been initialized.\n * This typically indicates that ConfigModule's onInitialize hook hasn't run yet,\n * or the module wasn't registered properly.\n */\nexport class ConfigNotInitializedError extends ApplicationError {\n  constructor() {\n    super(\n      'errors.configNotInitialized',\n      ERROR_CODES.SYSTEM.CONFIG_NOT_INITIALIZED\n    )\n  }\n}\n","import type { z } from '../i18n/validation'\n\nexport class ConfigValidationError extends Error {\n  constructor(\n    message: string,\n    public readonly errors: z.ZodError\n  ) {\n    super(message)\n    this.name = 'ConfigValidationError'\n  }\n}\n\n/**\n * Configuration that can be augmented by applications\n * Apps should augment this interface with their AppConfig type using module augmentation\n *\n * @example\n * ```typescript\n * // In your app (e.g., apps/backend/src/config/types.ts)\n * declare module 'stratal' {\n *   interface ModuleConfig {\n *     database: { url: string; maxConnections: number }\n *     email: { provider: string; from: { name: string; email: string } }\n *   }\n * }\n * ```\n */\nexport interface ModuleConfig { }\n\n/**\n * Generate all valid dot-notation paths from a config object type\n * @example ConfigPath<{ database: { url: string } }> = 'database' | 'database.url'\n */\nexport type ConfigPath<T> = {\n  [K in keyof T & string]: T[K] extends Record<string, unknown>\n  ? K | `${K}.${ConfigPath<T[K]>}`\n  : K\n}[keyof T & string]\n\n/**\n * Get the value type at a dot-notation path\n * @example ConfigPathValue<{ database: { url: string } }, 'database.url'> = string\n */\nexport type ConfigPathValue<T, P extends string> = P extends `${infer K}.${infer Rest}`\n  ? K extends keyof T\n  ? T[K] extends Record<string, unknown>\n  ? ConfigPathValue<T[K], Rest>\n  : never\n  : never\n  : P extends keyof T\n  ? T[P]\n  : never\n\n/**\n * ConfigService interface with dot notation support\n */\nexport interface IConfigService<T extends object = ModuleConfig> {\n  /**\n   * Initialize the config service with validated configuration\n   * Should be called once during application startup\n   */\n  initialize(config: T): void\n\n  /**\n   * Get config value using dot notation\n   * @example config.get('database.url')\n   */\n  get<P extends ConfigPath<T>>(path: P): ConfigPathValue<T, P>\n\n  /**\n   * Set config value at runtime (for runtime overrides)\n   * @example config.set('email.from.name', 'Custom Name')\n   */\n  set<P extends ConfigPath<T>>(path: P, value: ConfigPathValue<T, P>): void\n\n  /**\n   * Reset config to original value\n   * @param path - Optional path to reset (resets entire config if omitted)\n   */\n  reset(path?: ConfigPath<T>): void\n\n  /**\n   * Get entire config object\n   */\n  all(): Readonly<T>\n\n  /**\n   * Check if a config path exists\n   */\n  has(path: ConfigPath<T>): boolean\n}\n","import { Transient } from '../../di/decorators'\nimport { CONFIG_TOKENS } from '../config.tokens'\nimport type { ConfigPath, ConfigPathValue, IConfigService, ModuleConfig } from '../config.types'\nimport { ConfigNotInitializedError } from '../errors'\n\n/**\n * ConfigService with dot notation support for get/set operations\n *\n * Supports runtime overrides via set() - useful for request-specific config overrides.\n * Use reset() to restore original values.\n *\n * @example\n * ```typescript\n * // Get with dot notation\n * const url = config.get('database.url')\n * const fromName = config.get('email.from.name')\n *\n * // Set at runtime (e.g., in middleware for runtime override)\n * config.set('email.from.name', 'Custom Name')\n *\n * // Reset to original\n * config.reset('email.from.name') // reset specific path\n * config.reset() // reset entire config\n * ```\n */\n@Transient(CONFIG_TOKENS.ConfigService)\nexport class ConfigService<T extends object = ModuleConfig> implements IConfigService<T> {\n  private originalConfig: T | undefined\n  private currentConfig: T | undefined\n\n  /**\n   * Initialize the config service with validated configuration\n   * Called by ConfigModule during initialization\n   */\n  initialize(config: T): void {\n    this.originalConfig = this.deepClone(config)\n    this.currentConfig = this.deepClone(config)\n  }\n\n  /**\n   * Get config value using dot notation\n   * @example config.get('database.url')\n   */\n  get<P extends ConfigPath<T>>(path: P): ConfigPathValue<T, P> {\n    this.ensureInitialized()\n    return this.getByPath(this.currentConfig, path) as ConfigPathValue<T, P>\n  }\n\n  /**\n   * Set config value at runtime (for runtime overrides)\n   * @example config.set('email.from.name', 'Custom Name')\n   */\n  set<P extends ConfigPath<T>>(path: P, value: ConfigPathValue<T, P>): void {\n    this.ensureInitialized()\n    this.setByPath(this.currentConfig, path, value)\n  }\n\n  /**\n   * Reset config to original value\n   * @param path - Optional path to reset (resets entire config if omitted)\n   */\n  reset(path?: ConfigPath<T>): void {\n    this.ensureInitialized()\n    if (path) {\n      const originalValue = this.getByPath(this.originalConfig, path)\n      this.setByPath(this.currentConfig, path, this.deepClone(originalValue))\n    } else {\n      this.currentConfig = this.deepClone(this.originalConfig)\n    }\n  }\n\n  /**\n   * Get entire config object\n   */\n  all(): Readonly<T> {\n    this.ensureInitialized()\n    return this.currentConfig as Readonly<T>\n  }\n\n  /**\n   * Check if a config path exists\n   */\n  has(path: ConfigPath<T>): boolean {\n    this.ensureInitialized()\n    return this.getByPath(this.currentConfig, path) !== undefined\n  }\n\n  private getByPath(obj: unknown, path: string): unknown {\n    const keys = path.split('.')\n    let current = obj\n    for (const key of keys) {\n      if (this.isDangerousKey(key)) return undefined\n      if (current === null || current === undefined) return undefined\n      current = (current as Record<string, unknown>)[key]\n    }\n    return current\n  }\n\n  private setByPath(obj: unknown, path: string, value: unknown): void {\n    const keys = path.split('.')\n    if (keys.some((key) => this.isDangerousKey(key))) return\n    let current = obj as Record<string, unknown>\n    for (let i = 0; i < keys.length - 1; i++) {\n      const key = keys[i]\n      if (!Object.hasOwn(current, key) || typeof current[key] !== 'object' || current[key] === null) {\n        Object.defineProperty(current, key, {\n          value: {},\n          writable: true,\n          enumerable: true,\n          configurable: true,\n        })\n      }\n      current = current[key] as Record<string, unknown>\n    }\n    Object.defineProperty(current, keys[keys.length - 1], {\n      value,\n      writable: true,\n      enumerable: true,\n      configurable: true,\n    })\n  }\n\n  private isDangerousKey(key: string): boolean {\n    return key === '__proto__' || key === 'constructor' || key === 'prototype'\n  }\n\n  private ensureInitialized(): void {\n    if (!this.currentConfig) {\n      throw new ConfigNotInitializedError()\n    }\n  }\n\n  private deepClone<V>(obj: V): V {\n    if (obj === null || typeof obj !== 'object') {\n      return obj\n    }\n    return JSON.parse(JSON.stringify(obj)) as V\n  }\n}\n","import type { z } from '../i18n/validation'\nimport { ConfigModuleNotInitializedError } from './errors'\nimport { DI_TOKENS } from '../di/tokens'\nimport { Scope } from '../di/types'\nimport { Module } from '../module'\nimport type { DynamicModule, ModuleContext, OnInitialize, Provider } from '../module/types'\nimport { CONFIG_TOKENS } from './config.tokens'\nimport { ConfigValidationError, ModuleConfig } from './config.types'\nimport type { ConfigNamespace } from './register-as'\nimport { ConfigService } from './services/config.service'\n\n/**\n * Any config namespace - uses structural typing for flexibility\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type AnyConfigNamespace = ConfigNamespace<string, any, object>\n\n/**\n * Options for ConfigModule.forRoot\n */\nexport interface ConfigModuleOptions {\n  /**\n   * Array of config namespaces created via registerAs()\n   */\n  load: AnyConfigNamespace[]\n\n  /**\n   * Optional Zod schema for validating the merged config\n   * Validates the entire config object after all namespaces are merged\n   */\n  validateSchema?: z.ZodType<object>\n}\n\n// Store options for use in onInitialize\nlet moduleOptions: ConfigModuleOptions | null = null\n\n/**\n * ConfigModule\n *\n * Provides configuration management with namespace support.\n * Uses registerAs() to create typed config namespaces that can be injected.\n *\n * @example\n * ```typescript\n * // Define config namespaces\n * const databaseConfig = registerAs('database', (env) => ({\n *   url: env.DATABASE_URL,\n *   maxConnections: 10\n * }))\n *\n * const emailConfig = registerAs('email', (env) => ({\n *   provider: env.EMAIL_PROVIDER,\n *   from: { name: 'App', email: 'noreply@example.com' }\n * }))\n *\n * // Register in module\n * @Module({\n *   imports: [\n *     ConfigModule.forRoot({\n *       load: [databaseConfig, emailConfig],\n *       validateSchema: AppConfigSchema\n *     })\n *   ]\n * })\n * export class AppModule {}\n *\n * // Inject config\n * constructor(\n *   @inject(CONFIG_TOKENS.ConfigService) private config: IConfigService,\n *   @inject(databaseConfig.KEY) private dbConfig: DatabaseConfig\n * ) {\n *   // Use dot notation\n *   const url = this.config.get('database.url')\n *\n *   // Or inject namespace directly\n *   const url = this.dbConfig.url\n * }\n * ```\n */\n@Module({\n  providers: [\n    // Register the main ConfigService as Singleton so initialization persists\n    {\n      provide: CONFIG_TOKENS.ConfigService,\n      useClass: ConfigService,\n      scope: Scope.Singleton,\n    },\n  ],\n})\nexport class ConfigModule implements OnInitialize {\n  /**\n   * Configure ConfigModule with namespace loaders\n   *\n   * @param options - Configuration options\n   * @returns Dynamic module with config infrastructure\n   */\n  static forRoot(options: ConfigModuleOptions): DynamicModule {\n    moduleOptions = options\n\n    const providers: Provider[] = []\n\n    // Register each namespace config using asProvider()\n    for (const namespace of options.load) {\n      providers.push(namespace.asProvider())\n    }\n\n    return {\n      module: ConfigModule,\n      providers,\n    }\n  }\n\n  /**\n   * Initialize config service with merged namespaces\n   * Called after all providers are registered\n   */\n  onInitialize(context: ModuleContext): void {\n    if (!moduleOptions) {\n      throw new ConfigModuleNotInitializedError()\n    }\n\n    const env = context.container.resolve<unknown>(DI_TOKENS.CloudflareEnv)\n    const configService = context.container.resolve<ConfigService>(CONFIG_TOKENS.ConfigService)\n\n    // Build merged config from all namespaces\n    const mergedConfig: Record<string, unknown> = {}\n\n    for (const namespace of moduleOptions.load) {\n      mergedConfig[namespace.namespace] = namespace.factory(env)\n    }\n\n    // Validate if schema provided\n    if (moduleOptions.validateSchema) {\n      const result = moduleOptions.validateSchema.safeParse(mergedConfig)\n      if (!result.success) {\n        throw new ConfigValidationError(\n          'Configuration validation failed',\n          result.error\n        )\n      }\n    }\n\n    // Initialize ConfigService with merged config\n    configService.initialize(mergedConfig as ModuleConfig)\n\n    context.logger.debug('ConfigModule initialized', {\n      namespaces: moduleOptions.load.map((n) => n.namespace),\n    })\n  }\n}\n","import type { InjectionToken } from 'tsyringe'\nimport { DI_TOKENS } from '../di/tokens'\nimport type { FactoryProvider } from '../module/types'\n\n/**\n * Configuration namespace registration result\n */\nexport interface ConfigNamespace<TKey extends string, TEnv, TConfig extends object> {\n  /** Auto-derived injection token (e.g., 'database' -> Symbol('stratal:config:database')) */\n  readonly KEY: InjectionToken<TConfig>\n  /** The namespace key */\n  readonly namespace: TKey\n  /** The factory function that receives env and returns config */\n  readonly factory: (env: TEnv) => TConfig\n  /**\n   * Returns a provider configuration for use in module registration\n   * Automatically injects DI_TOKENS.CloudflareEnv\n   */\n  asProvider(): FactoryProvider<TConfig>\n}\n\n/**\n * Create a namespaced configuration factory\n * Similar to NestJS registerAs\n *\n * @param namespace - Configuration namespace (e.g., 'database', 'email')\n * @param factory - Factory function receiving env and returning config object\n * @returns ConfigNamespace with token, factory, and asProvider() method\n *\n * @example\n * ```typescript\n * // apps/backend/src/config/database.config.ts\n * export const databaseConfig = registerAs('database', (env: Env) => ({\n *   url: env.DATABASE_URL,\n *   maxConnections: parseInt(env.DATABASE_MAX_CONNECTIONS || '10'),\n * }))\n *\n * // Auto-generates: databaseConfig.KEY = Symbol('stratal:config:database')\n *\n * // Usage in module:\n * // Option 1: Manual provider\n * {\n *   provide: databaseConfig.KEY,\n *   useFactory: databaseConfig.factory,\n *   inject: [DI_TOKENS.CloudflareEnv]\n * }\n *\n * // Option 2: asProvider() helper\n * databaseConfig.asProvider()\n * // Returns: { provide: databaseConfig.KEY, useFactory: ..., inject: [DI_TOKENS.CloudflareEnv] }\n * ```\n */\nexport function registerAs<TKey extends string, TEnv, TConfig extends object>(\n  namespace: TKey,\n  factory: (env: TEnv) => TConfig\n): ConfigNamespace<TKey, TEnv, TConfig> {\n  const KEY = Symbol.for(`stratal:config:${namespace}`) as InjectionToken<TConfig>\n\n  return {\n    KEY,\n    namespace,\n    factory,\n    asProvider(): FactoryProvider<TConfig> {\n      return {\n        provide: KEY,\n        useFactory: factory,\n        inject: [DI_TOKENS.CloudflareEnv],\n      }\n    },\n  }\n}\n\n/**\n * Helper to derive config type from registerAs result\n *\n * @example\n * ```typescript\n * const databaseConfig = registerAs('database', (env) => ({ url: env.DATABASE_URL }))\n * type DatabaseConfig = InferConfigType<typeof databaseConfig>\n * // { url: string }\n * ```\n */\nexport type InferConfigType<T> = T extends ConfigNamespace<string, unknown, infer C> ? C : never\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/config/config.tokens.ts","../../src/config/config.types.ts","../../src/config/errors/config-module-not-initialized.error.ts","../../src/config/errors/config-not-initialized.error.ts","../../src/config/services/config.service.ts","../../src/config/config.module.ts","../../src/config/register-as.ts"],"sourcesContent":["export const CONFIG_TOKENS = {\n\tConfigService: Symbol.for('stratal:config:service'),\n} as const\n","import type { z } from '../i18n/validation'\n\nexport class ConfigValidationError extends Error {\n  constructor(\n    message: string,\n    public readonly errors: z.ZodError\n  ) {\n    super(message)\n    this.name = 'ConfigValidationError'\n  }\n}\n\n/**\n * Configuration that can be augmented by applications\n * Apps should augment this interface with their AppConfig type using module augmentation\n *\n * @example\n * ```typescript\n * // In your app (e.g., apps/backend/src/config/types.ts)\n * declare module 'stratal' {\n *   interface ModuleConfig {\n *     database: { url: string; maxConnections: number }\n *     email: { provider: string; from: { name: string; email: string } }\n *   }\n * }\n * ```\n */\nexport interface ModuleConfig { }\n\n/**\n * Generate all valid dot-notation paths from a config object type\n * @example ConfigPath<{ database: { url: string } }> = 'database' | 'database.url'\n */\nexport type ConfigPath<T> = {\n  [K in keyof T & string]: T[K] extends Record<string, unknown>\n  ? K | `${K}.${ConfigPath<T[K]>}`\n  : K\n}[keyof T & string]\n\n/**\n * Get the value type at a dot-notation path\n * @example ConfigPathValue<{ database: { url: string } }, 'database.url'> = string\n */\nexport type ConfigPathValue<T, P extends string> = P extends `${infer K}.${infer Rest}`\n  ? K extends keyof T\n  ? T[K] extends Record<string, unknown>\n  ? ConfigPathValue<T[K], Rest>\n  : never\n  : never\n  : P extends keyof T\n  ? T[P]\n  : never\n\n/**\n * ConfigService interface with dot notation support\n */\nexport interface IConfigService<T extends object = ModuleConfig> {\n  /**\n   * Initialize the config service with validated configuration\n   * Should be called once during application startup\n   */\n  initialize(config: T): void\n\n  /**\n   * Get config value using dot notation\n   * @example config.get('database.url')\n   */\n  get<P extends ConfigPath<T>>(path: P): ConfigPathValue<T, P>\n\n  /**\n   * Set config value at runtime (for runtime overrides)\n   * @example config.set('email.from.name', 'Custom Name')\n   */\n  set<P extends ConfigPath<T>>(path: P, value: ConfigPathValue<T, P>): void\n\n  /**\n   * Reset config to original value\n   * @param path - Optional path to reset (resets entire config if omitted)\n   */\n  reset(path?: ConfigPath<T>): void\n\n  /**\n   * Get entire config object\n   */\n  all(): Readonly<T>\n\n  /**\n   * Check if a config path exists\n   */\n  has(path: ConfigPath<T>): boolean\n}\n","import { ApplicationError, ERROR_CODES } from '../../errors'\n\n/**\n * Error thrown when ConfigModule's onInitialize runs but forRoot() was never called.\n *\n * This means the module was imported without calling ConfigModule.forRoot({ load: [...] }).\n */\nexport class ConfigModuleNotInitializedError extends ApplicationError {\n  constructor() {\n    super(\n      'errors.configModuleNotInitialized',\n      ERROR_CODES.SYSTEM.CONFIG_MODULE_NOT_INITIALIZED\n    )\n  }\n}\n","import { ERROR_CODES } from '../../errors'\nimport { ApplicationError } from '../../errors'\n\n/**\n * ConfigNotInitializedError\n *\n * Thrown when attempting to access ConfigService before it has been initialized.\n * This typically indicates that ConfigModule's onInitialize hook hasn't run yet,\n * or the module wasn't registered properly.\n */\nexport class ConfigNotInitializedError extends ApplicationError {\n  constructor() {\n    super(\n      'errors.configNotInitialized',\n      ERROR_CODES.SYSTEM.CONFIG_NOT_INITIALIZED\n    )\n  }\n}\n","import { Transient } from '../../di/decorators'\nimport { CONFIG_TOKENS } from '../config.tokens'\nimport type { ConfigPath, ConfigPathValue, IConfigService, ModuleConfig } from '../config.types'\nimport { ConfigNotInitializedError } from '../errors'\n\n/**\n * ConfigService with dot notation support for get/set operations\n *\n * Supports runtime overrides via set() - useful for request-specific config overrides.\n * Use reset() to restore original values.\n *\n * @example\n * ```typescript\n * // Get with dot notation\n * const url = config.get('database.url')\n * const fromName = config.get('email.from.name')\n *\n * // Set at runtime (e.g., in middleware for runtime override)\n * config.set('email.from.name', 'Custom Name')\n *\n * // Reset to original\n * config.reset('email.from.name') // reset specific path\n * config.reset() // reset entire config\n * ```\n */\n@Transient(CONFIG_TOKENS.ConfigService)\nexport class ConfigService<T extends object = ModuleConfig> implements IConfigService<T> {\n  private originalConfig: T | undefined\n  private currentConfig: T | undefined\n\n  /**\n   * Initialize the config service with validated configuration\n   * Called by ConfigModule during initialization\n   */\n  initialize(config: T): void {\n    this.originalConfig = this.deepClone(config)\n    this.currentConfig = this.deepClone(config)\n  }\n\n  /**\n   * Get config value using dot notation\n   * @example config.get('database.url')\n   */\n  get<P extends ConfigPath<T>>(path: P): ConfigPathValue<T, P> {\n    this.ensureInitialized()\n    return this.getByPath(this.currentConfig, path) as ConfigPathValue<T, P>\n  }\n\n  /**\n   * Set config value at runtime (for runtime overrides)\n   * @example config.set('email.from.name', 'Custom Name')\n   */\n  set<P extends ConfigPath<T>>(path: P, value: ConfigPathValue<T, P>): void {\n    this.ensureInitialized()\n    this.setByPath(this.currentConfig, path, value)\n  }\n\n  /**\n   * Reset config to original value\n   * @param path - Optional path to reset (resets entire config if omitted)\n   */\n  reset(path?: ConfigPath<T>): void {\n    this.ensureInitialized()\n    if (path) {\n      const originalValue = this.getByPath(this.originalConfig, path)\n      this.setByPath(this.currentConfig, path, this.deepClone(originalValue))\n    } else {\n      this.currentConfig = this.deepClone(this.originalConfig)\n    }\n  }\n\n  /**\n   * Get entire config object\n   */\n  all(): Readonly<T> {\n    this.ensureInitialized()\n    return this.currentConfig as Readonly<T>\n  }\n\n  /**\n   * Check if a config path exists\n   */\n  has(path: ConfigPath<T>): boolean {\n    this.ensureInitialized()\n    return this.getByPath(this.currentConfig, path) !== undefined\n  }\n\n  private getByPath(obj: unknown, path: string): unknown {\n    const keys = path.split('.')\n    let current = obj\n    for (const key of keys) {\n      if (this.isDangerousKey(key)) return undefined\n      if (current === null || current === undefined) return undefined\n      current = (current as Record<string, unknown>)[key]\n    }\n    return current\n  }\n\n  private setByPath(obj: unknown, path: string, value: unknown): void {\n    const keys = path.split('.')\n    if (keys.some((key) => this.isDangerousKey(key))) return\n    let current = obj as Record<string, unknown>\n    for (let i = 0; i < keys.length - 1; i++) {\n      const key = keys[i]\n      if (!Object.hasOwn(current, key) || typeof current[key] !== 'object' || current[key] === null) {\n        Object.defineProperty(current, key, {\n          value: {},\n          writable: true,\n          enumerable: true,\n          configurable: true,\n        })\n      }\n      current = current[key] as Record<string, unknown>\n    }\n    Object.defineProperty(current, keys[keys.length - 1], {\n      value,\n      writable: true,\n      enumerable: true,\n      configurable: true,\n    })\n  }\n\n  private isDangerousKey(key: string): boolean {\n    return key === '__proto__' || key === 'constructor' || key === 'prototype'\n  }\n\n  private ensureInitialized(): void {\n    if (!this.currentConfig) {\n      throw new ConfigNotInitializedError()\n    }\n  }\n\n  private deepClone<V>(obj: V): V {\n    if (obj === null || typeof obj !== 'object') {\n      return obj\n    }\n    return JSON.parse(JSON.stringify(obj)) as V\n  }\n}\n","import { DI_TOKENS } from '../di/tokens'\nimport { Scope } from '../di/types'\nimport type { z } from '../i18n/validation'\nimport { Module } from '../module'\nimport type { DynamicModule, ModuleContext, OnInitialize, Provider } from '../module/types'\nimport { CONFIG_TOKENS } from './config.tokens'\nimport { ConfigValidationError, type ModuleConfig } from './config.types'\nimport { ConfigModuleNotInitializedError } from './errors'\nimport type { ConfigNamespace } from './register-as'\nimport { ConfigService } from './services/config.service'\n\n/**\n * Any config namespace - uses structural typing for flexibility\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type AnyConfigNamespace = ConfigNamespace<string, any, object>\n\n/**\n * Options for ConfigModule.forRoot\n */\nexport interface ConfigModuleOptions {\n  /**\n   * Array of config namespaces created via registerAs()\n   */\n  load: AnyConfigNamespace[]\n\n  /**\n   * Optional Zod schema for validating the merged config\n   * Validates the entire config object after all namespaces are merged\n   */\n  validateSchema?: z.ZodType<object>\n}\n\n// Store options for use in onInitialize\nlet moduleOptions: ConfigModuleOptions | null = null\n\n/**\n * ConfigModule\n *\n * Provides configuration management with namespace support.\n * Uses registerAs() to create typed config namespaces that can be injected.\n *\n * @example\n * ```typescript\n * // Define config namespaces\n * const databaseConfig = registerAs('database', (env) => ({\n *   url: env.DATABASE_URL,\n *   maxConnections: 10\n * }))\n *\n * const emailConfig = registerAs('email', (env) => ({\n *   provider: env.EMAIL_PROVIDER,\n *   from: { name: 'App', email: 'noreply@example.com' }\n * }))\n *\n * // Register in module\n * @Module({\n *   imports: [\n *     ConfigModule.forRoot({\n *       load: [databaseConfig, emailConfig],\n *       validateSchema: AppConfigSchema\n *     })\n *   ]\n * })\n * export class AppModule {}\n *\n * // Inject config\n * constructor(\n *   @inject(CONFIG_TOKENS.ConfigService) private config: IConfigService,\n *   @inject(databaseConfig.KEY) private dbConfig: DatabaseConfig\n * ) {\n *   // Use dot notation\n *   const url = this.config.get('database.url')\n *\n *   // Or inject namespace directly\n *   const url = this.dbConfig.url\n * }\n * ```\n */\n@Module({\n  providers: [\n    // Register the main ConfigService as Singleton so initialization persists\n    {\n      provide: CONFIG_TOKENS.ConfigService,\n      useClass: ConfigService,\n      scope: Scope.Singleton,\n    },\n  ],\n})\nexport class ConfigModule implements OnInitialize {\n  /**\n   * Configure ConfigModule with namespace loaders\n   *\n   * @param options - Configuration options\n   * @returns Dynamic module with config infrastructure\n   */\n  static forRoot(options: ConfigModuleOptions): DynamicModule {\n    moduleOptions = options\n\n    const providers: Provider[] = []\n\n    // Register each namespace config using asProvider()\n    for (const namespace of options.load) {\n      providers.push(namespace.asProvider())\n    }\n\n    return {\n      module: ConfigModule,\n      providers,\n    }\n  }\n\n  /**\n   * Initialize config service with merged namespaces\n   * Called after all providers are registered\n   */\n  onInitialize(context: ModuleContext): void {\n    if (!moduleOptions) {\n      throw new ConfigModuleNotInitializedError()\n    }\n\n    const env = context.container.resolve<unknown>(DI_TOKENS.CloudflareEnv)\n    const configService = context.container.resolve<ConfigService>(CONFIG_TOKENS.ConfigService)\n\n    // Build merged config from all namespaces\n    const mergedConfig: Record<string, unknown> = {}\n\n    for (const namespace of moduleOptions.load) {\n      mergedConfig[namespace.namespace] = namespace.factory(env)\n    }\n\n    // Validate if schema provided\n    if (moduleOptions.validateSchema) {\n      const result = moduleOptions.validateSchema.safeParse(mergedConfig)\n      if (!result.success) {\n        throw new ConfigValidationError(\n          'Configuration validation failed',\n          result.error\n        )\n      }\n    }\n\n    // Initialize ConfigService with merged config\n    configService.initialize(mergedConfig as ModuleConfig)\n\n    context.logger.debug('ConfigModule initialized', {\n      namespaces: moduleOptions.load.map((n) => n.namespace),\n    })\n  }\n}\n","import type { InjectionToken } from 'tsyringe'\nimport { DI_TOKENS } from '../di/tokens'\nimport type { FactoryProvider } from '../module/types'\n\n/**\n * Configuration namespace registration result\n */\nexport interface ConfigNamespace<TKey extends string, TEnv, TConfig extends object> {\n  /** Auto-derived injection token (e.g., 'database' -> Symbol('stratal:config:database')) */\n  readonly KEY: InjectionToken<TConfig>\n  /** The namespace key */\n  readonly namespace: TKey\n  /** The factory function that receives env and returns config */\n  readonly factory: (env: TEnv) => TConfig\n  /**\n   * Returns a provider configuration for use in module registration\n   * Automatically injects DI_TOKENS.CloudflareEnv\n   */\n  asProvider(): FactoryProvider<TConfig>\n}\n\n/**\n * Create a namespaced configuration factory\n * Similar to NestJS registerAs\n *\n * @param namespace - Configuration namespace (e.g., 'database', 'email')\n * @param factory - Factory function receiving env and returning config object\n * @returns ConfigNamespace with token, factory, and asProvider() method\n *\n * @example\n * ```typescript\n * // apps/backend/src/config/database.config.ts\n * export const databaseConfig = registerAs('database', (env: Env) => ({\n *   url: env.DATABASE_URL,\n *   maxConnections: parseInt(env.DATABASE_MAX_CONNECTIONS || '10'),\n * }))\n *\n * // Auto-generates: databaseConfig.KEY = Symbol('stratal:config:database')\n *\n * // Usage in module:\n * // Option 1: Manual provider\n * {\n *   provide: databaseConfig.KEY,\n *   useFactory: databaseConfig.factory,\n *   inject: [DI_TOKENS.CloudflareEnv]\n * }\n *\n * // Option 2: asProvider() helper\n * databaseConfig.asProvider()\n * // Returns: { provide: databaseConfig.KEY, useFactory: ..., inject: [DI_TOKENS.CloudflareEnv] }\n * ```\n */\nexport function registerAs<TKey extends string, TEnv, TConfig extends object>(\n  namespace: TKey,\n  factory: (env: TEnv) => TConfig\n): ConfigNamespace<TKey, TEnv, TConfig> {\n  const KEY = Symbol.for(`stratal:config:${namespace}`) as InjectionToken<TConfig>\n\n  return {\n    KEY,\n    namespace,\n    factory,\n    asProvider(): FactoryProvider<TConfig> {\n      return {\n        provide: KEY,\n        useFactory: factory,\n        inject: [DI_TOKENS.CloudflareEnv],\n      }\n    },\n  }\n}\n\n/**\n * Helper to derive config type from registerAs result\n *\n * @example\n * ```typescript\n * const databaseConfig = registerAs('database', (env) => ({ url: env.DATABASE_URL }))\n * type DatabaseConfig = InferConfigType<typeof databaseConfig>\n * // { url: string }\n * ```\n */\nexport type InferConfigType<T> = T extends ConfigNamespace<string, unknown, infer C> ? C : never\n"],"mappings":"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"}

package/dist/consumer-registry-BkuHXR_u.d.mts

@@ -0,0 +1,142 @@
+//#region src/queue/queue-consumer.d.ts
+/**
+ * Queue message structure
+ *
+ * All messages dispatched to queues follow this structure.
+ * The `id` and `timestamp` are auto-generated by QueueSender.
+ */
+interface QueueMessage<T = unknown> {
+  /** Unique message identifier (UUID) */
+  id: string;
+  /** Timestamp when message was dispatched (milliseconds since epoch) */
+  timestamp: number;
+  /** Message type for routing to consumers */
+  type: string;
+  /** Message payload */
+  payload: T;
+  /** Optional metadata including locale for i18n */
+  metadata?: {
+    locale?: string;
+    [key: string]: unknown;
+  };
+}
+/**
+ * Queue consumer interface
+ *
+ * Consumers handle messages based on their `messageTypes` declaration.
+ * A consumer receives messages of the declared types from ANY queue.
+ *
+ * @example
+ * ```typescript
+ * @Transient()
+ * export class EmailConsumer implements IQueueConsumer<SendEmailInput> {
+ *   readonly messageTypes = ['email.send', 'email.batch.send']
+ *
+ *   async handle(message: QueueMessage<SendEmailInput>): Promise<void> {
+ *     // Process email...
+ *   }
+ * }
+ * ```
+ */
+interface IQueueConsumer<T = unknown> {
+  /**
+   * Message types this consumer handles.
+   *
+   * The consumer receives messages matching these types from ANY queue.
+   * Use '*' to match all message types (wildcard consumer).
+   */
+  readonly messageTypes: string[];
+  /**
+   * Handle an incoming message
+   *
+   * @param message - The queue message to process
+   */
+  handle(message: QueueMessage<T>): Promise<void>;
+  /**
+   * Optional error handler for failed message processing
+   *
+   * @param error - The error that occurred
+   * @param message - The message that failed to process
+   */
+  onError?(error: Error, message: QueueMessage<T>): Promise<void>;
+}
+//#endregion
+//#region src/queue/consumer-registry.d.ts
+/**
+ * Consumer Registry
+ *
+ * Singleton service that holds all registered queue consumers indexed by message type.
+ * Consumers declare the message types they handle, and this registry routes messages
+ * to the appropriate consumers based on their types.
+ *
+ * **Message-Type Routing:**
+ * - Consumers declare `messageTypes` array (e.g., `['email.send', 'email.batch.send']`)
+ * - When a message arrives, consumers matching the message type are invoked
+ * - A consumer can handle messages from ANY queue (routing is by type, not queue)
+ * - Use `'*'` as a wildcard to handle all message types
+ *
+ * @example Consumer registration
+ * ```typescript
+ * // In consumer.ts
+ * @Transient()
+ * export class EmailConsumer implements IQueueConsumer {
+ *   readonly messageTypes = ['email.send', 'email.batch.send']
+ *   // ...
+ * }
+ *
+ * // In module.ts
+ * @Module({
+ *   consumers: [EmailConsumer]
+ * })
+ *
+ * // Application auto-registers via ConsumerRegistry
+ * this.consumerRegistry.register(consumer)
+ * ```
+ */
+declare class ConsumerRegistry {
+  /** Map from message type to consumers handling that type */
+  private consumersByType;
+  /** Set of all registered consumers (for iteration) */
+  private allConsumers;
+  /**
+   * Register a queue consumer
+   *
+   * Indexes the consumer by each of its declared message types.
+   *
+   * @param consumer - Queue consumer to register
+   */
+  register(consumer: IQueueConsumer): void;
+  /**
+   * Get all consumers that can handle a specific message type
+   *
+   * Returns consumers that either:
+   * - Explicitly declare the message type
+   * - Use '*' wildcard to handle all types
+   *
+   * @param messageType - The message type to find consumers for
+   * @returns Array of consumers that can handle this message type
+   */
+  getConsumers(messageType: string): IQueueConsumer[];
+  /**
+   * Check if any consumers can handle a message type
+   *
+   * @param messageType - The message type to check
+   * @returns true if at least one consumer can handle this type
+   */
+  hasConsumers(messageType: string): boolean;
+  /**
+   * Get all registered message types
+   *
+   * @returns Array of message types with registered consumers
+   */
+  getMessageTypes(): string[];
+  /**
+   * Get all registered consumers
+   *
+   * @returns Array of all registered consumers
+   */
+  getAllConsumers(): IQueueConsumer[];
+}
+//#endregion
+export { IQueueConsumer as n, QueueMessage as r, ConsumerRegistry as t };
+//# sourceMappingURL=consumer-registry-BkuHXR_u.d.mts.map

package/dist/consumer-registry-BkuHXR_u.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer-registry-BkuHXR_u.d.mts","names":[],"sources":["../src/queue/queue-consumer.ts","../src/queue/consumer-registry.ts"],"mappings":";;AAMA;;;;;UAAiB,YAAA;EAIf;EAFA,EAAA;EAMA;EAJA,SAAA;EAMA;EAJA,IAAA;EAMG;EAJH,OAAA,EAAS,CAAA;EAIK;EAFd,QAAA;IACE,MAAA;IAAA,CACC,GAAA;EAAA;AAAA;;;;;;;;;;;;;;;;;;;UAsBY,cAAA;EAsBQ;;;;;;EAAA,SAfd,YAAA;ECXE;;;;;EDkBX,MAAA,CAAO,OAAA,EAAS,YAAA,CAAa,CAAA,IAAK,OAAA;ECqDD;;;;;;ED7CjC,OAAA,EAAS,KAAA,EAAO,KAAA,EAAO,OAAA,EAAS,YAAA,CAAa,CAAA,IAAK,OAAA;AAAA;;;AAxDpD;;;;;;;;;;;;;;;AAkCA;;;;;;;;;;;;;;;;AAlCA,cC8Ba,gBAAA;EDkBJ;EAAA,QChBC,eAAA;EDwBR;EAAA,QCrBQ,YAAA;EDqBC;;;;;;;ECZT,QAAA,CAAS,QAAA,EAAU,cAAA;;;AAfrB;;;;;;;;EAuCE,YAAA,CAAa,WAAA,WAAsB,cAAA;EAjC3B;;;;;;EAgDR,YAAA,CAAa,WAAA;EAAb;;;;;EASA,eAAA,CAAA;EASiC;;;;;EAAjC,eAAA,CAAA,GAAmB,cAAA;AAAA"}

package/dist/cron/index.d.mts

@@ -1,119 +1,6 @@
-import { s as ApplicationError } from "../index-BJWm863C.mjs";
-//#region src/cron/cron-job.d.ts
-/**
- * Interface for cron jobs that can be registered by modules
- *
- * Cron jobs are executed when Cloudflare triggers match their schedule.
- * Jobs are registered via the module's getCronJobs() method.
- *
- * @example
- * ```typescript
- * @Transient()
- * export class DataCleanupJob implements CronJob {
- *   readonly schedule = '0 2 * * *' // Daily at 2 AM UTC
- *
- *   constructor(
- *     @inject(LOGGER_TOKENS.LoggerService) private logger: LoggerService,
- *   ) {}
- *
- *   async execute(controller: ScheduledController): Promise<void> {
- *     this.logger.info('Running data cleanup')
- *     await this.cleanupExpiredData()
- *   }
- *
- *   async onError(error: Error): Promise<void> {
- *     this.logger.error('Data cleanup failed', { error: error.message })
- *   }
- * }
- * ```
- */
-interface CronJob {
-  /**
-   * Cron expression that triggers this job
-   *
-   * Must match a cron trigger defined in wrangler.jsonc
-   * @example '0 2 * * *' // Daily at 2 AM UTC
-   * @example '* /15 * * * *' // Every 15 minutes
-   */
-  readonly schedule: string;
-  /**
-   * Execute the cron job
-   *
-   * @param controller - Cloudflare ScheduledController with scheduledTime and cron
-   * @throws ApplicationError for expected errors
-   */
-  execute(controller: ScheduledController): Promise<void>;
-  /**
-   * Optional error handler for job execution failures
-   *
-   * If not provided, errors are logged via GlobalErrorHandler
-   *
-   * @param error - Error that occurred during execution
-   * @param controller - Cloudflare ScheduledController
-   */
-  onError?(error: Error, controller: ScheduledController): Promise<void>;
-}
-//#endregion
-//#region src/cron/cron-manager.d.ts
-/**
- * Manages cron job registration and execution
- *
- * CronManager is a singleton service that:
- * - Registers cron jobs from modules
- * - Routes scheduled events to matching jobs
- * - Handles errors during job execution
- *
- * Jobs are grouped by their cron expression, allowing multiple jobs
- * to run on the same schedule.
- */
-declare class CronManager {
-  /**
-   * Map of cron expressions to jobs
-   * Key: Cron expression (e.g., '0 2 * * *')
-   * Value: Array of jobs matching that expression
-   */
-  private jobs;
-  /**
-   * Register a cron job
-   *
-   * Jobs with the same schedule are grouped together and executed
-   * sequentially when the trigger fires.
-   *
-   * @param job - CronJob instance to register
-   */
-  registerJob(job: CronJob): void;
-  /**
-   * Execute all jobs matching the triggered cron expression
-   *
-   * Jobs are executed sequentially. If a job fails:
-   * - Its onError() hook is called (if defined)
-   * - Execution continues with the next job
-   * - Errors are collected and logged
-   *
-   * @param controller - Cloudflare ScheduledController
-   */
-  executeScheduled(controller: ScheduledController): Promise<void>;
-  /**
-   * Get all registered jobs for a specific cron expression
-   *
-   * @param schedule - Cron expression
-   * @returns Array of jobs for that schedule, or empty array if none
-   */
-  getJobsForSchedule(schedule: string): CronJob[];
-  /**
-   * Get all registered cron expressions
-   *
-   * @returns Array of unique cron expressions
-   */
-  getAllSchedules(): string[];
-  /**
-   * Get total number of registered jobs across all schedules
-   *
-   * @returns Total job count
-   */
-  getTotalJobCount(): number;
-}
-//#endregion
+import { d as ApplicationError } from "../index-BrmS34sa.mjs";
+import { n as CronJob, t as CronManager } from "../cron-manager-BnEZquBL.mjs";
+
 //#region src/cron/errors/cron-execution.error.d.ts
 /**
  * Error thrown when one or more cron jobs fail execution

package/dist/cron/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/cron/cron-job.ts","../../src/cron/cron-manager.ts","../../src/cron/errors/cron-execution.error.ts"],"mappings":";;;;;;AA2BA;;;;;;;;;;;;;;;;;;;;;;;UAAiB,OAAA;;;ACZjB;;;;;WDoBU,QAAA;EC6D6B;;;;;;EDrDtC,OAAA,CAAQ,UAAA,EAAY,mBAAA,GAAsB,OAAA;ECKpC;;;;;;;;EDKN,OAAA,EAAS,KAAA,EAAO,KAAA,EAAO,UAAA,EAAY,mBAAA,GAAsB,OAAA;AAAA;;;;;;AA1B1D;;;;;;;;cCXa,WAAA;EDqCoD;;;;;EAAA,QC/BxD,IAAA;ED+BR;;;;;;;;ECrBA,WAAA,CAAY,GAAA,EAAK,OAAA;;;AAjBlB;;;;;;;;EAiCO,gBAAA,CAAiB,UAAA,EAAY,mBAAA,GAAsB,OAAA;EA1BjD;;;;;;EA0ER,kBAAA,CAAmB,QAAA,WAAmB,OAAA;EAhDmB;;;;;EAyDzD,eAAA,CAAA;EASgB;;;;;EAAhB,gBAAA,CAAA;AAAA;;;;;;ADvFD;;cEnBa,kBAAA,SAA2B,gBAAA;cAEtC,QAAA,UACA,eAAA,UACA,QAAA;AAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/cron/errors/cron-execution.error.ts"],"mappings":";;;;;;;AAQA;;cAAa,kBAAA,SAA2B,gBAAA;cAEtC,QAAA,UACA,eAAA,UACA,QAAA;AAAA"}

package/dist/cron/index.mjs

@@ -1,5 +1,2 @@
-import "../errors-CtCi1wn6.mjs";
-import "../decorate-D5j-d9_z.mjs";
-import "../logger-BR1-s1Um.mjs";
-import { n as CronExecutionError, t as CronManager } from "../cron-manager-DR7fiG6o.mjs";
+import { n as CronExecutionError, t as CronManager } from "../cron-manager-1KnZvojs.mjs";
 export { CronExecutionError, CronManager };

package/dist/{cron-manager-DR7fiG6o.mjs → cron-manager-1KnZvojs.mjs}

@@ -1,5 +1,5 @@
-import { S as ApplicationError, b as ERROR_CODES } from "./errors-CtCi1wn6.mjs";
-import { i as Transient, t as __decorate } from "./decorate-D5j-d9_z.mjs";
+import { H as ApplicationError, k as ERROR_CODES } from "./errors--RBIvDXr.mjs";
+import { a as __decorate, p as Transient } from "./logger-c0ftIK4G.mjs";
 //#region src/cron/errors/cron-execution.error.ts
 /**
 * Error thrown when one or more cron jobs fail execution
@@ -104,4 +104,4 @@ CronManager = __decorate([Transient()], CronManager);
 //#endregion
 export { CronExecutionError as n, CronManager as t };
 
-//# sourceMappingURL=cron-manager-DR7fiG6o.mjs.map
+//# sourceMappingURL=cron-manager-1KnZvojs.mjs.map

package/dist/{cron-manager-DR7fiG6o.mjs.map → cron-manager-1KnZvojs.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"cron-manager-DR7fiG6o.mjs","names":[],"sources":["../src/cron/errors/cron-execution.error.ts","../src/cron/cron-manager.ts"],"sourcesContent":["import { ApplicationError } from '../../errors'\nimport { ERROR_CODES } from '../../errors'\n\n/**\n * Error thrown when one or more cron jobs fail execution\n *\n * This error aggregates failures from multiple jobs that share the same schedule.\n */\nexport class CronExecutionError extends ApplicationError {\n\tconstructor(\n\t\tschedule: string,\n\t\tfailedJobsCount: number,\n\t\tjobNames: string\n\t) {\n\t\tsuper(\n\t\t\t'errors.cronExecutionFailed',\n\t\t\tERROR_CODES.SYSTEM.CRON_EXECUTION_FAILED,\n\t\t\t{\n\t\t\t\tschedule,\n\t\t\t\tcount: failedJobsCount,\n\t\t\t\tjobs: jobNames\n\t\t\t}\n\t\t)\n\t}\n}\n","import { Transient } from '../di/decorators'\nimport type { CronJob } from './cron-job'\nimport { CronExecutionError } from './errors/cron-execution.error'\n\n/**\n * Manages cron job registration and execution\n *\n * CronManager is a singleton service that:\n * - Registers cron jobs from modules\n * - Routes scheduled events to matching jobs\n * - Handles errors during job execution\n *\n * Jobs are grouped by their cron expression, allowing multiple jobs\n * to run on the same schedule.\n */\n@Transient()\nexport class CronManager {\n\t/**\n\t * Map of cron expressions to jobs\n\t * Key: Cron expression (e.g., '0 2 * * *')\n\t * Value: Array of jobs matching that expression\n\t */\n\tprivate jobs = new Map<string, CronJob[]>()\n\n\t/**\n\t * Register a cron job\n\t *\n\t * Jobs with the same schedule are grouped together and executed\n\t * sequentially when the trigger fires.\n\t *\n\t * @param job - CronJob instance to register\n\t */\n\tregisterJob(job: CronJob): void {\n\t\tconst existing = this.jobs.get(job.schedule) ?? []\n\t\texisting.push(job)\n\t\tthis.jobs.set(job.schedule, existing)\n\t}\n\n\t/**\n\t * Execute all jobs matching the triggered cron expression\n\t *\n\t * Jobs are executed sequentially. If a job fails:\n\t * - Its onError() hook is called (if defined)\n\t * - Execution continues with the next job\n\t * - Errors are collected and logged\n\t *\n\t * @param controller - Cloudflare ScheduledController\n\t */\n\tasync executeScheduled(controller: ScheduledController): Promise<void> {\n\t\tconst { cron } = controller\n\t\tconst matchingJobs = this.jobs.get(cron) ?? []\n\n\t\tif (matchingJobs.length === 0) {\n\t\t\treturn\n\t\t}\n\n\t\tconst errors: { job: string; error: Error }[] = []\n\n\t\tfor (const job of matchingJobs) {\n\t\t\tconst jobName = job.constructor.name\n\n\t\t\ttry {\n\t\t\t\tawait job.execute(controller)\n\t\t\t} catch (error) {\n\t\t\t\tconst err = error as Error\n\t\t\t\terrors.push({ job: jobName, error: err })\n\n\t\t\t\t// Call job's error handler if defined\n\t\t\t\tif (job.onError) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tawait job.onError(err, controller)\n\t\t\t\t\t} catch {\n\t\t\t\t\t\t// If onError() itself fails, we just continue\n\t\t\t\t\t\t// The error will be logged by GlobalErrorHandler\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// If any jobs failed, throw an aggregate error\n\t\t// This ensures the error is logged by GlobalErrorHandler\n\t\tif (errors.length > 0) {\n\t\t\tconst jobNames = errors\n\t\t\t\t.map(({ job, error }) => `${job}: ${error.message}`)\n\t\t\t\t.join('; ')\n\n\t\t\tthrow new CronExecutionError(cron, errors.length, jobNames)\n\t\t}\n\t}\n\n\t/**\n\t * Get all registered jobs for a specific cron expression\n\t *\n\t * @param schedule - Cron expression\n\t * @returns Array of jobs for that schedule, or empty array if none\n\t */\n\tgetJobsForSchedule(schedule: string): CronJob[] {\n\t\treturn this.jobs.get(schedule) ?? []\n\t}\n\n\t/**\n\t * Get all registered cron expressions\n\t *\n\t * @returns Array of unique cron expressions\n\t */\n\tgetAllSchedules(): string[] {\n\t\treturn Array.from(this.jobs.keys())\n\t}\n\n\t/**\n\t * Get total number of registered jobs across all schedules\n\t *\n\t * @returns Total job count\n\t */\n\tgetTotalJobCount(): number {\n\t\tlet count = 0\n\t\tfor (const jobs of this.jobs.values()) {\n\t\t\tcount += jobs.length\n\t\t}\n\t\treturn count\n\t}\n}\n"],"mappings":";;;;;;;;AAQA,IAAa,qBAAb,cAAwC,iBAAiB;CACxD,YACC,UACA,iBACA,UACC;AACD,QACC,8BACA,YAAY,OAAO,uBACnB;GACC;GACA,OAAO;GACP,MAAM;GACN,CACD;;;;;ACNI,IAAA,cAAA,MAAM,YAAY;;;;;;CAMxB,uBAAe,IAAI,KAAwB;;;;;;;;;CAU3C,YAAY,KAAoB;EAC/B,MAAM,WAAW,KAAK,KAAK,IAAI,IAAI,SAAS,IAAI,EAAE;AAClD,WAAS,KAAK,IAAI;AAClB,OAAK,KAAK,IAAI,IAAI,UAAU,SAAS;;;;;;;;;;;;CAatC,MAAM,iBAAiB,YAAgD;EACtE,MAAM,EAAE,SAAS;EACjB,MAAM,eAAe,KAAK,KAAK,IAAI,KAAK,IAAI,EAAE;AAE9C,MAAI,aAAa,WAAW,EAC3B;EAGD,MAAM,SAA0C,EAAE;AAElD,OAAK,MAAM,OAAO,cAAc;GAC/B,MAAM,UAAU,IAAI,YAAY;AAEhC,OAAI;AACH,UAAM,IAAI,QAAQ,WAAW;YACrB,OAAO;IACf,MAAM,MAAM;AACZ,WAAO,KAAK;KAAE,KAAK;KAAS,OAAO;KAAK,CAAC;AAGzC,QAAI,IAAI,QACP,KAAI;AACH,WAAM,IAAI,QAAQ,KAAK,WAAW;YAC3B;;;AAUX,MAAI,OAAO,SAAS,GAAG;GACtB,MAAM,WAAW,OACf,KAAK,EAAE,KAAK,YAAY,GAAG,IAAI,IAAI,MAAM,UAAU,CACnD,KAAK,KAAK;AAEZ,SAAM,IAAI,mBAAmB,MAAM,OAAO,QAAQ,SAAS;;;;;;;;;CAU7D,mBAAmB,UAA6B;AAC/C,SAAO,KAAK,KAAK,IAAI,SAAS,IAAI,EAAE;;;;;;;CAQrC,kBAA4B;AAC3B,SAAO,MAAM,KAAK,KAAK,KAAK,MAAM,CAAC;;;;;;;CAQpC,mBAA2B;EAC1B,IAAI,QAAQ;AACZ,OAAK,MAAM,QAAQ,KAAK,KAAK,QAAQ,CACpC,UAAS,KAAK;AAEf,SAAO;;;0BAxGR,WAAW,CAAA,EAAA,YAAA"}
+{"version":3,"file":"cron-manager-1KnZvojs.mjs","names":[],"sources":["../src/cron/errors/cron-execution.error.ts","../src/cron/cron-manager.ts"],"sourcesContent":["import { ApplicationError } from '../../errors'\nimport { ERROR_CODES } from '../../errors'\n\n/**\n * Error thrown when one or more cron jobs fail execution\n *\n * This error aggregates failures from multiple jobs that share the same schedule.\n */\nexport class CronExecutionError extends ApplicationError {\n\tconstructor(\n\t\tschedule: string,\n\t\tfailedJobsCount: number,\n\t\tjobNames: string\n\t) {\n\t\tsuper(\n\t\t\t'errors.cronExecutionFailed',\n\t\t\tERROR_CODES.SYSTEM.CRON_EXECUTION_FAILED,\n\t\t\t{\n\t\t\t\tschedule,\n\t\t\t\tcount: failedJobsCount,\n\t\t\t\tjobs: jobNames\n\t\t\t}\n\t\t)\n\t}\n}\n","import { Transient } from '../di/decorators'\nimport type { CronJob } from './cron-job'\nimport { CronExecutionError } from './errors/cron-execution.error'\n\n/**\n * Manages cron job registration and execution\n *\n * CronManager is a singleton service that:\n * - Registers cron jobs from modules\n * - Routes scheduled events to matching jobs\n * - Handles errors during job execution\n *\n * Jobs are grouped by their cron expression, allowing multiple jobs\n * to run on the same schedule.\n */\n@Transient()\nexport class CronManager {\n\t/**\n\t * Map of cron expressions to jobs\n\t * Key: Cron expression (e.g., '0 2 * * *')\n\t * Value: Array of jobs matching that expression\n\t */\n\tprivate jobs = new Map<string, CronJob[]>()\n\n\t/**\n\t * Register a cron job\n\t *\n\t * Jobs with the same schedule are grouped together and executed\n\t * sequentially when the trigger fires.\n\t *\n\t * @param job - CronJob instance to register\n\t */\n\tregisterJob(job: CronJob): void {\n\t\tconst existing = this.jobs.get(job.schedule) ?? []\n\t\texisting.push(job)\n\t\tthis.jobs.set(job.schedule, existing)\n\t}\n\n\t/**\n\t * Execute all jobs matching the triggered cron expression\n\t *\n\t * Jobs are executed sequentially. If a job fails:\n\t * - Its onError() hook is called (if defined)\n\t * - Execution continues with the next job\n\t * - Errors are collected and logged\n\t *\n\t * @param controller - Cloudflare ScheduledController\n\t */\n\tasync executeScheduled(controller: ScheduledController): Promise<void> {\n\t\tconst { cron } = controller\n\t\tconst matchingJobs = this.jobs.get(cron) ?? []\n\n\t\tif (matchingJobs.length === 0) {\n\t\t\treturn\n\t\t}\n\n\t\tconst errors: { job: string; error: Error }[] = []\n\n\t\tfor (const job of matchingJobs) {\n\t\t\tconst jobName = job.constructor.name\n\n\t\t\ttry {\n\t\t\t\tawait job.execute(controller)\n\t\t\t} catch (error) {\n\t\t\t\tconst err = error as Error\n\t\t\t\terrors.push({ job: jobName, error: err })\n\n\t\t\t\t// Call job's error handler if defined\n\t\t\t\tif (job.onError) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tawait job.onError(err, controller)\n\t\t\t\t\t} catch {\n\t\t\t\t\t\t// If onError() itself fails, we just continue\n\t\t\t\t\t\t// The error will be logged by ExceptionHandler\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// If any jobs failed, throw an aggregate error\n\t\t// This ensures the error is logged by ExceptionHandler\n\t\tif (errors.length > 0) {\n\t\t\tconst jobNames = errors\n\t\t\t\t.map(({ job, error }) => `${job}: ${error.message}`)\n\t\t\t\t.join('; ')\n\n\t\t\tthrow new CronExecutionError(cron, errors.length, jobNames)\n\t\t}\n\t}\n\n\t/**\n\t * Get all registered jobs for a specific cron expression\n\t *\n\t * @param schedule - Cron expression\n\t * @returns Array of jobs for that schedule, or empty array if none\n\t */\n\tgetJobsForSchedule(schedule: string): CronJob[] {\n\t\treturn this.jobs.get(schedule) ?? []\n\t}\n\n\t/**\n\t * Get all registered cron expressions\n\t *\n\t * @returns Array of unique cron expressions\n\t */\n\tgetAllSchedules(): string[] {\n\t\treturn Array.from(this.jobs.keys())\n\t}\n\n\t/**\n\t * Get total number of registered jobs across all schedules\n\t *\n\t * @returns Total job count\n\t */\n\tgetTotalJobCount(): number {\n\t\tlet count = 0\n\t\tfor (const jobs of this.jobs.values()) {\n\t\t\tcount += jobs.length\n\t\t}\n\t\treturn count\n\t}\n}\n"],"mappings":";;;;;;;;AAQA,IAAa,qBAAb,cAAwC,iBAAiB;CACxD,YACC,UACA,iBACA,UACC;AACD,QACC,8BACA,YAAY,OAAO,uBACnB;GACC;GACA,OAAO;GACP,MAAM;GACN,CACD;;;;;ACNI,IAAA,cAAA,MAAM,YAAY;;;;;;CAMxB,uBAAe,IAAI,KAAwB;;;;;;;;;CAU3C,YAAY,KAAoB;EAC/B,MAAM,WAAW,KAAK,KAAK,IAAI,IAAI,SAAS,IAAI,EAAE;AAClD,WAAS,KAAK,IAAI;AAClB,OAAK,KAAK,IAAI,IAAI,UAAU,SAAS;;;;;;;;;;;;CAatC,MAAM,iBAAiB,YAAgD;EACtE,MAAM,EAAE,SAAS;EACjB,MAAM,eAAe,KAAK,KAAK,IAAI,KAAK,IAAI,EAAE;AAE9C,MAAI,aAAa,WAAW,EAC3B;EAGD,MAAM,SAA0C,EAAE;AAElD,OAAK,MAAM,OAAO,cAAc;GAC/B,MAAM,UAAU,IAAI,YAAY;AAEhC,OAAI;AACH,UAAM,IAAI,QAAQ,WAAW;YACrB,OAAO;IACf,MAAM,MAAM;AACZ,WAAO,KAAK;KAAE,KAAK;KAAS,OAAO;KAAK,CAAC;AAGzC,QAAI,IAAI,QACP,KAAI;AACH,WAAM,IAAI,QAAQ,KAAK,WAAW;YAC3B;;;AAUX,MAAI,OAAO,SAAS,GAAG;GACtB,MAAM,WAAW,OACf,KAAK,EAAE,KAAK,YAAY,GAAG,IAAI,IAAI,MAAM,UAAU,CACnD,KAAK,KAAK;AAEZ,SAAM,IAAI,mBAAmB,MAAM,OAAO,QAAQ,SAAS;;;;;;;;;CAU7D,mBAAmB,UAA6B;AAC/C,SAAO,KAAK,KAAK,IAAI,SAAS,IAAI,EAAE;;;;;;;CAQrC,kBAA4B;AAC3B,SAAO,MAAM,KAAK,KAAK,KAAK,MAAM,CAAC;;;;;;;CAQpC,mBAA2B;EAC1B,IAAI,QAAQ;AACZ,OAAK,MAAM,QAAQ,KAAK,KAAK,QAAQ,CACpC,UAAS,KAAK;AAEf,SAAO;;;0BAxGR,WAAW,CAAA,EAAA,YAAA"}

package/dist/cron-manager-BnEZquBL.d.mts

@@ -0,0 +1,117 @@
+//#region src/cron/cron-job.d.ts
+/**
+ * Interface for cron jobs that can be registered by modules
+ *
+ * Cron jobs are executed when Cloudflare triggers match their schedule.
+ * Jobs are registered via the module's getCronJobs() method.
+ *
+ * @example
+ * ```typescript
+ * @Transient()
+ * export class DataCleanupJob implements CronJob {
+ *   readonly schedule = '0 2 * * *' // Daily at 2 AM UTC
+ *
+ *   constructor(
+ *     @inject(LOGGER_TOKENS.LoggerService) private logger: LoggerService,
+ *   ) {}
+ *
+ *   async execute(controller: ScheduledController): Promise<void> {
+ *     this.logger.info('Running data cleanup')
+ *     await this.cleanupExpiredData()
+ *   }
+ *
+ *   async onError(error: Error): Promise<void> {
+ *     this.logger.error('Data cleanup failed', { error: error.message })
+ *   }
+ * }
+ * ```
+ */
+interface CronJob {
+  /**
+   * Cron expression that triggers this job
+   *
+   * Must match a cron trigger defined in wrangler.jsonc
+   * @example '0 2 * * *' // Daily at 2 AM UTC
+   * @example '* /15 * * * *' // Every 15 minutes
+   */
+  readonly schedule: string;
+  /**
+   * Execute the cron job
+   *
+   * @param controller - Cloudflare ScheduledController with scheduledTime and cron
+   * @throws ApplicationError for expected errors
+   */
+  execute(controller: ScheduledController): Promise<void>;
+  /**
+   * Optional error handler for job execution failures
+   *
+   * If not provided, errors are logged via ExceptionHandler
+   *
+   * @param error - Error that occurred during execution
+   * @param controller - Cloudflare ScheduledController
+   */
+  onError?(error: Error, controller: ScheduledController): Promise<void>;
+}
+//#endregion
+//#region src/cron/cron-manager.d.ts
+/**
+ * Manages cron job registration and execution
+ *
+ * CronManager is a singleton service that:
+ * - Registers cron jobs from modules
+ * - Routes scheduled events to matching jobs
+ * - Handles errors during job execution
+ *
+ * Jobs are grouped by their cron expression, allowing multiple jobs
+ * to run on the same schedule.
+ */
+declare class CronManager {
+  /**
+   * Map of cron expressions to jobs
+   * Key: Cron expression (e.g., '0 2 * * *')
+   * Value: Array of jobs matching that expression
+   */
+  private jobs;
+  /**
+   * Register a cron job
+   *
+   * Jobs with the same schedule are grouped together and executed
+   * sequentially when the trigger fires.
+   *
+   * @param job - CronJob instance to register
+   */
+  registerJob(job: CronJob): void;
+  /**
+   * Execute all jobs matching the triggered cron expression
+   *
+   * Jobs are executed sequentially. If a job fails:
+   * - Its onError() hook is called (if defined)
+   * - Execution continues with the next job
+   * - Errors are collected and logged
+   *
+   * @param controller - Cloudflare ScheduledController
+   */
+  executeScheduled(controller: ScheduledController): Promise<void>;
+  /**
+   * Get all registered jobs for a specific cron expression
+   *
+   * @param schedule - Cron expression
+   * @returns Array of jobs for that schedule, or empty array if none
+   */
+  getJobsForSchedule(schedule: string): CronJob[];
+  /**
+   * Get all registered cron expressions
+   *
+   * @returns Array of unique cron expressions
+   */
+  getAllSchedules(): string[];
+  /**
+   * Get total number of registered jobs across all schedules
+   *
+   * @returns Total job count
+   */
+  getTotalJobCount(): number;
+}
+//#endregion
+export { CronJob as n, CronManager as t };
+//# sourceMappingURL=cron-manager-BnEZquBL.d.mts.map