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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keyhive/keyhive",
-  "version": "0.1.0-alpha.3",
+  "version": "0.1.0-alpha.4",
   "description": "",
   "main": "pkg/keyhive_wasm.js",
   "keywords": [],

package/pkg/keyhive_wasm.d.ts

@@ -10,23 +10,13 @@ export class Access {
 }
 
 /**
- * The result of adding a member: the membership delegation, plus any new leaf
- * secrets produced by auto-rekeying a non-forward-secret document on add.
+ * The result of adding a member: the membership delegation.
  */
 export class AddMemberUpdate {
     private constructor();
     free(): void;
     [Symbol.dispose](): void;
     readonly delegation: SignedDelegation;
-    /**
-     * New leaf secret keypairs from auto-rekeying a non-forward-secret document
-     * when this reader was added, serialized as a
-     * `BTreeMap<ShareKey, ShareSecretKey>` (the format `importPrekeySecrets`
-     * accepts). A sibling instance of this identity (e.g. a tab and its
-     * SharedWorker) installs them to derive the rotated key. `undefined` when
-     * no rotation occurred (a forward-secret document).
-     */
-    readonly leafSecrets: Uint8Array | undefined;
 }
 
 export class Agent {
@@ -135,6 +125,23 @@ export class ContactCard {
     readonly shareKey: ShareKey;
 }
 
+/**
+ * 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 {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * The 32-byte application secret key used to decrypt this content.
+     */
+    readonly applicationSecret: Uint8Array;
+    readonly plaintext: Uint8Array;
+}
+
 export class Delegation {
     private constructor();
     free(): void;
@@ -183,6 +190,12 @@ export class Encrypted {
     private constructor();
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * 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.
+     */
+    decryptWithKey(key: Uint8Array): Uint8Array;
     static fromBytes(bytes: Uint8Array): Encrypted;
     serialize(): Uint8Array;
     toBytes(): Uint8Array;
@@ -199,6 +212,13 @@ export class EncryptedContentWithUpdate {
     [Symbol.dispose](): void;
     encrypted_content(): Encrypted;
     update_op(): SignedCgkaOperation | undefined;
+    /**
+     * 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.
+     */
+    readonly applicationSecret: Uint8Array;
 }
 
 export class Event {
@@ -334,14 +354,8 @@ export class Keyhive {
     ingestEventsBytes(events_bytes_array: Array<any>): Promise<Array<any>>;
     /**
      * Initialize a peer.
-     *
-     * `forward_secrecy` is this peer's policy for all documents it creates or
-     * receives. When `false`, documents carry the CGKA predecessor key chain
-     * (a member added later reads the whole prior history) and adding a reader
-     * auto-rekeys (see `addMember`'s `leafSecrets`). When `true`, a member
-     * added later cannot read content from before they joined.
      */
-    static init(signer: Signer, ciphertext_store: CiphertextStore, event_handler: Function, forward_secrecy: boolean): Promise<Keyhive>;
+    static init(signer: Signer, ciphertext_store: CiphertextStore, event_handler: Function): Promise<Keyhive>;
     intoArchive(): Promise<Archive>;
     membershipOpsForAgent(agent: Agent): Promise<Map<any, any>>;
     pendingEventHashes(): Promise<Set<any>>;
@@ -353,6 +367,13 @@ export class Keyhive {
     stats(): Promise<Stats>;
     toArchive(): Promise<Archive>;
     tryDecrypt(doc: Document, encrypted: Encrypted): Promise<Uint8Array>;
+    /**
+     * 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.
+     */
+    tryDecryptWithKey(doc: Document, encrypted: Encrypted): Promise<DecryptedWithKey>;
     tryEncrypt(doc: Document, content_ref: ChangeId, js_pred_refs: ChangeId[], content: Uint8Array): Promise<EncryptedContentWithUpdate>;
     tryEncryptArchive(doc: Document, content_ref: ChangeId, pred_refs: ChangeId[], content: Uint8Array): Promise<EncryptedContentWithUpdate>;
     tryPcsKeyHash(doc: Document): Promise<Uint8Array | undefined>;
@@ -514,3 +535,19 @@ export class Summary {
  * https://rustwasm.github.io/docs/wasm-pack/tutorials/npm-browser-packages/template-deep-dive/src-utils-rs.html#2-what-is-console_error_panic_hook
  */
 export function setPanicHook(): void;
+
+/**
+ * Inverse of [`symmetric_encrypt`]. Reads `nonce(24) || ciphertext`.
+ */
+export function symmetricDecrypt(key: Uint8Array, blob: Uint8Array): Uint8Array;
+
+/**
+ * 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.
+ */
+export function symmetricEncrypt(key: Uint8Array, plaintext: Uint8Array, associated_data: Uint8Array): Uint8Array;

package/pkg/keyhive_wasm.js

@@ -5,5 +5,5 @@ import { __wbg_set_wasm } from "./keyhive_wasm_bg.js";
 __wbg_set_wasm(wasm);
 wasm.__wbindgen_start();
 export {
-    Access, AddMemberUpdate, Agent, AllAgentEvents, Archive, CannotParseEd25519SigningKey, CannotParseIdentifier, Capability, CgkaOperation, ChangeId, CiphertextStore, ContactCard, Delegation, DocContentRefs, Document, DocumentId, Encrypted, EncryptedContentWithUpdate, Event, GenerateWebCryptoError, Group, GroupId, History, Identifier, Individual, IndividualId, Invocation, Keyhive, Membered, Membership, Peer, Revocation, ShareKey, Signed, SignedCgkaOperation, SignedDelegation, SignedInvocation, SignedRevocation, Signer, Stats, Summary, setPanicHook
+    Access, AddMemberUpdate, Agent, AllAgentEvents, Archive, CannotParseEd25519SigningKey, CannotParseIdentifier, Capability, CgkaOperation, ChangeId, CiphertextStore, ContactCard, DecryptedWithKey, Delegation, DocContentRefs, Document, DocumentId, Encrypted, EncryptedContentWithUpdate, Event, GenerateWebCryptoError, Group, GroupId, History, Identifier, Individual, IndividualId, Invocation, Keyhive, Membered, Membership, Peer, Revocation, ShareKey, Signed, SignedCgkaOperation, SignedDelegation, SignedInvocation, SignedRevocation, Signer, Stats, Summary, setPanicHook, symmetricDecrypt, symmetricEncrypt
 } from "./keyhive_wasm_bg.js";