bunqueue-client 0.1.8 → 0.1.9

package/CHANGELOG.md

@@ -5,6 +5,18 @@ All notable changes to `bunqueue-client` (TypeScript SDK) are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.9] - 2026-07-14
+
+Conformance-suite driven: the SDK is now certified by the cross-language
+conformance kit (`sdk/conformance`, 17/17) against the formal wire spec
+(`docs/protocol.md`).
+
+### Fixed
+
+- **`drain()` now returns the number of removed jobs** (was `void`,
+  silently discarding the wire `count` — the "discarded return value"
+  class the conformance suite checks for).
+
 ## [0.1.8] - 2026-07-14
 
 Spec-alignment audit against the core protocol. Every fix ships with a repro

package/dist/queue-control.d.ts

@@ -9,7 +9,8 @@ export declare const controlMethods: {
     pause(this: Ctx): Promise<void>;
     resume(this: Ctx): Promise<void>;
     isPaused(this: Ctx): Promise<boolean>;
-    drain(this: Ctx): Promise<void>;
+    /** Remove all waiting/delayed jobs; returns how many were dropped. */
+    drain(this: Ctx): Promise<number>;
     obliterate(this: Ctx): Promise<void>;
     /** Remove old jobs; returns how many were removed. */
     clean(this: Ctx, graceMs: number, limit?: number, state?: JobStateName): Promise<number>;

package/dist/queue-control.js

@@ -15,8 +15,10 @@ export const controlMethods = {
     async isPaused() {
         return (await this.call({ cmd: 'IsPaused', queue: this.name })).paused === true;
     },
+    /** Remove all waiting/delayed jobs; returns how many were dropped. */
     async drain() {
-        await this.call({ cmd: 'Drain', queue: this.name });
+        const response = await this.call({ cmd: 'Drain', queue: this.name });
+        return response.count ?? 0;
     },
     async obliterate() {
         await this.call({ cmd: 'Obliterate', queue: this.name });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bunqueue-client",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Cross-runtime TypeScript client for the bunqueue job queue server — Node.js, Bun, Deno and Cloudflare Workers",
   "license": "MIT",
   "type": "module",

package/src/queue-control.ts

@@ -25,8 +25,10 @@ export const controlMethods = {
     return (await this.call<PausedResponse>({ cmd: 'IsPaused', queue: this.name })).paused === true;
   },
 
-  async drain(this: Ctx): Promise<void> {
-    await this.call({ cmd: 'Drain', queue: this.name });
+  /** Remove all waiting/delayed jobs; returns how many were dropped. */
+  async drain(this: Ctx): Promise<number> {
+    const response = await this.call<{ count?: number }>({ cmd: 'Drain', queue: this.name });
+    return response.count ?? 0;
   },
 
   async obliterate(this: Ctx): Promise<void> {