bunqueue 2.8.11 → 2.8.12

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

@@ -127,6 +127,8 @@ export declare class Worker<T = unknown, R = unknown> extends EventEmitter {
     private tryProcess;
     private registerPulledJobs;
     private getBufferedJob;
+    /** Put an item back at the front of the pending buffer (Issue #96). */
+    private requeueItem;
     /**
      * Get the next buffered job eligible for processing.
      * When group concurrency is enabled, skips jobs whose group is at capacity

package/dist/client/worker/worker.js

@@ -516,6 +516,19 @@ export class Worker extends EventEmitter {
                 }
             }
             if (item) {
+                // Issue #96: re-check the concurrency gate before starting. poll()
+                // checked it, but `await doPullBatch()` above — or a setImmediate path
+                // that bypasses poll() — may have filled the slots since. This check is
+                // atomic with startJob()'s activeJobs++ (no await between here and the
+                // increment), so it cannot overshoot. If full, requeue the job (we still
+                // own it via pulledJobIds/jobTokens) and let a freed slot pick it up.
+                if (this.activeJobs >= this.opts.concurrency) {
+                    this.requeueItem(item);
+                    this.pollTimer = setTimeout(() => {
+                        this.poll();
+                    }, 10);
+                    return;
+                }
                 this.consecutiveErrors = 0;
                 this.startJob(item.job, item.token);
             }
@@ -566,6 +579,15 @@ export class Worker extends EventEmitter {
         }
         return item;
     }
+    /** Put an item back at the front of the pending buffer (Issue #96). */
+    requeueItem(item) {
+        if (this.pendingJobsHead > 0) {
+            this.pendingJobs[--this.pendingJobsHead] = item;
+        }
+        else {
+            this.pendingJobs.unshift(item);
+        }
+    }
     /**
      * Get the next buffered job eligible for processing.
      * When group concurrency is enabled, skips jobs whose group is at capacity

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bunqueue",
-  "version": "2.8.11",
+  "version": "2.8.12",
   "description": "High-performance job queue for Bun & AI agents. SQLite persistence, cron scheduling, priorities, retries, DLQ, webhooks, native MCP server. Zero external dependencies.",
   "type": "module",
   "main": "dist/main.js",