@spinajs/queue 2.0.481 → 2.0.484

package/lib/cjs/config/queue.d.ts

@@ -5,6 +5,16 @@ declare const queue: {
             name: string;
             service: string;
         }[];
+        deduplicate: boolean;
+        retention: {
+            service: string;
+            enabled: boolean;
+            interval: number;
+        };
+        progress: {
+            minDelta: number;
+            minInterval: number;
+        };
     };
 };
 export default queue;

package/lib/cjs/config/queue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../../src/config/queue.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,KAAK;;;;;;;;CAaV,CAAC;AAEF,eAAe,KAAK,CAAC"}
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../../src/config/queue.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,KAAK;;;;;;;;;;;;;;;;;;CAqCV,CAAC;AAEF,eAAe,KAAK,CAAC"}

package/lib/cjs/config/queue.js

@@ -12,6 +12,27 @@ const queue = {
                 service: 'BlackHoleQueueClient',
             },
         ],
+        // Skip re-executing a job whose tracking row ( queue_jobs ) is already terminal
+        // ( success / error / dead ). Messaging is at-least-once, so duplicates happen on
+        // consumer crash and broker failover - dedup keeps jobs idempotent. Defaults to true.
+        deduplicate: true,
+        // Periodic cleanup of tracked jobs ( queue_jobs rows ). The `service` selects the
+        // JobRetentionService implementation; swap it to plug in a custom purge strategy.
+        // Disabled by default - set `enabled: true` and a `maxAge` ( ms ) to opt in.
+        retention: {
+            service: 'DefaultJobRetentionService',
+            enabled: false,
+            interval: 60 * 60 * 1000, // how often ( ms ) to run the purge
+            // maxAge: 7 * 24 * 60 * 60 * 1000, // delete terminal jobs older than this ( ms )
+            // statuses: ['success', 'error', 'dead'], // which statuses to purge
+        },
+        // Throttle job progress persistence so a chatty job doesn't write to the DB on every
+        // callback. A non-final, meta-less progress update is skipped unless it moved at least
+        // `minDelta` % or `minInterval` ms have passed since the last persisted write.
+        progress: {
+            minDelta: 5, // minimum progress delta ( % ) between throttled writes
+            minInterval: 1000, // minimum time ( ms ) between throttled writes
+        },
     },
 };
 exports.default = queue;

package/lib/cjs/config/queue.js.map

