@tagadapay/plugin-sdk 2.8.9 → 3.0.1

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

@@ -3,18 +3,26 @@
  * Handles offers with automatic caching
  */
 import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
-import { useCallback, useMemo, useRef, useState } from 'react';
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import { OffersResource } from '../../core/resources/offers';
 import { useTagadaContext } from '../providers/TagadaProvider';
 import { getGlobalApiClient } from './useApiQuery';
 import { usePluginConfig } from './usePluginConfig';
 export function useOffersQuery(options = {}) {
-    const { offerIds = [], enabled = true, returnUrl, orderId: defaultOrderId } = options;
+    const { offerIds = [], enabled = true, returnUrl, orderId: defaultOrderId, activeOfferId, skipPreview = false } = options;
     const { storeId } = usePluginConfig();
     const { isSessionInitialized, session } = useTagadaContext();
     const _queryClient = useQueryClient();
+    // Version identifier for debugging
+    console.log('[useOffersQuery] Hook initialized - VERSION: 2.2-production-ready', {
+        activeOfferId,
+        skipPreview,
+        isSessionInitialized,
+    });
     // State for checkout sessions per offer (similar to postPurchases)
     const [checkoutSessions, setCheckoutSessions] = useState({});
+    const [isActiveSummaryLoading, setIsActiveSummaryLoading] = useState(false);
+    const lastPreviewedOfferRef = useRef(null);
     // Use ref to break dependency cycles in callbacks
     const checkoutSessionsRef = useRef(checkoutSessions);
     // Update ref on every render
@@ -30,6 +38,8 @@ export function useOffersQuery(options = {}) {
     }, []);
     // Helper function for fetching order summary (similar to postPurchases)
     const fetchOrderSummary = useCallback(async (offerId, sessionId) => {
+        if (!isSessionInitialized)
+            return null;
         try {
             // Set updating state
             setCheckoutSessions(prev => ({
@@ -77,7 +87,7 @@ export function useOffersQuery(options = {}) {
             }));
             throw error;
         }
-    }, [offersResource]);
+    }, [offersResource, isSessionInitialized]);
     // Create query key based on options
     const queryKey = useMemo(() => ['offers', { storeId, offerIds }], [storeId, offerIds]);
     // Use TanStack Query for fetching offers
