jsgar 4.3.2 → 4.5.0

package/dist/gar.umd.js

@@ -73,6 +73,7 @@
             this.localTopicMap = new Map();
             this.localKeyMap = new Map();
             this.recordMap = new Map();
+            this._activeOwnership = { msg_ref: 0, ownership_action: 'None', skip_ownership_checks: false, client_key_id: 0 };
 
             this.running = false;
             this.heartbeatIntervalId = null;
@@ -138,6 +139,9 @@
             this.localTopicMap.clear();
             this.localKeyMap.clear();
 
+            // Active ownership state
+            this._activeOwnership = { msg_ref: 0, ownership_action: 'None', skip_ownership_checks: false, client_key_id: 0 };
+
             // Heartbeat grace period flags
             this._initialGracePeriod = false;
             this._initialGraceDeadline = 0;
@@ -1131,6 +1135,23 @@
             );
         }
 
+        /**
+         * Send an ActiveOwnership message if the parameters differ from the last sent values.
+         * @param {Object} [options]
+         * @param {number} [options.msgRef=0] - Message reference for correlating recoverable error responses.
+         * @param {string} [options.ownershipAction='None'] - 'None' (check only), 'Acquire', or 'Release'.
+         * @param {boolean} [options.skipOwnershipChecks=false] - Bypass ownership validation.
+         * @param {number} [options.clientKeyId=0] - The g::Client key ID for ownership. 0 uses the connection key.
+         */
+        updateActiveOwnership({ msgRef = 0, ownershipAction = 'None', skipOwnershipChecks = false, clientKeyId = 0 } = {}) {
+            const newOwnership = { msg_ref: msgRef, ownership_action: ownershipAction, skip_ownership_checks: skipOwnershipChecks, client_key_id: clientKeyId };
+            const cur = this._activeOwnership;
+            if (newOwnership.msg_ref !== cur.msg_ref || newOwnership.ownership_action !== cur.ownership_action || newOwnership.skip_ownership_checks !== cur.skip_ownership_checks || newOwnership.client_key_id !== cur.client_key_id) {
+                this._activeOwnership = newOwnership;
+                this.sendMessage({ message_type: 'ActiveOwnership', value: newOwnership });
+            }
+        }
+
         /**
          * Introduce a new key if not already known and return local key ID.
          * @param {string} name - Key name
@@ -1141,25 +1162,15 @@
             if (!this.localKeyMap.has(name)) {
                 const keyId = this.localKeyCounter++;
                 this.localKeyMap.set(name, keyId);
-                let classList = null;
+                const value = { key_id: keyId, name };
                 if (className) {
                     if (typeof className === 'string') {
-                        classList = className.split(/\s+/).filter(Boolean);
+                        value.class_list = className.split(/\s+/).filter(Boolean);
                     } else if (Array.isArray(className)) {
-                        classList = className;
+                        value.class_list = className;
                     }
                 }
-                const msg = {
-                    message_type: 'KeyIntroduction',
-                    value: {
-                        key_id: keyId,
-                        name
-                    }
-                };
-                if (classList) {
-                    msg.value.class_list = classList;
-                }
-                this.sendMessage(msg);
+                this.sendMessage({ message_type: 'KeyIntroduction', value });
             }
             return this.localKeyMap.get(name);
         }

package/gar.js

@@ -67,6 +67,7 @@ class GARClient {
         this.localTopicMap = new Map();
         this.localKeyMap = new Map();
         this.recordMap = new Map();
+        this._activeOwnership = { msg_ref: 0, ownership_action: 'None', skip_ownership_checks: false, client_key_id: 0 };
 
         this.running = false;
         this.heartbeatIntervalId = null;
@@ -132,6 +133,9 @@ class GARClient {
         this.localTopicMap.clear();
         this.localKeyMap.clear();
 
+        // Active ownership state
+        this._activeOwnership = { msg_ref: 0, ownership_action: 'None', skip_ownership_checks: false, client_key_id: 0 };
+
         // Heartbeat grace period flags
         this._initialGracePeriod = false;
         this._initialGraceDeadline = 0;
@@ -1125,6 +1129,23 @@ class GARClient {
         );
     }
 
+    /**
+     * Send an ActiveOwnership message if the parameters differ from the last sent values.
+     * @param {Object} [options]
+     * @param {number} [options.msgRef=0] - Message reference for correlating recoverable error responses.
+     * @param {string} [options.ownershipAction='None'] - 'None' (check only), 'Acquire', or 'Release'.
+     * @param {boolean} [options.skipOwnershipChecks=false] - Bypass ownership validation.
+     * @param {number} [options.clientKeyId=0] - The g::Client key ID for ownership. 0 uses the connection key.
+     */
+    updateActiveOwnership({ msgRef = 0, ownershipAction = 'None', skipOwnershipChecks = false, clientKeyId = 0 } = {}) {
+        const newOwnership = { msg_ref: msgRef, ownership_action: ownershipAction, skip_ownership_checks: skipOwnershipChecks, client_key_id: clientKeyId };
+        const cur = this._activeOwnership;
+        if (newOwnership.msg_ref !== cur.msg_ref || newOwnership.ownership_action !== cur.ownership_action || newOwnership.skip_ownership_checks !== cur.skip_ownership_checks || newOwnership.client_key_id !== cur.client_key_id) {
+            this._activeOwnership = newOwnership;
+            this.sendMessage({ message_type: 'ActiveOwnership', value: newOwnership });
+        }
+    }
+
     /**
      * Introduce a new key if not already known and return local key ID.
      * @param {string} name - Key name
@@ -1135,25 +1156,15 @@ class GARClient {
         if (!this.localKeyMap.has(name)) {
             const keyId = this.localKeyCounter++;
             this.localKeyMap.set(name, keyId);
-            let classList = null;
+            const value = { key_id: keyId, name };
             if (className) {
                 if (typeof className === 'string') {
-                    classList = className.split(/\s+/).filter(Boolean);
+                    value.class_list = className.split(/\s+/).filter(Boolean);
                 } else if (Array.isArray(className)) {
-                    classList = className;
+                    value.class_list = className;
                 }
             }
-            const msg = {
-                message_type: 'KeyIntroduction',
-                value: {
-                    key_id: keyId,
-                    name
-                }
-            };
-            if (classList) {
-                msg.value.class_list = classList;
-            }
-            this.sendMessage(msg);
+            this.sendMessage({ message_type: 'KeyIntroduction', value });
         }
         return this.localKeyMap.get(name);
     }

package/package.json

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