bunqueue 1.9.7 → 1.9.8

package/dist/application/stallDetection.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Stall Detection - Job stall detection and recovery
+ * Uses two-phase detection (like BullMQ) to prevent false positives
+ */
+import type { BackgroundContext } from './types';
+/**
+ * Check for stalled jobs and handle them
+ * Uses two-phase detection to prevent false positives
+ */
+export declare function checkStalledJobs(ctx: BackgroundContext): void;
+//# sourceMappingURL=stallDetection.d.ts.map

package/dist/application/stallDetection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stallDetection.d.ts","sourceRoot":"","sources":["../../src/application/stallDetection.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI,CAoD7D"}

package/dist/application/stallDetection.js

@@ -0,0 +1,128 @@
+/**
+ * Stall Detection - Job stall detection and recovery
+ * Uses two-phase detection (like BullMQ) to prevent false positives
+ */
+import { calculateBackoff } from '../domain/types/job';
+import { getStallAction, incrementStallCount } from '../domain/types/stall';
+import { queueLog } from '../shared/logger';
+import { shardIndex, processingShardIndex, SHARD_COUNT } from '../shared/hash';
+import { withWriteLock } from '../shared/lock';
+/**
+ * Check for stalled jobs and handle them
+ * Uses two-phase detection to prevent false positives
+ */
+export function checkStalledJobs(ctx) {
+    const now = Date.now();
+    const confirmedStalled = [];
+    // Phase 1: Check jobs that were candidates from previous cycle
+    for (const jobId of ctx.stalledCandidates) {
+        const procIdx = processingShardIndex(String(jobId));
+        const job = ctx.processingShards[procIdx].get(jobId);
+        if (!job) {
+            ctx.stalledCandidates.delete(jobId);
+            continue;
+        }
+        const stallConfig = ctx.shards[shardIndex(job.queue)].getStallConfig(job.queue);
+        if (!stallConfig.enabled) {
+            ctx.stalledCandidates.delete(jobId);
+            continue;
+        }
+        const action = getStallAction(job, stallConfig, now);
+        if (action !== "keep" /* StallAction.Keep */) {
+            confirmedStalled.push({ job, action });
+        }
+        ctx.stalledCandidates.delete(jobId);
+    }
+    // Phase 2: Mark current processing jobs as candidates for NEXT check
+    for (let i = 0; i < SHARD_COUNT; i++) {
+        const procShard = ctx.processingShards[i];
+        for (const [jobId, job] of procShard) {
+            const stallConfig = ctx.shards[shardIndex(job.queue)].getStallConfig(job.queue);
+            if (!stallConfig.enabled)
+                continue;
+            const action = getStallAction(job, stallConfig, now);
+            if (action !== "keep" /* StallAction.Keep */) {
+                ctx.stalledCandidates.add(jobId);
+            }
+        }
+    }
+    // Process confirmed stalled jobs
+    for (const { job, action } of confirmedStalled) {
+        handleStalledJob(job, action, ctx).catch((err) => {
+            queueLog.error('Failed to handle stalled job', {
+                jobId: String(job.id),
+                error: String(err),
+            });
+        });
+    }
+}
+/**
+ * Handle a stalled job based on the action
+ * Uses proper locking to prevent race conditions
+ */
+async function handleStalledJob(job, action, ctx) {
+    const idx = shardIndex(job.queue);
+    const procIdx = processingShardIndex(String(job.id));
+    // Broadcast events before acquiring locks (non-blocking)
+    ctx.eventsManager.broadcast({
+        eventType: "stalled" /* EventType.Stalled */,
+        queue: job.queue,
+        jobId: job.id,
+        timestamp: Date.now(),
+        data: { stallCount: job.stallCount + 1, action },
+    });
+    void ctx.webhookManager.trigger('stalled', String(job.id), job.queue, {
+        data: { stallCount: job.stallCount + 1, action },
+    });
+    // Acquire processing lock first, then shard lock
+    await withWriteLock(ctx.processingLocks[procIdx], async () => {
+        // Verify job is still in processing (might have been handled already)
+        if (!ctx.processingShards[procIdx].has(job.id)) {
+            return;
+        }
+        await withWriteLock(ctx.shardLocks[idx], () => {
+            const shard = ctx.shards[idx];
+            if (action === "move_to_dlq" /* StallAction.MoveToDlq */) {
+                moveStalliedJobToDlq(job, ctx, shard, procIdx, idx);
+            }
+            else {
+                retryStalliedJob(job, ctx, shard, procIdx, idx);
+            }
+        });
+    });
+}
+/** Move stalled job to DLQ */
+function moveStalliedJobToDlq(job, ctx, shard, procIdx, _idx) {
+    queueLog.warn('Job exceeded max stalls, moving to DLQ', {
+        jobId: String(job.id),
+        queue: job.queue,
+        stallCount: job.stallCount,
+    });
+    ctx.processingShards[procIdx].delete(job.id);
+    shard.releaseConcurrency(job.queue);
+    const entry = shard.addToDlq(job, "stalled" /* FailureReason.Stalled */, `Job stalled ${job.stallCount + 1} times`);
+    ctx.jobIndex.set(job.id, { type: 'dlq', queueName: job.queue });
+    ctx.storage?.saveDlqEntry(entry);
+}
+/** Retry stalled job */
+function retryStalliedJob(job, ctx, shard, procIdx, idx) {
+    incrementStallCount(job);
+    job.attempts++;
+    job.startedAt = null;
+    job.runAt = Date.now() + calculateBackoff(job);
+    job.lastHeartbeat = Date.now();
+    queueLog.warn('Job stalled, retrying', {
+        jobId: String(job.id),
+        queue: job.queue,
+        stallCount: job.stallCount,
+        attempt: job.attempts,
+    });
+    ctx.processingShards[procIdx].delete(job.id);
+    shard.releaseConcurrency(job.queue);
+    shard.getQueue(job.queue).push(job);
+    const isDelayed = job.runAt > Date.now();
+    shard.incrementQueued(job.id, isDelayed, job.createdAt, job.queue, job.runAt);
+    ctx.jobIndex.set(job.id, { type: 'queue', shardIdx: idx, queueName: job.queue });
+    ctx.storage?.updateForRetry(job);
+}
+//# sourceMappingURL=stallDetection.js.map

