@tagadapay/plugin-sdk 3.1.11 → 3.1.22

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

@@ -3,6 +3,7 @@
  * Handles customer-related API operations
  */
 import { ApiClient } from './apiClient';
+import type { Subscription as CoreSubscription, DeviceInfo, PromotionCode, OrderAddress, OrderSummary, PromotionSummary, PaymentSummary, OrderAdjustmentSummary } from '../types';
 export interface CustomerAddress {
     firstName: string | null;
     lastName: string | null;
@@ -40,12 +41,12 @@ export interface CustomerInfos {
         acceptsMarketing: boolean;
         createdAt: string;
         updatedAt: string;
-        metadata: Record<string, any>;
-        device: any | null;
+        metadata: Record<string, unknown>;
+        device: DeviceInfo | null;
         orders: CustomerOrderSummary[];
-        subscriptions: any[];
+        subscriptions: CoreSubscription[];
     };
-    promotionCodes: any[];
+    promotionCodes: PromotionCode[];
 }
 export interface OrderWithRelations {
     id: string;
@@ -53,27 +54,27 @@ export interface OrderWithRelations {
     paidAmount: number;
     status: string;
     createdAt: string;
-    metadata?: Record<string, any>;
-    items: any[];
-    summaries?: any[];
-    shippingAddress?: any;
-    billingAddress?: any;
-    pickupAddress?: any;
+    metadata?: Record<string, unknown>;
+    items: Record<string, unknown>[];
+    summaries?: OrderSummary[];
+    shippingAddress?: OrderAddress | null;
+    billingAddress?: OrderAddress | null;
+    pickupAddress?: Record<string, unknown> | null;
     checkoutSession?: {
         returnUrl?: string;
-        [key: string]: any;
+        [key: string]: unknown;
     };
-    relatedOrders?: any[];
-    customer?: any;
-    store?: any;
+    relatedOrders?: OrderWithRelations[];
+    customer?: Record<string, unknown>;
+    store?: Record<string, unknown>;
     account?: {
         id: string;
         name?: string;
     };
-    payments?: any[];
-    promotions?: any[];
-    subscriptions?: any[];
-    adjustments: any[];
+    payments?: PaymentSummary[];
+    promotions?: PromotionSummary[];
+    subscriptions?: CoreSubscription[];
+    adjustments: OrderAdjustmentSummary[];
 }
 export interface Subscription {
     id: string;
@@ -127,7 +128,7 @@ export declare class CustomerResource {
         firstName?: string;
         lastName?: string;
         acceptsMarketing?: boolean;
-        metadata?: Record<string, any>;
+        metadata?: Record<string, unknown>;
     }): Promise<CustomerInfos>;
     /**
      * Get customer orders

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

@@ -31,14 +31,14 @@ export declare enum FunnelActionType {
  * Data structures for specific action types
  */
 export type NextAction<T> = T & {
-    [key: string]: any;
+    [key: string]: unknown;
 };
 /**
  * Base resource data type - all resources must have an id and optional metadata
  */
 export interface FunnelResourceData {
     id: string;
-    [key: string]: any;
+    [key: string]: unknown;
 }
 /**
  * Resource metadata for tracking, versioning, and relationships
@@ -57,7 +57,7 @@ export interface ResourceMetadata {
     /** Related resource IDs (for relationships) */
     relatedTo?: string[];
     /** Custom metadata */
-    [key: string]: any;
+    [key: string]: unknown;
 }
 /**
  * Wrapped resource with metadata
@@ -220,7 +220,7 @@ export interface FunnelActionResources<TCustom = {}> {
      * Legacy top-level data (backward compatible)
      * Will be automatically migrated to resources by orchestrator
      */
