@orchestr-sh/orchestr 1.7.4 → 1.8.0

package/dist/Queue/Middleware/ThrottlesExceptions.js

@@ -0,0 +1,119 @@
+"use strict";
+/**
+ * ThrottlesExceptions Middleware
+ *
+ * When a job throws too many exceptions within a given time window,
+ * subsequent attempts are delayed to prevent rapid failure loops.
+ *
+ * Mirrors Laravel's Illuminate\Queue\Middleware\ThrottlesExceptions.
+ *
+ * @example
+ * ```typescript
+ * class ProcessPodcast extends Job {
+ *   middleware() {
+ *     return [
+ *       new ThrottlesExceptions(10, 5) // 10 exceptions per 5 minutes
+ *         .backoff(5) // Wait 5 minutes before retrying
+ *     ];
+ *   }
+ * }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ThrottlesExceptions = void 0;
+// In-memory exception tracking
+const exceptionStore = new Map();
+class ThrottlesExceptions {
+    maxExceptions;
+    decayMinutes;
+    /**
+     * The number of minutes to back off for
+     */
+    backoffMinutes = 5;
+    /**
+     * The prefix for the throttle key
+     */
+    keyPrefix = '';
+    /**
+     * Whether to retry the job or delete it when throttled
+     */
+    shouldRetryOnThrottle = true;
+    constructor(
+    /**
+     * The maximum number of exceptions allowed
+     */
+    maxExceptions = 10, 
+    /**
+     * The number of minutes in the decay window
+     */
+    decayMinutes = 10) {
+        this.maxExceptions = maxExceptions;
+        this.decayMinutes = decayMinutes;
+    }
+    async handle(job, next) {
+        const key = this.getKey(job);
+        const now = Math.floor(Date.now() / 1000);
+        // Clean up expired entries
+        const existing = exceptionStore.get(key);
+        if (existing && existing.resetAt <= now) {
+            exceptionStore.delete(key);
+        }
+        const current = exceptionStore.get(key);
+        // Check if throttled
+        if (current && current.count >= this.maxExceptions) {
+            if (this.shouldRetryOnThrottle) {
+                job.release(this.backoffMinutes * 60);
+            }
+            else {
+                job.delete();
+            }
+            return;
+        }
+        try {
+            await next();
+        }
+        catch (error) {
+            // Record the exception
+            if (current) {
+                current.count++;
+            }
+            else {
+                exceptionStore.set(key, {
+                    count: 1,
+                    resetAt: now + (this.decayMinutes * 60),
+                });
+            }
+            throw error;
+        }
+    }
+    /**
+     * Get the throttle key for this job
+     */
+    getKey(job) {
+        const prefix = this.keyPrefix || job.displayName();
+        return `throttle:${prefix}`;
+    }
+    /**
+     * Set the number of minutes to back off for when throttled
+     */
+    backoff(minutes) {
+        this.backoffMinutes = minutes;
+        return this;
+    }
+    /**
+     * Set a custom key prefix
+     */
+    by(key) {
+        this.keyPrefix = key;
+        return this;
+    }
+    /**
+     * Indicate the job should NOT be retried when throttled
+     */
+    dontRetry() {
+        this.shouldRetryOnThrottle = false;
+        return this;
+    }
+}
+exports.ThrottlesExceptions = ThrottlesExceptions;
+//# sourceMappingURL=ThrottlesExceptions.js.map

