b2b-platform-utils 1.1.8 → 1.1.9

package/amountFormat.js

@@ -0,0 +1,97 @@
+'use strict';
+
+/**
+ * @module amountFormat
+ * @description
+ * Utility for consistent conversion between major (e.g. 17.00 EUR)
+ * and minor units (e.g. 1700 cents).
+ *
+ * All conversions are currency-aware and respect currency exponents:
+ * EUR/USD/GBP → 2 decimals, JPY → 0 decimals, KWD → 3 decimals.
+ */
+
+const { getBaseCurrency } = require('./localCache');
+
+/**
+ * Convert minor units (e.g. 1700) to major amount (e.g. 17.00)
+ *
+ * @param {number|string} amount - Minor amount in integer form.
+ * @param {string} [currency=getBaseCurrency()] - ISO 4217 currency code.
+ * @returns {number} Major amount.
+ * @throws {Error} If amount is not numeric.
+ */
+function toMajorAmount(amount, currency = getBaseCurrency()) {
+    if (amount == null) return 0;
+
+    const exponent = getCurrencyExponent(currency);
+    const num = Number(amount);
+
+    if (!Number.isFinite(num)) {
+        throw new Error('Invalid amount');
+    }
+
+    // Avoid unnecessary floating-point drift.
+    const factor = Math.pow(10, exponent);
+    const major = num / factor;
+
+    return parseFloat(major.toFixed(exponent));
+}
+
+/**
+ * Convert major amount (e.g. 17.00) to minor units (e.g. 1700)
+ *
+ * @param {number|string} amount - Major amount.
+ * @param {string} [currency=getBaseCurrency()] - ISO 4217 currency code.
+ * @returns {number} Minor amount as integer.
+ * @throws {Error} If amount is missing or invalid.
+ */
+function toMinorAmount(amount, currency = getBaseCurrency()) {
+    if (amount == null) {
+        throw new Error('Amount is required');
+    }
+
+    const exponent = getCurrencyExponent(currency);
+    const normalized = String(amount).replace(',', '.'); // support "17,5"
+    const num = Number(normalized);
+
+    if (!Number.isFinite(num)) {
+        throw new Error('Invalid amount');
+    }
+
+    const fixed = num.toFixed(exponent);
+    // Using Math.round avoids string replace for integers like 0 decimals
+    const minor = Math.round(num * Math.pow(10, exponent));
+
+    // fallback to parsed integer if rounding is not safe
+    return Number.isSafeInteger(minor)
+        ? minor
+        : parseInt(fixed.replace('.', ''), 10);
+}
+
+/**
+ * Return decimal exponent for currency.
+ *
+ * @param {string} currency - ISO 4217 currency code.
+ * @returns {number} Number of decimal places (default = 2).
+ */
+function getCurrencyExponent(currency) {
+    const map = {
+        EUR: 2,
+        USD: 2,
+        GBP: 2,
+        CHF: 2,
+        JPY: 0,
+        KWD: 3
+    };
+
+    const code = typeof currency === 'string'
+        ? currency.trim().toUpperCase()
+        : '';
+
+    return map[code] ?? 2;
+}
+
+module.exports = {
+    toMajorAmount,
+    toMinorAmount
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "b2b-platform-utils",
-  "version": "1.1.8",
+  "version": "1.1.9",
   "description": "Shared utilities for Node.js microservices: errors map, local cache, logger, numbers, dates, filesystem, media optimization, paginator, slugger, crypto wrapper, sanitize HTML, sorting.",
   "type": "commonjs",
   "license": "KingSizer",