-    [key: string]: any;
+    [key: string]: unknown;
 }
 export interface DirectNavigationActionData extends FunnelActionResources {
     targetStepId: string;
@@ -234,13 +234,13 @@ export interface PaymentSuccessActionData extends FunnelActionResources {
         status: string;
         transactionId?: string;
         timestamp?: string;
-        [key: string]: any;
+        [key: string]: unknown;
     };
     order: {
         id: string;
         amount: number;
         currency: string;
-        [key: string]: any;
+        [key: string]: unknown;
     };
 }
 export interface PaymentFailedActionData extends FunnelActionResources {
@@ -248,21 +248,21 @@ export interface PaymentFailedActionData extends FunnelActionResources {
         id: string;
         status: string;
         error?: string;
-        [key: string]: any;
+        [key: string]: unknown;
     };
 }
 export interface OfferAcceptedActionData extends FunnelActionResources {
     offer: {
         accepted: boolean;
         offerId?: string;
-        [key: string]: any;
+        [key: string]: unknown;
     };
 }
 export interface OfferDeclinedActionData extends FunnelActionResources {
     offer: {
         declined: boolean;
         offerId?: string;
-        [key: string]: any;
+        [key: string]: unknown;
     };
 }
 export interface CartUpdatedActionData extends FunnelActionResources {
@@ -271,12 +271,12 @@ export interface CartUpdatedActionData extends FunnelActionResources {
         itemIds?: string[];
         variantIds?: string[];
         total?: number;
-        [key: string]: any;
+        [key: string]: unknown;
     };
 }
 export interface FormSubmitActionData extends FunnelActionResources {
     form?: {
-        [key: string]: any;
+        [key: string]: unknown;
     };
 }
 /**
@@ -305,10 +305,10 @@ export type FunnelAction = BaseFunnelAction & (({
     data: NextAction<BackNavigationActionData>;
 }) | ({
     type: FunnelActionType.CONTINUE_CLICKED;
-    data: NextAction<any>;
+    data: NextAction<FunnelActionResources>;
 }) | ({
     type: FunnelActionType.BUTTON_CLICK;
-    data: NextAction<any>;
+    data: NextAction<FunnelActionResources>;
 }) | ({
     type: FunnelActionType.FORM_SUBMIT;
     data: NextAction<FormSubmitActionData>;
@@ -340,7 +340,7 @@ export type FunnelAction = BaseFunnelAction & (({
 export interface FunnelNavigationAction {
     type: 'redirect' | 'replace' | 'push' | 'external' | 'none';
     url?: string;
-    data?: any;
+    data?: Record<string, unknown>;
 }
 export interface FunnelNavigationResult {
     stepId?: string;
@@ -424,12 +424,12 @@ export interface SimpleFunnelContext<TCustom = {}> {
      * - Available at runtime as context.static
      * - Example: context.static.offer.id for statically configured offers
      */
-    static?: Record<string, any>;
+    static?: Record<string, unknown>;
     /**
      * Legacy/Custom metadata
      * For backward compatibility and flexible unstructured data
      */
