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

package/dist/{types-CMA6_FML.d.mts → types-CICUnw0v.d.mts}

@@ -1,78 +1,17 @@
-import { NormalizedCart, NormalizedProduct, NormalizedProductVariant } from '@anker-in/shopify-sdk';
+import * as swr_mutation from 'swr/mutation';
+import { SWRMutationConfiguration } from 'swr/mutation';
+import { NormalizedProductVariant, NormalizedProduct, MoneyV2, NormalizedCart } from '@anker-in/shopify-sdk';
 
 /**
  * Tracking Types
  * Type definitions for analytics and tracking
  */
-
-interface TrackingLineItem {
-    variant?: {
-        id: string;
-        sku?: string;
-        title?: string;
-        name?: string;
-        price?: {
-            amount: string;
-            currencyCode: string;
-        };
-        finalPrice?: {
-            amount: string;
-        };
-        product?: {
-            title?: string;
-            name?: string;
-            vendor?: string;
-            productType?: string;
-            metafields?: {
-                global?: {
-                    trafficType?: string;
-                };
-            };
-        };
-    };
-    quantity?: number;
-    finalPrice?: {
-        amount: string;
-    };
-}
 interface GtmParams {
     pageGroup?: string;
     position?: string;
     brand?: string;
     ga4Params?: Record<string, any>;
 }
-interface TrackingOptions {
-    /** Enable Google Analytics tracking */
-    enableGA?: boolean;
-    /** Enable Facebook Pixel tracking */
-    enableFBQ?: boolean;
-    /** GTM parameters */
-    gtmParams?: GtmParams;
-    /** Brand name for tracking */
-    brand?: string;
-}
-interface TrackingAdapter {
-    /** Track add to cart event */
-    trackAddToCart?: (params: {
-        cart: NormalizedCart;
-        lineItems: TrackingLineItem[];
-        gtmParams?: GtmParams;
-        brand?: string;
-    }) => void;
-    /** Track remove from cart event */
-    trackRemoveFromCart?: (params: {
-        cart: NormalizedCart;
-        lineItems: TrackingLineItem[];
-        gtmParams?: GtmParams;
-        brand?: string;
-    }) => void;
-    /** Track begin checkout event */
-    trackBeginCheckout?: (params: {
-        cart: NormalizedCart;
-        gtmParams?: GtmParams;
-        brand?: string;
-    }) => void;
-}
 
 /**
  * Google Analytics Tracking
@@ -92,29 +31,25 @@ declare const gaTrack: (data: any) => void;
 /**
  * Track add to cart event in GA4
  */
