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

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 };