@chatwidgetai/chat-widget 0.1.0

package/dist/types/index.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Widget Types
+ * Aligned with backend types from WIDGET_SYSTEM_ARCHITECTURE.md
+ */
+export type WidgetTheme = 'light' | 'dark' | 'auto';
+export type WidgetPosition = 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
+export type WidgetSize = 'small' | 'medium' | 'large';
+export interface WidgetAppearance {
+    theme: WidgetTheme;
+    primaryColor: string;
+    position: WidgetPosition;
+    size: WidgetSize;
+    borderRadius: number;
+    fontFamily?: string;
+    customCSS?: string;
+    logo?: string;
+    companyName?: string;
+    welcomeMessage: string;
+    placeholder: string;
+    buttonIcon?: string;
+    buttonText?: string;
+    buttonSize: number;
+}
+export type SourceDisplayMode = 'none' | 'minimal' | 'with-score' | 'with-content' | 'full';
+export interface WidgetBehavior {
+    autoOpen: boolean;
+    autoOpenDelay?: number;
+    persistConversation: boolean;
+    showTimestamps: boolean;
+    showTypingIndicator: boolean;
+    enableFileUpload: boolean;
+    enableFeedback: boolean;
+    maxMessagesPerSession?: number;
+    agentic: boolean;
+    showSources: boolean;
+    sourceDisplayMode: SourceDisplayMode;
+    suggestedQuestions?: string[];
+    temperature: number;
+    maxTokens: number;
+    systemPrompt?: string;
+    fallbackMessage?: string;
+}
+export interface WidgetConfig {
+    appearance: WidgetAppearance;
+    behavior: WidgetBehavior;
+    knowledgeBases: string[];
+    actions?: string[];
+}
+export interface FileAttachment {
+    name: string;
+    size: number;
+    extension: string;
+}
+export type KbDocument = {
+    kbId: string;
+    score?: number;
+    doc: {
+        pageContent: string;
+        id: string;
+        metadata: Record<string, unknown>;
+    };
+};
+export type MessageContent = string;
+export interface BaseMessage {
+    type: string;
+    content: MessageContent;
+    id?: string;
+    name?: string | null;
+    response_metadata?: Record<string, any>;
+    additional_kwargs?: Record<string, any>;
+}
+export interface ToolCall {
+    name: string;
+    args: Record<string, any>;
+    id?: string;
+    type?: string;
+}
+export interface UsageMetadata {
+    input_tokens?: number;
+    output_tokens?: number;
+    total_tokens?: number;
+    model_name?: string;
+    [k: string]: any;
+}
+export interface AIMessage extends BaseMessage {
+    type: "ai";
+    tool_calls?: ToolCall[];
+    invalid_tool_calls?: Array<Record<string, any>>;
+    example?: boolean;
+    usage_metadata?: UsageMetadata | null;
+}
+export interface HumanMessage extends BaseMessage {
+    type: "human";
+}
+export interface SystemMessage extends BaseMessage {
+    type: "system";
+}
+export interface ChatMessage extends BaseMessage {
+    type: "chat";
+}
+export interface FunctionMessage extends BaseMessage {
+    type: "function";
+    name: string;
+}
+export interface ToolMessage extends BaseMessage {
+    type: "tool";
+    tool_call_id: string;
+    artifact?: any;
+}
+export interface RemoveMessage extends BaseMessage {
+    type: "remove";
+    id: string;
+}
+export type AnyMessage = AIMessage | HumanMessage | SystemMessage | ChatMessage | FunctionMessage | ToolMessage | RemoveMessage;
+export interface ConversationMessage {
+    id: string;
+    message: AnyMessage;
+    timestamp: string;
+    sources: KbDocument[];
+    feedback?: "positive" | "negative";
+}
+export interface WidgetProps {
+    widgetId: string;
+    apiKey: string;
+    apiUrl?: string;
+    position?: WidgetPosition;
+    theme?: WidgetTheme;
+    primaryColor?: string;
+    onOpen?: () => void;
+    onClose?: () => void;
+    onMessage?: (message: ConversationMessage) => void;
+    onError?: (error: Error) => void;
+}
+export interface ChatState {
+    messages: ConversationMessage[];
+    isOpen: boolean;
+    isLoading: boolean;
+    isTyping: boolean;
+    error: string | null;
+    conversationId: string;
+    config: WidgetConfig | null;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/dist/umd.d.ts

@@ -0,0 +1,25 @@
+type MountOptions = {
+    widgetId: string;
+    apiKey: string;
+    apiUrl?: string;
+    position?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
+    theme?: 'light' | 'dark' | 'auto';
+    primaryColor?: string;
+    container?: string | HTMLElement;
+    onOpen?: () => void;
+    onClose?: () => void;
+    onMessage?: (msg: any) => void;
+    onError?: (err: Error) => void;
+};
+declare function mount(options: MountOptions): {
+    destroy(): void;
+};
+declare global {
+    interface Window {
+        AIChatWidget: {
+            mount: typeof mount;
+        };
+    }
+}
+export { mount };
+//# sourceMappingURL=umd.d.ts.map

package/dist/umd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"umd.d.ts","sourceRoot":"","sources":["../src/umd.ts"],"names":[],"mappings":"AASA,KAAK,YAAY,GAAG;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,cAAc,GAAG,aAAa,GAAG,WAAW,GAAG,UAAU,CAAC;IACrE,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;CAChC,CAAC;AAgBF,iBAAS,KAAK,CAAC,OAAO,EAAE,YAAY;;EA4BnC;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,YAAY,EAAE;YAAE,KAAK,EAAE,OAAO,KAAK,CAAA;SAAE,CAAC;KACvC;CACF;AAOD,OAAO,EAAE,KAAK,EAAE,CAAC"}