-declare const trackAddToCartGA: ({ lineItems, gtmParams, brand, }: {
-    lineItems: TrackingLineItem[];
+declare const trackAddToCartGA: ({ lineItems, gtmParams, }: {
+    lineItems: AddToCartLineItem[];
     gtmParams?: GtmParams;
-    brand?: string;
 }) => void;
 /**
  * Track begin checkout event in GA4
  */
-declare const trackBeginCheckoutGA: ({ lineItems, currencyCode, totalPrice, gtmParams, brand, }: {
-    lineItems: TrackingLineItem[];
+declare const trackBeginCheckoutGA: ({ lineItems, currencyCode, gtmParams, }: {
+    lineItems: AddToCartLineItem[];
     currencyCode?: string;
-    totalPrice?: number;
     gtmParams?: GtmParams;
-    brand?: string;
 }) => void;
 /**
  * Track buy now event in GA4
  * This triggers begin_checkout event for buy now actions
  */
-declare const trackBuyNowGA: ({ lineItems, gtmParams, brand, }: {
-    lineItems: TrackingLineItem[];
+declare const trackBuyNowGA: ({ lineItems, gtmParams, }: {
+    lineItems: AddToCartLineItem[];
     gtmParams?: GtmParams;
-    brand?: string;
 }) => void;
 
 /**
@@ -132,7 +67,7 @@ declare global {
  * Track add to cart event in Facebook Pixel
  */
 declare const trackAddToCartFBQ: ({ lineItems }: {
-    lineItems: TrackingLineItem[];
+    lineItems: AddToCartLineItem[];
 }) => void;
 /**
  * Configuration for Buy Now tracking events
@@ -154,6 +89,80 @@ declare const trackBuyNowFBQ: ({ trackConfig }: {
     trackConfig?: BuyNowTrackConfig;
 }) => void;
 
+type AddToCartLineItem = {
+    variant?: NormalizedProductVariant & {
+        product?: NormalizedProduct;
+        finalPrice?: MoneyV2;
+    };
+    sellingPlanId?: string;
+    quantity?: number;
+    attributes?: Array<{
+        key: string;
+        value: string;
+    }>;
+};
+interface AddToCartInput {
+    /** Lines to add */
+    lineItems: Array<AddToCartLineItem>;
+    /** Cart ID (optional) */
+    cartId?: string;
+    /** Discount codes to apply */
+    discountCodes?: string[];
+    /** Custom attributes for the cart */
+    customAttributes?: Array<{
+        key: string;
+        value: string;
+    }>;
+    /** 全量更新 codes，默认是追加 */
+    replaceExistingCodes?: boolean;
+    /** Buyer identity for cart creation */
+    buyerIdentity?: {
+        email?: string;
+        countryCode?: string;
+    };
+    /** GTM tracking parameters */
+    gtmParams?: Omit<GtmParams, 'brand'>;
+    /** Force create new cart */
+    needCreateCart?: boolean;
+    /** Callback when discount codes are invalid */
+    onCodesInvalid?: (updatedCart: NormalizedCart, invalidCodes: string[]) => Promise<NormalizedCart | undefined>;
+}
+interface UseAddToCartOptions {
+    /** Enable tracking (GA and FBQ) */
+    withTrack?: boolean;
+}
+/**
+ * Hook for adding items to cart with tracking support
+ *
+ * This is the enhanced version that includes:
+ * - Automatic cart creation if needed
+ * - Discount code validation
+ * - Google Analytics tracking
+ * - Facebook Pixel tracking
+ * - Invalid code handling
+ *
+ * @param options - Hook configuration
+ * @param swrOptions - SWR mutation configuration
+ * @returns SWR mutation with trigger function
+ *
+ * @example
+ * ```tsx
+ * const { trigger, isMutating } = useAddToCart({ withTrack: true})
+ *
+ * await trigger({
+ *   lineItems: [{
+ *     variantId: 'gid://shopify/ProductVariant/123',
+ *     quantity: 2
+ *   }],
+ *   gtmParams: {
+ *     pageGroup: 'PDP',
+ *     position: 'Add to Cart Button'
+ *   }
+ * })
+ * ```
+ */
+declare function useAddToCart({ withTrack }?: UseAddToCartOptions, swrOptions?: SWRMutationConfiguration<NormalizedCart | undefined, Error, string, AddToCartInput>): swr_mutation.SWRMutationResponse<NormalizedCart | undefined, Error, string, AddToCartInput>;
+
 /**
  * Plus Member Types
  * Type definitions for Plus Member functionality
@@ -547,4 +556,4 @@ type DeliveryData = {
     deliveryCustomData: DeliveryCustomData;
 };
 
-export { type BuyNowTrackConfig as B, DeliveryPlusType as D, type GtmParams as G, type MailingAddress as M, PLUS_MEMBER_TYPE as P, ShippingMethodMode as S, type TrackingLineItem as T, PlusMemberMode as a, type PlusMemberShippingMethodMetafields as b, type PlusMemberShippingMethodConfig as c, type PlusMemberSettingsMetafields as d, type SelectedPlusMemberProduct as e, type DeliveryOption as f, type DeliveryCustomData as g, type DeliveryData as h, type TrackingOptions as i, type TrackingAdapter as j, gaTrack as k, trackBeginCheckoutGA as l, trackBuyNowGA as m, trackAddToCartFBQ as n, trackBuyNowFBQ as o, trackAddToCartGA as t };
+export { type AddToCartLineItem as A, type BuyNowTrackConfig as B, DeliveryPlusType as D, type GtmParams as G, type MailingAddress as M, 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 SelectedPlusMemberProduct as f, type DeliveryOption as g, type DeliveryCustomData as h, type DeliveryData as i, gaTrack as j, trackBeginCheckoutGA as k, trackBuyNowGA as l, trackAddToCartFBQ as m, trackBuyNowFBQ as n, trackAddToCartGA as t, useAddToCart as u };

package/dist/{types-CMA6_FML.d.ts → types-CICUnw0v.d.ts}

@@ -1,78 +1,17 @@
-import { NormalizedCart, NormalizedProduct, NormalizedProductVariant } from '@anker-in/shopify-sdk';
+import * as swr_mutation from 'swr/mutation';
+import { SWRMutationConfiguration } from 'swr/mutation';
+import { NormalizedProductVariant, NormalizedProduct, MoneyV2, NormalizedCart } from '@anker-in/shopify-sdk';
 
 /**
  * Tracking Types
  * Type definitions for analytics and tracking
  */
-
-interface TrackingLineItem {
-    variant?: {
-        id: string;
-        sku?: string;
-        title?: string;
-        name?: string;
-        price?: {
-            amount: string;
-            currencyCode: string;
-        };
-        finalPrice?: {
-            amount: string;
-        };
-        product?: {
-            title?: string;
-            name?: string;
-            vendor?: string;
-            productType?: string;
-            metafields?: {
-                global?: {
-                    trafficType?: string;
-                };
-            };
-        };
-    };
-    quantity?: number;
-    finalPrice?: {
-        amount: string;
-    };
-}
 interface GtmParams {
     pageGroup?: string;
     position?: string;
     brand?: string;
     ga4Params?: Record<string, any>;
 }
-interface TrackingOptions {
-    /** Enable Google Analytics tracking */
-    enableGA?: boolean;
-    /** Enable Facebook Pixel tracking */
-    enableFBQ?: boolean;
-    /** GTM parameters */
-    gtmParams?: GtmParams;
-    /** Brand name for tracking */
-    brand?: string;
-}
-interface TrackingAdapter {
-    /** Track add to cart event */
-    trackAddToCart?: (params: {
-        cart: NormalizedCart;
-        lineItems: TrackingLineItem[];
-        gtmParams?: GtmParams;
-        brand?: string;
-    }) => void;
-    /** Track remove from cart event */
-    trackRemoveFromCart?: (params: {
-        cart: NormalizedCart;
-        lineItems: TrackingLineItem[];
-        gtmParams?: GtmParams;
-        brand?: string;
-    }) => void;
-    /** Track begin checkout event */
-    trackBeginCheckout?: (params: {
-        cart: NormalizedCart;
-        gtmParams?: GtmParams;
-        brand?: string;
-    }) => void;
-}
 
 /**
  * Google Analytics Tracking
@@ -92,29 +31,25 @@ declare const gaTrack: (data: any) => void;
 /**
  * Track add to cart event in GA4
  */
-declare const trackAddToCartGA: ({ lineItems, gtmParams, brand, }: {
-    lineItems: TrackingLineItem[];
+declare const trackAddToCartGA: ({ lineItems, gtmParams, }: {
+    lineItems: AddToCartLineItem[];
     gtmParams?: GtmParams;
-    brand?: string;
 }) => void;
 /**
  * Track begin checkout event in GA4
  */
-declare const trackBeginCheckoutGA: ({ lineItems, currencyCode, totalPrice, gtmParams, brand, }: {
-    lineItems: TrackingLineItem[];
+declare const trackBeginCheckoutGA: ({ lineItems, currencyCode, gtmParams, }: {
+    lineItems: AddToCartLineItem[];
     currencyCode?: string;
-    totalPrice?: number;
     gtmParams?: GtmParams;
-    brand?: string;
 }) => void;
 /**
  * Track buy now event in GA4
  * This triggers begin_checkout event for buy now actions
  */
-declare const trackBuyNowGA: ({ lineItems, gtmParams, brand, }: {
-    lineItems: TrackingLineItem[];
+declare const trackBuyNowGA: ({ lineItems, gtmParams, }: {
+    lineItems: AddToCartLineItem[];
     gtmParams?: GtmParams;
-    brand?: string;
 }) => void;
 
 /**
@@ -132,7 +67,7 @@ declare global {
  * Track add to cart event in Facebook Pixel
  */
 declare const trackAddToCartFBQ: ({ lineItems }: {
-    lineItems: TrackingLineItem[];
+    lineItems: AddToCartLineItem[];
 }) => void;
 /**
  * Configuration for Buy Now tracking events
@@ -154,6 +89,80 @@ declare const trackBuyNowFBQ: ({ trackConfig }: {
     trackConfig?: BuyNowTrackConfig;
 }) => void;
 
+type AddToCartLineItem = {
+    variant?: NormalizedProductVariant & {
+        product?: NormalizedProduct;
+        finalPrice?: MoneyV2;
+    };
+    sellingPlanId?: string;
+    quantity?: number;
+    attributes?: Array<{
+        key: string;
+        value: string;
+    }>;
+};
+interface AddToCartInput {
+    /** Lines to add */
+    lineItems: Array<AddToCartLineItem>;
+    /** Cart ID (optional) */
+    cartId?: string;
+    /** Discount codes to apply */
+    discountCodes?: string[];
+    /** Custom attributes for the cart */
+    customAttributes?: Array<{
+        key: string;
+        value: string;
+    }>;
+    /** 全量更新 codes，默认是追加 */
+    replaceExistingCodes?: boolean;
+    /** Buyer identity for cart creation */
+    buyerIdentity?: {
+        email?: string;
+        countryCode?: string;
+    };
+    /** GTM tracking parameters */
+    gtmParams?: Omit<GtmParams, 'brand'>;
+    /** Force create new cart */
+    needCreateCart?: boolean;
+    /** Callback when discount codes are invalid */
+    onCodesInvalid?: (updatedCart: NormalizedCart, invalidCodes: string[]) => Promise<NormalizedCart | undefined>;
+}
+interface UseAddToCartOptions {
+    /** Enable tracking (GA and FBQ) */
+    withTrack?: boolean;
+}
+/**
+ * Hook for adding items to cart with tracking support
+ *
+ * This is the enhanced version that includes:
+ * - Automatic cart creation if needed
+ * - Discount code validation
+ * - Google Analytics tracking
+ * - Facebook Pixel tracking
+ * - Invalid code handling
+ *
+ * @param options - Hook configuration
+ * @param swrOptions - SWR mutation configuration
+ * @returns SWR mutation with trigger function
+ *
+ * @example
+ * ```tsx
+ * const { trigger, isMutating } = useAddToCart({ withTrack: true})
+ *
+ * await trigger({
+ *   lineItems: [{
+ *     variantId: 'gid://shopify/ProductVariant/123',
+ *     quantity: 2
+ *   }],
+ *   gtmParams: {
+ *     pageGroup: 'PDP',
+ *     position: 'Add to Cart Button'
+ *   }
+ * })
+ * ```
+ */
+declare function useAddToCart({ withTrack }?: UseAddToCartOptions, swrOptions?: SWRMutationConfiguration<NormalizedCart | undefined, Error, string, AddToCartInput>): swr_mutation.SWRMutationResponse<NormalizedCart | undefined, Error, string, AddToCartInput>;
+
 /**
  * Plus Member Types
  * Type definitions for Plus Member functionality
@@ -547,4 +556,4 @@ type DeliveryData = {
     deliveryCustomData: DeliveryCustomData;
 };
 
-export { type BuyNowTrackConfig as B, DeliveryPlusType as D, type GtmParams as G, type MailingAddress as M, PLUS_MEMBER_TYPE as P, ShippingMethodMode as S, type TrackingLineItem as T, PlusMemberMode as a, type PlusMemberShippingMethodMetafields as b, type PlusMemberShippingMethodConfig as c, type PlusMemberSettingsMetafields as d, type SelectedPlusMemberProduct as e, type DeliveryOption as f, type DeliveryCustomData as g, type DeliveryData as h, type TrackingOptions as i, type TrackingAdapter as j, gaTrack as k, trackBeginCheckoutGA as l, trackBuyNowGA as m, trackAddToCartFBQ as n, trackBuyNowFBQ as o, trackAddToCartGA as t };
+export { type AddToCartLineItem as A, type BuyNowTrackConfig as B, DeliveryPlusType as D, type GtmParams as G, type MailingAddress as M, 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 SelectedPlusMemberProduct as f, type DeliveryOption as g, type DeliveryCustomData as h, type DeliveryData as i, gaTrack as j, trackBeginCheckoutGA as k, trackBuyNowGA as l, trackAddToCartFBQ as m, trackBuyNowFBQ as n, trackAddToCartGA as t, useAddToCart as u };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anker-in/shopify-react",
-  "version": "0.1.1-beta.0",
+  "version": "0.1.1-beta.2",
   "description": "React hooks and components for Shopify SDK",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -31,8 +31,8 @@
     "decimal.js": "^10.6.0",
     "js-cookie": "^3.0.5",
     "swr": "^2.2.0",
-    "@anker-in/shopify-sdk": "0.1.1-beta.0",
-    "@anker-in/shopify-core": "0.1.1-beta.0"
+    "@anker-in/shopify-core": "0.1.1-beta.0",
+    "@anker-in/shopify-sdk": "0.1.1-beta.1"
   },
   "peerDependencies": {
     "react": ">=18.0.0",
@@ -47,8 +47,8 @@
     "react-dom": "^19.1.0",
     "tsup": "^8.0.0",
     "typescript": "5.9.2",
-    "@repo/eslint-config": "0.0.0",
-    "@repo/typescript-config": "0.0.0"
+    "@repo/typescript-config": "0.0.0",
+    "@repo/eslint-config": "0.0.0"
   },
   "publishConfig": {
     "access": "public"