andy-widget-react 2.0.5

package/dist/types/AndyChat.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import type { AndyChatProps } from './types';
+declare const AndyChat: React.FC<AndyChatProps>;
+export default AndyChat;

package/dist/types/components/ChatBubble.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { ChatbotConfig } from '../types';
+interface ChatBubbleProps {
+    isOpen: boolean;
+    config: ChatbotConfig | null;
+    onClick: () => void;
+}
+declare const ChatBubble: React.FC<ChatBubbleProps>;
+export default ChatBubble;

package/dist/types/components/ChatWindow.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import type { ChatbotConfig, Message } from '../types';
+interface ChatWindowProps {
+    config: ChatbotConfig | null;
+    messages: Message[];
+    isLoading: boolean;
+    onClose: () => void;
+    onSendMessage: (message: string) => Promise<void> | void;
+}
+declare const ChatWindow: React.FC<ChatWindowProps>;
+export default ChatWindow;

package/dist/types/components/FAQ.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import type { FAQItem } from '../types';
+interface FAQProps {
+    faqs?: FAQItem[];
+    onBack: () => void;
+}
+declare const FAQ: React.FC<FAQProps>;
+export default FAQ;

package/dist/types/components/MessageInput.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+interface MessageInputProps {
+    onSendMessage: (message: string) => Promise<void> | void;
+    disabled?: boolean;
+    placeholder?: string;
+}
+declare const MessageInput: React.FC<MessageInputProps>;
+export default MessageInput;

package/dist/types/components/MessageList.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+import type { Message } from '../types';
+interface MessageListProps {
+    messages: Message[];
+    isLoading: boolean;
+    logoUrl?: string;
+    botName?: string;
+}
+declare const MessageList: React.FC<MessageListProps>;
+export default MessageList;

package/dist/types/components/UserInfoForm.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+import type { UserInfo } from '../types';
+interface UserInfoFormProps {
+    headerText?: string;
+    brandColor?: string;
+    onSubmit: (data: UserInfo) => Promise<void> | void;
+    onClose: () => void;
+}
+declare const UserInfoForm: React.FC<UserInfoFormProps>;
+export default UserInfoForm;

package/dist/types/components/WelcomePopup.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+interface WelcomePopupProps {
+    message: string;
+    brandColor?: string;
+    onClose: () => void;
+}
+declare const WelcomePopup: React.FC<WelcomePopupProps>;
+export default WelcomePopup;

package/dist/types/hooks/index.d.ts

@@ -0,0 +1 @@
+export { useAndyChat } from './useAndyChat';

package/dist/types/hooks/useAndyChat.d.ts

@@ -0,0 +1,2 @@
+import type { UseAndyChatReturn } from '../types';
+export declare const useAndyChat: (embedId: string) => UseAndyChatReturn;

package/dist/types/index.d.ts

@@ -0,0 +1,13 @@
+export { default as AndyChat } from './AndyChat';
+export { default as Andy } from './AndyChat';
+export { useAndyChat } from './hooks/useAndyChat';
+export { default as ChatBubble } from './components/ChatBubble';
+export { default as ChatWindow } from './components/ChatWindow';
+export { default as MessageList } from './components/MessageList';
+export { default as MessageInput } from './components/MessageInput';
+export { default as FAQ } from './components/FAQ';
+export { default as WelcomePopup } from './components/WelcomePopup';
+export { default as UserInfoForm } from './components/UserInfoForm';
+export type { AndyChatProps, ChatbotConfig, Message, FAQItem, PredefinedQuestion, WelcomePopupConfig, CollectUserInfoConfig, UserInfo, UseAndyChatReturn, ChatBubbleProps, ChatWindowProps, MessageListProps, MessageInputProps, FAQProps, WelcomePopupProps, UserInfoFormProps, FaqItemProps } from './types';
+export { theme, colors, typography, spacing, borderRadius, shadows, zIndex, animation, chat, generateSessionId, parseMarkdown, sanitizeUrl, isValidEmbedId, getEmbedId, getApiBaseUrl, setApiBaseUrl } from 'andy-widget-core';
+export { default } from './AndyChat';

