@anker-in/campaign-ui 0.2.11-beta.2 → 0.2.11-beta.21

package/dist/esm/components/LiveChatWidget/hooks/useChatState.d.ts

@@ -0,0 +1,120 @@
+/**
+ * 聊天状态管理 Hook
+ * 管理消息列表、窗口状态、输入框状态、流式消息累积
+ * 基于 specs/livechat-widget/plan.md 的状态管理策略
+ */
+import type { Message, SSEEvent } from '../types';
+export interface UseChatStateOptions {
+    /**
+     * 初始欢迎消息
+     */
+    welcomeMessage?: string;
+    /**
+     * Shopify 店铺域名
+     */
+    site?: string;
+    /**
+     * 窗口打开回调
+     */
+    onOpen?: () => void;
+    /**
+     * 窗口关闭回调
+     */
+    onClose?: () => void;
+    /**
+     * 消息发送回调
+     */
+    onMessageSend?: (message: string) => void;
+    /**
+     * 错误处理回调
+     */
+    onError?: (error: Error) => void;
+    /**
+     * 商品添加到购物车回调
+     */
+    onAddToCart?: (product: any) => void;
+    /**
+     * 购物车按钮点击回调
+     */
+    onCart?: (cartId: string, checkoutUrl?: string) => void;
+}
+export interface UseChatStateReturn {
+    /**
+     * 消息列表
+     */
+    messages: Message[];
+    /**
+     * 聊天窗口是否打开
+     */
+    isOpen: boolean;
+    /**
+     * 用户 ID
+     */
+    userId: string;
+    /**
+     * 会话 ID
+     */
+    sessionId: string | null;
+    /**
+     * 输入框内容
+     */
+    inputValue: string;
+    /**
+     * 是否正在接收流式消息
+     */
+    isStreaming: boolean;
+    /**
+     * 打开聊天窗口
+     */
+    openChat: () => void;
+    /**
+     * 关闭聊天窗口
+     */
+    closeChat: () => void;
+    /**
+     * 切换聊天窗口状态
+     */
+    toggleChat: () => void;
+    /**
+     * 设置输入框内容
+     */
+    setInputValue: (value: string) => void;
+    /**
+     * 添加消息到列表
+     */
+    addMessage: (message: Message) => void;
+    /**
+     * 批量设置消息列表（用于加载历史）
+     */
+    setMessages: (messages: Message[]) => void;
+    /**
+     * 清空消息列表
+     */
+    clearMessages: () => void;
+    /**
+     * 处理 SSE 事件
+     */
+    handleSSEEvent: (event: SSEEvent) => void;
+    /**
+     * 保存会话 ID
+     */
+    saveSession: (id: string) => void;
+    /**
+     * 清空会话
+     */
+    clearSession: () => void;
+}
+/**
+ * 聊天状态管理 Hook
+ *
+ * 功能：
+ * 1. 管理消息列表（添加、清空、批量设置）
+ * 2. 管理窗口状态（打开、关闭、切换）
+ * 3. 管理输入框状态
+ * 4. 处理 SSE 流式消息事件
+ * 5. 累积流式文本内容
+ *
+ * @param options Hook 配置选项
+ * @returns 状态管理工具对象
+ */
+export declare function useChatState(options?: UseChatStateOptions): UseChatStateReturn;

package/dist/esm/components/LiveChatWidget/hooks/useChatState.js

@@ -0,0 +1,2 @@
+import{useState as f,useCallback as c,useRef as G,useEffect as H}from"react";import{getUserId as J}from"../utils/userId";import{useSession as K}from"./useSession";import{transformProducts as w}from"../utils/productTransformers";import{transformCartData as L}from"../utils/cartTransformers";function ee(T={}){const{welcomeMessage:l,site:y,onOpen:m,onClose:C,onMessageSend:N,onError:_,onAddToCart:E,onCart:b}=T,{sessionId:h,saveSession:v,clearSession:D}=K(),[O,U]=f("");H(()=>{J().then(r=>U(r))},[]);const[A,d]=f(()=>l?[{id:`welcome-${Date.now()}`,role:"assistant",content:[{type:"text",text:l}],timestamp:Date.now()}]:[]),[P,k]=f(!1),[q,R]=f(""),[V,S]=f(!1),t=G(null),$=c(()=>{k(!0),m?.()},[m]),B=c(()=>{k(!1),C?.()},[C]),j=c(()=>{k(r=>{const u=!r;return u?m?.():C?.(),u})},[m,C]),M=c(r=>{d(u=>[...u,r])},[]),z=c(r=>{d(r)},[]),x=c(()=>{d([])},[]),F=c(r=>{const{event:u,data:p}=r;switch(u){case"message_start":{S(!0);const s=p;s.sessionId&&s.sessionId!==h&&v(s.sessionId);const n=`msg-${Date.now()}`;t.current={id:n,role:"assistant",content:[{type:"thinking",data:{status:"thinking"}}],timestamp:Date.now()},d(e=>[...e,t.current]);break}case"content_delta":{const s=p,n=s.delta||s.text||"";if(t.current&&n){t.current.content.some(o=>o.type==="thinking")&&(t.current.content=t.current.content.filter(o=>o.type!=="thinking"));const a=t.current.content[t.current.content.length-1];a&&a.type==="text"?a.text+=n:t.current.content.push({type:"text",text:n}),d(o=>{const i=[...o],g=i.findIndex(I=>I.id===t.current.id);return g>=0?i[g]={...t.current}:i.push({...t.current}),i})}break}case"content_block":{const s=p;if(t.current){const n=s.type||s.data?.type,e=s.data;if(!n||!e){console.warn("[useChatState] Invalid content_block:",s);break}let a;n==="product_list"&&Array.isArray(e)?a={type:"product_list",data:{products:w(e,y),title:void 0,onAddToCart:E}}:n==="product_comparison"&&e.products?a={type:"product_comparison",data:{products:w(e.products,y),dimensions:e.dimensions||{}}}:n==="faq_list"&&e.found!==void 0?a={type:"faq_list",data:e}:n==="quick_replies"&&e.replies?a={type:"quick_replies",data:{replies:e.replies}}:n==="policy"&&e.title&&e.content?a={type:"policy",data:{title:e.title,content:e.content}}:n==="promotion_list"&&e.found!==void 0?a={type:"promotion_list",data:e}:n==="cart"&&e.id!==void 0?a={type:"cart",data:{...L(e),onCart:b}}:a={type:n,data:e},t.current.content.push(a),d(o=>{const i=[...o],g=i.findIndex(I=>I.id===t.current.id);return g>=0?i[g]={...t.current}:i.push({...t.current}),i})}break}case"tool_start":case"tool_end":break;case"message_end":{S(!1),t.current=null;break}case"status":{p.type==="session_expired"&&(x(),D(),l&&M({id:`welcome-${Date.now()}`,role:"assistant",content:[{type:"text",text:l}],timestamp:Date.now()}));break}case"error":{const s=p;S(!1),t.current=null,M({id:`error-${Date.now()}`,role:"system",content:[{type:"error",data:{message:s.message,code:s.code}}],timestamp:Date.now()}),_?.(new Error(s.message));break}case"done":{S(!1),t.current=null;break}default:break}},[l,y,M,x,D,v,h,_,E,b]);return{messages:A,isOpen:P,userId:O,sessionId:h,inputValue:q,isStreaming:V,openChat:$,closeChat:B,toggleChat:j,setInputValue:R,addMessage:M,setMessages:z,clearMessages:x,handleSSEEvent:F,saveSession:v,clearSession:D}}export{ee as useChatState};
+//# sourceMappingURL=useChatState.js.map

