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

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/components/LiveChatWidget/hooks/useChatState.ts"],
+  "sourcesContent": ["/**\n * \u804A\u5929\u72B6\u6001\u7BA1\u7406 Hook\n * \u7BA1\u7406\u6D88\u606F\u5217\u8868\u3001\u7A97\u53E3\u72B6\u6001\u3001\u8F93\u5165\u6846\u72B6\u6001\u3001\u6D41\u5F0F\u6D88\u606F\u7D2F\u79EF\n * \u57FA\u4E8E specs/livechat-widget/plan.md \u7684\u72B6\u6001\u7BA1\u7406\u7B56\u7565\n */\n\nimport { useState, useCallback, useRef, useEffect } from 'react'\nimport type { Message, MessageContent, SSEEvent, StatusData, ErrorData, MessageStartData, BackendCartData, Product, TextContent, ProductCardContent, ProductListContent } from '../types'\nimport { getUserId } from '../utils/userId'\nimport { useSession } from './useSession'\nimport { transformProducts } from '../utils/productTransformers'\nimport { transformCartData } from '../utils/cartTransformers'\n\n// ============================================================================\n// \u8F85\u52A9\u51FD\u6570\uFF1A\u6587\u672C\u89E3\u6790\u548C\u6D88\u606F\u91CD\u7EC4\n// ============================================================================\n\n/**\n * \u5B9E\u65F6\u89E3\u6790\u6D41\u5F0F\u6587\u672C\u4E2D\u7684\u4EA7\u54C1\u5360\u4F4D\u7B26\n * \u5904\u7406\u7F13\u51B2\u533A\u4E2D\u7684\u6587\u672C\uFF0C\u68C0\u6D4B\u5B8C\u6574\u7684 {{product:xxx}} \u5360\u4F4D\u7B26\n *\n * @param buffer \u5F53\u524D\u7F13\u51B2\u533A\u5185\u5BB9\uFF08\u5305\u542B\u65B0\u63A5\u6536\u7684\u6587\u672C\uFF09\n * @param productMap shopifyId \u2192 Product \u7684\u6620\u5C04\u8868\n * @param rawProductMap shopifyId \u2192 raw backend product \u7684\u6620\u5C04\u8868\n * @param onAddToCart \u6DFB\u52A0\u5230\u8D2D\u7269\u8F66\u56DE\u8C03\n * @param productCardRender \u81EA\u5B9A\u4E49\u4EA7\u54C1\u5361\u7247\u6E32\u67D3\u51FD\u6570\n * @returns { contents: \u9700\u8981\u6DFB\u52A0\u7684\u5185\u5BB9\u6570\u7EC4, remainingBuffer: \u5269\u4F59\u7F13\u51B2\u533A\u5185\u5BB9 }\n */\nfunction parseStreamingText(\n  buffer: string,\n  productMap: Map<string, Product>,\n  rawProductMap: Map<string, any>,\n  onAddToCart?: (product: Product) => void,\n  productCardRender?: (product: any) => React.ReactNode\n): { contents: MessageContent[]; remainingBuffer: string } {\n  const contents: MessageContent[] = []\n  const regex = /\\{\\{(?:product:)?([^}]+)\\}\\}/g\n\n  let lastIndex = 0\n  let match: RegExpExecArray | null\n  let foundMatch = false\n\n  // \u67E5\u627E\u6240\u6709\u5B8C\u6574\u7684\u5360\u4F4D\u7B26\n  while ((match = regex.exec(buffer)) !== null) {\n    foundMatch = true\n\n    // \u63D0\u53D6\u5360\u4F4D\u7B26\u524D\u7684\u6587\u672C\n    const beforeText = buffer.slice(lastIndex, match.index)\n    if (beforeText) {\n      contents.push({ type: 'text', text: beforeText } as TextContent)\n    }\n\n    // \u63D0\u53D6\u4EA7\u54C1 ID \u5E76\u521B\u5EFA\u4EA7\u54C1\u5361\u7247\n    const productId = match[1].trim()\n    const product = productMap.get(productId)\n    const rawProduct = rawProductMap.get(productId)\n\n    if (product) {\n      console.log('[useChatState] \uD83C\uDFAF \u5B9E\u65F6\u68C0\u6D4B\u5230\u4EA7\u54C1:', productId, '\u2192', product.title)\n      contents.push({\n        type: 'product_card',\n        data: {\n          product: product,\n          rawProduct: rawProduct,\n          onAddToCart: onAddToCart,\n          productCardRender: productCardRender\n        }\n      } as ProductCardContent)\n    } else {\n      // \u4EA7\u54C1\u672A\u627E\u5230\uFF0C\u4FDD\u7559\u539F\u59CB\u6587\u672C\n      console.warn('[useChatState] \u26A0\uFE0F \u5B9E\u65F6\u89E3\u6790\u672A\u627E\u5230\u4EA7\u54C1:', productId)\n      contents.push({ type: 'text', text: match[0] } as TextContent)\n    }\n\n    lastIndex = regex.lastIndex\n  }\n\n  // \u5982\u679C\u627E\u5230\u4E86\u81F3\u5C11\u4E00\u4E2A\u5B8C\u6574\u5360\u4F4D\u7B26\n  if (foundMatch) {\n    // \u8FD4\u56DE\u5269\u4F59\u7684\u6587\u672C\u4F5C\u4E3A\u7F13\u51B2\u533A\uFF08\u53EF\u80FD\u5305\u542B\u4E0D\u5B8C\u6574\u7684\u5360\u4F4D\u7B26\uFF09\n    const remainingBuffer = buffer.slice(lastIndex)\n    return { contents, remainingBuffer }\n  } else {\n    // \u6CA1\u6709\u627E\u5230\u5B8C\u6574\u5360\u4F4D\u7B26\uFF0C\u68C0\u67E5\u662F\u5426\u6709\u4E0D\u5B8C\u6574\u7684\u5360\u4F4D\u7B26\u5F00\u5934\n    // \u4F8B\u5982\uFF1A\u7F13\u51B2\u533A\u662F \"some text {{prod\"\uFF0C\u6211\u4EEC\u9700\u8981\u4FDD\u7559 \"{{prod\" \u7B49\u5F85\u66F4\u591A\u6587\u672C\n    const incompleteMatch = buffer.match(/\\{\\{[^}]*$/)\n\n    if (incompleteMatch) {\n      // \u6709\u4E0D\u5B8C\u6574\u7684\u5360\u4F4D\u7B26\u5F00\u5934\n      const completeText = buffer.slice(0, incompleteMatch.index)\n      if (completeText) {\n        contents.push({ type: 'text', text: completeText } as TextContent)\n      }\n      return { contents, remainingBuffer: incompleteMatch[0] }\n    } else {\n      // \u6CA1\u6709\u4E0D\u5B8C\u6574\u7684\u5360\u4F4D\u7B26\uFF0C\u6574\u4E2A\u7F13\u51B2\u533A\u90FD\u662F\u666E\u901A\u6587\u672C\n      if (buffer) {\n        contents.push({ type: 'text', text: buffer } as TextContent)\n      }\n      return { contents, remainingBuffer: '' }\n    }\n  }\n}\n\n/**\n * \u89E3\u6790\u6587\u672C\u4E2D\u7684 {{shopifyId}}\uFF0C\u8FD4\u56DE [text, product_card, text, ...] \u6570\u7EC4\uFF08\u7528\u4E8E\u5386\u53F2\u6D88\u606F\u91CD\u7EC4\uFF09\n *\n * @param text \u5305\u542B {{shopifyId}} \u6807\u8BB0\u7684\u6587\u672C\n * @param productMap shopifyId \u2192 Product \u7684\u6620\u5C04\u8868\n * @param onAddToCart \u6DFB\u52A0\u5230\u8D2D\u7269\u8F66\u56DE\u8C03\n * @param productCardRender \u81EA\u5B9A\u4E49\u4EA7\u54C1\u5361\u7247\u6E32\u67D3\u51FD\u6570\n * @returns MessageContent \u6570\u7EC4\n *\n * @example\n * \u8F93\u5165\uFF1A\n *   text: \"\u6211\u63A8\u8350\u4EE5\u4E0B\u4EA7\u54C1\uFF1A\\n{{12345}}\\n\u8FD9\u6B3E\u4EA7\u54C1\u6027\u4EF7\u6BD4\u5F88\u9AD8\u3002\"\n *   productMap: Map { '12345' => Product {...} }\n * \u8F93\u51FA\uFF1A\n *   [\n *     { type: 'text', text: '\u6211\u63A8\u8350\u4EE5\u4E0B\u4EA7\u54C1\uFF1A' },\n *     { type: 'product_card', data: { product: {...}, onAddToCart } },\n *     { type: 'text', text: '\u8FD9\u6B3E\u4EA7\u54C1\u6027\u4EF7\u6BD4\u5F88\u9AD8\u3002' }\n *   ]\n */\nfunction parseTextWithProductIds(\n  text: string,\n  productMap: Map<string, Product>,\n  rawProductMap: Map<string, any>,\n  onAddToCart?: (product: Product) => void,\n  productCardRender?: (product: any) => React.ReactNode\n): MessageContent[] {\n  const result: MessageContent[] = []\n  // \u4FEE\u6539\u6B63\u5219\u8868\u8FBE\u5F0F\u4EE5\u5339\u914D {{product:ID}} \u683C\u5F0F\n  // \u5339\u914D {{product:xxx}} \u6216 {{xxx}}\uFF08\u517C\u5BB9\u4E24\u79CD\u683C\u5F0F\uFF09\n  const regex = /\\{\\{(?:product:)?([^}]+)\\}\\}/g\n\n  let lastIndex = 0\n  let match: RegExpExecArray | null\n\n  while ((match = regex.exec(text)) !== null) {\n    const beforeText = text.slice(lastIndex, match.index).trim()\n    // match[1] \u662F\u6355\u83B7\u7EC4\u4E2D\u7684\u5185\u5BB9\uFF0C\u5373 product: \u540E\u9762\u7684 ID\n    const productId = match[1].trim()\n\n    // \u6DFB\u52A0\u524D\u9762\u7684\u6587\u672C\uFF08\u5982\u679C\u6709\uFF09\n    if (beforeText) {\n      result.push({\n        type: 'text',\n        text: beforeText,\n      } as TextContent)\n    }\n\n    // \u6DFB\u52A0\u4EA7\u54C1\u5361\u7247\n    const product = productMap.get(productId)\n    const rawProduct = rawProductMap.get(productId)\n    if (product) {\n      console.log(`[useChatState] \u2705 \u627E\u5230\u4EA7\u54C1\u5339\u914D: ${productId} \u2192 ${product.title}`)\n      result.push({\n        type: 'product_card',\n        data: {\n          product: product,\n          rawProduct: rawProduct,\n          onAddToCart: onAddToCart,\n          productCardRender: productCardRender,\n        },\n      } as ProductCardContent)\n    } else {\n      // \u627E\u4E0D\u5230\u4EA7\u54C1\u65F6\uFF0C\u4FDD\u7559\u539F\u59CB\u6807\u8BB0\uFF08\u4E0D\u5E94\u8BE5\u53D1\u751F\uFF0C\u4F46\u505A\u515C\u5E95\u5904\u7406\uFF09\n      const availableKeys = Array.from(productMap.keys())\n      console.warn(`[useChatState] \u274C Product not found for ID: \"${productId}\"`)\n      console.warn('[useChatState] \u53EF\u7528\u7684\u4EA7\u54C1ID\u5217\u8868:', availableKeys)\n      console.warn('[useChatState] ID\u7C7B\u578B:', typeof productId, '\u957F\u5EA6:', productId.length)\n      result.push({\n        type: 'text',\n        text: match[0], // \u4FDD\u7559\u539F\u59CB\u5B8C\u6574\u6807\u8BB0\uFF0C\u5305\u62EC product: \u524D\u7F00\n      } as TextContent)\n    }\n\n    lastIndex = regex.lastIndex\n  }\n\n  // \u6DFB\u52A0\u6700\u540E\u5269\u4F59\u7684\u6587\u672C\n  const remainingText = text.slice(lastIndex).trim()\n  if (remainingText) {\n    result.push({\n      type: 'text',\n      text: remainingText,\n    } as TextContent)\n  }\n\n  return result\n}\n\n/**\n * \u91CD\u7EC4\u6D88\u606F\u5185\u5BB9\uFF1A\u89E3\u6790\u6587\u672C\u4E2D\u7684 {{shopifyId}}\uFF0C\u66FF\u6362\u4E3A\u4EA7\u54C1\u5361\u7247\n *\n * \u5904\u7406\u903B\u8F91\uFF1A\n * 1. \u904D\u5386\u6D88\u606F\u7684\u6240\u6709 content blocks\n * 2. \u5BF9\u4E8E text \u7C7B\u578B\uFF0C\u89E3\u6790\u5176\u4E2D\u7684 {{shopifyId}} \u5E76\u62C6\u5206\u4E3A\u591A\u4E2A content\n * 3. \u8DF3\u8FC7 product_list \u7C7B\u578B\uFF08\u5DF2\u7ECF\u88AB\u62C6\u5206\u5230\u6587\u672C\u4E2D\uFF09\n * 4. \u5176\u4ED6\u7C7B\u578B\u76F4\u63A5\u4FDD\u7559\n *\n * @param contents \u539F\u59CB\u6D88\u606F\u5185\u5BB9\u6570\u7EC4\n * @param productMap shopifyId \u2192 Product \u7684\u6620\u5C04\u8868\n * @param onAddToCart \u6DFB\u52A0\u5230\u8D2D\u7269\u8F66\u56DE\u8C03\n * @param productCardRender \u81EA\u5B9A\u4E49\u4EA7\u54C1\u5361\u7247\u6E32\u67D3\u51FD\u6570\n * @returns \u91CD\u7EC4\u540E\u7684\u6D88\u606F\u5185\u5BB9\u6570\u7EC4\n */\nfunction reorganizeMessageContent(\n  contents: MessageContent[],\n  productMap: Map<string, Product>,\n  rawProductMap: Map<string, any>,\n  onAddToCart?: (product: Product) => void,\n  productCardRender?: (product: any) => React.ReactNode\n): MessageContent[] {\n  const result: MessageContent[] = []\n\n  for (const content of contents) {\n    // \u53EA\u5904\u7406\u6587\u672C\u7C7B\u578B\n    if (content.type === 'text') {\n      const textContent = content as TextContent\n      const segments = parseTextWithProductIds(textContent.text, productMap, rawProductMap, onAddToCart, productCardRender)\n      result.push(...segments)\n    }\n    // \u8DF3\u8FC7 product_list\uFF08\u5DF2\u7ECF\u88AB\u62C6\u5206\u5230\u6587\u672C\u4E2D\uFF09\n    else if (content.type === 'product_list') {\n      continue\n    }\n    // \u5176\u4ED6\u7C7B\u578B\u76F4\u63A5\u4FDD\u7559\n    else {\n      result.push(content)\n    }\n  }\n\n  return result\n}\n\n/**\n * \u5904\u7406\u5355\u6761\u6D88\u606F\u7684\u91CD\u7EC4\uFF08\u7528\u4E8E\u5386\u53F2\u6D88\u606F\u52A0\u8F7D\uFF09\n * \u5982\u679C\u6D88\u606F\u5305\u542B product_list \u548C\u5E26\u6709 {{}} \u7684\u6587\u672C\uFF0C\u5219\u8FDB\u884C\u91CD\u7EC4\n *\n * @param message \u539F\u59CB\u6D88\u606F\n * @param onAddToCart \u6DFB\u52A0\u5230\u8D2D\u7269\u8F66\u56DE\u8C03\n * @param productCardRender \u81EA\u5B9A\u4E49\u4EA7\u54C1\u5361\u7247\u6E32\u67D3\u51FD\u6570\n * @returns \u91CD\u7EC4\u540E\u7684\u6D88\u606F\uFF08\u5982\u679C\u9700\u8981\u91CD\u7EC4\uFF09\uFF0C\u5426\u5219\u8FD4\u56DE\u539F\u6D88\u606F\n */\nfunction maybeReorganizeHistoricalMessage(\n  message: Message,\n  onAddToCart?: (product: Product) => void,\n  productCardRender?: (product: any) => React.ReactNode\n): Message {\n  // \u68C0\u67E5\u6D88\u606F\u662F\u5426\u5305\u542B product_list\n  const hasProductList = message.content.some(c => c.type === 'product_list')\n  if (!hasProductList) {\n    return message // \u6CA1\u6709 product_list\uFF0C\u4E0D\u9700\u8981\u91CD\u7EC4\n  }\n\n  // \u68C0\u67E5\u6D88\u606F\u662F\u5426\u5305\u542B\u5E26\u6709 {{}} \u7684\u6587\u672C\n  const hasPlaceholder = message.content.some(\n    c => c.type === 'text' && /\\{\\{(?:product:)?[^}]+\\}\\}/.test((c as TextContent).text)\n  )\n  if (!hasPlaceholder) {\n    return message // \u6CA1\u6709\u5360\u4F4D\u7B26\uFF0C\u4E0D\u9700\u8981\u91CD\u7EC4\n  }\n\n  console.log('[useChatState] \u68C0\u6D4B\u5230\u5386\u53F2\u6D88\u606F\u9700\u8981\u91CD\u7EC4, \u6D88\u606FID:', message.id)\n\n  // \u6784\u5EFA\u4EA7\u54C1\u6620\u5C04\n  const productMap = new Map<string, Product>()\n  // \u4ECE structured_content \u4E2D\u63D0\u53D6\u539F\u59CB\u540E\u7AEF\u4EA7\u54C1\u6570\u636E\n  const rawProductMap = new Map<string, any>()\n\n  // \u4F18\u5148\u4ECE structured_content \u83B7\u53D6\u539F\u59CB\u4EA7\u54C1\u6570\u636E\uFF08\u5982\u679C\u5B58\u5728\uFF09\n  if (message.structured_content) {\n    message.structured_content.forEach(structuredContent => {\n      if (structuredContent.type === 'product_list' && Array.isArray(structuredContent.data)) {\n        structuredContent.data.forEach((rawProduct: any) => {\n          if (rawProduct && rawProduct.shopify_product_id) {\n            const shopifyId = rawProduct.shopify_product_id\n            // 1. \u4F7F\u7528\u5B8C\u6574\u7684 shopifyId \u4F5C\u4E3Akey\n            rawProductMap.set(shopifyId, rawProduct)\n\n            // 2. \u540C\u65F6\u63D0\u53D6\u6570\u5B57\u90E8\u5206\u4F5C\u4E3Akey\n            const numericId = shopifyId.match(/\\d+$/)?.[0]\n            if (numericId) {\n              rawProductMap.set(numericId, rawProduct)\n            }\n\n            console.log('[useChatState] \u4ECE structured_content \u63D0\u53D6\u539F\u59CB\u4EA7\u54C1\u6570\u636E:', {\n              fullId: shopifyId,\n              numericId,\n              title: rawProduct.title,\n            })\n          }\n        })\n      }\n    })\n  }\n\n  // \u6784\u5EFA\u8F6C\u6362\u540E\u7684\u4EA7\u54C1\u6620\u5C04\uFF08\u7528\u4E8E\u9ED8\u8BA4\u6E32\u67D3\uFF09\n  message.content.forEach(content => {\n    if (content.type === 'product_list') {\n      const productListContent = content as ProductListContent\n      productListContent.data.products.forEach(product => {\n        if (product && product.shopifyId) {\n          // 1. \u4F7F\u7528\u5B8C\u6574\u7684 shopifyId \u4F5C\u4E3Akey\n          productMap.set(product.shopifyId, product)\n\n          // 2. \u540C\u65F6\u63D0\u53D6\u6570\u5B57\u90E8\u5206\u4F5C\u4E3Akey\n          const numericId = product.shopifyId.match(/\\d+$/)?.[0]\n          if (numericId) {\n            productMap.set(numericId, product)\n          }\n        }\n      })\n    }\n  })\n\n  // \u91CD\u7EC4\u6D88\u606F\u5185\u5BB9\n  const reorganizedContent = reorganizeMessageContent(message.content, productMap, rawProductMap, onAddToCart, productCardRender)\n\n  // \u8FD4\u56DE\u65B0\u6D88\u606F\u5BF9\u8C61\n  return {\n    ...message,\n    content: reorganizedContent,\n  }\n}\n\nexport interface UseChatStateOptions {\n  /**\n   * \u521D\u59CB\u6B22\u8FCE\u6D88\u606F\n   */\n  welcomeMessage?: string\n\n  /**\n   * Shopify \u5E97\u94FA\u57DF\u540D\n   */\n  site?: string\n\n  /**\n   * \u53D7\u63A7\u6A21\u5F0F\uFF1A\u662F\u5426\u6253\u5F00\u804A\u5929\u7A97\u53E3\n   * \u63D0\u4F9B\u6B64\u53C2\u6570\u65F6\uFF0C\u7EC4\u4EF6\u5904\u4E8E\u53D7\u63A7\u6A21\u5F0F\n   */\n  open?: boolean\n\n  /**\n   * \u53D7\u63A7\u6A21\u5F0F\uFF1A\u72B6\u6001\u53D8\u5316\u56DE\u8C03\uFF08\u5FC5\u9700\uFF09\n   * \u7528\u4E8E\u540C\u6B65\u72B6\u6001\u5230\u7236\u7EC4\u4EF6\n   */\n  onOpenChange?: (open: boolean) => void\n\n  /**\n   * \u7A97\u53E3\u6253\u5F00\u4E8B\u4EF6\u76D1\u542C\uFF08\u53EF\u9009\uFF09\n   * \u7528\u4E8E\u57CB\u70B9\u3001\u65E5\u5FD7\u7B49\u526F\u4F5C\u7528\n   */\n  onOpen?: () => void\n\n  /**\n   * \u7A97\u53E3\u5173\u95ED\u4E8B\u4EF6\u76D1\u542C\uFF08\u53EF\u9009\uFF09\n   * \u7528\u4E8E\u57CB\u70B9\u3001\u65E5\u5FD7\u7B49\u526F\u4F5C\u7528\n   */\n  onClose?: () => void\n\n  /**\n   * \u6D88\u606F\u53D1\u9001\u56DE\u8C03\n   */\n  onMessageSend?: (message: string) => void\n\n  /**\n   * \u9519\u8BEF\u5904\u7406\u56DE\u8C03\n   */\n  onError?: (error: Error) => void\n\n  /**\n   * AI \u6D88\u606F\u56DE\u8C03\n   */\n  /**\n   * AI \u56DE\u590D\u6587\u672C\u6D88\u606F\u65F6\u89E6\u53D1\n   */\n  onTextMessage?: () => void\n\n  /**\n   * AI \u56DE\u590D\u5546\u54C1\u5217\u8868\u5361\u7247\u65F6\u89E6\u53D1\n   */\n  onProductList?: () => void\n\n  /**\n   * AI \u56DE\u590D\u4FC3\u9500\u5361\u7247\u65F6\u89E6\u53D1\n   */\n  onPromotionList?: () => void\n\n  /**\n   * \u5546\u54C1\u6DFB\u52A0\u5230\u8D2D\u7269\u8F66\u56DE\u8C03\n   */\n  onAddToCart?: (product: any) => void\n\n  /**\n   * \u8D2D\u7269\u8F66\u6309\u94AE\u70B9\u51FB\u56DE\u8C03\n   */\n  onCart?: (cartId: string, checkoutUrl?: string) => void\n\n  /**\n   * \u81EA\u5B9A\u4E49\u4EA7\u54C1\u5361\u7247\u6E32\u67D3\u51FD\u6570\n   */\n  productCardRender?: (product: Product) => React.ReactNode\n}\n\nexport interface UseChatStateReturn {\n  /**\n   * \u6D88\u606F\u5217\u8868\n   */\n  messages: Message[]\n\n  /**\n   * \u804A\u5929\u7A97\u53E3\u662F\u5426\u6253\u5F00\n   */\n  isOpen: boolean\n\n  /**\n   * \u7528\u6237 ID\n   */\n  userId: string\n\n  /**\n   * \u4F1A\u8BDD ID\n   */\n  sessionId: string | null\n\n  /**\n   * \u8F93\u5165\u6846\u5185\u5BB9\n   */\n  inputValue: string\n\n  /**\n   * \u662F\u5426\u6B63\u5728\u63A5\u6536\u6D41\u5F0F\u6D88\u606F\n   */\n  isStreaming: boolean\n\n  /**\n   * \u6253\u5F00\u804A\u5929\u7A97\u53E3\n   */\n  openChat: () => void\n\n  /**\n   * \u5173\u95ED\u804A\u5929\u7A97\u53E3\n   */\n  closeChat: () => void\n\n  /**\n   * \u5207\u6362\u804A\u5929\u7A97\u53E3\u72B6\u6001\n   */\n  toggleChat: () => void\n\n  /**\n   * \u8BBE\u7F6E\u8F93\u5165\u6846\u5185\u5BB9\n   */\n  setInputValue: (value: string) => void\n\n  /**\n   * \u6DFB\u52A0\u6D88\u606F\u5230\u5217\u8868\n   */\n  addMessage: (message: Message) => void\n\n  /**\n   * \u6279\u91CF\u8BBE\u7F6E\u6D88\u606F\u5217\u8868\uFF08\u7528\u4E8E\u52A0\u8F7D\u5386\u53F2\uFF09\n   */\n  setMessages: (messages: Message[]) => void\n\n  /**\n   * \u6E05\u7A7A\u6D88\u606F\u5217\u8868\n   */\n  clearMessages: () => void\n\n  /**\n   * \u5904\u7406 SSE \u4E8B\u4EF6\n   */\n  handleSSEEvent: (event: SSEEvent) => void\n\n  /**\n   * \u4FDD\u5B58\u4F1A\u8BDD ID\n   */\n  saveSession: (id: string) => void\n\n  /**\n   * \u6E05\u7A7A\u4F1A\u8BDD\n   */\n  clearSession: () => void\n}\n\n/**\n * \u804A\u5929\u72B6\u6001\u7BA1\u7406 Hook\n *\n * \u529F\u80FD\uFF1A\n * 1. \u7BA1\u7406\u6D88\u606F\u5217\u8868\uFF08\u6DFB\u52A0\u3001\u6E05\u7A7A\u3001\u6279\u91CF\u8BBE\u7F6E\uFF09\n * 2. \u7BA1\u7406\u7A97\u53E3\u72B6\u6001\uFF08\u6253\u5F00\u3001\u5173\u95ED\u3001\u5207\u6362\uFF09\n * 3. \u7BA1\u7406\u8F93\u5165\u6846\u72B6\u6001\n * 4. \u5904\u7406 SSE \u6D41\u5F0F\u6D88\u606F\u4E8B\u4EF6\n * 5. \u7D2F\u79EF\u6D41\u5F0F\u6587\u672C\u5185\u5BB9\n *\n * @param options Hook \u914D\u7F6E\u9009\u9879\n * @returns \u72B6\u6001\u7BA1\u7406\u5DE5\u5177\u5BF9\u8C61\n */\nexport function useChatState(options: UseChatStateOptions = {}): UseChatStateReturn {\n  const {\n    welcomeMessage,\n    site,\n    open: controlledOpen,\n    onOpenChange,\n    onOpen,\n    onClose,\n    onMessageSend,\n    onError,\n    onTextMessage,\n    onProductList,\n    onPromotionList,\n    onAddToCart,\n    onCart,\n    productCardRender,\n  } = options\n\n  // \u4F1A\u8BDD\u7BA1\u7406\n  const { sessionId, saveSession, clearSession } = useSession()\n\n  // \u7528\u6237 ID (\u521D\u59CB\u5316\u65F6\u5F02\u6B65\u751F\u6210)\n  const [userId, setUserId] = useState<string>('')\n\n  // \u521D\u59CB\u5316 userId\n  useEffect(() => {\n    getUserId().then(id => setUserId(id))\n  }, [])\n\n  // \u6D88\u606F\u5217\u8868\n  const [messages, setMessagesState] = useState<Message[]>(() => {\n    // \u5982\u679C\u6709\u6B22\u8FCE\u6D88\u606F\uFF0C\u521D\u59CB\u5316\u65F6\u6DFB\u52A0\n    if (welcomeMessage) {\n      return [\n        {\n          id: `welcome-${Date.now()}`,\n          role: 'assistant',\n          content: [{ type: 'text', text: welcomeMessage }],\n          timestamp: Date.now(),\n        },\n      ]\n    }\n    return []\n  })\n\n  // \u804A\u5929\u7A97\u53E3\u662F\u5426\u6253\u5F00\uFF08\u652F\u6301\u53D7\u63A7\u548C\u975E\u53D7\u63A7\u4E24\u79CD\u6A21\u5F0F\uFF09\n  const [internalOpen, setInternalOpen] = useState(false)\n  const isControlled = controlledOpen !== undefined\n  const isOpen = isControlled ? controlledOpen : internalOpen\n\n  // \u8F93\u5165\u6846\u5185\u5BB9\n  const [inputValue, setInputValue] = useState('')\n\n  // \u662F\u5426\u6B63\u5728\u63A5\u6536\u6D41\u5F0F\u6D88\u606F\n  const [isStreaming, setIsStreaming] = useState(false)\n\n  // \u5F53\u524D\u6B63\u5728\u7D2F\u79EF\u7684\u6D41\u5F0F\u6D88\u606F (\u4E34\u65F6\u5B58\u50A8)\n  const currentMessageRef = useRef<Message | null>(null)\n\n  // \u6807\u8BB0\u5F53\u524D\u6D88\u606F\u662F\u5426\u5DF2\u89E6\u53D1 onTextMessage \u56DE\u8C03\uFF08\u907F\u514D\u91CD\u590D\u89E6\u53D1\uFF09\n  const textMessageCallbackTriggeredRef = useRef<boolean>(false)\n\n  // \u4EA7\u54C1\u6620\u5C04\u7F13\u5B58 (shopifyId \u2192 Product)\uFF0C\u7528\u4E8E\u5B9E\u65F6\u89E3\u6790\u5360\u4F4D\u7B26\n  const productMapRef = useRef<Map<string, Product>>(new Map())\n\n  // \u539F\u59CB\u4EA7\u54C1\u6570\u636E\u7F13\u5B58 (shopifyId \u2192 raw backend product)\uFF0C\u7528\u4E8E productCardRender\n  const rawProductMapRef = useRef<Map<string, any>>(new Map())\n\n  // \u6587\u672C\u7F13\u51B2\u533A\uFF0C\u7528\u4E8E\u5B58\u50A8\u672A\u5B8C\u6210\u7684\u6587\u672C\uFF08\u5904\u7406\u5360\u4F4D\u7B26\u8DE8\u8D8A\u591A\u4E2A delta \u7684\u60C5\u51B5\uFF09\n  const textBufferRef = useRef<string>('')\n\n  /**\n   * \u6253\u5F00\u804A\u5929\u7A97\u53E3\n   */\n  const openChat = useCallback(() => {\n    if (!isControlled) {\n      setInternalOpen(true)\n    }\n    onOpenChange?.(true)\n    onOpen?.()\n  }, [isControlled, onOpenChange, onOpen])\n\n  /**\n   * \u5173\u95ED\u804A\u5929\u7A97\u53E3\n   */\n  const closeChat = useCallback(() => {\n    if (!isControlled) {\n      setInternalOpen(false)\n    }\n    onOpenChange?.(false)\n    onClose?.()\n  }, [isControlled, onOpenChange, onClose])\n\n  /**\n   * \u5207\u6362\u804A\u5929\u7A97\u53E3\u72B6\u6001\n   */\n  const toggleChat = useCallback(() => {\n    const newState = !isOpen\n    if (!isControlled) {\n      setInternalOpen(newState)\n    }\n    onOpenChange?.(newState)\n    if (newState) {\n      onOpen?.()\n    } else {\n      onClose?.()\n    }\n  }, [isControlled, isOpen, onOpenChange, onOpen, onClose])\n\n  /**\n   * \u6DFB\u52A0\u6D88\u606F\u5230\u5217\u8868\n   */\n  const addMessage = useCallback((message: Message) => {\n    // \u9632\u62A4\uFF1A\u5982\u679C\u6D88\u606F\u4E3A null \u6216 undefined\uFF0C\u4E0D\u6DFB\u52A0\n    if (!message) {\n      console.warn('[useChatState] Attempted to add null/undefined message')\n      return\n    }\n    setMessagesState(prev => [...prev, message])\n  }, [])\n\n  /**\n   * \u6279\u91CF\u8BBE\u7F6E\u6D88\u606F\u5217\u8868\uFF08\u7528\u4E8E\u52A0\u8F7D\u5386\u53F2\uFF09\n   */\n  const setMessages = useCallback(\n    (newMessages: Message[]) => {\n      // \u9632\u62A4\uFF1A\u8FC7\u6EE4\u6389 null/undefined \u6D88\u606F\n      const validMessages = newMessages.filter(msg => msg != null)\n      if (validMessages.length !== newMessages.length) {\n        console.warn('[useChatState] Filtered out null/undefined messages from batch set')\n      }\n\n      // \u5BF9\u6BCF\u6761\u5386\u53F2\u6D88\u606F\u8FDB\u884C\u91CD\u7EC4\uFF08\u5982\u679C\u9700\u8981\uFF09\n      const reorganizedMessages = validMessages.map(msg => maybeReorganizeHistoricalMessage(msg, onAddToCart, productCardRender))\n\n      setMessagesState(reorganizedMessages)\n    },\n    [onAddToCart, productCardRender]\n  )\n\n  /**\n   * \u6E05\u7A7A\u6D88\u606F\u5217\u8868\n   */\n  const clearMessages = useCallback(() => {\n    setMessagesState([])\n  }, [])\n\n  /**\n   * \u5904\u7406 SSE \u4E8B\u4EF6\n   * \u6839\u636E\u4E8B\u4EF6\u7C7B\u578B\u8FDB\u884C\u4E0D\u540C\u7684\u5904\u7406\n   */\n  const handleSSEEvent = useCallback(\n    (event: SSEEvent) => {\n      const { event: eventType, data } = event\n\n      switch (eventType) {\n        case 'message_start': {\n          // \u5F00\u59CB\u63A5\u6536\u65B0\u6D88\u606F\n          setIsStreaming(true)\n\n          // \u91CD\u7F6E\u6587\u672C\u6D88\u606F\u56DE\u8C03\u6807\u8BB0\n          textMessageCallbackTriggeredRef.current = false\n\n          // \u91CD\u7F6E\u6587\u672C\u7F13\u51B2\u533A\n          textBufferRef.current = ''\n\n          // T039: \u4FDD\u5B58 sessionId\uFF08\u5982\u679C\u540E\u7AEF\u8FD4\u56DE\uFF09\n          const messageStartData = data as MessageStartData\n          if (messageStartData.sessionId && messageStartData.sessionId !== sessionId) {\n            saveSession(messageStartData.sessionId)\n          }\n\n          // \u68C0\u67E5\u6700\u540E\u4E00\u6761\u6D88\u606F\u662F\u5426\u662F thinking \u6D88\u606F\uFF08\u7528\u6237\u53D1\u9001\u6D88\u606F\u65F6\u5DF2\u6DFB\u52A0\uFF09\n          setMessagesState(prev => {\n            const lastMessage = prev[prev.length - 1]\n            const hasThinking =\n              lastMessage &&\n              lastMessage.role === 'assistant' &&\n              lastMessage.content.length === 1 &&\n              lastMessage.content[0].type === 'thinking'\n\n            if (hasThinking) {\n              // \u590D\u7528\u5DF2\u5B58\u5728\u7684 thinking \u6D88\u606F\n              currentMessageRef.current = lastMessage\n              return prev // \u4E0D\u9700\u8981\u6DFB\u52A0\u65B0\u6D88\u606F\n            } else {\n              // \u6CA1\u6709 thinking \u6D88\u606F\uFF0C\u521B\u5EFA\u65B0\u7684\uFF08\u517C\u5BB9\u5176\u4ED6\u573A\u666F\uFF09\n              const messageId = `msg-${Date.now()}`\n              currentMessageRef.current = {\n                id: messageId,\n                role: 'assistant',\n                content: [{ type: 'thinking', data: { status: 'thinking' } }],\n                timestamp: Date.now(),\n              }\n              return [...prev, currentMessageRef.current!]\n            }\n          })\n          break\n        }\n\n        case 'content_delta': {\n          // \u7D2F\u79EF\u6D41\u5F0F\u6587\u672C\u5185\u5BB9\uFF0C\u5E76\u5B9E\u65F6\u68C0\u6D4B\u4EA7\u54C1\u5360\u4F4D\u7B26\n          const deltaData = data as any\n          const deltaText = deltaData.delta || deltaData.text || ''\n\n          if (currentMessageRef.current && deltaText) {\n            // \u89E6\u53D1\u6587\u672C\u6D88\u606F\u56DE\u8C03\uFF08\u4EC5\u89E6\u53D1\u4E00\u6B21\uFF09\n            if (!textMessageCallbackTriggeredRef.current) {\n              textMessageCallbackTriggeredRef.current = true\n              onTextMessage?.()\n            }\n\n            // \u79FB\u9664\u601D\u8003\u6C14\u6CE1\uFF08\u5982\u679C\u5B58\u5728\uFF09\n            const hasThinking = currentMessageRef.current.content.some(c => c.type === 'thinking')\n            if (hasThinking) {\n              currentMessageRef.current.content = currentMessageRef.current.content.filter(c => c.type !== 'thinking')\n            }\n\n            // \u5C06\u65B0\u6587\u672C\u6DFB\u52A0\u5230\u7F13\u51B2\u533A\n            textBufferRef.current += deltaText\n\n            // \u5B9E\u65F6\u89E3\u6790\u7F13\u51B2\u533A\u4E2D\u7684\u5360\u4F4D\u7B26\n            const { contents, remainingBuffer } = parseStreamingText(\n              textBufferRef.current,\n              productMapRef.current,\n              rawProductMapRef.current,\n              onAddToCart,\n              productCardRender\n            )\n\n            // \u66F4\u65B0\u7F13\u51B2\u533A\u4E3A\u5269\u4F59\u5185\u5BB9\n            textBufferRef.current = remainingBuffer\n\n            // \u5C06\u89E3\u6790\u51FA\u7684\u5185\u5BB9\u6DFB\u52A0\u5230\u6D88\u606F\u4E2D\n            if (contents.length > 0) {\n              contents.forEach(content => {\n                const lastContent = currentMessageRef.current!.content[\n                  currentMessageRef.current!.content.length - 1\n                ] as MessageContent | undefined\n\n                // \u5982\u679C\u662F\u6587\u672C\u5185\u5BB9\u4E14\u6700\u540E\u4E00\u4E2A\u4E5F\u662F\u6587\u672C\uFF0C\u5219\u5408\u5E76\n                if (content.type === 'text' && lastContent && lastContent.type === 'text') {\n                  lastContent.text += content.text\n                } else {\n                  // \u5426\u5219\u6DFB\u52A0\u65B0\u5185\u5BB9\n                  currentMessageRef.current!.content.push(content)\n                }\n              })\n\n              // \u66F4\u65B0\u6D88\u606F\u5217\u8868\u4EE5\u89E6\u53D1\u6E32\u67D3\n              setMessagesState(prev => {\n                if (!currentMessageRef.current) return prev\n\n                const updated = [...prev]\n                const existingIndex = updated.findIndex(m => m && m.id === currentMessageRef.current!.id)\n\n                if (existingIndex >= 0) {\n                  updated[existingIndex] = { ...currentMessageRef.current! }\n                } else {\n                  updated.push({ ...currentMessageRef.current! })\n                }\n\n                return updated\n              })\n            }\n          }\n          break\n        }\n\n        case 'content_block': {\n          // \u63A5\u6536\u7ED3\u6784\u5316\u5185\u5BB9\u5757\uFF08\u5546\u54C1\u3001\u653F\u7B56\u7B49\uFF09\n          // API \u8FD4\u56DE\u683C\u5F0F\u53D8\u66F4:\n          // \u65B0\u683C\u5F0F: {index: number, type: string, data: {...}}  <- type \u5728\u5916\u5C42\n          // \u65E7\u683C\u5F0F: {index: number, data: {type: string, ...}}  <- type \u5728 data \u5185\n          const blockData = data as any\n          if (currentMessageRef.current) {\n            // \u83B7\u53D6 type \u548C data\n            // \u4F18\u5148\u4ECE\u5916\u5C42\u83B7\u53D6 type\uFF0C\u517C\u5BB9\u65E7\u683C\u5F0F\u4ECE data \u5185\u83B7\u53D6\n            const contentType = blockData.type || blockData.data?.type\n            const contentData = blockData.data\n\n            if (!contentType || !contentData) {\n              console.warn('[useChatState] Invalid content_block:', blockData)\n              break\n            }\n\n            // ============================================================\n            // \u8F6C\u6362\u6570\u636E\u7ED3\u6784\u4EE5\u5339\u914D\u7C7B\u578B\u5B9A\u4E49\n            // \u6839\u636E\u540E\u7AEF\u6570\u636E\u7ED3\u6784\u89C4\u8303\uFF08\u98DE\u4E66\u6587\u6863\uFF09\u8FDB\u884C\u8F6C\u6362\n            // ============================================================\n            let messageContent: MessageContent\n\n            // ========== 1. \u4EA7\u54C1\u5217\u8868\u5361\u7247 (Product List) ==========\n            // \u540E\u7AEF\u683C\u5F0F: {type: \"product_list\", data: [product1, product2, ...]}\n            // data \u76F4\u63A5\u662F\u4EA7\u54C1\u6570\u7EC4\uFF0C\u4E0D\u662F {products: [...]}\n            if (contentType === 'product_list' && Array.isArray(contentData)) {\n              // \u89E6\u53D1\u5546\u54C1\u5217\u8868\u56DE\u8C03\n              onProductList?.()\n\n              // \u7F13\u5B58\u539F\u59CB\u540E\u7AEF\u4EA7\u54C1\u6570\u636E\uFF08\u7528\u4E8E productCardRender\uFF09\n              contentData.forEach((rawProduct: any) => {\n                if (rawProduct && rawProduct.shopify_product_id) {\n                  const shopifyId = rawProduct.shopify_product_id\n                  // 1. \u4F7F\u7528\u5B8C\u6574\u7684 shopifyId \u4F5C\u4E3Akey\n                  rawProductMapRef.current.set(shopifyId, rawProduct)\n\n                  // 2. \u540C\u65F6\u63D0\u53D6\u6570\u5B57\u90E8\u5206\u4F5C\u4E3Akey\n                  const numericId = shopifyId.match(/\\d+$/)?.[0]\n                  if (numericId) {\n                    rawProductMapRef.current.set(numericId, rawProduct)\n                  }\n                }\n              })\n\n              // \u4F7F\u7528\u7EDF\u4E00\u7684\u4EA7\u54C1\u8F6C\u6362\u5DE5\u5177\u51FD\u6570\n              const transformedProducts = transformProducts(contentData, site)\n\n              // \u5EFA\u7ACB\u4EA7\u54C1\u6620\u5C04\u7F13\u5B58 (shopifyId \u2192 Product)\n              // \u7528\u4E8E\u540E\u7EED\u5728 message_end \u65F6\u89E3\u6790\u6587\u672C\u4E2D\u7684 {{shopifyId}}\n              transformedProducts.forEach(product => {\n                if (product && product.shopifyId) {\n                  // 1. \u4F7F\u7528\u5B8C\u6574\u7684 shopifyId \u4F5C\u4E3Akey\uFF08\u5982 \"gid://shopify/Product/123\"\uFF09\n                  productMapRef.current.set(product.shopifyId, product)\n\n                  // 2. \u540C\u65F6\u63D0\u53D6\u6570\u5B57\u90E8\u5206\u4F5C\u4E3Akey\uFF08\u5982 \"123\"\uFF09\uFF0C\u652F\u6301\u7B80\u5199\u683C\u5F0F\n                  // \u4ECE \"gid://shopify/Product/123\" \u6216 \"123\" \u4E2D\u63D0\u53D6\u7EAF\u6570\u5B57\n                  const numericId = product.shopifyId.match(/\\d+$/)?.[0]\n                  if (numericId) {\n                    productMapRef.current.set(numericId, product)\n                  }\n\n                  console.log('[useChatState] \u5EFA\u7ACB\u4EA7\u54C1\u6620\u5C04:', {\n                    fullId: product.shopifyId,\n                    numericId,\n                    title: product.title,\n                  })\n                }\n              })\n\n              // \u26A0\uFE0F \u4E0D\u8981\u628A product_list \u6DFB\u52A0\u5230\u6D88\u606F\u4E2D\uFF0C\u907F\u514D\u95EA\u70C1\n              // \u7B49\u5230 message_end \u65F6\uFF0C\u901A\u8FC7\u6587\u672C\u89E3\u6790\u521B\u5EFA product_card\uFF0C\u76F4\u63A5\u663E\u793A\u6700\u7EC8\u7684\u4EA4\u66FF\u683C\u5F0F\n              console.log('[useChatState] \u2705 \u4EA7\u54C1\u5217\u8868\u5DF2\u7F13\u5B58\uFF0C\u4E0D\u6DFB\u52A0\u5230\u6D88\u606F\u4E2D\uFF08\u907F\u514D\u95EA\u70C1\uFF09')\n              break // \u76F4\u63A5\u8DF3\u51FA\uFF0C\u4E0D\u6267\u884C\u540E\u7EED\u7684 push \u64CD\u4F5C\n            }\n            // ========== 2. \u4EA7\u54C1\u5BF9\u6BD4\u5361\u7247 (Product Comparison) ==========\n            // \u540E\u7AEF\u683C\u5F0F: {type: \"product_comparison\", data: {products: [...], dimensions: {...}}}\n            else if (contentType === 'product_comparison' && contentData.products) {\n              // \u4F7F\u7528\u7EDF\u4E00\u7684\u4EA7\u54C1\u8F6C\u6362\u5DE5\u5177\u51FD\u6570\n              const transformedProducts = transformProducts(contentData.products, site)\n\n              messageContent = {\n                type: 'product_comparison',\n                data: {\n                  products: transformedProducts,\n                  dimensions: contentData.dimensions || {},\n                },\n              } as MessageContent\n            }\n            // ========== 3. FAQ \u5217\u8868\u5361\u7247 (FAQ List) ==========\n            // \u540E\u7AEF\u683C\u5F0F: {type: \"faq_list\", data: {found, count, total, results: [...]}}\n            else if (contentType === 'faq_list' && contentData.found !== undefined) {\n              messageContent = {\n                type: 'faq_list',\n                data: contentData, // \u76F4\u63A5\u4F7F\u7528\uFF0C\u7ED3\u6784\u5DF2\u5339\u914D\n              } as MessageContent\n            }\n            // ========== 4. \u5FEB\u6377\u56DE\u590D (Quick Replies) ==========\n            else if (contentType === 'quick_replies' && contentData.replies) {\n              messageContent = {\n                type: 'quick_replies',\n                data: {\n                  replies: contentData.replies,\n                },\n              } as MessageContent\n            }\n            // ========== 5. \u653F\u7B56\u5185\u5BB9 (Policy) ==========\n            else if (contentType === 'policy' && contentData.title && contentData.content) {\n              messageContent = {\n                type: 'policy',\n                data: {\n                  title: contentData.title,\n                  content: contentData.content,\n                },\n              } as MessageContent\n            }\n            // ========== 6. \u4FC3\u9500\u6D3B\u52A8\u5217\u8868 (Promotion List) ==========\n            // \u540E\u7AEF\u683C\u5F0F: {type: \"promotion_list\", data: {found, count, total, results: [...]}}\n            else if (contentType === 'promotion_list' && contentData.found !== undefined) {\n              // \u89E6\u53D1\u4FC3\u9500\u5361\u7247\u56DE\u8C03\n              onPromotionList?.()\n\n              messageContent = {\n                type: 'promotion_list',\n                data: contentData, // \u76F4\u63A5\u4F7F\u7528\uFF0C\u7ED3\u6784\u5DF2\u5339\u914D\n              } as MessageContent\n            }\n            // ========== 7. \u8D2D\u7269\u8F66 (Cart) ==========\n            // \u540E\u7AEF\u683C\u5F0F: {type: \"cart\", data: {id, lines: {edges: [...]}, cost, ...}} (Shopify GraphQL)\n            // \u9700\u8981\u8F6C\u6362\u4E3A\u524D\u7AEF\u683C\u5F0F: {cartId, lines: [...], cost, ...}\n            else if (contentType === 'cart' && contentData.id !== undefined) {\n              // \u8F6C\u6362\u540E\u7AEF Shopify GraphQL \u683C\u5F0F\u4E3A\u524D\u7AEF\u6807\u51C6\u683C\u5F0F\n              const transformedData = transformCartData(contentData as BackendCartData)\n              messageContent = {\n                type: 'cart',\n                data: {\n                  ...transformedData,\n                  onCart: onCart, // \u6CE8\u5165\u8D2D\u7269\u8F66\u6309\u94AE\u56DE\u8C03\n                },\n              } as MessageContent\n            }\n            // ========== 8. \u5176\u4ED6\u7C7B\u578B\uFF08\u901A\u7528\u5904\u7406\uFF09 ==========\n            else {\n              messageContent = {\n                type: contentType,\n                data: contentData,\n              } as MessageContent\n            }\n\n            currentMessageRef.current.content.push(messageContent)\n\n            setMessagesState(prev => {\n              if (!currentMessageRef.current) return prev\n\n              const updated = [...prev]\n              const existingIndex = updated.findIndex(m => m && m.id === currentMessageRef.current!.id)\n\n              if (existingIndex >= 0) {\n                updated[existingIndex] = { ...currentMessageRef.current! }\n              } else {\n                updated.push({ ...currentMessageRef.current! })\n              }\n\n              return updated\n            })\n          }\n          break\n        }\n\n        case 'tool_start':\n        case 'tool_end': {\n          // \u5DE5\u5177\u8C03\u7528\u4E8B\u4EF6\uFF0C\u6682\u65F6\u5FFD\u7565\n          // \u53EF\u4EE5\u5728\u672A\u6765\u7528\u4E8E\u663E\u793A\u5DE5\u5177\u8C03\u7528\u72B6\u6001\n          break\n        }\n\n        case 'message_end': {\n          // \u6D88\u606F\u63A5\u6536\u5B8C\u6210\n          setIsStreaming(false)\n\n          // \u5904\u7406\u7F13\u51B2\u533A\u4E2D\u5269\u4F59\u7684\u6587\u672C\uFF08\u5982\u679C\u6709\uFF09\n          if (currentMessageRef.current && textBufferRef.current) {\n            console.log('[useChatState] \u5904\u7406\u5269\u4F59\u7F13\u51B2\u533A:', textBufferRef.current)\n\n            const lastContent = currentMessageRef.current.content[\n              currentMessageRef.current.content.length - 1\n            ] as MessageContent | undefined\n\n            // \u5982\u679C\u6700\u540E\u4E00\u4E2A\u5185\u5BB9\u662F\u6587\u672C\uFF0C\u5219\u5408\u5E76\n            if (lastContent && lastContent.type === 'text') {\n              lastContent.text += textBufferRef.current\n            } else {\n              // \u5426\u5219\u6DFB\u52A0\u4E3A\u65B0\u7684\u6587\u672C\u5757\n              currentMessageRef.current.content.push({\n                type: 'text',\n                text: textBufferRef.current,\n              })\n            }\n\n            // \u66F4\u65B0\u6D88\u606F\u5217\u8868\n            setMessagesState(prev => {\n              if (!currentMessageRef.current) return prev\n\n              const updated = [...prev]\n              const existingIndex = updated.findIndex(m => m && m.id === currentMessageRef.current!.id)\n\n              if (existingIndex >= 0) {\n                updated[existingIndex] = { ...currentMessageRef.current! }\n              }\n\n              return updated\n            })\n          }\n\n          // \u6E05\u7A7A\u7F13\u51B2\u533A\u548C\u4EA7\u54C1\u6620\u5C04\n          textBufferRef.current = ''\n          productMapRef.current.clear()\n          rawProductMapRef.current.clear()\n          currentMessageRef.current = null\n          break\n        }\n\n        case 'status': {\n          // T040: \u72B6\u6001\u66F4\u65B0\uFF08\u5982\u4F1A\u8BDD\u8FC7\u671F\uFF09\n          const statusData = data as StatusData\n          if (statusData.type === 'session_expired') {\n            // \u4F1A\u8BDD\u8FC7\u671F\uFF0C\u6E05\u7A7A\u6D88\u606F\u5217\u8868\u548C\u4F1A\u8BDD\n            clearMessages()\n            clearSession()\n            if (welcomeMessage) {\n              addMessage({\n                id: `welcome-${Date.now()}`,\n                role: 'assistant',\n                content: [{ type: 'text', text: welcomeMessage }],\n                timestamp: Date.now(),\n              })\n            }\n          }\n          break\n        }\n\n        case 'error': {\n          // \u9519\u8BEF\u5904\u7406\n          const errorData = data as ErrorData\n          setIsStreaming(false)\n          currentMessageRef.current = null\n\n          // \u6DFB\u52A0\u9519\u8BEF\u6D88\u606F\u5230\u754C\u9762\n          addMessage({\n            id: `error-${Date.now()}`,\n            role: 'system',\n            content: [\n              {\n                type: 'error',\n                data: {\n                  message: errorData.message,\n                  code: errorData.code,\n                },\n              },\n            ],\n            timestamp: Date.now(),\n          })\n\n          onError?.(new Error(errorData.message))\n          break\n        }\n\n        case 'done': {\n          // \u6D41\u7ED3\u675F\n          setIsStreaming(false)\n          currentMessageRef.current = null\n          break\n        }\n\n        default:\n          // \u5176\u4ED6\u4E8B\u4EF6\u7C7B\u578B\uFF08tool_start, tool_end \u7B49\uFF09\n          break\n      }\n    },\n    [\n      welcomeMessage,\n      site,\n      addMessage,\n      clearMessages,\n      clearSession,\n      saveSession,\n      sessionId,\n      onError,\n      onTextMessage,\n      onProductList,\n      onPromotionList,\n      onAddToCart,\n      onCart,\n    ]\n  )\n\n  return {\n    messages,\n    isOpen,\n    userId,\n    sessionId,\n    inputValue,\n    isStreaming,\n    openChat,\n    closeChat,\n    toggleChat,\n    setInputValue,\n    addMessage,\n    setMessages,\n    clearMessages,\n    handleSSEEvent,\n    saveSession,\n    clearSession,\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["useChatState_exports", "__export", "useChatState", "__toCommonJS", "import_react", "import_userId", "import_useSession", "import_productTransformers", "import_cartTransformers", "parseStreamingText", "buffer", "productMap", "rawProductMap", "onAddToCart", "productCardRender", "contents", "regex", "lastIndex", "match", "foundMatch", "beforeText", "productId", "product", "rawProduct", "remainingBuffer", "incompleteMatch", "completeText", "parseTextWithProductIds", "text", "result", "availableKeys", "remainingText", "reorganizeMessageContent", "content", "segments", "maybeReorganizeHistoricalMessage", "message", "c", "structuredContent", "shopifyId", "numericId", "reorganizedContent", "options", "welcomeMessage", "site", "controlledOpen", "onOpenChange", "onOpen", "onClose", "onMessageSend", "onError", "onTextMessage", "onProductList", "onPromotionList", "onCart", "sessionId", "saveSession", "clearSession", "userId", "setUserId", "id", "messages", "setMessagesState", "internalOpen", "setInternalOpen", "isControlled", "isOpen", "inputValue", "setInputValue", "isStreaming", "setIsStreaming", "currentMessageRef", "textMessageCallbackTriggeredRef", "productMapRef", "rawProductMapRef", "textBufferRef", "openChat", "closeChat", "toggleChat", "newState", "addMessage", "prev", "setMessages", "newMessages", "validMessages", "msg", "reorganizedMessages", "clearMessages", "handleSSEEvent", "event", "eventType", "data", "messageStartData", "lastMessage", "messageId", "deltaData", "deltaText", "lastContent", "updated", "existingIndex", "m", "blockData", "contentType", "contentData", "messageContent", "errorData"]
+}

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

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

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

