@monque/tsed 0.1.0

package/dist/index.mjs.map

@@ -0,0 +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":"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"}

package/package.json

@@ -0,0 +1,98 @@
+{
+	"name": "@monque/tsed",
+	"version": "0.1.0",
+	"description": "Ts.ED integration for Monque - A robust, type-safe MongoDB job queue for TypeScript",
+	"author": "Maurice de Bruyn <debruyn.maurice@gmail.com>",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/ueberBrot/monque.git",
+		"directory": "packages/tsed"
+	},
+	"license": "ISC",
+	"bugs": {
+		"url": "https://github.com/ueberBrot/monque/issues"
+	},
+	"homepage": "https://github.com/ueberBrot/monque#readme",
+	"sideEffects": false,
+	"type": "module",
+	"engines": {
+		"node": ">=22.0.0"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"keywords": [
+		"tsed",
+		"tsed-module",
+		"monque",
+		"mongodb",
+		"queue",
+		"job-queue",
+		"worker",
+		"background-jobs",
+		"cron",
+		"scheduler",
+		"typescript"
+	],
+	"main": "./dist/index.cjs",
+	"module": "./dist/index.mjs",
+	"types": "./dist/index.d.mts",
+	"exports": {
+		".": {
+			"import": {
+				"types": "./dist/index.d.mts",
+				"default": "./dist/index.mjs"
+			},
+			"require": {
+				"types": "./dist/index.d.cts",
+				"default": "./dist/index.cjs"
+			}
+		}
+	},
+	"files": [
+		"dist",
+		"src"
+	],
+	"scripts": {
+		"build": "tsdown",
+		"check:exports": "publint && attw --pack .",
+		"clean": "rimraf dist coverage .turbo",
+		"type-check": "tsc --noEmit",
+		"pretest": "bun run type-check",
+		"test": "vitest run",
+		"test:unit": "bun run type-check && vitest run --config vitest.unit.config.ts --coverage.enabled=false",
+		"test:integration": "bun run type-check && vitest run tests/integration --coverage.enabled=false",
+		"test:watch": "vitest",
+		"test:watch:unit": "vitest --config vitest.unit.config.ts",
+		"test:watch:integration": "vitest tests/integration",
+		"lint": "biome check ."
+	},
+	"peerDependencies": {
+		"@monque/core": "^1.1.2",
+		"@tsed/core": "^8.24.1",
+		"@tsed/di": "^8.24.1",
+		"@tsed/mongoose": "^8.24.1",
+		"mongodb": "^7.0.0"
+	},
+	"peerDependenciesMeta": {
+		"@tsed/mongoose": {
+			"optional": true
+		}
+	},
+	"devDependencies": {
+		"@monque/core": "workspace:*",
+		"@testcontainers/mongodb": "^11.11.0",
+		"@total-typescript/ts-reset": "^0.6.1",
+		"@tsed/core": "^8.24.1",
+		"@tsed/di": "^8.24.1",
+		"@tsed/mongoose": "^8.24.1",
+		"@tsed/platform-http": "^8.24.1",
+		"@tsed/testcontainers-mongo": "^8.24.1",
+		"@types/bun": "^1.3.7",
+		"@vitest/coverage-v8": "^4.0.18",
+		"mongodb": "^7.0.0",
+		"testcontainers": "^11.11.0",
+		"tsdown": "^0.20.1",
+		"vitest": "^4.0.18"
+	}
+}

package/src/config/config.ts

@@ -0,0 +1,60 @@
+/**
+ * @monque/tsed - Configuration
+ *
+ * Defines the configuration interface and TsED module augmentation.
+ */
+
+import type { MonqueTsedConfig } from './types.js';
+
+// ─────────────────────────────────────────────────────────────────────────────
+// TsED Module Augmentation
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Augment TsED's Configuration interface to include monque settings.
+ *
+ * This allows type-safe configuration via @Configuration decorator.
+ */
+declare global {
+	namespace TsED {
+		interface Configuration {
+			/**
+			 * Monque job queue configuration.
+			 */
+			monque?: MonqueTsedConfig;
+		}
+	}
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Validation
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Validate that exactly one database resolution strategy is provided.
+ *
+ * @param config - The configuration to validate.
+ * @throws Error if zero or multiple strategies are provided.
+ *
+ * @example
+ * ```typescript
+ * validateDatabaseConfig({ db: mongoDb }); // OK
+ * validateDatabaseConfig({}); // throws
+ * validateDatabaseConfig({ db: mongoDb, dbFactory: fn }); // throws
+ * ```
+ */
+export function validateDatabaseConfig(config: MonqueTsedConfig): void {
+	const strategies = [config.db, 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",
+		);
+	}
+}

