@modern-admin/queue 0.1.0

package/dist/cron/cron-task.decorator.d.ts

@@ -0,0 +1,30 @@
+import type { JobsOptions } from 'bullmq';
+export declare const CRON_TASK_META = "MODERN_ADMIN_CRON_TASK_META";
+export interface CronTaskOptions {
+    /** Unique task name — used as the BullMQ job scheduler key. */
+    name: string;
+    /** Cron expression, e.g. `"0 8 * * *"` for every day at 08:00 UTC. */
+    cron: string;
+    /**
+     * When `true`, a distributed Redis lock is acquired before the handler runs.
+     * If the previous execution is still active, the new invocation is skipped.
+     */
+    skipIfRunning?: boolean;
+    /** Extra BullMQ job options (excluding `repeat` which is controlled by `cron`). */
+    opts?: Omit<JobsOptions, 'repeat'>;
+}
+/**
+ * Marks a service method as a BullMQ-backed cron task.
+ * The `CronService` discovers all decorated methods automatically on module init.
+ *
+ * @example
+ * @Injectable()
+ * export class ReportService {
+ *   @CronTask({ name: 'daily-report', cron: '0 8 * * *' })
+ *   async run(job: Job) {
+ *     // ...
+ *   }
+ * }
+ */
+export declare const CronTask: (options: CronTaskOptions) => MethodDecorator;
+//# sourceMappingURL=cron-task.decorator.d.ts.map

package/dist/cron/cron-task.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-task.decorator.d.ts","sourceRoot":"","sources":["../../src/cron/cron-task.decorator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AAEzC,eAAO,MAAM,cAAc,gCAAgC,CAAA;AAE3D,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAA;IACZ,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAA;IACZ;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,mFAAmF;IACnF,IAAI,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;CACnC;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,QAAQ,GAAI,SAAS,eAAe,KAAG,eACd,CAAA"}

package/dist/cron/cron-task.decorator.js

@@ -0,0 +1,17 @@
+import { SetMetadata } from '@nestjs/common';
+export const CRON_TASK_META = 'MODERN_ADMIN_CRON_TASK_META';
+/**
+ * Marks a service method as a BullMQ-backed cron task.
+ * The `CronService` discovers all decorated methods automatically on module init.
+ *
+ * @example
+ * @Injectable()
+ * export class ReportService {
+ *   @CronTask({ name: 'daily-report', cron: '0 8 * * *' })
+ *   async run(job: Job) {
+ *     // ...
+ *   }
+ * }
+ */
+export const CronTask = (options) => SetMetadata(CRON_TASK_META, options);
+//# sourceMappingURL=cron-task.decorator.js.map

package/dist/cron/cron-task.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-task.decorator.js","sourceRoot":"","sources":["../../src/cron/cron-task.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAG5C,MAAM,CAAC,MAAM,cAAc,GAAG,6BAA6B,CAAA;AAgB3D;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,OAAwB,EAAmB,EAAE,CACpE,WAAW,CAAC,cAAc,EAAE,OAAO,CAAC,CAAA"}

package/dist/cron/cron.constants.d.ts

@@ -0,0 +1,5 @@
+export declare const CRON_QUEUE = "ma:cron";
+export declare const DEFAULT_CRON_WORKER_CONCURRENCY = 4;
+export declare const CRON_LOCK_PREFIX = "ma:cron-lock:";
+export declare const DEFAULT_CRON_LOCK_TTL = 300;
+//# sourceMappingURL=cron.constants.d.ts.map

package/dist/cron/cron.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.constants.d.ts","sourceRoot":"","sources":["../../src/cron/cron.constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,YAAY,CAAA;AACnC,eAAO,MAAM,+BAA+B,IAAI,CAAA;AAChD,eAAO,MAAM,gBAAgB,kBAAkB,CAAA;AAC/C,eAAO,MAAM,qBAAqB,MAAM,CAAA"}

package/dist/cron/cron.constants.js

