@ethora/chat-component 26.8.1 → 26.9.0

package/dist/helpers/findMessagesForFile.d.ts

@@ -0,0 +1,25 @@
+import { IRoom } from '../types/types';
+export interface FileMessageMatch {
+    roomJID: string;
+    messageId: string;
+}
+export interface DeletableFileRef {
+    _id: string;
+    roomName?: string;
+    location?: string;
+}
+/**
+ * Finds every locally loaded message that carries the given file, so
+ * deleting a file from the Files panel can also tombstone its chat
+ * message(s) instead of leaving a broken-image bubble behind.
+ *
+ * `file.roomName` is checked first: sent-media messages stamp `attachmentId`
+ * on the message (see useSendMessage.tsx / sendMediaMessage.xmpp.ts) with
+ * the same id the backend gives the file, and the Files API's `roomName`
+ * field actually holds the room's JID (see FilesList.tsx / bug 3), so most
+ * of the time the right room is known outright. When that doesn't resolve
+ * anything - a different backend shape, or the id genuinely isn't on the
+ * message - every locally loaded room is searched by attachment location as
+ * a fallback, since a matching URL is still a correct match.
+ */
+export declare const findMessagesForFile: (rooms: Record<string, IRoom>, file: DeletableFileRef) => FileMessageMatch[];

package/dist/helpers/sealedAttachments.d.ts

@@ -0,0 +1,25 @@
+import { FileEnvelopeMeta } from '../e2ee/fileEnvelope';
+export interface OpenedAttachment {
+    bytes: Uint8Array;
+    meta: FileEnvelopeMeta;
+}
+/**
+ * Fetch and decrypt one sealed attachment.
+ *
+ * `url` must already carry the viewer's `?ft=` token where the file is
+ * membership-gated - this is a plain fetch of whatever it is given.
+ */
+export declare function openSealedAttachment(url: string, keyMaterial: string, fetchImpl?: typeof fetch): Promise<OpenedAttachment>;
+/** Hands a blob to the browser as a download. Injectable for tests. */
+export type SaveBlob = (blob: Blob, fileName: string) => void;
+/**
+ * Fetch, decrypt and save one sealed attachment under its real filename.
+ *
+ * Returns the recovered metadata so the caller can label the card with the
+ * real name once it is known - before the first download there is no way to
+ * know it, because it lives inside the seal.
+ */
+export declare function saveSealedAttachment(url: string, keyMaterial: string, deps?: {
+    fetchImpl?: typeof fetch;
+    save?: SaveBlob;
+}): Promise<FileEnvelopeMeta>;

package/dist/helpers/xmppIdShape.d.ts

@@ -0,0 +1,9 @@
+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
+ * id. Kept narrow on purpose: a handle a person actually picked is never
+ * this shape, so it is never mistaken for one.
+ */
+export declare const isOpaqueXmppUserId: (value: string | undefined | null) => boolean;

package/dist/helpers/xmppUsername.d.ts

@@ -1,3 +1,3 @@
-export declare const toLocalPart: (value?: string) => string;
+export { toLocalPart, isOpaqueXmppUserId } from './xmppIdShape';
 export declare const normalizeXmppUsername: (value: string | undefined | null) => string;
 export declare const isSameXmppUsername: (a: string | undefined | null, b: string | undefined | null) => boolean;

package/dist/hooks/useChatWrapperInit.d.ts

@@ -17,6 +17,10 @@ interface useChatWrapperInitResult {
 }
 export declare const resolveLegacyTranslatesLangSource: (translatesConfig?: IConfig["translates"]) => Iso639_1Codes | undefined;
 export declare const resolveExternalReaderLocaleLangSource: (readerLocale?: string) => Iso639_1Codes | undefined;
-export declare const isStatusConnectionLost: (status?: string | null) => boolean;
+export declare const isStatusConnectionLost: (status?: string | null, isRecoveringAuth?: boolean, hasEverBeenOnline?: boolean) => boolean;
+export declare const hasHostRefreshedSession: (user: {
+    xmppUsername?: string;
+    xmppPassword?: string;
+}) => boolean;
 declare const useChatWrapperInit: ({ roomJID, wasAutoSelected, config, }: useChatWrapperInitProps) => useChatWrapperInitResult;
 export default useChatWrapperInit;