-    metadata?: Record<string, any>;
+    metadata?: Record<string, unknown>;
     script?: string;
 }
 export interface FunnelInitializeRequest {
@@ -603,7 +603,7 @@ export declare class FunnelResource {
     getSession(sessionId: string, currentUrl?: string, includeDebugData?: boolean): Promise<{
         success: boolean;
         context?: SimpleFunnelContext;
-        debugData?: any;
+        debugData?: Record<string, unknown>;
         error?: string;
     }>;
 }

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

@@ -3,18 +3,19 @@
  * Axios-based API client for payment endpoints
  */
 import { ApiClient } from './apiClient';
+import type { Order } from '../types';
 export interface Payment {
     id: string;
     status: string;
     subStatus: string;
-    requireAction: 'none' | 'redirect' | 'error' | 'radar';
+    requireAction: 'none' | 'redirect' | 'redirect_to_payment' | 'error' | 'radar';
     requireActionData?: {
-        type: 'redirect' | 'threeds_auth' | 'processor_auth' | 'error' | 'stripe_radar' | 'finix_radar' | 'radar';
+        type: 'redirect' | 'redirect_to_payment' | 'threeds_auth' | 'processor_auth' | 'error' | 'stripe_radar' | 'finix_radar' | 'radar' | 'kesspay_auth' | 'trustflow_auth' | 'mastercard_auth';
         url?: string;
         processed: boolean;
         processorId?: string;
         metadata?: {
-            type: 'redirect' | 'stripe_radar' | 'finix_radar';
+            type: 'redirect' | 'redirect_to_payment' | 'stripe_radar' | 'finix_radar';
             redirect?: {
                 redirectUrl: string;
                 returnUrl: string;
@@ -42,12 +43,15 @@ export interface Payment {
     order?: {
         id: string;
         checkoutSessionId: string;
+        amount?: number;
+        currency?: string;
+        [key: string]: unknown;
     };
 }
 export interface PaymentResponse {
     paymentId: string;
     payment: Payment;
-    order?: any;
+    order?: Order | null;
 }
 export interface PaymentInstrumentResponse {
     id: string;
@@ -94,6 +98,16 @@ export interface PaymentOptions {
      * If neither is set, the store's selectedPaymentFlowId will be used
      */
     paymentFlowId?: string;
+    /**
+     * For alternative payment methods (APM)
+     * Processor ID to use for the payment
+     */
+    processorId?: string;
+    /**
+     * For alternative payment methods (APM)
+     * Payment method type (e.g., 'klarna', 'afterpay', 'paypal')
+     */
+    paymentMethod?: string;
     /** @deprecated Use onPaymentSuccess instead - this will be removed in v3 */
     onSuccess?: (response: PaymentResponse) => void;
     /** @deprecated Use onPaymentFailed instead - this will be removed in v3 */
@@ -138,28 +152,83 @@ export interface ApplePayToken {
         brand: string;
     };
 }
+/** Token response from BasisTheory SDK */
+export interface BasisTheoryTokenResponse {
+    id: string;
+    type: string;
+    enrichments?: {
+        cardDetails?: {
+            bin?: string;
+            last4?: string;
+        };
+    };
+}
+/** External BasisTheory SDK instance shape (from @basis-theory/basis-theory-react) */
+export interface BasisTheoryInstance {
+    tokens: {
+        create(data: Record<string, unknown>): Promise<BasisTheoryTokenResponse>;
+    };
+}
+export interface GooglePayToken {
+    id: string;
+    type: string;
+    card: {
+        bin: string;
+        last4: string;
+        expiration_month: number;
+        expiration_year: number;
+        brand: string;
+    };
+    details?: {
+        auth_method?: string;
+        [key: string]: unknown;
+    };
+}
+export interface PaymentInstrumentInput {
+    type: string;
+    token?: string;
+    card?: {
+        maskedCardNumber?: string;
+        expirationMonth?: number;
+        expirationYear?: number;
+        bin?: string;
+        last4?: string;
+        brand?: string;
+    };
+    dpanType?: string;
+    authMethod?: string;
+    provider?: string;
+    paymentMethod?: string;
+    processorId?: string;
+    [key: string]: unknown;
+}
 export declare class PaymentsResource {
     private apiClient;
     constructor(apiClient: ApiClient);
     /**
      * Create payment instrument
      */
-    createPaymentInstrument(paymentInstrumentData: any): Promise<PaymentInstrumentResponse>;
+    createPaymentInstrument(paymentInstrumentData: PaymentInstrumentInput): Promise<PaymentInstrumentResponse>;
     /**
      * Create card payment instrument
      */
-    createCardPaymentInstrument(basisTheory: any, // BasisTheory instance from @basis-theory/basis-theory-react
-    cardData: CardPaymentMethod): Promise<PaymentInstrumentResponse>;
+    createCardPaymentInstrument(basisTheory: BasisTheoryInstance | undefined, cardData: CardPaymentMethod): Promise<PaymentInstrumentResponse>;
     /**
      * Create Apple Pay payment instrument
      */
-    createApplePayPaymentInstrument(basisTheory: any, // BasisTheory instance from @basis-theory/basis-theory-react
-    applePayToken: ApplePayToken): Promise<PaymentInstrumentResponse>;
+    createApplePayPaymentInstrument(basisTheory: BasisTheoryInstance | undefined, applePayToken: ApplePayToken): Promise<PaymentInstrumentResponse>;
     /**
      * Create Google Pay payment instrument
      */
-    createGooglePayPaymentInstrument(basisTheory: any, // BasisTheory instance from @basis-theory/basis-theory-react
-    googlePayToken: any): Promise<PaymentInstrumentResponse>;
+    createGooglePayPaymentInstrument(basisTheory: BasisTheoryInstance | undefined, googlePayToken: GooglePayToken): Promise<PaymentInstrumentResponse>;
+    /**
+     * Create APM payment instrument (Klarna, Afterpay, PayPal, etc.)
+     */
+    createApmPaymentInstrument(apmData: {
+        provider: string;
+        paymentMethod: string;
+        processorId: string;
+    }): Promise<PaymentInstrumentResponse>;
     /**
      * Helper function to format expiry date
      */
@@ -171,6 +240,8 @@ export declare class PaymentsResource {
         initiatedBy?: 'customer' | 'merchant';
         source?: 'upsell' | 'checkout' | 'offer' | 'missing_club' | 'forced';
         paymentFlowId?: string;
+        processorId?: string;
+        paymentMethod?: string;
     }): Promise<PaymentResponse>;
     /**
      * Get card payment instruments for customer
@@ -200,7 +271,7 @@ export declare class PaymentsResource {
         transactionId?: string;
         message?: string;
         success?: boolean;
-        error?: any;
+        error?: string;
     }>;
     saveRadarSession(data: {
         orderId?: string;
@@ -226,5 +297,5 @@ export declare class PaymentsResource {
         paymentId: string;
         status: 'succeeded' | 'failed' | 'pending';
         paymentIntentId: string;
-    }): Promise<any>;
+    }): Promise<Payment>;
 }

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

@@ -17,8 +17,7 @@ export class PaymentsResource {
     /**
      * Create card payment instrument
      */
-    async createCardPaymentInstrument(basisTheory, // BasisTheory instance from @basis-theory/basis-theory-react
-    cardData) {
+    async createCardPaymentInstrument(basisTheory, cardData) {
         if (!basisTheory) {
             throw new Error('Payment processor not initialized');
         }
@@ -55,8 +54,7 @@ export class PaymentsResource {
     /**
      * Create Apple Pay payment instrument
      */
-    async createApplePayPaymentInstrument(basisTheory, // BasisTheory instance from @basis-theory/basis-theory-react
-    applePayToken) {
+    async createApplePayPaymentInstrument(basisTheory, applePayToken) {
         if (!basisTheory) {
             throw new Error('Payment processor not initialized');
         }
@@ -81,9 +79,7 @@ export class PaymentsResource {
     /**
      * Create Google Pay payment instrument
      */
-    async createGooglePayPaymentInstrument(basisTheory, // BasisTheory instance from @basis-theory/basis-theory-react
-    googlePayToken // Token from Basis Theory Google Pay tokenization
-    ) {
+    async createGooglePayPaymentInstrument(basisTheory, googlePayToken) {
         if (!basisTheory) {
             throw new Error('Payment processor not initialized');
         }
@@ -106,6 +102,21 @@ export class PaymentsResource {
         const response = await this.apiClient.post('/api/v1/payment/create-payment-instrument', { paymentInstrumentData });
         return response;
     }
+    /**
+     * Create APM payment instrument (Klarna, Afterpay, PayPal, etc.)
+     */
+    async createApmPaymentInstrument(apmData) {
+        console.log('Creating APM payment instrument:', apmData);
+        const paymentInstrumentData = {
+            type: 'apm',
+            provider: apmData.provider,
+            paymentMethod: apmData.paymentMethod,
+            processorId: apmData.processorId,
+        };
+        const response = await this.apiClient.post('/api/v1/payment/create-payment-instrument', { paymentInstrumentData });
+        console.log('APM payment instrument created:', response);
+        return response;
+    }
     /**
      * Helper function to format expiry date
      */
@@ -124,15 +135,21 @@ export class PaymentsResource {
      */
     async processPaymentDirect(checkoutSessionId, paymentInstrumentId, threedsSessionId, options = {}) {
         console.log('[PaymentsResource] processPaymentDirect START', options.paymentFlowId ? `(flow: ${options.paymentFlowId})` : '');
+        console.log('[PaymentsResource] Full options object:', JSON.stringify(options, null, 2));
+        console.log('[PaymentsResource] processorId:', options.processorId, 'paymentMethod:', options.paymentMethod);
         try {
-            const response = await this.apiClient.post('/api/public/v1/checkout/pay-v2', {
+            const requestBody = {
                 checkoutSessionId,
                 paymentInstrumentId,
                 ...(threedsSessionId && { threedsSessionId }),
                 ...(options.initiatedBy && { initiatedBy: options.initiatedBy }),
                 ...(options.source && { source: options.source }),
                 ...(options.paymentFlowId && { paymentFlowId: options.paymentFlowId }),
-            });
+                ...(options.processorId && { processorId: options.processorId }),
+                ...(options.paymentMethod && { paymentMethod: options.paymentMethod }),
+            };
+            console.log('[PaymentsResource] Request body being sent:', JSON.stringify(requestBody, null, 2));
+            const response = await this.apiClient.post('/api/public/v1/checkout/pay-v2', requestBody);
             console.log('[PaymentsResource] processPaymentDirect SUCCESS:', response);
             return response;
         }

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

@@ -19,6 +19,16 @@ export interface ShippingRatesResponse {
     rates: ShippingRate[];
     forceCheckoutSessionRefetch?: boolean;
 }
+export interface ShippingRatesPreviewParams {
+    countryCode: string;
+    stateCode?: string;
+}
+export interface ShippingRatesPreviewResponse {
+    rates: ShippingRate[];
+    pickupPoint?: {
+        apiKey: string | null;
+    };
+}
 export declare class ShippingRatesResource {
     private apiClient;
     constructor(apiClient: ApiClient);
@@ -33,4 +43,9 @@ export declare class ShippingRatesResource {
         success: boolean;
         error?: any;
     }>;
+    /**
+     * Preview shipping rates for a country without updating session
+     * Useful for showing rates before user enters email
+     */
+    previewShippingRates(sessionId: string, params: ShippingRatesPreviewParams): Promise<ShippingRatesPreviewResponse>;
 }

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

@@ -20,4 +20,15 @@ export class ShippingRatesResource {
             shippingRateId,
         });
     }
+    /**
+     * Preview shipping rates for a country without updating session
+     * Useful for showing rates before user enters email
+     */
+    async previewShippingRates(sessionId, params) {
+        const queryParams = new URLSearchParams({ countryCode: params.countryCode });
+        if (params.stateCode) {
+            queryParams.set('stateCode', params.stateCode);
+        }
+        return this.apiClient.get(`/api/v1/checkout-sessions/${sessionId}/shipping-rates/preview?${queryParams.toString()}`);
+    }
 }

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

@@ -1,6 +1,9 @@
 /**
  * Types for the Tagada Pay SDK Core
  */
+export type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+};
 export type Environment = 'production' | 'development' | 'local';
 export interface ApiConfig {
     baseUrl: string;
@@ -86,6 +89,40 @@ export interface PickupPoint {
     opening_hours?: string;
     extra_info?: string;
 }
+export interface Subscription {
+    id: string;
+    status: string;
+    planName?: string;
+    interval?: string;
+    intervalCount?: number;
+    currentPeriodEnd?: string;
+    currentPeriodStart?: string;
+    cancelAtPeriodEnd?: boolean;
+    trialEnd?: string | null;
+    [key: string]: unknown;
+}
+export interface DeviceGeoData {
+    city?: string;
+    regionName?: string;
+    country?: string;
+    [key: string]: unknown;
+}
+export interface DeviceInfo {
+    userAgent?: string;
+    ip?: string;
+    country?: string;
+    browser?: string;
+    browserVersion?: string;
+    os?: string;
+    osVersion?: string;
+    geoData?: DeviceGeoData;
+    [key: string]: unknown;
+}
+export interface PromotionCode {
+    id: string;
+    code: string;
+    [key: string]: unknown;
+}
 export interface OrderItem {
     id: string;
     productId: string;
@@ -141,15 +178,16 @@ export interface Order {
     paidAmount: number;
     status: string;
     createdAt: string;
-    metadata?: Record<string, any>;
+    metadata?: Record<string, unknown>;
     items: OrderItem[];
     summaries?: OrderSummary[];
     shippingAddress?: OrderAddress;
     billingAddress?: OrderAddress;
-    pickupAddress?: PickupPoint;
+    pickupAddress?: PickupPoint | null;
+    customer?: Customer;
     checkoutSession?: {
         returnUrl?: string;
-        [key: string]: any;
+        [key: string]: unknown;
     };
     relatedOrders?: Order[];
 }
@@ -161,7 +199,7 @@ export interface PaymentSummary {
     createdAt: string;
     updatedAt?: string;
     provider?: string;
-    metadata?: Record<string, any>;
+    metadata?: Record<string, unknown>;
 }
 export interface PromotionSummary {
     id: string;
@@ -188,10 +226,10 @@ export interface OrderWithRelations extends Order {
     checkoutSession?: {
         id?: string;
         returnUrl?: string;
-        [key: string]: any;
+        [key: string]: unknown;
     };
     promotions?: PromotionSummary[];
-    subscriptions?: any[];
+    subscriptions?: Subscription[];
     adjustments: OrderAdjustmentSummary[];
 }
 export interface CustomerAddress {
@@ -225,7 +263,7 @@ export interface CustomerOrderSummary {
     externalOrderId: string | null;
     billingAddress: CustomerAddress;
     shippingAddress: Omit<CustomerAddress, 'email'>;
-    pickupAddress: any | null;
+    pickupAddress: PickupPoint | null;
     taxesIncluded: boolean;
     draft: boolean;
     checkoutSessionId: string | null;
@@ -235,7 +273,7 @@ export interface CustomerOrderSummary {
     paymentInstrumentId: string | null;
     refundedAt: string | null;
     refundedAmount: number | null;
-    metadata?: Record<string, any>;
+    metadata?: Record<string, unknown>;
 }
 export interface CustomerInfos {
     customer: {
@@ -255,12 +293,12 @@ export interface CustomerInfos {
         acceptsMarketing: boolean;
         createdAt: string;
         updatedAt: string;
-        metadata: Record<string, any>;
-        device: any | null;
+        metadata: Record<string, unknown>;
+        device: DeviceInfo | null;
         orders: CustomerOrderSummary[];
-        subscriptions: any[];
+        subscriptions: Subscription[];
     };
-    promotionCodes: any[];
+    promotionCodes: PromotionCode[];
 }
 export interface SessionInitResponse {
     store: Store;

package/dist/v2/core/types.js

@@ -1,4 +1 @@
-/**
- * Types for the Tagada Pay SDK Core
- */
 export {};

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

@@ -2,8 +2,8 @@
  * Checkout Utility Functions
  * Pure functions for checkout data manipulation
  */
-import type { CheckoutData, CheckoutSession, CheckoutLineItem, CheckoutInitParams, Promotion } from '../resources/checkout';
-export type { CheckoutData, CheckoutSession, CheckoutLineItem, CheckoutInitParams, Promotion, };
+import type { CheckoutData, CheckoutInitParams, CheckoutLineItem, CheckoutSession, Promotion } from '../resources/checkout';
+export type { CheckoutData, CheckoutInitParams, CheckoutLineItem, CheckoutSession, Promotion };
 export declare class CheckoutUtils {
     /**
      * Get checkout session ID

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

@@ -13,13 +13,18 @@ export class CheckoutUtils {
      * Get checkout line items
      */
     static getLineItems(checkoutData) {
-        return checkoutData.checkoutSession?.lineItems || [];
+        const lineItems = checkoutData.checkoutSession?.lineItems;
+        if (!Array.isArray(lineItems)) {
+            return [];
+        }
+        return lineItems;
     }
     /**
      * Get checkout total
      */
     static getTotal(checkoutData) {
-        return checkoutData.checkoutSession?.totalPrice || 0;
+        const totalPrice = checkoutData.checkoutSession?.totalPrice;
+        return typeof totalPrice === 'number' ? totalPrice : 0;
     }
     /**
      * Check if customer is club member