@agora-sdk/secure-chat-core 0.7.0 → 0.8.0

package/dist/cjs/hooks/message-fold.js

@@ -0,0 +1,218 @@
+"use strict";
+// Fold reducer — collapses reaction/edit/delete/un-react MimiContent messages onto their target post.
+//
+// The hybrid reference model: messages REFERENCE each other by MIMI content-hash (resolved here through
+// an in-memory hex(contentHash) → messageId index), while the hook keys STORAGE/ordering/dedup by the
+// server messageId. A mutation whose target hasn't been decoded yet (MLS delivery isn't globally
+// ordered — a reaction can arrive before its message) is BUFFERED by target-hash and applied the moment
+// the target lands ("buffer, never silently drop" — the same fail-closed discipline used for epoch
+// ordering). On reload the index rebuilds for free by recomputing contentHash from the stored canonical
+// bytes, so no hash→id index is persisted. Pure: no React, no crypto, no I/O.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MessageFold = void 0;
+const mimi_content_js_1 = require("../content/mimi-content.js");
+const hex = (b) => {
+    let s = "";
+    for (const x of b)
+        s += x.toString(16).padStart(2, "0");
+    return s;
+};
+function textBody(p) {
+    if (p.cardinality === mimi_content_js_1.Cardinality.Single)
+        return new TextDecoder().decode(p.content);
+    return null;
+}
+function classify(m) {
+    const isNull = m.nestedPart.cardinality === mimi_content_js_1.Cardinality.Null;
+    const isReaction = m.nestedPart.cardinality === mimi_content_js_1.Cardinality.Single &&
+        m.nestedPart.disposition === mimi_content_js_1.Disposition.Reaction;
+    if (m.replaces) {
+        if (isNull)
+            return { kind: "delete-or-unreact", target: m.replaces };
+        return { kind: "edit", target: m.replaces, body: textBody(m.nestedPart) };
+    }
+    if (m.inReplyTo) {
+        if (isReaction)
+            return { kind: "reaction", target: m.inReplyTo, token: textBody(m.nestedPart) ?? "" };
+        return { kind: "reply", body: textBody(m.nestedPart), replyTo: m.inReplyTo };
+    }
+    return { kind: "post", body: textBody(m.nestedPart), replyTo: null };
+}
+/**
+ * Stateful fold over decoded content messages. Feed every decoded message via {@link MessageFold.apply};
+ * read the rendered projection of a post/reply via {@link MessageFold.getContent}. Mutation messages
+ * (edit/delete/reaction/un-react) fold onto their target and are reported non-renderable.
+ *
+ * @example
+ * ```ts
+ * const fold = new MessageFold();
+ * const { renderable } = fold.apply(decoded);   // false for a reaction/edit/delete
+ * const content = fold.getContent(decoded.messageId); // post/reply projection or null
+ * ```
+ */
+class MessageFold {
+    constructor() {
+        this.rows = new Map(); // messageId → rendered row (post/reply only)
+        this.idByHash = new Map(); // hex(contentHash) → messageId (ALL content messages)
+        this.reactionReg = new Map(); // reactionMsgId → …
+        this.pending = new Map(); // hex(targetHash) → buffered mutations
+    }
+    /** Drop all state (e.g. on conversation switch or full reload before re-folding). */
+    reset() {
+        this.rows.clear();
+        this.idByHash.clear();
+        this.reactionReg.clear();
+        this.pending.clear();
+    }
+    /**
+     * True if `messageId` produced a visible (post/reply) row.
+     * @param messageId - The server message id to test.
+     * @returns Whether a rendered row exists for it.
+     */
+    isRenderable(messageId) {
+        return this.rows.has(messageId);
+    }
+    /**
+     * The rendered projection for a post/reply, or `null` for a folded mutation / unknown id.
+     * @param messageId - The server message id to project.
+     * @returns A fresh {@link RenderedContent} snapshot, or `null` when the id is not a rendered row.
+     */
+    getContent(messageId) {
+        const r = this.rows.get(messageId);
+        if (!r)
+            return null;
+        const reactions = {};
+        for (const [token, set] of r.reactions)
+            if (set.size > 0)
+                reactions[token] = set.size;
+        // Copy `replyTo` so a caller can't mutate the fold's internal hash bytes (body is a string — immutable).
+        return { body: r.body, replyTo: r.replyTo ? r.replyTo.slice() : null, editedAt: r.editedAt, deleted: r.deleted, reactions };
+    }
+    /**
+     * Apply one decoded message. Buffers a mutation whose target is unknown.
+     *
+     * Idempotent on a strict immediate re-apply of the same `messageId`, but NOT across an interleaved
+     * re-delivery: re-applying an already-withdrawn reaction id resurrects it (the replayed reaction
+     * re-adds itself to the now-empty token set and the prior un-react is not re-triggered). The CONSUMER
+     * (the hook) MUST dedup by `messageId` and apply each id at most once — do not re-feed an
+     * already-applied message.
+     * @param msg - The decoded, content-hashed message to fold in.
+     * @returns `{ renderable }` — whether this id is a standalone (post/reply) row.
+     */
+    apply(msg) {
+        const selfHex = hex(msg.contentHash);
+        this.idByHash.set(selfHex, msg.messageId);
+        const op = classify(msg.mimi);
+        if (op.kind === "post" || op.kind === "reply") {
+            const existing = this.rows.get(msg.messageId);
+            const row = existing ?? {
+                messageId: msg.messageId,
+                createdAt: msg.createdAt,
+                senderDeviceId: msg.senderDeviceId,
+                body: op.body,
+                replyTo: op.kind === "reply" ? op.replyTo : null,
+                editedAt: null,
+                deleted: false,
+                reactions: new Map(),
+            };
+            if (!existing)
+                this.rows.set(msg.messageId, row);
+            this.drain(selfHex); // a target just appeared → apply anything buffered against it
+            return { renderable: true };
+        }
+        // Mutations resolve a target by content-hash; buffer if the target isn't present yet.
+        if (op.kind === "edit") {
+            const row = this.resolveRow(op.target);
+            if (!row)
+                return this.buffer(op.target, msg);
+            row.body = op.body;
+            row.editedAt = msg.createdAt;
+            return { renderable: false };
+        }
+        if (op.kind === "reaction") {
+            const row = this.resolveRow(op.target);
+            if (!row)
+                return this.buffer(op.target, msg);
+            let set = row.reactions.get(op.token);
+            if (!set)
+                row.reactions.set(op.token, (set = new Set()));
+            set.add(msg.messageId);
+            this.reactionReg.set(msg.messageId, { targetHash: hex(op.target), token: op.token });
+            this.drain(selfHex); // a pending un-react of THIS reaction can now apply
+            return { renderable: false };
+        }
+        // delete-or-unreact: distinguish by whether `replaces` points at a known reaction message.
+        if (op.kind === "delete-or-unreact") {
+            const targetId = this.idByHash.get(hex(op.target));
+            const reaction = targetId ? this.reactionReg.get(targetId) : undefined;
+            if (reaction) {
+                // Un-react: drop exactly the one reaction message from its target's token set.
+                const row = this.resolveRow(fromHex(reaction.targetHash) ?? new Uint8Array());
+                row?.reactions.get(reaction.token)?.delete(targetId);
+                return { renderable: false };
+            }
+            // Un-react-before-reaction guard: the reaction message was INDEXED on first sight (so `targetId`
+            // resolves) but BUFFERED, not applied — hence no `reactionReg` entry yet AND no rendered row for
+            // it. Treat this as an un-react of an as-yet-unapplied reaction: buffer it under the reaction's
+            // hash so the reaction branch's `drain(selfHex)` replays the un-react after the reaction folds in.
+            // Without this guard the delete path below would tombstone a non-row target as a no-op, then the
+            // replayed reaction would survive — net wrong. Fail closed: buffer, never silently drop.
+            if (targetId && !this.rows.has(targetId))
+                return this.buffer(op.target, msg);
+            const row = this.resolveRow(op.target);
+            if (!row)
+                return this.buffer(op.target, msg); // a delete of an as-yet-unseen post → buffer it
+            row.deleted = true;
+            row.body = null;
+            return { renderable: false };
+        }
+        // Unreachable: `classify` is exhaustive over Op.kind; satisfies the compiler's return analysis.
+        return { renderable: false };
+    }
+    /**
+     * Resolve the rendered row a content-hash points at, if it has been decoded.
+     * @param targetHash - The referenced message's content-hash.
+     * @returns The {@link Row}, or `undefined` if the target is unknown or not a rendered row.
+     */
+    resolveRow(targetHash) {
+        const id = this.idByHash.get(hex(targetHash));
+        return id ? this.rows.get(id) : undefined;
+    }
+    /**
+     * Buffer a mutation against the hex of its (not-yet-decoded) target; replayed by {@link MessageFold.drain}.
+     * @param targetHash - The target content-hash to key the buffer under.
+     * @param msg - The mutation to defer.
+     * @returns `{ renderable: false }` — a buffered mutation is never a standalone row.
+     */
+    buffer(targetHash, msg) {
+        const key = hex(targetHash);
+        const list = this.pending.get(key) ?? [];
+        list.push(msg);
+        this.pending.set(key, list);
+        return { renderable: false };
+    }
+    /**
+     * Replay every mutation buffered against a content-hash that has just been decoded.
+     * @param hashHex - The hex content-hash that just appeared (a post/reply or a now-applied reaction).
+     */
+    drain(hashHex) {
+        const list = this.pending.get(hashHex);
+        if (!list)
+            return;
+        this.pending.delete(hashHex);
+        for (const m of list)
+            this.apply(m);
+    }
+}
+exports.MessageFold = MessageFold;
+// Map a hex key back to bytes (for resolving a reaction's stored target-hash). Kept local — the fold is
+// the only place that round-trips hash hex.
+function fromHex(h) {
+    if (h.length % 2 !== 0)
+        return null;
+    const out = new Uint8Array(h.length / 2);
+    for (let i = 0; i < out.length; i++)
+        out[i] = parseInt(h.slice(i * 2, i * 2 + 2), 16);
+    return out;
+}
+//# sourceMappingURL=message-fold.js.map

