@tagadapay/plugin-sdk 2.4.34 → 2.4.36

package/dist/react/hooks/usePluginConfig.js

@@ -2,10 +2,23 @@
  * Plugin Configuration Hook
  *
  * Professional SDK approach to access plugin configuration:
+ * - Raw Config: Direct configuration passed via TagadaProvider (highest priority)
  * - Store ID, Account ID, Base Path: from .local.json (dev) or headers (production)
  * - Deployment Config: from config/*.json (dev) or meta tags (production)
+ *
+ * Usage:
+ * 1. Raw config (recommended for programmatic usage):
+ *    <TagadaProvider rawPluginConfig={{ storeId: 'store_123', config: {...} }}>
+ *
+ * 2. File-based config (for development):
+ *    - .local.json for store/account info
+ *    - config/default.tgd.json for deployment config
+ *
+ * 3. Production config:
+ *    - Headers for store/account info
+ *    - Meta tags for deployment config
  */
-import { useTagadaContext } from '../providers/TagadaProvider';
+import { useTagadaContextSafe } from '../providers/TagadaProvider';
 // Simple cache for plugin configuration
 let cachedConfig = null;
 let configPromise = null;
@@ -122,10 +135,20 @@ const loadProductionConfig = async () => {
 };
 /**
  * Load plugin configuration (cached)
- * Tries local dev config first, then production config
+ * Tries raw config first, then local dev config, then production config
  */