package/dist/Queue/Middleware/ThrottlesExceptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThrottlesExceptions.js","sourceRoot":"","sources":["../../../src/Queue/Middleware/ThrottlesExceptions.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;AAKH,+BAA+B;AAC/B,MAAM,cAAc,GAAoD,IAAI,GAAG,EAAE,CAAC;AAElF,MAAa,mBAAmB;IAoBlB;IAKA;IAxBZ;;OAEG;IACO,cAAc,GAAW,CAAC,CAAC;IAErC;;OAEG;IACO,SAAS,GAAW,EAAE,CAAC;IAEjC;;OAEG;IACO,qBAAqB,GAAY,IAAI,CAAC;IAEhD;IACE;;OAEG;IACO,gBAAwB,EAAE;IAEpC;;OAEG;IACO,eAAuB,EAAE;QALzB,kBAAa,GAAb,aAAa,CAAa;QAK1B,iBAAY,GAAZ,YAAY,CAAa;IAClC,CAAC;IAEJ,KAAK,CAAC,MAAM,CAAC,GAAQ,EAAE,IAAyB;QAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAE1C,2BAA2B;QAC3B,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,QAAQ,IAAI,QAAQ,CAAC,OAAO,IAAI,GAAG,EAAE,CAAC;YACxC,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;QAED,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAExC,qBAAqB;QACrB,IAAI,OAAO,IAAI,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACnD,IAAI,IAAI,CAAC,qBAAqB,EAAE,CAAC;gBAC/B,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC,CAAC;YACxC,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,MAAM,EAAE,CAAC;YACf,CAAC;YACD,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,EAAE,CAAC;QACf,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,uBAAuB;YACvB,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,CAAC;iBAAM,CAAC;gBACN,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE;oBACtB,KAAK,EAAE,CAAC;oBACR,OAAO,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC;iBACxC,CAAC,CAAC;YACL,CAAC;YAED,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACO,MAAM,CAAC,GAAQ;QACvB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;QACnD,OAAO,YAAY,MAAM,EAAE,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,OAAe;QACrB,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,EAAE,CAAC,GAAW;QACZ,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,SAAS;QACP,IAAI,CAAC,qBAAqB,GAAG,KAAK,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAlGD,kDAkGC"}

package/dist/Queue/Middleware/WithoutOverlapping.d.ts

@@ -0,0 +1,64 @@
+/**
+ * WithoutOverlapping Middleware
+ *
+ * Prevents a job from running if another instance with the same
+ * key is currently being processed.
+ *
+ * Mirrors Laravel's Illuminate\Queue\Middleware\WithoutOverlapping.
+ *
+ * @example
+ * ```typescript
+ * class UpdateSearchIndex extends Job {
+ *   middleware() {
+ *     return [new WithoutOverlapping(this.productId)];
+ *   }
+ * }
+ * ```
+ */
+import type { Job } from '../Job';
+import type { JobMiddleware } from './JobMiddleware';
+export declare class WithoutOverlapping implements JobMiddleware {
+    /**
+     * The lock key to prevent overlapping
+     */
+    protected key: string | number;
+    /**
+     * The prefix for the lock key
+     */
+    protected prefix: string;
+    /**
+     * The number of seconds to release the job for if locked
+     */
+    protected releaseAfterSeconds: number;
+    /**
+     * The number of seconds the lock should be held
+     */
+    protected lockExpiresAfter: number;
+    /**
+     * Whether to skip the job entirely if locked (vs releasing back to queue)
+     */
+    protected shouldDontRelease: boolean;
+    constructor(
+    /**
+     * The lock key to prevent overlapping
+     */
+    key: string | number, 
+    /**
+     * The prefix for the lock key
+     */
+    prefix?: string);
+    handle(job: Job, next: () => Promise<void>): Promise<void>;
+    /**
+     * Set the number of seconds to release the job for if locked
+     */
+    releaseAfter(seconds: number): this;
+    /**
+     * Set the lock expiration time in seconds
+     */
+    expireAfter(seconds: number): this;
+    /**
+     * Indicate the job should be deleted if locked (instead of released)
+     */
+    dontRelease(): this;
+}
+//# sourceMappingURL=WithoutOverlapping.d.ts.map

package/dist/Queue/Middleware/WithoutOverlapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WithoutOverlapping.d.ts","sourceRoot":"","sources":["../../../src/Queue/Middleware/WithoutOverlapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAKrD,qBAAa,kBAAmB,YAAW,aAAa;IAiBpD;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAE9B;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM;IAxB1B;;OAEG;IACH,SAAS,CAAC,mBAAmB,EAAE,MAAM,CAAK;IAE1C;;OAEG;IACH,SAAS,CAAC,gBAAgB,EAAE,MAAM,CAAK;IAEvC;;OAEG;IACH,SAAS,CAAC,iBAAiB,EAAE,OAAO,CAAS;;IAG3C;;OAEG;IACO,GAAG,EAAE,MAAM,GAAG,MAAM;IAE9B;;OAEG;IACO,MAAM,GAAE,MAAmB;IAGjC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAmChE;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKnC;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKlC;;OAEG;IACH,WAAW,IAAI,IAAI;CAIpB"}

