jsgar 4.13.3 → 4.13.6

package/dist/gar.umd.js

@@ -1551,27 +1551,48 @@
         }
 
         /**
-         * Delete a key by name if it exists in the localKeyMap. Safe to call multiple times.
+         * Remove a single class from a key by sending a KeyIntroduction with deleted_class set, if the
+         * key exists in the localKeyMap. Safe to call multiple times. The key may still exist on the
+         * server in other classes, so the localKeyMap entry is preserved. Careful: every record that
+         * applied to className but to no remaining class is deleted.
          * @param {string} keyName - Key name
-         * @param {string|null} [className=null] - If set, removes the key from this class only via
-         *     a KeyIntroduction with deleted_class set; the key may still exist on the server in
-         *     other classes and the localKeyMap entry is preserved. If unset, sends DeleteKey to
-         *     remove the key entirely and forgets the local id so a future
-         *     getAndPossiblyIntroduceKeyId(keyName) re-introduces with a fresh id.
+         * @param {string} className - Class to remove from the key
+         * @param {string|Array<string>|null} [downgradeToClassList=null] - If set, populates
+         *     key_introduction::class_list in the same message — the classes the key should apply to
+         *     alongside the removal. A single key_introduction may both add classes (class_list) and
+         *     remove one (deleted_class).
          */
