@tagadapay/plugin-sdk 4.0.0 → 4.0.4

package/dist/v2/react/hooks/useCheckoutQuery.js

@@ -21,7 +21,7 @@ export function useCheckoutQuery(options = {}) {
     const { storeId } = usePluginConfig();
     const currency = useCurrency();
     const queryClient = useQueryClient();
-    const { isSessionInitialized, session } = useTagadaContext();
+    const { isSessionInitialized, session, client } = useTagadaContext();
     // Track pending session promises to avoid creating multiple promises
     const pendingSessionPromise = useRef(null);
     const sessionResolvers = useRef(new Set());
@@ -64,12 +64,12 @@ export function useCheckoutQuery(options = {}) {
     // Create checkout resource client
     const checkoutResource = useMemo(() => {
         try {
-            return new CheckoutResource(getGlobalApiClient());
+            return new CheckoutResource(getGlobalApiClient(), client.bus);
         }
         catch (error) {
             throw new Error(messages.initFailed + ': ' + (error instanceof Error ? error.message : 'Unknown error'));
         }
-    }, []);
+    }, [client.bus]);
     // Internal token state that can be updated after init
     const [internalToken, setInternalToken] = useState(providedToken);
     // Update internal token when provided token changes
@@ -304,6 +304,32 @@ export function useCheckoutQuery(options = {}) {
             promotionIds,
         }),
     });
+    // Stable mutator wrappers. Returning inline arrows each render produced new
+    // refs on every checkout state change (mutation success → query invalidate
+    // → refetch → re-render), which propagated instability into consumer
+    // useCallback/useEffect deps and broke debounced auto-update (the timer in
+    // the shared RHF watch listener kept getting cleared mid-debounce, so the
+    // customer-and-session-info call never fired for email-only typing).
+    const init = useCallback(async (params) => {
+        await waitForSession();
+        const result = await initMutation.mutateAsync(params);
+        setInternalToken(result.checkoutToken);
+        return {
+            checkoutSession: checkout?.checkoutSession ?? {},
+            checkoutToken: result.checkoutToken,
+        };
+    }, [waitForSession, initMutation.mutateAsync, checkout?.checkoutSession]);
+    const replaceSessionLineItems = useCallback((lineItems) => replaceSessionLineItemsMutation.mutateAsync({ lineItems }), [replaceSessionLineItemsMutation.mutateAsync]);
+    const updateLineItems = useCallback((lineItems) => lineItemsMutation.mutateAsync({ lineItems }), [lineItemsMutation.mutateAsync]);
+    const updateLineItemsOptimistic = useCallback((lineItems) => lineItemsMutation.mutate({ lineItems }), [lineItemsMutation.mutate]);
+    const addLineItems = useCallback((lineItems) => addLineItemsMutation.mutateAsync({ lineItems }), [addLineItemsMutation.mutateAsync]);
+    const removeLineItems = useCallback((lineItems) => removeLineItemsMutation.mutateAsync({ lineItems }), [removeLineItemsMutation.mutateAsync]);
+    const setItemQuantity = useCallback((variantId, quantity, priceId) => quantityMutation.mutateAsync({ variantId, quantity, priceId }), [quantityMutation.mutateAsync]);
+    const updateCustomer = useCallback((data) => customerMutation.mutateAsync(data), [customerMutation.mutateAsync]);
+    const updateCustomerAndSessionInfo = useCallback((data) => customerAndSessionMutation.mutateAsync(data), [customerAndSessionMutation.mutateAsync]);
+    const applyPromotionCode = useCallback((code) => promotionMutation.mutateAsync({ code }), [promotionMutation.mutateAsync]);
+    const removePromotion = useCallback((promotionId) => removePromotionMutation.mutateAsync({ promotionId }), [removePromotionMutation.mutateAsync]);
+    const previewCheckoutSession = useCallback((lineItems, promotionIds) => previewCheckoutSessionMutation.mutateAsync({ lineItems, promotionIds }), [previewCheckoutSessionMutation.mutateAsync]);
     return {
         // Query data
         checkout,
@@ -311,33 +337,19 @@ export function useCheckoutQuery(options = {}) {
         error,
         isSuccess,
         // Actions
-        init: async (params) => {
-            // Wait for session to be initialized to ensure we have customerId
-            await waitForSession();
-            const result = await initMutation.mutateAsync(params);
-            // Update internal token state so the query can fetch the checkout data
-            // The query will automatically refetch when token changes, and getCheckout()
-            // will automatically wait for async completion (via SDK skipAsyncWait=false)
-            setInternalToken(result.checkoutToken);
-            // Return immediately with token
-            // checkoutSession will be populated by the query once background processing completes
-            return {
-                checkoutSession: checkout?.checkoutSession ?? {},
-                checkoutToken: result.checkoutToken,
-            };
-        },
+        init,
         refresh,
         // Checkout operations
-        replaceSessionLineItems: (lineItems) => replaceSessionLineItemsMutation.mutateAsync({ lineItems }),
-        updateLineItems: (lineItems) => lineItemsMutation.mutateAsync({ lineItems }),
-        updateLineItemsOptimistic: (lineItems) => lineItemsMutation.mutate({ lineItems }),
-        addLineItems: (lineItems) => addLineItemsMutation.mutateAsync({ lineItems }),
-        removeLineItems: (lineItems) => removeLineItemsMutation.mutateAsync({ lineItems }),
-        setItemQuantity: (variantId, quantity, priceId) => quantityMutation.mutateAsync({ variantId, quantity, priceId }),
-        updateCustomer: (data) => customerMutation.mutateAsync(data),
-        updateCustomerAndSessionInfo: (data) => customerAndSessionMutation.mutateAsync(data),
-        applyPromotionCode: (code) => promotionMutation.mutateAsync({ code }),
-        removePromotion: (promotionId) => removePromotionMutation.mutateAsync({ promotionId }),
-        previewCheckoutSession: (lineItems, promotionIds) => previewCheckoutSessionMutation.mutateAsync({ lineItems, promotionIds }),
+        replaceSessionLineItems,
+        updateLineItems,
+        updateLineItemsOptimistic,
+        addLineItems,
+        removeLineItems,
+        setItemQuantity,
+        updateCustomer,
+        updateCustomerAndSessionInfo,
+        applyPromotionCode,
+        removePromotion,
+        previewCheckoutSession,
     };
 }

