bunqueue 2.4.0 → 2.4.1

package/dist/client/worker/workerHeartbeat.d.ts

@@ -0,0 +1,16 @@
+/**
+ * WorkerHeartbeat - Heartbeat sending for TCP worker connections
+ * Sends periodic heartbeats to keep locks alive and prevent stall detection
+ */
+import type { EventEmitter } from 'events';
+import type { TcpConnection } from './types';
+export interface HeartbeatDeps {
+    readonly pulledJobIds: Set<string>;
+    readonly jobTokens: Map<string, string>;
+    readonly tcp: TcpConnection | null;
+    readonly useLocks: boolean;
+    readonly emitter: EventEmitter;
+}
+export declare function startHeartbeat(deps: HeartbeatDeps, intervalMs: number): ReturnType<typeof setInterval>;
+export declare function sendHeartbeat(deps: HeartbeatDeps): Promise<void>;
+//# sourceMappingURL=workerHeartbeat.d.ts.map

package/dist/client/worker/workerHeartbeat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workerHeartbeat.d.ts","sourceRoot":"","sources":["../../../src/client/worker/workerHeartbeat.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;CAChC;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,aAAa,EACnB,UAAU,EAAE,MAAM,GACjB,UAAU,CAAC,OAAO,WAAW,CAAC,CAEhC;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BtE"}

package/dist/client/worker/workerHeartbeat.js

@@ -0,0 +1,44 @@
+/**
+ * WorkerHeartbeat - Heartbeat sending for TCP worker connections
+ * Sends periodic heartbeats to keep locks alive and prevent stall detection
+ */
+export function startHeartbeat(deps, intervalMs) {
+    return setInterval(() => void sendHeartbeat(deps), intervalMs);
+}
+export async function sendHeartbeat(deps) {
+    // Send heartbeat for ALL pulled jobs (including buffered ones)
+    // This is critical: when locks are enabled, we need to renew them
+    // even for jobs sitting in the buffer waiting to be processed
+    if (deps.pulledJobIds.size === 0 || !deps.tcp)
+        return;
+    try {
+        // Always take a fresh snapshot - avoids race with job start/complete
+        const ids = Array.from(deps.pulledJobIds);
+        if (ids.length === 0)
+            return;
+        if (deps.useLocks) {
+            // With locks: include tokens for lock renewal
+            const tokens = ids.map((id) => deps.jobTokens.get(id) ?? '');
+            if (ids.length === 1) {
+                await deps.tcp.send({ cmd: 'JobHeartbeat', id: ids[0], token: tokens[0] || undefined });
+            }
+            else {
+                await deps.tcp.send({ cmd: 'JobHeartbeatB', ids, tokens });
+            }
+        }
+        else {
+            // Without locks: simple heartbeat for stall detection only
+            if (ids.length === 1) {
+                await deps.tcp.send({ cmd: 'JobHeartbeat', id: ids[0] });
+            }
+            else {
+                await deps.tcp.send({ cmd: 'JobHeartbeatB', ids });
+            }
+        }
+    }
+    catch (err) {
+        const error = err instanceof Error ? err : new Error(String(err));
+        deps.emitter.emit('error', Object.assign(error, { context: 'heartbeat' }));
+    }
+}
+//# sourceMappingURL=workerHeartbeat.js.map

package/dist/client/worker/workerHeartbeat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workerHeartbeat.js","sourceRoot":"","sources":["../../../src/client/worker/workerHeartbeat.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,MAAM,UAAU,cAAc,CAC5B,IAAmB,EACnB,UAAkB;IAElB,OAAO,WAAW,CAAC,GAAG,EAAE,CAAC,KAAK,aAAa,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAmB;IACrD,+DAA+D;IAC/D,kEAAkE;IAClE,8DAA8D;IAC9D,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QAAE,OAAO;IAEtD,IAAI,CAAC;QACH,qEAAqE;QACrE,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC1C,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAE7B,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,8CAA8C;YAC9C,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7D,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACrB,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,cAAc,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,CAAC,CAAC;YAC1F,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC;aAAM,CAAC;YACN,2DAA2D;YAC3D,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACrB,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,cAAc,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC3D,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAClE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC"}

package/dist/client/worker/workerPull.d.ts

