@tagadapay/plugin-sdk 3.1.12 → 3.1.24

package/dist/v2/core/funnelClient.js

@@ -2,7 +2,7 @@ import { detectEnvironment } from './config/environment';
 import { FunnelActionType, FunnelResource } from './resources/funnel';
 import { EventDispatcher } from './utils/eventDispatcher';
 import { getSDKParams } from './utils/previewMode';
-import { injectPreviewModeIndicator } from './utils/previewModeIndicator';
+const lazyInjectPreviewIndicator = () => import('./utils/previewModeIndicator').then(m => m.injectPreviewModeIndicator());
 import { getFunnelSessionCookie, setFunnelSessionCookie } from './utils/sessionStorage';
 /**
  * Tracking providers supported by the SDK.
@@ -16,6 +16,41 @@ export var TrackingProvider;
     TrackingProvider["PINTEREST"] = "pinterest";
     TrackingProvider["GTM"] = "gtm";
 })(TrackingProvider || (TrackingProvider = {}));
+/** Get all enabled entries from a paymentSetupConfig */
+export function getEnabledMethods(config) {
+    if (!config)
+        return [];
+    return Object.values(config).filter(m => m.enabled);
+}
+/** Get all express methods (for rendering above the payment form) */
+export function getExpressMethods(config) {
+    return getEnabledMethods(config).filter(m => m.express);
+}
+/** Group enabled express methods by processorId (one Express Element per processor) */
+export function getExpressMethodsByProcessor(config) {
+    const groups = {};
+    for (const m of getExpressMethods(config)) {
+        const key = m.processorId || m.integrationId || m.provider;
+        if (!groups[key])
+            groups[key] = [];
+        groups[key].push(m);
+    }
+    return groups;
+}
+/** Find a specific method entry by method name (returns first match) */
+export function findMethod(config, method) {
+    if (!config)
+        return undefined;
+    for (const entry of Object.values(config)) {
+        if (entry.method === method && entry.enabled)
+            return entry;
+    }
+    return undefined;
+}
+/** Check if a specific method is enabled (any provider) */
+export function isMethodEnabled(config, method) {
+    return !!findMethod(config, method);
+}
 /**
  * Get the funnel ID from the injected HTML
  * Returns undefined if not available
@@ -183,11 +218,14 @@ export function getLocalFunnelConfig() {
  * Convert LocalFunnelConfig to RuntimeStepConfig
  */
 function localConfigToStepConfig(local) {
+    const merged = { ...local.staticResources, ...local.resources };
     return {
         payment: local.paymentFlowId ? { paymentFlowId: local.paymentFlowId } : undefined,
-        staticResources: local.staticResources,
+        resources: Object.keys(merged).length > 0 ? merged : undefined,
         scripts: local.scripts,
         pixels: local.pixels,
+        orderBumps: local.orderBumps,
+        upsellOffers: local.upsellOffers,
     };
 }
 /**
@@ -207,7 +245,6 @@ export function getAssignedStepConfig() {
     if (typeof window === 'undefined')
         return undefined;
     // Method 1: Local dev override (HIGHEST PRIORITY in local dev)
-    // Allows developers to test different configurations without redeploying
     const localConfig = getLocalFunnelConfig();
     if (localConfig) {
         console.log('🛠️ [SDK] Using local funnel.local.json (overrides injected)');
@@ -233,22 +270,29 @@ export function getAssignedStepConfig() {
     return undefined;
 }
 /**
- * Get the assigned payment flow ID from step config or legacy injection
- * Returns undefined if not available
+ * Get the assigned payment flow ID from step config or legacy injection.
+ * Resolution order:
+ *   1. paymentSetupConfig.card.paymentFlowId  (per-method, most specific)
+ *   2. stepConfig.payment.paymentFlowId        (per-step level)
+ *   3. window.__TGD_PAYMENT_FLOW_ID__          (legacy injection)
+ *   4. meta[name="x-payment-flow-id"]          (legacy meta tag)
  */
 export function getAssignedPaymentFlowId() {
-    // Method 1: New stepConfig (preferred)
     const stepConfig = getAssignedStepConfig();
+    // Method 1: Per-method config — card entry in paymentSetupConfig
+    const cardConfig = stepConfig?.paymentSetupConfig?.card;
+    if (cardConfig?.paymentFlowId) {
+        return cardConfig.paymentFlowId;
+    }
+    // Method 2: Per-step config (legacy but still supported)
     if (stepConfig?.payment?.paymentFlowId) {
         return stepConfig.payment.paymentFlowId;
     }
-    // Method 2: Legacy direct injection (backward compatibility)
+    // Method 3: Legacy direct injection (backward compatibility)
     if (typeof window !== 'undefined') {
-        // Legacy window variable
         if (window.__TGD_PAYMENT_FLOW_ID__) {
             return window.__TGD_PAYMENT_FLOW_ID__;
         }
-        // Legacy meta tag
         if (typeof document !== 'undefined') {
             const meta = document.querySelector('meta[name="x-payment-flow-id"]');
             return meta?.getAttribute('content') || undefined;
@@ -257,12 +301,23 @@ export function getAssignedPaymentFlowId() {
     return undefined;
 }
 /**
- * Get the assigned static resources from step config
- * Returns undefined if not available
+ * Get resource bindings from step config.
+ * Reads from `resources` (new) with `staticResources` (legacy) as fallback, merged.
  */
-export function getAssignedStaticResources() {
+export function getAssignedResources() {
     const stepConfig = getAssignedStepConfig();
-    return stepConfig?.staticResources;
+    const legacy = stepConfig?.staticResources;
+    const current = stepConfig?.resources;
+    if (!legacy && !current)
+        return undefined;
+    return { ...legacy, ...current };
+}
+/**
+ * @deprecated Use `getAssignedResources()` instead.
+ * Kept for backward compatibility — reads from both `resources` and `staticResources`.
+ */
+export function getAssignedStaticResources() {
+    return getAssignedResources();
 }
 /**
  * Get the assigned scripts from step config
@@ -284,6 +339,21 @@ export function getAssignedScripts(position) {
  * Get assigned pixel tracking configuration (normalized to arrays)
  * Always returns arrays of PixelConfig for consistent consumption.
  */
+/**
+ * Split a pixel config with semicolon/comma-separated IDs into individual configs.
+ * Handles cases where the CRM stores "ID1; ID2; ID3" as a single pixelId or containerId.
+ */
+function splitPixelConfig(px) {
+    // GTM configs use containerId
+    const idField = 'containerId' in px ? 'containerId' : 'pixelId';
+    const rawId = px[idField];
+    if (!rawId || !rawId.includes(';') && !rawId.includes(','))
+        return [px];
+    const ids = rawId.split(/[;,]/).map((id) => id.trim()).filter((id) => id.length > 0);
+    if (ids.length <= 1)
+        return [px];
+    return ids.map((id) => ({ ...px, [idField]: id }));
+}
 export function getAssignedPixels() {
     const stepConfig = getAssignedStepConfig();
     const rawPixels = stepConfig?.pixels;
@@ -294,17 +364,43 @@ export function getAssignedPixels() {
         if (!value)
             continue;
         if (Array.isArray(value)) {
-            // Already an array
-            normalized[key] = value;
+            // Expand any entries with semicolon/comma-separated pixelIds into separate configs
+            normalized[key] = value.flatMap((px) => splitPixelConfig(px));
         }
         else if (typeof value === 'object') {
-            // Single object - wrap in array
-            normalized[key] = [value];
+            // Single object - wrap in array, splitting if needed
+            normalized[key] = splitPixelConfig(value);
         }
         // Skip invalid entries
     }
     return Object.keys(normalized).length > 0 ? normalized : undefined;
 }
+/**
+ * Get the enabled order bump offer IDs from step config.
+ * Returns undefined when mode is 'inherit' (use all store bumps).
+ * Returns the explicit list when mode is 'custom'.
+ */
+export function getAssignedOrderBumpOfferIds() {
+    const stepConfig = getAssignedStepConfig();
+    if (!stepConfig?.orderBumps)
+        return undefined;
+    if (stepConfig.orderBumps.mode !== 'custom')
+        return undefined;
+    return stepConfig.orderBumps.enabledOfferIds;
+}
+/**
+ * Get the enabled upsell offer IDs from step config.
+ * Returns undefined when mode is 'inherit' (use all store upsells).
+ * Returns the explicit list when mode is 'custom'.
+ */
+export function getAssignedUpsellOfferIds() {
+    const stepConfig = getAssignedStepConfig();
+    if (!stepConfig?.upsellOffers)
+        return undefined;
+    if (stepConfig.upsellOffers.mode !== 'custom')
+        return undefined;
+    return stepConfig.upsellOffers.enabledUpsellIds;
+}
 export class FunnelClient {
     constructor(config) {
         this.eventDispatcher = new EventDispatcher();
@@ -444,8 +540,7 @@ export class FunnelClient {
             if (response.success && response.context) {
                 const enriched = this.enrichContext(response.context);
                 this.handleSessionSuccess(enriched);
-                // 🔍 Auto-inject preview mode indicator if in preview/dev mode
-                injectPreviewModeIndicator();
+                lazyInjectPreviewIndicator();
                 return enriched;
             }
             else {
@@ -495,8 +590,7 @@ export class FunnelClient {
             if (response.success && response.context) {
                 const enriched = this.enrichContext(response.context);
                 this.handleSessionSuccess(enriched);
-                // 🔍 Auto-inject preview mode indicator if in preview/dev mode
-                injectPreviewModeIndicator();
+                lazyInjectPreviewIndicator();
                 return enriched;
             }
             else {
@@ -608,12 +702,12 @@ export class FunnelClient {
                 : this.config.autoRedirect !== false; // Default to true
             // Skip refreshSession if auto-redirecting (next page will initialize with fresh state)
             // Only refresh if staying on same page (autoRedirect: false)
-            if (!shouldAutoRedirect) {
-                if (this.config.debugMode) {
-                    console.log('🔄 [FunnelClient] Refreshing session (no auto-redirect)');
-                }
-                await this.refreshSession();
-            }
+            // if (!shouldAutoRedirect) {
+            //   if (this.config.debugMode) {
+            //     console.log('🔄 [FunnelClient] Refreshing session (no auto-redirect)');
+            //   }
+            //   await this.refreshSession();
+            // }
             this.updateState({ isNavigating: false, isLoading: false });
             // Auto-redirect if enabled and result has a URL
             if (shouldAutoRedirect && result?.url && typeof window !== 'undefined') {

package/dist/v2/core/isoData.d.ts

@@ -1,7 +1,6 @@
 /**
- * ISO Data Core
- * Pure functions for country and region data management
- * Uses the existing iso3166 data functions
+ * ISO Data Core — CDN-backed country/region data (pure functions, no React).
+ * Call ensureLoaded() before using synchronous getters.
  */
 import { type SupportedLanguage } from '../../data/iso3166';
 export interface ISOCountry {
@@ -44,7 +43,8 @@ export declare class ISODataCore {
      */
     static importLanguage(language: SupportedLanguage): Promise<void>;
     /**
-     * Get available languages for ISO data
+     * Fetch countries + regions from CDN for a language (call before sync getters)
      */
+    static ensureLoaded(language?: SupportedLanguage): Promise<void>;
     static getAvailableLanguages(): SupportedLanguage[];
 }

package/dist/v2/core/isoData.js

@@ -1,10 +1,8 @@
 /**
- * ISO Data Core
- * Pure functions for country and region data management
- * Uses the existing iso3166 data functions
+ * ISO Data Core — CDN-backed country/region data (pure functions, no React).
+ * Call ensureLoaded() before using synchronous getters.
  */
-// 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';
 export class ISODataCore {
     /**
      * Get countries data for a specific language
@@ -94,10 +92,12 @@ export class ISODataCore {
         return importLanguage(language);
     }
     /**
-     * Get available languages for ISO data
+     * Fetch countries + regions from CDN for a language (call before sync getters)
      */
+    static async ensureLoaded(language = 'en') {
+        return ensureGeoDataLoaded(language);
+    }
     static getAvailableLanguages() {
-        // Return all available languages (not just registered ones)
         return ['en', 'ru', 'de', 'fr', 'es', 'zh', 'hi', 'pt', 'ja', 'ar', 'it', 'he'];
     }
 }

package/dist/v2/core/pixelMapping.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Core pixel event mapping, parameter transformation, and event gating.
+ *
+ * This module is framework-agnostic (no React, no DOM) so it can be shared
+ * between the React `PixelTrackingProvider` and the standalone vanilla SDK.
+ *
+ * Official event name references (verified Feb 2026 against vendor docs):
+ *   Meta:      fbq('track', 'Purchase', { value, currency })       — developers.facebook.com/docs/meta-pixel/reference
+ *   TikTok:    ttq.track('Purchase', { value, currency })          — ads.tiktok.com/help/article/standard-events-parameters (Sep 2025)
+ *   Snapchat:  snaptr('track', 'PURCHASE', { price, currency })    — developers.snap.com/api/marketing-api/Conversions-API/Parameters
+ *   Pinterest: pintrk('track', 'checkout', { value, currency })    — help.pinterest.com/en/business/article/add-event-codes
+ *   GTM/GA4:   gtag('event', 'purchase', { value, currency, items })
+ */
+import type { GTMTrackingConfig, PixelConfig, PixelsConfig } from './funnelClient';
+export type StandardPixelEvent = 'PageView' | 'ViewContent' | 'AddToCart' | 'AddToWishlist' | 'Search' | 'InitiateCheckout' | 'AddPaymentInfo' | 'Purchase' | 'Lead' | 'CompleteRegistration' | 'Conversion';
+export type PixelProviderKey = 'facebook' | 'tiktok' | 'snapchat' | 'pinterest' | 'gtm';
+export interface MappedEvent {
+    name: string;
+    params: Record<string, unknown>;
+}
+/**
+ * Returns `true` if the given event is enabled on the pixel config.
+ * If the pixel has no `events` map (e.g. MetaConversionTrackingConfig) we allow all.
+ */
+export declare function isEventEnabled(pixel: PixelConfig, eventName: StandardPixelEvent): boolean;
+/**
+ * Filter an array of pixel configs to only those that are globally enabled
+ * AND have the specific event toggled on.
+ */
+export declare function getEligiblePixels<T extends PixelConfig>(pixels: T[] | undefined, eventName: StandardPixelEvent): T[];
+export declare function mapMetaEvent(eventName: StandardPixelEvent, parameters: Record<string, unknown>): MappedEvent;
+export declare function mapTikTokEvent(eventName: StandardPixelEvent, parameters: Record<string, unknown>): MappedEvent;
+export declare function mapSnapchatEvent(eventName: StandardPixelEvent, parameters: Record<string, unknown>): MappedEvent;
+export declare function mapPinterestEvent(eventName: StandardPixelEvent, parameters: Record<string, unknown>): MappedEvent;
+export declare function mapGTMEvent(eventName: StandardPixelEvent, parameters: Record<string, unknown>): MappedEvent;
+/**
+ * Append Google Ads `send_to` parameter when conversion tracking is configured.
+ */
+export declare function applyGoogleAdsConversion(params: Record<string, unknown>, eventName: StandardPixelEvent, pixel: GTMTrackingConfig): Record<string, unknown>;
+export interface ProviderEvent {
+    provider: PixelProviderKey;
+    mapped: MappedEvent;
+    pixel: PixelConfig;
+}
+/**
+ * Given a PixelsConfig and an event, return per-provider mapped events
+ * for every eligible (enabled + event-toggled-on) pixel.
+ */
+export declare function resolvePixelEvents(pixels: PixelsConfig, eventName: StandardPixelEvent, parameters: Record<string, unknown>): ProviderEvent[];