package/dist/application/stallDetection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stallDetection.js","sourceRoot":"","sources":["../../src/application/stallDetection.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,EAAe,cAAc,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAGzF,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAG/C;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAsB;IACrD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,gBAAgB,GAA6C,EAAE,CAAC;IAEtE,+DAA+D;IAC/D,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,iBAAiB,EAAE,CAAC;QAC1C,MAAM,OAAO,GAAG,oBAAoB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACpD,MAAM,GAAG,GAAG,GAAG,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAErD,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,CAAC,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACpC,SAAS;QACX,CAAC;QAED,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAChF,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YACzB,GAAG,CAAC,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACpC,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC;QACrD,IAAI,MAAM,kCAAqB,EAAE,CAAC;YAChC,gBAAgB,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;QACzC,CAAC;QAED,GAAG,CAAC,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,qEAAqE;IACrE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,SAAS,GAAG,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;QAE1C,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,SAAS,EAAE,CAAC;YACrC,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAChF,IAAI,CAAC,WAAW,CAAC,OAAO;gBAAE,SAAS;YAEnC,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC;YACrD,IAAI,MAAM,kCAAqB,EAAE,CAAC;gBAChC,GAAG,CAAC,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;IACH,CAAC;IAED,iCAAiC;IACjC,KAAK,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,gBAAgB,EAAE,CAAC;QAC/C,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;YACxD,QAAQ,CAAC,KAAK,CAAC,8BAA8B,EAAE;gBAC7C,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrB,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC;aACnB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,gBAAgB,CAC7B,GAAQ,EACR,MAAmB,EACnB,GAAsB;IAEtB,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAClC,MAAM,OAAO,GAAG,oBAAoB,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAErD,yDAAyD;IACzD,GAAG,CAAC,aAAa,CAAC,SAAS,CAAC;QAC1B,SAAS,mCAAmB;QAC5B,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,KAAK,EAAE,GAAG,CAAC,EAAE;QACb,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,IAAI,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,GAAG,CAAC,EAAE,MAAM,EAAE;KACjD,CAAC,CAAC;IACH,KAAK,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,SAAyB,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,KAAK,EAAE;QACpF,IAAI,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,GAAG,CAAC,EAAE,MAAM,EAAE;KACjD,CAAC,CAAC;IAEH,iDAAiD;IACjD,MAAM,aAAa,CAAC,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,KAAK,IAAI,EAAE;QAC3D,sEAAsE;QACtE,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAC/C,OAAO;QACT,CAAC;QAED,MAAM,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE;YAC5C,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAE9B,IAAI,MAAM,8CAA0B,EAAE,CAAC;gBACrC,oBAAoB,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;YACtD,CAAC;iBAAM,CAAC;gBACN,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;YAClD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,8BAA8B;AAC9B,SAAS,oBAAoB,CAC3B,GAAQ,EACR,GAAsB,EACtB,KAA0C,EAC1C,OAAe,EACf,IAAY;IAEZ,QAAQ,CAAC,IAAI,CAAC,wCAAwC,EAAE;QACtD,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,UAAU,EAAE,GAAG,CAAC,UAAU;KAC3B,CAAC,CAAC;IAEH,GAAG,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC7C,KAAK,CAAC,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAEpC,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAC1B,GAAG,yCAEH,eAAe,GAAG,CAAC,UAAU,GAAG,CAAC,QAAQ,CAC1C,CAAC;IACF,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;IAChE,GAAG,CAAC,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC;AAED,wBAAwB;AACxB,SAAS,gBAAgB,CACvB,GAAQ,EACR,GAAsB,EACtB,KAA0C,EAC1C,OAAe,EACf,GAAW;IAEX,mBAAmB,CAAC,GAAG,CAAC,CAAC;IACzB,GAAG,CAAC,QAAQ,EAAE,CAAC;IACf,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC;IACrB,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC/C,GAAG,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE/B,QAAQ,CAAC,IAAI,CAAC,uBAAuB,EAAE;QACrC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,OAAO,EAAE,GAAG,CAAC,QAAQ;KACtB,CAAC,CAAC;IAEH,GAAG,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC7C,KAAK,CAAC,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAEpC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzC,KAAK,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;IAC9E,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;IACjF,GAAG,CAAC,OAAO,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC"}