package/dist/esm/components/LiveChatWidget/hooks/useChatState.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/components/LiveChatWidget/hooks/useChatState.ts"],
+  "sourcesContent": ["/**\n * \u804A\u5929\u72B6\u6001\u7BA1\u7406 Hook\n * \u7BA1\u7406\u6D88\u606F\u5217\u8868\u3001\u7A97\u53E3\u72B6\u6001\u3001\u8F93\u5165\u6846\u72B6\u6001\u3001\u6D41\u5F0F\u6D88\u606F\u7D2F\u79EF\n * \u57FA\u4E8E specs/livechat-widget/plan.md \u7684\u72B6\u6001\u7BA1\u7406\u7B56\u7565\n */\n\nimport { useState, useCallback, useRef, useEffect } from 'react'\nimport type { Message, MessageContent, SSEEvent, StatusData, ErrorData, MessageStartData, BackendCartData } from '../types'\nimport { getUserId } from '../utils/userId'\nimport { useSession } from './useSession'\nimport { transformProducts } from '../utils/productTransformers'\nimport { transformCartData } from '../utils/cartTransformers'\n\nexport interface UseChatStateOptions {\n  /**\n   * \u521D\u59CB\u6B22\u8FCE\u6D88\u606F\n   */\n  welcomeMessage?: string\n\n  /**\n   * Shopify \u5E97\u94FA\u57DF\u540D\n   */\n  site?: string\n\n  /**\n   * \u7A97\u53E3\u6253\u5F00\u56DE\u8C03\n   */\n  onOpen?: () => void\n\n  /**\n   * \u7A97\u53E3\u5173\u95ED\u56DE\u8C03\n   */\n  onClose?: () => void\n\n  /**\n   * \u6D88\u606F\u53D1\u9001\u56DE\u8C03\n   */\n  onMessageSend?: (message: string) => void\n\n  /**\n   * \u9519\u8BEF\u5904\u7406\u56DE\u8C03\n   */\n  onError?: (error: Error) => void\n\n  /**\n   * \u5546\u54C1\u6DFB\u52A0\u5230\u8D2D\u7269\u8F66\u56DE\u8C03\n   */\n  onAddToCart?: (product: any) => void\n\n  /**\n   * \u8D2D\u7269\u8F66\u6309\u94AE\u70B9\u51FB\u56DE\u8C03\n   */\n  onCart?: (cartId: string, checkoutUrl?: string) => void\n}\n\nexport interface UseChatStateReturn {\n  /**\n   * \u6D88\u606F\u5217\u8868\n   */\n  messages: Message[]\n\n  /**\n   * \u804A\u5929\u7A97\u53E3\u662F\u5426\u6253\u5F00\n   */\n  isOpen: boolean\n\n  /**\n   * \u7528\u6237 ID\n   */\n  userId: string\n\n  /**\n   * \u4F1A\u8BDD ID\n   */\n  sessionId: string | null\n\n  /**\n   * \u8F93\u5165\u6846\u5185\u5BB9\n   */\n  inputValue: string\n\n  /**\n   * \u662F\u5426\u6B63\u5728\u63A5\u6536\u6D41\u5F0F\u6D88\u606F\n   */\n  isStreaming: boolean\n\n  /**\n   * \u6253\u5F00\u804A\u5929\u7A97\u53E3\n   */\n  openChat: () => void\n\n  /**\n   * \u5173\u95ED\u804A\u5929\u7A97\u53E3\n   */\n  closeChat: () => void\n\n  /**\n   * \u5207\u6362\u804A\u5929\u7A97\u53E3\u72B6\u6001\n   */\n  toggleChat: () => void\n\n  /**\n   * \u8BBE\u7F6E\u8F93\u5165\u6846\u5185\u5BB9\n   */\n  setInputValue: (value: string) => void\n\n  /**\n   * \u6DFB\u52A0\u6D88\u606F\u5230\u5217\u8868\n   */\n  addMessage: (message: Message) => void\n\n  /**\n   * \u6279\u91CF\u8BBE\u7F6E\u6D88\u606F\u5217\u8868\uFF08\u7528\u4E8E\u52A0\u8F7D\u5386\u53F2\uFF09\n   */\n  setMessages: (messages: Message[]) => void\n\n  /**\n   * \u6E05\u7A7A\u6D88\u606F\u5217\u8868\n   */\n  clearMessages: () => void\n\n  /**\n   * \u5904\u7406 SSE \u4E8B\u4EF6\n   */\n  handleSSEEvent: (event: SSEEvent) => void\n\n  /**\n   * \u4FDD\u5B58\u4F1A\u8BDD ID\n   */\n  saveSession: (id: string) => void\n\n  /**\n   * \u6E05\u7A7A\u4F1A\u8BDD\n   */\n  clearSession: () => void\n}\n\n/**\n * \u804A\u5929\u72B6\u6001\u7BA1\u7406 Hook\n *\n * \u529F\u80FD\uFF1A\n * 1. \u7BA1\u7406\u6D88\u606F\u5217\u8868\uFF08\u6DFB\u52A0\u3001\u6E05\u7A7A\u3001\u6279\u91CF\u8BBE\u7F6E\uFF09\n * 2. \u7BA1\u7406\u7A97\u53E3\u72B6\u6001\uFF08\u6253\u5F00\u3001\u5173\u95ED\u3001\u5207\u6362\uFF09\n * 3. \u7BA1\u7406\u8F93\u5165\u6846\u72B6\u6001\n * 4. \u5904\u7406 SSE \u6D41\u5F0F\u6D88\u606F\u4E8B\u4EF6\n * 5. \u7D2F\u79EF\u6D41\u5F0F\u6587\u672C\u5185\u5BB9\n *\n * @param options Hook \u914D\u7F6E\u9009\u9879\n * @returns \u72B6\u6001\u7BA1\u7406\u5DE5\u5177\u5BF9\u8C61\n */\nexport function useChatState(options: UseChatStateOptions = {}): UseChatStateReturn {\n  const { welcomeMessage, site, onOpen, onClose, onMessageSend, onError, onAddToCart, onCart } = options\n\n  // \u4F1A\u8BDD\u7BA1\u7406\n  const { sessionId, saveSession, clearSession } = useSession()\n\n  // \u7528\u6237 ID (\u521D\u59CB\u5316\u65F6\u5F02\u6B65\u751F\u6210)\n  const [userId, setUserId] = useState<string>('')\n\n  // \u521D\u59CB\u5316 userId\n  useEffect(() => {\n    getUserId().then(id => setUserId(id))\n  }, [])\n\n  // \u6D88\u606F\u5217\u8868\n  const [messages, setMessagesState] = useState<Message[]>(() => {\n    // \u5982\u679C\u6709\u6B22\u8FCE\u6D88\u606F\uFF0C\u521D\u59CB\u5316\u65F6\u6DFB\u52A0\n    if (welcomeMessage) {\n      return [\n        {\n          id: `welcome-${Date.now()}`,\n          role: 'assistant',\n          content: [{ type: 'text', text: welcomeMessage }],\n          timestamp: Date.now(),\n        },\n      ]\n    }\n    return []\n  })\n\n  // \u804A\u5929\u7A97\u53E3\u662F\u5426\u6253\u5F00\n  const [isOpen, setIsOpen] = useState(false)\n\n  // \u8F93\u5165\u6846\u5185\u5BB9\n  const [inputValue, setInputValue] = useState('')\n\n  // \u662F\u5426\u6B63\u5728\u63A5\u6536\u6D41\u5F0F\u6D88\u606F\n  const [isStreaming, setIsStreaming] = useState(false)\n\n  // \u5F53\u524D\u6B63\u5728\u7D2F\u79EF\u7684\u6D41\u5F0F\u6D88\u606F (\u4E34\u65F6\u5B58\u50A8)\n  const currentMessageRef = useRef<Message | null>(null)\n\n  /**\n   * \u6253\u5F00\u804A\u5929\u7A97\u53E3\n   */\n  const openChat = useCallback(() => {\n    setIsOpen(true)\n    onOpen?.()\n  }, [onOpen])\n\n  /**\n   * \u5173\u95ED\u804A\u5929\u7A97\u53E3\n   */\n  const closeChat = useCallback(() => {\n    setIsOpen(false)\n    onClose?.()\n  }, [onClose])\n\n  /**\n   * \u5207\u6362\u804A\u5929\u7A97\u53E3\u72B6\u6001\n   */\n  const toggleChat = useCallback(() => {\n    setIsOpen(prev => {\n      const newState = !prev\n      if (newState) {\n        onOpen?.()\n      } else {\n        onClose?.()\n      }\n      return newState\n    })\n  }, [onOpen, onClose])\n\n  /**\n   * \u6DFB\u52A0\u6D88\u606F\u5230\u5217\u8868\n   */\n  const addMessage = useCallback((message: Message) => {\n    setMessagesState(prev => [...prev, message])\n  }, [])\n\n  /**\n   * \u6279\u91CF\u8BBE\u7F6E\u6D88\u606F\u5217\u8868\uFF08\u7528\u4E8E\u52A0\u8F7D\u5386\u53F2\uFF09\n   */\n  const setMessages = useCallback((newMessages: Message[]) => {\n    setMessagesState(newMessages)\n  }, [])\n\n  /**\n   * \u6E05\u7A7A\u6D88\u606F\u5217\u8868\n   */\n  const clearMessages = useCallback(() => {\n    setMessagesState([])\n  }, [])\n\n  /**\n   * \u5904\u7406 SSE \u4E8B\u4EF6\n   * \u6839\u636E\u4E8B\u4EF6\u7C7B\u578B\u8FDB\u884C\u4E0D\u540C\u7684\u5904\u7406\n   */\n  const handleSSEEvent = useCallback(\n    (event: SSEEvent) => {\n      const { event: eventType, data } = event\n\n      switch (eventType) {\n        case 'message_start': {\n          // \u5F00\u59CB\u63A5\u6536\u65B0\u6D88\u606F\uFF0C\u663E\u793A\u601D\u8003\u6C14\u6CE1\n          setIsStreaming(true)\n\n          // T039: \u4FDD\u5B58 sessionId\uFF08\u5982\u679C\u540E\u7AEF\u8FD4\u56DE\uFF09\n          const messageStartData = data as MessageStartData\n          if (messageStartData.sessionId && messageStartData.sessionId !== sessionId) {\n            saveSession(messageStartData.sessionId)\n          }\n\n          const messageId = `msg-${Date.now()}`\n          currentMessageRef.current = {\n            id: messageId,\n            role: 'assistant',\n            content: [{ type: 'thinking', data: { status: 'thinking' } }], // \u6DFB\u52A0\u601D\u8003\u72B6\u6001\n            timestamp: Date.now(),\n          }\n\n          // \u7ACB\u5373\u6DFB\u52A0\u5230\u6D88\u606F\u5217\u8868\u4EE5\u663E\u793A\u601D\u8003\u52A8\u753B\n          setMessagesState(prev => [...prev, currentMessageRef.current!])\n          break\n        }\n\n        case 'content_delta': {\n          // \u7D2F\u79EF\u6D41\u5F0F\u6587\u672C\u5185\u5BB9\n          // \u5B9E\u9645 API \u8FD4\u56DE\u7684\u662F {index: 0, delta: \"\u6587\u672C\"} \u800C\u4E0D\u662F {text: \"\u6587\u672C\"}\n          const deltaData = data as any\n          const deltaText = deltaData.delta || deltaData.text || ''\n\n          if (currentMessageRef.current && deltaText) {\n            // \u79FB\u9664\u601D\u8003\u6C14\u6CE1\uFF08\u5982\u679C\u5B58\u5728\uFF09\n            const hasThinking = currentMessageRef.current.content.some(c => c.type === 'thinking')\n            if (hasThinking) {\n              currentMessageRef.current.content = currentMessageRef.current.content.filter(c => c.type !== 'thinking')\n            }\n\n            const lastContent = currentMessageRef.current.content[currentMessageRef.current.content.length - 1] as\n              | MessageContent\n              | undefined\n\n            if (lastContent && lastContent.type === 'text') {\n              // \u8FFD\u52A0\u5230\u73B0\u6709\u6587\u672C\u5757\n              lastContent.text += deltaText\n            } else {\n              // \u521B\u5EFA\u65B0\u6587\u672C\u5757\n              currentMessageRef.current.content.push({\n                type: 'text',\n                text: deltaText,\n              })\n            }\n\n            // \u66F4\u65B0\u6D88\u606F\u5217\u8868\u4EE5\u89E6\u53D1\u6E32\u67D3\n            setMessagesState(prev => {\n              const updated = [...prev]\n              const existingIndex = updated.findIndex(m => m.id === currentMessageRef.current!.id)\n\n              if (existingIndex >= 0) {\n                updated[existingIndex] = { ...currentMessageRef.current! }\n              } else {\n                updated.push({ ...currentMessageRef.current! })\n              }\n\n              return updated\n            })\n          }\n          break\n        }\n\n        case 'content_block': {\n          // \u63A5\u6536\u7ED3\u6784\u5316\u5185\u5BB9\u5757\uFF08\u5546\u54C1\u3001\u653F\u7B56\u7B49\uFF09\n          // API \u8FD4\u56DE\u683C\u5F0F\u53D8\u66F4:\n          // \u65B0\u683C\u5F0F: {index: number, type: string, data: {...}}  <- type \u5728\u5916\u5C42\n          // \u65E7\u683C\u5F0F: {index: number, data: {type: string, ...}}  <- type \u5728 data \u5185\n          const blockData = data as any\n          if (currentMessageRef.current) {\n            // \u83B7\u53D6 type \u548C data\n            // \u4F18\u5148\u4ECE\u5916\u5C42\u83B7\u53D6 type\uFF0C\u517C\u5BB9\u65E7\u683C\u5F0F\u4ECE data \u5185\u83B7\u53D6\n            const contentType = blockData.type || blockData.data?.type\n            const contentData = blockData.data\n\n            if (!contentType || !contentData) {\n              console.warn('[useChatState] Invalid content_block:', blockData)\n              break\n            }\n\n            // ============================================================\n            // \u8F6C\u6362\u6570\u636E\u7ED3\u6784\u4EE5\u5339\u914D\u7C7B\u578B\u5B9A\u4E49\n            // \u6839\u636E\u540E\u7AEF\u6570\u636E\u7ED3\u6784\u89C4\u8303\uFF08\u98DE\u4E66\u6587\u6863\uFF09\u8FDB\u884C\u8F6C\u6362\n            // ============================================================\n            let messageContent: MessageContent\n\n            // ========== 1. \u4EA7\u54C1\u5217\u8868\u5361\u7247 (Product List) ==========\n            // \u540E\u7AEF\u683C\u5F0F: {type: \"product_list\", data: [product1, product2, ...]}\n            // data \u76F4\u63A5\u662F\u4EA7\u54C1\u6570\u7EC4\uFF0C\u4E0D\u662F {products: [...]}\n            if (contentType === 'product_list' && Array.isArray(contentData)) {\n              // \u4F7F\u7528\u7EDF\u4E00\u7684\u4EA7\u54C1\u8F6C\u6362\u5DE5\u5177\u51FD\u6570\n              const transformedProducts = transformProducts(contentData, site)\n\n              messageContent = {\n                type: 'product_list',\n                data: {\n                  products: transformedProducts,\n                  title: undefined, // \u540E\u7AEF\u65B0\u89C4\u8303\u4E0D\u8FD4\u56DE title\n                  onAddToCart: onAddToCart, // \u6CE8\u5165\u8D2D\u7269\u8F66\u56DE\u8C03\n                },\n              } as MessageContent\n            }\n            // ========== 2. \u4EA7\u54C1\u5BF9\u6BD4\u5361\u7247 (Product Comparison) ==========\n            // \u540E\u7AEF\u683C\u5F0F: {type: \"product_comparison\", data: {products: [...], dimensions: {...}}}\n            else if (contentType === 'product_comparison' && contentData.products) {\n              // \u4F7F\u7528\u7EDF\u4E00\u7684\u4EA7\u54C1\u8F6C\u6362\u5DE5\u5177\u51FD\u6570\n              const transformedProducts = transformProducts(contentData.products, site)\n\n              messageContent = {\n                type: 'product_comparison',\n                data: {\n                  products: transformedProducts,\n                  dimensions: contentData.dimensions || {},\n                },\n              } as MessageContent\n            }\n            // ========== 3. FAQ \u5217\u8868\u5361\u7247 (FAQ List) ==========\n            // \u540E\u7AEF\u683C\u5F0F: {type: \"faq_list\", data: {found, count, total, results: [...]}}\n            else if (contentType === 'faq_list' && contentData.found !== undefined) {\n              messageContent = {\n                type: 'faq_list',\n                data: contentData, // \u76F4\u63A5\u4F7F\u7528\uFF0C\u7ED3\u6784\u5DF2\u5339\u914D\n              } as MessageContent\n            }\n            // ========== 4. \u5FEB\u6377\u56DE\u590D (Quick Replies) ==========\n            else if (contentType === 'quick_replies' && contentData.replies) {\n              messageContent = {\n                type: 'quick_replies',\n                data: {\n                  replies: contentData.replies,\n                },\n              } as MessageContent\n            }\n            // ========== 5. \u653F\u7B56\u5185\u5BB9 (Policy) ==========\n            else if (contentType === 'policy' && contentData.title && contentData.content) {\n              messageContent = {\n                type: 'policy',\n                data: {\n                  title: contentData.title,\n                  content: contentData.content,\n                },\n              } as MessageContent\n            }\n            // ========== 6. \u4FC3\u9500\u6D3B\u52A8\u5217\u8868 (Promotion List) ==========\n            // \u540E\u7AEF\u683C\u5F0F: {type: \"promotion_list\", data: {found, count, total, results: [...]}}\n            else if (contentType === 'promotion_list' && contentData.found !== undefined) {\n              messageContent = {\n                type: 'promotion_list',\n                data: contentData, // \u76F4\u63A5\u4F7F\u7528\uFF0C\u7ED3\u6784\u5DF2\u5339\u914D\n              } as MessageContent\n            }\n            // ========== 7. \u8D2D\u7269\u8F66 (Cart) ==========\n            // \u540E\u7AEF\u683C\u5F0F: {type: \"cart\", data: {id, lines: {edges: [...]}, cost, ...}} (Shopify GraphQL)\n            // \u9700\u8981\u8F6C\u6362\u4E3A\u524D\u7AEF\u683C\u5F0F: {cartId, lines: [...], cost, ...}\n            else if (contentType === 'cart' && contentData.id !== undefined) {\n              // \u8F6C\u6362\u540E\u7AEF Shopify GraphQL \u683C\u5F0F\u4E3A\u524D\u7AEF\u6807\u51C6\u683C\u5F0F\n              const transformedData = transformCartData(contentData as BackendCartData)\n              messageContent = {\n                type: 'cart',\n                data: {\n                  ...transformedData,\n                  onCart: onCart, // \u6CE8\u5165\u8D2D\u7269\u8F66\u6309\u94AE\u56DE\u8C03\n                },\n              } as MessageContent\n            }\n            // ========== 8. \u5176\u4ED6\u7C7B\u578B\uFF08\u901A\u7528\u5904\u7406\uFF09 ==========\n            else {\n              messageContent = {\n                type: contentType,\n                data: contentData,\n              } as MessageContent\n            }\n\n            currentMessageRef.current.content.push(messageContent)\n\n            setMessagesState(prev => {\n              const updated = [...prev]\n              const existingIndex = updated.findIndex(m => m.id === currentMessageRef.current!.id)\n\n              if (existingIndex >= 0) {\n                updated[existingIndex] = { ...currentMessageRef.current! }\n              } else {\n                updated.push({ ...currentMessageRef.current! })\n              }\n\n              return updated\n            })\n          }\n          break\n        }\n\n        case 'tool_start':\n        case 'tool_end': {\n          // \u5DE5\u5177\u8C03\u7528\u4E8B\u4EF6\uFF0C\u6682\u65F6\u5FFD\u7565\n          // \u53EF\u4EE5\u5728\u672A\u6765\u7528\u4E8E\u663E\u793A\u5DE5\u5177\u8C03\u7528\u72B6\u6001\n          break\n        }\n\n        case 'message_end': {\n          // \u6D88\u606F\u63A5\u6536\u5B8C\u6210\n          setIsStreaming(false)\n          currentMessageRef.current = null\n          break\n        }\n\n        case 'status': {\n          // T040: \u72B6\u6001\u66F4\u65B0\uFF08\u5982\u4F1A\u8BDD\u8FC7\u671F\uFF09\n          const statusData = data as StatusData\n          if (statusData.type === 'session_expired') {\n            // \u4F1A\u8BDD\u8FC7\u671F\uFF0C\u6E05\u7A7A\u6D88\u606F\u5217\u8868\u548C\u4F1A\u8BDD\n            clearMessages()\n            clearSession()\n            if (welcomeMessage) {\n              addMessage({\n                id: `welcome-${Date.now()}`,\n                role: 'assistant',\n                content: [{ type: 'text', text: welcomeMessage }],\n                timestamp: Date.now(),\n              })\n            }\n          }\n          break\n        }\n\n        case 'error': {\n          // \u9519\u8BEF\u5904\u7406\n          const errorData = data as ErrorData\n          setIsStreaming(false)\n          currentMessageRef.current = null\n\n          // \u6DFB\u52A0\u9519\u8BEF\u6D88\u606F\u5230\u754C\u9762\n          addMessage({\n            id: `error-${Date.now()}`,\n            role: 'system',\n            content: [\n              {\n                type: 'error',\n                data: {\n                  message: errorData.message,\n                  code: errorData.code,\n                },\n              },\n            ],\n            timestamp: Date.now(),\n          })\n\n          onError?.(new Error(errorData.message))\n          break\n        }\n\n        case 'done': {\n          // \u6D41\u7ED3\u675F\n          setIsStreaming(false)\n          currentMessageRef.current = null\n          break\n        }\n\n        default:\n          // \u5176\u4ED6\u4E8B\u4EF6\u7C7B\u578B\uFF08tool_start, tool_end \u7B49\uFF09\n          break\n      }\n    },\n    [welcomeMessage, site, addMessage, clearMessages, clearSession, saveSession, sessionId, onError, onAddToCart, onCart]\n  )\n\n  return {\n    messages,\n    isOpen,\n    userId,\n    sessionId,\n    inputValue,\n    isStreaming,\n    openChat,\n    closeChat,\n    toggleChat,\n    setInputValue,\n    addMessage,\n    setMessages,\n    clearMessages,\n    handleSSEEvent,\n    saveSession,\n    clearSession,\n  }\n}\n"],
+  "mappings": "AAMA,OAAS,YAAAA,EAAU,eAAAC,EAAa,UAAAC,EAAQ,aAAAC,MAAiB,QAEzD,OAAS,aAAAC,MAAiB,kBAC1B,OAAS,cAAAC,MAAkB,eAC3B,OAAS,qBAAAC,MAAyB,+BAClC,OAAS,qBAAAC,MAAyB,4BA2I3B,SAASC,GAAaC,EAA+B,CAAC,EAAuB,CAClF,KAAM,CAAE,eAAAC,EAAgB,KAAAC,EAAM,OAAAC,EAAQ,QAAAC,EAAS,cAAAC,EAAe,QAAAC,EAAS,YAAAC,EAAa,OAAAC,CAAO,EAAIR,EAGzF,CAAE,UAAAS,EAAW,YAAAC,EAAa,aAAAC,CAAa,EAAIf,EAAW,EAGtD,CAACgB,EAAQC,CAAS,EAAItB,EAAiB,EAAE,EAG/CG,EAAU,IAAM,CACdC,EAAU,EAAE,KAAKmB,GAAMD,EAAUC,CAAE,CAAC,CACtC,EAAG,CAAC,CAAC,EAGL,KAAM,CAACC,EAAUC,CAAgB,EAAIzB,EAAoB,IAEnDU,EACK,CACL,CACE,GAAI,WAAW,KAAK,IAAI,CAAC,GACzB,KAAM,YACN,QAAS,CAAC,CAAE,KAAM,OAAQ,KAAMA,CAAe,CAAC,EAChD,UAAW,KAAK,IAAI,CACtB,CACF,EAEK,CAAC,CACT,EAGK,CAACgB,EAAQC,CAAS,EAAI3B,EAAS,EAAK,EAGpC,CAAC4B,EAAYC,CAAa,EAAI7B,EAAS,EAAE,EAGzC,CAAC8B,EAAaC,CAAc,EAAI/B,EAAS,EAAK,EAG9CgC,EAAoB9B,EAAuB,IAAI,EAK/C+B,EAAWhC,EAAY,IAAM,CACjC0B,EAAU,EAAI,EACdf,IAAS,CACX,EAAG,CAACA,CAAM,CAAC,EAKLsB,EAAYjC,EAAY,IAAM,CAClC0B,EAAU,EAAK,EACfd,IAAU,CACZ,EAAG,CAACA,CAAO,CAAC,EAKNsB,EAAalC,EAAY,IAAM,CACnC0B,EAAUS,GAAQ,CAChB,MAAMC,EAAW,CAACD,EAClB,OAAIC,EACFzB,IAAS,EAETC,IAAU,EAELwB,CACT,CAAC,CACH,EAAG,CAACzB,EAAQC,CAAO,CAAC,EAKdyB,EAAarC,EAAasC,GAAqB,CACnDd,EAAiBW,GAAQ,CAAC,GAAGA,EAAMG,CAAO,CAAC,CAC7C,EAAG,CAAC,CAAC,EAKCC,EAAcvC,EAAawC,GAA2B,CAC1DhB,EAAiBgB,CAAW,CAC9B,EAAG,CAAC,CAAC,EAKCC,EAAgBzC,EAAY,IAAM,CACtCwB,EAAiB,CAAC,CAAC,CACrB,EAAG,CAAC,CAAC,EAMCkB,EAAiB1C,EACpB2C,GAAoB,CACnB,KAAM,CAAE,MAAOC,EAAW,KAAAC,CAAK,EAAIF,EAEnC,OAAQC,EAAW,CACjB,IAAK,gBAAiB,CAEpBd,EAAe,EAAI,EAGnB,MAAMgB,EAAmBD,EACrBC,EAAiB,WAAaA,EAAiB,YAAc7B,GAC/DC,EAAY4B,EAAiB,SAAS,EAGxC,MAAMC,EAAY,OAAO,KAAK,IAAI,CAAC,GACnChB,EAAkB,QAAU,CAC1B,GAAIgB,EACJ,KAAM,YACN,QAAS,CAAC,CAAE,KAAM,WAAY,KAAM,CAAE,OAAQ,UAAW,CAAE,CAAC,EAC5D,UAAW,KAAK,IAAI,CACtB,EAGAvB,EAAiBW,GAAQ,CAAC,GAAGA,EAAMJ,EAAkB,OAAQ,CAAC,EAC9D,KACF,CAEA,IAAK,gBAAiB,CAGpB,MAAMiB,EAAYH,EACZI,EAAYD,EAAU,OAASA,EAAU,MAAQ,GAEvD,GAAIjB,EAAkB,SAAWkB,EAAW,CAEtBlB,EAAkB,QAAQ,QAAQ,KAAKmB,GAAKA,EAAE,OAAS,UAAU,IAEnFnB,EAAkB,QAAQ,QAAUA,EAAkB,QAAQ,QAAQ,OAAOmB,GAAKA,EAAE,OAAS,UAAU,GAGzG,MAAMC,EAAcpB,EAAkB,QAAQ,QAAQA,EAAkB,QAAQ,QAAQ,OAAS,CAAC,EAI9FoB,GAAeA,EAAY,OAAS,OAEtCA,EAAY,MAAQF,EAGpBlB,EAAkB,QAAQ,QAAQ,KAAK,CACrC,KAAM,OACN,KAAMkB,CACR,CAAC,EAIHzB,EAAiBW,GAAQ,CACvB,MAAMiB,EAAU,CAAC,GAAGjB,CAAI,EAClBkB,EAAgBD,EAAQ,UAAUE,GAAKA,EAAE,KAAOvB,EAAkB,QAAS,EAAE,EAEnF,OAAIsB,GAAiB,EACnBD,EAAQC,CAAa,EAAI,CAAE,GAAGtB,EAAkB,OAAS,EAEzDqB,EAAQ,KAAK,CAAE,GAAGrB,EAAkB,OAAS,CAAC,EAGzCqB,CACT,CAAC,CACH,CACA,KACF,CAEA,IAAK,gBAAiB,CAKpB,MAAMG,EAAYV,EAClB,GAAId,EAAkB,QAAS,CAG7B,MAAMyB,EAAcD,EAAU,MAAQA,EAAU,MAAM,KAChDE,EAAcF,EAAU,KAE9B,GAAI,CAACC,GAAe,CAACC,EAAa,CAChC,QAAQ,KAAK,wCAAyCF,CAAS,EAC/D,KACF,CAMA,IAAIG,EAKAF,IAAgB,gBAAkB,MAAM,QAAQC,CAAW,EAI7DC,EAAiB,CACf,KAAM,eACN,KAAM,CACJ,SALwBrD,EAAkBoD,EAAa/C,CAAI,EAM3D,MAAO,OACP,YAAaK,CACf,CACF,EAIOyC,IAAgB,sBAAwBC,EAAY,SAI3DC,EAAiB,CACf,KAAM,qBACN,KAAM,CACJ,SALwBrD,EAAkBoD,EAAY,SAAU/C,CAAI,EAMpE,WAAY+C,EAAY,YAAc,CAAC,CACzC,CACF,EAIOD,IAAgB,YAAcC,EAAY,QAAU,OAC3DC,EAAiB,CACf,KAAM,WACN,KAAMD,CACR,EAGOD,IAAgB,iBAAmBC,EAAY,QACtDC,EAAiB,CACf,KAAM,gBACN,KAAM,CACJ,QAASD,EAAY,OACvB,CACF,EAGOD,IAAgB,UAAYC,EAAY,OAASA,EAAY,QACpEC,EAAiB,CACf,KAAM,SACN,KAAM,CACJ,MAAOD,EAAY,MACnB,QAASA,EAAY,OACvB,CACF,EAIOD,IAAgB,kBAAoBC,EAAY,QAAU,OACjEC,EAAiB,CACf,KAAM,iBACN,KAAMD,CACR,EAKOD,IAAgB,QAAUC,EAAY,KAAO,OAGpDC,EAAiB,CACf,KAAM,OACN,KAAM,CACJ,GAJoBpD,EAAkBmD,CAA8B,EAKpE,OAAQzC,CACV,CACF,EAIA0C,EAAiB,CACf,KAAMF,EACN,KAAMC,CACR,EAGF1B,EAAkB,QAAQ,QAAQ,KAAK2B,CAAc,EAErDlC,EAAiBW,GAAQ,CACvB,MAAMiB,EAAU,CAAC,GAAGjB,CAAI,EAClBkB,EAAgBD,EAAQ,UAAUE,GAAKA,EAAE,KAAOvB,EAAkB,QAAS,EAAE,EAEnF,OAAIsB,GAAiB,EACnBD,EAAQC,CAAa,EAAI,CAAE,GAAGtB,EAAkB,OAAS,EAEzDqB,EAAQ,KAAK,CAAE,GAAGrB,EAAkB,OAAS,CAAC,EAGzCqB,CACT,CAAC,CACH,CACA,KACF,CAEA,IAAK,aACL,IAAK,WAGH,MAGF,IAAK,cAAe,CAElBtB,EAAe,EAAK,EACpBC,EAAkB,QAAU,KAC5B,KACF,CAEA,IAAK,SAAU,CAEMc,EACJ,OAAS,oBAEtBJ,EAAc,EACdtB,EAAa,EACTV,GACF4B,EAAW,CACT,GAAI,WAAW,KAAK,IAAI,CAAC,GACzB,KAAM,YACN,QAAS,CAAC,CAAE,KAAM,OAAQ,KAAM5B,CAAe,CAAC,EAChD,UAAW,KAAK,IAAI,CACtB,CAAC,GAGL,KACF,CAEA,IAAK,QAAS,CAEZ,MAAMkD,EAAYd,EAClBf,EAAe,EAAK,EACpBC,EAAkB,QAAU,KAG5BM,EAAW,CACT,GAAI,SAAS,KAAK,IAAI,CAAC,GACvB,KAAM,SACN,QAAS,CACP,CACE,KAAM,QACN,KAAM,CACJ,QAASsB,EAAU,QACnB,KAAMA,EAAU,IAClB,CACF,CACF,EACA,UAAW,KAAK,IAAI,CACtB,CAAC,EAED7C,IAAU,IAAI,MAAM6C,EAAU,OAAO,CAAC,EACtC,KACF,CAEA,IAAK,OAAQ,CAEX7B,EAAe,EAAK,EACpBC,EAAkB,QAAU,KAC5B,KACF,CAEA,QAEE,KACJ,CACF,EACA,CAACtB,EAAgBC,EAAM2B,EAAYI,EAAetB,EAAcD,EAAaD,EAAWH,EAASC,EAAaC,CAAM,CACtH,EAEA,MAAO,CACL,SAAAO,EACA,OAAAE,EACA,OAAAL,EACA,UAAAH,EACA,WAAAU,EACA,YAAAE,EACA,SAAAG,EACA,UAAAC,EACA,WAAAC,EACA,cAAAN,EACA,WAAAS,EACA,YAAAE,EACA,cAAAE,EACA,eAAAC,EACA,YAAAxB,EACA,aAAAC,CACF,CACF",
+  "names": ["useState", "useCallback", "useRef", "useEffect", "getUserId", "useSession", "transformProducts", "transformCartData", "useChatState", "options", "welcomeMessage", "site", "onOpen", "onClose", "onMessageSend", "onError", "onAddToCart", "onCart", "sessionId", "saveSession", "clearSession", "userId", "setUserId", "id", "messages", "setMessagesState", "isOpen", "setIsOpen", "inputValue", "setInputValue", "isStreaming", "setIsStreaming", "currentMessageRef", "openChat", "closeChat", "toggleChat", "prev", "newState", "addMessage", "message", "setMessages", "newMessages", "clearMessages", "handleSSEEvent", "event", "eventType", "data", "messageStartData", "messageId", "deltaData", "deltaText", "c", "lastContent", "updated", "existingIndex", "m", "blockData", "contentType", "contentData", "messageContent", "errorData"]
+}

