@ethora/chat-component 26.7.5 → 26.7.7

package/dist/components/styled/SendInput.d.ts

@@ -1,8 +1,12 @@
 import { default as React } from 'react';
-import { IConfig } from '../../types/types';
+import { IConfig, IMentionSpan } from '../../types/types';
 export interface SendInputProps {
-    sendMessage: (message: string) => void | Promise<void>;
-    sendMedia: (data: any, type: string) => void | Promise<void>;
+    sendMessage: (message: string, mentions?: IMentionSpan[]) => void | Promise<void>;
+    /**
+     * Receives a `File[]` for picked attachments (one message, N files) and a
+     * `Blob` for voice notes. Single files still arrive as a one-element array.
+     */
+    sendMedia: (data: File[] | File | Blob, type: string) => void | Promise<void>;
     isLoading: boolean;
     editMessage?: string;
     config?: IConfig;
@@ -14,9 +18,19 @@ export interface SendInputProps {
     inputHeight?: number;
     showPreview?: boolean;
     previewParser?: (text: string) => (string | JSX.Element)[];
-    onSendMessage?: (message: string) => void | Promise<void>;
-    onSendMedia?: (data: any, type: string) => void | Promise<void>;
+    onSendMessage?: (message: string, mentions?: IMentionSpan[]) => void | Promise<void>;
+    onSendMedia?: (data: File[] | File | Blob, type: string) => void | Promise<void>;
     placeholderText?: string;
+    /** Disables the @-mention autocomplete (e.g. for a composer variant that
+     * doesn't want it). Defaults to enabled. */
+    disableMentions?: boolean;
+    /**
+     * Disables per-room draft persistence. Set it on any SECOND composer
+     * that is mounted for the same room as the main one - the thread
+     * composer, for instance - since drafts are keyed by room JID and two
+     * live composers would otherwise overwrite each other's text.
+     */
+    disableDrafts?: boolean;
 }
 declare const SendInput: React.FC<SendInputProps>;
 export default SendInput;

package/dist/components/styled/StyledComponents.d.ts

@@ -45,7 +45,7 @@ export declare const StyledLoaderWrapper: import('styled-components/dist/types')
 export declare const OrDelimiter: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>> & string;
 export declare const AlsoContainer: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>> & string;
 export declare const AlsoCheckbox: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components/dist/types').Substitute<import('react').DetailedHTMLProps<import('react').InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, {
-    accentColor: string;
+    $accentColor: string;
 }>> & string;
 export declare const Wrapper: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components/dist/types').Substitute<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {
     bgColor: string;

package/dist/components/styled/StyledInputComponents/MediaComponents.d.ts

@@ -13,3 +13,21 @@ export declare const FileInformation: import('styled-components/dist/types').ISt
 export declare const FileName: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, never>> & string;
 export declare const FileSizeContainer: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>> & string;
 export declare const FileSize: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, never>> & string;
+/** Wraps every attachment of one message. Single-file messages keep the
+ *  old, un-gapped look because there is nothing to separate them from. */
+export declare const AttachmentStack: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>> & string;
+export declare const AttachmentGrid: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components/dist/types').Substitute<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {
+    $columns: number;
+}>> & string;
+export declare const AttachmentTile: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<import('react').DetailedHTMLProps<import('react').ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, never>> & string;
+export declare const PdfContainer: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components/dist/types').Substitute<import('react').DetailedHTMLProps<import('react').ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, {
+    $compact: boolean;
+}>> & string;
+export declare const PdfThumbnailFrame: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components/dist/types').Substitute<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {
+    $compact: boolean;
+}>> & string;
+/** Sits on the thumbnail while pdf.js parses so the row does not pop in. */
+export declare const PdfThumbnailSkeleton: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>> & string;
+export declare const PdfInformation: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>> & string;
+export declare const PdfMetaRow: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>> & string;
+export declare const PdfBadge: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, never>> & string;

package/dist/components/styled/StyledInputComponents/StyledInputComponents.d.ts

@@ -1,5 +1,21 @@
 export declare const InputContainer: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>> & string;
 export declare const MessageInputContainer: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>> & string;
