@tagadapay/plugin-sdk 3.1.12 → 3.1.22

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

@@ -3,6 +3,7 @@
  * Shared between all resource clients
  */
 import axios from 'axios';
+import { TagadaApiError, TagadaAuthError, TagadaNetworkError, TagadaCircuitBreakerError, TagadaError, TagadaErrorCode, } from '../errors';
 export class ApiClient {
     constructor(config) {
         this.currentToken = null;
@@ -61,12 +62,15 @@ export class ApiClient {
             console.error('[SDK] Request error:', error);
             return Promise.reject(error instanceof Error ? error : new Error(String(error)));
         });
-        // Response interceptor for logging
-        this.axios.interceptors.response.use((response) => {
-            // console.log('[SDK] Response status:', response.status);
-            return response;
-        }, (error) => {
+        // Response interceptor — maps Axios errors to structured TagadaError subtypes
+        this.axios.interceptors.response.use((response) => response, (error) => {
             console.error('[SDK] Response error:', error.message);
+            if (error instanceof TagadaError) {
+                return Promise.reject(error);
+            }
+            if (axios.isAxiosError(error)) {
+                return Promise.reject(this.toTagadaError(error));
+            }
             return Promise.reject(error instanceof Error ? error : new Error(String(error)));
         });
     }
@@ -146,10 +150,7 @@ export class ApiClient {
         }
         history.count++;
         if (history.count > this.MAX_REQUESTS) {
-            const error = new Error(`Circuit Breaker: Too many requests to ${key} (${history.count} in ${this.WINDOW_MS}ms)`);
-            // Add a property to identify this as a circuit breaker error
-            error.isCircuitBreaker = true;
-            throw error;
+            throw new TagadaCircuitBreakerError(`Circuit Breaker: Too many requests to ${key} (${history.count} in ${this.WINDOW_MS}ms)`);
         }
     }
     cleanupHistory() {
@@ -160,4 +161,46 @@ export class ApiClient {
             }
         }
     }
+    /** Convert an AxiosError into the appropriate TagadaError subclass. */
+    toTagadaError(error) {
+        const status = error.response?.status;
+        const data = error.response?.data;
+        const serverMessage = data?.message ??
+            data?.error ??
+            error.message;
+        // No response at all → network-level failure
+        if (!error.response) {
+            if (error.code === 'ECONNABORTED') {
+                return new TagadaApiError('Request timed out', 0, {
+                    code: TagadaErrorCode.TIMEOUT,
+                    retryable: true,
+                });
+            }
+            return new TagadaNetworkError(serverMessage);
+        }
+        // Auth failures
+        if (status === 401 || status === 403) {
+            return new TagadaAuthError(serverMessage, status);
+        }
+        // Rate-limited
+        if (status === 429) {
+            return new TagadaApiError(serverMessage, 429, {
+                code: TagadaErrorCode.RATE_LIMITED,
+                retryable: true,
+            });
+        }
+        // Not found
+        if (status === 404) {
+            return new TagadaApiError(serverMessage, 404, {
+                code: TagadaErrorCode.NOT_FOUND,
+                retryable: false,
+            });
+        }
+        // Generic API error
+        return new TagadaApiError(serverMessage, status ?? 0, {
+            code: data?.code ?? TagadaErrorCode.API_ERROR,
+            details: data,
+            retryable: (status ?? 0) >= 500,
+        });
+    }
 }

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

@@ -2,6 +2,7 @@
  * Checkout Resource Client
  * Axios-based API client for checkout endpoints
  */
