@anker-in/lib 1.0.0-beta.6 → 1.1.0-beta.1

package/dist/esm/utils/useCountDown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCountDown.d.ts","sourceRoot":"","sources":["../../../src/utils/useCountDown.tsx"],"names":[],"mappings":"AAEA,wBAAgB,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,aAAW;;;;EAsCnE"}

package/dist/esm/utils/useCountDown.js

@@ -0,0 +1,2 @@
+import{useCallback as a,useEffect as i,useRef as l,useState as f}from"react";function C(r,u=()=>{}){const[t,n]=f(!1),[e,o]=f(r),s=l(null),c=a(()=>{t||(o(r),n(!0))},[t,r]);return i(()=>(t&&(e>0?s.current=setTimeout(()=>{o(e-1)},1e3):(n(!1),u&&u())),()=>{s.current&&clearTimeout(s.current)}),[t,e,u]),{startCountDown:t,startAction:c,countDown:e}}export{C as useCountDown};
+//# sourceMappingURL=useCountDown.js.map

package/dist/esm/utils/useCountDown.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/utils/useCountDown.tsx"],
+  "sourcesContent": ["import { useCallback, useEffect, useRef, useState } from 'react'\n\nexport function useCountDown(countDownTime: number, onEnd = () => {}) {\n  const [start, setStart] = useState(false)\n  const [countDown, setCountDown] = useState(countDownTime)\n  const timerRef = useRef<NodeJS.Timeout | null>(null)\n\n  const startAction = useCallback(() => {\n    if (!start) {\n      setCountDown(countDownTime)\n      setStart(true)\n    }\n  }, [start, countDownTime])\n\n  useEffect(() => {\n    if (start) {\n      if (countDown > 0) {\n        timerRef.current = setTimeout(() => {\n          setCountDown(countDown - 1)\n        }, 1000)\n      } else {\n        setStart(false)\n        if (onEnd) {\n          onEnd()\n        }\n      }\n    }\n\n    return () => {\n      if (timerRef.current) {\n        clearTimeout(timerRef.current)\n      }\n    }\n  }, [start, countDown, onEnd])\n\n  return {\n    startCountDown: start,\n    startAction,\n    countDown,\n  }\n}\n"],
+  "mappings": "AAAA,OAAS,eAAAA,EAAa,aAAAC,EAAW,UAAAC,EAAQ,YAAAC,MAAgB,QAElD,SAASC,EAAaC,EAAuBC,EAAQ,IAAM,CAAC,EAAG,CACpE,KAAM,CAACC,EAAOC,CAAQ,EAAIL,EAAS,EAAK,EAClC,CAACM,EAAWC,CAAY,EAAIP,EAASE,CAAa,EAClDM,EAAWT,EAA8B,IAAI,EAE7CU,EAAcZ,EAAY,IAAM,CAC/BO,IACHG,EAAaL,CAAa,EAC1BG,EAAS,EAAI,EAEjB,EAAG,CAACD,EAAOF,CAAa,CAAC,EAEzB,OAAAJ,EAAU,KACJM,IACEE,EAAY,EACdE,EAAS,QAAU,WAAW,IAAM,CAClCD,EAAaD,EAAY,CAAC,CAC5B,EAAG,GAAI,GAEPD,EAAS,EAAK,EACVF,GACFA,EAAM,IAKL,IAAM,CACPK,EAAS,SACX,aAAaA,EAAS,OAAO,CAEjC,GACC,CAACJ,EAAOE,EAAWH,CAAK,CAAC,EAErB,CACL,eAAgBC,EAChB,YAAAK,EACA,UAAAH,CACF,CACF",
+  "names": ["useCallback", "useEffect", "useRef", "useState", "useCountDown", "countDownTime", "onEnd", "start", "setStart", "countDown", "setCountDown", "timerRef", "startAction"]
+}

package/esbuild-cjs.mjs

