@tagadapay/plugin-sdk 2.6.13 → 2.6.16

package/dist/react/hooks/usePluginConfig.d.ts

@@ -30,14 +30,10 @@ export interface RawPluginConfig<TConfig = Record<string, any>> {
     basePath?: string;
     config?: TConfig;
 }
-export interface LocalDevConfig {
-    storeId: string;
-    accountId: string;
-    basePath: string;
-}
 /**
  * Load plugin configuration (cached)
- * Tries raw config first, then local dev config, then production config
+ * Tries raw config first, then production config
+ * Note: Local dev config should be passed via rawConfig parameter
  */
 export declare const loadPluginConfig: (configVariant?: string, rawConfig?: RawPluginConfig) => Promise<PluginConfig>;
 /**

package/dist/react/hooks/usePluginConfig.js

@@ -22,88 +22,6 @@ import { useTagadaContext } from '../providers/TagadaProvider';
 // Simple cache for plugin configuration
 let cachedConfig = null;
 let configPromise = null;
-/**
- * Load local development configuration
- * Combines .local.json + config/default.tgd.json (or specified variant)
- */
-const loadLocalDevConfig = async (configVariant = 'default') => {
-    try {
-        // Only try to load local config in development
-        // Use hostname-based detection for better Vite compatibility
-        const isLocalDev = typeof window !== 'undefined' &&
-            (window.location.hostname === 'localhost' ||
-                window.location.hostname.includes('ngrok-free.app') ||
-                window.location.hostname.includes('.localhost') ||
-                window.location.hostname.includes('127.0.0.1'));
-        if (!isLocalDev) {
-            return null;
-        }
-        // Load local store/account config
-        const localResponse = await fetch('/.local.json');
-        if (!localResponse.ok) {
-            return null;
-        }
-        const localConfig = await localResponse.json();
-        // Load deployment config (specified variant or fallback to default)
-        let config = {};
-        let configLoaded = false;
-        try {
-            // Try .tgd.json first (new format), then fallback to .json
-            let deploymentResponse = await fetch(`/config/${configVariant}.tgd.json`);
-            if (!deploymentResponse.ok) {
-                deploymentResponse = await fetch(`/config/${configVariant}.json`);
-            }
-            if (deploymentResponse.ok) {
-                config = await deploymentResponse.json();
-                configLoaded = true;
-            }
-        }
-        catch {
-            // Config fetch failed, will try fallback
-        }
-        // If config didn't load and it's not 'default', try fallback to default
-        if (!configLoaded && configVariant !== 'default') {
-            console.warn(`⚠️ Config variant '${configVariant}' not found, falling back to 'default'`);
-            try {
-                let defaultResponse = await fetch('/config/default.tgd.json');
-                if (!defaultResponse.ok) {
-                    defaultResponse = await fetch('/config/default.json');
-                }
-                if (defaultResponse.ok) {
-                    config = await defaultResponse.json();
-                    configLoaded = true;
-                    console.log(`✅ Fallback to 'default' config successful`);
-                }
-            }
-            catch {
-                // Default config also failed
-            }
-        }
-        // Final warning if no config was loaded
-        if (!configLoaded) {
-            if (configVariant === 'default') {
-                console.warn(`⚠️ No 'default' config found. Create /config/default.tgd.json`);
-            }
-            else {
-                console.warn(`⚠️ Neither '${configVariant}' nor 'default' config found. Create /config/default.tgd.json`);
-            }
-        }
-        console.log('🛠️ Using local development plugin config:', {
-            configName: config.configName || configVariant,
-            local: localConfig,
-            deployment: config
-        });
-        return {
-            storeId: localConfig.storeId,
-            accountId: localConfig.accountId,
-            basePath: localConfig.basePath,
-            config,
-        };
-    }
-    catch {
-        return null;
-    }
-};
 /**
  * Load production config from headers and meta tags
  */
