@ethora/chat-component 26.9.6 → 26.9.8

package/dist/helpers/roomUserCount.d.ts

@@ -0,0 +1,19 @@
+import { IRoom } from '../types/types';
+type CountSource = Pick<IRoom, 'members' | 'usersCnt'> | {
+    members?: unknown;
+    usersCnt?: unknown;
+} | null | undefined;
+/**
+ * User count to DISPLAY for a room. /chats/my returns `usersCnt` (the true
+ * total) but at most 30 members for big public rooms, so the truncated
+ * members array must never win over usersCnt.
+ */
+export declare const getRoomUserCount: (room: CountSource) => number;
+/** True when the room is known to have more users than members loaded. */
+export declare const isRoomMembersTruncated: (room: CountSource) => boolean;
+/**
+ * Next usersCnt after a live join (+1) or leave (-1). Adjusts the CURRENT
+ * count instead of recomputing from the (possibly truncated) members array.
+ */
+export declare const adjustUsersCnt: (room: CountSource, delta: 1 | -1, nextMembersLength: number) => number;
+export {};

package/dist/helpers/userResolver.d.ts

@@ -0,0 +1,57 @@
+import { RoomMember } from '../types/types';
+export type RoomDirectoryState = 'idle' | 'loading' | 'done' | 'error';
+/** Re-render hook: called when a directory state or a negative cache entry changes. */
+export declare const subscribeUserResolver: (listener: () => void) => (() => void);
+/**
+ * True for an id the backend answered 404 for: the user really is gone.
+ * (An id merely not resolved yet is NOT "not found".)
+ */
+export declare const isUserNotFound: (rawId: string) => boolean;
+/**
+ * Where a sender's lookup stands, for the display chain:
+ * - resolved: in usersSet
+ * - pending: queued, in flight, or not requested yet (a bubble just mounted)
+ * - notfound / forbidden: the backend answered, nothing to show from it
+ * - failed: the last attempt errored (backoff), or the lookup is exhausted
+ * - unavailable: this id can never be looked up (plain handle) or there is
+ *   no session token, so nothing is coming
+ */
+export type UserLookupStatus = 'resolved' | 'pending' | 'notfound' | 'forbidden' | 'failed' | 'unavailable';
+export declare const getUserLookupStatus: (rawId: string) => UserLookupStatus;
+/**
+ * Ask for the profiles of these senders. Cheap to call from anywhere (a
+ * bubble mounting, a history batch parse): known, in-flight and recently
+ * failed ids are dropped, the rest are debounced into one pass.
+ */
+export declare function requestUsers(ids: string[]): void;
+/**
+ * Re-fetch one user's profile even though it is already in usersSet, because
+ * the server said it changed (ethora-event user-profile-updated). Bypasses
+ * the cache and forgets a negative-cache entry, but shares everything else
+ * with requestUsers: the same route chain (lookupUser), the same worker
+ * queue and concurrency cap, one request at a time per user. Calls for the
+ * same user within REFRESH_DEBOUNCE_MS coalesce into one fetch. The answer
+ * goes through insertUsers (display fields only), so existing bubbles are
+ * re-named. Never throws.
+ */
+export declare function refreshUser(rawId: string): void;
+/**
+ * Members loaded so far by ensureRoomDirectory for this room (a new array
+ * identity after every page, a stable empty array before any).
+ */
+export declare const getRoomDirectoryMembers: (roomJID: string) => RoomMember[];
+/** requestUsers for the senders of a batch of messages (history page, jump window). */
+export declare function requestSendersOf(messages: ReadonlyArray<{
+    user?: {
+        id?: string;
+    };
+} | null | undefined> | undefined): void;
+export declare const getRoomDirectoryState: (roomJID: string) => RoomDirectoryState;
+/**
+ * Loads every member of one room into usersSet, once. Pages are not
+ * guaranteed to be full, so it stops on an empty page or offset >= total,
+ * never on `items.length < limit`.
+ */
+export declare function ensureRoomDirectory(roomJID: string): Promise<void>;
+/** For tests and logout: drops every cache, timer and in-flight result. */
+export declare function resetUserResolver(): void;

package/dist/helpers/xmppIdShape.d.ts

@@ -2,7 +2,7 @@ export declare const toLocalPart: (value?: string) => string;
 /**
  * True when `value` (a full JID or already-bare local part) is a
  * machine-generated Ethora id rather than anything a human would recognize
- * as their own name - `<24 hex>_<24 hex>` (appId_userId) or a bare 24-hex
+ * as their own name - `<24 hex>_<24 hex>`, `<appId>_<uuid>` or a bare 24-hex
  * id. Kept narrow on purpose: a handle a person actually picked is never
  * this shape, so it is never mistaken for one.
  */

package/dist/hooks/useChatWrapperInit.d.ts

@@ -22,5 +22,11 @@ export declare const hasHostRefreshedSession: (user: {
     xmppUsername?: string;
     xmppPassword?: string;
 }) => boolean;
+export declare const startBackgroundJoinSweep: (client: {
+    sendAllPresencesAndMarkReady: () => Promise<unknown>;
+}) => void;
+export declare const loadRoomsThenJoinInBackground: <T>(client: {
+    sendAllPresencesAndMarkReady: () => Promise<unknown>;
+}, fetchRooms: () => Promise<T>, onListReady: () => void) => Promise<T>;
 declare const useChatWrapperInit: ({ roomJID, wasAutoSelected, config, }: useChatWrapperInitProps) => useChatWrapperInitResult;
 export default useChatWrapperInit;

package/dist/hooks/usePdfThumbnail.d.ts

@@ -9,6 +9,7 @@ interface UsePdfThumbnailParams {
     maxBytes?: number;
     sizeInBytes?: number;
     workerSrc?: string;
+    libUrl?: string;
 }
 interface UsePdfThumbnailResult {
     status: PdfThumbnailStatus;
@@ -18,5 +19,5 @@ interface UsePdfThumbnailResult {
     /** Re-runs a render that failed or was skipped for being too big. */
     retry: () => void;
 }
-export declare const usePdfThumbnail: ({ url, enabled, width, maxBytes, sizeInBytes, workerSrc, }: UsePdfThumbnailParams) => UsePdfThumbnailResult;
+export declare const usePdfThumbnail: ({ url, enabled, width, maxBytes, sizeInBytes, workerSrc, libUrl, }: UsePdfThumbnailParams) => UsePdfThumbnailResult;
 export {};

package/dist/hooks/useRoomDirectory.d.ts

@@ -0,0 +1,11 @@
+import { RoomDirectoryState } from '../helpers/userResolver';
+import { RoomMember } from '../types/types';
+/**
+ * Directory of a big room (usersCnt > the members the API returned).
+ * `enabled` starts the (once per room, deduplicated) load; the result grows
+ * page by page. Rooms that are not truncated never trigger a request.
+ */
+export declare const useRoomDirectory: (roomJid: string | undefined, enabled: boolean) => {
+    members: RoomMember[];
+    state: RoomDirectoryState;
+};