@brainbase-labs/chat-widget 0.1.19 → 0.1.20

package/dist/index.d.ts

@@ -12,9 +12,17 @@ declare interface ChatContainerProps {
     messages: MessageType[];
     toolCalls?: ToolCall[];
     isLoading: boolean;
+    showTypingIndicator?: boolean;
+    isExpanded?: boolean;
+    headerSubtitle?: string;
+    voiceTokenUrl?: string;
+    voiceAgentName?: string;
+    enableVoiceMode?: boolean;
     onSendMessage: (message: string) => void;
     onClose?: () => void;
+    onBack?: () => void;
     onNewChat?: () => void;
+    onExpandWindow?: () => void;
 }
 
 export declare const ChatHeader: default_2.FC<ChatHeaderProps>;
@@ -22,11 +30,18 @@ export declare const ChatHeader: default_2.FC<ChatHeaderProps>;
 declare interface ChatHeaderProps {
     agentName?: string;
     agentLogoUrl?: string;
+    /** Description shown below agent name (e.g., "The team can also help") */
+    headerSubtitle?: string;
     welcomeTitle?: string;
     welcomeSubtitle?: string;
     onClose?: () => void;
+    onBack?: () => void;
     onNewChatRequest?: () => void;
-    showNewChatButton?: boolean;
+    onExpandWindow?: () => void;
+    onDownloadTranscript?: () => void;
+    showMenuButton?: boolean;
+    /** Whether the widget is currently expanded */
+    isExpanded?: boolean;
     /** When true, shows a compact header without welcome text */
     compact?: boolean;
 }
@@ -38,6 +53,8 @@ declare interface ChatToggleButtonProps {
     agentName?: string;
     agentLogoUrl?: string;
     unreadCount?: number;
+    /** Custom icon - can be a Lucide icon name (string), image URL, or React node */
+    customIcon?: string | default_2.ReactNode;
 }
 
 export declare const ChatWidget: default_2.FC<ChatWidgetProps>;
@@ -57,14 +74,69 @@ export declare interface ChatWidgetProps {
     defaultOpen?: boolean;
     /** Override primary color */
     primaryColor?: string;
+    /** Accent color for buttons and icons - NOT header (defaults to primaryColor) */
+    accentColor?: string;
+    /** Use gradient on header (default: false) */
+    primaryGradient?: boolean;
+    /** Use gradient on accent elements like buttons and icons (default: false) */
+    accentGradient?: boolean;
+    /** Header text color (default: based on theme - black for light/dark, gray for granite) */
+    headerTextColor?: string;
+    /** Stream messages token by token (default: false - show full message when complete) */
+    streamMessages?: boolean;
+    /** Artificial delay range in seconds [min, max] for typing indicator and response.
+     * Adds random delay before showing dots and before showing response.
+     * Default: undefined (no artificial delay, just 1s delay for typing indicator) */
+    artificialDelay?: [number, number];
+    /** Home page hero image URL (optional) */
+    homeImage?: string;
+    /** Home page title text (optional) */
+    homeTitle?: string;
+    /** Home page description text (optional) */
+    homeDescription?: string;
+    /** URL to open when home page info card is clicked (optional) */
+    homeLink?: string;
+    /** Time in seconds before the widget auto-opens and sends a trigger message.
+     * When set, the widget will automatically open after this delay and send a hidden
+     * message to trigger the agent. Default: undefined (never auto-opens) */
+    timeToOpen?: number;
+    /** URL for the LiveKit token endpoint (e.g., 'https://your-app.com/api/token').
+     * Required for voice mode to work. */
+    voiceTokenUrl?: string;
+    /** Agent name for voice mode dispatch. Default: 'voice-agent' */
+    voiceAgentName?: string;
+    /** Enable voice mode (audio button in input). Default: false */
+    enableVoiceMode?: boolean;
+    /** Show the collapse button (circle with down arrow) when widget is open. Default: true */
+    showCollapseButton?: boolean;
     /** Override agent name */
     agentName?: string;
+    /** Override agent role (e.g., "AI Agent", "Support Bot") */
+    agentRole?: string;
+    /** Description shown below agent name in header (e.g., "The team can also help") */
+    headerSubtitle?: string;
     /** Override agent logo URL */
     agentLogoUrl?: string;
+    /** Agent name font size in pixels (default: 16) */
+    agentNameFontSize?: number;
+    /** Custom icon for the toggle button (when closed). Can be a URL or React node */
+    toggleIcon?: string | React.ReactNode;
     /** Override welcome message */
     welcomeMessage?: string;
     /** Override branding visibility */
     showBranding?: boolean;
+    /** Widget width in pixels (default: 420) */
+    width?: number;
+    /** Widget height in pixels (default: 720) */
+    height?: number;
+    /** Expanded widget width in pixels (default: 640) */
+    expandedWidth?: number;
+    /** Expanded widget height in pixels (default: 800) */
+    expandedHeight?: number;
+    /** Message font size in pixels (default: 15) */
+    messageFontSize?: number;
+    /** Theme: 'light' (default), 'dark', or 'granite' */
+    theme?: ChatWidgetTheme;
     /** Custom CSS class */
     className?: string;
     /** Callback when session starts */
@@ -77,6 +149,8 @@ export declare interface ChatWidgetProps {
     onError?: (error: Error) => void;
 }
 
+declare type ChatWidgetTheme = 'light' | 'dark' | 'granite';
+
 export declare function clearSession(embedId: string): void;
 
 export declare function createAPIClient(engineBaseUrl?: string): BrainbaseAPIClient;
@@ -90,6 +164,7 @@ export declare interface DeploymentConfig {
     flowId: string;
     welcomeMessage?: string;
     agentName?: string;
+    agentRole?: string;
     agentLogoUrl?: string;
     primaryColor?: string;
     styling?: Record<string, unknown>;
@@ -111,6 +186,10 @@ declare interface MessageInputProps {
     onSend: (message: string) => void;
     disabled?: boolean;
     placeholder?: string;
+    onAttachment?: () => void;
+    onEmoji?: () => void;
+    onGif?: () => void;
+    onVoice?: () => void;
 }
 
 export declare const MessageList: default_2.FC<MessageListProps>;
@@ -119,14 +198,17 @@ declare interface MessageListProps {
     messages: MessageType[];
     toolCalls?: ToolCall[];
     isLoading: boolean;
+    showTypingIndicator?: boolean;
     agentName?: string;
+    agentRole?: string;
     agentLogoUrl?: string;
 }
 
 declare interface MessageProps {
     message: MessageType;
     agentName?: string;
-    agentLogoUrl?: string;
+    agentRole?: string;
+    isLastAssistantMessage?: boolean;
 }
 
 export declare type MessageRole = 'user' | 'assistant' | 'system';
@@ -213,6 +295,8 @@ declare interface UseChatOptions {
     config: DeploymentConfig;
     apiClient: BrainbaseAPIClient | MockAPIClient;
     mockMode?: boolean;
+    streamMessages?: boolean;
+    artificialDelay?: [number, number];
     onSessionStart?: (sessionId: string) => void;
     onSessionEnd?: (session: Session) => void;
     onMessage?: (message: MessageType) => void;
@@ -223,9 +307,11 @@ export declare interface UseChatReturn {
     messages: MessageType[];
     toolCalls: ToolCall[];
     isLoading: boolean;
+    showTypingIndicator: boolean;
     error: Error | null;
     sessionId: string | null;
     sendMessage: (content: string) => Promise<void>;
+    sendTriggerMessage: () => Promise<void>;
     endSession: () => Promise<void>;
     clearMessages: () => void;
     startNewSession: () => Promise<string>;