@@ -135,12 +53,18 @@ const loadProductionConfig = async () => {
 };
 /**
  * Load plugin configuration (cached)
- * Tries raw config first, then local dev config, then production config
+ * Tries raw config first, then production config
+ * Note: Local dev config should be passed via rawConfig parameter
  */
 export const loadPluginConfig = async (configVariant = 'default', rawConfig) => {
     // If raw config is provided, use it directly
     if (rawConfig) {
-        console.log('🛠️ Using raw plugin config:', rawConfig);
+        console.log('🛠️ Using raw plugin config:', {
+            hasStoreId: !!rawConfig.storeId,
+            hasAccountId: !!rawConfig.accountId,
+            hasConfig: !!rawConfig.config,
+            configKeys: rawConfig.config ? Object.keys(rawConfig.config) : [],
+        });
         return {
             storeId: rawConfig.storeId,
             accountId: rawConfig.accountId,
@@ -148,12 +72,7 @@ export const loadPluginConfig = async (configVariant = 'default', rawConfig) =>
             config: rawConfig.config ?? {},
         };
     }
-    // Try local development config
-    const localConfig = await loadLocalDevConfig(configVariant);
-    if (localConfig) {
-        return localConfig;
-    }
-    // Fall back to production config
+    // Fall back to production config (from headers/meta tags)
     return loadProductionConfig();
 };
 /**

package/dist/react/providers/TagadaProvider.js

@@ -38,11 +38,11 @@ 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

package/dist/v2/index.d.ts

@@ -20,5 +20,6 @@ export type { ShippingRate, ShippingRatesResponse } from './core/resources/shipp
 export type { ApplyDiscountResponse, Discount, DiscountCodeValidation, RemoveDiscountResponse } from './core/resources/discounts';
 export type { ToggleOrderBumpResponse, VipOffer, VipPreviewResponse } from './core/resources/vipOffers';
 export type { StoreConfig } from './core/resources/storeConfig';
-export type { FunnelEvent, FunnelNavigationAction, FunnelNavigationResult, SimpleFunnelContext, FunnelInitializeRequest, FunnelInitializeResponse, FunnelNavigateRequest, FunnelNavigateResponse, FunnelContextUpdateRequest, FunnelContextUpdateResponse } from './core/resources/funnel';
-export { ApplePayButton, ExpressPaymentMethodsProvider, formatMoney, getAvailableLanguages, GooglePayButton, queryKeys, TagadaProvider, useApiMutation, useApiQuery, useCheckout, useCheckoutToken, useCountryOptions, useCurrency, useDiscounts, useExpressPaymentMethods, useGeoLocation, useGoogleAutocomplete, useInvalidateQuery, useISOData, useLanguageImport, useOffers, useOrder, useOrderBump, usePayment, usePluginConfig, usePostPurchases, usePreloadQuery, useProducts, usePromotions, useRegionOptions, useShippingRates, useStoreConfig, useTagadaContext, useThreeds, useThreedsModal, useVipOffers, useFunnel, useSimpleFunnel } from './react';
+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, useCheckout, useCheckoutToken, useCountryOptions, useCurrency, useDiscount, useDiscounts, useExpressPaymentMethods, useFunnel, useGeoLocation, useGoogleAutocomplete, useInvalidateQuery, useISOData, useLanguageImport, useOffers, useOrder, useOrderBump, usePayment, usePluginConfig, usePostPurchases, usePreloadQuery, useProducts, usePromotions, useRegionOptions, useShippingRates, useSimpleFunnel, useStoreConfig, useTagadaContext, useThreeds, useThreedsModal, useTranslation, useVipOffers } from './react';
+export type { StoreDiscount, TranslateFunction, TranslationText, UseTranslationOptions, UseTranslationResult } from './react';

package/dist/v2/index.js

@@ -12,4 +12,4 @@ export * from './core/utils/currency';
 export * from './core/utils/pluginConfig';
 export * from './core/utils/products';
 // React exports (hooks and components only, types are exported above)
-export { ApplePayButton, ExpressPaymentMethodsProvider, formatMoney, getAvailableLanguages, GooglePayButton, queryKeys, TagadaProvider, useApiMutation, useApiQuery, useCheckout, useCheckoutToken, useCountryOptions, useCurrency, useDiscounts, useExpressPaymentMethods, useGeoLocation, useGoogleAutocomplete, useInvalidateQuery, useISOData, useLanguageImport, useOffers, useOrder, useOrderBump, usePayment, usePluginConfig, usePostPurchases, usePreloadQuery, useProducts, usePromotions, useRegionOptions, useShippingRates, useStoreConfig, useTagadaContext, useThreeds, useThreedsModal, useVipOffers, useFunnel, useSimpleFunnel } from './react';
+export { ApplePayButton, ExpressPaymentMethodsProvider, formatMoney, getAvailableLanguages, GooglePayButton, queryKeys, TagadaProvider, useApiMutation, useApiQuery, useCheckout, useCheckoutToken, useCountryOptions, useCurrency, useDiscount, useDiscounts, useExpressPaymentMethods, useFunnel, useGeoLocation, useGoogleAutocomplete, useInvalidateQuery, useISOData, useLanguageImport, useOffers, useOrder, useOrderBump, usePayment, usePluginConfig, usePostPurchases, usePreloadQuery, useProducts, usePromotions, useRegionOptions, useShippingRates, useSimpleFunnel, useStoreConfig, useTagadaContext, useThreeds, useThreedsModal, useTranslation, useVipOffers } from './react';

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

@@ -0,0 +1,79 @@
+/**
+ * Single Discount Hook using TanStack Query
+ * Fetches a specific discount for a given store
+ */
+import { UseQueryResult } from '@tanstack/react-query';
+export interface StoreDiscountRuleAmount {
+    rate: number;
+    amount: number;
+    lock: boolean;
+    date: string;
+}
+export interface StoreDiscountRule {
+    id: string;
+    createdAt: string;
+    updatedAt: string;
+    promotionId: string;
+    type: string;
+    productId: string | null;
+    minimumQuantity: number | null;
+    minimumAmount: Record<string, StoreDiscountRuleAmount> | null;
+    variantIds: string[] | null;
+}
+export interface StoreDiscountAction {
+    id: string;
+    createdAt: string;
+    updatedAt: string;
+    promotionId: string;
+    type: string;
+    adjustmentAmount: number | null;
+    adjustmentPercentage: number | null;
+    adjustmentType: string | null;
+    freeShipping: boolean | null;
+    priceIdToAdd: string | null;
+    productIdToAdd: string | null;
+    variantIdToAdd: string | null;
+    subscriptionFreeTrialDuration: number | null;
+    subscriptionFreeTrialDurationType: string | null;
+    targetProductId: string | null;
+    targetVariantIds: string[] | null;
+    maxQuantityDiscounted: number | null;
+    appliesOnEachItem: boolean | null;
+}
+export interface StoreDiscount {
+    id: string;
+    createdAt: string;
+    updatedAt: string;
+    storeId: string;
+    accountId: string;
+    name: string;
+    code: string;
+    automatic: boolean;
+    usageLimit: number | null;
+    usageCount: number;
+    startDate: string;
+    endDate: string | null;
+    enabled: boolean;
+    archived: boolean;
+    ruleOperator: string;
+    externalId: string | null;
+    combinesWithOrderLevelDiscounts: boolean;
+    combinesWithLineItemDiscounts: boolean;
+    combinesWithShippingDiscounts: boolean;
+    forceCombine: boolean;
+    isTemporary: boolean;
+    rules: StoreDiscountRule[];
+    actions: StoreDiscountAction[];
+}
+export interface UseDiscountQueryOptions {
+    storeId?: string;
+    discountId?: string;
+    enabled?: boolean;
+}
+export interface UseDiscountQueryResult<TData = StoreDiscount> {
+    discount: TData | undefined;
+    isLoading: boolean;
+    error: Error | null;
+    refetch: UseQueryResult<TData>['refetch'];
+}
+export declare function useDiscountQuery<TData = StoreDiscount>(options: UseDiscountQueryOptions): UseDiscountQueryResult<TData>;

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

