@tagadapay/plugin-sdk 2.4.39 → 2.5.0

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

@@ -0,0 +1,87 @@
+/**
+ * Promotions Resource Client
+ * Axios-based API client for promotion endpoints
+ */
+export class PromotionsResource {
+    constructor(apiClient) {
+        this.apiClient = apiClient;
+    }
+    /**
+     * Get applied promotions for a checkout session
+     */
+    async getAppliedPromotions(checkoutSessionId) {
+        return this.apiClient.get(`/api/v1/checkout-sessions/${checkoutSessionId}/promotions`);
+    }
+    /**
+     * Apply a promotion code to a checkout session
+     */
+    async applyPromotionCode(checkoutSessionId, code) {
+        try {
+            const response = await this.apiClient.post(`/api/v1/checkout-sessions/${checkoutSessionId}/promotions/apply`, { code: code.trim() });
+            if (response.success) {
+                return { success: true, promotion: response.promotion };
+            }
+            else {
+                return { success: false, error: response.error?.message || 'Failed to apply promotion code' };
+            }
+        }
+        catch (err) {
+            // Try to extract error message from API response
+            let errorMessage = 'Failed to apply promotion code';
+            if (err && typeof err === 'object' && 'response' in err) {
+                const apiError = err;
+                if (apiError.response?.data?.error?.message) {
+                    errorMessage = apiError.response.data.error.message;
+                }
+                else if (apiError.response?.data?.message) {
+                    errorMessage = apiError.response.data.message;
+                }
+            }
+            return { success: false, error: errorMessage };
+        }
+    }
+    /**
+     * Remove a promotion from a checkout session
+     */
+    async removePromotionCode(checkoutSessionId, promotionId) {
+        try {
+            const response = await this.apiClient.delete(`/api/v1/checkout-sessions/${checkoutSessionId}/promotions/${promotionId}`);
+            if (response.success) {
+                return { success: true };
+            }
+            else {
+                return { success: false, error: response.error?.message || 'Failed to remove promotion' };
+            }
+        }
+        catch (err) {
+            // Try to extract error message from API response
+            let errorMessage = 'Failed to remove promotion';
+            if (err && typeof err === 'object' && 'response' in err) {
+                const apiError = err;
+                if (apiError.response?.data?.error?.message) {
+                    errorMessage = apiError.response.data.error.message;
+                }
+                else if (apiError.response?.data?.message) {
+                    errorMessage = apiError.response.data.message;
+                }
+            }
+            return { success: false, error: errorMessage };
+        }
+    }
+    /**
+     * Validate a promotion code without applying it
+     */
+    async validatePromotionCode(checkoutSessionId, code) {
+        try {
+            const response = await this.apiClient.post(`/api/v1/checkout-sessions/${checkoutSessionId}/promotions/validate`, { code: code.trim() });
+            return response;
+        }
+        catch {
+            return {
+                isValid: false,
+                code: code.trim(),
+                error: 'Failed to validate promotion code',
+            };
+        }
+    }
+}

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

@@ -0,0 +1,23 @@
+/**
+ * Threeds Resource Client
+ * Axios-based API client for 3DS endpoints
+ */
+import { ApiClient } from './apiClient';
+export interface ThreedsSession {
+    id: string;
+    sessionId: string;
+    provider: string;
+}
+export interface CreateSessionRequest {
+    provider: string;
+    sessionData: any;
+    paymentInstrumentId: string;
+}
+export declare class ThreedsResource {
+    private apiClient;
+    constructor(apiClient: ApiClient);
+    /**
+     * Create a 3DS session
+     */
+    createSession(request: CreateSessionRequest): Promise<ThreedsSession>;
+}

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

@@ -0,0 +1,15 @@
+/**
+ * Threeds Resource Client
+ * Axios-based API client for 3DS endpoints
+ */
+export class ThreedsResource {
+    constructor(apiClient) {
+        this.apiClient = apiClient;
+    }
+    /**
+     * Create a 3DS session
+     */
+    async createSession(request) {
+        return this.apiClient.post('/api/v1/threeds/create-session', request);
+    }
+}

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

