@spinajs/queue 2.0.481 → 2.0.484

package/lib/cjs/interfaces.js

@@ -12,7 +12,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.QueueClient = exports.QueueJob = exports.QueueEvent = exports.QueueMessage = exports.QueueService = exports.QueueMessageType = void 0;
+exports.JobRetentionService = exports.QueueClient = exports.QueueJob = exports.QueueEvent = exports.QueueMessage = exports.QueueService = exports.QueueMessageType = void 0;
 exports.isJob = isJob;
 const di_1 = require("@spinajs/di");
 const luxon_1 = require("luxon");
@@ -27,7 +27,7 @@ var QueueMessageType;
 class QueueService extends di_1.AsyncService {
     getConnectionsForMessage(event) {
         const eventName = (event.Name ?? event.name);
-        const option = this.Configuration.routing[eventName] ?? this.Configuration.default;
+        const option = (this.Configuration.routing ?? {})[eventName] ?? this.Configuration.default;
         if (lodash_1.default.isString(option)) {
             return [this.Configuration.default];
         }
@@ -40,7 +40,7 @@ class QueueService extends di_1.AsyncService {
             }));
         }
         else {
-            return [option.connection];
+            return [option.connection ?? this.Configuration.default];
         }
     }
 }
@@ -95,20 +95,27 @@ class QueueEvent extends QueueMessage {
     }
 }
 exports.QueueEvent = QueueEvent;
