@anker-in/campaign-ui 0.3.3 → 0.3.5

package/dist/index.d.ts

@@ -0,0 +1,1305 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React$1 from 'react';
+import React__default, { PropsWithChildren, Dispatch, SetStateAction } from 'react';
+export { useCopilotAction, useCopilotChat, useCopilotReadable } from '@copilotkit/react-core';
+export { ActionExecutionMessage, Role, TextMessage } from '@copilotkit/runtime-client-gql';
+import * as swr_dist_mutation from 'swr/dist/mutation';
+import { HeadlessConfig } from '@anker-in/lib';
+
+interface ChatProps {
+    title: string;
+    runtimeUrl: string;
+    shopifyDomain: string;
+    /** GA 的 client id
+     */
+    userId: string;
+    /** 是否登陆用户 0 or 1
+     */
+    account?: string;
+    /** 用户浏览器语言
+     */
+    locale?: string;
+    /** 开场白
+     */
+    prologue?: string;
+    /** ?a=1&b=2
+     */
+    query?: string;
+    /** 'follow' or 'unfollow' | true or false
+     * follow: ResponseButton 会跟随在 messages 的后边
+     * unfollow: ResponseButton 在聊天框底部
+     */
+    showResponseButton?: string | boolean;
+    /** messages 的回调事件
+     * 每次生成/接受新的messages，会将 整个 messages list 传递给外部
+     */
+    messagesCallback?: (_messages: any) => void;
+    /** 通用 action 的触发事件
+     */
+    commonRender?: string | ((_props: any) => React__default.ReactElement);
+    /** shulex的 action 的触发事件
+     */
+    shulexRender?: string | ((_props: any) => React__default.ReactElement);
+    /** 通用 积分 换 Coupon 的触发事件
+     */
+    pointsExchangeCouponRender?: string | ((_props: any) => React__default.ReactElement);
+    /** 跳转 checkout action 卡片，接受参数： {"status":"complete","args":[{"sku":["A3936031"],"handle":"space-a40-a3936031"}],"result":""}
+     * 后端接口文档：https://anker-in.feishu.cn/wiki/DOYJwE9oxipWmYk072ncnJNznBb
+     */
+    gotocheckoutRender?: string | ((_props: any) => React__default.ReactElement);
+    /** 打开购物车 action 卡片，接受参数： {"status":"complete","args":[{"sku":["A3936031"],"handle":"space-a40-a3936031"}],"result":""}
+     * 后端接口文档：https://anker-in.feishu.cn/wiki/DOYJwE9oxipWmYk072ncnJNznBb
+     */
+    gotocartRender?: string | ((_props: any) => React__default.ReactElement);
+    /** 打开购物车 action 的触发事件
+     */
+    addtocartHandler?: (_args: any) => Promise<any>;
+    /** 加购卡片，接受参数： {"status":"complete","args":[{"sku":["A3936031"],"handle":"space-a40-a3936031"}],"result":""}
+     * 后端接口文档：https://anker-in.feishu.cn/wiki/DOYJwE9oxipWmYk072ncnJNznBb
+     */
+    addtocartRender?: string | ((_props: any) => React__default.ReactElement);
+    /** 订阅卡片，接受参数： {"status":"complete","args":[{"sku":["A3936031"],"handle":"space-a40-a3936031"}],"result":""}
+     * 后端接口文档：https://anker-in.feishu.cn/wiki/DOYJwE9oxipWmYk072ncnJNznBb
+     */
+    signupRender?: string | ((_props: any) => React__default.ReactElement);
+    /** 产品卡片，接受参数： {"status":"complete","args":[{"sku":["A3936031"],"handle":"space-a40-a3936031"}],"result":""}
+     * 后端接口文档：https://anker-in.feishu.cn/wiki/DOYJwE9oxipWmYk072ncnJNznBb
+     */
+    productRender?: string | ((_props: any) => React__default.ReactElement);
+    /** CopilotPopup 自定义参数，参考：https://docs.copilotkit.ai/reference/components/CopilotPopup */
+    popup?: any;
+    /** 文案，{"productRenderTipMessage": "","popupTip": "Hi ! Welcome to soundcore Innovations live chat！", "popupTipTimeout": [3000, 6000]} */
+    lang?: any;
+    /** 参考此文档：https://docs.copilotkit.ai/concepts/customize-look-and-feel */
+    style?: any;
+    className?: string;
+}
+declare const Chat: (props: ChatProps) => react_jsx_runtime.JSX.Element;
+
+declare enum ConsumeType {
+    Coupon = "coupon",
+    GiftCard = "giftCard",
+    GoGift = "goGift",
+    Product = "product",
+    ShippingCoupon = "shippingCoupon"
+}
+declare enum DTC_TASK_TYPE {
+    FirstPurchase = "firstPurchase",
+    UploadReceipt = "uploadReceipt",
+    Shopping = "shopping"
+}
+
+interface BaseResponse {
+    brand: string;
+}
+interface CreditInfoResponse extends BaseResponse {
+    total_credit: number;
+    available_credit: number;
+    pending_credit: number;
+    expired_credit: number;
+    cancel_credit: number;
+    consumed_credit: number;
+}
+
+interface MyActivitiesMetafields {
+    title: string;
+    tips: string;
+    allTab: string;
+    earnedTab: string;
+    deductedTab: string;
+    expiredTab: string;
+    activationTask: string;
+    updateNameTask: string;
+    updatePhoneTask: string;
+    updateBirthdayTask: string;
+    updateAppNameTask: string;
+    subscriptionTask: string;
+    refundTask: string;
+    productUnApprovedTask: string;
+    pendingTips?: string;
+    pendingTips2?: string;
+    firstPurchaseTask: string;
+    uploadReceiptTask: string;
+    shoppingTask: string;
+    emptyListImage: {
+        url: string;
+        alt?: string;
+    };
+    emptyListLabel: string;
+}
+
+interface MyRewardsMetafields {
+    title: string;
+    orderNumberLabel: string;
+    valueLabel: string;
+    receivedLabel: string;
+    failedLabel: string;
+    approveSuccessLabel: string;
+    couponTab: string;
+    productTab: string;
+    pendingLabel: string;
+    unfulfilledLabel: string;
+    fulfilledLabel: string;
+    confirmedTip: string;
+    pendingTip: string;
+    processingTip: string;
+    ShippedTip: string;
+    emptyListLabel: string;
+    pointUnit: string;
+    code: string;
+    copied: string;
+    copy: string;
+    emptyListImage: {
+        url: string;
+        alt?: string;
+    };
+}
+
+type CreditsPageCommon = {
+    pointUnit?: string;
+    infoIcon?: string;
+    ruleLabel?: string;
+    soldOut?: string;
+    copied?: string;
+    off?: string;
+    copy?: string;
+    giftCardLabel?: string;
+    imageMapping?: {
+        [key in ConsumeType]: {
+            url: string;
+        };
+    };
+    activitiesModal?: MyActivitiesMetafields;
+    rewardsModal?: MyRewardsMetafields;
+    insufficientCredits?: string;
+    validatorInfo?: {
+        addressInfo: {
+            name: string;
+            country: string;
+            province: string;
+            city: string;
+            address: string;
+        };
+    };
+};
+
+declare enum FunctionDiscountType {
+    Percentage = 1,
+    FixedAmount = 2,
+    FixedPrice = 3
+}
+
+type DiscountConfig = {
+    discount_type: FunctionDiscountType;
+    discount_value: number;
+};
+type FunctionMemberPriceConfig = {
+    rule_id: string;
+    result_detail: {
+        member_discounts?: {
+            user_identity: number;
+            main_products: {
+                all_store_variant: boolean;
+                variants: {
+                    variant_id: string;
+                    sku: string;
+                    handle: string;
+                }[];
+            };
+            discount_conf: DiscountConfig;
+        }[];
+    };
+    discount_combinations: {
+        other_product_discounts: boolean;
+    };
+};
+
+type Context = {
+    profile: any;
+    isLoadingProfile: boolean;
+    removeProfile: () => void;
+    taskIdToTypeMapping: Record<string, DTC_TASK_TYPE>;
+    openSignInPopup: () => void;
+    openSignUpPopup: () => void;
+    creditInfo?: CreditInfoResponse;
+    customer?: any;
+    customerLoading: boolean;
+    fetchCreditInfo: (user_id: string) => void;
+    gtm: {
+        pageGroup: string;
+        pageHandle?: string;
+    };
+    pageCommon: CreditsPageCommon;
+    memberPriceDiscount?: FunctionMemberPriceConfig[];
+    alpcBrand?: string;
+    cartConfig?: {
+        addToCart: (params: {
+            variantList: Array<{
+                variant: any;
+                quantity: number;
+                attributes?: Array<{
+                    key: string;
+                    value: string;
+                }>;
+            }>;
+            cartAttributes?: Record<string, string>;
+            discountCodes?: string[];
+        }) => void | Promise<any>;
+    };
+};
+declare function CreditsProvider({ children, profile, removeProfile, isLoadingProfile, openSignInPopup, openSignUpPopup, taskIdToTypeMapping, creditInfo, customer, customerLoading, fetchCreditInfo, gtm, pageCommon, memberPriceDiscount, alpcBrand, cartConfig, }: PropsWithChildren<Context>): react_jsx_runtime.JSX.Element;
+declare function useCreditsContext(): Context;
+
+declare const useUploadReceipt: () => swr_dist_mutation.SWRMutationResponse<{
+    ok: boolean;
+    code: number;
+}, any, "/api/multipass/mktsrv/v1/credit/upload_third_party_order", {
+    orderName: string;
+}>;
+
+type ReceiptCopy = {
+    title: string;
+    description: string;
+    placeholder: string;
+    note: string;
+    submit: string;
+    successTitle: string;
+    successDescription: string;
+    gotIt: string;
+    failedTitle: string;
+    successIcon: string;
+    failedIcon: string;
+    failedReasons: {
+        code: string;
+        id: string;
+        description: string;
+    }[];
+};
+declare function CreditsUploadReceiptModal({ isOpen, onClose, copy, onSuccess, }: {
+    isOpen: boolean;
+    onClose: () => void;
+    copy: ReceiptCopy;
+    onSuccess: () => void;
+}): react_jsx_runtime.JSX.Element;
+
+type Img = {
+    url: string;
+    alt: string;
+    width?: number;
+    height?: number;
+};
+type CreditsBannerCopy = {
+    pcImg: Img;
+    laptopImg: Img;
+    mobileImg: Img;
+    joinNow: string;
+    loginIn: string;
+    login: {
+        title: string;
+        description: string;
+    };
+    unLogin: {
+        title: string;
+        description: string;
+    };
+};
+declare function CreditsBanner({ copy, id }: {
+    copy: CreditsBannerCopy;
+    id?: string;
+}): react_jsx_runtime.JSX.Element;
+
+interface BenefitItemCopy {
+    icon: {
+        alt: string;
+        url: string;
+    };
+    text: string;
+    note?: string;
+    tag?: string;
+}
+
+type CreditsBenefitsCopy = {
+    title: string;
+    benefits: BenefitItemCopy[];
+    bigIcon?: boolean;
+    cardBgColor?: string;
+    cardBorderColor?: string;
+};
+declare const CreditsBenefits: ({ copy, id }: {
+    copy: CreditsBenefitsCopy;
+    id?: string;
+}) => react_jsx_runtime.JSX.Element;
+
+type ButtonConfig = {
+    text: string;
+    type: 'activities' | 'rewards';
+};
+type CreditsInfoCardCopy = {
+    balanceLabel: string;
+    comingSoonLabel: string;
+    comingSoonTips: string;
+    buttons: ButtonConfig[];
+};
+declare function CreditsInfoCard({ copy, id }: {
+    copy: CreditsInfoCardCopy;
+    id?: string;
+}): react_jsx_runtime.JSX.Element;
+
+type CreditsSubscribeModalCopy = {
+    title: string;
+    desc?: string;
+    placeholder: string;
+    policy?: string;
+    successTips?: string;
+    dealsType?: string;
+};
+
+type BenefitItem = {
+    title: string;
+    credits: string;
+    id: string;
+};
+type CreditsWaysToGetCreditsCopy = {
+    title: string;
+    subtitle: string;
+    equalCredits: string;
+    musicIcon: string;
+    list: BenefitItem[];
+    mainImage: {
+        url: string;
+        alt: string;
+    };
+    joinNow: string;
+    activate: string;
+    completed: string;
+    completeProfile: string;
+    makeFirstPurchase: string;
+    goShopLink: string;
+    uploadReceipt: string;
+    shopNow: string;
+    subscribeLabel: string;
+    sendEmailSuccess: string;
+    creditsIcon: {
+        url: string;
+        alt: string;
+    };
+    receipt: ReceiptCopy;
+    subscribe: CreditsSubscribeModalCopy;
+};
+type CreditsWaysToGetCreditsProps = {
+    copy: CreditsWaysToGetCreditsCopy;
+    classNames?: {
+        equalCreditsText?: string;
+        subtitle?: string;
+    };
+};
+
+declare const CreditsWaysToGetCredits: ({ copy, classNames, id }: CreditsWaysToGetCreditsProps & {
+    id?: string;
+}) => react_jsx_runtime.JSX.Element;
+
+type CreditsFaqCopy = {
+    title: string;
+    subTitle: string;
+    learnMore: {
+        link: string;
+        label: string;
+    };
+    items: {
+        category_name: string;
+        question: string;
+        answer: string;
+    }[];
+};
+declare const CreditsFaq: ({ copy, id }: {
+    copy: CreditsFaqCopy;
+    id?: string;
+}) => react_jsx_runtime.JSX.Element;
+
+type RedeemableItemConfig$1 = {
+    title: string;
+    desc: string;
+    price: number;
+    credit: string;
+    rules: string;
+    image: {
+        url: string;
+    };
+    mobileImage: {
+        url: string;
+    };
+    redeemId: number;
+};
+type CreditsCashCopy = {
+    title: string;
+    list: (RedeemableItemConfig$1 & {
+        products: {
+            handle: string;
+            sku: string;
+        }[];
+    })[];
+    soldOut: string;
+    unlockRewards: string;
+    btnRedeem: string;
+    off: string;
+    badgeLabel?: string;
+};
+
+declare const CreditsCash: ({ copy, id }: {
+    copy: CreditsCashCopy;
+    id?: string;
+}) => react_jsx_runtime.JSX.Element;
+
+type CreditsRedeemListCopy = {
+    title: string;
+    availableCredits: string;
+    unlockRewards: string;
+    btnRedeem: string;
+    list: {
+        label: string;
+        list: {
+            id: string;
+            type: string;
+            value: string;
+            rules: string[];
+        }[];
+    }[];
+    redeemModal: {
+        confirmTitle: string;
+        confirmButton: string;
+        commonError: string;
+        redeemLimitError: string;
+        inventoryNotEnough: string;
+        creditsNotEnough: string;
+        crossSiteError: string;
+        errorImageUrl: string;
+        coupon: {
+            successDesc: string;
+            successTitle: string;
+            successButton: string;
+            successButtonUrl: string;
+        };
+        product: {
+            required: string;
+            invalidEmail: string;
+            shippingAddress: string;
+            shippingProduct: string;
+            addressForm: {
+                key: string;
+                type: string;
+                label: string;
+                isSelect: boolean;
+                required: boolean;
+                placeholder: string;
+            }[][];
+            form: {
+                key: string;
+                type: string;
+                isSelect: boolean;
+                required: boolean;
+                placeholder: string;
+            }[][];
+            successDesc: string[];
+            rules: string[];
+            steps: {
+                imageUrl: string;
+                title: string;
+            }[];
+            quantityLabel: string;
+            totalPriceLabel: string;
+            variantLabel: string;
+            shippingFeeLabel: string;
+            paymentButton: string;
+            stepTitle: string;
+        };
+    };
+};
+
+declare const CreditsRedeemList: ({ copy, id }: {
+    copy: CreditsRedeemListCopy;
+    id?: string;
+}) => react_jsx_runtime.JSX.Element;
+
+type AuthCodeActivateCopy = {
+    authCodeTitle?: string;
+    authCodeDesc?: string;
+    enterActiveCodeText?: string;
+    authCodeContent?: string;
+    authCodeReceiveText?: string;
+    sendAgainText?: string;
+    buttonText?: string;
+    note?: string;
+    codeEmptyError?: string;
+    incorrectCodeError?: string;
+    retrieveText?: string;
+    authSuccessMessage?: string;
+    sendEmailSuccessMessage?: string;
+    sendEmailErrorMessage?: string;
+    beenActivatedMessage?: string;
+    invalidCodeMessage?: string;
+    expiredCodeMessage?: string;
+};
+type AuthCodeActivateProps = {
+    copy: AuthCodeActivateCopy;
+};
+
+declare const AuthCodeActivate: React__default.FC<AuthCodeActivateProps>;
+
+interface RegistrationContextType {
+    email?: string;
+    copy?: any;
+    authCodeActivate: {
+        isOpen: boolean;
+        open: () => void;
+        close: () => void;
+        isActivateSuccess: boolean;
+        activeToken?: string;
+        onAuthSuccess: (() => void) | undefined;
+        isSendingActivateEmail: boolean;
+        setIsSendingActivateEmail: Dispatch<SetStateAction<boolean>>;
+        setActiveToken: Dispatch<SetStateAction<string | undefined>>;
+        setIsActivateSuccess: Dispatch<SetStateAction<boolean>>;
+        setOnAuthSuccess: Dispatch<SetStateAction<(() => void) | undefined>>;
+        autoSendEmail: boolean;
+        setAutoSendEmail: Dispatch<SetStateAction<boolean>>;
+    };
+}
+declare const RegistrationContext: React$1.Context<RegistrationContextType>;
+declare const useRegistration: () => RegistrationContextType;
+declare const RegistrationProvider: ({ children, email, copy }: PropsWithChildren<{
+    email?: string;
+    copy?: any;
+}>) => react_jsx_runtime.JSX.Element;
+
+type MessageRole = 'user' | 'assistant' | 'system' | 'tool';
+interface MessageMetadata {
+    tokenUsage?: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+    toolCalls?: Array<{
+        id: string;
+        type: string;
+        name: string;
+    }>;
+}
+interface Message {
+    id: string;
+    sessionId?: string;
+    role: MessageRole;
+    content: MessageContent[];
+    timestamp: number;
+    metadata?: MessageMetadata;
+}
+type MessageContentType = 'text' | 'product_card' | 'product_list' | 'product_comparison' | 'policy' | 'quick_replies' | 'thinking' | 'error' | 'faq_list' | 'cart';
+type MessageContent = TextContent | ProductCardContent | ProductListContent | ProductComparisonContent | PolicyContent | QuickRepliesContent | ThinkingContent | ErrorContent | FAQListContent | PromotionListContent | CartContent;
+interface TextContent {
+    type: 'text';
+    text: string;
+}
+interface ProductCardContent {
+    type: 'product_card';
+    data: {
+        product: Product;
+    };
+}
+interface ProductListContent {
+    type: 'product_list';
+    data: {
+        products: Product[];
+        title?: string;
+        onAddToCart?: (product: Product) => void;
+        commonText?: CommonText;
+    };
+}
+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;
+        commonText?: CommonText;
+    };
+}
+interface PolicyContent {
+    type: 'policy';
+    data: {
+        title: string;
+        content: string;
+    };
+}
+interface QuickRepliesContent {
+    type: 'quick_replies';
+    data: {
+        replies: QuickReply[];
+    };
+}
+interface ThinkingContent {
+    type: 'thinking';
+    data: {
+        status: string;
+    };
+}
+interface ErrorContent {
+    type: 'error';
+    data: {
+        message: string;
+        code?: string;
+    };
+}
+interface FAQListContent {
+    type: 'faq_list';
+    data: {
+        found: boolean;
+        count: number;
+        total?: number;
+        results: FAQItem[];
+    };
+}
+interface PromotionListContent {
+    type: 'promotion_list';
+    data: {
+        found: boolean;
+        count: number;
+        total?: number;
+        results: PromotionItem[];
+        commonText?: CommonText;
+    };
+}
+type FAQCategory = 'shipping' | 'return' | 'product' | 'payment' | 'general';
+interface FAQItem {
+    id: string;
+    question: string;
+    answer: string;
+    category: FAQCategory;
+    keywords?: string[];
+    relatedQuestions?: string[];
+    metadata?: {
+        language?: string;
+        priority?: number;
+        lastUpdated?: string;
+    };
+}
+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;
+    };
+}
+type StockStatus = 'in_stock' | 'low_stock' | 'out_of_stock';
+interface Price {
+    amount: number;
+    currency: string;
+}
+interface PriceRange {
+    min: number;
+    max: number;
+    currency: string;
+}
+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;
+}
+interface VariantMemberPrice {
+    has_member_price: boolean;
+    price?: number;
+}
+interface ProductFeatures {
+    is_new?: boolean;
+    has_rental?: boolean;
+    has_presale?: boolean;
+    has_member_price?: boolean;
+    has_discount?: boolean;
+}
+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;
+}
+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[];
+}
+interface QuickReply {
+    id: string;
+    label: string;
+    value: string;
+    icon?: string;
+}
+/**
+ * 购物车金额信息
+ */
+interface CartAmount {
+    /** 金额字符串（如 "99.99"） */
+    amount: string;
+    /** 货币代码（如 "USD"） */
+    currencyCode: string;
+}
+/**
+ * 购物车价格汇总
+ */
+interface CartCost {
+    /** 应付总价（已应用折扣） */
+    totalAmount: CartAmount;
+    /** 原价小计（未应用折扣） */
+    subtotalAmount: CartAmount;
+}
+/**
+ * 购物车商品变体信息
+ */
+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;
+    };
+}
+/**
+ * 购物车商品行
+ */
+interface CartLine {
+    /** 购物车行 ID (用于更新/删除操作) */
+    id: string;
+    /** 商品数量 */
+    quantity: number;
+    /** 价格信息 */
+    cost: {
+        /** 行总价（单价 × 数量，已应用折扣） */
+        totalAmount: CartAmount;
+        /** 单价 */
+        amountPerQuantity: CartAmount;
+        /** 行小计（单价 × 数量，未应用折扣） */
+        subtotalAmount: CartAmount;
+    };
+    /** 商品变体信息 */
+    merchandise: CartMerchandise;
+    /** 自定义属性（可选） */
+    attributes?: Array<{
+        key: string;
+        value: string;
+    }>;
+}
+/**
+ * 购物车折扣码
+ */
+interface CartDiscountCode {
+    /** 折扣码 */
+    code: string;
+    /** 是否有效/适用 */
+    applicable: boolean;
+}
+/**
+ * 购物车数据
+ */
+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;
+    /** 通用文案配置 */
+    commonText?: CommonText;
+}
+/**
+ * 购物车内容块
+ */
+interface CartContent {
+    type: 'cart';
+    data: CartData;
+}
+type SSEEventType = 'message_start' | 'content_delta' | 'content_block' | 'message_end' | 'tool_start' | 'tool_end' | 'status' | 'error' | 'done';
+interface SSEEvent<T = any> {
+    event: SSEEventType | null;
+    data: T;
+}
+/**
+ * 流式对话请求参数
+ */
+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;
+    };
+}
+/**
+ * 通用文案配置
+ * 用于自定义组件中的按钮文案
+ */
+interface CommonText {
+    /**
+     * 产品列表展开按钮文案
+     * @default "Learn More"
+     */
+    learnMore?: string;
+    /**
+     * 产品列表收起按钮文案
+     * @default "Show Less"
+     */
+    showLess?: string;
+    /**
+     * 添加到购物车按钮文案
+     * @default "Add to Cart"
+     */
+    addToCart?: string;
+    /**
+     * 查看购物车/更多按钮文案
+     * @default "View More"
+     */
+    viewMore?: string;
+    /**
+     * 折扣标签后缀文案（如 "20% OFF" 中的 "OFF"）
+     * @default "OFF"
+     */
+    off?: string;
+}
+interface LiveChatWidgetProps {
+    /**
+     * API 基础 URL
+     * @example "https://beta-api-livechat.anker.com"
+     */
+    apiBaseUrl: string;
+    /**
+     * 自定义请求头
+     * 将在所有 API 请求中添加这些请求头
+     * @example { "Authorization": "Bearer token", "X-Custom-Header": "value" }
+     */
+    headers?: Record<string, string>;
+    /**
+     * 是否启用 reCAPTCHA 验证
+     * @default false
+     */
+    needRecaptcha?: boolean;
+    /**
+     * reCAPTCHA site key
+     * 当 needRecaptcha=true 时必填
+     * @example "6LfS4J4pAAAAACX1e_WrxutmxxzCK7FU4WzVqL14"
+     */
+    recaptchaSitekey?: string;
+    /**
+     * reCAPTCHA action 前缀
+     * 实际使用时会根据不同接口添加后缀（如 chat_stream, new_session）
+     * @default "livechat"
+     */
+    recaptchaAction?: string;
+    /**
+     * Shopify 店铺域名
+     * @example "www.eufy.com"
+     */
+    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;
+    /**
+     * AI 消息回调
+     */
+    /**
+     * AI 回复文本消息时触发
+     */
+    onTextMessage?: () => void;
+    /**
+     * AI 回复商品列表卡片时触发
+     */
+    onProductList?: () => void;
+    /**
+     * AI 回复促销卡片时触发
+     */
+    onPromotionList?: () => void;
+    /**
+     * 商品操作回调
+     */
+    onAddToCart?: (product: Product) => void;
+    /**
+     * 购物车按钮点击回调
+     */
+    onCart?: (cartId: string, checkoutUrl?: string) => void;
+    /**
+     * 是否显示新会话按钮
+     * @default true
+     */
+    showNewSessionButton?: boolean;
+    /**
+     * 通用文案配置
+     * 用于自定义按钮文案
+     */
+    commonText?: CommonText;
+}
+interface MessageRenderer {
+    render: (content: MessageContent, isUser: boolean, isSystem: boolean) => React.ReactNode;
+}
+interface PositionStyles {
+    bottom?: string;
+    top?: string;
+    left?: string;
+    right?: string;
+}
+type BubblePosition = PositionStyles;
+
+/**
+ * LiveChat 主组件
+ * 集成所有子组件，提供完整的聊天功能
+ * 基于 specs/livechat-widget/plan.md 的三层架构设计
+ */
+
+/**
+ * LiveChat 聊天组件
+ *
+ * 功能：
+ * - 气泡弹窗聊天界面
+ * - SSE 流式消息接收
+ * - 会话管理（userId, sessionId）
+ * - 历史消息加载
+ * - 多种消息类型渲染
+ * - 自定义扩展机制
+ * - reCAPTCHA v3 安全防护
+ *
+ * 架构：
+ * - UI Layer: ChatBubble, ChatWindow, MessageList, etc.
+ * - Logic Layer: useChatState, useChatAPI, useSession
+ * - Core Layer: MessageRendererRegistry, 自定义渲染器
+ *
+ * @example
+ * ```tsx
+ * // 基础使用（使用默认位置）
+ * <LiveChatWidget
+ *   apiBaseUrl="https://beta-api-livechat.anker.com"
+ *   site="www.eufy.com"
+ *   welcomeMessage="你好！我是 AI 助手"
+ *   onMessageSend={(msg) => console.log('Sent:', msg)}
+ * />
+ *
+ * // 使用自定义位置
+ * <LiveChatWidget
+ *   apiBaseUrl="https://beta-api-livechat.anker.com"
+ *   site="www.eufy.com"
+ *   position={{ bottom: "20px", right: "30px" }}
+ *   onMessageSend={(msg) => console.log('Sent:', msg)}
+ * />
+ *
+ * // 启用 reCAPTCHA v3 安全防护
+ * <LiveChatWidget
+ *   apiBaseUrl="https://beta-api-livechat.anker.com"
+ *   site="www.eufy.com"
+ *   needRecaptcha={true}
+ *   recaptchaSitekey="6LfS4J4pAAAAACX1e_WrxutmxxzCK7FU4WzVqL14"
+ *   recaptchaAction="livechat"
+ * />
+ *
+ * // 使用自定义 headers 和 reCAPTCHA
+ * <LiveChatWidget
+ *   apiBaseUrl="https://beta-api-livechat.anker.com"
+ *   site="www.eufy.com"
+ *   headers={{
+ *     "Authorization": "Bearer your-token",
+ *     "X-Custom-Header": "value"
+ *   }}
+ *   needRecaptcha={true}
+ *   recaptchaSitekey="your-site-key"
+ * />
+ * ```
+ */
+declare const LiveChatWidget: React__default.FC<LiveChatWidgetProps>;
+
+type RedeemableItemConfig = {
+    title: string;
+    desc: string;
+    price: number;
+    credit: string;
+    rules: string;
+    image: {
+        url: string;
+    };
+    mobileImage: {
+        url: string;
+    };
+    redeemId: number;
+};
+type TabConfig = {
+    label: string;
+    type: 'memberPrice' | 'redeem';
+};
+type CreditsMemberPriceCopy = {
+    title: string;
+    tabs: TabConfig[];
+    memberPriceTab: {
+        memberPriceRuleId: string;
+        addToCart: string;
+        shopNowText: string;
+        memberPriceLabel: string;
+        badgeLabel?: string;
+    };
+    redeemTab: {
+        list: (RedeemableItemConfig & {
+            products: {
+                handle: string;
+                sku: string;
+            }[];
+        })[];
+        soldOut: string;
+        unlockRewards: string;
+        btnRedeem: string;
+        off: string;
+        badgeLabel?: string;
+    };
+};
+
+type NavigationItem = {
+    label: string;
+    targetId: string;
+};
+type CreditsNavigationCopy = {
+    items: NavigationItem[];
+};
+
+declare enum ComponentKey {
+    Navigation = "creditsNavigation",
+    Banner = "creditsBanner",
+    InfoCard = "creditsInfoCard",
+    Benefits = "creditsBenefits",
+    WaysToGetCredits = "creditsWaysToGetCredits",
+    AnkersolixTask = "creditsAnkersolixTask",
+    RedeemList = "creditsRedeemList",
+    SpendCreditsLikeCash = "creditsCash",
+    MemberPrice = "creditsMemberPrice",
+    Faqs = "creditsFaq"
+}
+type CreditsTemplateProps = {
+    headlessConfig: HeadlessConfig;
+    siteConfig: {
+        registrationsSettings: {
+            authCodeActivate: AuthCodeActivateCopy;
+        };
+        taskIdToTypeMapping: Record<string, DTC_TASK_TYPE>;
+        memberPriceDiscount?: FunctionMemberPriceConfig[];
+    };
+    creditsConfig?: {
+        alpcBrand?: string;
+    };
+    pageConfig: {
+        order: ComponentKey[];
+        common: CreditsPageCommon;
+        components: {
+            [ComponentKey.Navigation]?: CreditsNavigationCopy;
+            [ComponentKey.Banner]?: CreditsBannerCopy;
+            [ComponentKey.InfoCard]?: CreditsInfoCardCopy;
+            [ComponentKey.Benefits]?: CreditsBenefitsCopy;
+            [ComponentKey.WaysToGetCredits]?: CreditsWaysToGetCreditsCopy;
+            [ComponentKey.AnkersolixTask]?: CreditsWaysToGetCreditsCopy;
+            [ComponentKey.RedeemList]?: CreditsRedeemListCopy;
+            [ComponentKey.SpendCreditsLikeCash]?: CreditsCashCopy;
+            [ComponentKey.MemberPrice]?: CreditsMemberPriceCopy;
+            [ComponentKey.Faqs]?: CreditsFaqCopy;
+        };
+    };
+    userContext: {
+        profile: any;
+        removeProfile: () => void;
+        isLoadingProfile: boolean;
+        creditInfo: any;
+        customer: any;
+        customerLoading: boolean;
+        fetchCreditInfo: () => void;
+    };
+    registrationContext: {
+        openSignUpPopup: () => void;
+        openSignInPopup: () => void;
+    };
+    gtm: {
+        pageGroup: string;
+        pageHandle?: string;
+    };
+    cartConfig?: {
+        addToCart: (params: {
+            variantList: Array<{
+                variant: any;
+                quantity: number;
+                attributes?: Array<{
+                    key: string;
+                    value: string;
+                }>;
+            }>;
+            cartAttributes?: Record<string, string>;
+            discountCodes?: string[];
+        }) => void | Promise<any>;
+    };
+};
+declare const CreditsTemplate: ({ headlessConfig, siteConfig, creditsConfig, userContext, pageConfig, registrationContext, gtm, cartConfig, }: CreditsTemplateProps) => react_jsx_runtime.JSX.Element;
+
+declare const ROUNDED_BRANDS: string[];
+
+export { AuthCodeActivate, Chat, type ChatStreamRequest, ComponentKey, CreditsBanner, CreditsBenefits, CreditsCash, CreditsFaq, CreditsInfoCard, CreditsProvider, CreditsRedeemList, CreditsTemplate, type CreditsTemplateProps, CreditsUploadReceiptModal, CreditsWaysToGetCredits, type ErrorContent, LiveChatWidget, type LiveChatWidgetProps, type Message, type MessageContent, type MessageContentType, type MessageMetadata, type MessageRenderer, type MessageRole, type PolicyContent, type ProductCardContent, type ProductListContent, type QuickRepliesContent, type QuickReply, ROUNDED_BRANDS, RegistrationContext, RegistrationProvider, type SSEEvent, type ThinkingContent, useCreditsContext, useUploadReceipt as useCreditsUploadReceipt, useRegistration };