jsgar 4.13.2 → 4.13.3

package/dist/gar.umd.js

@@ -1179,7 +1179,9 @@
          * @param {Object} opts - Named subscription options (fields below).
          * @param {string} opts.name - Subscription name
          * @param {string} [opts.subscriptionMode='Streaming'] - Subscription mode
-         * @param {string|Array<string>|null} [keyName=null] - Key name(s)
+         * @param {string|Array<string>|Array<number>|null} [keyName=null] - Key name(s), matched
+         *     exactly via a synthesized key_filter alternation (keys are NOT created by
+         *     subscribing); an array of integers passes through as the wire key_id_list
          * @param {string|Array<string>|null} [topicName=null] - Topic name(s)
          * @param {string|Array<string>|null} [className=null] - Class name(s)
          * @param {string|null} [keyFilter=null] - Key filter regex (cannot use with keyName)
@@ -1258,16 +1260,24 @@
                 referencingClasses = referencingClassList;
             }
 
-            let singleClass = Array.isArray(classList) && classList.length === 1 ? classList[0] : null;
-
-            // Convert keyName to array
+            // Convert keyName to array. Subscribing must NOT create keys: names are no longer
+            // introduced to build a key_id_list (the old behavior materialized every named key on
+            // the server). Names become an exact-match alternation key_filter instead — the server
+            // recognizes the literal-alternation shape and builds a trie, skipping the full
+            // regex->DFA compilation. An array of integers passes through as key_id_list verbatim
+            // (the caller already holds real key ids).
             let keyNames = [];
             if (typeof keyName === 'string') {
                 keyNames = [keyName];
             } else if (Array.isArray(keyName)) {
                 keyNames = keyName;
             }
-            const keyIdList = keyNames.map(x => this.getAndPossiblyIntroduceKeyId(x, singleClass));
+            let keyIdList = [];
+            if (keyNames.length > 0 && keyNames.every(Number.isInteger)) {
+                keyIdList = keyNames;
+            } else if (keyNames.length > 0) {
+                keyFilter = keyNames.map(GARClient.escapeRegex).join('|');
+            }
 
             // Convert topicName to array
             let topicNames = [];
@@ -1849,6 +1859,16 @@
             });
         }
 
+        /**
+         * Escape TRS-regex metacharacters so `name` matches literally (TRS regexes match the
+         * whole string, so an escaped name is an exact-match alternative in a key_filter).
+         * @param {string} name
+         * @returns {string}
+         */
+        static escapeRegex(name) {
+            return String(name).replace(/[\\.^$|?*+()[\]{}]/g, '\\$&');
+        }
+
         static _generateUUID() {
             const bytes = new Uint8Array(16);
             if (typeof globalThis.crypto !== 'undefined' && globalThis.crypto.getRandomValues)

package/gar.js

@@ -1172,7 +1172,9 @@ class GARClient {
      * @param {Object} opts - Named subscription options (fields below).
      * @param {string} opts.name - Subscription name
      * @param {string} [opts.subscriptionMode='Streaming'] - Subscription mode
-     * @param {string|Array<string>|null} [keyName=null] - Key name(s)
+     * @param {string|Array<string>|Array<number>|null} [keyName=null] - Key name(s), matched
+     *     exactly via a synthesized key_filter alternation (keys are NOT created by
+     *     subscribing); an array of integers passes through as the wire key_id_list
      * @param {string|Array<string>|null} [topicName=null] - Topic name(s)
      * @param {string|Array<string>|null} [className=null] - Class name(s)
      * @param {string|null} [keyFilter=null] - Key filter regex (cannot use with keyName)
@@ -1251,16 +1253,24 @@ class GARClient {
             referencingClasses = referencingClassList;
         }
 
-        let singleClass = Array.isArray(classList) && classList.length === 1 ? classList[0] : null;
-
-        // Convert keyName to array
+        // Convert keyName to array. Subscribing must NOT create keys: names are no longer
+        // introduced to build a key_id_list (the old behavior materialized every named key on
+        // the server). Names become an exact-match alternation key_filter instead — the server
+        // recognizes the literal-alternation shape and builds a trie, skipping the full
+        // regex->DFA compilation. An array of integers passes through as key_id_list verbatim
+        // (the caller already holds real key ids).
         let keyNames = [];
         if (typeof keyName === 'string') {
             keyNames = [keyName];
         } else if (Array.isArray(keyName)) {
             keyNames = keyName;
         }
-        const keyIdList = keyNames.map(x => this.getAndPossiblyIntroduceKeyId(x, singleClass));
+        let keyIdList = [];
+        if (keyNames.length > 0 && keyNames.every(Number.isInteger)) {
+            keyIdList = keyNames;
+        } else if (keyNames.length > 0) {
+            keyFilter = keyNames.map(GARClient.escapeRegex).join('|');
+        }
 
         // Convert topicName to array
         let topicNames = [];
@@ -1842,6 +1852,16 @@ class GARClient {
         });
     }
 
+    /**
+     * Escape TRS-regex metacharacters so `name` matches literally (TRS regexes match the
+     * whole string, so an escaped name is an exact-match alternative in a key_filter).
+     * @param {string} name
+     * @returns {string}
+     */
+    static escapeRegex(name) {
+        return String(name).replace(/[\\.^$|?*+()[\]{}]/g, '\\$&');
+    }
+
     static _generateUUID() {
         const bytes = new Uint8Array(16);
         if (typeof globalThis.crypto !== 'undefined' && globalThis.crypto.getRandomValues)

package/package.json

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