@ethora/chat-component 26.9.6 → 26.10.1

package/dist/main.css

@@ -1 +1 @@
-.ethora-chat-root{font-family:var( --ethora-font-family, -apple-system, BlinkMacSystemFont, "Segoe UI", "Roboto", "Oxygen", "Ubuntu", "Cantarell", "Fira Sans", "Droid Sans", "Helvetica Neue", sans-serif );-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.ethora-chat-root code{font-family:source-code-pro,Menlo,Monaco,Consolas,Courier New,monospace}.ethora-chat-root,.ethora-chat-root *{scrollbar-width:thin;scrollbar-color:rgba(20,20,20,.22) transparent;scrollbar-color:var( --ethora-scrollbar-thumb, color-mix(in srgb, var(--ethora-icon-color, #0052cd) 35%, transparent) ) var(--ethora-scrollbar-track, transparent)}.ethora-chat-root::-webkit-scrollbar,.ethora-chat-root ::-webkit-scrollbar{width:8px;height:8px}.ethora-chat-root::-webkit-scrollbar-thumb,.ethora-chat-root ::-webkit-scrollbar-thumb{background-color:#14141438;background-color:var( --ethora-scrollbar-thumb, color-mix(in srgb, var(--ethora-icon-color, #0052cd) 35%, transparent) );border-radius:var(--ethora-radius-full, 999px);border:2px solid transparent;background-clip:content-box}.ethora-chat-root::-webkit-scrollbar-thumb:hover,.ethora-chat-root ::-webkit-scrollbar-thumb:hover{background-color:#14141466;background-color:var( --ethora-scrollbar-thumb-hover, color-mix(in srgb, var(--ethora-icon-color, #0052cd) 60%, transparent) );background-clip:content-box}.ethora-chat-root::-webkit-scrollbar-track,.ethora-chat-root ::-webkit-scrollbar-track{background-color:var(--ethora-scrollbar-track, transparent)}.ethora-apple-emoji{font-family:"Apple Color Emoji","Segoe UI Emoji","Noto Color Emoji",sans-serif}.ethora-chat-root .emoji-mart{max-width:320px;max-height:360px;overflow-y:auto;border-radius:12px;box-shadow:0 4px 12px #0000001a}[data-message-id].ethora-message-highlight{animation:ethoraMessageFlash 1s ease-out;border-radius:var(--ethora-radius-md, 12px)}@keyframes ethoraMessageFlash{0%{background-color:color-mix(in srgb,var(--ethora-color-primary, #0052cd) 35%,transparent)}to{background-color:transparent}}.ethora-message-highlight{animation:ethoraMessageHighlight 1s ease-out;transition:background-color .3s ease}@keyframes ethoraMessageHighlight{0%{background-color:#2196f366;transform:scale(1.02);box-shadow:0 0 0 2px #2196f333}30%{background-color:#2196f34d;box-shadow:0 0 0 2px #2196f326}60%{background-color:#2196f333;box-shadow:0 0 0 1px #2196f31a}to{background-color:transparent;transform:scale(1);box-shadow:none}}@media(max-width:768px){.ethora-message-notification-container{left:50%!important;right:auto!important;transform:translate(-50%)!important;align-items:center!important}.ethora-message-notification-container[data-position-horizontal=left],.ethora-message-notification-container[data-position-horizontal=right]{left:50%!important;right:auto!important;transform:translate(-50%)!important}}
+.ethora-chat-root{font-family:var( --ethora-font-family, -apple-system, BlinkMacSystemFont, "Segoe UI", "Roboto", "Oxygen", "Ubuntu", "Cantarell", "Fira Sans", "Droid Sans", "Helvetica Neue", sans-serif );-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.ethora-chat-root code{font-family:source-code-pro,Menlo,Monaco,Consolas,Courier New,monospace}.ethora-chat-root,.ethora-chat-root *{scrollbar-width:thin;scrollbar-color:rgba(20,20,20,.22) transparent;scrollbar-color:var( --ethora-scrollbar-thumb, color-mix(in srgb, var(--ethora-icon-color, #0052cd) 35%, transparent) ) var(--ethora-scrollbar-track, transparent)}.ethora-chat-root::-webkit-scrollbar,.ethora-chat-root ::-webkit-scrollbar{width:8px;height:8px}.ethora-chat-root::-webkit-scrollbar-thumb,.ethora-chat-root ::-webkit-scrollbar-thumb{background-color:#14141438;background-color:var( --ethora-scrollbar-thumb, color-mix(in srgb, var(--ethora-icon-color, #0052cd) 35%, transparent) );border-radius:var(--ethora-radius-full, 999px);border:2px solid transparent;background-clip:content-box}.ethora-chat-root::-webkit-scrollbar-thumb:hover,.ethora-chat-root ::-webkit-scrollbar-thumb:hover{background-color:#14141466;background-color:var( --ethora-scrollbar-thumb-hover, color-mix(in srgb, var(--ethora-icon-color, #0052cd) 60%, transparent) );background-clip:content-box}.ethora-chat-root::-webkit-scrollbar-track,.ethora-chat-root ::-webkit-scrollbar-track{background-color:var(--ethora-scrollbar-track, transparent)}.ethora-apple-emoji{font-family:"Apple Color Emoji","Segoe UI Emoji","Noto Color Emoji",sans-serif}.ethora-chat-root .emoji-mart{max-width:320px;max-height:360px;overflow-y:auto;border-radius:12px;box-shadow:0 4px 12px #0000001a}[data-message-id].ethora-message-highlight{animation:none;transition:none}[data-message-id].ethora-message-highlight [data-ethora-bubble]{animation:ethoraBubblePulse 1s ease-out forwards}[data-message-id].ethora-message-highlight [data-ethora-bubble]:after{content:"";position:absolute;inset:0;border-radius:inherit;pointer-events:none;z-index:1;background-color:color-mix(in srgb,var(--ethora-color-primary, #0052cd) 22%,transparent);animation:ethoraBubbleTint 1s ease-out forwards}@keyframes ethoraBubblePulse{0%{box-shadow:0 0 color-mix(in srgb,var(--ethora-color-primary, #0052cd) 55%,transparent)}35%{box-shadow:0 0 0 3px color-mix(in srgb,var(--ethora-color-primary, #0052cd) 60%,transparent),0 0 14px 2px color-mix(in srgb,var(--ethora-color-primary, #0052cd) 35%,transparent)}to{box-shadow:0 0 0 9px color-mix(in srgb,var(--ethora-color-primary, #0052cd) 0%,transparent)}}@keyframes ethoraBubbleTint{0%{opacity:0}20%{opacity:1}to{opacity:0}}@media(prefers-reduced-motion:reduce){[data-message-id].ethora-message-highlight [data-ethora-bubble]{animation:none;box-shadow:0 0 0 2px var(--ethora-color-primary, #0052cd)}[data-message-id].ethora-message-highlight [data-ethora-bubble]:after{animation:none;display:none}}.ethora-message-highlight{animation:ethoraMessageHighlight 1s ease-out;transition:background-color .3s ease}@keyframes ethoraMessageHighlight{0%{background-color:#2196f366;transform:scale(1.02);box-shadow:0 0 0 2px #2196f333}30%{background-color:#2196f34d;box-shadow:0 0 0 2px #2196f326}60%{background-color:#2196f333;box-shadow:0 0 0 1px #2196f31a}to{background-color:transparent;transform:scale(1);box-shadow:none}}@media(max-width:768px){.ethora-message-notification-container{left:50%!important;right:auto!important;transform:translate(-50%)!important;align-items:center!important}.ethora-message-notification-container[data-position-horizontal=left],.ethora-message-notification-container[data-position-horizontal=right]{left:50%!important;right:auto!important;transform:translate(-50%)!important}}

package/dist/main.js

@@ -1,4 +1,4 @@
-import { ba as a, bb as r, bc as b, bd as o, be as t, bf as u, bg as i, bh as p, bi as h, bj as n, bk as l, bl as d, bm as f, L as m, bn as T, bo as g, bp as y, bq as I, br as R, bs as c, bt as k, bu as C, bv as A, ak as E, al as Q, bw as v, bx as F } from "./main-rJpE4hh-.js";
+import { br as a, bs as r, bt as b, bu as o, bv as t, bw as u, bx as i, by as p, bz as h, bA as n, bB as d, i as l, bC as y, S as I, bD as T, bE as f, bF as m, bG as R, bH as g, bI as c, bJ as C, bK as A, bL as E, aq as F, ar as M, bM as Q, bN as k } from "./main-CUB_w8AZ.js";
 export {
   a as AuthTestIds,
   r as Chat,
@@ -10,21 +10,21 @@ export {
   p as applyTypography,
   h as clearTypography,
   n as formatFingerprint,
-  l as handleQRChatId,
-  d as isE2eeEnabled,
-  f as isRefreshFatalError,
-  m as logoutService,
+  d as handleQRChatId,
+  l as isE2eeEnabled,
+  y as isRefreshFatalError,
+  I as logoutService,
   T as omemo,
-  g as parseQuickReplies,
-  y as refreshAuthTokens,
-  I as refreshAuthTokensQuietly,
-  R as resendMessage,
+  f as parseQuickReplies,
+  m as refreshAuthTokens,
+  R as refreshAuthTokensQuietly,
+  g as resendMessage,
   c as useInAppNotifications,
-  k as useIsUserOnline,
-  C as usePushNotifications,
-  A as useQRCodeChat,
-  E as useRoomMute,
-  Q as useRoomPresence,
-  v as useTypography,
-  F as useUnread
+  C as useIsUserOnline,
+  A as usePushNotifications,
+  E as useQRCodeChat,
+  F as useRoomMute,
+  M as useRoomPresence,
+  Q as useTypography,
+  k as useUnread
 };

package/dist/networking/api-requests/auth.api.d.ts

@@ -27,6 +27,8 @@ export interface UploadFileOptions {
      * BEFORE the secure/legacy split so both routes carry it.
      */
     clientEncrypted?: boolean;
+    /** Upload progress for this request, 0 to 100. */
+    onProgress?: (percent: number) => void;
 }
 export declare function uploadFile(formData: FormData, activeRoomJID: string, options?: UploadFileOptions): Promise<import('axios').AxiosResponse<any, any, {}>>;
 export declare function ensureUserFromMy(user: User | null | undefined): Promise<User | null>;

package/dist/networking/api-requests/roomMembers.api.d.ts

@@ -1,2 +1,20 @@
 import { RoomMember } from '../../types/types';
+export type UserLookupRoute = 'auto' | 'v1' | 'v2';
+export type UserLookupOutcome = {
+    status: 'ok';
+    user: RoomMember;
+} | {
+    status: 'notfound' | 'forbidden' | 'error';
+};
+/** Module-level override of config.userLookupRoute (tests, non-React hosts). */
+export declare const setUserLookupRoute: (route: UserLookupRoute | null) => void;
+/** Forgets what was learned about the routes (account change, logout, tests). */
+export declare const resetUserLookupRoute: () => void;
+/** Visible for tests and diagnostics. */
+export declare const isUserV1RouteUnsupported: () => boolean;
+/**
+ * One user by `appId_userId`, through the route chain above. Never throws.
+ * `forbidden` and `notfound` are per-user answers, `error` is transient.
+ */
+export declare function lookupUser(id: string, token: string): Promise<UserLookupOutcome>;
 export declare function getUserByXmppUsername(xmppUsername: string | undefined, token: string): Promise<RoomMember | null>;

package/dist/networking/callKeyStanza.d.ts

@@ -0,0 +1,7 @@
+import { Element } from 'ltx';
+/**
+ * Claims a decrypted <call-key> signal, feeding the media key into the call
+ * slice. Returns true when it handled the stanza (so the caller stops
+ * dispatching it to the chat handlers).
+ */
+export declare function onCallKeyStanza(stanza: Element): boolean;

package/dist/networking/ethoraEvents.d.ts

@@ -0,0 +1,44 @@
+import { Element } from 'ltx';
+/**
+ * Server push `<ethora-event xmlns="urn:ethora:events:1" .../>` inside a
+ * `type="headline"` message from the server's admin account:
+ *
+ *   user-profile-updated  xmppUsername="<appId>_<userId>" uuid appId
+ *   chat-meta-updated     chatName="<appId>_<roomId>" appId
+ *
+ * The payload is a pointer only. The client re-reads the user or the room
+ * through the normal API, so nothing in the stanza is ever shown or stored.
+ * Everything in the stanza is untrusted input until proven otherwise.
+ */
+export declare const ETHORA_EVENT_XMLNS = "urn:ethora:events:1";
+export declare const ETHORA_EVENT_USER_PROFILE = "user-profile-updated";
+export declare const ETHORA_EVENT_CHAT_META = "chat-meta-updated";
+type HostLike = {
+    host?: string;
+    client?: {
+        jid?: {
+            getDomain?: () => string;
+        };
+    };
+};
+/**
+ * True when a headline came from the server and not from a user or a room.
+ * - from must be a BARE jid (a user's c2s stanza or a MUC occupant always
+ *   carries a resource, and the server stamps it, so it cannot be spoofed)
+ * - its domain must be the session's own XMPP domain (not conference.*, not
+ *   another server)
+ * - when config.trustedEventSenders is set, the sender must be listed
+ * The server's admin local part is deployment config (XMPP_ADMIN), so it
+ * cannot be hard-coded here.
+ */
+export declare const isTrustedEventSender: (stanza: Element, xmppWs: HostLike | undefined) => boolean;
+/**
+ * Handles `<ethora-event>` headlines. Returns true when the stanza carried
+ * one (trusted or not), so the caller can stop routing it. Unknown types,
+ * malformed attributes and untrusted senders are ignored silently. Never
+ * throws.
+ */
+export declare function onEthoraEvent(stanza: Element, xmppWs?: HostLike): boolean;
+/** Drops timers and per-room state (tests, logout). */
+export declare function resetEthoraEvents(): void;
+export {};

package/dist/networking/stanzaHandlers.d.ts

@@ -4,9 +4,11 @@ import { default as XmppClient } from './xmppClient';
 declare const onRealtimeMessage: (stanza: Element, xmppClient?: XmppClient) => Promise<IMessage>;
 declare const onReactionMessage: (stanza: Element) => Promise<void>;
 declare const onDeleteMessage: (stanza: Element) => Promise<void>;
+declare const onReceivedReceipt: (stanza: Element) => Promise<void>;
+declare const onDisplayedMarker: (stanza: Element) => Promise<void>;
 declare const onEditMessage: (stanza: Element) => Promise<void>;
 declare const onReactionHistory: (stanza: any) => Promise<void>;
-declare const onMessageHistory: (stanza: any) => Promise<void>;
+declare const onMessageHistory: (stanza: any, xmppClient?: XmppClient) => Promise<void>;
 declare const handleComposing: (stanza: Element, currentUser: string) => Promise<void>;
 declare const onPresenceInRoom: (stanza: Element | any) => void;
 declare const onChatInvite: (stanza: Element, client: XmppClient) => Promise<void>;
@@ -29,6 +31,6 @@ export type XMPPErrorInfo = {
     message: string;
 };
 export declare const handleErrorMessageStanza: (stanza: Element) => XMPPErrorInfo | null;
-declare const onUserUpdate: (stanza: Element) => Promise<void>;
-declare const onChatUpdate: (stanza: Element) => Promise<void>;
-export { onRealtimeMessage, onMessageHistory, onPresenceInRoom, onReactionHistory, onGetLastMessageArchive, handleComposing, onGetChatRooms, onNewRoomCreated, onGetMembers, onGetRoomInfo, onDeleteMessage, onEditMessage, onReactionMessage, onChatInvite, onRoomKicked, onRoomMembershipChange, onMembersRefreshSignal, onMessageError, onUserUpdate, onChatUpdate, };
+declare const onUserUpdate: (stanza: Element, xmppWs?: XmppClient) => Promise<void>;
+declare const onChatUpdate: (stanza: Element, xmppWs?: XmppClient) => Promise<void>;
+export { onRealtimeMessage, onMessageHistory, onPresenceInRoom, onReactionHistory, onGetLastMessageArchive, handleComposing, onGetChatRooms, onNewRoomCreated, onGetMembers, onGetRoomInfo, onDeleteMessage, onEditMessage, onReactionMessage, onReceivedReceipt, onDisplayedMarker, onChatInvite, onRoomKicked, onRoomMembershipChange, onMembersRefreshSignal, onMessageError, onUserUpdate, onChatUpdate, };

package/dist/networking/xmpp/allRoomPresences.xmpp.d.ts

@@ -11,4 +11,21 @@ export interface AllRoomPresenceSummary {
     }>;
 }
 export type RoomJoiner = (roomJid: string) => Promise<boolean>;
-export declare function allRoomPresences(client: Client, join?: RoomJoiner): Promise<AllRoomPresenceSummary>;
+export interface AllRoomPresencesOptions {
+    /** Parallel joins. Default 5. */
+    concurrency?: number;
+    /** Pause after each join, per worker. Default 30 ms. */
+    pacingMs?: number;
+    /** Rooms the connection already joined: skipped, no round trip. */
+    isJoined?: (roomJid: string) => boolean;
+    /** The room the user has open: always joined next, ahead of the queue. */
+    getActiveRoomJid?: () => string | null | undefined;
+    /** Higher = joined earlier (recent activity). Default: store order. */
+    rank?: (roomJid: string) => number;
+    /** True once this sweep is obsolete (connection dropped and replaced). */
+    isCancelled?: () => boolean;
+    /** Fired once the first wave (the active room plus one pool-width of the
+     *  most recent rooms) has settled, long before the rest of the sweep. */
+    onPriorityDone?: () => void;
+}
+export declare function allRoomPresences(client: Client, join?: RoomJoiner, options?: AllRoomPresencesOptions): Promise<AllRoomPresenceSummary>;

package/dist/networking/xmpp/presenceInRoom.xmpp.d.ts

@@ -1,3 +1,3 @@
 import { Client } from '@xmpp/client';
 import { Element } from '@xmpp/xml';
-export declare const presenceInRoom: (client: Client, roomJID: string, delay?: number, timeoutMs?: number) => Promise<Element>;
+export declare const presenceInRoom: (client: Client, roomJID: string, delay?: number, timeoutMs?: number, historyStanzas?: number) => Promise<Element>;

package/dist/networking/xmpp/sendDisplayedMarker.xmpp.d.ts

@@ -0,0 +1,2 @@
+import { Client } from '@xmpp/client';
+export declare function sendDisplayedMarker(client: Client, messageId: string, roomJid: string): void;

package/dist/networking/xmpp/sendMediaMessage.xmpp.d.ts

@@ -1,4 +1,5 @@
 import { Client } from '@xmpp/client';
+import { IMentionSpan } from '../../types/types';
 /**
  * What <body> carries in an e2ee room: the key material for each sealed
  * attachment, in the same order as `attachments` / the flat fields on <data>.
@@ -9,5 +10,12 @@ import { Client } from '@xmpp/client';
 export interface E2eeMediaBody {
     v: 1;
     keys: string[];
+    /**
+     * The text typed with the files. It lives here, inside the envelope, and
+     * nowhere on <data>, so an e2ee caption is never readable in transit.
+     * Older readers only look at `keys` and ignore the rest.
+     */
+    caption?: string;
+    captionMentions?: IMentionSpan[];
 }
 export declare function sendMediaMessage(client: Client, roomJID: string, data: any, id: string): Promise<void>;

package/dist/networking/xmpp/sendReceivedReceipt.xmpp.d.ts

@@ -0,0 +1,2 @@
+import { Client } from '@xmpp/client';
+export declare function sendReceivedReceipt(client: Client, messageId: string, roomJid: string): void;

package/dist/networking/xmppClient.d.ts

@@ -2,6 +2,18 @@ import { Client } from '@xmpp/client';
 import { Iso639_1Codes, XmppClientInterface, xmppSettingsInterface, IMessage, IMentionSpan } from '../types/types';
 import { AllRoomPresenceSummary } from './xmpp/allRoomPresences.xmpp';
 type HistorySource = 'active' | 'send_ack' | 'background' | 'default';
+/** What the server's <fin> said about one windowed MAM page. */
+export interface HistoryWindowFin {
+    complete: boolean;
+    first: number | null;
+    last: number | null;
+}
+/** One page of a windowed history query, returned instead of stored. */
+export interface HistoryWindowPage extends HistoryWindowFin {
+    ok: boolean;
+    /** Ascending by time (oldest first), whichever direction was paged. */
+    messages: IMessage[];
+}
 export type XmppCredentialsProvider = () => Promise<{
     username: string;
     password: string;
@@ -24,6 +36,12 @@ export declare class XmppClient implements XmppClientInterface {
     private reconnecting;
     private reconnectPromise;
     presencesReady: boolean;
+    priorityPresencesReady: boolean;
+    private sweepEpoch;
+    private sweepRetryTimer;
+    private sweepRetryRunning;
+    private static readonly SWEEP_RETRY_DELAYS_MS;
+    private joinConcurrency;
     private sendAllPresencesInFlight;
     private connectionSteps;
     private messageQueue;
@@ -46,11 +64,16 @@ export declare class XmppClient implements XmppClientInterface {
     private historyQueueWorkerScheduled;
     private historyQueueWorkerTimer;
     private roomHistoryEpoch;
+    private historyReceiptAckedIds;
+    private readonly maxHistoryReceiptAckedIds;
     private criticalSendUntil;
     private activeRoomBoostUntil;
     private sendStartedAtById;
+    private sessionOnlineAt;
+    private lastSentAtById;
     private pendingSendIdsByRoom;
     private maxInFlightHistory;
+    private joinHistoryStanzas;
     private softPauseAfterSendMs;
     private activeRoomBoostTtlMs;
     private activeSendBoostMs;
@@ -183,13 +206,21 @@ export declare class XmppClient implements XmppClientInterface {
     private startAdaptivePing;
     private markActivity;
     sendAllPresencesAndMarkReady(): Promise<void>;
+    private hasUnjoinedRooms;
     private runAllPresencesSweep;
+    private clearSweepRetry;
+    private nextSweepRetryAt;
+    private scheduleSweepRetry;
+    private runSweepRetry;
     reconnect(): Promise<void>;
-    allRoomPresencesStanza(): Promise<AllRoomPresenceSummary>;
+    allRoomPresencesStanza(epoch?: number): Promise<AllRoomPresenceSummary>;
     ensureConnected(timeout?: number): Promise<void>;
     close(): Promise<void>;
     wrapWithConnectionCheck<T>(operation: () => Promise<T>): Promise<T>;
     private clearMamRegistry;
+    private static readonly HISTORY_WATCHDOG_MS;
+    private historyQueueGeneration;
+    private abandonMamRequest;
     private clearHistoryQueue;
     private getSendLane;
     setActiveRoomJid(roomJID: string | null): void;
@@ -210,6 +241,16 @@ export declare class XmppClient implements XmppClientInterface {
     private pickNextHistoryTask;
     private processHistoryQueue;
     private executeHistoryTask;
+    /**
+     * Writes one archive page into the store. A LATEST page (no `before`)
+     * that is full and starts after everything the room has cached means more
+     * than a page arrived while this client was away: merging it would leave a
+     * silent hole between the cache and the page, so the cache is replaced
+     * (the same "cache reset" the startup catch-up does when its anchor is
+     * missing). Anything overlapping the cache is merged as before.
+     */
+    private storeHistoryPage;
+    private clearPreloadError;
     private parseMamMessages;
     private routeMamStanza;
     private requestMamHistory;
@@ -247,7 +288,22 @@ export declare class XmppClient implements XmppClientInterface {
         coalesceRoom?: boolean;
         skipIfPreloaded?: boolean;
         source?: HistorySource;
-    }) => Promise<any>;
+        reissued?: boolean;
+    }) => Promise<IMessage[] | undefined>;
+    private guardHistoryRequest;
+    /**
+     * One page of archive for a window around a message, RETURNED rather than
+     * stored: no setRoomMessages, no messageStats / historyComplete update, so
+     * the live history is untouched. Pass `before` for the page ending just
+     * before that archive id, or `after` for the page starting just after it
+     * (both exclusive; microsecond MAM ids). Messages come back oldest first.
+     */
+    getHistoryWindow: (chatJID: string, max: number, cursor: {
+        before?: number;
+        after?: number;
+        start?: string;
+        end?: string;
+    }) => Promise<HistoryWindowPage>;
     getLastMessageArchiveStanza(roomJID: string): void;
     setRoomImageStanza: (roomJid: string, roomThumbnail: string, type: string, roomBackground?: string) => void;
     getRoomInfoStanza: (roomJID: string) => void;
@@ -259,6 +315,9 @@ export declare class XmppClient implements XmppClientInterface {
     deleteMessageStanza(room: string, msgId: string): void;
     editMessageStanza(room: string, msgId: string, text: string): void;
     sendMessageReactionStanza(messageId: string, roomJid: string, reactionsList: string[], reactionSymbol?: any): void;
+    sendReceivedReceiptStanza(messageId: string, roomJid: string): void;
+    sendDisplayedMarkerStanza(messageId: string, roomJid: string): void;
+    sendHistoryReceivedReceiptStanza(roomJid: string, messageId: string): void;
     sendTypingRequestStanza(chatId: string, fullName: string, start: boolean): void;
     getChatsPrivateStoreRequestStanza: () => Promise<Record<string, string | number> | null>;
     actionSetTimestampToPrivateStoreStanza(chatId: string, timestamp: number, chats?: string[]): Promise<void>;

package/dist/roomStore/Middleware/jumpThreadMiddleware.d.ts

@@ -0,0 +1,2 @@
+import { Middleware } from '@reduxjs/toolkit';
+export declare const jumpThreadMiddleware: Middleware;

package/dist/roomStore/callSlice.d.ts

@@ -11,6 +11,8 @@ export interface CallState {
     callId: string | null;
     peerXmppUsername: string | null;
     token: string | null;
+    e2eeKey: string | null;
+    e2eeKeyCallId: string | null;
     error: string | null;
     startedAt: number | null;
     connectedAt: number | null;
@@ -33,6 +35,9 @@ export declare const startOutgoingCall: import('@reduxjs/toolkit').ActionCreator
     roomJid: string;
     token: string;
     callId?: string | null;
-}, "call/setOutgoingCallToken">, acceptIncomingCall: import('@reduxjs/toolkit').ActionCreatorWithoutPayload<"call/acceptIncomingCall">, declineIncomingCall: import('@reduxjs/toolkit').ActionCreatorWithoutPayload<"call/declineIncomingCall">, endCall: import('@reduxjs/toolkit').ActionCreatorWithoutPayload<"call/endCall">, setCallError: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<string, "call/setCallError">, setCallPhase: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<CallPhase, "call/setCallPhase">, setCallKind: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<CallKind, "call/setCallKind">, resetCall: import('@reduxjs/toolkit').ActionCreatorWithoutPayload<"call/resetCall">;
+}, "call/setOutgoingCallToken">, acceptIncomingCall: import('@reduxjs/toolkit').ActionCreatorWithoutPayload<"call/acceptIncomingCall">, declineIncomingCall: import('@reduxjs/toolkit').ActionCreatorWithoutPayload<"call/declineIncomingCall">, endCall: import('@reduxjs/toolkit').ActionCreatorWithoutPayload<"call/endCall">, setCallError: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<string, "call/setCallError">, setCallPhase: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<CallPhase, "call/setCallPhase">, setCallKind: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<CallKind, "call/setCallKind">, setCallE2eeKey: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<{
+    key: string;
+    callId: string | null;
+}, "call/setCallE2eeKey">, resetCall: import('@reduxjs/toolkit').ActionCreatorWithoutPayload<"call/resetCall">;
 declare const _default: import('redux').Reducer<import('immer').WritableDraft<CallState>>;
 export default _default;

package/dist/roomStore/index.d.ts

@@ -32,6 +32,28 @@ export declare const optimizePersistedRooms: (rooms: Record<string, IRoom>, char
 export declare const compactUsersSetForPersist: (usersSet: Record<string, any>) => Record<string, any>;
 /** Puts back what compactUsersSetForPersist folded into the key. */
 export declare const restoreUsersSetForRehydrate: (usersSet: Record<string, any>) => Record<string, any>;
+/**
+ * Per-session facts about a room that must not survive a reload. A persisted
+ * 'done' made the next page load treat the cached transcript as current:
+ * the preload sweep skipped the room and opening it returned the cache
+ * without asking the server, so anything sent while the page was closed was
+ * missing until a manual refetch. 'done'/'loading' go back to
+ * 'partial'/'idle' (the room is refetched once per session, and a page that
+ * does not overlap the cache replaces it instead of leaving a hole). The
+ * API's unread count is likewise a snapshot of that moment: the next
+ * /chats/my response re-seeds it.
+ */
+export declare const resetSessionRoomState: (roomsMap: Record<string, IRoom>) => Record<string, IRoom>;
+/**
+ * A transcript cached by a build that did not persist reactions repaints every
+ * bubble without its reaction chips, and the archive will not re-deliver them
+ * for the cached middle (the latest page is merged onto the cache and the
+ * backfill resumes from the cache's oldest message). Such a cache is dropped
+ * once - the room shell stays, the transcript is refetched from MAM - exactly
+ * like the cache-budget eviction, except the paging cursors go with it: a
+ * stale first/last id would make the backfill start behind the dropped range.
+ */
+export declare const dropReactionlessCaches: (roomsMap: Record<string, IRoom>) => Record<string, IRoom>;
 export declare const limitMessagesTransform: import('redux-persist').Transform<any, any, Record<string, any>, Record<string, any>>;
 export declare const scrubSensitiveChatStateTransform: import('redux-persist').Transform<any, any, Record<string, any>, Record<string, any>>;
 export declare const sanitizeRoomsStateTransform: import('redux-persist').Transform<any, any, Record<string, any>, Record<string, any>>;

package/dist/roomStore/roomsSlice.d.ts

@@ -1,4 +1,4 @@
-import { AddRoomMessageAction, ApiRoom, EditAction, IMessage, IRoom, ReactionAction, RoomMember, Translation } from '../types/types';
+import { AddRoomMessageAction, ApiRoom, EditAction, IAttachment, IMessage, IRoom, ReactionAction, RoomMember, Translation } from '../types/types';
 import { default as XmppClient } from '../networking/xmppClient';
 /**
  * Draft caps. Drafts ride along in the persisted rooms slice, so they have
@@ -44,6 +44,27 @@ export interface PendingJump {
     /** Epoch ms the request was made, to drop one nobody ever fulfilled. */
     at: number;
 }
+/**
+ * A short slice of a room's archive around one message, shown INSTEAD of the
+ * live list while the reader is away from the tail (a search jump to a message
+ * far back). Separate from room.messages on purpose: it is not contiguous with
+ * the live history, so it must not touch messageStats or historyComplete.
+ */
+export interface JumpWindow {
+    roomJID: string;
+    /** Ascending by time, like room.messages. */
+    messages: IMessage[];
+    /** Id of the message the jump named, as it appears in `messages`. */
+    targetId: string;
+    /** RSM cursor (microseconds) to continue older paging from. */
+    olderCursor: number | null;
+    hasOlder: boolean;
+    /** RSM cursor (microseconds) to continue newer paging from. */
+    newerCursor: number | null;
+    hasNewer: boolean;
+}
+/** The window is trimmed on the far side past this many messages. */
+export declare const JUMP_WINDOW_MAX_MESSAGES = 300;
 interface RoomMessagesState {
     rooms: {
         [jid: string]: IRoom;
@@ -64,6 +85,7 @@ interface RoomMessagesState {
     roomsLoadError: boolean;
     pendingJump: PendingJump | null;
     archivedMessage: ArchivedMessage | null;
+    jumpWindow: JumpWindow | null;
     joiningRoomJID: string | null;
     drafts: Record<string, string>;
 }
@@ -107,7 +129,13 @@ export declare const addRoom: import('@reduxjs/toolkit').ActionCreatorWithOption
 }, "roomMessages/setMessageSendFailed">, setMessageSendRetrying: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<{
     roomJID: string;
     messageId: string;
-}, "roomMessages/setMessageSendRetrying">, editRoomMessage: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<{
+}, "roomMessages/setMessageSendRetrying">, setMediaUploadState: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<{
+    roomJID: string;
+    messageId: string;
+    attachments?: IAttachment[];
+    pending?: boolean;
+    failed?: boolean;
+}, "roomMessages/setMediaUploadState">, editRoomMessage: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<{
     roomJID: string;
     messageId: string;
     text: string;
@@ -139,7 +167,17 @@ export declare const addRoom: import('@reduxjs/toolkit').ActionCreatorWithOption
     createdAt?: string;
     body?: string;
     preview?: ArchivedMessage;
-}, "roomMessages/requestJumpToMessage">, clearPendingJump: import('@reduxjs/toolkit').ActionCreatorWithoutPayload<"roomMessages/clearPendingJump">, showArchivedMessage: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<ArchivedMessage, "roomMessages/showArchivedMessage">, clearArchivedMessage: import('@reduxjs/toolkit').ActionCreatorWithoutPayload<"roomMessages/clearArchivedMessage">, setJoiningRoom: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<string, "roomMessages/setJoiningRoom">, clearJoiningRoom: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<string, "roomMessages/clearJoiningRoom">, setCurrentRoom: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<{
+}, "roomMessages/requestJumpToMessage">, clearPendingJump: import('@reduxjs/toolkit').ActionCreatorWithoutPayload<"roomMessages/clearPendingJump">, showArchivedMessage: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<ArchivedMessage, "roomMessages/showArchivedMessage">, clearArchivedMessage: import('@reduxjs/toolkit').ActionCreatorWithoutPayload<"roomMessages/clearArchivedMessage">, setJumpWindow: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<JumpWindow, "roomMessages/setJumpWindow">, prependJumpWindowMessages: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<{
+    roomJID: string;
+    messages: IMessage[];
+    olderCursor: number | null;
+    hasOlder: boolean;
+}, "roomMessages/prependJumpWindowMessages">, appendJumpWindowMessages: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<{
+    roomJID: string;
+    messages: IMessage[];
+    newerCursor: number | null;
+    hasNewer: boolean;
+}, "roomMessages/appendJumpWindowMessages">, clearJumpWindow: import('@reduxjs/toolkit').ActionCreatorWithoutPayload<"roomMessages/clearJumpWindow">, setJoiningRoom: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<string, "roomMessages/setJoiningRoom">, clearJoiningRoom: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<string, "roomMessages/clearJoiningRoom">, setCurrentRoom: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<{
     roomJID: string | null;
 }, "roomMessages/setCurrentRoom">, setMemberOnline: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<{
     roomJID: string;
@@ -150,7 +188,16 @@ export declare const addRoom: import('@reduxjs/toolkit').ActionCreatorWithOption
 }, "roomMessages/setMemberOffline">, setChatUiVisible: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<boolean, "roomMessages/setChatUiVisible">, setRoomRole: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<{
     chatJID: string;
     role: string;
-}, "roomMessages/setRoomRole">, setReactions: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<ReactionAction, "roomMessages/setReactions">, setLogoutState: import('@reduxjs/toolkit').ActionCreatorWithoutPayload<"roomMessages/setLogoutState">, setActiveMessage: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<{
+}, "roomMessages/setRoomRole">, setReactions: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<ReactionAction, "roomMessages/setReactions">, setReceivedReceipt: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<{
+    roomJID: string;
+    messageId: string;
+    fromXmppUsername: string;
+    timestamp: number;
+}, "roomMessages/setReceivedReceipt">, setDisplayedMarker: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<{
+    roomJID: string;
+    xmppUsername: string;
+    messageId: string;
+}, "roomMessages/setDisplayedMarker">, setLogoutState: import('@reduxjs/toolkit').ActionCreatorWithoutPayload<"roomMessages/setLogoutState">, setActiveMessage: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<{
     id: string;
     chatJID: string;
 }, "roomMessages/setActiveMessage">, setCloseActiveMessage: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<{

package/dist/roomStore/safeKey.d.ts

@@ -0,0 +1,12 @@
+/** True when `key` is a non-empty string that is safe to use as an object key. */
+export declare const isSafeKey: (key: unknown) => key is string;
+/** True when `name` is a property name every object already has. */
+export declare const isReservedName: (name: string) => boolean;
+/**
+ * True for an `<appId>_<rest>` id that is safe to send and to store: the whole
+ * id and every underscore-separated segment after the first must not be a
+ * reserved object name, and no segment may start with `__` (which also
+ * rejects `<appId>___proto__`, where the split yields an empty segment and a
+ * `__`-prefixed one).
+ */
+export declare const hasSafeIdSegments: (id: string) => boolean;

package/dist/roomStore/usersSetCap.d.ts

@@ -0,0 +1,15 @@
+import { RoomMember } from '../types/types';
+/**
+ * usersSet is persisted, and lazily resolved senders keep adding to it, so
+ * it needs a ceiling. Object key order is insertion order, so "least
+ * recently inserted" is simply the first keys.
+ */
+export declare const USERS_SET_CAP = 5000;
+/** Drops the oldest-inserted entries until at most `cap` remain. */
+export declare const capUsersSet: (usersSet: Record<string, RoomMember>, cap?: number) => void;
+/**
+ * Merges the members of a fresh /chats/my payload into usersSet: fresh
+ * entries win, entries fetched lazily earlier stay. A refreshed key moves to
+ * the newest position so the cap evicts genuinely stale ones first.
+ */
+export declare const mergeUsersSet: (usersSet: Record<string, RoomMember>, fresh: Record<string, RoomMember>, cap?: number) => void;

package/dist/styles/motion.d.ts

@@ -20,7 +20,17 @@ export declare const MOTION_BASE_MS = 220;
 export declare const fadeIn: import('styled-components/dist/models/Keyframes').default;
 export declare const fadeInUp: import('styled-components/dist/models/Keyframes').default;
 export declare const scaleIn: import('styled-components/dist/models/Keyframes').default;
-export declare const shimmer: import('styled-components/dist/models/Keyframes').default;
+/** Skeleton timing: one sweep cycle, and the delay before anything shows. */
+export declare const SHIMMER_SWEEP_MS = 2000;
+export declare const SHIMMER_DELAY_MS = 120;
+export declare const SHIMMER_FADE_IN_MS = 240;
+/**
+ * The loading band drifts left to right (reading direction). Keyframes move
+ * the band's own transform, not background-position, so the browser can run
+ * it on the compositor. The band is 60% of the host wide, so -100% parks it
+ * just off the left edge and 166.67% just off the right edge.
+ */
+export declare const shimmerSweep: import('styled-components/dist/models/Keyframes').default;
 /**
  * Right-hand side drawer entrance. Travels further than `fadeInUp` (a panel
  * sliding in from the screen edge reads as motion only if it actually
@@ -47,7 +57,17 @@ export declare const fadeInAnimation: import('styled-components').RuleSet<object
 export declare const scaleInAnimation: import('styled-components').RuleSet<object>;
 /** Convenience: side-drawer slide-in shorthand, respecting reduced motion. */
 export declare const slideInRightAnimation: import('styled-components').RuleSet<object>;
-/** Shimmering skeleton background, respecting reduced motion (stays static). */
+/**
+ * Loading skeleton: a calm, slightly tinted base with one soft band sweeping
+ * left to right every 2s. The band fades in with its own transparent edges,
+ * so there is no hard leading or trailing line. Nothing shows for the first
+ * 120ms, so an image that arrives quickly never flashes a placeholder.
+ *
+ * The host must be positioned (`position: relative` or `absolute`, set by the
+ * host itself so this helper cannot override it); the band is an ::after
+ * clipped by the host's `overflow: hidden`. Reduced motion keeps only the
+ * static base.
+ */
 export declare const shimmerBackground: import('styled-components').RuleSet<object>;
 export declare const fadeOut: import('styled-components/dist/models/Keyframes').default;
 export declare const scaleOut: import('styled-components/dist/models/Keyframes').default;

package/dist/types/models/attachment.model.d.ts

@@ -23,6 +23,9 @@ export interface IAttachment {
     /** Bytes, as a string - that is how it travels on the wire. */
     size?: string;
     duration?: string;
+    /** Natural pixel size, when the storage recorded it. Sizes the solo preview box. */
+    width?: number;
+    height?: number;
     ownerKey?: string;
     userId?: string;
     createdAt?: string;
@@ -30,4 +33,20 @@ export interface IAttachment {
     expiresAt?: string;
     isVisible?: boolean;
     isPrivate?: boolean;
+    /**
+     * Local-only state of an outgoing attachment, set by the sender while its
+     * message is still being sent. Never written to the wire.
+     *   uploading - the file is going up (or every file is up and the message
+     *               is waiting on its siblings); `uploadProgress` is 0 to 100.
+     *   failed    - this file did not upload; the message is held until it
+     *               is retried.
+     */
+    uploadStatus?: 'uploading' | 'failed';
+    uploadProgress?: number;
+    /**
+     * Local-only `blob:` URL of the sender's own picture, so an outgoing image
+     * shows at once and stays on screen while the server copy loads. Never
+     * written to the wire.
+     */
+    localUrl?: string;
 }