@@ -1 +1 @@
-{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../../src/config/queue.ts"],"names":[],"mappings":";;AAAA,MAAM,KAAK,GAAG;IACZ,KAAK,EAAE;QACL,kDAAkD;QAClD,gEAAgE;QAChE,sEAAsE;QACtE,OAAO,EAAE,YAAY;QACrB,WAAW,EAAE;YACX;gBACE,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,sBAAsB;aAChC;SACF;KACF;CACF,CAAC;AAEF,kBAAe,KAAK,CAAC"}
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../../src/config/queue.ts"],"names":[],"mappings":";;AAAA,MAAM,KAAK,GAAG;IACZ,KAAK,EAAE;QACL,kDAAkD;QAClD,gEAAgE;QAChE,sEAAsE;QACtE,OAAO,EAAE,YAAY;QACrB,WAAW,EAAE;YACX;gBACE,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,sBAAsB;aAChC;SACF;QAED,gFAAgF;QAChF,kFAAkF;QAClF,sFAAsF;QACtF,WAAW,EAAE,IAAI;QAEjB,kFAAkF;QAClF,kFAAkF;QAClF,6EAA6E;QAC7E,SAAS,EAAE;YACT,OAAO,EAAE,4BAA4B;YACrC,OAAO,EAAE,KAAK;YACd,QAAQ,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,oCAAoC;YAC9D,kFAAkF;YAClF,qEAAqE;SACtE;QAED,qFAAqF;QACrF,uFAAuF;QACvF,+EAA+E;QAC/E,QAAQ,EAAE;YACR,QAAQ,EAAE,CAAC,EAAE,wDAAwD;YACrE,WAAW,EAAE,IAAI,EAAE,+CAA+C;SACnE;KACF;CACF,CAAC;AAEF,kBAAe,KAAK,CAAC"}

package/lib/cjs/decorators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/decorators.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAE3B;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,GAAG,KACT,QAAQ,GAAG,UAWpB;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,IAClC,QAAQ,GAAG,UAYpB"}
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/decorators.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,GAAG,KACT,QAAQ,GAAG,UAWpB;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,IAClC,QAAQ,GAAG,UAYpB"}

package/lib/cjs/decorators.js.map

@@ -1 +1 @@
-{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../src/decorators.ts"],"names":[],"mappings":";;AAcA,kBAYC;AAOD,sBAaC;AAtCD;;;;;GAKG;AACH,SAAgB,GAAG;IACjB,OAAO,CAAC,MAAW,EAAE,EAAE;QACrB,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,MAAM,CAAC,EAAE,CAAC;YAClD,OAAO,CAAC,cAAc,CACpB,eAAe,EACf;gBACE,IAAI,EAAE,KAAK;aACZ,EACD,MAAM,CACP,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAgB,KAAK,CAAC,OAAsB;IAC1C,OAAO,CAAC,MAAW,EAAE,EAAE;QACrB,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,MAAM,CAAC,EAAE,CAAC;YAClD,OAAO,CAAC,cAAc,CACpB,eAAe,EACf;gBACE,GAAG,OAAO;gBACV,IAAI,EAAE,OAAO;aACd,EACD,MAAM,CACP,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../src/decorators.ts"],"names":[],"mappings":";;AAaA,kBAYC;AAOD,sBAaC;AAtCD;;;;;GAKG;AACH,SAAgB,GAAG;IACjB,OAAO,CAAC,MAAW,EAAE,EAAE;QACrB,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,MAAM,CAAC,EAAE,CAAC;YAClD,OAAO,CAAC,cAAc,CACpB,eAAe,EACf;gBACE,IAAI,EAAE,KAAK;aACZ,EACD,MAAM,CACP,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAgB,KAAK,CAAC,OAAsB;IAC1C,OAAO,CAAC,MAAW,EAAE,EAAE;QACrB,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,MAAM,CAAC,EAAE,CAAC;YAClD,OAAO,CAAC,cAAc,CACpB,eAAe,EACf;gBACE,GAAG,OAAO;gBACV,IAAI,EAAE,OAAO;aACd,EACD,MAAM,CACP,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/lib/cjs/fp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fp.d.ts","sourceRoot":"","sources":["../../src/fp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAgB,MAAM,iBAAiB,CAAC;AAIpF,wBAAgB,GAAG,CAAC,KAAK,EAAE,aAAa,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAKrF"}
+{"version":3,"file":"fp.d.ts","sourceRoot":"","sources":["../../src/fp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAgB,MAAM,iBAAiB,CAAC;AAIpF,wBAAgB,GAAG,CAAC,KAAK,EAAE,aAAa,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAErF"}

package/lib/cjs/fp.js.map

@@ -1 +1 @@
-{"version":3,"file":"fp.js","sourceRoot":"","sources":["../../src/fp.ts"],"names":[],"mappings":";;AAIA,kBAKC;AATD,mDAAoF;AACpF,wCAAuC;AACvC,oCAAuC;AAEvC,SAAgB,GAAG,CAAC,KAA4C;IAC9D,OAAO,GAAG,EAAE,CAAC,IAAA,aAAM,EACjB,IAAA,aAAQ,EAAC,4BAAY,CAAC,EACtB,CAAC,OAAqB,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAC/C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"fp.js","sourceRoot":"","sources":["../../src/fp.ts"],"names":[],"mappings":";;AAIA,kBAEC;AAND,mDAAoF;AACpF,wCAAuC;AACvC,oCAAuC;AAEvC,SAAgB,GAAG,CAAC,KAA4C;IAC9D,OAAO,GAAG,EAAE,CAAC,IAAA,aAAM,EAAC,IAAA,aAAQ,EAAC,4BAAY,CAAC,EAAE,CAAC,OAAqB,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AAC9F,CAAC"}

package/lib/cjs/index.d.ts

@@ -1,17 +1,28 @@
 import { Constructor } from '@spinajs/di';
 import { Log } from '@spinajs/log';
-import { QueueClient, QueueJob, QueueEvent, IQueueMessage, QueueMessage, QueueService } from './interfaces.js';
+import { QueueClient, QueueJob, QueueEvent, IQueueMessage, QueueMessage, QueueService, JobRetentionService } from './interfaces.js';
 export * from './BlackHoleQueueClient.js';
 export * from './interfaces.js';
 export * from './decorators.js';
 export * from './models/JobModel.js';
+export * from './services/JobRetentionService.js';
 export * from './migrations/Queue_2022_10_18_01_13_00.js';
+export * from './migrations/Queue_2026_06_30_00_00_00.js';
+export * from './migrations/Queue_2026_07_02_00_00_00.js';
+export * from './migrations/Queue_2026_07_10_00_00_00.js';
+export * from './migrations/Queue_2026_07_17_00_00_00.js';
 export * from './fp.js';
 export declare class DefaultQueueService extends QueueService {
     protected Log: Log;
     protected Connections: Map<string, QueueClient>;
+    /**
+     * Config-selected retention service that periodically purges old tracked jobs.
+     * Started / stopped by DI on injection / disposal. May be undefined if retention
+     * is not configured.
+     */
+    protected Retention?: JobRetentionService;
     dispose(): Promise<void>;
-    emit(event: IQueueMessage | QueueEvent | QueueJob): Promise<void>;
+    emit(event: IQueueMessage | QueueEvent | QueueJob): Promise<string | undefined>;
     stopConsuming(event: Constructor<QueueMessage>): Promise<void>;
     /**
      *

package/lib/cjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAmC,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,GAAG,EAAU,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAS,MAAM,iBAAiB,CAAC;AAMtH,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2CAA2C,CAAC;AAC1D,cAAc,SAAS,CAAC;AAExB,qBACa,mBAAoB,SAAQ,YAAY;IAEnD,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC;IAGnB,SAAS,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAEnC,OAAO;IAYP,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,UAAU,GAAG,QAAQ;IA6BjD,aAAa,CAAC,KAAK,EAAE,WAAW,CAAC,YAAY,CAAC;IAI3D;;;;;;;;;;;;;;;OAeG;IACU,OAAO,CAAC,CAAC,SAAS,YAAY,EAAE,KAAK,EAAE,WAAW,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;IAuFnK;;;;OAIG;IACI,GAAG,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW;CAG7C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAmC,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,GAAG,EAAU,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAoB,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAS,MAAM,iBAAiB,CAAC;AAM7J,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mCAAmC,CAAC;AAClD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,SAAS,CAAC;AAMxB,qBACa,mBAAoB,SAAQ,YAAY;IAEnD,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC;IAGnB,SAAS,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAEhD;;;;OAIG;IAEH,SAAS,CAAC,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAE7B,OAAO;IAoBP,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAwB/E,aAAa,CAAC,KAAK,EAAE,WAAW,CAAC,YAAY,CAAC;IAI3D;;;;;;;;;;;;;;;OAeG;IACU,OAAO,CAAC,CAAC,SAAS,YAAY,EAAE,KAAK,EAAE,WAAW,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;IAwKnK;;;;OAIG;IACI,GAAG,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW;CAG7C"}

package/lib/cjs/index.js

@@ -36,10 +36,26 @@ __exportStar(require("./BlackHoleQueueClient.js"), exports);
 __exportStar(require("./interfaces.js"), exports);
 __exportStar(require("./decorators.js"), exports);
 __exportStar(require("./models/JobModel.js"), exports);
+__exportStar(require("./services/JobRetentionService.js"), exports);
 __exportStar(require("./migrations/Queue_2022_10_18_01_13_00.js"), exports);
+__exportStar(require("./migrations/Queue_2026_06_30_00_00_00.js"), exports);
+__exportStar(require("./migrations/Queue_2026_07_02_00_00_00.js"), exports);
+__exportStar(require("./migrations/Queue_2026_07_10_00_00_00.js"), exports);
+__exportStar(require("./migrations/Queue_2026_07_17_00_00_00.js"), exports);
 __exportStar(require("./fp.js"), exports);
+/** Fallback progress-throttle values used when `queue.progress` is not configured. */
+const DEFAULT_PROGRESS_MIN_DELTA = 5;
+const DEFAULT_PROGRESS_MIN_INTERVAL_MS = 1000;
 let DefaultQueueService = class DefaultQueueService extends interfaces_js_1.QueueService {
     async dispose() {
+        if (this.Retention) {
+            try {
+                await this.Retention.dispose();
+            }
+            catch (err) {
+                this.Log.error(err, 'Cannot dispose job retention service');
+            }
+        }
         this.Connections.forEach(async (val) => {
             try {
                 await val.dispose();
@@ -52,24 +68,21 @@ let DefaultQueueService = class DefaultQueueService extends interfaces_js_1.Queu
     }
     async emit(event) {
         const connections = this.getConnectionsForMessage(event);
+        let jobId;
         for (let c of connections) {
             const connection = this.Connections.get(c);
             if (!connection) {
                 throw new exceptions_1.ConnectionNotFound(`Queue connection ${c} not found. Please check your configuration before emitting events to this connection.`);
             }
             if ((0, interfaces_js_1.isJob)(event)) {
-                const jModel = new JobModel_js_1.JobModel();
-                jModel.JobId = (0, uuid_1.v4)();
-                jModel.Name = event.Name;
-                jModel.Status = 'created';
-                jModel.Progress = 0;
-                jModel.Connection = c;
-                await jModel.insert();
-                event.JobId = jModel.JobId;
+                event.JobId = event.JobId ?? (0, uuid_1.v4)(); // generate only; consumer writes the row
+                jobId = event.JobId;
             }
             await connection.emit(event);
             this.Log.trace(`Emitted message ${event.Name}, type: ${event.Type} to connection ${c}`);
         }
+        // for jobs this is the id the caller uses to track progress / status
+        return jobId;
     }
     async stopConsuming(event) {
         this.getConnectionsForMessage(event).forEach((c) => this.Connections.get(c).unsubscribe(event));
@@ -116,9 +129,46 @@ let DefaultQueueService = class DefaultQueueService extends interfaces_js_1.Queu
                      */
                     if (ev instanceof interfaces_js_1.QueueJob) {
                         let jobResult = null;
-                        const jModel = await JobModel_js_1.JobModel.where({ JobId: ev.JobId }).firstOrThrow(new exceptions_1.UnexpectedServerError(`No model found for jobId ${ev.JobId}`));
+                        // Consumer owns the tracking row. First receipt inserts; a redelivery finds the
+                        // row from the prior attempt. The queue_jobs.JobId unique index makes a rare
+                        // concurrent double-receipt safe (second insert collides -> re-read).
+                        let jModel = await JobModel_js_1.JobModel.where({ JobId: ev.JobId }).first();
+                        if (!jModel) {
+                            jModel = new JobModel_js_1.JobModel();
+                            jModel.JobId = ev.JobId;
+                            jModel.Name = ev.Name;
+                            jModel.Connection = c;
+                            jModel.Attempt = 0;
+                            jModel.Progress = 0;
+                            // set Status explicitly so tracking never depends on the DB column default,
+                            // which can differ across dialects ( and MySQL MODIFY COLUMN can drop it ).
+                            jModel.Status = 'created';
+                            // capture the dispatch-time attempt ceiling ( retries + 1 ) so it stays authoritative
+                            // across redeliveries and consumers can render Attempt/MaxAttempts consistently.
+                            jModel.MaxAttempts = (ev.RetryCount ?? 0) + 1;
+                            try {
+                                await jModel.insert();
+                            }
+                            catch (e) {
+                                // concurrent first-receipt from another worker won the insert; re-read and continue.
+                                jModel = await JobModel_js_1.JobModel.where({ JobId: ev.JobId }).firstOrThrow(new exceptions_1.UnexpectedServerError(`No model found for jobId ${ev.JobId}`));
+                            }
+                        }
+                        // at-least-once delivery means a job can be redelivered after it already finished
+                        // ( consumer crash before ack, broker failover ). Skip re-running a job whose tracking
+                        // row is already terminal so jobs stay idempotent. Acks without re-execution or rethrow.
+                        if ((this.Configuration?.deduplicate ?? true) && JobModel_js_1.JOB_TERMINAL_STATUSES.includes(jModel.Status)) {
+                            this.Log.info(`Job ${ev.Name}:${ev.JobId} already in terminal state ${jModel.Status}, skipping duplicate delivery`);
+                            return;
+                        }
                         jModel.Status = 'executing';
                         jModel.ExecutedAt = luxon_1.DateTime.now();
+                        // throttle progress persistence: skip writes smaller than the threshold and
+                        // closer together than the min interval, so a chatty job doesn't hammer the DB.
+                        let lastProgress = 0;
+                        let lastProgressAt = 0;
+                        const minProgressDelta = this.Configuration.progress?.minDelta ?? DEFAULT_PROGRESS_MIN_DELTA;
+                        const minProgressInterval = this.Configuration.progress?.minInterval ?? DEFAULT_PROGRESS_MIN_INTERVAL_MS;
                         try {
                             // update executing state
                             await jModel.update();
@@ -131,13 +181,48 @@ let DefaultQueueService = class DefaultQueueService extends interfaces_js_1.Queu
                         }
                         catch (err) {
                             this.Log.error(err, `Cannot execute job ${event.name}`);
-                            jModel.Result = {
-                                message: err.message,
-                            };
-                            jModel.Status = 'error';
+                            // record the failed attempt and mark the job retrying / dead so the
+                            // transport can apply its retry-then-dead-letter policy ( re-thrown below ).
+                            // the error goes to LastError - Result is reserved for the successful output.
+                            jModel.Attempt = (jModel.Attempt ?? 0) + 1;
+                            // derive the retry limit from the dispatch-time ceiling captured on the row so it stays
+                            // authoritative across redeliveries ( a redelivered wire message could carry a different
+                            // RetryCount ). MaxAttempts is retries + 1, so the limit is MaxAttempts - 1.
+                            const maxRetries = jModel.MaxAttempts ? jModel.MaxAttempts - 1 : (ev.RetryCount ?? 0);
+                            jModel.Status = jModel.Attempt > maxRetries ? 'dead' : 'retrying';
+                            jModel.LastError = err instanceof Error ? err.message : String(err);
+                            await jModel.update();
+                            // notify the job of the failed attempt ( e.g. to send an alert on the final one ).
+                            // the hook must never mask the original error, so its own failure is only logged.
+                            try {
+                                await ev.onFailed(err, { attempt: jModel.Attempt, maxAttempts: jModel.MaxAttempts ?? maxRetries + 1, isFinal: jModel.Status === 'dead', jobId: ev.JobId });
+                            }
+                            catch (hookErr) {
+                                this.Log.error(hookErr, `onFailed hook for job ${event.name} threw`);
+                            }
+                            // propagate so the transport sees the failure and can retry / dead-letter.
+                            // ( previously the error was swallowed and the message silently acked )
+                            throw err;
                         }
                         await jModel.update();
-                        async function onProgress(p) {
+                        async function onProgress(p, meta) {
+                            const now = luxon_1.DateTime.now().toMillis();
+                            const isFinal = p >= 100;
+                            const hasMeta = meta?.phase !== undefined || meta?.message !== undefined;
+                            // apply meta eagerly so a phase / message change is never lost to throttling
+                            if (meta?.phase !== undefined) {
+                                jModel.Phase = meta.phase;
+                            }
+                            if (meta?.message !== undefined) {
+                                jModel.Message = meta.message;
+                            }
+                            // always persist the final 100% or a meta change; otherwise throttle by delta + time
+                            if (!isFinal && !hasMeta && p - lastProgress < minProgressDelta && now - lastProgressAt < minProgressInterval) {
+                                jModel.Progress = p;
+                                return;
+                            }
+                            lastProgress = p;
+                            lastProgressAt = now;
                             jModel.Progress = p;
                             await jModel.update();
                             self.Log.trace(`Job ${event.name}:${jModel.JobId} progress: ${p}%`);
@@ -172,6 +257,10 @@ __decorate([
     (0, configuration_1.AutoinjectService)('queue.connections', interfaces_js_1.QueueClient),
     __metadata("design:type", Map)
 ], DefaultQueueService.prototype, "Connections", void 0);
+__decorate([
+    (0, configuration_1.AutoinjectService)('queue.retention', interfaces_js_1.JobRetentionService),
+    __metadata("design:type", interfaces_js_1.JobRetentionService)
+], DefaultQueueService.prototype, "Retention", void 0);
 exports.DefaultQueueService = DefaultQueueService = __decorate([
     (0, di_1.Injectable)(interfaces_js_1.QueueService)
 ], DefaultQueueService);

package/lib/cjs/index.js.map

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

package/lib/cjs/interfaces.d.ts

@@ -34,7 +34,12 @@ export interface IQueueJob extends IQueueMessage {
 }
 export declare abstract class QueueService extends AsyncService {
     protected Configuration: IQueueConfiguration;
-    abstract emit(event: IQueueMessage | QueueEvent | QueueJob): Promise<void>;
+    /**
+     * Emit a message. For jobs the generated JobId is returned so the caller can
+     * correlate the job with its progress/status (e.g. via queue-http-progress).
+     * Returns undefined for non-job messages.
+     */
+    abstract emit(event: IQueueMessage | QueueEvent | QueueJob): Promise<string | undefined>;
     abstract consume<T extends QueueMessage>(event: Constructor<QueueMessage>, callback?: (message: T) => Promise<void>, subscriptionId?: string, durable?: boolean): Promise<void>;
     abstract stopConsuming(event: Constructor<QueueMessage>): Promise<void>;
     abstract get(connection?: string): QueueClient;
@@ -88,6 +93,35 @@ export declare abstract class QueueEvent extends QueueMessage {
  *
  * Job results are preserved
  */
+/**
+ * Optional richer progress metadata a job may report alongside the numeric
+ * percentage - persisted to the job model and exposed by queue-http-progress.
+ */
+export interface IJobProgressMeta {
+    /** Short phase label, e.g. `loading`, `rendering`. */
+    phase?: string;
+    /** Human-facing status message. */
+    message?: string;
+}
+/**
+ * Progress reporter passed to {@link QueueJob.execute}. Call with a 0-100
+ * percentage; the optional `meta` carries a phase label / message. Jobs that
+ * only report a percentage can ignore `meta`.
+ */
+export type JobProgressCallback = (p: number, meta?: IJobProgressMeta) => Promise<void>;
+/**
+ * Context passed to {@link QueueJob.onFailed} describing the failed attempt.
+ */
+export interface IJobFailureContext {
+    /** The attempt number that just failed ( 1-based ). */
+    attempt: number;
+    /** The total allowed executions ( retries + 1 ). */
+    maxAttempts: number;
+    /** True when this failure exhausted the retries and the job was marked dead. */
+    isFinal: boolean;
+    /** The failed job's JobId. */
+    jobId: string;
+}
 export declare abstract class QueueJob extends QueueMessage implements IQueueJob {
     JobId: string;
     /**
@@ -95,8 +129,18 @@ export declare abstract class QueueJob extends QueueMessage implements IQueueJob
      */
     RetryCount: number;
     constructor();
-    abstract execute(progress: (p: number) => Promise<void>): Promise<unknown>;
-    static emit<T extends typeof QueueMessage>(this: T, val: Partial<InstanceType<T>>, options?: IMessageOptions): Promise<void>;
+    abstract execute(progress: JobProgressCallback): Promise<unknown>;
+    /**
+     * 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.
+     */
+    onFailed(_err: unknown, _ctx: IJobFailureContext): Promise<void>;
+    /**
+     * 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 emit<T extends typeof QueueMessage>(this: T, val: Partial<InstanceType<T>>, options?: IMessageOptions): Promise<string | undefined>;
 }
 export declare abstract class QueueClient extends AsyncService implements IInstanceCheck, IMappableService {
     Options: IQueueConnectionOptions;
@@ -108,9 +152,14 @@ export declare abstract class QueueClient extends AsyncService implements IInsta
     __checkInstance__(creationOptions: any): boolean;
     /**
      *
-     * Dispatches event to queue
+     * Dispatches a message to the broker.
      *
-     * @param event - event to dispatch
+     * Delivery-guarantee contract: the returned promise MUST resolve only once the broker has
+     * taken custody of the message ( AMQP publisher confirm / STOMP RECEIPT frame ), so callers
+     * emitting persistent Jobs get an at-least-once guarantee. Fire-and-forget publishing is only
+     * acceptable for non-persistent Events.
+     *
+     * @param event - message to dispatch
      */
     abstract emit(event: IQueueMessage): Promise<void>;
     /**
@@ -128,8 +177,17 @@ export declare abstract class QueueClient extends AsyncService implements IInsta
      * @param durable - is durable event ?
      */
     abstract subscribe(channel: string, callback: (e: IQueueMessage) => Promise<void>, subscriptionId?: string, durable?: boolean): Promise<void>;
-    abstract unsubscribe(event: Constructor<QueueMessage>): void;
-    abstract unsubscribe(channel: string): void;
+    abstract unsubscribe(event: Constructor<QueueMessage>, removeDurable?: boolean): void;
+    abstract unsubscribe(channel: string, removeDurable?: boolean): void;
+    /**
+     *
+     * 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: IQueueMessage | Constructor<QueueMessage>): string | undefined;
     /**
      *
      * Gets event channel from routing table or default if non is set
@@ -154,6 +212,78 @@ export interface IQueueConfiguration {
      */
     routing?: IQueueMessageRoutingOptions;
     connections: IQueueConnectionOptions[];
+    /**
+     * Skip re-executing a job whose {@link JobModel} is already in a terminal state
+     * ( `success` or `dead` ). Messaging is at-least-once, so duplicates happen on
+     * consumer crash and on broker failover - dedup keeps jobs idempotent.
+     *
+     * Defaults to `true`.
+     */
+    deduplicate?: boolean;
+    /**
+     * Automatic cleanup of old tracked jobs ( {@link JobModel} rows ) so the table doesn't
+     * grow unbounded. Disabled by default - opt in to avoid silently deleting data.
+     */
+    retention?: IQueueRetentionOptions;
+    /**
+     * Throttling of job progress persistence, so a chatty job that reports progress
+     * frequently doesn't hammer the DB with a write per callback.
+     */
+    progress?: IQueueProgressOptions;
+}
+export interface IQueueProgressOptions {
+    /**
+     * Minimum progress delta ( % ) between throttled DB writes. Default `5`.
+     */
+    minDelta?: number;
+    /**
+     * Minimum time ( ms ) between throttled DB writes. Default `1000`.
+     */
+    minInterval?: number;
+}
+export interface IQueueRetentionOptions {
+    /**
+     * DI service name of the {@link JobRetentionService} implementation that runs the purge.
+     * Selected via {@link AutoinjectService}; defaults to `DefaultJobRetentionService`.
+     */
+    service: string;
+    /**
+     * Turn the periodic purge on. Default `false`.
+     */
+    enabled?: boolean;
+    /**
+     * Age in milliseconds after which a purged job is deleted ( based on CreatedAt ).
+     */
+    maxAge?: number;
+    /**
+     * Which statuses to purge. Defaults to terminal statuses ( success / error / dead ).
+     */
+    statuses?: string[];
+    /**
+     * How often ( ms ) to run the purge. Default 1 hour.
+     */
+    interval?: number;
+}
+/**
+ * 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 ).
+ */
+export declare abstract class JobRetentionService extends AsyncService implements IMappableService {
+    Options: IQueueRetentionOptions;
+    constructor(Options: IQueueRetentionOptions);
+    get ServiceName(): string;
+    /**
+     * Deletes tracked jobs ( {@link JobModel} rows ) created before `olderThan` in one of `statuses`.
+     * Used by the periodic purge and available for manual cleanup.
+     *
+     * @param olderThan - delete jobs created before this moment
+     * @param statuses - which statuses to purge ( defaults to terminal: success / error / dead )
+     * @returns number of deleted rows
+     */
+    abstract purgeJobs(olderThan: DateTime, statuses?: string[]): Promise<number>;
 }
 export interface IMessageRoutingOption {
     channel?: string;
@@ -190,6 +320,47 @@ export interface IQueueConnectionOptions {
      * and for unblocking source queue
      */
     defaultQueueDeadLetterChannel?: string;
+    /**
+     * Delay in milliseconds before the transport tries to reconnect after a dropped connection.
+     */
+    reconnectDelay?: number;
+    /**
+     * Incoming heartbeat interval in milliseconds ( 0 to disable ).
+     */
+    heartbeatIncoming?: number;
+    /**
+     * Outgoing heartbeat interval in milliseconds ( 0 to disable ).
+     */
+    heartbeatOutgoing?: number;
+    /**
+     * How long ( ms ) to wait for the initial connection before giving up.
+     */
+    connectionTimeout?: number;
+    /**
+     * How long ( ms ) to wait for a broker delivery receipt when emitting a message.
+     */
+    receiptTimeout?: number;
+    /**
+     * Base delay ( ms ) for retry backoff when a job fails and is rescheduled.
+     * Transports may apply exponential backoff based on this value. 0 means retry immediately.
+     */
+    retryDelay?: number;
+    /**
+     * Optional DI service name resolving to an {@link IQueueCredentialsProvider}.
+     * When set, the transport asks it for credentials right before each ( re )connect,
+     * allowing rotating secrets / token based authentication.
+     */
+    credentialProvider?: string;
+}
+/**
+ * Provides connection credentials on demand ( e.g. rotating secrets, short lived tokens ).
+ * Resolved from DI by the name set in {@link IQueueConnectionOptions.credentialProvider}.
+ */
+export interface IQueueCredentialsProvider {
+    getCredentials(options: IQueueConnectionOptions): Promise<{
+        login?: string;
+        passcode?: string;
+    }>;
 }
 export interface IMessageOptions {
     Persistent: boolean;

package/lib/cjs/interfaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../src/interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAM,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC9F,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEjC,OAAO,EAAE,GAAG,EAAU,MAAM,cAAc,CAAC;AAG3C,oBAAY,gBAAgB;IAC1B,GAAG,QAAQ;IACX,KAAK,UAAU;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,QAAQ,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,gBAAgB,CAAC;IAEvB,UAAU,EAAE,OAAO,CAAC;IAEpB,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,SAAU,SAAQ,aAAa;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,8BAAsB,YAAa,SAAQ,YAAY;IAErD,SAAS,CAAC,aAAa,EAAE,mBAAmB,CAAC;aAE7B,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;aACjE,OAAO,CAAC,CAAC,SAAS,YAAY,EAAE,KAAK,EAAE,WAAW,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;aACtK,aAAa,CAAC,KAAK,EAAE,WAAW,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;aAC9D,GAAG,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW;IAErD,SAAS,CAAC,wBAAwB,CAAC,KAAK,EAAE,aAAa,GAAG,WAAW,CAAC,YAAY,CAAC,GAAG,MAAM,EAAE;CAsB/F;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,aAAa,GAAG,KAAK,IAAI,QAAQ,CAE7D;AAED;;GAEG;AACH,8BAAsB,YAAa,YAAW,aAAa;IACzD,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;IAEZ,SAAS,EAAE,QAAQ,CAAC;IAIpB,IAAI,EAAE,MAAM,CAAC;IAEb,IAAI,EAAG,gBAAgB,CAAC;IAExB,UAAU,EAAG,OAAO,CAAC;IAErB,QAAQ,EAAG,MAAM,CAAC;IAEzB;;OAEG;IACI,aAAa,EAAG,MAAM,GAAG,SAAS,CAAC;IAE1C;;OAEG;IACI,cAAc,EAAG,MAAM,GAAG,SAAS,CAAC;IAE3C;;OAEG;IACI,cAAc,EAAG,MAAM,GAAG,SAAS,CAAC;IAE3C;;OAEG;IACI,YAAY,EAAG,MAAM,GAAG,SAAS,CAAC;gBAE7B,IAAI,CAAC,EAAE,GAAG;IASf,OAAO,CAAC,OAAO,EAAE,GAAG;CAG5B;AAED;;;;;;;GAOG;AACH,8BAAsB,UAAW,SAAQ,YAAY;gBACvC,IAAI,CAAC,EAAE,GAAG;WAMF,IAAI,CAAC,CAAC,SAAS,OAAO,YAAY,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CAc1I;AAED;;;;;GAKG;AACH,8BAAsB,QAAS,SAAQ,YAAa,YAAW,SAAS;IAC/D,KAAK,EAAE,MAAM,CAAC;IAErB;;OAEG;IACI,UAAU,EAAE,MAAM,CAAC;;aAQV,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;WAE7D,IAAI,CAAC,CAAC,SAAS,OAAO,YAAY,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CAc1I;AAED,8BAAsB,WAAY,SAAQ,YAAa,YAAW,cAAc,EAAE,gBAAgB;IAe7E,OAAO,EAAE,uBAAuB;IAbnD,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC;IAGnB,SAAS,CAAC,OAAO,EAAE,2BAA2B,CAAC;IAE/C,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,IAAW,WAAW,WAErB;gBAEkB,OAAO,EAAE,uBAAuB;IAI5C,iBAAiB,CAAC,eAAe,EAAE,GAAG,GAAG,OAAO;IAIvD;;;;;OAKG;aACa,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAEzD;;;;OAIG;aACa,SAAS,CAAC,KAAK,EAAE,WAAW,CAAC,YAAY,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAErK;;;;;;;OAOG;aACa,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;aAEpI,WAAW,CAAC,KAAK,EAAE,WAAW,CAAC,YAAY,CAAC,GAAG,IAAI;aACnD,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAElD;;;;;OAKG;IACI,oBAAoB,CAAC,KAAK,EAAE,aAAa,GAAG,WAAW,CAAC,YAAY,CAAC,GAAG,MAAM,EAAE;CA6BxF;AAED,MAAM,WAAW,2BAA2B;IAC1C,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,qBAAqB,GAAG,MAAM,EAAE,GAAG,qBAAqB,EAAE,CAAC;CACpF;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,2BAA2B,CAAC;IACtC,WAAW,EAAE,uBAAuB,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,IAAI,EAAE,OAAO,GAAG,KAAK,CAAC;IAEtB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B;;;;;OAKG;IACH,6BAA6B,CAAC,EAAE,MAAM,CAAC;CACxC;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,OAAO,CAAC;IAEpB,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB"}
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../src/interfaces.ts"],"names":[],"mappings":"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"}