package/dist/cjs/hooks/message-fold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-fold.js","sourceRoot":"","sources":["../../../src/hooks/message-fold.ts"],"names":[],"mappings":"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"}

package/dist/cjs/hooks/useSecureMessages.d.ts

@@ -1,23 +1,28 @@
 import { SecureMessageModel } from "../contract/index.js";
 import { GroupHandle, type SecureDecryptFailureReason } from "@agora-sdk/secure-chat-crypto";
+import { type MimiContent } from "../content/mimi-content.js";
+import { type RenderedContent } from "./message-fold.js";
 /**
  * Decryption outcome for a stored message:
- * - `ok` — decrypted + authenticated; `plaintext` is set.
- * - `pending` — not decryptable yet (no group handle, or the message's epoch is ahead of ours); it will
- *   be retried when the group advances. `plaintext` is null.
- * - `rejected` — fails closed: the MLS core rejected it (replay, over-window gap, bad auth, malformed,
- *   too-old epoch). NEVER retried; `plaintext` is null and `rejectedReason` says why.
+ * - `ok` — decrypted + authenticated + decoded; `content`/`mimi`/`contentHash` are set (unless it is a
+ *   folded mutation, which the list omits, or a reserved control frame, which is hidden).
+ * - `pending` — not decryptable yet (no handle, or epoch ahead). Retried when the group advances.
+ * - `rejected` — fails closed (replay/gap/bad-auth/malformed/too-old, or undecodable content). Never retried.
  */
 export type SecureMessageStatus = "ok" | "pending" | "rejected";