@@ -0,0 +1,21 @@
+/**
+ * WorkerPull - Job pulling functions for embedded and TCP modes
+ * Handles batch pulling with optional lock-based ownership
+ */
+import type { Job as InternalJob } from '../../domain/types/job';
+import type { TcpConnection } from './types';
+export interface PullConfig {
+    readonly name: string;
+    readonly workerId: string;
+    readonly useLocks: boolean;
+    readonly pollTimeout: number;
+}
+export declare function pullEmbedded(config: PullConfig, count: number): Promise<Array<{
+    job: InternalJob;
+    token: string | null;
+}>>;
+export declare function pullTcp(config: PullConfig, tcp: TcpConnection, count: number, closing: boolean): Promise<Array<{
+    job: InternalJob;
+    token: string | null;
+}>>;
+//# sourceMappingURL=workerPull.d.ts.map

package/dist/client/worker/workerPull.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workerPull.d.ts","sourceRoot":"","sources":["../../../src/client/worker/workerPull.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,GAAG,IAAI,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAG7C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,KAAK,CAAC;IAAE,GAAG,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAAC,CAyB5D;AAED,wBAAsB,OAAO,CAC3B,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,KAAK,CAAC;IAAE,GAAG,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAAC,CAuC5D"}

package/dist/client/worker/workerPull.js

@@ -0,0 +1,60 @@
+/**
+ * WorkerPull - Job pulling functions for embedded and TCP modes
+ * Handles batch pulling with optional lock-based ownership
+ */
+import { getSharedManager } from '../manager';
+import { parseJobFromResponse } from './jobParser';
+export async function pullEmbedded(config, count) {
+    const manager = getSharedManager();
+    // Use lock-based pull only when useLocks is enabled
+    if (config.useLocks) {
+        if (count === 1) {
+            const { job, token } = await manager.pullWithLock(config.name, config.workerId, 0);
+            return job ? [{ job, token }] : [];
+        }
+        const { jobs, tokens } = await manager.pullBatchWithLock(config.name, count, config.workerId, 0);
+        return jobs.map((job, i) => ({ job, token: tokens[i] || null }));
+    }
+    // No locks - use regular pull
+    if (count === 1) {
+        const job = await manager.pull(config.name, 0);
+        return job ? [{ job, token: null }] : [];
+    }
+    const jobs = await manager.pullBatch(config.name, count, 0);
+    return jobs.map((job) => ({ job, token: null }));
+}
+export async function pullTcp(config, tcp, count, closing) {
+    if (closing)
+        return [];
+    // Build pull command - only request locks if useLocks is enabled
+    const cmd = {
+        cmd: count === 1 ? 'PULL' : 'PULLB',
+        queue: config.name,
+        timeout: config.pollTimeout,
+        count,
+    };
+    // Only request lock ownership when useLocks is enabled
+    if (config.useLocks) {
+        cmd.owner = config.workerId;
+    }
+    const response = await tcp.send(cmd);
+    if (!response.ok)
+        return [];
+    if (count === 1) {
+        const job = response.job;
+        // Only expect token if locks are enabled
+        const token = config.useLocks ? (response.token ?? null) : null;
+        if (job) {
+            return [{ job: parseJobFromResponse(job, config.name), token }];
+        }
+        return [];
+    }
+    const jobs = response.jobs;
+    // Only expect tokens if locks are enabled
+    const tokens = config.useLocks ? (response.tokens ?? []) : [];
+    return (jobs?.map((j, i) => ({
+        job: parseJobFromResponse(j, config.name),
+        token: tokens[i] || null,
+    })) ?? []);
+}
+//# sourceMappingURL=workerPull.js.map

package/dist/client/worker/workerPull.js.map

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

package/dist/client/worker/workerRateLimiter.d.ts

