@anker-in/campaign-ui 0.2.11-beta.25 → 0.2.11-beta.26

package/dist/esm/components/LiveChatWidget/api/chat.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/components/LiveChatWidget/api/chat.ts"],
-  "sourcesContent": ["/**\n * LiveChat API \u5C42\n * \u5904\u7406 SSE \u6D41\u5F0F\u901A\u4FE1\u548C HTTP \u8BF7\u6C42\n * \u57FA\u4E8E specs/livechat-widget/contracts/*.yaml\n */\n\nimport type { ChatStreamRequest, SSEEvent, NewSessionRequest, NewSessionResponse, ErrorResponse } from '../types'\n\n// ============================================================================\n// SSE \u6D41\u5F0F\u6D88\u606F\u5904\u7406 (T006)\n// ============================================================================\n\n/**\n * \u53D1\u9001\u6D88\u606F\u5E76\u63A5\u6536 SSE \u6D41\u5F0F\u54CD\u5E94\n * @param apiBaseUrl API \u57FA\u7840 URL\n * @param request \u8BF7\u6C42\u53C2\u6570\n * @param onEvent SSE \u4E8B\u4EF6\u56DE\u8C03\n * @param customHeaders \u81EA\u5B9A\u4E49\u8BF7\u6C42\u5934\n */\nexport async function sendMessage(\n  apiBaseUrl: string,\n  request: ChatStreamRequest,\n  onEvent: (event: SSEEvent) => void,\n  customHeaders?: Record<string, string>\n): Promise<void> {\n  const response = await fetch(`${apiBaseUrl}/api/chat/stream`, {\n    method: 'POST',\n    headers: {\n      'Content-Type': 'application/json',\n      Accept: 'text/event-stream',\n      ...customHeaders,\n    },\n    body: JSON.stringify(request),\n  })\n\n  if (!response.ok) {\n    throw new Error(`HTTP ${response.status}: ${response.statusText}`)\n  }\n\n  const reader = response.body?.getReader()\n  if (!reader) {\n    throw new Error('Response body is not readable')\n  }\n\n  const decoder = new TextDecoder()\n  let buffer = ''\n  let currentEvent: string | null = null\n\n  try {\n    while (true) {\n      const { done, value } = await reader.read()\n      if (done) break\n\n      // \u89E3\u7801\u5E76\u8FFD\u52A0\u5230\u7F13\u51B2\u533A\n      buffer += decoder.decode(value, { stream: true })\n\n      // \u6309\u884C\u5206\u5272\n      const lines = buffer.split('\\n')\n\n      // \u4FDD\u7559\u6700\u540E\u4E00\u4E2A\u4E0D\u5B8C\u6574\u7684\u884C\n      buffer = lines.pop() || ''\n\n      for (const line of lines) {\n        const trimmed = line.trim()\n\n        if (trimmed === '') {\n          // \u7A7A\u884C\u8868\u793A\u4E8B\u4EF6\u8FB9\u754C\uFF0C\u91CD\u7F6E\u5F53\u524D\u4E8B\u4EF6\u7C7B\u578B\n          currentEvent = null\n          continue\n        }\n\n        if (trimmed.startsWith('event:')) {\n          // \u63D0\u53D6\u4E8B\u4EF6\u7C7B\u578B\n          currentEvent = trimmed.substring(6).trim()\n        } else if (trimmed.startsWith('data:')) {\n          // \u63D0\u53D6\u6570\u636E\u5E76\u89E3\u6790 JSON\n          const dataStr = trimmed.substring(5).trim()\n          try {\n            const data = JSON.parse(dataStr)\n            onEvent({\n              event: (currentEvent as any) || 'message',\n              data,\n            })\n          } catch (err) {\n            console.error('[LiveChat API] Failed to parse SSE data:', dataStr, err)\n            onEvent({\n              event: 'error',\n              data: {\n                message: 'Failed to parse SSE data',\n                code: 'PARSE_ERROR',\n              },\n            })\n          }\n        }\n      }\n    }\n  } catch (error) {\n    console.error('[LiveChat API] SSE stream error:', error)\n    throw error\n  } finally {\n    reader.releaseLock()\n  }\n}\n\n// ============================================================================\n// \u521B\u5EFA/\u6062\u590D\u4F1A\u8BDD (T009)\n// ============================================================================\n\n/**\n * \u521B\u5EFA\u65B0\u4F1A\u8BDD\u6216\u6062\u590D\u73B0\u6709\u4F1A\u8BDD\n *\n * \u4F7F\u7528\u573A\u666F\uFF1A\n * 1. \u521B\u5EFA\u65B0\u4F1A\u8BDD\uFF1A\u4E0D\u4F20 session_id\uFF0C\u8FD4\u56DE\u65B0\u7684 sessionId\n * 2. \u6062\u590D\u4F1A\u8BDD\uFF1A\u4F20\u5165 session_id\uFF0C\u9A8C\u8BC1\u4F1A\u8BDD\u6709\u6548\u6027\u5E76\u8FD4\u56DE\u5386\u53F2\u6D88\u606F\uFF08resumed: true, messages: [...]\uFF09\n *\n * @param apiBaseUrl API \u57FA\u7840 URL\n * @param request \u8BF7\u6C42\u53C2\u6570\n * @param customHeaders \u81EA\u5B9A\u4E49\u8BF7\u6C42\u5934\n * @returns \u4F1A\u8BDD\u4FE1\u606F\uFF0C\u53EF\u80FD\u5305\u542B\u5386\u53F2\u6D88\u606F\n */\nexport async function createNewSession(\n  apiBaseUrl: string,\n  request: NewSessionRequest,\n  customHeaders?: Record<string, string>\n): Promise<NewSessionResponse> {\n  const response = await fetch(`${apiBaseUrl}/api/chat/new-session`, {\n    method: 'POST',\n    headers: {\n      'Content-Type': 'application/json',\n      ...customHeaders,\n    },\n    body: JSON.stringify(request),\n  })\n\n  if (!response.ok) {\n    const errorData: ErrorResponse = await response.json().catch(() => ({\n      success: false,\n      error: `HTTP ${response.status}: ${response.statusText}`,\n      code: 'HTTP_ERROR',\n    }))\n    throw new Error(errorData.error || 'Failed to create session')\n  }\n\n  return response.json()\n}\n"],
-  "mappings": "AAmBA,eAAsBA,EACpBC,EACAC,EACAC,EACAC,EACe,CACf,MAAMC,EAAW,MAAM,MAAM,GAAGJ,CAAU,mBAAoB,CAC5D,OAAQ,OACR,QAAS,CACP,eAAgB,mBAChB,OAAQ,oBACR,GAAGG,CACL,EACA,KAAM,KAAK,UAAUF,CAAO,CAC9B,CAAC,EAED,GAAI,CAACG,EAAS,GACZ,MAAM,IAAI,MAAM,QAAQA,EAAS,MAAM,KAAKA,EAAS,UAAU,EAAE,EAGnE,MAAMC,EAASD,EAAS,MAAM,UAAU,EACxC,GAAI,CAACC,EACH,MAAM,IAAI,MAAM,+BAA+B,EAGjD,MAAMC,EAAU,IAAI,YACpB,IAAIC,EAAS,GACTC,EAA8B,KAElC,GAAI,CACF,OAAa,CACX,KAAM,CAAE,KAAAC,EAAM,MAAAC,CAAM,EAAI,MAAML,EAAO,KAAK,EAC1C,GAAII,EAAM,MAGVF,GAAUD,EAAQ,OAAOI,EAAO,CAAE,OAAQ,EAAK,CAAC,EAGhD,MAAMC,EAAQJ,EAAO,MAAM;AAAA,CAAI,EAG/BA,EAASI,EAAM,IAAI,GAAK,GAExB,UAAWC,KAAQD,EAAO,CACxB,MAAME,EAAUD,EAAK,KAAK,EAE1B,GAAIC,IAAY,GAAI,CAElBL,EAAe,KACf,QACF,CAEA,GAAIK,EAAQ,WAAW,QAAQ,EAE7BL,EAAeK,EAAQ,UAAU,CAAC,EAAE,KAAK,UAChCA,EAAQ,WAAW,OAAO,EAAG,CAEtC,MAAMC,EAAUD,EAAQ,UAAU,CAAC,EAAE,KAAK,EAC1C,GAAI,CACF,MAAME,EAAO,KAAK,MAAMD,CAAO,EAC/BZ,EAAQ,CACN,MAAQM,GAAwB,UAChC,KAAAO,CACF,CAAC,CACH,OAASC,EAAK,CACZ,QAAQ,MAAM,2CAA4CF,EAASE,CAAG,EACtEd,EAAQ,CACN,MAAO,QACP,KAAM,CACJ,QAAS,2BACT,KAAM,aACR,CACF,CAAC,CACH,CACF,CACF,CACF,CACF,OAASe,EAAO,CACd,cAAQ,MAAM,mCAAoCA,CAAK,EACjDA,CACR,QAAE,CACAZ,EAAO,YAAY,CACrB,CACF,CAkBA,eAAsBa,EACpBlB,EACAC,EACAE,EAC6B,CAC7B,MAAMC,EAAW,MAAM,MAAM,GAAGJ,CAAU,wBAAyB,CACjE,OAAQ,OACR,QAAS,CACP,eAAgB,mBAChB,GAAGG,CACL,EACA,KAAM,KAAK,UAAUF,CAAO,CAC9B,CAAC,EAED,GAAI,CAACG,EAAS,GAAI,CAChB,MAAMe,EAA2B,MAAMf,EAAS,KAAK,EAAE,MAAM,KAAO,CAClE,QAAS,GACT,MAAO,QAAQA,EAAS,MAAM,KAAKA,EAAS,UAAU,GACtD,KAAM,YACR,EAAE,EACF,MAAM,IAAI,MAAMe,EAAU,OAAS,0BAA0B,CAC/D,CAEA,OAAOf,EAAS,KAAK,CACvB",
-  "names": ["sendMessage", "apiBaseUrl", "request", "onEvent", "customHeaders", "response", "reader", "decoder", "buffer", "currentEvent", "done", "value", "lines", "line", "trimmed", "dataStr", "data", "err", "error", "createNewSession", "errorData"]
+  "sourcesContent": ["/**\n * LiveChat API \u5C42\n * \u5904\u7406 SSE \u6D41\u5F0F\u901A\u4FE1\u548C HTTP \u8BF7\u6C42\n * \u57FA\u4E8E specs/livechat-widget/contracts/*.yaml\n */\n\nimport type { ChatStreamRequest, SSEEvent, NewSessionRequest, NewSessionResponse, ErrorResponse } from '../types'\nimport { fetcher } from '../utils/fetcher'\n\n/**\n * Recaptcha \u914D\u7F6E\n */\nexport interface RecaptchaConfig {\n  /**\n   * \u662F\u5426\u542F\u7528 reCAPTCHA\n   */\n  needRecaptcha?: boolean\n  /**\n   * reCAPTCHA site key\n   */\n  recaptchaSitekey?: string\n  /**\n   * reCAPTCHA action \u540D\u79F0\n   */\n  recaptchaAction?: string\n}\n\n// ============================================================================\n// SSE \u6D41\u5F0F\u6D88\u606F\u5904\u7406 (T006)\n// ============================================================================\n\n/**\n * \u53D1\u9001\u6D88\u606F\u5E76\u63A5\u6536 SSE \u6D41\u5F0F\u54CD\u5E94\n * @param apiBaseUrl API \u57FA\u7840 URL\n * @param request \u8BF7\u6C42\u53C2\u6570\n * @param onEvent SSE \u4E8B\u4EF6\u56DE\u8C03\n * @param customHeaders \u81EA\u5B9A\u4E49\u8BF7\u6C42\u5934\n * @param recaptchaConfig reCAPTCHA \u914D\u7F6E\n */\nexport async function sendMessage(\n  apiBaseUrl: string,\n  request: ChatStreamRequest,\n  onEvent: (event: SSEEvent) => void,\n  customHeaders?: Record<string, string>,\n  recaptchaConfig?: RecaptchaConfig\n): Promise<void> {\n  // \u4F7F\u7528 fetcher \u5904\u7406 reCAPTCHA \u548C\u81EA\u5B9A\u4E49 headers\n  const response = await fetcher({\n    url: `${apiBaseUrl}/api/chat/stream`,\n    method: 'POST',\n    headers: {\n      Accept: 'text/event-stream',\n      ...customHeaders,\n    },\n    body: request,\n    needRecaptcha: recaptchaConfig?.needRecaptcha,\n    recaptchaSitekey: recaptchaConfig?.recaptchaSitekey,\n    recaptchaAction: recaptchaConfig?.recaptchaAction || 'chat_stream',\n  })\n\n  if (!response.ok) {\n    throw new Error(`HTTP ${response.status}: ${response.statusText}`)\n  }\n\n  const reader = response.body?.getReader()\n  if (!reader) {\n    throw new Error('Response body is not readable')\n  }\n\n  const decoder = new TextDecoder()\n  let buffer = ''\n  let currentEvent: string | null = null\n\n  try {\n    while (true) {\n      const { done, value } = await reader.read()\n      if (done) break\n\n      // \u89E3\u7801\u5E76\u8FFD\u52A0\u5230\u7F13\u51B2\u533A\n      buffer += decoder.decode(value, { stream: true })\n\n      // \u6309\u884C\u5206\u5272\n      const lines = buffer.split('\\n')\n\n      // \u4FDD\u7559\u6700\u540E\u4E00\u4E2A\u4E0D\u5B8C\u6574\u7684\u884C\n      buffer = lines.pop() || ''\n\n      for (const line of lines) {\n        const trimmed = line.trim()\n\n        if (trimmed === '') {\n          // \u7A7A\u884C\u8868\u793A\u4E8B\u4EF6\u8FB9\u754C\uFF0C\u91CD\u7F6E\u5F53\u524D\u4E8B\u4EF6\u7C7B\u578B\n          currentEvent = null\n          continue\n        }\n\n        if (trimmed.startsWith('event:')) {\n          // \u63D0\u53D6\u4E8B\u4EF6\u7C7B\u578B\n          currentEvent = trimmed.substring(6).trim()\n        } else if (trimmed.startsWith('data:')) {\n          // \u63D0\u53D6\u6570\u636E\u5E76\u89E3\u6790 JSON\n          const dataStr = trimmed.substring(5).trim()\n          try {\n            const data = JSON.parse(dataStr)\n            onEvent({\n              event: (currentEvent as any) || 'message',\n              data,\n            })\n          } catch (err) {\n            console.error('[LiveChat API] Failed to parse SSE data:', dataStr, err)\n            onEvent({\n              event: 'error',\n              data: {\n                message: 'Failed to parse SSE data',\n                code: 'PARSE_ERROR',\n              },\n            })\n          }\n        }\n      }\n    }\n  } catch (error) {\n    console.error('[LiveChat API] SSE stream error:', error)\n    throw error\n  } finally {\n    reader.releaseLock()\n  }\n}\n\n// ============================================================================\n// \u521B\u5EFA/\u6062\u590D\u4F1A\u8BDD (T009)\n// ============================================================================\n\n/**\n * \u521B\u5EFA\u65B0\u4F1A\u8BDD\u6216\u6062\u590D\u73B0\u6709\u4F1A\u8BDD\n *\n * \u4F7F\u7528\u573A\u666F\uFF1A\n * 1. \u521B\u5EFA\u65B0\u4F1A\u8BDD\uFF1A\u4E0D\u4F20 session_id\uFF0C\u8FD4\u56DE\u65B0\u7684 sessionId\n * 2. \u6062\u590D\u4F1A\u8BDD\uFF1A\u4F20\u5165 session_id\uFF0C\u9A8C\u8BC1\u4F1A\u8BDD\u6709\u6548\u6027\u5E76\u8FD4\u56DE\u5386\u53F2\u6D88\u606F\uFF08resumed: true, messages: [...]\uFF09\n *\n * @param apiBaseUrl API \u57FA\u7840 URL\n * @param request \u8BF7\u6C42\u53C2\u6570\n * @param customHeaders \u81EA\u5B9A\u4E49\u8BF7\u6C42\u5934\n * @param recaptchaConfig reCAPTCHA \u914D\u7F6E\n * @returns \u4F1A\u8BDD\u4FE1\u606F\uFF0C\u53EF\u80FD\u5305\u542B\u5386\u53F2\u6D88\u606F\n */\nexport async function createNewSession(\n  apiBaseUrl: string,\n  request: NewSessionRequest,\n  customHeaders?: Record<string, string>,\n  recaptchaConfig?: RecaptchaConfig\n): Promise<NewSessionResponse> {\n  // \u4F7F\u7528 fetcher \u5904\u7406 reCAPTCHA \u548C\u81EA\u5B9A\u4E49 headers\n  const response = await fetcher({\n    url: `${apiBaseUrl}/api/chat/new-session`,\n    method: 'POST',\n    headers: customHeaders,\n    body: request,\n    needRecaptcha: recaptchaConfig?.needRecaptcha,\n    recaptchaSitekey: recaptchaConfig?.recaptchaSitekey,\n    recaptchaAction: recaptchaConfig?.recaptchaAction || 'new_session',\n  })\n\n  if (!response.ok) {\n    const errorData: ErrorResponse = await response.json().catch(() => ({\n      success: false,\n      error: `HTTP ${response.status}: ${response.statusText}`,\n      code: 'HTTP_ERROR',\n    }))\n    throw new Error(errorData.error || 'Failed to create session')\n  }\n\n  return response.json()\n}\n"],
+  "mappings": "AAOA,OAAS,WAAAA,MAAe,mBAgCxB,eAAsBC,EACpBC,EACAC,EACAC,EACAC,EACAC,EACe,CAEf,MAAMC,EAAW,MAAMP,EAAQ,CAC7B,IAAK,GAAGE,CAAU,mBAClB,OAAQ,OACR,QAAS,CACP,OAAQ,oBACR,GAAGG,CACL,EACA,KAAMF,EACN,cAAeG,GAAiB,cAChC,iBAAkBA,GAAiB,iBACnC,gBAAiBA,GAAiB,iBAAmB,aACvD,CAAC,EAED,GAAI,CAACC,EAAS,GACZ,MAAM,IAAI,MAAM,QAAQA,EAAS,MAAM,KAAKA,EAAS,UAAU,EAAE,EAGnE,MAAMC,EAASD,EAAS,MAAM,UAAU,EACxC,GAAI,CAACC,EACH,MAAM,IAAI,MAAM,+BAA+B,EAGjD,MAAMC,EAAU,IAAI,YACpB,IAAIC,EAAS,GACTC,EAA8B,KAElC,GAAI,CACF,OAAa,CACX,KAAM,CAAE,KAAAC,EAAM,MAAAC,CAAM,EAAI,MAAML,EAAO,KAAK,EAC1C,GAAII,EAAM,MAGVF,GAAUD,EAAQ,OAAOI,EAAO,CAAE,OAAQ,EAAK,CAAC,EAGhD,MAAMC,EAAQJ,EAAO,MAAM;AAAA,CAAI,EAG/BA,EAASI,EAAM,IAAI,GAAK,GAExB,UAAWC,KAAQD,EAAO,CACxB,MAAME,EAAUD,EAAK,KAAK,EAE1B,GAAIC,IAAY,GAAI,CAElBL,EAAe,KACf,QACF,CAEA,GAAIK,EAAQ,WAAW,QAAQ,EAE7BL,EAAeK,EAAQ,UAAU,CAAC,EAAE,KAAK,UAChCA,EAAQ,WAAW,OAAO,EAAG,CAEtC,MAAMC,EAAUD,EAAQ,UAAU,CAAC,EAAE,KAAK,EAC1C,GAAI,CACF,MAAME,EAAO,KAAK,MAAMD,CAAO,EAC/Bb,EAAQ,CACN,MAAQO,GAAwB,UAChC,KAAAO,CACF,CAAC,CACH,OAASC,EAAK,CACZ,QAAQ,MAAM,2CAA4CF,EAASE,CAAG,EACtEf,EAAQ,CACN,MAAO,QACP,KAAM,CACJ,QAAS,2BACT,KAAM,aACR,CACF,CAAC,CACH,CACF,CACF,CACF,CACF,OAASgB,EAAO,CACd,cAAQ,MAAM,mCAAoCA,CAAK,EACjDA,CACR,QAAE,CACAZ,EAAO,YAAY,CACrB,CACF,CAmBA,eAAsBa,EACpBnB,EACAC,EACAE,EACAC,EAC6B,CAE7B,MAAMC,EAAW,MAAMP,EAAQ,CAC7B,IAAK,GAAGE,CAAU,wBAClB,OAAQ,OACR,QAASG,EACT,KAAMF,EACN,cAAeG,GAAiB,cAChC,iBAAkBA,GAAiB,iBACnC,gBAAiBA,GAAiB,iBAAmB,aACvD,CAAC,EAED,GAAI,CAACC,EAAS,GAAI,CAChB,MAAMe,EAA2B,MAAMf,EAAS,KAAK,EAAE,MAAM,KAAO,CAClE,QAAS,GACT,MAAO,QAAQA,EAAS,MAAM,KAAKA,EAAS,UAAU,GACtD,KAAM,YACR,EAAE,EACF,MAAM,IAAI,MAAMe,EAAU,OAAS,0BAA0B,CAC/D,CAEA,OAAOf,EAAS,KAAK,CACvB",
+  "names": ["fetcher", "sendMessage", "apiBaseUrl", "request", "onEvent", "customHeaders", "recaptchaConfig", "response", "reader", "decoder", "buffer", "currentEvent", "done", "value", "lines", "line", "trimmed", "dataStr", "data", "err", "error", "createNewSession", "errorData"]
 }

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

