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

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

@@ -0,0 +1,609 @@
+/**
+ * LiveChat 组件核心类型定义
+ * 基于 specs/livechat-widget/data-model.md
+ */
+export type SessionStatus = 'active' | 'expired';
+export interface Session {
+    sessionId: string;
+    userId: string;
+    site: string;
+    status: SessionStatus;
+    createdAt?: number;
+    lastActivityAt?: number;
+}
+export type MessageRole = 'user' | 'assistant' | 'system' | 'tool';
+export interface MessageMetadata {
+    tokenUsage?: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+    toolCalls?: Array<{
+        id: string;
+        type: string;
+        name: string;
+    }>;
+}
+export interface Message {
+    id: string;
+    sessionId?: string;
+    role: MessageRole;
+    content: MessageContent[];
+    timestamp: number;
+    metadata?: MessageMetadata;
+}
+export type MessageContentType = 'text' | 'product_card' | 'product_list' | 'product_comparison' | 'policy' | 'quick_replies' | 'thinking' | 'error' | 'faq_list' | 'cart';
+export type MessageContent = TextContent | ProductCardContent | ProductListContent | ProductComparisonContent | PolicyContent | QuickRepliesContent | ThinkingContent | ErrorContent | FAQListContent | PromotionListContent | CartContent;
+export interface TextContent {
+    type: 'text';
+    text: string;
+}
+export interface ProductCardContent {
+    type: 'product_card';
+    data: {
+        product: Product;
+    };
+}
+export interface ProductListContent {
+    type: 'product_list';
+    data: {
+        products: Product[];
+        title?: string;
+        onAddToCart?: (product: Product) => void;
+    };
+}
+export interface ProductComparisonContent {
+    type: 'product_comparison';
+    data: {
+        products: Product[];
+        dimensions: {
+            price?: {
+                label: string;
+                values: Array<{
+                    product_id: string;
+                    min: number;
+                    max: number;
+                    currency: string;
+                    has_discount: boolean;
+                }>;
+            };
+            variants?: {
+                label: string;
+                values: Array<{
+                    product_id: string;
+                    count: number;
+                }>;
+            };
+            member_price?: {
+                label: string;
+                values: Array<{
+                    product_id: string;
+                    available: boolean;
+                    min: number;
+                    max: number;
+                    currency: string;
+                }>;
+            };
+            discount?: {
+                label: string;
+                values: Array<{
+                    product_id: string;
+                    has_discount: boolean;
+                }>;
+            };
+            [key: string]: any;
+        };
+        onAddToCart?: (product: Product) => void;
+    };
+}
+export interface PolicyContent {
+    type: 'policy';
+    data: {
+        title: string;
+        content: string;
+    };
+}
+export interface QuickRepliesContent {
+    type: 'quick_replies';
+    data: {
+        replies: QuickReply[];
+    };
+}
+export interface ThinkingContent {
+    type: 'thinking';
+    data: {
+        status: string;
+    };
+}
+export interface ErrorContent {
+    type: 'error';
+    data: {
+        message: string;
+        code?: string;
+    };
+}
+export interface FAQListContent {
+    type: 'faq_list';
+    data: {
+        found: boolean;
+        count: number;
+        total?: number;
+        results: FAQItem[];
+    };
+}
+export interface PromotionListContent {
+    type: 'promotion_list';
+    data: {
+        found: boolean;
+        count: number;
+        total?: number;
+        results: PromotionItem[];
+    };
+}
+export type FAQCategory = 'shipping' | 'return' | 'product' | 'payment' | 'general';
+export interface FAQItem {
+    id: string;
+    question: string;
+    answer: string;
+    category: FAQCategory;
+    keywords?: string[];
+    relatedQuestions?: string[];
+    metadata?: {
+        language?: string;
+        priority?: number;
+        lastUpdated?: string;
+    };
+}
+export interface PromotionItem {
+    id: string;
+    title: string;
+    subtitle?: string;
+    description?: string;
+    banner_url?: string;
+    url?: string;
+    time_range: {
+        start: string;
+        end?: string | null;
+        is_active: boolean;
+    };
+    priority?: number;
+    product_count?: number;
+    metadata?: {
+        display_order?: number;
+        target_audience?: string;
+    };
+}
+export type StockStatus = 'in_stock' | 'low_stock' | 'out_of_stock';
+export interface Price {
+    amount: number;
+    currency: string;
+}
+export interface PriceRange {
+    min: number;
+    max: number;
+    currency: string;
+}
+export interface VariantDiscount {
+    has_discount: boolean;
+    discount_price?: number;
+    discount_code?: string;
+    discount_percentage?: number;
+    /** 折扣类型：fixed_amount 固定金额折扣，percentage 百分比折扣 */
+    discount_type?: 'fixed_amount' | 'percentage';
+    /** 折扣数值（可能是字符串或数字） */
+    discount_value?: string | number;
+}
+export interface VariantMemberPrice {
+    has_member_price: boolean;
+    price?: number;
+}
+export interface ProductFeatures {
+    is_new?: boolean;
+    has_rental?: boolean;
+    has_presale?: boolean;
+    has_member_price?: boolean;
+    has_discount?: boolean;
+}
+export interface Variant {
+    id: string;
+    title: string;
+    sku?: string;
+    price?: Price;
+    availableForSale: boolean;
+    color?: string;
+    discount?: VariantDiscount;
+    memberPrice?: VariantMemberPrice;
+    inventoryQuantity?: number;
+    option1?: string;
+    option2?: string;
+    option3?: string;
+}
+export interface Product {
+    shopifyId: string;
+    sku?: string;
+    handle: string;
+    title: string;
+    description?: string;
+    vendor?: string;
+    price: Price;
+    priceRange?: PriceRange;
+    memberPriceRange?: PriceRange;
+    imageUrl: string;
+    productUrl: string;
+    stockStatus: StockStatus;
+    hotScore?: number;
+    averageRating?: number;
+    reviewCount?: number;
+    variants?: Variant[];
+    variantCount?: number;
+    availableCount?: number;
+    features?: ProductFeatures;
+    tags?: string[];
+}
+export interface QuickReply {
+    id: string;
+    label: string;
+    value: string;
+    icon?: string;
+}
+export interface Policy {
+    title: string;
+    content: string;
+}
+/**
+ * 购物车金额信息
+ */
+export interface CartAmount {
+    /** 金额字符串（如 "99.99"） */
+    amount: string;
+    /** 货币代码（如 "USD"） */
+    currencyCode: string;
+}
+/**
+ * 购物车价格汇总
+ */
+export interface CartCost {
+    /** 应付总价（已应用折扣） */
+    totalAmount: CartAmount;
+    /** 原价小计（未应用折扣） */
+    subtotalAmount: CartAmount;
+}
+/**
+ * 购物车商品变体信息
+ */
+export interface CartMerchandise {
+    /** 变体 ID (Shopify ProductVariant GID) */
+    id: string;
+    /** 变体标题（如 "Black", "Large" 等） */
+    title: string;
+    /** 单价 */
+    price: CartAmount;
+    /** 商品图片 URL */
+    image?: {
+        url: string;
+        altText?: string;
+    };
+    /** 关联的商品信息 */
+    product: {
+        /** 商品 ID */
+        id: string;
+        /** 商品标题 */
+        title: string;
+        /** 商品 handle */
+        handle: string;
+    };
+}
+/**
+ * 购物车商品行
+ */
+export interface CartLine {
+    /** 购物车行 ID (用于更新/删除操作) */
+    id: string;
+    /** 商品数量 */
+    quantity: number;
+    /** 价格信息 */
+    cost: {
+        /** 行总价（单价 × 数量，已应用折扣） */
+        totalAmount: CartAmount;
+        /** 单价 */
+        amountPerQuantity: CartAmount;
+        /** 行小计（单价 × 数量，未应用折扣） */
+        subtotalAmount: CartAmount;
+    };
+    /** 商品变体信息 */
+    merchandise: CartMerchandise;
+    /** 自定义属性（可选） */
+    attributes?: Array<{
+        key: string;
+        value: string;
+    }>;
+}
+/**
+ * 购物车折扣码
+ */
+export interface CartDiscountCode {
+    /** 折扣码 */
+    code: string;
+    /** 是否有效/适用 */
+    applicable: boolean;
+}
+/**
+ * 购物车数据
+ */
+export interface CartData {
+    /** 购物车是否为空 */
+    isEmpty: boolean;
+    /** 购物车 ID (Shopify Cart GID) */
+    cartId: string;
+    /** 商品总数量 */
+    totalQuantity: number;
+    /** 商品列表 */
+    lines: CartLine[];
+    /** 价格汇总 */
+    cost: CartCost;
+    /** 折扣码列表 */
+    discountCodes?: CartDiscountCode[];
+    /** 结账页面 URL */
+    checkoutUrl?: string;
+    /** 购物车按钮回调函数 */
+    onCart?: (cartId: string, checkoutUrl?: string) => void;
+}
+/**
+ * 购物车内容块
+ */
+export interface CartContent {
+    type: 'cart';
+    data: CartData;
+}
+/**
+ * 后端返回的购物车商品行数据 (Shopify GraphQL 格式)
+ */
+export interface BackendCartLineNode {
+    id: string;
+    quantity: number;
+    cost: {
+        totalAmount: CartAmount;
+        amountPerQuantity: CartAmount;
+        compareAtAmountPerQuantity?: CartAmount | null;
+        subtotalAmount: CartAmount;
+    };
+    discountAllocations: any[];
+    merchandise: {
+        id: string;
+        title: string;
+        availableForSale: boolean;
+        quantityAvailable?: number;
+        price: CartAmount;
+        compareAtPrice?: CartAmount | null;
+        image?: {
+            url: string;
+            altText?: string | null;
+            width?: number;
+            height?: number;
+        } | null;
+        product: {
+            id: string;
+            title: string;
+            handle: string;
+            vendor?: string;
+            featuredImage?: {
+                url: string;
+                altText?: string | null;
+                width?: number;
+                height?: number;
+            } | null;
+            tags?: string[];
+        };
+    };
+    attributes?: Array<{
+        key: string;
+        value: string;
+    }>;
+}
+/**
+ * 后端返回的购物车数据 (Shopify GraphQL 格式)
+ */
+export interface BackendCartData {
+    id: string;
+    checkoutUrl?: string;
+    totalQuantity: number;
+    lines: {
+        edges: Array<{
+            node: BackendCartLineNode;
+        }>;
+    };
+    cost: {
+        totalAmount: CartAmount;
+        subtotalAmount: CartAmount;
+        checkoutChargeAmount?: CartAmount;
+        totalAmountEstimated?: boolean;
+        subtotalAmountEstimated?: boolean;
+        totalTaxAmount?: CartAmount | null;
+        totalDutyAmount?: CartAmount | null;
+    };
+    discountAllocations?: any[];
+    buyerIdentity?: any;
+    attributes?: Array<{
+        key: string;
+        value: string;
+    }>;
+    discountCodes?: any[];
+    createdAt?: string;
+    updatedAt?: string;
+}
+export type SSEEventType = 'message_start' | 'content_delta' | 'content_block' | 'message_end' | 'tool_start' | 'tool_end' | 'status' | 'error' | 'done';
+export interface SSEEvent<T = any> {
+    event: SSEEventType | null;
+    data: T;
+}
+export interface MessageStartData {
+    sessionId: string;
+}
+export interface ContentDeltaData {
+    text: string;
+}
+export interface ContentBlockData {
+    type: string;
+    data: any;
+}
+export interface MessageEndData {
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}
+export interface ToolStartData {
+    id: string;
+    type: string;
+    name: string;
+}
+export interface ToolEndData {
+    id: string;
+}
+export interface StatusData {
+    type: string;
+    message?: string;
+}
+export interface ErrorData {
+    message: string;
+    code?: string;
+}
+/**
+ * 流式对话请求参数
+ */
+export interface ChatStreamRequest {
+    /** 用户的消息文本 */
+    message: string;
+    /** 用户标识符 */
+    user_id: string;
+    /** 来自 new-session 端点的会话 ID */
+    session_id: string;
+    /** 可选的上下文信息 */
+    context?: {
+        /** 用于购物车操作的 Shopify 购物车 ID */
+        cartId?: string;
+        /** Storefront API 访问令牌 */
+        accessToken?: string;
+        /** 已登录用户的 ID */
+        real_user_id?: string;
+    };
+}
+export interface NewSessionRequest {
+    user_id: string;
+    session_id?: string;
+    site?: string;
+    real_user_id?: string;
+}
+export interface NewSessionResponse {
+    success: boolean;
+    sessionId: string;
+    message: string;
+    resumed?: boolean;
+    messages?: Message[];
+    welcomeMessage?: string;
+    quickQuestions?: string[];
+    brand?: string;
+}
+export interface ErrorResponse {
+    success: boolean;
+    error: string;
+    code?: string;
+    details?: any;
+}
+export interface LiveChatWidgetProps {
+    /**
+     * API 基础 URL
+     * @example "https://beta-api-livechat.anker.com"
+     */
+    apiBaseUrl: string;
+    /**
+     * Shopify 店铺域名
+     * @example "www.eufy.com"
+     */
+    site?: string;
+    /**
+     * 已登录用户的 ID（可选）
+     * 如果提供，将在 API 请求中传递
+     */
+    loginUserId?: string;
+    /**
+     * Shopify 购物车 ID（可选）
+     * 用于购物车操作，将在 stream 接口的 context 中传递
+     * @example "gid://shopify/Cart/Z2NwLXVzLWVhc3QxOjAxSkZH..."
+     */
+    cartId?: string;
+    /**
+     * Storefront API 访问令牌（可选）
+     * 用于购物车操作，将在 stream 接口的 context 中传递
+     */
+    accessToken?: string;
+    /**
+     * 气泡按钮位置
+     * 自定义位置对象：{ top?: string, bottom?: string, left?: string, right?: string }
+     * @default { bottom: "1.5rem", right: "1.5rem" }
+     * @example
+     * // 自定义位置
+     * position={{ bottom: "20px", right: "30px" }}
+     * position={{ top: "100px", left: "50px" }}
+     */
+    position?: BubblePosition;
+    /**
+     * 欢迎消息
+     * @default "你好！我是 AI 助手，有什么可以帮助你的吗？"
+     */
+    welcomeMessage?: string;
+    /**
+     * 初始快捷回复按钮
+     */
+    quickReplies?: QuickReply[];
+    /**
+     * 自定义消息渲染器
+     */
+    customRenderers?: Record<string, MessageRenderer>;
+    /**
+     * Logo URL
+     */
+    logoUrl?: string;
+    /**
+     * 聊天窗口标题
+     * @default "AI 助手"
+     */
+    title?: string;
+    /**
+     * 聊天气泡按钮图标（图片 URL）
+     * 如果提供，将使用图片替代默认的 SVG 图标
+     */
+    chatBubbleIcon?: string;
+    /**
+     * 事件回调
+     */
+    onOpen?: () => void;
+    onClose?: () => void;
+    onMessageSend?: (message: string) => void;
+    onError?: (error: Error) => void;
+    /**
+     * 商品操作回调
+     */
+    onAddToCart?: (product: Product) => void;
+    /**
+     * 购物车按钮点击回调
+     */
+    onCart?: (cartId: string, checkoutUrl?: string) => void;
+    /**
+     * 是否显示新会话按钮
+     * @default true
+     */
+    showNewSessionButton?: boolean;
+}
+export interface MessageRenderer {
+    render: (content: MessageContent, isUser: boolean, isSystem: boolean) => React.ReactNode;
+}
+export interface CustomRendererMap {
+    [type: string]: MessageRenderer;
+}
+export interface PositionStyles {
+    bottom?: string;
+    top?: string;
+    left?: string;
+    right?: string;
+}
+export type BubblePosition = PositionStyles;

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