package/dist/Queue/Middleware/WithoutOverlapping.js

@@ -0,0 +1,103 @@
+"use strict";
+/**
+ * WithoutOverlapping Middleware
+ *
+ * Prevents a job from running if another instance with the same
+ * key is currently being processed.
+ *
+ * Mirrors Laravel's Illuminate\Queue\Middleware\WithoutOverlapping.
+ *
+ * @example
+ * ```typescript
+ * class UpdateSearchIndex extends Job {
+ *   middleware() {
+ *     return [new WithoutOverlapping(this.productId)];
+ *   }
+ * }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WithoutOverlapping = void 0;
+// Simple in-memory lock store
+const lockStore = new Map();
+class WithoutOverlapping {
+    key;
+    prefix;
+    /**
+     * The number of seconds to release the job for if locked
+     */
+    releaseAfterSeconds = 0;
+    /**
+     * The number of seconds the lock should be held
+     */
+    lockExpiresAfter = 0;
+    /**
+     * Whether to skip the job entirely if locked (vs releasing back to queue)
+     */
+    shouldDontRelease = false;
+    constructor(
+    /**
+     * The lock key to prevent overlapping
+     */
+    key, 
+    /**
+     * The prefix for the lock key
+     */
+    prefix = 'overlap:') {
+        this.key = key;
+        this.prefix = prefix;
+    }
+    async handle(job, next) {
+        const lockKey = `${this.prefix}${this.key}`;
+        const now = Math.floor(Date.now() / 1000);
+        // Clean up expired locks
+        const existing = lockStore.get(lockKey);
+        if (existing && existing.expiresAt > 0 && existing.expiresAt <= now) {
+            lockStore.delete(lockKey);
+        }
+        // Check if locked
+        if (lockStore.has(lockKey)) {
+            if (this.shouldDontRelease) {
+                // Skip the job entirely
+                job.delete();
+                return;
+            }
+            // Release back onto the queue
+            job.release(this.releaseAfterSeconds || 5);
+            return;
+        }
+        // Acquire lock
+        const expiresAt = this.lockExpiresAfter > 0 ? now + this.lockExpiresAfter : 0;
+        lockStore.set(lockKey, { expiresAt });
+        try {
+            await next();
+        }
+        finally {
+            // Release lock
+            lockStore.delete(lockKey);
+        }
+    }
+    /**
+     * Set the number of seconds to release the job for if locked
+     */
+    releaseAfter(seconds) {
+        this.releaseAfterSeconds = seconds;
+        return this;
+    }
+    /**
+     * Set the lock expiration time in seconds
+     */
+    expireAfter(seconds) {
+        this.lockExpiresAfter = seconds;
+        return this;
+    }
+    /**
+     * Indicate the job should be deleted if locked (instead of released)
+     */
+    dontRelease() {
+        this.shouldDontRelease = true;
+        return this;
+    }
+}
+exports.WithoutOverlapping = WithoutOverlapping;
+//# sourceMappingURL=WithoutOverlapping.js.map

