@tagadapay/plugin-sdk 2.8.10 → 3.0.2

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

@@ -4,6 +4,7 @@
  */
 export { ExpressPaymentMethodsProvider } from './providers/ExpressPaymentMethodsProvider';
 export { TagadaProvider, useTagadaContext } from './providers/TagadaProvider';
+export type { DebugScript } from './providers/TagadaProvider';
 export { ApplePayButton } from './components/ApplePayButton';
 export { GooglePayButton } from './components/GooglePayButton';
 export { useAuth } from './hooks/useAuth';
@@ -25,7 +26,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 +39,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 +60,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,43 @@
 import { ReactNode } from 'react';
-import { TagadaState } 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 { convertCurrency, formatMoney, formatMoneyWithoutSymbol, formatSimpleMoney, getCurrencyInfo, minorUnitsToMajorUnits, moneyStringOrNumberToMinorUnits } from '../../../react/utils/money';
+import { TagadaClient, TagadaClientConfig, TagadaState } from '../../core/client';
+import { FunnelState } from '../../core/funnelClient';
+import { FunnelAction, FunnelNavigationResult, SimpleFunnelContext } from '../../core/resources/funnel';
+import { Environment, EnvironmentConfig } from '../../core/types';
+import { RawPluginConfig } from '../../core/utils/pluginConfig';
+/**
+ * Debug Script Definition
+ * Templates can provide debug scripts that will appear in the Debug Drawer "Scripts" tab
+ */
+export interface DebugScript {
+    /** Unique identifier for the script */
+    id: string;
+    /** Display name shown in the Scripts tab */
+    name: string;
+    /** Optional description of what the script does */
+    description?: string;
+    /** The function to execute when the script is run */
+    run: (context: TagadaContextValue) => void | Promise<void>;
+    /** Optional category to group scripts */
+    category?: string;
+}
 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;
@@ -22,6 +54,7 @@ interface TagadaContextValue extends TagadaState {
         lastUpdated: Date | null;
     };
     updateFunnelDebugData: (data: any, error?: Error | null, isLoading?: boolean) => void;
+    debugScripts: DebugScript[];
     refreshCoordinator: {
         registerCheckoutRefresh: (refreshFn: () => Promise<void>, name?: string) => void;
         registerOrderBumpRefresh: (refreshFn: () => Promise<void>) => void;
@@ -53,8 +86,36 @@ interface TagadaProviderProps {
     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;
+    /**
+     * Debug scripts provided by the template.
+     * These will appear in the Debug Drawer "Scripts" tab when debugMode is enabled.
+     * Only shown if the array is not empty.
+     */
+    debugScripts?: DebugScript[];
 }
 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, debugScripts, }: TagadaProviderProps): import("react/jsx-runtime").JSX.Element;
 export declare function useTagadaContext(): TagadaContextValue;
 export {};

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

@@ -4,10 +4,10 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
  * TagadaProvider - Main provider component for the Tagada Pay React SDK
  */
 import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
-import { createContext, useCallback, useContext, useEffect, useMemo, useState, useRef, } from 'react';
-import { TagadaClient } from '../../core/client';
+import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, } from 'react';
 import { ApiService } from '../../../react/services/apiService';
-import { formatMoney, formatMoneyWithoutSymbol, formatSimpleMoney, getCurrencyInfo, minorUnitsToMajorUnits, moneyStringOrNumberToMinorUnits, convertCurrency, } from '../../../react/utils/money';
+import { convertCurrency, formatMoney, formatMoneyWithoutSymbol, formatSimpleMoney, getCurrencyInfo, minorUnitsToMajorUnits, moneyStringOrNumberToMinorUnits, } from '../../../react/utils/money';
+import { TagadaClient } from '../../core/client';
 import { default as DebugDrawer } from '../components/DebugDrawer';
 import { setGlobalApiClient } from '../hooks/useApiQuery';
 // Professional, subtle loading component for initialization
@@ -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, debugScripts = [], }) {
+    // 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,13 +195,92 @@ 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,
         updateFunnelDebugData,
+        debugScripts,
         refreshCoordinator,
         money: moneyUtils,
     };

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.10",
+  "version": "3.0.2",
   "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": {