@monque/tsed 0.1.0 → 1.1.0

package/dist/index.mjs

@@ -1,10 +1,15 @@
+import { ConnectionError, Monque, MonqueError, WorkerRegistrationError } from "@monque/core";
 import { Store, useDecorators } from "@tsed/core";
 import { Configuration, DIContext, Inject, Injectable, InjectorService, LOGGER, Module, ProviderScope, runInContext } from "@tsed/di";
-import { Monque, MonqueError } from "@monque/core";
 import { ObjectId } from "mongodb";
 
 //#region src/config/config.ts
 /**
+* @monque/tsed - Configuration
+*
+* Defines the configuration interface and TsED module augmentation.
+*/
+/**
 * Validate that exactly one database resolution strategy is provided.
 *
 * @param config - The configuration to validate.
@@ -23,8 +28,8 @@ function validateDatabaseConfig(config) {
 		config.dbFactory,
 		config.dbToken
 	].filter(Boolean);
-	if (strategies.length === 0) throw new Error("MonqueTsedConfig requires exactly one of 'db', 'dbFactory', or 'dbToken' to be set");
-	if (strategies.length > 1) throw new Error("MonqueTsedConfig accepts only one of 'db', 'dbFactory', or 'dbToken' - multiple were provided");
+	if (strategies.length === 0) throw new MonqueError("MonqueTsedConfig requires exactly one of 'db', 'dbFactory', or 'dbToken' to be set");
+	if (strategies.length > 1) throw new MonqueError("MonqueTsedConfig accepts only one of 'db', 'dbFactory', or 'dbToken' - multiple were provided");
 }
 
 //#endregion
@@ -32,7 +37,7 @@ function validateDatabaseConfig(config) {
 /**
 * Symbol used to store decorator metadata on class constructors.
 *
-* Used by @WorkerController, @Worker, and @Cron decorators to attach
+* Used by @JobController, @Job, and @Cron decorators to attach
 * metadata that is later collected by MonqueModule during initialization.
 *
 * @example
@@ -49,13 +54,13 @@ const MONQUE = Symbol.for("monque");
 *
 * These constants are used to categorize providers registered with Ts.ED's
 * dependency injection container, enabling MonqueModule to discover and
-* register workers automatically.
+* register jobs automatically.
 *
 * Note: Using string constants with `as const` instead of enums per
 * Constitution guidelines.
 */
 const ProviderTypes = {
-	WORKER_CONTROLLER: "monque:worker-controller",
+	JOB_CONTROLLER: "monque:job-controller",
 	CRON: "monque:cron"
 };
 