package/dist/Queue/Middleware/WithoutOverlapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WithoutOverlapping.js","sourceRoot":"","sources":["../../../src/Queue/Middleware/WithoutOverlapping.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;;AAKH,8BAA8B;AAC9B,MAAM,SAAS,GAAuC,IAAI,GAAG,EAAE,CAAC;AAEhE,MAAa,kBAAkB;IAoBjB;IAKA;IAxBZ;;OAEG;IACO,mBAAmB,GAAW,CAAC,CAAC;IAE1C;;OAEG;IACO,gBAAgB,GAAW,CAAC,CAAC;IAEvC;;OAEG;IACO,iBAAiB,GAAY,KAAK,CAAC;IAE7C;IACE;;OAEG;IACO,GAAoB;IAE9B;;OAEG;IACO,SAAiB,UAAU;QAL3B,QAAG,GAAH,GAAG,CAAiB;QAKpB,WAAM,GAAN,MAAM,CAAqB;IACpC,CAAC;IAEJ,KAAK,CAAC,MAAM,CAAC,GAAQ,EAAE,IAAyB;QAC9C,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAE1C,yBAAyB;QACzB,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,QAAQ,IAAI,QAAQ,CAAC,SAAS,GAAG,CAAC,IAAI,QAAQ,CAAC,SAAS,IAAI,GAAG,EAAE,CAAC;YACpE,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC;QAED,kBAAkB;QAClB,IAAI,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBAC3B,wBAAwB;gBACxB,GAAG,CAAC,MAAM,EAAE,CAAC;gBACb,OAAO;YACT,CAAC;YAED,8BAA8B;YAC9B,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,IAAI,CAAC,CAAC,CAAC;YAC3C,OAAO;QACT,CAAC;QAED,eAAe;QACf,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9E,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QAEtC,IAAI,CAAC;YACH,MAAM,IAAI,EAAE,CAAC;QACf,CAAC;gBAAS,CAAC;YACT,eAAe;YACf,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,OAAe;QAC1B,IAAI,CAAC,mBAAmB,GAAG,OAAO,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,OAAe;QACzB,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,WAAW;QACT,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAtFD,gDAsFC"}

package/dist/Queue/Middleware/index.d.ts

@@ -0,0 +1,5 @@
+export type { JobMiddleware } from './JobMiddleware';
+export { RateLimited } from './RateLimited';
+export { WithoutOverlapping } from './WithoutOverlapping';
+export { ThrottlesExceptions } from './ThrottlesExceptions';
+//# sourceMappingURL=index.d.ts.map

package/dist/Queue/Middleware/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/Queue/Middleware/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/Queue/Middleware/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ThrottlesExceptions = exports.WithoutOverlapping = exports.RateLimited = void 0;
+var RateLimited_1 = require("./RateLimited");
+Object.defineProperty(exports, "RateLimited", { enumerable: true, get: function () { return RateLimited_1.RateLimited; } });
+var WithoutOverlapping_1 = require("./WithoutOverlapping");
+Object.defineProperty(exports, "WithoutOverlapping", { enumerable: true, get: function () { return WithoutOverlapping_1.WithoutOverlapping; } });
+var ThrottlesExceptions_1 = require("./ThrottlesExceptions");
+Object.defineProperty(exports, "ThrottlesExceptions", { enumerable: true, get: function () { return ThrottlesExceptions_1.ThrottlesExceptions; } });
+//# sourceMappingURL=index.js.map

package/dist/Queue/Middleware/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/Queue/Middleware/index.ts"],"names":[],"mappings":";;;AACA,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AACpB,2DAA0D;AAAjD,wHAAA,kBAAkB,OAAA;AAC3B,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA"}

package/dist/Queue/PendingChain.d.ts

@@ -0,0 +1,63 @@
+/**
+ * PendingChain
+ *
+ * Fluent builder for chaining multiple jobs together.
+ * Jobs in a chain are executed sequentially - if one fails,
+ * the remaining jobs in the chain are not executed.
+ *
+ * Mirrors Laravel's Illuminate\Foundation\Bus\PendingChain.
+ *
+ * @example
+ * ```typescript
+ * await Bus.chain([
+ *   new ProcessPodcast(id),
+ *   new OptimizePodcast(id),
+ *   new ReleasePodcast(id),
+ * ])
+ *   .onConnection('redis')
+ *   .onQueue('processing')
+ *   .catch((error) => console.error('Chain failed:', error))
+ *   .dispatch();
+ * ```
+ */
+import type { Job } from './Job';
+import type { QueueManager } from './QueueManager';
+export declare class PendingChain {
+    protected manager: QueueManager;
+    protected jobs: Job[];
+    protected _connection?: string;
+    protected _queue?: string;
+    protected _delay?: number | Date;
+    protected _catchCallback?: (error: Error) => void | Promise<void>;
+    protected _finallyCallback?: () => void | Promise<void>;
+    constructor(manager: QueueManager, jobs: Job[]);
+    /**
+     * Set the connection for all jobs in the chain
+     */
+    onConnection(connection: string): this;
+    /**
+     * Set the queue for all jobs in the chain
+     */
+    onQueue(queue: string): this;
+    /**
+     * Set the delay before the first job starts
+     */
+    delay(delay: number | Date): this;
+    /**
+     * Set a callback to execute if any job in the chain fails
+     */
+    catch(callback: (error: Error) => void | Promise<void>): this;
+    /**
+     * Set a callback to execute when the chain completes (success or failure)
+     */
+    finally(callback: () => void | Promise<void>): this;
+    /**
+     * Dispatch the chain
+     *
+     * The first job is dispatched immediately. Each subsequent job
+     * stores the remaining chain and dispatches the next job upon
+     * successful completion.
+     */
+    dispatch(): Promise<string>;
+}
+//# sourceMappingURL=PendingChain.d.ts.map

