@tagadapay/plugin-sdk 2.8.1 → 2.8.4

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

@@ -3,34 +3,43 @@
  */
 import { ApiClient } from './apiClient';
 /**
- * Funnel event types enum
+ * Funnel action types enum
  *
  * Special types:
  * - DIRECT_NAVIGATION: Bypasses step conditions, navigates directly to targetStepId
  * - BACK_NAVIGATION: Similar to direct_navigation, used for backward navigation
  *
  * Common types (for logging/tracking):
- * - Any string value is accepted, but these are commonly used examples
+ * - These are commonly used action types that align with funnel orchestrator conditions
+ * - Navigation logic is based on step conditions.from, action types are primarily for analytics
  */
-export declare enum FunnelEventType {
+export declare enum FunnelActionType {
     DIRECT_NAVIGATION = "direct_navigation",
     BACK_NAVIGATION = "back_navigation",
+    CONTINUE_CLICKED = "continue_clicked",
+    BUTTON_CLICK = "button_click",
+    FORM_SUBMIT = "form_submit",
     PAYMENT_SUCCESS = "payment_success",
+    PAYMENT_FAILED = "payment_failed",
+    OFFER_ACCEPTED = "offer_accepted",
+    OFFER_DECLINED = "offer_declined",
+    CART_UPDATED = "cart_updated",
+    CART_ITEM_ADDED = "cart_item_added",
     CUSTOM = "custom"
 }
 /**
- * Data structures for specific event types
+ * Data structures for specific action types
  */
-export type NextEvent<T> = T & {
+export type NextAction<T> = T & {
     [key: string]: any;
 };
-export interface DirectNavigationEventData {
+export interface DirectNavigationActionData {
     targetStepId: string;
 }
-export interface BackNavigationEventData {
+export interface BackNavigationActionData {
     targetStepId: string;
 }
-export interface PaymentSuccessEventData {
+export interface PaymentSuccessActionData {
     payment: {
         id: string;
         status: string;
@@ -46,12 +55,53 @@ export interface PaymentSuccessEventData {
     };
     [key: string]: any;
 }
+export interface PaymentFailedActionData {
+    payment: {
+        id: string;
+        status: string;
+        error?: string;
+        [key: string]: any;
+    };
+    [key: string]: any;
+}
+export interface OfferAcceptedActionData {
+    offer: {
+        accepted: boolean;
+        offerId?: string;
+        [key: string]: any;
+    };
+    [key: string]: any;
+}
+export interface OfferDeclinedActionData {
+    offer: {
+        declined: boolean;
+        offerId?: string;
+        [key: string]: any;
+    };
+    [key: string]: any;
+}
+export interface CartUpdatedActionData {
+    cart: {
+        hasSpecificItem?: boolean;
+        itemIds?: string[];
+        variantIds?: string[];
+        total?: number;
+        [key: string]: any;
+    };
+    [key: string]: any;
+}
+export interface FormSubmitActionData {
+    form?: {
+        [key: string]: any;
+    };
+    [key: string]: any;
+}
 /**
- * Base properties shared by all FunnelEvent types
+ * Base properties shared by all FunnelAction types
  */
-interface BaseFunnelEvent {
+interface BaseFunnelAction {
     /**
-     * Event timestamp (ISO string format)
+     * Action timestamp (ISO string format)
      */
     timestamp?: string;
     /**
@@ -62,20 +112,44 @@ interface BaseFunnelEvent {
     currentUrl?: string;
 }
 /**
- * Discriminated union for FunnelEvent based on event type
+ * Discriminated union for FunnelAction based on action type
  */
-export type FunnelAction = BaseFunnelEvent & (({
-    type: FunnelEventType.DIRECT_NAVIGATION;
-    data: NextEvent<DirectNavigationEventData>;
+export type FunnelAction = BaseFunnelAction & (({
+    type: FunnelActionType.DIRECT_NAVIGATION;
+    data: NextAction<DirectNavigationActionData>;
+}) | ({
+    type: FunnelActionType.BACK_NAVIGATION;
+    data: NextAction<BackNavigationActionData>;
+}) | ({
+    type: FunnelActionType.CONTINUE_CLICKED;
+    data?: NextAction<any>;
+}) | ({
+    type: FunnelActionType.BUTTON_CLICK;
+    data?: NextAction<any>;
+}) | ({
+    type: FunnelActionType.FORM_SUBMIT;
+    data?: NextAction<FormSubmitActionData>;
+}) | ({
+    type: FunnelActionType.PAYMENT_SUCCESS;
+    data: NextAction<PaymentSuccessActionData>;
+}) | ({
+    type: FunnelActionType.PAYMENT_FAILED;
+    data?: NextAction<PaymentFailedActionData>;
+}) | ({
+    type: FunnelActionType.OFFER_ACCEPTED;
+    data?: NextAction<OfferAcceptedActionData>;
+}) | ({
+    type: FunnelActionType.OFFER_DECLINED;
+    data?: NextAction<OfferDeclinedActionData>;
 }) | ({
-    type: FunnelEventType.BACK_NAVIGATION;
-    data: NextEvent<BackNavigationEventData>;
+    type: FunnelActionType.CART_UPDATED;
+    data?: NextAction<CartUpdatedActionData>;
 }) | ({
-    type: FunnelEventType.PAYMENT_SUCCESS;
-    data: NextEvent<PaymentSuccessEventData>;
+    type: FunnelActionType.CART_ITEM_ADDED;
+    data?: NextAction<CartUpdatedActionData>;
 }) | ({
-    type: FunnelEventType.CUSTOM;
-    data?: NextEvent<any>;
+    type: FunnelActionType.CUSTOM;
+    data?: NextAction<any>;
 }));
 export interface FunnelNavigationAction {
     type: 'redirect' | 'replace' | 'push' | 'external' | 'none';

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

@@ -2,23 +2,37 @@
  * Funnel Resource - API client for funnel navigation and session management
  */
 /**
- * Funnel event types enum
+ * Funnel action types enum
  *
  * Special types:
  * - DIRECT_NAVIGATION: Bypasses step conditions, navigates directly to targetStepId
  * - BACK_NAVIGATION: Similar to direct_navigation, used for backward navigation
  *
  * Common types (for logging/tracking):
- * - Any string value is accepted, but these are commonly used examples
+ * - These are commonly used action types that align with funnel orchestrator conditions
+ * - Navigation logic is based on step conditions.from, action types are primarily for analytics
  */
-export var FunnelEventType;
-(function (FunnelEventType) {
-    // Special navigation types
-    FunnelEventType["DIRECT_NAVIGATION"] = "direct_navigation";
-    FunnelEventType["BACK_NAVIGATION"] = "back_navigation";
-    FunnelEventType["PAYMENT_SUCCESS"] = "payment_success";
-    FunnelEventType["CUSTOM"] = "custom";
-})(FunnelEventType || (FunnelEventType = {}));
+export var FunnelActionType;
+(function (FunnelActionType) {
+    // Special navigation types (bypass step conditions)
+    FunnelActionType["DIRECT_NAVIGATION"] = "direct_navigation";
+    FunnelActionType["BACK_NAVIGATION"] = "back_navigation";
+    // User interaction types
+    FunnelActionType["CONTINUE_CLICKED"] = "continue_clicked";
+    FunnelActionType["BUTTON_CLICK"] = "button_click";
+    FunnelActionType["FORM_SUBMIT"] = "form_submit";
+    // Payment actions
+    FunnelActionType["PAYMENT_SUCCESS"] = "payment_success";
+    FunnelActionType["PAYMENT_FAILED"] = "payment_failed";
+    // Offer actions
+    FunnelActionType["OFFER_ACCEPTED"] = "offer_accepted";
+    FunnelActionType["OFFER_DECLINED"] = "offer_declined";
+    // Cart actions
+    FunnelActionType["CART_UPDATED"] = "cart_updated";
+    FunnelActionType["CART_ITEM_ADDED"] = "cart_item_added";
+    // Generic/custom actions
+    FunnelActionType["CUSTOM"] = "custom";
+})(FunnelActionType || (FunnelActionType = {}));
 export class FunnelResource {
     constructor(apiClient) {
         this.apiClient = apiClient;

package/dist/v2/index.d.ts

@@ -21,8 +21,8 @@ export type { ShippingRate, ShippingRatesResponse } from './core/resources/shipp
 export type { ApplyDiscountResponse, Discount, DiscountCodeValidation, RemoveDiscountResponse } from './core/resources/discounts';
 export type { ToggleOrderBumpResponse, VipOffer, VipPreviewResponse } from './core/resources/vipOffers';
 export type { StoreConfig } from './core/resources/storeConfig';
-export { FunnelEventType } from './core/resources/funnel';
-export type { BackNavigationEventData, DirectNavigationEventData, FunnelContextUpdateRequest, FunnelContextUpdateResponse, FunnelAction as FunnelEvent, FunnelInitializeRequest, FunnelInitializeResponse, FunnelNavigateRequest, FunnelNavigateResponse, FunnelNavigationAction, FunnelNavigationResult, NextEvent, PaymentSuccessEventData, SimpleFunnelContext } from './core/resources/funnel';
+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, 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 type { TranslateFunction, TranslationText, UseTranslationOptions, UseTranslationResult } from './react/hooks/useTranslation';
 export type { ClubOffer, ClubOfferItem, ClubOfferLineItem, ClubOfferSummary, UseClubOffersOptions, UseClubOffersResult } from './react/hooks/useClubOffers';

package/dist/v2/index.js

@@ -13,6 +13,6 @@ export * from './core/utils/pluginConfig';
 export * from './core/utils/products';
 // Path remapping helpers (framework-agnostic)
 export * from './core/pathRemapping';
-export { FunnelEventType } from './core/resources/funnel';
+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, 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';

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

@@ -6,7 +6,7 @@
  */
 import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
 import { useCallback, useEffect, useMemo, useState } from 'react';
-import { FunnelEventType, FunnelResource } from '../../core/resources/funnel';
+import { FunnelActionType, FunnelResource } from '../../core/resources/funnel';
 import { useTagadaContext } from '../providers/TagadaProvider';
 import { getGlobalApiClient } from './useApiQuery';
 // Query keys for funnel operations
@@ -405,7 +405,7 @@ export function useFunnel(options) {
     }, [navigateMutation]);
     const goToStep = useCallback(async (stepId) => {
         return next({
-            type: FunnelEventType.DIRECT_NAVIGATION,
+            type: FunnelActionType.DIRECT_NAVIGATION,
             data: { targetStepId: stepId },
             timestamp: new Date().toISOString()
         });

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

@@ -8,7 +8,6 @@ import { PostPurchasesResource } from '../../core/resources/postPurchases';
 import { useTagadaContext } from '../providers/TagadaProvider';
 import { getGlobalApiClient, getGlobalApiClientOrNull } from './useApiQuery';
 export function usePostPurchasesQuery(options) {
-    console.log('usePostPurchasesQuery');
     const { orderId, enabled = true, autoInitializeCheckout = false } = options;
     const queryClient = useQueryClient();
     const { session, isSessionInitialized, apiService } = useTagadaContext();

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

@@ -55,7 +55,7 @@ export type { ExtractedAddress, GooglePlaceDetails, GooglePrediction, UseGoogleA
 export type { ISOCountry, ISORegion, UseISODataResult } from './hooks/useISOData';
 export type { UsePluginConfigOptions, UsePluginConfigResult } from './hooks/usePluginConfig';
 export type { TranslateFunction, UseTranslationOptions, UseTranslationResult } from './hooks/useTranslation';
-export { FunnelEventType } from '../core/resources/funnel';
+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';

package/dist/v2/react/index.js

@@ -45,6 +45,6 @@ export { useVipOffersQuery as useVipOffers } from './hooks/useVipOffersQuery';
 // Funnel hooks
 export { useFunnel, useSimpleFunnel } from './hooks/useFunnel';
 // TanStack Query types
-export { FunnelEventType } from '../core/resources/funnel';
+export { FunnelActionType } from '../core/resources/funnel';
 // Re-export utilities from main react
 export { formatMoney } from '../../react/utils/money';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tagadapay/plugin-sdk",
-  "version": "2.8.1",
+  "version": "2.8.4",
   "description": "Modern React SDK for building Tagada Pay plugins",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",