@tagadapay/plugin-sdk 3.1.25 → 4.0.0

package/dist/v2/core/config/environment.d.ts

@@ -8,11 +8,11 @@ import { ApiConfig, Environment, EnvironmentConfig } from '../types';
  * Environment detection priority (highest to lowest):
  * 1. **tagadaClientEnv** - Explicit override via URL param, localStorage, or cookie
  *    Example: ?tagadaClientEnv=production
- * 2. **Production domains** → production API (app.tagadapay.com)
- * 3. **Dev/staging domains** → development API (app.tagadapay.dev, vercel.app, etc.)
+ * 2. **Production domains** → production API (api.tagada.io)
+ * 3. **Dev/staging domains** → development API (api.tagada.dev, vercel.app, etc.)
  * 4. **Localhost/local IPs** → local API (localhost, 127.0.0.1, etc.)
  *    - Can be overridden via window.__TAGADA_ENV__.TAGADA_ENVIRONMENT
- * 5. **Default fallback** → production API (safest for unknown domains)
+ * 5. **Default fallback** → production API (safest)
  *
  * Build-time .env variables (VITE_*, REACT_APP_*, NEXT_PUBLIC_*) are IGNORED
  * to prevent incorrect API connections when plugins are deployed to different environments.

package/dist/v2/core/config/environment.js