package/dist/Queue/PendingChain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PendingChain.d.ts","sourceRoot":"","sources":["../../src/Queue/PendingChain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,qBAAa,YAAY;IAQrB,SAAS,CAAC,OAAO,EAAE,YAAY;IAC/B,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE;IARvB,SAAS,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC/B,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,SAAS,CAAC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,SAAS,CAAC,gBAAgB,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;gBAG5C,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,GAAG,EAAE;IAGvB;;OAEG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAKtC;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK5B;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAKjC;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAK7D;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAKnD;;;;;;OAMG;IACG,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;CAkClC"}

package/dist/Queue/PendingChain.js

@@ -0,0 +1,111 @@
+"use strict";
+/**
+ * PendingChain
+ *
+ * Fluent builder for chaining multiple jobs together.
+ * Jobs in a chain are executed sequentially - if one fails,
+ * the remaining jobs in the chain are not executed.
+ *
+ * Mirrors Laravel's Illuminate\Foundation\Bus\PendingChain.
+ *
+ * @example
+ * ```typescript
+ * await Bus.chain([
+ *   new ProcessPodcast(id),
+ *   new OptimizePodcast(id),
+ *   new ReleasePodcast(id),
+ * ])
+ *   .onConnection('redis')
+ *   .onQueue('processing')
+ *   .catch((error) => console.error('Chain failed:', error))
+ *   .dispatch();
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PendingChain = void 0;
+class PendingChain {
+    manager;
+    jobs;
+    _connection;
+    _queue;
+    _delay;
+    _catchCallback;
+    _finallyCallback;
+    constructor(manager, jobs) {
+        this.manager = manager;
+        this.jobs = jobs;
+    }
+    /**
+     * Set the connection for all jobs in the chain
+     */
+    onConnection(connection) {
+        this._connection = connection;
+        return this;
+    }
+    /**
+     * Set the queue for all jobs in the chain
+     */
+    onQueue(queue) {
+        this._queue = queue;
+        return this;
+    }
+    /**
+     * Set the delay before the first job starts
+     */
+    delay(delay) {
+        this._delay = delay;
+        return this;
+    }
+    /**
+     * Set a callback to execute if any job in the chain fails
+     */
+    catch(callback) {
+        this._catchCallback = callback;
+        return this;
+    }
+    /**
+     * Set a callback to execute when the chain completes (success or failure)
+     */
+    finally(callback) {
+        this._finallyCallback = callback;
+        return this;
+    }
+    /**
+     * Dispatch the chain
+     *
+     * The first job is dispatched immediately. Each subsequent job
+     * stores the remaining chain and dispatches the next job upon
+     * successful completion.
+     */
+    async dispatch() {
+        if (this.jobs.length === 0) {
+            throw new Error('Cannot dispatch an empty chain.');
+        }
+        // Apply connection/queue to all jobs
+        for (const job of this.jobs) {
+            if (this._connection) {
+                job.connection = this._connection;
+            }
+            if (this._queue) {
+                job.queue = this._queue;
+            }
+        }
+        // Store chain metadata on the first job
+        const firstJob = this.jobs[0];
+        const remainingJobs = this.jobs.slice(1);
+        // Store chain info as serializable data
+        firstJob._chainJobs = remainingJobs.map((j) => ({
+            class: j.constructor.name,
+            data: j.toJSON(),
+        }));
+        firstJob._chainCatch = this._catchCallback;
+        firstJob._chainFinally = this._finallyCallback;
+        // Apply delay to first job only
+        if (this._delay) {
+            firstJob.delay = this._delay;
+        }
+        return this.manager.dispatch(firstJob);
+    }
+}
+exports.PendingChain = PendingChain;
+//# sourceMappingURL=PendingChain.js.map

