export type KefuWidgetHostConfig = { channelId: string baseUrl: string apiBaseUrl?: string /** 外部访客稳定标识;未传时使用浏览器本地访客 ID */ externalId?: string /** 访客展示名,随请求以 X-External-Name / WS query externalName 传给后端 */ externalName?: string /** 业务系统签发的前台用户 JWT */ userToken?: string title?: string subtitle?: string position?: "left" | "right" themeColor?: string width?: string } declare global { interface Window { CSAgentConfig?: KefuWidgetHostConfig __CS_AGENT_WIDGET_CONFIG__?: KefuWidgetHostConfig __CS_AGENT_WIDGET_STATE__?: unknown } } export function readKefuWidgetConfig(): KefuWidgetHostConfig { if (typeof window === "undefined") { return { channelId: "", baseUrl: "", apiBaseUrl: "", } } const query = new URLSearchParams(window.location.search) const fallback: KefuWidgetHostConfig = { channelId: query.get("channelId") ?? process.env.NEXT_PUBLIC_OPEN_IM_CHANNEL_ID?.trim() ?? "", baseUrl: query.get("baseUrl") ?? process.env.NEXT_PUBLIC_API_BASE_URL?.trim() ?? window.location.origin, apiBaseUrl: query.get("apiBaseUrl") ?? process.env.NEXT_PUBLIC_API_BASE_URL?.trim() ?? undefined, externalId: query.get("externalId") ?? undefined, externalName: query.get("externalName") ?? undefined, userToken: query.get("userToken") ?? undefined, title: query.get("title") ?? undefined, subtitle: query.get("subtitle") ?? undefined, position: (query.get("position") as "left" | "right" | null) ?? undefined, themeColor: query.get("themeColor") ?? undefined, width: query.get("width") ?? undefined, } return window.__CS_AGENT_WIDGET_CONFIG__ ?? window.CSAgentConfig ?? fallback } export function setKefuWidgetConfig(config: KefuWidgetHostConfig) { if (typeof window === "undefined") { return } window.__CS_AGENT_WIDGET_CONFIG__ = config }