package/dist/domain/queue/dependencyTracker.d.ts

@@ -0,0 +1,74 @@
+/**
+ * DependencyTracker - Tracks job dependencies and parent-child relationships
+ */
+import type { Job, JobId } from '../types/job';
+/**
+ * Manages job dependency tracking for a shard
+ * Provides O(1) lookup when dependencies complete
+ */
+export declare class DependencyTracker {
+    /** Jobs waiting for dependencies */
+    readonly waitingDeps: Map<JobId, Job>;
+    /**
+     * Reverse index: depId -> Set of jobIds waiting for that dependency
+     * Enables O(1) lookup when a dependency completes instead of O(n) scan
+     */
+    readonly dependencyIndex: Map<JobId, Set<JobId>>;
+    /** Parent jobs waiting for children to complete */
+    readonly waitingChildren: Map<JobId, Job>;
+    /**
+     * Register a job's dependencies in the reverse index
+     * Call when adding a job to waitingDeps
+     */
+    registerDependencies(jobId: JobId, dependsOn: JobId[]): void;
+    /**
+     * Unregister a job's dependencies from the reverse index
+     * Call when removing a job from waitingDeps
+     */
+    unregisterDependencies(jobId: JobId, dependsOn: JobId[]): void;
+    /**
+     * Get jobs waiting for a specific dependency - O(1)
+     */
+    getJobsWaitingFor(depId: JobId): Set<JobId> | undefined;
+    /**
+     * Add a job that is waiting for dependencies
+     */
+    addWaitingJob(job: Job): void;
+    /**
+     * Remove a job from waiting deps
+     */
+    removeWaitingJob(jobId: JobId): Job | undefined;
+    /**
+     * Get a job waiting for dependencies
+     */
+    getWaitingJob(jobId: JobId): Job | undefined;
+    /**
+     * Check if a job is waiting for dependencies
+     */
+    isWaiting(jobId: JobId): boolean;
+    /**
+     * Add a parent job waiting for children
+     */
+    addWaitingParent(job: Job): void;
+    /**
+     * Remove a parent job from waiting
+     */
+    removeWaitingParent(jobId: JobId): Job | undefined;
+    /**
+     * Get a parent job waiting for children
+     */
+    getWaitingParent(jobId: JobId): Job | undefined;
+    /**
+     * Check if a parent is waiting for children
+     */
+    isParentWaiting(jobId: JobId): boolean;
+    /**
+     * Get counts for debugging
+     */
+    getCounts(): {
+        waitingDeps: number;
+        dependencyIndex: number;
+        waitingChildren: number;
+    };
+}
+//# sourceMappingURL=dependencyTracker.d.ts.map