package/dist/esm/components/LiveChatWidget/hooks/useSession.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 会话管理 Hook
+ * 负责 sessionId 的持久化和生命周期管理
+ * 基于 specs/livechat-widget/plan.md 的会话管理策略
+ */
+export interface UseSessionReturn {
+    /**
+     * 当前会话 ID
+     */
+    sessionId: string | null;
+    /**
+     * 保存会话 ID 到 localStorage 和状态
+     * @param id 会话 ID (UUID 格式)
+     */
+    saveSession: (id: string) => void;
+    /**
+     * 清空会话 ID (会话过期或新会话)
+     */
+    clearSession: () => void;
+    /**
+     * 检查是否有活动会话
+     */
+    hasSession: boolean;
+}
+/**
+ * 会话管理 Hook
+ *
+ * 会话管理策略：
+ * 1. 首次对话: 不传 session_id,后端从 message_start 事件返回
+ * 2. 存储位置: localStorage.livechat_session_id
+ * 3. 会话恢复: 打开聊天窗口时自动加载历史消息
+ * 4. 会话过期: 监听 status 事件 (type: "session_expired"),清空消息列表和 sessionId
+ * 5. 新会话按钮: 调用 POST /api/chat/new-session,更新 sessionId
+ *
+ * @returns 会话管理工具对象
+ */
+export declare function useSession(): UseSessionReturn;