+import type { OrderAddress } from '../types';
 import { ApiClient } from './apiClient';
 export interface CheckoutLineItem {
     externalProductId?: string | null;
@@ -91,7 +92,7 @@ export interface Store {
     chargeCurrencies: string[];
     upsells: Upsell[];
     emailDomains: string[];
-    integrations: any[];
+    integrations: unknown[];
 }
 export interface CheckoutSession {
     id: string;
@@ -106,7 +107,56 @@ export interface CheckoutSession {
     updatedAt: string;
     lastActiveDate: string;
     selectedPresentmentCurrency: string;
-    [key: string]: any;
+    shippingRate?: {
+        id: string;
+        [key: string]: unknown;
+    } | null;
+    shippingRateId?: string;
+    sessionLineItems?: Array<{
+        isOrderBump?: boolean;
+        [key: string]: unknown;
+    }>;
+    customer?: {
+        email?: string;
+        firstName?: string;
+        lastName?: string;
+        currency?: string;
+        [key: string]: unknown;
+    };
+    shippingAddress?: {
+        firstName?: string;
+        lastName?: string;
+        address1?: string;
+        address2?: string;
+        city?: string;
+        state?: string;
+        postal?: string;
+        country?: string;
+        phone?: string;
+        [key: string]: unknown;
+    };
+    billingAddress?: {
+        firstName?: string;
+        lastName?: string;
+        address1?: string;
+        address2?: string;
+        city?: string;
+        state?: string;
+        postal?: string;
+        country?: string;
+        phone?: string;
+        [key: string]: unknown;
+    };
+    metadata?: {
+        cartCustomAttributes?: Array<{
+            name?: string;
+            value?: string;
+            [key: string]: unknown;
+        }>;
+        clubProductId?: string;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
 }
 export interface CheckoutSummaryItem {
     id: string;
@@ -129,7 +179,7 @@ export interface CheckoutSummaryItem {
     amount: number;
     adjustedAmount: number;
     currency: string;
-    adjustments: any[];
+    adjustments: CheckoutSessionPreviewAdjustment[];
     recurring: boolean;
     interval?: 'day' | 'week' | 'month' | 'year';
     intervalCount?: number;
@@ -169,6 +219,7 @@ export interface CheckoutSummary {
     }[];
 }
 export interface CheckoutSessionPreviewAdjustment {
+    id?: string;
     type: 'Promotion' | 'Tax' | 'Shipping';
     description: string;
     level: 'Order' | 'LineItem';
@@ -205,7 +256,7 @@ export interface CheckoutSessionPreviewItem {
     intervalCount?: number;
     totalBillingCycles?: number;
     unitAmountAfterFirstCycle?: number;
-    subscriptionSettings?: any;
+    subscriptionSettings?: Record<string, unknown>;
     orderLineItemProduct: {
         name: string | null;
     } | null;
@@ -221,13 +272,22 @@ export interface CheckoutSessionPreview {
     totalAdjustedAmount: number;
     totalPromotionAmount: number;
 }
+export interface PromotionAction {
+    id: string;
+    adjustmentAmount?: Record<string, {
+        amount: number;
+        [key: string]: unknown;
+    }>;
+    adjustmentPercentage?: number;
+    [key: string]: unknown;
+}
 export interface Promotion {
     id: string;
     name: string;
     description: string | null;
     type: string;
-    rules: any[];
-    actions: any[];
+    rules: Record<string, unknown>[];
+    actions: PromotionAction[];
 }
 export interface CheckoutData {
     checkoutSession: CheckoutSession;
@@ -236,14 +296,6 @@ export interface CheckoutData {
     summary: CheckoutSummary;
     availablePromotions: Promotion[];
 }
-export interface Promotion {
-    id: string;
-    name: string;
-    description: string | null;
-    type: string;
-    rules: any[];
-    actions: any[];
-}
 export declare class CheckoutResource {
     private apiClient;
     constructor(apiClient: ApiClient);
@@ -300,9 +352,9 @@ export declare class CheckoutResource {
         funnelVariantId?: string;
         navigationEvent?: string | {
             type: string;
-            data?: any;
+            data?: Record<string, unknown>;
         };
-        navigationOptions?: any;
+        navigationOptions?: Record<string, unknown>;
     }, getFunnelSessionId?: () => string | null | undefined): Promise<{
         checkoutToken: string;
         customerId: string;
@@ -338,8 +390,8 @@ export declare class CheckoutResource {
      * Update checkout address
      */
     updateAddress(checkoutSessionId: string, data: {
-        shippingAddress: any;
-        billingAddress?: any;
+        shippingAddress: Partial<OrderAddress>;
+        billingAddress?: Partial<OrderAddress>;
     }): Promise<{
         success: boolean;
         errors?: Record<string, {
@@ -353,8 +405,8 @@ export declare class CheckoutResource {
      * Set checkout info
      */
     setCheckoutInfo(checkoutSessionId: string, data: {
-        shippingAddress: any;
-        billingAddress?: any;
+        shippingAddress: Partial<OrderAddress>;
+        billingAddress?: Partial<OrderAddress>;
         differentBillingAddress?: boolean;
     }): Promise<{
         success: boolean;
@@ -370,32 +422,39 @@ export declare class CheckoutResource {
      */
     applyPromotionCode(checkoutSessionId: string, code: string): Promise<{
         success: boolean;
-        error?: any;
+        error?: string;
     }>;
     /**
      * Remove promotion
      */
     removePromotion(checkoutSessionId: string, promotionId: string): Promise<{
         success: boolean;
-        error?: any;
+        error?: string;
     }>;
     /**
      * Get applied promotions
      */
     getAppliedPromotions(checkoutSessionId: string): Promise<Promotion[]>;
+    /**
+     * Replace all session line items (full rewrite)
+     */
+    replaceSessionLineItems(checkoutSessionId: string, lineItems: CheckoutLineItem[]): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
     /**
      * Update line items
      */
     updateLineItems(checkoutSessionId: string, lineItems: CheckoutLineItem[]): Promise<{
         success: boolean;
-        error?: any;
+        error?: string;
     }>;
     /**
      * Add line items
      */
     addLineItems(checkoutSessionId: string, lineItems: CheckoutLineItem[]): Promise<{
         success: boolean;
-        error?: any;
+        error?: string;
     }>;
     /**
      * Remove line items
@@ -405,21 +464,21 @@ export declare class CheckoutResource {
         quantity?: number;
     }[]): Promise<{
         success: boolean;
-        error?: any;
+        error?: string;
     }>;
     /**
      * Set item quantity
      */
     setItemQuantity(checkoutSessionId: string, variantId: string, quantity: number, priceId?: string): Promise<{
         success: boolean;
-        error?: any;
+        error?: string;
     }>;
     /**
      * Toggle order bump
      */
     toggleOrderBump(checkoutSessionId: string, orderBumpOfferId: string, selected: boolean): Promise<{
         success: boolean;
-        error?: any;
+        error?: string;
     }>;
     /**
      * Update customer
@@ -429,7 +488,7 @@ export declare class CheckoutResource {
         acceptsMarketing?: boolean;
     }): Promise<{
         success: boolean;
-        error?: any;
+        error?: string;
     }>;
     /**
      * Update customer and session info
@@ -439,8 +498,8 @@ export declare class CheckoutResource {
             email: string;
             acceptsMarketing?: boolean;
         };
-        shippingAddress: any;
-        billingAddress?: any;
+        shippingAddress: Partial<OrderAddress>;
+        billingAddress?: Partial<OrderAddress>;
         differentBillingAddress?: boolean;
     }): Promise<{
         success: boolean;

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

@@ -147,6 +147,14 @@ export class CheckoutResource {
     async getAppliedPromotions(checkoutSessionId) {
         return this.apiClient.get(`/api/v1/checkout-sessions/${checkoutSessionId}/promotions`);
     }
+    /**
+     * Replace all session line items (full rewrite)
+     */
+    async replaceSessionLineItems(checkoutSessionId, lineItems) {
+        return this.apiClient.post(`/api/v1/checkout-sessions/${checkoutSessionId}/line-items`, {
+            lineItems,
+        });
+    }
     /**
      * Update line items
      */

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;
     }>;
 }