customer-chat-sdk 1.4.2 → 1.4.4

package/dist/customer-sdk.cjs.js

@@ -29354,7 +29354,7 @@ function requireBlowfish () {
 
 var cryptoJsExports = cryptoJs.exports;
 
-class CustomerSDK {
+let CustomerSDK$1 = class CustomerSDK {
     constructor() {
         this.iconManager = null;
         this.screenshotManager = null;
@@ -29639,631 +29639,158 @@ class CustomerSDK {
             console.log('CustomerSDK destroyed');
         }
     }
-}
+};
 
 /**
- * Customer SDK 主类
- * 只负责悬浮图标和iframe管理，不处理WebSocket连接
- * 所有聊天逻辑都在iframe中处理
+ * 全局 CustomerSDK 单例实例
  */
-class CustomerServiceSDK {
-    constructor() {
-        this.iconManager = null;
-        this.screenshotManager = null;
-        this.config = null;
-        this.isInitialized = false;
-        this.isInitializing = false; // 初始化锁，防止并发初始化
-        this.initResult = null; // 保存初始化结果
-        this.debug = false; // debug 模式标志
-        this.lastIconConfig = null; // 保存上一次的图标配置
-    }
-    /**
-     * 初始化 SDK
-     * @param config SDK配置
-     * @param options UI选项 或 截图回调（可选）
-     * @param forceReinit 是否强制重新初始化（用于更新token等配置）
-     * @returns 返回初始化信息（包含设备ID等）
-     */
-    async init(config, options, forceReinit = false) {
-        // 防止并发初始化
-        if (this.isInitializing) {
-            throw new Error('SDK is already initializing. Please wait for the current initialization to complete.');
-        }
-        // 如果已经初始化且不强制重新初始化，返回之前保存的初始化信息
-        if (this.isInitialized && !forceReinit) {
-            if (this.debug) {
-                console.warn('CustomerSDK already initialized, returning cached result. Use forceReinit=true to reinitialize.');
-            }
-            if (this.initResult) {
-                return this.initResult;
-            }
-            throw new Error('SDK already initialized but cannot retrieve initialization info');
-        }
-        // 设置初始化锁
-        this.isInitializing = true;
-        // 如果需要强制重新初始化，先清理旧资源
-        if (this.isInitialized && forceReinit) {
-            if (this.debug) {
-                console.log('Force reinitializing SDK...');
-            }
-            // 清理旧的截图管理器
-            this.screenshotManager?.destroy();
-            this.screenshotManager = null;
-            // 注意：图标管理器暂时保留，稍后检查配置是否变化再决定是否重新创建
-            // 重置初始化标志
-            this.isInitialized = false;
-        }
-        this.config = config;
-        this.debug = config.debug ?? false;
-        try {
-            // 获取设备指纹ID
-            const rawDeviceId = await this.getDeviceId();
-            if (this.debug) {
-                console.log('Raw Device ID:', rawDeviceId);
-            }
-            // 计算返回给前端的 deviceId：md5(deviceId + getReferrer())
-            const referrer = this.getReferrer(config);
-            const deviceId = cryptoJsExports.MD5(rawDeviceId + referrer).toString();
-            if (this.debug) {
-                console.log('Raw Device ID:', rawDeviceId);
-                console.log('MD5 Device ID (for frontend):', deviceId);
-                console.log('Referrer used:', referrer);
-            }
-            // 准备返回的初始化信息（返回给前端的是 md5 后的 deviceId）
-            const initResult = {
-                deviceId,
-                referrer,
-                agent: config.agent,
-                timestamp: Date.now()
-            };
-            // 处理图标管理器（优化：如果配置没变化，保留图标避免闪烁）
-            // target 和 iconPosition 只从 config 读取
-            const iconPosition = config.iconPosition ?? this.lastIconConfig?.position;
-            const iconTarget = config.target ?? this.lastIconConfig?.target;
-            // 检查图标配置是否变化
-            const iconConfigChanged = this.isIconConfigChanged(iconPosition, iconTarget);
-            if (iconConfigChanged) {
-                // 配置变化了，需要重新创建图标管理器
-                if (this.iconManager) {
-                    this.iconManager.hide();
-                    this.iconManager = null; // 先清空引用，避免引用混乱
-                    if (this.debug) {
-                        console.log('Icon config changed, recreating icon manager');
-                    }
-                }
-                this.iconManager = new IconManager(iconPosition, this.debug, iconTarget, {
-                    sideAttach: config.sideAttach ?? true,
-                    sideHideRatio: config.sideHideRatio ?? 0.5,
-                    magnetic: config.magnetic ?? true,
-                    magneticDirection: config.magneticDirection ?? 'x',
-                    margin: config.margin ?? 10,
-                    autoAttachDelay: config.autoAttachDelay ?? 3000
-                });
-                await this.iconManager.show();
-                // 保存新的配置
-                this.lastIconConfig = { position: iconPosition, target: iconTarget };
-            }
-            else {
-                // 配置没变化，保留图标管理器（避免闪烁）
-                if (!this.iconManager) {
-                    // 如果不存在，创建新的
-                    this.iconManager = new IconManager(iconPosition, this.debug, iconTarget, {
-                        sideAttach: config.sideAttach ?? true,
-                        sideHideRatio: config.sideHideRatio ?? 0.5,
-                        magnetic: config.magnetic ?? true,
-                        magneticDirection: config.magneticDirection ?? 'x',
-                        margin: config.margin ?? 10,
-                        autoAttachDelay: config.autoAttachDelay ?? 3000
-                    });
-                    await this.iconManager.show();
-                }
-                else {
-                    // 已存在，确保显示（可能被隐藏了）
-                    await this.iconManager.show();
-                    if (this.debug) {
-                        console.log('Icon config unchanged, keeping existing icon manager');
-                    }
-                }
-                // 更新配置记录
-                this.lastIconConfig = { position: iconPosition, target: iconTarget };
-            }
-            // 设置点击事件：图标点击回调（由外部处理）
-            this.iconManager.onClick(() => {
-                // 图标点击事件由外部处理（例如打开弹窗）
-                // 这里只清除通知
-                this.clearNotification();
-            });
-            // 初始化截图管理器（如果启用了截图功能）
-            if (config.screenshot) {
-                // 默认截图目标为 document.body，可以通过配置自定义
-                const targetElement = document.body;
-                // 传入发送消息到 iframe 的回调函数
-                // 将 debug 配置传递给截图管理器
-                const screenshotOptions = {
-                    ...config.screenshot,
-                    debug: this.debug // 直接传递 debug 标志
-                };
-                // 检查 options 是否包含 sendData 回调（ScreenshotMessageCallback）
-                const sendToExternal = options && 'sendData' in options ? options.sendData : undefined;
-                if (this.debug) {
-                    console.log('[CustomerServiceSDK] 初始化截图管理器:');
-                    console.log('  options:', options ? '存在' : 'null/undefined', options);
-                    console.log('  sendData:', sendToExternal ? '存在' : 'undefined', typeof sendToExternal);
-                }
-                this.screenshotManager = new ScreenshotManager(targetElement, screenshotOptions, sendToExternal);
-                // 自动启用截图功能（用于测试，实际使用时需要通过 iframe 消息启用）
-                this.screenshotManager.enable(true);
-                if (this.debug) {
-                    console.log('CustomerSDK screenshot manager initialized and enabled');
-                }
-            }
-            this.isInitialized = true;
-            // 保存初始化结果，以便后续获取
-            this.initResult = initResult;
-            if (this.debug) {
-                console.log('CustomerSDK initialized successfully (icon + screenshot only)');
-            }
-            // 返回初始化信息
-            return initResult;
-        }
-        catch (error) {
-            // 错误始终输出
-            console.error('Failed to initialize CustomerSDK:', error);
-            // 清理已创建的资源（防止资源泄漏）
-            try {
-                if (this.iconManager) {
-                    this.iconManager.hide();
-                    this.iconManager = null;
-                }
-                if (this.screenshotManager) {
-                    this.screenshotManager.destroy();
-                    this.screenshotManager = null;
-                }
-                this.isInitialized = false;
-                this.initResult = null;
-            }
-            catch (cleanupError) {
-                // 清理过程中的错误不应该影响原始错误的抛出
-                console.error('Error during cleanup after initialization failure:', cleanupError);
-            }
-            throw error;
-        }
-        finally {
-            // 释放初始化锁
-            this.isInitializing = false;
-        }
-    }
-    /**
-     * 显示/隐藏悬浮图标
-     */
-    showIcon() {
-        this.iconManager?.show();
-    }
-    hideIcon() {
-        this.iconManager?.hide();
-    }
-    /**
-     * 设置图标位置
-     */
-    setIconPosition(position) {
-        this.iconManager?.setPosition(position);
-    }
-    /**
-     * 设置图标坐标位置（x, y）
-     */
-    setIconCoordinates(position) {
-        this.iconManager?.setIconPosition(position);
-    }
-    /**
-     * 更新图标样式
-     */
-    setIconStyle(style) {
-        this.iconManager?.setStyle(style);
-    }
-    /**
-     * 设置图标点击回调
-     */
-    onIconClick(callback) {
-        this.iconManager?.onClick(callback);
-    }
-    /**
-     * 获取连接状态
-     * 注意：真正的连接状态保存在iframe中的SSE连接中
-     */
-    getConnectionStatus() {
-        return this.isInitialized;
-    }
-    /**
-     * 显示消息通知
-     */
-    showNotification(badgeCount = 1, options = {}) {
-        if (!this.iconManager) {
-            if (this.debug) {
-                console.warn('SDK not initialized');
-            }
-            return;
-        }
-        this.iconManager.showNotification({
-            badgeCount: typeof badgeCount === 'string' ? 0 : badgeCount,
-            badgeText: typeof badgeCount === 'string' ? badgeCount : '',
-            pulse: options.pulse || false
-        });
-        // 自动隐藏通知
-        if (options.autoHide && options.autoHide > 0) {
-            setTimeout(() => {
-                this.iconManager?.clearNotification();
-            }, options.autoHide);
-        }
-    }
-    /**
-     * 清除消息通知
-     */
-    clearNotification() {
-        this.iconManager?.clearNotification();
-    }
-    /**
-     * 设置截图目标元素
-     */
-    setScreenshotTarget(element) {
-        this.screenshotManager?.setTargetElement(element);
-    }
-    /**
-     * 手动触发截图
-     */
-    async captureScreenshot(force = false) {
-        if (!this.screenshotManager) {
-            if (this.debug) {
-                console.warn('截图功能未启用');
-            }
-            return false;
-        }
-        return await this.screenshotManager.captureOnce(force);
-    }
-    /**
-     * 启用/禁用截图功能
-     */
-    enableScreenshot(enabled) {
-        if (!this.screenshotManager) {
-            if (this.debug) {
-                console.warn('截图管理器未初始化');
-            }
-            return;
-        }
-        this.screenshotManager.enable(enabled);
-        if (this.debug) {
-            console.log(`📸 截图功能已${enabled ? '启用' : '禁用'}`);
-        }
-    }
-    /**
-     * 获取截图状态
-     */
-    getScreenshotState() {
-        return this.screenshotManager?.getState() || null;
-    }
-    /**
-     * 更新截图配置（动态更新，无需重新初始化）
-     * @param options 要更新的配置项（部分更新）
-     */
-    updateScreenshotOptions(options) {
-        if (!this.screenshotManager) {
-            if (this.debug) {
-                console.warn('截图管理器未初始化，无法更新配置');
-            }
-            return;
-        }
-        this.screenshotManager.updateOptions(options);
-        if (this.debug) {
-            console.log('📸 截图配置已更新:', options);
-        }
-    }
-    /**
-     * 触发截图配置（用于弹窗组件场景，替代之前的 iframe postMessage）
-     * @param configJson 截图配置的 JSON 字符串（BinaryConfig 格式）
-     */
-    triggerScreenshotConfig(configJson) {
-        if (!this.screenshotManager) {
-            if (this.debug) {
-                console.warn('[CustomerServiceSDK] ScreenshotManager not initialized');
-            }
-            return;
-        }
-        this.screenshotManager.handleScreenshotConfig(configJson);
-        if (this.debug) {
-            console.log('[CustomerServiceSDK] Screenshot config triggered:', configJson);
-        }
-    }
-    /**
-     * 销毁 SDK
-     */
-    destroy() {
-        this.iconManager?.hide();
-        this.screenshotManager?.destroy();
-        this.iconManager = null;
-        this.screenshotManager = null;
-        this.config = null;
-        this.initResult = null;
-        this.lastIconConfig = null;
-        this.isInitialized = false;
-        if (this.debug) {
-            console.log('CustomerSDK destroyed');
-        }
-    }
-    /**
-     * 获取初始化信息（设备ID等）
-     * 如果已初始化，返回保存的结果；否则返回 null
-     */
-    getInitResult() {
-        return this.initResult;
-    }
-    /**
-     * 生成初始化信息（设备ID等）
-     * 可以在任何时候调用，即使没有初始化也能获取 deviceId 等信息
-     * @param agent 代理商ID（可选，如果不传则从已保存的配置中获取）
-     * @returns 返回初始化信息（包含设备ID等）
-     */
-    async generateInitResult(agent) {
-        // 获取设备指纹ID
-        const rawDeviceId = await this.getDeviceId();
-        // 获取 referrer（优先使用已保存的配置，否则使用当前页面的 referrer）
-        const referrer = this.config?.referrer || this.getReferrer(this.config || {});
-        // 计算返回给前端的 deviceId：md5(deviceId + getReferrer())
-        const deviceId = cryptoJsExports.MD5(rawDeviceId + referrer).toString();
-        // 使用传入的 agent 或已保存的配置中的 agent
-        const finalAgent = agent || this.config?.agent;
-        if (this.debug) {
-            console.log('Generated InitResult:', {
-                deviceId,
-                referrer,
-                agent: finalAgent,
-                timestamp: Date.now()
-            });
-        }
-        return {
-            deviceId,
-            referrer,
-            agent: finalAgent,
-            timestamp: Date.now()
-        };
-    }
-    /**
-     * 获取设备指纹ID
-     */
-    async getDeviceId() {
-        if (this.debug) {
-            console.log('🔍 Starting to get device fingerprint...');
-        }
-        try {
-            if (this.debug) {
-                console.log('📦 Loading FingerprintJS...');
-            }
-            const fp = await index$1.load();
-            if (this.debug) {
-                console.log('🎯 Getting device fingerprint...');
-            }
-            const result = await fp.get();
-            if (this.debug) {
-                console.log('✅ FingerprintJS result:', result);
-                console.log('🆔 Device ID obtained:', result.visitorId);
-            }
-            return result.visitorId;
-        }
-        catch (error) {
-            if (this.debug) {
-                console.warn('❌ Failed to get device fingerprint, using fallback:', error);
-            }
-            const fallbackId = 'device_' + Date.now() + '_' + Math.random().toString(36).substr(2, 9);
-            if (this.debug) {
-                console.log('🆔 Fallback Device ID:', fallbackId);
-            }
-            return fallbackId;
-        }
-    }
-    /**
-     * 检查图标配置是否变化
-     */
-    isIconConfigChanged(newPosition, newTarget) {
-        // 如果没有保存的配置，说明是首次初始化，需要创建
-        if (!this.lastIconConfig) {
-            return true;
-        }
-        // 比较位置配置
-        const positionChanged = JSON.stringify(this.lastIconConfig.position) !== JSON.stringify(newPosition);
-        // 比较 target 配置
-        const oldTarget = this.lastIconConfig.target;
-        let targetChanged = false;
-        if (oldTarget !== newTarget) {
-            // 如果引用不同，进一步检查
-            if (typeof oldTarget === 'string' && typeof newTarget === 'string') {
-                // 都是字符串，比较值
-                targetChanged = oldTarget !== newTarget;
-            }
-            else if (oldTarget instanceof HTMLElement && newTarget instanceof HTMLElement) {
-                // 都是 HTMLElement，比较引用（引用不同就是变化了）
-                targetChanged = true;
-            }
-            else {
-                // 类型不同，肯定是变化了
-                targetChanged = true;
-            }
-        }
-        return positionChanged || targetChanged;
-    }
-    /**
-     * 获取 referrer（统一获取逻辑）
-     */
-    getReferrer(config) {
-        return config.referrer || document.referrer || document.location.href;
-    }
-}
-// 创建全局实例
 let globalSDKInstance = null;
 /**
- * 初始化 Customer SDK
- * @param config SDK配置
- * @param options UI选项 或 截图回调（可选）
- * @param forceReinit 是否强制重新初始化（用于更新token等配置）
- * @returns 返回初始化信息（包含设备ID等）
+ * 获取全局 SDK 实例（懒加载）
  */
-const init = async (config, options, forceReinit = false) => {
+function getSDKInstance() {
     if (!globalSDKInstance) {
-        globalSDKInstance = new CustomerServiceSDK();
+        globalSDKInstance = new CustomerSDK$1();
     }
-    return await globalSDKInstance.init(config, options, forceReinit);
-};
+    return globalSDKInstance;
+}
 /**
- * 获取全局SDK实例
+ * 全局初始化函数
+ * @param config SDK配置
+ * @param screenshotCallback 截图消息回调（可选）
+ * @param initCallback 初始化回调（可选，包含图标点击回调等）
+ * @returns 返回初始化信息（包含设备ID等）
  */
-const getInstance = () => {
-    if (!globalSDKInstance) {
-        throw new Error('SDK not initialized. Call init() first.');
-    }
-    return globalSDKInstance;
+const init = async (config, screenshotCallback, initCallback) => {
+    const sdk = getSDKInstance();
+    return await sdk.init(config, screenshotCallback, initCallback);
 };
 /**
- * 图标控制API
+ * 显示悬浮图标
  */
 const showIcon = () => {
-    const sdk = getInstance();
-    sdk.showIcon();
+    getSDKInstance().showIcon();
 };
+/**
+ * 隐藏悬浮图标
+ */
 const hideIcon = () => {
-    const sdk = getInstance();
-    sdk.hideIcon();
+    getSDKInstance().hideIcon();
 };
+/**
+ * 设置图标位置（预设位置）
+ */
 const setIconPosition = (position) => {
-    const sdk = getInstance();
-    sdk.setIconPosition(position);
+    getSDKInstance().setIconPosition(position);
 };
+/**
+ * 设置图标坐标位置（自定义坐标）
+ */
 const setIconCoordinates = (position) => {
-    const sdk = getInstance();
-    sdk.setIconCoordinates(position);
+    getSDKInstance().setIconCoordinates(position);
 };
+/**
+ * 更新图标样式
+ */
 const setIconStyle = (style) => {
-    const sdk = getInstance();
-    sdk.setIconStyle(style);
+    getSDKInstance().setIconStyle(style);
 };
 /**
  * 设置图标点击回调
  */
 const onIconClick = (callback) => {
-    const sdk = getInstance();
-    sdk.onIconClick(callback);
+    getSDKInstance().onIconClick(callback);
 };
 /**
- * 其他API
+ * 设置图标的 HTML 内容
  */
-const getConnectionStatus = () => {
-    const sdk = getInstance();
-    return sdk.getConnectionStatus();
+const setIconHTML = (html) => {
+    getSDKInstance().setIconHTML(html);
 };
 /**
- * 获取初始化信息（设备ID等）
+ * 设置图标的图片 URL
  */
-const getInitResult = () => {
-    const sdk = getInstance();
-    return sdk.getInitResult();
+const setIconImage = (imageUrl) => {
+    getSDKInstance().setIconImage(imageUrl);
 };
 /**
- * 生成初始化信息（设备ID等）
- * 可以在任何时候调用，即使没有初始化也能获取 deviceId 等信息
- * @param agent 代理商ID（可选，如果不传则从已保存的配置中获取）
- * @returns 返回初始化信息（包含设备ID等）
+ * 显示图标通知（红点）
  */
-const generateInitResult = async (agent) => {
-    const sdk = getInstance();
-    return await sdk.generateInitResult(agent);
+const showNotification = (options) => {
+    getSDKInstance().showNotification(options);
 };
 /**
- * 消息通知API
+ * 清除图标通知
  */
-const showNotification = (badgeCount = 1, options = {}) => {
-    const sdk = getInstance();
-    sdk.showNotification(badgeCount, options);
-};
 const clearNotification = () => {
-    const sdk = getInstance();
-    sdk.clearNotification();
+    getSDKInstance().clearNotification();
 };
+/**
+ * 手动触发截图配置（用于测试）
+ * @param configJson BinaryConfig 的 JSON 字符串
+ */
+const triggerScreenshotConfig = (configJson) => {
+    getSDKInstance().triggerScreenshotConfig(configJson);
+};
+/**
+ * 销毁 SDK（清理所有资源）
+ */
 const destroy = () => {
-    const sdk = getInstance();
-    sdk.destroy();
+    getSDKInstance().destroy();
     globalSDKInstance = null;
 };
 /**
- * 截图相关API
+ * 获取当前设备ID（md5后的）
  */
-const setScreenshotTarget = (element) => {
-    const sdk = getInstance();
-    sdk.setScreenshotTarget(element);
-};
-const captureScreenshot = async (force = false) => {
-    const sdk = getInstance();
-    return await sdk.captureScreenshot(force);
-};
-const enableScreenshot = (enabled) => {
-    const sdk = getInstance();
-    sdk.enableScreenshot(enabled);
-};
-const getScreenshotState = () => {
-    const sdk = getInstance();
-    return sdk.getScreenshotState();
-};
-const updateScreenshotOptions = (options) => {
-    const sdk = getInstance();
-    sdk.updateScreenshotOptions(options);
+const getDeviceId = () => {
+    return getSDKInstance().getDeviceId();
 };
 /**
- * 触发截图配置（用于弹窗组件场景，替代之前的 iframe postMessage）
- * @param configJson 截图配置的 JSON 字符串（BinaryConfig 格式）
+ * 获取 SDK 实例（用于高级用法）
  */
-const triggerScreenshotConfig = (configJson) => {
-    const sdk = getInstance();
-    sdk.triggerScreenshotConfig(configJson);
+const getInstance = () => {
+    return getSDKInstance();
 };
-// 默认导出
+/**
+ * 导出 CustomerSDK 类（用于创建多个实例）
+ */
+const CustomerSDK = CustomerSDK$1;
+/**
+ * 默认导出（兼容旧版用法）
+ */
 var index = {
     init,
-    getInstance,
-    getInitResult,
-    generateInitResult,
     showIcon,
     hideIcon,
     setIconPosition,
     setIconCoordinates,
     setIconStyle,
     onIconClick,
-    getConnectionStatus,
+    setIconHTML,
+    setIconImage,
     showNotification,
     clearNotification,
-    setScreenshotTarget,
-    captureScreenshot,
-    enableScreenshot,
-    getScreenshotState,
-    updateScreenshotOptions,
     triggerScreenshotConfig,
-    destroy
+    destroy,
+    getDeviceId,
+    getInstance,
+    CustomerSDK
 };
 
 exports.CustomerSDK = CustomerSDK;
-exports.CustomerServiceSDK = CustomerServiceSDK;
-exports.captureScreenshot = captureScreenshot;
 exports.clearNotification = clearNotification;
 exports.default = index;
 exports.destroy = destroy;
-exports.enableScreenshot = enableScreenshot;
-exports.generateInitResult = generateInitResult;
-exports.getConnectionStatus = getConnectionStatus;
-exports.getInitResult = getInitResult;
+exports.getDeviceId = getDeviceId;
 exports.getInstance = getInstance;
-exports.getScreenshotState = getScreenshotState;
 exports.hideIcon = hideIcon;
 exports.init = init;
 exports.onIconClick = onIconClick;
 exports.setIconCoordinates = setIconCoordinates;
+exports.setIconHTML = setIconHTML;
+exports.setIconImage = setIconImage;
 exports.setIconPosition = setIconPosition;
 exports.setIconStyle = setIconStyle;
-exports.setScreenshotTarget = setScreenshotTarget;
 exports.showIcon = showIcon;
 exports.showNotification = showNotification;
 exports.triggerScreenshotConfig = triggerScreenshotConfig;
-exports.updateScreenshotOptions = updateScreenshotOptions;