jsgar 4.5.2 → 4.5.3

package/dist/gar.umd.js

@@ -74,7 +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, client_key_id: 0 };
+            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;
@@ -142,7 +142,7 @@
             this.invalidatedKeyIds.clear();
 
             // Active ownership state
-            this._activeOwnership = { msg_ref: 0, ownership_action: 'None', skip_ownership_checks: false, client_key_id: 0 };
+            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;
@@ -1145,12 +1145,13 @@
          * @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, clientKeyId = 0 } = {}) {
-            const newOwnership = { msg_ref: msgRef, ownership_action: ownershipAction, skip_ownership_checks: skipOwnershipChecks, client_key_id: clientKeyId };
+        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.client_key_id !== cur.client_key_id) {
+            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 });
             }

package/gar.js

@@ -68,7 +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, client_key_id: 0 };
+        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;
@@ -136,7 +136,7 @@ class GARClient {
         this.invalidatedKeyIds.clear();
 
         // Active ownership state
-        this._activeOwnership = { msg_ref: 0, ownership_action: 'None', skip_ownership_checks: false, client_key_id: 0 };
+        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;
@@ -1139,12 +1139,13 @@ class GARClient {
      * @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, clientKeyId = 0 } = {}) {
-        const newOwnership = { msg_ref: msgRef, ownership_action: ownershipAction, skip_ownership_checks: skipOwnershipChecks, client_key_id: clientKeyId };
+    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.client_key_id !== cur.client_key_id) {
+        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 });
         }

package/package.json

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