@@ -0,0 +1,5 @@
+export const CRON_QUEUE = 'ma:cron';
+export const DEFAULT_CRON_WORKER_CONCURRENCY = 4;
+export const CRON_LOCK_PREFIX = 'ma:cron-lock:';
+export const DEFAULT_CRON_LOCK_TTL = 300;
+//# sourceMappingURL=cron.constants.js.map

package/dist/cron/cron.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.constants.js","sourceRoot":"","sources":["../../src/cron/cron.constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAA;AACnC,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAA;AAChD,MAAM,CAAC,MAAM,gBAAgB,GAAG,eAAe,CAAA;AAC/C,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAA"}

package/dist/cron/cron.module.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Global module that enables BullMQ-backed cron scheduling.
+ *
+ * Provides:
+ * - `CronService` — register tasks imperatively or via `@CronTask` decorator
+ * - `CronProcessor` — BullMQ worker that dispatches jobs to their handlers
+ *
+ * Requires `QueueModule.forRoot()` to be imported in the root module.
+ *
+ * @example
+ * // AppModule
+ * imports: [
+ *   QueueModule.forRoot({ connection: { host: 'localhost', port: 6379 } }),
+ *   CronModule,
+ * ]
+ */
+export declare class CronModule {
+}
+//# sourceMappingURL=cron.module.d.ts.map

package/dist/cron/cron.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.module.d.ts","sourceRoot":"","sources":["../../src/cron/cron.module.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;GAeG;AACH,qBASa,UAAU;CAAG"}

package/dist/cron/cron.module.js

@@ -0,0 +1,43 @@
+var __decorate = (this && this.__decorate) || function (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);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { Global, Module } from '@nestjs/common';
+import { DiscoveryModule } from '@nestjs/core';
+import { QueueModule } from '../queue.module.js';
+import { CRON_QUEUE } from './cron.constants.js';
+import { CronService } from './cron.service.js';
+import { CronProcessor } from './cron.processor.js';
+/**
+ * Global module that enables BullMQ-backed cron scheduling.
+ *
+ * Provides:
+ * - `CronService` — register tasks imperatively or via `@CronTask` decorator
+ * - `CronProcessor` — BullMQ worker that dispatches jobs to their handlers
+ *
+ * Requires `QueueModule.forRoot()` to be imported in the root module.
+ *
+ * @example
+ * // AppModule
+ * imports: [
+ *   QueueModule.forRoot({ connection: { host: 'localhost', port: 6379 } }),
+ *   CronModule,
+ * ]
+ */
+let CronModule = class CronModule {
+};
+CronModule = __decorate([
+    Global(),
+    Module({
+        imports: [
+            DiscoveryModule,
+            QueueModule.register({ queues: [CRON_QUEUE] }),
+        ],
+        providers: [CronService, CronProcessor],
+        exports: [CronService],
+    })
+], CronModule);
+export { CronModule };
+//# sourceMappingURL=cron.module.js.map

package/dist/cron/cron.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.module.js","sourceRoot":"","sources":["../../src/cron/cron.module.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAEnD;;;;;;;;;;;;;;;GAeG;AAUI,IAAM,UAAU,GAAhB,MAAM,UAAU;CAAG,CAAA;AAAb,UAAU;IATtB,MAAM,EAAE;IACR,MAAM,CAAC;QACN,OAAO,EAAE;YACP,eAAe;YACf,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC;SAC/C;QACD,SAAS,EAAE,CAAC,WAAW,EAAE,aAAa,CAAC;QACvC,OAAO,EAAE,CAAC,WAAW,CAAC;KACvB,CAAC;GACW,UAAU,CAAG"}

package/dist/cron/cron.processor.d.ts

@@ -0,0 +1,13 @@
+import { WorkerHost } from '@nestjs/bullmq';
+import type { Job, Queue } from 'bullmq';
+import type { CronService } from './cron.service.js';
+export declare class CronProcessor extends WorkerHost {
+    private readonly cronService;
+    private readonly cronQueue;
+    private readonly logger;
+    constructor(cronService: CronService, cronQueue: Queue);
+    process(job: Job<unknown, unknown, string>): Promise<unknown>;
+    private processWithLock;
+    private executeHandler;
+}
+//# sourceMappingURL=cron.processor.d.ts.map

