@tagadapay/plugin-sdk 1.0.25 → 1.0.27

package/dist/react/hooks/useCheckout.js

@@ -1,7 +1,8 @@
-import { useState, useCallback, useEffect, useRef } from 'react';
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { useCurrency } from '../hooks/useCurrency';
 import { useTagadaContext } from '../providers/TagadaProvider';
 import { getCheckoutToken } from '../utils/urlUtils';
-import { useCurrency } from '../hooks/useCurrency';
+import { collectTrackingData } from '../utils/trackingUtils';
 export function useCheckout(options = {}) {
     const { apiService, updateCheckoutDebugData, refreshCoordinator, store, currency } = useTagadaContext();
     const { code: currentCurrency } = useCurrency();
@@ -62,6 +63,14 @@ export function useCheckout(options = {}) {
         setIsLoading(true);
         setError(null);
         try {
+            // Collect tracking data
+            const trackingData = await collectTrackingData();
+            // Enhanced customerMetadata with tracking data
+            const enhancedCustomerMetadata = {
+                ...params.customerMetadata,
+                localStorage: trackingData.localStorageData,
+                cookies: trackingData.trackingCookiesData,
+            };
             const requestBody = {
                 ...params,
                 returnUrl: params.returnUrl || window.location.origin,
@@ -69,6 +78,7 @@ export function useCheckout(options = {}) {
                     ...params.customer,
                     currency: params.customer?.currency || currentCurrency,
                 },
+                customerMetadata: enhancedCustomerMetadata,
             };
             const response = await apiService.fetch('/api/v1/checkout/session/init', {
                 method: 'POST',
@@ -417,7 +427,7 @@ export function useCheckout(options = {}) {
                     lineItems,
                     storeId: store?.id,
                     currency: currency.code,
-                    promotionIds: promotionIds || [],
+                    promotionIds: promotionIds ?? [],
                 },
             });
             return response;

package/dist/react/hooks/usePostPurchases.d.ts

@@ -0,0 +1,109 @@
+export interface PostPurchaseOfferItem {
+    id: string;
+    productId: string;
+    variantId: string;
+    product: {
+        name: string;
+        description: string;
+    };
+    variant: {
+        name: string;
+        description: string;
+        imageUrl: string;
+        grams: number | null;
+    };
+    unitAmount: number;
+    quantity: number;
+    amount: number;
+    adjustedAmount: number;
+}
+export interface PostPurchaseOfferSummary {
+    currency: string;
+    totalAmount: number;
+    totalAdjustedAmount: number;
+    items: PostPurchaseOfferItem[];
+}
+export interface PostPurchaseOfferLineItem {
+    id: string;
+    quantity: number;
+    price: {
+        variant: {
+            id: string;
+            name: string;
+            description: string | null;
+            grams: number | null;
+            product: {
+                id: string;
+                name: string;
+                description: string;
+            };
+        };
+    };
+}
+export interface PostPurchaseOffer {
+    id: string;
+    titleTrans: Record<string, string> | null;
+    summaries: PostPurchaseOfferSummary[];
+    offerLineItems: PostPurchaseOfferLineItem[];
+}
+export interface UsePostPurchasesOptions {
+    /**
+     * OrderID to fetch post-purchase offers for
+     */
+    orderId: string;
+    /**
+     * Whether to fetch offers automatically on mount
+     * @default true
+     */
+    enabled?: boolean;
+}
+export interface UsePostPurchasesResult {
+    /**
+     * Array of fetched post-purchase offers
+     */
+    offers: PostPurchaseOffer[];
+    /**
+     * Loading state
+     */
+    isLoading: boolean;
+    /**
+     * Error state
+     */
+    error: Error | null;
+    /**
+     * Refetch post-purchase offers
+     */
+    refetch: () => Promise<void>;
+    /**
+     * Get offer by ID from the loaded offers
+     */
+    getOffer: (offerId: string) => PostPurchaseOffer | undefined;
+    /**
+     * Get total value of all post-purchase offers
+     */
+    getTotalValue: () => number;
+    /**
+     * Get total savings across all post-purchase offers
+     */
+    getTotalSavings: () => number;
+    /**
+     * Initialize a checkout session for a post-purchase offer
+     */
+    initCheckoutSession: (offerId: string, orderId: string) => Promise<{
+        checkoutSessionId: string;
+    }>;
+    /**
+     * Initialize a checkout session for a post-purchase offer with specific variants
+     */
+    initCheckoutSessionWithVariants: (offerId: string, orderId: string, lineItems: Array<{
+        variantId: string;
+        quantity: number;
+    }>) => Promise<{
+        checkoutSessionId: string;
+    }>;
+    /**
+     * Pay with a checkout session for a post-purchase offer
+     */
+    payWithCheckoutSession: (checkoutSessionId: string, orderId?: string) => Promise<void>;
+}
+export declare function usePostPurchases(options: UsePostPurchasesOptions): UsePostPurchasesResult;

package/dist/react/hooks/usePostPurchases.js

@@ -0,0 +1,104 @@
+import { useCallback, useEffect, useState } from 'react';
+import { useTagadaContext } from '../providers/TagadaProvider';
+export function usePostPurchases(options) {
+    const { apiService } = useTagadaContext();
+    const { orderId, enabled = true } = options;
+    const [offers, setOffers] = useState([]);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const fetchOffers = useCallback(async () => {
+        if (!orderId) {
+            setOffers([]);
+            return;
+        }
+        setIsLoading(true);
+        setError(null);
+        try {
+            const response = await apiService.fetch(`/api/v1/post-purchase/${orderId}/offers`, {
+                method: 'GET',
+            });
+            setOffers(response || []);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error('Failed to fetch post-purchase offers');
+            setError(error);
+            console.error('[SDK] Failed to fetch post-purchase offers:', error);
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [orderId]);
+    const initCheckoutSession = useCallback(async (offerId, orderId) => {
+        const response = await apiService.fetch(`/api/v1/checkout/offer/init`, {
+            method: 'POST',
+            body: JSON.stringify({
+                offerId: offerId,
+                returnUrl: window.location.href,
+                customerId: '',
+                orderId,
+            }),
+        });
+        return response;
+    }, []);
+    const initCheckoutSessionWithVariants = useCallback(async (offerId, orderId, lineItems) => {
+        const response = await apiService.fetch(`/api/v1/offers/${offerId}/transform-to-checkout`, {
+            method: 'POST',
+            body: JSON.stringify({
+                offerId: offerId,
+                lineItems: lineItems,
+                returnUrl: window.location.href,
+                mainOrderId: orderId,
+            }),
+        });
+        return response;
+    }, []);
+    const payWithCheckoutSession = useCallback(async (checkoutSessionId, orderId) => {
+        const response = await apiService.fetch(`/api/v1/checkout-sessions/${checkoutSessionId}/pay`, {
+            method: 'POST',
+            body: JSON.stringify({
+                checkoutSessionId,
+                metadata: {
+                    comingFromPostPurchase: true,
+                    postOrder: orderId,
+                },
+            }),
+        });
+        return response;
+    }, []);
+    useEffect(() => {
+        if (enabled && orderId) {
+            fetchOffers();
+        }
+    }, [enabled, orderId, fetchOffers]);
+    const getOffer = useCallback((offerId) => {
+        return offers.find((offer) => offer.id === offerId);
+    }, [offers]);
+    const getTotalValue = useCallback(() => {
+        return offers.reduce((total, offer) => {
+            return (total +
+                offer.summaries.reduce((summaryTotal, summary) => {
+                    return summaryTotal + summary.totalAmount;
+                }, 0));
+        }, 0);
+    }, [offers]);
+    const getTotalSavings = useCallback(() => {
+        return offers.reduce((total, offer) => {
+            return (total +
+                offer.summaries.reduce((summaryTotal, summary) => {
+                    return summaryTotal + (summary.totalAmount - summary.totalAdjustedAmount);
+                }, 0));
+        }, 0);
+    }, [offers]);
+    return {
+        offers,
+        isLoading,
+        error,
+        refetch: fetchOffers,
+        getOffer,
+        getTotalValue,
+        getTotalSavings,
+        initCheckoutSession,
+        initCheckoutSessionWithVariants,
+        payWithCheckoutSession,
+    };
+}

package/dist/react/index.d.ts

@@ -2,28 +2,30 @@
  * React SDK exports
  */
 export { TagadaProvider } from './providers/TagadaProvider';
+export { useAddress } from './hooks/useAddress';
+export { useAuth } from './hooks/useAuth';
 export { useCheckout } from './hooks/useCheckout';
-export { useProducts } from './hooks/useProducts';
-export { useOffers } from './hooks/useOffers';
-export { useOrderBump } from './hooks/useOrderBump';
-export { useSession } from './hooks/useSession';
 export { useCurrency } from './hooks/useCurrency';
 export { useCustomer } from './hooks/useCustomer';
 export { useEnvironment } from './hooks/useEnvironment';
 export { useLocale } from './hooks/useLocale';
-export { useAuth } from './hooks/useAuth';
-export { useAddress } from './hooks/useAddress';
+export { useOffers } from './hooks/useOffers';
+export { useOrderBump } from './hooks/useOrderBump';
+export { usePostPurchases } from './hooks/usePostPurchases';
+export { useProducts } from './hooks/useProducts';
+export { useSession } from './hooks/useSession';
 export { useOrder } from './hooks/useOrder';
 export type { UseOrderOptions, UseOrderResult } from './hooks/useOrder';
 export { usePayment } from './hooks/usePayment';
 export { usePaymentPolling } from './hooks/usePaymentPolling';
 export { useThreeds } from './hooks/useThreeds';
 export { useThreedsModal } from './hooks/useThreedsModal';
-export type { Customer, Session, AuthState, Locale, Currency, Store, Environment, EnvironmentConfig, Order, OrderItem, OrderSummary, OrderAddress, PickupPoint, } from './types';
-export type { UseCheckoutOptions, UseCheckoutResult, CheckoutInitParams, CheckoutLineItem, CheckoutSession, CheckoutData, Promotion, } from './hooks/useCheckout';
-export type { UseOrderBumpOptions, UseOrderBumpResult, OrderBumpPreview } from './hooks/useOrderBump';
-export type { UseAddressOptions, UseAddressResult, AddressData, AddressField, Country, State, } from './hooks/useAddress';
-export type { Payment, PollingOptions, PaymentPollingHook } from './hooks/usePaymentPolling';
-export type { PaymentInstrument, ThreedsSession, ThreedsChallenge, ThreedsOptions, ThreedsHook, ThreedsProvider, } from './hooks/useThreeds';
-export type { ApplePayToken, CardPaymentMethod, PaymentResponse, PaymentOptions, PaymentInstrumentResponse, PaymentHook, } from './hooks/usePayment';
-export { formatMoney, formatMoneyWithoutSymbol, getCurrencyInfo, minorUnitsToMajorUnits, moneyStringOrNumberToMinorUnits, convertCurrency, formatSimpleMoney, } from './utils/money';
+export type { AuthState, Currency, Customer, Environment, EnvironmentConfig, Locale, Order, OrderAddress, OrderItem, OrderSummary, PickupPoint, Session, Store, } from './types';
+export type { CheckoutData, CheckoutInitParams, CheckoutLineItem, CheckoutSession, Promotion, UseCheckoutOptions, UseCheckoutResult, } from './hooks/useCheckout';
+export type { OrderBumpPreview, UseOrderBumpOptions, UseOrderBumpResult } from './hooks/useOrderBump';
+export type { PostPurchaseOffer, PostPurchaseOfferItem, PostPurchaseOfferLineItem, PostPurchaseOfferSummary, UsePostPurchasesOptions, UsePostPurchasesResult, } from './hooks/usePostPurchases';
+export type { AddressData, AddressField, Country, State, UseAddressOptions, UseAddressResult, } from './hooks/useAddress';
+export type { Payment, PaymentPollingHook, PollingOptions } from './hooks/usePaymentPolling';
+export type { PaymentInstrument, ThreedsChallenge, ThreedsHook, ThreedsOptions, ThreedsProvider, ThreedsSession, } from './hooks/useThreeds';
+export type { ApplePayToken, CardPaymentMethod, PaymentHook, PaymentInstrumentResponse, PaymentOptions, PaymentResponse, } from './hooks/usePayment';
+export { convertCurrency, formatMoney, formatMoneyWithoutSymbol, formatSimpleMoney, getCurrencyInfo, minorUnitsToMajorUnits, moneyStringOrNumberToMinorUnits, } from './utils/money';

package/dist/react/index.js

@@ -5,17 +5,18 @@
 // Provider exports
 export { TagadaProvider } from './providers/TagadaProvider';
 // Hook exports
+export { useAddress } from './hooks/useAddress';
+export { useAuth } from './hooks/useAuth';
 export { useCheckout } from './hooks/useCheckout';
-export { useProducts } from './hooks/useProducts';
-export { useOffers } from './hooks/useOffers';
-export { useOrderBump } from './hooks/useOrderBump';
-export { useSession } from './hooks/useSession';
 export { useCurrency } from './hooks/useCurrency';
 export { useCustomer } from './hooks/useCustomer';
 export { useEnvironment } from './hooks/useEnvironment';
 export { useLocale } from './hooks/useLocale';
-export { useAuth } from './hooks/useAuth';
-export { useAddress } from './hooks/useAddress';
+export { useOffers } from './hooks/useOffers';
+export { useOrderBump } from './hooks/useOrderBump';
+export { usePostPurchases } from './hooks/usePostPurchases';
+export { useProducts } from './hooks/useProducts';
+export { useSession } from './hooks/useSession';
 // Order hook exports
 export { useOrder } from './hooks/useOrder';
 // Payment hooks exports
@@ -26,4 +27,4 @@ export { useThreedsModal } from './hooks/useThreedsModal';
 // Component exports (if any)
 // export { SomeComponent } from './components/SomeComponent';
 // Utility exports
-export { formatMoney, formatMoneyWithoutSymbol, getCurrencyInfo, minorUnitsToMajorUnits, moneyStringOrNumberToMinorUnits, convertCurrency, formatSimpleMoney, } from './utils/money';
+export { convertCurrency, formatMoney, formatMoneyWithoutSymbol, formatSimpleMoney, getCurrencyInfo, minorUnitsToMajorUnits, moneyStringOrNumberToMinorUnits, } from './utils/money';

package/dist/react/utils/trackingUtils.d.ts

@@ -0,0 +1,24 @@
+export interface TrackingData {
+    trackingCookiesData: Record<string, string>;
+    localStorageData: Record<string, string>;
+}
+/**
+ * Define pixel tracking cookie patterns for various platforms
+ */
+export declare const trackingCookiePatterns: RegExp[];
+/**
+ * Function to get cookies with retry logic
+ */
+export declare const getCookiesWithRetry: (maxRetries?: number, delay?: number) => Promise<string[]>;
+/**
+ * Collect localStorage data as dictionary
+ */
+export declare const getLocalStorageData: () => Record<string, string>;
+/**
+ * Collect tracking cookies data based on defined patterns
+ */
+export declare const getTrackingCookiesData: () => Promise<Record<string, string>>;
+/**
+ * Collect all tracking data (localStorage and cookies)
+ */
+export declare const collectTrackingData: () => Promise<TrackingData>;

package/dist/react/utils/trackingUtils.js

@@ -0,0 +1,172 @@
+/**
+ * Define pixel tracking cookie patterns for various platforms
+ */
+export const trackingCookiePatterns = [
+    // Meta/Facebook pixels
+    /^_fbp/,
+    /^_fbc/,
+    /^fr$/,
+    /^_fbq/,
+    /^fbq/,
+    /^sb$/,
+    // Google Analytics & Ads
+    /^_ga/,
+    /^_gid/,
+    /^_gcl_au/,
+    /^_gac_/,
+    /^_gtag/,
+    /^_gat/,
+    /^_dc_gtm_/,
+    /^_gtm/,
+    // Google Ads
+    /^_gcl_/,
+    /^_gclid/,
+    /^_gclsrc/,
+    // Snapchat
+    /^_scid/,
+    /^_sctr/,
+    /^_schn/,
+    /^_scpx/,
+    // TikTok
+    /^_ttp/,
+    /^_tt_enable_cookie/,
+    /^_ttclid/,
+    /^_tta/,
+    // Pinterest
+    /^_pin/,
+    /^_pinterest_/,
+    /^_pinid/,
+    // Twitter/X
+    /^_twitter/,
+    /^_twid/,
+    /^muc_ads/,
+    // LinkedIn
+    /^_li/,
+    /^AnalyticsSyncHistory/,
+    /^bcookie/,
+    /^bscookie/,
+    // Microsoft/Bing
+    /^_uetsid/,
+    /^_uetvid/,
+    /^MUID/,
+    /^_msdcs/,
+    // Amazon
+    /^ad-id/,
+    /^ad-privacy/,
+    // CVG tracking
+    /^__cvg_uid/,
+    /^__cvg_sid/,
+    /^__cvg_session/,
+    // Shopify tracking
+    /^_shopify_y/,
+    /^_shopify_s/,
+    /^_shopify_ga/,
+    /^_shopify_ga_/,
+    /^_shopify_sa_p/,
+    /^_shopify_sa_t/,
+    // General tracking
+    /^_awc/,
+    /^_aw_/,
+    /^utm_/,
+    /^_clck/,
+    /^_clsk/,
+];
+/**
+ * Function to get cookies with retry logic
+ */
+export const getCookiesWithRetry = async (maxRetries = 3, delay = 100) => {
+    for (let attempt = 1; attempt <= maxRetries; attempt++) {
+        try {
+            const cookies = document.cookie.split('; ');
+            if (cookies.length > 0 && cookies[0] !== '') {
+                return cookies;
+            }
+            // If no cookies found, wait and retry
+            if (attempt < maxRetries) {
+                console.log(`Cookie collection attempt ${attempt} failed, retrying in ${delay}ms...`);
+                await new Promise((resolve) => setTimeout(resolve, delay));
+            }
+        }
+        catch (error) {
+            console.warn(`Cookie collection attempt ${attempt} failed:`, error);
+            if (attempt < maxRetries) {
+                await new Promise((resolve) => setTimeout(resolve, delay));
+            }
+        }
+    }
+    return [];
+};
+/**
+ * Collect localStorage data as dictionary
+ */
+export const getLocalStorageData = () => {
+    const localStorageData = {};
+    try {
+        for (let i = 0; i < localStorage.length; i++) {
+            const key = localStorage.key(i);
+            if (key) {
+                localStorageData[key] = localStorage.getItem(key) || '';
+            }
+        }
+    }
+    catch (error) {
+        console.warn('Failed to read localStorage:', error);
+    }
+    return localStorageData;
+};
+/**
+ * Collect tracking cookies data based on defined patterns
+ */
+export const getTrackingCookiesData = async () => {
+    const trackingCookiesData = {};
+    try {
+        // Get cookies with retry logic
+        const cookies = await getCookiesWithRetry();
+        if (cookies.length === 0) {
+            console.warn('No cookies found after retry attempts');
+        }
+        else {
+            console.log(`Successfully collected ${cookies.length} cookies`);
+        }
+        cookies.forEach((cookie) => {
+            const [key, ...valueParts] = cookie.split('=');
+            const value = valueParts.join('='); // Handle values that might contain =
+            if (key && trackingCookiePatterns.some((pattern) => pattern.test(key))) {
+                try {
+                    trackingCookiesData[key] = decodeURIComponent(value || '');
+                }
+                catch (error) {
+                    // If decoding fails, use raw value
+                    trackingCookiesData[key] = value || '';
+                }
+            }
+        });
+        // Log specific cookies we're looking for
+        const importantCookies = ['_shopify_y', '__cvg_uid', '_fbp', '_ga'];
+        importantCookies.forEach((cookieName) => {
+            if (trackingCookiesData[cookieName]) {
+                console.log(`Found ${cookieName}:`, trackingCookiesData[cookieName]);
+            }
+            else {
+                console.log(`Missing ${cookieName} cookie`);
+            }
+        });
+    }
+    catch (error) {
+        console.warn('Failed to read tracking cookies:', error);
+    }
+    return trackingCookiesData;
+};
+/**
+ * Collect all tracking data (localStorage and cookies)
+ */
+export const collectTrackingData = async () => {
+    const [localStorageData, trackingCookiesData] = await Promise.all([
+        Promise.resolve(getLocalStorageData()),
+        getTrackingCookiesData(),
+    ]);
+    return {
+        localStorageData,
+        trackingCookiesData,
+    };
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tagadapay/plugin-sdk",
-  "version": "1.0.25",
+  "version": "1.0.27",
   "description": "Modern React SDK for building Tagada Pay plugins",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",