package/dist/esm/components/LiveChatWidget/hooks/useSession.js

@@ -0,0 +1,2 @@
+import{useState as l,useCallback as t,useEffect as u}from"react";const s="livechat_session_id";function S(){const[r,n]=l(()=>{if(typeof window>"u")return null;try{return localStorage.getItem(s)}catch(e){return console.error("[useSession] Failed to read from localStorage:",e),null}}),i=t(e=>{if(!e||typeof e!="string"){console.warn("[useSession] Invalid session ID:",e);return}if(n(e),typeof window<"u")try{localStorage.setItem(s,e)}catch(o){console.error("[useSession] Failed to save to localStorage:",o)}},[]),a=t(()=>{if(n(null),typeof window<"u")try{localStorage.removeItem(s)}catch(e){console.error("[useSession] Failed to remove from localStorage:",e)}},[]);return u(()=>{if(typeof window>"u")return;const e=o=>{o.key===s&&n(o.newValue)};return window.addEventListener("storage",e),()=>{window.removeEventListener("storage",e)}},[]),{sessionId:r,saveSession:i,clearSession:a,hasSession:r!==null}}export{S as useSession};
+//# sourceMappingURL=useSession.js.map

package/dist/esm/components/LiveChatWidget/hooks/useSession.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/components/LiveChatWidget/hooks/useSession.ts"],
+  "sourcesContent": ["/**\n * \u4F1A\u8BDD\u7BA1\u7406 Hook\n * \u8D1F\u8D23 sessionId \u7684\u6301\u4E45\u5316\u548C\u751F\u547D\u5468\u671F\u7BA1\u7406\n * \u57FA\u4E8E specs/livechat-widget/plan.md \u7684\u4F1A\u8BDD\u7BA1\u7406\u7B56\u7565\n */\n\nimport { useState, useCallback, useEffect } from 'react'\n\nconst SESSION_KEY = 'livechat_session_id'\n\nexport interface UseSessionReturn {\n  /**\n   * \u5F53\u524D\u4F1A\u8BDD ID\n   */\n  sessionId: string | null\n\n  /**\n   * \u4FDD\u5B58\u4F1A\u8BDD ID \u5230 localStorage \u548C\u72B6\u6001\n   * @param id \u4F1A\u8BDD ID (UUID \u683C\u5F0F)\n   */\n  saveSession: (id: string) => void\n\n  /**\n   * \u6E05\u7A7A\u4F1A\u8BDD ID (\u4F1A\u8BDD\u8FC7\u671F\u6216\u65B0\u4F1A\u8BDD)\n   */\n  clearSession: () => void\n\n  /**\n   * \u68C0\u67E5\u662F\u5426\u6709\u6D3B\u52A8\u4F1A\u8BDD\n   */\n  hasSession: boolean\n}\n\n/**\n * \u4F1A\u8BDD\u7BA1\u7406 Hook\n *\n * \u4F1A\u8BDD\u7BA1\u7406\u7B56\u7565\uFF1A\n * 1. \u9996\u6B21\u5BF9\u8BDD: \u4E0D\u4F20 session_id,\u540E\u7AEF\u4ECE message_start \u4E8B\u4EF6\u8FD4\u56DE\n * 2. \u5B58\u50A8\u4F4D\u7F6E: localStorage.livechat_session_id\n * 3. \u4F1A\u8BDD\u6062\u590D: \u6253\u5F00\u804A\u5929\u7A97\u53E3\u65F6\u81EA\u52A8\u52A0\u8F7D\u5386\u53F2\u6D88\u606F\n * 4. \u4F1A\u8BDD\u8FC7\u671F: \u76D1\u542C status \u4E8B\u4EF6 (type: \"session_expired\"),\u6E05\u7A7A\u6D88\u606F\u5217\u8868\u548C sessionId\n * 5. \u65B0\u4F1A\u8BDD\u6309\u94AE: \u8C03\u7528 POST /api/chat/new-session,\u66F4\u65B0 sessionId\n *\n * @returns \u4F1A\u8BDD\u7BA1\u7406\u5DE5\u5177\u5BF9\u8C61\n */\nexport function useSession(): UseSessionReturn {\n  // \u4ECE localStorage \u521D\u59CB\u5316\u4F1A\u8BDD ID\n  const [sessionId, setSessionId] = useState<string | null>(() => {\n    if (typeof window === 'undefined') return null\n\n    try {\n      return localStorage.getItem(SESSION_KEY)\n    } catch (error) {\n      console.error('[useSession] Failed to read from localStorage:', error)\n      return null\n    }\n  })\n\n  /**\n   * \u4FDD\u5B58\u4F1A\u8BDD ID\n   * \u540C\u65F6\u66F4\u65B0\u72B6\u6001\u548C localStorage\n   */\n  const saveSession = useCallback((id: string) => {\n    if (!id || typeof id !== 'string') {\n      console.warn('[useSession] Invalid session ID:', id)\n      return\n    }\n\n    setSessionId(id)\n\n    if (typeof window !== 'undefined') {\n      try {\n        localStorage.setItem(SESSION_KEY, id)\n      } catch (error) {\n        console.error('[useSession] Failed to save to localStorage:', error)\n      }\n    }\n  }, [])\n\n  /**\n   * \u6E05\u7A7A\u4F1A\u8BDD ID\n   * \u7528\u4E8E\u4F1A\u8BDD\u8FC7\u671F\u6216\u5F00\u59CB\u65B0\u4F1A\u8BDD\n   */\n  const clearSession = useCallback(() => {\n    setSessionId(null)\n\n    if (typeof window !== 'undefined') {\n      try {\n        localStorage.removeItem(SESSION_KEY)\n      } catch (error) {\n        console.error('[useSession] Failed to remove from localStorage:', error)\n      }\n    }\n  }, [])\n\n  /**\n   * \u76D1\u542C localStorage \u53D8\u5316\uFF08\u8DE8\u6807\u7B7E\u9875\u540C\u6B65\uFF09\n   * \u6CE8\u610F\uFF1A\u6839\u636E\u8BA1\u5212\u6587\u6863\uFF0C\u591A\u6807\u7B7E\u9875\u4E0D\u652F\u6301\u5B9E\u65F6\u540C\u6B65\n   * \u8FD9\u91CC\u4EC5\u76D1\u542C\u662F\u4E3A\u4E86\u9632\u6B62\u540C\u4E00\u6D4F\u89C8\u5668\u591A\u6807\u7B7E\u9875\u5BFC\u81F4\u7684\u72B6\u6001\u4E0D\u4E00\u81F4\n   */\n  useEffect(() => {\n    if (typeof window === 'undefined') return\n\n    const handleStorageChange = (event: StorageEvent) => {\n      if (event.key === SESSION_KEY) {\n        setSessionId(event.newValue)\n      }\n    }\n\n    window.addEventListener('storage', handleStorageChange)\n\n    return () => {\n      window.removeEventListener('storage', handleStorageChange)\n    }\n  }, [])\n\n  return {\n    sessionId,\n    saveSession,\n    clearSession,\n    hasSession: sessionId !== null,\n  }\n}\n"],
+  "mappings": "AAMA,OAAS,YAAAA,EAAU,eAAAC,EAAa,aAAAC,MAAiB,QAEjD,MAAMC,EAAc,sBAqCb,SAASC,GAA+B,CAE7C,KAAM,CAACC,EAAWC,CAAY,EAAIN,EAAwB,IAAM,CAC9D,GAAI,OAAO,OAAW,IAAa,OAAO,KAE1C,GAAI,CACF,OAAO,aAAa,QAAQG,CAAW,CACzC,OAASI,EAAO,CACd,eAAQ,MAAM,iDAAkDA,CAAK,EAC9D,IACT,CACF,CAAC,EAMKC,EAAcP,EAAaQ,GAAe,CAC9C,GAAI,CAACA,GAAM,OAAOA,GAAO,SAAU,CACjC,QAAQ,KAAK,mCAAoCA,CAAE,EACnD,MACF,CAIA,GAFAH,EAAaG,CAAE,EAEX,OAAO,OAAW,IACpB,GAAI,CACF,aAAa,QAAQN,EAAaM,CAAE,CACtC,OAASF,EAAO,CACd,QAAQ,MAAM,+CAAgDA,CAAK,CACrE,CAEJ,EAAG,CAAC,CAAC,EAMCG,EAAeT,EAAY,IAAM,CAGrC,GAFAK,EAAa,IAAI,EAEb,OAAO,OAAW,IACpB,GAAI,CACF,aAAa,WAAWH,CAAW,CACrC,OAASI,EAAO,CACd,QAAQ,MAAM,mDAAoDA,CAAK,CACzE,CAEJ,EAAG,CAAC,CAAC,EAOL,OAAAL,EAAU,IAAM,CACd,GAAI,OAAO,OAAW,IAAa,OAEnC,MAAMS,EAAuBC,GAAwB,CAC/CA,EAAM,MAAQT,GAChBG,EAAaM,EAAM,QAAQ,CAE/B,EAEA,cAAO,iBAAiB,UAAWD,CAAmB,EAE/C,IAAM,CACX,OAAO,oBAAoB,UAAWA,CAAmB,CAC3D,CACF,EAAG,CAAC,CAAC,EAEE,CACL,UAAAN,EACA,YAAAG,EACA,aAAAE,EACA,WAAYL,IAAc,IAC5B,CACF",
+  "names": ["useState", "useCallback", "useEffect", "SESSION_KEY", "useSession", "sessionId", "setSessionId", "error", "saveSession", "id", "clearSession", "handleStorageChange", "event"]
+}