@@ -69,8 +74,8 @@ const ProviderTypes = {
 *
 * @example
 * ```typescript
-* @WorkerController()
-* class ReportWorkers {
+* @JobController()
+* class ReportJobs {
 *   @Cron("@daily", { timezone: "UTC" })
 *   async generateDailyReport() {
 *     // ...
@@ -91,7 +96,7 @@ function Cron(pattern, options) {
 		const store = Store.from(targetConstructor);
 		const existing = store.get(MONQUE) || {
 			type: "controller",
-			workers: [],
+			jobs: [],
 			cronJobs: []
 		};
 		const cronJobs = [...existing.cronJobs || [], cronMetadata];
@@ -103,21 +108,21 @@ function Cron(pattern, options) {
 }
 
 //#endregion
-//#region src/decorators/worker.ts
+//#region src/decorators/job.ts
 /**
-* @Worker method decorator
+* @Job method decorator
 *
 * Registers a method as a job handler. The method will be called when a job
 * with the matching name is picked up for processing.
 *
 * @param name - Job name (combined with controller namespace if present).
-* @param options - Worker configuration options.
+* @param options - Job configuration options.
 *
 * @example
 * ```typescript
-* @WorkerController("notifications")
-* export class NotificationWorkers {
-*   @Worker("push", { concurrency: 10 })
+* @JobController("notifications")
+* export class NotificationJobs {
+*   @Job("push", { concurrency: 10 })
 *   async sendPush(job: Job<PushPayload>) {
 *     await pushService.send(job.data);
 *   }
@@ -128,11 +133,11 @@ function Cron(pattern, options) {
 * Method decorator that registers a method as a job handler.
 *
 * @param name - The job name (will be prefixed with controller namespace if present)
-* @param options - Optional worker configuration (concurrency, replace, etc.)
+* @param options - Optional job configuration (concurrency, replace, etc.)
 */
-function Worker(name, options) {
+function Job(name, options) {
 	return (target, propertyKey, _descriptor) => {
-		const workerMetadata = {
+		const jobMetadata = {
 			name,
 			method: String(propertyKey),
 			opts: options || {}
@@ -141,58 +146,58 @@ function Worker(name, options) {
 		const store = Store.from(targetConstructor);
 		const existing = store.get(MONQUE) || {
 			type: "controller",
-			workers: [],
+			jobs: [],
 			cronJobs: []
 		};
-		const workers = [...existing.workers || [], workerMetadata];
+		const jobs = [...existing.jobs || [], jobMetadata];
 		store.set(MONQUE, {
 			...existing,
-			workers
+			jobs
 		});
 	};
 }
 
 //#endregion
-//#region src/decorators/worker-controller.ts
+//#region src/decorators/job-controller.ts
 /**
-* @WorkerController class decorator
+* @JobController class decorator
 *
-* Marks a class as containing worker methods and registers it with the Ts.ED DI container.
-* Workers in the class will have their job names prefixed with the namespace.
+* Marks a class as containing job methods and registers it with the Ts.ED DI container.
+* Jobs in the class will have their job names prefixed with the namespace.
 *
 * @param namespace - Optional prefix for all job names in this controller.
 *                    When set, job names become "{namespace}.{name}".
 *
 * @example
 * ```typescript
-* @WorkerController("email")
-* export class EmailWorkers {
-*   @Worker("send")  // Registered as "email.send"
+* @JobController("email")
+* export class EmailJobs {
+*   @Job("send")  // Registered as "email.send"
 *   async send(job: Job<EmailPayload>) { }
 * }
 * ```
 */
 /**
-* Class decorator that registers a class as a worker controller.
+* Class decorator that registers a class as a job controller.
 *
 * @param namespace - Optional namespace prefix for job names
 */
-function WorkerController(namespace) {
-	return useDecorators(Injectable({ type: ProviderTypes.WORKER_CONTROLLER }), (target) => {
+function JobController(namespace) {
+	return useDecorators(Injectable({ type: ProviderTypes.JOB_CONTROLLER }), (target) => {
 		const store = Store.from(target);
 		const existing = store.get(MONQUE) || {};
-		const workerStore = {
+		const jobStore = {
 			type: "controller",
 			...namespace !== void 0 && { namespace },
-			workers: existing.workers || [],
+			jobs: existing.jobs || [],
 			cronJobs: existing.cronJobs || []
 		};
-		store.set(MONQUE, workerStore);
+		store.set(MONQUE, jobStore);
 	});
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.110.0/helpers/decorate.js
+//#region \0@oxc-project+runtime@0.112.0/helpers/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);
@@ -379,8 +384,8 @@ MonqueService = __decorate([Injectable()], MonqueService);
 /**
 * Build the full job name by combining namespace and name.
 *
-* @param namespace - Optional namespace from @WorkerController
-* @param name - Job name from @Worker or @Cron
+* @param namespace - Optional namespace from @JobController
+* @param name - Job name from @Job or @Cron
 * @returns Full job name (e.g., "email.send" or just "send")
 *
 * @example
@@ -395,22 +400,22 @@ function buildJobName(namespace, name) {
 }
 
 //#endregion
-//#region src/utils/collect-worker-metadata.ts
+//#region src/utils/collect-job-metadata.ts
 /**
-* Collect worker metadata utility
+* Collect job metadata utility
 *
-* Collects all worker metadata from a class decorated with @WorkerController.
-* Used by MonqueModule to discover and register all workers.
+* Collects all job metadata from a class decorated with @JobController.
+* Used by MonqueModule to discover and register all jobs.
 */
 /**
-* Collect all worker metadata from a class.
+* Collect all job metadata from a class.
 *
-* @param target - The class constructor (decorated with @WorkerController)
-* @returns Array of collected worker metadata ready for registration
+* @param target - The class constructor (decorated with @JobController)
+* @returns Array of collected job metadata ready for registration
 *
 * @example
 * ```typescript
-* const metadata = collectWorkerMetadata(EmailWorkers);
+* const metadata = collectJobMetadata(EmailJobs);
 * // Returns:
 * // [
 * //   { fullName: "email.send", method: "sendEmail", opts: {}, isCron: false },
@@ -418,18 +423,18 @@ function buildJobName(namespace, name) {
 * // ]
 * ```
 */
-function collectWorkerMetadata(target) {
-	const workerStore = Store.from(target).get(MONQUE);
-	if (!workerStore) return [];
+function collectJobMetadata(target) {
+	const jobStore = Store.from(target).get(MONQUE);
+	if (!jobStore) return [];
 	const results = [];
-	const namespace = workerStore.namespace;
-	for (const worker of workerStore.workers) results.push({
-		fullName: buildJobName(namespace, worker.name),
-		method: worker.method,
-		opts: worker.opts,
+	const namespace = jobStore.namespace;
+	for (const job of jobStore.jobs) results.push({
+		fullName: buildJobName(namespace, job.name),
+		method: job.method,
+		opts: job.opts,
 		isCron: false
 	});
-	for (const cron of workerStore.cronJobs) results.push({
+	for (const cron of jobStore.cronJobs) results.push({
 		fullName: buildJobName(namespace, cron.name),
 		method: cron.method,
 		opts: cron.opts,
@@ -440,29 +445,29 @@ function collectWorkerMetadata(target) {
 }
 
 //#endregion
-//#region src/utils/get-worker-token.ts
+//#region src/utils/get-job-token.ts
 /**
-* Generate a unique token for a worker controller.
+* Generate a unique token for a job controller.
 *
-* Used internally by Ts.ED DI to identify worker controller providers.
+* Used internally by Ts.ED DI to identify job controller providers.
 * The token is based on the class name for debugging purposes.
 *
 * @param target - The class constructor
-* @returns A Symbol token unique to this worker controller
+* @returns A Symbol token unique to this job controller
 *
 * @example
 * ```typescript
-* @WorkerController("email")
-* class EmailWorkers {}
+* @JobController("email")
+* class EmailJobs {}
 *
-* const token = getWorkerToken(EmailWorkers);
-* // Symbol("monque:worker:EmailWorkers")
+* const token = getJobToken(EmailJobs);
+* // Symbol("monque:job:EmailJobs")
 * ```
 */
-function getWorkerToken(target) {
+function getJobToken(target) {
 	const name = target.name?.trim();
-	if (!name) throw new Error("Worker class must have a non-empty name");
-	return Symbol.for(`monque:worker:${name}`);
+	if (!name) throw new MonqueError("Job class must have a non-empty name");
+	return Symbol.for(`monque:job:${name}`);
 }
 
 //#endregion
@@ -491,6 +496,11 @@ function isMongooseConnection(value) {
 //#endregion
 //#region src/utils/resolve-database.ts
 /**
+* @monque/tsed - Database Resolution Utility
+*
+* Multi-strategy database resolution for flexible MongoDB connection handling.
+*/
+/**
 * Resolve the MongoDB database instance from the configuration.
 *
 * Supports three resolution strategies:
@@ -527,30 +537,30 @@ async function resolveDatabase(config, injectorFn) {
 	if (config.db) return config.db;
 	if (config.dbFactory) return config.dbFactory();
 	if (config.dbToken) {
-		if (!injectorFn) throw new Error("MonqueTsedConfig.dbToken requires an injector function to resolve the database");
+		if (!injectorFn) throw new ConnectionError("MonqueTsedConfig.dbToken requires an injector function to resolve the database");
 		const resolved = injectorFn(config.dbToken);
-		if (!resolved) throw new Error(`Could not resolve database from token: ${String(config.dbToken)}. Make sure the provider is registered in the DI container.`);
+		if (!resolved) throw new ConnectionError(`Could not resolve database from token: ${String(config.dbToken)}. Make sure the provider is registered in the DI container.`);
 		if (isMongooseService(resolved)) {
 			const connectionId = config.mongooseConnectionId || "default";
 			const connection = resolved.get(connectionId);
-			if (!connection) throw new Error(`MongooseService resolved from token "${String(config.dbToken)}" returned no connection for ID "${connectionId}". Ensure the connection ID is correct and the connection is established.`);
+			if (!connection) throw new ConnectionError(`MongooseService resolved from token "${String(config.dbToken)}" returned no connection for ID "${connectionId}". Ensure the connection ID is correct and the connection is established.`);
 			if ("db" in connection && connection.db) return connection.db;
 		}
 		if (isMongooseConnection(resolved)) return resolved.db;
-		if (typeof resolved !== "object" || resolved === null || !("collection" in resolved)) throw new Error(`Resolved value from token "${String(config.dbToken)}" does not appear to be a valid MongoDB Db instance.`);
+		if (typeof resolved !== "object" || resolved === null || !("collection" in resolved)) throw new ConnectionError(`Resolved value from token "${String(config.dbToken)}" does not appear to be a valid MongoDB Db instance.`);
 		return resolved;
 	}
-	throw new Error("MonqueTsedConfig requires 'db', 'dbFactory', or 'dbToken' to be set");
+	throw new ConnectionError("MonqueTsedConfig requires 'db', 'dbFactory', or 'dbToken' to be set");
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.110.0/helpers/decorateMetadata.js
+//#region \0@oxc-project+runtime@0.112.0/helpers/decorateMetadata.js
 function __decorateMetadata(k, v) {
 	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.110.0/helpers/decorateParam.js
+//#region \0@oxc-project+runtime@0.112.0/helpers/decorateParam.js
 function __decorateParam(paramIndex, decorator) {
 	return function(target, key) {
 		decorator(target, key, paramIndex);
@@ -563,7 +573,7 @@ function __decorateParam(paramIndex, decorator) {
 * MonqueModule - Main Integration Module
 *
 * Orchestrates the integration between Monque and Ts.ED.
-* Handles lifecycle hooks, configuration resolution, and worker registration.
+* Handles lifecycle hooks, configuration resolution, and job registration.
 */
 var _ref, _ref2, _ref3, _ref4;
 let MonqueModule = class MonqueModule {
@@ -592,9 +602,12 @@ let MonqueModule = class MonqueModule {
 			this.monqueService._setMonque(this.monque);
 			this.logger.info("Monque: Connecting to MongoDB...");
 			await this.monque.initialize();
-			await this.registerWorkers();
-			await this.monque.start();
-			this.logger.info("Monque: Started successfully");
+			if (config.disableJobProcessing) this.logger.info("Monque: Job processing is disabled for this instance");
+			else {
+				await this.registerJobs();
+				await this.monque.start();
+				this.logger.info("Monque: Started successfully");
+			}
 		} catch (error) {
 			this.logger.error({
 				event: "MONQUE_INIT_ERROR",
@@ -612,25 +625,25 @@ let MonqueModule = class MonqueModule {
 		}
 	}
 	/**
-	* Discover and register all workers from @WorkerController providers
+	* Discover and register all jobs from @JobController providers
 	*/
-	async registerWorkers() {
-		if (!this.monque) throw new Error("Monque instance not initialized");
+	async registerJobs() {
+		if (!this.monque) throw new MonqueError("Monque instance not initialized");
 		const monque = this.monque;
-		const workerControllers = this.injector.getProviders(ProviderTypes.WORKER_CONTROLLER);
+		const jobControllers = this.injector.getProviders(ProviderTypes.JOB_CONTROLLER);
 		const registeredJobs = /* @__PURE__ */ new Set();
-		this.logger.info(`Monque: Found ${workerControllers.length} worker controllers`);
-		for (const provider of workerControllers) {
+		this.logger.info(`Monque: Found ${jobControllers.length} job controllers`);
+		for (const provider of jobControllers) {
 			const useClass = provider.useClass;
-			const workers = collectWorkerMetadata(useClass);
+			const jobs = collectJobMetadata(useClass);
 			const instance = this.injector.get(provider.token);
 			if (!instance && provider.scope !== ProviderScope.REQUEST) {
 				this.logger.warn(`Monque: Could not resolve instance for controller ${provider.name}. Skipping.`);
 				continue;
 			}
-			for (const worker of workers) {
-				const { fullName, method, opts, isCron, cronPattern } = worker;
-				if (registeredJobs.has(fullName)) throw new Error(`Monque: Duplicate job registration detected. Job "${fullName}" is already registered.`);
+			for (const job of jobs) {
+				const { fullName, method, opts, isCron, cronPattern } = job;
+				if (registeredJobs.has(fullName)) throw new WorkerRegistrationError(`Monque: Duplicate job registration detected. Job "${fullName}" is already registered.`, fullName);
 				registeredJobs.add(fullName);
 				const handler = async (job) => {
 					const $ctx = new DIContext({
@@ -664,7 +677,7 @@ let MonqueModule = class MonqueModule {
 					monque.register(fullName, handler, opts);
 					await monque.schedule(cronPattern, fullName, {}, opts);
 				} else {
-					this.logger.debug(`Monque: Registering worker "${fullName}"`);
+					this.logger.debug(`Monque: Registering job "${fullName}"`);
 					monque.register(fullName, handler, opts);
 				}
 			}
@@ -687,5 +700,5 @@ MonqueModule = __decorate([
 ], MonqueModule);
 
 //#endregion
-export { Cron, MONQUE, MonqueModule, MonqueService, ProviderTypes, Worker, WorkerController, buildJobName, collectWorkerMetadata, getWorkerToken, resolveDatabase, validateDatabaseConfig };
+export { Cron, Job, JobController, MONQUE, MonqueModule, MonqueService, ProviderTypes, buildJobName, collectJobMetadata, getJobToken, resolveDatabase, validateDatabaseConfig };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/config/config.ts","../src/constants/constants.ts","../src/constants/types.ts","../src/decorators/cron.ts","../src/decorators/worker.ts","../src/decorators/worker-controller.ts","../src/services/monque-service.ts","../src/utils/build-job-name.ts","../src/utils/collect-worker-metadata.ts","../src/utils/get-worker-token.ts","../src/utils/guards.ts","../src/utils/resolve-database.ts","../src/monque-module.ts"],"sourcesContent":["/**\n * @monque/tsed - Configuration\n *\n * Defines the configuration interface and TsED module augmentation.\n */\n\nimport type { MonqueTsedConfig } from './types.js';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// TsED Module Augmentation\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Augment TsED's Configuration interface to include monque settings.\n *\n * This allows type-safe configuration via @Configuration decorator.\n */\ndeclare global {\n\tnamespace TsED {\n\t\tinterface Configuration {\n\t\t\t/**\n\t\t\t * Monque job queue configuration.\n\t\t\t */\n\t\t\tmonque?: MonqueTsedConfig;\n\t\t}\n\t}\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Validation\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Validate that exactly one database resolution strategy is provided.\n *\n * @param config - The configuration to validate.\n * @throws Error if zero or multiple strategies are provided.\n *\n * @example\n * ```typescript\n * validateDatabaseConfig({ db: mongoDb }); // OK\n * validateDatabaseConfig({}); // throws\n * validateDatabaseConfig({ db: mongoDb, dbFactory: fn }); // throws\n * ```\n */\nexport function validateDatabaseConfig(config: MonqueTsedConfig): void {\n\tconst strategies = [config.db, config.dbFactory, config.dbToken].filter(Boolean);\n\n\tif (strategies.length === 0) {\n\t\tthrow new Error(\n\t\t\t\"MonqueTsedConfig requires exactly one of 'db', 'dbFactory', or 'dbToken' to be set\",\n\t\t);\n\t}\n\n\tif (strategies.length > 1) {\n\t\tthrow new Error(\n\t\t\t\"MonqueTsedConfig accepts only one of 'db', 'dbFactory', or 'dbToken' - multiple were provided\",\n\t\t);\n\t}\n}\n","/**\n * Symbol used to store decorator metadata on class constructors.\n *\n * Used by @WorkerController, @Worker, and @Cron decorators to attach\n * metadata that is later collected by MonqueModule during initialization.\n *\n * @example\n * ```typescript\n * Store.from(Class).set(MONQUE, metadata);\n * ```\n */\nexport const MONQUE = Symbol.for('monque');\n","/**\n * Provider type constants for DI scanning.\n *\n * These constants are used to categorize providers registered with Ts.ED's\n * dependency injection container, enabling MonqueModule to discover and\n * register workers automatically.\n *\n * Note: Using string constants with `as const` instead of enums per\n * Constitution guidelines.\n */\nexport const ProviderTypes = {\n\t/** Provider type for @WorkerController decorated classes */\n\tWORKER_CONTROLLER: 'monque:worker-controller',\n\t/** Provider type for cron job handlers */\n\tCRON: 'monque:cron',\n} as const;\n\n/**\n * Union type of all provider type values.\n */\nexport type ProviderType = (typeof ProviderTypes)[keyof typeof ProviderTypes];\n","import { Store } from '@tsed/core';\n\nimport { MONQUE } from '@/constants';\nimport type { CronDecoratorOptions, CronMetadata, WorkerStore } from '@/decorators/types.js';\n\n/**\n * Method decorator that registers a method as a scheduled cron job.\n *\n * @param pattern - Cron expression (e.g., \"* * * * *\", \"@daily\")\n * @param options - Optional cron configuration (name, timezone, etc.)\n *\n * @example\n * ```typescript\n * @WorkerController()\n * class ReportWorkers {\n *   @Cron(\"@daily\", { timezone: \"UTC\" })\n *   async generateDailyReport() {\n *     // ...\n *   }\n * }\n * ```\n */\nexport function Cron(pattern: string, options?: CronDecoratorOptions): MethodDecorator {\n\treturn <T>(\n\t\ttarget: object,\n\t\tpropertyKey: string | symbol,\n\t\t_descriptor: TypedPropertyDescriptor<T>,\n\t): void => {\n\t\tconst methodName = String(propertyKey);\n\n\t\tconst cronMetadata: CronMetadata = {\n\t\t\tpattern,\n\t\t\t// Default name to method name if not provided\n\t\t\tname: options?.name || methodName,\n\t\t\tmethod: methodName,\n\t\t\topts: options || {},\n\t\t};\n\n\t\t// Get the class constructor (target is the prototype for instance methods)\n\t\tconst targetConstructor = target.constructor;\n\t\tconst store = Store.from(targetConstructor);\n\n\t\t// Get or initialize the MONQUE store\n\t\tconst existing = store.get<Partial<WorkerStore>>(MONQUE) || {\n\t\t\ttype: 'controller',\n\t\t\tworkers: [],\n\t\t\tcronJobs: [],\n\t\t};\n\n\t\t// Add this cron job to the list\n\t\tconst cronJobs = [...(existing.cronJobs || []), cronMetadata];\n\n\t\tstore.set(MONQUE, {\n\t\t\t...existing,\n\t\t\tcronJobs,\n\t\t});\n\t};\n}\n","/**\n * @Worker method decorator\n *\n * Registers a method as a job handler. The method will be called when a job\n * with the matching name is picked up for processing.\n *\n * @param name - Job name (combined with controller namespace if present).\n * @param options - Worker configuration options.\n *\n * @example\n * ```typescript\n * @WorkerController(\"notifications\")\n * export class NotificationWorkers {\n *   @Worker(\"push\", { concurrency: 10 })\n *   async sendPush(job: Job<PushPayload>) {\n *     await pushService.send(job.data);\n *   }\n * }\n * ```\n */\nimport { Store } from '@tsed/core';\n\nimport { MONQUE } from '@/constants';\n\nimport type { WorkerDecoratorOptions, WorkerMetadata, WorkerStore } from './types.js';\n\n/**\n * Method decorator that registers a method as a job handler.\n *\n * @param name - The job name (will be prefixed with controller namespace if present)\n * @param options - Optional worker configuration (concurrency, replace, etc.)\n */\nexport function Worker(name: string, options?: WorkerDecoratorOptions): MethodDecorator {\n\treturn <T>(\n\t\ttarget: object,\n\t\tpropertyKey: string | symbol,\n\t\t_descriptor: TypedPropertyDescriptor<T>,\n\t): void => {\n\t\tconst methodName = String(propertyKey);\n\n\t\tconst workerMetadata: WorkerMetadata = {\n\t\t\tname,\n\t\t\tmethod: methodName,\n\t\t\topts: options || {},\n\t\t};\n\n\t\t// Get the class constructor (target is the prototype for instance methods)\n\t\tconst targetConstructor = target.constructor;\n\t\tconst store = Store.from(targetConstructor);\n\n\t\t// Get or initialize the MONQUE store\n\t\tconst existing = store.get<Partial<WorkerStore>>(MONQUE) || {\n\t\t\ttype: 'controller',\n\t\t\tworkers: [],\n\t\t\tcronJobs: [],\n\t\t};\n\n\t\t// Add this worker to the list\n\t\tconst workers = [...(existing.workers || []), workerMetadata];\n\n\t\tstore.set(MONQUE, {\n\t\t\t...existing,\n\t\t\tworkers,\n\t\t});\n\t};\n}\n","/**\n * @WorkerController class decorator\n *\n * Marks a class as containing worker methods and registers it with the Ts.ED DI container.\n * Workers in the class will have their job names prefixed with the namespace.\n *\n * @param namespace - Optional prefix for all job names in this controller.\n *                    When set, job names become \"{namespace}.{name}\".\n *\n * @example\n * ```typescript\n * @WorkerController(\"email\")\n * export class EmailWorkers {\n *   @Worker(\"send\")  // Registered as \"email.send\"\n *   async send(job: Job<EmailPayload>) { }\n * }\n * ```\n */\nimport { Store, useDecorators } from '@tsed/core';\nimport { Injectable } from '@tsed/di';\n\nimport { MONQUE, ProviderTypes } from '@/constants';\n\nimport type { WorkerStore } from './types.js';\n\n/**\n * Class decorator that registers a class as a worker controller.\n *\n * @param namespace - Optional namespace prefix for job names\n */\nexport function WorkerController(namespace?: string): ClassDecorator {\n\treturn useDecorators(\n\t\t// Register as injectable with custom provider type\n\t\tInjectable({\n\t\t\ttype: ProviderTypes.WORKER_CONTROLLER,\n\t\t}),\n\t\t// Apply custom decorator to store metadata\n\t\t(target: object) => {\n\t\t\tconst store = Store.from(target);\n\n\t\t\t// Get existing store or create new one\n\t\t\tconst existing = store.get<Partial<WorkerStore>>(MONQUE) || {};\n\n\t\t\t// Merge with new metadata, only include namespace if defined\n\t\t\tconst workerStore: WorkerStore = {\n\t\t\t\ttype: 'controller',\n\t\t\t\t...(namespace !== undefined && { namespace }),\n\t\t\t\tworkers: existing.workers || [],\n\t\t\t\tcronJobs: existing.cronJobs || [],\n\t\t\t};\n\n\t\t\tstore.set(MONQUE, workerStore);\n\t\t},\n\t);\n}\n","/**\n * MonqueService - Injectable wrapper for Monque\n *\n * Provides a DI-friendly interface to the Monque job queue.\n * All methods delegate to the underlying Monque instance.\n *\n * @example\n * ```typescript\n * @Service()\n * export class OrderService {\n *   @Inject()\n *   private monque: MonqueService;\n *\n *   async createOrder(data: CreateOrderDto) {\n *     const order = await this.save(data);\n *     await this.monque.enqueue(\"order.process\", { orderId: order.id });\n *     return order;\n *   }\n * }\n * ```\n */\n\nimport type {\n\tBulkOperationResult,\n\tCursorOptions,\n\tCursorPage,\n\tEnqueueOptions,\n\tGetJobsFilter,\n\tJobSelector,\n\tMonque,\n\tPersistedJob,\n\tQueueStats,\n\tScheduleOptions,\n} from '@monque/core';\nimport { MonqueError } from '@monque/core';\nimport { Injectable } from '@tsed/di';\nimport { ObjectId } from 'mongodb';\n\n/**\n * Injectable service that wraps the Monque instance.\n *\n * Exposes the full Monque public API through dependency injection.\n */\n@Injectable()\nexport class MonqueService {\n\t/**\n\t * Internal Monque instance (set by MonqueModule)\n\t * @internal\n\t */\n\tprivate _monque: Monque | null = null;\n\n\t/**\n\t * Set the internal Monque instance.\n\t * Called by MonqueModule during initialization.\n\t * @internal\n\t */\n\t_setMonque(monque: Monque): void {\n\t\tthis._monque = monque;\n\t}\n\n\t/**\n\t * Access the underlying Monque instance.\n\t * @throws Error if MonqueModule is not initialized\n\t */\n\tget monque(): Monque {\n\t\tif (!this._monque) {\n\t\t\tthrow new MonqueError(\n\t\t\t\t'MonqueService is not initialized. Ensure MonqueModule is imported and enabled.',\n\t\t\t);\n\t\t}\n\n\t\treturn this._monque;\n\t}\n\n\t// ─────────────────────────────────────────────────────────────────────────────\n\t// Job Scheduling\n\t// ─────────────────────────────────────────────────────────────────────────────\n\n\t/**\n\t * Enqueue a job for processing.\n\t *\n\t * @param name - Job type identifier (use full namespaced name, e.g., \"email.send\")\n\t * @param data - Job payload\n\t * @param options - Scheduling and deduplication options\n\t * @returns The created or existing job document\n\t */\n\tasync enqueue<T>(name: string, data: T, options?: EnqueueOptions): Promise<PersistedJob<T>> {\n\t\treturn this.monque.enqueue(name, data, options);\n\t}\n\n\t/**\n\t * Enqueue a job for immediate processing.\n\t *\n\t * @param name - Job type identifier\n\t * @param data - Job payload\n\t * @returns The created job document\n\t */\n\tasync now<T>(name: string, data: T): Promise<PersistedJob<T>> {\n\t\treturn this.monque.now(name, data);\n\t}\n\n\t/**\n\t * Schedule a recurring job with a cron expression.\n\t *\n\t * @param cron - Cron expression (5-field standard or predefined like @daily)\n\t * @param name - Job type identifier\n\t * @param data - Job payload\n\t * @param options - Scheduling options\n\t * @returns The created job document\n\t */\n\tasync schedule<T>(\n\t\tcron: string,\n\t\tname: string,\n\t\tdata: T,\n\t\toptions?: ScheduleOptions,\n\t): Promise<PersistedJob<T>> {\n\t\treturn this.monque.schedule(cron, name, data, options);\n\t}\n\n\t// ─────────────────────────────────────────────────────────────────────────────\n\t// Job Management (Single Job Operations)\n\t// ─────────────────────────────────────────────────────────────────────────────\n\n\t/**\n\t * Cancel a pending or scheduled job.\n\t *\n\t * @param jobId - The ID of the job to cancel\n\t * @returns The cancelled job, or null if not found\n\t */\n\tasync cancelJob(jobId: string): Promise<PersistedJob<unknown> | null> {\n\t\treturn this.monque.cancelJob(jobId);\n\t}\n\n\t/**\n\t * Retry a failed or cancelled job.\n\t *\n\t * @param jobId - The ID of the job to retry\n\t * @returns The updated job, or null if not found\n\t */\n\tasync retryJob(jobId: string): Promise<PersistedJob<unknown> | null> {\n\t\treturn this.monque.retryJob(jobId);\n\t}\n\n\t/**\n\t * Reschedule a pending job to run at a different time.\n\t *\n\t * @param jobId - The ID of the job to reschedule\n\t * @param runAt - The new Date when the job should run\n\t * @returns The updated job, or null if not found\n\t */\n\tasync rescheduleJob(jobId: string, runAt: Date): Promise<PersistedJob<unknown> | null> {\n\t\treturn this.monque.rescheduleJob(jobId, runAt);\n\t}\n\n\t/**\n\t * Permanently delete a job.\n\t *\n\t * @param jobId - The ID of the job to delete\n\t * @returns true if deleted, false if job not found\n\t */\n\tasync deleteJob(jobId: string): Promise<boolean> {\n\t\treturn this.monque.deleteJob(jobId);\n\t}\n\n\t// ─────────────────────────────────────────────────────────────────────────────\n\t// Job Management (Bulk Operations)\n\t// ─────────────────────────────────────────────────────────────────────────────\n\n\t/**\n\t * Cancel multiple jobs matching the given filter.\n\t *\n\t * @param filter - Selector for which jobs to cancel\n\t * @returns Result with count of cancelled jobs\n\t */\n\tasync cancelJobs(filter: JobSelector): Promise<BulkOperationResult> {\n\t\treturn this.monque.cancelJobs(filter);\n\t}\n\n\t/**\n\t * Retry multiple jobs matching the given filter.\n\t *\n\t * @param filter - Selector for which jobs to retry\n\t * @returns Result with count of retried jobs\n\t */\n\tasync retryJobs(filter: JobSelector): Promise<BulkOperationResult> {\n\t\treturn this.monque.retryJobs(filter);\n\t}\n\n\t/**\n\t * Delete multiple jobs matching the given filter.\n\t *\n\t * @param filter - Selector for which jobs to delete\n\t * @returns Result with count of deleted jobs\n\t */\n\tasync deleteJobs(filter: JobSelector): Promise<BulkOperationResult> {\n\t\treturn this.monque.deleteJobs(filter);\n\t}\n\n\t// ─────────────────────────────────────────────────────────────────────────────\n\t// Job Queries\n\t// ─────────────────────────────────────────────────────────────────────────────\n\n\t/**\n\t * Get a job by its ID.\n\t *\n\t * @param jobId - The job's ObjectId (as string or ObjectId)\n\t * @returns The job document, or null if not found\n\t * @throws MonqueError if jobId is an invalid hex string\n\t */\n\tasync getJob<T>(jobId: string | ObjectId): Promise<PersistedJob<T> | null> {\n\t\tlet id: ObjectId;\n\n\t\tif (typeof jobId === 'string') {\n\t\t\tif (!ObjectId.isValid(jobId)) {\n\t\t\t\tthrow new MonqueError(`Invalid job ID format: ${jobId}`);\n\t\t\t}\n\t\t\tid = ObjectId.createFromHexString(jobId);\n\t\t} else {\n\t\t\tid = jobId;\n\t\t}\n\n\t\treturn this.monque.getJob(id);\n\t}\n\n\t/**\n\t * Query jobs from the queue with optional filters.\n\t *\n\t * @param filter - Optional filter criteria (name, status, limit, skip)\n\t * @returns Array of matching jobs\n\t */\n\tasync getJobs<T>(filter?: GetJobsFilter): Promise<PersistedJob<T>[]> {\n\t\treturn this.monque.getJobs(filter);\n\t}\n\n\t/**\n\t * Get a paginated list of jobs using opaque cursors.\n\t *\n\t * @param options - Pagination options (cursor, limit, direction, filter)\n\t * @returns Page of jobs with next/prev cursors\n\t */\n\tasync getJobsWithCursor<T>(options?: CursorOptions): Promise<CursorPage<T>> {\n\t\treturn this.monque.getJobsWithCursor(options);\n\t}\n\n\t/**\n\t * Get aggregate statistics for the job queue.\n\t *\n\t * @param filter - Optional filter to scope statistics by job name\n\t * @returns Queue statistics\n\t */\n\tasync getQueueStats(filter?: Pick<JobSelector, 'name'>): Promise<QueueStats> {\n\t\treturn this.monque.getQueueStats(filter);\n\t}\n\n\t// ─────────────────────────────────────────────────────────────────────────────\n\t// Health Check\n\t// ─────────────────────────────────────────────────────────────────────────────\n\n\t/**\n\t * Check if the scheduler is healthy and running.\n\t *\n\t * @returns true if running and connected\n\t */\n\tisHealthy(): boolean {\n\t\treturn this.monque.isHealthy();\n\t}\n}\n","/**\n * Build the full job name by combining namespace and name.\n *\n * @param namespace - Optional namespace from @WorkerController\n * @param name - Job name from @Worker or @Cron\n * @returns Full job name (e.g., \"email.send\" or just \"send\")\n *\n * @example\n * ```typescript\n * buildJobName(\"email\", \"send\"); // \"email.send\"\n * buildJobName(undefined, \"send\"); // \"send\"\n * buildJobName(\"\", \"send\"); // \"send\"\n * ```\n */\nexport function buildJobName(namespace: string | undefined, name: string): string {\n\treturn namespace ? `${namespace}.${name}` : name;\n}\n","/**\n * Collect worker metadata utility\n *\n * Collects all worker metadata from a class decorated with @WorkerController.\n * Used by MonqueModule to discover and register all workers.\n */\nimport { Store } from '@tsed/core';\n\nimport { MONQUE } from '@/constants';\nimport type { CronDecoratorOptions, WorkerDecoratorOptions, WorkerStore } from '@/decorators';\n\nimport { buildJobName } from './build-job-name.js';\n\n/**\n * Collected worker registration info ready for Monque.register()\n */\nexport interface CollectedWorkerMetadata {\n\t/**\n\t * Full job name (with namespace prefix if applicable)\n\t */\n\tfullName: string;\n\n\t/**\n\t * Method name on the controller class\n\t */\n\tmethod: string;\n\n\t/**\n\t * Worker options to pass to Monque.register()\n\t */\n\topts: WorkerDecoratorOptions | CronDecoratorOptions;\n\n\t/**\n\t * Whether this is a cron job\n\t */\n\tisCron: boolean;\n\n\t/**\n\t * Cron pattern (only for cron jobs)\n\t */\n\tcronPattern?: string;\n}\n\n/**\n * Collect all worker metadata from a class.\n *\n * @param target - The class constructor (decorated with @WorkerController)\n * @returns Array of collected worker metadata ready for registration\n *\n * @example\n * ```typescript\n * const metadata = collectWorkerMetadata(EmailWorkers);\n * // Returns:\n * // [\n * //   { fullName: \"email.send\", method: \"sendEmail\", opts: {}, isCron: false },\n * //   { fullName: \"email.daily-digest\", method: \"sendDailyDigest\", opts: {}, isCron: true, cronPattern: \"0 9 * * *\" }\n * // ]\n * ```\n */\nexport function collectWorkerMetadata(\n\ttarget: new (...args: unknown[]) => unknown,\n): CollectedWorkerMetadata[] {\n\tconst store = Store.from(target);\n\tconst workerStore = store.get<WorkerStore>(MONQUE);\n\n\tif (!workerStore) {\n\t\treturn [];\n\t}\n\n\tconst results: CollectedWorkerMetadata[] = [];\n\tconst namespace = workerStore.namespace;\n\n\t// Collect regular workers\n\tfor (const worker of workerStore.workers) {\n\t\tresults.push({\n\t\t\tfullName: buildJobName(namespace, worker.name),\n\t\t\tmethod: worker.method,\n\t\t\topts: worker.opts,\n\t\t\tisCron: false,\n\t\t});\n\t}\n\n\t// Collect cron jobs\n\tfor (const cron of workerStore.cronJobs) {\n\t\tresults.push({\n\t\t\tfullName: buildJobName(namespace, cron.name),\n\t\t\tmethod: cron.method,\n\t\t\topts: cron.opts,\n\t\t\tisCron: true,\n\t\t\tcronPattern: cron.pattern,\n\t\t});\n\t}\n\n\treturn results;\n}\n","/**\n * Generate a unique token for a worker controller.\n *\n * Used internally by Ts.ED DI to identify worker controller providers.\n * The token is based on the class name for debugging purposes.\n *\n * @param target - The class constructor\n * @returns A Symbol token unique to this worker controller\n *\n * @example\n * ```typescript\n * @WorkerController(\"email\")\n * class EmailWorkers {}\n *\n * const token = getWorkerToken(EmailWorkers);\n * // Symbol(\"monque:worker:EmailWorkers\")\n * ```\n */\nexport function getWorkerToken(target: new (...args: unknown[]) => unknown): symbol {\n\tconst name = target.name?.trim();\n\n\tif (!name) {\n\t\tthrow new Error('Worker class must have a non-empty name');\n\t}\n\n\treturn Symbol.for(`monque:worker:${name}`);\n}\n","/**\n * @monque/tsed - Type Guards\n *\n * Utilities for duck-typing Mongoose and MongoDB related objects\n * to avoid hard dependencies on @tsed/mongoose.\n */\n\nimport type { Db } from 'mongodb';\n\n/**\n * Interface representing a Mongoose Connection object.\n * We only care that it has a `db` property which is a MongoDB Db instance.\n */\nexport interface MongooseConnection {\n\tdb: Db;\n}\n\n/**\n * Interface representing the @tsed/mongoose MongooseService.\n * It acts as a registry/factory for connections.\n */\nexport interface MongooseService {\n\t/**\n\t * Get a connection by its ID (configuration key).\n\t * @param id The connection ID (default: \"default\")\n\t */\n\tget(id?: string): MongooseConnection | undefined;\n}\n\n/**\n * Type guard to check if an object acts like a Mongoose Service.\n *\n * Checks if the object has a `get` method.\n *\n * @param value The value to check\n */\nexport function isMongooseService(value: unknown): value is MongooseService {\n\treturn (\n\t\ttypeof value === 'object' &&\n\t\tvalue !== null &&\n\t\t'get' in value &&\n\t\ttypeof (value as MongooseService).get === 'function'\n\t);\n}\n\n/**\n * Type guard to check if an object acts like a Mongoose Connection.\n *\n * Checks if the object has a `db` property.\n *\n * @param value The value to check\n */\nexport function isMongooseConnection(value: unknown): value is MongooseConnection {\n\treturn (\n\t\ttypeof value === 'object' &&\n\t\tvalue !== null &&\n\t\t'db' in value &&\n\t\ttypeof (value as MongooseConnection).db === 'object' &&\n\t\t(value as MongooseConnection).db !== null &&\n\t\ttypeof (value as MongooseConnection).db.collection === 'function'\n\t);\n}\n","/**\n * @monque/tsed - Database Resolution Utility\n *\n * Multi-strategy database resolution for flexible MongoDB connection handling.\n */\n\nimport type { TokenProvider } from '@tsed/di';\nimport type { Db } from 'mongodb';\n\nimport type { MonqueTsedConfig } from '@/config';\n\nimport { isMongooseConnection, isMongooseService } from './guards.js';\n\n/**\n * Type for the injector function used to resolve DI tokens.\n */\nexport type InjectorFn = <T>(token: TokenProvider<T>) => T | undefined;\n\n/**\n * Resolve the MongoDB database instance from the configuration.\n *\n * Supports three resolution strategies:\n * 1. **Direct `db`**: Returns the provided Db instance directly\n * 2. **Factory `dbFactory`**: Calls the factory function (supports async)\n * 3. **DI Token `dbToken`**: Resolves the Db from the DI container\n *\n * @param config - The Monque configuration containing database settings\n * @param injectorFn - Optional function to resolve DI tokens (required for dbToken strategy)\n * @returns The resolved MongoDB Db instance\n * @throws Error if no database strategy is provided or if DI resolution fails\n *\n * @example\n * ```typescript\n * // Direct Db instance\n * const db = await resolveDatabase({ db: mongoDb });\n *\n * // Factory function\n * const db = await resolveDatabase({\n *   dbFactory: async () => {\n *     const client = await MongoClient.connect(uri);\n *     return client.db(\"myapp\");\n *   }\n * });\n *\n * // DI token\n * const db = await resolveDatabase(\n *   { dbToken: \"MONGODB_DATABASE\" },\n *   (token) => injector.get(token)\n * );\n * ```\n */\nexport async function resolveDatabase(\n\tconfig: MonqueTsedConfig,\n\tinjectorFn?: InjectorFn,\n): Promise<Db> {\n\t// Strategy 1: Direct Db instance\n\tif (config.db) {\n\t\treturn config.db;\n\t}\n\n\t// Strategy 2: Factory function (sync or async)\n\tif (config.dbFactory) {\n\t\treturn config.dbFactory();\n\t}\n\n\t// Strategy 3: DI token resolution\n\tif (config.dbToken) {\n\t\tif (!injectorFn) {\n\t\t\tthrow new Error(\n\t\t\t\t'MonqueTsedConfig.dbToken requires an injector function to resolve the database',\n\t\t\t);\n\t\t}\n\n\t\tconst resolved = injectorFn(config.dbToken);\n\n\t\tif (!resolved) {\n\t\t\tthrow new Error(\n\t\t\t\t`Could not resolve database from token: ${String(config.dbToken)}. ` +\n\t\t\t\t\t'Make sure the provider is registered in the DI container.',\n\t\t\t);\n\t\t}\n\n\t\tif (isMongooseService(resolved)) {\n\t\t\t// Check for Mongoose Service (duck typing)\n\t\t\t// It has a get() method that returns a connection\n\t\t\tconst connectionId = config.mongooseConnectionId || 'default';\n\t\t\tconst connection = resolved.get(connectionId);\n\n\t\t\tif (!connection) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`MongooseService resolved from token \"${String(config.dbToken)}\" returned no connection for ID \"${connectionId}\". ` +\n\t\t\t\t\t\t'Ensure the connection ID is correct and the connection is established.',\n\t\t\t\t);\n\t\t\t}\n\n\t\t\tif ('db' in connection && connection.db) {\n\t\t\t\treturn connection.db as Db;\n\t\t\t}\n\t\t}\n\n\t\tif (isMongooseConnection(resolved)) {\n\t\t\t// Check for Mongoose Connection (duck typing)\n\t\t\t// It has a db property that is the native Db instance\n\t\t\treturn resolved.db as Db;\n\t\t}\n\n\t\t// Default: Assume it is a native Db instance\n\t\tif (typeof resolved !== 'object' || resolved === null || !('collection' in resolved)) {\n\t\t\tthrow new Error(\n\t\t\t\t`Resolved value from token \"${String(config.dbToken)}\" does not appear to be a valid MongoDB Db instance.`,\n\t\t\t);\n\t\t}\n\n\t\treturn resolved as Db;\n\t}\n\n\t// No strategy provided\n\tthrow new Error(\"MonqueTsedConfig requires 'db', 'dbFactory', or 'dbToken' to be set\");\n}\n","/**\n * MonqueModule - Main Integration Module\n *\n * Orchestrates the integration between Monque and Ts.ED.\n * Handles lifecycle hooks, configuration resolution, and worker registration.\n */\n\nimport {\n\ttype Job,\n\tMonque,\n\ttype MonqueOptions,\n\ttype ScheduleOptions,\n\ttype WorkerOptions,\n} from '@monque/core';\nimport {\n\tConfiguration,\n\tDIContext,\n\tInject,\n\tInjectorService,\n\tLOGGER,\n\tModule,\n\ttype OnDestroy,\n\ttype OnInit,\n\tProviderScope,\n\trunInContext,\n\ttype TokenProvider,\n} from '@tsed/di';\n\nimport { type MonqueTsedConfig, validateDatabaseConfig } from '@/config';\nimport { ProviderTypes } from '@/constants';\nimport { MonqueService } from '@/services';\nimport { collectWorkerMetadata, resolveDatabase } from '@/utils';\n\n@Module({\n\timports: [MonqueService],\n})\nexport class MonqueModule implements OnInit, OnDestroy {\n\tprotected injector: InjectorService;\n\tprotected monqueService: MonqueService;\n\tprotected logger: LOGGER;\n\tprotected monqueConfig: MonqueTsedConfig;\n\n\tprotected monque: Monque | null = null;\n\n\tconstructor(\n\t\t@Inject(InjectorService) injector: InjectorService,\n\t\t@Inject(MonqueService) monqueService: MonqueService,\n\t\t@Inject(LOGGER) logger: LOGGER,\n\t\t@Inject(Configuration) configuration: Configuration,\n\t) {\n\t\tthis.injector = injector;\n\t\tthis.monqueService = monqueService;\n\t\tthis.logger = logger;\n\t\tthis.monqueConfig = configuration.get<MonqueTsedConfig>('monque') || {};\n\t}\n\n\tasync $onInit(): Promise<void> {\n\t\tconst config = this.monqueConfig;\n\n\t\tif (config?.enabled === false) {\n\t\t\tthis.logger.info('Monque integration is disabled');\n\n\t\t\treturn;\n\t\t}\n\n\t\tvalidateDatabaseConfig(config);\n\n\t\ttry {\n\t\t\tconst db = await resolveDatabase(config, (token) =>\n\t\t\t\tthis.injector.get(token as TokenProvider),\n\t\t\t);\n\n\t\t\t// We construct the options object carefully to match MonqueOptions\n\t\t\tconst { db: _db, ...restConfig } = config;\n\t\t\tconst options: MonqueOptions = restConfig;\n\n\t\t\tthis.monque = new Monque(db, options);\n\t\t\tthis.monqueService._setMonque(this.monque);\n\n\t\t\tthis.logger.info('Monque: Connecting to MongoDB...');\n\t\t\tawait this.monque.initialize();\n\n\t\t\tawait this.registerWorkers();\n\n\t\t\tawait this.monque.start();\n\n\t\t\tthis.logger.info('Monque: Started successfully');\n\t\t} catch (error) {\n\t\t\tthis.logger.error({\n\t\t\t\tevent: 'MONQUE_INIT_ERROR',\n\t\t\t\tmessage: 'Failed to initialize Monque',\n\t\t\t\terror,\n\t\t\t});\n\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\tasync $onDestroy(): Promise<void> {\n\t\tif (this.monque) {\n\t\t\tthis.logger.info('Monque: Stopping...');\n\n\t\t\tawait this.monque.stop();\n\n\t\t\tthis.logger.info('Monque: Stopped');\n\t\t}\n\t}\n\n\t/**\n\t * Discover and register all workers from @WorkerController providers\n\t */\n\tprotected async registerWorkers(): Promise<void> {\n\t\tif (!this.monque) {\n\t\t\tthrow new Error('Monque instance not initialized');\n\t\t}\n\n\t\tconst monque = this.monque;\n\t\tconst workerControllers = this.injector.getProviders(ProviderTypes.WORKER_CONTROLLER);\n\t\tconst registeredJobs = new Set<string>();\n\n\t\tthis.logger.info(`Monque: Found ${workerControllers.length} worker controllers`);\n\n\t\tfor (const provider of workerControllers) {\n\t\t\tconst useClass = provider.useClass;\n\t\t\tconst workers = collectWorkerMetadata(useClass);\n\t\t\t// Try to resolve singleton instance immediately\n\t\t\tconst instance = this.injector.get(provider.token);\n\n\t\t\tif (!instance && provider.scope !== ProviderScope.REQUEST) {\n\t\t\t\tthis.logger.warn(\n\t\t\t\t\t`Monque: Could not resolve instance for controller ${provider.name}. Skipping.`,\n\t\t\t\t);\n\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tfor (const worker of workers) {\n\t\t\t\tconst { fullName, method, opts, isCron, cronPattern } = worker;\n\n\t\t\t\tif (registeredJobs.has(fullName)) {\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t`Monque: Duplicate job registration detected. Job \"${fullName}\" is already registered.`,\n\t\t\t\t\t);\n\t\t\t\t}\n\n\t\t\t\tregisteredJobs.add(fullName);\n\n\t\t\t\tconst handler = async (job: Job) => {\n\t\t\t\t\tconst $ctx = new DIContext({\n\t\t\t\t\t\tinjector: this.injector,\n\t\t\t\t\t\tid: job._id?.toString() || 'unknown',\n\t\t\t\t\t});\n\t\t\t\t\t$ctx.set('MONQUE_JOB', job);\n\t\t\t\t\t$ctx.container.set(DIContext, $ctx);\n\n\t\t\t\t\tawait runInContext($ctx, async () => {\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\tlet targetInstance = instance;\n\t\t\t\t\t\t\tif (provider.scope === ProviderScope.REQUEST || !targetInstance) {\n\t\t\t\t\t\t\t\ttargetInstance = await this.injector.invoke(provider.token, {\n\t\t\t\t\t\t\t\t\tlocals: $ctx.container,\n\t\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\tconst typedInstance = targetInstance as Record<string, (job: Job) => unknown>;\n\n\t\t\t\t\t\t\tif (typedInstance && typeof typedInstance[method] === 'function') {\n\t\t\t\t\t\t\t\tawait typedInstance[method](job);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\t\tthis.logger.error({\n\t\t\t\t\t\t\t\tevent: 'MONQUE_JOB_ERROR',\n\t\t\t\t\t\t\t\tjobName: fullName,\n\t\t\t\t\t\t\t\tjobId: job._id,\n\t\t\t\t\t\t\t\tmessage: `Error processing job ${fullName}`,\n\t\t\t\t\t\t\t\terror,\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\tthrow error;\n\t\t\t\t\t\t} finally {\n\t\t\t\t\t\t\tawait $ctx.destroy();\n\t\t\t\t\t\t}\n\t\t\t\t\t});\n\t\t\t\t};\n\n\t\t\t\tif (isCron && cronPattern) {\n\t\t\t\t\tthis.logger.debug(`Monque: Registering cron job \"${fullName}\" (${cronPattern})`);\n\n\t\t\t\t\tmonque.register(fullName, handler, opts as WorkerOptions);\n\t\t\t\t\tawait monque.schedule(cronPattern, fullName, {}, opts as ScheduleOptions);\n\t\t\t\t} else {\n\t\t\t\t\tthis.logger.debug(`Monque: Registering worker \"${fullName}\"`);\n\t\t\t\t\tmonque.register(fullName, handler, opts as WorkerOptions);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tthis.logger.info(`Monque: Registered ${registeredJobs.size} jobs`);\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AA6CA,SAAgB,uBAAuB,QAAgC;CACtE,MAAM,aAAa;EAAC,OAAO;EAAI,OAAO;EAAW,OAAO;EAAQ,CAAC,OAAO,QAAQ;AAEhF,KAAI,WAAW,WAAW,EACzB,OAAM,IAAI,MACT,qFACA;AAGF,KAAI,WAAW,SAAS,EACvB,OAAM,IAAI,MACT,gGACA;;;;;;;;;;;;;;;;AC9CH,MAAa,SAAS,OAAO,IAAI,SAAS;;;;;;;;;;;;;;ACD1C,MAAa,gBAAgB;CAE5B,mBAAmB;CAEnB,MAAM;CACN;;;;;;;;;;;;;;;;;;;;;ACOD,SAAgB,KAAK,SAAiB,SAAiD;AACtF,SACC,QACA,aACA,gBACU;EACV,MAAM,aAAa,OAAO,YAAY;EAEtC,MAAM,eAA6B;GAClC;GAEA,MAAM,SAAS,QAAQ;GACvB,QAAQ;GACR,MAAM,WAAW,EAAE;GACnB;EAGD,MAAM,oBAAoB,OAAO;EACjC,MAAM,QAAQ,MAAM,KAAK,kBAAkB;EAG3C,MAAM,WAAW,MAAM,IAA0B,OAAO,IAAI;GAC3D,MAAM;GACN,SAAS,EAAE;GACX,UAAU,EAAE;GACZ;EAGD,MAAM,WAAW,CAAC,GAAI,SAAS,YAAY,EAAE,EAAG,aAAa;AAE7D,QAAM,IAAI,QAAQ;GACjB,GAAG;GACH;GACA,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACvBJ,SAAgB,OAAO,MAAc,SAAmD;AACvF,SACC,QACA,aACA,gBACU;EAGV,MAAM,iBAAiC;GACtC;GACA,QAJkB,OAAO,YAAY;GAKrC,MAAM,WAAW,EAAE;GACnB;EAGD,MAAM,oBAAoB,OAAO;EACjC,MAAM,QAAQ,MAAM,KAAK,kBAAkB;EAG3C,MAAM,WAAW,MAAM,IAA0B,OAAO,IAAI;GAC3D,MAAM;GACN,SAAS,EAAE;GACX,UAAU,EAAE;GACZ;EAGD,MAAM,UAAU,CAAC,GAAI,SAAS,WAAW,EAAE,EAAG,eAAe;AAE7D,QAAM,IAAI,QAAQ;GACjB,GAAG;GACH;GACA,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACjCJ,SAAgB,iBAAiB,WAAoC;AACpE,QAAO,cAEN,WAAW,EACV,MAAM,cAAc,mBACpB,CAAC,GAED,WAAmB;EACnB,MAAM,QAAQ,MAAM,KAAK,OAAO;EAGhC,MAAM,WAAW,MAAM,IAA0B,OAAO,IAAI,EAAE;EAG9D,MAAM,cAA2B;GAChC,MAAM;GACN,GAAI,cAAc,UAAa,EAAE,WAAW;GAC5C,SAAS,SAAS,WAAW,EAAE;GAC/B,UAAU,SAAS,YAAY,EAAE;GACjC;AAED,QAAM,IAAI,QAAQ,YAAY;GAE/B;;;;;;;;;;;;;;ACTK,0BAAM,cAAc;;;;;CAK1B,AAAQ,UAAyB;;;;;;CAOjC,WAAW,QAAsB;AAChC,OAAK,UAAU;;;;;;CAOhB,IAAI,SAAiB;AACpB,MAAI,CAAC,KAAK,QACT,OAAM,IAAI,YACT,iFACA;AAGF,SAAO,KAAK;;;;;;;;;;CAeb,MAAM,QAAW,MAAc,MAAS,SAAoD;AAC3F,SAAO,KAAK,OAAO,QAAQ,MAAM,MAAM,QAAQ;;;;;;;;;CAUhD,MAAM,IAAO,MAAc,MAAmC;AAC7D,SAAO,KAAK,OAAO,IAAI,MAAM,KAAK;;;;;;;;;;;CAYnC,MAAM,SACL,MACA,MACA,MACA,SAC2B;AAC3B,SAAO,KAAK,OAAO,SAAS,MAAM,MAAM,MAAM,QAAQ;;;;;;;;CAavD,MAAM,UAAU,OAAsD;AACrE,SAAO,KAAK,OAAO,UAAU,MAAM;;;;;;;;CASpC,MAAM,SAAS,OAAsD;AACpE,SAAO,KAAK,OAAO,SAAS,MAAM;;;;;;;;;CAUnC,MAAM,cAAc,OAAe,OAAoD;AACtF,SAAO,KAAK,OAAO,cAAc,OAAO,MAAM;;;;;;;;CAS/C,MAAM,UAAU,OAAiC;AAChD,SAAO,KAAK,OAAO,UAAU,MAAM;;;;;;;;CAapC,MAAM,WAAW,QAAmD;AACnE,SAAO,KAAK,OAAO,WAAW,OAAO;;;;;;;;CAStC,MAAM,UAAU,QAAmD;AAClE,SAAO,KAAK,OAAO,UAAU,OAAO;;;;;;;;CASrC,MAAM,WAAW,QAAmD;AACnE,SAAO,KAAK,OAAO,WAAW,OAAO;;;;;;;;;CActC,MAAM,OAAU,OAA2D;EAC1E,IAAI;AAEJ,MAAI,OAAO,UAAU,UAAU;AAC9B,OAAI,CAAC,SAAS,QAAQ,MAAM,CAC3B,OAAM,IAAI,YAAY,0BAA0B,QAAQ;AAEzD,QAAK,SAAS,oBAAoB,MAAM;QAExC,MAAK;AAGN,SAAO,KAAK,OAAO,OAAO,GAAG;;;;;;;;CAS9B,MAAM,QAAW,QAAoD;AACpE,SAAO,KAAK,OAAO,QAAQ,OAAO;;;;;;;;CASnC,MAAM,kBAAqB,SAAiD;AAC3E,SAAO,KAAK,OAAO,kBAAkB,QAAQ;;;;;;;;CAS9C,MAAM,cAAc,QAAyD;AAC5E,SAAO,KAAK,OAAO,cAAc,OAAO;;;;;;;CAYzC,YAAqB;AACpB,SAAO,KAAK,OAAO,WAAW;;;4BA7N/B,YAAY;;;;;;;;;;;;;;;;;;AC7Bb,SAAgB,aAAa,WAA+B,MAAsB;AACjF,QAAO,YAAY,GAAG,UAAU,GAAG,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;AC4C7C,SAAgB,sBACf,QAC4B;CAE5B,MAAM,cADQ,MAAM,KAAK,OAAO,CACN,IAAiB,OAAO;AAElD,KAAI,CAAC,YACJ,QAAO,EAAE;CAGV,MAAM,UAAqC,EAAE;CAC7C,MAAM,YAAY,YAAY;AAG9B,MAAK,MAAM,UAAU,YAAY,QAChC,SAAQ,KAAK;EACZ,UAAU,aAAa,WAAW,OAAO,KAAK;EAC9C,QAAQ,OAAO;EACf,MAAM,OAAO;EACb,QAAQ;EACR,CAAC;AAIH,MAAK,MAAM,QAAQ,YAAY,SAC9B,SAAQ,KAAK;EACZ,UAAU,aAAa,WAAW,KAAK,KAAK;EAC5C,QAAQ,KAAK;EACb,MAAM,KAAK;EACX,QAAQ;EACR,aAAa,KAAK;EAClB,CAAC;AAGH,QAAO;;;;;;;;;;;;;;;;;;;;;;;AC3ER,SAAgB,eAAe,QAAqD;CACnF,MAAM,OAAO,OAAO,MAAM,MAAM;AAEhC,KAAI,CAAC,KACJ,OAAM,IAAI,MAAM,0CAA0C;AAG3D,QAAO,OAAO,IAAI,iBAAiB,OAAO;;;;;;;;;;;;ACW3C,SAAgB,kBAAkB,OAA0C;AAC3E,QACC,OAAO,UAAU,YACjB,UAAU,QACV,SAAS,SACT,OAAQ,MAA0B,QAAQ;;;;;;;;;AAW5C,SAAgB,qBAAqB,OAA6C;AACjF,QACC,OAAO,UAAU,YACjB,UAAU,QACV,QAAQ,SACR,OAAQ,MAA6B,OAAO,YAC3C,MAA6B,OAAO,QACrC,OAAQ,MAA6B,GAAG,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACRzD,eAAsB,gBACrB,QACA,YACc;AAEd,KAAI,OAAO,GACV,QAAO,OAAO;AAIf,KAAI,OAAO,UACV,QAAO,OAAO,WAAW;AAI1B,KAAI,OAAO,SAAS;AACnB,MAAI,CAAC,WACJ,OAAM,IAAI,MACT,iFACA;EAGF,MAAM,WAAW,WAAW,OAAO,QAAQ;AAE3C,MAAI,CAAC,SACJ,OAAM,IAAI,MACT,0CAA0C,OAAO,OAAO,QAAQ,CAAC,6DAEjE;AAGF,MAAI,kBAAkB,SAAS,EAAE;GAGhC,MAAM,eAAe,OAAO,wBAAwB;GACpD,MAAM,aAAa,SAAS,IAAI,aAAa;AAE7C,OAAI,CAAC,WACJ,OAAM,IAAI,MACT,wCAAwC,OAAO,OAAO,QAAQ,CAAC,mCAAmC,aAAa,2EAE/G;AAGF,OAAI,QAAQ,cAAc,WAAW,GACpC,QAAO,WAAW;;AAIpB,MAAI,qBAAqB,SAAS,CAGjC,QAAO,SAAS;AAIjB,MAAI,OAAO,aAAa,YAAY,aAAa,QAAQ,EAAE,gBAAgB,UAC1E,OAAM,IAAI,MACT,8BAA8B,OAAO,OAAO,QAAQ,CAAC,sDACrD;AAGF,SAAO;;AAIR,OAAM,IAAI,MAAM,sEAAsE;;;;;;;;;;;;;;;;;;;;;;;;;;ACjFhF,yBAAM,aAA0C;CACtD,AAAU;CACV,AAAU;CACV,AAAU;CACV,AAAU;CAEV,AAAU,SAAwB;CAElC,YACC,AAAyB,UACzB,AAAuB,eACvB,AAAgB,QAChB,AAAuB,eACtB;AACD,OAAK,WAAW;AAChB,OAAK,gBAAgB;AACrB,OAAK,SAAS;AACd,OAAK,eAAe,cAAc,IAAsB,SAAS,IAAI,EAAE;;CAGxE,MAAM,UAAyB;EAC9B,MAAM,SAAS,KAAK;AAEpB,MAAI,QAAQ,YAAY,OAAO;AAC9B,QAAK,OAAO,KAAK,iCAAiC;AAElD;;AAGD,yBAAuB,OAAO;AAE9B,MAAI;GACH,MAAM,KAAK,MAAM,gBAAgB,SAAS,UACzC,KAAK,SAAS,IAAI,MAAuB,CACzC;GAGD,MAAM,EAAE,IAAI,KAAK,GAAG,eAAe;AAGnC,QAAK,SAAS,IAAI,OAAO,IAFM,WAEM;AACrC,QAAK,cAAc,WAAW,KAAK,OAAO;AAE1C,QAAK,OAAO,KAAK,mCAAmC;AACpD,SAAM,KAAK,OAAO,YAAY;AAE9B,SAAM,KAAK,iBAAiB;AAE5B,SAAM,KAAK,OAAO,OAAO;AAEzB,QAAK,OAAO,KAAK,+BAA+B;WACxC,OAAO;AACf,QAAK,OAAO,MAAM;IACjB,OAAO;IACP,SAAS;IACT;IACA,CAAC;AAEF,SAAM;;;CAIR,MAAM,aAA4B;AACjC,MAAI,KAAK,QAAQ;AAChB,QAAK,OAAO,KAAK,sBAAsB;AAEvC,SAAM,KAAK,OAAO,MAAM;AAExB,QAAK,OAAO,KAAK,kBAAkB;;;;;;CAOrC,MAAgB,kBAAiC;AAChD,MAAI,CAAC,KAAK,OACT,OAAM,IAAI,MAAM,kCAAkC;EAGnD,MAAM,SAAS,KAAK;EACpB,MAAM,oBAAoB,KAAK,SAAS,aAAa,cAAc,kBAAkB;EACrF,MAAM,iCAAiB,IAAI,KAAa;AAExC,OAAK,OAAO,KAAK,iBAAiB,kBAAkB,OAAO,qBAAqB;AAEhF,OAAK,MAAM,YAAY,mBAAmB;GACzC,MAAM,WAAW,SAAS;GAC1B,MAAM,UAAU,sBAAsB,SAAS;GAE/C,MAAM,WAAW,KAAK,SAAS,IAAI,SAAS,MAAM;AAElD,OAAI,CAAC,YAAY,SAAS,UAAU,cAAc,SAAS;AAC1D,SAAK,OAAO,KACX,qDAAqD,SAAS,KAAK,aACnE;AAED;;AAGD,QAAK,MAAM,UAAU,SAAS;IAC7B,MAAM,EAAE,UAAU,QAAQ,MAAM,QAAQ,gBAAgB;AAExD,QAAI,eAAe,IAAI,SAAS,CAC/B,OAAM,IAAI,MACT,qDAAqD,SAAS,0BAC9D;AAGF,mBAAe,IAAI,SAAS;IAE5B,MAAM,UAAU,OAAO,QAAa;KACnC,MAAM,OAAO,IAAI,UAAU;MAC1B,UAAU,KAAK;MACf,IAAI,IAAI,KAAK,UAAU,IAAI;MAC3B,CAAC;AACF,UAAK,IAAI,cAAc,IAAI;AAC3B,UAAK,UAAU,IAAI,WAAW,KAAK;AAEnC,WAAM,aAAa,MAAM,YAAY;AACpC,UAAI;OACH,IAAI,iBAAiB;AACrB,WAAI,SAAS,UAAU,cAAc,WAAW,CAAC,eAChD,kBAAiB,MAAM,KAAK,SAAS,OAAO,SAAS,OAAO,EAC3D,QAAQ,KAAK,WACb,CAAC;OAGH,MAAM,gBAAgB;AAEtB,WAAI,iBAAiB,OAAO,cAAc,YAAY,WACrD,OAAM,cAAc,QAAQ,IAAI;eAEzB,OAAO;AACf,YAAK,OAAO,MAAM;QACjB,OAAO;QACP,SAAS;QACT,OAAO,IAAI;QACX,SAAS,wBAAwB;QACjC;QACA,CAAC;AACF,aAAM;gBACG;AACT,aAAM,KAAK,SAAS;;OAEpB;;AAGH,QAAI,UAAU,aAAa;AAC1B,UAAK,OAAO,MAAM,iCAAiC,SAAS,KAAK,YAAY,GAAG;AAEhF,YAAO,SAAS,UAAU,SAAS,KAAsB;AACzD,WAAM,OAAO,SAAS,aAAa,UAAU,EAAE,EAAE,KAAwB;WACnE;AACN,UAAK,OAAO,MAAM,+BAA+B,SAAS,GAAG;AAC7D,YAAO,SAAS,UAAU,SAAS,KAAsB;;;;AAK5D,OAAK,OAAO,KAAK,sBAAsB,eAAe,KAAK,OAAO;;;;CAnKnE,OAAO,EACP,SAAS,CAAC,cAAc,EACxB,CAAC;oBAUC,OAAO,gBAAgB;oBACvB,OAAO,cAAc;oBACrB,OAAO,OAAO;oBACd,OAAO,cAAc"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/config/config.ts","../src/constants/constants.ts","../src/constants/types.ts","../src/decorators/cron.ts","../src/decorators/job.ts","../src/decorators/job-controller.ts","../src/services/monque-service.ts","../src/utils/build-job-name.ts","../src/utils/collect-job-metadata.ts","../src/utils/get-job-token.ts","../src/utils/guards.ts","../src/utils/resolve-database.ts","../src/monque-module.ts"],"sourcesContent":["/**\n * @monque/tsed - Configuration\n *\n * Defines the configuration interface and TsED module augmentation.\n */\n\nimport { MonqueError } from '@monque/core';\n\nimport type { MonqueTsedConfig } from './types.js';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// TsED Module Augmentation\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Augment TsED's Configuration interface to include monque settings.\n *\n * This allows type-safe configuration via @Configuration decorator.\n */\ndeclare global {\n\tnamespace TsED {\n\t\tinterface Configuration {\n\t\t\t/**\n\t\t\t * Monque job queue configuration.\n\t\t\t */\n\t\t\tmonque?: MonqueTsedConfig;\n\t\t}\n\t}\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Validation\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Validate that exactly one database resolution strategy is provided.\n *\n * @param config - The configuration to validate.\n * @throws Error if zero or multiple strategies are provided.\n *\n * @example\n * ```typescript\n * validateDatabaseConfig({ db: mongoDb }); // OK\n * validateDatabaseConfig({}); // throws\n * validateDatabaseConfig({ db: mongoDb, dbFactory: fn }); // throws\n * ```\n */\nexport function validateDatabaseConfig(config: MonqueTsedConfig): void {\n\tconst strategies = [config.db, config.dbFactory, config.dbToken].filter(Boolean);\n\n\tif (strategies.length === 0) {\n\t\tthrow new MonqueError(\n\t\t\t\"MonqueTsedConfig requires exactly one of 'db', 'dbFactory', or 'dbToken' to be set\",\n\t\t);\n\t}\n\n\tif (strategies.length > 1) {\n\t\tthrow new MonqueError(\n\t\t\t\"MonqueTsedConfig accepts only one of 'db', 'dbFactory', or 'dbToken' - multiple were provided\",\n\t\t);\n\t}\n}\n","/**\n * Symbol used to store decorator metadata on class constructors.\n *\n * Used by @JobController, @Job, and @Cron decorators to attach\n * metadata that is later collected by MonqueModule during initialization.\n *\n * @example\n * ```typescript\n * Store.from(Class).set(MONQUE, metadata);\n * ```\n */\nexport const MONQUE = Symbol.for('monque');\n","/**\n * Provider type constants for DI scanning.\n *\n * These constants are used to categorize providers registered with Ts.ED's\n * dependency injection container, enabling MonqueModule to discover and\n * register jobs automatically.\n *\n * Note: Using string constants with `as const` instead of enums per\n * Constitution guidelines.\n */\nexport const ProviderTypes = {\n\t/** Provider type for @JobController decorated classes */\n\tJOB_CONTROLLER: 'monque:job-controller',\n\t/** Provider type for cron job handlers */\n\tCRON: 'monque:cron',\n} as const;\n\n/**\n * Union type of all provider type values.\n */\nexport type ProviderType = (typeof ProviderTypes)[keyof typeof ProviderTypes];\n","import { Store } from '@tsed/core';\n\nimport { MONQUE } from '@/constants';\nimport type { CronDecoratorOptions, CronMetadata, JobStore } from '@/decorators/types.js';\n\n/**\n * Method decorator that registers a method as a scheduled cron job.\n *\n * @param pattern - Cron expression (e.g., \"* * * * *\", \"@daily\")\n * @param options - Optional cron configuration (name, timezone, etc.)\n *\n * @example\n * ```typescript\n * @JobController()\n * class ReportJobs {\n *   @Cron(\"@daily\", { timezone: \"UTC\" })\n *   async generateDailyReport() {\n *     // ...\n *   }\n * }\n * ```\n */\nexport function Cron(pattern: string, options?: CronDecoratorOptions): MethodDecorator {\n\treturn <T>(\n\t\ttarget: object,\n\t\tpropertyKey: string | symbol,\n\t\t_descriptor: TypedPropertyDescriptor<T>,\n\t): void => {\n\t\tconst methodName = String(propertyKey);\n\n\t\tconst cronMetadata: CronMetadata = {\n\t\t\tpattern,\n\t\t\t// Default name to method name if not provided\n\t\t\tname: options?.name || methodName,\n\t\t\tmethod: methodName,\n\t\t\topts: options || {},\n\t\t};\n\n\t\t// Get the class constructor (target is the prototype for instance methods)\n\t\tconst targetConstructor = target.constructor;\n\t\tconst store = Store.from(targetConstructor);\n\n\t\t// Get or initialize the MONQUE store\n\t\tconst existing = store.get<Partial<JobStore>>(MONQUE) || {\n\t\t\ttype: 'controller',\n\t\t\tjobs: [],\n\t\t\tcronJobs: [],\n\t\t};\n\n\t\t// Add this cron job to the list\n\t\tconst cronJobs = [...(existing.cronJobs || []), cronMetadata];\n\n\t\tstore.set(MONQUE, {\n\t\t\t...existing,\n\t\t\tcronJobs,\n\t\t});\n\t};\n}\n","/**\n * @Job method decorator\n *\n * Registers a method as a job handler. The method will be called when a job\n * with the matching name is picked up for processing.\n *\n * @param name - Job name (combined with controller namespace if present).\n * @param options - Job configuration options.\n *\n * @example\n * ```typescript\n * @JobController(\"notifications\")\n * export class NotificationJobs {\n *   @Job(\"push\", { concurrency: 10 })\n *   async sendPush(job: Job<PushPayload>) {\n *     await pushService.send(job.data);\n *   }\n * }\n * ```\n */\nimport { Store } from '@tsed/core';\n\nimport { MONQUE } from '@/constants';\n\nimport type { JobDecoratorOptions, JobMetadata, JobStore } from './types.js';\n\n/**\n * Method decorator that registers a method as a job handler.\n *\n * @param name - The job name (will be prefixed with controller namespace if present)\n * @param options - Optional job configuration (concurrency, replace, etc.)\n */\nexport function Job(name: string, options?: JobDecoratorOptions): MethodDecorator {\n\treturn <T>(\n\t\ttarget: object,\n\t\tpropertyKey: string | symbol,\n\t\t_descriptor: TypedPropertyDescriptor<T>,\n\t): void => {\n\t\tconst methodName = String(propertyKey);\n\n\t\tconst jobMetadata: JobMetadata = {\n\t\t\tname,\n\t\t\tmethod: methodName,\n\t\t\topts: options || {},\n\t\t};\n\n\t\t// Get the class constructor (target is the prototype for instance methods)\n\t\tconst targetConstructor = target.constructor;\n\t\tconst store = Store.from(targetConstructor);\n\n\t\t// Get or initialize the MONQUE store\n\t\tconst existing = store.get<Partial<JobStore>>(MONQUE) || {\n\t\t\ttype: 'controller',\n\t\t\tjobs: [],\n\t\t\tcronJobs: [],\n\t\t};\n\n\t\t// Add this job to the list\n\t\tconst jobs = [...(existing.jobs || []), jobMetadata];\n\n\t\tstore.set(MONQUE, {\n\t\t\t...existing,\n\t\t\tjobs,\n\t\t});\n\t};\n}\n","/**\n * @JobController class decorator\n *\n * Marks a class as containing job methods and registers it with the Ts.ED DI container.\n * Jobs in the class will have their job names prefixed with the namespace.\n *\n * @param namespace - Optional prefix for all job names in this controller.\n *                    When set, job names become \"{namespace}.{name}\".\n *\n * @example\n * ```typescript\n * @JobController(\"email\")\n * export class EmailJobs {\n *   @Job(\"send\")  // Registered as \"email.send\"\n *   async send(job: Job<EmailPayload>) { }\n * }\n * ```\n */\nimport { Store, useDecorators } from '@tsed/core';\nimport { Injectable } from '@tsed/di';\n\nimport { MONQUE, ProviderTypes } from '@/constants';\n\nimport type { JobStore } from './types.js';\n\n/**\n * Class decorator that registers a class as a job controller.\n *\n * @param namespace - Optional namespace prefix for job names\n */\nexport function JobController(namespace?: string): ClassDecorator {\n\treturn useDecorators(\n\t\t// Register as injectable with custom provider type\n\t\tInjectable({\n\t\t\ttype: ProviderTypes.JOB_CONTROLLER,\n\t\t}),\n\t\t// Apply custom decorator to store metadata\n\t\t(target: object) => {\n\t\t\tconst store = Store.from(target);\n\n\t\t\t// Get existing store or create new one\n\t\t\tconst existing = store.get<Partial<JobStore>>(MONQUE) || {};\n\n\t\t\t// Merge with new metadata, only include namespace if defined\n\t\t\tconst jobStore: JobStore = {\n\t\t\t\ttype: 'controller',\n\t\t\t\t...(namespace !== undefined && { namespace }),\n\t\t\t\tjobs: existing.jobs || [],\n\t\t\t\tcronJobs: existing.cronJobs || [],\n\t\t\t};\n\n\t\t\tstore.set(MONQUE, jobStore);\n\t\t},\n\t);\n}\n","/**\n * MonqueService - Injectable wrapper for Monque\n *\n * Provides a DI-friendly interface to the Monque job queue.\n * All methods delegate to the underlying Monque instance.\n *\n * @example\n * ```typescript\n * @Service()\n * export class OrderService {\n *   @Inject()\n *   private monque: MonqueService;\n *\n *   async createOrder(data: CreateOrderDto) {\n *     const order = await this.save(data);\n *     await this.monque.enqueue(\"order.process\", { orderId: order.id });\n *     return order;\n *   }\n * }\n * ```\n */\n\nimport type {\n\tBulkOperationResult,\n\tCursorOptions,\n\tCursorPage,\n\tEnqueueOptions,\n\tGetJobsFilter,\n\tJobSelector,\n\tMonque,\n\tPersistedJob,\n\tQueueStats,\n\tScheduleOptions,\n} from '@monque/core';\nimport { MonqueError } from '@monque/core';\nimport { Injectable } from '@tsed/di';\nimport { ObjectId } from 'mongodb';\n\n/**\n * Injectable service that wraps the Monque instance.\n *\n * Exposes the full Monque public API through dependency injection.\n */\n@Injectable()\nexport class MonqueService {\n\t/**\n\t * Internal Monque instance (set by MonqueModule)\n\t * @internal\n\t */\n\tprivate _monque: Monque | null = null;\n\n\t/**\n\t * Set the internal Monque instance.\n\t * Called by MonqueModule during initialization.\n\t * @internal\n\t */\n\t_setMonque(monque: Monque): void {\n\t\tthis._monque = monque;\n\t}\n\n\t/**\n\t * Access the underlying Monque instance.\n\t * @throws Error if MonqueModule is not initialized\n\t */\n\tget monque(): Monque {\n\t\tif (!this._monque) {\n\t\t\tthrow new MonqueError(\n\t\t\t\t'MonqueService is not initialized. Ensure MonqueModule is imported and enabled.',\n\t\t\t);\n\t\t}\n\n\t\treturn this._monque;\n\t}\n\n\t// ─────────────────────────────────────────────────────────────────────────────\n\t// Job Scheduling\n\t// ─────────────────────────────────────────────────────────────────────────────\n\n\t/**\n\t * Enqueue a job for processing.\n\t *\n\t * @param name - Job type identifier (use full namespaced name, e.g., \"email.send\")\n\t * @param data - Job payload\n\t * @param options - Scheduling and deduplication options\n\t * @returns The created or existing job document\n\t */\n\tasync enqueue<T>(name: string, data: T, options?: EnqueueOptions): Promise<PersistedJob<T>> {\n\t\treturn this.monque.enqueue(name, data, options);\n\t}\n\n\t/**\n\t * Enqueue a job for immediate processing.\n\t *\n\t * @param name - Job type identifier\n\t * @param data - Job payload\n\t * @returns The created job document\n\t */\n\tasync now<T>(name: string, data: T): Promise<PersistedJob<T>> {\n\t\treturn this.monque.now(name, data);\n\t}\n\n\t/**\n\t * Schedule a recurring job with a cron expression.\n\t *\n\t * @param cron - Cron expression (5-field standard or predefined like @daily)\n\t * @param name - Job type identifier\n\t * @param data - Job payload\n\t * @param options - Scheduling options\n\t * @returns The created job document\n\t */\n\tasync schedule<T>(\n\t\tcron: string,\n\t\tname: string,\n\t\tdata: T,\n\t\toptions?: ScheduleOptions,\n\t): Promise<PersistedJob<T>> {\n\t\treturn this.monque.schedule(cron, name, data, options);\n\t}\n\n\t// ─────────────────────────────────────────────────────────────────────────────\n\t// Job Management (Single Job Operations)\n\t// ─────────────────────────────────────────────────────────────────────────────\n\n\t/**\n\t * Cancel a pending or scheduled job.\n\t *\n\t * @param jobId - The ID of the job to cancel\n\t * @returns The cancelled job, or null if not found\n\t */\n\tasync cancelJob(jobId: string): Promise<PersistedJob<unknown> | null> {\n\t\treturn this.monque.cancelJob(jobId);\n\t}\n\n\t/**\n\t * Retry a failed or cancelled job.\n\t *\n\t * @param jobId - The ID of the job to retry\n\t * @returns The updated job, or null if not found\n\t */\n\tasync retryJob(jobId: string): Promise<PersistedJob<unknown> | null> {\n\t\treturn this.monque.retryJob(jobId);\n\t}\n\n\t/**\n\t * Reschedule a pending job to run at a different time.\n\t *\n\t * @param jobId - The ID of the job to reschedule\n\t * @param runAt - The new Date when the job should run\n\t * @returns The updated job, or null if not found\n\t */\n\tasync rescheduleJob(jobId: string, runAt: Date): Promise<PersistedJob<unknown> | null> {\n\t\treturn this.monque.rescheduleJob(jobId, runAt);\n\t}\n\n\t/**\n\t * Permanently delete a job.\n\t *\n\t * @param jobId - The ID of the job to delete\n\t * @returns true if deleted, false if job not found\n\t */\n\tasync deleteJob(jobId: string): Promise<boolean> {\n\t\treturn this.monque.deleteJob(jobId);\n\t}\n\n\t// ─────────────────────────────────────────────────────────────────────────────\n\t// Job Management (Bulk Operations)\n\t// ─────────────────────────────────────────────────────────────────────────────\n\n\t/**\n\t * Cancel multiple jobs matching the given filter.\n\t *\n\t * @param filter - Selector for which jobs to cancel\n\t * @returns Result with count of cancelled jobs\n\t */\n\tasync cancelJobs(filter: JobSelector): Promise<BulkOperationResult> {\n\t\treturn this.monque.cancelJobs(filter);\n\t}\n\n\t/**\n\t * Retry multiple jobs matching the given filter.\n\t *\n\t * @param filter - Selector for which jobs to retry\n\t * @returns Result with count of retried jobs\n\t */\n\tasync retryJobs(filter: JobSelector): Promise<BulkOperationResult> {\n\t\treturn this.monque.retryJobs(filter);\n\t}\n\n\t/**\n\t * Delete multiple jobs matching the given filter.\n\t *\n\t * @param filter - Selector for which jobs to delete\n\t * @returns Result with count of deleted jobs\n\t */\n\tasync deleteJobs(filter: JobSelector): Promise<BulkOperationResult> {\n\t\treturn this.monque.deleteJobs(filter);\n\t}\n\n\t// ─────────────────────────────────────────────────────────────────────────────\n\t// Job Queries\n\t// ─────────────────────────────────────────────────────────────────────────────\n\n\t/**\n\t * Get a job by its ID.\n\t *\n\t * @param jobId - The job's ObjectId (as string or ObjectId)\n\t * @returns The job document, or null if not found\n\t * @throws MonqueError if jobId is an invalid hex string\n\t */\n\tasync getJob<T>(jobId: string | ObjectId): Promise<PersistedJob<T> | null> {\n\t\tlet id: ObjectId;\n\n\t\tif (typeof jobId === 'string') {\n\t\t\tif (!ObjectId.isValid(jobId)) {\n\t\t\t\tthrow new MonqueError(`Invalid job ID format: ${jobId}`);\n\t\t\t}\n\t\t\tid = ObjectId.createFromHexString(jobId);\n\t\t} else {\n\t\t\tid = jobId;\n\t\t}\n\n\t\treturn this.monque.getJob(id);\n\t}\n\n\t/**\n\t * Query jobs from the queue with optional filters.\n\t *\n\t * @param filter - Optional filter criteria (name, status, limit, skip)\n\t * @returns Array of matching jobs\n\t */\n\tasync getJobs<T>(filter?: GetJobsFilter): Promise<PersistedJob<T>[]> {\n\t\treturn this.monque.getJobs(filter);\n\t}\n\n\t/**\n\t * Get a paginated list of jobs using opaque cursors.\n\t *\n\t * @param options - Pagination options (cursor, limit, direction, filter)\n\t * @returns Page of jobs with next/prev cursors\n\t */\n\tasync getJobsWithCursor<T>(options?: CursorOptions): Promise<CursorPage<T>> {\n\t\treturn this.monque.getJobsWithCursor(options);\n\t}\n\n\t/**\n\t * Get aggregate statistics for the job queue.\n\t *\n\t * @param filter - Optional filter to scope statistics by job name\n\t * @returns Queue statistics\n\t */\n\tasync getQueueStats(filter?: Pick<JobSelector, 'name'>): Promise<QueueStats> {\n\t\treturn this.monque.getQueueStats(filter);\n\t}\n\n\t// ─────────────────────────────────────────────────────────────────────────────\n\t// Health Check\n\t// ─────────────────────────────────────────────────────────────────────────────\n\n\t/**\n\t * Check if the scheduler is healthy and running.\n\t *\n\t * @returns true if running and connected\n\t */\n\tisHealthy(): boolean {\n\t\treturn this.monque.isHealthy();\n\t}\n}\n","/**\n * Build the full job name by combining namespace and name.\n *\n * @param namespace - Optional namespace from @JobController\n * @param name - Job name from @Job or @Cron\n * @returns Full job name (e.g., \"email.send\" or just \"send\")\n *\n * @example\n * ```typescript\n * buildJobName(\"email\", \"send\"); // \"email.send\"\n * buildJobName(undefined, \"send\"); // \"send\"\n * buildJobName(\"\", \"send\"); // \"send\"\n * ```\n */\nexport function buildJobName(namespace: string | undefined, name: string): string {\n\treturn namespace ? `${namespace}.${name}` : name;\n}\n","/**\n * Collect job metadata utility\n *\n * Collects all job metadata from a class decorated with @JobController.\n * Used by MonqueModule to discover and register all jobs.\n */\nimport { Store } from '@tsed/core';\n\nimport { MONQUE } from '@/constants';\nimport type { CronDecoratorOptions, JobDecoratorOptions, JobStore } from '@/decorators';\n\nimport { buildJobName } from './build-job-name.js';\n\n/**\n * Collected job registration info ready for Monque.register()\n */\nexport interface CollectedJobMetadata {\n\t/**\n\t * Full job name (with namespace prefix if applicable)\n\t */\n\tfullName: string;\n\n\t/**\n\t * Method name on the controller class\n\t */\n\tmethod: string;\n\n\t/**\n\t * Job options to pass to Monque.register()\n\t */\n\topts: JobDecoratorOptions | CronDecoratorOptions;\n\n\t/**\n\t * Whether this is a cron job\n\t */\n\tisCron: boolean;\n\n\t/**\n\t * Cron pattern (only for cron jobs)\n\t */\n\tcronPattern?: string;\n}\n\n/**\n * Collect all job metadata from a class.\n *\n * @param target - The class constructor (decorated with @JobController)\n * @returns Array of collected job metadata ready for registration\n *\n * @example\n * ```typescript\n * const metadata = collectJobMetadata(EmailJobs);\n * // Returns:\n * // [\n * //   { fullName: \"email.send\", method: \"sendEmail\", opts: {}, isCron: false },\n * //   { fullName: \"email.daily-digest\", method: \"sendDailyDigest\", opts: {}, isCron: true, cronPattern: \"0 9 * * *\" }\n * // ]\n * ```\n */\nexport function collectJobMetadata(\n\ttarget: new (...args: unknown[]) => unknown,\n): CollectedJobMetadata[] {\n\tconst store = Store.from(target);\n\tconst jobStore = store.get<JobStore>(MONQUE);\n\n\tif (!jobStore) {\n\t\treturn [];\n\t}\n\n\tconst results: CollectedJobMetadata[] = [];\n\tconst namespace = jobStore.namespace;\n\n\t// Collect regular jobs\n\tfor (const job of jobStore.jobs) {\n\t\tresults.push({\n\t\t\tfullName: buildJobName(namespace, job.name),\n\t\t\tmethod: job.method,\n\t\t\topts: job.opts,\n\t\t\tisCron: false,\n\t\t});\n\t}\n\n\t// Collect cron jobs\n\tfor (const cron of jobStore.cronJobs) {\n\t\tresults.push({\n\t\t\tfullName: buildJobName(namespace, cron.name),\n\t\t\tmethod: cron.method,\n\t\t\topts: cron.opts,\n\t\t\tisCron: true,\n\t\t\tcronPattern: cron.pattern,\n\t\t});\n\t}\n\n\treturn results;\n}\n","/**\n * Generate a unique token for a job controller.\n *\n * Used internally by Ts.ED DI to identify job controller providers.\n * The token is based on the class name for debugging purposes.\n *\n * @param target - The class constructor\n * @returns A Symbol token unique to this job controller\n *\n * @example\n * ```typescript\n * @JobController(\"email\")\n * class EmailJobs {}\n *\n * const token = getJobToken(EmailJobs);\n * // Symbol(\"monque:job:EmailJobs\")\n * ```\n */\nimport { MonqueError } from '@monque/core';\n\nexport function getJobToken(target: new (...args: unknown[]) => unknown): symbol {\n\tconst name = target.name?.trim();\n\n\tif (!name) {\n\t\tthrow new MonqueError('Job class must have a non-empty name');\n\t}\n\n\treturn Symbol.for(`monque:job:${name}`);\n}\n","/**\n * @monque/tsed - Type Guards\n *\n * Utilities for duck-typing Mongoose and MongoDB related objects\n * to avoid hard dependencies on @tsed/mongoose.\n */\n\nimport type { Db } from 'mongodb';\n\n/**\n * Interface representing a Mongoose Connection object.\n * We only care that it has a `db` property which is a MongoDB Db instance.\n */\nexport interface MongooseConnection {\n\tdb: Db;\n}\n\n/**\n * Interface representing the @tsed/mongoose MongooseService.\n * It acts as a registry/factory for connections.\n */\nexport interface MongooseService {\n\t/**\n\t * Get a connection by its ID (configuration key).\n\t * @param id The connection ID (default: \"default\")\n\t */\n\tget(id?: string): MongooseConnection | undefined;\n}\n\n/**\n * Type guard to check if an object acts like a Mongoose Service.\n *\n * Checks if the object has a `get` method.\n *\n * @param value The value to check\n */\nexport function isMongooseService(value: unknown): value is MongooseService {\n\treturn (\n\t\ttypeof value === 'object' &&\n\t\tvalue !== null &&\n\t\t'get' in value &&\n\t\ttypeof (value as MongooseService).get === 'function'\n\t);\n}\n\n/**\n * Type guard to check if an object acts like a Mongoose Connection.\n *\n * Checks if the object has a `db` property.\n *\n * @param value The value to check\n */\nexport function isMongooseConnection(value: unknown): value is MongooseConnection {\n\treturn (\n\t\ttypeof value === 'object' &&\n\t\tvalue !== null &&\n\t\t'db' in value &&\n\t\ttypeof (value as MongooseConnection).db === 'object' &&\n\t\t(value as MongooseConnection).db !== null &&\n\t\ttypeof (value as MongooseConnection).db.collection === 'function'\n\t);\n}\n","/**\n * @monque/tsed - Database Resolution Utility\n *\n * Multi-strategy database resolution for flexible MongoDB connection handling.\n */\n\nimport { ConnectionError } from '@monque/core';\nimport type { TokenProvider } from '@tsed/di';\nimport type { Db } from 'mongodb';\n\nimport type { MonqueTsedConfig } from '@/config';\n\nimport { isMongooseConnection, isMongooseService } from './guards.js';\n\n/**\n * Type for the injector function used to resolve DI tokens.\n */\nexport type InjectorFn = <T>(token: TokenProvider<T>) => T | undefined;\n\n/**\n * Resolve the MongoDB database instance from the configuration.\n *\n * Supports three resolution strategies:\n * 1. **Direct `db`**: Returns the provided Db instance directly\n * 2. **Factory `dbFactory`**: Calls the factory function (supports async)\n * 3. **DI Token `dbToken`**: Resolves the Db from the DI container\n *\n * @param config - The Monque configuration containing database settings\n * @param injectorFn - Optional function to resolve DI tokens (required for dbToken strategy)\n * @returns The resolved MongoDB Db instance\n * @throws Error if no database strategy is provided or if DI resolution fails\n *\n * @example\n * ```typescript\n * // Direct Db instance\n * const db = await resolveDatabase({ db: mongoDb });\n *\n * // Factory function\n * const db = await resolveDatabase({\n *   dbFactory: async () => {\n *     const client = await MongoClient.connect(uri);\n *     return client.db(\"myapp\");\n *   }\n * });\n *\n * // DI token\n * const db = await resolveDatabase(\n *   { dbToken: \"MONGODB_DATABASE\" },\n *   (token) => injector.get(token)\n * );\n * ```\n */\nexport async function resolveDatabase(\n\tconfig: MonqueTsedConfig,\n\tinjectorFn?: InjectorFn,\n): Promise<Db> {\n\t// Strategy 1: Direct Db instance\n\tif (config.db) {\n\t\treturn config.db;\n\t}\n\n\t// Strategy 2: Factory function (sync or async)\n\tif (config.dbFactory) {\n\t\treturn config.dbFactory();\n\t}\n\n\t// Strategy 3: DI token resolution\n\tif (config.dbToken) {\n\t\tif (!injectorFn) {\n\t\t\tthrow new ConnectionError(\n\t\t\t\t'MonqueTsedConfig.dbToken requires an injector function to resolve the database',\n\t\t\t);\n\t\t}\n\n\t\tconst resolved = injectorFn(config.dbToken);\n\n\t\tif (!resolved) {\n\t\t\tthrow new ConnectionError(\n\t\t\t\t`Could not resolve database from token: ${String(config.dbToken)}. ` +\n\t\t\t\t\t'Make sure the provider is registered in the DI container.',\n\t\t\t);\n\t\t}\n\n\t\tif (isMongooseService(resolved)) {\n\t\t\t// Check for Mongoose Service (duck typing)\n\t\t\t// It has a get() method that returns a connection\n\t\t\tconst connectionId = config.mongooseConnectionId || 'default';\n\t\t\tconst connection = resolved.get(connectionId);\n\n\t\t\tif (!connection) {\n\t\t\t\tthrow new ConnectionError(\n\t\t\t\t\t`MongooseService resolved from token \"${String(config.dbToken)}\" returned no connection for ID \"${connectionId}\". ` +\n\t\t\t\t\t\t'Ensure the connection ID is correct and the connection is established.',\n\t\t\t\t);\n\t\t\t}\n\n\t\t\tif ('db' in connection && connection.db) {\n\t\t\t\treturn connection.db as Db;\n\t\t\t}\n\t\t}\n\n\t\tif (isMongooseConnection(resolved)) {\n\t\t\t// Check for Mongoose Connection (duck typing)\n\t\t\t// It has a db property that is the native Db instance\n\t\t\treturn resolved.db as Db;\n\t\t}\n\n\t\t// Default: Assume it is a native Db instance\n\t\tif (typeof resolved !== 'object' || resolved === null || !('collection' in resolved)) {\n\t\t\tthrow new ConnectionError(\n\t\t\t\t`Resolved value from token \"${String(config.dbToken)}\" does not appear to be a valid MongoDB Db instance.`,\n\t\t\t);\n\t\t}\n\n\t\treturn resolved as Db;\n\t}\n\n\t// No strategy provided\n\tthrow new ConnectionError(\"MonqueTsedConfig requires 'db', 'dbFactory', or 'dbToken' to be set\");\n}\n","/**\n * MonqueModule - Main Integration Module\n *\n * Orchestrates the integration between Monque and Ts.ED.\n * Handles lifecycle hooks, configuration resolution, and job registration.\n */\n\nimport {\n\ttype Job,\n\tMonque,\n\tMonqueError,\n\ttype MonqueOptions,\n\ttype ScheduleOptions,\n\ttype WorkerOptions,\n\tWorkerRegistrationError,\n} from '@monque/core';\nimport {\n\tConfiguration,\n\tDIContext,\n\tInject,\n\tInjectorService,\n\tLOGGER,\n\tModule,\n\ttype OnDestroy,\n\ttype OnInit,\n\tProviderScope,\n\trunInContext,\n\ttype TokenProvider,\n} from '@tsed/di';\n\nimport { type MonqueTsedConfig, validateDatabaseConfig } from '@/config';\nimport { ProviderTypes } from '@/constants';\nimport { MonqueService } from '@/services';\nimport { collectJobMetadata, resolveDatabase } from '@/utils';\n\n@Module({\n\timports: [MonqueService],\n})\nexport class MonqueModule implements OnInit, OnDestroy {\n\tprotected injector: InjectorService;\n\tprotected monqueService: MonqueService;\n\tprotected logger: LOGGER;\n\tprotected monqueConfig: MonqueTsedConfig;\n\n\tprotected monque: Monque | null = null;\n\n\tconstructor(\n\t\t@Inject(InjectorService) injector: InjectorService,\n\t\t@Inject(MonqueService) monqueService: MonqueService,\n\t\t@Inject(LOGGER) logger: LOGGER,\n\t\t@Inject(Configuration) configuration: Configuration,\n\t) {\n\t\tthis.injector = injector;\n\t\tthis.monqueService = monqueService;\n\t\tthis.logger = logger;\n\t\tthis.monqueConfig = configuration.get<MonqueTsedConfig>('monque') || {};\n\t}\n\n\tasync $onInit(): Promise<void> {\n\t\tconst config = this.monqueConfig;\n\n\t\tif (config?.enabled === false) {\n\t\t\tthis.logger.info('Monque integration is disabled');\n\n\t\t\treturn;\n\t\t}\n\n\t\tvalidateDatabaseConfig(config);\n\n\t\ttry {\n\t\t\tconst db = await resolveDatabase(config, (token) =>\n\t\t\t\tthis.injector.get(token as TokenProvider),\n\t\t\t);\n\n\t\t\t// We construct the options object carefully to match MonqueOptions\n\t\t\tconst { db: _db, ...restConfig } = config;\n\t\t\tconst options: MonqueOptions = restConfig;\n\n\t\t\tthis.monque = new Monque(db, options);\n\t\t\tthis.monqueService._setMonque(this.monque);\n\n\t\t\tthis.logger.info('Monque: Connecting to MongoDB...');\n\t\t\tawait this.monque.initialize();\n\n\t\t\tif (config.disableJobProcessing) {\n\t\t\t\tthis.logger.info('Monque: Job processing is disabled for this instance');\n\t\t\t} else {\n\t\t\t\tawait this.registerJobs();\n\t\t\t\tawait this.monque.start();\n\t\t\t\tthis.logger.info('Monque: Started successfully');\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tthis.logger.error({\n\t\t\t\tevent: 'MONQUE_INIT_ERROR',\n\t\t\t\tmessage: 'Failed to initialize Monque',\n\t\t\t\terror,\n\t\t\t});\n\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\tasync $onDestroy(): Promise<void> {\n\t\tif (this.monque) {\n\t\t\tthis.logger.info('Monque: Stopping...');\n\n\t\t\tawait this.monque.stop();\n\n\t\t\tthis.logger.info('Monque: Stopped');\n\t\t}\n\t}\n\n\t/**\n\t * Discover and register all jobs from @JobController providers\n\t */\n\tprotected async registerJobs(): Promise<void> {\n\t\tif (!this.monque) {\n\t\t\tthrow new MonqueError('Monque instance not initialized');\n\t\t}\n\n\t\tconst monque = this.monque;\n\t\tconst jobControllers = this.injector.getProviders(ProviderTypes.JOB_CONTROLLER);\n\t\tconst registeredJobs = new Set<string>();\n\n\t\tthis.logger.info(`Monque: Found ${jobControllers.length} job controllers`);\n\n\t\tfor (const provider of jobControllers) {\n\t\t\tconst useClass = provider.useClass;\n\t\t\tconst jobs = collectJobMetadata(useClass);\n\t\t\t// Try to resolve singleton instance immediately\n\t\t\tconst instance = this.injector.get(provider.token);\n\n\t\t\tif (!instance && provider.scope !== ProviderScope.REQUEST) {\n\t\t\t\tthis.logger.warn(\n\t\t\t\t\t`Monque: Could not resolve instance for controller ${provider.name}. Skipping.`,\n\t\t\t\t);\n\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tfor (const job of jobs) {\n\t\t\t\tconst { fullName, method, opts, isCron, cronPattern } = job;\n\n\t\t\t\tif (registeredJobs.has(fullName)) {\n\t\t\t\t\tthrow new WorkerRegistrationError(\n\t\t\t\t\t\t`Monque: Duplicate job registration detected. Job \"${fullName}\" is already registered.`,\n\t\t\t\t\t\tfullName,\n\t\t\t\t\t);\n\t\t\t\t}\n\n\t\t\t\tregisteredJobs.add(fullName);\n\n\t\t\t\tconst handler = async (job: Job) => {\n\t\t\t\t\tconst $ctx = new DIContext({\n\t\t\t\t\t\tinjector: this.injector,\n\t\t\t\t\t\tid: job._id?.toString() || 'unknown',\n\t\t\t\t\t});\n\t\t\t\t\t$ctx.set('MONQUE_JOB', job);\n\t\t\t\t\t$ctx.container.set(DIContext, $ctx);\n\n\t\t\t\t\tawait runInContext($ctx, async () => {\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\tlet targetInstance = instance;\n\t\t\t\t\t\t\tif (provider.scope === ProviderScope.REQUEST || !targetInstance) {\n\t\t\t\t\t\t\t\ttargetInstance = await this.injector.invoke(provider.token, {\n\t\t\t\t\t\t\t\t\tlocals: $ctx.container,\n\t\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\tconst typedInstance = targetInstance as Record<string, (job: Job) => unknown>;\n\n\t\t\t\t\t\t\tif (typedInstance && typeof typedInstance[method] === 'function') {\n\t\t\t\t\t\t\t\tawait typedInstance[method](job);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\t\tthis.logger.error({\n\t\t\t\t\t\t\t\tevent: 'MONQUE_JOB_ERROR',\n\t\t\t\t\t\t\t\tjobName: fullName,\n\t\t\t\t\t\t\t\tjobId: job._id,\n\t\t\t\t\t\t\t\tmessage: `Error processing job ${fullName}`,\n\t\t\t\t\t\t\t\terror,\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\tthrow error;\n\t\t\t\t\t\t} finally {\n\t\t\t\t\t\t\tawait $ctx.destroy();\n\t\t\t\t\t\t}\n\t\t\t\t\t});\n\t\t\t\t};\n\n\t\t\t\tif (isCron && cronPattern) {\n\t\t\t\t\tthis.logger.debug(`Monque: Registering cron job \"${fullName}\" (${cronPattern})`);\n\n\t\t\t\t\tmonque.register(fullName, handler, opts as WorkerOptions);\n\t\t\t\t\tawait monque.schedule(cronPattern, fullName, {}, opts as ScheduleOptions);\n\t\t\t\t} else {\n\t\t\t\t\tthis.logger.debug(`Monque: Registering job \"${fullName}\"`);\n\t\t\t\t\tmonque.register(fullName, handler, opts as WorkerOptions);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tthis.logger.info(`Monque: Registered ${registeredJobs.size} jobs`);\n\t}\n}\n"],"mappings":"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"}