@@ -120,6 +130,9 @@ export function useOffersQuery(options = {}) {
         return await payWithCheckoutSessionAsync({ checkoutSessionId, orderId });
     }, [payWithCheckoutSessionAsync]);
     const initCheckoutSession = useCallback(async (offerId, orderId, customerId) => {
+        if (!isSessionInitialized) {
+            throw new Error('Cannot initialize checkout session: CMS session is not initialized');
+        }
         // Use customerId from session context if not provided
         const effectiveCustomerId = customerId || session?.customerId;
         if (!effectiveCustomerId) {
@@ -130,8 +143,11 @@ export function useOffersQuery(options = {}) {
             orderId,
             customerId: effectiveCustomerId
         });
-    }, [initCheckoutSessionAsync, session?.customerId]);
+    }, [initCheckoutSessionAsync, session?.customerId, isSessionInitialized]);
     const payOffer = useCallback(async (offerId, orderId) => {
+        if (!isSessionInitialized) {
+            throw new Error('Cannot pay offer: CMS session is not initialized');
+        }
         const effectiveOrderId = orderId || defaultOrderId;
         const effectiveCustomerId = session?.customerId;
         if (!effectiveOrderId) {
@@ -144,18 +160,26 @@ export function useOffersQuery(options = {}) {
         const { checkoutSessionId } = await initCheckoutSession(offerId, effectiveOrderId, effectiveCustomerId);
         // 2. Pay
         await payWithCheckoutSession(checkoutSessionId, effectiveOrderId);
-    }, [initCheckoutSession, payWithCheckoutSession, defaultOrderId, session?.customerId]);
+    }, [initCheckoutSession, payWithCheckoutSession, defaultOrderId, session?.customerId, isSessionInitialized]);
     const preview = useCallback(async (offerId) => {
+        console.log('[useOffersQuery] preview() called for offer:', offerId);
+        if (!isSessionInitialized) {
+            console.log('[useOffersQuery] preview() - session not initialized, returning null');
+            // Return null silently to avoid errors during auto-initialization phases
+            return null;
+        }
         const effectiveOrderId = defaultOrderId;
         const effectiveCustomerId = session?.customerId;
         // Use ref to check current state without creating dependency
         const currentSessions = checkoutSessionsRef.current;
         // If we already have a summary in state, return it
         if (currentSessions[offerId]?.orderSummary) {
+            console.log('[useOffersQuery] preview() - using cached summary for offer:', offerId);
             return currentSessions[offerId].orderSummary;
         }
         // Prevent duplicate initialization if already has a session and is updating
         if (currentSessions[offerId]?.checkoutSessionId && currentSessions[offerId]?.isUpdatingSummary) {
+            console.log('[useOffersQuery] preview() - already updating, skipping for offer:', offerId);
             return null;
         }
         // If we don't have orderId, fallback to static summary from offer object
@@ -189,7 +213,71 @@ export function useOffersQuery(options = {}) {
             console.error("Failed to preview offer", e);
             return null;
         }
-    }, [offers, defaultOrderId, session?.customerId, initCheckoutSession, fetchOrderSummary]); // Removed checkoutSessions dependency
+    }, [offers, defaultOrderId, session?.customerId, initCheckoutSession, fetchOrderSummary, isSessionInitialized]); // Removed checkoutSessions dependency
+    // Auto-preview effect for activeOfferId
+    useEffect(() => {
+        console.log('[useOffersQuery v2.2] Auto-preview effect triggered:', {
+            activeOfferId,
+            skipPreview,
+            isSessionInitialized,
+            lastPreviewed: lastPreviewedOfferRef.current,
+        });
+        if (!activeOfferId || skipPreview || !isSessionInitialized) {
+            console.log('[useOffersQuery] Skipping auto-preview - conditions not met');
+            setIsActiveSummaryLoading(false); // Reset loading state if conditions not met
+            // Reset the ref when conditions are not met
+            if (!activeOfferId) {
+                lastPreviewedOfferRef.current = null;
+            }
+            return;
+        }
+        // Skip if we've already previewed this exact offer
+        if (lastPreviewedOfferRef.current === activeOfferId) {
+            console.log('[useOffersQuery] Skipping auto-preview - already previewed:', activeOfferId);
+            setIsActiveSummaryLoading(false); // Ensure loading is false
+            return;
+        }
+        console.log('[useOffersQuery] Starting auto-preview for offer:', activeOfferId);
+        let isMounted = true;
+        setIsActiveSummaryLoading(true); // Set loading immediately
+        // Debounce the preview call
+        const timer = setTimeout(() => {
+            if (!isMounted) {
+                console.log('[useOffersQuery] Component unmounted before preview call');
+                return;
+            }
+            console.log('[useOffersQuery] Calling preview for offer:', activeOfferId);
+            preview(activeOfferId)
+                .then(() => {
+                if (isMounted) {
+                    console.log('[useOffersQuery] Preview successful for offer:', activeOfferId);
+                    lastPreviewedOfferRef.current = activeOfferId; // Mark as previewed on success
+                }
+            })
+                .catch(err => {
+                console.error('[useOffersQuery] Failed to auto-preview offer:', activeOfferId, err);
+                // Don't mark as previewed on error, to avoid infinite retry loop
+            })
+                .finally(() => {
+                if (isMounted) {
+                    console.log('[useOffersQuery] Preview finished for offer:', activeOfferId);
+                    setIsActiveSummaryLoading(false);
+                }
+            });
+        }, 50);
+        return () => {
+            console.log('[useOffersQuery] Cleaning up auto-preview effect for offer:', activeOfferId);
+            isMounted = false;
+            clearTimeout(timer);
+            setIsActiveSummaryLoading(false); // Reset loading on unmount/cleanup
+        };
+    }, [activeOfferId, skipPreview, isSessionInitialized]); // FIXED: Removed 'preview' from dependencies to prevent infinite loop
+    const activeSummary = useMemo(() => {
+        if (!activeOfferId)
+            return null;
+        // Return dynamic summary if available, otherwise fallback to static summary
+        return checkoutSessions[activeOfferId]?.orderSummary || offers.find(o => o.id === activeOfferId)?.summaries?.[0] || null;
+    }, [activeOfferId, checkoutSessions, offers]);
     const getAvailableVariants = useCallback((offerId, productId) => {
         const sessionState = checkoutSessions[offerId]; // This hook needs to react to state changes
         if (!sessionState?.orderSummary?.options?.[productId])
@@ -208,6 +296,9 @@ export function useOffersQuery(options = {}) {
         return checkoutSessions[offerId]?.loadingVariants?.[productId] ?? false;
     }, [checkoutSessions]);
     const selectVariant = useCallback(async (offerId, productId, variantId) => {
+        if (!isSessionInitialized) {
+            throw new Error('Cannot select variant: CMS session is not initialized');
+        }
         // Use ref for initial check to avoid dependency but we might need latest state for logic
         // Actually for actions it's better to use ref or just dependency if action is not called in useEffect
         const currentSessions = checkoutSessionsRef.current;
@@ -286,12 +377,14 @@ export function useOffersQuery(options = {}) {
                 }
             }));
         }
