@tagadapay/plugin-sdk 2.7.16 → 2.7.20

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

@@ -70,12 +70,22 @@ export interface FunnelNavigateRequest {
      * Automatically extracted from event.currentUrl or window.location.href
      */
     currentUrl?: string;
+    /**
+     * Funnel ID for session recovery when session expires
+     * If session is not found and funnelId is provided, a new session will be created
+     */
+    funnelId?: string;
 }
 export interface FunnelNavigateResponse {
     success: boolean;
     result?: {
         stepId: string;
         url?: string;
+        /**
+         * New session ID if session was recovered (expired/removed)
+         * SDK should update its sessionId if this is present
+         */
+        sessionId?: string;
         tracking?: {
             from: string;
             to: string;

package/dist/v2/core/utils/env.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Resolves a value from multiple possible environment sources (Node, Vite, CRA, Next, window)
+ * using a list of supported prefixes.
+ */
+export declare function resolveEnvValue(key: string, prefixes?: string[]): string | undefined;

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

@@ -0,0 +1,20 @@
+const DEFAULT_PREFIXES = ['', 'VITE_', 'REACT_APP_', 'NEXT_PUBLIC_'];
+/**
+ * Resolves a value from multiple possible environment sources (Node, Vite, CRA, Next, window)
+ * using a list of supported prefixes.
+ */
+export function resolveEnvValue(key, prefixes = DEFAULT_PREFIXES) {
+    for (const prefix of prefixes) {
+        const envKey = prefix ? `${prefix}${key}` : key;
+        if (typeof process !== 'undefined' && process?.env?.[envKey]) {
+            return process.env[envKey];
+        }
+        if (typeof import.meta !== 'undefined' && import.meta?.env?.[envKey]) {
+            return import.meta.env[envKey];
+        }
+        if (typeof window !== 'undefined' && window?.__TAGADA_ENV__?.[envKey]) {
+            return window.__TAGADA_ENV__[envKey];
+        }
+    }
+    return undefined;
+}

package/dist/v2/core/utils/pluginConfig.d.ts

@@ -32,26 +32,12 @@ export declare const loadPluginConfig: (configVariant?: string, rawConfig?: RawP
  * Returns the config object that can be passed to TagadaProvider
  */
 export declare function loadLocalConfig(configName?: string, defaultConfig?: any): Promise<Record<string, unknown> | null>;
-export interface CreateRawPluginConfigOptions {
-    config?: any;
-}
 /**
  * Creates a RawPluginConfig object from provided options
  * @param options - Configuration options including storeId, accountId, basePath, configName, or a direct config object
  * @returns A RawPluginConfig object or undefined if required fields are missing
  */
-export declare function createRawPluginConfig(options?: CreateRawPluginConfigOptions): Promise<RawPluginConfig | undefined>;
-/**
- * Simple helper to get local plugin config with minimal boilerplate
- * Returns null if not in development or config not found
- *
- * @example
- * const config = await localConfigIfAny('blue');
- * if (config) {
- *   console.log('Config loaded:', config);
- * }
- */
-export declare function localConfigIfAny(configName?: string): Promise<RawPluginConfig | null>;
+export declare function createRawPluginConfig(): Promise<RawPluginConfig | undefined>;
 export declare class PluginConfigUtils {
     /**
      * Get plugin configuration from various sources

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

@@ -2,6 +2,7 @@
  * Plugin Configuration Utility Functions
  * Pure functions for plugin configuration management
  */
+import { resolveEnvValue } from './env';
 /**
  * Load local development configuration
  */
@@ -138,7 +139,6 @@ const loadProductionConfig = async () => {
 export const loadPluginConfig = async (configVariant = 'default', rawConfig) => {
     // If raw config is provided, use it directly
     if (rawConfig) {
-        console.log('🛠️ Using raw plugin config:', rawConfig);
         return {
             storeId: rawConfig.storeId,
             accountId: rawConfig.accountId,
@@ -146,6 +146,12 @@ export const loadPluginConfig = async (configVariant = 'default', rawConfig) =>
             config: rawConfig.config ?? {},
         };
     }
+    else {
+        const rawConfig = await createRawPluginConfig();
+        if (rawConfig) {
+            return rawConfig;
+        }
+    }
     // Try local development config
     const localConfig = await loadLocalDevConfig(configVariant);
     if (localConfig) {
@@ -202,33 +208,17 @@ export async function loadLocalConfig(configName = 'default', defaultConfig) {
  * @param options - Configuration options including storeId, accountId, basePath, configName, or a direct config object
  * @returns A RawPluginConfig object or undefined if required fields are missing
  */
-export async function createRawPluginConfig(options) {
+export async function createRawPluginConfig() {
     try {
-        const resolveEnv = (key) => {
-            const prefixes = ['', 'VITE_', 'REACT_APP_', 'NEXT_PUBLIC_'];
-            for (const prefix of prefixes) {
-                const envKey = prefix ? `${prefix}${key}` : key;
-                if (typeof process !== 'undefined' && process?.env?.[envKey]) {
-                    return process.env[envKey];
-                }
-                if (typeof import.meta !== 'undefined' && import.meta?.env?.[envKey]) {
-                    return import.meta.env[envKey];
-                }
-                if (typeof window !== 'undefined' && window?.__TAGADA_ENV__?.[envKey]) {
-                    return window.__TAGADA_ENV__[envKey];
-                }
-            }
-            return undefined;
-        };
-        const storeId = resolveEnv('TAGADA_STORE_ID');
-        const accountId = resolveEnv('TAGADA_ACCOUNT_ID');
-        const basePath = resolveEnv('TAGADA_BASE_PATH');
-        const configName = resolveEnv('TAGADA_CONFIG_NAME');
-        if (!storeId) {
+        const storeId = resolveEnvValue('TAGADA_STORE_ID');
+        const accountId = resolveEnvValue('TAGADA_ACCOUNT_ID');
+        const basePath = resolveEnvValue('TAGADA_BASE_PATH');
+        const configName = resolveEnvValue('TAGADA_CONFIG_NAME');
+        if (!storeId || !accountId) {
             console.warn('[createRawPluginConfig] No storeId provided');
             return undefined;
         }
-        const resolvedConfig = await loadLocalConfig(configName, options?.config);
+        const resolvedConfig = await loadLocalConfig(configName);
         if (!resolvedConfig) {
             console.warn('[createRawPluginConfig] No config found');
             return undefined;
@@ -252,34 +242,6 @@ export async function createRawPluginConfig(options) {
         return undefined;
     }
 }
-/**
- * Simple helper to get local plugin config with minimal boilerplate
- * Returns null if not in development or config not found
- *
- * @example
- * const config = await localConfigIfAny('blue');
- * if (config) {
- *   console.log('Config loaded:', config);
- * }
- */
-export async function localConfigIfAny(configName) {
-    try {
-        // Only work in localhost
-        const isLocalhost = typeof window !== 'undefined' &&
-            (window.location.hostname === 'localhost' ||
-                window.location.hostname.includes('.localhost') ||
-                window.location.hostname.includes('127.0.0.1'));
-        if (!isLocalhost) {
-            return null;
-        }
-        const rawConfig = await createRawPluginConfig();
-        return rawConfig || null;
-    }
-    catch (error) {
-        console.warn('[localConfigIfAny] Failed to load config:', error);
-        return null;
-    }
-}
 export class PluginConfigUtils {
     /**
      * Get plugin configuration from various sources

package/dist/v2/index.d.ts

@@ -22,7 +22,7 @@ export type { ApplyDiscountResponse, Discount, DiscountCodeValidation, RemoveDis
 export type { ToggleOrderBumpResponse, VipOffer, VipPreviewResponse } from './core/resources/vipOffers';
 export type { StoreConfig } from './core/resources/storeConfig';
 export type { FunnelContextUpdateRequest, FunnelContextUpdateResponse, FunnelEvent, FunnelInitializeRequest, FunnelInitializeResponse, FunnelNavigateRequest, FunnelNavigateResponse, FunnelNavigationAction, FunnelNavigationResult, SimpleFunnelContext } from './core/resources/funnel';
-export { ApplePayButton, ExpressPaymentMethodsProvider, formatMoney, getAvailableLanguages, GooglePayButton, queryKeys, TagadaProvider, useApiMutation, useApiQuery, useAuth, useCheckout, useCheckoutToken, useClubOffers, useCountryOptions, useCurrency, useCustomer, useCustomerInfos, useCustomerOrders, useCustomerSubscriptions, useDiscounts, useExpressPaymentMethods, useFunnel, useGeoLocation, useGoogleAutocomplete, useInvalidateQuery, useISOData, useLanguageImport, useLocalPluginConfig, useLogin, useOffers, useOrder, useOrderBump, usePayment, usePluginConfig, usePostPurchases, usePreloadQuery, useProducts, usePromotions, useRegionOptions, useRemappableParams, useShippingRates, useSimpleFunnel, useStoreConfig, useTagadaContext, useThreeds, useThreedsModal, useTranslation, useVipOffers } from './react';
+export { ApplePayButton, ExpressPaymentMethodsProvider, formatMoney, getAvailableLanguages, GooglePayButton, queryKeys, TagadaProvider, useApiMutation, useApiQuery, useAuth, useCheckout, useCheckoutToken, useClubOffers, useCountryOptions, useCurrency, useCustomer, useCustomerInfos, useCustomerOrders, useCustomerSubscriptions, useDiscounts, useExpressPaymentMethods, useFunnel, useGeoLocation, useGoogleAutocomplete, useInvalidateQuery, useISOData, useLanguageImport, useLogin, useOffers, useOrder, useOrderBump, usePayment, usePluginConfig, usePostPurchases, usePreloadQuery, useProducts, usePromotions, useRegionOptions, useRemappableParams, useShippingRates, useSimpleFunnel, useStoreConfig, useTagadaContext, useThreeds, useThreedsModal, useTranslation, useVipOffers } from './react';
 export type { TranslateFunction, TranslationText, UseTranslationOptions, UseTranslationResult } from './react/hooks/useTranslation';
 export type { ClubOffer, ClubOfferItem, ClubOfferLineItem, ClubOfferSummary, UseClubOffersOptions, UseClubOffersResult } from './react/hooks/useClubOffers';
 export type { UseLoginOptions, UseLoginResult } from './react/hooks/useLogin';

package/dist/v2/index.js

@@ -14,4 +14,4 @@ export * from './core/utils/products';
 // Path remapping helpers (framework-agnostic)
 export * from './core/pathRemapping';
 // React exports (hooks and components only, types are exported above)
-export { ApplePayButton, ExpressPaymentMethodsProvider, formatMoney, getAvailableLanguages, GooglePayButton, queryKeys, TagadaProvider, useApiMutation, useApiQuery, useAuth, useCheckout, useCheckoutToken, useClubOffers, useCountryOptions, useCurrency, useCustomer, useCustomerInfos, useCustomerOrders, useCustomerSubscriptions, useDiscounts, useExpressPaymentMethods, useFunnel, useGeoLocation, useGoogleAutocomplete, useInvalidateQuery, useISOData, useLanguageImport, useLocalPluginConfig, useLogin, useOffers, useOrder, useOrderBump, usePayment, usePluginConfig, usePostPurchases, usePreloadQuery, useProducts, usePromotions, useRegionOptions, useRemappableParams, useShippingRates, useSimpleFunnel, useStoreConfig, useTagadaContext, useThreeds, useThreedsModal, useTranslation, useVipOffers } from './react';
+export { ApplePayButton, ExpressPaymentMethodsProvider, formatMoney, getAvailableLanguages, GooglePayButton, queryKeys, TagadaProvider, useApiMutation, useApiQuery, useAuth, useCheckout, useCheckoutToken, useClubOffers, useCountryOptions, useCurrency, useCustomer, useCustomerInfos, useCustomerOrders, useCustomerSubscriptions, useDiscounts, useExpressPaymentMethods, useFunnel, useGeoLocation, useGoogleAutocomplete, useInvalidateQuery, useISOData, useLanguageImport, useLogin, useOffers, useOrder, useOrderBump, usePayment, usePluginConfig, usePostPurchases, usePreloadQuery, useProducts, usePromotions, useRegionOptions, useRemappableParams, useShippingRates, useSimpleFunnel, useStoreConfig, useTagadaContext, useThreeds, useThreedsModal, useTranslation, useVipOffers } from './react';

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

@@ -156,7 +156,8 @@ export function useFunnel(options) {
                 contextUpdates: {
                     lastActivityAt: Date.now()
                 },
-                currentUrl // ✅ Send to backend for URL→Step mapping
+                currentUrl, // ✅ Send to backend for URL→Step mapping
+                funnelId: effectiveFunnelId || options.funnelId // ✅ Send for session recovery
             };
             const response = await funnelResource.navigate(requestBody);
             if (response.success && response.result) {
@@ -169,19 +170,32 @@ export function useFunnel(options) {
         onSuccess: (result) => {
             if (!context)
                 return;
+            // 🔄 Handle session recovery (if backend created a new session)
+            let recoveredSessionId;
+            if (result.sessionId && result.sessionId !== context.sessionId) {
+                console.warn(`🔄 Funnel: Session recovered! Old: ${context.sessionId}, New: ${result.sessionId}`);
+                recoveredSessionId = result.sessionId;
+            }
             // Update local context
             const newContext = {
                 ...context,
+                sessionId: recoveredSessionId || context.sessionId, // ✅ Use recovered session ID if provided
                 currentStepId: result.stepId,
                 previousStepId: context.currentStepId,
                 lastActivityAt: Date.now(),
                 metadata: {
                     ...context.metadata,
                     lastEvent: 'navigation',
-                    lastTransition: new Date().toISOString()
+                    lastTransition: new Date().toISOString(),
+                    ...(recoveredSessionId ? { recovered: true, oldSessionId: context.sessionId } : {})
                 }
             };
             setContext(newContext);
+            // Update cookie with new session ID if recovered
+            if (recoveredSessionId) {
+                document.cookie = `funnelSessionId=${recoveredSessionId}; path=/; max-age=86400; SameSite=Lax`;
+                console.log(`🍪 Funnel: Updated cookie with recovered session ID: ${recoveredSessionId}`);
+            }
             // Create typed navigation result
             const navigationResult = {
                 stepId: result.stepId,

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

@@ -18,7 +18,6 @@ export { useExpressPaymentMethods } from './hooks/useExpressPaymentMethods';
 export { useGeoLocation } from './hooks/useGeoLocation';
 export { useGoogleAutocomplete } from './hooks/useGoogleAutocomplete';
 export { getAvailableLanguages, useCountryOptions, useISOData, useLanguageImport, useRegionOptions } from './hooks/useISOData';
-export { useLocalPluginConfig } from './hooks/useLocalPluginConfig';
 export { useLogin } from './hooks/useLogin';
 export { usePluginConfig } from './hooks/usePluginConfig';
 export { useRemappableParams } from './hooks/useRemappableParams';

package/dist/v2/react/index.js

@@ -21,7 +21,6 @@ export { useExpressPaymentMethods } from './hooks/useExpressPaymentMethods';
 export { useGeoLocation } from './hooks/useGeoLocation';
 export { useGoogleAutocomplete } from './hooks/useGoogleAutocomplete';
 export { getAvailableLanguages, useCountryOptions, useISOData, useLanguageImport, useRegionOptions } from './hooks/useISOData';
-export { useLocalPluginConfig } from './hooks/useLocalPluginConfig';
 export { useLogin } from './hooks/useLogin';
 export { usePluginConfig } from './hooks/usePluginConfig';
 export { useRemappableParams } from './hooks/useRemappableParams';

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

@@ -12,6 +12,7 @@ import { decodeJWTClient, isTokenExpired } from '../../../react/utils/jwtDecoder
 import { convertCurrency, formatMoney, formatMoneyWithoutSymbol, formatSimpleMoney, getCurrencyInfo, minorUnitsToMajorUnits, moneyStringOrNumberToMinorUnits, } from '../../../react/utils/money';
 import { clearClientToken, getClientToken, setClientToken } from '../../../react/utils/tokenStorage';
 import { ApiClient } from '../../core/resources/apiClient';
+import { resolveEnvValue } from '../../core/utils/env';
 import { loadPluginConfig } from '../../core/utils/pluginConfig';
 import { default as DebugDrawer } from '../components/DebugDrawer';
 import { setGlobalApiClient } from '../hooks/useApiQuery';
@@ -47,6 +48,15 @@ const InitializationLoader = () => (_jsxs("div", { style: {
           100% { transform: rotate(360deg); }
         }
       ` })] }));
+const isEnvironment = (value) => value === 'production' || value === 'development' || value === 'local';
+const resolveEnvironmentFromVariables = () => {
+    const envValue = resolveEnvValue('TAGADA_ENV') ?? resolveEnvValue('TAGADA_ENVIRONMENT');
+    if (!envValue) {
+        return undefined;
+    }
+    const normalized = envValue.trim().toLowerCase();
+    return isEnvironment(normalized) ? normalized : undefined;
+};
 const TagadaContext = createContext(null);
 // Global instance tracking for TagadaProvider
 let globalTagadaInstance = null;
@@ -154,7 +164,6 @@ rawPluginConfig, }) {
     }, [configVariant, rawPluginConfig]);
     // Extract store/account IDs from plugin config (only source now)
     const storeId = pluginConfig.storeId;
-    const _accountId = pluginConfig.accountId;
     const [isLoading, setIsLoading] = useState(true);
     const [isInitialized, setIsInitialized] = useState(false);
     const [token, setToken] = useState(null);
@@ -163,12 +172,16 @@ rawPluginConfig, }) {
     const isInitializing = useRef(false);
     // Initialize environment configuration
     const [environmentConfig, _setEnvironmentConfig] = useState(() => {
-        const detectedEnv = environment || detectEnvironment();
+        const envFromVariables = resolveEnvironmentFromVariables();
+        const detectedEnv = environment || envFromVariables || detectEnvironment();
         const config = getEnvironmentConfig(detectedEnv);
         // Log environment detection for debugging
         if (environment) {
             console.log(`[TagadaSDK] Using explicit environment: ${environment}`);
         }
+        else if (envFromVariables) {
+            console.log(`[TagadaSDK] Using environment from env variables: ${envFromVariables}`);
+        }
         else {
             console.log(`[TagadaSDK] Auto-detected environment: ${detectedEnv} (${typeof window !== 'undefined' ? window.location.hostname : 'SSR'})`);
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tagadapay/plugin-sdk",
-  "version": "2.7.16",
+  "version": "2.7.20",
   "description": "Modern React SDK for building Tagada Pay plugins",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

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

@@ -1,22 +0,0 @@
-import { RawPluginConfig } from '../../core/utils/pluginConfig';
-/**
- * Hook to load local plugin config with minimal boilerplate
- * Handles loading state and returns config when ready
- *
- * @example
- * function MyApp() {
- *   const { config, isLoading } = useLocalPluginConfig();
- *
- *   if (isLoading) return <div>Loading...</div>;
- *
- *   return (
- *     <TagadaProvider rawPluginConfig={config}>
- *       <YourApp />
- *     </TagadaProvider>
- *   );
- * }
- */
-export declare function useLocalPluginConfig(): {
-    config: RawPluginConfig | null;
-    isLoading: boolean;
-};

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

@@ -1,30 +0,0 @@
-import { useEffect, useState } from 'react';
-import { localConfigIfAny } from '../../core/utils/pluginConfig';
-/**
- * Hook to load local plugin config with minimal boilerplate
- * Handles loading state and returns config when ready
- *
- * @example
- * function MyApp() {
- *   const { config, isLoading } = useLocalPluginConfig();
- *
- *   if (isLoading) return <div>Loading...</div>;
- *
- *   return (
- *     <TagadaProvider rawPluginConfig={config}>
- *       <YourApp />
- *     </TagadaProvider>
- *   );
- * }
- */
-export function useLocalPluginConfig() {
-    const [config, setConfig] = useState(null);
-    const [isLoading, setIsLoading] = useState(true);
-    useEffect(() => {
-        localConfigIfAny().then((loadedConfig) => {
-            setConfig(loadedConfig);
-            setIsLoading(false);
-        });
-    }, []);
-    return { config, isLoading };
-}