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

package/pkg/keyhive_wasm_bg.js

@@ -15,6 +15,108 @@ export 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}
      */
@@ -31,6 +133,8 @@ export 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}
      */
@@ -43,36 +147,6 @@ export class Access {
 }
 if (Symbol.dispose) Access.prototype[Symbol.dispose] = Access.prototype.free;
 
-/**
- * The result of adding a member: the membership delegation.
- */
-export 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;
-
 export class Agent {
     static __wrap(ptr) {
         const obj = Object.create(Agent.prototype);
@@ -584,33 +658,31 @@ if (Symbol.dispose) ContactCard.prototype[Symbol.dispose] = ContactCard.prototyp
 
 /**
  * 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.
  */
-export class DecryptedWithKey {
+export 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;
@@ -619,13 +691,13 @@ export 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;
+if (Symbol.dispose) DecryptedKeyed.prototype[Symbol.dispose] = DecryptedKeyed.prototype.free;
 
 export class Delegation {
     static __wrap(ptr) {
@@ -908,8 +980,7 @@ export 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}
      */
@@ -1005,15 +1076,50 @@ export 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;
+
+/**
+ * Encrypted content plus the application secret key it was encrypted under.
+ */
+export 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;
@@ -1022,18 +1128,18 @@ export 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;
+if (Symbol.dispose) EncryptedKeyed.prototype[Symbol.dispose] = EncryptedKeyed.prototype.free;
 
 export class Event {
     static __wrap(ptr) {
@@ -1483,7 +1589,7 @@ export 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);
@@ -1503,6 +1609,20 @@ export 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>}
      */
@@ -1556,8 +1676,8 @@ export 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>}
      */
@@ -1567,8 +1687,6 @@ export 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
@@ -1693,7 +1811,6 @@ export class Keyhive {
         return ret;
     }
     /**
-     * Initialize a peer.
      * @param {Signer} signer
      * @param {CiphertextStore} ciphertext_store
      * @param {Function} event_handler
@@ -1802,17 +1919,14 @@ export 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;
     }
     /**
@@ -1849,6 +1963,25 @@ export 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>}
@@ -2662,13 +2795,7 @@ export function symmetricDecrypt(key, blob) {
 }
 
 /**
- * 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
@@ -2749,10 +2876,6 @@ export function __wbg_add_6c7b67a080be853e(arg0, arg1) {
     const ret = arg0.add(arg1);
     return ret;
 }
-export function __wbg_addmemberupdate_new(arg0) {
-    const ret = AddMemberUpdate.__wrap(arg0);
-    return ret;
-}
 export function __wbg_agent_new(arg0) {
     const ret = Agent.__wrap(arg0);
     return ret;
@@ -2819,8 +2942,8 @@ export function __wbg_debug_3003e89da631cad7(arg0, arg1) {
         wasm.__wbindgen_free(deferred0_0, deferred0_1, 1);
     }
 }
-export function __wbg_decryptedwithkey_new(arg0) {
-    const ret = DecryptedWithKey.__wrap(arg0);
+export function __wbg_decryptedkeyed_new(arg0) {
+    const ret = DecryptedKeyed.__wrap(arg0);
     return ret;
 }
 export function __wbg_doccontentrefs_new(arg0) {
@@ -2835,6 +2958,10 @@ export function __wbg_encryptedcontentwithupdate_new(arg0) {
     const ret = EncryptedContentWithUpdate.__wrap(arg0);
     return ret;
 }
+export function __wbg_encryptedkeyed_new(arg0) {
+    const ret = EncryptedKeyed.__wrap(arg0);
+    return ret;
+}
 export function __wbg_error_8b62d3db440cf4a8(arg0, arg1) {
     let deferred0_0;
     let deferred0_1;
@@ -3017,7 +3144,7 @@ export function __wbg_new_typed_1824d93f294193e5(arg0, arg1) {
             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;
             }
@@ -3170,8 +3297,8 @@ export function __wbg_warn_9d7408e9659996aa(arg0, arg1, arg2, arg3, arg4, arg5,
     }
 }
 export function __wbindgen_cast_0000000000000001(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;
 }
 export function __wbindgen_cast_0000000000000002(arg0, arg1) {
@@ -3249,23 +3376,20 @@ export function __wbindgen_init_externref_table() {
     table.set(offset + 2, true);
     table.set(offset + 3, false);
 }
-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));
@@ -3296,9 +3420,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));
@@ -3317,6 +3441,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));