/** * 配置解析模块 - 参数校验 + 默认值填充 * * 参数映射: * integrateId → 后端 roleId(客服角色 ID) * userId → 后端 accountId(客户账号 ID) * chatId → 自动管理(不在用户配置中暴露) */ import { SDKConfig, ResolvedConfig } from './types'; import { logger } from './logger'; /** * 校验是否为合法 CSS 长度值:数字+单位,或 clamp()/calc()/min()/max() 函数。 * 用于 launcherSize 字符串类型的安全透传(非法值回退默认 60)。 */ function isCssLength(value: string): boolean { return /^-?\d*\.?\d+(px|rem|em|vw|vh|vmin|vmax|%|ch|ex|pt|pc|cm|mm|in)$/.test(value) || /^(clamp|calc|min|max)\(/.test(value); } /** * 解析并校验用户传入的配置,填充默认值 */ export function parseConfig(raw: SDKConfig): ResolvedConfig | null { // 校验必传参数:integrateId(对应后端 roleId) if (!raw.integrateId || (typeof raw.integrateId !== 'string' && typeof raw.integrateId !== 'number') || (typeof raw.integrateId === 'string' && raw.integrateId.trim() === '')) { logger.error('integrateId 是必传参数(对应后端 roleId 客服角色 ID),请检查 init() 调用。示例:ChatbotSDK.init({ integrateId: 1, requestDomain: "https://api.example.com" })'); return null; } // 校验必传参数:requestDomain if (!raw.requestDomain || typeof raw.requestDomain !== 'string' || raw.requestDomain.trim() === '') { logger.error('requestDomain 是必传参数,请检查 init() 调用。示例:ChatbotSDK.init({ integrateId: 1, requestDomain: "https://api.example.com" })'); return null; } // 校验 requestDomain 是否为合法 URL 格式 try { new URL(raw.requestDomain); } catch { logger.error(`requestDomain 不是合法的 URL 格式:${raw.requestDomain}。请提供完整的域名,如 https://api.example.com`); return null; } // integrateId 统一转为字符串(后端 roleId 为 Long,但 query param 传字符串也可接收) const integrateIdStr = String(raw.integrateId).trim(); // 解析图标:用户传入优先,否则使用 requestDomain + /sdk/launcher-logo.png const domain = raw.requestDomain.replace(/\/+$/, ''); const resolvedLauncherIcon = raw.launcherIcon || ``; const resolvedPrimaryColor = raw.primaryColor || '#4F46E5'; // 悬浮按钮尺寸:number → px 并 clamp 到 [36, 96];string → 合法 CSS 长度透传,否则回退默认 60 const launcherSize: number | string = typeof raw.launcherSize === 'number' ? Math.min(96, Math.max(36, raw.launcherSize)) : (typeof raw.launcherSize === 'string' && isCssLength(raw.launcherSize.trim()) ? raw.launcherSize.trim() : 80); // 填充默认值 const config: ResolvedConfig = { integrateId: integrateIdStr, requestDomain: raw.requestDomain.replace(/\/+$/, ''), // 去掉末尾斜杠 userId: raw.userId, categoryId: raw.categoryId, showCategorySwitch: raw.showCategorySwitch ?? false, title: raw.title || 'AI 智能助手', width: raw.width ?? 500, height: Math.max(400, raw.height ?? 520), position: raw.position === 'left-bottom' ? 'left-bottom' : 'right-bottom', primaryColor: resolvedPrimaryColor, launcherIcon: resolvedLauncherIcon, launcherSize, showClear: raw.showClear ?? true, quickReplies: Array.isArray(raw.quickReplies) ? raw.quickReplies.map(s => String(s).trim()).filter(Boolean) : [], suggestions: raw.suggestions ?? true, theme: raw.theme === 'dark' ? 'dark' : 'light', showTeaser: raw.showTeaser ?? true, teaserText: (typeof raw.teaserText === 'string' && raw.teaserText.trim()) || '', resizable: raw.resizable ?? true, watermark: (typeof raw.watermark === 'string' && raw.watermark.trim()) || undefined, streaming: raw.streaming ?? true, enableRag: raw.enableRag ?? true, rewriteStrategy: raw.rewriteStrategy || 'REWRITE', locale: raw.locale || 'zh-CN', debug: raw.debug ?? true, sound: raw.sound ?? false, notification: raw.notification ?? false, onError: typeof raw.onError === 'function' ? raw.onError : undefined, onReady: typeof raw.onReady === 'function' ? raw.onReady : undefined, onMessage: typeof raw.onMessage === 'function' ? raw.onMessage : undefined, token: raw.token, roles: raw.roles, disclaimer: raw.disclaimer, // undefined = 从后端拉取,'' = 隐藏,'...' = 直接用 chatId: '', // 初始为空,由 chatId 初始化流程填充 }; logger.info(`配置解析完成 integrateId(=roleId)=${config.integrateId} userId(=accountId)=${config.userId || '(未设置)'} requestDomain=${config.requestDomain}`); return config; }