+/**
+ * Anchors the composer's emoji picker above the input row, inside
+ * InputContainer's positioning context (the same one MentionDropdown uses).
+ * Sits one layer above that dropdown so the two can never fight for the
+ * same pixels if both were ever open at once.
+ */
+export declare const EmojiPickerPopover: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>> & string;
+/**
+ * Drop-target state for drag-and-drop attachments. Covers the whole drop
+ * zone (the message area when the host marks one, else the composer) and is
+ * pointer-events: none so it can never swallow the drop it is announcing.
+ * Motion comes from the shared primitives, which already opt out under
+ * prefers-reduced-motion.
+ */
+export declare const DropOverlay: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>> & string;
+export declare const DropTarget: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>> & string;
 export declare const MessageInput: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components/dist/types').Substitute<import('react').DetailedHTMLProps<import('react').InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, {
     $color?: string;
     $colorBg?: string;
@@ -12,6 +28,11 @@ export declare const FilePreviewContainer: import('styled-components/dist/types'
 export declare const FilePreview: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>> & string;
 export declare const ImagePreview: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<import('react').DetailedHTMLProps<import('react').ImgHTMLAttributes<HTMLImageElement>, HTMLImageElement>, never>> & string;
 export declare const VideoPreview: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<import('react').DetailedHTMLProps<import('react').VideoHTMLAttributes<HTMLVideoElement>, HTMLVideoElement>, never>> & string;
+/** First page of a picked PDF, before it is sent. Fills the whole tile. */
+export declare const DocumentPreview: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<import('react').DetailedHTMLProps<import('react').ImgHTMLAttributes<HTMLImageElement>, HTMLImageElement>, never>> & string;
+export declare const FilePreviewName: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, never>> & string;
+/** Why a pick was rejected (too many files, file too large). */
+export declare const AttachmentNotice: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components').FastOmit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>> & string;
 export declare const StyledInput: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components/dist/types').Substitute<import('react').DetailedHTMLProps<import('react').InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, {
     $colorBg?: string;
 }>> & string;

package/dist/components/styled/TreadLabel.d.ts

@@ -7,8 +7,8 @@ interface DateLabelProps {
     };
 }
 export declare const StyledDateLabel: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components/dist/types').Substitute<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {
-    primary?: string;
-    secondary?: string;
+    $primary?: string;
+    $secondary?: string;
 }>> & string;
 declare const TreadLabel: React.FC<DateLabelProps>;
 export default TreadLabel;

package/dist/components/styled/UnsupportedType.d.ts

@@ -2,7 +2,7 @@ import { default as React } from 'react';
 interface FileDownloadProps {
     fileName: string;
     fileURL: string;
-    mimetype: string;
+    mimetype?: string;
     size?: string;
     locationPreview?: string;
 }

package/dist/context/ModalTransitionContext.d.ts

@@ -0,0 +1,2 @@
+export declare const ModalExitingProvider: import('react').Provider<boolean>;
+export declare const useIsModalExiting: () => boolean;

package/dist/examples/quiz/QuizDemo.d.ts

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

package/dist/examples/quiz/quizScript.d.ts

@@ -0,0 +1,38 @@
+/**
+ * The shape of a scripted question flow, and a sample script.
+ *
+ * This is EXAMPLE code, not part of the SDK surface: the engine only knows
+ * about a message carrying `quickReplies` and about sending the tapped value
+ * back into the room. Everything below - the notion of a "step", the order
+ * they run in, where the answers pile up - belongs to whoever drives the
+ * flow, whether that is a bot on the server or a host page like this one.
+ *
+ * The step types mirror the node palette of the flow builders these widgets
+ * are usually compared against (Say / Single Input / Options / Yes-No /
+ * Rating), minus the branching nodes.
+ */
+export type QuizStepType = 'say' | 'input' | 'choice' | 'yesno' | 'rating';
+export interface QuizOption {
+    name: string;
+    value: string;
+}
+export interface QuizStep {
+    /** Echoed back as `questionId` when one of this step's buttons is tapped. */
+    id: string;
+    type: QuizStepType;
+    /** What the bot says. */
+    text: string;
+    /** Short name for the closing summary. Falls back to `text`. */
+    label?: string;
+    /** Only for `choice`; `yesno` and `rating` synthesise their own. */
+    options?: QuizOption[];
+}
+/** Buttons a step offers. `say` and `input` steps offer none. */
+export declare function optionsForStep(step: QuizStep): QuizOption[];
+/**
+ * A six-question intake, written as an eye clinic's because that is the
+ * kind of site these flows land on. Deliberately mixes button steps with
+ * typed ones: a name and a contact detail cannot be picked from a list, and
+ * the two answer paths are the thing worth demonstrating.
+ */
+export declare const DEFAULT_QUIZ_SCRIPT: QuizStep[];

