@orchestr-sh/orchestr 1.7.4 → 1.9.1

package/dist/Queue/JobPayload.d.ts

@@ -0,0 +1,37 @@
+/**
+ * JobPayload
+ *
+ * Represents the serialized structure of a job stored in the queue.
+ * This is the format that gets stored in the database/redis/etc.
+ */
+import type { Job } from './Job';
+export interface JobPayloadData {
+    uuid: string;
+    displayName: string;
+    job: string;
+    data: Record<string, any>;
+    maxTries: number | null;
+    maxExceptions: number | null;
+    failOnTimeout: boolean;
+    backoff: number | number[] | null;
+    timeout: number | null;
+    retryUntil: number | null;
+    attempts: number;
+    afterCommit: boolean;
+    pushedAt: string;
+}
+export declare class JobPayload {
+    /**
+     * Create a payload from a job instance
+     */
+    static create(job: Job): JobPayloadData;
+    /**
+     * Serialize a payload to a JSON string
+     */
+    static serialize(payload: JobPayloadData): string;
+    /**
+     * Deserialize a JSON string to a payload
+     */
+    static deserialize(raw: string): JobPayloadData;
+}
+//# sourceMappingURL=JobPayload.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"JobPayload.d.ts","sourceRoot":"","sources":["../../src/Queue/JobPayload.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAEjC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC;IAClC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,UAAU;IACrB;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,cAAc;IAkBvC;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM;IAIjD;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc;CAGhD"}

package/dist/Queue/JobPayload.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * JobPayload
+ *
+ * Represents the serialized structure of a job stored in the queue.
+ * This is the format that gets stored in the database/redis/etc.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JobPayload = void 0;
+const crypto_1 = require("crypto");
+class JobPayload {
+    /**
+     * Create a payload from a job instance
+     */
+    static create(job) {
+        return {
+            uuid: job.uuid || (0, crypto_1.randomUUID)(),
+            displayName: job.displayName(),
+            job: job.constructor.name,
+            data: job.toJSON(),
+            maxTries: job.tries ?? null,
+            maxExceptions: job.maxExceptions ?? null,
+            failOnTimeout: job.failOnTimeout ?? false,
+            backoff: job.backoff ?? null,
+            timeout: job.timeout ?? null,
+            retryUntil: job.retryUntil ? job.retryUntil.getTime() : null,
+            attempts: 0,
+            afterCommit: job.afterCommit ?? false,
+            pushedAt: new Date().toISOString(),
+        };
+    }
+    /**
+     * Serialize a payload to a JSON string
+     */
+    static serialize(payload) {
+        return JSON.stringify(payload);
+    }
+    /**
+     * Deserialize a JSON string to a payload
+     */
+    static deserialize(raw) {
+        return JSON.parse(raw);
+    }
+}
+exports.JobPayload = JobPayload;
+//# sourceMappingURL=JobPayload.js.map

package/dist/Queue/JobPayload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobPayload.js","sourceRoot":"","sources":["../../src/Queue/JobPayload.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,mCAAoC;AAmBpC,MAAa,UAAU;IACrB;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,GAAQ;QACpB,OAAO;YACL,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,IAAA,mBAAU,GAAE;YAC9B,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE;YAC9B,GAAG,EAAE,GAAG,CAAC,WAAW,CAAC,IAAI;YACzB,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE;YAClB,QAAQ,EAAE,GAAG,CAAC,KAAK,IAAI,IAAI;YAC3B,aAAa,EAAE,GAAG,CAAC,aAAa,IAAI,IAAI;YACxC,aAAa,EAAE,GAAG,CAAC,aAAa,IAAI,KAAK;YACzC,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,IAAI;YAC5B,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,IAAI;YAC5B,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI;YAC5D,QAAQ,EAAE,CAAC;YACX,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,KAAK;YACrC,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACnC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,OAAuB;QACtC,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,GAAW;QAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;CACF;AAnCD,gCAmCC"}

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

@@ -0,0 +1,29 @@
+/**
+ * JobMiddleware Contract
+ *
+ * Defines the interface for job middleware.
+ * Mirrors Laravel's queue middleware pattern.
+ *
+ * @example
+ * ```typescript
+ * class RateLimited implements JobMiddleware {
+ *   constructor(private key: string) {}
+ *
+ *   async handle(job: Job, next: () => Promise<void>): Promise<void> {
+ *     // Rate limiting logic...
+ *     await next();
+ *   }
+ * }
+ * ```
+ */
+import type { Job } from '../Job';
+export interface JobMiddleware {
+    /**
+     * Process the job through this middleware
+     *
+     * @param job - The job being processed
+     * @param next - Call to pass execution to the next middleware
+     */
+    handle(job: Job, next: () => Promise<void>): Promise<void>;
+}
+//# sourceMappingURL=JobMiddleware.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"JobMiddleware.d.ts","sourceRoot":"","sources":["../../../src/Queue/Middleware/JobMiddleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAElC,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D"}

