Files
ai-agent/web/lib/stores/kefu-chat.ts
T
mlogclub fbabb174d2 feat: add WeChat MP channel support and enhance widget configuration
- Updated output path for generated enums to reflect new structure.
- Enhanced ChannelController to handle WeChat MP OAuth authorization and callback.
- Introduced WechatMPChannelConfig DTO for WeChat MP specific configurations.
- Modified WidgetConfigResponse to include channel type and external source.
- Added enums for WeChat MP channel type and external source.
- Implemented OAuth flow for WeChat MP, including state signing and verification.
- Updated frontend forms to accommodate WeChat MP configurations.
- Enhanced API interactions to support WeChat MP external ID and source.
- Updated generated enums to include WeChat MP external source.
2026-04-27 15:42:04 +08:00

623 lines
17 KiB
TypeScript

"use client"
import { create } from "zustand"
import {
closeImConversation,
createOrMatchImConversation,
fetchImMessages,
fetchImWidgetConfig,
markImMessageRead,
sendImMessage,
uploadImAttachment,
uploadImImage,
type ImAsset,
type ImConversation,
type ImMessage,
type ImWidgetConfig,
} from "@/lib/api/im"
import {
createImRealtimeConnection,
type ImRealtimeEnvelope,
} from "@/lib/im-realtime"
import {
cursorFromLoadedImMessages,
hasMoreAfterLatestImMessageMerge,
mergeImMessagesByIdAsc,
parseImMessageCursorId,
} from "@/lib/im-message-merge"
import {
markMessagesReadToSeqNo,
normalizeRealtimeMessage,
patchConversation,
patchConversationWithMessage,
} from "@/lib/im-realtime-state"
import { summarizeIMMessage } from "@/lib/im-message"
import { createRealtimeConnectionManager } from "@/lib/realtime-connection"
import { generateUUID } from "@/lib/utils"
import { readKefuWidgetConfig, setKefuWidgetConfig } from "@/lib/kefu-widget-config"
type ChatStatus = "connecting" | "connected" | "disconnected"
const DEFAULT_PAGE_LIMIT = 50
function getNotificationBody(message: ImMessage): string {
return summarizeIMMessage(message)
}
function showNotification(title: string, body: string, onClick?: () => void) {
if (typeof window === "undefined" || !("Notification" in window)) {
return
}
const create = () => {
const notification = new Notification(title, { body })
notification.onclick = () => {
window.focus()
onClick?.()
notification.close()
}
}
if (Notification.permission === "granted") {
create()
return
}
if (Notification.permission === "default") {
void Notification.requestPermission().then((permission) => {
if (permission === "granted") {
create()
}
})
}
}
function ensureMessageList(value: ImMessage[] | null | undefined): ImMessage[] {
return Array.isArray(value) ? value : []
}
function markConversationReadMessages(
messages: ImMessage[],
payload: ImRealtimeEnvelope["data"] | ImRealtimeEnvelope["payload"]
) {
let next = messages
if ((payload?.agentLastReadSeqNo ?? 0) > 0) {
next = markMessagesReadToSeqNo(
next,
payload?.agentLastReadSeqNo ?? 0,
"agent",
payload?.agentLastReadAt
)
}
if ((payload?.customerLastReadSeqNo ?? 0) > 0) {
next = markMessagesReadToSeqNo(
next,
payload?.customerLastReadSeqNo ?? 0,
"customer",
payload?.customerLastReadAt
)
}
return next
}
export type KefuChatStore = {
title: string
subtitle: string
themeColor: string
conversation: ImConversation | null
messages: ImMessage[]
messagesCursor: string
messagesHasMore: boolean
messagesLoadingMore: boolean
initialized: boolean
status: ChatStatus
error: string
sending: boolean
uploadingAsset: boolean
closingConversation: boolean
isOpen: boolean
isVisible: boolean
socket: WebSocket | null
readingMessageId: number
setIsOpen: (isOpen: boolean) => void
setIsVisible: (isVisible: boolean) => void
bootstrap: () => void
disconnectSocket: () => void
refreshMessages: () => Promise<void>
syncLatestMessages: () => Promise<void>
loadOlderMessages: () => Promise<void>
markConversationRead: () => Promise<void>
handleSendMessage: (content: string) => Promise<void>
sendMessage: (content: string) => Promise<void>
uploadMessageImage: (file: File) => Promise<ImAsset | null>
sendAttachment: (file: File) => Promise<void>
closeConversation: () => Promise<void>
retry: () => Promise<void>
}
let bootstrapToken = 0
export const useKefuChatStore = create<KefuChatStore>((set, get) => {
const realtime = createRealtimeConnectionManager({
createSocket: createImRealtimeConnection,
canReconnect: () => Boolean(get().isOpen && get().conversation?.id),
onStatusChange: (status) => {
if (get().isOpen || status === "disconnected") {
set({ status })
}
},
onSocketChange: (socket) => {
set({ socket })
},
onMessage: (messageEvent) => {
let event: ImRealtimeEnvelope
try {
event = JSON.parse(messageEvent.data) as ImRealtimeEnvelope
} catch {
return
}
const conversationId = get().conversation?.id
if (!conversationId) {
return
}
const payload = event.data ?? event.payload
if (event.type === "resyncRequired") {
void get().refreshMessages()
return
}
if (payload?.conversationId !== conversationId) {
return
}
if (event.type === "message.created") {
const message = normalizeRealtimeMessage<ImMessage>(payload)
if (!message) {
void get().syncLatestMessages()
return
}
set((state) => ({
messages: mergeImMessagesByIdAsc(state.messages, [message]),
conversation: patchConversationWithMessage(state.conversation, message),
}))
if (
message.senderType !== "customer" &&
typeof document !== "undefined" &&
document.visibilityState !== "visible"
) {
const state = get()
showNotification("新消息", getNotificationBody(message), () => {
state.setIsOpen(true)
state.setIsVisible(true)
})
}
return
}
if (event.type?.startsWith("conversation.")) {
set((state) => ({
conversation: patchConversation(state.conversation, payload),
messages: markConversationReadMessages(state.messages, payload),
}))
}
},
})
const closeSocket = (options?: { reconnect?: boolean }) => {
realtime.disconnect({
reconnect: options?.reconnect ?? false,
updateStatus: true,
})
}
const connectSocket = () => {
if (!get().conversation?.id) {
return
}
realtime.connect()
}
return {
title: "在线客服",
subtitle: "",
themeColor: "#2563eb",
conversation: null,
messages: [],
messagesCursor: "",
messagesHasMore: false,
messagesLoadingMore: false,
initialized: false,
status: "connecting",
error: "",
sending: false,
uploadingAsset: false,
closingConversation: false,
isOpen: typeof window !== "undefined" ? window.self === window.top : false,
isVisible:
typeof window !== "undefined" ? window.self === window.top : false,
socket: null,
readingMessageId: 0,
setIsOpen: (isOpen: boolean) => {
set({ isOpen })
},
setIsVisible: (isVisible: boolean) => {
set({ isVisible })
},
bootstrap: () => {
const token = ++bootstrapToken
if (!get().isOpen) {
closeSocket({ reconnect: false })
set({ status: "disconnected" })
return
}
const activateChat = async () => {
try {
set({ error: "", status: "connecting" })
const widgetConfig: ImWidgetConfig = await fetchImWidgetConfig().catch(
() => ({})
)
if (bootstrapToken !== token || !get().isOpen) {
return
}
if (widgetConfig.channelId || widgetConfig.externalSource) {
setKefuWidgetConfig({
...readKefuWidgetConfig(),
channelId: widgetConfig.channelId || readKefuWidgetConfig().channelId,
externalSource:
widgetConfig.externalSource || readKefuWidgetConfig().externalSource,
})
}
set({
title: widgetConfig.title || "在线客服",
subtitle: widgetConfig.subtitle || "",
themeColor: widgetConfig.themeColor || "#2563eb",
})
let currentConversation = get().conversation
if (!get().initialized || !currentConversation) {
currentConversation = await createOrMatchImConversation()
if (bootstrapToken !== token || !get().isOpen) {
return
}
set({ initialized: true, conversation: currentConversation })
}
await get().refreshMessages()
if (bootstrapToken !== token || !get().isOpen) {
return
}
connectSocket()
} catch (error) {
if (bootstrapToken !== token || !get().isOpen) {
return
}
set({
status: "disconnected",
error: error instanceof Error ? error.message : "初始化失败",
})
}
}
void activateChat()
},
disconnectSocket: () => {
closeSocket({ reconnect: false })
},
refreshMessages: async () => {
const conversationId = get().conversation?.id
if (!conversationId) {
return
}
try {
const page = await fetchImMessages({
conversationId,
limit: DEFAULT_PAGE_LIMIT,
})
const results = ensureMessageList(page.results)
set({
messages: results,
messagesCursor: cursorFromLoadedImMessages(results) || page.cursor || "",
messagesHasMore: Boolean(page.hasMore) || results.length >= DEFAULT_PAGE_LIMIT,
})
} catch (error) {
set({
error: error instanceof Error ? error.message : "加载消息失败",
})
throw error
}
},
syncLatestMessages: async () => {
const conversationId = get().conversation?.id
if (!conversationId) {
return
}
try {
const page = await fetchImMessages({
conversationId,
limit: DEFAULT_PAGE_LIMIT,
})
const batch = ensureMessageList(page.results)
if (batch.length === 0) {
return
}
set((state) => {
const merged = mergeImMessagesByIdAsc(state.messages, batch)
return {
messages: merged,
messagesCursor: cursorFromLoadedImMessages(merged) || page.cursor || "",
messagesHasMore: hasMoreAfterLatestImMessageMerge({
previousMessages: state.messages,
previousHasMore: state.messagesHasMore,
merged,
apiHasMore: Boolean(page.hasMore) || batch.length >= DEFAULT_PAGE_LIMIT,
}),
}
})
} catch (error) {
set({
error: error instanceof Error ? error.message : "同步消息失败",
})
}
},
loadOlderMessages: async () => {
const conversationId = get().conversation?.id
if (
!conversationId ||
get().messagesLoadingMore ||
!get().messagesHasMore
) {
return
}
const cursorId = parseImMessageCursorId(get().messagesCursor)
if (cursorId <= 0) {
return
}
set({ messagesLoadingMore: true })
try {
const page = await fetchImMessages({
conversationId,
cursor: cursorId,
limit: DEFAULT_PAGE_LIMIT,
})
const results = ensureMessageList(page.results)
set((state) => {
const merged = mergeImMessagesByIdAsc(
ensureMessageList(state.messages),
results
)
return {
messages: merged,
messagesCursor: cursorFromLoadedImMessages(merged) || page.cursor || "",
messagesHasMore: Boolean(page.hasMore) || results.length >= DEFAULT_PAGE_LIMIT,
messagesLoadingMore: false,
}
})
} catch (error) {
set({
messagesLoadingMore: false,
error: error instanceof Error ? error.message : "加载历史消息失败",
})
throw error
}
},
markConversationRead: async () => {
const state = get()
const conversation = state.conversation
const lastMessage = state.messages.at(-1)
if (!conversation?.id || !lastMessage) {
return
}
if (
conversation.customerUnreadCount <= 0 &&
conversation.customerLastReadMessageId >= lastMessage.id
) {
return
}
if (state.readingMessageId === lastMessage.id) {
return
}
set({ readingMessageId: lastMessage.id })
try {
await markImMessageRead(conversation.id, lastMessage.id)
set((current) => ({
readingMessageId: 0,
messages: current.messages.map((item) => {
if ((item.seqNo ?? 0) > (lastMessage.seqNo ?? 0)) {
return item
}
return item.customerRead ? item : { ...item, customerRead: true }
}),
conversation: current.conversation
? {
...current.conversation,
customerUnreadCount: 0,
customerLastReadMessageId: lastMessage.id,
customerLastReadSeqNo: lastMessage.seqNo,
}
: null,
}))
} catch (error) {
set({ readingMessageId: 0 })
throw error
}
},
handleSendMessage: async (content: string) => {
const conversationId = get().conversation?.id
if (!conversationId) {
return
}
set({ error: "", sending: true })
try {
const nextMessage = await sendImMessage({
conversationId,
messageType: "html",
content,
clientMsgId: `kefu_html_${generateUUID()}`,
})
set((state) => ({
sending: false,
messages: state.messages.some((message) => message.id === nextMessage.id)
? state.messages.map((message) =>
message.id === nextMessage.id ? nextMessage : message
)
: [...state.messages, nextMessage],
conversation: state.conversation
? {
...state.conversation,
customerLastReadMessageId: nextMessage.id,
customerLastReadSeqNo: nextMessage.seqNo,
customerUnreadCount: 0,
lastMessageAt: nextMessage.sentAt,
lastMessageSummary: summarizeIMMessage(nextMessage),
}
: null,
}))
} catch (error) {
set({
sending: false,
error: error instanceof Error ? error.message : "发送消息失败",
})
throw error
}
},
sendMessage: async (content: string) => {
return get().handleSendMessage(content)
},
uploadMessageImage: async (file: File) => {
const conversationId = get().conversation?.id
if (!conversationId) {
return null
}
set({ error: "", uploadingAsset: true })
try {
return await uploadImImage(conversationId, file)
} catch (error) {
set({
error: error instanceof Error ? error.message : "上传图片失败",
})
return null
} finally {
set({ uploadingAsset: false })
}
},
sendAttachment: async (file: File) => {
const conversationId = get().conversation?.id
if (!conversationId) {
return
}
set({ error: "", uploadingAsset: true })
try {
const asset = await uploadImAttachment(conversationId, file)
const nextMessage = await sendImMessage({
conversationId,
messageType: "attachment",
content: asset.filename,
payload: JSON.stringify({ assetId: asset.assetId }),
clientMsgId: `kefu_attachment_${generateUUID()}`,
})
set((state) => ({
uploadingAsset: false,
messages: state.messages.some((message) => message.id === nextMessage.id)
? state.messages.map((message) =>
message.id === nextMessage.id ? nextMessage : message
)
: [...state.messages, nextMessage],
conversation: state.conversation
? {
...state.conversation,
customerLastReadMessageId: nextMessage.id,
customerLastReadSeqNo: nextMessage.seqNo,
customerUnreadCount: 0,
lastMessageAt: nextMessage.sentAt,
lastMessageSummary: summarizeIMMessage(nextMessage),
}
: null,
}))
} catch (error) {
set({
uploadingAsset: false,
error: error instanceof Error ? error.message : "发送附件失败",
})
throw error
}
},
closeConversation: async () => {
const conversationId = get().conversation?.id
if (!conversationId) {
return
}
set({ error: "", closingConversation: true })
try {
await closeImConversation(conversationId)
closeSocket({ reconnect: false })
set((state) => ({
closingConversation: false,
status: "disconnected",
conversation: state.conversation
? {
...state.conversation,
status: 2,
}
: null,
}))
} catch (error) {
set({
closingConversation: false,
error: error instanceof Error ? error.message : "关闭会话失败",
})
throw error
}
},
retry: async () => {
if (!get().conversation?.id) {
return
}
set({ error: "", status: "connecting" })
try {
await get().refreshMessages()
if (get().isOpen) {
connectSocket()
}
} catch (error) {
set({
status: "disconnected",
error: error instanceof Error ? error.message : "刷新失败",
})
}
},
}
})