package/dist/examples/quiz/useDemoSession.d.ts

@@ -0,0 +1,42 @@
+/**
+ * A throwaway visitor + room, so the demo runs with no credentials.
+ *
+ * `POST /v2/widget/sessions` is the same endpoint the embeddable assistant
+ * uses to put an anonymous website visitor into a real MUC room: the server
+ * mints a visitor JID with a password and a room to talk in. Borrowing it
+ * here keeps this page open-and-run instead of "first go find a login" -
+ * and it is the only part of the demo that is demo-specific. A host
+ * embedding the chat normally already has a signed-in user.
+ */
+export interface DemoSession {
+    appId: string;
+    baseUrl: string;
+    roomJID: string;
+    user: {
+        _id: string;
+        appId: string;
+        username: string;
+        name: string;
+        walletAddress: string;
+        firstName: string;
+        lastName: string;
+        xmppUsername: string;
+        xmppPassword: string;
+        token: string;
+        refreshToken: string;
+        defaultWallet: {
+            walletAddress: string;
+        };
+    };
+    xmppSettings: {
+        devServer: string;
+        host: string;
+        conference: string;
+    };
+}
+export declare function useDemoSession(): {
+    session: DemoSession;
+    connect: () => Promise<void>;
+    loading: boolean;
+    error: string;
+};

package/dist/examples/quiz/useQuizFlow.d.ts

@@ -0,0 +1,47 @@
+import { QuizStep } from './quizScript';
+/**
+ * Drives a scripted question flow on top of the engine's two primitives:
+ *
+ *   1. a bot message carrying `quickReplies` renders buttons under the
+ *      bubble;
+ *   2. tapping one sends that button's value into the room as an ordinary
+ *      message, and calls `config.eventHandlers.onQuickReply`.
+ *
+ * The flow itself lives here, in host code. In production the same script
+ * would run on the bot: it would send the questions over XMPP instead of
+ * this hook injecting them into the store, and nothing in the engine or in
+ * the bubble would change.
+ *
+ * Steps that ask for free text have no buttons, so their answer arrives as
+ * an ordinary typed message. We watch the room for the user's own new
+ * messages to catch those - see the subscription below.
+ */
+export interface QuizAnswer {
+    stepId: string;
+    question: string;
+    answer: string;
+    /** How the answer was given, which is the interesting half of the demo. */
+    via: 'button' | 'typed';
+}
+export interface QuizBotIdentity {
+    id: string;
+    name: string;
+    avatar?: string;
+}
+export declare function useQuizFlow(script: QuizStep[], bot: QuizBotIdentity): {
+    onQuickReply: (event: {
+        messageId: string;
+        questionId: string;
+        reply: {
+            value: string;
+        };
+    }) => void;
+    start: () => void;
+    answers: QuizAnswer[];
+    isRunning: boolean;
+    currentStep: QuizStep;
+    stepIndex: number;
+    roomJID: any;
+    /** True while the composer is standing in for this step's buttons. */
+    awaitingTypedAnswer: boolean;
+};

package/dist/firebase-config.d.ts

@@ -8,7 +8,5 @@ export declare const defaultConfig: {
     messagingSenderId: any;
     appId: any;
 };
