@tagadapay/plugin-sdk 2.4.38 → 2.5.0

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

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

@@ -0,0 +1,42 @@
+/**
+ * Order Utility Functions
+ * Pure functions for order data manipulation
+ */
+export class OrderUtils {
+    /**
+     * Get order line items
+     */
+    static getOrderLineItems(order) {
+        return order.items || [];
+    }
+    /**
+     * Get order total
+     */
+    static getOrderTotal(order) {
+        return order.paidAmount || 0;
+    }
+    /**
+     * Get order status
+     */
+    static getOrderStatus(order) {
+        return order.status || 'unknown';
+    }
+    /**
+     * Check if order is completed
+     */
+    static isOrderCompleted(order) {
+        return order.status === 'completed' || order.status === 'fulfilled';
+    }
+    /**
+     * Check if order is pending
+     */
+    static isOrderPending(order) {
+        return order.status === 'pending' || order.status === 'processing';
+    }
+    /**
+     * Check if order is cancelled
+     */
+    static isOrderCancelled(order) {
+        return order.status === 'cancelled' || order.status === 'refunded';
+    }
+}

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

@@ -0,0 +1,40 @@
+/**
+ * Order Bump Utility Functions
+ * Pure functions for order bump data manipulation
+ */
+export interface OrderBumpOffer {
+    id: string;
+    name: string;
+    description: string;
+    price: number;
+    currency: string;
+    imageUrl?: string;
+    isSelected?: boolean;
+}
+export interface OrderBumpPreview {
+    offer: OrderBumpOffer;
+    totalAmount: number;
+    adjustedAmount: number;
+}
+export declare class OrderBumpUtils {
+    /**
+     * Check if order bump offer is valid
+     */
+    static isValidOffer(offer: OrderBumpOffer): boolean;
+    /**
+     * Toggle order bump selection
+     */
+    static toggleSelection(offer: OrderBumpOffer): OrderBumpOffer;
+    /**
+     * Calculate order bump preview
+     */
+    static calculatePreview(offer: OrderBumpOffer, baseAmount?: number): OrderBumpPreview;
+    /**
+     * Get selected order bumps
+     */
+    static getSelectedOffers(offers: OrderBumpOffer[]): OrderBumpOffer[];
+    /**
+     * Get total for selected order bumps
+     */
+    static getSelectedTotal(offers: OrderBumpOffer[]): number;
+}

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

@@ -0,0 +1,47 @@
+/**
+ * Order Bump Utility Functions
+ * Pure functions for order bump data manipulation
+ */
+export class OrderBumpUtils {
+    /**
+     * Check if order bump offer is valid
+     */
+    static isValidOffer(offer) {
+        return !!(offer.id && offer.name && offer.price > 0);
+    }
+    /**
+     * Toggle order bump selection
+     */
+    static toggleSelection(offer) {
+        return {
+            ...offer,
+            isSelected: !offer.isSelected,
+        };
+    }
+    /**
+     * Calculate order bump preview
+     */
+    static calculatePreview(offer, baseAmount = 0) {
+        const totalAmount = baseAmount + offer.price;
+        const adjustedAmount = offer.isSelected ? totalAmount : baseAmount;
+        return {
+            offer,
+            totalAmount,
+            adjustedAmount,
+        };
+    }
+    /**
+     * Get selected order bumps
+     */
+    static getSelectedOffers(offers) {
+        return offers.filter(offer => offer.isSelected);
+    }
+    /**
+     * Get total for selected order bumps
+     */
+    static getSelectedTotal(offers) {
+        return offers
+            .filter(offer => offer.isSelected)
+            .reduce((total, offer) => total + offer.price, 0);
+    }
+}

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

@@ -0,0 +1,43 @@
+/**
+ * Plugin Configuration Utility Functions
+ * Pure functions for plugin configuration management
+ */
+export interface PluginConfig<TConfig = Record<string, any>> {
+    storeId?: string;
+    accountId?: string;
+    basePath?: string;
+    config?: TConfig;
+    productId?: string;
+    variants?: Record<string, string>;
+    prices?: Record<string, any>;
+    defaultCurrency?: string;
+    hidePriceId?: string;
+    upsellId?: string;
+    googleApiKey?: string;
+    branding?: any;
+}
+export interface RawPluginConfig<TConfig = Record<string, any>> {
+    storeId?: string;
+    accountId?: string;
+    basePath?: string;
+    config?: TConfig;
+}
+/**
+ * Core plugin config loading function
+ * Handles local dev, production, and raw config
+ */
+export declare const loadPluginConfig: (configVariant?: string, rawConfig?: RawPluginConfig) => Promise<PluginConfig>;
+export declare class PluginConfigUtils {
+    /**
+     * Get plugin configuration from various sources
+     */
+    static getPluginConfig<TConfig = Record<string, any>>(rawConfig?: RawPluginConfig<TConfig>, context?: {
+        storeId?: string;
+        accountId?: string;
+        basePath?: string;
+    }): PluginConfig<TConfig>;
+    /**
+     * Validate plugin configuration
+     */
+    static validateConfig(config: PluginConfig): boolean;
+}