@@ -0,0 +1,24 @@
+/**
+ * Single Discount Hook using TanStack Query
+ * Fetches a specific discount for a given store
+ */
+import { useMemo } from 'react';
+import { useApiQuery } from './useApiQuery';
+import { usePluginConfig } from './usePluginConfig';
+export function useDiscountQuery(options) {
+    const { storeId: storeIdFromConfig } = usePluginConfig();
+    const { storeId = storeIdFromConfig, discountId, enabled = true } = options;
+    const key = useMemo(() => ['discount', storeId, discountId], [storeId, discountId]);
+    const url = useMemo(() => {
+        if (!storeId || !discountId)
+            return null;
+        return `/api/v1/stores/${storeId}/discounts/${discountId}`;
+    }, [storeId, discountId]);
+    const query = useApiQuery(key, url, { enabled });
+    return {
+        discount: query.data,
+        isLoading: query.isLoading,
+        error: query.error || null,
+        refetch: query.refetch,
+    };
+}

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

@@ -0,0 +1,46 @@
+import { LanguageCode } from '../../../data/languages';
+export type TranslationText = {
+    [key in LanguageCode | string]?: string;
+};
+export interface UseTranslationOptions {
+    defaultLanguage?: string;
+}
+export type TranslateFunction = (text: TranslationText | string | undefined, fallback?: string, languageCode?: string) => string;
+export interface UseTranslationResult {
+    /**
+     * Translate function that handles multi-language text objects
+     * @param text - The text to translate (can be a string or MultiLangText object)
+     * @param fallback - Optional fallback text if translation is not found
+     * @param languageCode - Optional language code to override the current locale
+     * @returns The translated string
+     */
+    t: TranslateFunction;
+    /**
+     * Current locale code (e.g., 'en', 'fr', 'es')
+     */
+    locale: string;
+}
+/**
+ * Hook for translating multi-language text objects
+ *
+ * @example
+ * ```tsx
+ * const { t, locale } = useTranslation({ defaultLanguage: 'en' });
+ *
+ * const multiLangText = {
+ *   en: 'Hello',
+ *   fr: 'Bonjour',
+ *   es: 'Hola'
+ * };
+ *
+ * // Translates to current locale
+ * const translated = t(multiLangText);
+ *
+ * // With fallback
+ * const withFallback = t(multiLangText, 'Default text');
+ *
+ * // Override locale
+ * const inFrench = t(multiLangText, '', 'fr');
+ * ```
+ */
+export declare const useTranslation: (options?: UseTranslationOptions) => UseTranslationResult;

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