package/dist/domain/queue/dependencyTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencyTracker.d.ts","sourceRoot":"","sources":["../../../src/domain/queue/dependencyTracker.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE/C;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,oCAAoC;IACpC,QAAQ,CAAC,WAAW,kBAAyB;IAE7C;;;OAGG;IACH,QAAQ,CAAC,eAAe,yBAAgC;IAExD,mDAAmD;IACnD,QAAQ,CAAC,eAAe,kBAAyB;IAEjD;;;OAGG;IACH,oBAAoB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,IAAI;IAW5D;;;OAGG;IACH,sBAAsB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,IAAI;IAY9D;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,SAAS;IAIvD;;OAEG;IACH,aAAa,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI;IAO7B;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,GAAG,GAAG,SAAS;IAW/C;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,GAAG,GAAG,SAAS;IAI5C;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAIhC;;OAEG;IACH,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI;IAIhC;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,GAAG,GAAG,SAAS;IAQlD;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,GAAG,GAAG,SAAS;IAI/C;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAItC;;OAEG;IACH,SAAS,IAAI;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE;CAOvF"}

package/dist/domain/queue/dependencyTracker.js

@@ -0,0 +1,126 @@
+/**
+ * DependencyTracker - Tracks job dependencies and parent-child relationships
+ */
+/**
+ * Manages job dependency tracking for a shard
+ * Provides O(1) lookup when dependencies complete
+ */
+export class DependencyTracker {
+    /** Jobs waiting for dependencies */
+    waitingDeps = new Map();
+    /**
+     * Reverse index: depId -> Set of jobIds waiting for that dependency
+     * Enables O(1) lookup when a dependency completes instead of O(n) scan
+     */
+    dependencyIndex = new Map();
+    /** Parent jobs waiting for children to complete */
+    waitingChildren = new Map();
+    /**
+     * Register a job's dependencies in the reverse index
+     * Call when adding a job to waitingDeps
+     */
+    registerDependencies(jobId, dependsOn) {
+        for (const depId of dependsOn) {
+            let waiters = this.dependencyIndex.get(depId);
+            if (!waiters) {
+                waiters = new Set();
+                this.dependencyIndex.set(depId, waiters);
+            }
+            waiters.add(jobId);
+        }
+    }
+    /**
+     * Unregister a job's dependencies from the reverse index
+     * Call when removing a job from waitingDeps
+     */
+    unregisterDependencies(jobId, dependsOn) {
+        for (const depId of dependsOn) {
+            const waiters = this.dependencyIndex.get(depId);
+            if (waiters) {
+                waiters.delete(jobId);
+                if (waiters.size === 0) {
+                    this.dependencyIndex.delete(depId);
+                }
+            }
+        }
+    }
+    /**
+     * Get jobs waiting for a specific dependency - O(1)
+     */
+    getJobsWaitingFor(depId) {
+        return this.dependencyIndex.get(depId);
+    }
+    /**
+     * Add a job that is waiting for dependencies
+     */
+    addWaitingJob(job) {
+        this.waitingDeps.set(job.id, job);
+        if (job.dependsOn && job.dependsOn.length > 0) {
+            this.registerDependencies(job.id, job.dependsOn);
+        }
+    }
+    /**
+     * Remove a job from waiting deps
+     */
+    removeWaitingJob(jobId) {
+        const job = this.waitingDeps.get(jobId);
+        if (job) {
+            this.waitingDeps.delete(jobId);
+            if (job.dependsOn && job.dependsOn.length > 0) {
+                this.unregisterDependencies(jobId, job.dependsOn);
+            }
+        }
+        return job;
+    }
+    /**
+     * Get a job waiting for dependencies
+     */
+    getWaitingJob(jobId) {
+        return this.waitingDeps.get(jobId);
+    }
+    /**
+     * Check if a job is waiting for dependencies
+     */
+    isWaiting(jobId) {
+        return this.waitingDeps.has(jobId);
+    }
+    /**
+     * Add a parent job waiting for children
+     */
+    addWaitingParent(job) {
+        this.waitingChildren.set(job.id, job);
+    }
+    /**
+     * Remove a parent job from waiting
+     */
+    removeWaitingParent(jobId) {
+        const job = this.waitingChildren.get(jobId);
+        if (job) {
+            this.waitingChildren.delete(jobId);
+        }
+        return job;
+    }
+    /**
+     * Get a parent job waiting for children
+     */
+    getWaitingParent(jobId) {
+        return this.waitingChildren.get(jobId);
+    }
+    /**
+     * Check if a parent is waiting for children
+     */
+    isParentWaiting(jobId) {
+        return this.waitingChildren.has(jobId);
+    }
+    /**
+     * Get counts for debugging
+     */
+    getCounts() {
+        return {
+            waitingDeps: this.waitingDeps.size,
+            dependencyIndex: this.dependencyIndex.size,
+            waitingChildren: this.waitingChildren.size,
+        };
+    }
+}
+//# sourceMappingURL=dependencyTracker.js.map