-export const loadPluginConfig = async (configVariant = 'default') => {
-    // Try local development config first
+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,
+            basePath: rawConfig.basePath ?? '/',
+            config: rawConfig.config ?? {},
+        };
+    }
+    // Try local development config
     const localConfig = await loadLocalDevConfig(configVariant);
     if (localConfig) {
         return localConfig;
@@ -138,8 +161,26 @@ export const loadPluginConfig = async (configVariant = 'default') => {
  * Gets config from TagadaProvider context (no parameters needed)
  */
 export const usePluginConfig = () => {
-    const context = useTagadaContext();
+    const context = useTagadaContextSafe();
+    // Log to confirm we're using the updated SDK
+    console.log('🔧 [SDK DEBUG] usePluginConfig called - using updated SDK version with safe context handling');
+    // If context is not ready yet, return loading state
+    if (!context) {
+        console.log('🔧 [SDK DEBUG] Context not ready yet, returning loading state');
+        return {
+            storeId: undefined,
+            accountId: undefined,
+            basePath: '/',
+            config: {},
+            loading: true,
+        };
+    }
     const { pluginConfig, pluginConfigLoading } = context;
+    console.log('🔧 [SDK DEBUG] Context ready, returning plugin config:', {
+        storeId: pluginConfig.storeId,
+        loading: pluginConfigLoading,
+        hasConfig: !!pluginConfig.config
+    });
     return {
         storeId: pluginConfig.storeId,
         accountId: pluginConfig.accountId,
@@ -158,14 +199,14 @@ export const useBasePath = () => {
 /**
  * Get cached config directly (for non-React usage)
  */
-export const getPluginConfig = async (configVariant = 'default') => {
+export const getPluginConfig = async (configVariant = 'default', rawConfig) => {
     if (cachedConfig) {
         return cachedConfig;
     }
     if (configPromise) {
         return configPromise;
     }
-    configPromise = loadPluginConfig(configVariant);
+    configPromise = loadPluginConfig(configVariant, rawConfig);
     const result = await configPromise;
     cachedConfig = result;
     configPromise = null;
@@ -181,7 +222,7 @@ export const clearPluginConfigCache = () => {
 /**
  * Development helper to log current configuration
  */
-export const debugPluginConfig = async (configVariant = 'default') => {
+export const debugPluginConfig = async (configVariant = 'default', rawConfig) => {
     // Use hostname-based detection for better Vite compatibility
     const isLocalDev = typeof window !== 'undefined' &&
         (window.location.hostname === 'localhost' ||
@@ -191,7 +232,7 @@ export const debugPluginConfig = async (configVariant = 'default') => {
     if (!isLocalDev) {
         return;
     }
-    const config = await getPluginConfig(configVariant);
+    const config = await getPluginConfig(configVariant, rawConfig);
     console.group('🔧 Plugin Configuration Debug');
     console.log('Store ID:', config.storeId || 'Not available');
     console.log('Account ID:', config.accountId || 'Not available');

package/dist/react/index.d.ts

@@ -7,9 +7,6 @@ export { useCheckout } from './hooks/useCheckout';
 export { useClubOffers } from './hooks/useClubOffers';
 export { useCurrency } from './hooks/useCurrency';
 export { useCustomer } from './hooks/useCustomer';
-export { useCustomerInfos } from './hooks/useCustomerInfos';
-export { useCustomerOrders } from './hooks/useCustomerOrders';
-export { useCustomerSubscriptions } from './hooks/useCustomerSubscriptions';
 export { useDiscounts } from './hooks/useDiscounts';
 export { useEnvironment } from './hooks/useEnvironment';
 export { useGeoLocation } from './hooks/useGeoLocation';
@@ -25,10 +22,10 @@ export { useShippingRates } from './hooks/useShippingRates';
 export type { UseShippingRatesOptions, UseShippingRatesResult } from './hooks/useShippingRates';
 export { useTranslations } from './hooks/useTranslations';
 export { useVipOffers } from './hooks/useVipOffers';
-export { useTagadaContext } from './providers/TagadaProvider';
+export { useTagadaContext, useTagadaContextSafe } from './providers/TagadaProvider';
 export { clearPluginConfigCache, debugPluginConfig, getPluginConfig, useBasePath, usePluginConfig } from './hooks/usePluginConfig';
 export type { PluginConfig } from './hooks/usePluginConfig';
-export { getAvailableLanguages, useCountryOptions, useISOData, useRegionOptions } from './hooks/useISOData';
+export { getAvailableLanguages, useCountryOptions, useISOData, useRegionOptions, useLanguageImport } from './hooks/useISOData';
 export type { ISOCountry, ISORegion, UseISODataResult } from './hooks/useISOData';
 export type { GeoLocationData, UseGeoLocationOptions, UseGeoLocationReturn } from './hooks/useGeoLocation';
 export type { ExtractedAddress, GoogleAddressComponent, GooglePlaceDetails, GooglePrediction, UseGoogleAutocompleteOptions, UseGoogleAutocompleteResult } from './hooks/useGoogleAutocomplete';
@@ -40,7 +37,7 @@ export { useThreeds } from './hooks/useThreeds';
 export { useThreedsModal } from './hooks/useThreedsModal';
 export { useApplePay } from './hooks/useApplePay';
 export { ExpressPaymentProvider, useExpressPayment } from './hooks/useExpressPayment';
-export type { AuthState, Currency, Customer, CustomerInfos, Environment, EnvironmentConfig, Locale, Order, OrderAddress, OrderItem, OrderSummary, PickupPoint, Session, Store } from './types';
+export type { AuthState, Currency, Customer, Environment, EnvironmentConfig, Locale, Order, OrderAddress, OrderItem, OrderSummary, PickupPoint, Session, Store } from './types';
 export type { CheckoutData, CheckoutInitParams, CheckoutLineItem, CheckoutSession, CheckoutSessionPreview, Promotion, UseCheckoutOptions, UseCheckoutResult } from './hooks/useCheckout';
 export type { Discount, DiscountCodeValidation, UseDiscountsOptions, UseDiscountsResult } from './hooks/useDiscounts';
 export type { OrderBumpPreview, UseOrderBumpOptions, UseOrderBumpResult } from './hooks/useOrderBump';

package/dist/react/index.js

@@ -10,9 +10,6 @@ export { useCheckout } from './hooks/useCheckout';
 export { useClubOffers } from './hooks/useClubOffers';
 export { useCurrency } from './hooks/useCurrency';
 export { useCustomer } from './hooks/useCustomer';
-export { useCustomerInfos } from './hooks/useCustomerInfos';
-export { useCustomerOrders } from './hooks/useCustomerOrders';
-export { useCustomerSubscriptions } from './hooks/useCustomerSubscriptions';
 export { useDiscounts } from './hooks/useDiscounts';
 export { useEnvironment } from './hooks/useEnvironment';
 export { useGeoLocation } from './hooks/useGeoLocation';
@@ -27,11 +24,11 @@ export { useSession } from './hooks/useSession';
 export { useShippingRates } from './hooks/useShippingRates';
 export { useTranslations } from './hooks/useTranslations';
 export { useVipOffers } from './hooks/useVipOffers';
-export { useTagadaContext } from './providers/TagadaProvider';
+export { useTagadaContext, useTagadaContextSafe } from './providers/TagadaProvider';
 // Plugin configuration hooks
 export { clearPluginConfigCache, debugPluginConfig, getPluginConfig, useBasePath, usePluginConfig } from './hooks/usePluginConfig';
 // ISO Data hooks
-export { getAvailableLanguages, useCountryOptions, useISOData, useRegionOptions } from './hooks/useISOData';
+export { getAvailableLanguages, useCountryOptions, useISOData, useRegionOptions, useLanguageImport } from './hooks/useISOData';
 // Order hook exports
 export { useOrder } from './hooks/useOrder';
 // Payment hooks exports

package/dist/react/providers/TagadaProvider.d.ts

@@ -2,7 +2,7 @@
  * TagadaProvider - Main provider component for the Tagada Pay React SDK
  */
 import { ReactNode } from 'react';
-import { PluginConfig } from '../hooks/usePluginConfig';
+import { PluginConfig, RawPluginConfig } from '../hooks/usePluginConfig';
 import { ApiService } from '../services/apiService';
 import { AuthState, Currency, Customer, Environment, EnvironmentConfig, Locale, Session, Store } from '../types';
 import { convertCurrency, formatMoney, formatMoneyWithoutSymbol, formatSimpleMoney, getCurrencyInfo, minorUnitsToMajorUnits, moneyStringOrNumberToMinorUnits } from '../utils/money';
@@ -54,8 +54,11 @@ interface TagadaProviderProps {
     debugMode?: boolean;
     localConfig?: string;
     blockUntilSessionReady?: boolean;
+    rawPluginConfig?: RawPluginConfig;
 }
 export declare function TagadaProvider({ children, environment, customApiConfig, debugMode, // Remove default, will be set based on environment
-localConfig, blockUntilSessionReady, }: TagadaProviderProps): import("react/jsx-runtime").JSX.Element;
+localConfig, blockUntilSessionReady, // Default to new non-blocking behavior
+rawPluginConfig, }: TagadaProviderProps): import("react/jsx-runtime").JSX.Element;
 export declare function useTagadaContext(): TagadaContextValue;
+export declare function useTagadaContextSafe(): TagadaContextValue | null;
 export {};

package/dist/react/providers/TagadaProvider.js

@@ -38,16 +38,16 @@ 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, // Remove default, will be set based on environment
 localConfig, blockUntilSessionReady = false, // Default to new non-blocking behavior
- }) {
+rawPluginConfig, }) {
     // LOCAL DEV ONLY: Use localConfig override if in local development, otherwise use default
     const isLocalDev = typeof window !== 'undefined' &&
         (window.location.hostname === 'localhost' ||
@@ -72,7 +72,7 @@ localConfig, blockUntilSessionReady = false, // Default to new non-blocking beha
     useEffect(() => {
         const loadConfig = async () => {
             try {
-                const config = await loadPluginConfig(configVariant);
+                const config = await loadPluginConfig(configVariant, rawPluginConfig);
                 // Ensure we have required store ID before proceeding
                 if (!config.storeId) {
                     console.warn('⚠️ No store ID found in plugin config. This may cause hooks to fail.');
@@ -83,6 +83,7 @@ localConfig, blockUntilSessionReady = false, // Default to new non-blocking beha
                     accountId: config.accountId,
                     basePath: config.basePath,
                     hasConfig: !!config.config,
+                    source: rawPluginConfig ? 'raw' : 'file',
                 });
                 if (blockUntilSessionReady) {
                     console.log('⏳ Blocking mode: Children will render after Phase 3 (session init) completes');
@@ -100,7 +101,7 @@ localConfig, blockUntilSessionReady = false, // Default to new non-blocking beha
             }
         };
         void loadConfig();
-    }, [configVariant]);
+    }, [configVariant, rawPluginConfig]);
     // Extract store/account IDs from plugin config (only source now)
     const storeId = pluginConfig.storeId;
     const accountId = pluginConfig.accountId;
@@ -350,58 +351,6 @@ localConfig, blockUntilSessionReady = false, // Default to new non-blocking beha
             setIsLoading(false);
         }
     }, [apiService, hasAttemptedAnonymousToken, initializeSession, finalDebugMode]);
-    // Initialize token from storage or create anonymous token (extracted to stable callback)
-    const initializeToken = useCallback(async () => {
-        try {
-            console.debug('[SDK] Initializing token...');
-            setIsLoading(true);
-            // Check for existing token
-            const existingToken = getClientToken();
-            let tokenToUse = null;
-            // Check URL params for token
-            const urlParams = new URLSearchParams(window.location.search);
-            const queryToken = urlParams.get('token');
-            if (queryToken) {
-                console.debug('[SDK] Found token in URL params');
-                tokenToUse = queryToken;
-                setClientToken(queryToken);
-            }
-            else if (existingToken && !isTokenExpired(existingToken)) {
-                console.debug('[SDK] Using existing token from storage');
-                tokenToUse = existingToken;
-            }
-            else {
-                console.debug('[SDK] No valid token found');
-                // Determine storeId for anonymous token
-                const targetStoreId = storeId || 'default-store';
-                await createAnonymousToken(targetStoreId);
-                return;
-            }
-            if (tokenToUse) {
-                setToken(tokenToUse);
-                // Update the API service with the token
-                apiService.updateToken(tokenToUse);
-                // Decode token to get session data
-                const decodedSession = decodeJWTClient(tokenToUse);
-                if (decodedSession) {
-                    setSession(decodedSession);
-                    // Initialize session with API call
-                    await initializeSession(decodedSession);
-                }
-                else {
-                    console.error('[SDK] Failed to decode token');
-                    setIsInitialized(true);
-                    setIsSessionInitialized(false); // Session failed to initialize
-                    setIsLoading(false);
-                }
-            }
-        }
-        catch (error) {
-            console.error('[SDK] Error initializing token:', error);
-            setIsInitialized(true);
-            setIsLoading(false);
-        }
-    }, [apiService, storeId, createAnonymousToken, initializeSession]);
     // Initialize token from storage or create anonymous token
     // This runs in the background after phases 1 & 2 complete, but doesn't block rendering
     useEffect(() => {
@@ -413,19 +362,59 @@ localConfig, blockUntilSessionReady = false, // Default to new non-blocking beha
             return;
         }
         isInitializing.current = true;
-        void initializeToken();
-    }, [storeId, configLoading, initializeToken]);
-    useEffect(() => {
-        function onStorage() {
-            // Re-run initialization when token may have changed in another tab
-            isInitializing.current = false;
-            void initializeToken();
-        }
-        window.addEventListener('storage', onStorage);
-        return () => {
-            window.removeEventListener('storage', onStorage);
+        const initializeToken = async () => {
+            try {
+                console.debug('[SDK] Initializing token...');
+                setIsLoading(true);
+                // Check for existing token
+                const existingToken = getClientToken();
+                let tokenToUse = null;
+                // Check URL params for token
+                const urlParams = new URLSearchParams(window.location.search);
+                const queryToken = urlParams.get('token');
+                if (queryToken) {
+                    console.debug('[SDK] Found token in URL params');
+                    tokenToUse = queryToken;
+                    setClientToken(queryToken);
+                }
+                else if (existingToken && !isTokenExpired(existingToken)) {
+                    console.debug('[SDK] Using existing token from storage');
+                    tokenToUse = existingToken;
+                }
+                else {
+                    console.debug('[SDK] No valid token found');
+                    // Determine storeId for anonymous token
+                    const targetStoreId = storeId || 'default-store';
+                    await createAnonymousToken(targetStoreId);
+                    return;
+                }
+                if (tokenToUse) {
+                    setToken(tokenToUse);
+                    // Update the API service with the token
+                    apiService.updateToken(tokenToUse);
+                    // Decode token to get session data
+                    const decodedSession = decodeJWTClient(tokenToUse);
+                    if (decodedSession) {
+                        setSession(decodedSession);
+                        // Initialize session with API call
+                        await initializeSession(decodedSession);
+                    }
+                    else {
+                        console.error('[SDK] Failed to decode token');
+                        setIsInitialized(true);
+                        setIsSessionInitialized(false); // Session failed to initialize
+                        setIsLoading(false);
+                    }
+                }
+            }
+            catch (error) {
+                console.error('[SDK] Error initializing token:', error);
+                setIsInitialized(true);
+                setIsLoading(false);
+            }
         };
-    }, [initializeToken]);
+        void initializeToken();
+    }, [storeId, createAnonymousToken, initializeSession, configLoading]);
     // Update auth state when customer/session changes
     useEffect(() => {
         setAuth({
@@ -571,6 +560,10 @@ export function useTagadaContext() {
     }
     return context;
 }
+// Safe version that returns null instead of throwing
+export function useTagadaContextSafe() {
+    return useContext(TagadaContext);
+}
 // Helper functions
 function getCurrencySymbol(code) {
     const symbols = {

package/dist/react/types.d.ts

@@ -150,112 +150,3 @@ export interface Order {
     };
     relatedOrders?: Order[];
 }
-export interface PaymentSummary {
-    id: string;
-    status: string;
-    amount: number;
-    currency: string;
-    createdAt: string;
-    updatedAt?: string;
-    provider?: string;
-    metadata?: Record<string, any>;
-}
-export interface PromotionSummary {
-    id: string;
-    code?: string | null;
-    type?: string;
-    amount?: number;
-    description?: string | null;
-}
-export interface OrderAdjustmentSummary {
-    type: string;
-    amount: number;
-    description: string;
-}
-export interface OrderWithRelations extends Order {
-    customer?: Customer;
-    store?: Store;
-    account?: {
-        id: string;
-        name?: string;
-    } | undefined;
-    items: OrderItem[];
-    payments?: PaymentSummary[];
-    summaries: OrderSummary[];
-    checkoutSession?: {
-        id?: string;
-        returnUrl?: string;
-        [key: string]: any;
-    };
-    promotions?: PromotionSummary[];
-    subscriptions?: any[];
-    adjustments: OrderAdjustmentSummary[];
-}
-export interface CustomerAddress {
-    company?: string;
-    firstName: string;
-    lastName: string;
-    address1: string;
-    city: string;
-    country: string;
-    state: string;
-    postal: string;
-    phone?: string;
-    email?: string;
-}
-export interface CustomerOrderSummary {
-    id: string;
-    storeId: string;
-    accountId: string;
-    createdAt: string;
-    updatedAt: string;
-    status: string;
-    cancelledAt: string | null;
-    cancelledReason: string | null;
-    paidAt: string | null;
-    paidAmount: number | null;
-    openAt: string | null;
-    abandonedAt: string | null;
-    currency: string;
-    externalCustomerType: string | null;
-    externalCustomerId: string | null;
-    externalOrderId: string | null;
-    billingAddress: CustomerAddress;
-    shippingAddress: Omit<CustomerAddress, 'email'>;
-    pickupAddress: any | null;
-    taxesIncluded: boolean;
-    draft: boolean;
-    checkoutSessionId: string | null;
-    sessionHash: string | null;
-    customerId: string;
-    createdFrom: string | null;
-    paymentInstrumentId: string | null;
-    refundedAt: string | null;
-    refundedAmount: number | null;
-    metadata?: Record<string, any>;
-}
-export interface CustomerInfos {
-    customer: {
-        id: string;
-        email: string | null;
-        firstName: string | null;
-        lastName: string | null;
-        externalCustomerId: string | null;
-        lastOrderId: string | null;
-        accountId: string;
-        storeId: string;
-        billingAddress: CustomerAddress | null;
-        shippingAddress: Omit<CustomerAddress, 'email'> | null;
-        currency: string | null;
-        locale: string | null;
-        draft: boolean;
-        acceptsMarketing: boolean;
-        createdAt: string;
-        updatedAt: string;
-        metadata: Record<string, any>;
-        device: any | null;
-        orders: CustomerOrderSummary[];
-        subscriptions: any[];
-    };
-    promotionCodes: any[];
-}

package/dist/react/utils/tokenStorage.js

@@ -10,7 +10,6 @@ export function setClientToken(token) {
     if (typeof window !== 'undefined') {
         try {
             localStorage.setItem(TOKEN_KEY, token);
-            window.dispatchEvent(new Event('storage'));
         }
         catch (error) {
             console.error('Failed to save token to localStorage:', error);