package/dist/esm/components/LiveChatWidget/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * LiveChatWidget 组件入口
+ */
+export { LiveChatWidget } from './LiveChatWidget';
+export type { LiveChatWidgetProps, Message, MessageContent, MessageRole, MessageContentType, MessageMetadata, Product, QuickReply, Session, BubblePosition, MessageRenderer, ProductCardContent, ProductListContent, PolicyContent, QuickRepliesContent, ThinkingContent, ErrorContent, FAQListContent, FAQItem, FAQCategory, PromotionListContent, PromotionItem, CartContent, CartData, CartLine, CartCost, CartAmount, CartDiscountCode, SSEEvent, ChatStreamRequest, } from './types';
+export { useChatState } from './hooks/useChatState';
+export { useChatAPI } from './hooks/useChatAPI';
+export { useSession } from './hooks/useSession';
+export { MessageRendererRegistry } from './utils/messageRenderers';
+export { getUserId } from './utils/userId';
+export { sanitizeInput, isValidUrl, isValidUUID, isValidMessageContent, escapeHtml } from './utils/validation';
+export { TextBlock, ProductCard, ProductList, PolicyBlock, QuickReplies, ThinkingBlock, ErrorBlock, FAQList, PromotionList, CartCard, createQuickRepliesRenderer, } from './components/MessageContent/index.js';