package/dist/cron/cron.processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.processor.d.ts","sourceRoot":"","sources":["../../src/cron/cron.processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAEnE,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AAOxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD,qBACa,aAAc,SAAQ,UAAU;IAIzC,OAAO,CAAC,QAAQ,CAAC,WAAW;IACH,OAAO,CAAC,QAAQ,CAAC,SAAS;IAJrD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiC;gBAGrC,WAAW,EAAE,WAAW,EACC,SAAS,EAAE,KAAK;IAKtD,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;YAarD,eAAe;YAmCf,cAAc;CAe7B"}

package/dist/cron/cron.processor.js

@@ -0,0 +1,83 @@
+var __decorate = (this && this.__decorate) || function (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);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var CronProcessor_1;
+import { InjectQueue, Processor, WorkerHost } from '@nestjs/bullmq';
+import { Logger } from '@nestjs/common';
+import { CRON_LOCK_PREFIX, CRON_QUEUE, DEFAULT_CRON_LOCK_TTL, DEFAULT_CRON_WORKER_CONCURRENCY, } from './cron.constants.js';
+let CronProcessor = CronProcessor_1 = class CronProcessor extends WorkerHost {
+    constructor(cronService, cronQueue) {
+        super();
+        this.cronService = cronService;
+        this.cronQueue = cronQueue;
+        this.logger = new Logger(CronProcessor_1.name);
+    }
+    async process(job) {
+        const handler = this.cronService.getHandler(job.name);
+        if (!handler) {
+            const msg = `No cron handler registered for "${job.name}"`;
+            this.logger.error(msg);
+            throw new Error(msg);
+        }
+        return this.cronService.shouldSkipIfRunning(job.name)
+            ? this.processWithLock(job, handler)
+            : this.executeHandler(job, handler);
+    }
+    async processWithLock(job, handler) {
+        const lockKey = `${CRON_LOCK_PREFIX}${job.name}`;
+        const client = await this.cronQueue.client;
+        // Atomic SET NX EX via the generic `runCommand` escape hatch on
+        // bullmq's `IRedisClient`. We can't use `client.set(..., { EX, NX })`
+        // because bullmq 5.77+ abstracted the client surface and dropped the
+        // `NX` option from `set`'s typed overloads (it now only accepts
+        // `{ PX?, EX? }`). `runCommand` is the documented portable way to
+        // reach any Redis command across ioredis / node-redis / bun-redis
+        // adapters. Returns the raw bulk-string reply ("OK") or nil.
+        const acquired = (await client.runCommand('set', [
+            lockKey,
+            job.id,
+            'EX',
+            DEFAULT_CRON_LOCK_TTL,
+            'NX',
+        ]));
+        if (!acquired) {
+            this.logger.warn(`Skipping "${job.name}" (jobId=${job.id}) — previous instance still running`);
+            return;
+        }
+        try {
+            return await this.executeHandler(job, handler);
+        }
+        finally {
+            await client.del(lockKey);
+        }
+    }
+    async executeHandler(job, handler) {
+        const start = Date.now();
+        this.logger.log(`Cron task "${job.name}" started (jobId=${job.id})`);
+        try {
+            const result = await handler(job);
+            this.logger.log(`Cron task "${job.name}" completed in ${Date.now() - start}ms`);
+            return result;
+        }
+        catch (err) {
+            this.logger.error(`Cron task "${job.name}" failed after ${Date.now() - start}ms`, err);
+            throw err;
+        }
+    }
+};
+CronProcessor = CronProcessor_1 = __decorate([
+    Processor(CRON_QUEUE, { concurrency: DEFAULT_CRON_WORKER_CONCURRENCY }),
+    __param(1, InjectQueue(CRON_QUEUE)),
+    __metadata("design:paramtypes", [Function, Function])
+], CronProcessor);
+export { CronProcessor };
+//# sourceMappingURL=cron.processor.js.map