@@ -0,0 +1,24 @@
+/**
+ * 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, };
+export declare class CheckoutUtils {
+    /**
+     * Get checkout session ID
+     */
+    static getCheckoutSessionId(checkoutData: CheckoutData): string;
+    /**
+     * Get checkout line items
+     */
+    static getLineItems(checkoutData: CheckoutData): CheckoutLineItem[];
+    /**
+     * Get checkout total
+     */
+    static getTotal(checkoutData: CheckoutData): number;
+    /**
+     * Check if customer is club member
+     */
+    static isClubMember(checkoutData: CheckoutData): boolean;
+}

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

@@ -0,0 +1,30 @@
+/**
+ * Checkout Utility Functions
+ * Pure functions for checkout data manipulation
+ */
+export class CheckoutUtils {
+    /**
+     * Get checkout session ID
+     */
+    static getCheckoutSessionId(checkoutData) {
+        return checkoutData.checkoutSession?.id || '';
+    }
+    /**
+     * Get checkout line items
+     */
+    static getLineItems(checkoutData) {
+        return checkoutData.checkoutSession?.lineItems || [];
+    }
+    /**
+     * Get checkout total
+     */
+    static getTotal(checkoutData) {
+        return checkoutData.checkoutSession?.totalPrice || 0;
+    }
+    /**
+     * Check if customer is club member
+     */
+    static isClubMember(checkoutData) {
+        return checkoutData.customerIsClubMember || false;
+    }
+}

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

@@ -0,0 +1,28 @@
+/**
+ * Currency Utility Functions
+ * Pure functions for currency management
+ */
+export interface Currency {
+    code: string;
+    symbol: string;
+    name: string;
+    decimalPlaces: number;
+}
+export declare class CurrencyUtils {
+    /**
+     * Get currency from context or fallback to default
+     */
+    static getCurrency(context: any, defaultCurrency?: string): Currency;
+    /**
+     * Get currency symbol
+     */
+    static getCurrencySymbol(code: string): string;
+    /**
+     * Get currency name
+     */
+    static getCurrencyName(code: string): string;
+    /**
+     * Get decimal places for currency
+     */
+    static getDecimalPlaces(code: string): number;
+}

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

