stratal 0.0.17 → 0.0.19

package/dist/controller.decorator-LZY9aHYG.mjs

@@ -0,0 +1,66 @@
+import { f as ROUTE_METADATA_KEYS } from "./errors-B4pYgYON.mjs";
+import { p as Transient } from "./logger-V6Ms3QnQ.mjs";
+//#region src/router/decorators/controller.decorator.ts
+const CONTROLLER_ROUTE_KEY = ROUTE_METADATA_KEYS.CONTROLLER_ROUTE;
+/**
+* Base controller decorator for route registration
+*
+* This is the core controller decorator that handles:
+* - Transient scope registration (request-scoped)
+* - Route metadata storage
+* - Controller options (tags, security schemes, hideFromDocs)
+*
+* @param route - Base route for this controller (e.g., '/api/v1/users')
+* @param options - Optional configuration (tags, security schemes, hideFromDocs)
+*
+* @example
+* ```typescript
+* import { Controller } from 'stratal/router'
+*
+* @Controller('/api/v1/users', { tags: ['Users'] })
+* export class UsersController implements IController {
+*   // All routes accessible
+* }
+* ```
+*/
+function Controller(route, options) {
+	return function(target) {
+		Transient()(target);
+		Reflect.defineMetadata(CONTROLLER_ROUTE_KEY, route, target);
+		if (options) Reflect.defineMetadata(ROUTE_METADATA_KEYS.CONTROLLER_OPTIONS, options, target);
+		return target;
+	};
+}
+/**
+* Get the route from controller class metadata
+*
+* @param target - Controller class or instance
+* @returns Route string or undefined if not set
+*/
+function getControllerRoute(target) {
+	const metadataTarget = typeof target === "function" ? target : target.constructor;
+	return Reflect.getMetadata(CONTROLLER_ROUTE_KEY, metadataTarget);
+}
+/**
+* Get the options from controller class metadata
+*
+* @param target - Controller class or instance
+* @returns Controller options or undefined if not set
+*/
+function getControllerOptions(target) {
+	const metadataTarget = typeof target === "function" ? target : target.constructor;
+	return Reflect.getMetadata(ROUTE_METADATA_KEYS.CONTROLLER_OPTIONS, metadataTarget);
+}
+/**
+* Get the version from controller class metadata
+*
+* @param target - Controller class or instance
+* @returns Version string, array, VERSION_NEUTRAL symbol, or undefined if not set
+*/
+function getControllerVersion(target) {
+	return getControllerOptions(target)?.version;
+}
+//#endregion
+export { getControllerVersion as i, getControllerOptions as n, getControllerRoute as r, Controller as t };
+
+//# sourceMappingURL=controller.decorator-LZY9aHYG.mjs.map

package/dist/controller.decorator-LZY9aHYG.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.decorator-LZY9aHYG.mjs","names":[],"sources":["../src/router/decorators/controller.decorator.ts"],"sourcesContent":["import { Transient } from '../../di/decorators'\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    Reflect.defineMetadata(CONTROLLER_ROUTE_KEY, route, target)\n\n    // Store options metadata if provided\n    if (options) {\n      Reflect.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 Reflect.getMetadata(CONTROLLER_ROUTE_KEY, metadataTarget) as string | undefined\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 Reflect.getMetadata(ROUTE_METADATA_KEYS.CONTROLLER_OPTIONS, metadataTarget) as ControllerOptions | undefined\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":";;;AAKA,MAAM,uBAAuB,oBAAoB;;;;;;;;;;;;;;;;;;;;;;AAuBjD,SAAgB,WAAW,OAAe,SAA6B;AACrE,QAAO,SAAiC,QAAW;AAEjD,aAAW,CAAC,OAAO;AAGnB,UAAQ,eAAe,sBAAsB,OAAO,OAAO;AAG3D,MAAI,QACF,SAAQ,eAAe,oBAAoB,oBAAoB,SAAS,OAAO;AAGjF,SAAO;;;;;;;;;AAUX,SAAgB,mBAAmB,QAAoC;CAGrE,MAAM,iBAAiB,OAAO,WAAW,aAAa,SAAU,OAAmC;AACnG,QAAO,QAAQ,YAAY,sBAAsB,eAAe;;;;;;;;AASlE,SAAgB,qBAAqB,QAA+C;CAClF,MAAM,iBAAiB,OAAO,WAAW,aAAa,SAAU,OAAmC;AACnG,QAAO,QAAQ,YAAY,oBAAoB,oBAAoB,eAAe;;;;;;;;AASpF,SAAgB,qBAAqB,QAA8C;AAEjF,QADgB,qBAAqB,OACvB,EAAE"}