package/dist/types/types/index.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Type definitions for andy-widget-react
+ */
+export interface WelcomePopupConfig {
+    enabled: boolean;
+    seconds: number;
+    message?: string;
+}
+export interface CollectUserInfoConfig {
+    enabled: boolean;
+    message?: string;
+}
+export interface PredefinedQuestion {
+    order: number;
+    question: string;
+}
+export interface FAQItem {
+    question: string;
+    answer: string;
+}
+export interface ChatbotConfig {
+    id: string | null;
+    name: string;
+    theme: 'light' | 'dark' | 'auto';
+    logoUrl: string;
+    headline: string;
+    brandColor: string;
+    description: string;
+    orientation: 'left' | 'right';
+    bubbleStyle: 'icon' | 'pill';
+    bubbleLabel: string | null;
+    useBrandColor: boolean;
+    defaultLang: 'en' | 'es';
+    showBranding: boolean;
+    welcomeMessage: string;
+    showWelcomePopup: WelcomePopupConfig;
+    collectUserInfo: CollectUserInfoConfig;
+    predefinedQuestions: PredefinedQuestion[];
+    faqs: FAQItem[];
+}
+export interface Message {
+    id: number;
+    content: string;
+    sender: 'user' | 'bot';
+    timestamp: string;
+    isForm?: boolean;
+    isLoading?: boolean;
+    isError?: boolean;
+}
+export interface UserInfo {
+    name: string;
+    email: string;
+}
+export interface AndyChatProps {
+    /** Required chatbot embed ID (not required if previewMode is true) */
+    embedId?: string;
+    /** Optional tooltip text for the chat bubble */
+    tooltip?: string;
+    /** Optional bot name (overrides API value) */
+    name?: string;
+    /** Optional headline/subtitle (overrides API value) */
+    headline?: string;
+    /** Optional description (overrides API value) */
+    description?: string;
+    /** Optional welcome message (overrides API value) */
+    welcomeMessage?: string;
+    /** Optional custom label for pill-style bubble (overrides default) */
+    bubbleLabel?: string;
+    /** Optional theme ('light' | 'dark' | 'auto') */
+    theme?: 'light' | 'dark' | 'auto';
+    /** Optional position ('left' | 'right') */
+    orientation?: 'left' | 'right';
+    /** Optional brand color hex (e.g., '#3B82F6') */
+    brandColor?: string;
+    /** Optional bubble style ('icon' | 'pill') */
+    bubbleStyle?: 'icon' | 'pill';
+    /** Optional whether to use brand color */
+    useBrandColor?: boolean;
+    /** Optional logo URL */
+    logoUrl?: string;
+    /** If true, skip API fetch and use props directly as config */
+    previewMode?: boolean;
+    /** If true, start with chat window open */
+    initialOpen?: boolean;
+}
+export interface FaqItemProps {
+    question: string;
+    answer: string;
+}
+export interface ChatBubbleProps {
+    isOpen: boolean;
+    onClick: () => void;
+    tooltip?: string;
+    logoUrl?: string;
+    bubbleStyle?: 'icon' | 'pill';
+    bubbleLabel?: string;
+    theme?: 'light' | 'dark' | 'auto';
+    useBrandColor?: boolean;
+}
+export interface ChatWindowProps {
+    isOpen: boolean;
+    config: ChatbotConfig | null;
+    messages: Message[];
+    isLoading: boolean;
+    showPredefinedQuestions: boolean;
+    isCollectingUserInfo: boolean;
+    onClose: () => void;
+    onSendMessage: (message: string) => void;
+    onPredefinedQuestion: (question: string) => void;
+    onUserInfoSubmit: (e: React.FormEvent<HTMLFormElement>) => void;
+}
+export interface MessageListProps {
+    messages: Message[];
+    config: ChatbotConfig | null;
+    isLoading: boolean;
+    isCollectingUserInfo: boolean;
+    onUserInfoSubmit: (e: React.FormEvent<HTMLFormElement>) => void;
+}
+export interface MessageInputProps {
+    onSendMessage: (message: string) => void;
+    disabled?: boolean;
+    placeholder?: string;
+}
+export interface FAQProps {
+    faqs: FAQItem[];
+    onBack: () => void;
+}
+export interface WelcomePopupProps {
+    message: string;
+    orientation?: 'left' | 'right';
+    onClose: () => void;
+}
+export interface UserInfoFormProps {
+    message?: string;
+    onSubmit: (e: React.FormEvent<HTMLFormElement>) => void;
+}
+export interface UseAndyChatReturn {
+    config: Partial<ChatbotConfig>;
+    isLoading: boolean;
+    isOpen: boolean;
+    showingFaq: boolean;
+    showingWelcomePopup: boolean;
+    showingUserInfoForm: boolean;
+    messages: Message[];
+    userInfoCollected: boolean;
+    sessionId: string;
+    error: string | null;
+    initializeChatbot: () => Promise<void>;
+    toggleChat: () => void;
+    sendMessage: (messageText: string) => Promise<unknown>;
+    showFaq: () => void;
+    hideFaq: () => void;
+    showWelcomePopup: () => void;
+    hideWelcomePopup: () => void;
+    showUserInfoForm: () => void;
+    hideUserInfoForm: () => void;
+    submitUserInfo: (userInfo: UserInfo) => Promise<void>;
+    startNewSession: () => void;
+    addMessage: (message: Message) => void;
+}
+export interface StylesheetOptions {
+    color?: string;
+    useBrandColor?: boolean;
+    theme?: 'light' | 'dark' | 'auto';
+    orientation?: 'left' | 'right';
+}
+export interface HostClassOptions {
+    theme?: 'light' | 'dark' | 'auto';
+    orientation?: 'left' | 'right';
+}
+export interface KeyboardListenerCallback {
+    (state: {
+        isOpen: boolean;
+        height: number;
+    }): void;
+}
+export interface KeyboardDetector {
+    addListener: (callback: KeyboardListenerCallback) => void;
+    removeListener: (callback: KeyboardListenerCallback) => void;
+}