package/dist/esm/components/LiveChatWidget/index.js

@@ -0,0 +1,2 @@
+import{LiveChatWidget as o}from"./LiveChatWidget";import{useChatState as s}from"./hooks/useChatState";import{useChatAPI as i}from"./hooks/useChatAPI";import{useSession as C}from"./hooks/useSession";import{MessageRendererRegistry as p}from"./utils/messageRenderers";import{getUserId as l}from"./utils/userId";import{sanitizeInput as u,isValidUrl as g,isValidUUID as P,isValidMessageContent as k,escapeHtml as x}from"./utils/validation";import{TextBlock as f,ProductCard as L,ProductList as M,PolicyBlock as y,QuickReplies as Q,ThinkingBlock as h,ErrorBlock as A,FAQList as I,PromotionList as S,CartCard as B,createQuickRepliesRenderer as E}from"./components/MessageContent/index.js";export{B as CartCard,A as ErrorBlock,I as FAQList,o as LiveChatWidget,p as MessageRendererRegistry,y as PolicyBlock,L as ProductCard,M as ProductList,S as PromotionList,Q as QuickReplies,f as TextBlock,h as ThinkingBlock,E as createQuickRepliesRenderer,x as escapeHtml,l as getUserId,k as isValidMessageContent,P as isValidUUID,g as isValidUrl,u as sanitizeInput,i as useChatAPI,s as useChatState,C as useSession};
+//# sourceMappingURL=index.js.map

