@ethora/chat-component 26.9.6 → 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}[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 { 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,
@@ -12,18 +12,18 @@ export {
   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,
   v as useTypography,
   F as useUnread

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/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;
@@ -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;
@@ -49,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;
@@ -183,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;
@@ -210,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;
@@ -247,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/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

@@ -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>;
 }
@@ -139,7 +161,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;

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/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;
     };
@@ -495,9 +502,17 @@ export interface IConfig {
      */
     disableUserCount?: boolean;
     /**
-     * Hide the "Search messages" button in the chat header (and so the search
-     * panel). Search is also hidden when `appId` is not set, since the archive
-     * it queries is scoped by app.
+     * 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;
     /**
@@ -614,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;
@@ -629,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;

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

@@ -63,6 +63,16 @@ export interface IRoom {
     lastViewedTimestamp?: number;
     unreadBaselineTimestamp?: number;
     unreadMessages?: number;
+    /**
+     * Unread count the server reported for this room in `GET /v1/chats/my`
+     * (`unreadCount`) and when it was read. Only present on backends that send
+     * it. The unread middleware uses it as a floor while the local message
+     * list is too short to count from (history not loaded yet): it lets the
+     * room list show a badge without a MAM round-trip per room. Ignored once
+     * the user has read past the API's last message, and cleared on open.
+     */
+    apiUnreadCount?: number;
+    apiUnreadSeededAt?: number;
     noMessages?: boolean;
     role?: string;
     messageStats?: {
@@ -109,6 +119,8 @@ export interface ApiRoom {
     description?: string;
     picture?: string;
     members?: RoomMember[];
+    /** True total; `members` is capped at 30 for big public rooms. */
+    usersCnt?: number;
     createdBy?: string;
     appId?: any;
     _id?: string;
@@ -118,6 +130,8 @@ export interface ApiRoom {
     __v?: string;
     /** See IRoom.muted - only present when the backend supports per-chat mute. */
     muted?: boolean;
+    /** See IRoom.apiUnreadCount - only present when the backend sends it. */
+    unreadCount?: number;
     /** See ApiRoomLastMessage - only present when the backend supports it. */
     lastMessage?: ApiRoomLastMessage;
 }

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

@@ -1,6 +1,6 @@
 import { Client } from '@xmpp/client';
 import { Iso639_1Codes } from './language.model';
-import { default as XmppClient } from '../../networking/xmppClient';
+import { default as XmppClient, HistoryWindowPage } from '../../networking/xmppClient';
 import { IMessage } from './message.model';
 export interface XmppState {
     client: XmppClient | null;
@@ -27,6 +27,20 @@ export interface xmppSettingsInterface {
         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;
     };
 }
 export interface MediaUploadData {
@@ -65,6 +79,12 @@ export interface XmppClientInterface {
         skipIfPreloaded?: boolean;
         source?: 'active' | 'send_ack' | 'background' | 'default';
     }): Promise<IMessage[] | undefined>;
+    getHistoryWindow(chatJID: string, max: number, cursor: {
+        before?: number;
+        after?: number;
+        start?: string;
+        end?: string;
+    }): Promise<HistoryWindowPage>;
     promoteRoomHistory(roomJID: string): void;
     setActiveRoomJid(roomJID: string | null): void;
     isActiveRoomGateOpen(): boolean;

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const ETHORA_CHAT_COMPONENT_VERSION = "26.9.6";
+export declare const ETHORA_CHAT_COMPONENT_VERSION = "26.9.8";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ethora/chat-component",
-  "version": "26.9.6",
+  "version": "26.9.8",
   "type": "module",
   "main": "dist/main.js",
   "types": "dist/main.d.ts",
@@ -97,6 +97,7 @@
     "eslint-plugin-prettier": "^5.5.0",
     "eslint-plugin-react-hooks": "^5.2.0",
     "eslint-plugin-react-refresh": "^0.4.20",
+    "globals": "^11.12.0",
     "jsdom": "^24.1.0",
     "prettier": "3.6.0",
     "react": "^18.3.1",

package/dist/components/MainComponents/computeAnchoredScrollTop.d.ts

@@ -1,9 +0,0 @@
-/**
- * Where to put scrollTop after content was added ABOVE the reader.
- *
- * `liveTop` must be the scrollTop at the moment the content arrived, not the
- * one captured when the request started: the reader keeps scrolling while a
- * page is in flight, and restoring the old value throws them back down by
- * however far they travelled meanwhile.
- */
-export declare function computeAnchoredScrollTop(liveTop: number, heightBefore: number, heightAfter: number): number;

package/dist/components/Modals/NewChatModal/UpdNewChatModal.d.ts

@@ -1,3 +0,0 @@
-import { default as React } from 'react';
-declare const NewChatModal: React.FC;
-export default NewChatModal;

package/dist/components/SortDropDown/index.d.ts

@@ -1,8 +0,0 @@
-import { default as React } from 'react';
-interface DropdownProps {
-    sortFunction: (value: string) => void;
-    icon: string;
-    values: string[];
-}
-declare const DropdownMenu: React.FC<DropdownProps>;
-export default DropdownMenu;