package/dist/utils/actionExecutor.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Client Action Executor
+ * Handles execution of client-side actions
+ */
+export interface ClientAction {
+    implementation: string;
+    parameters: Record<string, any>;
+}
+export interface ActionResult {
+    success: boolean;
+    result?: any;
+    error?: string;
+}
+/**
+ * Execute a client-side action
+ */
+export declare function executeClientAction(action: ClientAction): Promise<ActionResult>;
+//# sourceMappingURL=actionExecutor.d.ts.map

package/dist/utils/actionExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actionExecutor.d.ts","sourceRoot":"","sources":["../../src/utils/actionExecutor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CA+BrF"}

package/dist/utils/session.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Session Management Utilities
+ */
+/**
+ * Generate a unique session ID
+ */
+export declare function generateSessionId(): string;
+/**
+ * Generate a unique message ID
+ */
+export declare function generateMessageId(): string;
+//# sourceMappingURL=session.d.ts.map

package/dist/utils/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/utils/session.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAI1C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAI1C"}

package/dist/utils/storage.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Local Storage Utilities
+ * Handles conversation persistence in browser localStorage
+ */
+import { ConversationMessage } from '../types';
+export interface StoredConversation {
+    conversationId: string;
+    sessionId?: string;
+    messages: ConversationMessage[];
+    lastUpdated: string;
+}
+/**
+ * Save conversation to localStorage
+ */
+export declare function saveConversation(widgetId: string, conversationId: string, messages: ConversationMessage[]): void;
+/**
+ * Load conversation from localStorage
+ */
+export declare function loadConversation(widgetId: string): StoredConversation | null;
+/**
+ * Clear conversation from localStorage
+ */
+export declare function clearConversation(widgetId: string): void;
+/**
+ * Check if localStorage is available
+ */
+export declare function isStorageAvailable(): boolean;
+//# sourceMappingURL=storage.d.ts.map

package/dist/utils/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/utils/storage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAI/C,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;CACrB;AASD;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,mBAAmB,EAAE,GAC9B,IAAI,CAYN;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAc5E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAOxD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAS5C"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@chatwidgetai/chat-widget",
+  "version": "0.1.0",
+  "description": "Embeddable AI chat widget powered by your knowledge bases",
+  "main": "dist/index.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "react",
+    "chat",
+    "widget",
+    "ai",
+    "chatbot",
+    "knowledge-base"
+  ],
+  "author": "",
+  "license": "MIT",
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^28.0.2",
+    "@rollup/plugin-node-resolve": "^15.3.0",
+    "@rollup/plugin-typescript": "^12.1.2",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "eslint": "^9.0.0",
+    "eslint-plugin-react": "^7.37.0",
+    "eslint-plugin-react-hooks": "^5.0.0",
+    "postcss": "^8.4.49",
+    "rollup": "^4.30.1",
+    "rollup-plugin-peer-deps-external": "^2.2.4",
+    "rollup-plugin-postcss": "^4.0.2",
+    "tslib": "^2.8.1",
+    "typescript": "^5.7.2"
+  },
+  "dependencies": {
+    "react-markdown": "^9.0.1"
+  },
+  "scripts": {
+    "build": "rollup -c",
+    "dev": "rollup -c -w",
+    "test": "jest",
+    "lint": "eslint src --ext .ts,.tsx",
+    "typecheck": "tsc --noEmit"
+  }
+}