@@ -0,0 +1,23 @@
+import esbuild from 'esbuild'
+
+const dir = 'dist/cjs'
+
+const options = {
+  entryPoints: ['src/**/*.ts*'],
+  outdir: dir,
+  format: 'cjs',
+  target: 'es2020',
+  sourcemap: true,
+  minify: true,
+}
+
+// Check if "watch=true" flag is passed
+if (process.argv[2]) {
+  const [key, value] = process.argv[2].split('=')
+  if (key === 'watch' && value === 'true') {
+    const ctx = await esbuild.context(options)
+    await ctx.watch()
+  }
+}
+
+esbuild.build(options).catch(() => process.exit(1))

package/esbuild-esm.mjs

@@ -0,0 +1,31 @@
+import esbuild from 'esbuild'
+
+const dir = 'dist/esm'
+
+const options = {
+  entryPoints: ['src/**/*.ts*'],
+  outdir: dir,
+  format: 'esm',
+  target: 'es2020',
+  sourcemap: true,
+  minify: true,
+}
+
+// Check if "watch=true" flag is passed
+if (process.argv[2]) {
+  const [key, value] = process.argv[2].split('=')
+  if (key === 'watch' && value === 'true') {
+    const ctx = await esbuild.context(options)
+    await ctx.watch()
+  }
+}
+
+esbuild.build(options).catch(() => process.exit(1))
+
+// Create a package.json file in the dist/esm directory with "type": "module" field
+import fs from 'fs'
+import path from 'path'
+if (!fs.existsSync(dir)) {
+  fs.mkdirSync(dir, { recursive: true })
+}
+fs.writeFileSync(path.join(dir, 'package.json'), JSON.stringify({ type: 'module' }, null, 2) + '\n', 'utf-8')

package/jest.config.ts

@@ -0,0 +1,15 @@
+import { JestConfigWithTsJest } from 'ts-jest'
+
+const config: JestConfigWithTsJest = {
+  preset: 'ts-jest',
+  testEnvironment: 'jsdom', // 使用 node 环境（如果是浏览器库可改成 'jsdom'）
+  clearMocks: true, // 每次测试后自动清除 mock
+  coverageDirectory: 'coverage', // 输出覆盖率报告
+  testMatch: ['**/__tests__/**/*.test.ts'], // 匹配测试文件路径
+  moduleFileExtensions: ['ts', 'js', 'json'],
+  moduleNameMapper: {
+    '^src/(.*)$': '<rootDir>/src/$1',
+  },
+}
+
+export default config

package/package.json

@@ -1,44 +1,39 @@
 {
   "name": "@anker-in/lib",
-  "version": "1.0.0-beta.6",
-  "description": "Convenience package that re-exports all Anker headless packages",
-  "main": "dist/index.js",
-  "module": "dist/index.mjs",
-  "types": "dist/index.d.ts",
-  "files": [
-    "dist"
-  ],
+  "version": "1.1.0-beta.1",
+  "description": "Unified Anker headless library with shared context, Shopify integration, and cart utilities",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
   "exports": {
     ".": {
-      "import": {
-        "types": "./dist/index.d.mts",
-        "default": "./dist/index.mjs"
-      },
       "require": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.js"
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      },
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
       }
     }
   },
