@modern-admin/queue 0.6.0 → 0.9.0

package/README.md

@@ -20,6 +20,39 @@ bun add @modern-admin/queue
 Setup guides, architecture, and usage examples live in the
 [Modern Admin README](https://github.com/modern-admin/modern-admin#readme).
 
+## System retention
+
+`RetentionModule` runs history and audit-log pruning in the existing BullMQ
+cron queue. Import `QueueModule.forRoot()` once, then configure whichever
+stores need retention:
+
+```ts
+import { QueueModule, RetentionModule } from '@modern-admin/queue'
+
+@Module({
+  imports: [
+    QueueModule.forRoot({ connection: process.env.REDIS_URL! }),
+    RetentionModule.forRoot({
+      cron: '0 3 * * *',
+      history: {
+        store: system.historyStore,
+        keepDays: 90,
+        keepLast: 100,
+      },
+      auditLog: {
+        store: system.logStore,
+        keepDays: 365,
+      },
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+The task uses the cron worker's distributed lock, retries failures three
+times, and does not run when no `keepDays`/`keepLast` bound is configured.
+History `keepLast` is per record; audit-log `keepLast` is global.
+
 ## License
 
 [MIT](https://github.com/modern-admin/modern-admin/blob/main/LICENSE) © Modern Admin

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

@@ -1,4 +1,4 @@
-export declare const CRON_QUEUE = "ma:cron";
+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;

package/dist/cron/cron.constants.js

@@ -1,4 +1,4 @@
-export const CRON_QUEUE = 'ma:cron';
+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;

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

@@ -1,6 +1,6 @@
 import { WorkerHost } from '@nestjs/bullmq';
 import type { Job, Queue } from 'bullmq';
-import type { CronService } from './cron.service.js';
+import { CronService } from './cron.service.js';
 export declare class CronProcessor extends WorkerHost {
     private readonly cronService;
     private readonly cronQueue;

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

@@ -1 +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;IAExD,YACmB,WAAW,EAAE,WAAW,EACC,SAAS,EAAE,KAAK,EAG3D;IAEK,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAWlE;YAEa,eAAe;YAmCf,cAAc;CAe7B"}
+{"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,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C,qBACa,aAAc,SAAQ,UAAU;IAIzC,OAAO,CAAC,QAAQ,CAAC,WAAW;IACH,OAAO,CAAC,QAAQ,CAAC,SAAS;IAJrD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiC;IAExD,YACmB,WAAW,EAAE,WAAW,EACC,SAAS,EAAE,KAAK,EAG3D;IAEK,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAWlE;YAEa,eAAe;YAmCf,cAAc;CAe7B"}

package/dist/cron/cron.processor.js

@@ -14,6 +14,7 @@ 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';
+import { CronService } from './cron.service.js';
 let CronProcessor = CronProcessor_1 = class CronProcessor extends WorkerHost {
     constructor(cronService, cronQueue) {
         super();
@@ -77,7 +78,7 @@ let CronProcessor = CronProcessor_1 = class CronProcessor extends WorkerHost {
 CronProcessor = CronProcessor_1 = __decorate([
     Processor(CRON_QUEUE, { concurrency: DEFAULT_CRON_WORKER_CONCURRENCY }),
     __param(1, InjectQueue(CRON_QUEUE)),
-    __metadata("design:paramtypes", [Function, Function])
+    __metadata("design:paramtypes", [CronService, Function])
 ], CronProcessor);
 export { CronProcessor };
 //# sourceMappingURL=cron.processor.js.map

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

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

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 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';
+export { RetentionModule, RetentionService, RETENTION_OPTIONS, DEFAULT_RETENTION_CRON, SYSTEM_RETENTION_TASK, type AuditLogRetentionTarget, type HistoryRetentionTarget, type PrunableStore, type RetentionModuleOptions, type RetentionRunResult, } from './retention';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +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"}
+{"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;AAEf,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAA"}

package/dist/index.js

@@ -1,4 +1,5 @@
 // @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';
+export { RetentionModule, RetentionService, RETENTION_OPTIONS, DEFAULT_RETENTION_CRON, SYSTEM_RETENTION_TASK, } from './retention';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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"}
+{"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;AAEf,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,GAMtB,MAAM,aAAa,CAAA"}

package/dist/queue.module.d.ts

@@ -1,5 +1,6 @@
 import { type DynamicModule } from '@nestjs/common';
 import type { QueueModuleOptions, QueueRootOptions } from './queue.types.js';
+export declare const normalizeQueueConnection: (connection: QueueRootOptions['connection']) => object;
 /**
  * BullMQ integration module for modern-admin NestJS applications.
  *

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

@@ -1 +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,CAWvD;IAED;;;;;;;;;;;;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,CAkBhB;IAED;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,GAAG,aAAa,CAY1D;CACF"}
+{"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,eAAO,MAAM,wBAAwB,eACvB,gBAAgB,CAAC,YAAY,CAAC,KACzC,MAA2E,CAAA;AAE9E;;;;;;;;;;;;;;;GAeG;AACH,qBACa,WAAW;IACtB;;;OAGG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,aAAa,CAWvD;IAED;;;;;;;;;;;;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,CAkBhB;IAED;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,GAAG,aAAa,CAY1D;CACF"}

package/dist/queue.module.js

@@ -7,6 +7,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var QueueModule_1;
 import { Module } from '@nestjs/common';
 import { BullModule } from '@nestjs/bullmq';
+export const normalizeQueueConnection = (connection) => typeof connection === 'string' ? { url: connection } : connection;
 /**
  * BullMQ integration module for modern-admin NestJS applications.
  *
@@ -34,7 +35,7 @@ let QueueModule = QueueModule_1 = class QueueModule {
             global: true,
             imports: [
                 BullModule.forRoot({
-                    connection: options.connection,
+                    connection: normalizeQueueConnection(options.connection),
                     defaultJobOptions: options.defaultJobOptions,
                 }),
             ],
@@ -64,7 +65,7 @@ let QueueModule = QueueModule_1 = class QueueModule {
                     useFactory: async (...args) => {
                         const resolved = await opts.useFactory(...args);
                         return {
-                            connection: resolved.connection,
+                            connection: normalizeQueueConnection(resolved.connection),
                             defaultJobOptions: resolved.defaultJobOptions,
                         };
                     },

package/dist/queue.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"queue.module.js","sourceRoot":"","sources":["../src/queue.module.ts"],"names":[],"mappings":";;;;;;;AAAA,OAAO,EAAsB,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAG3C;;;;;;;;;;;;;;;GAeG;AAEI,IAAM,WAAW,mBAAjB,MAAM,WAAW;IACtB;;;OAGG;IACI,AAAP,MAAM,CAAC,OAAO,CAAC,OAAyB;QACtC,OAAO;YACL,MAAM,eAAa;YACnB,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE;gBACP,UAAU,CAAC,OAAO,CAAC;oBACjB,UAAU,EAAE,OAAO,CAAC,UAAoB;oBACxC,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;iBAC7C,CAAC;aACH;SACF,CAAA;IACH,CAAC;IAED;;;;;;;;;;;;OAYG;IACI,AAAP,MAAM,CAAC,YAAY,CAAC,IAInB;QACC,OAAO;YACL,MAAM,eAAa;YACnB,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE;gBACP,UAAU,CAAC,YAAY,CAAC;oBACtB,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,MAAM,EAAE,IAAI,CAAC,MAAiB;oBAC9B,UAAU,EAAE,KAAK,EAAE,GAAG,IAAe,EAAE,EAAE;wBACvC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,CAAA;wBAC/C,OAAO;4BACL,UAAU,EAAE,QAAQ,CAAC,UAAoB;4BACzC,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB;yBAC9C,CAAA;oBACH,CAAC;iBACF,CAAC;aACH;SACF,CAAA;IACH,CAAC;IAED;;;OAGG;IACI,AAAP,MAAM,CAAC,QAAQ,CAAC,OAA2B;QACzC,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAC/C,UAAU,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,CAAC,CACnC,CAAA;QACD,MAAM,WAAW,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACrD,UAAU,CAAC,oBAAoB,CAAC,EAAE,IAAI,EAAE,CAAC,CAC1C,CAAA;QACD,OAAO;YACL,MAAM,eAAa;YACnB,OAAO,EAAE,CAAC,GAAG,YAAY,EAAE,GAAG,WAAW,CAAC;YAC1C,OAAO,EAAE,CAAC,GAAG,YAAY,EAAE,GAAG,WAAW,CAAC;SAC3C,CAAA;IACH,CAAC;CACF,CAAA;AAxEY,WAAW;IADvB,MAAM,CAAC,EAAE,CAAC;GACE,WAAW,CAwEvB"}
+{"version":3,"file":"queue.module.js","sourceRoot":"","sources":["../src/queue.module.ts"],"names":[],"mappings":";;;;;;;AAAA,OAAO,EAAsB,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAG3C,MAAM,CAAC,MAAM,wBAAwB,GAAG,CACtC,UAA0C,EAClC,EAAE,CAAC,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,UAAU,CAAA;AAE9E;;;;;;;;;;;;;;;GAeG;AAEI,IAAM,WAAW,mBAAjB,MAAM,WAAW;IACtB;;;OAGG;IACI,AAAP,MAAM,CAAC,OAAO,CAAC,OAAyB;QACtC,OAAO;YACL,MAAM,eAAa;YACnB,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE;gBACP,UAAU,CAAC,OAAO,CAAC;oBACjB,UAAU,EAAE,wBAAwB,CAAC,OAAO,CAAC,UAAU,CAAC;oBACxD,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;iBAC7C,CAAC;aACH;SACF,CAAA;IACH,CAAC;IAED;;;;;;;;;;;;OAYG;IACI,AAAP,MAAM,CAAC,YAAY,CAAC,IAInB;QACC,OAAO;YACL,MAAM,eAAa;YACnB,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE;gBACP,UAAU,CAAC,YAAY,CAAC;oBACtB,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,MAAM,EAAE,IAAI,CAAC,MAAiB;oBAC9B,UAAU,EAAE,KAAK,EAAE,GAAG,IAAe,EAAE,EAAE;wBACvC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,CAAA;wBAC/C,OAAO;4BACL,UAAU,EAAE,wBAAwB,CAAC,QAAQ,CAAC,UAAU,CAAC;4BACzD,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB;yBAC9C,CAAA;oBACH,CAAC;iBACF,CAAC;aACH;SACF,CAAA;IACH,CAAC;IAED;;;OAGG;IACI,AAAP,MAAM,CAAC,QAAQ,CAAC,OAA2B;QACzC,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAC/C,UAAU,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,CAAC,CACnC,CAAA;QACD,MAAM,WAAW,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACrD,UAAU,CAAC,oBAAoB,CAAC,EAAE,IAAI,EAAE,CAAC,CAC1C,CAAA;QACD,OAAO;YACL,MAAM,eAAa;YACnB,OAAO,EAAE,CAAC,GAAG,YAAY,EAAE,GAAG,WAAW,CAAC;YAC1C,OAAO,EAAE,CAAC,GAAG,YAAY,EAAE,GAAG,WAAW,CAAC;SAC3C,CAAA;IACH,CAAC;CACF,CAAA;AAxEY,WAAW;IADvB,MAAM,CAAC,EAAE,CAAC;GACE,WAAW,CAwEvB"}

package/dist/retention/index.d.ts

@@ -0,0 +1,6 @@
+export { RetentionModule } from './retention.module.js';
+export { RetentionService } from './retention.service.js';
+export { RETENTION_OPTIONS } from './retention.tokens.js';
+export { DEFAULT_RETENTION_CRON, SYSTEM_RETENTION_TASK } from './retention.constants.js';
+export type { AuditLogRetentionTarget, HistoryRetentionTarget, PrunableStore, RetentionModuleOptions, RetentionRunResult, } from './retention.types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/retention/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAA;AACxF,YAAY,EACV,uBAAuB,EACvB,sBAAsB,EACtB,aAAa,EACb,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,sBAAsB,CAAA"}

package/dist/retention/index.js

@@ -0,0 +1,5 @@
+export { RetentionModule } from './retention.module.js';
+export { RetentionService } from './retention.service.js';
+export { RETENTION_OPTIONS } from './retention.tokens.js';
+export { DEFAULT_RETENTION_CRON, SYSTEM_RETENTION_TASK } from './retention.constants.js';
+//# sourceMappingURL=index.js.map

package/dist/retention/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/retention/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAA"}

package/dist/retention/retention.constants.d.ts

@@ -0,0 +1,3 @@
+export declare const SYSTEM_RETENTION_TASK = "ma:system-retention";
+export declare const DEFAULT_RETENTION_CRON = "0 3 * * *";
+//# sourceMappingURL=retention.constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retention.constants.d.ts","sourceRoot":"","sources":["../../src/retention/retention.constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,wBAAwB,CAAA;AAC1D,eAAO,MAAM,sBAAsB,cAAc,CAAA"}

package/dist/retention/retention.constants.js

@@ -0,0 +1,3 @@
+export const SYSTEM_RETENTION_TASK = 'ma:system-retention';
+export const DEFAULT_RETENTION_CRON = '0 3 * * *';
+//# sourceMappingURL=retention.constants.js.map

package/dist/retention/retention.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention.constants.js","sourceRoot":"","sources":["../../src/retention/retention.constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG,qBAAqB,CAAA;AAC1D,MAAM,CAAC,MAAM,sBAAsB,GAAG,WAAW,CAAA"}

package/dist/retention/retention.module.d.ts

@@ -0,0 +1,10 @@
+import { type DynamicModule } from '@nestjs/common';
+import type { RetentionModuleOptions } from './retention.types.js';
+/**
+ * Schedules history and action-log pruning as a durable BullMQ cron task.
+ * Requires `QueueModule.forRoot()` in the host application's root module.
+ */
+export declare class RetentionModule {
+    static forRoot(options: RetentionModuleOptions): DynamicModule;
+}
+//# sourceMappingURL=retention.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retention.module.d.ts","sourceRoot":"","sources":["../../src/retention/retention.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAU,MAAM,gBAAgB,CAAA;AAI3D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAmBlE;;;GAGG;AACH,qBACa,eAAe;IAC1B,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,sBAAsB,GAAG,aAAa,CAW7D;CACF"}

package/dist/retention/retention.module.js

@@ -0,0 +1,50 @@
+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 RetentionModule_1;
+import { Module } from '@nestjs/common';
+import { CronModule } from '../cron/cron.module.js';
+import { RetentionService } from './retention.service.js';
+import { RETENTION_OPTIONS } from './retention.tokens.js';
+const assertBound = (name, value) => {
+    if (value === undefined)
+        return;
+    if (!Number.isFinite(value) || !Number.isInteger(value) || value < 0) {
+        throw new Error(`${name} must be a non-negative integer`);
+    }
+};
+const validateOptions = (options) => {
+    if (options.cron !== undefined && options.cron.trim().length === 0) {
+        throw new Error('retention cron must not be empty');
+    }
+    assertBound('history.keepLast', options.history?.keepLast);
+    assertBound('history.keepDays', options.history?.keepDays);
+    assertBound('auditLog.keepLast', options.auditLog?.keepLast);
+    assertBound('auditLog.keepDays', options.auditLog?.keepDays);
+};
+/**
+ * Schedules history and action-log pruning as a durable BullMQ cron task.
+ * Requires `QueueModule.forRoot()` in the host application's root module.
+ */
+let RetentionModule = RetentionModule_1 = class RetentionModule {
+    static forRoot(options) {
+        validateOptions(options);
+        return {
+            module: RetentionModule_1,
+            imports: [CronModule],
+            providers: [
+                { provide: RETENTION_OPTIONS, useValue: options },
+                RetentionService,
+            ],
+            exports: [RetentionService],
+        };
+    }
+};
+RetentionModule = RetentionModule_1 = __decorate([
+    Module({})
+], RetentionModule);
+export { RetentionModule };
+//# sourceMappingURL=retention.module.js.map

package/dist/retention/retention.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention.module.js","sourceRoot":"","sources":["../../src/retention/retention.module.ts"],"names":[],"mappings":";;;;;;;AAAA,OAAO,EAAsB,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAGzD,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,KAAyB,EAAQ,EAAE;IACpE,IAAI,KAAK,KAAK,SAAS;QAAE,OAAM;IAC/B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,iCAAiC,CAAC,CAAA;IAC3D,CAAC;AACH,CAAC,CAAA;AAED,MAAM,eAAe,GAAG,CAAC,OAA+B,EAAQ,EAAE;IAChE,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAA;IACrD,CAAC;IACD,WAAW,CAAC,kBAAkB,EAAE,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;IAC1D,WAAW,CAAC,kBAAkB,EAAE,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;IAC1D,WAAW,CAAC,mBAAmB,EAAE,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IAC5D,WAAW,CAAC,mBAAmB,EAAE,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;AAC9D,CAAC,CAAA;AAED;;;GAGG;AAEI,IAAM,eAAe,uBAArB,MAAM,eAAe;IACnB,AAAP,MAAM,CAAC,OAAO,CAAC,OAA+B;QAC5C,eAAe,CAAC,OAAO,CAAC,CAAA;QACxB,OAAO;YACL,MAAM,mBAAiB;YACvB,OAAO,EAAE,CAAC,UAAU,CAAC;YACrB,SAAS,EAAE;gBACT,EAAE,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,OAAO,EAAE;gBACjD,gBAAgB;aACjB;YACD,OAAO,EAAE,CAAC,gBAAgB,CAAC;SAC5B,CAAA;IACH,CAAC;CACF,CAAA;AAbY,eAAe;IAD3B,MAAM,CAAC,EAAE,CAAC;GACE,eAAe,CAa3B"}

package/dist/retention/retention.service.d.ts

@@ -0,0 +1,15 @@
+import { type OnModuleInit } from '@nestjs/common';
+import { CronService } from '../cron/cron.service.js';
+import type { RetentionModuleOptions, RetentionRunResult } from './retention.types.js';
+export declare class RetentionService implements OnModuleInit {
+    private readonly options;
+    private readonly cron;
+    constructor(options: RetentionModuleOptions, cron: CronService);
+    onModuleInit(): void;
+    /** Execute every configured retention target. Called by the BullMQ worker. */
+    run(): Promise<RetentionRunResult>;
+    private hasWork;
+    private pruneHistory;
+    private pruneAuditLog;
+}
+//# sourceMappingURL=retention.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retention.service.d.ts","sourceRoot":"","sources":["../../src/retention/retention.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAEtE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAGrD,OAAO,KAAK,EAGV,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,sBAAsB,CAAA;AAK7B,qBACa,gBAAiB,YAAW,YAAY;IAEtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACnD,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFvB,YAC8C,OAAO,EAAE,sBAAsB,EAC1D,IAAI,EAAE,WAAW,EAChC;IAEJ,YAAY,IAAI,IAAI,CAcnB;IAED,8EAA8E;IACxE,GAAG,IAAI,OAAO,CAAC,kBAAkB,CAAC,CA2BvC;IAED,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,aAAa;CAOtB"}

package/dist/retention/retention.service.js

@@ -0,0 +1,91 @@
+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); }
+};
+import { Inject, Injectable } from '@nestjs/common';
+import { CronService } from '../cron/cron.service.js';
+import { DEFAULT_RETENTION_CRON, SYSTEM_RETENTION_TASK } from './retention.constants.js';
+import { RETENTION_OPTIONS } from './retention.tokens.js';
+const hasBounds = (retention) => retention.keepLast !== undefined || retention.keepDays !== undefined;
+let RetentionService = class RetentionService {
+    constructor(options, cron) {
+        this.options = options;
+        this.cron = cron;
+    }
+    onModuleInit() {
+        if (!this.hasWork())
+            return;
+        this.cron.register({
+            name: SYSTEM_RETENTION_TASK,
+            cron: this.options.cron ?? DEFAULT_RETENTION_CRON,
+            skipIfRunning: true,
+            opts: {
+                attempts: 3,
+                backoff: { type: 'exponential', delay: 1_000 },
+                ...this.options.jobOptions,
+            },
+            handler: () => this.run(),
+        });
+    }
+    /** Execute every configured retention target. Called by the BullMQ worker. */
+    async run() {
+        const result = {};
+        const failures = [];
+        if (this.options.history && hasBounds(this.options.history)) {
+            try {
+                result.history = await this.pruneHistory(this.options.history);
+            }
+            catch (err) {
+                failures.push(err);
+            }
+        }
+        if (this.options.auditLog && hasBounds(this.options.auditLog)) {
+            try {
+                result.auditLog = await this.pruneAuditLog(this.options.auditLog);
+            }
+            catch (err) {
+                failures.push(err);
+            }
+        }
+        if (failures.length === 1) {
+            throw failures[0];
+        }
+        if (failures.length > 1) {
+            throw new AggregateError(failures, 'Multiple retention targets failed');
+        }
+        return result;
+    }
+    hasWork() {
+        return Boolean((this.options.history && hasBounds(this.options.history))
+            || (this.options.auditLog && hasBounds(this.options.auditLog)));
+    }
+    pruneHistory(target) {
+        const retention = {
+            ...(target.keepLast !== undefined ? { keepLast: target.keepLast } : {}),
+            ...(target.keepDays !== undefined ? { keepDays: target.keepDays } : {}),
+        };
+        return target.store.prune(retention);
+    }
+    pruneAuditLog(target) {
+        const retention = {
+            ...(target.keepLast !== undefined ? { keepLast: target.keepLast } : {}),
+            ...(target.keepDays !== undefined ? { keepDays: target.keepDays } : {}),
+        };
+        return target.store.prune(retention);
+    }
+};
+RetentionService = __decorate([
+    Injectable(),
+    __param(0, Inject(RETENTION_OPTIONS)),
+    __metadata("design:paramtypes", [Object, CronService])
+], RetentionService);
+export { RetentionService };
+//# sourceMappingURL=retention.service.js.map

package/dist/retention/retention.service.js.map

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

package/dist/retention/retention.tokens.d.ts

@@ -0,0 +1,2 @@
+export declare const RETENTION_OPTIONS: unique symbol;
+//# sourceMappingURL=retention.tokens.d.ts.map

package/dist/retention/retention.tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention.tokens.d.ts","sourceRoot":"","sources":["../../src/retention/retention.tokens.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,eAAqD,CAAA"}

package/dist/retention/retention.tokens.js

@@ -0,0 +1,2 @@
+export const RETENTION_OPTIONS = Symbol.for('@modern-admin/queue:RetentionOptions');
+//# sourceMappingURL=retention.tokens.js.map

package/dist/retention/retention.tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention.tokens.js","sourceRoot":"","sources":["../../src/retention/retention.tokens.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAA"}

package/dist/retention/retention.types.d.ts

@@ -0,0 +1,26 @@
+import type { ActionLogRetention, HistoryRetention } from '@modern-admin/core';
+import type { JobsOptions } from 'bullmq';
+export interface PrunableStore<TRetention> {
+    prune(retention: TRetention): Promise<number>;
+}
+export interface HistoryRetentionTarget extends HistoryRetention {
+    store: PrunableStore<HistoryRetention>;
+}
+export interface AuditLogRetentionTarget extends ActionLogRetention {
+    store: PrunableStore<ActionLogRetention>;
+}
+export interface RetentionModuleOptions {
+    /** BullMQ cron expression. Defaults to every day at 03:00 UTC. */
+    cron?: string;
+    /** Revision-history retention. `keepLast` is evaluated per record. */
+    history?: HistoryRetentionTarget;
+    /** Action-log retention. `keepLast` is evaluated globally. */
+    auditLog?: AuditLogRetentionTarget;
+    /** BullMQ options for each scheduled maintenance job. */
+    jobOptions?: Omit<JobsOptions, 'repeat'>;
+}
+export interface RetentionRunResult {
+    history?: number;
+    auditLog?: number;
+}
+//# sourceMappingURL=retention.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retention.types.d.ts","sourceRoot":"","sources":["../../src/retention/retention.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AAEzC,MAAM,WAAW,aAAa,CAAC,UAAU;IACvC,KAAK,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CAC9C;AAED,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB;IAC9D,KAAK,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAA;CACvC;AAED,MAAM,WAAW,uBAAwB,SAAQ,kBAAkB;IACjE,KAAK,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAA;CACzC;AAED,MAAM,WAAW,sBAAsB;IACrC,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,sEAAsE;IACtE,OAAO,CAAC,EAAE,sBAAsB,CAAA;IAChC,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,uBAAuB,CAAA;IAClC,yDAAyD;IACzD,UAAU,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;CACzC;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB"}

package/dist/retention/retention.types.js

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

package/dist/retention/retention.types.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modern-admin/queue",
-  "version": "0.6.0",
+  "version": "0.9.0",
   "description": "BullMQ-based queue + cron module for Modern Admin (NestJS).",
   "homepage": "https://github.com/modern-admin/modern-admin/tree/main/packages/queue#readme",
   "keywords": [
@@ -44,6 +44,9 @@
       }
     }
   },
+  "dependencies": {
+    "@modern-admin/core": "^0.9.0"
+  },
   "devDependencies": {
     "@modern-admin/tsconfig": "0.4.0",
     "@nestjs/bullmq": "^11.0.5",

package/src/cron/cron.constants.ts

@@ -1,4 +1,4 @@
-export const CRON_QUEUE = 'ma:cron'
+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

package/src/cron/cron.processor.ts

@@ -7,7 +7,7 @@ import {
   DEFAULT_CRON_LOCK_TTL,
   DEFAULT_CRON_WORKER_CONCURRENCY,
 } from './cron.constants.js'
-import type { CronService } from './cron.service.js'
+import { CronService } from './cron.service.js'
 
 @Processor(CRON_QUEUE, { concurrency: DEFAULT_CRON_WORKER_CONCURRENCY })
 export class CronProcessor extends WorkerHost {

package/src/index.ts

@@ -17,3 +17,16 @@ export {
   type CronHandler,
   type CronTaskDefinition,
 } from './cron'
+
+export {
+  RetentionModule,
+  RetentionService,
+  RETENTION_OPTIONS,
+  DEFAULT_RETENTION_CRON,
+  SYSTEM_RETENTION_TASK,
+  type AuditLogRetentionTarget,
+  type HistoryRetentionTarget,
+  type PrunableStore,
+  type RetentionModuleOptions,
+  type RetentionRunResult,
+} from './retention'

package/src/queue.module.ts

@@ -2,6 +2,10 @@ import { type DynamicModule, Module } from '@nestjs/common'
 import { BullModule } from '@nestjs/bullmq'
 import type { QueueModuleOptions, QueueRootOptions } from './queue.types.js'
 
+export const normalizeQueueConnection = (
+  connection: QueueRootOptions['connection'],
+): object => typeof connection === 'string' ? { url: connection } : connection
+
 /**
  * BullMQ integration module for modern-admin NestJS applications.
  *
@@ -30,7 +34,7 @@ export class QueueModule {
       global: true,
       imports: [
         BullModule.forRoot({
-          connection: options.connection as object,
+          connection: normalizeQueueConnection(options.connection),
           defaultJobOptions: options.defaultJobOptions,
         }),
       ],
@@ -65,7 +69,7 @@ export class QueueModule {
           useFactory: async (...args: unknown[]) => {
             const resolved = await opts.useFactory(...args)
             return {
-              connection: resolved.connection as object,
+              connection: normalizeQueueConnection(resolved.connection),
               defaultJobOptions: resolved.defaultJobOptions,
             }
           },

package/src/retention/index.ts

@@ -0,0 +1,11 @@
+export { RetentionModule } from './retention.module.js'
+export { RetentionService } from './retention.service.js'
+export { RETENTION_OPTIONS } from './retention.tokens.js'
+export { DEFAULT_RETENTION_CRON, SYSTEM_RETENTION_TASK } from './retention.constants.js'
+export type {
+  AuditLogRetentionTarget,
+  HistoryRetentionTarget,
+  PrunableStore,
+  RetentionModuleOptions,
+  RetentionRunResult,
+} from './retention.types.js'

package/src/retention/retention.constants.ts

@@ -0,0 +1,2 @@
+export const SYSTEM_RETENTION_TASK = 'ma:system-retention'
+export const DEFAULT_RETENTION_CRON = '0 3 * * *'

package/src/retention/retention.module.ts

@@ -0,0 +1,42 @@
+import { type DynamicModule, Module } from '@nestjs/common'
+import { CronModule } from '../cron/cron.module.js'
+import { RetentionService } from './retention.service.js'
+import { RETENTION_OPTIONS } from './retention.tokens.js'
+import type { RetentionModuleOptions } from './retention.types.js'
+
+const assertBound = (name: string, value: number | undefined): void => {
+  if (value === undefined) return
+  if (!Number.isFinite(value) || !Number.isInteger(value) || value < 0) {
+    throw new Error(`${name} must be a non-negative integer`)
+  }
+}
+
+const validateOptions = (options: RetentionModuleOptions): void => {
+  if (options.cron !== undefined && options.cron.trim().length === 0) {
+    throw new Error('retention cron must not be empty')
+  }
+  assertBound('history.keepLast', options.history?.keepLast)
+  assertBound('history.keepDays', options.history?.keepDays)
+  assertBound('auditLog.keepLast', options.auditLog?.keepLast)
+  assertBound('auditLog.keepDays', options.auditLog?.keepDays)
+}
+
+/**
+ * Schedules history and action-log pruning as a durable BullMQ cron task.
+ * Requires `QueueModule.forRoot()` in the host application's root module.
+ */
+@Module({})
+export class RetentionModule {
+  static forRoot(options: RetentionModuleOptions): DynamicModule {
+    validateOptions(options)
+    return {
+      module: RetentionModule,
+      imports: [CronModule],
+      providers: [
+        { provide: RETENTION_OPTIONS, useValue: options },
+        RetentionService,
+      ],
+      exports: [RetentionService],
+    }
+  }
+}

package/src/retention/retention.service.ts

@@ -0,0 +1,91 @@
+import { Inject, Injectable, type OnModuleInit } from '@nestjs/common'
+import type { ActionLogRetention, HistoryRetention } from '@modern-admin/core'
+import { CronService } from '../cron/cron.service.js'
+import { DEFAULT_RETENTION_CRON, SYSTEM_RETENTION_TASK } from './retention.constants.js'
+import { RETENTION_OPTIONS } from './retention.tokens.js'
+import type {
+  AuditLogRetentionTarget,
+  HistoryRetentionTarget,
+  RetentionModuleOptions,
+  RetentionRunResult,
+} from './retention.types.js'
+
+const hasBounds = (retention: { keepLast?: number; keepDays?: number }): boolean =>
+  retention.keepLast !== undefined || retention.keepDays !== undefined
+
+@Injectable()
+export class RetentionService implements OnModuleInit {
+  constructor(
+    @Inject(RETENTION_OPTIONS) private readonly options: RetentionModuleOptions,
+    private readonly cron: CronService,
+  ) {}
+
+  onModuleInit(): void {
+    if (!this.hasWork()) return
+
+    this.cron.register({
+      name: SYSTEM_RETENTION_TASK,
+      cron: this.options.cron ?? DEFAULT_RETENTION_CRON,
+      skipIfRunning: true,
+      opts: {
+        attempts: 3,
+        backoff: { type: 'exponential', delay: 1_000 },
+        ...this.options.jobOptions,
+      },
+      handler: () => this.run(),
+    })
+  }
+
+  /** Execute every configured retention target. Called by the BullMQ worker. */
+  async run(): Promise<RetentionRunResult> {
+    const result: RetentionRunResult = {}
+    const failures: unknown[] = []
+
+    if (this.options.history && hasBounds(this.options.history)) {
+      try {
+        result.history = await this.pruneHistory(this.options.history)
+      } catch (err: unknown) {
+        failures.push(err)
+      }
+    }
+    if (this.options.auditLog && hasBounds(this.options.auditLog)) {
+      try {
+        result.auditLog = await this.pruneAuditLog(this.options.auditLog)
+      } catch (err: unknown) {
+        failures.push(err)
+      }
+    }
+
+    if (failures.length === 1) {
+      throw failures[0]
+    }
+    if (failures.length > 1) {
+      throw new AggregateError(failures, 'Multiple retention targets failed')
+    }
+
+    return result
+  }
+
+  private hasWork(): boolean {
+    return Boolean(
+      (this.options.history && hasBounds(this.options.history))
+      || (this.options.auditLog && hasBounds(this.options.auditLog)),
+    )
+  }
+
+  private pruneHistory(target: HistoryRetentionTarget): Promise<number> {
+    const retention: HistoryRetention = {
+      ...(target.keepLast !== undefined ? { keepLast: target.keepLast } : {}),
+      ...(target.keepDays !== undefined ? { keepDays: target.keepDays } : {}),
+    }
+    return target.store.prune(retention)
+  }
+
+  private pruneAuditLog(target: AuditLogRetentionTarget): Promise<number> {
+    const retention: ActionLogRetention = {
+      ...(target.keepLast !== undefined ? { keepLast: target.keepLast } : {}),
+      ...(target.keepDays !== undefined ? { keepDays: target.keepDays } : {}),
+    }
+    return target.store.prune(retention)
+  }
+}

package/src/retention/retention.tokens.ts

@@ -0,0 +1 @@
+export const RETENTION_OPTIONS = Symbol.for('@modern-admin/queue:RetentionOptions')

package/src/retention/retention.types.ts

@@ -0,0 +1,30 @@
+import type { ActionLogRetention, HistoryRetention } from '@modern-admin/core'
+import type { JobsOptions } from 'bullmq'
+
+export interface PrunableStore<TRetention> {
+  prune(retention: TRetention): Promise<number>
+}
+
+export interface HistoryRetentionTarget extends HistoryRetention {
+  store: PrunableStore<HistoryRetention>
+}
+
+export interface AuditLogRetentionTarget extends ActionLogRetention {
+  store: PrunableStore<ActionLogRetention>
+}
+
+export interface RetentionModuleOptions {
+  /** BullMQ cron expression. Defaults to every day at 03:00 UTC. */
+  cron?: string
+  /** Revision-history retention. `keepLast` is evaluated per record. */
+  history?: HistoryRetentionTarget
+  /** Action-log retention. `keepLast` is evaluated globally. */
+  auditLog?: AuditLogRetentionTarget
+  /** BullMQ options for each scheduled maintenance job. */
+  jobOptions?: Omit<JobsOptions, 'repeat'>
+}
+
+export interface RetentionRunResult {
+  history?: number
+  auditLog?: number
+}