@@ -0,0 +1,61 @@
+import { useCallback, useMemo } from 'react';
+/**
+ * Hook for translating multi-language text objects
+ *
+ * @example
+ * ```tsx
+ * const { t, locale } = useTranslation({ defaultLanguage: 'en' });
+ *
+ * const multiLangText = {
+ *   en: 'Hello',
+ *   fr: 'Bonjour',
+ *   es: 'Hola'
+ * };
+ *
+ * // Translates to current locale
+ * const translated = t(multiLangText);
+ *
+ * // With fallback
+ * const withFallback = t(multiLangText, 'Default text');
+ *
+ * // Override locale
+ * const inFrench = t(multiLangText, '', 'fr');
+ * ```
+ */
+export const useTranslation = (options = {}) => {
+    const { defaultLanguage = 'en' } = options;
+    // Get the current language from query params, browser, or fallback to default
+    const locale = useMemo(() => {
+        // Check for language query parameter
+        if (typeof window !== 'undefined') {
+            const urlParams = new URLSearchParams(window.location.search);
+            const langFromQuery = urlParams.get('language');
+            if (langFromQuery)
+                return langFromQuery;
+        }
+        // Try to get browser language
+        if (typeof navigator !== 'undefined') {
+            const browserLang = navigator.language.split('-')[0]; // e.g., 'en-US' -> 'en'
+            return browserLang;
+        }
+        return defaultLanguage;
+    }, [defaultLanguage]);
+    const t = useCallback((text, fallback, languageCode) => {
+        if (!text)
+            return fallback || '';
+        if (typeof text === 'string')
+            return text;
+        const targetLocale = languageCode || locale;
+        if (text[targetLocale])
+            return text[targetLocale];
+        if (fallback)
+            return fallback;
+        if (text[defaultLanguage])
+            return text[defaultLanguage];
+        const firstAvailable = Object.values(text).find((value) => value !== undefined && value !== '');
+        if (firstAvailable)
+            return firstAvailable;
+        return '';
+    }, [locale, defaultLanguage]);
+    return { t, locale };
+};

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