-  "dependencies": {
-    "@anker-in/shared": "1.0.0-beta.2",
-    "@anker-in/shopify": "0.0.0-beta.6",
-    "@anker-in/cart": "1.0.0-beta.2"
-  },
   "peerDependencies": {
-    "react": "^18.0.0",
-    "react-dom": "^18.0.0"
+    "tailwind-merge": "^1.11.0",
+    "clsx": "^2.1.1"
+  },
+  "dependencies": {
+    "swr": "^2.2.4",
+    "fetch-ponyfill": "^7.1.0",
+    "js-cookie": "^3.0.5"
   },
   "devDependencies": {
     "@types/jest": "^29.5.12",
-    "@types/react": "^18.3.3",
+    "@types/js-cookie": "^3.0.6",
+    "esbuild": "^0.19.0",
     "jest": "^29.0.0",
     "ts-jest": "^29.2.6",
     "tsup": "^8.4.0",
-    "typescript": "^5.0.0",
-    "@anker-in/shared": "1.0.0-beta.2",
-    "@anker-in/shopify": "0.0.0-beta.6",
-    "@anker-in/cart": "1.0.0-beta.2"
+    "typescript": "^5.0.0"
   },
   "publishConfig": {
     "access": "public",
@@ -49,16 +44,23 @@
     "headless",
     "shopify",
     "ecommerce",
-    "react"
+    "react",
+    "cart",
+    "context"
   ],
   "author": "Anker",
   "license": "MIT",
   "scripts": {
     "dev": "tsup --watch",
-    "build": "tsup",
+    "build": "pnpm run build:js:esm & pnpm run build:js:cjs & pnpm run build:types:esm & pnpm run build:types:cjs",
+    "build:js:cjs": "node esbuild-cjs.mjs",
+    "build:js:esm": "node esbuild-esm.mjs",
+    "build:types:esm": "tsc --outdir dist/esm",
+    "build:types:cjs": "tsc --outdir dist/cjs",
     "test": "jest --passWithNoTests",
     "test:watch": "jest --watch",
     "coverage": "jest --coverage",
+    "type-check": "tsc --noEmit",
     "clean": "rm -rf .turbo node_modules dist"
   }
 }

package/src/cart/const.ts

@@ -0,0 +1,23 @@
+import { SWRMutationConfiguration } from 'swr/mutation'
+
+export const currencyCodeMapping = {
+  us: 'USD',
+  ca: 'CAD',
+  gb: 'GBP',
+  eu: 'EUR',
+  au: 'AUD',
+  nz: 'NZD',
+  de: 'EUR',
+  fr: 'EUR',
+  es: 'EUR',
+  it: 'EUR',
+  nl: 'EUR',
+  pl: 'EUR',
+  ro: 'EUR',
+} as Record<string, string>
+
+export const defaultSWRMutationConfiguration: SWRMutationConfiguration<any, any, any, any, any> & {
+  throwOnError?: boolean
+} = {
+  throwOnError: false,
+}

package/src/cart/context/index.tsx

