@tagadapay/plugin-sdk 2.8.10 → 3.0.2

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

@@ -2,6 +2,7 @@
  * Plugin Configuration Utility Functions
  * Pure functions for plugin configuration management
  */
+import { isLocalEnvironment } from '../config/environment';
 import { resolveEnvValue } from './env';
 /**
  * Load local development configuration
@@ -15,13 +16,8 @@ const loadLocalDevConfig = async (configVariant = 'default') => {
             return null;
         }
         // Only try to load local config in TRUE local development (not deployed CDN instances)
-        // Exclude CDN subdomains (e.g., instance-id.cdn.localhost) by checking for 'cdn.' prefix
-        const isLocalDev = typeof window !== 'undefined' &&
-            (window.location.hostname === 'localhost' ||
-                window.location.hostname === '127.0.0.1' ||
-                window.location.hostname.includes('ngrok-free.app')) &&
-            !window.location.hostname.includes('.cdn.');
-        if (!isLocalDev) {
+        // Exclude CDN subdomains (e.g., instance-id.cdn.localhost)
+        if (!isLocalEnvironment(true)) {
             return null;
         }
         // Load local store/account config
@@ -99,28 +95,23 @@ const loadStaticResources = async () => {
             return null;
         }
         // Only try to load in TRUE local development (not deployed CDN instances)
-        // Exclude CDN subdomains (e.g., instance-id.cdn.localhost) by checking for 'cdn.' prefix
-        const isLocalDev = typeof window !== 'undefined' &&
-            (window.location.hostname === 'localhost' ||
-                window.location.hostname === '127.0.0.1' ||
-                window.location.hostname.includes('ngrok-free.app')) &&
-            !window.location.hostname.includes('.cdn.');
-        if (!isLocalDev) {
+        // Exclude CDN subdomains (e.g., instance-id.cdn.localhost)
+        if (!isLocalEnvironment(true)) {
             return null;
         }
         // Load static resources file
-        console.log('🛠️ Attempting to load /config/resources.static.json...');
+        console.log('🛠️ [V2] Attempting to load /config/resources.static.json...');
         const response = await fetch('/config/resources.static.json');
         if (!response.ok) {
-            console.log('🛠️ resources.static.json not found or failed to load');
+            console.log('🛠️ [V2] resources.static.json not found or failed to load');
             return null;
         }
         const staticResources = await response.json();
-        console.log('🛠️ ✅ Loaded local static resources:', staticResources);
+        console.log('🛠️ [V2] ✅ Loaded local static resources:', staticResources);
         return staticResources;
     }
     catch (error) {
-        console.error('🛠️ ❌ Error loading static resources:', error);
+        console.error('🛠️ [V2] ❌ Error loading static resources:', error);
         return null;
     }
 };
@@ -180,41 +171,70 @@ const loadProductionConfig = async () => {
  * Handles local dev, production, and raw config
  */
 export const loadPluginConfig = async (configVariant = 'default', rawConfig) => {
+    console.log('🔧 [V2] loadPluginConfig called with variant:', configVariant);
     // Load static resources first (only in local dev)
     const staticResources = await loadStaticResources();
+    console.log('🔧 [V2] Static resources loaded:', {
+        hasStaticResources: !!staticResources,
+        staticResourcesKeys: staticResources ? Object.keys(staticResources) : [],
+    });
     // If raw config is provided, use it directly
     if (rawConfig) {
-        return {
+        const result = {
             storeId: rawConfig.storeId,
             accountId: rawConfig.accountId,
             basePath: rawConfig.basePath ?? '/',
             config: rawConfig.config ?? {},
             staticResources: staticResources ?? undefined,
         };
+        console.log('🔧 [V2] Final config (raw):', {
+            hasStoreId: !!result.storeId,
+            hasStaticResources: !!result.staticResources,
+            staticResourcesKeys: result.staticResources ? Object.keys(result.staticResources) : [],
+        });
+        return result;
     }
     else {
         const rawConfig = await createRawPluginConfig();
         if (rawConfig) {
-            return {
+            const result = {
                 ...rawConfig,
                 staticResources: staticResources ?? undefined,
             };
+            console.log('🔧 [V2] Final config (createRawPluginConfig):', {
+                hasStoreId: !!result.storeId,
+                hasStaticResources: !!result.staticResources,
+                staticResourcesKeys: result.staticResources ? Object.keys(result.staticResources) : [],
+            });
+            return result;
         }
     }
     // Try local development config
     const localConfig = await loadLocalDevConfig(configVariant);
     if (localConfig) {
-        return {
+        const result = {
             ...localConfig,
             staticResources: staticResources ?? undefined,
         };
+        console.log('🔧 [V2] Final config (local):', {
+            hasStoreId: !!result.storeId,
+            hasStaticResources: !!result.staticResources,
+            staticResourcesKeys: result.staticResources ? Object.keys(result.staticResources) : [],
+        });
+        return result;
     }
     // Fall back to production config
     const productionConfig = await loadProductionConfig();
-    return {
+    const result = {
         ...productionConfig,
         staticResources: staticResources ?? undefined,
     };
+    console.log('🔧 [V2] Final config (production):', {
+        hasStoreId: !!result.storeId,
+        hasStaticResources: !!result.staticResources,
+        staticResourcesKeys: result.staticResources ? Object.keys(result.staticResources) : [],
+    });
+    return result;
 };
 /**
  * Helper to load local config file for development (from /config directory)
@@ -223,11 +243,7 @@ export const loadPluginConfig = async (configVariant = 'default', rawConfig) =>
 export async function loadLocalConfig(configName = 'default', defaultConfig) {
     try {
         // Only load 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) {
+        if (!isLocalEnvironment()) {
             return null;
         }
         if (defaultConfig) {
@@ -267,11 +283,7 @@ export async function loadLocalConfig(configName = 'default', defaultConfig) {
 export async function createRawPluginConfig() {
     try {
         // Only run in true localhost - production should use meta tags
-        const isLocalhost = typeof window !== 'undefined' &&
-            (window.location.hostname === 'localhost' ||
-                window.location.hostname.includes('.localhost') ||
-                window.location.hostname.includes('127.0.0.1'));
-        if (!isLocalhost) {
+        if (!isLocalEnvironment()) {
             console.log('[createRawPluginConfig] Not localhost, skipping - will use meta tags in production');
             return undefined;
         }

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

@@ -0,0 +1,20 @@
+/**
+ * Session Storage Utilities - Core SDK (Framework-agnostic)
+ * Handles session persistence using browser cookies
+ */
+/**
+ * Save funnel session ID to browser cookie
+ */
+export declare function setFunnelSessionCookie(sessionId: string): void;
+/**
+ * Retrieve funnel session ID from browser cookie
+ */
+export declare function getFunnelSessionCookie(): string | undefined;
+/**
+ * Clear funnel session cookie
+ */
+export declare function clearFunnelSessionCookie(): void;
+/**
+ * Check if a funnel session cookie exists
+ */
+export declare function hasFunnelSessionCookie(): boolean;

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

@@ -0,0 +1,39 @@
+/**
+ * Session Storage Utilities - Core SDK (Framework-agnostic)
+ * Handles session persistence using browser cookies
+ */
+const FUNNEL_SESSION_COOKIE_NAME = 'tgd-funnel-session-id';
+const SESSION_MAX_AGE = 30 * 24 * 60 * 60; // 30 days
+/**
+ * Save funnel session ID to browser cookie
+ */
+export function setFunnelSessionCookie(sessionId) {
+    if (typeof document === 'undefined')
+        return;
+    document.cookie = `${FUNNEL_SESSION_COOKIE_NAME}=${sessionId}; path=/; max-age=${SESSION_MAX_AGE}; SameSite=Lax`;
+}
+/**
+ * Retrieve funnel session ID from browser cookie
+ */
+export function getFunnelSessionCookie() {
+    if (typeof document === 'undefined')
+        return undefined;
+    const cookie = document.cookie
+        .split('; ')
+        .find((row) => row.startsWith(`${FUNNEL_SESSION_COOKIE_NAME}=`));
+    return cookie ? cookie.split('=')[1] : undefined;
+}
+/**
+ * Clear funnel session cookie
+ */
+export function clearFunnelSessionCookie() {
+    if (typeof document === 'undefined')
+        return;
+    document.cookie = `${FUNNEL_SESSION_COOKIE_NAME}=; path=/; max-age=0`;
+}
+/**
+ * Check if a funnel session cookie exists
+ */
+export function hasFunnelSessionCookie() {
+    return !!getFunnelSessionCookie();
+}

package/dist/v2/index.d.ts

@@ -14,7 +14,7 @@ export * from './core/pathRemapping';
 export type { CheckoutData, CheckoutInitParams, CheckoutLineItem, CheckoutSession, CheckoutSessionPreview, Promotion } from './core/resources/checkout';
 export type { Order, OrderLineItem } from './core/utils/order';
 export type { PostPurchaseOffer, PostPurchaseOfferItem, PostPurchaseOfferSummary } from './core/resources/postPurchases';
-export type { Offer, OfferItem, OfferSummary } from './core/resources/offers';
+export type { Offer, OfferSummary, OfferSummaryItem } from './core/resources/offers';
 export type { OrderBumpOffer, OrderBumpPreview } from './core/utils/orderBump';
 export type { ApplePayToken, CardPaymentMethod, Payment, PaymentInstrumentCustomer, PaymentInstrumentCustomerResponse, PaymentInstrumentResponse, PaymentOptions, PaymentResponse } from './core/resources/payments';
 export type { ShippingRate, ShippingRatesResponse } from './core/resources/shippingRates';
@@ -23,8 +23,10 @@ export type { ToggleOrderBumpResponse, VipOffer, VipPreviewResponse } from './co
 export type { StoreConfig } from './core/resources/storeConfig';
 export { FunnelActionType } from './core/resources/funnel';
 export type { BackNavigationActionData, CartUpdatedActionData, DirectNavigationActionData, FormSubmitActionData, FunnelContextUpdateRequest, FunnelContextUpdateResponse, FunnelAction as FunnelEvent, FunnelInitializeRequest, FunnelInitializeResponse, FunnelNavigateRequest, FunnelNavigateResponse, FunnelNavigationAction, FunnelNavigationResult, NextAction, OfferAcceptedActionData, OfferDeclinedActionData, PaymentFailedActionData, PaymentSuccessActionData, SimpleFunnelContext } from './core/resources/funnel';
-export { ApplePayButton, ExpressPaymentMethodsProvider, formatMoney, getAvailableLanguages, GooglePayButton, queryKeys, TagadaProvider, useApiMutation, useApiQuery, useAuth, useCheckout, useCheckoutToken, useClubOffers, useCountryOptions, useCredits, 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 { ApplePayButton, ExpressPaymentMethodsProvider, formatMoney, getAvailableLanguages, GooglePayButton, queryKeys, TagadaProvider, useApiMutation, useApiQuery, useAuth, useCheckout, useCheckoutToken, useClubOffers, useCountryOptions, useCredits, useCurrency, useCustomer, useCustomerInfos, useCustomerOrders, useCustomerSubscriptions, useDiscounts, useExpressPaymentMethods, useFunnel, useFunnelLegacy, useGeoLocation, useGoogleAutocomplete, useInvalidateQuery, useISOData, useLanguageImport, useLogin, useOffer, useOrder, useOrderBump, usePayment, usePluginConfig, usePostPurchases, usePreloadQuery, useProducts, usePromotions, useRegionOptions, useRemappableParams, useShippingRates, useSimpleFunnel, useStoreConfig, useTagadaContext, useThreeds, useThreedsModal, useTranslation, useVipOffers } from './react';
+export type { DebugScript } from './react';
 export type { TranslateFunction, TranslationText, UseTranslationOptions, UseTranslationResult } from './react/hooks/useTranslation';
+export type { FunnelContextValue } from './react/hooks/useFunnel';
 export type { ClubOffer, ClubOfferItem, ClubOfferLineItem, ClubOfferSummary, UseClubOffersOptions, UseClubOffersResult } from './react/hooks/useClubOffers';
 export type { UseCreditsOptions, UseCreditsResult } from './react/hooks/useCredits';
 export type { UseLoginOptions, UseLoginResult } from './react/hooks/useLogin';

package/dist/v2/index.js

@@ -15,4 +15,4 @@ export * from './core/utils/products';
 export * from './core/pathRemapping';
 export { FunnelActionType } from './core/resources/funnel';
 // 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, useCredits, 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 { ApplePayButton, ExpressPaymentMethodsProvider, formatMoney, getAvailableLanguages, GooglePayButton, queryKeys, TagadaProvider, useApiMutation, useApiQuery, useAuth, useCheckout, useCheckoutToken, useClubOffers, useCountryOptions, useCredits, useCurrency, useCustomer, useCustomerInfos, useCustomerOrders, useCustomerSubscriptions, useDiscounts, useExpressPaymentMethods, useFunnel, useFunnelLegacy, useGeoLocation, useGoogleAutocomplete, useInvalidateQuery, useISOData, useLanguageImport, useLogin, useOffer, useOrder, useOrderBump, usePayment, usePluginConfig, usePostPurchases, usePreloadQuery, useProducts, usePromotions, useRegionOptions, useRemappableParams, useShippingRates, useSimpleFunnel, useStoreConfig, useTagadaContext, useThreeds, useThreedsModal, useTranslation, useVipOffers } from './react';

package/dist/v2/react/components/DebugDrawer.js

@@ -77,6 +77,8 @@ export const DebugDrawer = ({ isOpen, onClose }) => {
     const context = useTagadaContext();
     const pluginConfig = usePluginConfig();
     const [activeTab, setActiveTab] = useState('overview');
+    const [runningScripts, setRunningScripts] = useState(new Set());
+    const [scriptResults, setScriptResults] = useState({});
     // Handler to jump to a specific step using direct_navigation
     const handleJumpToStep = async (stepId, stepName) => {
         // Try to get sessionId from debug data or context
@@ -168,7 +170,49 @@ export const DebugDrawer = ({ isOpen, onClose }) => {
     const itemsTab = context.debugCheckout.isActive && context.debugCheckout.data?.checkout?.summary
         ? [{ id: 'items', label: 'Items' }]
         : [];
-    const tabs = [...baseTabs, ...funnelTab, ...checkoutTab, ...itemsTab, { id: 'raw', label: 'Raw Data' }];
+    // Add scripts tab if debug scripts are available
+    const scriptsTab = context.debugScripts && context.debugScripts.length > 0
+        ? [{ id: 'scripts', label: `Scripts (${context.debugScripts.length})` }]
+        : [];
+    const tabs = [
+        ...baseTabs,
+        ...funnelTab,
+        ...checkoutTab,
+        ...itemsTab,
+        ...scriptsTab,
+        { id: 'raw', label: 'Raw Data' },
+    ];
+    // Handler to run a debug script
+    const handleRunScript = async (scriptId) => {
+        const script = context.debugScripts?.find((s) => s.id === scriptId);
+        if (!script)
+            return;
+        setRunningScripts((prev) => new Set(prev).add(scriptId));
+        setScriptResults((prev) => ({ ...prev, [scriptId]: undefined }));
+        try {
+            await script.run(context);
+            setScriptResults((prev) => ({
+                ...prev,
+                [scriptId]: { success: true, message: 'Script executed successfully' },
+            }));
+        }
+        catch (error) {
+            setScriptResults((prev) => ({
+                ...prev,
+                [scriptId]: {
+                    success: false,
+                    message: error instanceof Error ? error.message : 'Script failed',
+                },
+            }));
+        }
+        finally {
+            setRunningScripts((prev) => {
+                const next = new Set(prev);
+                next.delete(scriptId);
+                return next;
+            });
+        }
+    };
     return (_jsxs(_Fragment, { children: [_jsx("div", { style: {
                     position: 'fixed',
                     top: 0,
@@ -681,6 +725,59 @@ export const DebugDrawer = ({ isOpen, onClose }) => {
                                                                     fontSize: '11px',
                                                                     margin: 0,
                                                                     whiteSpace: 'pre-wrap',
-                                                                }, children: context.debugCheckout.error.stack }))] })] })), _jsxs("div", { children: [_jsx("h4", { style: { margin: '0 0 12px 0', color: '#60a5fa' }, children: "Full Checkout Data" }), _jsx(TreeView, { data: context.debugCheckout.data, name: "checkoutData" })] })] })) : (_jsx("p", { style: { color: '#6b7280' }, children: "No checkout hook active" }))] })), activeTab === 'raw' && (_jsxs("div", { children: [_jsx("h3", { style: { margin: '0 0 16px 0', color: '#60a5fa' }, children: "Raw Context Data" }), _jsx("div", { style: { fontSize: '12px' }, children: _jsx(TreeView, { data: context, name: "tagadaContext", maxLevel: 4 }) })] }))] })] })] }));
+                                                                }, children: context.debugCheckout.error.stack }))] })] })), _jsxs("div", { children: [_jsx("h4", { style: { margin: '0 0 12px 0', color: '#60a5fa' }, children: "Full Checkout Data" }), _jsx(TreeView, { data: context.debugCheckout.data, name: "checkoutData" })] })] })) : (_jsx("p", { style: { color: '#6b7280' }, children: "No checkout hook active" }))] })), activeTab === 'scripts' && (_jsxs("div", { children: [_jsx("h3", { style: { margin: '0 0 12px 0', color: '#60a5fa', fontSize: '14px' }, children: "\uD83D\uDEE0\uFE0F Debug Scripts" }), _jsx("p", { style: { margin: '0 0 16px 0', fontSize: '11px', color: '#9ca3af' }, children: "Template-provided scripts for debugging and testing. Click a script to run it." }), context.debugScripts && context.debugScripts.length > 0 ? (_jsx("div", { style: { display: 'grid', gap: '10px' }, children: (() => {
+                                            const grouped = context.debugScripts.reduce((acc, script) => {
+                                                const category = script.category || 'General';
+                                                if (!acc[category])
+                                                    acc[category] = [];
+                                                acc[category].push(script);
+                                                return acc;
+                                            }, {});
+                                            return Object.entries(grouped).map(([category, scripts]) => (_jsxs("div", { children: [_jsx("div", { style: {
+                                                            fontSize: '11px',
+                                                            color: '#9ca3af',
+                                                            fontWeight: 'bold',
+                                                            marginBottom: '8px',
+                                                            textTransform: 'uppercase',
+                                                            letterSpacing: '0.5px',
+                                                        }, children: category }), _jsx("div", { style: { display: 'grid', gap: '8px' }, children: scripts.map((script) => {
+                                                            const isRunning = runningScripts.has(script.id);
+                                                            const result = scriptResults[script.id];
+                                                            return (_jsxs("div", { style: {
+                                                                    border: '1px solid #374151',
+                                                                    borderRadius: '6px',
+                                                                    padding: '10px 12px',
+                                                                    backgroundColor: '#111827',
+                                                                }, children: [_jsxs("div", { style: {
+                                                                            display: 'flex',
+                                                                            justifyContent: 'space-between',
+                                                                            alignItems: 'flex-start',
+                                                                            gap: '12px',
+                                                                        }, children: [_jsxs("div", { style: { flex: 1 }, children: [_jsx("div", { style: {
+                                                                                            color: '#f9fafb',
+                                                                                            fontWeight: 'bold',
+                                                                                            fontSize: '12px',
+                                                                                            marginBottom: '4px',
+                                                                                        }, children: script.name }), script.description && (_jsx("div", { style: { fontSize: '11px', color: '#9ca3af' }, children: script.description }))] }), _jsx("button", { onClick: () => handleRunScript(script.id), disabled: isRunning, style: {
+                                                                                    backgroundColor: isRunning ? '#374151' : '#3b82f6',
+                                                                                    color: '#fff',
+                                                                                    border: 'none',
+                                                                                    borderRadius: '4px',
+                                                                                    padding: '6px 12px',
+                                                                                    fontSize: '11px',
+                                                                                    fontWeight: 'bold',
+                                                                                    cursor: isRunning ? 'not-allowed' : 'pointer',
+                                                                                    transition: 'background-color 0.2s',
+                                                                                    minWidth: '60px',
+                                                                                }, children: isRunning ? '⏳' : '▶ Run' })] }), result && (_jsxs("div", { style: {
+                                                                            marginTop: '8px',
+                                                                            padding: '6px 8px',
+                                                                            borderRadius: '4px',
+                                                                            fontSize: '10px',
+                                                                            backgroundColor: result.success ? '#065f46' : '#7f1d1d',
+                                                                            color: result.success ? '#6ee7b7' : '#fca5a5',
+                                                                        }, children: [result.success ? '✅' : '❌', " ", result.message] }))] }, script.id));
+                                                        }) })] }, category)));
+                                        })() })) : (_jsx("p", { style: { color: '#6b7280' }, children: "No debug scripts available" }))] })), activeTab === 'raw' && (_jsxs("div", { children: [_jsx("h3", { style: { margin: '0 0 16px 0', color: '#60a5fa' }, children: "Raw Context Data" }), _jsx("div", { style: { fontSize: '12px' }, children: _jsx(TreeView, { data: context, name: "tagadaContext", maxLevel: 4 }) })] }))] })] })] }));
 };
 export default DebugDrawer;