package/dist/cron/cron.processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.processor.js","sourceRoot":"","sources":["../../src/cron/cron.processor.ts"],"names":[],"mappings":"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"}

package/dist/cron/cron.service.d.ts

@@ -0,0 +1,38 @@
+import { type OnModuleDestroy, type OnModuleInit } from '@nestjs/common';
+import { DiscoveryService, Reflector } from '@nestjs/core';
+import type { Queue } from 'bullmq';
+import type { CronHandler, CronTaskDefinition } from './cron.types.js';
+export declare class CronService implements OnModuleInit, OnModuleDestroy {
+    private readonly cronQueue;
+    private readonly discoveryService;
+    private readonly reflector;
+    private readonly logger;
+    private readonly handlers;
+    private readonly skipIfRunningSet;
+    private readonly definitions;
+    private initialized;
+    constructor(cronQueue: Queue, discoveryService: DiscoveryService, reflector: Reflector);
+    /**
+     * Register a cron task imperatively.
+     * If called before `onModuleInit`, it is picked up by `syncSchedulers`.
+     * If called after `onModuleInit`, the scheduler is upserted in BullMQ immediately.
+     */
+    register<TData = unknown, TResult = unknown>(definition: CronTaskDefinition<TData, TResult>): void;
+    getHandler<TData = unknown, TResult = unknown>(name: string): CronHandler<TData, TResult> | undefined;
+    shouldSkipIfRunning(name: string): boolean;
+    onModuleInit(): Promise<void>;
+    onModuleDestroy(): Promise<void>;
+    /**
+     * Remove specific cron tasks by name — deletes their schedulers and any
+     * waiting/delayed jobs from Redis.
+     */
+    purgeTasks(names: string[]): Promise<void>;
+    private discoverCronTasks;
+    /**
+     * Synchronise repeatable job schedulers in Redis with the current definitions.
+     * Removes stale schedulers no longer defined in code, then upserts all current ones.
+     */
+    private syncSchedulers;
+    private upsertScheduler;
+}
+//# sourceMappingURL=cron.service.d.ts.map

package/dist/cron/cron.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.service.d.ts","sourceRoot":"","sources":["../../src/cron/cron.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,YAAY,EAClB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAE1D,OAAO,KAAK,EAAO,KAAK,EAAE,MAAM,QAAQ,CAAA;AAExC,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAGtE,qBACa,WAAY,YAAW,YAAY,EAAE,eAAe;IAQpC,OAAO,CAAC,QAAQ,CAAC,SAAS;IACnD,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAT5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+B;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiC;IAC1D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAoB;IACrD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA2B;IACvD,OAAO,CAAC,WAAW,CAAQ;gBAGiB,SAAS,EAAE,KAAK,EACzC,gBAAgB,EAAE,gBAAgB,EAClC,SAAS,EAAE,SAAS;IAGvC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EACzC,UAAU,EAAE,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,GAC7C,IAAI;IAaP,UAAU,CAAC,KAAK,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EAC3C,IAAI,EAAE,MAAM,GACX,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,SAAS;IAI1C,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIpC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAW7B,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAItC;;;OAGG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BhD,OAAO,CAAC,iBAAiB;IA6BzB;;;OAGG;YACW,cAAc;YAsBd,eAAe;CAmB9B"}

package/dist/cron/cron.service.js