@@ -0,0 +1,272 @@
+/**
+ * Currency Utility Functions
+ * Pure functions for currency management
+ */
+export class CurrencyUtils {
+    /**
+     * Get currency from context or fallback to default
+     */
+    static getCurrency(context, defaultCurrency = 'USD') {
+        // Handle case where context.currency might be a Currency object or string
+        let currencyCode;
+        if (typeof context?.currency === 'string') {
+            currencyCode = context.currency;
+        }
+        else if (context?.currency?.code) {
+            currencyCode = context.currency.code;
+        }
+        else if (context?.store?.presentmentCurrencies?.[0]) {
+            currencyCode = context.store.presentmentCurrencies[0];
+        }
+        else {
+            currencyCode = defaultCurrency;
+        }
+        return {
+            code: currencyCode,
+            symbol: this.getCurrencySymbol(currencyCode),
+            name: this.getCurrencyName(currencyCode),
+            decimalPlaces: this.getDecimalPlaces(currencyCode),
+        };
+    }
+    /**
+     * Get currency symbol
+     */
+    static getCurrencySymbol(code) {
+        const symbols = {
+            USD: '$',
+            EUR: '€',
+            GBP: '£',
+            JPY: '¥',
+            CAD: 'C$',
+            AUD: 'A$',
+            CHF: 'CHF',
+            CNY: '¥',
+            SEK: 'kr',
+            NOK: 'kr',
+            DKK: 'kr',
+            PLN: 'zł',
+            CZK: 'Kč',
+            HUF: 'Ft',
+            RON: 'lei',
+            BGN: 'лв',
+            HRK: 'kn',
+            RUB: '₽',
+            UAH: '₴',
+            TRY: '₺',
+            BRL: 'R$',
+            ARS: '$',
+            CLP: '$',
+            COP: '$',
+            MXN: '$',
+            PEN: 'S/',
+            UYU: '$U',
+            VEF: 'Bs',
+            ZAR: 'R',
+            EGP: '£',
+            MAD: 'د.م.',
+            TND: 'د.ت',
+            DZD: 'د.ج',
+            LYD: 'ل.د',
+            NGN: '₦',
+            GHS: '₵',
+            KES: 'KSh',
+            UGX: 'USh',
+            TZS: 'TSh',
+            ETB: 'Br',
+            ZMW: 'ZK',
+            BWP: 'P',
+            SZL: 'L',
+            LSL: 'L',
+            NAD: 'N$',
+            MUR: '₨',
+            SCR: '₨',
+            KWD: 'د.ك',
+            BHD: 'د.ب',
+            QAR: 'ر.ق',
+            AED: 'د.إ',
+            OMR: 'ر.ع.',
+            YER: '﷼',
+            SAR: 'ر.س',
+            JOD: 'د.ا',
+            LBP: 'ل.ل',
+            ILS: '₪',
+            INR: '₹',
+            PKR: '₨',
+            BDT: '৳',
+            LKR: '₨',
+            NPR: '₨',
+            AFN: '؋',
+            KZT: '₸',
+            UZS: 'лв',
+            KGS: 'лв',
+            TJS: 'SM',
+            TMT: 'T',
+            AZN: '₼',
+            GEL: '₾',
+            AMD: '֏',
+            KRW: '₩',
+            THB: '฿',
+            VND: '₫',
+            IDR: 'Rp',
+            MYR: 'RM',
+            SGD: 'S$',
+            PHP: '₱',
+            TWD: 'NT$',
+            HKD: 'HK$',
+            MOP: 'MOP$',
+            BND: 'B$',
+            LAK: '₭',
+            KHR: '៛',
+            MMK: 'K',
+            BOB: 'Bs',
+            PYG: '₲',
+            GTQ: 'Q',
+            HNL: 'L',
+            NIO: 'C$',
+            CRC: '₡',
+            PAB: 'B/.',
+            DOP: 'RD$',
+            JMD: 'J$',
+            TTD: 'TT$',
+            BBD: 'Bds$',
+            XCD: 'EC$',
+            AWG: 'ƒ',
+            ANG: 'ƒ',
+            SRD: '$',
+            GYD: 'G$',
+            VES: 'Bs.S',
+            VED: 'Bs.D',
+        };
+        return symbols[code] || code;
+    }
+    /**
+     * Get currency name
+     */
+    static getCurrencyName(code) {
+        const names = {
+            USD: 'US Dollar',
+            EUR: 'Euro',
+            GBP: 'British Pound',
+            JPY: 'Japanese Yen',
+            CAD: 'Canadian Dollar',
+            AUD: 'Australian Dollar',
+            CHF: 'Swiss Franc',
+            CNY: 'Chinese Yuan',
+            SEK: 'Swedish Krona',
+            NOK: 'Norwegian Krone',
+            DKK: 'Danish Krone',
+            PLN: 'Polish Zloty',
+            CZK: 'Czech Koruna',
+            HUF: 'Hungarian Forint',
+            RON: 'Romanian Leu',
+            BGN: 'Bulgarian Lev',
+            HRK: 'Croatian Kuna',
+            RUB: 'Russian Ruble',
+            UAH: 'Ukrainian Hryvnia',
+            TRY: 'Turkish Lira',
+            BRL: 'Brazilian Real',
+            ARS: 'Argentine Peso',
+            CLP: 'Chilean Peso',
+            COP: 'Colombian Peso',
+            MXN: 'Mexican Peso',
+            PEN: 'Peruvian Sol',
+            UYU: 'Uruguayan Peso',
+            VEF: 'Venezuelan Bolivar',
+            ZAR: 'South African Rand',
+            EGP: 'Egyptian Pound',
+            MAD: 'Moroccan Dirham',
+            TND: 'Tunisian Dinar',
+            DZD: 'Algerian Dinar',
+            LYD: 'Libyan Dinar',
+            NGN: 'Nigerian Naira',
+            GHS: 'Ghanaian Cedi',
+            KES: 'Kenyan Shilling',
+            UGX: 'Ugandan Shilling',
+            TZS: 'Tanzanian Shilling',
+            ETB: 'Ethiopian Birr',
+            ZMW: 'Zambian Kwacha',
+            BWP: 'Botswana Pula',
+            SZL: 'Swazi Lilangeni',
+            LSL: 'Lesotho Loti',
+            NAD: 'Namibian Dollar',
+            MUR: 'Mauritian Rupee',
+            SCR: 'Seychellois Rupee',
+            KWD: 'Kuwaiti Dinar',
+            BHD: 'Bahraini Dinar',
+            QAR: 'Qatari Riyal',
+            AED: 'UAE Dirham',
+            OMR: 'Omani Rial',
+            YER: 'Yemeni Rial',
+            SAR: 'Saudi Riyal',
+            JOD: 'Jordanian Dinar',
+            LBP: 'Lebanese Pound',
+            ILS: 'Israeli Shekel',
+            INR: 'Indian Rupee',
+            PKR: 'Pakistani Rupee',
+            BDT: 'Bangladeshi Taka',
+            LKR: 'Sri Lankan Rupee',
+            NPR: 'Nepalese Rupee',
+            AFN: 'Afghan Afghani',
+            KZT: 'Kazakhstani Tenge',
+            UZS: 'Uzbekistani Som',
+            KGS: 'Kyrgyzstani Som',
+            TJS: 'Tajikistani Somoni',
+            TMT: 'Turkmenistani Manat',
+            AZN: 'Azerbaijani Manat',
+            GEL: 'Georgian Lari',
+            AMD: 'Armenian Dram',
+            KRW: 'South Korean Won',
+            THB: 'Thai Baht',
+            VND: 'Vietnamese Dong',
+            IDR: 'Indonesian Rupiah',
+            MYR: 'Malaysian Ringgit',
+            SGD: 'Singapore Dollar',
+            PHP: 'Philippine Peso',
+            TWD: 'Taiwan Dollar',
+            HKD: 'Hong Kong Dollar',
+            MOP: 'Macanese Pataca',
+            BND: 'Brunei Dollar',
+            LAK: 'Lao Kip',
+            KHR: 'Cambodian Riel',
+            MMK: 'Myanmar Kyat',
+            BOB: 'Bolivian Boliviano',
+            PYG: 'Paraguayan Guarani',
+            GTQ: 'Guatemalan Quetzal',
+            HNL: 'Honduran Lempira',
+            NIO: 'Nicaraguan Cordoba',
+            CRC: 'Costa Rican Colon',
+            PAB: 'Panamanian Balboa',
+            DOP: 'Dominican Peso',
+            JMD: 'Jamaican Dollar',
+            TTD: 'Trinidad and Tobago Dollar',
+            BBD: 'Barbadian Dollar',
+            XCD: 'East Caribbean Dollar',
+            AWG: 'Aruban Florin',
+            ANG: 'Netherlands Antillean Guilder',
+            SRD: 'Surinamese Dollar',
+            GYD: 'Guyanese Dollar',
+            VES: 'Venezuelan Bolivar Soberano',
+            VED: 'Venezuelan Bolivar Digital',
+        };
+        return names[code] || code;
+    }
+    /**
+     * Get decimal places for currency
+     */
+    static getDecimalPlaces(code) {
+        const decimalPlaces = {
+            JPY: 0,
+            KRW: 0,
+            VND: 0,
+            IDR: 0,
+            LAK: 0,
+            KHR: 0,
+            MMK: 0,
+            PYG: 0,
+            VEF: 0,
+            VES: 0,
+            VED: 0,
+        };
+        return decimalPlaces[code] ?? 2;
+    }
+}

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

