jsgar 2.0.0 → 2.2.2

package/dist/gar.umd.js

@@ -50,7 +50,7 @@
             this.user = user;
             this.working_namespace = working_namespace;
             this.heartbeatTimeoutInterval = heartbeatTimeoutInterval;
-            this.version = 650704;
+            this.version = 650705;
 
             if (typeof window !== 'undefined' && window.location) {
                 this.application = window.location.href;
@@ -591,28 +591,80 @@
         /**
          * Send a subscription request using local IDs.
          * @param {string} name - Subscription name
-         * @param {string} [mode='Streaming'] - Subscription mode
+         * @param {string} [subscriptionMode='Streaming'] - Subscription mode
+         * @param {string} [mode] - Deprecated: use subscriptionMode instead
+         * @param {string} [subscriptionSet] - Subscription set identifier
+         * @param {string} [maxHistory] - Maximum history to include
+         * @param {number} [snapshotSizeLimit=0] - Limit snapshot size
+         * @param {number} [nagleInterval=0] - Nagle interval in milliseconds
+         * @param {number} [subscriptionGroup=0] - Subscription group ID for isolating callbacks
+         * @param {string} [density] - For performance tuning
+         * @param {boolean} [includeReferencedKeys=false] - Add keys from key references in matched records
+         * @param {boolean} [includeReferencingKeys=false] - Add keys that have one or more records referencing any matched keys
+         * @param {boolean} [includeAllNamespace=false] - Include keys and topics from all namespaces
+         * @param {number} [limit=0] - Limits records in initial snapshot (0 = all)
          * @param {string|Array<string>|null} [keyName=null] - Key name(s)
          * @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
-         * @param {string|null} [topicFilter=null] - Topic filter regex
-         * @param {boolean} [allMatchingKeys=false] - Retrieve all matching keys
-         * @param subscriptionGroup - Subscription group ID for isolating callbacks
-         * @param {number} [snapshotSizeLimit=0] - Limit snapshot size
+         * @param {string|null} [keyFilter=null] - Key filter regex (cannot use with keyName)
+         * @param {string|null} [excludeKeyFilter=null] - Exclude key filter regex (cannot use with keyName)
+         * @param {string|null} [topicFilter=null] - Topic filter regex (cannot use with topicName)
+         * @param {string|null} [excludeTopicFilter=null] - Exclude topic filter regex (cannot use with topicName)
+         * @param {string} [workingNamespace] - Namespace for matching relative paths
          */
         subscribe(
             name,
-            mode = 'Streaming',
+            subscriptionMode = 'Streaming',
+            mode = null,
+            subscriptionSet = null,
+            maxHistory = null,
+            snapshotSizeLimit = 0,
+            nagleInterval = 0,
+            subscriptionGroup = 0,
+            density = null,
+            includeReferencedKeys = false,
+            includeReferencingKeys = false,
+            includeAllNamespace = false,
+            limit = 0,
             keyName = null,
             topicName = null,
             className = null,
             keyFilter = null,
+            excludeKeyFilter = null,
             topicFilter = null,
-            allMatchingKeys = false,
-            subscriptionGroup = 0,
-            snapshotSizeLimit = 0
+            excludeTopicFilter = null,
+            workingNamespace = null
         ) {
+            // Handle deprecated mode parameter
+            if (mode !== null) {
+                console.warn('The "mode" parameter is deprecated. Use "subscriptionMode" instead.');
+                subscriptionMode = mode;
+            }
+
+            // Validate mutually exclusive parameters
+            if (keyName && (keyFilter || excludeKeyFilter)) {
+                throw new Error('keyName cannot be used with keyFilter or excludeKeyFilter');
+            }
+            
+            if (topicName && (topicFilter || excludeTopicFilter)) {
+                throw new Error('topicName cannot be used with topicFilter or excludeTopicFilter');
+            }
+
+            // Validate limit parameter usage
+            if (limit > 0 && subscriptionMode === 'Streaming') {
+                throw new Error('limit cannot be used with streaming subscriptions');
+            }
+
+            // Convert className to array
+            let classList = null;
+            if (typeof className === 'string') {
+                classList = className.split(/\s+/).filter(Boolean);
+            } else if (Array.isArray(className)) {
+                classList = className;
+            }
+
+            let singleClass = Array.isArray(classList) && classList.length === 1 ? classList[0] : null;
+
             // Convert keyName to array
             let keyNames = [];
             if (typeof keyName === 'string') {
@@ -620,7 +672,7 @@
             } else if (Array.isArray(keyName)) {
                 keyNames = keyName;
             }
-            const keyIdList = keyNames.map(x => this.getAndPossiblyIntroduceKeyId(x));
+            const keyIdList = keyNames.map(x => this.getAndPossiblyIntroduceKeyId(x, singleClass));
 
             // Convert topicName to array
             let topicNames = [];
@@ -631,29 +683,71 @@
             }
             const topicIdList = topicNames.map(x => this.getAndPossiblyIntroduceTopicId(x));
 
-            // Convert className to array
-            let classList = null;
-            if (typeof className === 'string') {
-                classList = className.split(/\s+/).filter(Boolean);
-            } else if (Array.isArray(className)) {
-                classList = className;
+            // Build subscription message, filtering out null/undefined values
+            const valueDict = {
+                subscription_mode: subscriptionMode,
+                name,
+            };
+            
+            // Add optional fields only if they have values
+            if (subscriptionSet !== null) {
+                valueDict.subscription_set = subscriptionSet;
+            }
+            if (maxHistory !== null) {
+                valueDict.max_history = maxHistory;
+            }
+            if (snapshotSizeLimit > 0) {
+                valueDict.snapshot_size_limit = snapshotSizeLimit;
+            }
+            if (nagleInterval > 0) {
+                valueDict.nagle_interval = nagleInterval;
+            }
+            if (subscriptionGroup > 0) {
+                valueDict.subscription_group = subscriptionGroup;
+            }
+            if (density !== null) {
+                valueDict.density = density;
+            }
+            if (includeReferencedKeys) {
+                valueDict.include_referenced_keys = includeReferencedKeys;
+            }
+            if (includeReferencingKeys) {
+                valueDict.include_referencing_keys = includeReferencingKeys;
+            }
+            if (includeAllNamespace) {
+                valueDict.include_all_namespace = includeAllNamespace;
+            }
+            if (limit > 0) {
+                valueDict.limit = limit;
+            }
+            if (keyIdList.length > 0) {
+                valueDict.key_id_list = keyIdList;
+            }
+            if (topicIdList.length > 0) {
+                valueDict.topic_id_list = topicIdList;
+            }
+            if (classList) {
+                valueDict.class_list = classList;
+            }
+            if (keyFilter) {
+                valueDict.key_filter = keyFilter;
+            }
+            if (excludeKeyFilter) {
+                valueDict.exclude_key_filter = excludeKeyFilter;
+            }
+            if (topicFilter) {
+                valueDict.topic_filter = topicFilter;
+            }
+            if (excludeTopicFilter) {
+                valueDict.exclude_topic_filter = excludeTopicFilter;
+            }
+            if (workingNamespace) {
+                valueDict.working_namespace = workingNamespace;
             }
 
             const subMsg = {
                 message_type: 'Subscribe',
-                value: {
-                    subscription_mode: mode,
-                    all_matching_keys: allMatchingKeys,
-                    snapshot_size_limit: snapshotSizeLimit,
-                    nagle_interval: 0,
-                    name,
-                    key_id_list: keyIdList,
-                    topic_id_list: topicIdList,
-                    class_list: classList,
-                    key_filter: keyFilter,
-                    topic_filter: topicFilter,
-                    subscription_group: subscriptionGroup
-                }
+                value: valueDict,
             };
             this.sendMessage(subMsg);
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jsgar",
-  "version": "2.0.0",
+  "version": "2.2.2",
   "description": "A Javascript client for the GAR protocol",
   "type": "module",
   "main": "dist/gar.umd.js",
@@ -27,7 +27,7 @@
     "@eslint/json": "^0.12.0",
     "@rollup/plugin-commonjs": "^24.0.0",
     "@rollup/plugin-node-resolve": "^15.0.0",
-    "eslint": "^9.25.0",
+    "eslint": "^9.33.0",
     "globals": "^16.0.0",
     "rollup": "^3.0.0"
   }