package/dist/cron/index.d.mts

@@ -1,5 +1,6 @@
-import { s as ApplicationError } from "../index-BFCxSp_f.mjs";
-import { n as CronJob, t as CronManager } from "../cron-manager-D7imGwUT.mjs";
+import { d as ApplicationError } from "../index-DPFqRs8L.mjs";
+import { n as CronJob, r as RegisteredJob, t as CronManager } from "../cron-manager-RuPtFVLy.mjs";
+import { ScheduledController } from "@cloudflare/workers-types";
 
 //#region src/cron/errors/cron-execution.error.d.ts
 /**
@@ -11,5 +12,5 @@ declare class CronExecutionError extends ApplicationError {
   constructor(schedule: string, failedJobsCount: number, jobNames: string);
 }
 //#endregion
-export { CronExecutionError, type CronJob, CronManager };
+export { CronExecutionError, type CronJob, CronManager, type RegisteredJob, type 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":";;;;;;;;AAQA;cAAa,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,4 +1,2 @@
-import "../errors-DSKapqD8.mjs";
-import "../logger-CGT91VY6.mjs";
-import { n as CronExecutionError, t as CronManager } from "../cron-manager-CFBamKKk.mjs";
+import { n as CronExecutionError, t as CronManager } from "../cron-manager-C30t9UZM.mjs";
 export { CronExecutionError, CronManager };

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

@@ -1,5 +1,5 @@
-import { S as ApplicationError, b as ERROR_CODES } from "./errors-DSKapqD8.mjs";
-import { a as __decorate, d as Transient } from "./logger-CGT91VY6.mjs";
+import { H as ApplicationError, k as ERROR_CODES } from "./errors-B4pYgYON.mjs";
+import { a as __decorate, p as Transient } from "./logger-V6Ms3QnQ.mjs";
 //#region src/cron/errors/cron-execution.error.ts
 /**
 * Error thrown when one or more cron jobs fail execution
@@ -19,51 +19,61 @@ var CronExecutionError = class extends ApplicationError {
 //#region src/cron/cron-manager.ts
 let CronManager = class CronManager {
 	/**
-	* Map of cron expressions to jobs
+	* Map of cron expressions to registered job entries
 	* Key: Cron expression (e.g., '0 2 * * *')
-	* Value: Array of jobs matching that expression
+	* Value: Array of registered jobs (class ref + schedule)
 	*/
 	jobs = /* @__PURE__ */ new Map();
 	/**
-	* Register a cron job
+	* Register a cron job class
 	*
 	* Jobs with the same schedule are grouped together and executed
 	* sequentially when the trigger fires.
 	*
-	* @param job - CronJob instance to register
+	* @param schedule - Cron expression (e.g., '0 2 * * *')
+	* @param jobClass - CronJob class constructor (resolved at execution time)
 	*/