-export declare const getFirebaseApp: (customConfig?: any) => FirebaseApp | null;
-export declare const getFirebaseMessaging: (customConfig?: any) => Messaging | null;
-export declare const app: FirebaseApp;
-export declare const messaging: Messaging;
+export declare const getFirebaseApp: (customConfig?: any) => Promise<FirebaseApp | null>;
+export declare const getFirebaseMessaging: (customConfig?: any) => Promise<Messaging | null>;

package/dist/handleCopyClick-BoZWTBLC.js

@@ -0,0 +1,108 @@
+import { v as e, x as t } from "./main-C2FKeV6y.js";
+const i = e.div`
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: var(--ethora-space-4, 16px);
+  padding: var(--ethora-space-3, 12px) 0 var(--ethora-space-2, 8px);
+  text-align: center;
+
+  /*
+   * The avatar (ProfileImagePlaceholder) is always this block's first and
+   * only non-text child - both callers (ChatProfileModal, UserProfileModal)
+   * render it first, before the name. A soft ring around it - the panel's
+   * own background colour, then the same elevation a card gets - lifts it
+   * off the page as the one deliberately-composed focal point instead of a
+   * flat circle sitting in a vertical stack. Targeting the position (not a
+   * class) means this works without touching ProfileImagePlaceholder itself,
+   * which is outside this pass's file list.
+   */
+  & > *:first-child {
+    box-shadow:
+      0 0 0 4px var(--ethora-color-bg, #fff),
+      var(--ethora-shadow-md, 0 4px 12px rgba(16, 24, 40, 0.1));
+    border-radius: var(--ethora-radius-full, 999px);
+  }
+`, s = e.div`
+  font-size: var(--ethora-font-size-xl, 22px);
+  font-weight: var(--ethora-font-weight-bold, 700);
+  line-height: var(--ethora-line-height-tight, 1.25);
+  color: var(--ethora-color-text, #141414);
+  overflow-wrap: anywhere;
+`, l = e.div`
+  margin-top: var(--ethora-space-1, 4px);
+  font-size: var(--ethora-font-size-sm, 14px);
+  font-weight: var(--ethora-font-weight-medium, 500);
+  color: var(--ethora-color-text-muted, #8c8c8c);
+`, n = e.div`
+  display: flex;
+  flex-direction: column;
+  gap: var(--ethora-space-2, 8px);
+  width: 100%;
+  margin-top: var(--ethora-space-1, 4px);
+`, c = e.p`
+  margin: 0;
+  font-size: var(--ethora-font-size-sm, 14px);
+  line-height: var(--ethora-line-height-normal, 1.5);
+  color: ${({ $empty: a }) => a ? "var(--ethora-color-text-muted, #8c8c8c)" : "var(--ethora-color-text, #141414)"};
+  font-style: ${({ $empty: a }) => a ? "italic" : "normal"};
+  text-align: start;
+  overflow-wrap: anywhere;
+`, h = e.span`
+  display: inline-flex;
+  /* The pill is usually a child of a column flex container, which blockifies
+     inline-flex and stretches it to the full column width unless it opts out.
+     A pill that spans the whole panel reads as a banner, not as a tag. */
+  align-self: flex-start;
+  align-items: center;
+  gap: var(--ethora-space-1, 4px);
+  padding: var(--ethora-space-1, 4px) var(--ethora-space-3, 12px);
+  border-radius: var(--ethora-radius-full, 999px);
+  background: var(--ethora-color-primary-soft, #e7edf9);
+  color: var(--ethora-color-primary, #0052cd);
+  font-size: var(--ethora-font-size-xs, 12px);
+  font-weight: var(--ethora-font-weight-semibold, 600);
+
+  & > svg {
+    width: 14px;
+    height: 14px;
+  }
+`, o = t`
+  padding: ${({ $compact: a }) => a ? "var(--ethora-space-4, 16px) var(--ethora-space-2, 8px)" : "var(--ethora-space-6, 24px) var(--ethora-space-4, 16px)"};
+`, p = e.div`
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  text-align: center;
+  gap: var(--ethora-space-1, 4px);
+  color: var(--ethora-color-text-secondary, #5a5f66);
+  ${o}
+
+  & > svg {
+    opacity: 0.7;
+    margin-bottom: var(--ethora-space-1, 4px);
+  }
+`, f = e.div`
+  font-size: var(--ethora-font-size-sm, 14px);
+  font-weight: var(--ethora-font-weight-medium, 500);
+  color: var(--ethora-color-text-secondary, #5a5f66);
+`;
+e.div`
+  font-size: var(--ethora-font-size-xs, 12px);
+  color: var(--ethora-color-text-muted, #8c8c8c);
+`;
+const d = (a) => {
+  navigator.clipboard.writeText(a);
+};
+export {
+  c as D,
+  i as P,
+  s as a,
+  n as b,
+  l as c,
+  h as d,
+  p as e,
+  f,
+  d as h
+};