@@ -0,0 +1,12 @@
+/**
+ * Core Utility Functions
+ * Pure functions without React dependencies
+ */
+export * from './products';
+export * from './order';
+export * from './currency';
+export * from './pluginConfig';
+export * from './checkout';
+export * from './promotions';
+export * from './postPurchases';
+export * from './orderBump';

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

@@ -0,0 +1,12 @@
+/**
+ * Core Utility Functions
+ * Pure functions without React dependencies
+ */
+export * from './products';
+export * from './order';
+export * from './currency';
+export * from './pluginConfig';
+export * from './checkout';
+export * from './promotions';
+export * from './postPurchases';
+export * from './orderBump';

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

@@ -0,0 +1,159 @@
+/**
+ * Order Utility Functions
+ * Pure functions for order data manipulation
+ */
+export interface OrderLineItem {
+    id: string;
+    orderId: string;
+    productId: string;
+    variantId: string;
+    priceId: string;
+    sku: string;
+    unitAmount: number;
+    quantity: number;
+    amount: number;
+    adjustedAmount: number;
+    currency: string;
+    adjustments?: Record<string, unknown>[];
+    recurring: boolean;
+    rebillMode?: string | null;
+    rebillStepIntervalMs?: number | null;
+    interval: string;
+    intervalCount: number;
+    totalBillingCycles: number;
+    unitAmountAfterFirstCycle: number;
+    subscriptionSettings?: Record<string, unknown> | null;
+    orderLineItemProduct: {
+        id: string;
+        name: string;
+        description: string;
+        storefrontProductId: string;
+        originalProductId: string;
+        orderLineItemId: string;
+    };
+    orderLineItemVariant: {
+        id: string;
+        name: string;
+        price: number | null;
+        currency: string | null;
+        imageUrl: string;
+        description: string | null;
+        storefrontVariantId: string | null;
+        originalVariantId: string;
+        orderLineItemId: string;
+    };
+}
+export interface Order {
+    id: string;
+    storeId: string;
+    accountId: string;
+    createdAt: string;
+    updatedAt: string;
+    status: string;
+    cancelledAt?: string | null;
+    cancelledReason?: string | null;
+    paidAt?: string | null;
+    paidAmount: number;
+    openAt: string;
+    abandonedAt?: string | null;
+    currency: string;
+    externalCustomerType?: string | null;
+    externalCustomerId?: string | null;
+    externalOrderId?: string | null;
+    billingAddress?: {
+        company: string;
+        firstName: string;
+        lastName: string;
+        address1: string;
+        city: string;
+        country: string;
+        state: string;
+        postal: string;
+        phone: string;
+        email?: string;
+    };
+    shippingAddress?: {
+        company: string;
+        firstName: string;
+        lastName: string;
+        address1: string;
+        city: string;
+        country: string;
+        state: string;
+        postal: string;
+        phone: string;
+    };
+    pickupAddress?: Record<string, unknown> | null;
+    taxesIncluded: boolean;
+    draft: boolean;
+    checkoutSessionId: string;
+    sessionHash: string;
+    customerId: string;
+    createdFrom: string;
+    paymentInstrumentId: string;
+    refundedAt?: string | null;
+    refundedAmount?: number | null;
+    metadata?: any;
+    customer?: {
+        id: string;
+        email: string;
+        firstName: string;
+        lastName: string;
+        externalCustomerId?: string | null;
+        lastOrderId: string;
+        accountId: string;
+        storeId: string;
+        billingAddress?: any;
+        shippingAddress?: any;
+        currency: string;
+        locale: string;
+        draft: boolean;
+        acceptsMarketing: boolean;
+        createdAt: string;
+        updatedAt: string;
+        metadata?: any;
+        device?: Record<string, unknown> | null;
+    };
+    items: OrderLineItem[];
+    summaries?: any[];
+    promotions?: any[];
+    checkoutSession?: {
+        id: string;
+        selectedPresentmentCurrency?: string;
+        [key: string]: any;
+    };
+    payments?: any[];
+    subscriptions?: any[];
+    store?: {
+        name: string;
+        chargeCurrencies: string[];
+        presentmentCurrencies: string[];
+    };
+    relatedOrders?: Order[];
+}
+export declare class OrderUtils {
+    /**
+     * Get order line items
+     */
+    static getOrderLineItems(order: Order): OrderLineItem[];
+    /**
+     * Get order total
+     */
+    static getOrderTotal(order: Order): number;
+    /**
+     * Get order status
+     */
+    static getOrderStatus(order: Order): string;
+    /**
+     * Check if order is completed
+     */
+    static isOrderCompleted(order: Order): boolean;
+    /**
+     * Check if order is pending
+     */
+    static isOrderPending(order: Order): boolean;
+    /**
+     * Check if order is cancelled
+     */
+    static isOrderCancelled(order: Order): boolean;
+}