package/package.json

@@ -0,0 +1,72 @@
+{
+	"name": "andy-widget-react",
+	"version": "2.0.5",
+	"description": "Official React Widget for embeddable Andy agents",
+	"type": "module",
+	"main": "dist/index.cjs",
+	"module": "dist/index.esm.js",
+	"types": "dist/types/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/types/index.d.ts",
+			"import": "./dist/index.esm.js",
+			"require": "./dist/index.cjs"
+		}
+	},
+	"files": [
+		"dist/**/*",
+		"src/**/*",
+		"README.md"
+	],
+	"scripts": {
+		"build": "rm -rf dist && rollup -c",
+		"build:dev": "rm -rf dist && rollup -c",
+		"dev": "rollup -c --watch",
+		"typecheck": "tsc -p tsconfig.json --noEmit",
+		"prepublishOnly": "bun run build"
+	},
+	"keywords": [
+		"react",
+		"chatbot",
+		"ai",
+		"chat",
+		"widget",
+		"customer-support",
+		"embeddable",
+		"component"
+	],
+	"author": "Andesphere",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/Andesphere/andy-sdk.git",
+		"directory": "packages/react"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"devDependencies": {
+		"@babel/core": "^7.27.3",
+		"@babel/preset-react": "^7.27.1",
+		"@rollup/plugin-babel": "^6.0.4",
+		"@rollup/plugin-commonjs": "^28.0.3",
+		"@rollup/plugin-node-resolve": "^16.0.1",
+		"@rollup/plugin-typescript": "^12.3.0",
+		"@rollup/plugin-url": "^8.0.2",
+		"@types/react": "^19.1.2",
+		"@types/react-dom": "^19.1.2",
+		"react": "^19.0.0",
+		"react-dom": "^19.0.0",
+		"rollup": "^4.41.1",
+		"rollup-plugin-postcss": "^4.0.2",
+		"tslib": "^2.8.1",
+		"typescript": "^5.9.3"
+	},
+	"peerDependencies": {
+		"react": "^18.0.0 || ^19.0.0",
+		"react-dom": "^18.0.0 || ^19.0.0"
+	},
+	"dependencies": {
+		"andy-widget-core": "2.0.5"
+	}
+}