package/dist/helpers/MarkdownBody.d.ts

@@ -0,0 +1,7 @@
+import { MentionClickHandler } from './parseMessageBody';
+interface MarkdownBodyProps {
+    text: string;
+    onMentionClick?: MentionClickHandler;
+}
+declare const MarkdownBody: ({ text, onMentionClick }: MarkdownBodyProps) => import("react/jsx-runtime").JSX.Element;
+export default MarkdownBody;

package/dist/helpers/attachments.d.ts

@@ -0,0 +1,33 @@
+import { IAttachment, IMessage } from '../types/types';
+/**
+ * Hard ceiling on how many attachments we will serialise into a stanza.
+ * The composer caps the picker far below this; this is the parser-side
+ * guard so a malformed or hostile stanza cannot make us render an
+ * unbounded grid.
+ */
+export declare const MAX_ATTACHMENTS_PER_MESSAGE = 10;
+/**
+ * Turns one raw wire/API object into an `IAttachment`, or null when there is
+ * nothing renderable in it. `location` is allowed to be empty: that is what
+ * an optimistic (still-uploading) attachment looks like.
+ */
+export declare const normalizeAttachment: (raw: unknown) => IAttachment | null;
+/** Accepts the parsed array, the raw JSON string, or junk. Never throws. */
+export declare const parseAttachments: (raw: unknown) => IAttachment[];
+/**
+ * The wire form: a JSON string on the `<data attachments="...">` attribute.
+ * Only the fields a receiver renders are sent - the stanza is already wide
+ * and every byte here is duplicated per attachment.
+ */
+export declare const serializeAttachments: (attachments: IAttachment[]) => string;
+/**
+ * The only supported way to read a media message's files.
+ *
+ * Order of truth: the multi-attach payload when present, otherwise the flat
+ * legacy fields synthesised into a single attachment. Every message that
+ * predates this feature - and every message from a client that does not
+ * speak it - takes the second path.
+ */
+export declare const getMessageAttachments: (message?: Pick<IMessage, "attachments" | "location" | "locationPreview" | "mimetype" | "originalName" | "fileName" | "size"> | null) => IAttachment[];
+/** Name to show for an attachment, with the URL tail as the last resort. */
+export declare const getAttachmentName: (attachment: IAttachment) => string;

package/dist/helpers/botMarkup.d.ts

@@ -0,0 +1,30 @@
+import { QuickReply } from './quickReplies';
+/**
+ * Buttons an AI agent writes straight into its reply text.
+ *
+ * Bots built on the SDK attach buttons as the `quickReplies` attribute of the
+ * stanza's <data> element. An LLM agent cannot do that: all it controls is the
+ * text of its answer. So its system prompt teaches it an in-band form of the
+ * same thing, part of the Ethora chat protocol:
+ *
+ *   <xml>
+ *   <bot-data type="buttons">[Accept],[Reject]</bot-data>
+ *   <body>Choose one please</body>
+ *   </xml>
+ *
+ * This module turns that text into the same QuickReply buttons the attribute
+ * produces, plus the text that should actually be shown. It is written for
+ * model output, so it is deliberately forgiving about the envelope (the
+ * <xml>/<body> wrappers are optional, code fences are unwrapped, an
+ * HTML-escaped copy is accepted) and deliberately strict about what it
+ * hides: only a `type="buttons"` block is consumed, and nothing is stripped
+ * from a message that does not contain one.
+ */
+export interface BotMarkup {
+    /** Text to display, with the machine-readable markup removed. */
+    text: string;
+    buttons: QuickReply[];
+}
+export declare const parseBotMarkup: (body: unknown) => BotMarkup;
+/** The displayable text of a body, for previews and copy. */
+export declare const stripBotMarkup: (body: unknown) => string;

