@keyhive/keyhive 0.1.0-alpha.4 → 0.1.0-alpha.6

package/pkg-node/keyhive_wasm.js

@@ -17,6 +17,108 @@ class Access {
         const ptr = this.__destroy_into_raw();
         wasm.__wbg_access_free(ptr, 0);
     }
+    /**
+     * The ability to revoke any members of a group, not just those that they have causal senority over.
+     * @returns {Access}
+     */
+    static admin() {
+        const ret = wasm.access_admin();
+        return Access.__wrap(ret);
+    }
+    /**
+     * True if this level is at least as permissive as `other`.
+     * @param {Access} other
+     * @returns {boolean}
+     */
+    atLeast(other) {
+        _assertClass(other, Access);
+        const ret = wasm.access_atLeast(this.__wbg_ptr, other.__wbg_ptr);
+        return ret !== 0;
+    }
+    /**
+     * Standard comparator result: -1 if less permissive than `other`,
+     * 0 if equal, 1 if more permissive.
+     * @param {Access} other
+     * @returns {number}
+     */
+    compareTo(other) {
+        _assertClass(other, Access);
+        const ret = wasm.access_compareTo(this.__wbg_ptr, other.__wbg_ptr);
+        return ret;
+    }
+    /**
+     * The ability to edit (append ops to) the content of a document.
+     * @returns {Access}
+     */
+    static edit() {
+        const ret = wasm.access_edit();
+        return Access.__wrap(ret);
+    }
+    /**
+     * @param {Access} other
+     * @returns {boolean}
+     */
+    equals(other) {
+        _assertClass(other, Access);
+        const ret = wasm.access_equals(this.__wbg_ptr, other.__wbg_ptr);
+        return ret !== 0;
+    }
+    /**
+     * Parse an access level, throwing on invalid input.
+     * Accepts "relay", "read", "edit", or "admin" (case-insensitive).
+     * @param {string} s
+     * @returns {Access}
+     */
+    static fromString(s) {
+        const ptr0 = passStringToWasm0(s, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.access_fromString(ptr0, len0);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return Access.__wrap(ret[0]);
+    }
+    /**
+     * True for Edit access or higher.
+     * @returns {boolean}
+     */
+    get isEditor() {
+        const ret = wasm.access_isEditor(this.__wbg_ptr);
+        return ret !== 0;
+    }
+    /**
+     * True for Read access or higher.
+     * @returns {boolean}
+     */
+    get isReader() {
+        const ret = wasm.access_isReader(this.__wbg_ptr);
+        return ret !== 0;
+    }
+    /**
+     * Numeric level for ordering: Relay = 0, Read = 1, Edit = 2, Admin = 3.
+     * Higher levels imply all lower levels.
+     * @returns {number}
+     */
+    get level() {
+        const ret = wasm.access_level(this.__wbg_ptr);
+        return ret;
+    }
+    /**
+     * The ability to read (decrypt) the content of a document.
+     * @returns {Access}
+     */
+    static read() {
+        const ret = wasm.access_read();
+        return Access.__wrap(ret);
+    }
+    /**
+     * The ability to retrieve bytes over the network.
+     * @returns {Access}
+     */
+    static relay() {
+        const ret = wasm.access_relay();
+        return Access.__wrap(ret);
+    }
     /**
      * @returns {string}
      */
@@ -33,6 +135,8 @@ class Access {
         }
     }
     /**
+     * Parse an access level, returning undefined on invalid input.
+     * Prefer `fromString`, which throws a descriptive error instead.
      * @param {string} s
      * @returns {Access | undefined}
      */