package/src/config/index.ts

@@ -0,0 +1,2 @@
+export { validateDatabaseConfig } from './config.js';
+export type { MonqueTsedConfig } from './types.js';

package/src/config/types.ts

@@ -0,0 +1,114 @@
+/**
+ * @monque/tsed - Configuration Types
+ */
+
+import type { MonqueOptions } from '@monque/core';
+import type { TokenProvider } from '@tsed/di';
+import type { Db } from 'mongodb';
+
+/**
+ * Configuration options for @monque/tsed.
+ *
+ * Extends MonqueOptions with Ts.ED-specific settings for database resolution
+ * and module behavior.
+ *
+ * @example
+ * ```typescript
+ * @Configuration({
+ *   monque: {
+ *     db: mongoClient.db("myapp"),
+ *     collectionName: "jobs",
+ *     defaultConcurrency: 5
+ *   }
+ * })
+ * export class Server {}
+ * ```
+ */
+export interface MonqueTsedConfig extends Omit<MonqueOptions, 'db'> {
+	/**
+	 * Enable or disable the Monque module.
+	 *
+	 * When disabled:
+	 * - Workers are not registered
+	 * - Lifecycle hooks are no-ops
+	 * - MonqueService throws on access
+	 *
+	 * @default true
+	 */
+	enabled?: boolean;
+
+	/**
+	 * Direct MongoDB database instance.
+	 *
+	 * Use when you have a pre-connected Db object available synchronously.
+	 *
+	 * @example
+	 * ```typescript
+	 * @Configuration({
+	 *   monque: {
+	 *     db: mongoClient.db("myapp"),
+	 *     collectionName: "jobs"
+	 *   }
+	 * })
+	 * ```
+	 */
+	db?: Db;
+
+	/**
+	 * Factory function to create the database connection.
+	 *
+	 * Called once during module initialization. Supports async factories
+	 * for connection pooling or lazy initialization.
+	 *
+	 * @example
+	 * ```typescript
+	 * @Configuration({
+	 *   monque: {
+	 *     dbFactory: async () => {
+	 *       const client = await MongoClient.connect(process.env.MONGO_URI!);
+	 *       return client.db("myapp");
+	 *     }
+	 *   }
+	 * })
+	 * ```
+	 */
+	dbFactory?: () => Promise<Db> | Db;
+
+	/**
+	 * DI token to inject the Db instance from the container.
+	 *
+	 * Use when your application already has a MongoDB provider registered
+	 * in the DI container.
+	 *
+	 * Can also be used to inject a MongooseService or Connection.
+	 *
+	 * @example
+	 * ```typescript
+	 * // First, register a MongoDB provider
+	 * registerProvider({
+	 *   provide: "MONGODB_DATABASE",
+	 *   useFactory: async () => {
+	 *     const client = await MongoClient.connect(uri);
+	 *     return client.db("myapp");
+	 *   }
+	 * });
+	 *
+	 * // Then reference it in config
+	 * @Configuration({
+	 *   monque: {
+	 *     dbToken: "MONGODB_DATABASE"
+	 *   }
+	 * })
+	 * ```
+	 */
+	dbToken?: TokenProvider<Db> | string;
+
+	/**
+	 * Connection ID of the Mongoose connection to use.
+	 *
+	 * Requires the use of `dbToken` pointing to `MongooseService`.
+	 *
+	 * @default "default"
+	 */
+	mongooseConnectionId?: string;
+}

package/src/constants/constants.ts

