@anker-in/lib 1.1.0 → 1.1.2-beta.1

package/dist/utils/fetcher/fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetcher.d.ts","sourceRoot":"","sources":["../../../src/utils/fetcher/fetcher.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,OAAO,GAAU,mEAS3B,GAAG,iBA0BL,CAAA"}

package/dist/utils/fetcher/index.d.ts

@@ -0,0 +1,3 @@
+export * from './fetcher';
+export * from './fetchResponse';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/fetcher/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/fetcher/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,iBAAiB,CAAA"}

package/dist/utils/index.d.ts

@@ -0,0 +1,5 @@
+export * from './classnames';
+export * from './fetcher';
+export * from './track';
+export * from './useCountDown';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,SAAS,CAAA;AACvB,cAAc,gBAAgB,CAAA"}

package/dist/utils/track.d.ts

@@ -0,0 +1,16 @@
+declare global {
+    interface Window {
+        dataLayer?: Array<any>;
+        fbq?: (...args: any[]) => void;
+        klaviyo?: any;
+        gtag?: (...args: any[]) => void;
+    }
+}
+export declare const gaTrack: (data: any) => "" | undefined;
+export declare function gaNormalClick({ position, label }: {
+    position: string;
+    label: string;
+}): void;
+export declare const fbq: (...args: any[]) => "" | undefined;
+export declare const gtag: (...args: any[]) => "" | undefined;
+//# sourceMappingURL=track.d.ts.map

package/dist/utils/track.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"track.d.ts","sourceRoot":"","sources":["../../src/utils/track.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,SAAS,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAA;QACtB,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;QAC9B,OAAO,CAAC,EAAE,GAAG,CAAA;QACb,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;KAChC;CACF;AAGD,eAAO,MAAM,OAAO,GAAI,MAAM,GAAG,mBAehC,CAAA;AAED,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,QAUrF;AAGD,eAAO,MAAM,GAAG,GAAI,GAAG,MAAM,GAAG,EAAE,mBAOjC,CAAA;AAED,eAAO,MAAM,IAAI,GAAI,GAAG,MAAM,GAAG,EAAE,mBAOlC,CAAA"}

package/dist/utils/useCountDown.d.ts

@@ -0,0 +1,6 @@
+export declare function useCountDown(countDownTime: number, onEnd?: () => void): {
+    startCountDown: boolean;
+    startAction: () => void;
+    countDown: number;
+};
+//# sourceMappingURL=useCountDown.d.ts.map

package/dist/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/esbuild-esm.mjs

@@ -1,4 +1,5 @@
 import esbuild from 'esbuild'
+
 const dir = 'dist/esm'
 
 const options = {

package/jest.config.ts

@@ -7,6 +7,9 @@ const config: JestConfigWithTsJest = {
   coverageDirectory: 'coverage', // 输出覆盖率报告
   testMatch: ['**/__tests__/**/*.test.ts'], // 匹配测试文件路径
   moduleFileExtensions: ['ts', 'js', 'json'],
+  moduleNameMapper: {
+    '^src/(.*)$': '<rootDir>/src/$1',
+  },
 }
 
 export default config

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anker-in/lib",
-  "version": "1.1.0",
+  "version": "1.1.2-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",
@@ -18,8 +18,6 @@
     }
   },
   "peerDependencies": {
-    "react": "^18.0.0",
-    "react-dom": "^18.0.0",
     "tailwind-merge": "^1.11.0",
     "clsx": "^2.1.1"
   },
@@ -54,10 +52,11 @@
   "license": "MIT",
   "scripts": {
     "dev": "tsup --watch",
-    "build": "pnpm run build:js:esm & pnpm run build:js:cjs & pnpm run build:types",
+    "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": "tsc --outdir dist",
+    "build:types:esm": "tsc --outdir dist/esm",
+    "build:types:cjs": "tsc --outdir dist/cjs",
     "test": "jest --passWithNoTests",
     "test:watch": "jest --watch",
     "coverage": "jest --coverage",

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)
+}

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

@@ -0,0 +1,72 @@
+import { Cart } from '../../../shopify'
+import { useCallback } from 'react'
+import useSWRMutation, { SWRMutationConfiguration } from 'swr/mutation'
+import { MutationCartDiscountCodesUpdateArgs } from '../../../shopify/gql'
+// import { startInactiveSpan } from '@sentry/nextjs'
+import { updateCartCodes as updateCartCodesFetcher } from '../../../shopify'
+import { useHeadlessContext } from '../../../context'
+import { defaultSWRMutationConfiguration } from '../../const'
+
+export type ApplyCartCodesArgs = {
+  cartId: string
+  discountCodes: string[]
+  currentCart?: Cart // 当前购物车状态，用于合并已有的折扣码
+}
+
+export const useApplyCartCodes = (
+  swrOptions: SWRMutationConfiguration<Cart | undefined, Error, string, ApplyCartCodesArgs> & {
+    throwOnError?: boolean
+  } = defaultSWRMutationConfiguration
+) => {
+  const { storefrontToken, storeDomain } = useHeadlessContext()
+
+  const trigger = useCallback(
+    async (_: any, { arg }: { arg: ApplyCartCodesArgs }) => {
+      const { cartId, discountCodes, currentCart } = arg
+
+      if (!discountCodes?.length) {
+        throw new Error('Invalid input used for this operation: Miss discountCode')
+      }
+
+      if (!cartId) {
+        throw new Error('cartId is required')
+      }
+
+      // 合并当前已有的可用折扣码
+      let existingCodes = currentCart?.discountCodes?.filter(code => code.applicable) || []
+      const uniqueCodes = [...new Set([...existingCodes.map(code => code.code), ...discountCodes])]
+
+      // const applyCartCodesApiSpan = startInactiveSpan({
+      //   name: 'applyCartCodesAPI',
+      //   op: 'business',
+      // })
+
+      const updatedCart = await updateCartCodesFetcher({
+        options: {
+          cartId,
+          discountCodes: uniqueCodes,
+        },
+        config: {
+          storefrontToken,
+          storeDomain,
+        },
+      })
+
+      // applyCartCodesApiSpan.end()
+
+      // 检查新添加的折扣码是否有不可用的
+      const unApplicableCodes = discountCodes.filter((code) =>
+        updatedCart?.discountCodes?.find((item) => item.code === code && !item.applicable)
+      )
+
+      if (unApplicableCodes.length) {
+        throw new Error(`${unApplicableCodes.join(', ')} is not applicable to the cart`)
+      }
+
+      return updatedCart
+    },
+    [storefrontToken, storeDomain]
+  )
+
+  return useSWRMutation('apply-cart-codes', trigger, swrOptions)
+}