@tagadapay/plugin-sdk 4.0.0 → 4.0.4

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

@@ -228,13 +228,15 @@ export function usePreviewOffer(options) {
         });
     }, [summary, effectiveCurrency]);
     // Pay for the offer with current selections
-    const pay = useCallback(async (mainOrderId) => {
+    const pay = useCallback(async (mainOrderId, payOptions) => {
         if (isPaying) {
             throw new Error('Payment already in progress');
         }
         setIsPaying(true);
         try {
-            const result = await offersResource.payPreviewedOffer(offerId, effectiveCurrency, lineItemsForPreview, typeof window !== 'undefined' ? window.location.href : undefined, mainOrderId);
+            // initiatedBy auto-picks from stepConfig.paymentInitiator inside
+            // OffersResource.payPreviewedOffer when not supplied here.
+            const result = await offersResource.payPreviewedOffer(offerId, effectiveCurrency, lineItemsForPreview, typeof window !== 'undefined' ? window.location.href : undefined, mainOrderId, payOptions?.initiatedBy);
             console.log('[usePreviewOffer] Payment initiated:', result);
             return {
                 checkoutUrl: result.checkout.checkoutUrl,

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

@@ -6,19 +6,21 @@ import { useMemo } from 'react';
 import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';
 import { PromotionsResource } from '../../core/resources/promotions';
 import { getGlobalApiClient } from './useApiQuery';
+import { useTagadaContext } from '../providers/TagadaProvider';
 export function usePromotionsQuery(options = {}) {
     const { checkoutSessionId, enabled = true } = options;
     const queryClient = useQueryClient();
-    const client = getGlobalApiClient();
+    const apiClient = getGlobalApiClient();
+    const { client } = useTagadaContext();
     // Create resource client
     const promotionsResource = useMemo(() => {
         try {
-            return new PromotionsResource(client);
+            return new PromotionsResource(apiClient, client.bus);
         }
         catch (error) {
             throw new Error('Failed to initialize promotions resource: ' + (error instanceof Error ? error.message : 'Unknown error'));
         }
-    }, [client]);
+    }, [apiClient, client.bus]);
     // Main promotions query
     const { data: appliedPromotions = [], isLoading, error, refetch, } = useQuery({
         queryKey: ['promotions', checkoutSessionId],
@@ -40,6 +42,8 @@ export function usePromotionsQuery(options = {}) {
             if (checkoutSessionId) {
                 void queryClient.invalidateQueries({ queryKey: ['promotions', checkoutSessionId] });
                 void queryClient.invalidateQueries({ queryKey: ['checkout', checkoutSessionId] });
+                void queryClient.invalidateQueries({ queryKey: ['shipping-rates', checkoutSessionId] });
+                void queryClient.invalidateQueries({ queryKey: ['shipping-rates-preview', checkoutSessionId] });
             }
         },
     });
@@ -56,6 +60,8 @@ export function usePromotionsQuery(options = {}) {
             if (checkoutSessionId) {
                 void queryClient.invalidateQueries({ queryKey: ['promotions', checkoutSessionId] });
                 void queryClient.invalidateQueries({ queryKey: ['checkout', checkoutSessionId] });
+                void queryClient.invalidateQueries({ queryKey: ['shipping-rates', checkoutSessionId] });
+                void queryClient.invalidateQueries({ queryKey: ['shipping-rates-preview', checkoutSessionId] });
             }
         },
     });

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

@@ -23,9 +23,8 @@ export function useShippingRatesQuery(options = {}) {
     const effectiveSessionId = sessionId || checkout?.checkoutSession?.id;
     // Track if we've synced the initial selection from checkout
     const hasSyncedInitialSelectionRef = useRef(false);
-    // Preview rates state
-    const [previewedRates, setPreviewedRates] = useState();
-    const [isPreviewLoading, setIsPreviewLoading] = useState(false);
+    // Preview rates params - triggers preview query when set
+    const [previewParams, setPreviewParams] = useState(null);
     // Main shipping rates query
     const { data: shippingRatesData, isLoading: isFetching, error: fetchError, refetch: refetchRates, } = useQuery({
         queryKey: ['shipping-rates', effectiveSessionId],
@@ -54,6 +53,23 @@ export function useShippingRatesQuery(options = {}) {
     });
     // Get sorted shipping rates from query data
     const shippingRates = shippingRatesData?.rates;
+    // Preview shipping rates query - invalidated by promotions mutations
+    const { data: previewedRates, isLoading: isPreviewLoading, } = useQuery({
+        queryKey: ['shipping-rates-preview', effectiveSessionId, previewParams?.countryCode, previewParams?.stateCode],
+        queryFn: async () => {
+            const response = await shippingRatesResource.previewShippingRates(effectiveSessionId, previewParams);
+            return [...response.rates].sort((a, b) => {
+                if (a.isFree && !b.isFree)
+                    return -1;
+                if (!a.isFree && b.isFree)
+                    return 1;
+                return (a.amount ?? 0) - (b.amount ?? 0);
+            });
+        },
+        enabled: !!effectiveSessionId && !!previewParams,
+        staleTime: 30000,
+        refetchOnWindowFocus: false,
+    });
     // Get selected rate from checkout data
     const checkoutSelectedRateId = checkout?.checkoutSession?.shippingRate?.id;
     // Set shipping rate mutation
@@ -137,31 +153,30 @@ export function useShippingRatesQuery(options = {}) {
     const previewRates = useCallback(async (countryCode, stateCode) => {
         if (!enabled || !effectiveSessionId)
             return [];
+        setPreviewParams({ countryCode, stateCode });
         try {
-            setIsPreviewLoading(true);
-            const response = await shippingRatesResource.previewShippingRates(effectiveSessionId, {
-                countryCode,
-                stateCode,
-            });
-            // Sort rates: free first, then by ascending amount
-            const sortedRates = [...response.rates].sort((a, b) => {
-                if (a.isFree && !b.isFree)
-                    return -1;
-                if (!a.isFree && b.isFree)
-                    return 1;
-                return (a.amount ?? 0) - (b.amount ?? 0);
+            return await queryClient.fetchQuery({
+                queryKey: ['shipping-rates-preview', effectiveSessionId, countryCode, stateCode],
+                queryFn: async () => {
+                    const response = await shippingRatesResource.previewShippingRates(effectiveSessionId, {
+                        countryCode,
+                        stateCode,
+                    });
+                    return [...response.rates].sort((a, b) => {
+                        if (a.isFree && !b.isFree)
+                            return -1;
+                        if (!a.isFree && b.isFree)
+                            return 1;
+                        return (a.amount ?? 0) - (b.amount ?? 0);
+                    });
+                },
             });
-            setPreviewedRates(sortedRates);
-            return sortedRates;
         }
         catch (error) {
             console.error('[useShippingRatesQuery] Error previewing shipping rates:', error);
             return [];
         }
-        finally {
-            setIsPreviewLoading(false);
-        }
-    }, [enabled, effectiveSessionId, shippingRatesResource]);
+    }, [enabled, effectiveSessionId, queryClient, shippingRatesResource]);
     return {
         shippingRates,
         selectedRate,

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

@@ -63,6 +63,15 @@ export interface UseStepConfigResult {
      * undefined = inherit all store upsells, string[] = only these IDs.
      */
     upsellOfferIds: string[] | undefined;
+    /**
+     * Enabled in-step checkout-offer upsell IDs (tiered selector).
+     * undefined = inherit all store upsells of type='upsell'.
+     */
+    checkoutOfferIds: string[] | undefined;
+    /**
+     * Default checkout-offer upsell ID configured for this step (if any).
+     */
+    checkoutOfferDefaultId: string | undefined;
 }
 /**
  * Hook to access runtime step configuration injected via HTML

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

@@ -22,7 +22,7 @@
  * ```
  */
 import { useMemo } from 'react';
-import { getAssignedOrderBumpOfferIds, getAssignedPaymentFlowId, getAssignedPixels, getAssignedResources, getAssignedScripts, getAssignedStepConfig, getAssignedUpsellOfferIds, } from '../../core/funnelClient';
+import { getAssignedCheckoutOfferDefault, getAssignedCheckoutOfferIds, getAssignedOrderBumpOfferIds, getAssignedPaymentFlowId, getAssignedPixels, getAssignedResources, getAssignedScripts, getAssignedStepConfig, getAssignedUpsellOfferIds, } from '../../core/funnelClient';
 /**
  * Hook to access runtime step configuration injected via HTML
  *
@@ -46,6 +46,8 @@ export function useStepConfig() {
     const paymentSetupConfig = useMemo(() => stepConfig?.paymentSetupConfig, [stepConfig]);
     const orderBumpOfferIds = useMemo(() => getAssignedOrderBumpOfferIds(), []);
     const upsellOfferIds = useMemo(() => getAssignedUpsellOfferIds(), []);
+    const checkoutOfferIds = useMemo(() => getAssignedCheckoutOfferIds(), []);
+    const checkoutOfferDefaultId = useMemo(() => getAssignedCheckoutOfferDefault(), []);
     return {
         stepConfig,
         paymentFlowId,
@@ -56,5 +58,7 @@ export function useStepConfig() {
         paymentSetupConfig,
         orderBumpOfferIds,
         upsellOfferIds,
+        checkoutOfferIds,
+        checkoutOfferDefaultId,
     };
 }

package/dist/v2/react/index.d.ts

@@ -33,6 +33,7 @@ export { queryKeys, useApiMutation, useApiQuery, useInvalidateQuery, usePreloadQ
 export { useCheckoutQuery as useCheckout } from './hooks/useCheckoutQuery';
 export { useCurrency } from './hooks/useCurrency';
 export { useDiscountsQuery as useDiscounts } from './hooks/useDiscountsQuery';
+/** @deprecated Use `usePreviewOffer` instead. */
 export { useOfferQuery as useOffer } from './hooks/useOfferQuery';
 export { useOrderBumpQuery as useOrderBump } from './hooks/useOrderBumpQuery';
 export { useOrderQuery as useOrder } from './hooks/useOrderQuery';
@@ -99,6 +100,10 @@ export type { UseStoreConfigQueryOptions as UseStoreConfigOptions, UseStoreConfi
 export type { PaymentInstrument, ThreedsChallenge, ThreedsHook, ThreedsOptions, ThreedsProvider, ThreedsSession } from './hooks/useThreeds';
 export type { UseVipOffersQueryOptions as UseVipOffersOptions, UseVipOffersQueryResult as UseVipOffersResult } from './hooks/useVipOffersQuery';
 export { formatMoney } from '../../react/utils/money';
+export { makeMetaEventId } from '../core/utils/metaEventId';
+export type { TrackOptions } from './hooks/usePixelTracking';
+export { resolveClickId, publishTrackingGlobal, CLICK_ID_URL_PARAMS, CLICK_ID_COOKIES, } from '../core/utils/clickIdResolver';
+export type { ResolvedClickId, TagadaTrackingGlobal, ClickIdSource, } from '../core/utils/clickIdResolver';
 export { TagadaError, TagadaApiError, TagadaNetworkError, TagadaAuthError, TagadaValidationError, TagadaCircuitBreakerError, TagadaErrorCode, } from '../core/errors';
 export type { TagadaErrorOptions, TagadaErrorCodeValue } from '../core/errors';
 export type { PaymentMethodName } from '../core/resources/checkout';

package/dist/v2/react/index.js

@@ -35,6 +35,7 @@ export { queryKeys, useApiMutation, useApiQuery, useInvalidateQuery, usePreloadQ
 export { useCheckoutQuery as useCheckout } from './hooks/useCheckoutQuery';
 export { useCurrency } from './hooks/useCurrency';
 export { useDiscountsQuery as useDiscounts } from './hooks/useDiscountsQuery';
+/** @deprecated Use `usePreviewOffer` instead. */
 export { useOfferQuery as useOffer } from './hooks/useOfferQuery';
 export { useOrderBumpQuery as useOrderBump } from './hooks/useOrderBumpQuery';
 export { useOrderQuery as useOrder } from './hooks/useOrderQuery';
@@ -63,5 +64,13 @@ export { FunnelActionType } from '../core/resources/funnel';
 export { getEnabledMethods, getExpressMethods, getExpressMethodsByProcessor, findMethod, isMethodEnabled } from '../core/funnelClient';
 // Re-export utilities from main react
 export { formatMoney } from '../../react/utils/money';
+// Meta CAPI / browser pixel deduplication helper.
+// Use this to build a stable `eventId` shared between the browser pixel
+// (`track('Purchase', params, { eventId })`) and the server-side Meta CAPI
+// `ServerEvent.setEventId(...)`. Both sides must agree on the formula.
+export { makeMetaEventId } from '../core/utils/metaEventId';
+// Click-id resolver (ad-tracker integrations: ClickFlare, Voluum, Binom, RedTrack, ClickMagick, …)
+// Lives in core (runtime-agnostic) so the standalone SDK / studio builder can use it too.
+export { resolveClickId, publishTrackingGlobal, CLICK_ID_URL_PARAMS, CLICK_ID_COOKIES, } from '../core/utils/clickIdResolver';
 // Error types
 export { TagadaError, TagadaApiError, TagadaNetworkError, TagadaAuthError, TagadaValidationError, TagadaCircuitBreakerError, TagadaErrorCode, } from '../core/errors';

package/dist/v2/react/providers/TagadaProvider.js

@@ -10,6 +10,19 @@ import { convertCurrency, formatMoney, formatMoneyWithoutSymbol, formatSimpleMon
 import { TagadaClient } from '../../core/client';
 import { setGlobalApiClient } from '../hooks/useApiQuery';
 import { PixelTrackingProvider } from '../hooks/usePixelTracking';
+import { publishTrackingGlobal } from '../../core/utils/clickIdResolver';
+// Publish window.TagadaPay.tracking eagerly at module-load time so merchant
+// postback scripts injected by <FunnelScriptInjector /> (which run from child
+// useEffects, BEFORE the parent provider's useEffects) can read it. Idempotent
+// — safe if standalone SDK already published.
+if (typeof window !== 'undefined') {
+    try {
+        publishTrackingGlobal();
+    }
+    catch (error) {
+        console.error('[TagadaProvider] Failed to publish tracking global:', error);
+    }
+}
 const FunnelScriptInjector = lazy(() => import('../components/FunnelScriptInjector').then(m => ({ default: m.FunnelScriptInjector })));
 const DebugDrawer = lazy(() => import('../components/DebugDrawer'));
 // Professional, subtle loading component for initialization
@@ -38,11 +51,11 @@ const InitializationLoader = () => (_jsxs("div", { style: {
                 borderTop: '1.5px solid #9ca3af',
                 borderRadius: '50%',
                 animation: 'tagada-spin 1s linear infinite',
-            } }), _jsx("span", { children: "Loading..." }), _jsx("style", { children: `
-        @keyframes tagada-spin {
-          0% { transform: rotate(0deg); }
-          100% { transform: rotate(360deg); }
-        }
+            } }), _jsx("span", { children: "Loading..." }), _jsx("style", { children: `
+        @keyframes tagada-spin {
+          0% { transform: rotate(0deg); }
+          100% { transform: rotate(360deg); }
+        }
       ` })] }));
 const TagadaContext = createContext(null);
 export function TagadaProvider({ children, environment, customApiConfig, debugMode, localConfig, blockUntilSessionReady = false, rawPluginConfig, features, funnelId, autoInitializeFunnel = true, onNavigate, onFunnelError, debugScripts = [], }) {

package/dist/v2/standalone/apple-pay-service.d.ts

@@ -9,4 +9,4 @@
  * (studio-app, vanilla-checkout templates, …) keep working without
  * code changes.
  */
-export { isApplePayAvailable, startApplePaySession, type ApplePayServiceConfig, type ApplePayPaymentRequest, type ApplePayTokenResult, type ApplePayShippingContact, type ApplePayCallbacks, } from '@tagadapay/core-js';
+export { isApplePayAvailable, startApplePaySession, type ApplePayServiceConfig, type ApplePayPaymentRequest, type ApplePayTokenResult, type ApplePayShippingContact, type ApplePayCallbacks, type ApplePayInlineError, } from '@tagadapay/core-js';

package/dist/v2/standalone/index.d.ts

@@ -57,6 +57,7 @@ export { isApplePayAvailable, startApplePaySession } from './apple-pay-service';
 export type { ApplePayServiceConfig, ApplePayPaymentRequest, ApplePayTokenResult, ApplePayShippingContact, ApplePayCallbacks, } from './apple-pay-service';
 export { isGooglePayAvailable, startGooglePaySession } from './google-pay-service';
 export type { GooglePayServiceConfig, GooglePayPaymentRequest, GooglePayTokenResult, GooglePayAddress, GooglePayCallbacks, } from './google-pay-service';
+export { formatMoney, getCurrencyInfo, moneyStringOrNumberToMinorUnits, minorUnitsToMajorUnits, } from '../../react/utils/money';
 /**
  * Get BasisTheory public API key based on hostname detection.
  * Delegates to the centralized isProductionBasisTheory() logic.
@@ -68,3 +69,5 @@ export declare function getBasisTheoryApiKey(): string;
 export declare function getBasisTheoryTenantId(): string;
 export { TagadaTracker, TagadaExternalTracker, } from './external-tracker';
 export type { TagadaTrackerConfig, ExternalTrackerSession, NavigateOptions, } from './external-tracker';
+export { resolveClickId, publishTrackingGlobal, CLICK_ID_URL_PARAMS, CLICK_ID_COOKIES, } from '../core/utils/clickIdResolver';
+export type { ResolvedClickId, TagadaTrackingGlobal, ClickIdSource, } from '../core/utils/clickIdResolver';

package/dist/v2/standalone/index.js

@@ -11,6 +11,7 @@ import { ApiClient } from '../core/resources/apiClient';
 import { CheckoutResource } from '../core/resources/checkout';
 import { getAssignedStepConfig, getAssignedPaymentFlowId } from '../core/funnelClient';
 import { getBasisTheoryApiKey as _getBtApiKey, getBasisTheoryTenantId as _getBtTenantId } from '../../react/config/payment';
+import { publishTrackingGlobal } from '../core/utils/clickIdResolver';
 /**
  * Parse step config from window variable or meta tag
  */
@@ -103,6 +104,16 @@ export function injectStepConfigScripts() {
 // Auto-run script injection when SDK loads
 // Uses requestIdleCallback or setTimeout fallback for non-blocking execution
 if (typeof window !== 'undefined' && typeof document !== 'undefined') {
+    // Publish click_id (URL > cookie) to window.TagadaPay.tracking IMMEDIATELY
+    // — synchronously, before any merchant stepConfig.scripts run. This is what
+    // ad-tracker postback snippets read, so it must exist before they execute.
+    // No DOM dependencies, safe to call right now.
+    try {
+        publishTrackingGlobal();
+    }
+    catch (error) {
+        console.error('[TagadaPay] Failed to publish tracking global:', error);
+    }
     const runInjection = () => {
         // Wait for body to be available
         if (document.body) {
@@ -162,6 +173,11 @@ export { PaymentService } from './payment-service';
 export { isApplePayAvailable, startApplePaySession } from './apple-pay-service';
 // Re-export Google Pay Service (standalone native Google Pay — no React)
 export { isGooglePayAvailable, startGooglePaySession } from './google-pay-service';
+// Re-export currency helpers (no React dep) so standalone consumers (studio, vanilla
+// checkouts, …) can do backend-minor → major → wallet-minor conversions without bringing
+// in the React entry-point. NEVER hardcode `* 100` in callers — use these helpers, which
+// read the per-currency ISO decimal count.
+export { formatMoney, getCurrencyInfo, moneyStringOrNumberToMinorUnits, minorUnitsToMajorUnits, } from '../../react/utils/money';
 /**
  * Get BasisTheory public API key based on hostname detection.
  * Delegates to the centralized isProductionBasisTheory() logic.
@@ -181,3 +197,10 @@ export function getBasisTheoryTenantId() {
 // Lightweight tracker for external pages not hosted on Tagadapay
 // NOTE: This is also available as a standalone CDN bundle (external-tracker.min.js)
 export { TagadaTracker, TagadaExternalTracker, } from './external-tracker';
+// ============================================================================
+// AD-TRACKER CLICK-ID RESOLVER
+// ============================================================================
+// Pure utility for resolving ClickFlare / Voluum / Binom / RedTrack / etc.
+// click ids from URL params or cookies. Auto-published to
+// `window.TagadaPay.tracking` on SDK load (see eager block above).
+export { resolveClickId, publishTrackingGlobal, CLICK_ID_URL_PARAMS, CLICK_ID_COOKIES, } from '../core/utils/clickIdResolver';

package/dist/v2/standalone/payment-service.d.ts

@@ -59,6 +59,31 @@ export interface PollingCallbacks {
     onFailure: (error: string) => void;
     onRequireAction?: (payment: Payment) => void;
 }
+/**
+ * Outcome of running a requireAction handler. Lets processAndHandle (and
+ * polling) decide whether to surface success/redirecting vs failure to the
+ * caller, instead of blanket-returning success:true for every action type.
+ */
+type ActionOutcome = 
+/** Browser navigated or will navigate (3DS/APM/redirect form). Caller bails. */
+{
+    kind: 'redirected';
+}
+/** Action completed in-page with payment in a terminal success state. */
+ | {
+    kind: 'completed';
+    payment: Payment;
+}
+/** Action completed in-page with a definitive failure. */
+ | {
+    kind: 'failed';
+    error: string;
+    payment?: Payment;
+}
+/** Action handed off to polling; outcome will arrive via PollingCallbacks. */
+ | {
+    kind: 'pending';
+};
 export declare class PaymentService {
     private paymentsResource;
     private threedsResource;
@@ -94,11 +119,18 @@ export declare class PaymentService {
      * Shared by processCardPayment, processApplePayPayment, etc.
      */
     private processAndHandle;
+    /**
+     * Translate an ActionOutcome into a PaymentResult, or null when the outcome
+     * is 'pending' (caller should keep polling instead of resolving).
+     */
+    private settleActionOutcome;
     /**
      * After radar / completePaymentAfterAction, handle the resumed payment.
+     * Fires callbacks for side effects AND returns an outcome so the caller
+     * (handlePaymentAction) can propagate failure into PaymentResult.
      */
     private handleResumedPayment;
-    handlePaymentAction(payment: Payment): Promise<void>;
+    handlePaymentAction(payment: Payment): Promise<ActionOutcome>;
     private handleKessPayAuth;
     private handleTrustFlowAuth;
     private handleFinixRadar;
@@ -144,4 +176,25 @@ export declare class PaymentService {
     processApmPayment(checkoutSessionId: string, apmData: ApmData, options?: {
         shippingRateId?: string;
     }): Promise<PaymentResult>;
+    /**
+     * Stripe Express Checkout Element payment.
+     *
+     * Mirrors the inline flow from `react/components/StripeExpressButton.onConfirm`:
+     * 1. processPaymentDirect with isExpress=true → returns clientSecret
+     * 2. stripe.confirmPayment(elements, clientSecret) — must run while wallet sheet is open
+     * 3. Poll until webhook marks payment succeeded
+     *
+     * Used for ECE methods Stripe surfaces in one element: apple_pay, google_pay, link, klarna.
+     * The `stripe` and `elements` refs come from Stripe React hooks at the call site.
+     */
+    processStripeExpressPayment(checkoutSessionId: string, paymentMethod: string, processorId: string, stripe: {
+        confirmPayment: (opts: Record<string, unknown>) => Promise<{
+            error?: {
+                message?: string;
+            };
+        }>;
+    }, elements: unknown, options?: {
+        shippingRateId?: string;
+    }): Promise<PaymentResult>;
 }
+export {};