qrusty-client 0.20.9 → 0.21.0

package/index.js

@@ -498,6 +498,43 @@ class WsSession {
     await this._request({ type: "nack", queue, id });
   }
 
+  /**
+   * Negative-acknowledge a message and defer redelivery for
+   * `delaySecs` seconds.
+   *
+   * The broker parks the message in "in-escrow" state (no consumer
+   * owns it, but `locked_until > now`) so it is invisible to pop
+   * for the requested delay.  After the delay elapses the broker's
+   * periodic unlock-expired sweep promotes it back to available and
+   * the next eligible subscriber will see it.
+   *
+   * Intended for the throttle-yield pattern: a worker that is
+   * throttled against an upstream releases its credit immediately
+   * but tells the broker not to redeliver the message for at least
+   * the duration of the throttle backoff, so the next attempt
+   * happens after the cooldown rather than into it.
+   *
+   * `delaySecs` of 0 is allowed and is equivalent to a regular
+   * {@link nack} (the unlock-expired sweep picks it up on its next
+   * pass).
+   *
+   * @param {string} queue
+   * @param {string} id
+   * @param {number} delaySecs   Non-negative integer seconds.
+   * @returns {Promise<void>}
+   */
+  async nackWithDelay(queue, id, delaySecs) {
+    if (!Number.isInteger(delaySecs) || delaySecs < 0) {
+      throw new TypeError("delaySecs must be a non-negative integer");
+    }
+    await this._request({
+      type: "nack-with-delay",
+      queue,
+      id,
+      delay_secs: delaySecs,
+    });
+  }
+
   /**
    * Batch-acknowledge multiple messages.
    * @param {string} queue

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qrusty-client",
-  "version": "0.20.9",
+  "version": "0.21.0",
   "description": "Node.js client for the qrusty priority queue server API.",
   "main": "index.js",
   "author": "Gordon Greene <greeng3@obscure-reference.com>",
@@ -10,11 +10,11 @@
     "docs": "jsdoc -c jsdoc.json"
   },
   "dependencies": {
-    "axios": "^1.15.0",
-    "ws": "^8.20.0"
+    "axios": "^1.16.1",
+    "ws": "^8.21.0"
   },
   "devDependencies": {
-    "jest": "30.3.0",
+    "jest": "30.4.2",
     "jsdoc": "^4.0.5"
   }
 }