@@ -19,11 +19,11 @@ function getCookie(name) {
  * Environment detection priority (highest to lowest):
  * 1. **tagadaClientEnv** - Explicit override via URL param, localStorage, or cookie
  *    Example: ?tagadaClientEnv=production
- * 2. **Production domains** → production API (app.tagadapay.com)
- * 3. **Dev/staging domains** → development API (app.tagadapay.dev, vercel.app, etc.)
+ * 2. **Production domains** → production API (api.tagada.io)
+ * 3. **Dev/staging domains** → development API (api.tagada.dev, vercel.app, etc.)
  * 4. **Localhost/local IPs** → local API (localhost, 127.0.0.1, etc.)
  *    - Can be overridden via window.__TAGADA_ENV__.TAGADA_ENVIRONMENT
- * 5. **Default fallback** → production API (safest for unknown domains)
+ * 5. **Default fallback** → production API (safest)
  *
  * Build-time .env variables (VITE_*, REACT_APP_*, NEXT_PUBLIC_*) are IGNORED
  * to prevent incorrect API connections when plugins are deployed to different environments.
@@ -33,7 +33,7 @@ function getCookie(name) {
  */
 export const ENVIRONMENT_CONFIGS = {
     production: {
-        baseUrl: 'https://app.tagadapay.com',
+        baseUrl: 'https://api.tagada.io',
         endpoints: {
             checkout: {
                 sessionInit: '/api/v1/checkout/session/init',
@@ -51,7 +51,7 @@ export const ENVIRONMENT_CONFIGS = {
         },
     },
     development: {
-        baseUrl: 'https://app.tagadapay.dev',
+        baseUrl: 'https://api.tagada.dev',
         endpoints: {
             checkout: {
                 sessionInit: '/api/v1/checkout/session/init',
@@ -213,13 +213,13 @@ export function detectEnvironment() {
         return 'local';
     }
     // 2. Production: deployed to production domains
-    if (hostname === 'app.tagadapay.com' ||
+    if (hostname.includes('tagada.io') ||
         hostname.includes('tagadapay.com') ||
         hostname.includes('yourproductiondomain.com')) {
         return 'production';
     }
     // 3. Development: deployed to staging/dev domains or has dev indicators
-    if (hostname === 'app.tagadapay.dev' ||
+    if (hostname.includes('tagada.dev') ||
         hostname.includes('tagadapay.dev') ||
         hostname.includes('vercel.app') ||
         hostname.includes('netlify.app') ||

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

@@ -137,6 +137,8 @@ export interface PaymentMethodConfig {
         note?: string;
     }>;
     metadata?: Record<string, any>;
+    /** Integration settings (e.g. custom_payment checkout instructions, thank-you text) */
+    settings?: Record<string, any>;
 }
 export type PaymentSetupConfig = Record<string, PaymentMethodConfig>;
 /** Get all enabled entries from a paymentSetupConfig */

package/dist/v2/core/resources/funnel.d.ts

@@ -405,7 +405,7 @@ export interface SimpleFunnelContext<TCustom = {}> {
      * ✅ Environment context (staging or production)
      * - Determined at session initialization based on entry URL
      * - Ensures all navigation stays in the same environment
-     * - 'staging': Uses funnel.config (alias domains like funnel--store.cdn.tagadapay.com)
+     * - 'staging': Uses funnel.config (alias domains like funnel--store.cdn.tagada.io)
      * - 'production': Uses funnel.productionConfig (custom domains)
      */
     environment?: 'staging' | 'production';

package/dist/v2/core/resources/geo.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Geo Resource Client
+ * API client for IP geolocation endpoint
+ */
+import { ApiClient } from './apiClient';
+export interface GeoLocationData {
+    ip_address?: string | null;
+    city?: string | null;
+    region?: string | null;
+    region_iso_code?: string | null;
+    postal_code?: string | null;
+    country?: string | null;
+    country_code?: string | null;
+    country_is_eu?: boolean | null;
+    continent?: string | null;
+    continent_code?: string | null;
+    latitude?: number | null;
+    longitude?: number | null;
+    security?: {
+        is_vpn?: boolean | null;
+    } | null;
+    timezone?: {
+        name?: string | null;
+        abbreviation?: string | null;
+        gmt_offset?: number | null;
+        current_time?: string | null;
+        is_dst?: boolean | null;
+    } | null;
+    currency?: {
+        currency_name?: string | null;
+        currency_code?: string | null;
+    } | null;
+}
+export declare class GeoResource {
+    private apiClient;
+    constructor(apiClient: ApiClient);
+    /**
+     * Get geolocation data from the visitor's IP address
+     */
+    getGeoLocation(): Promise<GeoLocationData>;
+    /**
+     * Get geolocation data for a specific IP address
+     */
+    getGeoLocationByIp(ip: string): Promise<GeoLocationData>;
+    /**
+     * Convenience: get just the country code from IP geolocation
+     * Returns ISO 3166-1 alpha-2 code (e.g. 'US', 'FR') or null
+     */
+    detectCountry(): Promise<string | null>;
+}

package/dist/v2/core/resources/geo.js

@@ -0,0 +1,35 @@
+/**
+ * Geo Resource Client
+ * API client for IP geolocation endpoint
+ */
+export class GeoResource {
+    constructor(apiClient) {
+        this.apiClient = apiClient;
+    }
+    /**
+     * Get geolocation data from the visitor's IP address
+     */
+    async getGeoLocation() {
+        return this.apiClient.get('/api/v1/geo');
+    }
+    /**
+     * Get geolocation data for a specific IP address
+     */
+    async getGeoLocationByIp(ip) {
+        return this.apiClient.get(`/api/v1/geo?ip=${encodeURIComponent(ip)}`);
+    }
+    /**
+     * Convenience: get just the country code from IP geolocation
+     * Returns ISO 3166-1 alpha-2 code (e.g. 'US', 'FR') or null
+     */
+    async detectCountry() {
+        try {
+            const data = await this.getGeoLocation();
+            const code = data?.country_code;
+            return code && typeof code === 'string' && code.length === 2 ? code : null;
+        }
+        catch {
+            return null;
+        }
+    }
+}

package/dist/v2/core/resources/payments.d.ts

@@ -10,7 +10,7 @@ export interface Payment {
     subStatus: string;
     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' | 'stripe_express_checkout';
+        type: 'redirect' | 'redirect_to_payment' | 'threeds_auth' | 'processor_auth' | 'error' | 'stripe_radar' | 'finix_radar' | 'radar' | 'kesspay_auth' | 'trustflow_auth' | 'mastercard_auth' | 'stripe_express_checkout' | 'ngenius_3ds';
         url?: string;
         processed: boolean;
         processorId?: string;
@@ -112,6 +112,14 @@ export interface PaymentOptions {
      * Payment method type (e.g., 'klarna', 'afterpay', 'paypal')
      */
     paymentMethod?: string;
+    /**
+     * Shipping rate selected by the customer at checkout. Forwarded to
+     * `processPaymentDirect` so the order is created with the right shipping
+     * even if the session's stored rate hasn't fully round-tripped or got
+     * cleared (race conditions). The backend treats this as authoritative
+     * when present, otherwise falls back to the session's stored rate.
+     */
+    shippingRateId?: string;
     /** @deprecated Use onPaymentSuccess instead - this will be removed in v3 */
     onSuccess?: (response: PaymentResponse) => void;
     /** @deprecated Use onPaymentFailed instead - this will be removed in v3 */
@@ -247,6 +255,7 @@ export declare class PaymentsResource {
         processorId?: string;
         paymentMethod?: string;
         isExpress?: boolean;
+        shippingRateId?: string;
     }): Promise<PaymentResponse>;
     /**
      * Get card payment instruments for customer
@@ -304,4 +313,13 @@ export declare class PaymentsResource {
         status: 'succeeded' | 'failed' | 'pending';
         paymentIntentId: string;
     }): Promise<Payment>;
+    /**
+     * Complete N-Genius payment after WebSDK 3DS flow finishes.
+     * Verifies state from N-Genius server-side and updates the payment record.
+     */
+    ngeniusThreedsComplete(data: {
+        paymentId: string;
+        orderReference: string;
+        paymentReference: string;
+    }): Promise<Payment>;
 }

package/dist/v2/core/resources/payments.js

@@ -148,6 +148,7 @@ export class PaymentsResource {
                 ...(options.processorId && { processorId: options.processorId }),
                 ...(options.paymentMethod && { paymentMethod: options.paymentMethod }),
                 ...(options.isExpress && { isExpress: options.isExpress }),
+                ...(options.shippingRateId && { shippingRateId: options.shippingRateId }),
             };
             console.log('[PaymentsResource] Request body being sent:', JSON.stringify(requestBody, null, 2));
             const response = await this.apiClient.post('/api/public/v1/checkout/pay-v2', requestBody);
@@ -206,4 +207,11 @@ export class PaymentsResource {
     async updateThreedsStatus(data) {
         return this.apiClient.post('/api/v1/threeds/status', data);
     }
+    /**
+     * Complete N-Genius payment after WebSDK 3DS flow finishes.
+     * Verifies state from N-Genius server-side and updates the payment record.
+     */
+    async ngeniusThreedsComplete(data) {
+        return this.apiClient.post('/api/v1/payments/ngenius/threeds-complete', data);
+    }
 }

package/dist/v2/core/utils/previewModeIndicator.js

@@ -212,143 +212,143 @@ export function injectPreviewModeIndicator() {
     // Create container
     const container = document.createElement('div');
     container.id = 'tgd-preview-indicator';
-    container.style.cssText = `
-        position: fixed;
-        bottom: 16px;
-        right: 16px;
-        z-index: 999999;
-        font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+    container.style.cssText = `
+        position: fixed;
+        bottom: 16px;
+        right: 16px;
+        z-index: 999999;
+        font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
     `;
     // Create badge
     const badge = document.createElement('div');
-    badge.style.cssText = `
-        background: ${draftMode ? '#ff9500' : '#007aff'};
-        color: white;
-        padding: 8px 12px;
-        border-radius: 8px;
-        font-size: 13px;
-        font-weight: 600;
-        box-shadow: 0 2px 8px rgba(0, 0, 0, 0.15);
-        cursor: pointer;
-        transition: all 0.2s ease;
-        display: flex;
-        align-items: center;
-        gap: 6px;
+    badge.style.cssText = `
+        background: ${draftMode ? '#ff9500' : '#007aff'};
+        color: white;
+        padding: 8px 12px;
+        border-radius: 8px;
+        font-size: 13px;
+        font-weight: 600;
+        box-shadow: 0 2px 8px rgba(0, 0, 0, 0.15);
+        cursor: pointer;
+        transition: all 0.2s ease;
+        display: flex;
+        align-items: center;
+        gap: 6px;
     `;
-    badge.innerHTML = `
-        <span style="font-size: 16px;">🔍</span>
-        <span>${draftMode ? 'Preview Mode' : 'Dev Mode'}</span>
+    badge.innerHTML = `
+        <span style="font-size: 16px;">🔍</span>
+        <span>${draftMode ? 'Preview Mode' : 'Dev Mode'}</span>
     `;
     // Create details popup (with padding-top to bridge gap with badge)
     const details = document.createElement('div');
-    details.style.cssText = `
-        position: absolute;
-        bottom: calc(100% + 8px);
-        right: 0;
-        background: white;
-        border: 1px solid #e5e5e5;
-        border-radius: 8px;
-        box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);
-        padding: 12px;
-        min-width: 250px;
-        font-size: 12px;
-        line-height: 1.5;
-        display: none;
+    details.style.cssText = `
+        position: absolute;
+        bottom: calc(100% + 8px);
+        right: 0;
+        background: white;
+        border: 1px solid #e5e5e5;
+        border-radius: 8px;
+        box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);
+        padding: 12px;
+        min-width: 250px;
+        font-size: 12px;
+        line-height: 1.5;
+        display: none;
     `;
     details.style.paddingTop = '20px'; // Extra padding to bridge the gap
     // Add invisible bridge between badge and popup to prevent flickering
     const bridge = document.createElement('div');
-    bridge.style.cssText = `
-        position: absolute;
-        bottom: 100%;
-        left: 0;
-        right: 0;
-        height: 8px;
-        display: none;
+    bridge.style.cssText = `
+        position: absolute;
+        bottom: 100%;
+        left: 0;
+        right: 0;
+        height: 8px;
+        display: none;
     `;
     // Build details content
     let detailsHTML = '<div style="margin-bottom: 8px; font-weight: 600; color: #1d1d1f;">Current Environment</div>';
     detailsHTML += '<div style="display: flex; flex-direction: column; gap: 6px;">';
     if (draftMode) {
-        detailsHTML += `
-            <div style="display: flex; justify-content: space-between; color: #86868b;">
-                <span>Draft Mode:</span>
-                <span style="color: #ff9500; font-weight: 600;">ON</span>
-            </div>
+        detailsHTML += `
+            <div style="display: flex; justify-content: space-between; color: #86868b;">
+                <span>Draft Mode:</span>
+                <span style="color: #ff9500; font-weight: 600;">ON</span>
+            </div>
         `;
     }
     if (trackingDisabled) {
-        detailsHTML += `
-            <div style="display: flex; justify-content: space-between; color: #86868b;">
-                <span>Tracking:</span>
-                <span style="color: #ff3b30; font-weight: 600;">DISABLED</span>
-            </div>
+        detailsHTML += `
+            <div style="display: flex; justify-content: space-between; color: #86868b;">
+                <span>Tracking:</span>
+                <span style="color: #ff3b30; font-weight: 600;">DISABLED</span>
+            </div>
         `;
     }
     if (params.funnelEnv) {
-        detailsHTML += `
-            <div style="display: flex; justify-content: space-between; color: #86868b;">
-                <span>Funnel Env:</span>
-                <span style="color: #1d1d1f; font-weight: 600; font-family: monospace; font-size: 11px;">
-                    ${params.funnelEnv}
-                </span>
-            </div>
+        detailsHTML += `
+            <div style="display: flex; justify-content: space-between; color: #86868b;">
+                <span>Funnel Env:</span>
+                <span style="color: #1d1d1f; font-weight: 600; font-family: monospace; font-size: 11px;">
+                    ${params.funnelEnv}
+                </span>
+            </div>
         `;
     }
     if (params.tagadaClientEnv) {
-        detailsHTML += `
-            <div style="display: flex; justify-content: space-between; color: #86868b;">
-                <span>API Env:</span>
-                <span style="color: #1d1d1f; font-weight: 600; font-family: monospace; font-size: 11px;">
-                    ${params.tagadaClientEnv}
-                </span>
-            </div>
+        detailsHTML += `
+            <div style="display: flex; justify-content: space-between; color: #86868b;">
+                <span>API Env:</span>
+                <span style="color: #1d1d1f; font-weight: 600; font-family: monospace; font-size: 11px;">
+                    ${params.tagadaClientEnv}
+                </span>
+            </div>
         `;
     }
     if (params.tagadaClientBaseUrl) {
-        detailsHTML += `
-            <div style="color: #86868b;">
-                <div style="margin-bottom: 4px;">API URL:</div>
-                <div style="color: #1d1d1f; font-weight: 600; font-family: monospace; font-size: 10px; word-break: break-all; background: #f5f5f7; padding: 4px 6px; border-radius: 4px;">
-                    ${params.tagadaClientBaseUrl}
-                </div>
-            </div>
+        detailsHTML += `
+            <div style="color: #86868b;">
+                <div style="margin-bottom: 4px;">API URL:</div>
+                <div style="color: #1d1d1f; font-weight: 600; font-family: monospace; font-size: 10px; word-break: break-all; background: #f5f5f7; padding: 4px 6px; border-radius: 4px;">
+                    ${params.tagadaClientBaseUrl}
+                </div>
+            </div>
         `;
     }
     if (params.funnelId) {
-        detailsHTML += `
-            <div style="color: #86868b; margin-top: 4px; padding-top: 8px; border-top: 1px solid #e5e5e5;">
-                <div style="margin-bottom: 4px;">Funnel ID:</div>
-                <div style="color: #1d1d1f; font-family: monospace; font-size: 10px; word-break: break-all; background: #f5f5f7; padding: 4px 6px; border-radius: 4px;">
-                    ${params.funnelId}
-                </div>
-            </div>
+        detailsHTML += `
+            <div style="color: #86868b; margin-top: 4px; padding-top: 8px; border-top: 1px solid #e5e5e5;">
+                <div style="margin-bottom: 4px;">Funnel ID:</div>
+                <div style="color: #1d1d1f; font-family: monospace; font-size: 10px; word-break: break-all; background: #f5f5f7; padding: 4px 6px; border-radius: 4px;">
+                    ${params.funnelId}
+                </div>
+            </div>
         `;
     }
     detailsHTML += '</div>';
-    detailsHTML += `
-        <div style="margin-top: 12px; padding-top: 8px; border-top: 1px solid #e5e5e5; font-size: 11px; color: #86868b; text-align: center;">
-            Add <code style="background: #f5f5f7; padding: 2px 4px; border-radius: 3px;">?forceReset=true</code> to reset
-        </div>
+    detailsHTML += `
+        <div style="margin-top: 12px; padding-top: 8px; border-top: 1px solid #e5e5e5; font-size: 11px; color: #86868b; text-align: center;">
+            Add <code style="background: #f5f5f7; padding: 2px 4px; border-radius: 3px;">?forceReset=true</code> to reset
+        </div>
     `;
     // Add action button
-    detailsHTML += `
-        <div style="margin-top: 12px; padding-top: 8px; border-top: 1px solid #e5e5e5;">
-            <button id="tgd-leave-preview" style="
-                background: #ff3b30;
-                color: white;
-                border: none;
-                border-radius: 6px;
-                padding: 10px 12px;
-                font-size: 13px;
-                font-weight: 600;
-                cursor: pointer;
-                transition: opacity 0.2s;
-                width: 100%;
-            ">
-                🚪 Leave Preview Mode
-            </button>
-        </div>
+    detailsHTML += `
+        <div style="margin-top: 12px; padding-top: 8px; border-top: 1px solid #e5e5e5;">
+            <button id="tgd-leave-preview" style="
+                background: #ff3b30;
+                color: white;
+                border: none;
+                border-radius: 6px;
+                padding: 10px 12px;
+                font-size: 13px;
+                font-weight: 600;
+                cursor: pointer;
+                transition: opacity 0.2s;
+                width: 100%;
+            ">
+                🚪 Leave Preview Mode
+            </button>
+        </div>
     `;
     details.innerHTML = detailsHTML;
     // Hover behavior - keep popup visible when hovering over badge, bridge, or popup