langchat-widget 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,635 @@
+import { App } from 'vue';
+import { ComputedRef } from 'vue';
+
+export declare interface AvatarConfig {
+    ai?: string;
+    user?: string;
+    size?: number;
+    borderRadius?: string;
+}
+
+export declare interface BackendAPI {
+    getSuggestedQuestions: (context: string) => Promise<QuestionItem[]>;
+    getWelcomeMessage: () => Promise<WelcomeData>;
+}
+
+export declare interface ChatMessage {
+    id: string;
+    type: 'ai' | 'questions' | 'user' | 'welcome';
+    content: string;
+    timestamp: Date;
+    status?: 'error' | 'sending' | 'sent' | 'streaming';
+    error?: string;
+    isStreaming?: boolean;
+    streamContent?: string;
+    questions?: QuestionItem[];
+    welcomeData?: WelcomeData;
+}
+
+export declare interface ChatRequest {
+    messages: Array<{
+        content: string;
+        role: 'assistant' | 'system' | 'user';
+    }>;
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    stream?: boolean;
+}
+
+export declare interface ChatResponse {
+    id: string;
+    object: string;
+    created: number;
+    model: string;
+    choices: Array<{
+        finishReason: string;
+        index: number;
+        message: {
+            content: string;
+            role: string;
+        };
+    }>;
+    usage: {
+        completionTokens: number;
+        promptTokens: number;
+        totalTokens: number;
+    };
+}
+
+export declare interface ChatSession {
+    id: string;
+    messages: ChatMessage[];
+    createdAt: Date;
+    updatedAt: Date;
+}
+
+export declare interface CopyrightConfig {
+    text?: string;
+    link?: string;
+    linkText?: string;
+    className?: string;
+    backgroundColor?: string;
+    textColor?: string;
+}
+
+export declare function createErrorHandler(config?: Partial<ErrorHandlerConfig>): ErrorHandler;
+
+export declare function createMessageStore(options?: {
+    maxHistoryItems?: number;
+    enableHistory?: boolean;
+}): MessageStore;
+
+export declare function createOpenAIClient(config: OpenAIConfig): OpenAIClient;
+
+export declare function createThemeManager(initialTheme?: Partial<ThemeConfig_2>): ThemeManager;
+
+export declare type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+};
+
+export declare const DEFAULT_CONFIG: Required<LangChatConfig>;
+
+declare class ErrorHandler {
+    private config;
+    private errorHistory;
+    private retryQueue;
+    constructor(config?: Partial<ErrorHandlerConfig>);
+    handleError(error: any, context?: Record<string, any>): ErrorInfo;
+    private createErrorInfo;
+    private scheduleRetry;
+    private executeRetry;
+    private logError;
+    private getLogLevel;
+    getErrorHistory(): ErrorInfo[];
+    getErrorsByType(type: ErrorType): ErrorInfo[];
+    getErrorsBySeverity(severity: ErrorSeverity): ErrorInfo[];
+    getRetryableErrors(): ErrorInfo[];
+    clearErrorHistory(): void;
+    cleanupOldErrors(olderThanHours?: number): number;
+    getErrorStats(): Record<string, any>;
+    updateConfig(config: Partial<ErrorHandlerConfig>): void;
+    getConfig(): ErrorHandlerConfig;
+    destroy(): void;
+}
+
+export declare const errorHandler: ErrorHandler;
+
+declare interface ErrorHandlerConfig {
+    enableRetry: boolean;
+    maxRetries: number;
+    retryDelay: number;
+    showTechnicalDetails: boolean;
+    logErrors: boolean;
+    onError?: (error: ErrorInfo) => void;
+}
+
+declare interface ErrorInfo {
+    type: ErrorType;
+    severity: ErrorSeverity;
+    code: string;
+    message: string;
+    userMessage: string;
+    technicalDetails?: string;
+    retryable: boolean;
+    retryCount?: number;
+    maxRetries?: number;
+    timestamp: Date;
+    context?: Record<string, any>;
+}
+
+declare enum ErrorSeverity {
+    LOW = "LOW",
+    MEDIUM = "MEDIUM",
+    HIGH = "HIGH",
+    CRITICAL = "CRITICAL"
+}
+
+declare enum ErrorType {
+    NETWORK = "NETWORK",
+    API = "API",
+    VALIDATION = "VALIDATION",
+    AUTHENTICATION = "AUTHENTICATION",
+    RATE_LIMIT = "RATE_LIMIT",
+    TIMEOUT = "TIMEOUT",
+    UNKNOWN = "UNKNOWN"
+}
+
+export declare interface HeaderConfig {
+    title?: string;
+    className?: string;
+    backgroundColor?: string;
+    textColor?: string;
+    showCloseButton?: boolean;
+    draggable?: boolean;
+}
+
+declare class LangChatBot implements LangChatInstance {
+    private _isLoading;
+    private _isOpen;
+    private app;
+    private config;
+    private container;
+    private eventListeners;
+    private isInitialized;
+    private messages;
+    private openaiClient;
+    private streamingMessageId;
+    private suggestedQuestions;
+    private welcomeData;
+    constructor(config: LangChatConfig);
+    clearHistory(): void;
+    close(): void;
+    destroy(): void;
+    getConfig(): LangChatConfig;
+    getHistory(): ChatMessage[];
+    getSuggestedQuestions(context?: string): Promise<QuestionItem[]>;
+    init(): void;
+    isLoading(): boolean;
+    isOpen(): boolean;
+    off(event: LangChatEvent, callback: Function): void;
+    on(event: LangChatEvent, callback: Function): void;
+    open(): void;
+    sendMessage(content: string): Promise<void>;
+    startStreaming(messageId: string): void;
+    stopStreaming(messageId: string): void;
+    toggle(): void;
+    updateConfig(config: Partial<LangChatConfig>): void;
+    private createContainer;
+    private createVueApp;
+    private emit;
+    private generateId;
+    private initializeOpenAIClient;
+    private initializeThemeManager;
+    private initializeWelcomeAndQuestions;
+    private mergeConfig;
+    private saveToHistory;
+    private startStreamingReply;
+    private updateContainerPosition;
+    private updateOpenAIClient;
+    private updateSuggestedQuestions;
+    private validateConfig;
+}
+export { LangChatBot }
+export default LangChatBot;
+
+export declare interface LangChatConfig {
+    apiKey: string;
+    modelName: string;
+    baseUrl?: string;
+    organization?: string;
+    header?: HeaderConfig;
+    avatars?: AvatarConfig;
+    theme?: ThemeConfig;
+    messages?: MessageConfig;
+    copyright?: CopyrightConfig;
+    welcome?: WelcomeConfig;
+    questions?: QuestionItem[];
+    autoOpen?: boolean;
+    position?: 'bottom-left' | 'bottom-right' | 'top-left' | 'top-right';
+    zIndex?: number;
+    enableMarkdown?: boolean;
+    enableHistory?: boolean;
+    maxHistoryItems?: number;
+    enableStreaming?: boolean;
+    enableAutoSuggestions?: boolean;
+    backendAPI?: BackendAPI;
+    onMessageSent?: (message: ChatMessage) => void;
+    onMessageReceived?: (message: ChatMessage) => void;
+    onStreamingUpdate?: (messageId: string, content: string) => void;
+    onError?: (error: Error) => void;
+    onOpen?: () => void;
+    onClose?: () => void;
+}
+
+export declare type LangChatEvent = 'close' | 'config-updated' | 'error' | 'init' | 'message-received' | 'message-sent' | 'open' | 'questions-updated' | 'streaming-update';
+
+export declare interface LangChatInstance {
+    init(): void;
+    destroy(): void;
+    open(): void;
+    close(): void;
+    toggle(): void;
+    sendMessage(content: string): Promise<void>;
+    clearHistory(): void;
+    getHistory(): ChatMessage[];
+    startStreaming(messageId: string): void;
+    stopStreaming(messageId: string): void;
+    getSuggestedQuestions(context?: string): Promise<QuestionItem[]>;
+    updateConfig(config: Partial<LangChatConfig>): void;
+    getConfig(): LangChatConfig;
+    isOpen(): boolean;
+    isLoading(): boolean;
+}
+
+export declare interface MarkdownOptions {
+    html?: boolean;
+    linkify?: boolean;
+    typographer?: boolean;
+    breaks?: boolean;
+}
+
+export declare interface MessageConfig {
+    aiBackgroundColor?: string;
+    userBackgroundColor?: string;
+    aiTextColor?: string;
+    userTextColor?: string;
+    maxHeight?: string;
+    showTimestamp?: boolean;
+    markdownOptions?: MarkdownOptions;
+    placeholder?: string;
+    maxLength?: number;
+    showAudioButton?: boolean;
+}
+
+declare class MessageStore {
+    private messages;
+    private sessions;
+    private currentSessionId;
+    private questions;
+    private enableHistory;
+    constructor(options?: {
+        maxHistoryItems?: number;
+        enableHistory?: boolean;
+    });
+    get allMessages(): ComputedRef<    {
+    id: string;
+    type: "ai" | "questions" | "user" | "welcome";
+    content: string;
+    timestamp: Date;
+    status?: "error" | "sending" | "sent" | "streaming" | undefined;
+    error?: string | undefined;
+    isStreaming?: boolean | undefined;
+    streamContent?: string | undefined;
+    questions?: {
+    id: string;
+    text: string;
+    value?: string | undefined;
+    category?: string | undefined;
+    priority?: number | undefined;
+    }[] | undefined;
+    welcomeData?: {
+    title: string;
+    subtitle?: string | undefined;
+    icon?: string | undefined;
+    } | undefined;
+    }[]>;
+    get currentMessages(): ComputedRef<    {
+    id: string;
+    type: "ai" | "questions" | "user" | "welcome";
+    content: string;
+    timestamp: Date;
+    status?: "error" | "sending" | "sent" | "streaming" | undefined;
+    error?: string | undefined;
+    isStreaming?: boolean | undefined;
+    streamContent?: string | undefined;
+    questions?: {
+    id: string;
+    text: string;
+    value?: string | undefined;
+    category?: string | undefined;
+    priority?: number | undefined;
+    }[] | undefined;
+    welcomeData?: {
+    title: string;
+    subtitle?: string | undefined;
+    icon?: string | undefined;
+    } | undefined;
+    }[]>;
+    get messageCount(): ComputedRef<number>;
+    get hasMessages(): ComputedRef<boolean>;
+    get lastMessage(): ComputedRef<    {
+    id: string;
+    type: "ai" | "questions" | "user" | "welcome";
+    content: string;
+    timestamp: Date;
+    status?: "error" | "sending" | "sent" | "streaming" | undefined;
+    error?: string | undefined;
+    isStreaming?: boolean | undefined;
+    streamContent?: string | undefined;
+    questions?: {
+    id: string;
+    text: string;
+    value?: string | undefined;
+    category?: string | undefined;
+    priority?: number | undefined;
+    }[] | undefined;
+    welcomeData?: {
+    title: string;
+    subtitle?: string | undefined;
+    icon?: string | undefined;
+    } | undefined;
+    } | undefined>;
+    get userMessages(): ComputedRef<    {
+    id: string;
+    type: "ai" | "questions" | "user" | "welcome";
+    content: string;
+    timestamp: Date;
+    status?: "error" | "sending" | "sent" | "streaming" | undefined;
+    error?: string | undefined;
+    isStreaming?: boolean | undefined;
+    streamContent?: string | undefined;
+    questions?: {
+    id: string;
+    text: string;
+    value?: string | undefined;
+    category?: string | undefined;
+    priority?: number | undefined;
+    }[] | undefined;
+    welcomeData?: {
+    title: string;
+    subtitle?: string | undefined;
+    icon?: string | undefined;
+    } | undefined;
+    }[]>;
+    get aiMessages(): ComputedRef<    {
+    id: string;
+    type: "ai" | "questions" | "user" | "welcome";
+    content: string;
+    timestamp: Date;
+    status?: "error" | "sending" | "sent" | "streaming" | undefined;
+    error?: string | undefined;
+    isStreaming?: boolean | undefined;
+    streamContent?: string | undefined;
+    questions?: {
+    id: string;
+    text: string;
+    value?: string | undefined;
+    category?: string | undefined;
+    priority?: number | undefined;
+    }[] | undefined;
+    welcomeData?: {
+    title: string;
+    subtitle?: string | undefined;
+    icon?: string | undefined;
+    } | undefined;
+    }[]>;
+    get streamingMessages(): ComputedRef<    {
+    id: string;
+    type: "ai" | "questions" | "user" | "welcome";
+    content: string;
+    timestamp: Date;
+    status?: "error" | "sending" | "sent" | "streaming" | undefined;
+    error?: string | undefined;
+    isStreaming?: boolean | undefined;
+    streamContent?: string | undefined;
+    questions?: {
+    id: string;
+    text: string;
+    value?: string | undefined;
+    category?: string | undefined;
+    priority?: number | undefined;
+    }[] | undefined;
+    welcomeData?: {
+    title: string;
+    subtitle?: string | undefined;
+    icon?: string | undefined;
+    } | undefined;
+    }[]>;
+    get errorMessages(): ComputedRef<    {
+    id: string;
+    type: "ai" | "questions" | "user" | "welcome";
+    content: string;
+    timestamp: Date;
+    status?: "error" | "sending" | "sent" | "streaming" | undefined;
+    error?: string | undefined;
+    isStreaming?: boolean | undefined;
+    streamContent?: string | undefined;
+    questions?: {
+    id: string;
+    text: string;
+    value?: string | undefined;
+    category?: string | undefined;
+    priority?: number | undefined;
+    }[] | undefined;
+    welcomeData?: {
+    title: string;
+    subtitle?: string | undefined;
+    icon?: string | undefined;
+    } | undefined;
+    }[]>;
+    get suggestedQuestions(): ComputedRef<    {
+    id: string;
+    text: string;
+    value?: string | undefined;
+    category?: string | undefined;
+    priority?: number | undefined;
+    }[]>;
+    get hasQuestions(): ComputedRef<boolean>;
+    addMessage(message: Omit<ChatMessage, 'id' | 'timestamp'>): ChatMessage;
+    updateMessage(messageId: string, updates: Partial<ChatMessage>): boolean;
+    removeMessage(messageId: string): boolean;
+    getMessage(messageId: string): ChatMessage | undefined;
+    setMessageStatus(messageId: string, status: ChatMessage['status']): boolean;
+    setMessageStreaming(messageId: string, isStreaming: boolean): boolean;
+    setMessageError(messageId: string, error: string): boolean;
+    updateStreamingContent(messageId: string, content: string): boolean;
+    addMessages(messages: Omit<ChatMessage, 'id' | 'timestamp'>[]): ChatMessage[];
+    clearMessages(): void;
+    setQuestions(questions: QuestionItem[]): void;
+    addQuestion(question: QuestionItem): void;
+    clearQuestions(): void;
+    removeQuestion(questionId: string): boolean;
+    removeMessages(messageIds: string[]): number;
+    filterMessages(predicate: (message: ChatMessage) => boolean): ChatMessage[];
+    searchMessages(query: string): ChatMessage[];
+    getMessagesByType(type: ChatMessage['type']): ChatMessage[];
+    getMessagesByStatus(status: ChatMessage['status']): ChatMessage[];
+    createSession(): string;
+    switchSession(sessionId: string): boolean;
+    deleteSession(sessionId: string): boolean;
+    getSession(sessionId: string): ChatSession | undefined;
+    getAllSessions(): ChatSession[];
+    private saveHistory;
+    private loadHistory;
+    exportHistory(): string;
+    importHistory(historyData: string): boolean;
+    getStats(): {
+        totalMessages: number;
+        userMessages: number;
+        aiMessages: number;
+        errorMessages: number;
+        streamingMessages: number;
+        sessions: number;
+        averageMessagesPerSession: number;
+    };
+    cleanup(olderThanDays?: number): number;
+    private generateMessageId;
+    private generateSessionId;
+    destroy(): void;
+}
+
+export declare const messageStore: MessageStore;
+
+declare class OpenAIClient {
+    private client;
+    private config;
+    constructor(config: OpenAIConfig);
+    chatCompletionStream(request: ChatRequest): AsyncGenerator<StreamingChatResponse, void, unknown>;
+    destroy(): void;
+    getConfig(): OpenAIConfig;
+    listModels(): Promise<any[]>;
+    testConnection(): Promise<boolean>;
+    updateConfig(config: Partial<OpenAIConfig>): void;
+    private handleError;
+}
+
+export declare interface OpenAIConfig {
+    apiKey: string;
+    baseUrl?: string;
+    organization?: string;
+    timeout?: number;
+    maxRetries?: number;
+    enableStreaming?: boolean;
+}
+
+export declare interface QuestionItem {
+    id: string;
+    text: string;
+    value?: string;
+    category?: string;
+    priority?: number;
+}
+
+export declare interface QuestionsConfig {
+    enabled?: boolean;
+    items?: QuestionItem[];
+    maxItems?: number;
+    showCategories?: boolean;
+    autoSuggest?: boolean;
+}
+
+export declare type RequiredFields<T, K extends keyof T> = Required<Pick<T, K>> & T;
+
+export declare interface StreamingChatResponse {
+    id: string;
+    object: string;
+    created: number;
+    model: string;
+    choices: Array<{
+        delta: {
+            content?: string;
+            role?: string;
+        };
+        finishReason?: string;
+        index: number;
+    }>;
+}
+
+export declare interface ThemeConfig {
+    mode?: 'auto' | 'dark' | 'light';
+    primaryColor?: string;
+    backgroundColor?: string;
+    textColor?: string;
+    borderRadius?: string;
+    shadow?: string;
+    customCSS?: string;
+}
+
+declare interface ThemeConfig_2 {
+    mode: ThemeMode;
+    primaryColor: string;
+    backgroundColor: string;
+    textColor: string;
+    borderRadius: string;
+    shadow: string;
+    customCSS?: string;
+}
+
+declare class ThemeManager {
+    private currentTheme;
+    private themeMode;
+    private customThemes;
+    private styleElement;
+    constructor(initialTheme?: Partial<ThemeConfig_2>);
+    private initializeTheme;
+    private setupThemeWatcher;
+    private createStyleElement;
+    private applyTheme;
+    private generateCSSVariables;
+    private getSystemTheme;
+    private loadThemeFromStorage;
+    private saveThemeToStorage;
+    getCurrentTheme(): ThemeConfig_2;
+    setTheme(theme: Partial<ThemeConfig_2>): void;
+    setThemeMode(mode: ThemeMode): void;
+    applyPresetTheme(themeName: string): void;
+    addCustomTheme(name: string, theme: ThemeConfig_2): void;
+    getCustomTheme(name: string): ThemeConfig_2 | null;
+    getAvailableThemes(): string[];
+    getThemeMode(): ThemeMode;
+    isDarkMode(): boolean;
+    getCSSVariables(): Record<string, string>;
+    exportTheme(): string;
+    importTheme(themeData: string): boolean;
+    resetToDefault(): void;
+    destroy(): void;
+}
+
+export declare const themeManager: ThemeManager;
+
+declare type ThemeMode = 'light' | 'dark' | 'auto';
+
+export declare function validateApiKey(apiKey: string): boolean;
+
+export declare function validateBaseUrl(baseUrl: string): boolean;
+
+export declare const VuePlugin: {
+    install: (app: App) => void;
+};
+
+export declare interface WelcomeConfig {
+    enabled?: boolean;
+    title?: string;
+    subtitle?: string;
+    backgroundColor?: string;
+    textColor?: string;
+}
+
+export declare interface WelcomeData {
+    title: string;
+    subtitle?: string;
+    icon?: string;
+}
+
+export { }