langchat-widget 0.1.0 → 0.2.0

package/README.md

@@ -0,0 +1,11 @@
+# LangChat Widget
+
+## Development
+
+```shell
+pnpm install
+
+pnpm build
+```
+
+npx vite-bundle-analyzer dist/langchat-widget.umd.js

package/dist/index.d.ts

@@ -35,6 +35,8 @@ export declare interface ChatRequest {
     temperature?: number;
     maxTokens?: number;
     stream?: boolean;
+    conversationId?: string;
+    chatId?: string;
 }
 
 export declare interface ChatResponse {
@@ -80,6 +82,9 @@ export declare function createMessageStore(options?: {
     enableHistory?: boolean;
 }): MessageStore;
 
+/**
+ * 创建OpenAI客户端实例
+ */
 export declare function createOpenAIClient(config: OpenAIConfig): OpenAIClient;
 
 export declare function createThemeManager(initialTheme?: Partial<ThemeConfig_2>): ThemeManager;
@@ -95,21 +100,69 @@ declare class ErrorHandler {
     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;
 }
 
@@ -170,6 +223,7 @@ declare class LangChatBot implements LangChatInstance {
     private app;
     private config;
     private container;
+    private currentAbortController;
     private eventListeners;
     private isInitialized;
     private messages;
@@ -177,38 +231,144 @@ declare class LangChatBot implements LangChatInstance {
     private streamingMessageId;
     private suggestedQuestions;
     private welcomeData;
+    private conversationService;
+    private conversations;
+    private currentConversationId;
+    private isContextAvailable;
     constructor(config: LangChatConfig);
+    /**
+     * 中断当前请求
+     */
+    abortCurrentRequest(): void;
+    /**
+     * 清空历史记录
+     */
     clearHistory(): void;
+    /**
+     * 关闭聊天窗口
+     */
     close(): void;
+    /**
+     * 销毁聊天组件
+     */
     destroy(): void;
+    /**
+     * 获取当前配置
+     */
     getConfig(): LangChatConfig;
+    /**
+     * 获取历史记录
+     */
     getHistory(): ChatMessage[];
+    /**
+     * 获取建议问题
+     */
     getSuggestedQuestions(context?: string): Promise<QuestionItem[]>;
-    init(): void;
+    /**
+     * 初始化聊天组件
+     */
+    init(): Promise<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;
+    /**
+     * 创建DOM容器
+     */
     private createContainer;
+    /**
+     * 创建Vue应用
+     */
     private createVueApp;
+    /**
+     * 触发事件
+     */
     private emit;
+    /**
+     * 生成唯一ID
+     */
     private generateId;
+    /**
+     * 初始化OpenAI客户端
+     */
     private initializeOpenAIClient;
+    /**
+     * 初始化主题管理器
+     */
     private initializeThemeManager;
+    /**
+     * 初始化欢迎语和问题建议
+     */
     private initializeWelcomeAndQuestions;
+    /**
+     * 合并配置
+     */
     private mergeConfig;
+    /**
+     * 保存到历史记录
+     */
     private saveToHistory;
+    /**
+     * 开始流式回复
+     */
     private startStreamingReply;
+    /**
+     * 更新容器位置
+     */
     private updateContainerPosition;
+    /**
+     * 更新OpenAI客户端配置
+     */
     private updateOpenAIClient;
+    /**
+     * 更新问题建议
+     */
     private updateSuggestedQuestions;
+    /**
+     * 验证配置
+     */
     private validateConfig;
+    private initializeContext;
+    private mapAndSetMessages;
+    private createConversation;
+    private deleteConversation;
+    private selectConversation;
 }
 export { LangChatBot }
 export default LangChatBot;
@@ -228,6 +388,8 @@ export declare interface LangChatConfig {
     autoOpen?: boolean;
     position?: 'bottom-left' | 'bottom-right' | 'top-left' | 'top-right';
     zIndex?: number;
+    buttonOffset?: string;
+    buttonClassName?: string;
     enableMarkdown?: boolean;
     enableHistory?: boolean;
     maxHistoryItems?: number;
@@ -245,7 +407,7 @@ export declare interface LangChatConfig {
 export declare type LangChatEvent = 'close' | 'config-updated' | 'error' | 'init' | 'message-received' | 'message-sent' | 'open' | 'questions-updated' | 'streaming-update';
 
 export declare interface LangChatInstance {
-    init(): void;
+    init(): Promise<void>;
     destroy(): void;
     open(): void;
     close(): void;
@@ -359,7 +521,7 @@ declare class MessageStore {
     subtitle?: string | undefined;
     icon?: string | undefined;
     } | undefined;
-    } | undefined>;
+    }>;
     get userMessages(): ComputedRef<    {
     id: string;
     type: "ai" | "questions" | "user" | "welcome";
@@ -505,12 +667,33 @@ declare class OpenAIClient {
     private client;
     private config;
     constructor(config: OpenAIConfig);
+    /**
+     * 流式聊天（主要方法）
+     */
     chatCompletionStream(request: ChatRequest): AsyncGenerator<StreamingChatResponse, void, unknown>;
+    /**
+     * 清理资源
+     */
     destroy(): void;
+    /**
+     * 获取当前配置
+     */
     getConfig(): OpenAIConfig;
+    /**
+     * 获取模型列表
+     */
     listModels(): Promise<any[]>;
+    /**
+     * 测试API连接
+     */
     testConnection(): Promise<boolean>;
+    /**
+     * 更新配置
+     */
     updateConfig(config: Partial<OpenAIConfig>): void;
+    /**
+     * 错误处理
+     */
     private handleError;
 }
 
@@ -582,27 +765,93 @@ declare class ThemeManager {
     private customThemes;
     private styleElement;
     constructor(initialTheme?: Partial<ThemeConfig_2>);
+    /**
+     * 初始化主题
+     */
     private initializeTheme;
+    /**
+     * 设置主题监听器
+     */
     private setupThemeWatcher;
+    /**
+     * 创建样式元素
+     */
     private createStyleElement;
+    /**
+     * 应用主题
+     */
     private applyTheme;
+    /**
+     * 生成CSS变量
+     */
     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;
+    /**
+     * 获取主题CSS变量
+     */
     getCSSVariables(): Record<string, string>;
+    /**
+     * 导出主题配置
+     */
     exportTheme(): string;
+    /**
+     * 导入主题配置
+     */
     importTheme(themeData: string): boolean;
+    /**
+     * 重置为默认主题
+     */
     resetToDefault(): void;
+    /**
+     * 销毁主题管理器
+     */
     destroy(): void;
 }
 
@@ -610,8 +859,14 @@ export declare const themeManager: ThemeManager;
 
 declare type ThemeMode = 'light' | 'dark' | 'auto';
 
+/**
+ * 验证API密钥格式
+ */
 export declare function validateApiKey(apiKey: string): boolean;
 
+/**
+ * 验证baseUrl格式
+ */
 export declare function validateBaseUrl(baseUrl: string): boolean;
 
 export declare const VuePlugin: {