jsgar 4.6.3 → 4.8.0

package/dist/gar.umd.js

@@ -1331,13 +1331,29 @@
          * @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.
+         * @param {string} [options.clientKeyName=''] - If non-empty, atomically introduce this g::Client key with
+         *     the message. The server creates the key and maps the remote id in one round-trip; no separate
+         *     KeyIntroduction is sent. Ignored if the name is already mapped locally (existing id is reused).
          */
-        updateActiveOwnership({ msgRef = 0, ownershipAction = 'None', skipOwnershipChecks = false, requireExisting = false, clientKeyId = 0 } = {}) {
+        updateActiveOwnership({ msgRef = 0, ownershipAction = 'None', skipOwnershipChecks = false, requireExisting = false, clientKeyId = 0, clientKeyName = '' } = {}) {
+            if (clientKeyName) {
+                const existingId = this.localKeyMap.get(clientKeyName);
+                if (existingId !== undefined) {
+                    clientKeyId = existingId;
+                    clientKeyName = '';
+                } else {
+                    clientKeyId = this.localKeyCounter++;
+                    this.localKeyMap.set(clientKeyName, clientKeyId);
+                }
+            }
             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) {
+            const changed = 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;
+            if (changed || clientKeyName) {
                 this._activeOwnership = newOwnership;
-                this.sendMessage({ message_type: 'ActiveOwnership', value: newOwnership });
+                const value = { ...newOwnership };
+                if (clientKeyName) value.client_key_name = clientKeyName;
+                this.sendMessage({ message_type: 'ActiveOwnership', value });
             }
         }
 

package/gar.js

@@ -1325,13 +1325,29 @@ class GARClient {
      * @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.
+     * @param {string} [options.clientKeyName=''] - If non-empty, atomically introduce this g::Client key with
+     *     the message. The server creates the key and maps the remote id in one round-trip; no separate
+     *     KeyIntroduction is sent. Ignored if the name is already mapped locally (existing id is reused).
      */
-    updateActiveOwnership({ msgRef = 0, ownershipAction = 'None', skipOwnershipChecks = false, requireExisting = false, clientKeyId = 0 } = {}) {
+    updateActiveOwnership({ msgRef = 0, ownershipAction = 'None', skipOwnershipChecks = false, requireExisting = false, clientKeyId = 0, clientKeyName = '' } = {}) {
+        if (clientKeyName) {
+            const existingId = this.localKeyMap.get(clientKeyName);
+            if (existingId !== undefined) {
+                clientKeyId = existingId;
+                clientKeyName = '';
+            } else {
+                clientKeyId = this.localKeyCounter++;
+                this.localKeyMap.set(clientKeyName, clientKeyId);
+            }
+        }
         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) {
+        const changed = 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;
+        if (changed || clientKeyName) {
             this._activeOwnership = newOwnership;
-            this.sendMessage({ message_type: 'ActiveOwnership', value: newOwnership });
+            const value = { ...newOwnership };
+            if (clientKeyName) value.client_key_name = clientKeyName;
+            this.sendMessage({ message_type: 'ActiveOwnership', value });
         }
     }
 

package/package.json

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