@@ -4,6 +4,7 @@
  * 基于 specs/livechat-widget/plan.md 的 API 调用策略
  */
 import type { ChatStreamRequest, SSEEvent, NewSessionRequest, NewSessionResponse } from '../types';
+import { type RecaptchaConfig } from '../api/chat';
 export interface UseChatAPIOptions {
     /**
      * API 基础 URL
@@ -13,6 +14,10 @@ export interface UseChatAPIOptions {
      * 自定义请求头
      */
     headers?: Record<string, string>;
+    /**
+     * reCAPTCHA 配置
+     */
+    recaptchaConfig?: RecaptchaConfig;
     /**
      * 错误处理回调
      */

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

@@ -1,2 +1,2 @@
-import{useCallback as u,useRef as c}from"react";import{sendMessage as h,createNewSession as p}from"../api/chat";function d(l){const{apiBaseUrl:s,headers:o,onError:n}=l,e=c(null),a=c(!1),S=u(async(i,r)=>{e.current&&e.current.abort(),e.current=new AbortController,a.current=!0;try{await h(s,i,r,o)}catch(t){if(t instanceof Error&&t.name==="AbortError")return;throw console.error("[useChatAPI] Stream error:",t),n?.(t),t}finally{a.current=!1,e.current=null}},[s,o,n]),m=u(async i=>{try{return await p(s,i,o)}catch(r){throw console.error("[useChatAPI] Create session error:",r),n?.(r),r}},[s,o,n]),f=u(()=>{e.current&&(e.current.abort(),e.current=null,a.current=!1)},[]);return{sendMessageStream:S,createSession:m,abortStream:f,isSending:a.current}}export{d as useChatAPI};
+import{useCallback as u,useRef as l}from"react";import{sendMessage as C,createNewSession as m}from"../api/chat";function E(S){const{apiBaseUrl:s,headers:o,recaptchaConfig:n,onError:a}=S,e=l(null),i=l(!1),f=u(async(c,r)=>{e.current&&e.current.abort(),e.current=new AbortController,i.current=!0;try{await C(s,c,r,o,n)}catch(t){if(t instanceof Error&&t.name==="AbortError")return;throw console.error("[useChatAPI] Stream error:",t),a?.(t),t}finally{i.current=!1,e.current=null}},[s,o,n,a]),h=u(async c=>{try{return await m(s,c,o,n)}catch(r){throw console.error("[useChatAPI] Create session error:",r),a?.(r),r}},[s,o,n,a]),p=u(()=>{e.current&&(e.current.abort(),e.current=null,i.current=!1)},[]);return{sendMessageStream:f,createSession:h,abortStream:p,isSending:i.current}}export{E as useChatAPI};
 //# sourceMappingURL=useChatAPI.js.map

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/components/LiveChatWidget/hooks/useChatAPI.ts"],
-  "sourcesContent": ["/**\n * \u804A\u5929 API \u8C03\u7528 Hook\n * \u5C01\u88C5 SSE \u6D41\u5F0F\u6D88\u606F\u63A5\u6536\u3001\u5386\u53F2\u6D88\u606F\u52A0\u8F7D\u3001\u65B0\u4F1A\u8BDD\u521B\u5EFA\n * \u57FA\u4E8E specs/livechat-widget/plan.md \u7684 API \u8C03\u7528\u7B56\u7565\n */\n\nimport { useCallback, useRef } from 'react'\nimport type { ChatStreamRequest, SSEEvent, NewSessionRequest, NewSessionResponse } from '../types'\nimport { sendMessage, createNewSession } from '../api/chat'\n\nexport interface UseChatAPIOptions {\n  /**\n   * API \u57FA\u7840 URL\n   */\n  apiBaseUrl: string\n\n  /**\n   * \u81EA\u5B9A\u4E49\u8BF7\u6C42\u5934\n   */\n  headers?: Record<string, string>\n\n  /**\n   * \u9519\u8BEF\u5904\u7406\u56DE\u8C03\n   */\n  onError?: (error: Error) => void\n}\n\nexport interface UseChatAPIReturn {\n  /**\n   * \u53D1\u9001\u6D88\u606F\u5E76\u63A5\u6536 SSE \u6D41\u5F0F\u54CD\u5E94\n   * @param request \u8BF7\u6C42\u53C2\u6570\n   * @param onEvent SSE \u4E8B\u4EF6\u56DE\u8C03\n   * @returns Promise<void>\n   */\n  sendMessageStream: (request: ChatStreamRequest, onEvent: (event: SSEEvent) => void) => Promise<void>\n\n  /**\n   * \u521B\u5EFA\u65B0\u4F1A\u8BDD\u6216\u6062\u590D\u73B0\u6709\u4F1A\u8BDD\n   * @param request \u8BF7\u6C42\u53C2\u6570\n   * @returns \u65B0\u4F1A\u8BDD\u4FE1\u606F\uFF0C\u53EF\u80FD\u5305\u542B\u5386\u53F2\u6D88\u606F\n   */\n  createSession: (request: NewSessionRequest) => Promise<NewSessionResponse>\n\n  /**\n   * \u4E2D\u65AD\u5F53\u524D\u7684 SSE \u6D41\n   */\n  abortStream: () => void\n\n  /**\n   * \u662F\u5426\u6B63\u5728\u53D1\u9001\u6D88\u606F\n   */\n  isSending: boolean\n}\n\n/**\n * \u804A\u5929 API \u8C03\u7528 Hook\n *\n * \u529F\u80FD\uFF1A\n * 1. sendMessageStream: \u53D1\u9001\u6D88\u606F\u5E76\u63A5\u6536 SSE \u6D41\u5F0F\u54CD\u5E94\n * 2. createSession: \u521B\u5EFA\u65B0\u4F1A\u8BDD\u6216\u6062\u590D\u73B0\u6709\u4F1A\u8BDD\n * 3. abortStream: \u4E2D\u65AD\u5F53\u524D\u6D41\n *\n * @param options Hook \u914D\u7F6E\u9009\u9879\n * @returns API \u8C03\u7528\u5DE5\u5177\u5BF9\u8C61\n */\nexport function useChatAPI(options: UseChatAPIOptions): UseChatAPIReturn {\n  const { apiBaseUrl, headers, onError } = options\n\n  // \u7528\u4E8E\u4E2D\u65AD\u5F53\u524D\u8BF7\u6C42\u7684 AbortController\n  const abortControllerRef = useRef<AbortController | null>(null)\n\n  // \u53D1\u9001\u72B6\u6001\u6807\u8BB0\n  const isSendingRef = useRef(false)\n\n  /**\n   * \u53D1\u9001\u6D88\u606F\u5E76\u63A5\u6536 SSE \u6D41\u5F0F\u54CD\u5E94\n   */\n  const sendMessageStream = useCallback(\n    async (request: ChatStreamRequest, onEvent: (event: SSEEvent) => void) => {\n      // \u5982\u679C\u6B63\u5728\u53D1\u9001\uFF0C\u5148\u4E2D\u65AD\u4E4B\u524D\u7684\u8BF7\u6C42\n      if (abortControllerRef.current) {\n        abortControllerRef.current.abort()\n      }\n\n      // \u521B\u5EFA\u65B0\u7684 AbortController\n      abortControllerRef.current = new AbortController()\n      isSendingRef.current = true\n\n      try {\n        await sendMessage(apiBaseUrl, request, onEvent, headers)\n      } catch (error) {\n        // \u5FFD\u7565\u624B\u52A8\u4E2D\u65AD\u7684\u9519\u8BEF\n        if (error instanceof Error && error.name === 'AbortError') {\n          return\n        }\n\n        console.error('[useChatAPI] Stream error:', error)\n        onError?.(error as Error)\n        throw error\n      } finally {\n        isSendingRef.current = false\n        abortControllerRef.current = null\n      }\n    },\n    [apiBaseUrl, headers, onError]\n  )\n\n  /**\n   * \u521B\u5EFA\u65B0\u4F1A\u8BDD\u6216\u6062\u590D\u73B0\u6709\u4F1A\u8BDD\n   */\n  const createSession = useCallback(\n    async (request: NewSessionRequest): Promise<NewSessionResponse> => {\n      try {\n        return await createNewSession(apiBaseUrl, request, headers)\n      } catch (error) {\n        console.error('[useChatAPI] Create session error:', error)\n        onError?.(error as Error)\n        throw error\n      }\n    },\n    [apiBaseUrl, headers, onError]\n  )\n\n  /**\n   * \u4E2D\u65AD\u5F53\u524D\u7684 SSE \u6D41\n   */\n  const abortStream = useCallback(() => {\n    if (abortControllerRef.current) {\n      abortControllerRef.current.abort()\n      abortControllerRef.current = null\n      isSendingRef.current = false\n    }\n  }, [])\n\n  return {\n    sendMessageStream,\n    createSession,\n    abortStream,\n    isSending: isSendingRef.current,\n  }\n}\n"],
-  "mappings": "AAMA,OAAS,eAAAA,EAAa,UAAAC,MAAc,QAEpC,OAAS,eAAAC,EAAa,oBAAAC,MAAwB,cAyDvC,SAASC,EAAWC,EAA8C,CACvE,KAAM,CAAE,WAAAC,EAAY,QAAAC,EAAS,QAAAC,CAAQ,EAAIH,EAGnCI,EAAqBR,EAA+B,IAAI,EAGxDS,EAAeT,EAAO,EAAK,EAK3BU,EAAoBX,EACxB,MAAOY,EAA4BC,IAAuC,CAEpEJ,EAAmB,SACrBA,EAAmB,QAAQ,MAAM,EAInCA,EAAmB,QAAU,IAAI,gBACjCC,EAAa,QAAU,GAEvB,GAAI,CACF,MAAMR,EAAYI,EAAYM,EAASC,EAASN,CAAO,CACzD,OAASO,EAAO,CAEd,GAAIA,aAAiB,OAASA,EAAM,OAAS,aAC3C,OAGF,cAAQ,MAAM,6BAA8BA,CAAK,EACjDN,IAAUM,CAAc,EAClBA,CACR,QAAE,CACAJ,EAAa,QAAU,GACvBD,EAAmB,QAAU,IAC/B,CACF,EACA,CAACH,EAAYC,EAASC,CAAO,CAC/B,EAKMO,EAAgBf,EACpB,MAAOY,GAA4D,CACjE,GAAI,CACF,OAAO,MAAMT,EAAiBG,EAAYM,EAASL,CAAO,CAC5D,OAASO,EAAO,CACd,cAAQ,MAAM,qCAAsCA,CAAK,EACzDN,IAAUM,CAAc,EAClBA,CACR,CACF,EACA,CAACR,EAAYC,EAASC,CAAO,CAC/B,EAKMQ,EAAchB,EAAY,IAAM,CAChCS,EAAmB,UACrBA,EAAmB,QAAQ,MAAM,EACjCA,EAAmB,QAAU,KAC7BC,EAAa,QAAU,GAE3B,EAAG,CAAC,CAAC,EAEL,MAAO,CACL,kBAAAC,EACA,cAAAI,EACA,YAAAC,EACA,UAAWN,EAAa,OAC1B,CACF",
-  "names": ["useCallback", "useRef", "sendMessage", "createNewSession", "useChatAPI", "options", "apiBaseUrl", "headers", "onError", "abortControllerRef", "isSendingRef", "sendMessageStream", "request", "onEvent", "error", "createSession", "abortStream"]
+  "sourcesContent": ["/**\n * \u804A\u5929 API \u8C03\u7528 Hook\n * \u5C01\u88C5 SSE \u6D41\u5F0F\u6D88\u606F\u63A5\u6536\u3001\u5386\u53F2\u6D88\u606F\u52A0\u8F7D\u3001\u65B0\u4F1A\u8BDD\u521B\u5EFA\n * \u57FA\u4E8E specs/livechat-widget/plan.md \u7684 API \u8C03\u7528\u7B56\u7565\n */\n\nimport { useCallback, useRef } from 'react'\nimport type { ChatStreamRequest, SSEEvent, NewSessionRequest, NewSessionResponse } from '../types'\nimport { sendMessage, createNewSession, type RecaptchaConfig } from '../api/chat'\n\nexport interface UseChatAPIOptions {\n  /**\n   * API \u57FA\u7840 URL\n   */\n  apiBaseUrl: string\n\n  /**\n   * \u81EA\u5B9A\u4E49\u8BF7\u6C42\u5934\n   */\n  headers?: Record<string, string>\n\n  /**\n   * reCAPTCHA \u914D\u7F6E\n   */\n  recaptchaConfig?: RecaptchaConfig\n\n  /**\n   * \u9519\u8BEF\u5904\u7406\u56DE\u8C03\n   */\n  onError?: (error: Error) => void\n}\n\nexport interface UseChatAPIReturn {\n  /**\n   * \u53D1\u9001\u6D88\u606F\u5E76\u63A5\u6536 SSE \u6D41\u5F0F\u54CD\u5E94\n   * @param request \u8BF7\u6C42\u53C2\u6570\n   * @param onEvent SSE \u4E8B\u4EF6\u56DE\u8C03\n   * @returns Promise<void>\n   */\n  sendMessageStream: (request: ChatStreamRequest, onEvent: (event: SSEEvent) => void) => Promise<void>\n\n  /**\n   * \u521B\u5EFA\u65B0\u4F1A\u8BDD\u6216\u6062\u590D\u73B0\u6709\u4F1A\u8BDD\n   * @param request \u8BF7\u6C42\u53C2\u6570\n   * @returns \u65B0\u4F1A\u8BDD\u4FE1\u606F\uFF0C\u53EF\u80FD\u5305\u542B\u5386\u53F2\u6D88\u606F\n   */\n  createSession: (request: NewSessionRequest) => Promise<NewSessionResponse>\n\n  /**\n   * \u4E2D\u65AD\u5F53\u524D\u7684 SSE \u6D41\n   */\n  abortStream: () => void\n\n  /**\n   * \u662F\u5426\u6B63\u5728\u53D1\u9001\u6D88\u606F\n   */\n  isSending: boolean\n}\n\n/**\n * \u804A\u5929 API \u8C03\u7528 Hook\n *\n * \u529F\u80FD\uFF1A\n * 1. sendMessageStream: \u53D1\u9001\u6D88\u606F\u5E76\u63A5\u6536 SSE \u6D41\u5F0F\u54CD\u5E94\n * 2. createSession: \u521B\u5EFA\u65B0\u4F1A\u8BDD\u6216\u6062\u590D\u73B0\u6709\u4F1A\u8BDD\n * 3. abortStream: \u4E2D\u65AD\u5F53\u524D\u6D41\n *\n * @param options Hook \u914D\u7F6E\u9009\u9879\n * @returns API \u8C03\u7528\u5DE5\u5177\u5BF9\u8C61\n */\nexport function useChatAPI(options: UseChatAPIOptions): UseChatAPIReturn {\n  const { apiBaseUrl, headers, recaptchaConfig, onError } = options\n\n  // \u7528\u4E8E\u4E2D\u65AD\u5F53\u524D\u8BF7\u6C42\u7684 AbortController\n  const abortControllerRef = useRef<AbortController | null>(null)\n\n  // \u53D1\u9001\u72B6\u6001\u6807\u8BB0\n  const isSendingRef = useRef(false)\n\n  /**\n   * \u53D1\u9001\u6D88\u606F\u5E76\u63A5\u6536 SSE \u6D41\u5F0F\u54CD\u5E94\n   */\n  const sendMessageStream = useCallback(\n    async (request: ChatStreamRequest, onEvent: (event: SSEEvent) => void) => {\n      // \u5982\u679C\u6B63\u5728\u53D1\u9001\uFF0C\u5148\u4E2D\u65AD\u4E4B\u524D\u7684\u8BF7\u6C42\n      if (abortControllerRef.current) {\n        abortControllerRef.current.abort()\n      }\n\n      // \u521B\u5EFA\u65B0\u7684 AbortController\n      abortControllerRef.current = new AbortController()\n      isSendingRef.current = true\n\n      try {\n        await sendMessage(apiBaseUrl, request, onEvent, headers, recaptchaConfig)\n      } catch (error) {\n        // \u5FFD\u7565\u624B\u52A8\u4E2D\u65AD\u7684\u9519\u8BEF\n        if (error instanceof Error && error.name === 'AbortError') {\n          return\n        }\n\n        console.error('[useChatAPI] Stream error:', error)\n        onError?.(error as Error)\n        throw error\n      } finally {\n        isSendingRef.current = false\n        abortControllerRef.current = null\n      }\n    },\n    [apiBaseUrl, headers, recaptchaConfig, onError]\n  )\n\n  /**\n   * \u521B\u5EFA\u65B0\u4F1A\u8BDD\u6216\u6062\u590D\u73B0\u6709\u4F1A\u8BDD\n   */\n  const createSession = useCallback(\n    async (request: NewSessionRequest): Promise<NewSessionResponse> => {\n      try {\n        return await createNewSession(apiBaseUrl, request, headers, recaptchaConfig)\n      } catch (error) {\n        console.error('[useChatAPI] Create session error:', error)\n        onError?.(error as Error)\n        throw error\n      }\n    },\n    [apiBaseUrl, headers, recaptchaConfig, onError]\n  )\n\n  /**\n   * \u4E2D\u65AD\u5F53\u524D\u7684 SSE \u6D41\n   */\n  const abortStream = useCallback(() => {\n    if (abortControllerRef.current) {\n      abortControllerRef.current.abort()\n      abortControllerRef.current = null\n      isSendingRef.current = false\n    }\n  }, [])\n\n  return {\n    sendMessageStream,\n    createSession,\n    abortStream,\n    isSending: isSendingRef.current,\n  }\n}\n"],
+  "mappings": "AAMA,OAAS,eAAAA,EAAa,UAAAC,MAAc,QAEpC,OAAS,eAAAC,EAAa,oBAAAC,MAA8C,cA8D7D,SAASC,EAAWC,EAA8C,CACvE,KAAM,CAAE,WAAAC,EAAY,QAAAC,EAAS,gBAAAC,EAAiB,QAAAC,CAAQ,EAAIJ,EAGpDK,EAAqBT,EAA+B,IAAI,EAGxDU,EAAeV,EAAO,EAAK,EAK3BW,EAAoBZ,EACxB,MAAOa,EAA4BC,IAAuC,CAEpEJ,EAAmB,SACrBA,EAAmB,QAAQ,MAAM,EAInCA,EAAmB,QAAU,IAAI,gBACjCC,EAAa,QAAU,GAEvB,GAAI,CACF,MAAMT,EAAYI,EAAYO,EAASC,EAASP,EAASC,CAAe,CAC1E,OAASO,EAAO,CAEd,GAAIA,aAAiB,OAASA,EAAM,OAAS,aAC3C,OAGF,cAAQ,MAAM,6BAA8BA,CAAK,EACjDN,IAAUM,CAAc,EAClBA,CACR,QAAE,CACAJ,EAAa,QAAU,GACvBD,EAAmB,QAAU,IAC/B,CACF,EACA,CAACJ,EAAYC,EAASC,EAAiBC,CAAO,CAChD,EAKMO,EAAgBhB,EACpB,MAAOa,GAA4D,CACjE,GAAI,CACF,OAAO,MAAMV,EAAiBG,EAAYO,EAASN,EAASC,CAAe,CAC7E,OAASO,EAAO,CACd,cAAQ,MAAM,qCAAsCA,CAAK,EACzDN,IAAUM,CAAc,EAClBA,CACR,CACF,EACA,CAACT,EAAYC,EAASC,EAAiBC,CAAO,CAChD,EAKMQ,EAAcjB,EAAY,IAAM,CAChCU,EAAmB,UACrBA,EAAmB,QAAQ,MAAM,EACjCA,EAAmB,QAAU,KAC7BC,EAAa,QAAU,GAE3B,EAAG,CAAC,CAAC,EAEL,MAAO,CACL,kBAAAC,EACA,cAAAI,EACA,YAAAC,EACA,UAAWN,EAAa,OAC1B,CACF",
+  "names": ["useCallback", "useRef", "sendMessage", "createNewSession", "useChatAPI", "options", "apiBaseUrl", "headers", "recaptchaConfig", "onError", "abortControllerRef", "isSendingRef", "sendMessageStream", "request", "onEvent", "error", "createSession", "abortStream"]
 }

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