@@ -0,0 +1,2 @@
+"use strict";var l=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var c=Object.getOwnPropertyNames;var S=Object.prototype.hasOwnProperty;var d=(s,o)=>{for(var r in o)l(s,r,{get:o[r],enumerable:!0})},f=(s,o,r,t)=>{if(o&&typeof o=="object"||typeof o=="function")for(let e of c(o))!S.call(s,e)&&e!==r&&l(s,e,{get:()=>o[e],enumerable:!(t=u(o,e))||t.enumerable});return s};var g=s=>f(l({},"__esModule",{value:!0}),s);var v={};d(v,{useSession:()=>w});module.exports=g(v);var n=require("react");const a="livechat_session_id";function w(){const[s,o]=(0,n.useState)(()=>{if(typeof window>"u")return null;try{return localStorage.getItem(a)}catch(e){return console.error("[useSession] Failed to read from localStorage:",e),null}}),r=(0,n.useCallback)(e=>{if(!e||typeof e!="string"){console.warn("[useSession] Invalid session ID:",e);return}if(o(e),typeof window<"u")try{localStorage.setItem(a,e)}catch(i){console.error("[useSession] Failed to save to localStorage:",i)}},[]),t=(0,n.useCallback)(()=>{if(o(null),typeof window<"u")try{localStorage.removeItem(a)}catch(e){console.error("[useSession] Failed to remove from localStorage:",e)}},[]);return(0,n.useEffect)(()=>{if(typeof window>"u")return;const e=i=>{i.key===a&&o(i.newValue)};return window.addEventListener("storage",e),()=>{window.removeEventListener("storage",e)}},[]),{sessionId:s,saveSession:r,clearSession:t,hasSession:s!==null}}
+//# sourceMappingURL=useSession.js.map

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

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

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

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

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

