jsgar 2.2.2 → 3.0.0

package/dist/gar.umd.js

@@ -589,58 +589,62 @@
         }
 
         /**
-         * Send a subscription request using local IDs.
+         * Send an already-formatted subscription message
+         * @param {object} subscriptionMessageValue - json representation of the gar `subscribe` struct
+         */
+        subscribeFormatted(subscriptionMessageValue) {
+            const subMsg = {
+                message_type: 'Subscribe',
+                value: subscriptionMessageValue,
+            };
+            this.sendMessage(subMsg);
+        }
+
+        /**
+         * Send a subscription request
          * @param {string} name - Subscription name
          * @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 (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} [excludeKeyFilter=null] - Exclude key filter regex (cannot use with keyName)
          * @param {string|null} [excludeTopicFilter=null] - Exclude topic filter regex (cannot use with topicName)
-         * @param {string} [workingNamespace] - Namespace for matching relative paths
+         * @param {string|null} [maxHistory] - Maximum history to include
+         * @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 {string|null} [workingNamespace] - Namespace for matching relative paths
+         * @param {string|null} [density] - For performance tuning
+         * @param {number} [subscriptionGroup=0] - Subscription group ID for isolating callbacks
+         * @param {string|null} [subscriptionSet] - Subscription set identifier
+         * @param {number} [snapshotSizeLimit=0] - Limit snapshot size
+         * @param {number} [nagleInterval=0] - Nagle interval in milliseconds
+         * @param {number} [limit=0] - Limits records in initial snapshot (0 = all)
          */
         subscribe(
             name,
             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,
+            excludeKeyFilter = null,
             excludeTopicFilter = null,
-            workingNamespace = null
+            maxHistory = null,
+            includeReferencedKeys = false,
+            includeReferencingKeys = false,
+            includeAllNamespace = false,
+            workingNamespace = null,
+            density = null,
+            subscriptionGroup = 0,
+            subscriptionSet = null,
+            snapshotSizeLimit = 0,
+            nagleInterval = 0,
+            limit = 0
         ) {
-            // 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');
@@ -690,10 +694,10 @@
             };
             
             // Add optional fields only if they have values
-            if (subscriptionSet !== null) {
+            if (subscriptionSet) {
                 valueDict.subscription_set = subscriptionSet;
             }
-            if (maxHistory !== null) {
+            if (maxHistory) {
                 valueDict.max_history = maxHistory;
             }
             if (snapshotSizeLimit > 0) {
@@ -705,7 +709,7 @@
             if (subscriptionGroup > 0) {
                 valueDict.subscription_group = subscriptionGroup;
             }
-            if (density !== null) {
+            if (density) {
                 valueDict.density = density;
             }
             if (includeReferencedKeys) {
@@ -745,11 +749,56 @@
                 valueDict.working_namespace = workingNamespace;
             }
 
-            const subMsg = {
-                message_type: 'Subscribe',
-                value: valueDict,
-            };
-            this.sendMessage(subMsg);
+            this.subscribeFormatted(valueDict);
+        }
+
+        /**
+         * Wrapper to `subscribe` with a smaller set of arguments.
+         * @param {string} name - Subscription name
+         * @param {string} [subscriptionMode='Streaming'] - Subscription mode
+         * @param {number} [subscriptionGroup=0] - Subscription group ID for isolating callbacks
+         * @param {number} [snapshotSizeLimit=0] - Limit snapshot size
+         * @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 (cannot use with keyName)
+         * @param {string|null} [topicFilter=null] - Topic filter regex (cannot use with topicName)
+         * @param {string|null} [excludeKeyFilter=null] - Exclude key filter regex (cannot use with keyName)
+         * @param {string|null} [excludeTopicFilter=null] - Exclude topic filter regex (cannot use with topicName)
+         */
+        subscribeCommon(
+            name,
+            subscriptionMode = 'Streaming',
+            subscriptionGroup = 0,
+            snapshotSizeLimit = 0,
+            keyName = null,
+            topicName = null,
+            className = null,
+            keyFilter = null,
+            topicFilter = null,
+            excludeKeyFilter = null,
+            excludeTopicFilter = null,
+        ) {
+            this.subscribe(
+                name,
+                subscriptionMode,
+                keyName,
+                topicName,
+                className,
+                keyFilter,
+                topicFilter,
+                excludeKeyFilter,
+                excludeTopicFilter,
+                null,
+                false,
+                false,
+                false,
+                null,
+                null,
+                subscriptionGroup,
+                null,
+                snapshotSizeLimit
+            );
         }
 
         /**

package/package.json

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