package/dist/Queue/Middleware/JobMiddleware.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * JobMiddleware Contract
+ *
+ * Defines the interface for job middleware.
+ * Mirrors Laravel's queue middleware pattern.
+ *
+ * @example
+ * ```typescript
+ * class RateLimited implements JobMiddleware {
+ *   constructor(private key: string) {}
+ *
+ *   async handle(job: Job, next: () => Promise<void>): Promise<void> {
+ *     // Rate limiting logic...
+ *     await next();
+ *   }
+ * }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=JobMiddleware.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"JobMiddleware.js","sourceRoot":"","sources":["../../../src/Queue/Middleware/JobMiddleware.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG"}

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

@@ -0,0 +1,56 @@
+/**
+ * RateLimited Middleware
+ *
+ * Rate limits job execution. When the rate limit is exceeded,
+ * the job is released back onto the queue.
+ *
+ * Mirrors Laravel's Illuminate\Queue\Middleware\RateLimited.
+ *
+ * @example
+ * ```typescript
+ * class ProcessPodcast extends Job {
+ *   middleware() {
+ *     return [new RateLimited('podcasts', 10, 60)];
+ *   }
+ * }
+ * ```
+ */
+import type { Job } from '../Job';
+import type { JobMiddleware } from './JobMiddleware';
+export declare class RateLimited implements JobMiddleware {
+    /**
+     * The rate limiter key
+     */
+    protected key: string;
+    /**
+     * The maximum number of attempts within the decay period
+     */
+    protected maxAttempts: number;
+    /**
+     * The number of seconds until the rate limit resets
+     */
+    protected decaySeconds: number;
+    /**
+     * The number of seconds to release the job for when rate limited
+     */
+    protected releaseAfterSeconds: number;
+    constructor(
+    /**
+     * The rate limiter key
+     */
+    key: string, 
+    /**
+     * The maximum number of attempts within the decay period
+     */
+    maxAttempts?: number, 
+    /**
+     * The number of seconds until the rate limit resets
+     */
+    decaySeconds?: number);
+    handle(job: Job, next: () => Promise<void>): Promise<void>;
+    /**
+     * Set the number of seconds to release the job for
+     */
+    releaseAfter(seconds: number): this;
+}
+//# sourceMappingURL=RateLimited.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RateLimited.d.ts","sourceRoot":"","sources":["../../../src/Queue/Middleware/RateLimited.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,WAAY,YAAW,aAAa;IAO7C;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM;IAErB;;OAEG;IACH,SAAS,CAAC,WAAW,EAAE,MAAM;IAE7B;;OAEG;IACH,SAAS,CAAC,YAAY,EAAE,MAAM;IAnBhC;;OAEG;IACH,SAAS,CAAC,mBAAmB,EAAE,MAAM,CAAK;;IAGxC;;OAEG;IACO,GAAG,EAAE,MAAM;IAErB;;OAEG;IACO,WAAW,GAAE,MAAU;IAEjC;;OAEG;IACO,YAAY,GAAE,MAAW;IAG/B,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BhE;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAIpC"}

package/dist/Queue/Middleware/RateLimited.js

@@ -0,0 +1,83 @@
+"use strict";
+/**
+ * RateLimited Middleware
+ *
+ * Rate limits job execution. When the rate limit is exceeded,
+ * the job is released back onto the queue.
+ *
+ * Mirrors Laravel's Illuminate\Queue\Middleware\RateLimited.
+ *
+ * @example
+ * ```typescript
+ * class ProcessPodcast extends Job {
+ *   middleware() {
+ *     return [new RateLimited('podcasts', 10, 60)];
+ *   }
+ * }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RateLimited = void 0;
+// Simple in-memory rate limiter store
+const rateLimiterStore = new Map();
+class RateLimited {
+    key;
+    maxAttempts;
+    decaySeconds;
+    /**
+     * The number of seconds to release the job for when rate limited
+     */
+    releaseAfterSeconds = 0;
+    constructor(
+    /**
+     * The rate limiter key
+     */
+    key, 
+    /**
+     * The maximum number of attempts within the decay period
+     */
+    maxAttempts = 1, 
+    /**
+     * The number of seconds until the rate limit resets
+     */
+    decaySeconds = 60) {
+        this.key = key;
+        this.maxAttempts = maxAttempts;
+        this.decaySeconds = decaySeconds;
+    }
+    async handle(job, next) {
+        const now = Math.floor(Date.now() / 1000);
+        const limiter = rateLimiterStore.get(this.key);
+        // Check if the rate limit has expired
+        if (limiter && limiter.resetAt <= now) {
+            rateLimiterStore.delete(this.key);
+        }
+        const current = rateLimiterStore.get(this.key);
+        if (current && current.count >= this.maxAttempts) {
+            // Rate limited - release the job back
+            const retryAfter = current.resetAt - now;
+            job.release(this.releaseAfterSeconds || retryAfter);
+            return;
+        }
+        // Increment the counter
+        if (current) {
+            current.count++;
+        }
+        else {
+            rateLimiterStore.set(this.key, {
+                count: 1,
+                resetAt: now + this.decaySeconds,
+            });
+        }
+        await next();
+    }
+    /**
+     * Set the number of seconds to release the job for
+     */
+    releaseAfter(seconds) {
+        this.releaseAfterSeconds = seconds;
+        return this;
+    }
+}
+exports.RateLimited = RateLimited;
+//# sourceMappingURL=RateLimited.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RateLimited.js","sourceRoot":"","sources":["../../../src/Queue/Middleware/RateLimited.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;;AAKH,sCAAsC;AACtC,MAAM,gBAAgB,GAAoD,IAAI,GAAG,EAAE,CAAC;AAEpF,MAAa,WAAW;IAUV;IAKA;IAKA;IAnBZ;;OAEG;IACO,mBAAmB,GAAW,CAAC,CAAC;IAE1C;IACE;;OAEG;IACO,GAAW;IAErB;;OAEG;IACO,cAAsB,CAAC;IAEjC;;OAEG;IACO,eAAuB,EAAE;QAVzB,QAAG,GAAH,GAAG,CAAQ;QAKX,gBAAW,GAAX,WAAW,CAAY;QAKvB,iBAAY,GAAZ,YAAY,CAAa;IAClC,CAAC;IAEJ,KAAK,CAAC,MAAM,CAAC,GAAQ,EAAE,IAAyB;QAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAC1C,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAE/C,sCAAsC;QACtC,IAAI,OAAO,IAAI,OAAO,CAAC,OAAO,IAAI,GAAG,EAAE,CAAC;YACtC,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpC,CAAC;QAED,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAE/C,IAAI,OAAO,IAAI,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACjD,sCAAsC;YACtC,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,GAAG,GAAG,CAAC;YACzC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,IAAI,UAAU,CAAC,CAAC;YACpD,OAAO;QACT,CAAC;QAED,wBAAwB;QACxB,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE;gBAC7B,KAAK,EAAE,CAAC;gBACR,OAAO,EAAE,GAAG,GAAG,IAAI,CAAC,YAAY;aACjC,CAAC,CAAC;QACL,CAAC;QAED,MAAM,IAAI,EAAE,CAAC;IACf,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,OAAe;QAC1B,IAAI,CAAC,mBAAmB,GAAG,OAAO,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AA7DD,kCA6DC"}

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