@@ -12,9 +12,11 @@ export { useGeoLocation } from './hooks/useGeoLocation';
 export { useGoogleAutocomplete } from './hooks/useGoogleAutocomplete';
 export { getAvailableLanguages, useCountryOptions, useISOData, useLanguageImport, useRegionOptions } from './hooks/useISOData';
 export { usePluginConfig } from './hooks/usePluginConfig';
+export { useTranslation } from './hooks/useTranslation';
 export { queryKeys, useApiMutation, useApiQuery, useInvalidateQuery, usePreloadQuery } from './hooks/useApiQuery';
 export { useCheckoutQuery as useCheckout } from './hooks/useCheckoutQuery';
 export { useCurrency } from './hooks/useCurrency';
+export { useDiscountQuery as useDiscount } from './hooks/useDiscountQuery';
 export { useDiscountsQuery as useDiscounts } from './hooks/useDiscountsQuery';
 export { useOffersQuery as useOffers } from './hooks/useOffersQuery';
 export { useOrderBumpQuery as useOrderBump } from './hooks/useOrderBumpQuery';
@@ -37,8 +39,11 @@ export type { GeoLocationData, UseGeoLocationOptions, UseGeoLocationReturn } fro
 export type { ExtractedAddress, GooglePlaceDetails, GooglePrediction, UseGoogleAutocompleteOptions, UseGoogleAutocompleteResult } from './hooks/useGoogleAutocomplete';
 export type { ISOCountry, ISORegion, UseISODataResult } from './hooks/useISOData';
 export type { UsePluginConfigOptions, UsePluginConfigResult } from './hooks/usePluginConfig';
+export type { TranslateFunction, TranslationText, UseTranslationOptions, UseTranslationResult } from './hooks/useTranslation';
 export type { UseCheckoutQueryOptions as UseCheckoutOptions, UseCheckoutQueryResult as UseCheckoutResult } from './hooks/useCheckoutQuery';
+export type { StoreDiscount, UseDiscountQueryOptions as UseDiscountOptions, UseDiscountQueryResult as UseDiscountResult } from './hooks/useDiscountQuery';
 export type { UseDiscountsQueryOptions as UseDiscountsOptions, UseDiscountsQueryResult as UseDiscountsResult } from './hooks/useDiscountsQuery';
+export type { FunnelEvent, FunnelNavigationAction, FunnelNavigationResult, SimpleFunnelContext, UseFunnelOptions, UseFunnelResult } from './hooks/useFunnel';
 export type { UseOffersQueryOptions as UseOffersOptions, UseOffersQueryResult as UseOffersResult } from './hooks/useOffersQuery';
 export type { UseOrderBumpQueryOptions as UseOrderBumpOptions, UseOrderBumpQueryResult as UseOrderBumpResult } from './hooks/useOrderBumpQuery';
 export type { UseOrderQueryOptions as UseOrderOptions, UseOrderQueryResult as UseOrderResult } from './hooks/useOrderQuery';