-/** A stored message paired with its decryption outcome. */
+/** A stored message paired with its decoded, folded content. */
 export interface DecryptedSecureMessage {
     /** The raw message row from the server (still holds the base64 ciphertext). */
     model: SecureMessageModel;
-    /** Decrypted text, or null when {@link DecryptedSecureMessage.status} is `pending` or `rejected`. */
-    plaintext: string | null;
-    /** Decryption outcome — drives fail-closed handling and what the UI renders. */
+    /** The Tier-2 projection (body/replyTo/editedAt/deleted/reactions), or `null` when not `ok`. */
+    content: RenderedContent | null;
+    /** The raw decoded `MimiContent` (power users), or `null` when not `ok`. */
+    mimi: MimiContent | null;
+    /** SHA-256 content-hash — reference this to reply/react/edit/delete — or `null` when not `ok`. */
+    contentHash: Uint8Array | null;
+    /** Decryption outcome. */
     status: SecureMessageStatus;
-    /** When `status` is `rejected`, why the MLS core refused the message. */
+    /** When `status` is `rejected`, why. */
     rejectedReason?: SecureDecryptFailureReason;
 }
 /** Options for {@link useSecureMessages}. */
@@ -29,7 +34,7 @@ export interface UseSecureMessagesOptions {
 }
 /** The state and actions returned by {@link useSecureMessages}. */
 export interface UseSecureMessagesValues {
-    /** Loaded messages, newest first, each with decrypted text when possible. */
+    /** Rendered messages (post/reply rows with folded reactions/edits/deletes), newest first. */
     messages: DecryptedSecureMessage[];
     /** True while a page load or refresh is in flight. */
     loading: boolean;
@@ -41,15 +46,21 @@ export interface UseSecureMessagesValues {
     loadMore: () => Promise<void>;
     /** Reload from the newest message, replacing the current list. */
     refresh: () => Promise<void>;
-    /** Encrypt + send a text message. Requires a resolvable group + sender device. */
+    /** Encrypt + send a text post. */
     sendMessage: (text: string) => Promise<void>;
+    /** Send a reply to the message with `targetHash` (its {@link DecryptedSecureMessage.contentHash}). */
+    reply: (targetHash: Uint8Array, text: string) => Promise<void>;
+    /** React to the message with `targetHash` using `token` (e.g. an emoji). */
+    react: (targetHash: Uint8Array, token: string) => Promise<void>;
+    /** Edit the message with `targetHash`, replacing its body with `text`. */
+    editMessage: (targetHash: Uint8Array, text: string) => Promise<void>;
+    /** Delete (tombstone) the message with `targetHash`. */
+    deleteMessage: (targetHash: Uint8Array) => Promise<void>;
+    /** Withdraw your reaction whose own content-hash is `reactionHash`. */
+    unreact: (reactionHash: Uint8Array) => Promise<void>;
 }
 /**
- * Load, decrypt, send, and live-receive messages in one secure conversation.
- *
- * Auto-resolves the MLS group handle (via `resolveGroup`) and the sender device id (from the
- * persisted device) unless overridden in `options`. Joins the conversation socket room for live
- * `secure:message` events.
+ * Load, decrypt, send, and live-receive MIMI-content messages in one secure conversation.
  *
  * @param conversationId - The conversation to read and send within.
  * @param options - {@link UseSecureMessagesOptions}.
@@ -57,8 +68,9 @@ export interface UseSecureMessagesValues {
  *
  * @example
  * ```tsx
- * const { messages, sendMessage } = useSecureMessages(conversationId);
+ * const { messages, sendMessage, react } = useSecureMessages(conversationId);
  * await sendMessage("hello 💜");
+ * await react(messages[0].contentHash!, "👍");
  * ```
  */
 export declare function useSecureMessages(conversationId: string, options?: UseSecureMessagesOptions): UseSecureMessagesValues;