@@ -557,6 +557,23 @@ export interface LiveChatWidgetProps {
      * @example { "Authorization": "Bearer token", "X-Custom-Header": "value" }
      */
     headers?: Record<string, string>;
+    /**
+     * 是否启用 reCAPTCHA 验证
+     * @default false
+     */
+    needRecaptcha?: boolean;
+    /**
+     * reCAPTCHA site key
+     * 当 needRecaptcha=true 时必填
+     * @example "6LfS4J4pAAAAACX1e_WrxutmxxzCK7FU4WzVqL14"
+     */
+    recaptchaSitekey?: string;
+    /**
+     * reCAPTCHA action 前缀
+     * 实际使用时会根据不同接口添加后缀（如 chat_stream, new_session）
+     * @default "livechat"
+     */
+    recaptchaAction?: string;
     /**
      * Shopify 店铺域名
      * @example "www.eufy.com"

package/dist/esm/components/LiveChatWidget/utils/fetcher.d.ts

@@ -0,0 +1,36 @@
+/**
+ * LiveChat Fetcher
+ * 参照 storefront 的实现，支持 reCAPTCHA
+ */
+/**
+ * Fetcher 参数
+ */
+export interface FetcherOptions {
+    url: string;
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    headers?: Record<string, string>;
+    body?: any;
+    timeout?: number;
+    needRecaptcha?: boolean;
+    recaptchaSitekey?: string;
+    recaptchaAction?: string;
+    recaptchaHeaderKey?: string;
+}
+/**
+ * Fetcher 函数
+ * 支持 reCAPTCHA 和自定义 headers
+ */
+export declare const fetcher: ({ url, method, headers, body, timeout, needRecaptcha, recaptchaSitekey, recaptchaAction, recaptchaHeaderKey, }: FetcherOptions) => Promise<Response>;
+/**
+ * 扩展 Window 接口以支持 grecaptcha
+ */
+declare global {
+    interface Window {
+        grecaptcha?: {
+            execute: (sitekey: string, options: {
+                action: string;
+            }) => Promise<string>;
+            ready: (callback: () => void) => void;
+        };
+    }
+}

package/dist/esm/components/LiveChatWidget/utils/fetcher.js

@@ -0,0 +1,2 @@
+const u=async(r,e)=>{if(typeof window>"u"||!window.grecaptcha?.execute)return console.warn("[LiveChat Fetcher] reCAPTCHA not loaded"),!1;try{return await window.grecaptcha.execute(e,{action:r})}catch(t){return console.error("[LiveChat Fetcher] reCAPTCHA execution failed:",t),!1}};async function f(r,e,t="X-Recaptcha-Token"){const n=await u(r,e);return n?{[t]:n}:{}}const T=async({url:r,method:e="POST",headers:t={},body:n,timeout:i=9e4,needRecaptcha:l=!1,recaptchaSitekey:o,recaptchaAction:g="activity",recaptchaHeaderKey:p="X-Recaptcha-Token"})=>{let s={};l&&(o?s=await f(g,o,p):console.warn("[LiveChat Fetcher] needRecaptcha=true but recaptchaSitekey is missing"));const d=n?JSON.stringify(n):void 0,h=new AbortController;let a;i&&(a=setTimeout(()=>h.abort(),i));try{const c=await fetch(r,{method:e,mode:"cors",headers:{"Content-Type":"application/json",...t,...s},signal:h.signal,...e!=="GET"&&d&&{body:d}});return a&&clearTimeout(a),c}catch(c){throw a&&clearTimeout(a),c}};export{T as fetcher};
+//# sourceMappingURL=fetcher.js.map

package/dist/esm/components/LiveChatWidget/utils/fetcher.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/components/LiveChatWidget/utils/fetcher.ts"],
+  "sourcesContent": ["/**\n * LiveChat Fetcher\n * \u53C2\u7167 storefront \u7684\u5B9E\u73B0\uFF0C\u652F\u6301 reCAPTCHA\n */\n\n/**\n * \u6267\u884C Google reCAPTCHA \u9A8C\u8BC1\n */\nconst executeRecaptcha = async (action: string, sitekey: string): Promise<string | false> => {\n  if (typeof window === 'undefined' || !window.grecaptcha?.execute) {\n    console.warn('[LiveChat Fetcher] reCAPTCHA not loaded')\n    return false\n  }\n\n  try {\n    const token = await window.grecaptcha.execute(sitekey, { action })\n    return token\n  } catch (error) {\n    console.error('[LiveChat Fetcher] reCAPTCHA execution failed:', error)\n    return false\n  }\n}\n\n/**\n * \u83B7\u53D6 reCAPTCHA headers\n */\nasync function getRecaptchaHeaders(\n  action: string,\n  sitekey: string,\n  headerKey = 'X-Recaptcha-Token'\n): Promise<Record<string, string>> {\n  const recaptchaToken = await executeRecaptcha(action, sitekey)\n  if (!recaptchaToken) {\n    return {}\n  }\n  return {\n    [headerKey]: recaptchaToken,\n  }\n}\n\n/**\n * Fetcher \u53C2\u6570\n */\nexport interface FetcherOptions {\n  url: string\n  method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH'\n  headers?: Record<string, string>\n  body?: any\n  timeout?: number\n  needRecaptcha?: boolean\n  recaptchaSitekey?: string\n  recaptchaAction?: string\n  recaptchaHeaderKey?: string\n}\n\n/**\n * Fetcher \u51FD\u6570\n * \u652F\u6301 reCAPTCHA \u548C\u81EA\u5B9A\u4E49 headers\n */\nexport const fetcher = async ({\n  url,\n  method = 'POST',\n  headers = {},\n  body,\n  timeout = 90000,\n  needRecaptcha = false,\n  recaptchaSitekey,\n  recaptchaAction = 'activity',\n  recaptchaHeaderKey = 'X-Recaptcha-Token',\n}: FetcherOptions): Promise<Response> => {\n  // \u83B7\u53D6 reCAPTCHA headers\uFF08\u5982\u679C\u9700\u8981\uFF09\n  let recaptchaHeaders: Record<string, string> = {}\n  if (needRecaptcha) {\n    if (!recaptchaSitekey) {\n      console.warn('[LiveChat Fetcher] needRecaptcha=true but recaptchaSitekey is missing')\n    } else {\n      recaptchaHeaders = await getRecaptchaHeaders(recaptchaAction, recaptchaSitekey, recaptchaHeaderKey)\n    }\n  }\n\n  // \u51C6\u5907\u8BF7\u6C42\u4F53\n  const bodyData = body ? JSON.stringify(body) : undefined\n\n  const controller = new AbortController()\n  let timeoutTimer: NodeJS.Timeout | undefined\n  if (timeout) {\n    timeoutTimer = setTimeout(() => controller.abort(), timeout)\n  }\n\n  try {\n    const response = await fetch(url, {\n      method,\n      mode: 'cors',\n      headers: {\n        'Content-Type': 'application/json',\n        ...headers,\n        ...recaptchaHeaders,\n      },\n      signal: controller.signal,\n      ...(method !== 'GET' && bodyData && { body: bodyData }),\n    })\n\n    if (timeoutTimer) {\n      clearTimeout(timeoutTimer)\n    }\n\n    return response\n  } catch (error) {\n    if (timeoutTimer) {\n      clearTimeout(timeoutTimer)\n    }\n    throw error\n  }\n}\n\n/**\n * \u6269\u5C55 Window \u63A5\u53E3\u4EE5\u652F\u6301 grecaptcha\n */\ndeclare global {\n  interface Window {\n    grecaptcha?: {\n      execute: (sitekey: string, options: { action: string }) => Promise<string>\n      ready: (callback: () => void) => void\n    }\n  }\n}\n"],
+  "mappings": "AAQA,MAAMA,EAAmB,MAAOC,EAAgBC,IAA6C,CAC3F,GAAI,OAAO,OAAW,KAAe,CAAC,OAAO,YAAY,QACvD,eAAQ,KAAK,yCAAyC,EAC/C,GAGT,GAAI,CAEF,OADc,MAAM,OAAO,WAAW,QAAQA,EAAS,CAAE,OAAAD,CAAO,CAAC,CAEnE,OAASE,EAAO,CACd,eAAQ,MAAM,iDAAkDA,CAAK,EAC9D,EACT,CACF,EAKA,eAAeC,EACbH,EACAC,EACAG,EAAY,oBACqB,CACjC,MAAMC,EAAiB,MAAMN,EAAiBC,EAAQC,CAAO,EAC7D,OAAKI,EAGE,CACL,CAACD,CAAS,EAAGC,CACf,EAJS,CAAC,CAKZ,CAqBO,MAAMC,EAAU,MAAO,CAC5B,IAAAC,EACA,OAAAC,EAAS,OACT,QAAAC,EAAU,CAAC,EACX,KAAAC,EACA,QAAAC,EAAU,IACV,cAAAC,EAAgB,GAChB,iBAAAC,EACA,gBAAAC,EAAkB,WAClB,mBAAAC,EAAqB,mBACvB,IAAyC,CAEvC,IAAIC,EAA2C,CAAC,EAC5CJ,IACGC,EAGHG,EAAmB,MAAMb,EAAoBW,EAAiBD,EAAkBE,CAAkB,EAFlG,QAAQ,KAAK,uEAAuE,GAOxF,MAAME,EAAWP,EAAO,KAAK,UAAUA,CAAI,EAAI,OAEzCQ,EAAa,IAAI,gBACvB,IAAIC,EACAR,IACFQ,EAAe,WAAW,IAAMD,EAAW,MAAM,EAAGP,CAAO,GAG7D,GAAI,CACF,MAAMS,EAAW,MAAM,MAAMb,EAAK,CAChC,OAAAC,EACA,KAAM,OACN,QAAS,CACP,eAAgB,mBAChB,GAAGC,EACH,GAAGO,CACL,EACA,OAAQE,EAAW,OACnB,GAAIV,IAAW,OAASS,GAAY,CAAE,KAAMA,CAAS,CACvD,CAAC,EAED,OAAIE,GACF,aAAaA,CAAY,EAGpBC,CACT,OAASlB,EAAO,CACd,MAAIiB,GACF,aAAaA,CAAY,EAErBjB,CACR,CACF",
+  "names": ["executeRecaptcha", "action", "sitekey", "error", "getRecaptchaHeaders", "headerKey", "recaptchaToken", "fetcher", "url", "method", "headers", "body", "timeout", "needRecaptcha", "recaptchaSitekey", "recaptchaAction", "recaptchaHeaderKey", "recaptchaHeaders", "bodyData", "controller", "timeoutTimer", "response"]
+}

package/dist/esm/stories/LiveChatWidget.stories.d.ts

@@ -90,3 +90,11 @@ export declare const ProductComparisonMessage: Story;
  * FAQ 组件会显示搜索结果的常见问题，每个问题可以点击展开查看答案。
  */
 export declare const FAQListMessage: Story;
+/**
+ * 带 reCAPTCHA 配置
+ *
+ * 展示如何配置 Google reCAPTCHA v3 验证，保护 API 请求免受滥用。
+ *
+ * reCAPTCHA 会在后台自动验证用户行为，无需用户手动操作。
+ */
+export declare const WithRecaptcha: Story;