@@ -0,0 +1,2 @@
+"use strict";var i=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var g=Object.getOwnPropertyNames;var P=Object.prototype.hasOwnProperty;var k=(r,o)=>{for(var n in o)i(r,n,{get:o[n],enumerable:!0})},x=(r,o,n,a)=>{if(o&&typeof o=="object"||typeof o=="function")for(let s of g(o))!P.call(r,s)&&s!==n&&i(r,s,{get:()=>o[s],enumerable:!(a=u(o,s))||a.enumerable});return r};var R=r=>x(i({},"__esModule",{value:!0}),r);var f={};k(f,{CartCard:()=>e.CartCard,ErrorBlock:()=>e.ErrorBlock,FAQList:()=>e.FAQList,LiveChatWidget:()=>C.LiveChatWidget,MessageRendererRegistry:()=>l.MessageRendererRegistry,PolicyBlock:()=>e.PolicyBlock,ProductCard:()=>e.ProductCard,ProductList:()=>e.ProductList,PromotionList:()=>e.PromotionList,QuickReplies:()=>e.QuickReplies,TextBlock:()=>e.TextBlock,ThinkingBlock:()=>e.ThinkingBlock,createQuickRepliesRenderer:()=>e.createQuickRepliesRenderer,escapeHtml:()=>t.escapeHtml,getUserId:()=>m.getUserId,isValidMessageContent:()=>t.isValidMessageContent,isValidUUID:()=>t.isValidUUID,isValidUrl:()=>t.isValidUrl,sanitizeInput:()=>t.sanitizeInput,useChatAPI:()=>p.useChatAPI,useChatState:()=>d.useChatState,useSession:()=>c.useSession});module.exports=R(f);var C=require("./LiveChatWidget"),d=require("./hooks/useChatState"),p=require("./hooks/useChatAPI"),c=require("./hooks/useSession"),l=require("./utils/messageRenderers"),m=require("./utils/userId"),t=require("./utils/validation"),e=require("./components/MessageContent/index.js");
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/components/LiveChatWidget/index.tsx"],
+  "sourcesContent": ["/**\n * LiveChatWidget \u7EC4\u4EF6\u5165\u53E3\n */\n\nexport { LiveChatWidget } from './LiveChatWidget'\nexport type {\n  LiveChatWidgetProps,\n  Message,\n  MessageContent,\n  MessageRole,\n  MessageContentType,\n  MessageMetadata,\n  Product,\n  QuickReply,\n  Session,\n  BubblePosition,\n  MessageRenderer,\n  ProductCardContent,\n  ProductListContent,\n  PolicyContent,\n  QuickRepliesContent,\n  ThinkingContent,\n  ErrorContent,\n  FAQListContent,\n  FAQItem,\n  FAQCategory,\n  PromotionListContent,\n  PromotionItem,\n  CartContent,\n  CartData,\n  CartLine,\n  CartCost,\n  CartAmount,\n  CartDiscountCode,\n  SSEEvent,\n  ChatStreamRequest,\n} from './types'\n\n// \u5BFC\u51FA Hook (\u4F9B\u9AD8\u7EA7\u7528\u6237\u81EA\u5B9A\u4E49\u4F7F\u7528)\nexport { useChatState } from './hooks/useChatState'\nexport { useChatAPI } from './hooks/useChatAPI'\nexport { useSession } from './hooks/useSession'\n\n// \u5BFC\u51FA\u5DE5\u5177\u7C7B\nexport { MessageRendererRegistry } from './utils/messageRenderers'\nexport { getUserId } from './utils/userId'\nexport { sanitizeInput, isValidUrl, isValidUUID, isValidMessageContent, escapeHtml } from './utils/validation'\n\n// \u5BFC\u51FA\u6D88\u606F\u6E32\u67D3\u5668\uFF08\u4F9B\u81EA\u5B9A\u4E49\u4F7F\u7528\uFF09\nexport {\n  TextBlock,\n  ProductCard,\n  ProductList,\n  PolicyBlock,\n  QuickReplies,\n  ThinkingBlock,\n  ErrorBlock,\n  FAQList,\n  PromotionList,\n  CartCard,\n  createQuickRepliesRenderer,\n} from './components/MessageContent/index.js'\n"],
+  "mappings": "yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,suBAAAE,EAAAF,GAIA,IAAAG,EAA+B,4BAmC/BC,EAA6B,gCAC7BC,EAA2B,8BAC3BC,EAA2B,8BAG3BC,EAAwC,oCACxCC,EAA0B,0BAC1BC,EAA0F,8BAG1FC,EAYO",
+  "names": ["LiveChatWidget_exports", "__export", "__toCommonJS", "import_LiveChatWidget", "import_useChatState", "import_useChatAPI", "import_useSession", "import_messageRenderers", "import_userId", "import_validation", "import_MessageContent"]
+}