@tagadapay/plugin-sdk 3.1.22 → 3.1.25

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

@@ -5,12 +5,19 @@
 import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import { CheckoutResource } from '../../core/resources/checkout';
+import { getAssignedOrderBumpOfferIds } from '../../core/funnelClient';
 import { useTagadaContext } from '../providers/TagadaProvider';
 import { getGlobalApiClient } from './useApiQuery';
 import { useCurrency } from './useCurrency';
 import { usePluginConfig } from './usePluginConfig';
+const DEFAULT_MESSAGES = {
+    sessionTimeout: 'Session initialization timeout. Please refresh the page and try again.',
+    initFailed: 'Failed to initialize checkout resource',
+    noCheckoutSession: 'No checkout session available',
+};
 export function useCheckoutQuery(options = {}) {
-    const { checkoutToken: providedToken, enabled = true } = options;
+    const { checkoutToken: providedToken, enabled = true, messages: userMessages } = options;
+    const messages = { ...DEFAULT_MESSAGES, ...userMessages };
     const { storeId } = usePluginConfig();
     const currency = useCurrency();
     const queryClient = useQueryClient();
@@ -48,7 +55,7 @@ export function useCheckoutQuery(options = {}) {
                     if (sessionResolvers.current.size === 0) {
                         pendingSessionPromise.current = null;
                     }
-                    reject(new Error('Session initialization timeout. Please refresh the page and try again.'));
+                    reject(new Error(messages.sessionTimeout));
                 }
             }, 10000);
         });
@@ -60,7 +67,7 @@ export function useCheckoutQuery(options = {}) {
             return new CheckoutResource(getGlobalApiClient());
         }
         catch (error) {
-            throw new Error('Failed to initialize checkout resource: ' + (error instanceof Error ? error.message : 'Unknown error'));
+            throw new Error(messages.initFailed + ': ' + (error instanceof Error ? error.message : 'Unknown error'));
         }
     }, []);
     // Internal token state that can be updated after init
@@ -73,10 +80,14 @@ export function useCheckoutQuery(options = {}) {
     }, [providedToken, internalToken]);
     // Use provided token or internal token
     const checkoutToken = providedToken || internalToken;
