stratal 0.0.22 → 0.0.24

package/dist/{controller.decorator-DIUazNU7.mjs → controller.decorator-C5UVeJS3.mjs}

@@ -1,6 +1,6 @@
-import { d as Transient } from "./di-BO1QIb5H.mjs";
-import { n as getMetadata, t as defineMetadata } from "./metadata-BVkc4aUu.mjs";
-import { u as ROUTE_METADATA_KEYS } from "./exception-context-B4kM-M53.mjs";
+import { c as Transient } from "./di-DseMn-z9.mjs";
+import { n as getMetadata, t as defineMetadata } from "./metadata-DzzprcID.mjs";
+import { u as ROUTE_METADATA_KEYS } from "./exception-context-kEoMFwze.mjs";
 //#region src/router/decorators/controller.decorator.ts
 const CONTROLLER_ROUTE_KEY = ROUTE_METADATA_KEYS.CONTROLLER_ROUTE;
 /**
@@ -63,4 +63,4 @@ function getControllerVersion(target) {
 //#endregion
 export { getControllerVersion as i, getControllerOptions as n, getControllerRoute as r, Controller as t };
 
-//# sourceMappingURL=controller.decorator-DIUazNU7.mjs.map
+//# sourceMappingURL=controller.decorator-C5UVeJS3.mjs.map

package/dist/{controller.decorator-DIUazNU7.mjs.map → controller.decorator-C5UVeJS3.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"controller.decorator-DIUazNU7.mjs","names":[],"sources":["../src/router/decorators/controller.decorator.ts"],"sourcesContent":["import { Transient } from '../../di/decorators'\nimport { defineMetadata, getMetadata } from '../../di/metadata'\nimport { type Constructor } from '../../types'\nimport { ROUTE_METADATA_KEYS } from '../constants'\nimport { type ControllerOptions } from '../types'\n\nconst CONTROLLER_ROUTE_KEY = ROUTE_METADATA_KEYS.CONTROLLER_ROUTE\n\n/**\n * Base controller decorator for route registration\n *\n * This is the core controller decorator that handles:\n * - Transient scope registration (request-scoped)\n * - Route metadata storage\n * - Controller options (tags, security schemes, hideFromDocs)\n *\n * @param route - Base route for this controller (e.g., '/api/v1/users')\n * @param options - Optional configuration (tags, security schemes, hideFromDocs)\n *\n * @example\n * ```typescript\n * import { Controller } from 'stratal/router'\n *\n * @Controller('/api/v1/users', { tags: ['Users'] })\n * export class UsersController implements IController {\n *   // All routes accessible\n * }\n * ```\n */\nexport function Controller(route: string, options?: ControllerOptions) {\n  return function <T extends Constructor>(target: T) {\n    // Wrap @Transient (handles @injectable and scope metadata)\n    Transient()(target)\n\n    // Store route metadata on the class\n    defineMetadata(CONTROLLER_ROUTE_KEY, route, target)\n\n    // Store options metadata if provided\n    if (options) {\n      defineMetadata(ROUTE_METADATA_KEYS.CONTROLLER_OPTIONS, options, target)\n    }\n\n    return target\n  }\n}\n\n/**\n * Get the route from controller class metadata\n *\n * @param target - Controller class or instance\n * @returns Route string or undefined if not set\n */\nexport function getControllerRoute(target: object): string | undefined {\n  // Check if target is a class constructor (function) or an instance\n  // If class, get metadata from it directly; if instance, get from constructor\n  const metadataTarget = typeof target === 'function' ? target : (target as { constructor: object }).constructor\n  return getMetadata<string>(CONTROLLER_ROUTE_KEY, metadataTarget)\n}\n\n/**\n * Get the options from controller class metadata\n *\n * @param target - Controller class or instance\n * @returns Controller options or undefined if not set\n */\nexport function getControllerOptions(target: object): ControllerOptions | undefined {\n  const metadataTarget = typeof target === 'function' ? target : (target as { constructor: object }).constructor\n  return getMetadata<ControllerOptions>(ROUTE_METADATA_KEYS.CONTROLLER_OPTIONS, metadataTarget)\n}\n\n/**\n * Get the version from controller class metadata\n *\n * @param target - Controller class or instance\n * @returns Version string, array, VERSION_NEUTRAL symbol, or undefined if not set\n */\nexport function getControllerVersion(target: object): ControllerOptions['version'] {\n  const options = getControllerOptions(target)\n  return options?.version\n}\n"],"mappings":";;;;AAMA,MAAM,uBAAuB,oBAAoB;;;;;;;;;;;;;;;;;;;;;;AAuBjD,SAAgB,WAAW,OAAe,SAA6B;CACrE,OAAO,SAAiC,QAAW;EAEjD,WAAW,CAAC,OAAO;EAGnB,eAAe,sBAAsB,OAAO,OAAO;EAGnD,IAAI,SACF,eAAe,oBAAoB,oBAAoB,SAAS,OAAO;EAGzE,OAAO;;;;;;;;;AAUX,SAAgB,mBAAmB,QAAoC;CAIrE,OAAO,YAAoB,sBADJ,OAAO,WAAW,aAAa,SAAU,OAAmC,YACnC;;;;;;;;AASlE,SAAgB,qBAAqB,QAA+C;CAClF,MAAM,iBAAiB,OAAO,WAAW,aAAa,SAAU,OAAmC;CACnG,OAAO,YAA+B,oBAAoB,oBAAoB,eAAe;;;;;;;;AAS/F,SAAgB,qBAAqB,QAA8C;CAEjF,OADgB,qBAAqB,OACvB,EAAE"}
+{"version":3,"file":"controller.decorator-C5UVeJS3.mjs","names":[],"sources":["../src/router/decorators/controller.decorator.ts"],"sourcesContent":["import { Transient } from '../../di/decorators'\nimport { defineMetadata, getMetadata } from '../../di/metadata'\nimport { type Constructor } from '../../types'\nimport { ROUTE_METADATA_KEYS } from '../constants'\nimport { type ControllerOptions } from '../types'\n\nconst CONTROLLER_ROUTE_KEY = ROUTE_METADATA_KEYS.CONTROLLER_ROUTE\n\n/**\n * Base controller decorator for route registration\n *\n * This is the core controller decorator that handles:\n * - Transient scope registration (request-scoped)\n * - Route metadata storage\n * - Controller options (tags, security schemes, hideFromDocs)\n *\n * @param route - Base route for this controller (e.g., '/api/v1/users')\n * @param options - Optional configuration (tags, security schemes, hideFromDocs)\n *\n * @example\n * ```typescript\n * import { Controller } from 'stratal/router'\n *\n * @Controller('/api/v1/users', { tags: ['Users'] })\n * export class UsersController implements IController {\n *   // All routes accessible\n * }\n * ```\n */\nexport function Controller(route: string, options?: ControllerOptions) {\n  return function <T extends Constructor>(target: T) {\n    // Wrap @Transient (handles @injectable and scope metadata)\n    Transient()(target)\n\n    // Store route metadata on the class\n    defineMetadata(CONTROLLER_ROUTE_KEY, route, target)\n\n    // Store options metadata if provided\n    if (options) {\n      defineMetadata(ROUTE_METADATA_KEYS.CONTROLLER_OPTIONS, options, target)\n    }\n\n    return target\n  }\n}\n\n/**\n * Get the route from controller class metadata\n *\n * @param target - Controller class or instance\n * @returns Route string or undefined if not set\n */\nexport function getControllerRoute(target: object): string | undefined {\n  // Check if target is a class constructor (function) or an instance\n  // If class, get metadata from it directly; if instance, get from constructor\n  const metadataTarget = typeof target === 'function' ? target : (target as { constructor: object }).constructor\n  return getMetadata<string>(CONTROLLER_ROUTE_KEY, metadataTarget)\n}\n\n/**\n * Get the options from controller class metadata\n *\n * @param target - Controller class or instance\n * @returns Controller options or undefined if not set\n */\nexport function getControllerOptions(target: object): ControllerOptions | undefined {\n  const metadataTarget = typeof target === 'function' ? target : (target as { constructor: object }).constructor\n  return getMetadata<ControllerOptions>(ROUTE_METADATA_KEYS.CONTROLLER_OPTIONS, metadataTarget)\n}\n\n/**\n * Get the version from controller class metadata\n *\n * @param target - Controller class or instance\n * @returns Version string, array, VERSION_NEUTRAL symbol, or undefined if not set\n */\nexport function getControllerVersion(target: object): ControllerOptions['version'] {\n  const options = getControllerOptions(target)\n  return options?.version\n}\n"],"mappings":";;;;AAMA,MAAM,uBAAuB,oBAAoB;;;;;;;;;;;;;;;;;;;;;;AAuBjD,SAAgB,WAAW,OAAe,SAA6B;CACrE,OAAO,SAAiC,QAAW;EAEjD,UAAU,EAAE,MAAM;EAGlB,eAAe,sBAAsB,OAAO,MAAM;EAGlD,IAAI,SACF,eAAe,oBAAoB,oBAAoB,SAAS,MAAM;EAGxE,OAAO;CACT;AACF;;;;;;;AAQA,SAAgB,mBAAmB,QAAoC;CAIrE,OAAO,YAAoB,sBADJ,OAAO,WAAW,aAAa,SAAU,OAAmC,WACpC;AACjE;;;;;;;AAQA,SAAgB,qBAAqB,QAA+C;CAClF,MAAM,iBAAiB,OAAO,WAAW,aAAa,SAAU,OAAmC;CACnG,OAAO,YAA+B,oBAAoB,oBAAoB,cAAc;AAC9F;;;;;;;AAQA,SAAgB,qBAAqB,QAA8C;CAEjF,OADgB,qBAAqB,MACxB,GAAG;AAClB"}

package/dist/cron/index.d.mts

@@ -1,7 +1,82 @@
-import { xr as ApplicationError } from "../index-DEncMcC6.mjs";
-import { n as CronJob, r as RegisteredJob, t as CronManager } from "../cron-manager-CSTIBPcM.mjs";
-import { ScheduledController } from "@cloudflare/workers-types";
+import { Dr as ApplicationError, Y as Container } from "../index-B_JoEl3V.mjs";
+import { n as RegisteredJob, t as CronJob } from "../cron-job-NesZRk8F.mjs";
+import { ScheduledController as ScheduledController$1 } from "@cloudflare/workers-types";
 
+//#region src/cron/cron-manager.d.ts
+/**
+ * Manages cron job registration and execution
+ *
+ * CronManager is a singleton service that:
+ * - Registers cron job class references from modules
+ * - Routes scheduled events to matching jobs
+ * - Resolves jobs from a request-scoped container at execution time
+ *
+ * Jobs are grouped by their cron expression, allowing multiple jobs
+ * to run on the same schedule.
+ */
+declare class CronManager {
+  /**
+   * Map of cron expressions to registered job entries
+   * Key: Cron expression (e.g., '0 2 * * *')
+   * Value: Array of registered jobs (class ref + schedule)
+   */
+  private jobs;
+  /**
+   * Register a cron job class
+   *
+   * Jobs with the same schedule are grouped together and executed
+   * sequentially when the trigger fires.
+   *
+   * @param schedule - Cron expression (e.g., '0 2 * * *')
+   * @param jobClass - CronJob class constructor (resolved at execution time)
+   */
+  registerJob(schedule: string, jobClass: RegisteredJob['jobClass']): void;
+  /**
+   * Execute all jobs matching the triggered cron expression
+   *
+   * Jobs are resolved from the provided request-scoped container,
+   * ensuring dependencies (e.g. database) are properly scoped.
+   *
+   * 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 thrown as CronExecutionError
+   *
+   * @param controller - Cloudflare ScheduledController
+   * @param container - Request-scoped container to resolve jobs from
+   */
+  executeScheduled(controller: ScheduledController, container: Container): Promise<void>;
+  /**
+   * Get all registered jobs for a specific cron expression
+   *
+   * @param schedule - Cron expression
+   * @returns Array of registered jobs, or empty array if none
+   */
+  getJobsForSchedule(schedule: string): RegisteredJob[];
+  /**
+   * 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
+//#region src/cron/cron.module.d.ts
+/**
+ * Registers the cron manager (`DI_TOKENS.Cron`).
+ *
+ * Lazy: loaded on demand via `await import()` — by `Application.ensureCron`
+ * (first scheduled trigger, or at bootstrap when the app declares jobs) and by
+ * the `schedule:list` command. Kept out of cold start for apps without cron.
+ */
+declare class CronModule {}
+//#endregion
 //#region src/cron/errors/cron-execution.error.d.ts
 interface CronJobFailure {
   job: string;
@@ -33,5 +108,5 @@ declare class CronExecutionError extends ApplicationError {
   constructor(schedule: string, failures: CronJobFailure[]);
 }
 //#endregion
-export { CronExecutionError, type CronJob, CronManager, type RegisteredJob, type ScheduledController };
+export { CronExecutionError, type CronJob, CronManager, CronModule, type RegisteredJob, type ScheduledController$1 as ScheduledController };
 //# sourceMappingURL=index.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/cron/errors/cron-execution.error.ts"],"mappings":";;;;;UAEiB,cAAA;EAChB,GAAA;EACA,KAAA,EAAO,KAAA;AAAA;AAAA,UAGE,oBAAA;EACT,GAAA;EACA,IAAA;EACA,IAAA;EACA,OAAA;EACA,WAAA;EACA,GAAA;AAAA;;AARA;;;;;;;;;cAqBY,kBAAA,SAA2B,gBAAA;EAAA,SACvB,QAAA,WAAmB,cAAA;EAAA,SACnB,QAAA;EAAA,SACA,YAAA;EAAA,SACA,IAAA,EAAM,oBAAA;cAEV,QAAA,UAAkB,QAAA,EAAU,cAAA;AAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/cron/cron-manager.ts","../../src/cron/cron.module.ts","../../src/cron/errors/cron-execution.error.ts"],"mappings":";;;;;;;;AAmBA;;;;;;;;cACa,WAAA;EA0FuC;;;;;EAAA,QApF3C,IAAA;EA+BF;;;;;;;;;EApBN,WAAA,CAAY,QAAA,UAAkB,QAAA,EAAU,aAAA;EA2FxC;;AAAgB;;;;ACrHjB;;;;AAKuB;;;;EDyChB,gBAAA,CAAiB,UAAA,EAAY,mBAAA,EAAqB,SAAA,EAAW,SAAA,GAAY,OAAA;EEvDjD;;;;;;EF4G9B,kBAAA,CAAmB,QAAA,WAAmB,aAAA;EE1G1B;AACZ;;;;EFkHA,eAAA;EE9GA;;;;;EFuHA,gBAAA;AAAA;;;;;;;;AA7GD;;cCHa,UAAA;;;UCdI,cAAA;EAChB,GAAA;EACA,KAAA,EAAO,KAAK;AAAA;AAAA,UAGH,oBAAA;EACT,GAAA;EACA,IAAA;EACA,IAAA;EACA,OAAA;EACA,WAAA;EACA,GAAA;AAAA;;;;;;;;;;;cAaY,kBAAA,SAA2B,gBAAA;EAAA,SACvB,QAAA,WAAmB,cAAA;EAAA,SACnB,QAAA;EAAA,SACA,YAAA;EAAA,SACA,IAAA,EAAM,oBAAA;cAEV,QAAA,UAAkB,QAAA,EAAU,cAAA;AAAA"}

package/dist/cron/index.mjs

@@ -1,2 +1,2 @@
-import { n as CronExecutionError, t as CronManager } from "../cron-manager-9bpN9bu4.mjs";
-export { CronExecutionError, CronManager };
+import { i as CronExecutionError, r as CronManager, t as CronModule } from "../cron.module-Bgzq5hiT.mjs";
+export { CronExecutionError, CronManager, CronModule };

package/dist/cron-job-NesZRk8F.d.mts

@@ -0,0 +1,58 @@
+import { t as Constructor } from "./types-CmV_9xBD.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.
+ * The `schedule` property must be declared as a **static** field so the
+ * framework can read it at registration time without instantiating the class.
+ *
+ * @example
+ * ```typescript
+ * @Transient()
+ * export class DataCleanupJob implements CronJob {
+ *   static 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 RegisteredJob {
+  /** The cron schedule expression */
+  schedule: string;
+  /** The job class constructor (resolved from container at execution time) */
+  jobClass: Constructor<CronJob>;
+}
+interface CronJob {
+  /**
+   * 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
+export { RegisteredJob as n, CronJob as t };
+//# sourceMappingURL=cron-job-NesZRk8F.d.mts.map

package/dist/cron-job-NesZRk8F.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-job-NesZRk8F.d.mts","names":[],"sources":["../src/cron/cron-job.ts"],"mappings":";;;;;AA8BA;;;;;;;;;AAI8B;AAG9B;;;;;;;;;;;;;;;;UAPiB,aAAA;EAwBmB;EAtBnC,QAAA;EAsByD;EApBzD,QAAA,EAAU,WAAW,CAAC,OAAA;AAAA;AAAA,UAGN,OAAA;;;;;;;EAOhB,OAAA,CAAQ,UAAA,EAAY,mBAAA,GAAsB,OAAA;;;;;;;;;EAU1C,OAAA,EAAS,KAAA,EAAO,KAAA,EAAO,UAAA,EAAY,mBAAA,GAAsB,OAAA;AAAA"}

package/dist/{cron-manager-9bpN9bu4.mjs → cron.module-Bgzq5hiT.mjs}

@@ -1,8 +1,10 @@
-import { a as ApplicationError } from "./container-storage-GpNNz79X.mjs";
-import { d as Transient } from "./di-BO1QIb5H.mjs";
-import { t as __decorate } from "./decorate-HgTKAYK8.mjs";
+import { t as __exportAll } from "./chunk-BBjsoOtd.mjs";
+import { r as DI_TOKENS, s as Singleton } from "./di-DseMn-z9.mjs";
+import { a as ApplicationError } from "./container-storage-BmOJ4_Na.mjs";
+import { t as __decorate } from "./decorate-CuAoSZvs.mjs";
 import { LOGGER_TOKENS } from "./logger/index.mjs";
-import "./errors-BBZTnjdq.mjs";
+import "./errors-mXYxG0XB.mjs";
+import { n as Module } from "./module.decorator-CYHY6pG5.mjs";
 //#region src/cron/errors/cron-execution.error.ts
 /**
 * Error thrown when one or more cron jobs fail execution.
@@ -136,8 +138,16 @@ let CronManager = class CronManager {
 		return count;
 	}
 };
-CronManager = __decorate([Transient()], CronManager);
+CronManager = __decorate([Singleton(DI_TOKENS.Cron)], CronManager);
 //#endregion
-export { CronExecutionError as n, CronManager as t };
+//#region src/cron/cron.module.ts
+var cron_module_exports = /* @__PURE__ */ __exportAll({ CronModule: () => CronModule });
+let CronModule = class CronModule {};
+CronModule = __decorate([Module({ providers: [{
+	provide: DI_TOKENS.Cron,
+	useClass: CronManager
+}] })], CronModule);
+//#endregion
+export { CronExecutionError as i, cron_module_exports as n, CronManager as r, CronModule as t };
 
-//# sourceMappingURL=cron-manager-9bpN9bu4.mjs.map
+//# sourceMappingURL=cron.module-Bgzq5hiT.mjs.map

package/dist/cron.module-Bgzq5hiT.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.module-Bgzq5hiT.mjs","names":[],"sources":["../src/cron/errors/cron-execution.error.ts","../src/cron/cron-manager.ts","../src/cron/cron.module.ts"],"sourcesContent":["import { ApplicationError } from '../../errors'\n\nexport interface CronJobFailure {\n\tjob: string\n\terror: Error\n}\n\ninterface SerializedJobFailure {\n\tjob: string\n\tname: string\n\tcode?: number | string\n\tmessage: string\n\tdbErrorCode?: string\n\tsql?: string\n}\n\n/**\n * Error thrown when one or more cron jobs fail execution.\n *\n * Aggregates failures from multiple jobs that share the same schedule while\n * preserving each underlying error:\n * - The originals are kept on `this.failures` for typed access.\n * - `this.cause` is set to the only failure (1 job) or an `AggregateError`\n *   wrapping all of them (2+ jobs), so `LoggerService.serializeError` can\n *   walk the chain and surface every stack/cause.\n */\nexport class CronExecutionError extends ApplicationError {\n\tpublic readonly failures: readonly CronJobFailure[]\n\tpublic readonly schedule: string\n\tpublic readonly failureCount: number\n\tpublic readonly jobs: SerializedJobFailure[]\n\n\tconstructor(schedule: string, failures: CronJobFailure[]) {\n\t\tconst cause =\n\t\t\tfailures.length === 0\n\t\t\t\t? undefined\n\t\t\t\t: failures.length === 1\n\t\t\t\t\t? failures[0].error\n\t\t\t\t\t: new AggregateError(failures.map((f) => f.error), `${failures.length} cron jobs failed`)\n\n\t\tsuper(\n\t\t\t`${failures.length} cron job(s) failed for schedule \"${schedule}\"`,\n\t\t\tcause,\n\t\t)\n\n\t\tthis.failures = failures\n\t\tthis.schedule = schedule\n\t\tthis.failureCount = failures.length\n\t\tthis.jobs = failures.map((f) => serializeFailure(f))\n\t}\n}\n\nfunction serializeFailure({ job, error }: CronJobFailure): SerializedJobFailure {\n\tconst out: SerializedJobFailure = {\n\t\tjob,\n\t\tname: error.name,\n\t\tmessage: error.message,\n\t}\n\tconst maybeCoded = error as { code?: number | string }\n\tif (maybeCoded.code !== undefined) out.code = maybeCoded.code\n\treturn out\n}\n","import type { Container } from '../di/container'\nimport { Singleton } from '../di/decorators'\nimport { DI_TOKENS } from '../di/tokens'\nimport { LOGGER_TOKENS } from '../logger/logger.tokens'\nimport type { LoggerService } from '../logger/services/logger.service'\nimport type { CronJob, RegisteredJob } 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 job class references from modules\n * - Routes scheduled events to matching jobs\n * - Resolves jobs from a request-scoped container at execution time\n *\n * Jobs are grouped by their cron expression, allowing multiple jobs\n * to run on the same schedule.\n */\n@Singleton(DI_TOKENS.Cron)\nexport class CronManager {\n\t/**\n\t * Map of cron expressions to registered job entries\n\t * Key: Cron expression (e.g., '0 2 * * *')\n\t * Value: Array of registered jobs (class ref + schedule)\n\t */\n\tprivate jobs = new Map<string, RegisteredJob[]>()\n\n\t/**\n\t * Register a cron job class\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 schedule - Cron expression (e.g., '0 2 * * *')\n\t * @param jobClass - CronJob class constructor (resolved at execution time)\n\t */\n\tregisterJob(schedule: string, jobClass: RegisteredJob['jobClass']): void {\n\t\tconst existing = this.jobs.get(schedule) ?? []\n\t\texisting.push({ schedule, jobClass })\n\t\tthis.jobs.set(schedule, existing)\n\t}\n\n\t/**\n\t * Execute all jobs matching the triggered cron expression\n\t *\n\t * Jobs are resolved from the provided request-scoped container,\n\t * ensuring dependencies (e.g. database) are properly scoped.\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 thrown as CronExecutionError\n\t *\n\t * @param controller - Cloudflare ScheduledController\n\t * @param container - Request-scoped container to resolve jobs from\n\t */\n\tasync executeScheduled(controller: ScheduledController, container: Container): 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\tconst logger = container.resolve<LoggerService>(LOGGER_TOKENS.LoggerService)\n\t\t\tlogger.warn('No cron jobs matched scheduled trigger', {\n\t\t\t\tincomingCron: cron,\n\t\t\t\tregisteredSchedules: Array.from(this.jobs.keys()),\n\t\t\t})\n\t\t\treturn\n\t\t}\n\n\t\tconst errors: { job: string; error: Error }[] = []\n\n\t\tfor (const { jobClass } of matchingJobs) {\n\t\t\tconst jobName = jobClass.name\n\n\t\t\ttry {\n\t\t\t\t// Register the job class in the request-scoped container so its\n\t\t\t\t// dependencies are resolved from request scope (not the parent).\n\t\t\t\tcontainer.register(jobClass, jobClass)\n\t\t\t\tconst job = container.resolve<CronJob>(jobClass)\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// Try to resolve and call onError if possible\n\t\t\t\ttry {\n\t\t\t\t\tconst job = container.resolve<CronJob>(jobClass)\n\t\t\t\t\tif (job.onError) {\n\t\t\t\t\t\tawait job.onError(err, controller)\n\t\t\t\t\t}\n\t\t\t\t} catch {\n\t\t\t\t\t// If resolution or onError fails, continue\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// If any jobs failed, throw an aggregate error so ExceptionHandler logs\n\t\t// it. The full per-job errors are passed through so cause/stacks survive.\n\t\tif (errors.length > 0) {\n\t\t\tthrow new CronExecutionError(cron, errors)\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 registered jobs, or empty array if none\n\t */\n\tgetJobsForSchedule(schedule: string): RegisteredJob[] {\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","import { DI_TOKENS } from '../di/tokens'\nimport { Module } from '../module/module.decorator'\nimport { CronManager } from './cron-manager'\n\n/**\n * Registers the cron manager (`DI_TOKENS.Cron`).\n *\n * Lazy: loaded on demand via `await import()` — by `Application.ensureCron`\n * (first scheduled trigger, or at bootstrap when the app declares jobs) and by\n * the `schedule:list` command. Kept out of cold start for apps without cron.\n */\n@Module({\n  providers: [\n    { provide: DI_TOKENS.Cron, useClass: CronManager },\n  ],\n})\nexport class CronModule { }\n"],"mappings":";;;;;;;;;;;;;;;;;;AA0BA,IAAa,qBAAb,cAAwC,iBAAiB;CACxD;CACA;CACA;CACA;CAEA,YAAY,UAAkB,UAA4B;EACzD,MAAM,QACL,SAAS,WAAW,IACjB,KAAA,IACA,SAAS,WAAW,IACnB,SAAS,GAAG,QACZ,IAAI,eAAe,SAAS,KAAK,MAAM,EAAE,KAAK,GAAG,GAAG,SAAS,OAAO,kBAAkB;EAE3F,MACC,GAAG,SAAS,OAAO,oCAAoC,SAAS,IAChE,KACD;EAEA,KAAK,WAAW;EAChB,KAAK,WAAW;EAChB,KAAK,eAAe,SAAS;EAC7B,KAAK,OAAO,SAAS,KAAK,MAAM,iBAAiB,CAAC,CAAC;CACpD;AACD;AAEA,SAAS,iBAAiB,EAAE,KAAK,SAA+C;CAC/E,MAAM,MAA4B;EACjC;EACA,MAAM,MAAM;EACZ,SAAS,MAAM;CAChB;CACA,MAAM,aAAa;CACnB,IAAI,WAAW,SAAS,KAAA,GAAW,IAAI,OAAO,WAAW;CACzD,OAAO;AACR;;;ACzCO,IAAA,cAAA,MAAM,YAAY;;;;;;CAMxB,uBAAe,IAAI,IAA6B;;;;;;;;;;CAWhD,YAAY,UAAkB,UAA2C;EACxE,MAAM,WAAW,KAAK,KAAK,IAAI,QAAQ,KAAK,CAAC;EAC7C,SAAS,KAAK;GAAE;GAAU;EAAS,CAAC;EACpC,KAAK,KAAK,IAAI,UAAU,QAAQ;CACjC;;;;;;;;;;;;;;;CAgBA,MAAM,iBAAiB,YAAiC,WAAqC;EAC5F,MAAM,EAAE,SAAS;EACjB,MAAM,eAAe,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC;EAE7C,IAAI,aAAa,WAAW,GAAG;GAE9B,UADyB,QAAuB,cAAc,aACzD,EAAE,KAAK,0CAA0C;IACrD,cAAc;IACd,qBAAqB,MAAM,KAAK,KAAK,KAAK,KAAK,CAAC;GACjD,CAAC;GACD;EACD;EAEA,MAAM,SAA0C,CAAC;EAEjD,KAAK,MAAM,EAAE,cAAc,cAAc;GACxC,MAAM,UAAU,SAAS;GAEzB,IAAI;IAGH,UAAU,SAAS,UAAU,QAAQ;IAErC,MADY,UAAU,QAAiB,QAC/B,EAAE,QAAQ,UAAU;GAC7B,SAAS,OAAO;IACf,MAAM,MAAM;IACZ,OAAO,KAAK;KAAE,KAAK;KAAS,OAAO;IAAI,CAAC;IAGxC,IAAI;KACH,MAAM,MAAM,UAAU,QAAiB,QAAQ;KAC/C,IAAI,IAAI,SACP,MAAM,IAAI,QAAQ,KAAK,UAAU;IAEnC,QAAQ,CAER;GACD;EACD;EAIA,IAAI,OAAO,SAAS,GACnB,MAAM,IAAI,mBAAmB,MAAM,MAAM;CAE3C;;;;;;;CAQA,mBAAmB,UAAmC;EACrD,OAAO,KAAK,KAAK,IAAI,QAAQ,KAAK,CAAC;CACpC;;;;;;CAOA,kBAA4B;EAC3B,OAAO,MAAM,KAAK,KAAK,KAAK,KAAK,CAAC;CACnC;;;;;;CAOA,mBAA2B;EAC1B,IAAI,QAAQ;EACZ,KAAK,MAAM,QAAQ,KAAK,KAAK,OAAO,GACnC,SAAS,KAAK;EAEf,OAAO;CACR;AACD;0BApHC,UAAU,UAAU,IAAI,CAAA,GAAA,WAAA;;;;ACHlB,IAAA,aAAA,MAAM,WAAW,CAAE;yBALzB,OAAO,EACN,WAAW,CACT;CAAE,SAAS,UAAU;CAAM,UAAU;AAAY,CACnD,EACF,CAAC,CAAA,GAAA,UAAA"}

package/dist/{decorate-HgTKAYK8.mjs → decorate-CuAoSZvs.mjs}

@@ -1,11 +1,11 @@
-//#region \0@oxc-project+runtime@0.129.0/helpers/decorateParam.js
+//#region \0@oxc-project+runtime@0.133.0/helpers/esm/decorateParam.js
 function __decorateParam(paramIndex, decorator) {
 	return function(target, key) {
 		decorator(target, key, paramIndex);
 	};
 }
 //#endregion
-//#region \0@oxc-project+runtime@0.129.0/helpers/decorate.js
+//#region \0@oxc-project+runtime@0.133.0/helpers/esm/decorate.js
 function __decorate(decorators, target, key, desc) {
 	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
 	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);

package/dist/{deep-merge-C8NgcXw4.mjs → deep-merge-ByiAOZ3r.mjs}

@@ -15,4 +15,4 @@ function deepMerge(target, source) {
 //#endregion
 export { deepMerge as t };
 
-//# sourceMappingURL=deep-merge-C8NgcXw4.mjs.map
+//# sourceMappingURL=deep-merge-ByiAOZ3r.mjs.map

package/dist/{deep-merge-C8NgcXw4.mjs.map → deep-merge-ByiAOZ3r.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"deep-merge-C8NgcXw4.mjs","names":[],"sources":["../src/i18n/utils/deep-merge.ts"],"sourcesContent":["/**\n * Deep merge two objects. Source values override target at leaf level.\n */\nexport function deepMerge(\n  target: Record<string, unknown>,\n  source: Record<string, unknown>,\n): Record<string, unknown> {\n  const result: Record<string, unknown> = { ...target }\n\n  for (const key of Object.keys(source)) {\n    const targetValue = target[key]\n    const sourceValue = source[key]\n\n    if (\n      typeof targetValue === 'object'\n      && targetValue !== null\n      && !Array.isArray(targetValue)\n      && typeof sourceValue === 'object'\n      && sourceValue !== null\n      && !Array.isArray(sourceValue)\n    ) {\n      result[key] = deepMerge(\n        targetValue as Record<string, unknown>,\n        sourceValue as Record<string, unknown>,\n      )\n    } else {\n      result[key] = sourceValue\n    }\n  }\n\n  return result\n}\n"],"mappings":";;;;AAGA,SAAgB,UACd,QACA,QACyB;CACzB,MAAM,SAAkC,EAAE,GAAG,QAAQ;CAErD,KAAK,MAAM,OAAO,OAAO,KAAK,OAAO,EAAE;EACrC,MAAM,cAAc,OAAO;EAC3B,MAAM,cAAc,OAAO;EAE3B,IACE,OAAO,gBAAgB,YACpB,gBAAgB,QAChB,CAAC,MAAM,QAAQ,YAAY,IAC3B,OAAO,gBAAgB,YACvB,gBAAgB,QAChB,CAAC,MAAM,QAAQ,YAAY,EAE9B,OAAO,OAAO,UACZ,aACA,YACD;OAED,OAAO,OAAO;;CAIlB,OAAO"}
+{"version":3,"file":"deep-merge-ByiAOZ3r.mjs","names":[],"sources":["../src/i18n/utils/deep-merge.ts"],"sourcesContent":["/**\n * Deep merge two objects. Source values override target at leaf level.\n */\nexport function deepMerge(\n  target: Record<string, unknown>,\n  source: Record<string, unknown>,\n): Record<string, unknown> {\n  const result: Record<string, unknown> = { ...target }\n\n  for (const key of Object.keys(source)) {\n    const targetValue = target[key]\n    const sourceValue = source[key]\n\n    if (\n      typeof targetValue === 'object'\n      && targetValue !== null\n      && !Array.isArray(targetValue)\n      && typeof sourceValue === 'object'\n      && sourceValue !== null\n      && !Array.isArray(sourceValue)\n    ) {\n      result[key] = deepMerge(\n        targetValue as Record<string, unknown>,\n        sourceValue as Record<string, unknown>,\n      )\n    } else {\n      result[key] = sourceValue\n    }\n  }\n\n  return result\n}\n"],"mappings":";;;;AAGA,SAAgB,UACd,QACA,QACyB;CACzB,MAAM,SAAkC,EAAE,GAAG,OAAO;CAEpD,KAAK,MAAM,OAAO,OAAO,KAAK,MAAM,GAAG;EACrC,MAAM,cAAc,OAAO;EAC3B,MAAM,cAAc,OAAO;EAE3B,IACE,OAAO,gBAAgB,YACpB,gBAAgB,QAChB,CAAC,MAAM,QAAQ,WAAW,KAC1B,OAAO,gBAAgB,YACvB,gBAAgB,QAChB,CAAC,MAAM,QAAQ,WAAW,GAE7B,OAAO,OAAO,UACZ,aACA,WACF;OAEA,OAAO,OAAO;CAElB;CAEA,OAAO;AACT"}

package/dist/di/index.d.mts

@@ -1,2 +1,2 @@
-import { $ as ConditionalBindingGive, B as Transient, Bn as LazyToken, F as defineMetadata, Fn as ContainerLike, G as InjectParam, H as getInjectionTokens, Hn as lazy, I as getMetadata, In as ExtensionDecorator, J as ContainerError, K as ParamInjection, L as hasMetadata, Ln as InjectionToken, M as containerStorage, N as getContainer, P as runWithContainer, Q as ConditionalBindingBuilderImpl, R as Request, Rn as Scope, U as inject, V as getClassMetadata, Vn as isLazyToken, W as INJECT_PARAM_METADATA_KEY, X as ContainerOptions, Y as Container, Z as ConditionalBindingBuilder, br as DI_TOKENS, et as ConditionalBindingUse, q as getMethodInjections, tt as PredicateContainer, vr as CONTAINER_TOKEN, yr as DIToken, z as Singleton, zn as WhenOptions } from "../index-DEncMcC6.mjs";
-export { CONTAINER_TOKEN, ConditionalBindingBuilder, ConditionalBindingBuilderImpl, ConditionalBindingGive, ConditionalBindingUse, Container, ContainerError, ContainerLike, ContainerOptions, DIToken, DI_TOKENS, ExtensionDecorator, INJECT_PARAM_METADATA_KEY, InjectParam, InjectionToken, LazyToken, ParamInjection, PredicateContainer, Request, Scope, Singleton, Transient, WhenOptions, containerStorage, defineMetadata, getClassMetadata, getContainer, getInjectionTokens, getMetadata, getMethodInjections, hasMetadata, inject, isLazyToken, lazy, runWithContainer };
+import { $ as ConditionalBindingGive, B as Transient, Bn as ContainerLike, Er as DI_TOKENS, F as defineMetadata, G as InjectParam, Gn as LazyToken, H as getInjectionTokens, Hn as InjectionToken, I as getMetadata, J as ContainerError, K as ParamInjection, Kn as isLazyToken, L as hasMetadata, M as containerStorage, N as getContainer, P as runWithContainer, Q as ConditionalBindingBuilderImpl, R as Request, Tr as DIToken, U as inject, Un as Scope, V as getClassMetadata, Vn as ExtensionDecorator, W as INJECT_PARAM_METADATA_KEY, Wn as WhenOptions, X as ContainerOptions, Y as Container, Z as ConditionalBindingBuilder, et as ConditionalBindingUse, q as getMethodInjections, qn as lazy, tt as PredicateContainer, wr as CONTAINER_TOKEN, z as Singleton } from "../index-B_JoEl3V.mjs";
+export { CONTAINER_TOKEN, ConditionalBindingBuilder, ConditionalBindingBuilderImpl, ConditionalBindingGive, ConditionalBindingUse, Container, ContainerError, ContainerLike, ContainerOptions, DIToken, DI_TOKENS, ExtensionDecorator, INJECT_PARAM_METADATA_KEY, InjectParam, InjectionToken, LazyToken, type ParamInjection, PredicateContainer, Request, Scope, Singleton, Transient, WhenOptions, containerStorage, defineMetadata, getClassMetadata, getContainer, getInjectionTokens, getMetadata, getMethodInjections, hasMetadata, inject, isLazyToken, lazy, runWithContainer };

package/dist/di/index.mjs

@@ -1,4 +1,4 @@
-import { n as getContainer, r as runWithContainer, t as containerStorage } from "../container-storage-GpNNz79X.mjs";
-import { _ as getMethodInjections, a as ContainerError, c as DI_TOKENS, d as Transient, f as getClassMetadata, g as InjectParam, h as INJECT_PARAM_METADATA_KEY, i as ConditionalBindingBuilderImpl, l as Request, m as inject, n as isLazyToken, p as getInjectionTokens, r as lazy, s as CONTAINER_TOKEN, t as Container, u as Singleton, v as Scope } from "../di-BO1QIb5H.mjs";
-import { n as getMetadata, r as hasMetadata, t as defineMetadata } from "../metadata-BVkc4aUu.mjs";
+import { _ as ContainerError, a as lazy, c as Transient, d as inject, f as INJECT_PARAM_METADATA_KEY, g as ConditionalBindingBuilderImpl, h as Scope, i as isLazyToken, l as getClassMetadata, m as getMethodInjections, n as CONTAINER_TOKEN, o as Request, p as InjectParam, r as DI_TOKENS, s as Singleton, t as Container, u as getInjectionTokens } from "../di-DseMn-z9.mjs";
+import { n as getContainer, r as runWithContainer, t as containerStorage } from "../container-storage-BmOJ4_Na.mjs";
+import { n as getMetadata, r as hasMetadata, t as defineMetadata } from "../metadata-DzzprcID.mjs";
 export { CONTAINER_TOKEN, ConditionalBindingBuilderImpl, Container, ContainerError, DI_TOKENS, INJECT_PARAM_METADATA_KEY, InjectParam, Request, Scope, Singleton, Transient, containerStorage, defineMetadata, getClassMetadata, getContainer, getInjectionTokens, getMetadata, getMethodInjections, hasMetadata, inject, isLazyToken, lazy, runWithContainer };