@tagadapay/plugin-sdk 2.8.9 → 3.0.1

package/dist/v2/core/resources/offers.js

@@ -6,6 +6,13 @@ export class OffersResource {
     constructor(apiClient) {
         this.apiClient = apiClient;
     }
+    /**
+     * Get a single offer by ID
+     */
+    async getOfferById(offerId) {
+        const response = await this.apiClient.get(`/api/v1/offers/${offerId}`);
+        return response;
+    }
     /**
      * Get offers for a store
      */
@@ -77,6 +84,24 @@ export class OffersResource {
         });
     }
     /**
+     * Transform offer to checkout session with dynamic variant selection
+     * Uses lineItems from the offer to create a new checkout session
+     */
+    async transformToCheckoutSession(offerId, lineItems, mainOrderId, returnUrl) {
+        const response = await this.apiClient.post(`/api/v1/offers/${offerId}/transform-to-checkout`, {
+            offerId,
+            lineItems,
+            mainOrderId,
+            returnUrl: returnUrl || (typeof window !== 'undefined' ? window.location.origin : ''),
+        });
+        return {
+            checkoutUrl: response.checkoutUrl,
+            checkoutSessionId: response.checkoutSessionId,
+            customerId: response.customerId,
+        };
+    }
+    /**
+     * @deprecated Use transformToCheckoutSession instead
      * Transform offer to checkout session with dynamic variant selection
      */
     async transformToCheckout(offerId, returnUrl) {

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

@@ -7,6 +7,7 @@ import { ApiClient } from './apiClient';
 export interface GetProductsOptions {
     storeId: string;
     productIds?: string[];
+    variantIds?: string[];
     includeVariants?: boolean;
     includePrices?: boolean;
 }
@@ -26,4 +27,8 @@ export declare class ProductsResource {
      * Get multiple products by IDs
      */
     getProductsByIds(productIds: string[], options: GetProductsOptions): Promise<Product[]>;
+    /**
+     * Get products by variant IDs (efficient filtering on the backend)
+     */
+    getProductsByVariantIds(variantIds: string[], options: GetProductsOptions): Promise<Product[]>;
 }

package/dist/v2/core/resources/products.js

@@ -10,9 +10,10 @@ export class ProductsResource {
      * Get all products for a store
      */
     async getProducts(options) {
-        const { storeId, includeVariants = true, includePrices = true } = options;
+        const { storeId, variantIds, includeVariants = true, includePrices = true } = options;
         const response = await this.apiClient.post('/api/v1/products', {
             storeId,
+            variantIds,
             includeVariants,
             includePrices,
         });
@@ -46,4 +47,17 @@ export class ProductsResource {
         const results = await Promise.all(fetchPromises);
         return results.filter((product) => product !== null);
     }
+    /**
+     * Get products by variant IDs (efficient filtering on the backend)
+     */
+    async getProductsByVariantIds(variantIds, options) {
+        const { storeId, includeVariants = true, includePrices = true } = options;
+        const response = await this.apiClient.post('/api/v1/products', {
+            storeId,
+            variantIds, // Backend will filter products that have these variants
+            includeVariants,
+            includePrices,
+        });
+        return Array.isArray(response) ? response : response.items ?? [];
+    }
 }

package/dist/v2/core/types.d.ts

@@ -60,6 +60,7 @@ export interface Currency {
 }
 export interface Store {
     id: string;
+    accountId: string;
     name: string;
     domain: string;
     currency: string;

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

@@ -0,0 +1,23 @@
+/**
+ * Funnel Query Keys - Core SDK (Framework-agnostic)
+ * Standardized query keys for caching funnel data
+ * Can be used with any query library (TanStack Query, SWR, etc.)
+ */
+/**
+ * Query keys for funnel operations
+ * These keys are used for caching and invalidation strategies
+ */
+export declare const funnelQueryKeys: {
+    /**
+     * Key for a specific funnel session
+     */
+    session: (sessionId: string) => readonly ["funnel", "session", string];
+    /**
+     * Key for all funnel sessions
+     */
+    allSessions: () => readonly ["funnel", "sessions"];
+    /**
+     * Key for funnel metadata/configuration
+     */
+    funnelMeta: (funnelId: string) => readonly ["funnel", "meta", string];
+};

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

@@ -0,0 +1,23 @@
+/**
+ * Funnel Query Keys - Core SDK (Framework-agnostic)
+ * Standardized query keys for caching funnel data
+ * Can be used with any query library (TanStack Query, SWR, etc.)
+ */
+/**
+ * Query keys for funnel operations
+ * These keys are used for caching and invalidation strategies
+ */
+export const funnelQueryKeys = {
+    /**
+     * Key for a specific funnel session
+     */
+    session: (sessionId) => ['funnel', 'session', sessionId],
+    /**
+     * Key for all funnel sessions
+     */
+    allSessions: () => ['funnel', 'sessions'],
+    /**
+     * Key for funnel metadata/configuration
+     */
+    funnelMeta: (funnelId) => ['funnel', 'meta', funnelId],
+};

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

@@ -10,3 +10,5 @@ export * from './checkout';
 export * from './promotions';
 export * from './postPurchases';
 export * from './orderBump';
+export * from './sessionStorage';
+export * from './funnelQueryKeys';

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

@@ -10,3 +10,5 @@ export * from './checkout';
 export * from './promotions';
 export * from './postPurchases';
 export * from './orderBump';
+export * from './sessionStorage';
+export * from './funnelQueryKeys';

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

@@ -7,6 +7,7 @@ export type PluginConfig<TConfig = Record<string, any>> = {
     accountId?: string;
     basePath?: string;
     config?: any;
+    staticResources?: Record<string, any>;
     productId?: string;
     variants?: Record<string, string>;
     prices?: Record<string, any>;

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
@@ -14,14 +15,9 @@ const loadLocalDevConfig = async (configVariant = 'default') => {
             // Skip local config loading if explicitly in production mode
             return null;
         }
-        // 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) {
+        // Only try to load local config in TRUE local development (not deployed CDN instances)
+        // Exclude CDN subdomains (e.g., instance-id.cdn.localhost)
+        if (!isLocalEnvironment(true)) {
             return null;
         }
         // Load local store/account config
@@ -87,6 +83,38 @@ const loadLocalDevConfig = async (configVariant = 'default') => {
         return null;
     }
 };
+/**
+ * Load static resources for local development
+ * Loads /config/resources.static.json
+ */
+const loadStaticResources = async () => {
+    try {
+        // Check for explicit environment override
+        const env = resolveEnvValue('TAGADA_ENV') || resolveEnvValue('TAGADA_ENVIRONMENT');
+        if (env === 'production') {
+            return null;
+        }
+        // Only try to load in TRUE local development (not deployed CDN instances)
+        // Exclude CDN subdomains (e.g., instance-id.cdn.localhost)
+        if (!isLocalEnvironment(true)) {
+            return null;
+        }
+        // Load static resources file
+        console.log('🛠️ [V2] Attempting to load /config/resources.static.json...');
+        const response = await fetch('/config/resources.static.json');
+        if (!response.ok) {
+            console.log('🛠️ [V2] resources.static.json not found or failed to load');
+            return null;
+        }
+        const staticResources = await response.json();
+        console.log('🛠️ [V2] ✅ Loaded local static resources:', staticResources);
+        return staticResources;
+    }
+    catch (error) {
+        console.error('🛠️ [V2] ❌ Error loading static resources:', error);
+        return null;
+    }
+};
 /**
  * Helper to get content from meta tag
  */
@@ -143,28 +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 rawConfig;
+            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 localConfig;
+        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
-    return loadProductionConfig();
+    const productionConfig = await loadProductionConfig();
+    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)
@@ -173,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) {
@@ -217,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,9 @@ 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 { 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/ApplePayButton.js

@@ -5,7 +5,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  */
 import { useCallback, useEffect, useState } from 'react';
 import { useExpressPaymentMethods } from '../hooks/useExpressPaymentMethods';
-export const ApplePayButton = ({ className = '', disabled = false, onSuccess, onError, onCancel, storeName, currencyCode = 'USD', variant = 'outline', size = 'lg', checkout, }) => {
+export const ApplePayButton = ({ className = '', disabled = false, onSuccess, onError, onCancel, storeName, currencyCode = 'USD', variant = 'default', size = 'lg', checkout, }) => {
     const { applePayPaymentMethod, shippingMethods, lineItems, handleAddExpressId, updateCheckoutSessionValues, updateCustomerEmail, reComputeOrderSummary, setError: setContextError, } = useExpressPaymentMethods();
     const [processingPayment, setProcessingPayment] = useState(false);
     const [isApplePayAvailable, setIsApplePayAvailable] = useState(false);

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,51 +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;
+    } | 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;