@spinajs/queue 2.0.480 → 2.0.482

package/lib/mjs/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/mjs/interfaces.d.ts.map

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

package/lib/mjs/interfaces.js

@@ -20,7 +20,7 @@ export var QueueMessageType;
 export class QueueService extends 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 (_.isString(option)) {
             return [this.Configuration.default];
         }
@@ -33,7 +33,7 @@ export class QueueService extends AsyncService {
             }));
         }
         else {
-            return [option.connection];
+            return [option.connection ?? this.Configuration.default];
         }
     }
 }
@@ -85,20 +85,27 @@ export class QueueEvent extends QueueMessage {
         await queue.emit(message);
     }
 }
-/**
- * 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
- */
 export 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.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 ?? DateTime.now(),
@@ -106,7 +113,7 @@ export class QueueJob extends QueueMessage {
             ...options,
         };
         // partial of queue job always is queue message
-        await queue.emit(message);
+        return queue.emit(message);
     }
 }
 export class QueueClient extends AsyncService {
@@ -123,6 +130,30 @@ export class QueueClient extends 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 && !_.isString(rOption) && !_.isArray(rOption) && rOption.deadLetterChannel) {
+            return rOption.deadLetterChannel;
+        }
+        // multiple routes - use the first one that declares a dead-letter channel
+        if (_.isArray(rOption)) {
+            const withDlq = rOption.find((x) => !_.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
@@ -133,7 +164,7 @@ export class QueueClient extends 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];
@@ -160,4 +191,20 @@ __decorate([
     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 ).
+ */
+export class JobRetentionService extends AsyncService {
+    constructor(Options) {
+        super();
+        this.Options = Options;
+    }
+    get ServiceName() {
+        return this.Options.service;
+    }
+}
 //# sourceMappingURL=interfaces.js.map

package/lib/mjs/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/mjs/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/mjs/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/mjs/migrations/Queue_2026_06_30_00_00_00.js

@@ -0,0 +1,26 @@
+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;
+};
+/* eslint-disable @typescript-eslint/no-unused-vars */
+import { OrmMigration, Migration } 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.
+ */
+let Queue_2026_06_30_00_00_00 = class Queue_2026_06_30_00_00_00 extends 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) { }
+};
+Queue_2026_06_30_00_00_00 = __decorate([
+    Migration('queue')
+], Queue_2026_06_30_00_00_00);
+export { Queue_2026_06_30_00_00_00 };
+//# sourceMappingURL=Queue_2026_06_30_00_00_00.js.map

package/lib/mjs/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,OAAO,EAAE,YAAY,EAAa,SAAS,EAAE,MAAM,cAAc,CAAC;AAElE;;;GAGG;AAEI,IAAM,yBAAyB,GAA/B,MAAM,yBAA0B,SAAQ,YAAY;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,yBAAyB;IADrC,SAAS,CAAC,OAAO,CAAC;GACN,yBAAyB,CASrC"}

package/lib/mjs/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/mjs/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/mjs/migrations/Queue_2026_07_02_00_00_00.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;
+};
+/* eslint-disable @typescript-eslint/no-unused-vars */
+import { OrmMigration, Migration } 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
+ */
+let Queue_2026_07_02_00_00_00 = class Queue_2026_07_02_00_00_00 extends 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) { }
+};
+Queue_2026_07_02_00_00_00 = __decorate([
+    Migration('queue')
+], Queue_2026_07_02_00_00_00);
+export { Queue_2026_07_02_00_00_00 };
+//# sourceMappingURL=Queue_2026_07_02_00_00_00.js.map

package/lib/mjs/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,OAAO,EAAE,YAAY,EAAa,SAAS,EAAE,MAAM,cAAc,CAAC;AAElE;;;;;;;GAOG;AAEI,IAAM,yBAAyB,GAA/B,MAAM,yBAA0B,SAAQ,YAAY;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,yBAAyB;IADrC,SAAS,CAAC,OAAO,CAAC;GACN,yBAAyB,CA+BrC"}

package/lib/mjs/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/mjs/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/mjs/migrations/Queue_2026_07_10_00_00_00.js

@@ -0,0 +1,28 @@
+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;
+};
+/* eslint-disable @typescript-eslint/no-unused-vars */
+import { OrmMigration, Migration } 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.
+ */
+let Queue_2026_07_10_00_00_00 = class Queue_2026_07_10_00_00_00 extends 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) { }
+};
+Queue_2026_07_10_00_00_00 = __decorate([
+    Migration('queue')
+], Queue_2026_07_10_00_00_00);
+export { Queue_2026_07_10_00_00_00 };
+//# sourceMappingURL=Queue_2026_07_10_00_00_00.js.map

package/lib/mjs/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,OAAO,EAAE,YAAY,EAAa,SAAS,EAAE,MAAM,cAAc,CAAC;AAElE;;;GAGG;AAEI,IAAM,yBAAyB,GAA/B,MAAM,yBAA0B,SAAQ,YAAY;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,yBAAyB;IADrC,SAAS,CAAC,OAAO,CAAC;GACN,yBAAyB,CAWrC"}

package/lib/mjs/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/mjs/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"}