-        deleteKey(keyName, className = null) {
+        deleteClass(keyName, className, downgradeToClassList = null) {
             const keyId = this.localKeyMap.get(keyName);
             if (keyId === undefined) return;
+            const value = { key_id: keyId, name: keyName, deleted_class: className };
+            if (downgradeToClassList) {
+                value.class_list = typeof downgradeToClassList === 'string'
+                    ? downgradeToClassList.split(/\s+/).filter(Boolean)
+                    : downgradeToClassList;
+            }
+            this.sendMessage({ message_type: 'KeyIntroduction', value });
+        }
+
+        /**
+         * Delete a key by name if it exists in the localKeyMap. Safe to call multiple times.
+         * @param {string} keyName - Key name
+         * @param {string|null} [className=null] - If set, delegates to deleteClass (KeyIntroduction
+         *     with deleted_class set); the key may still exist on the server in other classes and the
+         *     localKeyMap entry is preserved. If unset, sends DeleteKey to remove the key entirely and
+         *     forgets the local id so a future getAndPossiblyIntroduceKeyId(keyName) re-introduces with
+         *     a fresh id.
+         */
+        deleteKey(keyName, className = null) {
             if (className) {
-                this.sendMessage({
-                    message_type: 'KeyIntroduction',
-                    value: { key_id: keyId, name: keyName, deleted_class: className },
-                });
-            } else {
-                this.publishDeleteKey(keyId);
-                // Forget the local id so future re-introduction allocates a new one.
-                this.localKeyMap.delete(keyName);
+                this.deleteClass(keyName, className);
+                return;
             }
+            const keyId = this.localKeyMap.get(keyName);
+            if (keyId === undefined) return;
+            this.publishDeleteKey(keyId);
+            // Forget the local id so future re-introduction allocates a new one.
+            this.localKeyMap.delete(keyName);
         }
 
         /**
@@ -1673,6 +1694,16 @@
             this.compareExchangeRecordWithIds(keyId, topicId, test, value);
         }
 
+        /**
+         * Declare the subscription group for subsequent operations whose results the server tags by group —
+         * notably compare-exchange. Send this BEFORE a compareExchangeRecord and register the result handler
+         * on the same group, so the result routes to it (the server reflects this group ahead of the result).
+         * @param {number} subscriptionGroup - The group to attribute following results to.
+         */
+        sendActiveSubscriptionGroup(subscriptionGroup) {
+            this.sendMessage({ message_type: 'ActiveSubscription', value: { subscription_group: subscriptionGroup } });
+        }
+
         /**
          * Query GAR deployment routing to find servers with matching publications.
          * Mirrors the Python client's route_query implementation.

package/gar.js

@@ -1544,27 +1544,48 @@ class GARClient {
     }
 
     /**
-     * Delete a key by name if it exists in the localKeyMap. Safe to call multiple times.
+     * Remove a single class from a key by sending a KeyIntroduction with deleted_class set, if the
+     * key exists in the localKeyMap. Safe to call multiple times. The key may still exist on the
+     * server in other classes, so the localKeyMap entry is preserved. Careful: every record that
+     * applied to className but to no remaining class is deleted.
      * @param {string} keyName - Key name
-     * @param {string|null} [className=null] - If set, removes the key from this class only via
-     *     a KeyIntroduction with deleted_class set; the key may still exist on the server in
-     *     other classes and the localKeyMap entry is preserved. If unset, sends DeleteKey to
-     *     remove the key entirely and forgets the local id so a future
-     *     getAndPossiblyIntroduceKeyId(keyName) re-introduces with a fresh id.
+     * @param {string} className - Class to remove from the key
+     * @param {string|Array<string>|null} [downgradeToClassList=null] - If set, populates
+     *     key_introduction::class_list in the same message — the classes the key should apply to
+     *     alongside the removal. A single key_introduction may both add classes (class_list) and
+     *     remove one (deleted_class).
      */
-    deleteKey(keyName, className = null) {
+    deleteClass(keyName, className, downgradeToClassList = null) {
         const keyId = this.localKeyMap.get(keyName);
         if (keyId === undefined) return;
+        const value = { key_id: keyId, name: keyName, deleted_class: className };
+        if (downgradeToClassList) {
+            value.class_list = typeof downgradeToClassList === 'string'
+                ? downgradeToClassList.split(/\s+/).filter(Boolean)
+                : downgradeToClassList;
+        }
+        this.sendMessage({ message_type: 'KeyIntroduction', value });
+    }
+
+    /**
+     * Delete a key by name if it exists in the localKeyMap. Safe to call multiple times.
+     * @param {string} keyName - Key name
+     * @param {string|null} [className=null] - If set, delegates to deleteClass (KeyIntroduction
+     *     with deleted_class set); the key may still exist on the server in other classes and the
+     *     localKeyMap entry is preserved. If unset, sends DeleteKey to remove the key entirely and
+     *     forgets the local id so a future getAndPossiblyIntroduceKeyId(keyName) re-introduces with
+     *     a fresh id.
+     */
+    deleteKey(keyName, className = null) {
         if (className) {
-            this.sendMessage({
-                message_type: 'KeyIntroduction',
-                value: { key_id: keyId, name: keyName, deleted_class: className },
-            });
-        } else {
-            this.publishDeleteKey(keyId);
-            // Forget the local id so future re-introduction allocates a new one.
-            this.localKeyMap.delete(keyName);
+            this.deleteClass(keyName, className);
+            return;
         }
+        const keyId = this.localKeyMap.get(keyName);
+        if (keyId === undefined) return;
+        this.publishDeleteKey(keyId);
+        // Forget the local id so future re-introduction allocates a new one.
+        this.localKeyMap.delete(keyName);
     }
 
     /**
@@ -1666,6 +1687,16 @@ class GARClient {
         this.compareExchangeRecordWithIds(keyId, topicId, test, value);
     }
 
+    /**
+     * Declare the subscription group for subsequent operations whose results the server tags by group —
+     * notably compare-exchange. Send this BEFORE a compareExchangeRecord and register the result handler
+     * on the same group, so the result routes to it (the server reflects this group ahead of the result).
+     * @param {number} subscriptionGroup - The group to attribute following results to.
+     */
+    sendActiveSubscriptionGroup(subscriptionGroup) {
+        this.sendMessage({ message_type: 'ActiveSubscription', value: { subscription_group: subscriptionGroup } });
+    }
+
     /**
      * Query GAR deployment routing to find servers with matching publications.
      * Mirrors the Python client's route_query implementation.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jsgar",
-  "version": "4.13.3",
+  "version": "4.13.6",
   "description": "A Javascript client for the GAR protocol",
   "type": "module",
   "main": "dist/gar.umd.js",