@anker-in/shopify-react 1.3.0-beta.0 → 1.3.0-beta.1

package/dist/hooks/index.d.mts

@@ -1,25 +1,22 @@
 import * as swr_mutation from 'swr/mutation';
 import { SWRMutationConfiguration } from 'swr/mutation';
 import * as _anker_in_shopify_sdk from '@anker-in/shopify-sdk';
-import { CartLineInput, NormalizedCart, NormalizedProduct, NormalizedProductVariant, NormalizedLineItem, UpdateCartLinesOptions, HasMetafieldsIdentifier, Media, NormalizedCollection, CollectionsConnection, NormalizedBlog, NormalizedArticle, NormalizedAttribute } from '@anker-in/shopify-sdk';
-import { U as UseAddToCartOptions, a as AddToCartInput, A as AddToCartLineItem, G as GtmParams, B as BuyNowTrackConfig, d as PlusMemberShippingMethodConfig, e as PlusMemberSettingsMetafields, D as DeliveryPlusType, f as SelectedPlusMemberVariant } from '../types-CMMWxyUF.mjs';
-export { g as DeliveryCustomData, P as PLUS_MEMBER_TYPE, b as PlusMemberMode, c as PlusMemberShippingMethodMetafields, S as ShippingMethodMode } from '../types-CMMWxyUF.mjs';
-import Decimal from 'decimal.js';
+import { CartLineInput, BuyerIdentityInput, NormalizedCart, NormalizedProduct, NormalizedProductVariant, NormalizedLineItem, UpdateCartLinesOptions, HasMetafieldsIdentifier, Media, NormalizedCollection, CollectionsConnection, NormalizedBlog, NormalizedArticle, NormalizedAttribute } from '@anker-in/shopify-sdk';
+import { h as UseAddToCartOptions, g as AddToCartInput, A as AddToCartLineItem, G as GtmParams, C as BuyNowTrackConfig, e as UseScriptAutoFreeGiftResult, m as PlusMemberShippingMethodConfig, n as PlusMemberSettingsMetafields, D as DeliveryPlusType, o as SelectedPlusMemberVariant } from '../types-CM5QrlnE.mjs';
+export { p as DeliveryCustomData, P as PLUS_MEMBER_TYPE, j as PlusMemberMode, l as PlusMemberShippingMethodMetafields, S as ScriptAutoFreeGiftConfig, k as ShippingMethodMode, U as UseAutoRemoveFreeGiftsOptions, a as UseAutoRemoveFreeGiftsResult, d as isAnyGift, c as isBuyGetGift, i as isFunctionGift, b as isScriptGift, u as useAutoRemoveFreeGifts, f as useScriptAutoFreeGift } from '../types-CM5QrlnE.mjs';
 import * as swr from 'swr';
 import swr__default, { SWRConfiguration } from 'swr';
 import * as swr__internal from 'swr/_internal';
 import * as React$1 from 'react';
 import { Dispatch, SetStateAction, PropsWithChildren, RefObject } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import 'decimal.js';
 
 interface CreateCartInput {
     /** Lines to add to the cart */
     lines?: CartLineInput[];
     /** Buyer identity for cart creation */
-    buyerIdentity?: {
-        email?: string;
-        countryCode?: string;
-    };
+    buyerIdentity?: BuyerIdentityInput;
     /** Discount codes */
     discountCodes?: string[];
     /** Custom attributes */
@@ -498,6 +495,52 @@ interface UseUpdateCartAttributesOptions {
  */
 declare function useUpdateCartAttributes({ mutate, metafieldIdentifiers, disabled, swrOptions, }: UseUpdateCartAttributesOptions): swr_mutation.SWRMutationResponse<NormalizedCart | undefined, Error, "update-cart-attributes", UpdateCartAttributesInput>;
 
+interface UpdateBuyerIdentityInput {
+    /** Cart ID (optional, will use cookie) */
+    cartId?: string;
+    /** Buyer identity information */
+    buyerIdentity: BuyerIdentityInput;
+}
+interface UseUpdateBuyerIdentityOptions {
+    /** Function to update cart state */
+    mutate: (cart: NormalizedCart | undefined) => void;
+    /** Metafield identifiers for variant and product */
+    metafieldIdentifiers?: {
+        variant: HasMetafieldsIdentifier[];
+        product: HasMetafieldsIdentifier[];
+    };
+    /** Disable the mutation */
+    disabled?: boolean;
+    /** SWR mutation configuration */
+    swrOptions?: SWRMutationConfiguration<NormalizedCart | undefined, Error, 'update-buyer-identity', UpdateBuyerIdentityInput>;
+}
+/**
+ * Hook for updating buyer identity in the cart
+ *
+ * @param options - Hook configuration options
+ * @returns SWR mutation with trigger function
+ *
+ * @example
+ * ```tsx
+ * const { trigger, isMutating } = useUpdateBuyerIdentity({
+ *   mutate: mutateCart,
+ *   metafieldIdentifiers: {
+ *     variant: [...],
+ *     product: [...]
+ *   }
+ * })
+ *
+ * await trigger({
+ *   buyerIdentity: {
+ *     email: 'customer@example.com',
+ *     countryCode: 'US',
+ *     phone: '+1234567890'
+ *   }
+ * })
+ * ```
+ */
+declare function useUpdateBuyerIdentity({ mutate, metafieldIdentifiers, disabled, swrOptions, }: UseUpdateBuyerIdentityOptions): swr_mutation.SWRMutationResponse<NormalizedCart | undefined, Error, "update-buyer-identity", UpdateBuyerIdentityInput>;
+
 interface BuyNowInput {
     /** Metafield identifiers */
     metafieldIdentifiers?: {
@@ -514,10 +557,7 @@ interface BuyNowInput {
         value: string;
     }>;
     /** Buyer identity */
-    buyerIdentity?: {
-        email?: string;
-        countryCode?: string;
-    };
+    buyerIdentity?: BuyerIdentityInput;
     /** GTM tracking parameters */
     gtmParams?: Omit<GtmParams, 'brand'>;
     /** Facebook Pixel tracking configuration */
@@ -572,43 +612,6 @@ declare function useBuyNow({ withTrack }?: UseBuyNowOptions, swrOptions?: SWRMut
  */
 declare const useCalcAutoFreeGift: (cart: any, autoFreeGiftConfig: AutoFreeGiftConfig, customer: any, lines?: AddToCartLineItem[]) => FunctionGiftResult;
 
-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;
-    requireLogin?: boolean;
-}
-interface UseScriptAutoFreeGiftResult {
-    involvedLines: NormalizedLineItem[];
-    reorder: (a: NormalizedLineItem, b: NormalizedLineItem) => number;
-    disableCodeRemove: boolean;
-    nextFreeGiftLevel: Breakpoint | null;
-    freeGiftLevel: Breakpoint | null;
-    involvedSubTotal: Decimal;
-    giftProductsResult?: NormalizedProduct[];
-}
-declare const useScriptAutoFreeGift: ({ campaign, _giveaway, cart, locale: providedLocale, lines, profile, }: {
-    campaign: Campaign | null;
-    _giveaway: string;
-    cart: NormalizedCart | undefined;
-    locale?: string;
-    lines?: AddToCartLineItem[];
-    profile?: any;
-}) => UseScriptAutoFreeGiftResult;
-
 interface UseCalcGiftsFromLinesOptions {
     /** Lines to calculate gifts from (AddToCartLineItem format) */
     lines: AddToCartLineItem[];
@@ -695,36 +698,68 @@ declare const getReferralAttributes: () => {
     key: string;
     value: any;
 }[];
+/**
+ * Detect operating system
+ */
+declare const getOperatingSystem: () => "Android" | "IOS" | "Unknown";
 /**
  * Get user type based on customer information
  */
 declare const getUserType: (customer?: any) => string;
+/**
+ * Get GA4 attributes (sync version)
+ */
+declare function getGA4Attributes(ga4Data?: {
+    clientId?: string;
+    sessionId?: string;
+} | null): Array<{
+    key: string;
+    value: string;
+}>;
+/**
+ * Get GA4 attributes (async version)
+ * Fetches GA4 data and returns formatted attributes
+ */
+declare function getGA4AttributesAsync(): Promise<Array<{
+    key: string;
+    value: string;
+}>>;
 interface GetCartAttributesProps {
     profile?: any;
     customer?: any;
     cart?: NormalizedCart;
     memberType?: string;
     currentUrl?: string;
+    appContext?: {
+        isInApp?: boolean;
+        appName?: string;
+    };
+    buyPath?: 'hasCart' | 'buyNow';
 }
 /**
- * Get cart attributes (pure function version)
+ * Get basic cart attributes (pure function version)
  */
-declare function getCartAttributes({ profile, customer, cart, memberType, currentUrl, }: GetCartAttributesProps): Array<{
+declare function getCartBasicAttributes({ profile, customer, cart, memberType, currentUrl, appContext, buyPath, }: GetCartAttributesProps): Array<{
     key: string;
-    value: any;
+    value: string;
 }>;
 /**
  * Hook to get cart attributes
  */
-declare const useCartAttributes: ({ profile, customer, cart, memberType, }: {
+declare const useCartAttributes: ({ profile, customer, cart, memberType, appContext, buyPath, }: {
     profile: any;
     customer: any;
     cart?: NormalizedCart;
     memberType?: string;
+    appContext?: {
+        isInApp?: boolean;
+        appName?: string;
+    };
+    buyPath?: "hasCart" | "buyNow";
 }) => {
     attributes: Array<{
         key: string;
-        value: any;
+        value: string;
     }>;
 };
 
@@ -749,7 +784,7 @@ declare const useCartItemQuantityLimit: ({ cart, cartItem, config, }: {
 /**
  * 更新购物车中各个 item 的折后价相关的属性
  */
-declare const useUpdateLineCodeAmountAttributes: ({ cart, mutateCart, isCartLoading, setLoadingState, metafieldIdentifiers, }: {
+declare const useUpdateLineCodeAmountAttributes: ({ cart, mutateCart, isCartLoading, setLoadingState, metafieldIdentifiers, disabled, }: {
     cart?: NormalizedCart;
     mutateCart: (cart: NormalizedCart | undefined) => void;
     isCartLoading: boolean;
@@ -758,6 +793,8 @@ declare const useUpdateLineCodeAmountAttributes: ({ cart, mutateCart, isCartLoad
         variant: HasMetafieldsIdentifier[];
         product: HasMetafieldsIdentifier[];
     };
+    /** 是否禁用更新 */
+    disabled?: boolean;
 }) => void;
 
 declare const currencyCodeMapping: Record<string, string>;
@@ -1982,4 +2019,4 @@ declare function getCachedGeoLocation(cacheKey?: string): GeoLocationData | unde
  */
 declare function clearGeoLocationCache(cacheKey?: string): void;
 
-export { type AddCartLinesInput, AddToCartInput, AddToCartLineItem, type ApplyCartCodesInput, type AutoFreeGift, type AutoFreeGiftCartLineInput, type AutoFreeGiftConfig, type AutoFreeGiftItem, type AutoFreeGiftList, type AutoFreeGiftMainProduct, type BuyNowInput, BuyRuleType, CODE_AMOUNT_KEY, CUSTOMER_ATTRIBUTE_KEY, CUSTOMER_SCRIPT_GIFT_KEY, type Config, type CreateCartInput, DeliveryPlusType, type DiscountLabel, type FormattedGift, type FunctionGiftResult, type GeoLocationData, type GetCartAttributesProps, type GiftProduct, type GiftProductItem, type GiftTier, type HasPlusMemberInCartProps, type HasPlusMemberInCartResult, type HasPlusMemberInLinesResult, type ImageMedia, type LocaleMapping, MAIN_PRODUCT_CODE, MEMBER_PRICE_ATTRIBUTE_KEY, type MainProductInfo, type NormalizedSearchResultItem, type Options, OrderBasePriceType, type OrderDiscountConfig, type OrderDiscountResult, OrderDiscountType, PlusMemberContext, type PlusMemberContextValue, PlusMemberProvider, type PlusMemberProviderProps, PlusMemberSettingsMetafields, PlusMemberShippingMethodConfig, PriceBasePriceType, type PriceDiscountConfig, PriceDiscountType, type RemoveCartCodesInput, type RemoveCartLinesInput, type RewardItem, type RuleCondition, RuleType, SCRIPT_CODE_AMOUNT_KEY, type SearchResult, type SearchResultType, type SelectedOptionsResult, SelectedPlusMemberVariant, type ShippingMethodsContext, type SiteInfo, SpendMoneyType, type TieredDiscount, type UpdateCartAttributesInput, UseAddToCartOptions, type UseAllBlogsOptions, type UseAllCollectionsOptions, type UseAllProductsOptions, type UseArticleOptions, type UseArticlesInBlogOptions, type UseArticlesOptions, type UseAutoRemovePlusMemberInCartProps, type UseAvailableDeliveryCouponResult, type UseBlogOptions, type UseBuyNowOptions, type UseCalcGiftsFromLinesOptions, type UseCalcGiftsFromLinesResult, type UseCollectionOptions, type UseCollectionsOptions, type UseExposureOptions, type UseGeoLocationOptions, type UseHasPlusMemberInLinesProps, type UseIntersectionOptions, type UsePlusMemberVariantsOptions, type UsePlusMemberVariantsResult, type UsePriceOptions, type UsePriceResult, type UseProductOptions, type UseProductsByHandlesOptions, type UseScriptAutoFreeGiftResult, type UseSearchOptions, type UseShippingMethodsOptions, type UseShippingMethodsResult, type UseSiteOptions, type UseUpdateCartAttributesOptions, type VariantItem, type VariantMedia, type VideoMedia, clearGeoLocationCache, createMockCartFromLines, currencyCodeMapping, defaultSWRMutationConfiguration, formatFunctionAutoFreeGift, formatScriptAutoFreeGift, getCachedGeoLocation, getCartAttributes, getDiscountEnvAttributeValue, getMatchedMainProductSubTotal, getQuery, getReferralAttributes, getUserType, hasPlusMemberInCart, hasPlusMemberInLines, normalizeAddToCartLines, preCheck, safeParse, useAddCartLines, useAddToCart, useAllBlogs, useAllCollections, useAllProducts, useApplyCartCodes, useArticle, useArticles, useArticlesInBlog, useAutoRemovePlusMemberInCart, useAvailableDeliveryCoupon, useBlog, useBuyNow, useCalcAutoFreeGift, useCalcGiftsFromLines, useCalcOrderDiscount, useCartAttributes, useCartItemQuantityLimit, useCollection, useCollections, useCreateCart, useExposure, useGeoLocation, useHasPlusMemberInCart, useHasPlusMemberInLines, useIntersection, usePlusMemberCheckoutCustomAttributes, usePlusMemberContext, usePlusMemberNeedAddToCart, usePlusMemberVariants, usePrice, useProduct, useProductUrl, useProductsByHandles, useRemoveCartCodes, useRemoveCartLines, useReplaceCartPlusMember, useScriptAutoFreeGift, useSearch, useSelectedOptions, useShippingMethods, useSite, useUpdateCartAttributes, useUpdateCartLines, useUpdateLineCodeAmountAttributes, useUpdateVariantQuery, useVariant, useVariantMedia };
+export { type AddCartLinesInput, AddToCartInput, AddToCartLineItem, type ApplyCartCodesInput, type AutoFreeGift, type AutoFreeGiftCartLineInput, type AutoFreeGiftConfig, type AutoFreeGiftItem, type AutoFreeGiftList, type AutoFreeGiftMainProduct, type BuyNowInput, BuyRuleType, CODE_AMOUNT_KEY, CUSTOMER_ATTRIBUTE_KEY, CUSTOMER_SCRIPT_GIFT_KEY, type Config, type CreateCartInput, DeliveryPlusType, type DiscountLabel, type FormattedGift, type FunctionGiftResult, type GeoLocationData, type GetCartAttributesProps, type GiftProduct, type GiftProductItem, type GiftTier, type HasPlusMemberInCartProps, type HasPlusMemberInCartResult, type HasPlusMemberInLinesResult, type ImageMedia, type LocaleMapping, MAIN_PRODUCT_CODE, MEMBER_PRICE_ATTRIBUTE_KEY, type MainProductInfo, type NormalizedSearchResultItem, type Options, OrderBasePriceType, type OrderDiscountConfig, type OrderDiscountResult, OrderDiscountType, PlusMemberContext, type PlusMemberContextValue, PlusMemberProvider, type PlusMemberProviderProps, PlusMemberSettingsMetafields, PlusMemberShippingMethodConfig, PriceBasePriceType, type PriceDiscountConfig, PriceDiscountType, type RemoveCartCodesInput, type RemoveCartLinesInput, type RewardItem, type RuleCondition, RuleType, SCRIPT_CODE_AMOUNT_KEY, type SearchResult, type SearchResultType, type SelectedOptionsResult, SelectedPlusMemberVariant, type ShippingMethodsContext, type SiteInfo, SpendMoneyType, type TieredDiscount, type UpdateBuyerIdentityInput, type UpdateCartAttributesInput, UseAddToCartOptions, type UseAllBlogsOptions, type UseAllCollectionsOptions, type UseAllProductsOptions, type UseArticleOptions, type UseArticlesInBlogOptions, type UseArticlesOptions, type UseAutoRemovePlusMemberInCartProps, type UseAvailableDeliveryCouponResult, type UseBlogOptions, type UseBuyNowOptions, type UseCalcGiftsFromLinesOptions, type UseCalcGiftsFromLinesResult, type UseCollectionOptions, type UseCollectionsOptions, type UseExposureOptions, type UseGeoLocationOptions, type UseHasPlusMemberInLinesProps, type UseIntersectionOptions, type UsePlusMemberVariantsOptions, type UsePlusMemberVariantsResult, type UsePriceOptions, type UsePriceResult, type UseProductOptions, type UseProductsByHandlesOptions, UseScriptAutoFreeGiftResult, type UseSearchOptions, type UseShippingMethodsOptions, type UseShippingMethodsResult, type UseSiteOptions, type UseUpdateBuyerIdentityOptions, type UseUpdateCartAttributesOptions, type VariantItem, type VariantMedia, type VideoMedia, clearGeoLocationCache, createMockCartFromLines, currencyCodeMapping, defaultSWRMutationConfiguration, formatFunctionAutoFreeGift, formatScriptAutoFreeGift, getCachedGeoLocation, getCartBasicAttributes, getDiscountEnvAttributeValue, getGA4Attributes, getGA4AttributesAsync, getMatchedMainProductSubTotal, getOperatingSystem, getQuery, getReferralAttributes, getUserType, hasPlusMemberInCart, hasPlusMemberInLines, normalizeAddToCartLines, preCheck, safeParse, useAddCartLines, useAddToCart, useAllBlogs, useAllCollections, useAllProducts, useApplyCartCodes, useArticle, useArticles, useArticlesInBlog, useAutoRemovePlusMemberInCart, useAvailableDeliveryCoupon, useBlog, useBuyNow, useCalcAutoFreeGift, useCalcGiftsFromLines, useCalcOrderDiscount, useCartAttributes, useCartItemQuantityLimit, useCollection, useCollections, useCreateCart, useExposure, useGeoLocation, useHasPlusMemberInCart, useHasPlusMemberInLines, useIntersection, usePlusMemberCheckoutCustomAttributes, usePlusMemberContext, usePlusMemberNeedAddToCart, usePlusMemberVariants, usePrice, useProduct, useProductUrl, useProductsByHandles, useRemoveCartCodes, useRemoveCartLines, useReplaceCartPlusMember, useSearch, useSelectedOptions, useShippingMethods, useSite, useUpdateBuyerIdentity, useUpdateCartAttributes, useUpdateCartLines, useUpdateLineCodeAmountAttributes, useUpdateVariantQuery, useVariant, useVariantMedia };

package/dist/hooks/index.d.ts

@@ -1,25 +1,22 @@
 import * as swr_mutation from 'swr/mutation';
 import { SWRMutationConfiguration } from 'swr/mutation';
 import * as _anker_in_shopify_sdk from '@anker-in/shopify-sdk';
-import { CartLineInput, NormalizedCart, NormalizedProduct, NormalizedProductVariant, NormalizedLineItem, UpdateCartLinesOptions, HasMetafieldsIdentifier, Media, NormalizedCollection, CollectionsConnection, NormalizedBlog, NormalizedArticle, NormalizedAttribute } from '@anker-in/shopify-sdk';
-import { U as UseAddToCartOptions, a as AddToCartInput, A as AddToCartLineItem, G as GtmParams, B as BuyNowTrackConfig, d as PlusMemberShippingMethodConfig, e as PlusMemberSettingsMetafields, D as DeliveryPlusType, f as SelectedPlusMemberVariant } from '../types-CMMWxyUF.js';
-export { g as DeliveryCustomData, P as PLUS_MEMBER_TYPE, b as PlusMemberMode, c as PlusMemberShippingMethodMetafields, S as ShippingMethodMode } from '../types-CMMWxyUF.js';
-import Decimal from 'decimal.js';
+import { CartLineInput, BuyerIdentityInput, NormalizedCart, NormalizedProduct, NormalizedProductVariant, NormalizedLineItem, UpdateCartLinesOptions, HasMetafieldsIdentifier, Media, NormalizedCollection, CollectionsConnection, NormalizedBlog, NormalizedArticle, NormalizedAttribute } from '@anker-in/shopify-sdk';
+import { h as UseAddToCartOptions, g as AddToCartInput, A as AddToCartLineItem, G as GtmParams, C as BuyNowTrackConfig, e as UseScriptAutoFreeGiftResult, m as PlusMemberShippingMethodConfig, n as PlusMemberSettingsMetafields, D as DeliveryPlusType, o as SelectedPlusMemberVariant } from '../types-CM5QrlnE.js';
+export { p as DeliveryCustomData, P as PLUS_MEMBER_TYPE, j as PlusMemberMode, l as PlusMemberShippingMethodMetafields, S as ScriptAutoFreeGiftConfig, k as ShippingMethodMode, U as UseAutoRemoveFreeGiftsOptions, a as UseAutoRemoveFreeGiftsResult, d as isAnyGift, c as isBuyGetGift, i as isFunctionGift, b as isScriptGift, u as useAutoRemoveFreeGifts, f as useScriptAutoFreeGift } from '../types-CM5QrlnE.js';
 import * as swr from 'swr';
 import swr__default, { SWRConfiguration } from 'swr';
 import * as swr__internal from 'swr/_internal';
 import * as React$1 from 'react';
 import { Dispatch, SetStateAction, PropsWithChildren, RefObject } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import 'decimal.js';
 
 interface CreateCartInput {
     /** Lines to add to the cart */
     lines?: CartLineInput[];
     /** Buyer identity for cart creation */
-    buyerIdentity?: {
-        email?: string;
-        countryCode?: string;
-    };
+    buyerIdentity?: BuyerIdentityInput;
     /** Discount codes */
     discountCodes?: string[];
     /** Custom attributes */
@@ -498,6 +495,52 @@ interface UseUpdateCartAttributesOptions {
  */
 declare function useUpdateCartAttributes({ mutate, metafieldIdentifiers, disabled, swrOptions, }: UseUpdateCartAttributesOptions): swr_mutation.SWRMutationResponse<NormalizedCart | undefined, Error, "update-cart-attributes", UpdateCartAttributesInput>;
 
+interface UpdateBuyerIdentityInput {
+    /** Cart ID (optional, will use cookie) */
+    cartId?: string;
+    /** Buyer identity information */
+    buyerIdentity: BuyerIdentityInput;
+}
+interface UseUpdateBuyerIdentityOptions {
+    /** Function to update cart state */
+    mutate: (cart: NormalizedCart | undefined) => void;
+    /** Metafield identifiers for variant and product */
+    metafieldIdentifiers?: {
+        variant: HasMetafieldsIdentifier[];
+        product: HasMetafieldsIdentifier[];
+    };
+    /** Disable the mutation */
+    disabled?: boolean;
+    /** SWR mutation configuration */
+    swrOptions?: SWRMutationConfiguration<NormalizedCart | undefined, Error, 'update-buyer-identity', UpdateBuyerIdentityInput>;
+}
+/**
+ * Hook for updating buyer identity in the cart
+ *
+ * @param options - Hook configuration options
+ * @returns SWR mutation with trigger function
+ *
+ * @example
+ * ```tsx
+ * const { trigger, isMutating } = useUpdateBuyerIdentity({
+ *   mutate: mutateCart,
+ *   metafieldIdentifiers: {
+ *     variant: [...],
+ *     product: [...]
+ *   }
+ * })
+ *
+ * await trigger({
+ *   buyerIdentity: {
+ *     email: 'customer@example.com',
+ *     countryCode: 'US',
+ *     phone: '+1234567890'
+ *   }
+ * })
+ * ```
+ */
+declare function useUpdateBuyerIdentity({ mutate, metafieldIdentifiers, disabled, swrOptions, }: UseUpdateBuyerIdentityOptions): swr_mutation.SWRMutationResponse<NormalizedCart | undefined, Error, "update-buyer-identity", UpdateBuyerIdentityInput>;
+
 interface BuyNowInput {
     /** Metafield identifiers */
     metafieldIdentifiers?: {
@@ -514,10 +557,7 @@ interface BuyNowInput {
         value: string;
     }>;
     /** Buyer identity */
-    buyerIdentity?: {
-        email?: string;
-        countryCode?: string;
-    };
+    buyerIdentity?: BuyerIdentityInput;
     /** GTM tracking parameters */
     gtmParams?: Omit<GtmParams, 'brand'>;
     /** Facebook Pixel tracking configuration */
@@ -572,43 +612,6 @@ declare function useBuyNow({ withTrack }?: UseBuyNowOptions, swrOptions?: SWRMut
  */
 declare const useCalcAutoFreeGift: (cart: any, autoFreeGiftConfig: AutoFreeGiftConfig, customer: any, lines?: AddToCartLineItem[]) => FunctionGiftResult;
 
-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;
-    requireLogin?: boolean;
-}
-interface UseScriptAutoFreeGiftResult {
-    involvedLines: NormalizedLineItem[];
-    reorder: (a: NormalizedLineItem, b: NormalizedLineItem) => number;
-    disableCodeRemove: boolean;
-    nextFreeGiftLevel: Breakpoint | null;
-    freeGiftLevel: Breakpoint | null;
-    involvedSubTotal: Decimal;
-    giftProductsResult?: NormalizedProduct[];
-}
-declare const useScriptAutoFreeGift: ({ campaign, _giveaway, cart, locale: providedLocale, lines, profile, }: {
-    campaign: Campaign | null;
-    _giveaway: string;
-    cart: NormalizedCart | undefined;
-    locale?: string;
-    lines?: AddToCartLineItem[];
-    profile?: any;
-}) => UseScriptAutoFreeGiftResult;
-
 interface UseCalcGiftsFromLinesOptions {
     /** Lines to calculate gifts from (AddToCartLineItem format) */
     lines: AddToCartLineItem[];
@@ -695,36 +698,68 @@ declare const getReferralAttributes: () => {
     key: string;
     value: any;
 }[];
+/**
+ * Detect operating system
+ */
+declare const getOperatingSystem: () => "Android" | "IOS" | "Unknown";
 /**
  * Get user type based on customer information
  */
 declare const getUserType: (customer?: any) => string;
+/**
+ * Get GA4 attributes (sync version)
+ */
+declare function getGA4Attributes(ga4Data?: {
+    clientId?: string;
+    sessionId?: string;
+} | null): Array<{
+    key: string;
+    value: string;
+}>;
+/**
+ * Get GA4 attributes (async version)
+ * Fetches GA4 data and returns formatted attributes
+ */
+declare function getGA4AttributesAsync(): Promise<Array<{
+    key: string;
+    value: string;
+}>>;
 interface GetCartAttributesProps {
     profile?: any;
     customer?: any;
     cart?: NormalizedCart;
     memberType?: string;
     currentUrl?: string;
+    appContext?: {
+        isInApp?: boolean;
+        appName?: string;
+    };
+    buyPath?: 'hasCart' | 'buyNow';
 }
 /**
- * Get cart attributes (pure function version)
+ * Get basic cart attributes (pure function version)
  */
-declare function getCartAttributes({ profile, customer, cart, memberType, currentUrl, }: GetCartAttributesProps): Array<{
+declare function getCartBasicAttributes({ profile, customer, cart, memberType, currentUrl, appContext, buyPath, }: GetCartAttributesProps): Array<{
     key: string;
-    value: any;
+    value: string;
 }>;
 /**
  * Hook to get cart attributes
  */
-declare const useCartAttributes: ({ profile, customer, cart, memberType, }: {
+declare const useCartAttributes: ({ profile, customer, cart, memberType, appContext, buyPath, }: {
     profile: any;
     customer: any;
     cart?: NormalizedCart;
     memberType?: string;
+    appContext?: {
+        isInApp?: boolean;
+        appName?: string;
+    };
+    buyPath?: "hasCart" | "buyNow";
 }) => {
     attributes: Array<{
         key: string;
-        value: any;
+        value: string;
     }>;
 };
 
@@ -749,7 +784,7 @@ declare const useCartItemQuantityLimit: ({ cart, cartItem, config, }: {
 /**
  * 更新购物车中各个 item 的折后价相关的属性
  */
-declare const useUpdateLineCodeAmountAttributes: ({ cart, mutateCart, isCartLoading, setLoadingState, metafieldIdentifiers, }: {
+declare const useUpdateLineCodeAmountAttributes: ({ cart, mutateCart, isCartLoading, setLoadingState, metafieldIdentifiers, disabled, }: {
     cart?: NormalizedCart;
     mutateCart: (cart: NormalizedCart | undefined) => void;
     isCartLoading: boolean;
@@ -758,6 +793,8 @@ declare const useUpdateLineCodeAmountAttributes: ({ cart, mutateCart, isCartLoad
         variant: HasMetafieldsIdentifier[];
         product: HasMetafieldsIdentifier[];
     };
+    /** 是否禁用更新 */
+    disabled?: boolean;
 }) => void;
 
 declare const currencyCodeMapping: Record<string, string>;
@@ -1982,4 +2019,4 @@ declare function getCachedGeoLocation(cacheKey?: string): GeoLocationData | unde
  */
 declare function clearGeoLocationCache(cacheKey?: string): void;
 
-export { type AddCartLinesInput, AddToCartInput, AddToCartLineItem, type ApplyCartCodesInput, type AutoFreeGift, type AutoFreeGiftCartLineInput, type AutoFreeGiftConfig, type AutoFreeGiftItem, type AutoFreeGiftList, type AutoFreeGiftMainProduct, type BuyNowInput, BuyRuleType, CODE_AMOUNT_KEY, CUSTOMER_ATTRIBUTE_KEY, CUSTOMER_SCRIPT_GIFT_KEY, type Config, type CreateCartInput, DeliveryPlusType, type DiscountLabel, type FormattedGift, type FunctionGiftResult, type GeoLocationData, type GetCartAttributesProps, type GiftProduct, type GiftProductItem, type GiftTier, type HasPlusMemberInCartProps, type HasPlusMemberInCartResult, type HasPlusMemberInLinesResult, type ImageMedia, type LocaleMapping, MAIN_PRODUCT_CODE, MEMBER_PRICE_ATTRIBUTE_KEY, type MainProductInfo, type NormalizedSearchResultItem, type Options, OrderBasePriceType, type OrderDiscountConfig, type OrderDiscountResult, OrderDiscountType, PlusMemberContext, type PlusMemberContextValue, PlusMemberProvider, type PlusMemberProviderProps, PlusMemberSettingsMetafields, PlusMemberShippingMethodConfig, PriceBasePriceType, type PriceDiscountConfig, PriceDiscountType, type RemoveCartCodesInput, type RemoveCartLinesInput, type RewardItem, type RuleCondition, RuleType, SCRIPT_CODE_AMOUNT_KEY, type SearchResult, type SearchResultType, type SelectedOptionsResult, SelectedPlusMemberVariant, type ShippingMethodsContext, type SiteInfo, SpendMoneyType, type TieredDiscount, type UpdateCartAttributesInput, UseAddToCartOptions, type UseAllBlogsOptions, type UseAllCollectionsOptions, type UseAllProductsOptions, type UseArticleOptions, type UseArticlesInBlogOptions, type UseArticlesOptions, type UseAutoRemovePlusMemberInCartProps, type UseAvailableDeliveryCouponResult, type UseBlogOptions, type UseBuyNowOptions, type UseCalcGiftsFromLinesOptions, type UseCalcGiftsFromLinesResult, type UseCollectionOptions, type UseCollectionsOptions, type UseExposureOptions, type UseGeoLocationOptions, type UseHasPlusMemberInLinesProps, type UseIntersectionOptions, type UsePlusMemberVariantsOptions, type UsePlusMemberVariantsResult, type UsePriceOptions, type UsePriceResult, type UseProductOptions, type UseProductsByHandlesOptions, type UseScriptAutoFreeGiftResult, type UseSearchOptions, type UseShippingMethodsOptions, type UseShippingMethodsResult, type UseSiteOptions, type UseUpdateCartAttributesOptions, type VariantItem, type VariantMedia, type VideoMedia, clearGeoLocationCache, createMockCartFromLines, currencyCodeMapping, defaultSWRMutationConfiguration, formatFunctionAutoFreeGift, formatScriptAutoFreeGift, getCachedGeoLocation, getCartAttributes, getDiscountEnvAttributeValue, getMatchedMainProductSubTotal, getQuery, getReferralAttributes, getUserType, hasPlusMemberInCart, hasPlusMemberInLines, normalizeAddToCartLines, preCheck, safeParse, useAddCartLines, useAddToCart, useAllBlogs, useAllCollections, useAllProducts, useApplyCartCodes, useArticle, useArticles, useArticlesInBlog, useAutoRemovePlusMemberInCart, useAvailableDeliveryCoupon, useBlog, useBuyNow, useCalcAutoFreeGift, useCalcGiftsFromLines, useCalcOrderDiscount, useCartAttributes, useCartItemQuantityLimit, useCollection, useCollections, useCreateCart, useExposure, useGeoLocation, useHasPlusMemberInCart, useHasPlusMemberInLines, useIntersection, usePlusMemberCheckoutCustomAttributes, usePlusMemberContext, usePlusMemberNeedAddToCart, usePlusMemberVariants, usePrice, useProduct, useProductUrl, useProductsByHandles, useRemoveCartCodes, useRemoveCartLines, useReplaceCartPlusMember, useScriptAutoFreeGift, useSearch, useSelectedOptions, useShippingMethods, useSite, useUpdateCartAttributes, useUpdateCartLines, useUpdateLineCodeAmountAttributes, useUpdateVariantQuery, useVariant, useVariantMedia };
+export { type AddCartLinesInput, AddToCartInput, AddToCartLineItem, type ApplyCartCodesInput, type AutoFreeGift, type AutoFreeGiftCartLineInput, type AutoFreeGiftConfig, type AutoFreeGiftItem, type AutoFreeGiftList, type AutoFreeGiftMainProduct, type BuyNowInput, BuyRuleType, CODE_AMOUNT_KEY, CUSTOMER_ATTRIBUTE_KEY, CUSTOMER_SCRIPT_GIFT_KEY, type Config, type CreateCartInput, DeliveryPlusType, type DiscountLabel, type FormattedGift, type FunctionGiftResult, type GeoLocationData, type GetCartAttributesProps, type GiftProduct, type GiftProductItem, type GiftTier, type HasPlusMemberInCartProps, type HasPlusMemberInCartResult, type HasPlusMemberInLinesResult, type ImageMedia, type LocaleMapping, MAIN_PRODUCT_CODE, MEMBER_PRICE_ATTRIBUTE_KEY, type MainProductInfo, type NormalizedSearchResultItem, type Options, OrderBasePriceType, type OrderDiscountConfig, type OrderDiscountResult, OrderDiscountType, PlusMemberContext, type PlusMemberContextValue, PlusMemberProvider, type PlusMemberProviderProps, PlusMemberSettingsMetafields, PlusMemberShippingMethodConfig, PriceBasePriceType, type PriceDiscountConfig, PriceDiscountType, type RemoveCartCodesInput, type RemoveCartLinesInput, type RewardItem, type RuleCondition, RuleType, SCRIPT_CODE_AMOUNT_KEY, type SearchResult, type SearchResultType, type SelectedOptionsResult, SelectedPlusMemberVariant, type ShippingMethodsContext, type SiteInfo, SpendMoneyType, type TieredDiscount, type UpdateBuyerIdentityInput, type UpdateCartAttributesInput, UseAddToCartOptions, type UseAllBlogsOptions, type UseAllCollectionsOptions, type UseAllProductsOptions, type UseArticleOptions, type UseArticlesInBlogOptions, type UseArticlesOptions, type UseAutoRemovePlusMemberInCartProps, type UseAvailableDeliveryCouponResult, type UseBlogOptions, type UseBuyNowOptions, type UseCalcGiftsFromLinesOptions, type UseCalcGiftsFromLinesResult, type UseCollectionOptions, type UseCollectionsOptions, type UseExposureOptions, type UseGeoLocationOptions, type UseHasPlusMemberInLinesProps, type UseIntersectionOptions, type UsePlusMemberVariantsOptions, type UsePlusMemberVariantsResult, type UsePriceOptions, type UsePriceResult, type UseProductOptions, type UseProductsByHandlesOptions, UseScriptAutoFreeGiftResult, type UseSearchOptions, type UseShippingMethodsOptions, type UseShippingMethodsResult, type UseSiteOptions, type UseUpdateBuyerIdentityOptions, type UseUpdateCartAttributesOptions, type VariantItem, type VariantMedia, type VideoMedia, clearGeoLocationCache, createMockCartFromLines, currencyCodeMapping, defaultSWRMutationConfiguration, formatFunctionAutoFreeGift, formatScriptAutoFreeGift, getCachedGeoLocation, getCartBasicAttributes, getDiscountEnvAttributeValue, getGA4Attributes, getGA4AttributesAsync, getMatchedMainProductSubTotal, getOperatingSystem, getQuery, getReferralAttributes, getUserType, hasPlusMemberInCart, hasPlusMemberInLines, normalizeAddToCartLines, preCheck, safeParse, useAddCartLines, useAddToCart, useAllBlogs, useAllCollections, useAllProducts, useApplyCartCodes, useArticle, useArticles, useArticlesInBlog, useAutoRemovePlusMemberInCart, useAvailableDeliveryCoupon, useBlog, useBuyNow, useCalcAutoFreeGift, useCalcGiftsFromLines, useCalcOrderDiscount, useCartAttributes, useCartItemQuantityLimit, useCollection, useCollections, useCreateCart, useExposure, useGeoLocation, useHasPlusMemberInCart, useHasPlusMemberInLines, useIntersection, usePlusMemberCheckoutCustomAttributes, usePlusMemberContext, usePlusMemberNeedAddToCart, usePlusMemberVariants, usePrice, useProduct, useProductUrl, useProductsByHandles, useRemoveCartCodes, useRemoveCartLines, useReplaceCartPlusMember, useSearch, useSelectedOptions, useShippingMethods, useSite, useUpdateBuyerIdentity, useUpdateCartAttributes, useUpdateCartLines, useUpdateLineCodeAmountAttributes, useUpdateVariantQuery, useVariant, useVariantMedia };

package/dist/index.d.mts

@@ -1,15 +1,15 @@
-export { CartContextValue, CartProvider, CartProviderProps, LoadingState, ShopifyContext, ShopifyContextValue, ShopifyProvider, ShopifyProviderProps, useCartContext, useShopify } from './provider/index.mjs';
+export { AppContext, CartContextValue, CartProvider, CartProviderProps, LoadingState, ShopifyContext, ShopifyContextValue, ShopifyProvider, ShopifyProviderProps, useCartContext, useShopify } from './provider/index.mjs';
 export { C as CookieAdapter, a as CookieOptions, P as PerformanceAdapter, R as RouterAdapter, U as UserContextAdapter } from './types-SKDHauqk.mjs';
 export { BrowserPerformanceAdapter, browserCartCookieAdapter, browserCookieAdapter } from './adapters/index.mjs';
-export { AddCartLinesInput, ApplyCartCodesInput, AutoFreeGift, AutoFreeGiftCartLineInput, AutoFreeGiftConfig, AutoFreeGiftItem, AutoFreeGiftList, AutoFreeGiftMainProduct, BuyNowInput, BuyRuleType, CODE_AMOUNT_KEY, CUSTOMER_ATTRIBUTE_KEY, CUSTOMER_SCRIPT_GIFT_KEY, Config, CreateCartInput, DiscountLabel, FormattedGift, FunctionGiftResult, GeoLocationData, GetCartAttributesProps, GiftProduct, GiftProductItem, GiftTier, HasPlusMemberInCartProps, HasPlusMemberInCartResult, HasPlusMemberInLinesResult, ImageMedia, LocaleMapping, MAIN_PRODUCT_CODE, MEMBER_PRICE_ATTRIBUTE_KEY, MainProductInfo, NormalizedSearchResultItem, Options, OrderBasePriceType, OrderDiscountConfig, OrderDiscountResult, OrderDiscountType, PlusMemberContext, PlusMemberContextValue, PlusMemberProvider, PlusMemberProviderProps, PriceBasePriceType, PriceDiscountConfig, PriceDiscountType, RemoveCartCodesInput, RemoveCartLinesInput, RewardItem, RuleCondition, RuleType, SCRIPT_CODE_AMOUNT_KEY, SearchResult, SearchResultType, SelectedOptionsResult, ShippingMethodsContext, SiteInfo, SpendMoneyType, TieredDiscount, UpdateCartAttributesInput, UseAllBlogsOptions, UseAllCollectionsOptions, UseAllProductsOptions, UseArticleOptions, UseArticlesInBlogOptions, UseArticlesOptions, UseAutoRemovePlusMemberInCartProps, UseAvailableDeliveryCouponResult, UseBlogOptions, UseBuyNowOptions, UseCalcGiftsFromLinesOptions, UseCalcGiftsFromLinesResult, UseCollectionOptions, UseCollectionsOptions, UseExposureOptions, UseGeoLocationOptions, UseHasPlusMemberInLinesProps, UseIntersectionOptions, UsePlusMemberVariantsOptions, UsePlusMemberVariantsResult, UsePriceOptions, UsePriceResult, UseProductOptions, UseProductsByHandlesOptions, UseScriptAutoFreeGiftResult, UseSearchOptions, UseShippingMethodsOptions, UseShippingMethodsResult, UseSiteOptions, UseUpdateCartAttributesOptions, VariantItem, VariantMedia, VideoMedia, clearGeoLocationCache, createMockCartFromLines, currencyCodeMapping, defaultSWRMutationConfiguration, formatFunctionAutoFreeGift, formatScriptAutoFreeGift, getCachedGeoLocation, getCartAttributes, getDiscountEnvAttributeValue, getMatchedMainProductSubTotal, getQuery, getReferralAttributes, getUserType, hasPlusMemberInCart, hasPlusMemberInLines, normalizeAddToCartLines, preCheck, safeParse, useAddCartLines, useAddToCart, useAllBlogs, useAllCollections, useAllProducts, useApplyCartCodes, useArticle, useArticles, useArticlesInBlog, useAutoRemovePlusMemberInCart, useAvailableDeliveryCoupon, useBlog, useBuyNow, useCalcAutoFreeGift, useCalcGiftsFromLines, useCalcOrderDiscount, useCartAttributes, useCartItemQuantityLimit, useCollection, useCollections, useCreateCart, useExposure, useGeoLocation, useHasPlusMemberInCart, useHasPlusMemberInLines, useIntersection, usePlusMemberCheckoutCustomAttributes, usePlusMemberContext, usePlusMemberNeedAddToCart, usePlusMemberVariants, usePrice, useProduct, useProductUrl, useProductsByHandles, useRemoveCartCodes, useRemoveCartLines, useReplaceCartPlusMember, useScriptAutoFreeGift, useSearch, useSelectedOptions, useShippingMethods, useSite, useUpdateCartAttributes, useUpdateCartLines, useUpdateLineCodeAmountAttributes, useUpdateVariantQuery, useVariant, useVariantMedia } from './hooks/index.mjs';
-export { a as AddToCartInput, A as AddToCartLineItem, B as BuyNowTrackConfig, g as DeliveryCustomData, D as DeliveryPlusType, G as GtmParams, P as PLUS_MEMBER_TYPE, b as PlusMemberMode, e as PlusMemberSettingsMetafields, d as PlusMemberShippingMethodConfig, c as PlusMemberShippingMethodMetafields, f as SelectedPlusMemberVariant, S as ShippingMethodMode, U as UseAddToCartOptions, h as gaTrack, k as trackAddToCartFBQ, t as trackAddToCartGA, i as trackBeginCheckoutGA, l as trackBuyNowFBQ, j as trackBuyNowGA } from './types-CMMWxyUF.mjs';
+export { AddCartLinesInput, ApplyCartCodesInput, AutoFreeGift, AutoFreeGiftCartLineInput, AutoFreeGiftConfig, AutoFreeGiftItem, AutoFreeGiftList, AutoFreeGiftMainProduct, BuyNowInput, BuyRuleType, CODE_AMOUNT_KEY, CUSTOMER_ATTRIBUTE_KEY, CUSTOMER_SCRIPT_GIFT_KEY, Config, CreateCartInput, DiscountLabel, FormattedGift, FunctionGiftResult, GeoLocationData, GetCartAttributesProps, GiftProduct, GiftProductItem, GiftTier, HasPlusMemberInCartProps, HasPlusMemberInCartResult, HasPlusMemberInLinesResult, ImageMedia, LocaleMapping, MAIN_PRODUCT_CODE, MEMBER_PRICE_ATTRIBUTE_KEY, MainProductInfo, NormalizedSearchResultItem, Options, OrderBasePriceType, OrderDiscountConfig, OrderDiscountResult, OrderDiscountType, PlusMemberContext, PlusMemberContextValue, PlusMemberProvider, PlusMemberProviderProps, PriceBasePriceType, PriceDiscountConfig, PriceDiscountType, RemoveCartCodesInput, RemoveCartLinesInput, RewardItem, RuleCondition, RuleType, SCRIPT_CODE_AMOUNT_KEY, SearchResult, SearchResultType, SelectedOptionsResult, ShippingMethodsContext, SiteInfo, SpendMoneyType, TieredDiscount, UpdateBuyerIdentityInput, UpdateCartAttributesInput, UseAllBlogsOptions, UseAllCollectionsOptions, UseAllProductsOptions, UseArticleOptions, UseArticlesInBlogOptions, UseArticlesOptions, UseAutoRemovePlusMemberInCartProps, UseAvailableDeliveryCouponResult, UseBlogOptions, UseBuyNowOptions, UseCalcGiftsFromLinesOptions, UseCalcGiftsFromLinesResult, UseCollectionOptions, UseCollectionsOptions, UseExposureOptions, UseGeoLocationOptions, UseHasPlusMemberInLinesProps, UseIntersectionOptions, UsePlusMemberVariantsOptions, UsePlusMemberVariantsResult, UsePriceOptions, UsePriceResult, UseProductOptions, UseProductsByHandlesOptions, UseSearchOptions, UseShippingMethodsOptions, UseShippingMethodsResult, UseSiteOptions, UseUpdateBuyerIdentityOptions, UseUpdateCartAttributesOptions, VariantItem, VariantMedia, VideoMedia, clearGeoLocationCache, createMockCartFromLines, currencyCodeMapping, defaultSWRMutationConfiguration, formatFunctionAutoFreeGift, formatScriptAutoFreeGift, getCachedGeoLocation, getCartBasicAttributes, getDiscountEnvAttributeValue, getGA4Attributes, getGA4AttributesAsync, getMatchedMainProductSubTotal, getOperatingSystem, getQuery, getReferralAttributes, getUserType, hasPlusMemberInCart, hasPlusMemberInLines, normalizeAddToCartLines, preCheck, safeParse, useAddCartLines, useAddToCart, useAllBlogs, useAllCollections, useAllProducts, useApplyCartCodes, useArticle, useArticles, useArticlesInBlog, useAutoRemovePlusMemberInCart, useAvailableDeliveryCoupon, useBlog, useBuyNow, useCalcAutoFreeGift, useCalcGiftsFromLines, useCalcOrderDiscount, useCartAttributes, useCartItemQuantityLimit, useCollection, useCollections, useCreateCart, useExposure, useGeoLocation, useHasPlusMemberInCart, useHasPlusMemberInLines, useIntersection, usePlusMemberCheckoutCustomAttributes, usePlusMemberContext, usePlusMemberNeedAddToCart, usePlusMemberVariants, usePrice, useProduct, useProductUrl, useProductsByHandles, useRemoveCartCodes, useRemoveCartLines, useReplaceCartPlusMember, useSearch, useSelectedOptions, useShippingMethods, useSite, useUpdateBuyerIdentity, useUpdateCartAttributes, useUpdateCartLines, useUpdateLineCodeAmountAttributes, useUpdateVariantQuery, useVariant, useVariantMedia } from './hooks/index.mjs';
+export { g as AddToCartInput, A as AddToCartLineItem, C as BuyNowTrackConfig, p as DeliveryCustomData, D as DeliveryPlusType, v as GA4Data, G as GtmParams, P as PLUS_MEMBER_TYPE, j as PlusMemberMode, n as PlusMemberSettingsMetafields, m as PlusMemberShippingMethodConfig, l as PlusMemberShippingMethodMetafields, S as ScriptAutoFreeGiftConfig, o as SelectedPlusMemberVariant, k as ShippingMethodMode, h as UseAddToCartOptions, U as UseAutoRemoveFreeGiftsOptions, a as UseAutoRemoveFreeGiftsResult, e as UseScriptAutoFreeGiftResult, q as gaTrack, x as getGA4ClientId, z as getGA4Data, y as getGA4SessionId, d as isAnyGift, c as isBuyGetGift, i as isFunctionGift, b as isScriptGift, B as trackAddToCartFBQ, t as trackAddToCartGA, r as trackBeginCheckoutGA, E as trackBuyNowFBQ, s as trackBuyNowGA, u as useAutoRemoveFreeGifts, f as useScriptAutoFreeGift, w as waitForGtagReady } from './types-CM5QrlnE.mjs';
 export * from '@anker-in/shopify-sdk';
 import 'react';
 import 'react/jsx-runtime';
 import 'swr';
 import 'swr/mutation';
-import 'decimal.js';
 import 'swr/_internal';
+import 'decimal.js';
 
 /**
  * Utility types for TypeScript

package/dist/index.d.ts

@@ -1,15 +1,15 @@
-export { CartContextValue, CartProvider, CartProviderProps, LoadingState, ShopifyContext, ShopifyContextValue, ShopifyProvider, ShopifyProviderProps, useCartContext, useShopify } from './provider/index.js';
+export { AppContext, CartContextValue, CartProvider, CartProviderProps, LoadingState, ShopifyContext, ShopifyContextValue, ShopifyProvider, ShopifyProviderProps, useCartContext, useShopify } from './provider/index.js';
 export { C as CookieAdapter, a as CookieOptions, P as PerformanceAdapter, R as RouterAdapter, U as UserContextAdapter } from './types-SKDHauqk.js';
 export { BrowserPerformanceAdapter, browserCartCookieAdapter, browserCookieAdapter } from './adapters/index.js';
-export { AddCartLinesInput, ApplyCartCodesInput, AutoFreeGift, AutoFreeGiftCartLineInput, AutoFreeGiftConfig, AutoFreeGiftItem, AutoFreeGiftList, AutoFreeGiftMainProduct, BuyNowInput, BuyRuleType, CODE_AMOUNT_KEY, CUSTOMER_ATTRIBUTE_KEY, CUSTOMER_SCRIPT_GIFT_KEY, Config, CreateCartInput, DiscountLabel, FormattedGift, FunctionGiftResult, GeoLocationData, GetCartAttributesProps, GiftProduct, GiftProductItem, GiftTier, HasPlusMemberInCartProps, HasPlusMemberInCartResult, HasPlusMemberInLinesResult, ImageMedia, LocaleMapping, MAIN_PRODUCT_CODE, MEMBER_PRICE_ATTRIBUTE_KEY, MainProductInfo, NormalizedSearchResultItem, Options, OrderBasePriceType, OrderDiscountConfig, OrderDiscountResult, OrderDiscountType, PlusMemberContext, PlusMemberContextValue, PlusMemberProvider, PlusMemberProviderProps, PriceBasePriceType, PriceDiscountConfig, PriceDiscountType, RemoveCartCodesInput, RemoveCartLinesInput, RewardItem, RuleCondition, RuleType, SCRIPT_CODE_AMOUNT_KEY, SearchResult, SearchResultType, SelectedOptionsResult, ShippingMethodsContext, SiteInfo, SpendMoneyType, TieredDiscount, UpdateCartAttributesInput, UseAllBlogsOptions, UseAllCollectionsOptions, UseAllProductsOptions, UseArticleOptions, UseArticlesInBlogOptions, UseArticlesOptions, UseAutoRemovePlusMemberInCartProps, UseAvailableDeliveryCouponResult, UseBlogOptions, UseBuyNowOptions, UseCalcGiftsFromLinesOptions, UseCalcGiftsFromLinesResult, UseCollectionOptions, UseCollectionsOptions, UseExposureOptions, UseGeoLocationOptions, UseHasPlusMemberInLinesProps, UseIntersectionOptions, UsePlusMemberVariantsOptions, UsePlusMemberVariantsResult, UsePriceOptions, UsePriceResult, UseProductOptions, UseProductsByHandlesOptions, UseScriptAutoFreeGiftResult, UseSearchOptions, UseShippingMethodsOptions, UseShippingMethodsResult, UseSiteOptions, UseUpdateCartAttributesOptions, VariantItem, VariantMedia, VideoMedia, clearGeoLocationCache, createMockCartFromLines, currencyCodeMapping, defaultSWRMutationConfiguration, formatFunctionAutoFreeGift, formatScriptAutoFreeGift, getCachedGeoLocation, getCartAttributes, getDiscountEnvAttributeValue, getMatchedMainProductSubTotal, getQuery, getReferralAttributes, getUserType, hasPlusMemberInCart, hasPlusMemberInLines, normalizeAddToCartLines, preCheck, safeParse, useAddCartLines, useAddToCart, useAllBlogs, useAllCollections, useAllProducts, useApplyCartCodes, useArticle, useArticles, useArticlesInBlog, useAutoRemovePlusMemberInCart, useAvailableDeliveryCoupon, useBlog, useBuyNow, useCalcAutoFreeGift, useCalcGiftsFromLines, useCalcOrderDiscount, useCartAttributes, useCartItemQuantityLimit, useCollection, useCollections, useCreateCart, useExposure, useGeoLocation, useHasPlusMemberInCart, useHasPlusMemberInLines, useIntersection, usePlusMemberCheckoutCustomAttributes, usePlusMemberContext, usePlusMemberNeedAddToCart, usePlusMemberVariants, usePrice, useProduct, useProductUrl, useProductsByHandles, useRemoveCartCodes, useRemoveCartLines, useReplaceCartPlusMember, useScriptAutoFreeGift, useSearch, useSelectedOptions, useShippingMethods, useSite, useUpdateCartAttributes, useUpdateCartLines, useUpdateLineCodeAmountAttributes, useUpdateVariantQuery, useVariant, useVariantMedia } from './hooks/index.js';
-export { a as AddToCartInput, A as AddToCartLineItem, B as BuyNowTrackConfig, g as DeliveryCustomData, D as DeliveryPlusType, G as GtmParams, P as PLUS_MEMBER_TYPE, b as PlusMemberMode, e as PlusMemberSettingsMetafields, d as PlusMemberShippingMethodConfig, c as PlusMemberShippingMethodMetafields, f as SelectedPlusMemberVariant, S as ShippingMethodMode, U as UseAddToCartOptions, h as gaTrack, k as trackAddToCartFBQ, t as trackAddToCartGA, i as trackBeginCheckoutGA, l as trackBuyNowFBQ, j as trackBuyNowGA } from './types-CMMWxyUF.js';
+export { AddCartLinesInput, ApplyCartCodesInput, AutoFreeGift, AutoFreeGiftCartLineInput, AutoFreeGiftConfig, AutoFreeGiftItem, AutoFreeGiftList, AutoFreeGiftMainProduct, BuyNowInput, BuyRuleType, CODE_AMOUNT_KEY, CUSTOMER_ATTRIBUTE_KEY, CUSTOMER_SCRIPT_GIFT_KEY, Config, CreateCartInput, DiscountLabel, FormattedGift, FunctionGiftResult, GeoLocationData, GetCartAttributesProps, GiftProduct, GiftProductItem, GiftTier, HasPlusMemberInCartProps, HasPlusMemberInCartResult, HasPlusMemberInLinesResult, ImageMedia, LocaleMapping, MAIN_PRODUCT_CODE, MEMBER_PRICE_ATTRIBUTE_KEY, MainProductInfo, NormalizedSearchResultItem, Options, OrderBasePriceType, OrderDiscountConfig, OrderDiscountResult, OrderDiscountType, PlusMemberContext, PlusMemberContextValue, PlusMemberProvider, PlusMemberProviderProps, PriceBasePriceType, PriceDiscountConfig, PriceDiscountType, RemoveCartCodesInput, RemoveCartLinesInput, RewardItem, RuleCondition, RuleType, SCRIPT_CODE_AMOUNT_KEY, SearchResult, SearchResultType, SelectedOptionsResult, ShippingMethodsContext, SiteInfo, SpendMoneyType, TieredDiscount, UpdateBuyerIdentityInput, UpdateCartAttributesInput, UseAllBlogsOptions, UseAllCollectionsOptions, UseAllProductsOptions, UseArticleOptions, UseArticlesInBlogOptions, UseArticlesOptions, UseAutoRemovePlusMemberInCartProps, UseAvailableDeliveryCouponResult, UseBlogOptions, UseBuyNowOptions, UseCalcGiftsFromLinesOptions, UseCalcGiftsFromLinesResult, UseCollectionOptions, UseCollectionsOptions, UseExposureOptions, UseGeoLocationOptions, UseHasPlusMemberInLinesProps, UseIntersectionOptions, UsePlusMemberVariantsOptions, UsePlusMemberVariantsResult, UsePriceOptions, UsePriceResult, UseProductOptions, UseProductsByHandlesOptions, UseSearchOptions, UseShippingMethodsOptions, UseShippingMethodsResult, UseSiteOptions, UseUpdateBuyerIdentityOptions, UseUpdateCartAttributesOptions, VariantItem, VariantMedia, VideoMedia, clearGeoLocationCache, createMockCartFromLines, currencyCodeMapping, defaultSWRMutationConfiguration, formatFunctionAutoFreeGift, formatScriptAutoFreeGift, getCachedGeoLocation, getCartBasicAttributes, getDiscountEnvAttributeValue, getGA4Attributes, getGA4AttributesAsync, getMatchedMainProductSubTotal, getOperatingSystem, getQuery, getReferralAttributes, getUserType, hasPlusMemberInCart, hasPlusMemberInLines, normalizeAddToCartLines, preCheck, safeParse, useAddCartLines, useAddToCart, useAllBlogs, useAllCollections, useAllProducts, useApplyCartCodes, useArticle, useArticles, useArticlesInBlog, useAutoRemovePlusMemberInCart, useAvailableDeliveryCoupon, useBlog, useBuyNow, useCalcAutoFreeGift, useCalcGiftsFromLines, useCalcOrderDiscount, useCartAttributes, useCartItemQuantityLimit, useCollection, useCollections, useCreateCart, useExposure, useGeoLocation, useHasPlusMemberInCart, useHasPlusMemberInLines, useIntersection, usePlusMemberCheckoutCustomAttributes, usePlusMemberContext, usePlusMemberNeedAddToCart, usePlusMemberVariants, usePrice, useProduct, useProductUrl, useProductsByHandles, useRemoveCartCodes, useRemoveCartLines, useReplaceCartPlusMember, useSearch, useSelectedOptions, useShippingMethods, useSite, useUpdateBuyerIdentity, useUpdateCartAttributes, useUpdateCartLines, useUpdateLineCodeAmountAttributes, useUpdateVariantQuery, useVariant, useVariantMedia } from './hooks/index.js';
+export { g as AddToCartInput, A as AddToCartLineItem, C as BuyNowTrackConfig, p as DeliveryCustomData, D as DeliveryPlusType, v as GA4Data, G as GtmParams, P as PLUS_MEMBER_TYPE, j as PlusMemberMode, n as PlusMemberSettingsMetafields, m as PlusMemberShippingMethodConfig, l as PlusMemberShippingMethodMetafields, S as ScriptAutoFreeGiftConfig, o as SelectedPlusMemberVariant, k as ShippingMethodMode, h as UseAddToCartOptions, U as UseAutoRemoveFreeGiftsOptions, a as UseAutoRemoveFreeGiftsResult, e as UseScriptAutoFreeGiftResult, q as gaTrack, x as getGA4ClientId, z as getGA4Data, y as getGA4SessionId, d as isAnyGift, c as isBuyGetGift, i as isFunctionGift, b as isScriptGift, B as trackAddToCartFBQ, t as trackAddToCartGA, r as trackBeginCheckoutGA, E as trackBuyNowFBQ, s as trackBuyNowGA, u as useAutoRemoveFreeGifts, f as useScriptAutoFreeGift, w as waitForGtagReady } from './types-CM5QrlnE.js';
 export * from '@anker-in/shopify-sdk';
 import 'react';
 import 'react/jsx-runtime';
 import 'swr';
 import 'swr/mutation';
-import 'decimal.js';
 import 'swr/_internal';
+import 'decimal.js';
 
 /**
  * Utility types for TypeScript

package/dist/provider/index.d.mts

@@ -4,7 +4,8 @@ import { ShopifyClient, ShopifyConfig, CartCookieAdapter, NormalizedCart, Attrib
 import { C as CookieAdapter, R as RouterAdapter, U as UserContextAdapter, P as PerformanceAdapter } from '../types-SKDHauqk.mjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { SWRConfiguration } from 'swr';
-import { e as PlusMemberSettingsMetafields } from '../types-CMMWxyUF.mjs';
+import { S as ScriptAutoFreeGiftConfig, n as PlusMemberSettingsMetafields, U as UseAutoRemoveFreeGiftsOptions } from '../types-CM5QrlnE.mjs';
+import 'decimal.js';
 
 interface ShopifyContextValue {
     client: ShopifyClient;
@@ -48,6 +49,12 @@ type LoadingState = {
     listingAutoCodeApplying: boolean;
     userCodeApplying: boolean;
 };
+type AppContext = {
+    /** Whether running in app */
+    isInApp?: boolean;
+    /** App name */
+    appName?: string;
+};
 interface CartContextValue {
     /** Current cart data */
     cart: NormalizedCart | undefined;
@@ -91,10 +98,10 @@ interface CartContextValue {
     calculatedAutoFreeGift?: any;
     /** Gifts that need to be added to cart */
     giftNeedAddToCartLines: any[];
-    /** Auto free gift config */
-    autoFreeGiftConfig?: any;
-    /** Gradient gifts config */
-    gradientGiftsConfig?: any;
+    /** Function auto free gift config */
+    functionAutoFreeGiftConfig?: any;
+    /** Script auto free gift config */
+    scriptAutoFreeGiftConfig?: ScriptAutoFreeGiftConfig;
     /** Metafield identifiers */
     metafieldIdentifiers?: {
         variant: HasMetafieldsIdentifier[];
@@ -106,17 +113,19 @@ interface CartContextValue {
     customer?: any;
     /** Plus member settings */
     memberSetting?: PlusMemberSettingsMetafields;
+    /** App context */
+    appContext?: AppContext;
+    /** Auto remove free gifts options */
+    autoRemoveFreeGiftsOptions?: UseAutoRemoveFreeGiftsOptions;
 }
 interface CartProviderProps {
     children: React__default.ReactNode;
     /** SWR configuration options */
     swrOptions?: SWRConfiguration<NormalizedCart | undefined, Error>;
-    /** Auto free gift configuration */
-    autoFreeGiftConfig?: any;
-    /** Gradient gifts configuration (for script gifts) */
-    gradientGiftsConfig?: any;
-    /** Function gift configuration */
-    fnGiftConf?: any;
+    /** Function auto free gift configuration */
+    functionAutoFreeGiftConfig?: any;
+    /** Script auto free gift configuration */
+    scriptAutoFreeGiftConfig?: ScriptAutoFreeGiftConfig;
     /** User profile */
     profile?: any;
     /** Customer data */
@@ -130,6 +139,10 @@ interface CartProviderProps {
     };
     /** Plus member settings */
     memberSetting?: PlusMemberSettingsMetafields;
+    /** App context */
+    appContext?: AppContext;
+    /** 是否禁用自动更新 line item 的 code amount attributes，默认为 false */
+    disableUpdateLineCodeAmountAttributes?: boolean;
 }
 /**
  * Cart Provider Component
@@ -141,7 +154,8 @@ interface CartProviderProps {
  * <ShopifyProvider {...config}>
  *   <CartProvider
  *     locale="us"
- *     autoFreeGiftConfig={config}
+ *     functionAutoFreeGiftConfig={functionConfig}
+ *     scriptAutoFreeGiftConfig={scriptConfig}
  *     profile={profile}
  *     customer={customer}
  *   >
@@ -150,7 +164,7 @@ interface CartProviderProps {
  * </ShopifyProvider>
  * ```
  */
-declare function CartProvider({ children, autoFreeGiftConfig, gradientGiftsConfig, profile, customer, locale, metafieldIdentifiers, memberSetting, }: CartProviderProps): react_jsx_runtime.JSX.Element;
+declare function CartProvider({ children, functionAutoFreeGiftConfig, scriptAutoFreeGiftConfig, profile, customer, locale, metafieldIdentifiers, memberSetting, appContext, disableUpdateLineCodeAmountAttributes, }: CartProviderProps): react_jsx_runtime.JSX.Element;
 /**
  * Hook to access cart context
  *
@@ -175,4 +189,4 @@ declare function useCartContext(options: {
     optional: true;
 }): CartContextValue | null;
 
-export { type CartContextValue, CartProvider, type CartProviderProps, type LoadingState, ShopifyContext, type ShopifyContextValue, ShopifyProvider, type ShopifyProviderProps, useCartContext, useShopify };
+export { type AppContext, type CartContextValue, CartProvider, type CartProviderProps, type LoadingState, ShopifyContext, type ShopifyContextValue, ShopifyProvider, type ShopifyProviderProps, useCartContext, useShopify };

package/dist/provider/index.d.ts

@@ -4,7 +4,8 @@ import { ShopifyClient, ShopifyConfig, CartCookieAdapter, NormalizedCart, Attrib
 import { C as CookieAdapter, R as RouterAdapter, U as UserContextAdapter, P as PerformanceAdapter } from '../types-SKDHauqk.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { SWRConfiguration } from 'swr';
-import { e as PlusMemberSettingsMetafields } from '../types-CMMWxyUF.js';
+import { S as ScriptAutoFreeGiftConfig, n as PlusMemberSettingsMetafields, U as UseAutoRemoveFreeGiftsOptions } from '../types-CM5QrlnE.js';
+import 'decimal.js';
 
 interface ShopifyContextValue {
     client: ShopifyClient;
@@ -48,6 +49,12 @@ type LoadingState = {
     listingAutoCodeApplying: boolean;
     userCodeApplying: boolean;
 };
+type AppContext = {
+    /** Whether running in app */
+    isInApp?: boolean;
+    /** App name */
+    appName?: string;
+};
 interface CartContextValue {
     /** Current cart data */
     cart: NormalizedCart | undefined;
@@ -91,10 +98,10 @@ interface CartContextValue {
     calculatedAutoFreeGift?: any;
     /** Gifts that need to be added to cart */
     giftNeedAddToCartLines: any[];
-    /** Auto free gift config */
-    autoFreeGiftConfig?: any;
-    /** Gradient gifts config */
-    gradientGiftsConfig?: any;
+    /** Function auto free gift config */
+    functionAutoFreeGiftConfig?: any;
+    /** Script auto free gift config */
+    scriptAutoFreeGiftConfig?: ScriptAutoFreeGiftConfig;
     /** Metafield identifiers */
     metafieldIdentifiers?: {
         variant: HasMetafieldsIdentifier[];
@@ -106,17 +113,19 @@ interface CartContextValue {
     customer?: any;
     /** Plus member settings */
     memberSetting?: PlusMemberSettingsMetafields;
+    /** App context */
+    appContext?: AppContext;
+    /** Auto remove free gifts options */
+    autoRemoveFreeGiftsOptions?: UseAutoRemoveFreeGiftsOptions;
 }
 interface CartProviderProps {
     children: React__default.ReactNode;
     /** SWR configuration options */
     swrOptions?: SWRConfiguration<NormalizedCart | undefined, Error>;
-    /** Auto free gift configuration */
-    autoFreeGiftConfig?: any;
-    /** Gradient gifts configuration (for script gifts) */
-    gradientGiftsConfig?: any;
-    /** Function gift configuration */
-    fnGiftConf?: any;
+    /** Function auto free gift configuration */
+    functionAutoFreeGiftConfig?: any;
+    /** Script auto free gift configuration */
+    scriptAutoFreeGiftConfig?: ScriptAutoFreeGiftConfig;
     /** User profile */
     profile?: any;
     /** Customer data */
@@ -130,6 +139,10 @@ interface CartProviderProps {
     };
     /** Plus member settings */
     memberSetting?: PlusMemberSettingsMetafields;
+    /** App context */
+    appContext?: AppContext;
+    /** 是否禁用自动更新 line item 的 code amount attributes，默认为 false */
+    disableUpdateLineCodeAmountAttributes?: boolean;
 }
 /**
  * Cart Provider Component
@@ -141,7 +154,8 @@ interface CartProviderProps {
  * <ShopifyProvider {...config}>
  *   <CartProvider
  *     locale="us"
- *     autoFreeGiftConfig={config}
+ *     functionAutoFreeGiftConfig={functionConfig}
+ *     scriptAutoFreeGiftConfig={scriptConfig}
  *     profile={profile}
  *     customer={customer}
  *   >
@@ -150,7 +164,7 @@ interface CartProviderProps {
  * </ShopifyProvider>
  * ```
  */
-declare function CartProvider({ children, autoFreeGiftConfig, gradientGiftsConfig, profile, customer, locale, metafieldIdentifiers, memberSetting, }: CartProviderProps): react_jsx_runtime.JSX.Element;
+declare function CartProvider({ children, functionAutoFreeGiftConfig, scriptAutoFreeGiftConfig, profile, customer, locale, metafieldIdentifiers, memberSetting, appContext, disableUpdateLineCodeAmountAttributes, }: CartProviderProps): react_jsx_runtime.JSX.Element;
 /**
  * Hook to access cart context
  *
@@ -175,4 +189,4 @@ declare function useCartContext(options: {
     optional: true;
 }): CartContextValue | null;
 
-export { type CartContextValue, CartProvider, type CartProviderProps, type LoadingState, ShopifyContext, type ShopifyContextValue, ShopifyProvider, type ShopifyProviderProps, useCartContext, useShopify };
+export { type AppContext, type CartContextValue, CartProvider, type CartProviderProps, type LoadingState, ShopifyContext, type ShopifyContextValue, ShopifyProvider, type ShopifyProviderProps, useCartContext, useShopify };

package/dist/{types-CMMWxyUF.d.mts → types-CM5QrlnE.d.mts}

@@ -1,4 +1,5 @@
-import { NormalizedProductVariant, NormalizedProduct, MoneyV2, NormalizedCart } from '@anker-in/shopify-sdk';
+import { NormalizedLineItem, MoneyV2, NormalizedProductVariant, NormalizedProduct, BuyerIdentityInput, NormalizedCart } from '@anker-in/shopify-sdk';
+import Decimal from 'decimal.js';
 
 /**
  * Tracking Types
@@ -18,19 +19,30 @@ interface GtmParams {
 
 declare global {
     interface Window {
-        dataLayer?: any[];
-        gtag?: (...args: any) => void;
+        dataLayer?: Array<Record<string, unknown>>;
+        gtag?: {
+            (command: 'config', targetId: string, config?: Record<string, unknown>): void;
+            (command: 'set', config: Record<string, unknown>): void;
+            (command: 'event', eventName: string, eventParams?: Record<string, unknown>): void;
+            (command: 'get', targetId: string, fieldName: string, callback?: (value: string) => void): void;
+            (command: 'consent', consentArg: string, consentParams?: Record<string, unknown>): void;
+        };
     }
 }
 /**
  * Push event to GA4 dataLayer
  */
-declare const gaTrack: (data: any) => void;
+declare const gaTrack: (data: Record<string, unknown>) => void;
 /**
  * Track add to cart event in GA4
  */
 declare const trackAddToCartGA: ({ lineItems, gtmParams, }: {
-    lineItems: AddToCartLineItem[];
+    lineItems: Array<NormalizedLineItem & {
+        finalPrice?: MoneyV2;
+        gtmParams?: {
+            item_category_id?: number | string;
+        };
+    }>;
     gtmParams?: GtmParams;
 }) => void;
 /**
@@ -46,26 +58,59 @@ declare const trackBeginCheckoutGA: ({ lineItems, currencyCode, gtmParams, }: {
  * This triggers begin_checkout event for buy now actions
  */
 declare const trackBuyNowGA: ({ lineItems, gtmParams, }: {
-    lineItems: AddToCartLineItem[];
+    lineItems: Array<NormalizedLineItem & {
+        gtmParams?: {
+            item_category_id?: number | string;
+        };
+    }>;
     gtmParams?: GtmParams;
 }) => void;
+/**
+ * GA4 Data
+ */
+interface GA4Data {
+    clientId: string;
+    sessionId: string;
+}
+/**
+ * Wait for gtag to be ready
+ */
+declare function waitForGtagReady(timeout?: number): Promise<void>;
+/**
+ * Get GA4 client ID
+ */
+declare const getGA4ClientId: (measurementId?: string) => Promise<string>;
+/**
+ * Get GA4 session ID
+ */
+declare const getGA4SessionId: (measurementId?: string) => Promise<string>;
+/**
+ * Get GA4 data (client ID and session ID)
+ */
+declare const getGA4Data: (measurementId?: string) => Promise<GA4Data>;
 
 /**
  * Facebook Pixel Tracking
  * FBQ event tracking utilities
  */
 
+type FbqCommand = 'track' | 'trackCustom' | 'trackSingle' | 'trackCustom';
+type FbqEventName = 'AddToCart' | 'Purchase' | 'InitiateCheckout' | 'ViewContent' | string;
+type FbqEventParams = Record<string, unknown>;
 declare global {
     interface Window {
-        fbq?: (...args: any[]) => void;
-        gtag?: (...args: any[]) => void;
+        fbq?: (command: FbqCommand, eventName: FbqEventName, params?: FbqEventParams) => void;
     }
 }
 /**
  * Track add to cart event in Facebook Pixel
  */
-declare const trackAddToCartFBQ: ({ lineItems }: {
-    lineItems: AddToCartLineItem[];
+declare const trackAddToCartFBQ: ({ lineItems, }: {
+    lineItems: Array<NormalizedLineItem & {
+        gtmParams?: {
+            item_category_id?: number | string;
+        };
+    }>;
 }) => void;
 /**
  * Configuration for Buy Now tracking events
@@ -102,6 +147,9 @@ type AddToCartLineItem = {
         code: string;
         amount: number;
     };
+    gtmParams?: {
+        item_category_id?: number | string;
+    };
 };
 interface AddToCartInput {
     /** Lines to add */
@@ -118,10 +166,7 @@ interface AddToCartInput {
     /** 全量更新 codes，默认是追加 */
     replaceExistingCodes?: boolean;
     /** Buyer identity for cart creation */
-    buyerIdentity?: {
-        email?: string;
-        countryCode?: string;
-    };
+    buyerIdentity?: BuyerIdentityInput;
     /** GTM tracking parameters */
     gtmParams?: Omit<GtmParams, 'brand'>;
     /** Force create new cart */
@@ -134,6 +179,131 @@ interface UseAddToCartOptions {
     withTrack?: boolean;
 }
 
+/**
+ * Auto Remove Free Gifts Hook
+ *
+ * Automatically removes Function and Script free gifts from cart on page load.
+ * This ensures gifts are only added at checkout time, not kept in cart permanently.
+ *
+ * Based on storefront-anker production implementation.
+ */
+
+interface UseAutoRemoveFreeGiftsOptions {
+    /**
+     * Whether to remove Function gifts (with _discounts_function_env attribute)
+     * @default true
+     */
+    removeFunctionGifts?: boolean;
+    /**
+     * Whether to remove Script gifts (with _giveaway_gradient_gifts attribute)
+     * @default true
+     */
+    removeScriptGifts?: boolean;
+    /**
+     * Custom function to identify additional gift line items
+     * @param line - Line item to check
+     * @returns true if line item is a gift that should be removed
+     */
+    isGiftLineItem?: (line: NormalizedLineItem) => boolean;
+}
+interface UseAutoRemoveFreeGiftsResult {
+    /** Whether removal is in progress */
+    isRemoving: boolean;
+}
+/**
+ * Automatically removes free gifts from cart on initialization
+ *
+ * Function满赠和Script满赠的赠品都会被添加到购物车，需要在返回购物车页面时自动删除。
+ * - Function 赠品：带 _discounts_function_env 属性
+ * - Script 赠品：带 _giveaway_gradient_gifts 属性
+ *
+ * @example
+ * ```tsx
+ * function CartPage() {
+ *   // Auto-remove all gifts on page load
+ *   useAutoRemoveFreeGifts()
+ *
+ *   return <Cart />
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Only remove Function gifts, keep Script gifts
+ * useAutoRemoveFreeGifts({
+ *   removeFunctionGifts: true,
+ *   removeScriptGifts: false
+ * })
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Custom gift identification
+ * useAutoRemoveFreeGifts({
+ *   isGiftLineItem: (line) => {
+ *     // Also remove other campaign gifts
+ *     return line.customAttributes?.some(
+ *       attr => attr.key === '_giveaway_summer_campaign'
+ *     )
+ *   }
+ * })
+ * ```
+ */
+declare function useAutoRemoveFreeGifts(options?: UseAutoRemoveFreeGiftsOptions): UseAutoRemoveFreeGiftsResult;
+/**
+ * Helper function to check if a line item is a Function gift
+ */
+declare function isFunctionGift(line: NormalizedLineItem): boolean;
+/**
+ * Helper function to check if a line item is a Script gift
+ */
+declare function isScriptGift(line: NormalizedLineItem): boolean;
+/**
+ * Helper function to check if a line item is a buy-get gift (买赠)
+ */
+declare function isBuyGetGift(line: NormalizedLineItem): boolean;
+/**
+ * Helper function to check if a line item is any type of gift
+ */
+declare function isAnyGift(line: NormalizedLineItem): boolean;
+
+interface GiveawayProduct {
+    handle: string;
+    sku: string;
+}
+interface Breakpoint {
+    breakpoint: string;
+    giveawayProducts: GiveawayProduct[];
+}
+interface ScriptAutoFreeGiftConfig {
+    activityAvailableQuery?: string;
+    activityQroperty?: string;
+    breakpoints?: Array<{
+        breakpoint: string;
+        giveawayProducts: GiveawayProduct[];
+    }>;
+    includeTags?: string[];
+    useTotalAmount?: boolean;
+    requireLogin?: boolean;
+}
+interface UseScriptAutoFreeGiftResult {
+    involvedLines: NormalizedLineItem[];
+    reorder: (a: NormalizedLineItem, b: NormalizedLineItem) => number;
+    disableCodeRemove: boolean;
+    nextFreeGiftLevel: Breakpoint | null;
+    freeGiftLevel: Breakpoint | null;
+    involvedSubTotal: Decimal;
+    giftProductsResult?: NormalizedProduct[];
+}
+declare const useScriptAutoFreeGift: ({ campaign, _giveaway, cart, locale: providedLocale, lines, profile, }: {
+    campaign?: ScriptAutoFreeGiftConfig;
+    _giveaway: string;
+    cart: NormalizedCart | undefined;
+    locale?: string;
+    lines?: AddToCartLineItem[];
+    profile?: any;
+}) => UseScriptAutoFreeGiftResult;
+
 /**
  * Plus Member Types
  * Type definitions for Plus Member functionality
@@ -510,4 +680,4 @@ type DeliveryCustomData = {
     plus_type?: DeliveryPlusType;
 };
 
-export { type AddToCartLineItem as A, type BuyNowTrackConfig as B, DeliveryPlusType as D, type GtmParams as G, PLUS_MEMBER_TYPE as P, ShippingMethodMode as S, type UseAddToCartOptions as U, type AddToCartInput as a, PlusMemberMode as b, type PlusMemberShippingMethodMetafields as c, type PlusMemberShippingMethodConfig as d, type PlusMemberSettingsMetafields as e, type SelectedPlusMemberVariant as f, type DeliveryCustomData as g, gaTrack as h, trackBeginCheckoutGA as i, trackBuyNowGA as j, trackAddToCartFBQ as k, trackBuyNowFBQ as l, trackAddToCartGA as t };
+export { type AddToCartLineItem as A, trackAddToCartFBQ as B, type BuyNowTrackConfig as C, DeliveryPlusType as D, trackBuyNowFBQ as E, type GtmParams as G, PLUS_MEMBER_TYPE as P, type ScriptAutoFreeGiftConfig as S, type UseAutoRemoveFreeGiftsOptions as U, type UseAutoRemoveFreeGiftsResult as a, isScriptGift as b, isBuyGetGift as c, isAnyGift as d, type UseScriptAutoFreeGiftResult as e, useScriptAutoFreeGift as f, type AddToCartInput as g, type UseAddToCartOptions as h, isFunctionGift as i, PlusMemberMode as j, ShippingMethodMode as k, type PlusMemberShippingMethodMetafields as l, type PlusMemberShippingMethodConfig as m, type PlusMemberSettingsMetafields as n, type SelectedPlusMemberVariant as o, type DeliveryCustomData as p, gaTrack as q, trackBeginCheckoutGA as r, trackBuyNowGA as s, trackAddToCartGA as t, useAutoRemoveFreeGifts as u, type GA4Data as v, waitForGtagReady as w, getGA4ClientId as x, getGA4SessionId as y, getGA4Data as z };

package/dist/{types-CMMWxyUF.d.ts → types-CM5QrlnE.d.ts}

@@ -1,4 +1,5 @@
-import { NormalizedProductVariant, NormalizedProduct, MoneyV2, NormalizedCart } from '@anker-in/shopify-sdk';
+import { NormalizedLineItem, MoneyV2, NormalizedProductVariant, NormalizedProduct, BuyerIdentityInput, NormalizedCart } from '@anker-in/shopify-sdk';
+import Decimal from 'decimal.js';
 
 /**
  * Tracking Types
@@ -18,19 +19,30 @@ interface GtmParams {
 
 declare global {
     interface Window {
-        dataLayer?: any[];
-        gtag?: (...args: any) => void;
+        dataLayer?: Array<Record<string, unknown>>;
+        gtag?: {
+            (command: 'config', targetId: string, config?: Record<string, unknown>): void;
+            (command: 'set', config: Record<string, unknown>): void;
+            (command: 'event', eventName: string, eventParams?: Record<string, unknown>): void;
+            (command: 'get', targetId: string, fieldName: string, callback?: (value: string) => void): void;
+            (command: 'consent', consentArg: string, consentParams?: Record<string, unknown>): void;
+        };
     }
 }
 /**
  * Push event to GA4 dataLayer
  */
-declare const gaTrack: (data: any) => void;
+declare const gaTrack: (data: Record<string, unknown>) => void;
 /**
  * Track add to cart event in GA4
  */
 declare const trackAddToCartGA: ({ lineItems, gtmParams, }: {
-    lineItems: AddToCartLineItem[];
+    lineItems: Array<NormalizedLineItem & {
+        finalPrice?: MoneyV2;
+        gtmParams?: {
+            item_category_id?: number | string;
+        };
+    }>;
     gtmParams?: GtmParams;
 }) => void;
 /**
@@ -46,26 +58,59 @@ declare const trackBeginCheckoutGA: ({ lineItems, currencyCode, gtmParams, }: {
  * This triggers begin_checkout event for buy now actions
  */
 declare const trackBuyNowGA: ({ lineItems, gtmParams, }: {
-    lineItems: AddToCartLineItem[];
+    lineItems: Array<NormalizedLineItem & {
+        gtmParams?: {
+            item_category_id?: number | string;
+        };
+    }>;
     gtmParams?: GtmParams;
 }) => void;
+/**
+ * GA4 Data
+ */
+interface GA4Data {
+    clientId: string;
+    sessionId: string;
+}
+/**
+ * Wait for gtag to be ready
+ */
+declare function waitForGtagReady(timeout?: number): Promise<void>;
+/**
+ * Get GA4 client ID
+ */
+declare const getGA4ClientId: (measurementId?: string) => Promise<string>;
+/**
+ * Get GA4 session ID
+ */
+declare const getGA4SessionId: (measurementId?: string) => Promise<string>;
+/**
+ * Get GA4 data (client ID and session ID)
+ */
+declare const getGA4Data: (measurementId?: string) => Promise<GA4Data>;
 
 /**
  * Facebook Pixel Tracking
  * FBQ event tracking utilities
  */
 
+type FbqCommand = 'track' | 'trackCustom' | 'trackSingle' | 'trackCustom';
+type FbqEventName = 'AddToCart' | 'Purchase' | 'InitiateCheckout' | 'ViewContent' | string;
+type FbqEventParams = Record<string, unknown>;
 declare global {
     interface Window {
-        fbq?: (...args: any[]) => void;
-        gtag?: (...args: any[]) => void;
+        fbq?: (command: FbqCommand, eventName: FbqEventName, params?: FbqEventParams) => void;
     }
 }
 /**
  * Track add to cart event in Facebook Pixel
  */
-declare const trackAddToCartFBQ: ({ lineItems }: {
-    lineItems: AddToCartLineItem[];
+declare const trackAddToCartFBQ: ({ lineItems, }: {
+    lineItems: Array<NormalizedLineItem & {
+        gtmParams?: {
+            item_category_id?: number | string;
+        };
+    }>;
 }) => void;
 /**
  * Configuration for Buy Now tracking events
@@ -102,6 +147,9 @@ type AddToCartLineItem = {
         code: string;
         amount: number;
     };
+    gtmParams?: {
+        item_category_id?: number | string;
+    };
 };
 interface AddToCartInput {
     /** Lines to add */
@@ -118,10 +166,7 @@ interface AddToCartInput {
     /** 全量更新 codes，默认是追加 */
     replaceExistingCodes?: boolean;
     /** Buyer identity for cart creation */
-    buyerIdentity?: {
-        email?: string;
-        countryCode?: string;
-    };
+    buyerIdentity?: BuyerIdentityInput;
     /** GTM tracking parameters */
     gtmParams?: Omit<GtmParams, 'brand'>;
     /** Force create new cart */
@@ -134,6 +179,131 @@ interface UseAddToCartOptions {
     withTrack?: boolean;
 }
 
+/**
+ * Auto Remove Free Gifts Hook
+ *
+ * Automatically removes Function and Script free gifts from cart on page load.
+ * This ensures gifts are only added at checkout time, not kept in cart permanently.
+ *
+ * Based on storefront-anker production implementation.
+ */
+
+interface UseAutoRemoveFreeGiftsOptions {
+    /**
+     * Whether to remove Function gifts (with _discounts_function_env attribute)
+     * @default true
+     */
+    removeFunctionGifts?: boolean;
+    /**
+     * Whether to remove Script gifts (with _giveaway_gradient_gifts attribute)
+     * @default true
+     */
+    removeScriptGifts?: boolean;
+    /**
+     * Custom function to identify additional gift line items
+     * @param line - Line item to check
+     * @returns true if line item is a gift that should be removed
+     */
+    isGiftLineItem?: (line: NormalizedLineItem) => boolean;
+}
+interface UseAutoRemoveFreeGiftsResult {
+    /** Whether removal is in progress */
+    isRemoving: boolean;
+}
+/**
+ * Automatically removes free gifts from cart on initialization
+ *
+ * Function满赠和Script满赠的赠品都会被添加到购物车，需要在返回购物车页面时自动删除。
+ * - Function 赠品：带 _discounts_function_env 属性
+ * - Script 赠品：带 _giveaway_gradient_gifts 属性
+ *
+ * @example
+ * ```tsx
+ * function CartPage() {
+ *   // Auto-remove all gifts on page load
+ *   useAutoRemoveFreeGifts()
+ *
+ *   return <Cart />
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Only remove Function gifts, keep Script gifts
+ * useAutoRemoveFreeGifts({
+ *   removeFunctionGifts: true,
+ *   removeScriptGifts: false
+ * })
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Custom gift identification
+ * useAutoRemoveFreeGifts({
+ *   isGiftLineItem: (line) => {
+ *     // Also remove other campaign gifts
+ *     return line.customAttributes?.some(
+ *       attr => attr.key === '_giveaway_summer_campaign'
+ *     )
+ *   }
+ * })
+ * ```
+ */
+declare function useAutoRemoveFreeGifts(options?: UseAutoRemoveFreeGiftsOptions): UseAutoRemoveFreeGiftsResult;
+/**
+ * Helper function to check if a line item is a Function gift
+ */
+declare function isFunctionGift(line: NormalizedLineItem): boolean;
+/**
+ * Helper function to check if a line item is a Script gift
+ */
+declare function isScriptGift(line: NormalizedLineItem): boolean;
+/**
+ * Helper function to check if a line item is a buy-get gift (买赠)
+ */
+declare function isBuyGetGift(line: NormalizedLineItem): boolean;
+/**
+ * Helper function to check if a line item is any type of gift
+ */
+declare function isAnyGift(line: NormalizedLineItem): boolean;
+
+interface GiveawayProduct {
+    handle: string;
+    sku: string;
+}
+interface Breakpoint {
+    breakpoint: string;
+    giveawayProducts: GiveawayProduct[];
+}
+interface ScriptAutoFreeGiftConfig {
+    activityAvailableQuery?: string;
+    activityQroperty?: string;
+    breakpoints?: Array<{
+        breakpoint: string;
+        giveawayProducts: GiveawayProduct[];
+    }>;
+    includeTags?: string[];
+    useTotalAmount?: boolean;
+    requireLogin?: boolean;
+}
+interface UseScriptAutoFreeGiftResult {
+    involvedLines: NormalizedLineItem[];
+    reorder: (a: NormalizedLineItem, b: NormalizedLineItem) => number;
+    disableCodeRemove: boolean;
+    nextFreeGiftLevel: Breakpoint | null;
+    freeGiftLevel: Breakpoint | null;
+    involvedSubTotal: Decimal;
+    giftProductsResult?: NormalizedProduct[];
+}
+declare const useScriptAutoFreeGift: ({ campaign, _giveaway, cart, locale: providedLocale, lines, profile, }: {
+    campaign?: ScriptAutoFreeGiftConfig;
+    _giveaway: string;
+    cart: NormalizedCart | undefined;
+    locale?: string;
+    lines?: AddToCartLineItem[];
+    profile?: any;
+}) => UseScriptAutoFreeGiftResult;
+
 /**
  * Plus Member Types
  * Type definitions for Plus Member functionality
@@ -510,4 +680,4 @@ type DeliveryCustomData = {
     plus_type?: DeliveryPlusType;
 };
 
-export { type AddToCartLineItem as A, type BuyNowTrackConfig as B, DeliveryPlusType as D, type GtmParams as G, PLUS_MEMBER_TYPE as P, ShippingMethodMode as S, type UseAddToCartOptions as U, type AddToCartInput as a, PlusMemberMode as b, type PlusMemberShippingMethodMetafields as c, type PlusMemberShippingMethodConfig as d, type PlusMemberSettingsMetafields as e, type SelectedPlusMemberVariant as f, type DeliveryCustomData as g, gaTrack as h, trackBeginCheckoutGA as i, trackBuyNowGA as j, trackAddToCartFBQ as k, trackBuyNowFBQ as l, trackAddToCartGA as t };
+export { type AddToCartLineItem as A, trackAddToCartFBQ as B, type BuyNowTrackConfig as C, DeliveryPlusType as D, trackBuyNowFBQ as E, type GtmParams as G, PLUS_MEMBER_TYPE as P, type ScriptAutoFreeGiftConfig as S, type UseAutoRemoveFreeGiftsOptions as U, type UseAutoRemoveFreeGiftsResult as a, isScriptGift as b, isBuyGetGift as c, isAnyGift as d, type UseScriptAutoFreeGiftResult as e, useScriptAutoFreeGift as f, type AddToCartInput as g, type UseAddToCartOptions as h, isFunctionGift as i, PlusMemberMode as j, ShippingMethodMode as k, type PlusMemberShippingMethodMetafields as l, type PlusMemberShippingMethodConfig as m, type PlusMemberSettingsMetafields as n, type SelectedPlusMemberVariant as o, type DeliveryCustomData as p, gaTrack as q, trackBeginCheckoutGA as r, trackBuyNowGA as s, trackAddToCartGA as t, useAutoRemoveFreeGifts as u, type GA4Data as v, waitForGtagReady as w, getGA4ClientId as x, getGA4SessionId as y, getGA4Data as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anker-in/shopify-react",
-  "version": "1.3.0-beta.0",
+  "version": "1.3.0-beta.1",
   "description": "React hooks and components for Shopify SDK",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -31,7 +31,7 @@
     "decimal.js": "^10.6.0",
     "js-cookie": "^3.0.5",
     "swr": "^2.2.0",
-    "@anker-in/shopify-sdk": "1.2.0-beta.0",
+    "@anker-in/shopify-sdk": "1.2.0-beta.1",
     "@anker-in/shopify-core": "1.0.1"
   },
   "peerDependencies": {