@@ -50,6 +55,5 @@ export type { UseShippingRatesQueryOptions as UseShippingRatesOptions, UseShippi
 export type { UseStoreConfigQueryOptions as UseStoreConfigOptions, UseStoreConfigQueryResult as UseStoreConfigResult } from './hooks/useStoreConfigQuery';
 export type { PaymentInstrument, ThreedsChallenge, ThreedsHook, ThreedsOptions, ThreedsProvider, ThreedsSession } from './hooks/useThreeds';
 export type { UseVipOffersQueryOptions as UseVipOffersOptions, UseVipOffersQueryResult as UseVipOffersResult } from './hooks/useVipOffersQuery';
-export type { UseFunnelOptions, UseFunnelResult, FunnelEvent, FunnelNavigationAction, FunnelNavigationResult, SimpleFunnelContext } from './hooks/useFunnel';
 export { formatMoney } from '../../react/utils/money';
 export type OrderItem = import('../core/utils/order').OrderLineItem;

package/dist/v2/react/index.js

@@ -15,10 +15,12 @@ export { useGeoLocation } from './hooks/useGeoLocation';
 export { useGoogleAutocomplete } from './hooks/useGoogleAutocomplete';
 export { getAvailableLanguages, useCountryOptions, useISOData, useLanguageImport, useRegionOptions } from './hooks/useISOData';
 export { usePluginConfig } from './hooks/usePluginConfig';
+export { useTranslation } from './hooks/useTranslation';
 // TanStack Query hooks (recommended)
 export { queryKeys, useApiMutation, useApiQuery, useInvalidateQuery, usePreloadQuery } from './hooks/useApiQuery';
 export { useCheckoutQuery as useCheckout } from './hooks/useCheckoutQuery';
 export { useCurrency } from './hooks/useCurrency';
+export { useDiscountQuery as useDiscount } from './hooks/useDiscountQuery';
 export { useDiscountsQuery as useDiscounts } from './hooks/useDiscountsQuery';
 export { useOffersQuery as useOffers } from './hooks/useOffersQuery';
 export { useOrderBumpQuery as useOrderBump } from './hooks/useOrderBumpQuery';

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

@@ -52,12 +52,11 @@ interface TagadaProviderProps {
     environment?: Environment;
     customApiConfig?: Partial<EnvironmentConfig>;
     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, // Default to new non-blocking behavior
+blockUntilSessionReady, // Default to new non-blocking behavior
 rawPluginConfig, }: TagadaProviderProps): import("react/jsx-runtime").JSX.Element;
 export declare function useTagadaContext(): TagadaContextValue;
 export {};

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

@@ -41,18 +41,18 @@ 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);
 // Global instance tracking for TagadaProvider
 let globalTagadaInstance = null;
 let globalTagadaInitialized = false;
 export function TagadaProvider({ children, environment, customApiConfig, debugMode, // Remove default, will be set based on environment
-localConfig, blockUntilSessionReady = false, // Default to new non-blocking behavior
+blockUntilSessionReady = false, // Default to new non-blocking behavior
 rawPluginConfig, }) {
     // Instance tracking
     const [instanceId] = useState(() => {
@@ -81,20 +81,13 @@ rawPluginConfig, }) {
             }
         };
     }, [instanceId]);
