@ethora/chat-component 26.9.5 → 26.9.8

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}.ethora-message-highlight{animation:ethoraMessageHighlight 2s 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,30 +1,30 @@
-import { b5 as a, b6 as r, b7 as b, b8 as o, b9 as t, ba as i, bb as p, bc as u, bd as h, be as n, bf as l, bg as d, bh as f, L as m, bi as T, bj as g, bk as y, bl as I, bm as R, bn as c, bo as k, bp as C, bq as A, ak as E, al as Q, br as F, bs as M } from "./main-BRIZ98KV.js";
+import { bh as a, bi as r, bj as b, bk as o, bl as t, bm as u, bn as i, bo as p, bp as h, bq as n, br as l, bs as d, bt as m, L as y, bu as T, bv as f, bw as I, bx as R, by as g, bz as c, bA as C, bB as A, bC as E, al as k, am as Q, bD as v, bE as F } from "./main-BnLtessp.js";
 export {
   a as AuthTestIds,
   r as Chat,
   b as ChatInputTestIds,
   o as MessageBubbleTestIds,
   t as RefreshFatalError,
-  i as RoomListTestIds,
-  p as XmppProvider,
-  u as applyTypography,
+  u as RoomListTestIds,
+  i as XmppProvider,
+  p as applyTypography,
   h as clearTypography,
   n as formatFingerprint,
   l as handleQRChatId,
   d as isE2eeEnabled,
-  f as isRefreshFatalError,
-  m as logoutService,
+  m as isRefreshFatalError,
+  y as logoutService,
   T as omemo,
-  g as parseQuickReplies,
-  y as refreshAuthTokens,
-  I as refreshAuthTokensQuietly,
-  R as resendMessage,
+  f as parseQuickReplies,
+  I as refreshAuthTokens,
+  R as refreshAuthTokensQuietly,
+  g as resendMessage,
   c as useInAppNotifications,
-  k as useIsUserOnline,
-  C as usePushNotifications,
-  A as useQRCodeChat,
-  E as useRoomMute,
+  C as useIsUserOnline,
+  A as usePushNotifications,
+  E as useQRCodeChat,
+  k as useRoomMute,
   Q as useRoomPresence,
-  F as useTypography,
-  M as useUnread
+  v as useTypography,
+  F as useUnread
 };

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

@@ -0,0 +1,56 @@
+/**
+ * GET /v2/apps/{appId}/messages/search: full-text / substring search over
+ * the chat archive. For a user token the server restricts it to chats the
+ * caller can see, so no client-side filtering is needed for privacy.
+ */
+export interface MessageSearchHit {
+    /** The archive row's own id: the only identifier every hit is guaranteed to have. */
+    id: string;
+    /** Room name, the local part of the room JID. */
+    chatId: string;
+    chatType: string;
+    /** Full room JID. */
+    room: string;
+    /** Sender's full JID, WITH the xmpp host: `appId_userId@xmpp.host`. */
+    from: string;
+    fromUserId: string;
+    body: string;
+    messageId: string;
+    stanzaId: string;
+    createdAt: string;
+}
+export interface MessageSearchPage {
+    items: MessageSearchHit[];
+    /** Total matches on the server, not the size of this page. */
+    total: number;
+    offset: number;
+    limit: number;
+    /**
+     * Where the next page starts. Counted in SERVER rows, not in `items`:
+     * deleted messages are dropped from `items`, and paging by the filtered
+     * count would re-request rows already seen.
+     */
+    nextOffset: number;
+}
+export interface SearchMessagesParams {
+    q: string;
+    /** Room name (local part of the JID). Omit to search every visible chat. */
+    chatId?: string;
+    /** Only messages from this user (a room member's `_id`). */
+    fromUserId?: string;
+    /** ISO 8601 bounds; the server rejects anything else. */
+    since?: string;
+    until?: string;
+    limit?: number;
+    offset?: number;
+    signal?: AbortSignal;
+}
+export declare const MESSAGE_SEARCH_PAGE_SIZE = 20;
+export declare function searchMessages({ q, chatId, fromUserId, since, until, limit, offset, signal, }: SearchMessagesParams): Promise<MessageSearchPage>;
+/**
+ * A key that is unique per hit. stanzaId and messageId are NOT: on QA whole
+ * pages of older hits come back with both empty, which made every React key
+ * `chatId:` (rows were left behind when the list changed) and made a
+ * duplicate check by those ids throw real hits away.
+ */
+export declare const hitKey: (hit: MessageSearchHit) => string;

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

@@ -0,0 +1,23 @@
+/** One entry of GET /v1/chats/public: a chat anyone in the app may join. */
+export interface PublicChat {
+    /** Room name: the local part of its JID. */
+    name: string;
+    title: string;
+    description: string;
+    picture: string;
+    e2ee: boolean;
+}
+export interface PublicChatsPage {
+    items: PublicChat[];
+    total: number;
+    offset: number;
+    limit: number;
+    /** Server rows consumed so far, not counting hidden ones. */
+    nextOffset: number;
+}
+export declare const PUBLIC_CHATS_PAGE_SIZE = 50;
+export declare function getPublicChats({ offset, limit, signal, }?: {
+    offset?: number;
+    limit?: number;
+    signal?: AbortSignal;
+}): Promise<PublicChatsPage>;

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/api-requests/xmppToken.api.d.ts

@@ -0,0 +1 @@
+export declare function fetchFreshXmppPassword(): Promise<string | null>;

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

@@ -29,6 +29,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>;
+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, 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/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;
@@ -10,6 +22,8 @@ export declare class XmppClient implements XmppClientInterface {
     client: Client;
     devServer: string | undefined;
     host: string;
+    private configuredHost;
+    private configuredConference;
     service: string;
     conference: string;
     username: string;
@@ -22,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;
@@ -47,8 +67,11 @@ export declare class XmppClient implements XmppClientInterface {
     private criticalSendUntil;
     private activeRoomBoostUntil;
     private sendStartedAtById;
+    private sessionOnlineAt;
+    private lastSentAtById;
     private pendingSendIdsByRoom;
     private maxInFlightHistory;
+    private joinHistoryStanzas;
     private softPauseAfterSendMs;
     private activeRoomBoostTtlMs;
     private activeSendBoostMs;
@@ -181,13 +204,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;
@@ -208,6 +239,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;
@@ -245,7 +286,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;

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

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

package/dist/roomStore/chatSettingsSlice.d.ts

@@ -38,7 +38,7 @@ export declare const setUser: import('@reduxjs/toolkit').ActionCreatorWithOption
     refreshToken: string;
     fileToken?: string;
     xmppPassword?: string;
-}, "chatSettingStore/refreshTokens">, logout: import('@reduxjs/toolkit').ActionCreatorWithoutPayload<"chatSettingStore/logout">, setActiveModal: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<string, "chatSettingStore/setActiveModal">, setDeleteModal: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<DeleteModal, "chatSettingStore/setDeleteModal">, setSelectedUser: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<IUser, "chatSettingStore/setSelectedUser">, updateUser: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<{
+}, "chatSettingStore/refreshTokens">, setXmppPassword: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<string, "chatSettingStore/setXmppPassword">, logout: import('@reduxjs/toolkit').ActionCreatorWithoutPayload<"chatSettingStore/logout">, setActiveModal: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<string, "chatSettingStore/setActiveModal">, setDeleteModal: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<DeleteModal, "chatSettingStore/setDeleteModal">, setSelectedUser: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<IUser, "chatSettingStore/setSelectedUser">, updateUser: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<{
     updates: Partial<User>;
 }, "chatSettingStore/updateUser">, setActiveFile: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<ModalFile, "chatSettingStore/setActiveFile">, setLangSource: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<Iso639_1Codes, "chatSettingStore/setLangSource">, setTranslateSendEnabled: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<boolean, "chatSettingStore/setTranslateSendEnabled">, setTranslateMode: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<"auto" | "manual", "chatSettingStore/setTranslateMode">;
 declare const _default: import('redux').Reducer<ChatState>;

package/dist/roomStore/index.d.ts

@@ -32,6 +32,18 @@ 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>;
 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

@@ -16,6 +16,55 @@ import { default as XmppClient } from '../networking/xmppClient';
  */
 export declare const MAX_DRAFT_LENGTH = 2000;
 export declare const MAX_PERSISTED_DRAFTS = 30;
+/** A message found in the archive that the chat cannot show in place. */
+export interface ArchivedMessage {
+    roomJID: string;
+    sender: string;
+    body: string;
+    /** ISO timestamp from the archive. */
+    createdAt: string;
+}
+/** A request to scroll a room's transcript to one message. */
+export interface PendingJump {
+    roomJID: string;
+    /** Any id the message may be known by: message id, stanza id, xmpp id. */
+    ids: string[];
+    /**
+     * For a message that has no usable id (search archive rows often carry
+     * none): its timestamp and text, matched against the loaded transcript.
+     */
+    createdAt?: string;
+    body?: string;
+    /**
+     * What to show if the message cannot be reached in the transcript: the hit
+     * itself, so a tap on a search result always ends with the message on
+     * screen rather than an error.
+     */
+    preview?: ArchivedMessage;
+    /** 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;
@@ -34,6 +83,10 @@ interface RoomMessagesState {
     loadingText?: string;
     roomsLoadedOnce: boolean;
     roomsLoadError: boolean;
+    pendingJump: PendingJump | null;
+    archivedMessage: ArchivedMessage | null;
+    jumpWindow: JumpWindow | null;
+    joiningRoomJID: string | null;
     drafts: Record<string, string>;
 }
 interface PreloadRoomUpdate {
@@ -102,7 +155,23 @@ export declare const addRoom: import('@reduxjs/toolkit').ActionCreatorWithOption
     chatJID?: string;
 }, "roomMessages/setRoomNoMessages">, setRoomsLoadResolved: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<{
     success: boolean;
-}, "roomMessages/setRoomsLoadResolved">, setCurrentRoom: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<{
+}, "roomMessages/setRoomsLoadResolved">, requestJumpToMessage: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<{
+    roomJID: string;
+    ids: string[];
+    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">, 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;

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/classNames.d.ts

@@ -29,6 +29,8 @@
 export declare const CHAT_ROOT_CLASS = "ethora-chat-root";
 /** Transient highlight flashed on a message when a notification is opened. */
 export declare const MESSAGE_HIGHLIGHT_CLASS = "ethora-message-highlight";
+/** How long the highlight stays on a message; keep equal to the CSS animation. */
+export declare const HIGHLIGHT_MS = 1000;
 /** Fixed-position container holding the in-app notification toasts. */
 export declare const NOTIFICATION_CONTAINER_CLASS = "ethora-message-notification-container";
 /** Forces the colour-emoji font on nodes that render a bare emoji glyph. */

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

@@ -174,6 +174,13 @@ export interface IConfig {
          * thumbnails, worth overriding if your users open large documents.
          */
         workerSrc?: string;
+        /**
+         * URL of a pdf.js ES module build to load at runtime instead of the copy
+         * bundled with the component. Pair it with `workerSrc`. For hosts that
+         * ship the component as one self-contained script and do not want 1.7 MB
+         * of pdf.js in it.
+         */
+        libUrl?: string;
         /** Documents above this are not auto-rendered. Default 25. */
         maxFileSizeMb?: number;
     };
@@ -494,6 +501,25 @@ export interface IConfig {
      * a presence state, not a count, so it is unaffected.
      */
     disableUserCount?: boolean;
+    /**
+     * Opt in to message search: the "Search messages" button in the chat header
+     * and profile panel, the Ctrl/Cmd+F shortcut inside the chat, and message
+     * matches under the chat-list search box. Off by default. Needs `appId`
+     * (the archive it queries is scoped by app) and a backend that serves
+     * `GET /v2/apps/{appId}/messages/search`.
+     */
+    enableMessageSearch?: boolean;
+    /**
+     * @deprecated Search is off unless `enableMessageSearch` is set. Kept so
+     * hosts that already pass `disableMessageSearch: true` stay off; it wins
+     * over `enableMessageSearch`.
+     */
+    disableMessageSearch?: boolean;
+    /**
+     * Hide the "Discover chats" entry of the room list menu, the directory of
+     * the app's public chats (GET /v1/chats/public).
+     */
+    disablePublicChatsDirectory?: boolean;
     disableSentLogic?: boolean;
     initBeforeLoad?: boolean;
     initBeforeLoadAuth?: {
@@ -603,6 +629,44 @@ export interface IConfig {
         hideSearch?: boolean;
     };
     useStoreConsoleEnabled?: boolean;
+    /**
+     * Route for looking up one unknown sender. `'auto'` (default) tries
+     * `GET /v1/apps/users/<xmppUsername>` and, when the backend does not accept
+     * the user token there (400/401, or a missing route), remembers that for 10
+     * minutes and uses `GET /v2/chats/users?xmppUsername=` instead, probing v1
+     * again after that. `'v1'` / `'v2'` pin one route with no fallback.
+     */
+    userLookupRoute?: 'auto' | 'v1' | 'v2';
+    /**
+     * Who may push `ethora-event` headlines (`urn:ethora:events:1`,
+     * user-profile-updated / chat-meta-updated). Default (unset or empty): any
+     * bare JID without a resource on the account's own XMPP domain, which is
+     * how the server sends them (from its admin account); room occupants,
+     * other users and other domains are never trusted. Set it to pin the exact
+     * sender(s), as full bare JIDs (`admin@xmpp.example.com`) or local parts
+     * (`admin`).
+     */
+    trustedEventSenders?: string[];
+    /**
+     * Background history preload after connect. Default `{ mode: 'staged',
+     * topRooms: 8, concurrency: 3 }`.
+     * - `'staged'`: the `topRooms` most recently active rooms are preloaded
+     *   (a one-message preview pass for rooms the API gave no `lastMessage`
+     *   for, then a full page), `concurrency` at a time; every other room
+     *   loads when the user opens it.
+     * - `'all'`: preload every room (the pre-staged behaviour; for accounts
+     *   with few rooms).
+     * - `'off'`: no background preload, rooms load when opened.
+     * A room the user opens jumps the queue; a reconnect only re-queues rooms
+     * that are not already preloaded.
+     * Falls back to the older `historyQoS.preloadTopKRooms` /
+     * `stagedPreloadConcurrency` when the matching field is not set.
+     */
+    historyPreload?: {
+        mode?: 'staged' | 'all' | 'off';
+        topRooms?: number;
+        concurrency?: number;
+    };
     historyQoS?: {
         maxInFlightHistory?: number;
         softPauseAfterSendMs?: number;
@@ -618,6 +682,20 @@ export interface IConfig {
         stagedPreloadFirstPassSize?: number;
         stagedPreloadSecondPassSize?: number;
         stagedPreloadConcurrency?: number;
+        /**
+         * Messages the MUC service replays on every room join, sent as
+         * `<history maxstanzas="N"/>`. Default 0: history comes from MAM only, so
+         * joining many rooms no longer pulls up to the server default (20) per
+         * room. Raise it only if a host relies on the join replay (a room without
+         * MAM archiving).
+         */
+        joinHistoryStanzas?: number;
+        /**
+         * Rooms joined in parallel by the background join sweep that runs after
+         * the room list is shown (active room first, then most recent activity).
+         * Default 5.
+         */
+        joinConcurrency?: number;
     };
     inAppNotifications?: {
         enabled?: boolean;