jsgar 1.3.2 → 1.4.2

package/dist/gar.umd.js

@@ -387,7 +387,7 @@
         registerDefaultHandlers() {
             this.registerIntroductionHandler((version, interval, user, _schema) =>
                 this.log('INFO', `Connected to server: ${user}`));
-            this.registerHeartbeatHandler((u_milliseconds) => this.log('INFO', `Heartbeat received ${u_milliseconds}}`));
+            this.registerHeartbeatHandler((u_milliseconds) => this.log('INFO', `Heartbeat received ${u_milliseconds}ms`));
             this.registerLogoffHandler(() => this.log('INFO', 'Logoff received'));
             this.registerTopicIntroductionHandler((topicId, name) =>
                 this.log('DEBUG', `New server topic: ${name} (Server ID: ${topicId})`));
@@ -395,8 +395,7 @@
                 this.log('DEBUG', `New server key: ${name} (Server ID: ${keyId})`));
             this.registerDeleteKeyHandler((keyId) =>
                 this.log('DEBUG', `Delete key: ${this.serverKeyMap.get(keyId) || 'unknown'} (Server ID: ${keyId})`));
-            this.registerSubscriptionStatusHandler((name, status) =>
-                this.log('INFO', `Subscription ${name} status: ${status}`));
+            this.registerSubscriptionStatusHandler(this._defaultSubscriptionStatusHandler.bind(this));
             this.registerDeleteRecordHandler((keyId, topicId) =>
                 this.log('DEBUG', `Delete record: ${this.serverKeyMap.get(keyId) || 'unknown'} - ${this.serverTopicMap.get(topicId) || 'unknown'}`));
             this.registerRecordUpdateHandler((keyId, topicId, value) =>
@@ -404,6 +403,19 @@
             this.registerShutdownHandler(() => this.log('INFO', 'Shutdown received'));
         }
 
+        /**
+         * Default handler for subscription status messages.
+         * @param {string} name - Subscription name
+         * @param {string} status - Subscription status
+         */
+        _defaultSubscriptionStatusHandler(name, status) {
+            this.log('INFO', `Subscription ${name} status: ${status}`);
+            if (status === 'NeedsContinue') {
+                this.log('INFO', `Snapshot size limit reached, sending SubscribeContinue for ${name}`);
+                this.sendSubscribeContinue(name);
+            }
+        }
+
         /**
          * Start the client and send introduction message.
          */
@@ -423,13 +435,13 @@
         }
 
         /**
-         +  * Wait until in‑memory queue is empty and WebSocket bufferedAmount is zero.
-         +  */
+         * Wait until in-memory queue is empty and WebSocket bufferedAmount is zero.
+         */
         async _waitForDrain(pollMs = 50) {
             while (
                 this.messageQueue.length > 0 ||
                 (this.websocket && this.websocket.bufferedAmount > 0)
-            ) {
+                ) {
                 await new Promise(r => setTimeout(r, pollMs));
             }
         }
@@ -447,7 +459,7 @@
                 this.heartbeatIntervalId = null;
             }
 
-            // if it's a regular stop, wait for send‐queue + socket to drain
+            // if it's a regular stop, wait for send-queue + socket to drain
             if (this.connected && this.websocket) {
                 await this._waitForDrain();
             }
@@ -488,6 +500,18 @@
             this.messageQueue.push(message);
         }
 
+        /**
+         * Send a SubscribeContinue message for a subscription name.
+         * @param {string} name - Subscription name
+         */
+        sendSubscribeContinue(name) {
+            const msg = {
+                message_type: 'SubscribeContinue',
+                value: { name }
+            };
+            this.sendMessage(msg);
+        }
+
         /**
          * Send periodic heartbeat messages.
          */
@@ -574,15 +598,28 @@
          * @param {string|null} [classFilter=null] - Class filter
          * @param {string|null} [keyFilter=null] - Key filter regex
          * @param {string|null} [topicFilter=null] - Topic filter regex
-         */
-        subscribe(name, mode = 'Streaming', keyName = null, topicName = null, classFilter = null, keyFilter = null, topicFilter = null, all_matching_keys = false) {
+         * @param {boolean} [allMatchingKeys=false] - Retrieve all matching keys
+         * @param {number} [snapshotSizeLimit=0] - Limit snapshot size
+         */
+        subscribe(
+            name,
+            mode = 'Streaming',
+            keyName = null,
+            topicName = null,
+            classFilter = null,
+            keyFilter = null,
+            topicFilter = null,
+            allMatchingKeys = false,
+            snapshotSizeLimit = 0
+        ) {
             const keyId = keyName ? this.getAndPossiblyIntroduceKeyId(keyName) : 0;
             const topicId = topicName ? this.getAndPossiblyIntroduceTopicId(topicName) : 0;
             const subMsg = {
                 message_type: 'Subscribe',
                 value: {
                     subscription_mode: mode,
-                    all_matching_keys: all_matching_keys,
+                    all_matching_keys: allMatchingKeys,
+                    snapshot_size_limit: snapshotSizeLimit,
                     nagle_interval: 0,
                     name,
                     key_id: keyId,
@@ -706,10 +743,10 @@
          * @param {string} keyName - Key name
          * @param {string} topicName - Topic name
          * @param {any} value - JSON-serializable value
-         * @param class_name - Class name for key (optional)
+         * @param {string|null} [className=null] - Class name
          */
-        publishRecord(keyName, topicName, value, class_name = null) {
-            const keyId = this.getAndPossiblyIntroduceKeyId(keyName, class_name);
+        publishRecord(keyName, topicName, value, className = null) {
+            const keyId = this.getAndPossiblyIntroduceKeyId(keyName, className);
             const topicId = this.getAndPossiblyIntroduceTopicId(topicName);
             this.publishRecordWithIds(keyId, topicId, value);
         }

package/package.json

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