@anker-in/lib 1.0.0 → 1.1.0-beta.2

package/src/cart/hooks/feature/useCalcOrderDiscount.tsx

@@ -0,0 +1,127 @@
+import { useMemo } from 'react'
+import { preCheck } from '../../utils/autoFreeGift'
+import { getMatchedMainProductSubTotal } from '../../utils/autoFreeGift'
+import { OrderDiscountConfig, DiscountType, BasePriceType, TieredDiscount } from '../../types/orderDiscount'
+
+// 返回结果类型
+export interface OrderDiscountResult {
+  qualifyingDiscount: TieredDiscount | null // 当前应得的折扣
+  nextTierGoal: TieredDiscount | null // 下一个目标阶梯
+  activeCampaign: OrderDiscountConfig | null // 当前生效的活动配置
+  discountAmount: number // 折扣金额
+  cartTotalForDiscount: number // 用于计算折扣的购物车总额
+  isLoading: boolean // 依赖数据是否加载中
+}
+
+/**
+ * [计算型 Hook]
+ * 根据购物车、活动配置和用户信息，计算出应得的订单折扣和下一个目标。
+ * 此 Hook 不产生任何副作用。
+ * 使用示例：
+ * const { qualifyingDiscount, nextTierGoal, activeCampaign, discountAmount, isLoading } = useCalcOrderDiscount(cart, orderDiscountConfig);
+ * @param cart - 购物车
+ * @param orderDiscountConfig - 订单折扣配置
+ * @returns { OrderDiscountResult }
+ */
+export const useCalcOrderDiscount = (
+  cart: any,
+  orderDiscountConfig: OrderDiscountConfig[],
+  customer: any
+): OrderDiscountResult => {
+  const tags = useMemo(() => customer?.tags || [], [customer?.tags])
+  const isCustomerLoading = useMemo(() => (!customer ? true : false), [customer])
+  const dealsType: string = '' // 可从URL或Context获取
+
+  // 1. 找到当前生效的活动和用于计算的子总价
+  const { activeCampaign, subtotal } = useMemo(() => {
+    // 遍历所有活动配置
+    for (const campaign of orderDiscountConfig) {
+      const { rule_conditions = [], result_detail } = campaign
+      const { main_product, order_discount_conf } = result_detail || {}
+
+      // 前置检查，判断用户和环境是否满足活动条件
+      const isPreCheckPassed = preCheck(rule_conditions, tags, dealsType ? [dealsType] : [])
+
+      if (isPreCheckPassed && main_product && order_discount_conf) {
+        // 计算参与活动的主商品的总价
+        const matchedSubtotal = getMatchedMainProductSubTotal(
+          cart,
+          main_product?.variant_list?.map(v => v.variant_id) || [],
+          {
+            spend_money_type: order_discount_conf.base_price === BasePriceType.MIN_DISCOUNTED_PRICE ? 2 : 1, // 根据基础价格类型设置
+            variant_id_list: main_product?.variant_list?.map(v => v.variant_id) || [],
+            all_store_variant: main_product?.all_store_variant || false,
+          }
+        )
+
+        // 如果有主商品在购物车中，则此活动为当前生效的活动
+        if (matchedSubtotal > 0) {
+          return { activeCampaign: campaign, subtotal: matchedSubtotal }
+        }
+      }
+    }
+    // 没有找到生效的活动
+    return { activeCampaign: null, subtotal: 0 }
+  }, [orderDiscountConfig, cart, tags, dealsType])
+
+  // 2. 根据子总价，计算应得折扣和下一个目标
+  const { qualifyingDiscount, nextTierGoal, discountAmount } = useMemo(() => {
+    if (!activeCampaign || !activeCampaign.result_detail?.order_discount_conf?.tiered_discounts) {
+      return {
+        qualifyingDiscount: null,
+        nextTierGoal: null,
+        discountAmount: 0,
+      }
+    }
+
+    const tieredDiscounts = activeCampaign.result_detail.order_discount_conf.tiered_discounts
+
+    // a. 找到当前满足条件的最高阶梯 (findLast)
+    const qualifyingTier = tieredDiscounts.findLast(tier => subtotal >= Number(tier.amount))
+
+    // b. 找到下一个目标阶梯 (第一个门槛比当前subtotal高的)
+    const nextGoal = tieredDiscounts.find(tier => subtotal < Number(tier.amount))
+
+    if (!qualifyingTier) {
+      return {
+        qualifyingDiscount: null,
+        nextTierGoal: nextGoal || null,
+        discountAmount: 0,
+      }
+    }
+
+    // c. 计算折扣金额
+    let calculatedDiscount = 0
+    switch (qualifyingTier.discount_type) {
+      case DiscountType.PERCENTAGE:
+        // 百分比折扣
+        calculatedDiscount = (subtotal * qualifyingTier.discount) / 100
+        break
+      case DiscountType.FIXED_AMOUNT:
+        // 固定金额折扣
+        calculatedDiscount = qualifyingTier.discount
+        break
+      case DiscountType.REDUCE_PRICE:
+        // 降低指定价格
+        calculatedDiscount = Math.min(subtotal, qualifyingTier.discount)
+        break
+      default:
+        calculatedDiscount = 0
+    }
+
+    return {
+      qualifyingDiscount: qualifyingTier,
+      nextTierGoal: nextGoal || null,
+      discountAmount: calculatedDiscount,
+    }
+  }, [activeCampaign, subtotal])
+
+  return {
+    qualifyingDiscount,
+    nextTierGoal,
+    activeCampaign,
+    discountAmount,
+    cartTotalForDiscount: subtotal,
+    isLoading: isCustomerLoading,
+  }
+}