@@ -0,0 +1,2 @@
+"use strict";var i=Object.defineProperty;var a=Object.getOwnPropertyDescriptor;var s=Object.getOwnPropertyNames;var u=Object.prototype.hasOwnProperty;var c=(e,t,o,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of s(t))!u.call(e,r)&&r!==o&&i(e,r,{get:()=>t[r],enumerable:!(n=a(t,r))||n.enumerable});return e};var g=e=>c(i({},"__esModule",{value:!0}),e);var d={};module.exports=g(d);
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/components/LiveChatWidget/types.ts"],
+  "sourcesContent": ["/**\n * LiveChat \u7EC4\u4EF6\u6838\u5FC3\u7C7B\u578B\u5B9A\u4E49\n * \u57FA\u4E8E specs/livechat-widget/data-model.md\n */\n\n// ============================================================================\n// Session Types (\u4F1A\u8BDD)\n// ============================================================================\n\nexport type SessionStatus = 'active' | 'expired'\n\nexport interface Session {\n  sessionId: string\n  userId: string\n  site: string\n  status: SessionStatus\n  createdAt?: number\n  lastActivityAt?: number\n}\n\n// ============================================================================\n// Message Types (\u6D88\u606F)\n// ============================================================================\n\nexport type MessageRole = 'user' | 'assistant' | 'system' | 'tool'\n\nexport interface MessageMetadata {\n  tokenUsage?: {\n    inputTokens: number\n    outputTokens: number\n  }\n  toolCalls?: Array<{\n    id: string\n    type: string\n    name: string\n  }>\n}\n\nexport interface Message {\n  id: string\n  sessionId?: string\n  role: MessageRole\n  content: MessageContent[]\n  timestamp: number\n  metadata?: MessageMetadata\n}\n\n// ============================================================================\n// Message Content Types (\u6D88\u606F\u5185\u5BB9)\n// ============================================================================\n\nexport type MessageContentType =\n  | 'text'\n  | 'product_card'\n  | 'product_list'\n  | 'product_comparison'\n  | 'policy'\n  | 'quick_replies'\n  | 'thinking'\n  | 'error'\n  | 'faq_list'\n  | 'cart'\n\nexport type MessageContent =\n  | TextContent\n  | ProductCardContent\n  | ProductListContent\n  | ProductComparisonContent\n  | PolicyContent\n  | QuickRepliesContent\n  | ThinkingContent\n  | ErrorContent\n  | FAQListContent\n  | PromotionListContent\n  | CartContent\n\nexport interface TextContent {\n  type: 'text'\n  text: string\n}\n\nexport interface ProductCardContent {\n  type: 'product_card'\n  data: {\n    product: Product\n  }\n}\n\nexport interface ProductListContent {\n  type: 'product_list'\n  data: {\n    products: Product[]\n    title?: string\n    onAddToCart?: (product: Product) => void\n  }\n}\n\nexport interface ProductComparisonContent {\n  type: 'product_comparison'\n  data: {\n    products: Product[]\n    dimensions: {\n      price?: {\n        label: string\n        values: Array<{\n          product_id: string\n          min: number\n          max: number\n          currency: string\n          has_discount: boolean\n        }>\n      }\n      variants?: {\n        label: string\n        values: Array<{\n          product_id: string\n          count: number\n        }>\n      }\n      member_price?: {\n        label: string\n        values: Array<{\n          product_id: string\n          available: boolean\n          min: number\n          max: number\n          currency: string\n        }>\n      }\n      discount?: {\n        label: string\n        values: Array<{\n          product_id: string\n          has_discount: boolean\n        }>\n      }\n      [key: string]: any\n    }\n    onAddToCart?: (product: Product) => void\n  }\n}\n\nexport interface PolicyContent {\n  type: 'policy'\n  data: {\n    title: string\n    content: string\n  }\n}\n\nexport interface QuickRepliesContent {\n  type: 'quick_replies'\n  data: {\n    replies: QuickReply[]\n  }\n}\n\nexport interface ThinkingContent {\n  type: 'thinking'\n  data: {\n    status: string\n  }\n}\n\nexport interface ErrorContent {\n  type: 'error'\n  data: {\n    message: string\n    code?: string\n  }\n}\n\nexport interface FAQListContent {\n  type: 'faq_list'\n  data: {\n    found: boolean\n    count: number\n    total?: number\n    results: FAQItem[]\n  }\n}\n\nexport interface PromotionListContent {\n  type: 'promotion_list'\n  data: {\n    found: boolean\n    count: number\n    total?: number\n    results: PromotionItem[]\n  }\n}\n\n// ============================================================================\n// FAQ Types (\u5E38\u89C1\u95EE\u9898)\n// ============================================================================\n\nexport type FAQCategory = 'shipping' | 'return' | 'product' | 'payment' | 'general'\n\nexport interface FAQItem {\n  id: string\n  question: string\n  answer: string\n  category: FAQCategory\n  keywords?: string[]\n  relatedQuestions?: string[]\n  metadata?: {\n    language?: string\n    priority?: number\n    lastUpdated?: string\n  }\n}\n\n// ============================================================================\n// Promotion Types (\u4FC3\u9500\u6D3B\u52A8)\n// ============================================================================\n\nexport interface PromotionItem {\n  id: string\n  title: string\n  subtitle?: string\n  description?: string\n  banner_url?: string\n  url?: string\n  time_range: {\n    start: string\n    end?: string | null\n    is_active: boolean\n  }\n  priority?: number\n  product_count?: number\n  metadata?: {\n    display_order?: number\n    target_audience?: string\n  }\n}\n\n// ============================================================================\n// Product Types (\u5546\u54C1)\n// ============================================================================\n\nexport type StockStatus = 'in_stock' | 'low_stock' | 'out_of_stock'\n\nexport interface Price {\n  amount: number\n  currency: string\n}\n\nexport interface PriceRange {\n  min: number\n  max: number\n  currency: string\n}\n\nexport interface VariantDiscount {\n  has_discount: boolean\n  discount_price?: number\n  discount_code?: string\n  discount_percentage?: number\n  /** \u6298\u6263\u7C7B\u578B\uFF1Afixed_amount \u56FA\u5B9A\u91D1\u989D\u6298\u6263\uFF0Cpercentage \u767E\u5206\u6BD4\u6298\u6263 */\n  discount_type?: 'fixed_amount' | 'percentage'\n  /** \u6298\u6263\u6570\u503C\uFF08\u53EF\u80FD\u662F\u5B57\u7B26\u4E32\u6216\u6570\u5B57\uFF09 */\n  discount_value?: string | number\n}\n\nexport interface VariantMemberPrice {\n  has_member_price: boolean\n  price?: number\n}\n\nexport interface ProductFeatures {\n  is_new?: boolean\n  has_rental?: boolean\n  has_presale?: boolean\n  has_member_price?: boolean\n  has_discount?: boolean\n}\n\nexport interface Variant {\n  id: string\n  title: string\n  sku?: string\n  price?: Price\n  availableForSale: boolean\n  color?: string\n  discount?: VariantDiscount\n  memberPrice?: VariantMemberPrice\n  inventoryQuantity?: number\n  option1?: string\n  option2?: string\n  option3?: string\n}\n\nexport interface Product {\n  shopifyId: string\n  sku?: string\n  handle: string\n  title: string\n  description?: string\n  vendor?: string\n  price: Price\n  priceRange?: PriceRange\n  memberPriceRange?: PriceRange\n  imageUrl: string\n  productUrl: string\n  stockStatus: StockStatus\n  hotScore?: number\n  averageRating?: number\n  reviewCount?: number\n  variants?: Variant[]\n  variantCount?: number\n  availableCount?: number\n  features?: ProductFeatures\n  tags?: string[]\n}\n\n// ============================================================================\n// Quick Reply Types (\u5FEB\u6377\u56DE\u590D)\n// ============================================================================\n\nexport interface QuickReply {\n  id: string\n  label: string\n  value: string\n  icon?: string\n}\n\n// ============================================================================\n// Policy Types (\u653F\u7B56)\n// ============================================================================\n\nexport interface Policy {\n  title: string\n  content: string\n}\n\n// ============================================================================\n// Cart Types (\u8D2D\u7269\u8F66)\n// ============================================================================\n\n/**\n * \u8D2D\u7269\u8F66\u91D1\u989D\u4FE1\u606F\n */\nexport interface CartAmount {\n  /** \u91D1\u989D\u5B57\u7B26\u4E32\uFF08\u5982 \"99.99\"\uFF09 */\n  amount: string\n  /** \u8D27\u5E01\u4EE3\u7801\uFF08\u5982 \"USD\"\uFF09 */\n  currencyCode: string\n}\n\n/**\n * \u8D2D\u7269\u8F66\u4EF7\u683C\u6C47\u603B\n */\nexport interface CartCost {\n  /** \u5E94\u4ED8\u603B\u4EF7\uFF08\u5DF2\u5E94\u7528\u6298\u6263\uFF09 */\n  totalAmount: CartAmount\n  /** \u539F\u4EF7\u5C0F\u8BA1\uFF08\u672A\u5E94\u7528\u6298\u6263\uFF09 */\n  subtotalAmount: CartAmount\n}\n\n/**\n * \u8D2D\u7269\u8F66\u5546\u54C1\u53D8\u4F53\u4FE1\u606F\n */\nexport interface CartMerchandise {\n  /** \u53D8\u4F53 ID (Shopify ProductVariant GID) */\n  id: string\n  /** \u53D8\u4F53\u6807\u9898\uFF08\u5982 \"Black\", \"Large\" \u7B49\uFF09 */\n  title: string\n  /** \u5355\u4EF7 */\n  price: CartAmount\n  /** \u5546\u54C1\u56FE\u7247 URL */\n  image?: {\n    url: string\n    altText?: string\n  }\n  /** \u5173\u8054\u7684\u5546\u54C1\u4FE1\u606F */\n  product: {\n    /** \u5546\u54C1 ID */\n    id: string\n    /** \u5546\u54C1\u6807\u9898 */\n    title: string\n    /** \u5546\u54C1 handle */\n    handle: string\n  }\n}\n\n/**\n * \u8D2D\u7269\u8F66\u5546\u54C1\u884C\n */\nexport interface CartLine {\n  /** \u8D2D\u7269\u8F66\u884C ID (\u7528\u4E8E\u66F4\u65B0/\u5220\u9664\u64CD\u4F5C) */\n  id: string\n  /** \u5546\u54C1\u6570\u91CF */\n  quantity: number\n  /** \u4EF7\u683C\u4FE1\u606F */\n  cost: {\n    /** \u884C\u603B\u4EF7\uFF08\u5355\u4EF7 \u00D7 \u6570\u91CF\uFF0C\u5DF2\u5E94\u7528\u6298\u6263\uFF09 */\n    totalAmount: CartAmount\n    /** \u5355\u4EF7 */\n    amountPerQuantity: CartAmount\n    /** \u884C\u5C0F\u8BA1\uFF08\u5355\u4EF7 \u00D7 \u6570\u91CF\uFF0C\u672A\u5E94\u7528\u6298\u6263\uFF09 */\n    subtotalAmount: CartAmount\n  }\n  /** \u5546\u54C1\u53D8\u4F53\u4FE1\u606F */\n  merchandise: CartMerchandise\n  /** \u81EA\u5B9A\u4E49\u5C5E\u6027\uFF08\u53EF\u9009\uFF09 */\n  attributes?: Array<{\n    key: string\n    value: string\n  }>\n}\n\n/**\n * \u8D2D\u7269\u8F66\u6298\u6263\u7801\n */\nexport interface CartDiscountCode {\n  /** \u6298\u6263\u7801 */\n  code: string\n  /** \u662F\u5426\u6709\u6548/\u9002\u7528 */\n  applicable: boolean\n}\n\n/**\n * \u8D2D\u7269\u8F66\u6570\u636E\n */\nexport interface CartData {\n  /** \u8D2D\u7269\u8F66\u662F\u5426\u4E3A\u7A7A */\n  isEmpty: boolean\n  /** \u8D2D\u7269\u8F66 ID (Shopify Cart GID) */\n  cartId: string\n  /** \u5546\u54C1\u603B\u6570\u91CF */\n  totalQuantity: number\n  /** \u5546\u54C1\u5217\u8868 */\n  lines: CartLine[]\n  /** \u4EF7\u683C\u6C47\u603B */\n  cost: CartCost\n  /** \u6298\u6263\u7801\u5217\u8868 */\n  discountCodes?: CartDiscountCode[]\n  /** \u7ED3\u8D26\u9875\u9762 URL */\n  checkoutUrl?: string\n  /** \u8D2D\u7269\u8F66\u6309\u94AE\u56DE\u8C03\u51FD\u6570 */\n  onCart?: (cartId: string, checkoutUrl?: string) => void\n}\n\n/**\n * \u8D2D\u7269\u8F66\u5185\u5BB9\u5757\n */\nexport interface CartContent {\n  type: 'cart'\n  data: CartData\n}\n\n// ============================================================================\n// Backend Cart Types (\u540E\u7AEF\u8D2D\u7269\u8F66\u6570\u636E\u683C\u5F0F - Shopify GraphQL)\n// ============================================================================\n\n/**\n * \u540E\u7AEF\u8FD4\u56DE\u7684\u8D2D\u7269\u8F66\u5546\u54C1\u884C\u6570\u636E (Shopify GraphQL \u683C\u5F0F)\n */\nexport interface BackendCartLineNode {\n  id: string\n  quantity: number\n  cost: {\n    totalAmount: CartAmount\n    amountPerQuantity: CartAmount\n    compareAtAmountPerQuantity?: CartAmount | null\n    subtotalAmount: CartAmount\n  }\n  discountAllocations: any[]\n  merchandise: {\n    id: string\n    title: string\n    availableForSale: boolean\n    quantityAvailable?: number\n    price: CartAmount\n    compareAtPrice?: CartAmount | null\n    image?: {\n      url: string\n      altText?: string | null\n      width?: number\n      height?: number\n    } | null\n    product: {\n      id: string\n      title: string\n      handle: string\n      vendor?: string\n      featuredImage?: {\n        url: string\n        altText?: string | null\n        width?: number\n        height?: number\n      } | null\n      tags?: string[]\n    }\n  }\n  attributes?: Array<{\n    key: string\n    value: string\n  }>\n}\n\n/**\n * \u540E\u7AEF\u8FD4\u56DE\u7684\u8D2D\u7269\u8F66\u6570\u636E (Shopify GraphQL \u683C\u5F0F)\n */\nexport interface BackendCartData {\n  id: string\n  checkoutUrl?: string\n  totalQuantity: number\n  lines: {\n    edges: Array<{\n      node: BackendCartLineNode\n    }>\n  }\n  cost: {\n    totalAmount: CartAmount\n    subtotalAmount: CartAmount\n    checkoutChargeAmount?: CartAmount\n    totalAmountEstimated?: boolean\n    subtotalAmountEstimated?: boolean\n    totalTaxAmount?: CartAmount | null\n    totalDutyAmount?: CartAmount | null\n  }\n  discountAllocations?: any[]\n  buyerIdentity?: any\n  attributes?: Array<{\n    key: string\n    value: string\n  }>\n  discountCodes?: any[]\n  createdAt?: string\n  updatedAt?: string\n}\n\n// ============================================================================\n// SSE Event Types (SSE \u4E8B\u4EF6)\n// ============================================================================\n\nexport type SSEEventType =\n  | 'message_start'\n  | 'content_delta'\n  | 'content_block'\n  | 'message_end'\n  | 'tool_start'\n  | 'tool_end'\n  | 'status'\n  | 'error'\n  | 'done'\n\nexport interface SSEEvent<T = any> {\n  event: SSEEventType | null\n  data: T\n}\n\n// \u5177\u4F53\u4E8B\u4EF6\u6570\u636E\u7C7B\u578B\nexport interface MessageStartData {\n  sessionId: string\n}\n\nexport interface ContentDeltaData {\n  text: string\n}\n\nexport interface ContentBlockData {\n  type: string\n  data: any\n}\n\nexport interface MessageEndData {\n  usage: {\n    inputTokens: number\n    outputTokens: number\n  }\n}\n\nexport interface ToolStartData {\n  id: string\n  type: string\n  name: string\n}\n\nexport interface ToolEndData {\n  id: string\n}\n\nexport interface StatusData {\n  type: string\n  message?: string\n}\n\nexport interface ErrorData {\n  message: string\n  code?: string\n}\n\n// ============================================================================\n// API Request/Response Types (API \u8BF7\u6C42\u54CD\u5E94)\n// ============================================================================\n\n/**\n * \u6D41\u5F0F\u5BF9\u8BDD\u8BF7\u6C42\u53C2\u6570\n */\nexport interface ChatStreamRequest {\n  /** \u7528\u6237\u7684\u6D88\u606F\u6587\u672C */\n  message: string\n  /** \u7528\u6237\u6807\u8BC6\u7B26 */\n  user_id: string\n  /** \u6765\u81EA new-session \u7AEF\u70B9\u7684\u4F1A\u8BDD ID */\n  session_id: string\n  /** \u53EF\u9009\u7684\u4E0A\u4E0B\u6587\u4FE1\u606F */\n  context?: {\n    /** \u7528\u4E8E\u8D2D\u7269\u8F66\u64CD\u4F5C\u7684 Shopify \u8D2D\u7269\u8F66 ID */\n    cartId?: string\n    /** Storefront API \u8BBF\u95EE\u4EE4\u724C */\n    accessToken?: string\n    /** \u5DF2\u767B\u5F55\u7528\u6237\u7684 ID */\n    real_user_id?: string\n  }\n}\n\nexport interface NewSessionRequest {\n  user_id: string\n  session_id?: string\n  site?: string\n  real_user_id?: string\n}\n\nexport interface NewSessionResponse {\n  success: boolean\n  sessionId: string\n  message: string\n  resumed?: boolean\n  messages?: Message[]\n  welcomeMessage?: string\n  quickQuestions?: string[]\n  brand?: string\n}\n\nexport interface ErrorResponse {\n  success: boolean\n  error: string\n  code?: string\n  details?: any\n}\n\n// ============================================================================\n// Component Props Types (\u7EC4\u4EF6 Props)\n// ============================================================================\n\nexport interface LiveChatWidgetProps {\n  /**\n   * API \u57FA\u7840 URL\n   * @example \"https://beta-api-livechat.anker.com\"\n   */\n  apiBaseUrl: string\n\n  /**\n   * Shopify \u5E97\u94FA\u57DF\u540D\n   * @example \"www.eufy.com\"\n   */\n  site?: string\n\n  /**\n   * \u5DF2\u767B\u5F55\u7528\u6237\u7684 ID\uFF08\u53EF\u9009\uFF09\n   * \u5982\u679C\u63D0\u4F9B\uFF0C\u5C06\u5728 API \u8BF7\u6C42\u4E2D\u4F20\u9012\n   */\n  loginUserId?: string\n\n  /**\n   * Shopify \u8D2D\u7269\u8F66 ID\uFF08\u53EF\u9009\uFF09\n   * \u7528\u4E8E\u8D2D\u7269\u8F66\u64CD\u4F5C\uFF0C\u5C06\u5728 stream \u63A5\u53E3\u7684 context \u4E2D\u4F20\u9012\n   * @example \"gid://shopify/Cart/Z2NwLXVzLWVhc3QxOjAxSkZH...\"\n   */\n  cartId?: string\n\n  /**\n   * Storefront API \u8BBF\u95EE\u4EE4\u724C\uFF08\u53EF\u9009\uFF09\n   * \u7528\u4E8E\u8D2D\u7269\u8F66\u64CD\u4F5C\uFF0C\u5C06\u5728 stream \u63A5\u53E3\u7684 context \u4E2D\u4F20\u9012\n   */\n  accessToken?: string\n\n  /**\n   * \u6C14\u6CE1\u6309\u94AE\u4F4D\u7F6E\n   * \u81EA\u5B9A\u4E49\u4F4D\u7F6E\u5BF9\u8C61\uFF1A{ top?: string, bottom?: string, left?: string, right?: string }\n   * @default { bottom: \"1.5rem\", right: \"1.5rem\" }\n   * @example\n   * // \u81EA\u5B9A\u4E49\u4F4D\u7F6E\n   * position={{ bottom: \"20px\", right: \"30px\" }}\n   * position={{ top: \"100px\", left: \"50px\" }}\n   */\n  position?: BubblePosition\n\n  /**\n   * \u6B22\u8FCE\u6D88\u606F\n   * @default \"\u4F60\u597D\uFF01\u6211\u662F AI \u52A9\u624B\uFF0C\u6709\u4EC0\u4E48\u53EF\u4EE5\u5E2E\u52A9\u4F60\u7684\u5417\uFF1F\"\n   */\n  welcomeMessage?: string\n\n  /**\n   * \u521D\u59CB\u5FEB\u6377\u56DE\u590D\u6309\u94AE\n   */\n  quickReplies?: QuickReply[]\n\n  /**\n   * \u81EA\u5B9A\u4E49\u6D88\u606F\u6E32\u67D3\u5668\n   */\n  customRenderers?: Record<string, MessageRenderer>\n\n  /**\n   * Logo URL\n   */\n  logoUrl?: string\n\n  /**\n   * \u804A\u5929\u7A97\u53E3\u6807\u9898\n   * @default \"AI \u52A9\u624B\"\n   */\n  title?: string\n\n  /**\n   * \u804A\u5929\u6C14\u6CE1\u6309\u94AE\u56FE\u6807\uFF08\u56FE\u7247 URL\uFF09\n   * \u5982\u679C\u63D0\u4F9B\uFF0C\u5C06\u4F7F\u7528\u56FE\u7247\u66FF\u4EE3\u9ED8\u8BA4\u7684 SVG \u56FE\u6807\n   */\n  chatBubbleIcon?: string\n\n  /**\n   * \u4E8B\u4EF6\u56DE\u8C03\n   */\n  onOpen?: () => void\n  onClose?: () => void\n  onMessageSend?: (message: string) => void\n  onError?: (error: Error) => void\n\n  /**\n   * \u5546\u54C1\u64CD\u4F5C\u56DE\u8C03\n   */\n  onAddToCart?: (product: Product) => void\n\n  /**\n   * \u8D2D\u7269\u8F66\u6309\u94AE\u70B9\u51FB\u56DE\u8C03\n   */\n  onCart?: (cartId: string, checkoutUrl?: string) => void\n\n  /**\n   * \u662F\u5426\u663E\u793A\u65B0\u4F1A\u8BDD\u6309\u94AE\n   * @default true\n   */\n  showNewSessionButton?: boolean\n}\n\nexport interface MessageRenderer {\n  render: (content: MessageContent, isUser: boolean, isSystem: boolean) => React.ReactNode\n}\n\nexport interface CustomRendererMap {\n  [type: string]: MessageRenderer\n}\n\n// ============================================================================\n// Utility Types (\u5DE5\u5177\u7C7B\u578B)\n// ============================================================================\n\nexport interface PositionStyles {\n  bottom?: string\n  top?: string\n  left?: string\n  right?: string\n}\n\nexport type BubblePosition = PositionStyles\n"],
+  "mappings": "+WAAA,IAAAA,EAAA,kBAAAC,EAAAD",
+  "names": ["types_exports", "__toCommonJS"]
+}