-/**
- * Jobs are executed only once even if multiple listeners waiting for it. usually used for single method call
- * or time consuming tasks, that need to checked for result and tracked
- *
- * Job results are preserved
- */
 class QueueJob extends QueueMessage {
     constructor() {
         super();
         this.Type = QueueMessageType.Job;
     }
+    /**
+     * Called by the consumer after a failed execute(); isFinal=true when the job was marked dead.
+     * Must not throw - errors are logged and swallowed. Override to react to failures ( e.g. send an
+     * alert on the final attempt ). No-op by default.
+     */
+    async onFailed(_err, _ctx) { }
+    /**
+     * Emit (enqueue) this job. Returns the generated JobId so the caller can track
+     * the job's progress / status (e.g. via queue-http-progress `:jobId/status`).
+     */
     static async emit(val, options) {
         const queue = await di_1.DI.resolve(QueueService);
         const message = {
+            // jobs must not be lost by default - persist unless the caller opts out.
+            // ( val / options below can still override this )
+            Persistent: true,
             ...val,
             Type: QueueMessageType.Job,
             CreatedAt: val.CreatedAt ?? luxon_1.DateTime.now(),
@@ -116,7 +123,7 @@ class QueueJob extends QueueMessage {
             ...options,
         };
         // partial of queue job always is queue message
-        await queue.emit(message);
+        return queue.emit(message);
     }
 }
 exports.QueueJob = QueueJob;
@@ -134,6 +141,30 @@ class QueueClient extends di_1.AsyncService {
     __checkInstance__(creationOptions) {
         return this.Options.name === creationOptions[0].name;
     }
+    /**
+     *
+     * Gets dead-letter channel for message from routing table or connection default if non is set.
+     * Used by transports to redirect messages that failed processing so they don't block the queue.
+     *
+     * @param event - event/job to check
+     * @returns the dead-letter channel, or undefined if none is configured
+     */
+    getDeadLetterChannelForMessage(event) {
+        const eName = event.Name ?? event.name ?? event.constructor.name;
+        const rOption = this.Routing?.[eName];
+        // a single route option may carry its own dead-letter channel
+        if (rOption && !lodash_1.default.isString(rOption) && !lodash_1.default.isArray(rOption) && rOption.deadLetterChannel) {
+            return rOption.deadLetterChannel;
+        }
+        // multiple routes - use the first one that declares a dead-letter channel
+        if (lodash_1.default.isArray(rOption)) {
+            const withDlq = rOption.find((x) => !lodash_1.default.isString(x) && x.deadLetterChannel);
+            if (withDlq) {
+                return withDlq.deadLetterChannel;
+            }
+        }
+        return this.Options.defaultQueueDeadLetterChannel;
+    }
     /**
      *
      * Gets event channel from routing table or default if non is set
@@ -144,7 +175,7 @@ class QueueClient extends di_1.AsyncService {
         const options = Reflect.getMetadata('queue:options', event);
         const eName = event.Name ?? event.name ?? event.constructor.name;
         const isJob = event.Type ? event.Type === QueueMessageType.Job : options ? options.type === 'job' : false;
-        const rOption = this.Routing[eName];
+        const rOption = this.Routing?.[eName];
         if (!rOption) {
             this.Log.warn(`No routing for event ${eName} found, using default channel`);
             return [isJob ? this.Options.defaultQueueChannel : this.Options.defaultTopicChannel];
@@ -172,4 +203,21 @@ __decorate([
     (0, configuration_1.Config)('queue.routing'),
     __metadata("design:type", Object)
 ], QueueClient.prototype, "Routing", void 0);
+/**
+ * Runs the periodic cleanup of tracked jobs ( {@link JobModel} rows ) so the table doesn't grow
+ * unbounded. The concrete implementation is selected by config ( `queue.retention.service` ) and
+ * injected into the {@link QueueService} via {@link AutoinjectService}. Because it is an
+ * {@link AsyncService}, DI runs `resolve()` on injection ( where the periodic purge is started )
+ * and `dispose()` on teardown ( where it is stopped ).
+ */
+class JobRetentionService extends di_1.AsyncService {
+    constructor(Options) {
+        super();
+        this.Options = Options;
+    }
+    get ServiceName() {
+        return this.Options.service;
+    }
+}
+exports.JobRetentionService = JobRetentionService;
 //# sourceMappingURL=interfaces.js.map

package/lib/cjs/interfaces.js.map

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

package/lib/cjs/migrations/Queue_2026_06_30_00_00_00.d.ts

@@ -0,0 +1,10 @@
+import { OrmMigration, OrmDriver } from '@spinajs/orm';
+/**
+ * Adds the `Attempt` column to `queue_jobs` so failed job runs can be counted
+ * and jobs can be marked `retrying` / `dead` once they exceed their RetryCount.
+ */
+export declare class Queue_2026_06_30_00_00_00 extends OrmMigration {
+    up(connection: OrmDriver): Promise<void>;
+    down(_connection: OrmDriver): Promise<void>;
+}
+//# sourceMappingURL=Queue_2026_06_30_00_00_00.d.ts.map

package/lib/cjs/migrations/Queue_2026_06_30_00_00_00.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Queue_2026_06_30_00_00_00.d.ts","sourceRoot":"","sources":["../../../src/migrations/Queue_2026_06_30_00_00_00.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAa,MAAM,cAAc,CAAC;AAElE;;;GAGG;AACH,qBACa,yBAA0B,SAAQ,YAAY;IAC5C,EAAE,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAOxC,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;CACzD"}

package/lib/cjs/migrations/Queue_2026_06_30_00_00_00.js

@@ -0,0 +1,29 @@
+"use strict";
+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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Queue_2026_06_30_00_00_00 = void 0;
+/* eslint-disable @typescript-eslint/no-unused-vars */
+const orm_1 = require("@spinajs/orm");
+/**
+ * Adds the `Attempt` column to `queue_jobs` so failed job runs can be counted
+ * and jobs can be marked `retrying` / `dead` once they exceed their RetryCount.
+ */
+let Queue_2026_06_30_00_00_00 = class Queue_2026_06_30_00_00_00 extends orm_1.OrmMigration {
+    async up(connection) {
+        await connection.schema().alterTable('queue_jobs', (table) => {
+            table.int('Attempt').notNull().default().value(0);
+        });
+    }
+    // eslint-disable-next-line @typescript-eslint/no-empty-function
+    async down(_connection) { }
+};
+exports.Queue_2026_06_30_00_00_00 = Queue_2026_06_30_00_00_00;
+exports.Queue_2026_06_30_00_00_00 = Queue_2026_06_30_00_00_00 = __decorate([
+    (0, orm_1.Migration)('queue')
+], Queue_2026_06_30_00_00_00);
+//# sourceMappingURL=Queue_2026_06_30_00_00_00.js.map

package/lib/cjs/migrations/Queue_2026_06_30_00_00_00.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Queue_2026_06_30_00_00_00.js","sourceRoot":"","sources":["../../../src/migrations/Queue_2026_06_30_00_00_00.ts"],"names":[],"mappings":";;;;;;;;;AAAA,sDAAsD;AACtD,sCAAkE;AAElE;;;GAGG;AAEI,IAAM,yBAAyB,GAA/B,MAAM,yBAA0B,SAAQ,kBAAY;IAClD,KAAK,CAAC,EAAE,CAAC,UAAqB;QACnC,MAAM,UAAU,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE;YAC3D,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,gEAAgE;IACzD,KAAK,CAAC,IAAI,CAAC,WAAsB,IAAkB,CAAC;CAC5D,CAAA;AATY,8DAAyB;oCAAzB,yBAAyB;IADrC,IAAA,eAAS,EAAC,OAAO,CAAC;GACN,yBAAyB,CASrC"}

package/lib/cjs/migrations/Queue_2026_07_02_00_00_00.d.ts

@@ -0,0 +1,14 @@
+import { OrmMigration, OrmDriver } from '@spinajs/orm';
+/**
+ * Hardens the `queue_jobs` schema:
+ *  - adds LastError ( errors no longer stuffed into Result ), MaxAttempts and UpdatedAt
+ *  - converts Status from a fixed ENUM to a plain string so `retrying` / `dead` ( and future
+ *    statuses ) are valid on all dialects ( the ENUM previously rejected them on MySQL/MSSQL )
+ *  - widens the too-small Name and Result columns
+ *  - indexes (Status, CreatedAt) to support retention purge and monitoring queries
+ */
+export declare class Queue_2026_07_02_00_00_00 extends OrmMigration {
+    up(connection: OrmDriver): Promise<void>;
+    down(_connection: OrmDriver): Promise<void>;
+}
+//# sourceMappingURL=Queue_2026_07_02_00_00_00.d.ts.map

package/lib/cjs/migrations/Queue_2026_07_02_00_00_00.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Queue_2026_07_02_00_00_00.d.ts","sourceRoot":"","sources":["../../../src/migrations/Queue_2026_07_02_00_00_00.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAa,MAAM,cAAc,CAAC;AAElE;;;;;;;GAOG;AACH,qBACa,yBAA0B,SAAQ,YAAY;IAC5C,EAAE,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BxC,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;CACzD"}

package/lib/cjs/migrations/Queue_2026_07_02_00_00_00.js

@@ -0,0 +1,53 @@
+"use strict";
+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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Queue_2026_07_02_00_00_00 = void 0;
+/* eslint-disable @typescript-eslint/no-unused-vars */
+const orm_1 = require("@spinajs/orm");
+/**
+ * Hardens the `queue_jobs` schema:
+ *  - adds LastError ( errors no longer stuffed into Result ), MaxAttempts and UpdatedAt
+ *  - converts Status from a fixed ENUM to a plain string so `retrying` / `dead` ( and future
+ *    statuses ) are valid on all dialects ( the ENUM previously rejected them on MySQL/MSSQL )
+ *  - widens the too-small Name and Result columns
+ *  - indexes (Status, CreatedAt) to support retention purge and monitoring queries
+ */
+let Queue_2026_07_02_00_00_00 = class Queue_2026_07_02_00_00_00 extends orm_1.OrmMigration {
+    async up(connection) {
+        // additive columns work on every dialect
+        await connection.schema().alterTable('queue_jobs', (table) => {
+            table.string('LastError', 1024);
+            table.int('MaxAttempts').notNull().default().value(0);
+            table.timestamp('UpdatedAt');
+        });
+        // sqlite stores TEXT regardless of declared type/length and has no MODIFY COLUMN, so the
+        // conversions below are only needed ( and only valid ) on dialects that enforce column types.
+        const isSqlite = connection.Options.Driver.toLowerCase().includes('sqlite');
+        if (!isSqlite) {
+            await connection.schema().alterTable('queue_jobs', (table) => {
+                // MySQL's MODIFY COLUMN replaces the whole definition and silently drops anything
+                // omitted, so the 'created' default must be restated or it is lost. `.default().value()`
+                // returns the ColumnQueryBuilder (no `.modify()`), so `.modify()` is called separately
+                // on the column builder itself ( mirrors the pattern in Queue_2026_07_17 ).
+                const status = table.string('Status', 32).notNull();
+                status.default().value('created');
+                status.modify();
+                table.string('Name', 256).notNull().modify();
+                table.text('Result').modify();
+            });
+        }
+        await connection.index().table('queue_jobs').name('queue_jobs_status_created').columns(['Status', 'CreatedAt']);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-empty-function
+    async down(_connection) { }
+};
+exports.Queue_2026_07_02_00_00_00 = Queue_2026_07_02_00_00_00;
+exports.Queue_2026_07_02_00_00_00 = Queue_2026_07_02_00_00_00 = __decorate([
+    (0, orm_1.Migration)('queue')
+], Queue_2026_07_02_00_00_00);
+//# sourceMappingURL=Queue_2026_07_02_00_00_00.js.map

package/lib/cjs/migrations/Queue_2026_07_02_00_00_00.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Queue_2026_07_02_00_00_00.js","sourceRoot":"","sources":["../../../src/migrations/Queue_2026_07_02_00_00_00.ts"],"names":[],"mappings":";;;;;;;;;AAAA,sDAAsD;AACtD,sCAAkE;AAElE;;;;;;;GAOG;AAEI,IAAM,yBAAyB,GAA/B,MAAM,yBAA0B,SAAQ,kBAAY;IAClD,KAAK,CAAC,EAAE,CAAC,UAAqB;QACnC,yCAAyC;QACzC,MAAM,UAAU,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE;YAC3D,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;YAChC,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACtD,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,yFAAyF;QACzF,8FAA8F;QAC9F,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC5E,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,UAAU,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE;gBAC3D,kFAAkF;gBAClF,yFAAyF;gBACzF,uFAAuF;gBACvF,4EAA4E;gBAC5E,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;gBACpD,MAAM,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;gBAClC,MAAM,CAAC,MAAM,EAAE,CAAC;gBAChB,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC;gBAC7C,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC;YAChC,CAAC,CAAC,CAAC;QACL,CAAC;QAED,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;IAClH,CAAC;IAED,gEAAgE;IACzD,KAAK,CAAC,IAAI,CAAC,WAAsB,IAAkB,CAAC;CAC5D,CAAA;AA/BY,8DAAyB;oCAAzB,yBAAyB;IADrC,IAAA,eAAS,EAAC,OAAO,CAAC;GACN,yBAAyB,CA+BrC"}

package/lib/cjs/migrations/Queue_2026_07_10_00_00_00.d.ts

@@ -0,0 +1,10 @@
+import { OrmMigration, OrmDriver } from '@spinajs/orm';
+/**
+ * Adds nullable `Phase` and `Message` columns to `queue_jobs` so jobs can report
+ * richer progress (a phase label and message) alongside the numeric percentage.
+ */
+export declare class Queue_2026_07_10_00_00_00 extends OrmMigration {
+    up(connection: OrmDriver): Promise<void>;
+    down(_connection: OrmDriver): Promise<void>;
+}
+//# sourceMappingURL=Queue_2026_07_10_00_00_00.d.ts.map

package/lib/cjs/migrations/Queue_2026_07_10_00_00_00.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Queue_2026_07_10_00_00_00.d.ts","sourceRoot":"","sources":["../../../src/migrations/Queue_2026_07_10_00_00_00.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAa,MAAM,cAAc,CAAC;AAElE;;;GAGG;AACH,qBACa,yBAA0B,SAAQ,YAAY;IAC5C,EAAE,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IASxC,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;CACzD"}

package/lib/cjs/migrations/Queue_2026_07_10_00_00_00.js

@@ -0,0 +1,31 @@
+"use strict";
+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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Queue_2026_07_10_00_00_00 = void 0;
+/* eslint-disable @typescript-eslint/no-unused-vars */
+const orm_1 = require("@spinajs/orm");
+/**
+ * Adds nullable `Phase` and `Message` columns to `queue_jobs` so jobs can report
+ * richer progress (a phase label and message) alongside the numeric percentage.
+ */
+let Queue_2026_07_10_00_00_00 = class Queue_2026_07_10_00_00_00 extends orm_1.OrmMigration {
+    async up(connection) {
+        await connection.schema().alterTable('queue_jobs', (table) => {
+            // nullable by default (no notNull) - only set by jobs that report richer progress
+            table.string('Phase', 32);
+            table.string('Message', 512);
+        });
+    }
+    // eslint-disable-next-line @typescript-eslint/no-empty-function
+    async down(_connection) { }
+};
+exports.Queue_2026_07_10_00_00_00 = Queue_2026_07_10_00_00_00;
+exports.Queue_2026_07_10_00_00_00 = Queue_2026_07_10_00_00_00 = __decorate([
+    (0, orm_1.Migration)('queue')
+], Queue_2026_07_10_00_00_00);
+//# sourceMappingURL=Queue_2026_07_10_00_00_00.js.map

package/lib/cjs/migrations/Queue_2026_07_10_00_00_00.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Queue_2026_07_10_00_00_00.js","sourceRoot":"","sources":["../../../src/migrations/Queue_2026_07_10_00_00_00.ts"],"names":[],"mappings":";;;;;;;;;AAAA,sDAAsD;AACtD,sCAAkE;AAElE;;;GAGG;AAEI,IAAM,yBAAyB,GAA/B,MAAM,yBAA0B,SAAQ,kBAAY;IAClD,KAAK,CAAC,EAAE,CAAC,UAAqB;QACnC,MAAM,UAAU,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE;YAC3D,kFAAkF;YAClF,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAC1B,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;IACL,CAAC;IAED,gEAAgE;IACzD,KAAK,CAAC,IAAI,CAAC,WAAsB,IAAkB,CAAC;CAC5D,CAAA;AAXY,8DAAyB;oCAAzB,yBAAyB;IADrC,IAAA,eAAS,EAAC,OAAO,CAAC;GACN,yBAAyB,CAWrC"}

package/lib/cjs/migrations/Queue_2026_07_17_00_00_00.d.ts

@@ -0,0 +1,16 @@
+import { OrmMigration, OrmDriver } from '@spinajs/orm';
+/**
+ * Widens `queue_jobs.Status` to the six states the code actually writes.
+ * `retrying` / `dead` arrived with retry support (see index.ts) but the enum
+ * was never widened, so strict-enum drivers reject or coerce them.
+ *
+ * NOT NULL and the 'created' default are restated deliberately: MySQL's MODIFY
+ * COLUMN replaces the whole definition and silently drops anything omitted.
+ * On sqlite this alteration is a logged no-op - it renders enum as
+ * unconstrained TEXT, so there is nothing to widen there.
+ */
+export declare class Queue_2026_07_17_00_00_00 extends OrmMigration {
+    up(connection: OrmDriver): Promise<void>;
+    down(_connection: OrmDriver): Promise<void>;
+}
+//# sourceMappingURL=Queue_2026_07_17_00_00_00.d.ts.map

package/lib/cjs/migrations/Queue_2026_07_17_00_00_00.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Queue_2026_07_17_00_00_00.d.ts","sourceRoot":"","sources":["../../../src/migrations/Queue_2026_07_17_00_00_00.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAa,MAAM,cAAc,CAAC;AAElE;;;;;;;;;GASG;AACH,qBACa,yBAA0B,SAAQ,YAAY;IAC5C,EAAE,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBxC,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;CACzD"}

package/lib/cjs/migrations/Queue_2026_07_17_00_00_00.js

@@ -0,0 +1,49 @@
+"use strict";
+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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Queue_2026_07_17_00_00_00 = void 0;
+/* eslint-disable @typescript-eslint/no-unused-vars */
+const orm_1 = require("@spinajs/orm");
+/**
+ * Widens `queue_jobs.Status` to the six states the code actually writes.
+ * `retrying` / `dead` arrived with retry support (see index.ts) but the enum
+ * was never widened, so strict-enum drivers reject or coerce them.
+ *
+ * NOT NULL and the 'created' default are restated deliberately: MySQL's MODIFY
+ * COLUMN replaces the whole definition and silently drops anything omitted.
+ * On sqlite this alteration is a logged no-op - it renders enum as
+ * unconstrained TEXT, so there is nothing to widen there.
+ */
+let Queue_2026_07_17_00_00_00 = class Queue_2026_07_17_00_00_00 extends orm_1.OrmMigration {
+    async up(connection) {
+        // sqlite renders enum as unconstrained TEXT and has no MODIFY COLUMN, so there is
+        // nothing to widen there. Emitting the MODIFY anyway produces a MySQL-flavoured
+        // `ALTER TABLE ... MODIFY ... ENUM(...)` that sqlite rejects, so skip it explicitly
+        // ( mirrors the guard in Queue_2026_07_02, and matches this migration's documented
+        // "no-op on sqlite" contract above ).
+        const isSqlite = connection.Options.Driver.toLowerCase().includes('sqlite');
+        if (isSqlite) {
+            return;
+        }
+        await connection.schema().alterTable('queue_jobs', (table) => {
+            // `.default().value('created')` returns the ColumnQueryBuilder, which has no
+            // `.modify()` - that lives on AlterColumnQueryBuilder. So `.modify()` must be
+            // called on the column builder itself, separately from the default.
+            const status = table.enum('Status', ['error', 'success', 'created', 'executing', 'retrying', 'dead']).notNull();
+            status.default().value('created');
+            status.modify();
+        });
+    }
+    // eslint-disable-next-line @typescript-eslint/no-empty-function
+    async down(_connection) { }
+};
+exports.Queue_2026_07_17_00_00_00 = Queue_2026_07_17_00_00_00;
+exports.Queue_2026_07_17_00_00_00 = Queue_2026_07_17_00_00_00 = __decorate([
+    (0, orm_1.Migration)('queue')
+], Queue_2026_07_17_00_00_00);
+//# sourceMappingURL=Queue_2026_07_17_00_00_00.js.map

package/lib/cjs/migrations/Queue_2026_07_17_00_00_00.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Queue_2026_07_17_00_00_00.js","sourceRoot":"","sources":["../../../src/migrations/Queue_2026_07_17_00_00_00.ts"],"names":[],"mappings":";;;;;;;;;AAAA,sDAAsD;AACtD,sCAAkE;AAElE;;;;;;;;;GASG;AAEI,IAAM,yBAAyB,GAA/B,MAAM,yBAA0B,SAAQ,kBAAY;IAClD,KAAK,CAAC,EAAE,CAAC,UAAqB;QACnC,kFAAkF;QAClF,gFAAgF;QAChF,oFAAoF;QACpF,mFAAmF;QACnF,sCAAsC;QACtC,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC5E,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QAED,MAAM,UAAU,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE;YAC3D,6EAA6E;YAC7E,8EAA8E;YAC9E,oEAAoE;YACpE,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YAChH,MAAM,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YAClC,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,gEAAgE;IACzD,KAAK,CAAC,IAAI,CAAC,WAAsB,IAAkB,CAAC;CAC5D,CAAA;AAxBY,8DAAyB;oCAAzB,yBAAyB;IADrC,IAAA,eAAS,EAAC,OAAO,CAAC;GACN,yBAAyB,CAwBrC"}

package/lib/cjs/models/JobModel.d.ts

@@ -1,18 +1,80 @@
 import { DateTime } from 'luxon';
-import { ModelBase } from '@spinajs/orm';
+import { ModelBase, QueryScope, ISelectQueryBuilder } from '@spinajs/orm';
 /**
- * Base modele for users used by ACL
+ * Possible job lifecycle statuses.
+ * - created:   dispatched, not yet picked up
+ * - executing: currently running
+ * - retrying:  failed, will be retried
+ * - success:   finished ok ( terminal )
+ * - error:     legacy generic failure ( terminal )
+ * - dead:      failed and retries exhausted / dead-lettered ( terminal )
+ */
+export type JobStatus = 'created' | 'executing' | 'retrying' | 'success' | 'error' | 'dead';
+/** Statuses a job can no longer leave - safe to report as done / purge. */
+export declare const JOB_TERMINAL_STATUSES: JobStatus[];
+/** Statuses of jobs still in flight. */
+export declare const JOB_ACTIVE_STATUSES: JobStatus[];
+/**
+ * Reusable query scopes for {@link JobModel}. Available on any JobModel query
+ * ( select / update / destroy ), so callers compose readable, safe queries eg.
  *
+ *   await JobModel.destroy().terminal().olderThan(cutoff);
+ *   await JobModel.query().byJobId(id).first();
+ */
+export declare class JobQueryScopes implements QueryScope {
+    byJobId(this: ISelectQueryBuilder<JobModel[]> & JobQueryScopes, jobId: string): ISelectQueryBuilder<JobModel<unknown>[]> & JobQueryScopes;
+    withStatus(this: ISelectQueryBuilder<JobModel[]> & JobQueryScopes, status: JobStatus | JobStatus[]): ISelectQueryBuilder<JobModel<unknown>[]> & JobQueryScopes;
+    /** Jobs in a terminal state ( success / error / dead ). */
+    terminal(this: ISelectQueryBuilder<JobModel[]> & JobQueryScopes): ISelectQueryBuilder<JobModel<unknown>[]> & JobQueryScopes;
+    /** Jobs still in flight ( created / executing / retrying ). */
+    active(this: ISelectQueryBuilder<JobModel[]> & JobQueryScopes): ISelectQueryBuilder<JobModel<unknown>[]> & JobQueryScopes;
+    /** Jobs created before the given moment ( row age ). */
+    olderThan(this: ISelectQueryBuilder<JobModel[]> & JobQueryScopes, date: DateTime): ISelectQueryBuilder<JobModel<unknown>[]> & JobQueryScopes;
+    /** Jobs finished before the given moment. */
+    finishedBefore(this: ISelectQueryBuilder<JobModel[]> & JobQueryScopes, date: DateTime): ISelectQueryBuilder<JobModel<unknown>[]> & JobQueryScopes;
+}
+/**
+ * Tracks a dispatched job: its status, progress, result / error and timing.
+ * One row per emitted job, keyed by the unique {@link JobModel.JobId}.
  */
-export declare class JobModel<T> extends ModelBase {
+export declare class JobModel<T = unknown> extends ModelBase {
+    static readonly _queryScopes: JobQueryScopes;
     Id: number;
     JobId: string;
     Name: string;
+    /**
+     * The job's successful result. Failures are recorded in {@link JobModel.LastError},
+     * so this holds only the actual output.
+     */
     Result: T;
-    Status: 'error' | 'success' | 'created' | 'executing';
+    Status: JobStatus;
     Progress: number;
+    /**
+     * Optional human-facing progress phase (e.g. `loading`, `rendering`), set by
+     * jobs that report richer progress than a bare percentage. Nullable.
+     */
+    Phase: string;
+    /**
+     * Optional human-facing progress message accompanying {@link Phase}. Nullable.
+     */
+    Message: string;
+    /**
+     * Number of times job execution has been attempted. Incremented on every failed run.
+     * Once it reaches {@link JobModel.MaxAttempts} the job is marked as `dead`.
+     */
+    Attempt: number;
+    /**
+     * Total allowed executions for the job ( RetryCount + 1 ) captured at first receipt.
+     * Lets consumers render `Attempt / MaxAttempts` ( e.g. "attempt 2 of 2" ).
+     */
+    MaxAttempts: number;
+    /**
+     * Last error message when the job failed or was retried. Kept separate from Result.
+     */
+    LastError: string;
     Connection: string;
     CreatedAt: DateTime;
+    UpdatedAt: DateTime;
     ExecutedAt: DateTime;
     FinishedAt: DateTime;
 }

package/lib/cjs/models/JobModel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"JobModel.d.ts","sourceRoot":"","sources":["../../../src/models/JobModel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,SAAS,EAA+D,MAAM,cAAc,CAAC;AAEtG;;;GAGG;AACH,qBAEa,QAAQ,CAAC,CAAC,CAAE,SAAQ,SAAS;IAEjC,EAAE,EAAE,MAAM,CAAC;IAEX,KAAK,EAAE,MAAM,CAAC;IAEd,IAAI,EAAE,MAAM,CAAC;IAGb,MAAM,EAAE,CAAC,CAAC;IAEV,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;IAEtD,QAAQ,EAAE,MAAM,CAAC;IAEjB,UAAU,EAAE,MAAM,CAAC;IAGnB,SAAS,EAAE,QAAQ,CAAC;IAGpB,UAAU,EAAE,QAAQ,CAAC;IAGrB,UAAU,EAAE,QAAQ,CAAC;CAC7B"}
+{"version":3,"file":"JobModel.d.ts","sourceRoot":"","sources":["../../../src/models/JobModel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,SAAS,EAA0E,UAAU,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAElJ;;;;;;;;GAQG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAE5F,2EAA2E;AAC3E,eAAO,MAAM,qBAAqB,EAAE,SAAS,EAAiC,CAAC;AAE/E,wCAAwC;AACxC,eAAO,MAAM,mBAAmB,EAAE,SAAS,EAAyC,CAAC;AAErF;;;;;;GAMG;AACH,qBAAa,cAAe,YAAW,UAAU;IACxC,OAAO,CAAC,IAAI,EAAE,mBAAmB,CAAC,QAAQ,EAAE,CAAC,GAAG,cAAc,EAAE,KAAK,EAAE,MAAM;IAI7E,UAAU,CAAC,IAAI,EAAE,mBAAmB,CAAC,QAAQ,EAAE,CAAC,GAAG,cAAc,EAAE,MAAM,EAAE,SAAS,GAAG,SAAS,EAAE;IAIzG,2DAA2D;IACpD,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC,QAAQ,EAAE,CAAC,GAAG,cAAc;IAItE,+DAA+D;IACxD,MAAM,CAAC,IAAI,EAAE,mBAAmB,CAAC,QAAQ,EAAE,CAAC,GAAG,cAAc;IAIpE,wDAAwD;IACjD,SAAS,CAAC,IAAI,EAAE,mBAAmB,CAAC,QAAQ,EAAE,CAAC,GAAG,cAAc,EAAE,IAAI,EAAE,QAAQ;IAIvF,6CAA6C;IACtC,cAAc,CAAC,IAAI,EAAE,mBAAmB,CAAC,QAAQ,EAAE,CAAC,GAAG,cAAc,EAAE,IAAI,EAAE,QAAQ;CAG7F;AAED;;;GAGG;AACH,qBAEa,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,SAAS;IAClD,gBAAuB,YAAY,EAAE,cAAc,CAAwB;IAGpE,EAAE,EAAE,MAAM,CAAC;IAEX,KAAK,EAAE,MAAM,CAAC;IAEd,IAAI,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IAEI,MAAM,EAAE,CAAC,CAAC;IAEV,MAAM,EAAE,SAAS,CAAC;IAElB,QAAQ,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACI,KAAK,EAAE,MAAM,CAAC;IAErB;;OAEG;IACI,OAAO,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACI,OAAO,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACI,WAAW,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACI,SAAS,EAAE,MAAM,CAAC;IAElB,UAAU,EAAE,MAAM,CAAC;IAGnB,SAAS,EAAE,QAAQ,CAAC;IAGpB,SAAS,EAAE,QAAQ,CAAC;IAGpB,UAAU,EAAE,QAAQ,CAAC;IAGrB,UAAU,EAAE,QAAQ,CAAC;CAC7B"}

package/lib/cjs/models/JobModel.js

@@ -9,16 +9,53 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.JobModel = void 0;
+exports.JobModel = exports.JobQueryScopes = exports.JOB_ACTIVE_STATUSES = exports.JOB_TERMINAL_STATUSES = void 0;
 const luxon_1 = require("luxon");
 const orm_1 = require("@spinajs/orm");
+/** Statuses a job can no longer leave - safe to report as done / purge. */
+exports.JOB_TERMINAL_STATUSES = ['success', 'error', 'dead'];
+/** Statuses of jobs still in flight. */
+exports.JOB_ACTIVE_STATUSES = ['created', 'executing', 'retrying'];
 /**
- * Base modele for users used by ACL
+ * Reusable query scopes for {@link JobModel}. Available on any JobModel query
+ * ( select / update / destroy ), so callers compose readable, safe queries eg.
  *
+ *   await JobModel.destroy().terminal().olderThan(cutoff);
+ *   await JobModel.query().byJobId(id).first();
+ */
+class JobQueryScopes {
+    byJobId(jobId) {
+        return this.where('JobId', jobId);
+    }
+    withStatus(status) {
+        return Array.isArray(status) ? this.whereIn('Status', status) : this.where('Status', status);
+    }
+    /** Jobs in a terminal state ( success / error / dead ). */
+    terminal() {
+        return this.whereIn('Status', exports.JOB_TERMINAL_STATUSES);
+    }
+    /** Jobs still in flight ( created / executing / retrying ). */
+    active() {
+        return this.whereIn('Status', exports.JOB_ACTIVE_STATUSES);
+    }
+    /** Jobs created before the given moment ( row age ). */
+    olderThan(date) {
+        return this.where('CreatedAt', '<', date);
+    }
+    /** Jobs finished before the given moment. */
+    finishedBefore(date) {
+        return this.where('FinishedAt', '<', date);
+    }
+}
+exports.JobQueryScopes = JobQueryScopes;
+/**
+ * Tracks a dispatched job: its status, progress, result / error and timing.
+ * One row per emitted job, keyed by the unique {@link JobModel.JobId}.
  */
 let JobModel = class JobModel extends orm_1.ModelBase {
 };
 exports.JobModel = JobModel;
+JobModel._queryScopes = new JobQueryScopes();
 __decorate([
     (0, orm_1.Primary)(),
     __metadata("design:type", Number)
@@ -31,6 +68,10 @@ __decorate([
     (0, orm_1.CreatedAt)(),
     __metadata("design:type", luxon_1.DateTime)
 ], JobModel.prototype, "CreatedAt", void 0);
+__decorate([
+    (0, orm_1.UpdatedAt)(),
+    __metadata("design:type", luxon_1.DateTime)
+], JobModel.prototype, "UpdatedAt", void 0);
 __decorate([
     (0, orm_1.DateTime)(),
     __metadata("design:type", luxon_1.DateTime)

package/lib/cjs/models/JobModel.js.map

@@ -1 +1 @@
-{"version":3,"file":"JobModel.js","sourceRoot":"","sources":["../../../src/models/JobModel.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,iCAAiC;AACjC,sCAAsG;AAEtG;;;GAGG;AAGI,IAAM,QAAQ,GAAd,MAAM,QAAY,SAAQ,eAAS;CAyBzC,CAAA;AAzBY,4BAAQ;AAEZ;IADN,IAAA,aAAO,GAAE;;oCACQ;AAOX;IADN,IAAA,UAAI,GAAE;;wCACU;AASV;IADN,IAAA,eAAS,GAAE;8BACM,gBAAQ;2CAAC;AAGpB;IADN,IAAA,cAAE,GAAE;8BACc,gBAAQ;4CAAC;AAGrB;IADN,IAAA,cAAE,GAAE;8BACc,gBAAQ;4CAAC;mBAxBjB,QAAQ;IAFpB,IAAA,gBAAU,EAAC,OAAO,CAAC;IACnB,IAAA,WAAK,EAAC,YAAY,CAAC;GACP,QAAQ,CAyBpB"}
+{"version":3,"file":"JobModel.js","sourceRoot":"","sources":["../../../src/models/JobModel.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,iCAAiC;AACjC,sCAAkJ;AAalJ,2EAA2E;AAC9D,QAAA,qBAAqB,GAAgB,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAE/E,wCAAwC;AAC3B,QAAA,mBAAmB,GAAgB,CAAC,SAAS,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;AAErF;;;;;;GAMG;AACH,MAAa,cAAc;IAClB,OAAO,CAAyD,KAAa;QAClF,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;IAEM,UAAU,CAAyD,MAA+B;QACvG,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC/F,CAAC;IAED,2DAA2D;IACpD,QAAQ;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,6BAAqB,CAAC,CAAC;IACvD,CAAC;IAED,+DAA+D;IACxD,MAAM;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,2BAAmB,CAAC,CAAC;IACrD,CAAC;IAED,wDAAwD;IACjD,SAAS,CAAyD,IAAc;QACrF,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED,6CAA6C;IACtC,cAAc,CAAyD,IAAc;QAC1F,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;CACF;AA5BD,wCA4BC;AAED;;;GAGG;AAGI,IAAM,QAAQ,GAAd,MAAM,QAAsB,SAAQ,eAAS;;AAAvC,4BAAQ;AACI,qBAAY,GAAmB,IAAI,cAAc,EAAE,AAAvC,CAAwC;AAGpE;IADN,IAAA,aAAO,GAAE;;oCACQ;AAWX;IADN,IAAA,UAAI,GAAE;;wCACU;AAqCV;IADN,IAAA,eAAS,GAAE;8BACM,gBAAQ;2CAAC;AAGpB;IADN,IAAA,eAAS,GAAE;8BACM,gBAAQ;2CAAC;AAGpB;IADN,IAAA,cAAE,GAAE;8BACc,gBAAQ;4CAAC;AAGrB;IADN,IAAA,cAAE,GAAE;8BACc,gBAAQ;4CAAC;mBA7DjB,QAAQ;IAFpB,IAAA,gBAAU,EAAC,OAAO,CAAC;IACnB,IAAA,WAAK,EAAC,YAAY,CAAC;GACP,QAAQ,CA8DpB"}

package/lib/cjs/services/JobRetentionService.d.ts

@@ -0,0 +1,26 @@
+import { Log } from '@spinajs/log';
+import { DateTime } from 'luxon';
+import { JobRetentionService } from '../interfaces.js';
+/**
+ * Built-in {@link JobRetentionService}. Periodically deletes terminal jobs older than the
+ * configured `maxAge` so the `queue_jobs` table doesn't grow unbounded. All timings / statuses
+ * come from the injected `queue.retention` config block - nothing is hardcoded except the
+ * fallback interval used when none is configured.
+ */
+export declare class DefaultJobRetentionService extends JobRetentionService {
+    protected Log: Log;
+    protected RetentionTimer?: ReturnType<typeof setInterval>;
+    resolve(): Promise<void>;
+    dispose(): Promise<void>;
+    /**
+     * Starts the periodic job-retention purge when configured. No-op if retention is disabled
+     * or no `maxAge` is set.
+     */
+    protected startRetention(): void;
+    /**
+     * Deletes terminal ( or given ) jobs created before `olderThan`. The set is selected with the
+     * JobModel query scopes ( status + date ), then removed by id.
+     */
+    purgeJobs(olderThan: DateTime, statuses?: string[]): Promise<number>;
+}
+//# sourceMappingURL=JobRetentionService.d.ts.map

package/lib/cjs/services/JobRetentionService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobRetentionService.d.ts","sourceRoot":"","sources":["../../../src/services/JobRetentionService.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAU,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAQvD;;;;;GAKG;AACH,qBACa,0BAA2B,SAAQ,mBAAmB;IAEjE,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC;IAEnB,SAAS,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;IAE7C,OAAO;IAIP,OAAO;IAOpB;;;OAGG;IACH,SAAS,CAAC,cAAc;IAyBxB;;;OAGG;IACU,SAAS,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CAclF"}