@palbase/web 1.2.1 → 1.3.0

package/dist/{analytics-facade-Ct3A1zop.d.cts → analytics-facade-B8UATgS4.d.cts}

@@ -756,6 +756,14 @@ interface ChatMessage {
      * a visible message of their own — they only mutate the target's tally.
      */
     readonly reactions: Record<string, string[]>;
+    /**
+     * Whether this message has been edited (edit-by-supersession). Defaults to
+     * `false`. Once any valid author edit folds onto this message it stays `true`
+     * forever (write-once, even if edited back to the original text). The rendered
+     * `text` reflects the LATEST edit's text (`edit ?? original`). An edit is never
+     * a visible message of its own — it only overlays the target's text + flag.
+     */
+    readonly edited: boolean;
 }
 /** The receipt from a send — the server's monotonic sequence + accepted epoch. */
 interface SentReceipt {
@@ -801,6 +809,10 @@ interface ReactionPayload {
     emoji: string;
     op: 'add' | 'remove';
 }
+interface EditPayload {
+    targetClientMsgId: string;
+    newText: string;
+}
 
 /** A decoded incoming message handed to chat listeners. */
 interface IncomingMessage {
@@ -824,6 +836,9 @@ interface IncomingMessage {
     envelopeType?: string;
     /** The decoded reaction payload, present only when `envelopeType === 'reaction'`. */
     reaction?: ReactionPayload | null;
+    /** The decoded edit payload, present only when `envelopeType === 'edit'`. Lets
+     * the Chat route an edit into its EditFold instead of appending a visible bubble. */
+    edit?: EditPayload | null;
 }
 
 /** The intended participants of a draft chat (held until the first send). */
@@ -858,6 +873,16 @@ interface ChatBackend {
         receipt: SentReceipt;
         clientMsgId: string;
     }>;
+    /** Send an edit (edit-by-supersession on a target message) through the same MLS
+     * application path as `sendText`. Returns the receipt + the wire clientMsgId. */
+    sendEdit(group: MessagingGroup, args: {
+        clientMsgId: string;
+        targetClientMsgId: string;
+        newText: string;
+    }): Promise<{
+        receipt: SentReceipt;
+        clientMsgId: string;
+    }>;
     history(group: MessagingGroup, limit: number, before?: number): Promise<ChatMessage[]>;
     members(group: MessagingGroup): Promise<ChatMember[]>;
     addMember(group: MessagingGroup, userId: string): Promise<void>;
@@ -890,6 +915,14 @@ declare class Chat {
     private readonly byClientMsgId;
     /** The single authoritative reaction fold for this chat (live + own-send + history). */
     private readonly reactionFold;
+    /** The single authoritative edit fold for this chat (live + own-send + history). */
+    private readonly editFold;
+    /** Per-target BASE (original) text, so the rendered text is `edit ?? original`.
+     * Seeded once per target (write-once base) so a 2nd own edit can't corrupt it. */
+    private readonly originalTextByClientMsgId;
+    /** Per-target AUTHOR userId — the EditFold author-gate input (filled at bubble
+     * projection time from senderUserId; '' = resolved-but-unknown peer). */
+    private readonly authorByClientMsgId;
     private loadedEarliestSeq;
     private historyLoaded;
     private wired;
@@ -922,6 +955,14 @@ declare class Chat {
     private mergeHistory;
     /** @internal — called by the backend's live subscription. */
     ingestLive(incoming: IncomingMessage): Promise<void>;
+    /** The EditFold author-gate input: the target message's resolved author userId
+     * (null = target unknown/dangling → the fold HOLDs). Captured as a bound arrow
+     * so it can be passed to the pure EditFold. */
+    private readonly authorOfTarget;
+    /** Seed the per-target base text + author for the edit fold. Base is write-once
+     * (a later own/peer edit must not overwrite the original we render against). The
+     * author is (re)recorded whenever a non-empty resolution is available. */
+    private seedEditBase;
     /**
      * Rebuild the target message's `reactions` from the authoritative fold and
      * re-emit. No-op when the target isn't present yet (its tally is attached the
@@ -934,6 +975,22 @@ declare class Chat {
      * attached upstream (the coordinator's page-local history fold) is preserved.
      */
     private applyReactionTally;
+    /**
+     * Rebuild the target message's rendered `text` + `edited` flag from the
+     * authoritative edit fold and re-emit, PRESERVING `.reactions` and `.replyTo`
+     * (the reaction-polish lesson — never clobber). text = `editFold.text(cid) ??
+     * base`; base is the seeded original so a forged/ignored edit leaves it intact.
+     * No-op when the target isn't present yet (the fold already recorded it; the
+     * overlay applies the moment the target lands) or when unchanged.
+     */
+    private recomputeEdit;
+    /**
+     * Overlay the authoritative edit fold's winning text + flag onto a message as it
+     * is appended/merged. The fold WINS when it has an edit for this target;
+     * otherwise the upstream `text`/`edited` (e.g. the coordinator's page-local
+     * history fold) is preserved. PRESERVES reactions + replyTo.
+     */
+    private applyEditOverlay;
     /** @internal — called by the backend's conv subscription. */
     applyConv(event: string, payload: Record<string, unknown>): void;
     private kindOf;
@@ -963,6 +1020,14 @@ declare class Chat {
     /** Remove this user's emoji reaction from a message (op:'remove'). */
     unreact(message: ChatMessage, emoji: string): Promise<void>;
     private sendReaction;
+    /** Edit an own text message (edit-by-supersession). No-op if the message isn't
+     * editable (empty clientMsgId, or not a `text` kind). The edit folds locally
+     * with the server receipt's `(epoch, serverSeq)` so the target's text updates
+     * instantly; the durable echo on the next pump is a fold no-op (dedup on the
+     * SAME wire clientMsgId). Never appends a bubble; PRESERVES the target's
+     * reactions + reply context. Only the original author's edits count — for an own
+     * message self IS the author, so the author-gate passes. */
+    edit(message: ChatMessage, newText: string): Promise<void>;
 }
 
 declare class PalbeMessaging {
@@ -1354,4 +1419,4 @@ declare class PalbeAnalytics {
     private post;
 }
 
-export { type AnalyticsProperties as A, type RealtimeConnectionState as B, Call as C, type RealtimeHandler as D, type RealtimePayload as E, type FlagsView as F, type RealtimeStatus as G, type RealtimeStatusSnapshot as H, type RealtimeSubscription as I, type PalbeRuntime as J, buildRuntime as K, type MagicLinkResult as M, type OAuthExchangeResult as O, PalbeAnalytics as P, RealtimeChannel as R, type SentReceipt as S, type Unsubscribe as U, type AuthChangeEvent as a, type AuthState as b, type AuthSuccess as c, type AuthUser as d, type CallChangeCallback as e, type CallParticipant as f, type CallState as g, Chat as h, type ChatBackend as i, type ChatDraft as j, type ChatKind as k, type ChatMember as l, type ChatMessage as m, type ChatMessageKind as n, type ChatRole as o, type ChatState as p, type CommsPrefs as q, type MessageDirection as r, PalbeAuth as s, PalbeCalls as t, type PalbeConfig as u, PalbeFlags as v, PalbeMessaging as w, type PalbeOAuthConfig as x, PalbeRealtime as y, type PresenceState as z };
+export { type AnalyticsProperties as A, type RealtimeConnectionState as B, Call as C, type RealtimeHandler as D, type RealtimePayload as E, type FlagsView as F, type RealtimeStatus as G, type RealtimeStatusSnapshot as H, type RealtimeSubscription as I, type ResolvedReply as J, type PalbeRuntime as K, buildRuntime as L, type MagicLinkResult as M, type OAuthExchangeResult as O, PalbeAnalytics as P, RealtimeChannel as R, type SentReceipt as S, type Unsubscribe as U, type AuthChangeEvent as a, type AuthState as b, type AuthSuccess as c, type AuthUser as d, type CallChangeCallback as e, type CallParticipant as f, type CallState as g, Chat as h, type ChatBackend as i, type ChatDraft as j, type ChatKind as k, type ChatMember as l, type ChatMessage as m, type ChatMessageKind as n, type ChatRole as o, type ChatState as p, type CommsPrefs as q, type MessageDirection as r, PalbeAuth as s, PalbeCalls as t, type PalbeConfig as u, PalbeFlags as v, PalbeMessaging as w, type PalbeOAuthConfig as x, PalbeRealtime as y, type PresenceState as z };

package/dist/{analytics-facade-C93tr7dA.d.ts → analytics-facade-Cq7R-VH_.d.ts}

@@ -756,6 +756,14 @@ interface ChatMessage {
      * a visible message of their own — they only mutate the target's tally.
      */
     readonly reactions: Record<string, string[]>;
+    /**
+     * Whether this message has been edited (edit-by-supersession). Defaults to
+     * `false`. Once any valid author edit folds onto this message it stays `true`
+     * forever (write-once, even if edited back to the original text). The rendered
+     * `text` reflects the LATEST edit's text (`edit ?? original`). An edit is never
+     * a visible message of its own — it only overlays the target's text + flag.
+     */
+    readonly edited: boolean;
 }
 /** The receipt from a send — the server's monotonic sequence + accepted epoch. */
 interface SentReceipt {
@@ -801,6 +809,10 @@ interface ReactionPayload {
     emoji: string;
     op: 'add' | 'remove';
 }
+interface EditPayload {
+    targetClientMsgId: string;
+    newText: string;
+}
 
 /** A decoded incoming message handed to chat listeners. */
 interface IncomingMessage {
@@ -824,6 +836,9 @@ interface IncomingMessage {
     envelopeType?: string;
     /** The decoded reaction payload, present only when `envelopeType === 'reaction'`. */
     reaction?: ReactionPayload | null;
+    /** The decoded edit payload, present only when `envelopeType === 'edit'`. Lets
+     * the Chat route an edit into its EditFold instead of appending a visible bubble. */
+    edit?: EditPayload | null;
 }
 
 /** The intended participants of a draft chat (held until the first send). */
@@ -858,6 +873,16 @@ interface ChatBackend {
         receipt: SentReceipt;
         clientMsgId: string;
     }>;
+    /** Send an edit (edit-by-supersession on a target message) through the same MLS
+     * application path as `sendText`. Returns the receipt + the wire clientMsgId. */
+    sendEdit(group: MessagingGroup, args: {
+        clientMsgId: string;
+        targetClientMsgId: string;
+        newText: string;
+    }): Promise<{
+        receipt: SentReceipt;
+        clientMsgId: string;
+    }>;
     history(group: MessagingGroup, limit: number, before?: number): Promise<ChatMessage[]>;
     members(group: MessagingGroup): Promise<ChatMember[]>;
     addMember(group: MessagingGroup, userId: string): Promise<void>;
@@ -890,6 +915,14 @@ declare class Chat {
     private readonly byClientMsgId;
     /** The single authoritative reaction fold for this chat (live + own-send + history). */
     private readonly reactionFold;
+    /** The single authoritative edit fold for this chat (live + own-send + history). */
+    private readonly editFold;
+    /** Per-target BASE (original) text, so the rendered text is `edit ?? original`.
+     * Seeded once per target (write-once base) so a 2nd own edit can't corrupt it. */
+    private readonly originalTextByClientMsgId;
+    /** Per-target AUTHOR userId — the EditFold author-gate input (filled at bubble
+     * projection time from senderUserId; '' = resolved-but-unknown peer). */
+    private readonly authorByClientMsgId;
     private loadedEarliestSeq;
     private historyLoaded;
     private wired;
@@ -922,6 +955,14 @@ declare class Chat {
     private mergeHistory;
     /** @internal — called by the backend's live subscription. */
     ingestLive(incoming: IncomingMessage): Promise<void>;
+    /** The EditFold author-gate input: the target message's resolved author userId
+     * (null = target unknown/dangling → the fold HOLDs). Captured as a bound arrow
+     * so it can be passed to the pure EditFold. */
+    private readonly authorOfTarget;
+    /** Seed the per-target base text + author for the edit fold. Base is write-once
+     * (a later own/peer edit must not overwrite the original we render against). The
+     * author is (re)recorded whenever a non-empty resolution is available. */
+    private seedEditBase;
     /**
      * Rebuild the target message's `reactions` from the authoritative fold and
      * re-emit. No-op when the target isn't present yet (its tally is attached the
@@ -934,6 +975,22 @@ declare class Chat {
      * attached upstream (the coordinator's page-local history fold) is preserved.
      */
     private applyReactionTally;
+    /**
+     * Rebuild the target message's rendered `text` + `edited` flag from the
+     * authoritative edit fold and re-emit, PRESERVING `.reactions` and `.replyTo`
+     * (the reaction-polish lesson — never clobber). text = `editFold.text(cid) ??
+     * base`; base is the seeded original so a forged/ignored edit leaves it intact.
+     * No-op when the target isn't present yet (the fold already recorded it; the
+     * overlay applies the moment the target lands) or when unchanged.
+     */
+    private recomputeEdit;
+    /**
+     * Overlay the authoritative edit fold's winning text + flag onto a message as it
+     * is appended/merged. The fold WINS when it has an edit for this target;
+     * otherwise the upstream `text`/`edited` (e.g. the coordinator's page-local
+     * history fold) is preserved. PRESERVES reactions + replyTo.
+     */
+    private applyEditOverlay;
     /** @internal — called by the backend's conv subscription. */
     applyConv(event: string, payload: Record<string, unknown>): void;
     private kindOf;
@@ -963,6 +1020,14 @@ declare class Chat {
     /** Remove this user's emoji reaction from a message (op:'remove'). */
     unreact(message: ChatMessage, emoji: string): Promise<void>;
     private sendReaction;
+    /** Edit an own text message (edit-by-supersession). No-op if the message isn't
+     * editable (empty clientMsgId, or not a `text` kind). The edit folds locally
+     * with the server receipt's `(epoch, serverSeq)` so the target's text updates
+     * instantly; the durable echo on the next pump is a fold no-op (dedup on the
+     * SAME wire clientMsgId). Never appends a bubble; PRESERVES the target's
+     * reactions + reply context. Only the original author's edits count — for an own
+     * message self IS the author, so the author-gate passes. */
+    edit(message: ChatMessage, newText: string): Promise<void>;
 }
 
 declare class PalbeMessaging {
@@ -1354,4 +1419,4 @@ declare class PalbeAnalytics {
     private post;
 }
 
-export { type AnalyticsProperties as A, type RealtimeConnectionState as B, Call as C, type RealtimeHandler as D, type RealtimePayload as E, type FlagsView as F, type RealtimeStatus as G, type RealtimeStatusSnapshot as H, type RealtimeSubscription as I, type PalbeRuntime as J, buildRuntime as K, type MagicLinkResult as M, type OAuthExchangeResult as O, PalbeAnalytics as P, RealtimeChannel as R, type SentReceipt as S, type Unsubscribe as U, type AuthChangeEvent as a, type AuthState as b, type AuthSuccess as c, type AuthUser as d, type CallChangeCallback as e, type CallParticipant as f, type CallState as g, Chat as h, type ChatBackend as i, type ChatDraft as j, type ChatKind as k, type ChatMember as l, type ChatMessage as m, type ChatMessageKind as n, type ChatRole as o, type ChatState as p, type CommsPrefs as q, type MessageDirection as r, PalbeAuth as s, PalbeCalls as t, type PalbeConfig as u, PalbeFlags as v, PalbeMessaging as w, type PalbeOAuthConfig as x, PalbeRealtime as y, type PresenceState as z };
+export { type AnalyticsProperties as A, type RealtimeConnectionState as B, Call as C, type RealtimeHandler as D, type RealtimePayload as E, type FlagsView as F, type RealtimeStatus as G, type RealtimeStatusSnapshot as H, type RealtimeSubscription as I, type ResolvedReply as J, type PalbeRuntime as K, buildRuntime as L, type MagicLinkResult as M, type OAuthExchangeResult as O, PalbeAnalytics as P, RealtimeChannel as R, type SentReceipt as S, type Unsubscribe as U, type AuthChangeEvent as a, type AuthState as b, type AuthSuccess as c, type AuthUser as d, type CallChangeCallback as e, type CallParticipant as f, type CallState as g, Chat as h, type ChatBackend as i, type ChatDraft as j, type ChatKind as k, type ChatMember as l, type ChatMessage as m, type ChatMessageKind as n, type ChatRole as o, type ChatState as p, type CommsPrefs as q, type MessageDirection as r, PalbeAuth as s, PalbeCalls as t, type PalbeConfig as u, PalbeFlags as v, PalbeMessaging as w, type PalbeOAuthConfig as x, PalbeRealtime as y, type PresenceState as z };