jsgar 4.5.1 → 4.5.3

package/dist/gar.umd.js

@@ -74,6 +74,7 @@
             this.localKeyMap = new Map();
             this.invalidatedKeyIds = new Set();
             this.recordMap = new Map();
+            this._activeOwnership = { msg_ref: 0, ownership_action: 'None', skip_ownership_checks: false, require_existing: false, client_key_id: 0 };
 
             this.running = false;
             this.heartbeatIntervalId = null;
@@ -140,6 +141,9 @@
             this.localKeyMap.clear();
             this.invalidatedKeyIds.clear();
 
+            // Active ownership state
+            this._activeOwnership = { msg_ref: 0, ownership_action: 'None', skip_ownership_checks: false, require_existing: false, client_key_id: 0 };
+
             // Heartbeat grace period flags
             this._initialGracePeriod = false;
             this._initialGraceDeadline = 0;
@@ -1135,13 +1139,31 @@
             );
         }
 
+        /**
+         * 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 {boolean} [options.requireExisting=false] - Only write to existing keys; do not create new keys.
+         * @param {number} [options.clientKeyId=0] - The g::Client key ID for ownership. 0 uses the connection key.
+         */
+        updateActiveOwnership({ msgRef = 0, ownershipAction = 'None', skipOwnershipChecks = false, requireExisting = false, clientKeyId = 0 } = {}) {
+            const newOwnership = { msg_ref: msgRef, ownership_action: ownershipAction, skip_ownership_checks: skipOwnershipChecks, require_existing: requireExisting, 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.require_existing !== cur.require_existing || 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) {
             const existingId = this.localKeyMap.get(name);
             if (existingId !== undefined && this.invalidatedKeyIds.has(existingId)) {
                 this.invalidatedKeyIds.delete(existingId);
@@ -1158,8 +1180,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

@@ -68,6 +68,7 @@ class GARClient {
         this.localKeyMap = new Map();
         this.invalidatedKeyIds = new Set();
         this.recordMap = new Map();
+        this._activeOwnership = { msg_ref: 0, ownership_action: 'None', skip_ownership_checks: false, require_existing: false, client_key_id: 0 };
 
         this.running = false;
         this.heartbeatIntervalId = null;
@@ -134,6 +135,9 @@ class GARClient {
         this.localKeyMap.clear();
         this.invalidatedKeyIds.clear();
 
+        // Active ownership state
+        this._activeOwnership = { msg_ref: 0, ownership_action: 'None', skip_ownership_checks: false, require_existing: false, client_key_id: 0 };
+
         // Heartbeat grace period flags
         this._initialGracePeriod = false;
         this._initialGraceDeadline = 0;
@@ -1129,13 +1133,31 @@ 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 {boolean} [options.requireExisting=false] - Only write to existing keys; do not create new keys.
+     * @param {number} [options.clientKeyId=0] - The g::Client key ID for ownership. 0 uses the connection key.
+     */
+    updateActiveOwnership({ msgRef = 0, ownershipAction = 'None', skipOwnershipChecks = false, requireExisting = false, clientKeyId = 0 } = {}) {
+        const newOwnership = { msg_ref: msgRef, ownership_action: ownershipAction, skip_ownership_checks: skipOwnershipChecks, require_existing: requireExisting, 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.require_existing !== cur.require_existing || 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) {
         const existingId = this.localKeyMap.get(name);
         if (existingId !== undefined && this.invalidatedKeyIds.has(existingId)) {
             this.invalidatedKeyIds.delete(existingId);
@@ -1152,8 +1174,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.5.1",
+  "version": "4.5.3",
   "description": "A Javascript client for the GAR protocol",
   "type": "module",
   "main": "dist/gar.umd.js",