package/dist/esm/components/LiveChatWidget/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/components/LiveChatWidget/index.tsx"],
+  "sourcesContent": ["/**\n * LiveChatWidget \u7EC4\u4EF6\u5165\u53E3\n */\n\nexport { LiveChatWidget } from './LiveChatWidget'\nexport type {\n  LiveChatWidgetProps,\n  Message,\n  MessageContent,\n  MessageRole,\n  MessageContentType,\n  MessageMetadata,\n  Product,\n  QuickReply,\n  Session,\n  BubblePosition,\n  MessageRenderer,\n  ProductCardContent,\n  ProductListContent,\n  PolicyContent,\n  QuickRepliesContent,\n  ThinkingContent,\n  ErrorContent,\n  FAQListContent,\n  FAQItem,\n  FAQCategory,\n  PromotionListContent,\n  PromotionItem,\n  CartContent,\n  CartData,\n  CartLine,\n  CartCost,\n  CartAmount,\n  CartDiscountCode,\n  SSEEvent,\n  ChatStreamRequest,\n} from './types'\n\n// \u5BFC\u51FA Hook (\u4F9B\u9AD8\u7EA7\u7528\u6237\u81EA\u5B9A\u4E49\u4F7F\u7528)\nexport { useChatState } from './hooks/useChatState'\nexport { useChatAPI } from './hooks/useChatAPI'\nexport { useSession } from './hooks/useSession'\n\n// \u5BFC\u51FA\u5DE5\u5177\u7C7B\nexport { MessageRendererRegistry } from './utils/messageRenderers'\nexport { getUserId } from './utils/userId'\nexport { sanitizeInput, isValidUrl, isValidUUID, isValidMessageContent, escapeHtml } from './utils/validation'\n\n// \u5BFC\u51FA\u6D88\u606F\u6E32\u67D3\u5668\uFF08\u4F9B\u81EA\u5B9A\u4E49\u4F7F\u7528\uFF09\nexport {\n  TextBlock,\n  ProductCard,\n  ProductList,\n  PolicyBlock,\n  QuickReplies,\n  ThinkingBlock,\n  ErrorBlock,\n  FAQList,\n  PromotionList,\n  CartCard,\n  createQuickRepliesRenderer,\n} from './components/MessageContent/index.js'\n"],
+  "mappings": "AAIA,OAAS,kBAAAA,MAAsB,mBAmC/B,OAAS,gBAAAC,MAAoB,uBAC7B,OAAS,cAAAC,MAAkB,qBAC3B,OAAS,cAAAC,MAAkB,qBAG3B,OAAS,2BAAAC,MAA+B,2BACxC,OAAS,aAAAC,MAAiB,iBAC1B,OAAS,iBAAAC,EAAe,cAAAC,EAAY,eAAAC,EAAa,yBAAAC,EAAuB,cAAAC,MAAkB,qBAG1F,OACE,aAAAC,EACA,eAAAC,EACA,eAAAC,EACA,eAAAC,EACA,gBAAAC,EACA,iBAAAC,EACA,cAAAC,EACA,WAAAC,EACA,iBAAAC,EACA,YAAAC,EACA,8BAAAC,MACK",
+  "names": ["LiveChatWidget", "useChatState", "useChatAPI", "useSession", "MessageRendererRegistry", "getUserId", "sanitizeInput", "isValidUrl", "isValidUUID", "isValidMessageContent", "escapeHtml", "TextBlock", "ProductCard", "ProductList", "PolicyBlock", "QuickReplies", "ThinkingBlock", "ErrorBlock", "FAQList", "PromotionList", "CartCard", "createQuickRepliesRenderer"]
+}