-	registerJob(job) {
-		const existing = this.jobs.get(job.schedule) ?? [];
-		existing.push(job);
-		this.jobs.set(job.schedule, existing);
+	registerJob(schedule, jobClass) {
+		const existing = this.jobs.get(schedule) ?? [];
+		existing.push({
+			schedule,
+			jobClass
+		});
+		this.jobs.set(schedule, existing);
 	}
 	/**
 	* 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 logged
+	* - Errors are collected and thrown as CronExecutionError
 	*
 	* @param controller - Cloudflare ScheduledController
+	* @param container - Request-scoped container to resolve jobs from
 	*/
-	async executeScheduled(controller) {
+	async executeScheduled(controller, container) {
 		const { cron } = controller;
 		const matchingJobs = this.jobs.get(cron) ?? [];
 		if (matchingJobs.length === 0) return;
 		const errors = [];
-		for (const job of matchingJobs) {
-			const jobName = job.constructor.name;
+		for (const { jobClass } of matchingJobs) {
+			const jobName = jobClass.name;
 			try {
-				await job.execute(controller);
+				container.register(jobClass, jobClass);
+				await container.resolve(jobClass).execute(controller);
 			} catch (error) {
 				const err = error;
 				errors.push({
 					job: jobName,
 					error: err
 				});
-				if (job.onError) try {
-					await job.onError(err, controller);
+				try {
+					const job = container.resolve(jobClass);
+					if (job.onError) await job.onError(err, controller);
 				} catch {}
 			}
 		}
@@ -76,7 +86,7 @@ let CronManager = class CronManager {
 	* 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
+	* @returns Array of registered jobs, or empty array if none
 	*/
 	getJobsForSchedule(schedule) {
 		return this.jobs.get(schedule) ?? [];
@@ -104,4 +114,4 @@ CronManager = __decorate([Transient()], CronManager);
 //#endregion
 export { CronExecutionError as n, CronManager as t };
 
-//# sourceMappingURL=cron-manager-CFBamKKk.mjs.map
+//# sourceMappingURL=cron-manager-C30t9UZM.mjs.map

package/dist/cron-manager-C30t9UZM.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-manager-C30t9UZM.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 type { Container } from '../di/container'\nimport { Transient } from '../di/decorators'\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@Transient()\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\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\t// Without this, tsyringe falls through to the parent container\n\t\t\t\t// and request-scoped services (e.g. database) get stale instances.\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\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 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"],"mappings":";;;;;;;;AAQA,IAAa,qBAAb,cAAwC,iBAAiB;CACxD,YACC,UACA,iBACA,UACC;AACD,QACC,8BACA,YAAY,OAAO,uBACnB;GACC;GACA,OAAO;GACP,MAAM;GACN,CACD;;;;;ACLI,IAAA,cAAA,MAAM,YAAY;;;;;;CAMxB,uBAAe,IAAI,KAA8B;;;;;;;;;;CAWjD,YAAY,UAAkB,UAA2C;EACxE,MAAM,WAAW,KAAK,KAAK,IAAI,SAAS,IAAI,EAAE;AAC9C,WAAS,KAAK;GAAE;GAAU;GAAU,CAAC;AACrC,OAAK,KAAK,IAAI,UAAU,SAAS;;;;;;;;;;;;;;;;CAiBlC,MAAM,iBAAiB,YAAiC,WAAqC;EAC5F,MAAM,EAAE,SAAS;EACjB,MAAM,eAAe,KAAK,KAAK,IAAI,KAAK,IAAI,EAAE;AAE9C,MAAI,aAAa,WAAW,EAC3B;EAGD,MAAM,SAA0C,EAAE;AAElD,OAAK,MAAM,EAAE,cAAc,cAAc;GACxC,MAAM,UAAU,SAAS;AAEzB,OAAI;AAKH,cAAU,SAAS,UAAU,SAAS;AAEtC,UADY,UAAU,QAAiB,SAC9B,CAAC,QAAQ,WAAW;YACrB,OAAO;IACf,MAAM,MAAM;AACZ,WAAO,KAAK;KAAE,KAAK;KAAS,OAAO;KAAK,CAAC;AAGzC,QAAI;KACH,MAAM,MAAM,UAAU,QAAiB,SAAS;AAChD,SAAI,IAAI,QACP,OAAM,IAAI,QAAQ,KAAK,WAAW;YAE5B;;;AAQV,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,UAAmC;AACrD,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;;;0BAnHR,WAAW,CAAA,EAAA,YAAA"}

package/dist/{cron-manager-D7imGwUT.d.mts → cron-manager-RuPtFVLy.d.mts}

@@ -1,3 +1,6 @@
+import { Cr as Container } from "./index-DPFqRs8L.mjs";
+import { t as Constructor } from "./types-DIWemRad.mjs";
+
 //#region src/cron/cron-job.d.ts
 /**
  * Interface for cron jobs that can be registered by modules
@@ -26,6 +29,12 @@
  * }
  * ```
  */
+interface RegisteredJob {
+  /** The cron schedule expression */
+  schedule: string;
+  /** The job class constructor (resolved from container at execution time) */
+  jobClass: Constructor<CronJob>;
+}
 interface CronJob {
   /**
    * Cron expression that triggers this job
@@ -45,7 +54,7 @@ interface CronJob {
   /**
    * Optional error handler for job execution failures
    *
-   * If not provided, errors are logged via GlobalErrorHandler
+   * If not provided, errors are logged via ExceptionHandler
    *
    * @param error - Error that occurred during execution
    * @param controller - Cloudflare ScheduledController
@@ -58,47 +67,52 @@ interface CronJob {
  * Manages cron job registration and execution
  *
  * CronManager is a singleton service that:
- * - Registers cron jobs from modules
+ * - Registers cron job class references from modules
  * - Routes scheduled events to matching jobs
- * - Handles errors during job execution
+ * - 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 jobs
+   * Map of cron expressions to registered job entries
    * Key: Cron expression (e.g., '0 2 * * *')
-   * Value: Array of jobs matching that expression
+   * Value: Array of registered jobs (class ref + schedule)
    */
   private jobs;
   /**
-   * Register a cron job
+   * Register a cron job class
    *
    * Jobs with the same schedule are grouped together and executed
    * sequentially when the trigger fires.
    *
-   * @param job - CronJob instance to register
+   * @param schedule - Cron expression (e.g., '0 2 * * *')
+   * @param jobClass - CronJob class constructor (resolved at execution time)
    */
-  registerJob(job: CronJob): void;
+  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 logged
+   * - Errors are collected and thrown as CronExecutionError
    *
    * @param controller - Cloudflare ScheduledController
+   * @param container - Request-scoped container to resolve jobs from
    */
-  executeScheduled(controller: ScheduledController): Promise<void>;
+  executeScheduled(controller: ScheduledController, container: Container): 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
+   * @returns Array of registered jobs, or empty array if none
    */
-  getJobsForSchedule(schedule: string): CronJob[];
+  getJobsForSchedule(schedule: string): RegisteredJob[];
   /**
    * Get all registered cron expressions
    *
@@ -113,5 +127,5 @@ declare class CronManager {
   getTotalJobCount(): number;
 }
 //#endregion
-export { CronJob as n, CronManager as t };
-//# sourceMappingURL=cron-manager-D7imGwUT.d.mts.map
+export { CronJob as n, RegisteredJob as r, CronManager as t };
+//# sourceMappingURL=cron-manager-RuPtFVLy.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cron-manager-RuPtFVLy.d.mts","names":[],"sources":["../src/cron/cron-job.ts","../src/cron/cron-manager.ts"],"mappings":";;;;;;;AA6BA;;;;;;;;;;AAOA;;;;;;;;;;;;;;UAPiB,aAAA;EAiChB;EA/BA,QAAA;EA+BS;EA7BT,QAAA,EAAU,WAAA,CAAY,OAAA;AAAA;AAAA,UAGN,OAAA;EA0BgD;;;;;AC9CjE;;ED8CiE,SAlBvD,QAAA;ECV+B;;;;;;EDkBxC,OAAA,CAAQ,UAAA,EAAY,mBAAA,GAAsB,OAAA;EC7BlC;;;;;;;;EDuCR,OAAA,EAAS,KAAA,EAAO,KAAA,EAAO,UAAA,EAAY,mBAAA,GAAsB,OAAA;AAAA;;;;;AAjC1D;;;;;;;;;cCZa,WAAA;EDmBI;;;;;EAAA,QCbR,IAAA;EDuC2B;;;;;;;;;EC5BnC,WAAA,CAAY,QAAA,UAAkB,QAAA,EAAU,aAAA;ED4BxB;;;;;;;;;;AC9CjB;;;;EAsCO,gBAAA,CAAiB,UAAA,EAAY,mBAAA,EAAqB,SAAA,EAAW,SAAA,GAAY,OAAA;EAAZ;;;;;;EAsDnE,kBAAA,CAAmB,QAAA,WAAmB,aAAA;EA1E1B;;;;;EAmFZ,eAAA,CAAA;EA/DmE;;;;;EAwEnE,gBAAA,CAAA;AAAA"}

package/dist/di/index.d.mts

@@ -1,2 +1,2 @@
-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 };
+import { Ar as instancePerContainerCachingFactory, Br as WhenOptions, Cr as Container, Dr as delay, Er as container, Fr as ConditionalBindingUse, Ir as PredicateContainer, Lr as ContainerLike, Mr as ConditionalBindingBuilder, Nr as ConditionalBindingBuilderImpl, Or as inject, Pr as ConditionalBindingGive, Rr as ExtensionDecorator, Tr as DependencyContainer, _r as DI_TOKENS, ar as containerStorage, cr as RequestScopeOperationNotAllowedError, dr as INJECT_PARAM_METADATA_KEY, fr as InjectParam, gr as DIToken, hr as CONTAINER_TOKEN, jr as singleton, kr as injectable, lr as ConditionalBindingFallbackError, mr as getMethodInjections, or as getContainer, pr as ParamInjection, sr as runWithContainer, ur as Transient, wr as ContainerOptions, zr as Scope } from "../index-DPFqRs8L.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, containerStorage, delay, getContainer, getMethodInjections, inject, injectable, instancePerContainerCachingFactory, runWithContainer, singleton };

package/dist/di/index.mjs

@@ -1,3 +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-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 };
+import { A as Scope, B as ConditionalBindingFallbackError, D as runWithContainer, E as getContainer, F as injectable, I as instancePerContainerCachingFactory, L as singleton, M as container, N as delay, P as inject, R as ConditionalBindingBuilderImpl, T as containerStorage, j as Container, z as RequestScopeOperationNotAllowedError } from "../errors-B4pYgYON.mjs";
+import { d as CONTAINER_TOKEN, f as DI_TOKENS, g as getMethodInjections, h as InjectParam, m as INJECT_PARAM_METADATA_KEY, p as Transient } from "../logger-V6Ms3QnQ.mjs";
+export { CONTAINER_TOKEN, ConditionalBindingBuilderImpl, ConditionalBindingFallbackError, Container, DI_TOKENS, INJECT_PARAM_METADATA_KEY, InjectParam, RequestScopeOperationNotAllowedError, Scope, Transient, container, containerStorage, delay, getContainer, getMethodInjections, inject, injectable, instancePerContainerCachingFactory, runWithContainer, singleton };

package/dist/email/index.d.mts

@@ -1,6 +1,6 @@
-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 { d as ApplicationError, hn as DynamicModule, pn as AsyncModuleOptions } from "../index-DPFqRs8L.mjs";
+import { o as z } from "../index-B437eK7p.mjs";
+import { g as QueueName, h as IQueueSender } from "../index-Dnqm9ZB6.mjs";
 import { ReactElement } from "react";
 
 //#region src/email/email.module.d.ts

package/dist/email/index.mjs

@@ -1,18 +1,10 @@
-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 { H as ApplicationError, k as ERROR_CODES } from "../errors-B4pYgYON.mjs";
+import { a as __decorate, o as __decorateParam, p as Transient, s as __decorateMetadata, u as LOGGER_TOKENS } from "../logger-V6Ms3QnQ.mjs";
+import { C as Module } from "../module-qGE_1duv.mjs";
+import { a as withI18n, i as z } from "../validation-Dbg3ehdP.mjs";
+import { c as QUEUE_TOKENS } from "../queue.module-P-G-nCYz.mjs";
 import "../queue/index.mjs";
-import "../errors-DuAR5Wke.mjs";
-import { l as STORAGE_TOKENS } from "../storage-CZKHOhci.mjs";
+import { u as STORAGE_TOKENS } from "../storage-P6X4h9So.mjs";
 import { inject } from "tsyringe";
 import { render } from "@react-email/render";
 //#region src/email/email.tokens.ts
@@ -26,10 +18,26 @@ import { render } from "@react-email/render";
 * Email Module DI Tokens
 */
 const EMAIL_TOKENS = {
+	/**
+	* Email module configuration options
+	*/
 	Options: Symbol.for("stratal:email:options"),
+	/**
+	* Main email service - facade for sending emails via queues
+	*/
 	EmailService: Symbol.for("stratal:email:service"),
+	/**
+	* Factory for creating email provider instances based on configuration
+	*/
 	EmailProviderFactory: Symbol.for("stratal:email:provider:factory"),
+	/**
+	* Email provider interface - abstracts provider implementation
+	*/
 	EmailProvider: Symbol.for("stratal:email:provider"),
+	/**
+	* Queue sender for email dispatch.
+	* Bound via EmailModule.forRoot({ queue: 'queue-name' })
+	*/
 	EmailQueue: Symbol.for("stratal:email:queue")
 };
 //#endregion
@@ -263,11 +271,11 @@ let EmailProviderFactory = class EmailProviderFactory {
 	async create() {
 		switch (this.options.provider) {
 			case "resend": {
-				const { ResendProvider } = await import("../resend.provider-bXMEkdRJ.mjs");
+				const { ResendProvider } = await import("../resend.provider-bwILp0WI.mjs");
 				return new ResendProvider(this.options);
 			}
 			case "smtp": {
-				const { SmtpProvider } = await import("../smtp.provider-DrbHQztF.mjs");
+				const { SmtpProvider } = await import("../smtp.provider-B07yuARi.mjs");
 				return new SmtpProvider(this.options);
 			}
 			default: throw new EmailProviderNotSupportedError(this.options.provider);
@@ -406,9 +414,21 @@ EmailModule = _EmailModule = __decorate([Module({
 * Use for small files that can fit in queue message.
 */
 const inlineEmailAttachmentSchema = z.object({
+	/**
+	* Filename to display for the attachment
+	*/
 	filename: z.string().min(1).max(255),
+	/**
+	* Base64 encoded content of the attachment
+	*/
 	content: z.string(),
+	/**
+	* MIME type of the attachment (e.g., 'application/pdf', 'image/png')
+	*/
 	contentType: z.string(),
+	/**
+	* Optional size of the attachment in bytes
+	*/
 	size: z.number().positive().optional()
 });
 /**
@@ -419,8 +439,17 @@ const inlineEmailAttachmentSchema = z.object({
 * Use for large files to avoid queue message size limits.
 */
 const storageEmailAttachmentSchema = z.object({
+	/**
+	* Filename to display for the attachment
+	*/
 	filename: z.string().min(1).max(255),
+	/**
+	* Path to the file in storage
+	*/
 	storageKey: z.string(),
+	/**
+	* Optional storage disk name (uses default if not provided)
+	*/
 	disk: z.string().optional()
 });
 /**
@@ -449,14 +478,45 @@ const emailAddressSchema = z.object({
 * Ensures either html or text content is provided.
 */
 const emailMessageSchema = z.object({
+	/**
+	* Recipient email address(es)
+	* Can be a single email string or array of emails
+	*/
 	to: z.union([z.string().email(), z.array(z.string().email())]),
+	/**
+	* Sender email address with optional name
+	* Falls back to default from config if not provided
+	*/
 	from: emailAddressSchema.optional(),
+	/**
+	* Email subject line
+	*/
 	subject: z.string().min(1).max(500),
+	/**
+	* HTML content of the email
+	* Either html or text must be provided
+	*/
 	html: z.string().optional(),
+	/**
+	* Plain text content of the email
+	* Either html or text must be provided
+	*/
 	text: z.string().optional(),
+	/**
+	* Reply-to email address
+	*/
 	replyTo: z.string().email().optional(),
+	/**
+	* CC recipients
+	*/
 	cc: z.array(z.string().email()).optional(),
+	/**
+	* BCC recipients
+	*/
 	bcc: z.array(z.string().email()).optional(),
+	/**
+	* Email attachments
+	*/
 	attachments: z.array(emailAttachmentSchema).optional()
 }).refine((data) => data.html ?? data.text, withI18n("zodI18n.errors.custom.emailOrTextRequired"));
 //#endregion
@@ -468,13 +528,22 @@ const emailMessageSchema = z.object({
 * Extends the base email message with optional metadata.
 * Uses safeExtend() because emailMessageSchema contains refinements.
 */
-const sendEmailInputSchema = emailMessageSchema.safeExtend({ metadata: z.record(z.string(), z.unknown()).optional() });
+const sendEmailInputSchema = emailMessageSchema.safeExtend({ 
+/**
+* Optional metadata to include with the email
+* Can be used for tracking, categorization, etc.
+*/
+metadata: z.record(z.string(), z.unknown()).optional() });
 /**
 * Send Batch Email Input Schema
 *
 * Schema for sending multiple emails in a batch
 */
-const sendBatchEmailInputSchema = z.object({ messages: z.array(sendEmailInputSchema).min(1).max(100) });
+const sendBatchEmailInputSchema = z.object({ 
+/**
+* Array of email messages to send
+*/
+messages: z.array(sendEmailInputSchema).min(1).max(100) });
 //#endregion
 export { EMAIL_TOKENS, EmailModule, EmailProviderFactory, EmailProviderNotSupportedError, EmailResendApiFailedError, EmailService, EmailSmtpConnectionFailedError, ResendApiKeyMissingError, SmtpConfigurationMissingError, SmtpHostMissingError, emailAddressSchema, emailAttachmentSchema, emailMessageSchema, inlineEmailAttachmentSchema, sendBatchEmailInputSchema, sendEmailInputSchema, storageEmailAttachmentSchema };