-    }, [offersResource, fetchOrderSummary]); // Removed checkoutSessions dependency
-    return {
+    }, [offersResource, fetchOrderSummary, isSessionInitialized]); // Removed checkoutSessions dependency
+    const result = {
         // Query data
         offers,
         isLoading,
         error,
+        activeSummary,
+        isActiveSummaryLoading,
         // Actions
         payOffer,
         preview,
@@ -299,4 +392,13 @@ export function useOffersQuery(options = {}) {
         selectVariant,
         isLoadingVariants,
     };
+    console.log('[useOffersQuery] Returning result:', {
+        offersCount: offers.length,
+        isLoading,
+        hasError: !!error,
+        activeOfferId,
+        hasActiveSummary: !!activeSummary,
+        isActiveSummaryLoading,
+    });
+    return result;
 }

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

@@ -5,6 +5,7 @@
 import { Product, ProductVariant } from '../../core/resources/products';
 export interface UseProductsQueryOptions {
     productIds?: string[];
+    variantIds?: string[];
     enabled?: boolean;
     includeVariants?: boolean;
     includePrices?: boolean;

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

@@ -8,7 +8,7 @@ import { ProductsResource } from '../../core/resources/products';
 import { getGlobalApiClient } from './useApiQuery';
 import { usePluginConfig } from './usePluginConfig';
 export function useProductsQuery(options = {}) {
-    const { productIds = [], enabled = true, includeVariants = true, includePrices = true } = options;
+    const { productIds = [], variantIds = [], enabled = true, includeVariants = true, includePrices = true } = options;
     const { storeId } = usePluginConfig();
     // Create products resource client
     const productsResource = useMemo(() => {
@@ -20,7 +20,7 @@ export function useProductsQuery(options = {}) {
         }
     }, []);
     // Create query key based on options
-    const queryKey = useMemo(() => ['products', { storeId, productIds, includeVariants, includePrices }], [storeId, productIds, includeVariants, includePrices]);
+    const queryKey = useMemo(() => ['products', { storeId, productIds, variantIds, includeVariants, includePrices }], [storeId, productIds, variantIds, includeVariants, includePrices]);
     // Use TanStack Query for fetching products
     const { data: products = [], isLoading, error, refetch } = useQuery({
         queryKey,
@@ -29,18 +29,22 @@ export function useProductsQuery(options = {}) {
             if (!storeId) {
                 throw new Error('Store ID not found. Make sure the TagadaProvider is properly configured.');
             }
-            const options = {
+            const baseOptions = {
                 storeId,
                 includeVariants,
                 includePrices,
             };
-            if (productIds.length > 0) {
+            if (variantIds.length > 0) {
+                // Fetch products by variant IDs (most efficient)
+                return await productsResource.getProductsByVariantIds(variantIds, baseOptions);
+            }
+            else if (productIds.length > 0) {
                 // Fetch specific products
-                return await productsResource.getProductsByIds(productIds, options);
+                return await productsResource.getProductsByIds(productIds, baseOptions);
             }
             else {
                 // Fetch all products for the store
-                return await productsResource.getProducts(options);
+                return await productsResource.getProducts(baseOptions);
             }
         },
         staleTime: 5 * 60 * 1000, // 5 minutes

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

@@ -25,7 +25,7 @@ export { queryKeys, useApiMutation, useApiQuery, useInvalidateQuery, usePreloadQ
 export { useCheckoutQuery as useCheckout } from './hooks/useCheckoutQuery';
 export { useCurrency } from './hooks/useCurrency';
 export { useDiscountsQuery as useDiscounts } from './hooks/useDiscountsQuery';
-export { useOffersQuery as useOffers } from './hooks/useOffersQuery';
+export { useOfferQuery as useOffer } from './hooks/useOfferQuery';
 export { useOrderBumpQuery as useOrderBump } from './hooks/useOrderBumpQuery';
 export { useOrderQuery as useOrder } from './hooks/useOrderQuery';
 export { usePaymentQuery as usePayment } from './hooks/usePaymentQuery';
@@ -38,7 +38,8 @@ export { useThreeds } from './hooks/useThreeds';
 export { useThreedsModal } from './hooks/useThreedsModal';
 export { useTranslation } from './hooks/useTranslation';
 export { useVipOffersQuery as useVipOffers } from './hooks/useVipOffersQuery';
-export { useFunnel, useSimpleFunnel } from './hooks/useFunnel';
+export { useFunnel } from './hooks/useFunnel';
+export { useFunnel as useFunnelLegacy, useSimpleFunnel } from './hooks/useFunnelLegacy';
 export type { UseCheckoutTokenOptions, UseCheckoutTokenResult } from './hooks/useCheckoutToken';
 export type { ClubOffer, ClubOfferItem, ClubOfferLineItem, ClubOfferSummary, UseClubOffersOptions, UseClubOffersResult } from './hooks/useClubOffers';
 export type { UseCreditsOptions, UseCreditsResult } from './hooks/useCredits';
@@ -58,8 +59,10 @@ export type { TranslateFunction, UseTranslationOptions, UseTranslationResult } f
 export { FunnelActionType } from '../core/resources/funnel';
 export type { UseCheckoutQueryOptions as UseCheckoutOptions, UseCheckoutQueryResult as UseCheckoutResult } from './hooks/useCheckoutQuery';
 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 { FunnelAction, FunnelNavigationAction, FunnelNavigationResult, SimpleFunnelContext } from '../core/resources/funnel';
+export type { FunnelContextValue } from './hooks/useFunnel';
+export type { UseFunnelOptions as UseFunnelLegacyOptions, UseFunnelResult as UseFunnelLegacyResult } from './hooks/useFunnelLegacy';
+export type { AvailableVariant, LineItemSelection, OfferLineItem, OfferPreviewSummary, UseOfferQueryOptions as UseOfferOptions, UseOfferQueryResult as UseOfferResult } from './hooks/useOfferQuery';
 export type { UseOrderBumpQueryOptions as UseOrderBumpOptions, UseOrderBumpQueryResult as UseOrderBumpResult } from './hooks/useOrderBumpQuery';
 export type { UseOrderQueryOptions as UseOrderOptions, UseOrderQueryResult as UseOrderResult } from './hooks/useOrderQuery';
 export type { PaymentHook as UsePaymentResult } from './hooks/usePaymentQuery';

package/dist/v2/react/index.js

@@ -29,7 +29,7 @@ export { queryKeys, useApiMutation, useApiQuery, useInvalidateQuery, usePreloadQ
 export { useCheckoutQuery as useCheckout } from './hooks/useCheckoutQuery';
 export { useCurrency } from './hooks/useCurrency';
 export { useDiscountsQuery as useDiscounts } from './hooks/useDiscountsQuery';
-export { useOffersQuery as useOffers } from './hooks/useOffersQuery';
+export { useOfferQuery as useOffer } from './hooks/useOfferQuery';
 export { useOrderBumpQuery as useOrderBump } from './hooks/useOrderBumpQuery';
 export { useOrderQuery as useOrder } from './hooks/useOrderQuery';
 export { usePaymentQuery as usePayment } from './hooks/usePaymentQuery';
@@ -43,7 +43,9 @@ export { useThreedsModal } from './hooks/useThreedsModal';
 export { useTranslation } from './hooks/useTranslation';
 export { useVipOffersQuery as useVipOffers } from './hooks/useVipOffersQuery';
 // Funnel hooks
-export { useFunnel, useSimpleFunnel } from './hooks/useFunnel';
+export { useFunnel } from './hooks/useFunnel';
+// Legacy funnel hooks (deprecated - use TagadaProvider + useFunnel instead)
+export { useFunnel as useFunnelLegacy, useSimpleFunnel } from './hooks/useFunnelLegacy';
 // TanStack Query types
 export { FunnelActionType } from '../core/resources/funnel';
 // Re-export utilities from main react

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

@@ -1,11 +1,27 @@
 import { ReactNode } from 'react';
-import { TagadaState } from '../../core/client';
+import { TagadaClient, TagadaState, TagadaClientConfig } from '../../core/client';
 import { RawPluginConfig } from '../../core/utils/pluginConfig';
 import { Environment, EnvironmentConfig } from '../../core/types';
 import { ApiService } from '../../../react/services/apiService';
 import { formatMoney, formatMoneyWithoutSymbol, formatSimpleMoney, getCurrencyInfo, minorUnitsToMajorUnits, moneyStringOrNumberToMinorUnits, convertCurrency } from '../../../react/utils/money';
+import { FunnelAction, FunnelNavigationResult, SimpleFunnelContext } from '../../core/resources/funnel';
+import { FunnelState } from '../../core/funnelClient';
 interface TagadaContextValue extends TagadaState {
+    client: TagadaClient;
     apiService: ApiService;
+    pendingRedirect: boolean;
+    funnel: FunnelState & {
+        currentStep: {
+            id: string;
+        } | null;
+        next: (event: FunnelAction) => Promise<FunnelNavigationResult>;
+        goToStep: (stepId: string) => Promise<FunnelNavigationResult>;
+        updateContext: (updates: Partial<SimpleFunnelContext>) => Promise<void>;
+        initializeSession: (entryStepId?: string) => Promise<void>;
+        endSession: () => Promise<void>;
+        retryInitialization: () => Promise<void>;
+        refetch: () => Promise<void>;
+    };
     debugCheckout: {
         isActive: boolean;
         data: any;
@@ -42,14 +58,41 @@ interface TagadaContextValue extends TagadaState {
 }
 interface TagadaProviderProps {
     children: ReactNode;
+    /**
+     * Optional environment override.
+     * ⚠️ Leave undefined for automatic runtime detection (recommended).
+     * Only set this if you need to force a specific environment for testing.
+     */
     environment?: Environment;
     customApiConfig?: Partial<EnvironmentConfig>;
     debugMode?: boolean;
     localConfig?: string;
     blockUntilSessionReady?: boolean;
     rawPluginConfig?: RawPluginConfig;
+    /**
+     * Optional feature flags to enable/disable subsystems (e.g. funnel).
+     * By default all features are enabled.
+     */
+    features?: TagadaClientConfig['features'];
+    /**
+     * Funnel ID to initialize. If not provided, will be detected from URL query param.
+     */
+    funnelId?: string;
+    /**
+     * Auto-initialize funnel session when auth and store are ready.
+     * Default: true
+     */
+    autoInitializeFunnel?: boolean;
+    /**
+     * Callback fired after funnel navigation
+     */
+    onNavigate?: (result: FunnelNavigationResult) => void | boolean;
+    /**
+     * Callback fired on funnel errors
+     */
+    onFunnelError?: (error: Error) => void;
 }
 export declare function TagadaProvider({ children, environment, customApiConfig, // Ignored for now in TagadaClient, or need to add support
-debugMode, localConfig, blockUntilSessionReady, rawPluginConfig, }: TagadaProviderProps): import("react/jsx-runtime").JSX.Element;
+debugMode, localConfig, blockUntilSessionReady, rawPluginConfig, features, funnelId, autoInitializeFunnel, onNavigate, onFunnelError, }: TagadaProviderProps): import("react/jsx-runtime").JSX.Element;
 export declare function useTagadaContext(): TagadaContextValue;
 export {};

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

@@ -44,18 +44,27 @@ const InitializationLoader = () => (_jsxs("div", { style: {
       ` })] }));
 const TagadaContext = createContext(null);
 export function TagadaProvider({ children, environment, customApiConfig, // Ignored for now in TagadaClient, or need to add support
-debugMode, localConfig, blockUntilSessionReady = false, rawPluginConfig, }) {
+debugMode, localConfig, blockUntilSessionReady = false, rawPluginConfig, features, funnelId, autoInitializeFunnel = true, onNavigate, onFunnelError, }) {
+    // Auto-detect debug mode from environment if not explicitly set
+    const effectiveDebugMode = debugMode !== undefined
+        ? debugMode
+        : (typeof import.meta !== 'undefined' && import.meta.env?.DEV) ||
+            (typeof process !== 'undefined' && process.env?.NODE_ENV === 'development');
     // Initialize client
     const client = useMemo(() => {
         const config = {
             environment,
-            debugMode,
+            debugMode: effectiveDebugMode,
             localConfig,
             rawPluginConfig,
             blockUntilSessionReady,
+            // For now we always enable funnel by default; callers can disable via features if needed
+            features: features ?? {
+                funnel: true,
+            },
         };
         return new TagadaClient(config);
-    }, []); // Singleton behavior
+    }, []); // Singleton behavior on first render
     // State Sync
     const [state, setState] = useState(client.getState());
     useEffect(() => {
@@ -82,6 +91,32 @@ debugMode, localConfig, blockUntilSessionReady = false, rawPluginConfig, }) {
         apiService.updateToken(state.token);
         apiService.updateConfig(state.environment);
     }, [state.token, state.environment, apiService]);
+    // Funnel State Management
+    const [funnelState, setFunnelState] = useState(() => client.funnel
+        ? client.funnel.getState()
+        : {
+            context: null,
+            isLoading: false,
+            isInitialized: false,
+            isNavigating: false,
+            error: null,
+            sessionError: null,
+        });
+    // Track pending redirect to prevent renders during navigation
+    const [pendingRedirect, setPendingRedirect] = useState(false);
+    // Subscribe to funnel state changes
+    useEffect(() => {
+        if (!client.funnel)
+            return;
+        // Keep funnel client in sync with latest config/environment
+        client.funnel.setConfig({
+            pluginConfig: state.pluginConfig,
+            environment: state.environment,
+        });
+        return client.funnel.subscribe(setFunnelState);
+    }, [client, state.pluginConfig, state.environment]);
+    // Note: Funnel auto-initialization is now handled by TagadaClient itself
+    // when the session is initialized. This happens automatically in the core layer.
     // Debug State (React specific)
     const [debugCheckout, setDebugCheckout] = useState({
         isActive: false,
@@ -160,9 +195,87 @@ debugMode, localConfig, blockUntilSessionReady = false, rawPluginConfig, }) {
         formatSimpleMoney,
     }), []);
     const [isDebugDrawerOpen, setIsDebugDrawerOpen] = useState(false);
+    // Funnel Methods
+    const funnelMethods = useMemo(() => {
+        if (!client.funnel) {
+            // Return no-op methods if funnel is disabled
+            const noopAsync = async () => {
+                throw new Error('Funnel feature is disabled');
+            };
+            return {
+                next: noopAsync,
+                goToStep: noopAsync,
+                updateContext: noopAsync,
+                initializeSession: noopAsync,
+                endSession: noopAsync,
+                retryInitialization: noopAsync,
+                refetch: noopAsync,
+            };
+        }
+        const next = async (event) => {
+            const result = await client.funnel.navigate(event);
+            // Call custom onNavigate handler if provided
+            let shouldAutoRedirect = true;
+            if (onNavigate) {
+                const handlerResult = onNavigate(result);
+                // If handler explicitly returns false, skip auto-redirect
+                if (handlerResult === false) {
+                    shouldAutoRedirect = false;
+                }
+            }
+            // Default behavior: auto-redirect if result has a URL
+            if (shouldAutoRedirect && result?.url && typeof window !== 'undefined') {
+                console.log('🚀 [TagadaProvider] Auto-redirecting to:', result.url);
+                // Set pending redirect flag BEFORE navigation to prevent renders
+                setPendingRedirect(true);
+                window.location.href = result.url;
+            }
+            return result;
+        };
+        const goToStep = async (stepId) => {
+            return await next({
+                type: 'DIRECT_NAVIGATION',
+                data: { targetStepId: stepId },
+            });
+        };
+        // Helper to resolve accountId with fallbacks
+        const getAccountId = () => state.store?.accountId || state.pluginConfig?.accountId || state.session?.accountId || '';
+        return {
+            next,
+            goToStep,
+            updateContext: (updates) => client.funnel.updateContext(updates),
+            initializeSession: async (entryStepId) => {
+                const accountId = getAccountId();
+                if (!accountId || !state.auth.session || !state.store) {
+                    throw new Error('Cannot initialize funnel: missing required data (accountId, session, or store)');
+                }
+                await client.funnel.initialize({ customerId: state.auth.session.customerId, sessionId: state.auth.session.sessionId }, { id: state.store.id, accountId }, funnelId, entryStepId);
+            },
+            endSession: () => client.funnel.endSession(),
+            retryInitialization: () => {
+                const accountId = getAccountId();
+                if (!accountId || !state.auth.session || !state.store) {
+                    return Promise.reject(new Error('Cannot retry initialization: missing required data'));
+                }
+                return client
+                    .funnel.autoInitialize({ customerId: state.auth.session.customerId, sessionId: state.auth.session.sessionId }, { id: state.store.id, accountId }, funnelId)
+                    .then(() => { });
+            },
+            refetch: async () => {
+                await client.funnel.refreshSession();
+            },
+        };
+    }, [client, state.auth.session, state.store, funnelId, onNavigate]);
     const contextValue = {
+        client,
         ...state,
         apiService,
+        pendingRedirect,
+        funnel: {
+            ...funnelState,
+            currentStep: funnelState.context?.currentStepId ? { id: funnelState.context.currentStepId } : null,
+            ...funnelMethods,
+        },
         debugCheckout,
         updateCheckoutDebugData,
         debugFunnel,

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

@@ -0,0 +1,20 @@
+/**
+ * Standalone Adapter for TagadaPay SDK v2
+ *
+ * Provides a vanilla JS interface for using the SDK without a framework.
+ * Suitable for standard HTML/JS sites or other frameworks (Svelte, Angular, etc).
+ *
+ * This layer is a very thin wrapper over the Core SDK.
+ */
+import { TagadaClient, TagadaClientConfig, TagadaState } from '../core/client';
+import { ApiClient } from '../core/resources/apiClient';
+/**
+ * Factory function to create a Tagada Client instance.
+ * Features (like funnel) can be toggled via the config.
+ */
+export declare function createTagadaClient(config?: TagadaClientConfig): TagadaClient;
+export { TagadaClient, ApiClient };
+export type { TagadaClientConfig, TagadaState };
+export { FunnelActionType } from '../core/resources/funnel';
+export type { FunnelAction, FunnelNavigationResult, SimpleFunnelContext } from '../core/resources/funnel';
+export * from '../core/utils';

package/dist/v2/standalone/index.js

@@ -0,0 +1,22 @@
+/**
+ * Standalone Adapter for TagadaPay SDK v2
+ *
+ * Provides a vanilla JS interface for using the SDK without a framework.
+ * Suitable for standard HTML/JS sites or other frameworks (Svelte, Angular, etc).
+ *
+ * This layer is a very thin wrapper over the Core SDK.
+ */
+import { TagadaClient } from '../core/client';
+import { ApiClient } from '../core/resources/apiClient';
+/**
+ * Factory function to create a Tagada Client instance.
+ * Features (like funnel) can be toggled via the config.
+ */
+export function createTagadaClient(config = {}) {
+    return new TagadaClient(config);
+}
+// Re-export Core Classes
+export { TagadaClient, ApiClient };
+export { FunnelActionType } from '../core/resources/funnel';
+// Re-export Utilities
+export * from '../core/utils';

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

@@ -0,0 +1,6 @@
+/**
+ * Vue.js Adapter for TagadaPay SDK
+ *
+ * Provides Vue composables that wrap the Core SDK logic.
+ * Uses Vue's reactivity system to expose state from TagadaClient and FunnelClient.
+ */

package/dist/v2/vue/index.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Vue.js Adapter for TagadaPay SDK
+ *
+ * Provides Vue composables that wrap the Core SDK logic.
+ * Uses Vue's reactivity system to expose state from TagadaClient and FunnelClient.
+ */
+// TODO: Implement Vue adapter
+// export function useTagada() { ... }
+// export function useFunnel() { ... }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tagadapay/plugin-sdk",
-  "version": "2.8.9",
+  "version": "3.0.1",
   "description": "Modern React SDK for building Tagada Pay plugins",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -19,6 +19,11 @@
       "types": "./dist/v2/index.d.ts",
       "import": "./dist/v2/index.js",
       "require": "./dist/v2/index.js"
+    },
+    "./v2/standalone": {
+      "types": "./dist/v2/standalone/index.d.ts",
+      "import": "./dist/v2/standalone/index.js",
+      "require": "./dist/v2/standalone/index.js"
     }
   },
   "scripts": {