package/dist/v2/react/hooks/__examples__/FunnelContextExample.d.ts

@@ -3,6 +3,9 @@
  *
  * This example demonstrates how to access data from previous steps
  * using the funnel context, including order, customer, and other resources.
+ *
+ * Note: Funnel initialization is now configured at the provider level:
+ * <TagadaProvider autoInitializeFunnel={true} funnelId="...">
  */
 export declare function FunnelContextExample(): import("react/jsx-runtime").JSX.Element;
 /**

package/dist/v2/react/hooks/__examples__/FunnelContextExample.js

@@ -4,12 +4,13 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  *
  * This example demonstrates how to access data from previous steps
  * using the funnel context, including order, customer, and other resources.
+ *
+ * Note: Funnel initialization is now configured at the provider level:
+ * <TagadaProvider autoInitializeFunnel={true} funnelId="...">
  */
 import { useFunnel } from '../useFunnel';
 export function FunnelContextExample() {
-    const { context, isLoading, isInitialized } = useFunnel({
-        autoInitialize: true,
-    });
+    const { context, isLoading, isInitialized } = useFunnel();
     if (isLoading) {
         return _jsx("div", { children: "Loading funnel session..." });
     }

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

@@ -9,7 +9,7 @@ export interface ClubOfferItem {
     variant: {
         name: string;
         description: string;
-        imageUrl: string;
+        imageUrl: string | null;
         grams: number;
     };
     unitAmount: number;
@@ -31,7 +31,7 @@ export interface ClubOfferLineItem {
             id: string;
             name: string;
             description: string | null;
-            imageUrl: string;
+            imageUrl: string | null;
             grams: number;
             product: {
                 id: string;

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

@@ -1,52 +1,40 @@
 /**
- * useFunnel Hook (v2) - TanStack Query-based funnel navigation
+ * useFunnel Hook - Access funnel state and navigation methods
  *
- * Modern implementation using TanStack Query for state management
- * and the v2 ApiClient for API calls.
+ * This hook consumes the funnel state from TagadaProvider. All complex
+ * initialization and session management is handled at the provider level.
+ *
+ * Usage:
+ * ```tsx
+ * // In your root component or layout:
+ * <TagadaProvider funnelId="funnelv2_xxx" autoInitializeFunnel={true}>
+ *   <YourApp />
+ * </TagadaProvider>
+ *
+ * // In any child component:
+ * const { context, next, isLoading } = useFunnel();
+ * ```
  */
 import { FunnelAction, FunnelNavigationResult, SimpleFunnelContext } from '../../core/resources/funnel';
-export interface UseFunnelOptions {
-    funnelId?: string;
-    currentStepId?: string;
-    onNavigate?: (result: FunnelNavigationResult) => void | boolean;
-    onError?: (error: Error) => void;
-    autoInitialize?: boolean;
-    enabled?: boolean;
-}
-export interface UseFunnelResult {
-    next: (event: FunnelAction) => Promise<any>;
-    goToStep: (stepId: string) => Promise<any>;
-    updateContext: (updates: Partial<SimpleFunnelContext>) => Promise<void>;
+import { FunnelState } from '../../core/funnelClient';
+export interface FunnelContextValue extends FunnelState {
     currentStep: {
         id: string;
-    };
-    context: SimpleFunnelContext | null;
-    isLoading: boolean;
-    isInitialized: boolean;
-    isNavigating: boolean;
+    } | 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>;
-    initializationError: Error | null;
-    isSessionLoading: boolean;
-    sessionError: Error | null;
-    refetch: () => void;
+    refetch: () => Promise<void>;
 }
 /**
- * React Hook for Funnel Navigation (Plugin SDK v2)
+ * Hook to access funnel state and methods
  *
- * Modern funnel navigation using TanStack Query for state management
- * and the v2 ApiClient architecture.
- */
-export declare function useFunnel(options?: UseFunnelOptions): UseFunnelResult;
-/**
- * Simplified funnel hook for basic step tracking (v2)
+ * This hook simply returns the funnel state from TagadaProvider.
+ * All complex logic is handled at the provider level.
+ *
+ * @returns FunnelContextValue with state and methods
  */
-export declare function useSimpleFunnel(funnelId: string, initialStepId?: string): {
-    currentStepId: string;
-    next: (event: FunnelAction) => Promise<any>;
-    goToStep: (stepId: string) => Promise<any>;
-    isLoading: boolean;
-    context: SimpleFunnelContext<{}> | null;
-};
-export type { FunnelAction as FunnelEvent, FunnelNavigationAction, FunnelNavigationResult, SimpleFunnelContext } from '../../core/resources/funnel';
+export declare function useFunnel(): FunnelContextValue;