stratal 0.0.15 → 0.0.17

package/dist/consumer-registry-Bymm6ff4.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-Bymm6ff4.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"consumer-registry-Bymm6ff4.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-D69rxo8H.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 { s as ApplicationError } from "../index-BFCxSp_f.mjs";
+import { n as CronJob, t as CronManager } from "../cron-manager-D7imGwUT.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,4 @@
-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-BRh86QCS.mjs";
+import "../errors-DSKapqD8.mjs";
+import "../logger-CGT91VY6.mjs";
+import { n as CronExecutionError, t as CronManager } from "../cron-manager-CFBamKKk.mjs";
 export { CronExecutionError, CronManager };

package/dist/{cron-manager-BRh86QCS.mjs → cron-manager-CFBamKKk.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 { S as ApplicationError, b as ERROR_CODES } from "./errors-DSKapqD8.mjs";
+import { a as __decorate, d as Transient } from "./logger-CGT91VY6.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-BRh86QCS.mjs.map
+//# sourceMappingURL=cron-manager-CFBamKKk.mjs.map

package/dist/{cron-manager-BRh86QCS.mjs.map → cron-manager-CFBamKKk.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"cron-manager-BRh86QCS.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-CFBamKKk.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"}

package/dist/cron-manager-D7imGwUT.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 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
+export { CronJob as n, CronManager as t };
+//# sourceMappingURL=cron-manager-D7imGwUT.d.mts.map

package/dist/cron-manager-D7imGwUT.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-manager-D7imGwUT.d.mts","names":[],"sources":["../src/cron/cron-job.ts","../src/cron/cron-manager.ts"],"mappings":";;AA2BA;;;;;;;;;;;;;;;;;;;;;;;;;;UAAiB,OAAA;ECXO;;;;;;;EAAA,SDmBd,QAAA;ECbD;;;;;;EDqBR,OAAA,CAAQ,UAAA,EAAY,mBAAA,GAAsB,OAAA;ECKe;;;;;;;;EDKzD,OAAA,EAAS,KAAA,EAAO,KAAA,EAAO,UAAA,EAAY,mBAAA,GAAsB,OAAA;AAAA;;;AA1B1D;;;;;;;;;;;AAAA,cCXa,WAAA;ED2BQ;;;;;EAAA,QCrBZ,IAAA;ED+B2B;;;;;;;;ECrBnC,WAAA,CAAY,GAAA,EAAK,OAAA;EAhBM;;;;;;;;;;EAgCjB,gBAAA,CAAiB,UAAA,EAAY,mBAAA,GAAsB,OAAA;EAhB7C;;;;;;EAgEZ,kBAAA,CAAmB,QAAA,WAAmB,OAAA;EAAA;;;;;EAStC,eAAA,CAAA;;;;;;EASA,gBAAA,CAAA;AAAA"}

package/dist/di/index.d.mts

@@ -1,2 +1,2 @@
-import { $t as Container, Gt as Transient, Jt as ParamInjection, Kt as INJECT_PARAM_METADATA_KEY, Qt as DI_TOKENS, Ut as RequestScopeOperationNotAllowedError, Wt as ConditionalBindingFallbackError, Xt as CONTAINER_TOKEN, Yt as getMethodInjections, Zt as DIToken, an as injectable, cn as ConditionalBindingBuilder, dn as ConditionalBindingUse, en as ContainerOptions, fn as PredicateContainer, gn as WhenOptions, hn as Scope, in as inject, ln as ConditionalBindingBuilderImpl, mn as ExtensionDecorator, nn as container, on as instancePerContainerCachingFactory, pn as ContainerLike, qt as InjectParam, rn as delay, sn as singleton, tn as DependencyContainer, un as ConditionalBindingGive } from "../index-D69rxo8H.mjs";
+import { $t as DI_TOKENS, Gt as ConditionalBindingFallbackError, Jt as InjectParam, Kt as Transient, Qt as DIToken, Wt as RequestScopeOperationNotAllowedError, Xt as getMethodInjections, Yt as ParamInjection, Zt as CONTAINER_TOKEN, _n as WhenOptions, an as inject, cn as singleton, dn as ConditionalBindingGive, en as Container, fn as ConditionalBindingUse, gn as Scope, hn as ExtensionDecorator, in as delay, ln as ConditionalBindingBuilder, mn as ContainerLike, nn as DependencyContainer, on as injectable, pn as PredicateContainer, qt as INJECT_PARAM_METADATA_KEY, rn as container, sn as instancePerContainerCachingFactory, tn as ContainerOptions, un as ConditionalBindingBuilderImpl } from "../index-BFCxSp_f.mjs";
 export { CONTAINER_TOKEN, ConditionalBindingBuilder, ConditionalBindingBuilderImpl, ConditionalBindingFallbackError, ConditionalBindingGive, ConditionalBindingUse, Container, ContainerLike, ContainerOptions, DIToken, DI_TOKENS, DependencyContainer, ExtensionDecorator, INJECT_PARAM_METADATA_KEY, InjectParam, ParamInjection, PredicateContainer, RequestScopeOperationNotAllowedError, Scope, Transient, WhenOptions, container, delay, getMethodInjections, inject, injectable, instancePerContainerCachingFactory, singleton };

package/dist/di/index.mjs

@@ -1,4 +1,3 @@
-import { _ as ConditionalBindingFallbackError, c as Container, d as inject, f as injectable, g as RequestScopeOperationNotAllowedError, h as ConditionalBindingBuilderImpl, l as container, m as singleton, p as instancePerContainerCachingFactory, s as Scope, u as delay } from "../errors-CtCi1wn6.mjs";
-import { a as INJECT_PARAM_METADATA_KEY, c as CONTAINER_TOKEN, i as Transient, l as DI_TOKENS, o as InjectParam, s as getMethodInjections } from "../decorate-D5j-d9_z.mjs";
-import "../logger-BR1-s1Um.mjs";
+import { _ as ConditionalBindingFallbackError, c as Container, d as inject, f as injectable, g as RequestScopeOperationNotAllowedError, h as ConditionalBindingBuilderImpl, l as container, m as singleton, p as instancePerContainerCachingFactory, s as Scope, u as delay } from "../errors-DSKapqD8.mjs";
+import { d as Transient, f as INJECT_PARAM_METADATA_KEY, g as DI_TOKENS, h as CONTAINER_TOKEN, m as getMethodInjections, p as InjectParam } from "../logger-CGT91VY6.mjs";
 export { CONTAINER_TOKEN, ConditionalBindingBuilderImpl, ConditionalBindingFallbackError, Container, DI_TOKENS, INJECT_PARAM_METADATA_KEY, InjectParam, RequestScopeOperationNotAllowedError, Scope, Transient, container, delay, getMethodInjections, inject, injectable, instancePerContainerCachingFactory, singleton };

package/dist/email/index.d.mts

@@ -1,6 +1,6 @@
-import { it as DynamicModule, nt as AsyncModuleOptions, s as ApplicationError } from "../index-D69rxo8H.mjs";
-import { o as z } from "../index-CpAN9ENH.mjs";
-import { g as QueueName, h as IQueueSender } from "../index-H-Su81aK.mjs";
+import { at as DynamicModule, rt as AsyncModuleOptions, s as ApplicationError } from "../index-BFCxSp_f.mjs";
+import { o as z } from "../index-NGxg-KP_.mjs";
+import { g as QueueName, h as IQueueSender } from "../index-DGRe6Yoa.mjs";
 import { ReactElement } from "react";
 
 //#region src/email/email.module.d.ts

package/dist/email/index.mjs

@@ -1,17 +1,18 @@
-import { S as ApplicationError, b as ERROR_CODES } from "../errors-CtCi1wn6.mjs";
-import { i as Transient, n as __decorateParam, r as __decorateMetadata, t as __decorate } from "../decorate-D5j-d9_z.mjs";
-import { s as LOGGER_TOKENS } from "../logger-BR1-s1Um.mjs";
-import { r as Module } from "../module-BH7t7BGG.mjs";
-import "../events-CXl-o1Ad.mjs";
-import "../command-DG_u5ob2.mjs";
-import "../is-command-MZDCH-0T.mjs";
-import "../is-seeder-BN9Ej1r7.mjs";
-import "../middleware-iRhNjsPH.mjs";
-import "../router-context-BLn4PrRG.mjs";
-import { a as withI18n, i as z } from "../validation-Dbt-snjx.mjs";
-import { c as QUEUE_TOKENS } from "../queue.module-BdXWUvIM.mjs";
+import { S as ApplicationError, b as ERROR_CODES } from "../errors-DSKapqD8.mjs";
+import { a as __decorate, d as Transient, o as __decorateParam, s as __decorateMetadata, u as LOGGER_TOKENS } from "../logger-CGT91VY6.mjs";
+import { r as Module } from "../module-tUtyVJ5E.mjs";
+import "../events-CvUSgEuN.mjs";
+import "../middleware-Bl-b5pkt.mjs";
+import "../router-context-D9R1v2Ac.mjs";
+import "../colors-Y7WIFXs7.mjs";
+import "../command-B1CPgsrU.mjs";
+import "../is-command-DJVI6wEJ.mjs";
+import "../is-seeder-D5MIEcdz.mjs";
+import { a as withI18n, i as z } from "../validation-DQTC259A.mjs";
+import { c as QUEUE_TOKENS } from "../queue.module-BtI8f4Jo.mjs";
 import "../queue/index.mjs";
-import { l as STORAGE_TOKENS } from "../storage-BtcfgibD.mjs";
+import "../errors-DuAR5Wke.mjs";
+import { l as STORAGE_TOKENS } from "../storage-CZKHOhci.mjs";
 import { inject } from "tsyringe";
 import { render } from "@react-email/render";
 //#region src/email/email.tokens.ts
@@ -262,11 +263,11 @@ let EmailProviderFactory = class EmailProviderFactory {
 	async create() {
 		switch (this.options.provider) {
 			case "resend": {
-				const { ResendProvider } = await import("../resend.provider-CQT5be5E.mjs");
+				const { ResendProvider } = await import("../resend.provider-bXMEkdRJ.mjs");
 				return new ResendProvider(this.options);
 			}
 			case "smtp": {
-				const { SmtpProvider } = await import("../smtp.provider-Cj7BUFbJ.mjs");
+				const { SmtpProvider } = await import("../smtp.provider-DrbHQztF.mjs");
 				return new SmtpProvider(this.options);
 			}
 			default: throw new EmailProviderNotSupportedError(this.options.provider);