package/dist/Queue/PendingChain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PendingChain.js","sourceRoot":"","sources":["../../src/Queue/PendingChain.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;AAKH,MAAa,YAAY;IAQX;IACA;IARF,WAAW,CAAU;IACrB,MAAM,CAAU;IAChB,MAAM,CAAiB;IACvB,cAAc,CAA0C;IACxD,gBAAgB,CAA8B;IAExD,YACY,OAAqB,EACrB,IAAW;QADX,YAAO,GAAP,OAAO,CAAc;QACrB,SAAI,GAAJ,IAAI,CAAO;IACpB,CAAC;IAEJ;;OAEG;IACH,YAAY,CAAC,UAAkB;QAC7B,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,KAAa;QACnB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAoB;QACxB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAgD;QACpD,IAAI,CAAC,cAAc,GAAG,QAAQ,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,QAAoC;QAC1C,IAAI,CAAC,gBAAgB,GAAG,QAAQ,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,QAAQ;QACZ,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;QAED,qCAAqC;QACrC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBACrB,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC;YACpC,CAAC;YACD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,wCAAwC;QACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAEzC,wCAAwC;QACvC,QAAgB,CAAC,UAAU,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACvD,KAAK,EAAE,CAAC,CAAC,WAAW,CAAC,IAAI;YACzB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;SACjB,CAAC,CAAC,CAAC;QACH,QAAgB,CAAC,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC;QACnD,QAAgB,CAAC,aAAa,GAAG,IAAI,CAAC,gBAAgB,CAAC;QAExD,gCAAgC;QAChC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QAC/B,CAAC;QAED,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;CACF;AA7FD,oCA6FC"}

package/dist/Queue/PendingDispatch.d.ts