@@ -0,0 +1,37 @@
+/**
+ * WorkerRateLimiter - Rate limiting for worker job processing
+ * BullMQ v5 compatible sliding window rate limiter
+ */
+import type { RateLimiterOptions } from '../types';
+export declare class WorkerRateLimiter {
+    private readonly limiter;
+    private limiterTokens;
+    private rateLimitExpiration;
+    constructor(limiter: RateLimiterOptions | null);
+    /**
+     * Check if rate limiter allows processing another job.
+     * Returns true if we can process, false if rate limited.
+     */
+    canProcessWithinLimit(): boolean;
+    /** Record a job completion for rate limiting. */
+    recordJobForLimiter(): void;
+    /**
+     * Get time until rate limiter allows next job (ms).
+     * Returns 0 if not rate limited.
+     */
+    getTimeUntilNextSlot(): number;
+    /** Get rate limiter info (for debugging/monitoring). */
+    getRateLimiterInfo(): {
+        current: number;
+        max: number;
+        duration: number;
+    } | null;
+    /**
+     * Apply rate limiting (BullMQ v5 compatible).
+     * The worker will not process jobs until the rate limit expires.
+     */
+    rateLimit(expireTimeMs: number): void;
+    /** Check if worker is currently rate limited. */
+    isRateLimited(): boolean;
+}
+//# sourceMappingURL=workerRateLimiter.d.ts.map

package/dist/client/worker/workerRateLimiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workerRateLimiter.d.ts","sourceRoot":"","sources":["../../../src/client/worker/workerRateLimiter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnD,qBAAa,iBAAiB;IAIhB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,mBAAmB,CAAK;gBAEH,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAE/D;;;OAGG;IACH,qBAAqB,IAAI,OAAO;IAahC,iDAAiD;IACjD,mBAAmB,IAAI,IAAI;IAK3B;;;OAGG;IACH,oBAAoB,IAAI,MAAM;IAkB9B,wDAAwD;IACxD,kBAAkB,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAc/E;;;OAGG;IACH,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAcrC,iDAAiD;IACjD,aAAa,IAAI,OAAO;CAGzB"}

package/dist/client/worker/workerRateLimiter.js

@@ -0,0 +1,84 @@
+/**
+ * WorkerRateLimiter - Rate limiting for worker job processing
+ * BullMQ v5 compatible sliding window rate limiter
+ */
+export class WorkerRateLimiter {
+    limiter;
+    limiterTokens = [];
+    rateLimitExpiration = 0;
+    constructor(limiter) {
+        this.limiter = limiter;
+    }
+    /**
+     * Check if rate limiter allows processing another job.
+     * Returns true if we can process, false if rate limited.
+     */
+    canProcessWithinLimit() {
+        if (!this.limiter)
+            return true;
+        const now = Date.now();
+        const windowStart = now - this.limiter.duration;
+        // Remove expired tokens
+        this.limiterTokens = this.limiterTokens.filter((t) => t > windowStart);
+        // Check if we have capacity
+        return this.limiterTokens.length < this.limiter.max;
+    }
+    /** Record a job completion for rate limiting. */
+    recordJobForLimiter() {
+        if (!this.limiter)
+            return;
+        this.limiterTokens.push(Date.now());
+    }
+    /**
+     * Get time until rate limiter allows next job (ms).
+     * Returns 0 if not rate limited.
+     */
+    getTimeUntilNextSlot() {
+        if (!this.limiter)
+            return 0;
+        const now = Date.now();
+        const windowStart = now - this.limiter.duration;
+        // Remove expired tokens
+        this.limiterTokens = this.limiterTokens.filter((t) => t > windowStart);
+        if (this.limiterTokens.length < this.limiter.max) {
+            return 0;
+        }
+        // Find oldest token and calculate when it expires
+        const oldestToken = Math.min(...this.limiterTokens);
+        return oldestToken + this.limiter.duration - now;
+    }
+    /** Get rate limiter info (for debugging/monitoring). */
+    getRateLimiterInfo() {
+        if (!this.limiter)
+            return null;
+        const now = Date.now();
+        const windowStart = now - this.limiter.duration;
+        const currentTokens = this.limiterTokens.filter((t) => t > windowStart).length;
+        return {
+            current: currentTokens,
+            max: this.limiter.max,
+            duration: this.limiter.duration,
+        };
+    }
+    /**
+     * Apply rate limiting (BullMQ v5 compatible).
+     * The worker will not process jobs until the rate limit expires.
+     */
+    rateLimit(expireTimeMs) {
+        if (expireTimeMs <= 0)
+            return;
+        // Fill rate limiter tokens to block processing
+        if (this.limiter) {
+            const now = Date.now();
+            for (let i = 0; i < this.limiter.max; i++) {
+                this.limiterTokens.push(now + expireTimeMs - this.limiter.duration);
+            }
+        }
+        this.rateLimitExpiration = Date.now() + expireTimeMs;
+    }
+    /** Check if worker is currently rate limited. */
+    isRateLimited() {
+        return Date.now() < this.rateLimitExpiration;
+    }
+}
+//# sourceMappingURL=workerRateLimiter.js.map