package/dist/helpers/buildChatShareLink.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Builds the "open this chat" link that the QR modal encodes.
+ *
+ * Two rules matter here:
+ *
+ * 1. The link has to point back at a page that actually mounts <Chat>.
+ *    The old fallback invented a `/app/chat/` path from the current origin
+ *    (and, with no window, an even older `beta.ethora.com` build-time URL),
+ *    so scanning the QR on any deployment whose chat does not live at
+ *    `/app/chat/` landed on a blank page. The current page is the one the
+ *    user is looking at the chat in, so its own origin + pathname is the
+ *    only entry point we can honestly guarantee. A host that serves chat
+ *    somewhere else still overrides everything via `config.qrUrl`.
+ *
+ * 2. The parameter is written with URLSearchParams so an existing query
+ *    string on the page (locale switches, host params) survives instead of
+ *    being clobbered, and the id is encoded.
+ */
+export declare const CHAT_LINK_PARAM = "chatId";
+export declare const buildChatShareLink: (chatJid: string, qrUrl?: string, currentHref?: string) => string;

package/dist/helpers/cacheScope.d.ts

@@ -1,8 +1,22 @@
 import { IConfig } from '../types/types';
 export declare const buildCacheScope: (config?: IConfig) => string;
-export declare const clearScopedChatCache: () => void;
+interface ClearScopedChatCacheOptions {
+    /**
+     * Keep the chat id a QR code / shared link just parked.
+     *
+     * That id is not cached data from a previous session, it is the room the
+     * user is arriving at RIGHT NOW. Wiping it on a first-run reset (which is
+     * exactly when someone opens a link on a fresh browser) dropped the
+     * destination on the floor: the selection was cleared, and the first room
+     * that happened to arrive over XMPP was opened instead. A genuine tenant
+     * switch still drops it - a bare chat id means nothing in another tenant.
+     */
+    keepPendingChatId?: boolean;
+}
+export declare const clearScopedChatCache: (options?: ClearScopedChatCacheOptions) => void;
 export declare const ensureScopedChatCache: (config?: IConfig) => {
     changed: boolean;
     scope: string;
     previousScope: string | null;
 };
+export {};

package/dist/helpers/constants/MODAL_TYPES.d.ts

@@ -4,12 +4,18 @@ export declare const MODAL_TYPES: {
     CHAT_PROFILE: string;
     MANAGE_DATA: string;
     VISIBILITY: string;
-    PROFILE_SHARES: string;
-    DOCUMENT_SHARES: string;
-    BLOCKED_USERS: string;
-    REFERRALS: string;
     FILE_PREVIEW: string;
 };
-export declare const MODAL_COMPONENTS: Record<string, React.FC<{
-    handleCloseModal: () => void;
-}>>;
+/**
+ * Panels reached from inside Settings. Their back button (and Escape) steps
+ * back to the Settings list rather than closing the drawer outright.
+ */
+export declare const SETTINGS_SUB_MODAL_TYPES: string[];
+/**
+ * Panels that open as the chat's right-hand COLUMN rather than as a centred
+ * card on top of it: the profile/settings family. These take part in the
+ * layout (see `components/Modals/SidePanel/SidePanel.tsx`), so opening one
+ * narrows the conversation instead of covering it. Everything else (file
+ * preview and the confirm dialogs) keeps the centred-dialog presentation.
+ */
+export declare const SIDE_PANEL_MODAL_TYPES: string[];

package/dist/helpers/createRoomFromApi.d.ts

@@ -1,2 +1,2 @@
 import { ApiRoom, IRoom } from '../types/types';