package/dist/domain/queue/dependencyTracker.js.map

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

package/dist/domain/queue/dlqShard.d.ts

@@ -0,0 +1,59 @@
+/**
+ * DlqShard - Dead Letter Queue operations for a shard
+ */
+import type { Job, JobId } from '../types/job';
+import type { DlqEntry, DlqConfig, DlqFilter } from '../types/dlq';
+import { FailureReason } from '../types/dlq';
+import type { StallConfig } from '../types/stall';
+/** Stats callback for counter updates */
+export interface DlqStatsCallback {
+    incrementDlq(): void;
+    decrementDlq(count?: number): void;
+}
+/**
+ * Manages Dead Letter Queue operations for a shard
+ */
+export declare class DlqShard {
+    /** Dead letter queue by queue name */
+    private readonly dlq;
+    /** DLQ configuration per queue */
+    private readonly dlqConfig;
+    /** Stall configuration per queue */
+    private readonly stallConfig;
+    /** Stats callback for counter updates */
+    private readonly stats;
+    constructor(stats: DlqStatsCallback);
+    /** Get DLQ config for queue */
+    getConfig(queue: string): DlqConfig;
+    /** Set DLQ config for queue */
+    setConfig(queue: string, config: Partial<DlqConfig>): void;
+    /** Get stall config for queue */
+    getStallConfig(queue: string): StallConfig;
+    /** Set stall config for queue */
+    setStallConfig(queue: string, config: Partial<StallConfig>): void;
+    /** Add job to DLQ with full metadata */
+    add(job: Job, reason?: FailureReason, error?: string | null): DlqEntry;
+    /** Get DLQ entries (raw) */
+    getEntries(queue: string): DlqEntry[];
+    /** Get DLQ jobs (for backward compatibility) */
+    getJobs(queue: string, count?: number): Job[];
+    /** Get DLQ entries with filter */
+    getFiltered(queue: string, filter: DlqFilter): DlqEntry[];
+    /** Remove entry from DLQ by job ID */
+    remove(queue: string, jobId: JobId): DlqEntry | null;
+    /** Get entries ready for auto-retry */
+    getAutoRetryEntries(queue: string, now?: number): DlqEntry[];
+    /** Get expired entries for cleanup */
+    getExpiredEntries(queue: string, now?: number): DlqEntry[];
+    /** Remove expired entries */
+    purgeExpired(queue: string, now?: number): number;
+    /** Clear DLQ for queue */
+    clear(queue: string): number;
+    /** Get DLQ count for queue */
+    getCount(queue: string): number;
+    /** Get all queue names with DLQ entries */
+    getQueueNames(): string[];
+    /** Delete queue data */
+    deleteQueue(queue: string): number;
+}
+//# sourceMappingURL=dlqShard.d.ts.map