@@ -0,0 +1,310 @@
+import React, { createContext, useContext, useState, useMemo, useEffect, useCallback } from 'react'
+import { Cart } from '../../shopify/types/cart'
+
+import { AutoFreeGiftConfig, FunctionGiftResult, AutoFreeGiftList } from '../types/autoFreeGift'
+import { useCalcAutoFreeGift } from '../hooks/feature/useCalcAutoFreeGift'
+import { getCart } from '../../shopify/fetchers/get-cart'
+import { useRequest } from 'ahooks'
+import { useHeadlessContext } from '../../context'
+import { useUpdateCartAttributes } from '../hooks/basic/useUpdateCartAttributes'
+import { useCartAttributes } from '../hooks/feature/useCartAttributes'
+import { AttributeInput } from '../../shopify/gql'
+import { isAttributesEqual } from '../utils'
+import { useUpdateLineCodeAmountAttributes } from '../hooks/feature/useUpdateLineCodeAmountAttributes'
+import useScriptAutoFreeGift, { UseScriptAutoFreeGiftResult } from '../hooks/feature/useScriptAutoFreeGift'
+import {
+  formatScriptAutoFreeGift,
+  formatFunctionAutoFreeGift,
+  getDiscountEnvAttributeValue,
+} from '../utils/autoFreeGift'
+import { CUSTOMER_ATTRIBUTE_KEY, CUSTOMER_SCRIPT_GIFT_KEY } from '../../shopify/utils/const'
+
+export type LoadingState = {
+  editLineQuantityLoading: boolean
+  editLineCodeAmountLoading: boolean
+  listingAutoCodeApplying: boolean
+  userCodeApplying: boolean
+}
+
+type CartContextType = {
+  cart: Cart | undefined
+  isCartLoading: boolean
+  mutateCart: (cart: Cart | undefined) => void
+  triggerFetch: () => void
+  calculatedAutoFreeGift?: FunctionGiftResult | undefined
+  addCustomAttributes: (attributes: AttributeInput[]) => void
+  removeCustomAttributes: (attributes: { key: string }[]) => void
+  setCustomAttributes: (attributes: AttributeInput[]) => void
+  isCodeChanging: boolean
+  setIsCodeChanging: (isCodeChanging: boolean) => void
+  autoFreeGiftConfig?: AutoFreeGiftConfig
+  setLoadingState: React.Dispatch<React.SetStateAction<LoadingState>>
+  loadingState: LoadingState
+  scriptAutoFreeGiftResult?: UseScriptAutoFreeGiftResult
+  scriptAutoFreeGift?: AutoFreeGiftList
+  functionAutoFreeGiftResult?: FunctionGiftResult
+  functionAutoFreeGift?: AutoFreeGiftList
+  setFunctionAutoFreeGift: (functionAutoFreeGift: AutoFreeGiftList) => void
+  setScriptAutoFreeGift: (scriptAutoFreeGift: AutoFreeGiftList) => void
+  giftNeedAddToCartLines: AutoFreeGiftList
+}
+
+const initialState: CartContextType = {
+  cart: undefined,
+  isCartLoading: false,
+  mutateCart: () => {},
+  triggerFetch: () => {},
+  calculatedAutoFreeGift: undefined,
+  addCustomAttributes: () => {},
+  removeCustomAttributes: () => {},
+  setCustomAttributes: () => {},
+  isCodeChanging: false,
+  setIsCodeChanging: () => {},
+  setLoadingState: () => {},
+  loadingState: {
+    editLineQuantityLoading: false,
+    editLineCodeAmountLoading: false,
+    listingAutoCodeApplying: false,
+    userCodeApplying: false,
+  },
+  scriptAutoFreeGift: undefined,
+  functionAutoFreeGift: undefined,
+  scriptAutoFreeGiftResult: undefined,
+  functionAutoFreeGiftResult: undefined,
+  setFunctionAutoFreeGift: () => {},
+  setScriptAutoFreeGift: () => {},
+  giftNeedAddToCartLines: [],
+}
+
+export const CartContext = createContext<CartContextType>(initialState)
+
+type CartProviderProps = {
+  children: React.ReactNode
+  autoFreeGiftConfig?: AutoFreeGiftConfig
+  gradientGiftsConfig: any
+  profile: any
+  customer: any
+}
+
+export const CartProvider = ({
+  children,
+  autoFreeGiftConfig,
+  gradientGiftsConfig,
+  profile,
+  customer,
+}: CartProviderProps) => {
+  const { storefrontToken, storeDomain, cartIdCookieName, locale } = useHeadlessContext()
+  const [customAttributes, setCustomAttributes] = useState<AttributeInput[]>([])
+  const [isCodeChanging, setIsCodeChanging] = useState(false)
+  const [loadingState, setLoadingState] = useState<LoadingState>({
+    editLineQuantityLoading: false,
+    editLineCodeAmountLoading: false,
+    listingAutoCodeApplying: false,
+    userCodeApplying: false,
+  })
+  const [scriptAutoFreeGift, setScriptAutoFreeGift] = useState<AutoFreeGiftList>([])
+  const [functionAutoFreeGift, setFunctionAutoFreeGift] = useState<AutoFreeGiftList>([])
+
+  // 获取购物车逻辑
+  const {
+    run: fetchCart,
+    data: cart,
+    loading: isCartLoading,
+    mutate: mutateCart,
+  } = useRequest(
+    async () => {
+      // 从 cookie 获取 cartId
+      const cartId =
+        typeof window !== 'undefined'
+          ? document.cookie
+              .split('; ')
+              .find(row => row.startsWith(`${cartIdCookieName}=`))
+              ?.split('=')[1]
+          : undefined
+
+      if (!cartId) {
+        return undefined
+      }
+
+      return getCart({
+        options: { cartId },
+        config: {
+          storefrontToken,
+          storeDomain,
+        },
+      })
+    },
+    {
+      refreshDeps: [locale, storefrontToken, storeDomain, cartIdCookieName],
+    }
+  ) as unknown as {
+    run: () => Promise<Cart | undefined>
+    mutate: (cart: Cart | undefined) => void
+    data: Cart | undefined
+    loading: boolean
+  }
+
+  // 更新 attributes
+  const { trigger: updateAttributes } = useUpdateCartAttributes()
+  // 公共 attributes
+  const { attributes } = useCartAttributes({ profile, customer, cart })
+
+  useRequest(
+    async () => {
+      // 去重逻辑
+      const newAttributes = [...attributes, ...customAttributes]
+
+      const needUpdate = cart && !isAttributesEqual(cart.customAttributes, newAttributes)
+
+      // 如果 attributes 没有变化，不更新
+      if (needUpdate && cart) {
+        const updatedCart = await updateAttributes({
+          cartId: cart.id,
+          attributes: newAttributes,
+        })
+        if (updatedCart) {
+          mutateCart(updatedCart)
+        }
+        return updatedCart
+      } else {
+        return Promise.resolve(cart)
+      }
+    },
+    {
+      throttleWait: 1000, // 1 秒内只触发最后一次更新
+      throttleTrailing: true,
+      throttleLeading: false,
+      refreshDeps: [attributes, customAttributes, cart?.id],
+    }
+  )
+
+  // 更新 code 时，同步更新 line item 中的 code amount attribute
+  useUpdateLineCodeAmountAttributes({
+    cart,
+    mutateCart,
+    isCartLoading: isCartLoading || isCodeChanging,
+    setLoadingState,
+  })
+
+  // 计算购物车赠品 - 只计算，不执行副作用
+  const functionAutoFreeGiftResult = useCalcAutoFreeGift(cart, autoFreeGiftConfig || [], customer)
+  const scriptAutoFreeGiftResult = useScriptAutoFreeGift({
+    campaign: gradientGiftsConfig,
+    _giveaway: CUSTOMER_SCRIPT_GIFT_KEY,
+    cart,
+  })
+
+  const formattedScriptGifts = useMemo(() => {
+    return formatScriptAutoFreeGift({
+      scriptAutoFreeGiftResult,
+      gradient_gifts: gradientGiftsConfig,
+      locale,
+    })
+  }, [scriptAutoFreeGiftResult, gradientGiftsConfig, locale])
+
+  const formattedFunctionGifts = useMemo(() => {
+    return formatFunctionAutoFreeGift({
+      qualifyingGift: functionAutoFreeGiftResult?.qualifyingGift || null,
+      giftProductsResult: (functionAutoFreeGiftResult?.giftProductsResult as any[]) || [],
+      locale,
+    })
+  }, [functionAutoFreeGiftResult, locale])
+
+  // 当格式化结果变化时更新状态
+  useEffect(() => {
+    if (
+      loadingState.userCodeApplying ||
+      loadingState.editLineQuantityLoading ||
+      loadingState.editLineCodeAmountLoading ||
+      loadingState.listingAutoCodeApplying
+    ) {
+      return
+    }
+
+    setScriptAutoFreeGift(formattedScriptGifts)
+    setFunctionAutoFreeGift(formattedFunctionGifts)
+  }, [
+    formattedScriptGifts,
+    formattedFunctionGifts,
+    loadingState.userCodeApplying,
+    loadingState.editLineQuantityLoading,
+    loadingState.editLineCodeAmountLoading,
+    loadingState.listingAutoCodeApplying,
+  ])
+
+  const giftNeedAddToCartLines = useMemo(() => {
+    const cartGiftLineItems = cart?.lineItems.filter(line =>
+      line.customAttributes?.some((attr: any) => [CUSTOMER_ATTRIBUTE_KEY, CUSTOMER_SCRIPT_GIFT_KEY].includes(attr.key))
+    )
+    const result = [...scriptAutoFreeGift, ...functionAutoFreeGift].filter(
+      item =>
+        // 如果购物车中已经存在对应赠品，且标记了 function 满赠的属性，则不添加
+        !cartGiftLineItems?.find(line => {
+          return (
+            line.variantId === item.line.variantId &&
+            line.customAttributes?.some((attr: any) => {
+              if (attr.key === '_discounts_function_env') {
+                return getDiscountEnvAttributeValue(line.customAttributes).is_gift
+              }
+
+              return false
+            })
+          )
+        })
+    )
+    return result
+  }, [cart?.lineItems, scriptAutoFreeGift, functionAutoFreeGift])
+
+  const removeCustomAttributes = useCallback((attributes: { key: string }[]) => {
+    setCustomAttributes(prev => prev.filter((attr: AttributeInput) => !attributes.some(a => a.key === attr.key)))
+  }, [])
+
+  const addCustomAttributes = useCallback(
+    (attributes: AttributeInput[]) => {
+      const sameAttributes = attributes.filter(attr => customAttributes.some(a => a.key === attr.key))
+      if (sameAttributes.length) {
+        setCustomAttributes(prev => {
+          // 更新相同的属性
+          const removedAttributes = prev.filter((attr: AttributeInput) => !sameAttributes.some(a => a.key === attr.key))
+          return [...removedAttributes, ...attributes]
+        })
+      } else {
+        // 添加新的属性
+        setCustomAttributes(prev => [...prev, ...attributes])
+      }
+    },
+    [customAttributes]
+  )
+
+  return (
+    <CartContext.Provider
+      value={{
+        cart,
+        mutateCart,
+        triggerFetch: fetchCart,
+        isCartLoading,
+        setCustomAttributes,
+        addCustomAttributes: addCustomAttributes,
+        removeCustomAttributes: removeCustomAttributes,
+        calculatedAutoFreeGift: functionAutoFreeGiftResult || scriptAutoFreeGiftResult,
+        isCodeChanging,
+        setIsCodeChanging,
+        setLoadingState,
+        loadingState,
+        // function满赠
+        functionAutoFreeGift,
+        functionAutoFreeGiftResult,
+        setFunctionAutoFreeGift,
+        // script满赠
+        scriptAutoFreeGift,
+        scriptAutoFreeGiftResult,
+        setScriptAutoFreeGift,
+        giftNeedAddToCartLines,
+      }}
+    >
+      {children}
+    </CartContext.Provider>
+  )
+}
+
+export const useCartContext = () => useContext(CartContext)