-export declare const createRoomFromApi: (room: ApiRoom, service?: string, usersArrayLength?: number) => IRoom;
+export declare const createRoomFromApi: (room: ApiRoom, service?: string, usersArrayLength?: number) => IRoom | null;

package/dist/helpers/ethoraLogger.d.ts

@@ -4,4 +4,12 @@ export declare const ethoraLogger: {
     debug: (...args: unknown[]) => void;
     error: (...args: unknown[]) => void;
     always: (...args: unknown[]) => void;
+    /**
+     * For failures that must never be silent, whatever the verbose-console
+     * setting is: today, an uncaught render error caught by the SDK's error
+     * boundary. `error` above stays gated so routine debug noise remains
+     * opt-in; this one does not, because a swallowed crash leaves the host
+     * with a replaced chat pane and no explanation anywhere.
+     */
+    criticalError: (...args: unknown[]) => void;
 };

package/dist/helpers/fileKind.d.ts

@@ -0,0 +1,17 @@
+/**
+ * One place that answers "what do we render for this file?".
+ *
+ * Before this, every surface (bubble, room list, notification toast, the
+ * composer) re-derived the answer from `mimetype` alone with a slightly
+ * different set of `startsWith` checks, and none of them looked at the file
+ * name. That is why a PDF uploaded as `application/octet-stream` (which our
+ * storage does for anything it cannot sniff) ended up in the audio branch.
+ */
+export type FileKind = 'image' | 'video' | 'audio' | 'pdf' | 'file';
+/** Lowercase extension without the dot; '' when the name carries none. */
+export declare const getFileExtension: (name?: string) => string;
+export declare const isPdfFile: (mimetype?: string, name?: string) => boolean;
+export declare const getFileKind: (mimetype?: string, name?: string) => FileKind;
+export declare const formatFileSize: (sizeInBytes?: string | number) => string;
+/** Middle-truncates the base name, always keeping the extension visible. */
+export declare const formatFileName: (name: string, maxLength: number) => string;

package/dist/helpers/formatNumberWithCommas.d.ts

@@ -1 +1 @@
-export declare function formatNumberWithCommas(num: number | string): string;
+export declare function formatNumberWithCommas(num: number | string, locale?: string): string;

package/dist/helpers/hiddenRooms.d.ts

@@ -2,7 +2,7 @@ import { IConfig, IRoom } from '../types/types';
 type RoomLike = Pick<IRoom, 'jid' | 'title' | 'name'>;
 /**
  * True when the room is listed in `config.hiddenRooms` (by JID or by
- * case-insensitive title). Hidden rooms stay joined — they are only
+ * case-insensitive title). Hidden rooms stay joined - they are only
  * suppressed from the room list and the unread counters.
  */
 export declare const isRoomHidden: (room: RoomLike | null | undefined, config?: Pick<IConfig, "hiddenRooms"> | null) => boolean;

package/dist/helpers/historyPreloadScheduler.d.ts

@@ -9,6 +9,7 @@ interface HistoryPreloadSchedulerOptions {
     selectedRoomJid?: string | null;
     defaultRoomJids?: string[];
     forceReload?: boolean;
+    completionState?: 'done' | 'partial';
 }
 export declare const runHistoryPreloadScheduler: (options: HistoryPreloadSchedulerOptions) => Promise<void>;
 export default runHistoryPreloadScheduler;

package/dist/helpers/lazyEmoji.d.ts

@@ -0,0 +1,3 @@
+export declare const loadEmojiData: () => Promise<any>;
+export declare const getEmojiNativeById: (id: string) => string;
+export declare const useEmojiData: () => boolean;

package/dist/helpers/localStorageUser.d.ts

@@ -1 +1 @@
-export declare const getLocalStorageUser: () => import('../types/types').User;
+export declare const getLocalStorageUser: () => import('../main').User;

package/dist/helpers/markdownSanitizeSchema.d.ts

@@ -0,0 +1,3 @@
+import { Options as SanitizeSchema } from 'rehype-sanitize';
+export declare const markdownSanitizeSchema: SanitizeSchema;
+export default markdownSanitizeSchema;