@@ -0,0 +1,66 @@
+/**
+ * PendingDispatch
+ *
+ * Provides a fluent interface for configuring job dispatch.
+ * Mirrors Laravel's Illuminate\Foundation\Bus\PendingDispatch.
+ *
+ * @example
+ * ```typescript
+ * await ProcessPodcast.dispatch(podcastId)
+ *   .onConnection('redis')
+ *   .onQueue('processing')
+ *   .delay(60);
+ *
+ * // The dispatch happens when the PendingDispatch is awaited
+ * // or when .dispatch() is explicitly called
+ * ```
+ */
+import type { Job } from './Job';
+import type { QueueManager } from './QueueManager';
+export declare class PendingDispatch implements PromiseLike<string> {
+    protected manager: QueueManager;
+    protected job: Job;
+    protected _afterCommit: boolean;
+    constructor(manager: QueueManager, job: Job);
+    /**
+     * Set the desired connection for the job
+     */
+    onConnection(connection: string): this;
+    /**
+     * Set the desired queue for the job
+     */
+    onQueue(queue: string): this;
+    /**
+     * Set the delay for the job
+     */
+    delay(delay: number | Date): this;
+    /**
+     * Set the number of times the job may be attempted
+     */
+    tries(tries: number): this;
+    /**
+     * Set the timeout for the job
+     */
+    timeout(timeout: number): this;
+    /**
+     * Set the backoff strategy for the job
+     */
+    backoff(backoff: number | number[]): this;
+    /**
+     * Indicate that the job should be dispatched after all DB transactions commit
+     */
+    afterCommit(): this;
+    /**
+     * Indicate that the job should not wait for DB transactions
+     */
+    beforeCommit(): this;
+    /**
+     * Dispatch the job to the queue
+     */
+    dispatch(): Promise<string>;
+    /**
+     * PromiseLike implementation - allows `await ProcessPodcast.dispatch(id)`
+     */
+    then<TResult1 = string, TResult2 = never>(onfulfilled?: ((value: string) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | null): PromiseLike<TResult1 | TResult2>;
+}
+//# sourceMappingURL=PendingDispatch.d.ts.map

package/dist/Queue/PendingDispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PendingDispatch.d.ts","sourceRoot":"","sources":["../../src/Queue/PendingDispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,qBAAa,eAAgB,YAAW,WAAW,CAAC,MAAM,CAAC;IAIvD,SAAS,CAAC,OAAO,EAAE,YAAY;IAC/B,SAAS,CAAC,GAAG,EAAE,GAAG;IAJpB,SAAS,CAAC,YAAY,EAAE,OAAO,CAAS;gBAG5B,OAAO,EAAE,YAAY,EACrB,GAAG,EAAE,GAAG;IAGpB;;OAEG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAKtC;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK5B;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAKjC;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK1B;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK9B;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAKzC;;OAEG;IACH,WAAW,IAAI,IAAI;IAMnB;;OAEG;IACH,YAAY,IAAI,IAAI;IAMpB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;IAIjC;;OAEG;IACH,IAAI,CAAC,QAAQ,GAAG,MAAM,EAAE,QAAQ,GAAG,KAAK,EACtC,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,EAC1E,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,GACtE,WAAW,CAAC,QAAQ,GAAG,QAAQ,CAAC;CAGpC"}

package/dist/Queue/PendingDispatch.js

@@ -0,0 +1,101 @@
+"use strict";
+/**
+ * PendingDispatch
+ *
+ * Provides a fluent interface for configuring job dispatch.
+ * Mirrors Laravel's Illuminate\Foundation\Bus\PendingDispatch.
+ *
+ * @example
+ * ```typescript
+ * await ProcessPodcast.dispatch(podcastId)
+ *   .onConnection('redis')
+ *   .onQueue('processing')
+ *   .delay(60);
+ *
+ * // The dispatch happens when the PendingDispatch is awaited
+ * // or when .dispatch() is explicitly called
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PendingDispatch = void 0;
+class PendingDispatch {
+    manager;
+    job;
+    _afterCommit = false;
+    constructor(manager, job) {
+        this.manager = manager;
+        this.job = job;
+    }
+    /**
+     * Set the desired connection for the job
+     */
+    onConnection(connection) {
+        this.job.connection = connection;
+        return this;
+    }
+    /**
+     * Set the desired queue for the job
+     */
+    onQueue(queue) {
+        this.job.queue = queue;
+        return this;
+    }
+    /**
+     * Set the delay for the job
+     */
+    delay(delay) {
+        this.job.delay = delay;
+        return this;
+    }
+    /**
+     * Set the number of times the job may be attempted
+     */
+    tries(tries) {
+        this.job.tries = tries;
+        return this;
+    }
+    /**
+     * Set the timeout for the job
+     */
+    timeout(timeout) {
+        this.job.timeout = timeout;
+        return this;
+    }
+    /**
+     * Set the backoff strategy for the job
+     */
+    backoff(backoff) {
+        this.job.backoff = backoff;
+        return this;
+    }
+    /**
+     * Indicate that the job should be dispatched after all DB transactions commit
+     */
+    afterCommit() {
+        this._afterCommit = true;
+        this.job.afterCommit = true;
+        return this;
+    }
+    /**
+     * Indicate that the job should not wait for DB transactions
+     */
+    beforeCommit() {
+        this._afterCommit = false;
+        this.job.afterCommit = false;
+        return this;
+    }
+    /**
+     * Dispatch the job to the queue
+     */
+    async dispatch() {
+        return this.manager.dispatch(this.job);
+    }
+    /**
+     * PromiseLike implementation - allows `await ProcessPodcast.dispatch(id)`
+     */
+    then(onfulfilled, onrejected) {
+        return this.dispatch().then(onfulfilled, onrejected);
+    }
+}
+exports.PendingDispatch = PendingDispatch;
+//# sourceMappingURL=PendingDispatch.js.map