package/dist/cjs/components/LiveChatWidget/utils/cartTransformers.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 购物车数据转换工具
+ * 将后端返回的 Shopify GraphQL 格式转换为前端标准格式
+ */
+import type { BackendCartData, CartData } from '../types';
+/**
+ * 转换后端购物车数据为前端格式
+ *
+ * @param backendData 后端返回的 Shopify GraphQL 格式数据
+ * @returns 前端标准化的购物车数据
+ *
+ * @example
+ * ```typescript
+ * const backendData = {
+ *   id: "gid://shopify/Cart/xxx",
+ *   lines: { edges: [{ node: {...} }] },
+ *   cost: { totalAmount: {...}, subtotalAmount: {...} },
+ *   ...
+ * }
+ *
+ * const cartData = transformCartData(backendData)
+ * // => { cartId: "gid://shopify/Cart/xxx", lines: [...], ... }
+ * ```
+ */
+export declare function transformCartData(backendData: BackendCartData): CartData;

package/dist/cjs/components/LiveChatWidget/utils/cartTransformers.js

@@ -0,0 +1,2 @@
+"use strict";var a=Object.defineProperty;var r=Object.getOwnPropertyDescriptor;var u=Object.getOwnPropertyNames;var s=Object.prototype.hasOwnProperty;var l=(o,n)=>{for(var t in n)a(o,t,{get:n[t],enumerable:!0})},m=(o,n,t,e)=>{if(n&&typeof n=="object"||typeof n=="function")for(let i of u(n))!s.call(o,i)&&i!==t&&a(o,i,{get:()=>n[i],enumerable:!(e=r(n,i))||e.enumerable});return o};var c=o=>m(a({},"__esModule",{value:!0}),o);var p={};l(p,{transformCartData:()=>d});module.exports=c(p);function d(o){const n=o.lines.edges.map(t=>({id:t.node.id,quantity:t.node.quantity,cost:{totalAmount:t.node.cost.totalAmount,amountPerQuantity:t.node.cost.amountPerQuantity,subtotalAmount:t.node.cost.subtotalAmount},merchandise:{id:t.node.merchandise.id,title:t.node.merchandise.title,price:t.node.merchandise.price,image:t.node.merchandise.image?{url:t.node.merchandise.image.url,altText:t.node.merchandise.image.altText||void 0}:void 0,product:{id:t.node.merchandise.product.id,title:t.node.merchandise.product.title,handle:t.node.merchandise.product.handle}},attributes:t.node.attributes}));return{isEmpty:o.totalQuantity===0||n.length===0,cartId:o.id,totalQuantity:o.totalQuantity,lines:n,cost:{totalAmount:o.cost.totalAmount,subtotalAmount:o.cost.subtotalAmount},discountCodes:o.discountCodes?.map(t=>({code:t.code||t,applicable:t.applicable!==!1})),checkoutUrl:o.checkoutUrl}}
+//# sourceMappingURL=cartTransformers.js.map