@@ -0,0 +1,12 @@
+/**
+ * Symbol used to store decorator metadata on class constructors.
+ *
+ * Used by @WorkerController, @Worker, and @Cron decorators to attach
+ * metadata that is later collected by MonqueModule during initialization.
+ *
+ * @example
+ * ```typescript
+ * Store.from(Class).set(MONQUE, metadata);
+ * ```
+ */
+export const MONQUE = Symbol.for('monque');

package/src/constants/index.ts

@@ -0,0 +1,2 @@
+export { MONQUE } from './constants.js';
+export { type ProviderType, ProviderTypes } from './types.js';

package/src/constants/types.ts

@@ -0,0 +1,21 @@
+/**
+ * Provider type constants for DI scanning.
+ *
+ * These constants are used to categorize providers registered with Ts.ED's
+ * dependency injection container, enabling MonqueModule to discover and
+ * register workers automatically.
+ *
+ * Note: Using string constants with `as const` instead of enums per
+ * Constitution guidelines.
+ */
+export const ProviderTypes = {
+	/** Provider type for @WorkerController decorated classes */
+	WORKER_CONTROLLER: 'monque:worker-controller',
+	/** Provider type for cron job handlers */
+	CRON: 'monque:cron',
+} as const;
+
+/**
+ * Union type of all provider type values.
+ */
+export type ProviderType = (typeof ProviderTypes)[keyof typeof ProviderTypes];

package/src/decorators/cron.ts

@@ -0,0 +1,58 @@
+import { Store } from '@tsed/core';
+
+import { MONQUE } from '@/constants';
+import type { CronDecoratorOptions, CronMetadata, WorkerStore } from '@/decorators/types.js';
+
+/**
+ * Method decorator that registers a method as a scheduled cron job.
+ *
+ * @param pattern - Cron expression (e.g., "* * * * *", "@daily")
+ * @param options - Optional cron configuration (name, timezone, etc.)
+ *
+ * @example
+ * ```typescript
+ * @WorkerController()
+ * class ReportWorkers {
+ *   @Cron("@daily", { timezone: "UTC" })
+ *   async generateDailyReport() {
+ *     // ...
+ *   }
+ * }
+ * ```
+ */
+export function Cron(pattern: string, options?: CronDecoratorOptions): MethodDecorator {
+	return <T>(
+		target: object,
+		propertyKey: string | symbol,
+		_descriptor: TypedPropertyDescriptor<T>,
+	): void => {
+		const methodName = String(propertyKey);
+
+		const cronMetadata: CronMetadata = {
+			pattern,
+			// Default name to method name if not provided
+			name: options?.name || methodName,
+			method: methodName,
+			opts: options || {},
+		};
+
+		// Get the class constructor (target is the prototype for instance methods)
+		const targetConstructor = target.constructor;
+		const store = Store.from(targetConstructor);
+
+		// Get or initialize the MONQUE store
+		const existing = store.get<Partial<WorkerStore>>(MONQUE) || {
+			type: 'controller',
+			workers: [],
+			cronJobs: [],
+		};
+
+		// Add this cron job to the list
+		const cronJobs = [...(existing.cronJobs || []), cronMetadata];
+
+		store.set(MONQUE, {
+			...existing,
+			cronJobs,
+		});
+	};
+}

package/src/decorators/index.ts

@@ -0,0 +1,10 @@
+export { Cron } from './cron.js';
+export type {
+	CronDecoratorOptions,
+	CronMetadata,
+	WorkerDecoratorOptions,
+	WorkerMetadata,
+	WorkerStore,
+} from './types.js';
+export { Worker } from './worker.js';
+export { WorkerController } from './worker-controller.js';

package/src/decorators/types.ts

