qrusty-client 0.6.0 → 0.8.0

package/README.md

@@ -8,6 +8,7 @@ Node.js client for the qrusty priority queue server API.
 - Publish, consume, ack, and purge messages
 - List and manage queues
 - Promise-based API using axios
+- WebSocket client (`WsSession`) for push-based delivery
 
 ## Installation
 
@@ -17,8 +18,10 @@ npm install qrusty-client
 
 ## Usage
 
+### HTTP client
+
 ```js
-const QrustyClient = require("qrusty-client");
+const { QrustyClient } = require("qrusty-client");
 const client = new QrustyClient("http://localhost:6784");
 
 (async () => {
@@ -31,6 +34,30 @@ const client = new QrustyClient("http://localhost:6784");
 })();
 ```
 
+### WebSocket client
+
+```js
+const { WsSession } = require("qrusty-client");
+
+(async () => {
+  const session = new WsSession("ws://localhost:6784");
+  await session.connect();
+
+  const id = await session.publish("orders", "hello", 10);
+
+  for await (const msg of session.subscribe("orders")) {
+    console.log(msg.payload);
+    await session.ack(msg.queue, msg.id);
+    break; // or keep processing
+  }
+
+  await session.close();
+})();
+```
+
+If the server closes the connection, all pending `publish`/`ack`/`nack` calls
+reject immediately and any active `subscribe` iterators stop iterating.
+
 ## Documentation
 
 Generate HTML docs with:

package/index.js

@@ -190,6 +190,7 @@ class QrustyClient {
 }
 
 // ---------------------------------------------------------------------------
+// Implements: WS-0019
 // WsSession – WebSocket client (WS-0019)
 // ---------------------------------------------------------------------------
 
@@ -248,9 +249,26 @@ class WsSession {
       this._ws.once("open", resolve);
       this._ws.once("error", reject);
       this._ws.on("message", (raw) => this._onMessage(raw));
+      this._ws.on("close", () => this._onClose());
     });
   }
 
+  _onClose() {
+    // Reject all pending request promises so callers unblock immediately.
+    for (const { reject } of this._pending.values()) {
+      reject(new Error("connection closed"));
+    }
+    this._pending.clear();
+
+    // Reject all delivery waiters so any active subscribe iterators unblock.
+    for (const waiters of this._deliverQueues.values()) {
+      for (const { reject } of waiters.splice(0)) {
+        reject(new Error("connection closed"));
+      }
+    }
+    this._deliverQueues.clear();
+  }
+
   /** Close the connection gracefully. */
   async close() {
     return new Promise((resolve) => {
@@ -429,6 +447,17 @@ class WsSession {
     const resp = await this._request({ type: "batch-nack", queue, ids });
     return { unlocked: resp.unlocked, dropped: resp.dropped };
   }
+
+  /**
+   * Renew (extend) the lock on a message by 30 seconds.
+   * Implements: WS-0020
+   * @param {string} queue
+   * @param {string} id
+   * @returns {Promise<void>}
+   */
+  async renew(queue, id) {
+    await this._request({ type: "renew", queue, id });
+  }
 }
 
 module.exports = { QrustyClient, WsSession };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qrusty-client",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "Node.js client for the qrusty priority queue server API.",
   "main": "index.js",
   "author": "Gordon Greene <greeng3@obscure-reference.com>",