+    // Only send currency to the backend when explicitly set via URL param or persisted storage.
+    // When not explicit, the backend uses the session's own selectedPresentmentCurrency --
+    // the frontend then reads the currency from the response, never guesses.
+    const explicitCurrency = currency.isExplicit ? currency.code : undefined;
     // Main checkout query
     const { data: checkout, isLoading, error, isSuccess, refetch, } = useQuery({
-        queryKey: ['checkout', checkoutToken, currency.code],
-        queryFn: () => checkoutResource.getCheckout(checkoutToken, currency.code),
+        queryKey: ['checkout', checkoutToken, explicitCurrency],
+        queryFn: () => checkoutResource.getCheckout(checkoutToken, explicitCurrency),
         enabled: enabled && !!checkoutToken && isSessionInitialized,
         staleTime: 30000, // 30 seconds
         refetchOnWindowFocus: false,
@@ -90,16 +101,17 @@ export function useCheckoutQuery(options = {}) {
     // Initialize checkout mutation (async mode for fast response)
     const initMutation = useMutation({
         mutationFn: async (params) => {
+            const enabledOrderBumpOfferIds = params.enabledOrderBumpOfferIds ?? getAssignedOrderBumpOfferIds();
             const requestBody = {
                 ...params,
                 storeId: params.storeId || storeId,
                 returnUrl: params.returnUrl || window.location.origin,
-                // Include customerId from session to prevent duplicate customer creation
                 customerId: params.customerId || session?.customerId,
                 customer: {
                     ...params.customer,
                     currency: params.customer?.currency ?? currency.code,
                 },
+                ...(enabledOrderBumpOfferIds && { enabledOrderBumpOfferIds }),
             };
             // Use async mode for fast response (~50ms vs 2-5s)
             const asyncResponse = await checkoutResource.initCheckoutAsync(requestBody);
@@ -125,7 +137,7 @@ export function useCheckoutQuery(options = {}) {
     const replaceSessionLineItemsMutation = useMutation({
         mutationFn: ({ lineItems }) => {
             if (!checkout?.checkoutSession?.id) {
-                throw new Error('No checkout session available');
+                throw new Error(messages.noCheckoutSession);
             }
             return checkoutResource.replaceSessionLineItems(checkout.checkoutSession.id, lineItems);
         },
@@ -139,7 +151,7 @@ export function useCheckoutQuery(options = {}) {
     const lineItemsMutation = useMutation({
         mutationFn: ({ lineItems }) => {
             if (!checkout?.checkoutSession?.id) {
-                throw new Error('No checkout session available');
+                throw new Error(messages.noCheckoutSession);
             }
             return checkoutResource.updateLineItems(checkout.checkoutSession.id, lineItems);
         },
@@ -184,7 +196,7 @@ export function useCheckoutQuery(options = {}) {
     const addLineItemsMutation = useMutation({
         mutationFn: ({ lineItems }) => {
             if (!checkout?.checkoutSession?.id) {
-                throw new Error('No checkout session available');
+                throw new Error(messages.noCheckoutSession);
             }
             return checkoutResource.addLineItems(checkout.checkoutSession.id, lineItems);
         },
@@ -198,7 +210,7 @@ export function useCheckoutQuery(options = {}) {
     const removeLineItemsMutation = useMutation({
         mutationFn: ({ lineItems }) => {
             if (!checkout?.checkoutSession?.id) {
-                throw new Error('No checkout session available');
+                throw new Error(messages.noCheckoutSession);
             }
             return checkoutResource.removeLineItems(checkout.checkoutSession.id, lineItems);
         },
@@ -212,7 +224,7 @@ export function useCheckoutQuery(options = {}) {
     const quantityMutation = useMutation({
         mutationFn: ({ variantId, quantity, priceId }) => {
             if (!checkout?.checkoutSession?.id) {
-                throw new Error('No checkout session available');
+                throw new Error(messages.noCheckoutSession);
             }
             return checkoutResource.setItemQuantity(checkout.checkoutSession.id, variantId, quantity, priceId);
         },
@@ -226,7 +238,7 @@ export function useCheckoutQuery(options = {}) {
     const customerMutation = useMutation({
         mutationFn: (data) => {
             if (!checkout?.checkoutSession?.id) {
-                throw new Error('No checkout session available');
+                throw new Error(messages.noCheckoutSession);
             }
             return checkoutResource.updateCustomer(checkout.checkoutSession.id, data);
         },
@@ -240,7 +252,7 @@ export function useCheckoutQuery(options = {}) {
     const customerAndSessionMutation = useMutation({
         mutationFn: (data) => {
             if (!checkout?.checkoutSession?.id) {
-                throw new Error('No checkout session available');
+                throw new Error(messages.noCheckoutSession);
             }
             return checkoutResource.updateCustomerAndSessionInfo(checkout.checkoutSession.id, data);
         },
@@ -254,7 +266,7 @@ export function useCheckoutQuery(options = {}) {
     const promotionMutation = useMutation({
         mutationFn: ({ code }) => {
             if (!checkout?.checkoutSession?.id) {
-                throw new Error('No checkout session available');
+                throw new Error(messages.noCheckoutSession);
             }
             return checkoutResource.applyPromotionCode(checkout.checkoutSession.id, code);
         },
@@ -271,7 +283,7 @@ export function useCheckoutQuery(options = {}) {
     const removePromotionMutation = useMutation({
         mutationFn: ({ promotionId }) => {
             if (!checkout?.checkoutSession?.id) {
-                throw new Error('No checkout session available');
+                throw new Error(messages.noCheckoutSession);
             }
             return checkoutResource.removePromotion(checkout.checkoutSession.id, promotionId);
         },

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

@@ -14,8 +14,8 @@
  * // In any child component:
  * const { context, next, isLoading, stepConfig } = useFunnel();
  *
- * // Access step-specific config (payment flows, static resources, etc.)
- * const offerId = stepConfig.staticResources?.offer;
+ * // Access step-specific config (payment flows, resources, etc.)
+ * const offerId = stepConfig.resources?.offer;
  * const paymentFlowId = stepConfig.paymentFlowId;
  * ```
  */
@@ -35,10 +35,11 @@ export interface StepConfigValue {
      */
     paymentFlowId: string | undefined;
     /**
-     * Static resources assigned to this step/variant
-     * For A/B tests, this contains the resources for the specific variant
+     * Resource bindings for this step/variant.
      * e.g., { offer: 'offer_xxx', product: 'product_xxx' }
      */
+    resources: Record<string, string> | undefined;
+    /** @deprecated Use `resources` instead */
     staticResources: Record<string, string> | undefined;
     /**
      * Get scripts for a specific injection position
@@ -54,6 +55,16 @@ export interface StepConfigValue {
         [TrackingProvider.SNAPCHAT]?: SnapchatTrackingConfig[];
         [TrackingProvider.GTM]?: GTMTrackingConfig[];
     };
+    /**
+     * Enabled order bump offer IDs for this step.
+     * undefined = inherit all store bumps, string[] = only these IDs.
+     */
+    orderBumpOfferIds: string[] | undefined;
+    /**
+     * Enabled upsell offer IDs for this step.
+     * undefined = inherit all store upsells, string[] = only these IDs.
+     */
+    upsellOfferIds: string[] | undefined;
 }
 export interface FunnelContextValue extends FunnelState {
     currentStep: {

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

@@ -14,13 +14,13 @@
  * // In any child component:
  * const { context, next, isLoading, stepConfig } = useFunnel();
  *
- * // Access step-specific config (payment flows, static resources, etc.)
- * const offerId = stepConfig.staticResources?.offer;
+ * // Access step-specific config (payment flows, resources, etc.)
+ * const offerId = stepConfig.resources?.offer;
  * const paymentFlowId = stepConfig.paymentFlowId;
  * ```
  */
 import { useMemo } from 'react';
-import { TrackingProvider, getAssignedPaymentFlowId, getAssignedPixels, getAssignedScripts, getAssignedStaticResources, getAssignedStepConfig } from '../../core/funnelClient';
+import { TrackingProvider, getAssignedOrderBumpOfferIds, getAssignedPaymentFlowId, getAssignedPixels, getAssignedResources, getAssignedScripts, getAssignedStepConfig, getAssignedUpsellOfferIds, } from '../../core/funnelClient';
 import { useTagadaContext } from '../providers/TagadaProvider';
 /**
  * Hook to access funnel state and methods
@@ -35,12 +35,16 @@ export function useFunnel() {
     // Compute step config from HTML injection (memoized, computed once on mount)
     const stepConfig = useMemo(() => {
         const raw = getAssignedStepConfig();
+        const resources = getAssignedResources();
         return {
             raw,
             paymentFlowId: getAssignedPaymentFlowId(),
-            staticResources: getAssignedStaticResources(),
+            resources,
+            staticResources: resources,
             pixels: getAssignedPixels(),
             getScripts: (position) => getAssignedScripts(position),
+            orderBumpOfferIds: getAssignedOrderBumpOfferIds(),
+            upsellOfferIds: getAssignedUpsellOfferIds(),
         };
     }, []);
     return {

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

@@ -68,6 +68,8 @@ export interface UseGoogleAutocompleteOptions {
     version?: string;
     language?: string;
     region?: string;
+    /** When true, defer loading the Google Maps script until searchPlaces() is first called. Default: false (eager load). */
+    defer?: boolean;
 }
 export interface UseGoogleAutocompleteResult {
     predictions: GooglePrediction[];

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

@@ -8,7 +8,7 @@ import { useCallback, useEffect, useRef, useState } from 'react';
  * Automatically loads the Google Maps JavaScript API with Places library
  */
 export function useGoogleAutocomplete(options) {
-    const { apiKey, libraries = ['places'], version = 'weekly', language, region } = options;
+    const { apiKey, libraries = ['places'], version = 'weekly', language, region, defer = false } = options;
     const [predictions, setPredictions] = useState([]);
     const [isLoading, setIsLoading] = useState(false);
     const [isScriptLoaded, setIsScriptLoaded] = useState(false);
@@ -16,19 +16,16 @@ export function useGoogleAutocomplete(options) {
     const placesServiceRef = useRef(null);
     const scriptLoadedRef = useRef(false);
     const debounceTimeoutRef = useRef(null);
-    // Inject Google Maps script
-    useEffect(() => {
-        if (!apiKey) {
-            return;
-        }
+    const pendingSearchRef = useRef(null);
+    // Shared script injection logic (used by both eager useEffect and lazy trigger)
+    const injectScript = useCallback(() => {
         if (scriptLoadedRef.current || window.google?.maps) {
             setIsScriptLoaded(true);
+            scriptLoadedRef.current = true;
             return;
         }
-        // Check if script is already being loaded
         const existingScript = document.querySelector('script[src*="maps.googleapis.com"]');
         if (existingScript) {
-            // Wait for existing script to load
             const checkLoaded = () => {
                 if (window.google?.maps?.places?.AutocompleteService) {
                     setIsScriptLoaded(true);
@@ -41,7 +38,6 @@ export function useGoogleAutocomplete(options) {
             checkLoaded();
             return;
         }
-        // Create and inject the script
         const script = document.createElement('script');
         const params = new URLSearchParams({
             key: apiKey,
@@ -63,12 +59,23 @@ export function useGoogleAutocomplete(options) {
             // Failed to load Google Maps API
         };
         document.head.appendChild(script);
-        // Cleanup function
-        return () => {
-            // Note: We don't remove the script as it might be used by other components
-            // The script will remain in the DOM for the session
-        };
     }, [apiKey, libraries, version, language, region]);
+    // Inject Google Maps script eagerly (unless defer is true)
+    useEffect(() => {
+        if (!apiKey || defer) {
+            return;
+        }
+        injectScript();
+    }, [apiKey, defer, injectScript]);
+    // When script finishes loading in deferred mode, replay the pending search
+    const searchPlacesRef = useRef(null);
+    useEffect(() => {
+        if (isScriptLoaded && pendingSearchRef.current && searchPlacesRef.current) {
+            const { input, countryRestriction } = pendingSearchRef.current;
+            pendingSearchRef.current = null;
+            searchPlacesRef.current(input, countryRestriction);
+        }
+    }, [isScriptLoaded]);
     // Initialize Google Places services
     const initializeServices = useCallback(() => {
         if (typeof window === 'undefined')
@@ -89,6 +96,11 @@ export function useGoogleAutocomplete(options) {
     // Search for place predictions
     const searchPlaces = useCallback((input, countryRestriction) => {
         if (!isScriptLoaded) {
+            // When deferred, trigger lazy load and queue the search for replay
+            if (defer && !scriptLoadedRef.current) {
+                pendingSearchRef.current = { input, countryRestriction };
+                injectScript();
+            }
             return;
         }
         if (!initializeServices()) {
@@ -124,7 +136,9 @@ export function useGoogleAutocomplete(options) {
                 }
             });
         }, 300); // 300ms debounce
-    }, [initializeServices, isScriptLoaded]);
+    }, [initializeServices, isScriptLoaded, defer, injectScript]);
+    // Keep ref in sync so the deferred-replay useEffect can call searchPlaces
+    searchPlacesRef.current = searchPlaces;
     // Get detailed place information
     const getPlaceDetails = useCallback((placeId) => {
         return new Promise((resolve) => {

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

@@ -18,11 +18,8 @@ export interface UseISODataResult {
     registeredLanguages: SupportedLanguage[];
 }
 /**
- * React hook for accessing ISO3166 countries and regions data with dynamic language loading
- * @param language - Language code (supports: en, ru, de, fr, es, zh, hi, pt, ja, ar, it, he)
- * @param autoImport - Whether to automatically import the language if not registered (default: true)
- * @param disputeSetting - Territorial dispute perspective (currently only UN is supported)
- * @returns Object with countries data and helper functions
+ * React hook for accessing ISO3166 countries and regions data.
+ * Fetches slim JSON from CDN on first use, then caches in memory.
  */
 export declare function useISOData(language?: SupportedLanguage, autoImport?: boolean, disputeSetting?: string): UseISODataResult;
 /**

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

@@ -1,35 +1,40 @@
 import { useMemo, useEffect, useState, useCallback } from 'react';
-// Import the pre-built ISO data functions
-import { getCountries, getStatesForCountry, importLanguage, isLanguageRegistered, getRegisteredLanguages } from '../../../data/iso3166';
+import { getCountries, getStatesForCountry, ensureGeoDataLoaded, importLanguage, isLanguageRegistered, getRegisteredLanguages } from '../../../data/iso3166';
 /**
- * React hook for accessing ISO3166 countries and regions data with dynamic language loading
- * @param language - Language code (supports: en, ru, de, fr, es, zh, hi, pt, ja, ar, it, he)
- * @param autoImport - Whether to automatically import the language if not registered (default: true)
- * @param disputeSetting - Territorial dispute perspective (currently only UN is supported)
- * @returns Object with countries data and helper functions
+ * React hook for accessing ISO3166 countries and regions data.
+ * Fetches slim JSON from CDN on first use, then caches in memory.
  */
 export function useISOData(language = 'en', autoImport = true, disputeSetting = 'UN') {
     const [isLanguageLoaded, setIsLanguageLoaded] = useState(isLanguageRegistered(language));
     const [registeredLanguages, setRegisteredLanguages] = useState(getRegisteredLanguages);
-    // Auto-import language if not registered and autoImport is true
+    // Fetch geodata from CDN (countries + regions) for the requested language
     useEffect(() => {
-        if (!isLanguageRegistered(language) && autoImport && language !== 'en') {
-            importLanguage(language)
-                .then(() => {
+        let cancelled = false;
+        ensureGeoDataLoaded(language)
+            .then(() => {
+            if (!cancelled) {
                 setIsLanguageLoaded(true);
                 setRegisteredLanguages(getRegisteredLanguages());
-            })
-                .catch((error) => {
-            });
-        }
+            }
+        })
+            .catch((err) => {
+            console.error('[SDK] Failed to load geodata from CDN:', err);
+        });
+        return () => { cancelled = true; };
     }, [language, autoImport]);
     const data = useMemo(() => {
+        if (!isLanguageLoaded) {
+            return {
+                countries: {},
+                getRegions: () => [],
+                findRegion: () => null,
+                mapGoogleToISO: () => null,
+                isLanguageLoaded: false,
+                registeredLanguages,
+            };
+        }
         try {
-            console.log('[SDK] Loading ISO data for language:', language, 'autoImport:', autoImport);
-            // Get countries from pre-built data with language support
             const countriesArray = getCountries(language);
-            console.log('[SDK] Loaded countries count:', countriesArray.length);
-            // Transform to our expected format (Record<string, ISOCountry>)
             const countries = {};
             countriesArray.forEach((country) => {
                 countries[country.code] = {
@@ -39,7 +44,6 @@ export function useISOData(language = 'en', autoImport = true, disputeSetting =
                     name: country.name,
                 };
             });
-            // Helper to load regions for a specific country
             const getRegions = (countryCode) => {
                 try {
                     const states = getStatesForCountry(countryCode, language);
@@ -49,31 +53,26 @@ export function useISOData(language = 'en', autoImport = true, disputeSetting =
                     }));
                 }
                 catch {
-                    return []; // Return empty array if no regions
+                    return [];
                 }
             };
-            // Find a specific region by ISO code
             const findRegion = (countryCode, regionCode) => {
                 const regions = getRegions(countryCode);
                 return regions.find((region) => region.iso === regionCode) ?? null;
             };
-            // Map Google Places state to ISO region (proven 100% success rate)
             const mapGoogleToISO = (googleState, googleStateLong, countryCode) => {
                 const regions = getRegions(countryCode);
                 if (regions.length === 0)
                     return null;
-                // Strategy 1: Exact ISO code match (86% success rate)
                 let match = regions.find((r) => r.iso === googleState);
                 if (match)
                     return match;
-                // Strategy 2: Name matching (14% success rate)
                 match = regions.find((r) => r.name.toLowerCase() === googleState.toLowerCase());
                 if (match)
                     return match;
                 match = regions.find((r) => r.name.toLowerCase() === googleStateLong.toLowerCase());
                 if (match)
                     return match;
-                // Strategy 3: Partial name matching (fallback)
                 match = regions.find((r) => r.name.toLowerCase().includes(googleStateLong.toLowerCase()) ||
                     googleStateLong.toLowerCase().includes(r.name.toLowerCase()));
                 return match ?? null;

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

@@ -2,9 +2,9 @@ export interface Payment {
     id: string;
     status: string;
     subStatus: string;
-    requireAction: 'none' | 'redirect' | 'redirect_to_payment' | 'error' | 'radar';
+    requireAction: 'none' | 'redirect' | 'redirect_to_payment' | 'error' | 'radar' | 'stripe_express_checkout';
     requireActionData?: {
-        type: 'redirect' | 'redirect_to_payment' | 'threeds_auth' | 'processor_auth' | 'error' | 'stripe_radar' | 'finix_radar' | 'radar' | 'kesspay_auth' | 'trustflow_auth' | 'mastercard_auth';
+        type: 'redirect' | 'redirect_to_payment' | 'threeds_auth' | 'processor_auth' | 'error' | 'stripe_radar' | 'finix_radar' | 'radar' | 'kesspay_auth' | 'trustflow_auth' | 'mastercard_auth' | 'stripe_express_checkout';
         url?: string;
         processed: boolean;
         processorId?: string;