@eloquentai/chat-sdk 0.33.10-dev → 0.33.12-dev

package/README.md

@@ -121,7 +121,7 @@ Passed via the `chatProps` prop.
 | `assistantName`          | `string`                         | Name shown for the assistant in the chat header.      |
 | `assistantLogo`          | `string`                         | URL of the logo shown for the assistant.              |
 | `legalText`              | `string`                         | Legal/disclaimer text shown in the chat window.       |
-| `hideCopyButton`         | `boolean`                        | Hide the "copy message" button on assistant messages. |
+| `hasCopyButton`          | `boolean`                        | Show the "copy message" button on assistant messages. |
 | `collectUserFeedback`    | `boolean`                        | Enable thumbs up/down feedback on assistant messages. |
 | `suggestedMessages`      | `boolean`                        | Show suggested message chips to the user.             |
 | `title`                  | `string`                         | Title shown in the chat header.                       |

package/dist/components/chat/chat.hook.d.ts

@@ -56,10 +56,17 @@ export interface UseChatReturn {
  * @param options The hook parameters
  * @returns The chat hook return type
  */
-export declare function useChat({ environment, apiUrl, appId, userId: initialUserId, userName, userData, chatProps, isMobile: propIsMobile, isInitiallyOpen: propIsInitiallyOpen, hasCloseButton: propHasCloseButton, hasCleanChatButton: propHasCleanChatButton, initialOpen: deprecatedInitialOpen, closeButton: deprecatedCloseButton, cleanChatButton: deprecatedCleanChatButton, proactiveMessageHideDelay: propProactiveMessageHideDelay, isAlwaysOpen, }: Readonly<Partial<UseChatProps> & {
+export declare function useChat({ environment, apiUrl, appId, userId: initialUserId, userName, userData, chatProps, isMobile: propIsMobile, isInitiallyOpen: propIsInitiallyOpen, hasCloseButton: propHasCloseButton, hasCleanChatButton: propHasCleanChatButton, initialOpen: deprecatedInitialOpen, closeButton: deprecatedCloseButton, cleanChatButton: deprecatedCleanChatButton, proactiveMessageHideDelay: propProactiveMessageHideDelay, isAlwaysOpen, hasCleanChatButtonOverride, }: Readonly<Partial<UseChatProps> & {
     environment: "test" | "live";
     apiUrl?: string;
     appId: string;
+    /**
+     * Internal-only kill-switch (INTERNAL_ONLY_SHOW_CLEAN_CHAT_BUTTON): when
+     * set, wins over both the boot `chat_settings.clean_chat_button` and the
+     * `hasCleanChatButton` prop. Leave undefined for the normal boot ?? prop
+     * resolution.
+     */
+    hasCleanChatButtonOverride?: boolean;
     /**
      * Embedded mode (INTERNAL_ONLY_CHAT_INTERFACE_ONLY): the interface is the
      * page content and there is no launcher bubble to reopen a closed chat, so

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

@@ -4,13 +4,18 @@ import { UseChatProps } from './chat.hook';
 type InternalChatProps = {
     INTERNAL_ONLY_CHAT_INTERFACE_ONLY?: boolean;
     INTERNAL_ONLY_BLOCK_STYLE?: boolean;
-    INTERNAL_ONLY_FEATURE_HIDE_PROACTIVE_MESSAGE?: boolean;
-    INTERNAL_ONLY_SHOW_CLEAR_CHAT_BUTTON?: boolean;
+    /**
+     * Force the clear-chat button on or off, winning over both the boot
+     * `chat_settings.clean_chat_button` and the public `hasCleanChatButton`
+     * prop. Leave unset to keep the normal boot ?? prop resolution.
+     */
+    INTERNAL_ONLY_SHOW_CLEAN_CHAT_BUTTON?: boolean;
+    /** Show the copy-message button on assistant messages (default false). */
+    INTERNAL_ONLY_SHOW_COPY_BUTTON?: boolean;
     INTERNAL_ONLY_ENVIRONMENT?: "test" | "live";
     INTERNAL_ONLY_API_URL?: string;
     INTERNAL_ONLY_FEATURE_MESSAGE_CLICK?: (message: Message) => void;
     INTERNAL_ONLY_FEATURE_CLEAR_CHAT_CLICK?: () => void;
-    INTERNAL_ONLY_FEATURE_HIDE_COPY_BUTTON?: boolean;
 };
 export type ChatProps = UseChatProps & InternalChatProps;
 export declare function Chat(props: Readonly<ChatProps>): import("react").JSX.Element;

package/dist/components/chat/validations.d.ts

@@ -1,67 +1,67 @@
-import { z } from 'zod';
-export declare const chatResponseApiSchema: z.ZodUnion<readonly [z.ZodObject<{
-    message_id: z.ZodNullable<z.ZodString>;
-    created_at: z.ZodString;
-    data: z.ZodObject<{
-        type: z.ZodLiteral<"utterance">;
-        content: z.ZodString;
-        role: z.ZodString;
+import * as z from "zod/mini";
+export declare const chatResponseApiSchema: z.ZodMiniUnion<readonly [z.ZodMiniObject<{
+    message_id: z.ZodMiniNullable<z.ZodMiniString<string>>;
+    created_at: z.ZodMiniString<string>;
+    data: z.ZodMiniObject<{
+        type: z.ZodMiniLiteral<"utterance">;
+        content: z.ZodMiniString<string>;
+        role: z.ZodMiniString<string>;
     }, z.core.$strip>;
-}, z.core.$strip>, z.ZodObject<{
-    created_at: z.ZodString;
-    data: z.ZodObject<{
-        type: z.ZodLiteral<"error">;
-        code: z.ZodString;
+}, z.core.$strip>, z.ZodMiniObject<{
+    created_at: z.ZodMiniString<string>;
+    data: z.ZodMiniObject<{
+        type: z.ZodMiniLiteral<"error">;
+        code: z.ZodMiniString<string>;
     }, z.core.$strip>;
-}, z.core.$strip>, z.ZodObject<{
-    created_at: z.ZodString;
-    data: z.ZodObject<{
-        type: z.ZodLiteral<"agent_cognition">;
-        content: z.ZodString;
+}, z.core.$strip>, z.ZodMiniObject<{
+    created_at: z.ZodMiniString<string>;
+    data: z.ZodMiniObject<{
+        type: z.ZodMiniLiteral<"agent_cognition">;
+        content: z.ZodMiniString<string>;
     }, z.core.$strip>;
-}, z.core.$strip>, z.ZodObject<{
-    created_at: z.ZodString;
-    data: z.ZodObject<{
-        type: z.ZodLiteral<"agent_captured_url">;
-        content: z.ZodString;
+}, z.core.$strip>, z.ZodMiniObject<{
+    created_at: z.ZodMiniString<string>;
+    data: z.ZodMiniObject<{
+        type: z.ZodMiniLiteral<"agent_captured_url">;
+        content: z.ZodMiniString<string>;
     }, z.core.$strip>;
-}, z.core.$strip>, z.ZodObject<{
-    created_at: z.ZodString;
-    data: z.ZodObject<{
-        type: z.ZodLiteral<"agent_topic">;
-        content: z.ZodString;
+}, z.core.$strip>, z.ZodMiniObject<{
+    created_at: z.ZodMiniString<string>;
+    data: z.ZodMiniObject<{
+        type: z.ZodMiniLiteral<"agent_topic">;
+        content: z.ZodMiniString<string>;
     }, z.core.$strip>;
-}, z.core.$strip>, z.ZodObject<{
-    created_at: z.ZodString;
-    data: z.ZodObject<{
-        type: z.ZodLiteral<"agent_summary">;
-        content: z.ZodString;
+}, z.core.$strip>, z.ZodMiniObject<{
+    created_at: z.ZodMiniString<string>;
+    data: z.ZodMiniObject<{
+        type: z.ZodMiniLiteral<"agent_summary">;
+        content: z.ZodMiniString<string>;
     }, z.core.$strip>;
-}, z.core.$strip>, z.ZodObject<{
-    message_id: z.ZodNullable<z.ZodString>;
-    created_at: z.ZodString;
-    data: z.ZodObject<{
-        type: z.ZodLiteral<"chat_closed_expired">;
-        content: z.ZodString;
+}, z.core.$strip>, z.ZodMiniObject<{
+    message_id: z.ZodMiniNullable<z.ZodMiniString<string>>;
+    created_at: z.ZodMiniString<string>;
+    data: z.ZodMiniObject<{
+        type: z.ZodMiniLiteral<"chat_closed_expired">;
+        content: z.ZodMiniString<string>;
     }, z.core.$strip>;
-}, z.core.$strip>, z.ZodObject<{
-    created_at: z.ZodString;
-    data: z.ZodObject<{
-        type: z.ZodLiteral<"chat_rating">;
-        content: z.ZodString;
+}, z.core.$strip>, z.ZodMiniObject<{
+    created_at: z.ZodMiniString<string>;
+    data: z.ZodMiniObject<{
+        type: z.ZodMiniLiteral<"chat_rating">;
+        content: z.ZodMiniString<string>;
     }, z.core.$strip>;
-}, z.core.$strip>, z.ZodObject<{
-    created_at: z.ZodString;
-    data: z.ZodObject<{
-        type: z.ZodLiteral<"breadcrumb">;
-        content: z.ZodString;
+}, z.core.$strip>, z.ZodMiniObject<{
+    created_at: z.ZodMiniString<string>;
+    data: z.ZodMiniObject<{
+        type: z.ZodMiniLiteral<"breadcrumb">;
+        content: z.ZodMiniString<string>;
     }, z.core.$strip>;
-}, z.core.$strip>, z.ZodObject<{
-    message_id: z.ZodNullable<z.ZodString>;
-    created_at: z.ZodString;
-    data: z.ZodObject<{
-        type: z.ZodLiteral<"chat_escalated">;
-        content: z.ZodNull;
+}, z.core.$strip>, z.ZodMiniObject<{
+    message_id: z.ZodMiniNullable<z.ZodMiniString<string>>;
+    created_at: z.ZodMiniString<string>;
+    data: z.ZodMiniObject<{
+        type: z.ZodMiniLiteral<"chat_escalated">;
+        content: z.ZodMiniNull;
     }, z.core.$strip>;
 }, z.core.$strip>]>;
 export type ChatResponseApi = z.infer<typeof chatResponseApiSchema>;
@@ -103,12 +103,12 @@ export type AgentSummaryNotification = {
         type: "agent_summary";
     }>;
 };
-export declare const chatResponseSchema: z.ZodObject<{
-    message_id: z.ZodString;
-    response: z.ZodObject<{
-        id: z.ZodString;
-        type: z.ZodString;
-        content: z.ZodString;
+export declare const chatResponseSchema: z.ZodMiniObject<{
+    message_id: z.ZodMiniString<string>;
+    response: z.ZodMiniObject<{
+        id: z.ZodMiniString<string>;
+        type: z.ZodMiniString<string>;
+        content: z.ZodMiniString<string>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type ChatResponse = z.infer<typeof chatResponseSchema>;

package/dist/components/chat-interface/index.d.ts

@@ -19,10 +19,13 @@ export interface ChatInterfaceProps {
     closeButton?: boolean;
     /** @deprecated Use `hasCleanChatButton` instead. Ignored when `hasCleanChatButton` is set. */
     cleanChatButton?: boolean;
+    /** Show the copy-message button on assistant messages. Defaults to true. */
+    hasCopyButton?: boolean;
+    /** @deprecated Use `hasCopyButton` instead. Ignored when `hasCopyButton` is set. */
     hideCopyButton?: boolean;
     collectUserFeedback?: boolean;
     suggestedMessages?: boolean;
-    /** Custom quick-reply texts; falls back to the default examples when empty. */
+    /** Quick-reply pill texts; the row renders nothing when empty. */
     suggestedMessageTexts?: string[];
     /** Rotating conic-gradient frame around the first suggestion pill, colored from the pill/user-bubble background. */
     hasSuggestedMessageAura?: boolean;
@@ -31,10 +34,10 @@ export interface ChatInterfaceProps {
     title?: string;
     subtitle?: string;
     /**
-     * Play the intro sequence (skeleton + animated logo) while the Rive asset
-     * loads, defaulting to true — the embed widget's existing behavior. With
-     * false the real interface renders immediately and the Rive runtime is never
-     * downloaded; read-only transcript views (and server rendering) want this.
+     * Play the popup-style panel entrance animation, defaulting to true — the
+     * embed widget's existing behavior. With false the interface renders as
+     * plain page content with no entrance; read-only transcript views (and
+     * server rendering) want this.
      */
     hasIntroAnimation?: boolean;
     /**

package/dist/components/chat-interface/shared.d.ts

@@ -1,3 +1,12 @@
+/**
+ * Header row layout, shared between the real header and its loading skeleton
+ * so the skeleton cannot drift out of alignment with what it mimics.
+ */
+export declare const headerRowClassName = "eloq:p-4 eloq:flex eloq:flex-row eloq:items-center eloq:justify-between eloq:space-y-0";
+/** Avatar + title cluster on the left side of the header row. */
+export declare const headerTitleGroupClassName = "eloq:flex eloq:flex-row eloq:items-center eloq:space-x-3";
+/** Secondary text beside a title (header subtitle, bubble assistant name). */
+export declare const subtitleTextClassName = "eloq:text-xs eloq:text-gray-500 eloq:dark:text-muted-foreground";
 export declare const cardContainerClassName: ({ isOpen, isMobile, skipAnimation, }: {
     isOpen: boolean;
     isMobile: boolean | undefined;

package/dist/components/chat-interface/suggested-messages.d.ts

@@ -4,11 +4,12 @@ export interface SuggestedMessagesProps {
 }
 /**
  * The quick-reply pill row shown above the composer. Renders nothing unless
- * `suggestedMessages` is enabled in the chat-interface context, and only
- * until the conversation starts: the pills disappear the moment the user
- * sends their first message (they reappear when the chat is cleared, since
- * the message list resets). Clicking a pill only fills the composer — the
- * pills stay until the message is actually sent. Two independently
+ * `suggestedMessages` is enabled in the chat-interface context AND
+ * `suggestedMessageTexts` is non-empty (there are no placeholder examples),
+ * and only until the conversation starts: the pills disappear the moment the
+ * user sends their first message (they reappear when the chat is cleared,
+ * since the message list resets). Clicking a pill only fills the composer —
+ * the pills stay until the message is actually sent. Two independently
  * toggleable effects highlight the first (primary) pill:
  * - `hasSuggestedMessageAura` — a rotating conic-gradient frame in a
  *   saturated/soft pair derived from the pill background (or the user-bubble

package/dist/embed-loader.d.ts

@@ -0,0 +1,35 @@
+export declare const EMBED_MODULE_FILE_NAME = "index.embed.js";
+export declare const EMBED_GLOBAL_NAME = "EloquentChatSDK";
+type UnmountFunction = () => void;
+type RenderChatFunction = (container: HTMLElement, props: Record<string, unknown>) => UnmountFunction;
+/** The shape of the dynamically imported SDK module the loader hands off to. */
+export type EmbedSdkModule = Record<string, unknown> & {
+    renderChat: RenderChatFunction;
+};
+export type EmbedSdkGlobal = Record<string, unknown> & {
+    renderChat: RenderChatFunction;
+    /** Resolves with the SDK module, or null when loading failed. */
+    ready: Promise<EmbedSdkModule | null>;
+};
+/** Resolves the ES module URL next to the loader's own script URL. */
+export declare function resolveEmbedModuleUrl(loaderScriptUrl: string): string;
+/**
+ * Finds the absolute URL of the loader's own <script> tag.
+ * `document.currentScript` is only populated during the initial synchronous
+ * evaluation, which is exactly when the loader runs; the tag scan is a
+ * fallback for exotic loading strategies (e.g. the snippet injected the tag
+ * without src-based execution order guarantees).
+ */
+export declare function findLoaderScriptUrl(documentReference: Document): string | null;
+export type InstallEmbedLoaderOptions = {
+    globalObject: Record<string, unknown>;
+    documentReference: Document;
+    importModule: (moduleUrl: string) => Promise<EmbedSdkModule>;
+};
+/**
+ * Installs the queueing SDK global and kicks off the module import.
+ * Returns the module (or null on failure) — the same promise exposed as
+ * `window.EloquentChatSDK.ready`.
+ */
+export declare function installEmbedLoader({ globalObject, documentReference, importModule, }: InstallEmbedLoaderOptions): Promise<EmbedSdkModule | null>;
+export {};

package/dist/embed-loader.entry.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/hooks/use-debounce.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Returns `value` delayed by `delayMilliseconds`: the returned value only
+ * updates once the input has stayed unchanged for the full delay. Drop-in
+ * replacement for `useDebounce` from `@uidotdev/usehooks`.
+ */
+export declare function useDebounce<Type>(value: Type, delayMilliseconds: number): Type;

package/dist/hooks/use-latest-ref.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Returns a ref that always holds the latest `value`, updated after every
+ * render. The "latest ref" pattern: long-lived closures (timers, socket
+ * subscriptions) read `ref.current` at call time instead of capturing a
+ * stale value, without needing the value in any dependency array.
+ */
+export declare function useLatestRef<Type>(value: Type): {
+    readonly current: Type;
+};

package/dist/hooks/use-typed-text.d.ts

@@ -1,7 +1,7 @@
 /**
  * Reveals `text` one character at a time, restarting whenever the text changes.
  *
- * Distinct from `useTypewriter`, which reveals whole messages at once: cognition
+ * Distinct from message rendering, which reveals whole messages at once: cognition
  * labels are a few words that replace each other, so typing them in is what
  * makes the swap read as the agent moving on to the next step rather than the
  * text glitching.