@@ -0,0 +1,175 @@
+var __decorate = (this && this.__decorate) || function (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);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var CronService_1;
+import { Injectable, Logger, } from '@nestjs/common';
+import { DiscoveryService, Reflector } from '@nestjs/core';
+import { InjectQueue } from '@nestjs/bullmq';
+import { CRON_QUEUE } from './cron.constants.js';
+import { CRON_TASK_META } from './cron-task.decorator.js';
+let CronService = CronService_1 = class CronService {
+    constructor(cronQueue, discoveryService, reflector) {
+        this.cronQueue = cronQueue;
+        this.discoveryService = discoveryService;
+        this.reflector = reflector;
+        this.logger = new Logger(CronService_1.name);
+        this.handlers = new Map();
+        this.skipIfRunningSet = new Set();
+        this.definitions = [];
+        this.initialized = false;
+    }
+    /**
+     * Register a cron task imperatively.
+     * If called before `onModuleInit`, it is picked up by `syncSchedulers`.
+     * If called after `onModuleInit`, the scheduler is upserted in BullMQ immediately.
+     */
+    register(definition) {
+        if (this.handlers.has(definition.name)) {
+            throw new Error(`Cron task "${definition.name}" is already registered`);
+        }
+        this.handlers.set(definition.name, definition.handler);
+        if (definition.skipIfRunning)
+            this.skipIfRunningSet.add(definition.name);
+        this.definitions.push(definition);
+        if (this.initialized) {
+            void this.upsertScheduler(definition);
+        }
+    }
+    getHandler(name) {
+        return this.handlers.get(name);
+    }
+    shouldSkipIfRunning(name) {
+        return this.skipIfRunningSet.has(name);
+    }
+    async onModuleInit() {
+        this.discoverCronTasks();
+        try {
+            await this.syncSchedulers();
+        }
+        catch (err) {
+            this.logger.error('Failed to sync cron schedulers on init', err);
+        }
+        finally {
+            this.initialized = true;
+        }
+    }
+    async onModuleDestroy() {
+        await this.cronQueue.close();
+    }
+    /**
+     * Remove specific cron tasks by name — deletes their schedulers and any
+     * waiting/delayed jobs from Redis.
+     */
+    async purgeTasks(names) {
+        const schedulers = await this.cronQueue.getJobSchedulers();
+        for (const s of schedulers) {
+            if (names.includes(s.name)) {
+                try {
+                    await this.cronQueue.removeJobScheduler(s.key);
+                    this.logger.log(`Purged scheduler: ${s.name}`);
+                }
+                catch (err) {
+                    this.logger.error(`Failed to purge scheduler ${s.name}`, err);
+                }
+            }
+        }
+        const jobs = (await this.cronQueue.getJobs(['waiting', 'delayed']));
+        for (const j of jobs) {
+            if (!j)
+                continue;
+            if (names.includes(j.name)) {
+                try {
+                    await j.remove();
+                    this.logger.log(`Purged job: ${j.name} (id=${j.id})`);
+                }
+                catch (err) {
+                    this.logger.error(`Failed to purge job ${j.name}`, err);
+                }
+            }
+        }
+    }
+    discoverCronTasks() {
+        const providers = this.discoveryService.getProviders();
+        for (const wrapper of providers) {
+            const instance = wrapper.instance;
+            if (!instance || typeof instance !== 'object')
+                continue;
+            const prototype = Object.getPrototypeOf(instance);
+            for (const key of Object.getOwnPropertyNames(prototype)) {
+                if (key === 'constructor')
+                    continue;
+                const descriptor = Object.getOwnPropertyDescriptor(prototype, key);
+                if (!descriptor || typeof descriptor.value !== 'function')
+                    continue;
+                const meta = this.reflector.get(CRON_TASK_META, descriptor.value);
+                if (!meta)
+                    continue;
+                const method = instance[key];
+                if (typeof method !== 'function')
+                    continue;
+                this.register({
+                    name: meta.name,
+                    cron: meta.cron,
+                    handler: (job) => method.call(instance, job),
+                    skipIfRunning: meta.skipIfRunning,
+                    opts: meta.opts,
+                });
+            }
+        }
+    }
+    /**
+     * Synchronise repeatable job schedulers in Redis with the current definitions.
+     * Removes stale schedulers no longer defined in code, then upserts all current ones.
+     */
+    async syncSchedulers() {
+        const registeredNames = new Set(this.definitions.map((d) => d.name));
+        const existing = await this.cronQueue.getJobSchedulers();
+        for (const scheduler of existing) {
+            if (!registeredNames.has(scheduler.name)) {
+                try {
+                    await this.cronQueue.removeJobScheduler(scheduler.key);
+                    this.logger.log(`Removed stale cron scheduler: ${scheduler.name} (key=${scheduler.key})`);
+                }
+                catch (err) {
+                    this.logger.error(`Failed to remove stale scheduler ${scheduler.name}`, err);
+                }
+            }
+        }
+        for (const def of this.definitions) {
+            await this.upsertScheduler(def);
+        }
+    }
+    async upsertScheduler(def) {
+        try {
+            await this.cronQueue.upsertJobScheduler(def.name, { pattern: def.cron }, {
+                name: def.name,
+                opts: {
+                    removeOnComplete: { count: 100 },
+                    removeOnFail: { count: 100 },
+                    ...def.opts,
+                },
+            });
+            this.logger.log(`Cron task scheduled: "${def.name}" [${def.cron}]`);
+        }
+        catch (err) {
+            this.logger.error(`Failed to schedule cron task "${def.name}"`, err);
+        }
+    }
+};
+CronService = CronService_1 = __decorate([
+    Injectable(),
+    __param(0, InjectQueue(CRON_QUEUE)),
+    __metadata("design:paramtypes", [Function, DiscoveryService,
+        Reflector])
+], CronService);
+export { CronService };
+//# sourceMappingURL=cron.service.js.map