package/src/cart/hooks/feature/useCartAttributes.tsx

@@ -0,0 +1,133 @@
+import Cookies from 'js-cookie'
+import { AttributeInput } from '../../../shopify/gql'
+import { useEffect, useMemo, useState } from 'react'
+import { Cart } from '../../../shopify/types/cart'
+import Decimal from 'decimal.js'
+
+export const useCartAttributes = ({
+  profile,
+  customer,
+  cart,
+}: {
+  profile: any
+  customer: any
+  cart?: Cart
+}): { attributes: AttributeInput[] } => {
+  const [currentUrl, setCurrentUrl] = useState('')
+
+  useEffect(() => {
+    setCurrentUrl(window.location.href)
+  }, [])
+
+  const userType = useMemo(() => {
+    let userInfo: any = Cookies.get('userInfo')
+    if (userInfo) {
+      userInfo = JSON.parse(userInfo)
+      let arr = typeof userInfo?.id == 'string' && userInfo?.id.split('/')
+      userInfo.setId = arr[arr.length - 1]
+    }
+    const customerInfo = userInfo || customer
+    if (!customerInfo) {
+      return 'new_user_unlogin'
+    }
+    if (customer) {
+      const { orders = {} } = customer
+      if (orders?.edges?.length === 1) {
+        return 'old_user_orders_once'
+      } else if (orders?.edges?.length > 1) {
+        return 'old_user_orders_twice'
+      }
+    }
+    return 'new_user_login'
+  }, [customer])
+
+  // 用户相关
+  const memberAttributes = useMemo(() => {
+    return [
+      {
+        key: '_token',
+        value: profile?.token, //是否登录
+      },
+      {
+        key: '_member_type',
+        value: profile?.memberType, //：0(游客)，1(普通会员)，2(付费会员)
+      },
+      {
+        key: '_user_type',
+        value: userType, // n
+      },
+      {
+        key: '_is_login',
+        value: profile?.token ? 'true' : 'false',
+      },
+    ]
+  }, [profile?.memberType, profile?.token, userType])
+
+  const functionAttributes = useMemo(() => {
+    return [
+      cart?.discountCodes && {
+        key: '_discounts_function_env',
+        value: JSON.stringify({
+          discount_code: cart?.discountCodes.map((item) => item.code),
+          user_tags: customer?.tags || [],
+        }),
+      },
+    ]
+  }, [cart])
+
+  const presellAttributes = useMemo(() => {
+    return [
+      {
+        key: '_presale',
+        value: cart?.lineItems.some(
+          (item) => item?.variant?.metafields?.presell === 'presell'
+        ),
+      },
+    ]
+  }, [cart])
+
+  const weightAttributes = useMemo(() => {
+    return [
+      {
+        key: '_weight',
+        value: cart?.lineItems.reduce<number>((acc, item) => {
+          return new Decimal(acc)
+            .plus(item.variant.weight?.value ?? 0)
+            .toNumber()
+        }, 0),
+      },
+      {
+        key: '_app_source_name',
+        value: 'dtc',
+      },
+    ]
+  }, [cart])
+
+  const trackingAttributes = useMemo(() => {
+    return [
+      {
+        key: 'utm_params',
+        value: currentUrl,
+      },
+    ]
+  }, [currentUrl])
+
+  return useMemo(
+    () => ({
+      attributes: [
+        ...memberAttributes,
+        ...functionAttributes,
+        ...presellAttributes,
+        ...weightAttributes,
+        ...trackingAttributes,
+      ].filter((item) => item?.value) as AttributeInput[],
+    }),
+    [
+      memberAttributes,
+      functionAttributes,
+      presellAttributes,
+      weightAttributes,
+      trackingAttributes,
+    ]
+  )
+}