package/src/cart/hooks/basic/useAddToCart.ts

@@ -0,0 +1,161 @@
+import { Cart, Attributes } from '../../../shopify'
+import { CartBuyerIdentityInput } from '../../../shopify/gql'
+import { useCallback } from 'react'
+import useSWRMutation, { SWRMutationConfiguration } from 'swr/mutation'
+import { GtmParams } from '../../types'
+// import { startInactiveSpan } from '@sentry/nextjs'
+import { addCartLines as addCartLinesFetcher, createCart as createCartFetcher } from '../../../shopify'
+import { useHeadlessContext } from '../../../context'
+import { defaultSWRMutationConfiguration } from '../../const'
+import { addToCartFbq } from '../../track/fbq'
+import { addToCartGa } from '../../track/gtm'
+
+type AddToCartLineItem = {
+  variant?: { id: string }
+  variantId?: string
+  quantity?: number
+  attributes?: Attributes
+}
+
+export type AddToCartArgs = {
+  lineItems: AddToCartLineItem[]
+  cartId?: string
+  discountCodes?: string[]
+  customAttributes?: Attributes
+  buyerIdentity?: CartBuyerIdentityInput
+  gtmParams?: Exclude<GtmParams, 'brand'>
+  needCreateCart?: boolean // 是否强制创建新购物车
+  onCodesInvalid?: (updatedCart: Cart, invalidCodes: string[]) => Promise<Cart | undefined> // 折扣码不可用时的回调
+}
+
+type UseAddToCartProps = {
+  withTrack?: boolean // 是否需要默认埋点（暂时注释，需要时可以启用）
+}
+
+export const useAddToCart = (
+  { withTrack = true }: UseAddToCartProps = {},
+  swrOptions: SWRMutationConfiguration<Cart | undefined, Error, string, AddToCartArgs> & {
+    throwOnError?: boolean
+  } = defaultSWRMutationConfiguration
+) => {
+  const { storefrontToken, storeDomain, brand } = useHeadlessContext()
+
+  const trigger = useCallback(
+    async (_: any, { arg }: { arg: AddToCartArgs }) => {
+      const {
+        lineItems,
+        cartId,
+        discountCodes,
+        gtmParams = {},
+        buyerIdentity,
+        needCreateCart = false,
+        onCodesInvalid,
+      } = arg
+
+      if (!lineItems || lineItems.length === 0) {
+        return
+      }
+
+      // const addToCartSpan = startInactiveSpan({
+      //   name: 'addToCart',
+      //   op: 'business',
+      // })
+
+      // 准备要添加的商品数据
+      const linesToAdd = lineItems
+        .map(item => ({
+          merchandiseId: item.variant?.id || item.variantId || '',
+          quantity: item.quantity || 1,
+          attributes: item.attributes,
+        }))
+        .filter(item => item.merchandiseId && item.quantity)
+
+      let resultCart: Cart | undefined
+
+      if (linesToAdd.length > 0) {
+        // const addToCartAPISpan = startInactiveSpan({
+        //   name: 'addToCartAPI',
+        //   op: 'business',
+        //   parentSpan: addToCartSpan,
+        // })
+
+        if (!cartId || needCreateCart) {
+          // 创建新购物车
+          // const createCartApiSpan = startInactiveSpan({
+          //   name: 'createCartAPI',
+          //   op: 'business',
+          //   parentSpan: addToCartAPISpan,
+          // })
+
+          resultCart = await createCartFetcher({
+            options: {
+              lines: linesToAdd,
+              buyerIdentity,
+              discountCodes,
+            },
+            config: {
+              storefrontToken,
+              storeDomain,
+            },
+          })
+
+          // createCartApiSpan.end()
+        } else {
+          // 添加到现有购物车
+          // const addCartLinesApiSpan = startInactiveSpan({
+          //   name: 'addCartLinesAPI',
+          //   op: 'business',
+          //   parentSpan: addToCartAPISpan,
+          // })
+
+          resultCart = await addCartLinesFetcher({
+            options: {
+              lines: linesToAdd,
+              cartId,
+            },
+            config: {
+              storefrontToken,
+              storeDomain,
+            },
+          })
+
+          // addCartLinesApiSpan.end()
+        }
+
+        // addToCartAPISpan.end()
+      }
+
+      // 检查是否有不可用的折扣码
+      if (resultCart && onCodesInvalid) {
+        const unApplicableCodes = resultCart.discountCodes
+          ?.filter((item) => !item.applicable)
+          .map((item) => item.code)
+
+        if (unApplicableCodes?.length) {
+          // const removeCartCodesApiSpan = startInactiveSpan({
+          //   name: 'removeCartCodesAPI',
+          //   op: 'business',
+          //   parentSpan: addToCartSpan,
+          // })
+
+          resultCart = (await onCodesInvalid(resultCart, unApplicableCodes)) || resultCart
+
+          // removeCartCodesApiSpan.end()
+        }
+      }
+
+      // 埋点（需要时可以启用）
+      if (withTrack) {
+        addToCartFbq({ lineItems: resultCart?.lineItems || [] })
+        addToCartGa({ lineItems: resultCart?.lineItems || [], gtmParams: { ...gtmParams, brand } })
+      }
+
+      // addToCartSpan.end()
+
+      return resultCart
+    },
+    [storefrontToken, storeDomain]
+  )
+
+  return useSWRMutation('add-to-cart', trigger, swrOptions)
+}