qrusty-client 0.6.0 → 0.7.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) => {

package/package.json

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