package/dist/domain/queue/dlqShard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dlqShard.d.ts","sourceRoot":"","sources":["../../../src/domain/queue/dlqShard.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAEL,aAAa,EAId,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGlD,yCAAyC;AACzC,MAAM,WAAW,gBAAgB;IAC/B,YAAY,IAAI,IAAI,CAAC;IACrB,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED;;GAEG;AACH,qBAAa,QAAQ;IACnB,sCAAsC;IACtC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAiC;IAErD,kCAAkC;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgC;IAE1D,oCAAoC;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkC;IAE9D,yCAAyC;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;gBAE7B,KAAK,EAAE,gBAAgB;IAInC,+BAA+B;IAC/B,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS;IAInC,+BAA+B;IAC/B,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI;IAK1D,iCAAiC;IACjC,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW;IAI1C,iCAAiC;IACjC,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI;IAKjE,wCAAwC;IACxC,GAAG,CACD,GAAG,EAAE,GAAG,EACR,MAAM,GAAE,aAAqC,EAC7C,KAAK,GAAE,MAAM,GAAG,IAAW,GAC1B,QAAQ;IAqBX,4BAA4B;IAC5B,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,EAAE;IAIrC,gDAAgD;IAChD,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,GAAG,EAAE;IAO7C,kCAAkC;IAClC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,QAAQ,EAAE;IAwBzD,sCAAsC;IACtC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,QAAQ,GAAG,IAAI;IASpD,uCAAuC;IACvC,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,QAAQ,EAAE;IAOxE,sCAAsC;IACtC,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,QAAQ,EAAE;IAMtE,6BAA6B;IAC7B,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,MAAM;IAgB7D,0BAA0B;IAC1B,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAS5B,8BAA8B;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAI/B,2CAA2C;IAC3C,aAAa,IAAI,MAAM,EAAE;IAIzB,wBAAwB;IACxB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;CAQnC"}

package/dist/domain/queue/dlqShard.js