@@ -0,0 +1,131 @@
+/**
+ * @monque/tsed - Decorator Types
+ */
+
+import type { WorkerOptions as CoreWorkerOptions, ScheduleOptions } from '@monque/core';
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Worker Decorator Options
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Options for the @Worker method decorator.
+ *
+ * Maps to @monque/core WorkerOptions. All standard Monque worker options
+ * are exposed here for decorator-based configuration.
+ */
+export interface WorkerDecoratorOptions extends CoreWorkerOptions {}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Worker Metadata
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Metadata for a single @Worker decorated method.
+ *
+ * Stored in the WorkerStore and used by MonqueModule to register workers.
+ */
+export interface WorkerMetadata {
+	/**
+	 * Job name (without namespace prefix).
+	 * Combined with controller namespace to form full job name.
+	 */
+	name: string;
+
+	/**
+	 * Method name on the controller class.
+	 */
+	method: string;
+
+	/**
+	 * Worker options forwarded to Monque.register().
+	 */
+	opts: WorkerDecoratorOptions;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Cron Decorator Options
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Options for the @Cron method decorator.
+ *
+ * Maps to @monque/core ScheduleOptions with additional metadata overrides.
+ */
+export interface CronDecoratorOptions extends ScheduleOptions {
+	/**
+	 * Override job name (defaults to method name).
+	 */
+	name?: string;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Cron Metadata
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Metadata for a single @Cron decorated method.
+ *
+ * Stored in the WorkerStore and used by MonqueModule to schedule cron jobs.
+ */
+export interface CronMetadata {
+	/**
+	 * Cron expression (5-field standard or predefined like @daily).
+	 */
+	pattern: string;
+
+	/**
+	 * Job name (defaults to method name if not specified in options).
+	 */
+	name: string;
+
+	/**
+	 * Method name on the controller class.
+	 */
+	method: string;
+
+	/**
+	 * Schedule options forwarded to Monque.schedule().
+	 */
+	opts: CronDecoratorOptions;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Worker Store
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Complete metadata structure stored on @WorkerController classes.
+ *
+ * Accessed via `Store.from(Class).get(MONQUE)`.
+ *
+ * @example
+ * ```typescript
+ * const store = Store.from(EmailWorkers).get<WorkerStore>(MONQUE);
+ * console.log(store.namespace); // "email"
+ * console.log(store.workers); // [{ name: "send", method: "sendEmail", opts: {} }]
+ * ```
+ */
+export interface WorkerStore {
+	/**
+	 * Type identifier for the store.
+	 * Always "controller" for WorkerController.
+	 */
+	type: 'controller';
+
+	/**
+	 * Optional namespace prefix for all jobs in this controller.
+	 * When set, job names become "{namespace}.{name}".
+	 */
+	namespace?: string;
+
+	/**
+	 * Worker method registrations from @Worker decorators.
+	 */
+	workers: WorkerMetadata[];
+
+	/**
+	 * Cron job registrations from @Cron decorators.
+	 */
+	cronJobs: CronMetadata[];
+}

package/src/decorators/worker-controller.ts

@@ -0,0 +1,55 @@
+/**
+ * @WorkerController 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.
+ *
+ * @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"
+ *   async send(job: Job<EmailPayload>) { }
+ * }
+ * ```
+ */
+import { Store, useDecorators } from '@tsed/core';
+import { Injectable } from '@tsed/di';
+
+import { MONQUE, ProviderTypes } from '@/constants';
+
+import type { WorkerStore } from './types.js';
+
+/**
+ * Class decorator that registers a class as a worker controller.
+ *
+ * @param namespace - Optional namespace prefix for job names
+ */
+export function WorkerController(namespace?: string): ClassDecorator {
+	return useDecorators(
+		// Register as injectable with custom provider type
+		Injectable({
+			type: ProviderTypes.WORKER_CONTROLLER,
+		}),
+		// Apply custom decorator to store metadata
+		(target: object) => {
+			const store = Store.from(target);
+
+			// Get existing store or create new one
+			const existing = store.get<Partial<WorkerStore>>(MONQUE) || {};
+
+			// Merge with new metadata, only include namespace if defined
+			const workerStore: WorkerStore = {
+				type: 'controller',
+				...(namespace !== undefined && { namespace }),
+				workers: existing.workers || [],
+				cronJobs: existing.cronJobs || [],
+			};
+
+			store.set(MONQUE, workerStore);
+		},
+	);
+}