@@ -0,0 +1,71 @@
+/**
+ * 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
+ *     ];
+ *   }
+ * }
+ * ```
+ */
+import type { Job } from '../Job';
+import type { JobMiddleware } from './JobMiddleware';
+export declare class ThrottlesExceptions implements JobMiddleware {
+    /**
+     * The maximum number of exceptions allowed
+     */
+    protected maxExceptions: number;
+    /**
+     * The number of minutes in the decay window
+     */
+    protected decayMinutes: number;
+    /**
+     * The number of minutes to back off for
+     */
+    protected backoffMinutes: number;
+    /**
+     * The prefix for the throttle key
+     */
+    protected keyPrefix: string;
+    /**
+     * Whether to retry the job or delete it when throttled
+     */
+    protected shouldRetryOnThrottle: boolean;
+    constructor(
+    /**
+     * The maximum number of exceptions allowed
+     */
+    maxExceptions?: number, 
+    /**
+     * The number of minutes in the decay window
+     */
+    decayMinutes?: number);
+    handle(job: Job, next: () => Promise<void>): Promise<void>;
+    /**
+     * Get the throttle key for this job
+     */
+    protected getKey(job: Job): string;
+    /**
+     * Set the number of minutes to back off for when throttled
+     */
+    backoff(minutes: number): this;
+    /**
+     * Set a custom key prefix
+     */
+    by(key: string): this;
+    /**
+     * Indicate the job should NOT be retried when throttled
+     */
+    dontRetry(): this;
+}
+//# sourceMappingURL=ThrottlesExceptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ThrottlesExceptions.d.ts","sourceRoot":"","sources":["../../../src/Queue/Middleware/ThrottlesExceptions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAKrD,qBAAa,mBAAoB,YAAW,aAAa;IAiBrD;;OAEG;IACH,SAAS,CAAC,aAAa,EAAE,MAAM;IAE/B;;OAEG;IACH,SAAS,CAAC,YAAY,EAAE,MAAM;IAxBhC;;OAEG;IACH,SAAS,CAAC,cAAc,EAAE,MAAM,CAAK;IAErC;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,CAAM;IAEjC;;OAEG;IACH,SAAS,CAAC,qBAAqB,EAAE,OAAO,CAAQ;;IAG9C;;OAEG;IACO,aAAa,GAAE,MAAW;IAEpC;;OAEG;IACO,YAAY,GAAE,MAAW;IAG/B,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAuChE;;OAEG;IACH,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM;IAKlC;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK9B;;OAEG;IACH,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKrB;;OAEG;IACH,SAAS,IAAI,IAAI;CAIlB"}

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"}