@@ -0,0 +1,165 @@
+/**
+ * DlqShard - Dead Letter Queue operations for a shard
+ */
+import { DEFAULT_DLQ_CONFIG, createDlqEntry, isDlqEntryExpired, canAutoRetry, } from '../types/dlq';
+import { DEFAULT_STALL_CONFIG } from '../types/stall';
+/**
+ * Manages Dead Letter Queue operations for a shard
+ */
+export class DlqShard {
+    /** Dead letter queue by queue name */
+    dlq = new Map();
+    /** DLQ configuration per queue */
+    dlqConfig = new Map();
+    /** Stall configuration per queue */
+    stallConfig = new Map();
+    /** Stats callback for counter updates */
+    stats;
+    constructor(stats) {
+        this.stats = stats;
+    }
+    /** Get DLQ config for queue */
+    getConfig(queue) {
+        return this.dlqConfig.get(queue) ?? DEFAULT_DLQ_CONFIG;
+    }
+    /** Set DLQ config for queue */
+    setConfig(queue, config) {
+        const current = this.getConfig(queue);
+        this.dlqConfig.set(queue, { ...current, ...config });
+    }
+    /** Get stall config for queue */
+    getStallConfig(queue) {
+        return this.stallConfig.get(queue) ?? DEFAULT_STALL_CONFIG;
+    }
+    /** Set stall config for queue */
+    setStallConfig(queue, config) {
+        const current = this.getStallConfig(queue);
+        this.stallConfig.set(queue, { ...current, ...config });
+    }
+    /** Add job to DLQ with full metadata */
+    add(job, reason = "unknown" /* FailureReason.Unknown */, error = null) {
+        let entries = this.dlq.get(job.queue);
+        if (!entries) {
+            entries = [];
+            this.dlq.set(job.queue, entries);
+        }
+        const config = this.getConfig(job.queue);
+        const entry = createDlqEntry(job, reason, error, config);
+        // Enforce max entries
+        while (entries.length >= config.maxEntries) {
+            entries.shift(); // Remove oldest
+            this.stats.decrementDlq();
+        }
+        entries.push(entry);
+        this.stats.incrementDlq();
+        return entry;
+    }
+    /** Get DLQ entries (raw) */
+    getEntries(queue) {
+        return this.dlq.get(queue) ?? [];
+    }
+    /** Get DLQ jobs (for backward compatibility) */
+    getJobs(queue, count) {
+        const entries = this.dlq.get(queue);
+        if (!entries)
+            return [];
+        const slice = count ? entries.slice(0, count) : entries;
+        return slice.map((e) => e.job);
+    }
+    /** Get DLQ entries with filter */
+    getFiltered(queue, filter) {
+        const entries = this.dlq.get(queue);
+        if (!entries)
+            return [];
+        const now = Date.now();
+        let result = entries.filter((entry) => {
+            if (filter.reason && entry.reason !== filter.reason)
+                return false;
+            if (filter.olderThan && entry.enteredAt >= filter.olderThan)
+                return false;
+            if (filter.newerThan && entry.enteredAt <= filter.newerThan)
+                return false;
+            if (filter.retriable && !canAutoRetry(entry, this.getConfig(queue), now))
+                return false;
+            if (filter.expired && !isDlqEntryExpired(entry, now))
+                return false;
+            return true;
+        });
+        if (filter.offset) {
+            result = result.slice(filter.offset);
+        }
+        if (filter.limit) {
+            result = result.slice(0, filter.limit);
+        }
+        return result;
+    }
+    /** Remove entry from DLQ by job ID */
+    remove(queue, jobId) {
+        const entries = this.dlq.get(queue);
+        if (!entries)
+            return null;
+        const idx = entries.findIndex((e) => e.job.id === jobId);
+        if (idx === -1)
+            return null;
+        this.stats.decrementDlq();
+        return entries.splice(idx, 1)[0];
+    }
+    /** Get entries ready for auto-retry */
+    getAutoRetryEntries(queue, now = Date.now()) {
+        const entries = this.dlq.get(queue);
+        if (!entries)
+            return [];
+        const config = this.getConfig(queue);
+        return entries.filter((entry) => canAutoRetry(entry, config, now));
+    }
+    /** Get expired entries for cleanup */
+    getExpiredEntries(queue, now = Date.now()) {
+        const entries = this.dlq.get(queue);
+        if (!entries)
+            return [];
+        return entries.filter((entry) => isDlqEntryExpired(entry, now));
+    }
+    /** Remove expired entries */
+    purgeExpired(queue, now = Date.now()) {
+        const entries = this.dlq.get(queue);
+        if (!entries)
+            return 0;
+        const before = entries.length;
+        const remaining = entries.filter((entry) => !isDlqEntryExpired(entry, now));
+        if (remaining.length < before) {
+            this.dlq.set(queue, remaining);
+            const removed = before - remaining.length;
+            this.stats.decrementDlq(removed);
+            return removed;
+        }
+        return 0;
+    }
+    /** Clear DLQ for queue */
+    clear(queue) {
+        const entries = this.dlq.get(queue);
+        if (!entries)
+            return 0;
+        const count = entries.length;
+        this.dlq.delete(queue);
+        this.stats.decrementDlq(count);
+        return count;
+    }
+    /** Get DLQ count for queue */
+    getCount(queue) {
+        return this.dlq.get(queue)?.length ?? 0;
+    }
+    /** Get all queue names with DLQ entries */
+    getQueueNames() {
+        return Array.from(this.dlq.keys());
+    }
+    /** Delete queue data */
+    deleteQueue(queue) {
+        const entries = this.dlq.get(queue);
+        const count = entries?.length ?? 0;
+        this.dlq.delete(queue);
+        this.dlqConfig.delete(queue);
+        this.stallConfig.delete(queue);
+        return count;
+    }
+}
+//# sourceMappingURL=dlqShard.js.map

