qrusty-client 0.17.3 → 0.17.4

package/index.js

@@ -27,12 +27,22 @@ class QrustyClient {
    * @param {string} name
    * @param {string} [ordering="MaxFirst"] - One of: Fifo | MinFirst | MaxFirst
    * @param {boolean} [allowDuplicates=true]
+   * @param {string} [priorityKind="Numeric"] - One of: Numeric | Text
    * @returns {Promise<void>}
    */
-  async createQueue(name, ordering = "MaxFirst", allowDuplicates = true) {
+  async createQueue(
+    name,
+    ordering = "MaxFirst",
+    allowDuplicates = true,
+    priorityKind = "Numeric",
+  ) {
     const data = {
       name,
-      config: { ordering, allow_duplicates: allowDuplicates },
+      config: {
+        ordering,
+        allow_duplicates: allowDuplicates,
+        priority_kind: priorityKind,
+      },
     };
     await axios.post(`${this.baseUrl}/create-queue`, data);
   }
@@ -187,6 +197,50 @@ class QrustyClient {
     const resp = await axios.get(`${this.baseUrl}/queues`);
     return resp.data;
   }
+
+  /**
+   * Purge all messages from all queues
+   * @returns {Promise<object>}
+   */
+  async purgeAll() {
+    const resp = await axios.post(`${this.baseUrl}/purge-all`);
+    return resp.data;
+  }
+
+  /**
+   * Delete all queues and their messages
+   * @returns {Promise<object>}
+   */
+  async deleteAll() {
+    const resp = await axios.post(`${this.baseUrl}/delete-all`);
+    return resp.data;
+  }
+
+  /**
+   * Batch-acknowledge multiple messages
+   * @param {string} queue
+   * @param {string} consumerId
+   * @param {string[]} messageIds
+   * @returns {Promise<object>}
+   */
+  async ackBatch(queue, consumerId, messageIds) {
+    const data = { consumer_id: consumerId, message_ids: messageIds };
+    const resp = await axios.post(`${this.baseUrl}/ack-batch/${queue}`, data);
+    return resp.data;
+  }
+
+  /**
+   * Batch-negative-acknowledge multiple messages
+   * @param {string} queue
+   * @param {string} consumerId
+   * @param {string[]} messageIds
+   * @returns {Promise<object>}
+   */
+  async nackBatch(queue, consumerId, messageIds) {
+    const data = { consumer_id: consumerId, message_ids: messageIds };
+    const resp = await axios.post(`${this.baseUrl}/nack-batch/${queue}`, data);
+    return resp.data;
+  }
 }
 
 // ---------------------------------------------------------------------------
@@ -235,6 +289,7 @@ class WsSession {
     this._reqCounter = 0;
     this._pending = new Map(); // req_id → { resolve, reject }
     this._deliverQueues = new Map(); // queue → Array of waiting resolvers
+    this._logWaiters = []; // Array of { resolve, reject } for log entries
   }
 
   // -------------------------------------------------------------------------
@@ -267,6 +322,11 @@ class WsSession {
       }
     }
     this._deliverQueues.clear();
+
+    // Reject all log waiters.
+    for (const { reject } of this._logWaiters.splice(0)) {
+      reject(new Error("connection closed"));
+    }
   }
 
   /** Close the connection gracefully. */
@@ -320,6 +380,18 @@ class WsSession {
           });
         }
       }
+      return;
+    }
+
+    if (frame.type === "log") {
+      const { resolve } = this._logWaiters.shift() || {};
+      if (resolve) {
+        resolve({
+          timestamp: frame.timestamp,
+          level: frame.level,
+          message: frame.message,
+        });
+      }
     }
   }
 
@@ -345,7 +417,7 @@ class WsSession {
    * Publish a message to a queue.
    * @param {string} queue
    * @param {string} payload
-   * @param {number} [priority=0]
+   * @param {number|string} [priority=0]
    * @returns {Promise<string>} The assigned message id.
    */
   async publish(queue, payload, priority = 0) {
@@ -448,6 +520,54 @@ class WsSession {
     return { unlocked: resp.unlocked, dropped: resp.dropped };
   }
 
+  /**
+   * Replenish credits for a subscription on a queue.
+   * @param {string} queue
+   * @param {number} credits
+   * @returns {Promise<void>}
+   */
+  async grantCredits(queue, credits) {
+    await this._request({ type: "credit", queue, credits });
+  }
+
+  /**
+   * Subscribe to the server's log stream.
+   * Returns an AsyncIterable that yields log entry objects
+   * with timestamp, level, and message properties.
+   * @returns {AsyncIterable<{timestamp: string, level: string, message: string}>}
+   */
+  subscribeLogs() {
+    this._request({ type: "subscribe-logs" }).catch(() => {});
+
+    const self = this;
+    return {
+      [Symbol.asyncIterator]() {
+        return {
+          next() {
+            return new Promise((resolve, reject) => {
+              self._logWaiters.push({
+                resolve: (entry) => resolve({ value: entry, done: false }),
+                reject,
+              });
+            });
+          },
+          return() {
+            return Promise.resolve({ value: undefined, done: true });
+          },
+        };
+      },
+    };
+  }
+
+  /**
+   * Unsubscribe from the server's log stream.
+   * @returns {Promise<void>}
+   */
+  async unsubscribeLogs() {
+    await this._request({ type: "unsubscribe-logs" });
+    this._logWaiters.splice(0);
+  }
+
   /**
    * Renew (extend) the lock on a message by 30 seconds.
    * Implements: WS-0020

package/package.json

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