@@ -46,37 +150,6 @@ class Access {
 if (Symbol.dispose) Access.prototype[Symbol.dispose] = Access.prototype.free;
 exports.Access = Access;
 
-/**
- * The result of adding a member: the membership delegation.
- */
-class AddMemberUpdate {
-    static __wrap(ptr) {
-        const obj = Object.create(AddMemberUpdate.prototype);
-        obj.__wbg_ptr = ptr;
-        AddMemberUpdateFinalization.register(obj, obj.__wbg_ptr, obj);
-        return obj;
-    }
-    __destroy_into_raw() {
-        const ptr = this.__wbg_ptr;
-        this.__wbg_ptr = 0;
-        AddMemberUpdateFinalization.unregister(this);
-        return ptr;
-    }
-    free() {
-        const ptr = this.__destroy_into_raw();
-        wasm.__wbg_addmemberupdate_free(ptr, 0);
-    }
-    /**
-     * @returns {SignedDelegation}
-     */
-    get delegation() {
-        const ret = wasm.addmemberupdate_delegation(this.__wbg_ptr);
-        return SignedDelegation.__wrap(ret);
-    }
-}
-if (Symbol.dispose) AddMemberUpdate.prototype[Symbol.dispose] = AddMemberUpdate.prototype.free;
-exports.AddMemberUpdate = AddMemberUpdate;
-
 class Agent {
     static __wrap(ptr) {
         const obj = Object.create(Agent.prototype);
@@ -598,33 +671,31 @@ exports.ContactCard = ContactCard;
 
 /**
  * Plaintext plus the application secret key that decrypted it.
- *
- * The key lets the consumer recover the blob's external predecessor-secret
- * chain and chain further encryptions onto it, without re-entering CGKA.
  */
-class DecryptedWithKey {
+class DecryptedKeyed {
     static __wrap(ptr) {
-        const obj = Object.create(DecryptedWithKey.prototype);
+        const obj = Object.create(DecryptedKeyed.prototype);
         obj.__wbg_ptr = ptr;
-        DecryptedWithKeyFinalization.register(obj, obj.__wbg_ptr, obj);
+        DecryptedKeyedFinalization.register(obj, obj.__wbg_ptr, obj);
         return obj;
     }
     __destroy_into_raw() {
         const ptr = this.__wbg_ptr;
         this.__wbg_ptr = 0;
-        DecryptedWithKeyFinalization.unregister(this);
+        DecryptedKeyedFinalization.unregister(this);
         return ptr;
     }
     free() {
         const ptr = this.__destroy_into_raw();
-        wasm.__wbg_decryptedwithkey_free(ptr, 0);
+        wasm.__wbg_decryptedkeyed_free(ptr, 0);
     }
     /**
      * The 32-byte application secret key used to decrypt this content.
+     * Treat as secret: do not log or persist unencrypted.
      * @returns {Uint8Array}
      */
     get applicationSecret() {
-        const ret = wasm.decryptedwithkey_applicationSecret(this.__wbg_ptr);
+        const ret = wasm.decryptedkeyed_applicationSecret(this.__wbg_ptr);
         var v1 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
         wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
         return v1;
@@ -633,14 +704,14 @@ class DecryptedWithKey {
      * @returns {Uint8Array}
      */
     get plaintext() {
-        const ret = wasm.decryptedwithkey_plaintext(this.__wbg_ptr);
+        const ret = wasm.decryptedkeyed_plaintext(this.__wbg_ptr);
         var v1 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
         wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
         return v1;
     }
 }
-if (Symbol.dispose) DecryptedWithKey.prototype[Symbol.dispose] = DecryptedWithKey.prototype.free;
-exports.DecryptedWithKey = DecryptedWithKey;
+if (Symbol.dispose) DecryptedKeyed.prototype[Symbol.dispose] = DecryptedKeyed.prototype.free;
+exports.DecryptedKeyed = DecryptedKeyed;
 
 class Delegation {
     static __wrap(ptr) {
@@ -927,8 +998,7 @@ class Encrypted {
     }
     /**
      * Decrypt this content with an explicit 32-byte application secret key,
-     * bypassing CGKA. The consumer uses this to follow the external
-     * predecessor-secret chain once it has recovered a blob's key.
+     * bypassing CGKA.
      * @param {Uint8Array} key
      * @returns {Uint8Array}
      */
@@ -1025,15 +1095,51 @@ class EncryptedContentWithUpdate {
         const ptr = this.__destroy_into_raw();
         wasm.__wbg_encryptedcontentwithupdate_free(ptr, 0);
     }
+    /**
+     * @returns {Encrypted}
+     */
+    encrypted_content() {
+        const ret = wasm.encryptedcontentwithupdate_encrypted_content(this.__wbg_ptr);
+        return Encrypted.__wrap(ret);
+    }
+    /**
+     * @returns {SignedCgkaOperation | undefined}
+     */
+    update_op() {
+        const ret = wasm.encryptedcontentwithupdate_update_op(this.__wbg_ptr);
+        return ret === 0 ? undefined : SignedCgkaOperation.__wrap(ret);
+    }
+}
+if (Symbol.dispose) EncryptedContentWithUpdate.prototype[Symbol.dispose] = EncryptedContentWithUpdate.prototype.free;
+exports.EncryptedContentWithUpdate = EncryptedContentWithUpdate;
+
+/**
+ * Encrypted content plus the application secret key it was encrypted under.
+ */
+class EncryptedKeyed {
+    static __wrap(ptr) {
+        const obj = Object.create(EncryptedKeyed.prototype);
+        obj.__wbg_ptr = ptr;
+        EncryptedKeyedFinalization.register(obj, obj.__wbg_ptr, obj);
+        return obj;
+    }
+    __destroy_into_raw() {
+        const ptr = this.__wbg_ptr;
+        this.__wbg_ptr = 0;
+        EncryptedKeyedFinalization.unregister(this);
+        return ptr;
+    }
+    free() {
+        const ptr = this.__destroy_into_raw();
+        wasm.__wbg_encryptedkeyed_free(ptr, 0);
+    }
     /**
      * The 32-byte application secret key used to encrypt this content.
-     *
-     * Lets the consumer build the external predecessor-secret chain and chain
-     * further encryptions onto this blob.
+     * Treat as secret: do not log or persist unencrypted.
      * @returns {Uint8Array}
      */
     get applicationSecret() {
-        const ret = wasm.encryptedcontentwithupdate_applicationSecret(this.__wbg_ptr);
+        const ret = wasm.encryptedkeyed_applicationSecret(this.__wbg_ptr);
         var v1 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
         wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
         return v1;
@@ -1042,19 +1148,19 @@ class EncryptedContentWithUpdate {
      * @returns {Encrypted}
      */
     encrypted_content() {
-        const ret = wasm.encryptedcontentwithupdate_encrypted_content(this.__wbg_ptr);
+        const ret = wasm.encryptedkeyed_encrypted_content(this.__wbg_ptr);
         return Encrypted.__wrap(ret);
     }
     /**
      * @returns {SignedCgkaOperation | undefined}
      */
     update_op() {
-        const ret = wasm.encryptedcontentwithupdate_update_op(this.__wbg_ptr);
+        const ret = wasm.encryptedkeyed_update_op(this.__wbg_ptr);
         return ret === 0 ? undefined : SignedCgkaOperation.__wrap(ret);
     }
 }
-if (Symbol.dispose) EncryptedContentWithUpdate.prototype[Symbol.dispose] = EncryptedContentWithUpdate.prototype.free;
-exports.EncryptedContentWithUpdate = EncryptedContentWithUpdate;
+if (Symbol.dispose) EncryptedKeyed.prototype[Symbol.dispose] = EncryptedKeyed.prototype.free;
+exports.EncryptedKeyed = EncryptedKeyed;
 
 class Event {
     static __wrap(ptr) {
@@ -1513,7 +1619,7 @@ class Keyhive {
      * @param {Membered} membered
      * @param {Access} access
      * @param {Document[]} other_relevant_docs
-     * @returns {Promise<AddMemberUpdate>}
+     * @returns {Promise<SignedDelegation>}
      */
     addMember(to_add, membered, access, other_relevant_docs) {
         _assertClass(to_add, Agent);
@@ -1533,6 +1639,20 @@ class Keyhive {
         const ret = wasm.keyhive_allAgentEvents(this.__wbg_ptr);
         return ret;
     }
+    /**
+     * The most permissive of `id`'s direct access and the document's
+     * public access. Returns undefined if neither grants access (or the
+     * document is unknown).
+     * @param {Identifier} id
+     * @param {DocumentId} doc_id
+     * @returns {Promise<Access | undefined>}
+     */
+    bestAccessForDoc(id, doc_id) {
+        _assertClass(id, Identifier);
+        _assertClass(doc_id, DocumentId);
+        const ret = wasm.keyhive_bestAccessForDoc(this.__wbg_ptr, id.__wbg_ptr, doc_id.__wbg_ptr);
+        return ret;
+    }
     /**
      * @returns {Promise<ContactCard>}
      */
@@ -1586,8 +1706,8 @@ class Keyhive {
     /**
      * Force a PCS key rotation and return the new leaf secret, serialized as a
      * one-entry `BTreeMap<ShareKey, ShareSecretKey>` (the exact format
-     * `importPrekeySecrets` accepts). A sibling instance of this identity can
-     * install it to derive the rotated key without re-importing the whole bundle.
+     * `importPrekeySecrets` accepts).
+     * The returned bytes are secret key material: do not log or persist unencrypted.
      * @param {Document} doc
      * @returns {Promise<Uint8Array>}
      */
@@ -1597,8 +1717,6 @@ class Keyhive {
         return ret;
     }
     /**
-     * Generate a document. Whether it provides forward secrecy is determined by
-     * this peer's forward-secrecy policy (chosen at `Keyhive.init`).
      * @param {Peer[]} coparents
      * @param {ChangeId} initial_content_ref_head
      * @param {ChangeId[]} more_initial_content_refs
@@ -1723,7 +1841,6 @@ class Keyhive {
         return ret;
     }
     /**
-     * Initialize a peer.
      * @param {Signer} signer
      * @param {CiphertextStore} ciphertext_store
      * @param {Function} event_handler
@@ -1832,17 +1949,14 @@ class Keyhive {
     }
     /**
      * Decrypt content and also return the 32-byte application secret key used.
-     *
-     * The consumer follows the external predecessor-secret chain from this key
-     * with `Encrypted.decryptWithKey`, avoiding further CGKA dives.
      * @param {Document} doc
      * @param {Encrypted} encrypted
-     * @returns {Promise<DecryptedWithKey>}
+     * @returns {Promise<DecryptedKeyed>}
      */
-    tryDecryptWithKey(doc, encrypted) {
+    tryDecryptKeyed(doc, encrypted) {
         _assertClass(doc, Document);
         _assertClass(encrypted, Encrypted);
-        const ret = wasm.keyhive_tryDecryptWithKey(this.__wbg_ptr, doc.__wbg_ptr, encrypted.__wbg_ptr);
+        const ret = wasm.keyhive_tryDecryptKeyed(this.__wbg_ptr, doc.__wbg_ptr, encrypted.__wbg_ptr);
         return ret;
     }
     /**
@@ -1879,6 +1993,25 @@ class Keyhive {
         const ret = wasm.keyhive_tryEncryptArchive(this.__wbg_ptr, doc.__wbg_ptr, content_ref.__wbg_ptr, ptr0, len0, ptr1, len1);
         return ret;
     }
+    /**
+     * Encrypt content and also return the application secret key it was
+     * encrypted under.
+     * @param {Document} doc
+     * @param {ChangeId} content_ref
+     * @param {ChangeId[]} js_pred_refs
+     * @param {Uint8Array} content
+     * @returns {Promise<EncryptedKeyed>}
+     */
+    tryEncryptKeyed(doc, content_ref, js_pred_refs, content) {
+        _assertClass(doc, Document);
+        _assertClass(content_ref, ChangeId);
+        const ptr0 = passArrayJsValueToWasm0(js_pred_refs, wasm.__wbindgen_malloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passArray8ToWasm0(content, wasm.__wbindgen_malloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ret = wasm.keyhive_tryEncryptKeyed(this.__wbg_ptr, doc.__wbg_ptr, content_ref.__wbg_ptr, ptr0, len0, ptr1, len1);
+        return ret;
+    }
     /**
      * @param {Document} doc
      * @returns {Promise<Uint8Array | undefined>}
@@ -2708,13 +2841,7 @@ function symmetricDecrypt(key, blob) {
 exports.symmetricDecrypt = symmetricDecrypt;
 
 /**
- * AEAD-encrypt `plaintext` under a 32-byte `key`.
- *
- * `associated_data` flavors the synthetic nonce (e.g. the document or content
- * id) so identical plaintext under the same key in different contexts produces
- * distinct ciphertext. Returns `nonce(24) || ciphertext` (the ciphertext
- * includes the Poly1305 tag). The nonce is carried in the output, so
- * [`symmetric_decrypt`] does not need the associated data.
+ * Encrypt `plaintext` under a 32-byte `key`, returning `nonce(24) || ciphertext`.
  * @param {Uint8Array} key
  * @param {Uint8Array} plaintext
  * @param {Uint8Array} associated_data
@@ -2799,10 +2926,6 @@ function __wbg_get_imports() {
             const ret = arg0.add(arg1);
             return ret;
         },
-        __wbg_addmemberupdate_new: function(arg0) {
-            const ret = AddMemberUpdate.__wrap(arg0);
-            return ret;
-        },
         __wbg_agent_new: function(arg0) {
             const ret = Agent.__wrap(arg0);
             return ret;
@@ -2869,8 +2992,8 @@ function __wbg_get_imports() {
                 wasm.__wbindgen_free(deferred0_0, deferred0_1, 1);
             }
         },
-        __wbg_decryptedwithkey_new: function(arg0) {
-            const ret = DecryptedWithKey.__wrap(arg0);
+        __wbg_decryptedkeyed_new: function(arg0) {
+            const ret = DecryptedKeyed.__wrap(arg0);
             return ret;
         },
         __wbg_doccontentrefs_new: function(arg0) {
@@ -2885,6 +3008,10 @@ function __wbg_get_imports() {
             const ret = EncryptedContentWithUpdate.__wrap(arg0);
             return ret;
         },
+        __wbg_encryptedkeyed_new: function(arg0) {
+            const ret = EncryptedKeyed.__wrap(arg0);
+            return ret;
+        },
         __wbg_error_8b62d3db440cf4a8: function(arg0, arg1) {
             let deferred0_0;
             let deferred0_1;
@@ -3067,7 +3194,7 @@ function __wbg_get_imports() {
                     const a = state0.a;
                     state0.a = 0;
                     try {
-                        return wasm_bindgen__convert__closures_____invoke__h58982df154245cbc(a, state0.b, arg0, arg1);
+                        return wasm_bindgen__convert__closures_____invoke__h3240482818b7fa6b(a, state0.b, arg0, arg1);
                     } finally {
                         state0.a = a;
                     }
@@ -3220,8 +3347,8 @@ function __wbg_get_imports() {
             }
         },
         __wbindgen_cast_0000000000000001: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 712, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, wasm_bindgen__convert__closures_____invoke__h9887d5ab72723f8a);
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 719, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, wasm_bindgen__convert__closures_____invoke__h264249ebd10d2c4e);
             return ret;
         },
         __wbindgen_cast_0000000000000002: function(arg0, arg1) {
@@ -3306,23 +3433,20 @@ function __wbg_get_imports() {
     };
 }
 
-function wasm_bindgen__convert__closures_____invoke__h9887d5ab72723f8a(arg0, arg1, arg2) {
-    const ret = wasm.wasm_bindgen__convert__closures_____invoke__h9887d5ab72723f8a(arg0, arg1, arg2);
+function wasm_bindgen__convert__closures_____invoke__h264249ebd10d2c4e(arg0, arg1, arg2) {
+    const ret = wasm.wasm_bindgen__convert__closures_____invoke__h264249ebd10d2c4e(arg0, arg1, arg2);
     if (ret[1]) {
         throw takeFromExternrefTable0(ret[0]);
     }
 }
 
-function wasm_bindgen__convert__closures_____invoke__h58982df154245cbc(arg0, arg1, arg2, arg3) {
-    wasm.wasm_bindgen__convert__closures_____invoke__h58982df154245cbc(arg0, arg1, arg2, arg3);
+function wasm_bindgen__convert__closures_____invoke__h3240482818b7fa6b(arg0, arg1, arg2, arg3) {
+    wasm.wasm_bindgen__convert__closures_____invoke__h3240482818b7fa6b(arg0, arg1, arg2, arg3);
 }
 
 const AccessFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
     : new FinalizationRegistry(ptr => wasm.__wbg_access_free(ptr, 1));
-const AddMemberUpdateFinalization = (typeof FinalizationRegistry === 'undefined')
-    ? { register: () => {}, unregister: () => {} }
-    : new FinalizationRegistry(ptr => wasm.__wbg_addmemberupdate_free(ptr, 1));
 const AgentFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
     : new FinalizationRegistry(ptr => wasm.__wbg_agent_free(ptr, 1));
@@ -3353,9 +3477,9 @@ const CiphertextStoreFinalization = (typeof FinalizationRegistry === 'undefined'
 const ContactCardFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
     : new FinalizationRegistry(ptr => wasm.__wbg_contactcard_free(ptr, 1));
-const DecryptedWithKeyFinalization = (typeof FinalizationRegistry === 'undefined')
+const DecryptedKeyedFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
-    : new FinalizationRegistry(ptr => wasm.__wbg_decryptedwithkey_free(ptr, 1));
+    : new FinalizationRegistry(ptr => wasm.__wbg_decryptedkeyed_free(ptr, 1));
 const DelegationFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
     : new FinalizationRegistry(ptr => wasm.__wbg_delegation_free(ptr, 1));
@@ -3374,6 +3498,9 @@ const EncryptedFinalization = (typeof FinalizationRegistry === 'undefined')
 const EncryptedContentWithUpdateFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
     : new FinalizationRegistry(ptr => wasm.__wbg_encryptedcontentwithupdate_free(ptr, 1));
+const EncryptedKeyedFinalization = (typeof FinalizationRegistry === 'undefined')
+    ? { register: () => {}, unregister: () => {} }
+    : new FinalizationRegistry(ptr => wasm.__wbg_encryptedkeyed_free(ptr, 1));
 const EventFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
     : new FinalizationRegistry(ptr => wasm.__wbg_event_free(ptr, 1));