@anker-in/campaign-ui 0.2.11-beta.3 → 0.2.11-beta.31

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"]
+}