package/dist/v2/react/hooks/useDiscountsQuery.js

@@ -45,6 +45,8 @@ export function useDiscountsQuery(options = {}) {
                     await Promise.all([
                         queryClient.invalidateQueries({ queryKey: ['discounts', sessionId] }),
                         queryClient.invalidateQueries({ queryKey: ['checkout'] }),
+                        queryClient.invalidateQueries({ queryKey: ['shipping-rates', sessionId] }),
+                        queryClient.invalidateQueries({ queryKey: ['shipping-rates-preview', sessionId] }),
                     ]);
                 }
                 // Call onSuccess callback if provided
@@ -72,6 +74,8 @@ export function useDiscountsQuery(options = {}) {
                     await Promise.all([
                         queryClient.invalidateQueries({ queryKey: ['discounts', sessionId] }),
                         queryClient.invalidateQueries({ queryKey: ['checkout'] }),
+                        queryClient.invalidateQueries({ queryKey: ['shipping-rates', sessionId] }),
+                        queryClient.invalidateQueries({ queryKey: ['shipping-rates-preview', sessionId] }),
                     ]);
                 }
                 // Call onSuccess callback if provided

package/dist/v2/react/hooks/useFunnel.d.ts

@@ -65,6 +65,13 @@ export interface StepConfigValue {
      * undefined = inherit all store upsells, string[] = only these IDs.
      */
     upsellOfferIds: string[] | undefined;
+    /**
+     * Payment initiator override for this step's offer/upsell charge.
+     * 'merchant' = MIT (off-session, no 3DS). 'customer' = CIT (may trigger 3DS).
+     * undefined = use SDK default (merchant).
+     * usePreviewOffer auto-applies this value; consumers usually don't need to read it.
+     */
+    paymentInitiator: 'merchant' | 'customer' | undefined;
 }
 export interface FunnelContextValue extends FunnelState {
     currentStep: {

package/dist/v2/react/hooks/useFunnel.js

@@ -20,7 +20,7 @@
  * ```
  */
 import { useMemo } from 'react';
-import { TrackingProvider, getAssignedOrderBumpOfferIds, getAssignedPaymentFlowId, getAssignedPixels, getAssignedResources, getAssignedScripts, getAssignedStepConfig, getAssignedUpsellOfferIds, } from '../../core/funnelClient';
+import { TrackingProvider, getAssignedOrderBumpOfferIds, getAssignedPaymentFlowId, getAssignedPaymentInitiator, getAssignedPixels, getAssignedResources, getAssignedScripts, getAssignedStepConfig, getAssignedUpsellOfferIds, } from '../../core/funnelClient';
 import { useTagadaContext } from '../providers/TagadaProvider';
 /**
  * Hook to access funnel state and methods
@@ -45,6 +45,7 @@ export function useFunnel() {
             getScripts: (position) => getAssignedScripts(position),
             orderBumpOfferIds: getAssignedOrderBumpOfferIds(),
             upsellOfferIds: getAssignedUpsellOfferIds(),
+            paymentInitiator: getAssignedPaymentInitiator(),
         };
     }, []);
     return {

package/dist/v2/react/hooks/useOfferQuery.d.ts

@@ -1,6 +1,14 @@
 /**
  * useOffer Hook - Single offer workflow with checkout session management
  *
+ * @deprecated Use `usePreviewOffer` instead. `usePreviewOffer` is the
+ * supported hook for post-checkout upsell pages: it skips the upfront
+ * checkout-session round-trip, recomputes pricing client-side, and applies
+ * the CRM-configured MIT/CIT payment initiator automatically via the
+ * shared OffersResource auto-pickup. `useOfferQuery` (aliased as `useOffer`)
+ * remains exported for backwards compatibility but will be removed in a
+ * future major version.
+ *
  * Behavior copied from useOffersQuery but simplified for a single offer:
  * 1. Fetches offer data
  * 2. Auto-initializes checkout session when mainOrderId is provided
@@ -106,4 +114,7 @@ export interface UseOfferQueryResult {
     /** Whether variant is loading for a product */
     isLoadingVariant: (productId: string) => boolean;
 }
+/**
+ * @deprecated Use `usePreviewOffer` instead. See module-level JSDoc.
+ */
 export declare function useOfferQuery(options: UseOfferQueryOptions): UseOfferQueryResult;

package/dist/v2/react/hooks/useOfferQuery.js

@@ -1,6 +1,14 @@
 /**
  * useOffer Hook - Single offer workflow with checkout session management
  *
+ * @deprecated Use `usePreviewOffer` instead. `usePreviewOffer` is the
+ * supported hook for post-checkout upsell pages: it skips the upfront
+ * checkout-session round-trip, recomputes pricing client-side, and applies
+ * the CRM-configured MIT/CIT payment initiator automatically via the
+ * shared OffersResource auto-pickup. `useOfferQuery` (aliased as `useOffer`)
+ * remains exported for backwards compatibility but will be removed in a
+ * future major version.
+ *
  * Behavior copied from useOffersQuery but simplified for a single offer:
  * 1. Fetches offer data
  * 2. Auto-initializes checkout session when mainOrderId is provided
@@ -14,6 +22,9 @@ import { OffersResource } from '../../core/resources/offers';
 import { useTagadaContext } from '../providers/TagadaProvider';
 import { getGlobalApiClient } from './useApiQuery';
 import { usePluginConfig } from './usePluginConfig';
+/**
+ * @deprecated Use `usePreviewOffer` instead. See module-level JSDoc.
+ */
 export function useOfferQuery(options) {
     const { offerId, enabled = true, mainOrderId: rawMainOrderId } = options;
     const { storeId } = usePluginConfig();

package/dist/v2/react/hooks/usePixelTracking.d.ts

@@ -1,15 +1,20 @@
 /**
  * usePixelTracking Hook & Provider
  *
- * SDK-level pixel tracking based on runtime stepConfig.pixels injected
- * by the CRM. Uses core/pixelMapping for event mapping and gating,
- * keeping browser-specific init/fire logic here.
+ * Thin React adapter over `core/pixelTracker`. The provider creates a tracker
+ * for the current `stepConfig.pixels`, exposes `{ track, pixelsInitialized }`
+ * via context, and disposes/recreates the tracker when pixels change.
+ *
+ * Init + fire logic lives in `core/pixelTracker` so non-React entries (Studio
+ * islands, full-SPA runtime) can fire pixels without mounting a provider.
  */
 import React from 'react';
-import { type StandardPixelEvent } from '../../core/pixelMapping';
+import { type TrackOptions } from '../../core/pixelTracker';
+import type { StandardPixelEvent } from '../../core/pixelMapping';
 export type { StandardPixelEvent } from '../../core/pixelMapping';
+export type { TrackOptions } from '../../core/pixelTracker';
 export interface PixelTrackingContextValue {
-    track: (eventName: StandardPixelEvent, parameters?: Record<string, unknown>) => void;
+    track: (eventName: StandardPixelEvent, parameters?: Record<string, unknown>, options?: TrackOptions) => void;
     pixelsInitialized: boolean;
 }
 export declare function PixelTrackingProvider({ children }: {

package/dist/v2/react/hooks/usePixelTracking.js

@@ -3,114 +3,46 @@ import { jsx as _jsx } from "react/jsx-runtime";
 /**
  * usePixelTracking Hook & Provider
  *
- * SDK-level pixel tracking based on runtime stepConfig.pixels injected
- * by the CRM. Uses core/pixelMapping for event mapping and gating,
- * keeping browser-specific init/fire logic here.
+ * Thin React adapter over `core/pixelTracker`. The provider creates a tracker
+ * for the current `stepConfig.pixels`, exposes `{ track, pixelsInitialized }`
+ * via context, and disposes/recreates the tracker when pixels change.
+ *
+ * Init + fire logic lives in `core/pixelTracker` so non-React entries (Studio
+ * islands, full-SPA runtime) can fire pixels without mounting a provider.
  */
-import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, } from 'react';
-import { resolvePixelEvents, } from '../../core/pixelMapping';
+import { createContext, useContext, useEffect, useMemo, useRef, useState, } from 'react';
+import { createPixelTracker, } from '../../core/pixelTracker';
 import { useStepConfig } from './useStepConfig';
 const PixelTrackingContext = createContext(null);
-// ---------------------------------------------------------------------------
-// Duplicate guard (time-window based)
-// ---------------------------------------------------------------------------
-function createDuplicateGuard(windowMs) {
-    const lastEvents = new Map();
-    return (eventName, parameters) => {
-        try {
-            const key = JSON.stringify({ eventName, parameters });
-            const now = Date.now();
-            const last = lastEvents.get(key);
-            if (last && now - last < windowMs)
-                return false;
-            lastEvents.set(key, now);
-            return true;
-        }
-        catch {
-            return true;
-        }
-    };
-}
-const shouldTrackEvent = createDuplicateGuard(5000);
-// ---------------------------------------------------------------------------
-// Provider
-// ---------------------------------------------------------------------------
 export function PixelTrackingProvider({ children }) {
     const { pixels } = useStepConfig();
+    const trackerRef = useRef(null);
     const [pixelsInitialized, setPixelsInitialized] = useState(false);
-    const isMountedRef = useRef(true);
-    useEffect(() => {
-        isMountedRef.current = true;
-        return () => { isMountedRef.current = false; };
-    }, []);
-    // ---- Initialize pixel scripts once ----
-    // Wait for all external scripts to actually load before marking initialized,
-    // so that pixel helpers (TikTok, etc.) can intercept events properly.
+    // Recreate the tracker when `pixels` changes. The underlying init helpers
+    // are idempotent — base scripts and per-pixel `init` calls de-duplicate
+    // themselves so a rebuild won't double-load scripts.
     useEffect(() => {
-        if (!pixels || pixelsInitialized || !isMountedRef.current)
+        if (!pixels)
             return;
-        const loadPromises = [];
-        try {
-            pixels.facebook?.forEach((px) => { if (px.enabled && px.pixelId)
-                loadPromises.push(initMetaPixel(px.pixelId)); });
-            pixels.tiktok?.forEach((px) => { if (px.enabled && px.pixelId)
-                loadPromises.push(initTikTokPixel(px.pixelId)); });
-            pixels.snapchat?.forEach((px) => { if (px.enabled && px.pixelId)
-                loadPromises.push(initSnapchatPixel(px.pixelId)); });
-            pixels.pinterest?.forEach((px) => { if (px.enabled && px.pixelId)
-                loadPromises.push(initPinterestPixel(px.pixelId)); });
-            pixels.gtm?.forEach((px) => { if (px.enabled && px.containerId)
-                loadPromises.push(initGTM(px.containerId)); });
-            Promise.all(loadPromises).then(() => {
-                if (isMountedRef.current)
-                    setPixelsInitialized(true);
-            });
-        }
-        catch (error) {
-            console.error('[SDK Pixels] Initialization error:', error);
-        }
-    }, [pixels, pixelsInitialized]);
-    // ---- Track function ----
-    const track = useCallback((eventName, parameters = {}) => {
-        if (!pixels || !pixelsInitialized || !isMountedRef.current)
-            return;
-        if (!shouldTrackEvent(eventName, parameters))
-            return;
-        try {
-            const events = resolvePixelEvents(pixels, eventName, parameters);
-            // Deduplicate by provider: Meta/Snapchat/Pinterest SDKs broadcast
-            // to all registered pixel IDs internally, so we only need to fire once per
-            // provider. GTM and TikTok need per-pixel firing (GTM for Google Ads
-            // send_to targeting, TikTok because ttq.instance() targets a specific pixel).
-            const firedProviders = new Set();
-            for (const { provider, mapped, pixel } of events) {
-                if (provider === 'gtm' || provider === 'tiktok') {
-                    fire(provider, mapped.name, mapped.params, pixel);
-                }
-                else {
-                    if (!firedProviders.has(provider)) {
-                        fire(provider, mapped.name, mapped.params);
-                        firedProviders.add(provider);
-                    }
-                }
-            }
-        }
-        catch (error) {
-            console.error('[SDK Pixels] Tracking error:', error);
-        }
-    }, [pixels, pixelsInitialized]);
-    // ---- Auto page-view ----
-    useEffect(() => {
-        if (!pixelsInitialized || !isMountedRef.current)
-            return;
-        const id = setTimeout(() => {
-            if (isMountedRef.current) {
-                track('PageView', { path: typeof window !== 'undefined' ? window.location.pathname : '' });
-            }
-        }, 0);
-        return () => clearTimeout(id);
-    }, [pixelsInitialized, track]);
-    const value = useMemo(() => ({ track, pixelsInitialized }), [track, pixelsInitialized]);
+        const tracker = createPixelTracker(pixels);
+        trackerRef.current = tracker;
+        setPixelsInitialized(false);
+        let cancelled = false;
+        tracker.initPromise.then(() => {
+            if (!cancelled)
+                setPixelsInitialized(true);
+        });
+        return () => {
+            cancelled = true;
+            trackerRef.current = null;
+        };
+    }, [pixels]);
+    const value = useMemo(() => ({
+        track: (eventName, parameters, options) => {
+            trackerRef.current?.track(eventName, parameters, options);
+        },
+        pixelsInitialized,
+    }), [pixelsInitialized]);
     return _jsx(PixelTrackingContext.Provider, { value: value, children: children });
 }
 export function usePixelTracking() {
@@ -119,277 +51,3 @@ export function usePixelTracking() {
         throw new Error('usePixelTracking must be used within a PixelTrackingProvider');
     return context;
 }
-// ---------------------------------------------------------------------------
-// Browser-specific: fire an event to the correct global pixel function
-// ---------------------------------------------------------------------------
-/* eslint-disable @typescript-eslint/no-explicit-any */
-function fire(provider, name, params, pixel) {
-    if (typeof window === 'undefined')
-        return;
-    const w = window;
-    switch (provider) {
-        case 'facebook':
-            w.fbq?.('track', name, params);
-            break;
-        case 'tiktok': {
-            // Use ttq.instance(pixelId) to target each pixel individually,
-            // since the global ttq.track() only fires for the sdkid pixel.
-            const pixelId = pixel && 'pixelId' in pixel ? pixel.pixelId : null;
-            const target = pixelId && w.ttq?.instance ? w.ttq.instance(pixelId) : w.ttq;
-            if (name === 'Pageview') {
-                target?.page?.();
-            }
-            else {
-                target?.track?.(name, params);
-            }
-            break;
-        }
-        case 'snapchat':
-            w.snaptr?.('track', name, params);
-            break;
-        case 'pinterest':
-            // Pinterest handles page views via pintrk('page'), not pintrk('track', 'pagevisit')
-            if (name === 'pagevisit') {
-                w.pintrk?.('page');
-            }
-            else {
-                w.pintrk?.('track', name, params);
-            }
-            break;
-        case 'gtm':
-            fireGTM(name, params);
-            break;
-    }
-}
-function fireGTM(event, params) {
-    try {
-        const w = window;
-        if (w.gtag) {
-            w.gtag('event', event, params);
-        }
-        else if (w.dataLayer) {
-            w.dataLayer.push({ event, ...params });
-        }
-    }
-    catch (error) {
-        console.error('[SDK GTM] Error:', error);
-    }
-}
-/* eslint-enable @typescript-eslint/no-explicit-any */
-// ===========================================================================
-// Pixel initialization (browser-only)
-// All pixel globals are accessed via `win` typed as `any` to avoid
-// `declare global` augmentation issues across tsconfig scopes.
-// ===========================================================================
-/* eslint-disable @typescript-eslint/no-explicit-any */
-const win = (typeof window !== 'undefined' ? window : undefined);
-const SCRIPT_LOAD_TIMEOUT_MS = 5000;
-function waitForScriptLoad(script) {
-    // If the script has already loaded, resolve immediately
-    if (script.dataset.loaded)
-        return Promise.resolve();
-    return new Promise((resolve) => {
-        const done = () => { script.dataset.loaded = '1'; clearTimeout(timer); resolve(); };
-        const timer = setTimeout(done, SCRIPT_LOAD_TIMEOUT_MS);
-        script.addEventListener('load', done, { once: true });
-        script.addEventListener('error', done, { once: true });
-    });
-}
-let _metaScriptEl = null;
-function initMetaPixel(pixelId) {
-    if (!win)
-        return Promise.resolve();
-    // Initialize Meta base code once
-    if (!win.fbq) {
-        const n = function (...args) {
-            if (n.callMethod)
-                n.callMethod(...args);
-            else
-                n.queue.push(args);
-        };
-        n.queue = [];
-        n.loaded = true;
-        n.version = '2.0';
-        win.fbq = n;
-        if (!win._fbq)
-            win._fbq = n;
-        const t = document.createElement('script');
-        t.async = true;
-        t.src = 'https://connect.facebook.net/en_US/fbevents.js';
-        const s = document.getElementsByTagName('script')[0];
-        s?.parentNode?.insertBefore(t, s);
-        _metaScriptEl = t;
-    }
-    // Register each pixel ID (fbq supports multiple pixels via multiple init calls)
-    win.fbq('init', pixelId);
-    return _metaScriptEl ? waitForScriptLoad(_metaScriptEl) : Promise.resolve();
-}
-let _tiktokBaseInitialized = false;
-function initTikTokPixel(pixelId) {
-    if (!win)
-        return Promise.resolve();
-    // Initialize TikTok base code once
-    if (!_tiktokBaseInitialized) {
-        _tiktokBaseInitialized = true;
-        win.TiktokAnalyticsObject = 'ttq';
-        const ttq = (win.ttq = win.ttq || []);
-        ttq.methods = [
-            'page', 'track', 'identify', 'instances', 'debug', 'on', 'off',
-            'once', 'ready', 'alias', 'group', 'enableCookie', 'disableCookie',
-            'holdConsent', 'revokeConsent', 'grantConsent',
-        ];
-        ttq.setAndDefer = function (t, e) {
-            t[e] = function (...args) { t.push([e, ...args]); };
-        };
-        for (const method of ttq.methods) {
-            ttq.setAndDefer(ttq, method);
-        }
-        ttq.instance = function (t) {
-            const e = ttq._i[t] || [];
-            for (const method of ttq.methods) {
-                ttq.setAndDefer(e, method);
-            }
-            return e;
-        };
-        ttq.load = function (e, n) {
-            const r = 'https://analytics.tiktok.com/i18n/pixel/events.js';
-            ttq._i = ttq._i || {};
-            ttq._i[e] = [];
-            ttq._i[e]._u = r;
-            ttq._t = ttq._t || {};
-            ttq._t[e] = +new Date();
-            ttq._o = ttq._o || {};
-            ttq._o[e] = n || {};
-            const s = document.createElement('script');
-            s.type = 'text/javascript';
-            s.async = true;
-            s.src = r + '?sdkid=' + e + '&lib=ttq';
-            const p = document.getElementsByTagName('script')[0];
-            p?.parentNode?.insertBefore(s, p);
-        };
-    }
-    // Skip if this specific pixel ID is already registered
-    if (win.ttq._i?.[pixelId])
-        return Promise.resolve();
-    // Register pixel and load its script
-    win.ttq.load(pixelId);
-    // Find the script we just created and wait for it
-    const scripts = document.querySelectorAll('script[src*="analytics.tiktok.com/i18n/pixel/events.js"]');
-    const lastScript = scripts[scripts.length - 1];
-    return lastScript ? waitForScriptLoad(lastScript) : Promise.resolve();
-}
-let _snapchatScriptEl = null;
-function initSnapchatPixel(pixelId) {
-    if (!win)
-        return Promise.resolve();
-    // Initialize Snapchat base code once
-    if (!win.snaptr) {
-        const a = function (...args) {
-            if (a.handleRequest)
-                a.handleRequest(...args);
-            else
-                a.queue.push(args);
-        };
-        a.queue = [];
-        win.snaptr = a;
-        const r = document.createElement('script');
-        r.async = true;
-        r.src = 'https://sc-static.net/scevent.min.js';
-        const u = document.getElementsByTagName('script')[0];
-        u?.parentNode?.insertBefore(r, u);
-        _snapchatScriptEl = r;
-    }
-    // Register each pixel ID (snaptr supports multiple pixels via multiple init calls)
-    win.snaptr('init', pixelId);
-    return _snapchatScriptEl ? waitForScriptLoad(_snapchatScriptEl) : Promise.resolve();
-}
-let _pinterestScriptEl = null;
-function initPinterestPixel(pixelId) {
-    if (!win)
-        return Promise.resolve();
-    // Initialize Pinterest base code once
-    if (!win.pintrk) {
-        const a = function (...args) { a.queue.push(args); };
-        a.queue = [];
-        win.pintrk = a;
-        const s = document.createElement('script');
-        s.async = true;
-        s.src = 'https://s.pinimg.com/ct/core.js';
-        const u = document.getElementsByTagName('script')[0];
-        u?.parentNode?.insertBefore(s, u);
-        _pinterestScriptEl = s;
-    }
-    // Register each pixel ID (pintrk supports multiple pixels via multiple load calls)
-    win.pintrk('load', pixelId);
-    // Note: pintrk('page') is NOT called here — the Provider's auto page-view
-    // effect handles it via fire(). Calling both would double-count page views.
-    return _pinterestScriptEl ? waitForScriptLoad(_pinterestScriptEl) : Promise.resolve();
-}
-function initGTM(containerId) {
-    if (!win || !containerId)
-        return Promise.resolve();
-    const isGtmContainer = containerId.startsWith('GTM-');
-    const scriptUrlPart = isGtmContainer
-        ? `googletagmanager.com/gtm.js?id=${containerId}`
-        : `googletagmanager.com/gtag/js?id=${containerId}`;
-    if (document.querySelector(`script[src*="${scriptUrlPart}"]`))
-        return Promise.resolve();
-    win.dataLayer = win.dataLayer || [];
-    // Push referrer domain context into dataLayer before GTM loads, so tags
-    // inside the container can use it for cross-domain tracking configuration.
-    try {
-        const ref = document.referrer && new URL(document.referrer).hostname;
-        if (ref && ref !== window.location.hostname) {
-            win.dataLayer.push({ tagada_referrer_domain: ref });
-        }
-    }
-    catch { /* ignore invalid referrer */ }
-    if (isGtmContainer) {
-        win.dataLayer.push({ 'gtm.start': new Date().getTime(), event: 'gtm.js' });
-        const f = document.getElementsByTagName('script')[0];
-        const j = document.createElement('script');
-        j.async = true;
-        j.src = 'https://www.googletagmanager.com/gtm.js?id=' + containerId;
-        if (f?.parentNode)
-            f.parentNode.insertBefore(j, f);
-        else
-            (document.head || document.getElementsByTagName('head')[0])?.appendChild(j);
-        const noscript = document.createElement('noscript');
-        const iframe = document.createElement('iframe');
-        iframe.src = `https://www.googletagmanager.com/ns.html?id=${containerId}`;
-        iframe.height = '0';
-        iframe.width = '0';
-        iframe.style.display = 'none';
-        iframe.style.visibility = 'hidden';
-        noscript.appendChild(iframe);
-        (document.body || document.getElementsByTagName('body')[0])?.insertBefore(noscript, document.body?.firstChild ?? null);
-        return waitForScriptLoad(j);
-    }
-    else {
-        if (!win.gtag) {
-            win.gtag = function (..._args) { win.dataLayer.push(arguments); };
-        }
-        win.gtag('js', new Date());
-        // Enable cross-domain tracking: accept incoming _gl parameter from referring
-        // domains (e.g. Shopify store → TagadaPay checkout) so Google preserves the
-        // client-id/session across the redirect.
-        const linkerConfig = { accept_incoming: true };
-        try {
-            const ref = document.referrer && new URL(document.referrer).hostname;
-            if (ref && ref !== window.location.hostname) {
-                linkerConfig.domains = [ref, window.location.hostname];
-            }
-        }
-        catch { /* ignore invalid referrer */ }
-        win.gtag('config', containerId, { linker: linkerConfig });
-        const script = document.createElement('script');
-        script.async = true;
-        script.src = 'https://www.googletagmanager.com/gtag/js?id=' + containerId;
-        const firstScript = document.getElementsByTagName('script')[0];
-        if (firstScript?.parentNode)
-            firstScript.parentNode.insertBefore(script, firstScript);
-        else
-            (document.head || document.getElementsByTagName('head')[0])?.appendChild(script);
-        return waitForScriptLoad(script);
-    }
-}

package/dist/v2/react/hooks/usePreviewOffer.d.ts

@@ -72,7 +72,9 @@ export interface UsePreviewOfferResult {
         unitAmount: number;
         currency: string;
     }>;
-    pay: (mainOrderId?: string) => Promise<{
+    pay: (mainOrderId?: string, options?: {
+        initiatedBy?: 'merchant' | 'customer';
+    }) => Promise<{
         checkoutUrl: string;
     }>;
     toCheckout: (mainOrderId?: string) => Promise<{