package/dist/domain/queue/dlqShard.js.map

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

package/dist/domain/queue/limiterManager.d.ts

@@ -0,0 +1,44 @@
+/**
+ * LimiterManager - Rate limiting and concurrency control
+ */
+import { type QueueState } from '../types/queue';
+/**
+ * Manages rate limiting and concurrency for queues
+ */
+export declare class LimiterManager {
+    /** Queue state (pause, rate limit, concurrency) */
+    private readonly queueState;
+    /** Rate limiters per queue */
+    private readonly rateLimiters;
+    /** Concurrency limiters per queue */
+    private readonly concurrencyLimiters;
+    /** Get queue state */
+    getState(name: string): QueueState;
+    /** Check if queue is paused */
+    isPaused(name: string): boolean;
+    /** Pause queue */
+    pause(name: string): void;
+    /** Resume queue */
+    resume(name: string): void;
+    /** Set rate limit for queue */
+    setRateLimit(queue: string, limit: number): void;
+    /** Clear rate limit */
+    clearRateLimit(queue: string): void;
+    /** Try to acquire rate limit token */
+    tryAcquireRateLimit(queue: string): boolean;
+    /** Set concurrency limit for queue */
+    setConcurrency(queue: string, limit: number): void;
+    /** Clear concurrency limit */
+    clearConcurrency(queue: string): void;
+    /** Try to acquire concurrency slot */
+    tryAcquireConcurrency(queue: string): boolean;
+    /** Release concurrency slot */
+    releaseConcurrency(queue: string): void;
+    /** Get all queue names with state */
+    getQueueNames(): string[];
+    /** Delete queue data */
+    deleteQueue(queue: string): void;
+    /** Get the underlying state map (for backward compatibility) */
+    getStateMap(): Map<string, QueueState>;
+}
+//# sourceMappingURL=limiterManager.d.ts.map

package/dist/domain/queue/limiterManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limiterManager.d.ts","sourceRoot":"","sources":["../../../src/domain/queue/limiterManager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,UAAU,EAAqD,MAAM,gBAAgB,CAAC;AAEpG;;GAEG;AACH,qBAAa,cAAc;IACzB,mDAAmD;IACnD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiC;IAE5D,8BAA8B;IAC9B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkC;IAE/D,qCAAqC;IACrC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAyC;IAE7E,sBAAsB;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;IASlC,+BAA+B;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI/B,kBAAkB;IAClB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIzB,mBAAmB;IACnB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM1B,+BAA+B;IAC/B,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAKhD,uBAAuB;IACvB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMnC,sCAAsC;IACtC,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAO3C,sCAAsC;IACtC,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAWlD,8BAA8B;IAC9B,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMrC,sCAAsC;IACtC,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAK7C,+BAA+B;IAC/B,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMvC,qCAAqC;IACrC,aAAa,IAAI,MAAM,EAAE;IAIzB,wBAAwB;IACxB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMhC,gEAAgE;IAChE,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC;CAGvC"}