package/dist/client/worker/workerRateLimiter.js.map

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

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

@@ -8,6 +8,8 @@
  * - LimiterManager: rate limiting + concurrency
  * - DependencyTracker: job dependency tracking
  * - TemporalManager: temporal index + delayed job tracking
+ * - WaiterManager: job availability notifications
+ * - ShardCounters: running counters for O(1) stats
  */
 import type { Job, JobId } from '../types/job';
 import type { QueueState } from '../types/queue';
@@ -16,15 +18,8 @@ import { FailureReason } from '../types/dlq';
 import type { StallConfig } from '../types/stall';
 import type { UniqueKeyEntry } from '../types/deduplication';
 import { IndexedPriorityQueue } from './priorityQueue';
-/** Shard statistics counters for O(1) stats retrieval */
-export interface ShardStats {
-    /** Total jobs in all queues (waiting + delayed) */
-    queuedJobs: number;
-    /** Jobs with runAt > now at time of push */
-    delayedJobs: number;
-    /** Total jobs in DLQ */
-    dlqJobs: number;
-}
+import { type ShardStats } from './shardCounters';
+export type { ShardStats } from './shardCounters';
 /**
  * Shard contains:
  * - Queues (waiting + delayed jobs)
@@ -46,22 +41,14 @@ export declare class Shard {
     private readonly dependencyTracker;
     /** Temporal manager for index and delayed jobs */
     private readonly temporalManager;
-    /** Running counters for O(1) stats - updated on every operation */
-    private readonly stats;
+    /** Waiter manager for job availability notifications */
+    private readonly waiterManager;
+    /** Running counters for O(1) stats */
+    private readonly counters;
     /** Active FIFO groups per queue */
     readonly activeGroups: Map<string, Set<string>>;
-    /** Waiter entry with cancellation flag for O(1) cleanup */
-    private readonly waiters;
-    /** Threshold for triggering full waiters cleanup */
-    private static readonly WAITERS_CLEANUP_THRESHOLD;
-    /** Pending notification flag - set when notify() is called with no waiters */
-    private pendingNotification;
     constructor();
-    /** Notify that jobs are available - wakes first non-cancelled waiter */
     notify(): void;
-    /** Remove all cancelled waiters from the array */
-    private cleanupWaiters;
-    /** Wait for a job to become available (with timeout) */
     waitForJob(timeoutMs: number): Promise<void>;
     getQueue(name: string): IndexedPriorityQueue;
     getState(name: string): QueueState;