package/dist/esm/stories/LiveChatWidget.stories.js

@@ -1,4 +1,4 @@
-import{jsx as t,jsxs as n}from"react/jsx-runtime";import{LiveChatWidget as s}from"../components/LiveChatWidget";import"../styles/livechat.css";const l={title:"Campaign/LiveChatWidget",component:s,parameters:{layout:"fullscreen",docs:{story:{inline:!1,iframeHeight:500},description:{component:`
+import{jsx as t,jsxs as c}from"react/jsx-runtime";import{LiveChatWidget as a}from"../components/LiveChatWidget";import"../styles/livechat.css";const n={title:"Campaign/LiveChatWidget",component:a,parameters:{layout:"fullscreen",docs:{story:{inline:!1,iframeHeight:500},description:{component:`
 # LiveChat \u804A\u5929\u7EC4\u4EF6
 
 \u53EF\u590D\u7528\u7684\u6C14\u6CE1\u5F39\u7A97\u804A\u5929\u7EC4\u4EF6\uFF0C\u652F\u6301 SSE \u6D41\u5F0F\u6D88\u606F\u3001\u81EA\u5B9A\u4E49\u6E32\u67D3\u5668\u548C\u591A\u79CD\u6D88\u606F\u7C7B\u578B\u3002
@@ -47,7 +47,7 @@ const customRenderers = {
   customRenderers={customRenderers}
 />
 \`\`\`
-        `}}},tags:["autodocs"],argTypes:{apiBaseUrl:{control:"text",description:"API \u57FA\u7840 URL"},headers:{control:"object",description:"\u81EA\u5B9A\u4E49\u8BF7\u6C42\u5934\uFF0C\u5C06\u5728\u6240\u6709 API \u8BF7\u6C42\u4E2D\u6DFB\u52A0",table:{defaultValue:{summary:"undefined"}}},site:{control:"text",description:"Shopify \u5E97\u94FA URL"},welcomeMessage:{control:"text",description:"\u6B22\u8FCE\u6D88\u606F",table:{defaultValue:{summary:"\u4F60\u597D\uFF01\u6211\u662F AI \u52A9\u624B\uFF0C\u6709\u4EC0\u4E48\u53EF\u4EE5\u5E2E\u52A9\u4F60\u7684\u5417\uFF1F"}}},logoUrl:{control:"text",description:"Logo URL"},position:{control:"object",description:"\u6C14\u6CE1\u6309\u94AE\u4F4D\u7F6E\u5BF9\u8C61",table:{defaultValue:{summary:'{ bottom: "1.5rem", right: "1.5rem" }'}}}},args:{apiBaseUrl:"http://172.16.38.183:3003",site:"www.eufy.com",loginUserId:"test_test",welcomeMessage:"\u4F60\u597D\uFF01\u6211\u662F AI \u52A9\u624B\uFF0C\u6709\u4EC0\u4E48\u53EF\u4EE5\u5E2E\u52A9\u4F60\u7684\u5417\uFF1F"}};var m=l;const g={args:{loginUserId:"test_test",apiBaseUrl:"https://beta-api-v2-livechat.anker.com",cartId:"gid://shopify/Cart/hWN7oFnMh7jKxbO1CYSzWVue?key=68f4cf2c4c772b9aed2fab2902e6dab3",accessToken:"92301d516a0a38a0a483bc230e5bfaad",title:"eufy",commonText:{learnMore:"Learn More"},site:"beta.eufy.com",headers:{"X-Recaptcha-Sitekey":"6LfS4J4pAAAAACX1e_WrxutmxxzCK7FU4WzVqL14",recaptcha:""}}},p={args:{position:{bottom:"1.5rem",left:"1.5rem"}}},u={args:{logoUrl:"https://images.unsplash.com/photo-1599305445671-ac291c95aaa9?w=100&h=100&fit=crop",welcomeMessage:"\u6B22\u8FCE\u6765\u5230 Soundcore\uFF01\u6211\u662F\u60A8\u7684\u4E13\u5C5E AI \u52A9\u624B \u{1F3A7}"}},y={args:{quickReplies:[{id:"1",label:"\u67E5\u8BE2\u4EF7\u683C",value:"\u6211\u60F3\u4E86\u89E3\u4EA7\u54C1\u4EF7\u683C",icon:"\u{1F4B0}"},{id:"2",label:"\u67E5\u8BE2\u7269\u6D41",value:"\u6211\u60F3\u67E5\u8BE2\u8BA2\u5355\u7269\u6D41",icon:"\u{1F4E6}"},{id:"3",label:"\u552E\u540E\u670D\u52A1",value:"\u6211\u9700\u8981\u552E\u540E\u5E2E\u52A9",icon:"\u{1F527}"},{id:"4",label:"\u4EA7\u54C1\u63A8\u8350",value:"\u8BF7\u63A8\u8350\u9002\u5408\u6211\u7684\u4EA7\u54C1",icon:"\u2B50"}]}},h={args:{welcomeMessage:`
+        `}}},tags:["autodocs"],argTypes:{apiBaseUrl:{control:"text",description:"API \u57FA\u7840 URL"},headers:{control:"object",description:"\u81EA\u5B9A\u4E49\u8BF7\u6C42\u5934\uFF0C\u5C06\u5728\u6240\u6709 API \u8BF7\u6C42\u4E2D\u6DFB\u52A0",table:{defaultValue:{summary:"undefined"}}},needRecaptcha:{control:"boolean",description:"\u662F\u5426\u542F\u7528 Google reCAPTCHA v3 \u9A8C\u8BC1",table:{defaultValue:{summary:"false"}}},recaptchaSitekey:{control:"text",description:"Google reCAPTCHA v3 site key",table:{defaultValue:{summary:"undefined"}}},recaptchaAction:{control:"text",description:"reCAPTCHA action \u540D\u79F0\uFF0C\u7528\u4E8E\u533A\u5206\u4E0D\u540C\u7684\u9A8C\u8BC1\u573A\u666F",table:{defaultValue:{summary:'"activity"'}}},site:{control:"text",description:"Shopify \u5E97\u94FA URL"},welcomeMessage:{control:"text",description:"\u6B22\u8FCE\u6D88\u606F",table:{defaultValue:{summary:"\u4F60\u597D\uFF01\u6211\u662F AI \u52A9\u624B\uFF0C\u6709\u4EC0\u4E48\u53EF\u4EE5\u5E2E\u52A9\u4F60\u7684\u5417\uFF1F"}}},logoUrl:{control:"text",description:"Logo URL"},position:{control:"object",description:"\u6C14\u6CE1\u6309\u94AE\u4F4D\u7F6E\u5BF9\u8C61",table:{defaultValue:{summary:'{ bottom: "1.5rem", right: "1.5rem" }'}}}},args:{apiBaseUrl:"http://172.16.38.183:3003",site:"www.eufy.com",loginUserId:"test_test",welcomeMessage:"\u4F60\u597D\uFF01\u6211\u662F AI \u52A9\u624B\uFF0C\u6709\u4EC0\u4E48\u53EF\u4EE5\u5E2E\u52A9\u4F60\u7684\u5417\uFF1F"}};var p=n;const m={args:{loginUserId:"test_test",apiBaseUrl:"https://beta-api-v2-livechat.anker.com",cartId:"gid://shopify/Cart/hWN7oFnMh7jKxbO1CYSzWVue?key=68f4cf2c4c772b9aed2fab2902e6dab3",accessToken:"92301d516a0a38a0a483bc230e5bfaad",title:"eufy",commonText:{learnMore:"Learn More"},site:"beta.eufy.com",needRecaptcha:!0,recaptchaSitekey:"6LfS4J4pAAAAACX1e_WrxutmxxzCK7FU4WzVqL14 999testtest",recaptchaAction:"chat"}},g={args:{position:{bottom:"1.5rem",left:"1.5rem"}}},u={args:{logoUrl:"https://images.unsplash.com/photo-1599305445671-ac291c95aaa9?w=100&h=100&fit=crop",welcomeMessage:"\u6B22\u8FCE\u6765\u5230 Soundcore\uFF01\u6211\u662F\u60A8\u7684\u4E13\u5C5E AI \u52A9\u624B \u{1F3A7}"}},y={args:{quickReplies:[{id:"1",label:"\u67E5\u8BE2\u4EF7\u683C",value:"\u6211\u60F3\u4E86\u89E3\u4EA7\u54C1\u4EF7\u683C",icon:"\u{1F4B0}"},{id:"2",label:"\u67E5\u8BE2\u7269\u6D41",value:"\u6211\u60F3\u67E5\u8BE2\u8BA2\u5355\u7269\u6D41",icon:"\u{1F4E6}"},{id:"3",label:"\u552E\u540E\u670D\u52A1",value:"\u6211\u9700\u8981\u552E\u540E\u5E2E\u52A9",icon:"\u{1F527}"},{id:"4",label:"\u4EA7\u54C1\u63A8\u8350",value:"\u8BF7\u63A8\u8350\u9002\u5408\u6211\u7684\u4EA7\u54C1",icon:"\u2B50"}]}},h={args:{welcomeMessage:`
 \u{1F44B} \u60A8\u597D\uFF01\u6B22\u8FCE\u6765\u5230 Soundcore \u5B98\u65B9\u5546\u57CE\u3002
 
 \u6211\u662F\u60A8\u7684 AI \u8D2D\u7269\u52A9\u624B\uFF0C\u53EF\u4EE5\u5E2E\u60A8\uFF1A
@@ -57,12 +57,12 @@ const customRenderers = {
 - \u{1F4AC} \u89E3\u7B54\u7591\u95EE
 
 \u6709\u4EC0\u4E48\u6211\u53EF\u4EE5\u5E2E\u52A9\u60A8\u7684\u5417\uFF1F
-    `.trim()}},f={args:{title:"",showNewSessionButton:!0,position:{bottom:"24px",right:"30px"},chatBubbleIcon:"https://cdn.shopify.com/s/files/1/0504/7094/4954/files/Rectangle_400770314.png?v=1768894153",headers:{"X-Custom-Header":"custom-value",Authorization:"Bearer your-token-here"}},render:o=>t(s,{...o,onOpen:()=>{console.log("[Story] Chat opened")},onClose:()=>{console.log("[Story] Chat closed")},onMessageSend:e=>{console.log("[Story] Message sent:",e)},onError:e=>{console.error("[Story] Error occurred:",e)},onTextMessage:()=>{console.log("\u{1F4DD} [Story] AI started replying with text message")},onProductList:()=>{console.log("\u{1F4E6} [Story] AI replied with product list card")},onPromotionList:()=>{console.log("\u{1F389} [Story] AI replied with promotion list card")},onAddToCart:e=>{console.log("\u{1F6D2} [Story] Add to Cart clicked!"),console.log("\u{1F4E6} Product Info:",{id:e.shopifyId,title:e.title,price:e.price,imageUrl:e.imageUrl,productUrl:e.productUrl}),console.log("\u{1F4CB} Full Product Object:",e),alert(`\u2705 "${e.title}" \u5DF2\u6DFB\u52A0\u5230\u8D2D\u7269\u8F66\uFF01
+    `.trim()}},C={args:{title:"",showNewSessionButton:!0,position:{bottom:"24px",right:"30px"},chatBubbleIcon:"https://cdn.shopify.com/s/files/1/0504/7094/4954/files/Rectangle_400770314.png?v=1768894153",headers:{"X-Custom-Header":"custom-value",Authorization:"Bearer your-token-here"}},render:o=>t(a,{...o,onOpen:()=>{console.log("[Story] Chat opened")},onClose:()=>{console.log("[Story] Chat closed")},onMessageSend:e=>{console.log("[Story] Message sent:",e)},onError:e=>{console.error("[Story] Error occurred:",e)},onTextMessage:()=>{console.log("\u{1F4DD} [Story] AI started replying with text message")},onProductList:()=>{console.log("\u{1F4E6} [Story] AI replied with product list card")},onPromotionList:()=>{console.log("\u{1F389} [Story] AI replied with promotion list card")},onAddToCart:e=>{console.log("\u{1F6D2} [Story] Add to Cart clicked!"),console.log("\u{1F4E6} Product Info:",{id:e.shopifyId,title:e.title,price:e.price,imageUrl:e.imageUrl,productUrl:e.productUrl}),console.log("\u{1F4CB} Full Product Object:",e),alert(`\u2705 "${e.title}" \u5DF2\u6DFB\u52A0\u5230\u8D2D\u7269\u8F66\uFF01
 
 \u4EF7\u683C: ${e.price.currency} ${e.price.amount}`)},onCart:(e,r)=>{console.log("\u{1F6D2} [Story] Cart button clicked!"),console.log("\u{1F4CB} Cart ID:",e),console.log("\u{1F517} Checkout URL:",r),alert(`\u8D2D\u7269\u8F66\u6309\u94AE\u88AB\u70B9\u51FB\uFF01
 
 Cart ID: ${e}
-Checkout URL: ${r||"\u65E0"}`)}})},v={args:{customRenderers:{video:{render:o=>{const e=o;return n("div",{className:"w-full",children:[t("video",{src:e.url,controls:!0,className:"w-full rounded-lg",poster:e.poster,children:"\u60A8\u7684\u6D4F\u89C8\u5668\u4E0D\u652F\u6301\u89C6\u9891\u64AD\u653E"}),e.title&&t("p",{className:"mt-2 text-sm text-gray-600",children:e.title})]})}}}}},C={args:{customRenderers:{image_gallery:{render:o=>{const r=o.images||[];return t("div",{className:"grid grid-cols-2 gap-2",children:r.map((a,i)=>t("div",{className:"relative aspect-square",children:t("img",{src:a.url,alt:a.alt||`Image ${i+1}`,className:"size-full rounded-lg object-cover"})},i))})}}}}},b={parameters:{viewport:{defaultViewport:"mobile1"}},args:{}},S={parameters:{viewport:{defaultViewport:"tablet"}},args:{}},w={render:()=>n("div",{className:"relative h-screen w-full bg-gray-50",children:[t("div",{className:"absolute inset-0 flex items-center justify-center",children:t("p",{className:"text-gray-500",children:"\u9875\u9762\u5185\u5BB9\u533A\u57DF"})}),t("div",{className:"absolute bottom-4 right-4 text-xs text-gray-400",children:"\u9ED8\u8BA4\u4F4D\u7F6E (\u53F3\u4E0B\u89D2)"}),t(s,{apiBaseUrl:"https://beta-api-livechat.anker.com",site:"www.eufy.com"})]})},x={render:o=>t(s,{...o,onAddToCart:e=>{console.log("\u{1F6D2} [ProductComparison Story] Add to Cart clicked!"),console.log("\u{1F4E6} Product Info:",{id:e.shopifyId,title:e.title,price:e.price,imageUrl:e.imageUrl,productUrl:e.productUrl}),console.log("\u{1F4CB} Full Product Object:",e),alert(`\u2705 "${e.title}" \u5DF2\u6DFB\u52A0\u5230\u8D2D\u7269\u8F66\uFF01
+Checkout URL: ${r||"\u65E0"}`)}})},A={args:{customRenderers:{video:{render:o=>{const e=o;return c("div",{className:"w-full",children:[t("video",{src:e.url,controls:!0,className:"w-full rounded-lg",poster:e.poster,children:"\u60A8\u7684\u6D4F\u89C8\u5668\u4E0D\u652F\u6301\u89C6\u9891\u64AD\u653E"}),e.title&&t("p",{className:"mt-2 text-sm text-gray-600",children:e.title})]})}}}}},v={args:{customRenderers:{image_gallery:{render:o=>{const r=o.images||[];return t("div",{className:"grid grid-cols-2 gap-2",children:r.map((s,i)=>t("div",{className:"relative aspect-square",children:t("img",{src:s.url,alt:s.alt||`Image ${i+1}`,className:"size-full rounded-lg object-cover"})},i))})}}}}},f={parameters:{viewport:{defaultViewport:"mobile1"}},args:{}},S={parameters:{viewport:{defaultViewport:"tablet"}},args:{}},b={render:()=>c("div",{className:"relative h-screen w-full bg-gray-50",children:[t("div",{className:"absolute inset-0 flex items-center justify-center",children:t("p",{className:"text-gray-500",children:"\u9875\u9762\u5185\u5BB9\u533A\u57DF"})}),t("div",{className:"absolute bottom-4 right-4 text-xs text-gray-400",children:"\u9ED8\u8BA4\u4F4D\u7F6E (\u53F3\u4E0B\u89D2)"}),t(a,{apiBaseUrl:"https://beta-api-livechat.anker.com",site:"www.eufy.com"})]})},x={render:o=>t(a,{...o,onAddToCart:e=>{console.log("\u{1F6D2} [ProductComparison Story] Add to Cart clicked!"),console.log("\u{1F4E6} Product Info:",{id:e.shopifyId,title:e.title,price:e.price,imageUrl:e.imageUrl,productUrl:e.productUrl}),console.log("\u{1F4CB} Full Product Object:",e),alert(`\u2705 "${e.title}" \u5DF2\u6DFB\u52A0\u5230\u8D2D\u7269\u8F66\uFF01
 
 \u4EF7\u683C: ${e.price.currency} ${e.price.amount}`)}}),args:{welcomeMessage:"\u4EE5\u4E0B\u662F\u60A8\u5173\u6CE8\u7684\u4EA7\u54C1\u5BF9\u6BD4\u4FE1\u606F\uFF1A"},parameters:{docs:{description:{story:`
 \u4EA7\u54C1\u5BF9\u6BD4\u6D88\u606F\u652F\u6301\u4EE5\u4E0B\u7EF4\u5EA6\uFF1A
@@ -81,7 +81,7 @@ Checkout URL: ${r||"\u65E0"}`)}})},v={args:{customRenderers:{video:{render:o=>{c
 - \u70B9\u51FB\u4EA7\u54C1\u5BF9\u6BD4\u5361\u7247\u4E2D\u7684 "Add to Cart" \u6309\u94AE
 - \u67E5\u770B\u63A7\u5236\u53F0\u8F93\u51FA\u7684\u4EA7\u54C1\u4FE1\u606F
 - \u4F1A\u5F39\u51FA\u786E\u8BA4\u63D0\u793A\u6846\u663E\u793A\u5DF2\u6DFB\u52A0\u5230\u8D2D\u7269\u8F66
-        `}}}},A={args:{welcomeMessage:"\u4EE5\u4E0B\u662F\u4E0E\u60A8\u7684\u95EE\u9898\u76F8\u5173\u7684\u5E38\u89C1\u89E3\u7B54\uFF1A"},parameters:{docs:{description:{story:`
+        `}}}},w={args:{welcomeMessage:"\u4EE5\u4E0B\u662F\u4E0E\u60A8\u7684\u95EE\u9898\u76F8\u5173\u7684\u5E38\u89C1\u89E3\u7B54\uFF1A"},parameters:{docs:{description:{story:`
 FAQ \u5217\u8868\u6D88\u606F\u652F\u6301\uFF1A
 
 - **\u53EF\u6298\u53E0\u95EE\u9898**: \u70B9\u51FB\u95EE\u9898\u6807\u9898\u5C55\u5F00/\u6298\u53E0\u7B54\u6848
@@ -94,5 +94,37 @@ FAQ \u5217\u8868\u6D88\u606F\u652F\u6301\uFF1A
 - \u7528\u6237\u8BE2\u95EE\u5E38\u89C1\u95EE\u9898\u65F6\u8FD4\u56DE FAQ \u5217\u8868
 - \u4EA7\u54C1\u4E13\u5C5E\u95EE\u9898\u67E5\u8BE2
 - \u6309\u5206\u7C7B\u67E5\u8BE2 FAQ
-        `}}}};export{u as CustomBranding,C as CustomImageGalleryRenderer,p as CustomPosition,v as CustomVideoRenderer,h as CustomWelcomeMessage,g as Default,w as DefaultPositionDemo,A as FAQListMessage,b as MobileView,x as ProductComparisonMessage,S as TabletView,f as WithEventCallbacks,y as WithQuickReplies,m as default};
+        `}}}},k={args:{needRecaptcha:!0,recaptchaSitekey:"6LfS4J4pAAAAACX1e_WrxutmxxzCK7FU4WzVqL14",recaptchaAction:"livechat"},parameters:{docs:{description:{story:`
+### reCAPTCHA v3 \u914D\u7F6E
+
+\u542F\u7528 reCAPTCHA v3 \u53EF\u4EE5\u4FDD\u62A4\u4F60\u7684 API \u514D\u53D7\u673A\u5668\u4EBA\u548C\u6EE5\u7528\u884C\u4E3A\u7684\u653B\u51FB\u3002
+
+**\u914D\u7F6E\u6B65\u9AA4\uFF1A**
+
+1. \u5728 [Google reCAPTCHA](https://www.google.com/recaptcha/admin) \u521B\u5EFA v3 \u5BC6\u94A5
+2. \u5728\u9875\u9762\u4E2D\u52A0\u8F7D reCAPTCHA \u811A\u672C\uFF1A
+   \`\`\`html
+   <script src="https://www.google.com/recaptcha/api.js?render=YOUR_SITE_KEY"><\/script>
+   \`\`\`
+3. \u914D\u7F6E LiveChatWidget \u7EC4\u4EF6\uFF1A
+   \`\`\`tsx
+   <LiveChatWidget
+     needRecaptcha={true}
+     recaptchaSitekey="YOUR_SITE_KEY"
+     recaptchaAction="livechat"
+   />
+   \`\`\`
+
+**\u5DE5\u4F5C\u539F\u7406\uFF1A**
+
+- \u6BCF\u6B21\u53D1\u9001\u6D88\u606F\u6216\u521B\u5EFA\u4F1A\u8BDD\u65F6\uFF0C\u4F1A\u81EA\u52A8\u83B7\u53D6 reCAPTCHA token
+- token \u4F1A\u901A\u8FC7 \`X-Recaptcha-Token\` header \u53D1\u9001\u5230\u540E\u7AEF
+- \u540E\u7AEF\u9700\u8981\u9A8C\u8BC1 token \u7684\u6709\u6548\u6027
+
+**\u6CE8\u610F\u4E8B\u9879\uFF1A**
+
+- reCAPTCHA v3 \u5728\u540E\u53F0\u8FD0\u884C\uFF0C\u4E0D\u4F1A\u6253\u65AD\u7528\u6237\u4F53\u9A8C
+- \u5EFA\u8BAE\u4E3A\u4E0D\u540C\u7684\u64CD\u4F5C\u4F7F\u7528\u4E0D\u540C\u7684 \`recaptchaAction\` \u4EE5\u4FBF\u5206\u6790
+- \u786E\u4FDD\u540E\u7AEF\u6B63\u786E\u9A8C\u8BC1 reCAPTCHA token
+        `}}}};export{u as CustomBranding,v as CustomImageGalleryRenderer,g as CustomPosition,A as CustomVideoRenderer,h as CustomWelcomeMessage,m as Default,b as DefaultPositionDemo,w as FAQListMessage,f as MobileView,x as ProductComparisonMessage,S as TabletView,C as WithEventCallbacks,y as WithQuickReplies,k as WithRecaptcha,p as default};
 //# sourceMappingURL=LiveChatWidget.stories.js.map

package/dist/esm/stories/LiveChatWidget.stories.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/stories/LiveChatWidget.stories.tsx"],
-  "sourcesContent": ["/**\n * LiveChatWidget Storybook Stories\n * \u5C55\u793A LiveChat \u7EC4\u4EF6\u7684\u5404\u79CD\u4F7F\u7528\u573A\u666F\u548C\u914D\u7F6E\n */\n\nimport type { Meta, StoryObj } from '@storybook/react'\nimport { LiveChatWidget } from '../components/LiveChatWidget'\nimport type { MessageRenderer, MessageContent } from '../components/LiveChatWidget'\nimport '../styles/livechat.css'\n\nconst meta: Meta<typeof LiveChatWidget> = {\n  title: 'Campaign/LiveChatWidget',\n  component: LiveChatWidget,\n  parameters: {\n    layout: 'fullscreen',\n    docs: {\n      story: {\n        inline: false,\n        iframeHeight: 500,\n      },\n      description: {\n        component: `\n# LiveChat \u804A\u5929\u7EC4\u4EF6\n\n\u53EF\u590D\u7528\u7684\u6C14\u6CE1\u5F39\u7A97\u804A\u5929\u7EC4\u4EF6\uFF0C\u652F\u6301 SSE \u6D41\u5F0F\u6D88\u606F\u3001\u81EA\u5B9A\u4E49\u6E32\u67D3\u5668\u548C\u591A\u79CD\u6D88\u606F\u7C7B\u578B\u3002\n\n## \u529F\u80FD\u7279\u6027\n\n- \uD83C\uDF88 **\u6C14\u6CE1\u5F39\u7A97**: \u53EF\u81EA\u5B9A\u4E49\u4F4D\u7F6E\u7684\u60AC\u6D6E\u6C14\u6CE1\u6309\u94AE\n- \uD83D\uDCAC **\u6D41\u5F0F\u6D88\u606F**: \u57FA\u4E8E SSE \u7684\u5B9E\u65F6\u6D41\u5F0F\u54CD\u5E94\n- \uD83D\uDCE6 **\u591A\u79CD\u6D88\u606F\u7C7B\u578B**: \u6587\u672C\u3001\u5546\u54C1\u5361\u7247\u3001\u5546\u54C1\u5217\u8868\u3001\u653F\u7B56\u3001\u5FEB\u6377\u56DE\u590D\u7B49\n- \uD83C\uDFA8 **\u53EF\u5B9A\u5236**: \u652F\u6301\u81EA\u5B9A\u4E49\u54C1\u724C\u989C\u8272\u3001Logo\u3001\u6E32\u67D3\u5668\n- \uD83D\uDCF1 **\u54CD\u5E94\u5F0F**: \u79FB\u52A8\u7AEF\u5168\u5C4F\uFF0C\u684C\u9762\u7AEF\u56FA\u5B9A\u5C3A\u5BF8\n- \uD83D\uDCBE **\u4F1A\u8BDD\u7BA1\u7406**: \u81EA\u52A8\u7BA1\u7406 userId \u548C sessionId\n- \uD83D\uDD12 **\u5B89\u5168\u9632\u62A4**: \u5185\u7F6E XSS \u9632\u62A4\u548C\u8F93\u5165\u9A8C\u8BC1\n\n## \u57FA\u7840\u7528\u6CD5\n\n\\`\\`\\`tsx\nimport { LiveChatWidget } from '@anker-in/campaign-ui'\nimport '@anker-in/campaign-ui/livechat.css'\n\nfunction App() {\n  return (\n    <LiveChatWidget\n      apiBaseUrl=\"https://beta-api-livechat.anker.com\"\n      site=\"www.eufy.com\"\n      welcomeMessage=\"\u4F60\u597D\uFF01\u6211\u662F AI \u52A9\u624B\"\n    />\n  )\n}\n\\`\\`\\`\n\n## \u81EA\u5B9A\u4E49\u6E32\u67D3\u5668\n\n\\`\\`\\`tsx\nconst customRenderers = {\n  video: {\n    render: (content) => (\n      <video src={content.url} controls className=\"w-full rounded\" />\n    )\n  }\n}\n\n<LiveChatWidget\n  apiBaseUrl=\"...\"\n  site=\"...\"\n  customRenderers={customRenderers}\n/>\n\\`\\`\\`\n        `,\n      },\n    },\n  },\n  tags: ['autodocs'],\n  argTypes: {\n    apiBaseUrl: {\n      control: 'text',\n      description: 'API \u57FA\u7840 URL',\n    },\n    headers: {\n      control: 'object',\n      description: '\u81EA\u5B9A\u4E49\u8BF7\u6C42\u5934\uFF0C\u5C06\u5728\u6240\u6709 API \u8BF7\u6C42\u4E2D\u6DFB\u52A0',\n      table: {\n        defaultValue: { summary: 'undefined' },\n      },\n    },\n    site: {\n      control: 'text',\n      description: 'Shopify \u5E97\u94FA URL',\n    },\n    welcomeMessage: {\n      control: 'text',\n      description: '\u6B22\u8FCE\u6D88\u606F',\n      table: {\n        defaultValue: { summary: '\u4F60\u597D\uFF01\u6211\u662F AI \u52A9\u624B\uFF0C\u6709\u4EC0\u4E48\u53EF\u4EE5\u5E2E\u52A9\u4F60\u7684\u5417\uFF1F' },\n      },\n    },\n    logoUrl: {\n      control: 'text',\n      description: 'Logo URL',\n    },\n    position: {\n      control: 'object',\n      description: '\u6C14\u6CE1\u6309\u94AE\u4F4D\u7F6E\u5BF9\u8C61',\n      table: {\n        defaultValue: { summary: '{ bottom: \"1.5rem\", right: \"1.5rem\" }' },\n      },\n    },\n  },\n  args: {\n    apiBaseUrl: 'http://172.16.38.183:3003',\n    site: 'www.eufy.com',\n    loginUserId: 'test_test',\n    welcomeMessage: '\u4F60\u597D\uFF01\u6211\u662F AI \u52A9\u624B\uFF0C\u6709\u4EC0\u4E48\u53EF\u4EE5\u5E2E\u52A9\u4F60\u7684\u5417\uFF1F',\n  },\n}\n\nexport default meta\ntype Story = StoryObj<typeof LiveChatWidget>\n\n/**\n * \u9ED8\u8BA4\u914D\u7F6E\n *\n * \u6700\u7B80\u5355\u7684\u4F7F\u7528\u65B9\u5F0F\uFF0C\u4F7F\u7528\u9ED8\u8BA4\u914D\u7F6E\u3002\n */\nexport const Default: Story = {\n  args: {\n    loginUserId: 'test_test',\n    apiBaseUrl: 'https://beta-api-v2-livechat.anker.com',\n    cartId: 'gid://shopify/Cart/hWN7oFnMh7jKxbO1CYSzWVue?key=68f4cf2c4c772b9aed2fab2902e6dab3',\n    accessToken: '92301d516a0a38a0a483bc230e5bfaad',\n    title: 'eufy',\n\n    commonText: {\n      learnMore: 'Learn More',\n    },\n\n    site: 'beta.eufy.com',\n\n    headers: {\n      'X-Recaptcha-Sitekey': '6LfS4J4pAAAAACX1e_WrxutmxxzCK7FU4WzVqL14',\n      recaptcha: '',\n    },\n  },\n}\n\n/**\n * \u81EA\u5B9A\u4E49\u4F4D\u7F6E\n *\n * \u4F7F\u7528\u81EA\u5B9A\u4E49\u4F4D\u7F6E\u5BF9\u8C61\u6765\u63A7\u5236\u6C14\u6CE1\u6309\u94AE\u7684\u4F4D\u7F6E\u3002\n */\nexport const CustomPosition: Story = {\n  args: {\n    position: { bottom: '1.5rem', left: '1.5rem' },\n  },\n}\n\n/**\n * \u81EA\u5B9A\u4E49\u54C1\u724C\u6837\u5F0F\n *\n * \u81EA\u5B9A\u4E49 Logo \u548C\u6B22\u8FCE\u6D88\u606F\u3002\n */\nexport const CustomBranding: Story = {\n  args: {\n    logoUrl: 'https://images.unsplash.com/photo-1599305445671-ac291c95aaa9?w=100&h=100&fit=crop',\n    welcomeMessage: '\u6B22\u8FCE\u6765\u5230 Soundcore\uFF01\u6211\u662F\u60A8\u7684\u4E13\u5C5E AI \u52A9\u624B \uD83C\uDFA7',\n  },\n}\n\n/**\n * \u5E26\u5FEB\u6377\u56DE\u590D\n *\n * \u5728\u6B22\u8FCE\u6D88\u606F\u540E\u663E\u793A\u5FEB\u6377\u56DE\u590D\u6309\u94AE\u3002\n */\nexport const WithQuickReplies: Story = {\n  args: {\n    quickReplies: [\n      {\n        id: '1',\n        label: '\u67E5\u8BE2\u4EF7\u683C',\n        value: '\u6211\u60F3\u4E86\u89E3\u4EA7\u54C1\u4EF7\u683C',\n        icon: '\uD83D\uDCB0',\n      },\n      {\n        id: '2',\n        label: '\u67E5\u8BE2\u7269\u6D41',\n        value: '\u6211\u60F3\u67E5\u8BE2\u8BA2\u5355\u7269\u6D41',\n        icon: '\uD83D\uDCE6',\n      },\n      {\n        id: '3',\n        label: '\u552E\u540E\u670D\u52A1',\n        value: '\u6211\u9700\u8981\u552E\u540E\u5E2E\u52A9',\n        icon: '\uD83D\uDD27',\n      },\n      {\n        id: '4',\n        label: '\u4EA7\u54C1\u63A8\u8350',\n        value: '\u8BF7\u63A8\u8350\u9002\u5408\u6211\u7684\u4EA7\u54C1',\n        icon: '\u2B50',\n      },\n    ],\n  },\n}\n\n/**\n * \u81EA\u5B9A\u4E49\u6B22\u8FCE\u6D88\u606F\n *\n * \u81EA\u5B9A\u4E49\u9996\u6B21\u6253\u5F00\u804A\u5929\u7A97\u53E3\u65F6\u7684\u6B22\u8FCE\u6D88\u606F\u3002\n */\nexport const CustomWelcomeMessage: Story = {\n  args: {\n    welcomeMessage: `\n\uD83D\uDC4B \u60A8\u597D\uFF01\u6B22\u8FCE\u6765\u5230 Soundcore \u5B98\u65B9\u5546\u57CE\u3002\n\n\u6211\u662F\u60A8\u7684 AI \u8D2D\u7269\u52A9\u624B\uFF0C\u53EF\u4EE5\u5E2E\u60A8\uFF1A\n- \uD83D\uDD0D \u67E5\u627E\u4EA7\u54C1\n- \uD83D\uDCB0 \u6BD4\u8F83\u4EF7\u683C\n- \uD83D\uDCE6 \u8DDF\u8E2A\u8BA2\u5355\n- \uD83D\uDCAC \u89E3\u7B54\u7591\u95EE\n\n\u6709\u4EC0\u4E48\u6211\u53EF\u4EE5\u5E2E\u52A9\u60A8\u7684\u5417\uFF1F\n    `.trim(),\n  },\n}\n\n/**\n * \u4E8B\u4EF6\u56DE\u8C03\n *\n * \u76D1\u542C\u7EC4\u4EF6\u4E8B\u4EF6\u8FDB\u884C\u81EA\u5B9A\u4E49\u5904\u7406\u3002\n */\nexport const WithEventCallbacks: Story = {\n  args: {\n    title: '',\n    showNewSessionButton: true,\n\n    position: {\n      bottom: '24px',\n      right: '30px',\n    },\n\n    chatBubbleIcon: 'https://cdn.shopify.com/s/files/1/0504/7094/4954/files/Rectangle_400770314.png?v=1768894153',\n\n    // \u81EA\u5B9A\u4E49\u8BF7\u6C42\u5934\u793A\u4F8B\n    headers: {\n      'X-Custom-Header': 'custom-value',\n      Authorization: 'Bearer your-token-here',\n    },\n  },\n\n  render: args => (\n    <LiveChatWidget\n      {...args}\n      onOpen={() => {\n        console.log('[Story] Chat opened')\n      }}\n      onClose={() => {\n        console.log('[Story] Chat closed')\n      }}\n      onMessageSend={(message: string) => {\n        console.log('[Story] Message sent:', message)\n      }}\n      onError={(error: Error) => {\n        console.error('[Story] Error occurred:', error)\n      }}\n      onTextMessage={() => {\n        console.log('\uD83D\uDCDD [Story] AI started replying with text message')\n      }}\n      onProductList={() => {\n        console.log('\uD83D\uDCE6 [Story] AI replied with product list card')\n      }}\n      onPromotionList={() => {\n        console.log('\uD83C\uDF89 [Story] AI replied with promotion list card')\n      }}\n      onAddToCart={(product: any) => {\n        console.log('\uD83D\uDED2 [Story] Add to Cart clicked!')\n        console.log('\uD83D\uDCE6 Product Info:', {\n          id: product.shopifyId,\n          title: product.title,\n          price: product.price,\n          imageUrl: product.imageUrl,\n          productUrl: product.productUrl,\n        })\n        console.log('\uD83D\uDCCB Full Product Object:', product)\n\n        // \u6A21\u62DF\u6DFB\u52A0\u5230\u8D2D\u7269\u8F66\u6210\u529F\n        alert(`\u2705 \"${product.title}\" \u5DF2\u6DFB\u52A0\u5230\u8D2D\u7269\u8F66\uFF01\\n\\n\u4EF7\u683C: ${product.price.currency} ${product.price.amount}`)\n      }}\n      onCart={(cartId: string, checkoutUrl?: string) => {\n        console.log('\uD83D\uDED2 [Story] Cart button clicked!')\n        console.log('\uD83D\uDCCB Cart ID:', cartId)\n        console.log('\uD83D\uDD17 Checkout URL:', checkoutUrl)\n\n        // \u6A21\u62DF\u8D2D\u7269\u8F66\u6309\u94AE\u70B9\u51FB\u6210\u529F\n        alert(`\u8D2D\u7269\u8F66\u6309\u94AE\u88AB\u70B9\u51FB\uFF01\\n\\nCart ID: ${cartId}\\nCheckout URL: ${checkoutUrl || '\u65E0'}`)\n      }}\n    />\n  ),\n}\n\n/**\n * \u81EA\u5B9A\u4E49\u89C6\u9891\u6D88\u606F\u6E32\u67D3\u5668\n *\n * \u6269\u5C55\u6D88\u606F\u7C7B\u578B\uFF0C\u6DFB\u52A0\u89C6\u9891\u6D88\u606F\u652F\u6301\u3002\n */\nexport const CustomVideoRenderer: Story = {\n  args: {\n    customRenderers: {\n      video: {\n        render: (content: MessageContent) => {\n          const videoContent = content as any\n          return (\n            <div className=\"w-full\">\n              <video src={videoContent.url} controls className=\"w-full rounded-lg\" poster={videoContent.poster}>\n                \u60A8\u7684\u6D4F\u89C8\u5668\u4E0D\u652F\u6301\u89C6\u9891\u64AD\u653E\n              </video>\n              {videoContent.title && <p className=\"mt-2 text-sm text-gray-600\">{videoContent.title}</p>}\n            </div>\n          )\n        },\n      } as MessageRenderer,\n    },\n  },\n}\n\n/**\n * \u81EA\u5B9A\u4E49\u56FE\u7247\u753B\u5ECA\u6E32\u67D3\u5668\n *\n * \u6269\u5C55\u6D88\u606F\u7C7B\u578B\uFF0C\u6DFB\u52A0\u56FE\u7247\u753B\u5ECA\u652F\u6301\u3002\n */\nexport const CustomImageGalleryRenderer: Story = {\n  args: {\n    customRenderers: {\n      image_gallery: {\n        render: (content: MessageContent) => {\n          const galleryContent = content as any\n          const images = galleryContent.images || []\n\n          return (\n            <div className=\"grid grid-cols-2 gap-2\">\n              {images.map((image: any, index: number) => (\n                <div key={index} className=\"relative aspect-square\">\n                  <img\n                    src={image.url}\n                    alt={image.alt || `Image ${index + 1}`}\n                    className=\"size-full rounded-lg object-cover\"\n                  />\n                </div>\n              ))}\n            </div>\n          )\n        },\n      } as MessageRenderer,\n    },\n  },\n}\n\n/**\n * \u79FB\u52A8\u7AEF\u9884\u89C8\n *\n * \u5728\u79FB\u52A8\u7AEF\u5C3A\u5BF8\u4E0B\u67E5\u770B\u6548\u679C\uFF08\u5168\u5C4F\u663E\u793A\uFF09\u3002\n */\nexport const MobileView: Story = {\n  parameters: {\n    viewport: {\n      defaultViewport: 'mobile1',\n    },\n  },\n  args: {},\n}\n\n/**\n * \u5E73\u677F\u7AEF\u9884\u89C8\n *\n * \u5728\u5E73\u677F\u7AEF\u5C3A\u5BF8\u4E0B\u67E5\u770B\u6548\u679C\u3002\n */\nexport const TabletView: Story = {\n  parameters: {\n    viewport: {\n      defaultViewport: 'tablet',\n    },\n  },\n  args: {},\n}\n\n/**\n * \u9ED8\u8BA4\u4F4D\u7F6E\u5C55\u793A\n *\n * \u5C55\u793A\u6C14\u6CE1\u6309\u94AE\u7684\u9ED8\u8BA4\u4F4D\u7F6E\uFF08\u53F3\u4E0B\u89D2\uFF09\u3002\n */\nexport const DefaultPositionDemo: Story = {\n  render: () => (\n    <div className=\"relative h-screen w-full bg-gray-50\">\n      <div className=\"absolute inset-0 flex items-center justify-center\">\n        <p className=\"text-gray-500\">\u9875\u9762\u5185\u5BB9\u533A\u57DF</p>\n      </div>\n\n      {/* \u6F14\u793A\u9ED8\u8BA4\u4F4D\u7F6E */}\n      <div className=\"absolute bottom-4 right-4 text-xs text-gray-400\">\u9ED8\u8BA4\u4F4D\u7F6E (\u53F3\u4E0B\u89D2)</div>\n\n      <LiveChatWidget apiBaseUrl=\"https://beta-api-livechat.anker.com\" site=\"www.eufy.com\" />\n    </div>\n  ),\n}\n\n/**\n * \u4EA7\u54C1\u5BF9\u6BD4\u6D88\u606F\n *\n * \u5C55\u793A\u4EA7\u54C1\u5BF9\u6BD4\u7C7B\u578B\u7684\u6D88\u606F\u6E32\u67D3\u6548\u679C\uFF0C\u5305\u62EC\u4EF7\u683C\u3001\u4F1A\u5458\u4EF7\u3001\u53D8\u4F53\u6570\u91CF\u3001\u6298\u6263\u7B49\u591A\u4E2A\u7EF4\u5EA6\u7684\u5BF9\u6BD4\u3002\n *\n * \u4EA7\u54C1\u5BF9\u6BD4\u7EC4\u4EF6\u4F1A\u4EE5\u7F51\u683C\u5E03\u5C40\u5C55\u793A\u591A\u4E2A\u4EA7\u54C1\u7684\u57FA\u672C\u4FE1\u606F\uFF0C\u5E76\u5728\u4E0B\u65B9\u663E\u793A\u5404\u7EF4\u5EA6\u7684\u5BF9\u6BD4\u6570\u636E\u3002\n */\nexport const ProductComparisonMessage: Story = {\n  render: args => (\n    <LiveChatWidget\n      {...args}\n      onAddToCart={(product: any) => {\n        console.log('\uD83D\uDED2 [ProductComparison Story] Add to Cart clicked!')\n        console.log('\uD83D\uDCE6 Product Info:', {\n          id: product.shopifyId,\n          title: product.title,\n          price: product.price,\n          imageUrl: product.imageUrl,\n          productUrl: product.productUrl,\n        })\n        console.log('\uD83D\uDCCB Full Product Object:', product)\n\n        // \u6A21\u62DF\u6DFB\u52A0\u5230\u8D2D\u7269\u8F66\u6210\u529F\n        alert(`\u2705 \"${product.title}\" \u5DF2\u6DFB\u52A0\u5230\u8D2D\u7269\u8F66\uFF01\\n\\n\u4EF7\u683C: ${product.price.currency} ${product.price.amount}`)\n      }}\n    />\n  ),\n  args: {\n    welcomeMessage: '\u4EE5\u4E0B\u662F\u60A8\u5173\u6CE8\u7684\u4EA7\u54C1\u5BF9\u6BD4\u4FE1\u606F\uFF1A',\n  },\n  parameters: {\n    docs: {\n      description: {\n        story: `\n\u4EA7\u54C1\u5BF9\u6BD4\u6D88\u606F\u652F\u6301\u4EE5\u4E0B\u7EF4\u5EA6\uFF1A\n\n- **\u4EF7\u683C\u5BF9\u6BD4**: \u663E\u793A\u4EA7\u54C1\u7684\u4EF7\u683C\u533A\u95F4\u548C\u4FC3\u9500\u6807\u7B7E\n- **\u4F1A\u5458\u4EF7\u5BF9\u6BD4**: \u663E\u793A\u4F1A\u5458\u4E13\u4EAB\u4EF7\u683C\uFF08\u5982\u679C\u53EF\u7528\uFF09\n- **\u53D8\u4F53\u6570\u91CF\u5BF9\u6BD4**: \u663E\u793A\u4EA7\u54C1\u7684\u53EF\u9009\u53D8\u4F53\u6570\u91CF\n- **\u6298\u6263\u5BF9\u6BD4**: \u663E\u793A\u4EA7\u54C1\u662F\u5426\u6709\u6298\u6263\u6D3B\u52A8\n\n\u7EC4\u4EF6\u4F1A\u81EA\u52A8\u5904\u7406\u4ECE\u540E\u7AEF\u8FD4\u56DE\u7684\u4EA7\u54C1\u5BF9\u6BD4\u6570\u636E\uFF0C\u5305\u62EC\uFF1A\n- \u4EA7\u54C1\u57FA\u672C\u4FE1\u606F\uFF08\u56FE\u7247\u3001\u6807\u9898\u3001\u4EF7\u683C\u7B49\uFF09\n- \u591A\u7EF4\u5EA6\u5BF9\u6BD4\u6570\u636E\uFF08\u4EF7\u683C\u3001\u4F1A\u5458\u4EF7\u3001\u53D8\u4F53\u3001\u6298\u6263\uFF09\n- \u54CD\u5E94\u5F0F\u5E03\u5C40\uFF08\u79FB\u52A8\u7AEF\u53EF\u6A2A\u5411\u6EDA\u52A8\uFF09\n\n**\u6D4B\u8BD5 Add to Cart \u529F\u80FD\uFF1A**\n- \u70B9\u51FB\u4EA7\u54C1\u5BF9\u6BD4\u5361\u7247\u4E2D\u7684 \"Add to Cart\" \u6309\u94AE\n- \u67E5\u770B\u63A7\u5236\u53F0\u8F93\u51FA\u7684\u4EA7\u54C1\u4FE1\u606F\n- \u4F1A\u5F39\u51FA\u786E\u8BA4\u63D0\u793A\u6846\u663E\u793A\u5DF2\u6DFB\u52A0\u5230\u8D2D\u7269\u8F66\n        `,\n      },\n    },\n  },\n}\n\n/**\n * FAQ \u5217\u8868\u6D88\u606F\n *\n * \u5C55\u793A\u5E38\u89C1\u95EE\u9898\u5217\u8868\uFF0C\u652F\u6301\u6298\u53E0/\u5C55\u5F00\u3002\n *\n * FAQ \u7EC4\u4EF6\u4F1A\u663E\u793A\u641C\u7D22\u7ED3\u679C\u7684\u5E38\u89C1\u95EE\u9898\uFF0C\u6BCF\u4E2A\u95EE\u9898\u53EF\u4EE5\u70B9\u51FB\u5C55\u5F00\u67E5\u770B\u7B54\u6848\u3002\n */\nexport const FAQListMessage: Story = {\n  args: {\n    welcomeMessage: '\u4EE5\u4E0B\u662F\u4E0E\u60A8\u7684\u95EE\u9898\u76F8\u5173\u7684\u5E38\u89C1\u89E3\u7B54\uFF1A',\n  },\n  parameters: {\n    docs: {\n      description: {\n        story: `\nFAQ \u5217\u8868\u6D88\u606F\u652F\u6301\uFF1A\n\n- **\u53EF\u6298\u53E0\u95EE\u9898**: \u70B9\u51FB\u95EE\u9898\u6807\u9898\u5C55\u5F00/\u6298\u53E0\u7B54\u6848\n- **Markdown \u7B54\u6848**: \u7B54\u6848\u652F\u6301 Markdown \u683C\u5F0F\uFF0C\u53EF\u663E\u793A\u5BCC\u6587\u672C\n- **\u76F8\u5173\u95EE\u9898**: \u5C55\u5F00\u7B54\u6848\u540E\u663E\u793A\u76F8\u5173\u95EE\u9898\uFF0C\u70B9\u51FB\u53EF\u89E6\u53D1\u65B0\u641C\u7D22\n- **\u5206\u7C7B\u6807\u8BB0**: \u6839\u636E\u95EE\u9898\u5206\u7C7B\u663E\u793A\uFF08\u914D\u9001\u3001\u9000\u8D27\u3001\u4EA7\u54C1\u3001\u652F\u4ED8\u3001\u901A\u7528\uFF09\n- **\u641C\u7D22\u7ED3\u679C\u7EDF\u8BA1**: \u663E\u793A\u627E\u5230\u7684\u95EE\u9898\u6570\u91CF\n\n\u4F7F\u7528\u573A\u666F\uFF1A\n- \u7528\u6237\u8BE2\u95EE\u5E38\u89C1\u95EE\u9898\u65F6\u8FD4\u56DE FAQ \u5217\u8868\n- \u4EA7\u54C1\u4E13\u5C5E\u95EE\u9898\u67E5\u8BE2\n- \u6309\u5206\u7C7B\u67E5\u8BE2 FAQ\n        `,\n      },\n    },\n  },\n}\n"],
-  "mappings": "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",
-  "names": ["jsx", "jsxs", "LiveChatWidget", "meta", "LiveChatWidget_stories_default", "Default", "CustomPosition", "CustomBranding", "WithQuickReplies", "CustomWelcomeMessage", "WithEventCallbacks", "args", "message", "error", "product", "cartId", "checkoutUrl", "CustomVideoRenderer", "content", "videoContent", "CustomImageGalleryRenderer", "images", "image", "index", "MobileView", "TabletView", "DefaultPositionDemo", "ProductComparisonMessage", "FAQListMessage"]
+  "sourcesContent": ["/**\n * LiveChatWidget Storybook Stories\n * \u5C55\u793A LiveChat \u7EC4\u4EF6\u7684\u5404\u79CD\u4F7F\u7528\u573A\u666F\u548C\u914D\u7F6E\n */\n\nimport type { Meta, StoryObj } from '@storybook/react'\nimport { LiveChatWidget } from '../components/LiveChatWidget'\nimport type { MessageRenderer, MessageContent } from '../components/LiveChatWidget'\nimport '../styles/livechat.css'\n\nconst meta: Meta<typeof LiveChatWidget> = {\n  title: 'Campaign/LiveChatWidget',\n  component: LiveChatWidget,\n  parameters: {\n    layout: 'fullscreen',\n    docs: {\n      story: {\n        inline: false,\n        iframeHeight: 500,\n      },\n      description: {\n        component: `\n# LiveChat \u804A\u5929\u7EC4\u4EF6\n\n\u53EF\u590D\u7528\u7684\u6C14\u6CE1\u5F39\u7A97\u804A\u5929\u7EC4\u4EF6\uFF0C\u652F\u6301 SSE \u6D41\u5F0F\u6D88\u606F\u3001\u81EA\u5B9A\u4E49\u6E32\u67D3\u5668\u548C\u591A\u79CD\u6D88\u606F\u7C7B\u578B\u3002\n\n## \u529F\u80FD\u7279\u6027\n\n- \uD83C\uDF88 **\u6C14\u6CE1\u5F39\u7A97**: \u53EF\u81EA\u5B9A\u4E49\u4F4D\u7F6E\u7684\u60AC\u6D6E\u6C14\u6CE1\u6309\u94AE\n- \uD83D\uDCAC **\u6D41\u5F0F\u6D88\u606F**: \u57FA\u4E8E SSE \u7684\u5B9E\u65F6\u6D41\u5F0F\u54CD\u5E94\n- \uD83D\uDCE6 **\u591A\u79CD\u6D88\u606F\u7C7B\u578B**: \u6587\u672C\u3001\u5546\u54C1\u5361\u7247\u3001\u5546\u54C1\u5217\u8868\u3001\u653F\u7B56\u3001\u5FEB\u6377\u56DE\u590D\u7B49\n- \uD83C\uDFA8 **\u53EF\u5B9A\u5236**: \u652F\u6301\u81EA\u5B9A\u4E49\u54C1\u724C\u989C\u8272\u3001Logo\u3001\u6E32\u67D3\u5668\n- \uD83D\uDCF1 **\u54CD\u5E94\u5F0F**: \u79FB\u52A8\u7AEF\u5168\u5C4F\uFF0C\u684C\u9762\u7AEF\u56FA\u5B9A\u5C3A\u5BF8\n- \uD83D\uDCBE **\u4F1A\u8BDD\u7BA1\u7406**: \u81EA\u52A8\u7BA1\u7406 userId \u548C sessionId\n- \uD83D\uDD12 **\u5B89\u5168\u9632\u62A4**: \u5185\u7F6E XSS \u9632\u62A4\u548C\u8F93\u5165\u9A8C\u8BC1\n\n## \u57FA\u7840\u7528\u6CD5\n\n\\`\\`\\`tsx\nimport { LiveChatWidget } from '@anker-in/campaign-ui'\nimport '@anker-in/campaign-ui/livechat.css'\n\nfunction App() {\n  return (\n    <LiveChatWidget\n      apiBaseUrl=\"https://beta-api-livechat.anker.com\"\n      site=\"www.eufy.com\"\n      welcomeMessage=\"\u4F60\u597D\uFF01\u6211\u662F AI \u52A9\u624B\"\n    />\n  )\n}\n\\`\\`\\`\n\n## \u81EA\u5B9A\u4E49\u6E32\u67D3\u5668\n\n\\`\\`\\`tsx\nconst customRenderers = {\n  video: {\n    render: (content) => (\n      <video src={content.url} controls className=\"w-full rounded\" />\n    )\n  }\n}\n\n<LiveChatWidget\n  apiBaseUrl=\"...\"\n  site=\"...\"\n  customRenderers={customRenderers}\n/>\n\\`\\`\\`\n        `,\n      },\n    },\n  },\n  tags: ['autodocs'],\n  argTypes: {\n    apiBaseUrl: {\n      control: 'text',\n      description: 'API \u57FA\u7840 URL',\n    },\n    headers: {\n      control: 'object',\n      description: '\u81EA\u5B9A\u4E49\u8BF7\u6C42\u5934\uFF0C\u5C06\u5728\u6240\u6709 API \u8BF7\u6C42\u4E2D\u6DFB\u52A0',\n      table: {\n        defaultValue: { summary: 'undefined' },\n      },\n    },\n    needRecaptcha: {\n      control: 'boolean',\n      description: '\u662F\u5426\u542F\u7528 Google reCAPTCHA v3 \u9A8C\u8BC1',\n      table: {\n        defaultValue: { summary: 'false' },\n      },\n    },\n    recaptchaSitekey: {\n      control: 'text',\n      description: 'Google reCAPTCHA v3 site key',\n      table: {\n        defaultValue: { summary: 'undefined' },\n      },\n    },\n    recaptchaAction: {\n      control: 'text',\n      description: 'reCAPTCHA action \u540D\u79F0\uFF0C\u7528\u4E8E\u533A\u5206\u4E0D\u540C\u7684\u9A8C\u8BC1\u573A\u666F',\n      table: {\n        defaultValue: { summary: '\"activity\"' },\n      },\n    },\n    site: {\n      control: 'text',\n      description: 'Shopify \u5E97\u94FA URL',\n    },\n    welcomeMessage: {\n      control: 'text',\n      description: '\u6B22\u8FCE\u6D88\u606F',\n      table: {\n        defaultValue: { summary: '\u4F60\u597D\uFF01\u6211\u662F AI \u52A9\u624B\uFF0C\u6709\u4EC0\u4E48\u53EF\u4EE5\u5E2E\u52A9\u4F60\u7684\u5417\uFF1F' },\n      },\n    },\n    logoUrl: {\n      control: 'text',\n      description: 'Logo URL',\n    },\n    position: {\n      control: 'object',\n      description: '\u6C14\u6CE1\u6309\u94AE\u4F4D\u7F6E\u5BF9\u8C61',\n      table: {\n        defaultValue: { summary: '{ bottom: \"1.5rem\", right: \"1.5rem\" }' },\n      },\n    },\n  },\n  args: {\n    apiBaseUrl: 'http://172.16.38.183:3003',\n    site: 'www.eufy.com',\n    loginUserId: 'test_test',\n    welcomeMessage: '\u4F60\u597D\uFF01\u6211\u662F AI \u52A9\u624B\uFF0C\u6709\u4EC0\u4E48\u53EF\u4EE5\u5E2E\u52A9\u4F60\u7684\u5417\uFF1F',\n  },\n}\n\nexport default meta\ntype Story = StoryObj<typeof LiveChatWidget>\n\n/**\n * \u9ED8\u8BA4\u914D\u7F6E\n *\n * \u6700\u7B80\u5355\u7684\u4F7F\u7528\u65B9\u5F0F\uFF0C\u4F7F\u7528\u9ED8\u8BA4\u914D\u7F6E\u3002\n */\nexport const Default: Story = {\n  args: {\n    loginUserId: 'test_test',\n    apiBaseUrl: 'https://beta-api-v2-livechat.anker.com',\n    cartId: 'gid://shopify/Cart/hWN7oFnMh7jKxbO1CYSzWVue?key=68f4cf2c4c772b9aed2fab2902e6dab3',\n    accessToken: '92301d516a0a38a0a483bc230e5bfaad',\n    title: 'eufy',\n\n    commonText: {\n      learnMore: 'Learn More',\n    },\n\n    site: 'beta.eufy.com',\n\n    // reCAPTCHA \u914D\u7F6E\uFF08\u4F7F\u7528\u7EC4\u4EF6 props\uFF0C\u4E0D\u662F headers\uFF09\n    needRecaptcha: true,\n    recaptchaSitekey: '6LfS4J4pAAAAACX1e_WrxutmxxzCK7FU4WzVqL14 999testtest',\n    recaptchaAction: 'chat',\n  },\n}\n\n/**\n * \u81EA\u5B9A\u4E49\u4F4D\u7F6E\n *\n * \u4F7F\u7528\u81EA\u5B9A\u4E49\u4F4D\u7F6E\u5BF9\u8C61\u6765\u63A7\u5236\u6C14\u6CE1\u6309\u94AE\u7684\u4F4D\u7F6E\u3002\n */\nexport const CustomPosition: Story = {\n  args: {\n    position: { bottom: '1.5rem', left: '1.5rem' },\n  },\n}\n\n/**\n * \u81EA\u5B9A\u4E49\u54C1\u724C\u6837\u5F0F\n *\n * \u81EA\u5B9A\u4E49 Logo \u548C\u6B22\u8FCE\u6D88\u606F\u3002\n */\nexport const CustomBranding: Story = {\n  args: {\n    logoUrl: 'https://images.unsplash.com/photo-1599305445671-ac291c95aaa9?w=100&h=100&fit=crop',\n    welcomeMessage: '\u6B22\u8FCE\u6765\u5230 Soundcore\uFF01\u6211\u662F\u60A8\u7684\u4E13\u5C5E AI \u52A9\u624B \uD83C\uDFA7',\n  },\n}\n\n/**\n * \u5E26\u5FEB\u6377\u56DE\u590D\n *\n * \u5728\u6B22\u8FCE\u6D88\u606F\u540E\u663E\u793A\u5FEB\u6377\u56DE\u590D\u6309\u94AE\u3002\n */\nexport const WithQuickReplies: Story = {\n  args: {\n    quickReplies: [\n      {\n        id: '1',\n        label: '\u67E5\u8BE2\u4EF7\u683C',\n        value: '\u6211\u60F3\u4E86\u89E3\u4EA7\u54C1\u4EF7\u683C',\n        icon: '\uD83D\uDCB0',\n      },\n      {\n        id: '2',\n        label: '\u67E5\u8BE2\u7269\u6D41',\n        value: '\u6211\u60F3\u67E5\u8BE2\u8BA2\u5355\u7269\u6D41',\n        icon: '\uD83D\uDCE6',\n      },\n      {\n        id: '3',\n        label: '\u552E\u540E\u670D\u52A1',\n        value: '\u6211\u9700\u8981\u552E\u540E\u5E2E\u52A9',\n        icon: '\uD83D\uDD27',\n      },\n      {\n        id: '4',\n        label: '\u4EA7\u54C1\u63A8\u8350',\n        value: '\u8BF7\u63A8\u8350\u9002\u5408\u6211\u7684\u4EA7\u54C1',\n        icon: '\u2B50',\n      },\n    ],\n  },\n}\n\n/**\n * \u81EA\u5B9A\u4E49\u6B22\u8FCE\u6D88\u606F\n *\n * \u81EA\u5B9A\u4E49\u9996\u6B21\u6253\u5F00\u804A\u5929\u7A97\u53E3\u65F6\u7684\u6B22\u8FCE\u6D88\u606F\u3002\n */\nexport const CustomWelcomeMessage: Story = {\n  args: {\n    welcomeMessage: `\n\uD83D\uDC4B \u60A8\u597D\uFF01\u6B22\u8FCE\u6765\u5230 Soundcore \u5B98\u65B9\u5546\u57CE\u3002\n\n\u6211\u662F\u60A8\u7684 AI \u8D2D\u7269\u52A9\u624B\uFF0C\u53EF\u4EE5\u5E2E\u60A8\uFF1A\n- \uD83D\uDD0D \u67E5\u627E\u4EA7\u54C1\n- \uD83D\uDCB0 \u6BD4\u8F83\u4EF7\u683C\n- \uD83D\uDCE6 \u8DDF\u8E2A\u8BA2\u5355\n- \uD83D\uDCAC \u89E3\u7B54\u7591\u95EE\n\n\u6709\u4EC0\u4E48\u6211\u53EF\u4EE5\u5E2E\u52A9\u60A8\u7684\u5417\uFF1F\n    `.trim(),\n  },\n}\n\n/**\n * \u4E8B\u4EF6\u56DE\u8C03\n *\n * \u76D1\u542C\u7EC4\u4EF6\u4E8B\u4EF6\u8FDB\u884C\u81EA\u5B9A\u4E49\u5904\u7406\u3002\n */\nexport const WithEventCallbacks: Story = {\n  args: {\n    title: '',\n    showNewSessionButton: true,\n\n    position: {\n      bottom: '24px',\n      right: '30px',\n    },\n\n    chatBubbleIcon: 'https://cdn.shopify.com/s/files/1/0504/7094/4954/files/Rectangle_400770314.png?v=1768894153',\n\n    // \u81EA\u5B9A\u4E49\u8BF7\u6C42\u5934\u793A\u4F8B\n    headers: {\n      'X-Custom-Header': 'custom-value',\n      Authorization: 'Bearer your-token-here',\n    },\n  },\n\n  render: args => (\n    <LiveChatWidget\n      {...args}\n      onOpen={() => {\n        console.log('[Story] Chat opened')\n      }}\n      onClose={() => {\n        console.log('[Story] Chat closed')\n      }}\n      onMessageSend={(message: string) => {\n        console.log('[Story] Message sent:', message)\n      }}\n      onError={(error: Error) => {\n        console.error('[Story] Error occurred:', error)\n      }}\n      onTextMessage={() => {\n        console.log('\uD83D\uDCDD [Story] AI started replying with text message')\n      }}\n      onProductList={() => {\n        console.log('\uD83D\uDCE6 [Story] AI replied with product list card')\n      }}\n      onPromotionList={() => {\n        console.log('\uD83C\uDF89 [Story] AI replied with promotion list card')\n      }}\n      onAddToCart={(product: any) => {\n        console.log('\uD83D\uDED2 [Story] Add to Cart clicked!')\n        console.log('\uD83D\uDCE6 Product Info:', {\n          id: product.shopifyId,\n          title: product.title,\n          price: product.price,\n          imageUrl: product.imageUrl,\n          productUrl: product.productUrl,\n        })\n        console.log('\uD83D\uDCCB Full Product Object:', product)\n\n        // \u6A21\u62DF\u6DFB\u52A0\u5230\u8D2D\u7269\u8F66\u6210\u529F\n        alert(`\u2705 \"${product.title}\" \u5DF2\u6DFB\u52A0\u5230\u8D2D\u7269\u8F66\uFF01\\n\\n\u4EF7\u683C: ${product.price.currency} ${product.price.amount}`)\n      }}\n      onCart={(cartId: string, checkoutUrl?: string) => {\n        console.log('\uD83D\uDED2 [Story] Cart button clicked!')\n        console.log('\uD83D\uDCCB Cart ID:', cartId)\n        console.log('\uD83D\uDD17 Checkout URL:', checkoutUrl)\n\n        // \u6A21\u62DF\u8D2D\u7269\u8F66\u6309\u94AE\u70B9\u51FB\u6210\u529F\n        alert(`\u8D2D\u7269\u8F66\u6309\u94AE\u88AB\u70B9\u51FB\uFF01\\n\\nCart ID: ${cartId}\\nCheckout URL: ${checkoutUrl || '\u65E0'}`)\n      }}\n    />\n  ),\n}\n\n/**\n * \u81EA\u5B9A\u4E49\u89C6\u9891\u6D88\u606F\u6E32\u67D3\u5668\n *\n * \u6269\u5C55\u6D88\u606F\u7C7B\u578B\uFF0C\u6DFB\u52A0\u89C6\u9891\u6D88\u606F\u652F\u6301\u3002\n */\nexport const CustomVideoRenderer: Story = {\n  args: {\n    customRenderers: {\n      video: {\n        render: (content: MessageContent) => {\n          const videoContent = content as any\n          return (\n            <div className=\"w-full\">\n              <video src={videoContent.url} controls className=\"w-full rounded-lg\" poster={videoContent.poster}>\n                \u60A8\u7684\u6D4F\u89C8\u5668\u4E0D\u652F\u6301\u89C6\u9891\u64AD\u653E\n              </video>\n              {videoContent.title && <p className=\"mt-2 text-sm text-gray-600\">{videoContent.title}</p>}\n            </div>\n          )\n        },\n      } as MessageRenderer,\n    },\n  },\n}\n\n/**\n * \u81EA\u5B9A\u4E49\u56FE\u7247\u753B\u5ECA\u6E32\u67D3\u5668\n *\n * \u6269\u5C55\u6D88\u606F\u7C7B\u578B\uFF0C\u6DFB\u52A0\u56FE\u7247\u753B\u5ECA\u652F\u6301\u3002\n */\nexport const CustomImageGalleryRenderer: Story = {\n  args: {\n    customRenderers: {\n      image_gallery: {\n        render: (content: MessageContent) => {\n          const galleryContent = content as any\n          const images = galleryContent.images || []\n\n          return (\n            <div className=\"grid grid-cols-2 gap-2\">\n              {images.map((image: any, index: number) => (\n                <div key={index} className=\"relative aspect-square\">\n                  <img\n                    src={image.url}\n                    alt={image.alt || `Image ${index + 1}`}\n                    className=\"size-full rounded-lg object-cover\"\n                  />\n                </div>\n              ))}\n            </div>\n          )\n        },\n      } as MessageRenderer,\n    },\n  },\n}\n\n/**\n * \u79FB\u52A8\u7AEF\u9884\u89C8\n *\n * \u5728\u79FB\u52A8\u7AEF\u5C3A\u5BF8\u4E0B\u67E5\u770B\u6548\u679C\uFF08\u5168\u5C4F\u663E\u793A\uFF09\u3002\n */\nexport const MobileView: Story = {\n  parameters: {\n    viewport: {\n      defaultViewport: 'mobile1',\n    },\n  },\n  args: {},\n}\n\n/**\n * \u5E73\u677F\u7AEF\u9884\u89C8\n *\n * \u5728\u5E73\u677F\u7AEF\u5C3A\u5BF8\u4E0B\u67E5\u770B\u6548\u679C\u3002\n */\nexport const TabletView: Story = {\n  parameters: {\n    viewport: {\n      defaultViewport: 'tablet',\n    },\n  },\n  args: {},\n}\n\n/**\n * \u9ED8\u8BA4\u4F4D\u7F6E\u5C55\u793A\n *\n * \u5C55\u793A\u6C14\u6CE1\u6309\u94AE\u7684\u9ED8\u8BA4\u4F4D\u7F6E\uFF08\u53F3\u4E0B\u89D2\uFF09\u3002\n */\nexport const DefaultPositionDemo: Story = {\n  render: () => (\n    <div className=\"relative h-screen w-full bg-gray-50\">\n      <div className=\"absolute inset-0 flex items-center justify-center\">\n        <p className=\"text-gray-500\">\u9875\u9762\u5185\u5BB9\u533A\u57DF</p>\n      </div>\n\n      {/* \u6F14\u793A\u9ED8\u8BA4\u4F4D\u7F6E */}\n      <div className=\"absolute bottom-4 right-4 text-xs text-gray-400\">\u9ED8\u8BA4\u4F4D\u7F6E (\u53F3\u4E0B\u89D2)</div>\n\n      <LiveChatWidget apiBaseUrl=\"https://beta-api-livechat.anker.com\" site=\"www.eufy.com\" />\n    </div>\n  ),\n}\n\n/**\n * \u4EA7\u54C1\u5BF9\u6BD4\u6D88\u606F\n *\n * \u5C55\u793A\u4EA7\u54C1\u5BF9\u6BD4\u7C7B\u578B\u7684\u6D88\u606F\u6E32\u67D3\u6548\u679C\uFF0C\u5305\u62EC\u4EF7\u683C\u3001\u4F1A\u5458\u4EF7\u3001\u53D8\u4F53\u6570\u91CF\u3001\u6298\u6263\u7B49\u591A\u4E2A\u7EF4\u5EA6\u7684\u5BF9\u6BD4\u3002\n *\n * \u4EA7\u54C1\u5BF9\u6BD4\u7EC4\u4EF6\u4F1A\u4EE5\u7F51\u683C\u5E03\u5C40\u5C55\u793A\u591A\u4E2A\u4EA7\u54C1\u7684\u57FA\u672C\u4FE1\u606F\uFF0C\u5E76\u5728\u4E0B\u65B9\u663E\u793A\u5404\u7EF4\u5EA6\u7684\u5BF9\u6BD4\u6570\u636E\u3002\n */\nexport const ProductComparisonMessage: Story = {\n  render: args => (\n    <LiveChatWidget\n      {...args}\n      onAddToCart={(product: any) => {\n        console.log('\uD83D\uDED2 [ProductComparison Story] Add to Cart clicked!')\n        console.log('\uD83D\uDCE6 Product Info:', {\n          id: product.shopifyId,\n          title: product.title,\n          price: product.price,\n          imageUrl: product.imageUrl,\n          productUrl: product.productUrl,\n        })\n        console.log('\uD83D\uDCCB Full Product Object:', product)\n\n        // \u6A21\u62DF\u6DFB\u52A0\u5230\u8D2D\u7269\u8F66\u6210\u529F\n        alert(`\u2705 \"${product.title}\" \u5DF2\u6DFB\u52A0\u5230\u8D2D\u7269\u8F66\uFF01\\n\\n\u4EF7\u683C: ${product.price.currency} ${product.price.amount}`)\n      }}\n    />\n  ),\n  args: {\n    welcomeMessage: '\u4EE5\u4E0B\u662F\u60A8\u5173\u6CE8\u7684\u4EA7\u54C1\u5BF9\u6BD4\u4FE1\u606F\uFF1A',\n  },\n  parameters: {\n    docs: {\n      description: {\n        story: `\n\u4EA7\u54C1\u5BF9\u6BD4\u6D88\u606F\u652F\u6301\u4EE5\u4E0B\u7EF4\u5EA6\uFF1A\n\n- **\u4EF7\u683C\u5BF9\u6BD4**: \u663E\u793A\u4EA7\u54C1\u7684\u4EF7\u683C\u533A\u95F4\u548C\u4FC3\u9500\u6807\u7B7E\n- **\u4F1A\u5458\u4EF7\u5BF9\u6BD4**: \u663E\u793A\u4F1A\u5458\u4E13\u4EAB\u4EF7\u683C\uFF08\u5982\u679C\u53EF\u7528\uFF09\n- **\u53D8\u4F53\u6570\u91CF\u5BF9\u6BD4**: \u663E\u793A\u4EA7\u54C1\u7684\u53EF\u9009\u53D8\u4F53\u6570\u91CF\n- **\u6298\u6263\u5BF9\u6BD4**: \u663E\u793A\u4EA7\u54C1\u662F\u5426\u6709\u6298\u6263\u6D3B\u52A8\n\n\u7EC4\u4EF6\u4F1A\u81EA\u52A8\u5904\u7406\u4ECE\u540E\u7AEF\u8FD4\u56DE\u7684\u4EA7\u54C1\u5BF9\u6BD4\u6570\u636E\uFF0C\u5305\u62EC\uFF1A\n- \u4EA7\u54C1\u57FA\u672C\u4FE1\u606F\uFF08\u56FE\u7247\u3001\u6807\u9898\u3001\u4EF7\u683C\u7B49\uFF09\n- \u591A\u7EF4\u5EA6\u5BF9\u6BD4\u6570\u636E\uFF08\u4EF7\u683C\u3001\u4F1A\u5458\u4EF7\u3001\u53D8\u4F53\u3001\u6298\u6263\uFF09\n- \u54CD\u5E94\u5F0F\u5E03\u5C40\uFF08\u79FB\u52A8\u7AEF\u53EF\u6A2A\u5411\u6EDA\u52A8\uFF09\n\n**\u6D4B\u8BD5 Add to Cart \u529F\u80FD\uFF1A**\n- \u70B9\u51FB\u4EA7\u54C1\u5BF9\u6BD4\u5361\u7247\u4E2D\u7684 \"Add to Cart\" \u6309\u94AE\n- \u67E5\u770B\u63A7\u5236\u53F0\u8F93\u51FA\u7684\u4EA7\u54C1\u4FE1\u606F\n- \u4F1A\u5F39\u51FA\u786E\u8BA4\u63D0\u793A\u6846\u663E\u793A\u5DF2\u6DFB\u52A0\u5230\u8D2D\u7269\u8F66\n        `,\n      },\n    },\n  },\n}\n\n/**\n * FAQ \u5217\u8868\u6D88\u606F\n *\n * \u5C55\u793A\u5E38\u89C1\u95EE\u9898\u5217\u8868\uFF0C\u652F\u6301\u6298\u53E0/\u5C55\u5F00\u3002\n *\n * FAQ \u7EC4\u4EF6\u4F1A\u663E\u793A\u641C\u7D22\u7ED3\u679C\u7684\u5E38\u89C1\u95EE\u9898\uFF0C\u6BCF\u4E2A\u95EE\u9898\u53EF\u4EE5\u70B9\u51FB\u5C55\u5F00\u67E5\u770B\u7B54\u6848\u3002\n */\nexport const FAQListMessage: Story = {\n  args: {\n    welcomeMessage: '\u4EE5\u4E0B\u662F\u4E0E\u60A8\u7684\u95EE\u9898\u76F8\u5173\u7684\u5E38\u89C1\u89E3\u7B54\uFF1A',\n  },\n  parameters: {\n    docs: {\n      description: {\n        story: `\nFAQ \u5217\u8868\u6D88\u606F\u652F\u6301\uFF1A\n\n- **\u53EF\u6298\u53E0\u95EE\u9898**: \u70B9\u51FB\u95EE\u9898\u6807\u9898\u5C55\u5F00/\u6298\u53E0\u7B54\u6848\n- **Markdown \u7B54\u6848**: \u7B54\u6848\u652F\u6301 Markdown \u683C\u5F0F\uFF0C\u53EF\u663E\u793A\u5BCC\u6587\u672C\n- **\u76F8\u5173\u95EE\u9898**: \u5C55\u5F00\u7B54\u6848\u540E\u663E\u793A\u76F8\u5173\u95EE\u9898\uFF0C\u70B9\u51FB\u53EF\u89E6\u53D1\u65B0\u641C\u7D22\n- **\u5206\u7C7B\u6807\u8BB0**: \u6839\u636E\u95EE\u9898\u5206\u7C7B\u663E\u793A\uFF08\u914D\u9001\u3001\u9000\u8D27\u3001\u4EA7\u54C1\u3001\u652F\u4ED8\u3001\u901A\u7528\uFF09\n- **\u641C\u7D22\u7ED3\u679C\u7EDF\u8BA1**: \u663E\u793A\u627E\u5230\u7684\u95EE\u9898\u6570\u91CF\n\n\u4F7F\u7528\u573A\u666F\uFF1A\n- \u7528\u6237\u8BE2\u95EE\u5E38\u89C1\u95EE\u9898\u65F6\u8FD4\u56DE FAQ \u5217\u8868\n- \u4EA7\u54C1\u4E13\u5C5E\u95EE\u9898\u67E5\u8BE2\n- \u6309\u5206\u7C7B\u67E5\u8BE2 FAQ\n        `,\n      },\n    },\n  },\n}\n\n/**\n * \u5E26 reCAPTCHA \u914D\u7F6E\n *\n * \u5C55\u793A\u5982\u4F55\u914D\u7F6E Google reCAPTCHA v3 \u9A8C\u8BC1\uFF0C\u4FDD\u62A4 API \u8BF7\u6C42\u514D\u53D7\u6EE5\u7528\u3002\n *\n * reCAPTCHA \u4F1A\u5728\u540E\u53F0\u81EA\u52A8\u9A8C\u8BC1\u7528\u6237\u884C\u4E3A\uFF0C\u65E0\u9700\u7528\u6237\u624B\u52A8\u64CD\u4F5C\u3002\n */\nexport const WithRecaptcha: Story = {\n  args: {\n    // \u542F\u7528 reCAPTCHA\n    needRecaptcha: true,\n    // \u914D\u7F6E\u4F60\u7684 reCAPTCHA site key\n    recaptchaSitekey: '6LfS4J4pAAAAACX1e_WrxutmxxzCK7FU4WzVqL14',\n    // \u53EF\u9009\uFF1A\u81EA\u5B9A\u4E49 action \u540D\u79F0\n    recaptchaAction: 'livechat',\n  },\n  parameters: {\n    docs: {\n      description: {\n        story: `\n### reCAPTCHA v3 \u914D\u7F6E\n\n\u542F\u7528 reCAPTCHA v3 \u53EF\u4EE5\u4FDD\u62A4\u4F60\u7684 API \u514D\u53D7\u673A\u5668\u4EBA\u548C\u6EE5\u7528\u884C\u4E3A\u7684\u653B\u51FB\u3002\n\n**\u914D\u7F6E\u6B65\u9AA4\uFF1A**\n\n1. \u5728 [Google reCAPTCHA](https://www.google.com/recaptcha/admin) \u521B\u5EFA v3 \u5BC6\u94A5\n2. \u5728\u9875\u9762\u4E2D\u52A0\u8F7D reCAPTCHA \u811A\u672C\uFF1A\n   \\`\\`\\`html\n   <script src=\"https://www.google.com/recaptcha/api.js?render=YOUR_SITE_KEY\"></script>\n   \\`\\`\\`\n3. \u914D\u7F6E LiveChatWidget \u7EC4\u4EF6\uFF1A\n   \\`\\`\\`tsx\n   <LiveChatWidget\n     needRecaptcha={true}\n     recaptchaSitekey=\"YOUR_SITE_KEY\"\n     recaptchaAction=\"livechat\"\n   />\n   \\`\\`\\`\n\n**\u5DE5\u4F5C\u539F\u7406\uFF1A**\n\n- \u6BCF\u6B21\u53D1\u9001\u6D88\u606F\u6216\u521B\u5EFA\u4F1A\u8BDD\u65F6\uFF0C\u4F1A\u81EA\u52A8\u83B7\u53D6 reCAPTCHA token\n- token \u4F1A\u901A\u8FC7 \\`X-Recaptcha-Token\\` header \u53D1\u9001\u5230\u540E\u7AEF\n- \u540E\u7AEF\u9700\u8981\u9A8C\u8BC1 token \u7684\u6709\u6548\u6027\n\n**\u6CE8\u610F\u4E8B\u9879\uFF1A**\n\n- reCAPTCHA v3 \u5728\u540E\u53F0\u8FD0\u884C\uFF0C\u4E0D\u4F1A\u6253\u65AD\u7528\u6237\u4F53\u9A8C\n- \u5EFA\u8BAE\u4E3A\u4E0D\u540C\u7684\u64CD\u4F5C\u4F7F\u7528\u4E0D\u540C\u7684 \\`recaptchaAction\\` \u4EE5\u4FBF\u5206\u6790\n- \u786E\u4FDD\u540E\u7AEF\u6B63\u786E\u9A8C\u8BC1 reCAPTCHA token\n        `,\n      },\n    },\n  },\n}\n"],
+  "mappings": "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",
+  "names": ["jsx", "jsxs", "LiveChatWidget", "meta", "LiveChatWidget_stories_default", "Default", "CustomPosition", "CustomBranding", "WithQuickReplies", "CustomWelcomeMessage", "WithEventCallbacks", "args", "message", "error", "product", "cartId", "checkoutUrl", "CustomVideoRenderer", "content", "videoContent", "CustomImageGalleryRenderer", "images", "image", "index", "MobileView", "TabletView", "DefaultPositionDemo", "ProductComparisonMessage", "FAQListMessage", "WithRecaptcha"]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anker-in/campaign-ui",
-  "version": "0.2.11-beta.25",
+  "version": "0.2.11-beta.26",
   "description": "Campaign UI components and utilities for Anker projects",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
@@ -92,8 +92,8 @@
     "react-markdown": "^10.1.0",
     "tailwind-merge": "^2.3.0",
     "tailwindcss": "^3.4.3",
-    "@anker-in/lib": "1.1.2-beta.2",
-    "@anker-in/headless-ui": "1.1.25-alpha.1767516866003"
+    "@anker-in/headless-ui": "1.1.25-alpha.1767516866003",
+    "@anker-in/lib": "1.1.2-beta.2"
   },
   "publishConfig": {
     "access": "public",

package/src/components/LiveChatWidget/LiveChatWidget.tsx

@@ -48,6 +48,7 @@ import {
  * - 历史消息加载
  * - 多种消息类型渲染
  * - 自定义扩展机制
+ * - reCAPTCHA v3 安全防护
  *
  * 架构：
  * - UI Layer: ChatBubble, ChatWindow, MessageList, etc.
@@ -56,7 +57,7 @@ import {
  *
  * @example
  * ```tsx
- * // 使用默认位置（右下角）
+ * // 基础使用（使用默认位置）
  * <LiveChatWidget
  *   apiBaseUrl="https://beta-api-livechat.anker.com"
  *   site="www.eufy.com"
@@ -71,11 +72,35 @@ import {
  *   position={{ bottom: "20px", right: "30px" }}
  *   onMessageSend={(msg) => console.log('Sent:', msg)}
  * />
+ *
+ * // 启用 reCAPTCHA v3 安全防护
+ * <LiveChatWidget
+ *   apiBaseUrl="https://beta-api-livechat.anker.com"
+ *   site="www.eufy.com"
+ *   needRecaptcha={true}
+ *   recaptchaSitekey="6LfS4J4pAAAAACX1e_WrxutmxxzCK7FU4WzVqL14"
+ *   recaptchaAction="livechat"
+ * />
+ *
+ * // 使用自定义 headers 和 reCAPTCHA
+ * <LiveChatWidget
+ *   apiBaseUrl="https://beta-api-livechat.anker.com"
+ *   site="www.eufy.com"
+ *   headers={{
+ *     "Authorization": "Bearer your-token",
+ *     "X-Custom-Header": "value"
+ *   }}
+ *   needRecaptcha={true}
+ *   recaptchaSitekey="your-site-key"
+ * />
  * ```
  */
 export const LiveChatWidget: React.FC<LiveChatWidgetProps> = ({
   apiBaseUrl,
   headers,
+  needRecaptcha,
+  recaptchaSitekey,
+  recaptchaAction,
   site,
   loginUserId,
   cartId,
@@ -145,6 +170,11 @@ export const LiveChatWidget: React.FC<LiveChatWidgetProps> = ({
   const { sendMessageStream, createSession } = useChatAPI({
     apiBaseUrl,
     headers,
+    recaptchaConfig: {
+      needRecaptcha,
+      recaptchaSitekey,
+      recaptchaAction,
+    },
     onError,
   })
 

package/src/components/LiveChatWidget/api/chat.ts

@@ -5,6 +5,25 @@
  */
 
 import type { ChatStreamRequest, SSEEvent, NewSessionRequest, NewSessionResponse, ErrorResponse } from '../types'
+import { fetcher } from '../utils/fetcher'
+
+/**
+ * Recaptcha 配置
+ */
+export interface RecaptchaConfig {
+  /**
+   * 是否启用 reCAPTCHA
+   */
+  needRecaptcha?: boolean
+  /**
+   * reCAPTCHA site key
+   */
+  recaptchaSitekey?: string
+  /**
+   * reCAPTCHA action 名称
+   */
+  recaptchaAction?: string
+}
 
 // ============================================================================
 // SSE 流式消息处理 (T006)
@@ -16,21 +35,27 @@ import type { ChatStreamRequest, SSEEvent, NewSessionRequest, NewSessionResponse
  * @param request 请求参数
  * @param onEvent SSE 事件回调
  * @param customHeaders 自定义请求头
+ * @param recaptchaConfig reCAPTCHA 配置
  */
 export async function sendMessage(
   apiBaseUrl: string,
   request: ChatStreamRequest,
   onEvent: (event: SSEEvent) => void,
-  customHeaders?: Record<string, string>
+  customHeaders?: Record<string, string>,
+  recaptchaConfig?: RecaptchaConfig
 ): Promise<void> {
-  const response = await fetch(`${apiBaseUrl}/api/chat/stream`, {
+  // 使用 fetcher 处理 reCAPTCHA 和自定义 headers
+  const response = await fetcher({
+    url: `${apiBaseUrl}/api/chat/stream`,
     method: 'POST',
     headers: {
-      'Content-Type': 'application/json',
       Accept: 'text/event-stream',
       ...customHeaders,
     },
-    body: JSON.stringify(request),
+    body: request,
+    needRecaptcha: recaptchaConfig?.needRecaptcha,
+    recaptchaSitekey: recaptchaConfig?.recaptchaSitekey,
+    recaptchaAction: recaptchaConfig?.recaptchaAction || 'chat_stream',
   })
 
   if (!response.ok) {
@@ -116,20 +141,24 @@ export async function sendMessage(
  * @param apiBaseUrl API 基础 URL
  * @param request 请求参数
  * @param customHeaders 自定义请求头
+ * @param recaptchaConfig reCAPTCHA 配置
  * @returns 会话信息，可能包含历史消息
  */
 export async function createNewSession(
   apiBaseUrl: string,
   request: NewSessionRequest,
-  customHeaders?: Record<string, string>
+  customHeaders?: Record<string, string>,
+  recaptchaConfig?: RecaptchaConfig
 ): Promise<NewSessionResponse> {
-  const response = await fetch(`${apiBaseUrl}/api/chat/new-session`, {
+  // 使用 fetcher 处理 reCAPTCHA 和自定义 headers
+  const response = await fetcher({
+    url: `${apiBaseUrl}/api/chat/new-session`,
     method: 'POST',
-    headers: {
-      'Content-Type': 'application/json',
-      ...customHeaders,
-    },
-    body: JSON.stringify(request),
+    headers: customHeaders,
+    body: request,
+    needRecaptcha: recaptchaConfig?.needRecaptcha,
+    recaptchaSitekey: recaptchaConfig?.recaptchaSitekey,
+    recaptchaAction: recaptchaConfig?.recaptchaAction || 'new_session',
   })
 
   if (!response.ok) {