@tagadapay/plugin-sdk 3.1.25 → 4.0.2

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

@@ -99,6 +99,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

@@ -63,5 +63,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/ExpressPaymentMethodsProvider.js

@@ -42,10 +42,15 @@ function paymentMethodsFromSetupConfig(config) {
             continue;
         }
         // Individual express methods (apple_pay, google_pay, etc.)
-        if (entry.express || entry.type === 'apple_pay' || entry.type === 'google_pay') {
+        // Match by: explicit express flag, type, method, provider, or key name
+        const resolvedMethod = entry.method || entry.provider || key;
+        const isExpressMethod = entry.express
+            || entry.type === 'apple_pay' || entry.type === 'google_pay'
+            || resolvedMethod === 'apple_pay' || resolvedMethod === 'google_pay';
+        if (isExpressMethod) {
             methods.push({
                 id: key,
-                type: entry.type || entry.method || key,
+                type: entry.type === 'apple_pay' || entry.type === 'google_pay' ? entry.type : resolvedMethod,
                 title: entry.label || key,
                 iconUrl: entry.logoUrl || '',
                 default: false,
@@ -60,8 +65,11 @@ export const ExpressPaymentMethodsProvider = ({ children, customerId, checkout,
     const [availableExpressPaymentMethodIds, setAvailableExpressPaymentMethodIds] = useState([]);
     const [error, setError] = useState(null);
     const checkoutSessionId = checkout?.checkoutSession?.id;
-    // If paymentSetupConfig is provided, derive payment methods from it (no API call needed)
-    const configDerivedMethods = useMemo(() => paymentSetupConfig ? paymentMethodsFromSetupConfig(paymentSetupConfig) : undefined, [paymentSetupConfig]);
+    // If paymentSetupConfig is provided AND contains at least one enabled method, derive from it.
+    // Missing, empty `{}`, or all-disabled configs fall through to the API fallback.
+    const configDerivedMethods = useMemo(() => (paymentSetupConfig && Object.values(paymentSetupConfig).some((v) => v?.enabled === true))
+        ? paymentMethodsFromSetupConfig(paymentSetupConfig)
+        : undefined, [paymentSetupConfig]);
     // Create express payment methods resource client
     const expressPaymentResource = useMemo(() => {
         try {

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

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

@@ -0,0 +1,12 @@
+/**
+ * Apple Pay Service (Standalone) — re-export shim.
+ *
+ * The canonical implementation lives in `@tagadapay/core-js` so partner
+ * code, the studio, the native checkout, and the plugin-sdk all share a
+ * single source of truth for the native Apple Pay primitive (BasisTheory
+ * tokenization, no checkout session). This file preserves the historical
+ * import path `@tagadapay/plugin-sdk/v2/standalone` so existing consumers
+ * (studio-app, vanilla-checkout templates, …) keep working without
+ * code changes.
+ */
+export { isApplePayAvailable, startApplePaySession, type ApplePayServiceConfig, type ApplePayPaymentRequest, type ApplePayTokenResult, type ApplePayShippingContact, type ApplePayCallbacks, type ApplePayInlineError, } from '@tagadapay/core-js';

package/dist/v2/standalone/apple-pay-service.js

@@ -0,0 +1,12 @@
+/**
+ * Apple Pay Service (Standalone) — re-export shim.
+ *
+ * The canonical implementation lives in `@tagadapay/core-js` so partner
+ * code, the studio, the native checkout, and the plugin-sdk all share a
+ * single source of truth for the native Apple Pay primitive (BasisTheory
+ * tokenization, no checkout session). This file preserves the historical
+ * import path `@tagadapay/plugin-sdk/v2/standalone` so existing consumers
+ * (studio-app, vanilla-checkout templates, …) keep working without
+ * code changes.
+ */
+export { isApplePayAvailable, startApplePaySession, } from '@tagadapay/core-js';

package/dist/v2/standalone/external-tracker.d.ts

@@ -36,7 +36,7 @@ export interface TagadaTrackerConfig {
     stepName?: string;
     /** Step type (optional — e.g., 'landing', 'offer', 'external') */
     stepType?: string;
-    /** API base URL (defaults to https://app.tagadapay.com) */
+    /** API base URL (defaults to https://api.tagada.io) */
     apiBaseUrl?: string;
     /** Enable debug logging */
     debug?: boolean;

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

@@ -0,0 +1,9 @@
+/**
+ * Google Pay Service (Standalone) — re-export shim.
+ *
+ * The canonical implementation lives in `@tagadapay/core-js`. This file
+ * preserves the historical import path `@tagadapay/plugin-sdk/v2/standalone`
+ * for downstream consumers (studio-app, vanilla-checkout templates,
+ * payment-error-dashboard) — they keep working unchanged.
+ */
+export { isGooglePayAvailable, startGooglePaySession, type GooglePayServiceConfig, type GooglePayPaymentRequest, type GooglePayTokenResult, type GooglePayAddress, type GooglePayCallbacks, } from '@tagadapay/core-js';

package/dist/v2/standalone/google-pay-service.js

@@ -0,0 +1,9 @@
+/**
+ * Google Pay Service (Standalone) — re-export shim.
+ *
+ * The canonical implementation lives in `@tagadapay/core-js`. This file
+ * preserves the historical import path `@tagadapay/plugin-sdk/v2/standalone`
+ * for downstream consumers (studio-app, vanilla-checkout templates,
+ * payment-error-dashboard) — they keep working unchanged.
+ */
+export { isGooglePayAvailable, startGooglePaySession, } from '@tagadapay/core-js';

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

@@ -25,12 +25,15 @@ export { TagadaClient, ApiClient, CheckoutResource };
 export { ShippingRatesResource } from '../core/resources/shippingRates';
 export { PaymentsResource } from '../core/resources/payments';
 export { OrdersResource } from '../core/resources/orders';
+export { OffersResource } from '../core/resources/offers';
 export { ExpressPaymentMethodsResource } from '../core/resources/expressPaymentMethods';
 export type { PaymentMethod as ExpressPaymentMethod } from '../core/resources/expressPaymentMethods';
 export type { ShippingRate, ShippingRatesResponse, ShippingRatesPreviewParams } from '../core/resources/shippingRates';
-export type { Payment, PaymentResponse, CardPaymentMethod, BasisTheoryInstance, GooglePayToken, ApplePayToken, PaymentInstrumentInput, PaymentInstrumentResponse, PaymentInstrumentCustomerResponse, } from '../core/resources/payments';
+export type { Payment, PaymentResponse, PaymentOptions, CardPaymentMethod, BasisTheoryInstance, GooglePayToken, ApplePayToken, PaymentInstrumentInput, PaymentInstrumentResponse, PaymentInstrumentCustomerResponse, } from '../core/resources/payments';
 export { StoreConfigResource } from '../core/resources/storeConfig';
 export type { StoreConfig } from '../core/resources/storeConfig';
+export { GeoResource } from '../core/resources/geo';
+export type { GeoLocationData } from '../core/resources/geo';
 export { ThreedsResource } from '../core/resources/threeds';
 export { ISODataCore } from '../core/isoData';
 export type { ISOCountry, ISORegion } from '../core/isoData';
@@ -50,6 +53,11 @@ export { getAssignedStepConfig } from '../core/funnelClient';
 export type { RuntimeStepConfig } from '../core/funnelClient';
 export { PaymentService } from './payment-service';
 export type { PaymentServiceConfig, PaymentResult, PaymentCallbacks, CardData, ApmData, } from './payment-service';
+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.
@@ -61,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) {
@@ -134,9 +145,12 @@ export { TagadaClient, ApiClient, CheckoutResource };
 export { ShippingRatesResource } from '../core/resources/shippingRates';
 export { PaymentsResource } from '../core/resources/payments';
 export { OrdersResource } from '../core/resources/orders';
+export { OffersResource } from '../core/resources/offers';
 export { ExpressPaymentMethodsResource } from '../core/resources/expressPaymentMethods';
 // Re-export Store Config (for standalone resolvers / builders)
 export { StoreConfigResource } from '../core/resources/storeConfig';
+// Re-export Geo Resource (for standalone geolocation / country detection)
+export { GeoResource } from '../core/resources/geo';
 // Re-export 3DS Resource (for standalone resolvers / builders)
 export { ThreedsResource } from '../core/resources/threeds';
 // Re-export ISO Data Core (for standalone address form / resolvers)
@@ -155,6 +169,15 @@ export { getAssignedPaymentFlowId };
 export { getAssignedStepConfig } from '../core/funnelClient';
 // Re-export Payment Service (standalone payment processing — no React)
 export { PaymentService } from './payment-service';
+// Re-export Apple Pay Service (standalone native Apple Pay — no React)
+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.
@@ -174,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

@@ -51,12 +51,39 @@ export interface PaymentCallbacks {
     onSuccess?: (payment: Payment) => void;
     onFailure?: (error: string) => void;
     onRedirectReturn?: (paymentId: string) => void;
+    /** Called before a browser redirect, allows caller to await async work (e.g. funnel navigate) */
+    onBeforeRedirect?: (payment: Payment, redirectUrl: string) => Promise<void>;
 }
 export interface PollingCallbacks {
     onSuccess: (payment: Payment) => void;
     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;
@@ -92,15 +119,23 @@ 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;
     private handleStripeRadar;
+    private handleNgeniusThreeds;
     private handleAirwallexRadar;
     private handleMasterCardAuth;
     private loadScript;
@@ -126,9 +161,40 @@ export declare class PaymentService {
         id: string;
         sessionId: string;
     }>;
-    processCardPayment(checkoutSessionId: string, cardData: CardData): Promise<PaymentResult>;
-    processApplePayPayment(checkoutSessionId: string, applePayToken: ApplePayToken): Promise<PaymentResult>;
-    processGooglePayPayment(checkoutSessionId: string, googlePayToken: GooglePayToken): Promise<PaymentResult>;
-    processPaymentWithInstrument(checkoutSessionId: string, paymentInstrumentId: string): Promise<PaymentResult>;
-    processApmPayment(checkoutSessionId: string, apmData: ApmData): Promise<PaymentResult>;
+    processCardPayment(checkoutSessionId: string, cardData: CardData, options?: {
+        shippingRateId?: string;
+    }): Promise<PaymentResult>;
+    processApplePayPayment(checkoutSessionId: string, applePayToken: ApplePayToken, options?: {
+        shippingRateId?: string;
+    }): Promise<PaymentResult>;
+    processGooglePayPayment(checkoutSessionId: string, googlePayToken: GooglePayToken, options?: {
+        shippingRateId?: string;
+    }): Promise<PaymentResult>;
+    processPaymentWithInstrument(checkoutSessionId: string, paymentInstrumentId: string, options?: {
+        shippingRateId?: string;
+    }): Promise<PaymentResult>;
+    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 {};