package/dist/cron/cron.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.service.js","sourceRoot":"","sources":["../../src/cron/cron.service.ts"],"names":[],"mappings":"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"}

package/dist/cron/cron.types.d.ts

@@ -0,0 +1,10 @@
+import type { Job, JobsOptions } from 'bullmq';
+export type CronHandler<TData = unknown, TResult = unknown> = (job: Job<TData, TResult, string>) => Promise<TResult> | TResult;
+export interface CronTaskDefinition<TData = unknown, TResult = unknown> {
+    name: string;
+    cron: string;
+    handler: CronHandler<TData, TResult>;
+    skipIfRunning?: boolean;
+    opts?: Omit<JobsOptions, 'repeat'>;
+}
+//# sourceMappingURL=cron.types.d.ts.map

package/dist/cron/cron.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.types.d.ts","sourceRoot":"","sources":["../../src/cron/cron.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AAE9C,MAAM,MAAM,WAAW,CAAC,KAAK,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,CAC5D,GAAG,EAAE,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,KAC7B,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAA;AAE/B,MAAM,WAAW,kBAAkB,CAAC,KAAK,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IACpE,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;IACpC,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,IAAI,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;CACnC"}

package/dist/cron/cron.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cron.types.js.map

package/dist/cron/cron.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.types.js","sourceRoot":"","sources":["../../src/cron/cron.types.ts"],"names":[],"mappings":""}

package/dist/cron/index.d.ts

@@ -0,0 +1,7 @@
+export { CronModule } from './cron.module.js';
+export { CronService } from './cron.service.js';
+export { CronProcessor } from './cron.processor.js';
+export { CronTask, CRON_TASK_META, type CronTaskOptions } from './cron-task.decorator.js';
+export type { CronHandler, CronTaskDefinition } from './cron.types.js';
+export { CRON_QUEUE, CRON_LOCK_PREFIX, DEFAULT_CRON_WORKER_CONCURRENCY, DEFAULT_CRON_LOCK_TTL, } from './cron.constants.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cron/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,0BAA0B,CAAA;AACzF,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACtE,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,+BAA+B,EAC/B,qBAAqB,GACtB,MAAM,qBAAqB,CAAA"}

package/dist/cron/index.js

@@ -0,0 +1,6 @@
+export { CronModule } from './cron.module.js';
+export { CronService } from './cron.service.js';
+export { CronProcessor } from './cron.processor.js';
+export { CronTask, CRON_TASK_META } from './cron-task.decorator.js';
+export { CRON_QUEUE, CRON_LOCK_PREFIX, DEFAULT_CRON_WORKER_CONCURRENCY, DEFAULT_CRON_LOCK_TTL, } from './cron.constants.js';
+//# sourceMappingURL=index.js.map