@@ -87,7 +74,6 @@ export declare class Shard {
     tryAcquireConcurrency(queue: string): boolean;
     releaseConcurrency(queue: string): void;
     get queueState(): Map<string, QueueState>;
-    /** Clear limiter data for a queue (rate limits, concurrency) */
     clearQueueLimiters(queue: string): void;
     releaseJobResources(queue: string, uniqueKey: string | null, groupId: string | null): void;
     get waitingDeps(): Map<JobId, Job>;
@@ -104,7 +90,6 @@ export declare class Shard {
     getStallConfig(queue: string): StallConfig;
     setStallConfig(queue: string, config: Partial<StallConfig>): void;
     addToDlq(job: Job, reason?: FailureReason, error?: string | null): DlqEntry;
-    /** Restore an existing DlqEntry (for recovery from persistence) */
     restoreDlqEntry(queue: string, entry: DlqEntry): void;
     getDlqEntries(queue: string): DlqEntry[];
     getDlq(queue: string, count?: number): Job[];

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

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

package/dist/domain/queue/shard.js

@@ -8,6 +8,8 @@
  * - LimiterManager: rate limiting + concurrency
  * - DependencyTracker: job dependency tracking
  * - TemporalManager: temporal index + delayed job tracking
+ * - WaiterManager: job availability notifications
+ * - ShardCounters: running counters for O(1) stats
  */
 import { IndexedPriorityQueue } from './priorityQueue';
 import { UniqueKeyManager } from './uniqueKeyManager';
@@ -15,6 +17,8 @@ import { DlqShard } from './dlqShard';
 import { LimiterManager } from './limiterManager';
 import { DependencyTracker } from './dependencyTracker';
 import { TemporalManager } from './temporalManager';
+import { WaiterManager } from './waiterManager';
+import { ShardCounters } from './shardCounters';
 /**
  * Shard contains:
  * - Queues (waiting + delayed jobs)
@@ -36,76 +40,29 @@ export class Shard {
     dependencyTracker = new DependencyTracker();
     /** Temporal manager for index and delayed jobs */
     temporalManager = new TemporalManager();
-    /** Running counters for O(1) stats - updated on every operation */
-    stats = {
-        queuedJobs: 0,
-        delayedJobs: 0,
-        dlqJobs: 0,
-    };
+    /** Waiter manager for job availability notifications */
+    waiterManager = new WaiterManager();
+    /** Running counters for O(1) stats */
+    counters;
     /** Active FIFO groups per queue */
     activeGroups = new Map();
-    /** Waiter entry with cancellation flag for O(1) cleanup */
-    waiters = [];
-    /** Threshold for triggering full waiters cleanup */
-    static WAITERS_CLEANUP_THRESHOLD = 1000;
-    /** Pending notification flag - set when notify() is called with no waiters */
-    pendingNotification = false;
     constructor() {
+        this.counters = new ShardCounters(this.temporalManager);
         this.dlqManager = new DlqShard({
             incrementDlq: () => {
-                this.incrementDlq();
+                this.counters.incrementDlq();
             },
             decrementDlq: (count) => {
-                this.decrementDlq(count);
+                this.counters.decrementDlq(count);
             },
         });
     }
-    /** Notify that jobs are available - wakes first non-cancelled waiter */
+    // ============ Waiter Management (delegated) ============
     notify() {
-        // Clean up leading cancelled waiters first
-        while (this.waiters.length > 0 && this.waiters[0].cancelled) {
-            this.waiters.shift();
-        }
-        // Wake the first active waiter
-        const waiter = this.waiters.shift();
-        if (waiter && !waiter.cancelled) {
-            waiter.resolve();
-        }
-        else {
-            // No active waiter - set pending flag so next waitForJob returns immediately
-            this.pendingNotification = true;
-        }
-        // Periodic full cleanup when array grows too large
-        if (this.waiters.length > Shard.WAITERS_CLEANUP_THRESHOLD) {
-            this.cleanupWaiters();
-        }
-    }
-    /** Remove all cancelled waiters from the array */
-    cleanupWaiters() {
-        const active = this.waiters.filter((w) => !w.cancelled);
-        this.waiters.length = 0;
-        this.waiters.push(...active);
+        this.waiterManager.notify();
     }
-    /** Wait for a job to become available (with timeout) */
     waitForJob(timeoutMs) {
-        if (timeoutMs <= 0)
-            return Promise.resolve();
-        // Check for pending notification - if set, clear it and return immediately
-        if (this.pendingNotification) {
-            this.pendingNotification = false;
-            return Promise.resolve();
-        }
-        return new Promise((resolve) => {
-            const waiter = { resolve, cancelled: false };
-            const cleanup = () => {
-                if (waiter.cancelled)
-                    return;
-                waiter.cancelled = true;
-                resolve();
-            };
-            this.waiters.push(waiter);
-            setTimeout(cleanup, timeoutMs);
-        });
+        return this.waiterManager.waitForJob(timeoutMs);
     }
     // ============ Queue Operations ============
     getQueue(name) {
@@ -127,7 +84,7 @@ export class Shard {
     }
     resume(name) {
         this.limiterManager.resume(name);
-        this.notify();
+        this.waiterManager.notify();
     }
     // ============ Unique Key Management (delegated) ============
     isUniqueAvailable(queue, key) {
@@ -194,7 +151,6 @@ export class Shard {
     get queueState() {
         return this.limiterManager.getStateMap();
     }
-    /** Clear limiter data for a queue (rate limits, concurrency) */
     clearQueueLimiters(queue) {
         this.limiterManager.deleteQueue(queue);
     }
@@ -266,7 +222,6 @@ export class Shard {
     addToDlq(job, reason = "unknown" /* FailureReason.Unknown */, error = null) {
         return this.dlqManager.add(job, reason, error);
     }
-    /** Restore an existing DlqEntry (for recovery from persistence) */
     restoreDlqEntry(queue, entry) {
         this.dlqManager.restoreEntry(queue, entry);
     }
@@ -322,49 +277,34 @@ export class Shard {
         }
         return counts;
     }
-    // ============ Running Counters (O(1) Stats) ============
+    // ============ Running Counters (delegated) ============
     getStats() {
-        return { ...this.stats };
+        return this.counters.getStats();
     }
     getInternalSizes() {
         const sizes = this.temporalManager.getSizes();
-        return { ...sizes, waiters: this.waiters.length };
+        return { ...sizes, waiters: this.waiterManager.length };
     }
     incrementQueued(jobId, isDelayed, createdAt, queue, runAt) {
-        this.stats.queuedJobs++;
-        if (isDelayed) {
-            this.stats.delayedJobs++;
-            if (runAt !== undefined) {
-                this.temporalManager.addDelayed(jobId, runAt);
-            }
-        }
-        if (createdAt !== undefined && queue !== undefined) {
-            this.temporalManager.addToIndex(createdAt, jobId, queue);
-        }
+        this.counters.incrementQueued(jobId, isDelayed, createdAt, queue, runAt);
     }
     decrementQueued(jobId) {
-        this.stats.queuedJobs = Math.max(0, this.stats.queuedJobs - 1);
-        if (this.temporalManager.removeDelayed(jobId)) {
-            this.stats.delayedJobs = Math.max(0, this.stats.delayedJobs - 1);
-        }
+        this.counters.decrementQueued(jobId);
     }
     incrementDlq() {
-        this.stats.dlqJobs++;
+        this.counters.incrementDlq();
     }
     decrementDlq(count = 1) {
-        this.stats.dlqJobs = Math.max(0, this.stats.dlqJobs - count);
+        this.counters.decrementDlq(count);
     }
     refreshDelayedCount(now) {
-        const readyCount = this.temporalManager.refreshDelayed(now);
-        this.stats.delayedJobs = Math.max(0, this.stats.delayedJobs - readyCount);
+        this.counters.refreshDelayedCount(now);
     }
     resetQueuedCounters() {
-        this.stats.queuedJobs = 0;
-        this.stats.delayedJobs = 0;
-        this.temporalManager.clearDelayed();
+        this.counters.resetQueuedCounters();
     }
     resetDlqCounter() {
-        this.stats.dlqJobs = 0;
+        this.counters.resetDlqCounter();
     }
     // ============ Temporal Index (delegated) ============
     getOldJobs(queue, thresholdMs, limit) {
@@ -400,8 +340,8 @@ export class Shard {
         }
         q.clear();
         this.temporalManager.clearIndexForQueue(queue);
-        this.stats.queuedJobs = Math.max(0, this.stats.queuedJobs - count);
-        this.stats.delayedJobs = this.temporalManager.delayedCount;
+        this.counters.adjustQueued(-count);
+        this.counters.syncDelayedCount();
         return { count, jobIds };
     }
     obliterate(queue) {
@@ -410,13 +350,13 @@ export class Shard {
             for (const job of q.values()) {
                 this.temporalManager.removeDelayed(job.id);
             }
-            this.stats.queuedJobs = Math.max(0, this.stats.queuedJobs - q.size);
+            this.counters.adjustQueued(-q.size);
         }
         const dlqCount = this.dlqManager.deleteQueue(queue);
         if (dlqCount > 0) {
-            this.stats.dlqJobs = Math.max(0, this.stats.dlqJobs - dlqCount);
+            this.counters.adjustDlq(-dlqCount);
         }
-        this.stats.delayedJobs = this.temporalManager.delayedCount;
+        this.counters.syncDelayedCount();
         this.temporalManager.clearIndexForQueue(queue);
         this.queues.delete(queue);
         this.uniqueKeyManager.clearQueue(queue);