package/src/cart/hooks/feature/useCartItemQuantityLimit.tsx

@@ -0,0 +1,59 @@
+import { useMemo } from 'react'
+
+import { LineItem, Cart } from '../../../shopify/types/cart'
+
+const DEFAULT_MIN = 1
+const DEFAULT_MAX = 999
+
+export const useCartItemQuantityLimit = ({
+  cart,
+  cartItem,
+  config,
+}: {
+  cart?: Cart
+  cartItem: LineItem
+  config: {
+    handle: Record<string, { min: number; max: number }>
+    sku: Record<string, { min: number; max: number }>
+  }
+}) => {
+  const quantityLimit = useMemo(() => {
+    if (config?.handle) {
+      // 按handle维度限制
+      const cartItemQuantityLimit =
+        config?.handle?.[cartItem?.product?.handle || '']
+
+      const sameHandleTotalQuantity =
+        cart?.lineItems.reduce((acc, item) => {
+          if (
+            item.product?.handle === cartItem?.product?.handle &&
+            item.variant.sku !== cartItem.variant.sku
+          ) {
+            acc += item.quantity
+          }
+          return acc
+        }, 0) || 0
+
+      return {
+        min: cartItemQuantityLimit?.min || DEFAULT_MIN,
+        max: cartItemQuantityLimit?.max
+          ? cartItemQuantityLimit?.max - sameHandleTotalQuantity
+          : DEFAULT_MAX,
+      }
+    } else if (config?.sku) {
+      const cartItemQuantityLimit = config?.sku?.[cartItem?.variant?.sku]
+
+      return {
+        min: cartItemQuantityLimit?.min || DEFAULT_MIN,
+        max: cartItemQuantityLimit?.max || DEFAULT_MAX,
+      }
+    }
+
+    return {
+      min: DEFAULT_MIN,
+      max: DEFAULT_MAX,
+    }
+  }, [cartItem, cart])
+
+  return quantityLimit
+}

package/src/cart/hooks/feature/useScriptAutoFreeGift.tsx

