You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
74 lines
3.4 KiB
74 lines
3.4 KiB
/**
|
|
* 配置解析模块 - 参数校验 + 默认值填充
|
|
*
|
|
* 参数映射：
|
|
* integrateId → 后端 roleId（客服角色 ID）
|
|
* userId → 后端 accountId（客户账号 ID）
|
|
* chatId → 自动管理（不在用户配置中暴露）
|
|
*/
|
|
import { SDKConfig, ResolvedConfig } from './types';
|
|
import { logger } from './logger';
|
|
|
|
/** 默认悬浮按钮 SVG 图标（客服对话气泡） */
|
|
const DEFAULT_LAUNCHER_ICON = `<svg xmlns="http://www.w3.org/2000/svg" width="28" height="28" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
|
|
<path d="M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2z"/>
|
|
<path d="M8 9h8"/><path d="M8 13h6"/>
|
|
</svg>`;
|
|
|
|
/**
|
|
* 解析并校验用户传入的配置，填充默认值
|
|
*/
|
|
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();
|
|
|
|
// 填充默认值
|
|
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 ?? 380,
|
|
position: raw.position === 'left-bottom' ? 'left-bottom' : 'right-bottom',
|
|
primaryColor: raw.primaryColor || '#4F46E5',
|
|
launcherIcon: raw.launcherIcon || DEFAULT_LAUNCHER_ICON,
|
|
showClear: raw.showClear ?? true,
|
|
showAdminPanel: raw.showAdminPanel ?? false,
|
|
quickReplies: Array.isArray(raw.quickReplies)
|
|
? raw.quickReplies.map(s => String(s).trim()).filter(Boolean)
|
|
: [],
|
|
theme: raw.theme === 'dark' ? 'dark' : 'light',
|
|
showTeaser: raw.showTeaser ?? true,
|
|
teaserText: (typeof raw.teaserText === 'string' && raw.teaserText.trim()) || '',
|
|
streaming: raw.streaming ?? true,
|
|
locale: raw.locale || 'zh-CN',
|
|
debug: raw.debug ?? true,
|
|
chatId: '', // 初始为空，由 chatId 初始化流程填充
|
|
};
|
|
|
|
logger.info(`配置解析完成 integrateId(=roleId)=${config.integrateId} userId(=accountId)=${config.userId || '(未设置)'} requestDomain=${config.requestDomain}`);
|
|
return config;
|
|
}
|