-    // LOCAL DEV ONLY: Use localConfig override if in local development, otherwise use default
-    const isLocalDev = typeof window !== 'undefined' &&
-        (window.location.hostname === 'localhost' ||
-            window.location.hostname.includes('.localhost') ||
-            window.location.hostname.includes('127.0.0.1'));
-    const configVariant = isLocalDev ? localConfig || 'default' : 'default';
     // Debug logging (only log once during initial render)
     const hasLoggedRef = useRef(false);
     if (!hasLoggedRef.current) {
-        console.log(`🔍 [TagadaProvider] Instance ${instanceId} Config Debug:`, {
+        console.log(`🔍 [TagadaProvider] Instance ${instanceId} Initializing with:`, {
             hostname: typeof window !== 'undefined' ? window.location.hostname : 'SSR',
-            isLocalDev,
-            localConfig,
-            configVariant,
+            hasRawConfig: !!rawPluginConfig,
+            rawConfigStoreId: rawPluginConfig?.storeId,
         });
         hasLoggedRef.current = true;
     }
@@ -102,6 +95,10 @@ rawPluginConfig, }) {
     // Initialize with raw config if available to avoid empty config during loading
     const [pluginConfig, setPluginConfig] = useState(() => {
         if (rawPluginConfig) {
+            console.log('🛠️ [TagadaProvider] Using raw plugin config immediately:', {
+                storeId: rawPluginConfig.storeId,
+                accountId: rawPluginConfig.accountId,
+            });
             return {
                 storeId: rawPluginConfig.storeId,
                 accountId: rawPluginConfig.accountId,
@@ -109,9 +106,11 @@ rawPluginConfig, }) {
                 config: rawPluginConfig.config ?? {},
             };
         }
+        console.log('⏳ [TagadaProvider] No raw config, will load from headers/files');
         return { basePath: '/', config: {} };
     });
     const [configLoading, setConfigLoading] = useState(!rawPluginConfig);
+    const [apiClientReady, setApiClientReady] = useState(false);
     // Load plugin config on mount with the specified variant
     useEffect(() => {
         // Prevent multiple config loads
@@ -121,8 +120,8 @@ rawPluginConfig, }) {
         }
         const loadConfig = async () => {
             try {
-                // Use the v2 core loadPluginConfig function
-                const config = await loadPluginConfig(configVariant, rawPluginConfig);
+                // Use the v2 core loadPluginConfig function (only used when no rawPluginConfig)
+                const config = await loadPluginConfig('default', 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.');
@@ -133,7 +132,7 @@ rawPluginConfig, }) {
                     accountId: config.accountId,
                     basePath: config.basePath,
                     hasConfig: !!config.config,
-                    source: rawPluginConfig ? 'raw' : 'file',
+                    source: rawPluginConfig ? 'raw' : 'headers/files',
                 });
                 if (blockUntilSessionReady) {
                     console.log('⏳ Blocking mode: Children will render after Phase 3 (session init) completes');
@@ -151,7 +150,7 @@ rawPluginConfig, }) {
             }
         };
         void loadConfig();
-    }, [configVariant, rawPluginConfig]);
+    }, [rawPluginConfig]);
     // Extract store/account IDs from plugin config (only source now)
     const storeId = pluginConfig.storeId;
     const _accountId = pluginConfig.accountId;
@@ -217,7 +216,8 @@ rawPluginConfig, }) {
         });
         // Set the global client for TanStack Query hooks
         setGlobalApiClient(client);
-        console.log('[SDK] ApiClient initialized with baseURL:', environmentConfig.apiConfig.baseUrl);
+        setApiClientReady(true);
+        console.log('[SDK] ✅ ApiClient initialized with baseURL:', environmentConfig.apiConfig.baseUrl);
     }, [environmentConfig]);
     // Sync token updates between ApiService and ApiClient
     useEffect(() => {
@@ -669,9 +669,16 @@ rawPluginConfig, }) {
         // debugCheckout removed from deps to prevent unnecessary re-renders
     ]);
     // Determine if we should show loading
-    // Always block until config is loaded (even if empty)
-    const shouldShowLoading = configLoading;
-    const canRenderChildren = !configLoading;
+    // Always block until BOTH config is loaded AND API client is ready
+    const shouldShowLoading = configLoading || !apiClientReady;
+    const canRenderChildren = !configLoading && apiClientReady;
+    if (!hasLoggedRef.current && canRenderChildren) {
+        console.log('✅ [TagadaProvider] All initialization complete, ready to render children:', {
+            configLoading,
+            apiClientReady,
+            hasStoreId: !!pluginConfig.storeId,
+        });
+    }
     // Initialize TanStack Query client
     const [queryClient] = useState(() => new QueryClient({
         defaultOptions: {