@@ -0,0 +1,256 @@
+
+import { useRouter } from 'next/router'
+import { useEffect, useMemo, useCallback, useState, useRef } from 'react'
+import Decimal from 'decimal.js'
+import Cookies from 'js-cookie'
+import { Cart, LineItem } from '../../../shopify/types/cart'
+import useSWR from 'swr'
+import { getProductsByHandles } from '../../../shopify/fetchers'
+import { Product } from '../../../shopify/types'
+import { useHeadlessContext } from '../../../context'
+
+// 兼容老script满赠  ----- 待拆解优化
+interface GiveawayProduct {
+  handle: string
+  sku: string
+}
+
+interface Breakpoint {
+  breakpoint: string
+  giveawayProducts: GiveawayProduct[]
+}
+
+interface Campaign {
+  activityAvailableQuery?: string
+  activityQroperty?: string
+  breakpoints?: Array<{
+    breakpoint: string
+    giveawayProducts: GiveawayProduct[]
+  }>
+  includeTags?: string[]
+  useTotalAmount?: boolean
+}
+export interface UseScriptAutoFreeGiftResult {
+  involvedLines: LineItem[]
+  reorder: (a: LineItem, b: LineItem) => number
+  disableCodeRemove: boolean
+  nextFreeGiftLevel: Breakpoint | null
+  freeGiftLevel: Breakpoint | null
+  involvedSubTotal: Decimal
+  giftProductsResult?: Product[]
+}
+
+// --- 3. 优化后的 Hook 主体 ---
+const useScriptAutoFreeGift = ({
+  campaign,
+  _giveaway,
+  cart,
+}: {
+  campaign: Campaign | null
+  _giveaway: string
+  cart: Cart | undefined
+}): UseScriptAutoFreeGiftResult => {
+  // const { cart } = useCartContext()
+  const { locale } = useRouter()
+
+  // --- 状态管理 ---
+  const [points_subscribe, set_points_subscribe] = useState<boolean>(false)
+  const { storefrontToken, storeDomain } = useHeadlessContext()
+
+  // 使用 useRef 缓存 giftProductsResult，确保只执行一次
+  const giftProductsCache = useRef<{
+    data: any[] | null
+    giftHandles: string[]
+  } | null>(null)
+
+  useEffect(() => {
+    if (locale === 'au') {
+      const isPointsSubscribe = Cookies.get('points_subscribe')
+      set_points_subscribe(!!isPointsSubscribe)
+    }
+  }, [locale])
+
+  // --- 计算层 ---
+  // 使用 useMemo 进行性能优化，处理所有纯计算逻辑。
+
+  const [upgrade_multiple, upgrade_value] = useMemo((): [number, number] => {
+    let upgrade_multiple = 1
+    let upgrade_value = 0
+    if (points_subscribe) {
+      upgrade_multiple = 1.2
+      upgrade_value = 40
+    }
+    cart?.lineItems?.forEach(({ customAttributes }) => {
+      customAttributes?.forEach(({ key, value }: { key: string; value: string }) => {
+        if (key === '_amount_upgrade_multiple')
+          upgrade_multiple = Number(value) || 1
+        if (key === '_amount_upgrade_value') upgrade_value = Number(value) || 0
+      })
+    })
+    return [upgrade_multiple, upgrade_value]
+  }, [cart?.lineItems, points_subscribe])
+
+  const breakpoints = useMemo((): Breakpoint[] => {
+    if (!campaign) return []
+    return (campaign.breakpoints || []).map((item) => ({
+      breakpoint: new Decimal(item.breakpoint)
+        .minus(new Decimal(upgrade_value))
+        .dividedBy(new Decimal(upgrade_multiple))
+        .toFixed(2, Decimal.ROUND_DOWN),
+      giveawayProducts: item.giveawayProducts || [],
+    }))
+  }, [campaign, upgrade_multiple, upgrade_value])
+
+  const giftHandles = useMemo(
+    (): string[] =>
+      // 使用 Set 去重，然后拼接字符串
+      [
+        ...new Set(
+          breakpoints
+            .flatMap((b) => b.giveawayProducts.map((p) => p.handle))
+            .filter(Boolean)
+        ),
+      ],
+    [breakpoints]
+  )
+
+  // 检查是否需要重新获取数据
+  const shouldFetch = useMemo(() => {
+    if (!giftHandles.length) return false
+
+    // 如果缓存存在且 handles 相同，直接使用缓存
+    if (
+      giftProductsCache.current &&
+      JSON.stringify(giftProductsCache.current.giftHandles) ===
+        JSON.stringify(giftHandles)
+    ) {
+      return false
+    }
+
+    return true
+  }, [giftHandles])
+
+  const involvedLines = useMemo((): LineItem[] => {
+    if (!campaign) return []
+    return (cart?.lineItems || []).filter((line) => {
+      const isNotGift =
+        line?.totalAmount &&
+        Number(line.totalAmount) > 0 &&
+        line.customAttributes?.every((item: { key: string; value: string }) => item.key !== _giveaway)
+      const hasCampaignTag = line.product?.tags?.some(
+        (tag) =>
+          campaign.includeTags?.includes(tag.trim()) &&
+          line.variant?.availableForSale
+      )
+      return isNotGift && hasCampaignTag
+    })
+  }, [cart?.lineItems, campaign, _giveaway])
+
+  const involvedSubTotal = useMemo((): Decimal => {
+    if (!campaign) return new Decimal(0)
+    return involvedLines.reduce((prev, item) => {
+      const amount = campaign.useTotalAmount
+        ? item.totalAmount
+        : item.subtotalAmount
+      return new Decimal(prev).plus(new Decimal(amount || 0))
+    }, new Decimal(0))
+  }, [involvedLines, campaign])
+
+  const [freeGiftLevel, nextFreeGiftLevel] = useMemo((): [
+    Breakpoint | null,
+    Breakpoint | null
+  ] => {
+    const sortedLevels = [...breakpoints].sort(
+      (a, b) => Number(b.breakpoint) - Number(a.breakpoint)
+    )
+    const levelIndex = sortedLevels.findIndex(
+      (level) =>
+        involvedSubTotal.gte(new Decimal(level.breakpoint)) &&
+        involvedLines.length > 0
+    )
+
+    if (levelIndex === -1) {
+      return [
+        null,
+        sortedLevels.length > 0 ? sortedLevels[sortedLevels.length - 1] : null,
+      ]
+    }
+
+    const currentLevel = sortedLevels[levelIndex]
+    const nextLevel = levelIndex > 0 ? sortedLevels[levelIndex - 1] : null
+    return [currentLevel, nextLevel]
+  }, [breakpoints, involvedSubTotal, involvedLines.length])
+
+  // --- 数据获取层 ---
+  const { data: giftProductsResult } = useSWR(
+    shouldFetch ? giftHandles : null,
+    async () => {
+      const res = await getProductsByHandles({
+        options: {
+          handles: giftHandles,
+        },
+        config: {
+          storefrontToken: storefrontToken,
+          storeDomain: storeDomain,
+        },
+      })
+      const result = Array.isArray(res) ? res : []
+
+      // 缓存结果
+      giftProductsCache.current = {
+        data: result,
+        giftHandles: [...giftHandles],
+      }
+
+      return result
+    }
+  )
+
+  // 使用缓存的数据或新获取的数据
+  const finalGiftProductsResult = useMemo(() => {
+    if (giftProductsCache.current && !shouldFetch) {
+      return giftProductsCache.current.data || undefined
+    }
+    return giftProductsResult
+  }, [giftProductsResult, shouldFetch])
+
+  // 使用 useCallback 创建一个稳定的排序函数，用于优化渲染。
+  // 它会根据商品类型（赠品、活动商品、普通商品）进行排序。
+  const reorder = useCallback(
+    (a: LineItem, b: LineItem): number => {
+      const getPriority = (item: LineItem): number => {
+        // 优先级 0: 赠品 (排在最后)
+        if (
+          item.customAttributes?.some(
+            (attribute: { key: string; value: string }) => attribute.key === _giveaway
+          )
+        )
+          return 0
+        // 优先级 1: 参与活动的商品 (BUG修复：应检查 product.tags)
+        if (
+          item.product?.tags?.some((tag) =>
+            campaign?.includeTags?.includes(tag)
+          )
+        )
+          return 1
+        // 优先级 2: 其他普通商品 (排在最前)
+        return 2
+      }
+      // b 的优先级减 a 的优先级，实现降序排列
+      return getPriority(b) - getPriority(a)
+    },
+    [campaign?.includeTags, _giveaway]
+  )
+
+  return {
+    involvedLines,
+    reorder,
+    disableCodeRemove: involvedLines.length > 0,
+    nextFreeGiftLevel,
+    freeGiftLevel,
+    involvedSubTotal,
+    giftProductsResult: finalGiftProductsResult,
+  }
+}
+
+export default useScriptAutoFreeGift