jsgar 4.4.0 → 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,13 +1135,30 @@
             );
         }
 
+        /**
+         * 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
          * @param {string|Array<string>|null} [className=null] - Class name(s)
          * @returns {number} Local key ID
          */
-        getAndPossiblyIntroduceKeyId(name, className = null, { forceWrite = false, noAcquire = false } = {}) {
+        getAndPossiblyIntroduceKeyId(name, className = null) {
             if (!this.localKeyMap.has(name)) {
                 const keyId = this.localKeyCounter++;
                 this.localKeyMap.set(name, keyId);
@@ -1149,8 +1170,6 @@
                         value.class_list = className;
                     }
                 }
-                if (forceWrite) value.force_write = true;
-                if (noAcquire) value.no_acquire = true;
                 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,13 +1129,30 @@ 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
      * @param {string|Array<string>|null} [className=null] - Class name(s)
      * @returns {number} Local key ID
      */
-    getAndPossiblyIntroduceKeyId(name, className = null, { forceWrite = false, noAcquire = false } = {}) {
+    getAndPossiblyIntroduceKeyId(name, className = null) {
         if (!this.localKeyMap.has(name)) {
             const keyId = this.localKeyCounter++;
             this.localKeyMap.set(name, keyId);
@@ -1143,8 +1164,6 @@ class GARClient {
                     value.class_list = className;
                 }
             }
-            if (forceWrite) value.force_write = true;
-            if (noAcquire) value.no_acquire = true;
             this.sendMessage({ message_type: 'KeyIntroduction', value });
         }
         return this.localKeyMap.get(name);

package/package.json

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