package/dist/cron/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cron/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAwB,MAAM,0BAA0B,CAAA;AAEzF,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,+BAA+B,EAC/B,qBAAqB,GACtB,MAAM,qBAAqB,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { QueueModule } from './queue.module.js';
+export type { QueueModuleOptions, QueueRootOptions } from './queue.types.js';
+export { CronModule, CronService, CronProcessor, CronTask, CRON_TASK_META, CRON_QUEUE, CRON_LOCK_PREFIX, DEFAULT_CRON_WORKER_CONCURRENCY, DEFAULT_CRON_LOCK_TTL, type CronTaskOptions, type CronHandler, type CronTaskDefinition, } from './cron';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAE5E,OAAO,EACL,UAAU,EACV,WAAW,EACX,aAAa,EACb,QAAQ,EACR,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,+BAA+B,EAC/B,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,kBAAkB,GACxB,MAAM,QAAQ,CAAA"}

package/dist/index.js

@@ -0,0 +1,4 @@
+// @modern-admin/queue — BullMQ queue + cron scheduling for NestJS.
+export { QueueModule } from './queue.module.js';
+export { CronModule, CronService, CronProcessor, CronTask, CRON_TASK_META, CRON_QUEUE, CRON_LOCK_PREFIX, DEFAULT_CRON_WORKER_CONCURRENCY, DEFAULT_CRON_LOCK_TTL, } from './cron';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mEAAmE;AAEnE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAG/C,OAAO,EACL,UAAU,EACV,WAAW,EACX,aAAa,EACb,QAAQ,EACR,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,+BAA+B,EAC/B,qBAAqB,GAItB,MAAM,QAAQ,CAAA"}

package/dist/queue.module.d.ts

@@ -0,0 +1,49 @@
+import { type DynamicModule } from '@nestjs/common';
+import type { QueueModuleOptions, QueueRootOptions } from './queue.types.js';
+/**
+ * BullMQ integration module for modern-admin NestJS applications.
+ *
+ * 1. Call `QueueModule.forRoot()` once in the root AppModule to configure the
+ *    Redis connection globally.
+ * 2. Call `QueueModule.register({ queues: [...] })` in any feature module to
+ *    register named queues and make their injection tokens available.
+ *
+ * @example
+ * // AppModule
+ * imports: [
+ *   QueueModule.forRoot({ connection: { host: 'localhost', port: 6379 } }),
+ *   QueueModule.register({ queues: ['emails', 'exports'] }),
+ *   CronModule,
+ * ]
+ */
+export declare class QueueModule {
+    /**
+     * Configure the BullMQ Redis connection for the whole application.
+     * Must be imported once at the root level before any `register()` call.
+     */
+    static forRoot(options: QueueRootOptions): DynamicModule;
+    /**
+     * Async variant of `forRoot` — useful when the Redis URL comes from a
+     * config service or environment variable loaded at runtime.
+     *
+     * @example
+     * QueueModule.forRootAsync({
+     *   imports: [ConfigModule],
+     *   inject: [ConfigService],
+     *   useFactory: (cfg: ConfigService) => ({
+     *     connection: cfg.get('REDIS_URL'),
+     *   }),
+     * })
+     */
+    static forRootAsync(opts: {
+        imports?: DynamicModule['imports'];
+        inject?: unknown[];
+        useFactory: (...args: unknown[]) => QueueRootOptions | Promise<QueueRootOptions>;
+    }): DynamicModule;
+    /**
+     * Register named queues (and optional flow producers) in the current module.
+     * Exports the BullMQ tokens so they can be injected via `@InjectQueue(name)`.
+     */
+    static register(options: QueueModuleOptions): DynamicModule;
+}
+//# sourceMappingURL=queue.module.d.ts.map

package/dist/queue.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.module.d.ts","sourceRoot":"","sources":["../src/queue.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAU,MAAM,gBAAgB,CAAA;AAE3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAE5E;;;;;;;;;;;;;;;GAeG;AACH,qBACa,WAAW;IACtB;;;OAGG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,aAAa;IAaxD;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE;QACxB,OAAO,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAA;QAClC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAA;QAClB,UAAU,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;KACjF,GAAG,aAAa;IAoBjB;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,GAAG,aAAa;CAa5D"}