@tagadapay/plugin-sdk 3.1.9 → 3.1.10

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

@@ -8,6 +8,20 @@ export interface Currency {
     name: string;
     decimalPlaces: number;
 }
+/**
+ * Format money amount from minor units (cents) to a formatted string
+ *
+ * @param amountMinorUnits - Amount in minor units (e.g., 12345 for $123.45)
+ * @param currencyCode - ISO 4217 currency code (e.g., "USD", "EUR")
+ * @param locale - Locale for formatting (default: "en-US")
+ * @returns Formatted money string (e.g., "$123.45")
+ *
+ * @example
+ * formatMoney(12345, 'USD') // "$123.45"
+ * formatMoney(10000, 'EUR', 'de-DE') // "100,00 €"
+ * formatMoney(1000, 'JPY') // "¥1,000"
+ */
+export declare function formatMoney(amountMinorUnits: number, currencyCode?: string, locale?: string): string;
 export declare class CurrencyUtils {
     /**
      * Get currency from context or fallback to default

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

@@ -2,6 +2,46 @@
  * Currency Utility Functions
  * Pure functions for currency management
  */
+/**
+ * Format money amount from minor units (cents) to a formatted string
+ *
+ * @param amountMinorUnits - Amount in minor units (e.g., 12345 for $123.45)
+ * @param currencyCode - ISO 4217 currency code (e.g., "USD", "EUR")
+ * @param locale - Locale for formatting (default: "en-US")
+ * @returns Formatted money string (e.g., "$123.45")
+ *
+ * @example
+ * formatMoney(12345, 'USD') // "$123.45"
+ * formatMoney(10000, 'EUR', 'de-DE') // "100,00 €"
+ * formatMoney(1000, 'JPY') // "¥1,000"
+ */
+export function formatMoney(amountMinorUnits, currencyCode = 'USD', locale = 'en-US') {
+    const decimalPlaces = CurrencyUtils.getDecimalPlaces(currencyCode);
+    // Convert minor units to major units
+    // Backend stores amounts with 2 decimal places for all currencies
+    // For currencies with 0 decimal places (JPY, KRW, etc.), divide by 100
+    let value;
+    if (decimalPlaces === 0) {
+        // For zero-decimal currencies, backend still stores with 2 decimals
+        value = amountMinorUnits / 100;
+    }
+    else {
+        value = amountMinorUnits / Math.pow(10, decimalPlaces);
+    }
+    try {
+        return new Intl.NumberFormat(locale, {
+            style: 'currency',
+            currency: currencyCode,
+            minimumFractionDigits: decimalPlaces,
+            maximumFractionDigits: decimalPlaces,
+        }).format(value);
+    }
+    catch {
+        // Fallback if Intl.NumberFormat fails
+        const symbol = CurrencyUtils.getCurrencySymbol(currencyCode);
+        return `${symbol}${value.toFixed(decimalPlaces)}`;
+    }
+}
 export class CurrencyUtils {
     /**
      * Get currency from context or fallback to default

package/dist/v2/standalone/index.js

@@ -19,7 +19,7 @@ export function createTagadaClient(config = {}) {
 // Re-export Core Classes
 export { TagadaClient, ApiClient, CheckoutResource };
 export { FunnelActionType } from '../core/resources/funnel';
-// Re-export Utilities
+// Re-export Utilities (includes formatMoney from core/utils/currency)
 export * from '../core/utils';
 // ============================================================================
 // EXTERNAL PAGE TRACKER

package/package.json

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