@temboplus/frontend-core 0.2.7 → 0.2.9

package/esm/src/models/currency/currency.js

@@ -27,6 +27,7 @@
  * dependencies are best managed in a unified module.
  */
 import file from "../../data/currencies.js";
+import { isCurrencyCode } from "./utils.js";
 /**
  * Represents a currency with essential details.
  * @class Currency
@@ -39,7 +40,7 @@ export class Currency {
      * @param {string} _symbolNative - The native symbol of the currency
      * @param {number} _decimalDigits - Number of decimal places typically used with this currency
      * @param {number} _rounding - Rounding increment used for this currency
-     * @param {string} _code - The ISO 4217 currency code
+     * @param {CurrencyCode} _code - The ISO 4217 currency code
      * @param {string} _namePlural - The plural form of the currency name
      */
     constructor(_symbol, _name, _symbolNative, _decimalDigits, _rounding, _code, _namePlural) {
@@ -188,23 +189,41 @@ export class Currency {
         return !!currency;
     }
     /**
-     * Attempts to create a Currency instance from a currency name or ISO code
-     * @param input The currency name or ISO code
-     * @returns A Currency instance if valid input, undefined otherwise
+     * Attempts to create a Currency instance from a currency name or ISO code string.
+     * The `CurrencyCode` type provides type hints for valid ISO codes but resolves to `string`.
+     * @param input The currency name or ISO code string.
+     * @returns A Currency instance if valid input, undefined otherwise.
      */
     static from(input) {
-        if (!input || typeof input !== "string")
+        // Handle null or undefined input explicitly
+        if (!input || typeof input === "object") {
             return undefined;
+        }
+        // Input is guaranteed to be a string here. Trim whitespace.
         const text = input.trim();
-        if (text.length === 0)
+        // Check for empty string after trimming
+        if (text.length === 0) {
             return undefined;
-        // deno-lint-ignore no-explicit-any
-        const currency1 = Currency.fromCode(text);
-        if (currency1)
-            return currency1;
-        const currency2 = Currency.fromName(text);
-        if (currency2)
-            return currency2;
+        }
+        // Check if the input string matches a known CurrencyCode
+        if (isCurrencyCode(text)) {
+            // If it's a valid code format, try creating from code.
+            // 'text' is now known to be of type CurrencyCode within this block.
+            const currency = Currency.fromCode(text);
+            // Return if successful. Note: fromCode itself might return undefined
+            // even for a valid code if it's e.g., not supported/enabled.
+            if (currency) {
+                return currency;
+            }
+        }
+        // If input wasn't a valid CurrencyCode recognized by the type guard,
+        // OR if isCurrencyCode returned true but Currency.fromCode(text) returned undefined,
+        // then try interpreting the original input string as a name.
+        const currencyFromName = Currency.fromName(text);
+        if (currencyFromName) {
+            return currencyFromName;
+        }
+        // If neither code nor name interpretation worked
         return undefined;
     }
     /**
@@ -288,7 +307,16 @@ export class CurrencyService {
     initialize() {
         try {
             const data = JSON.parse(JSON.stringify(file));
-            const currencies = Object.values(data).map((c) => new Currency(c.symbol, c.name, c.symbol_native, c.decimal_digits, c.rounding, c.code, c.name_plural));
+            const currencies = Object.values(data).map(function (c) {
+                let code;
+                if (isCurrencyCode(c.code)) {
+                    code = c.code;
+                }
+                else {
+                    throw new Error(`Unknown currency code: ${c.code}`);
+                }
+                return new Currency(c.symbol, c.name, c.symbol_native, c.decimal_digits, c.rounding, code, c.name_plural);
+            });
             const codeRecord = {};
             const nameRecord = {};
             currencies.forEach((currency) => {

package/esm/src/models/currency/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./currency.js";
 export * from "./types.js";
+export * from "./utils.js";
 //# sourceMappingURL=index.d.ts.map

package/esm/src/models/currency/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/models/currency/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/models/currency/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA"}

package/esm/src/models/currency/index.js

@@ -1,2 +1,3 @@
 export * from "./currency.js";
 export * from "./types.js";
+export * from "./utils.js";

package/esm/src/models/currency/types.d.ts

@@ -16,5 +16,6 @@
  * These three-letter codes represent currencies based on the ISO 4217 standard.
  * Example: "USD" for US Dollar, "EUR" for Euro, "JPY" for Japanese Yen
  */
-export type CurrencyCode = "USD" | "CAD" | "EUR" | "AED" | "AFN" | "ALL" | "AMD" | "ARS" | "AUD" | "AZN" | "BAM" | "BDT" | "BGN" | "BHD" | "BIF" | "BND" | "BOB" | "BRL" | "BWP" | "BYN" | "BZD" | "CDF" | "CHF" | "CLP" | "CNY" | "COP" | "CRC" | "CVE" | "CZK" | "DJF" | "DKK" | "DOP" | "DZD" | "EEK" | "EGP" | "ERN" | "ETB" | "GBP" | "GEL" | "GHS" | "GNF" | "GTQ" | "HKD" | "HNL" | "HRK" | "HUF" | "IDR" | "ILS" | "INR" | "IQD" | "IRR" | "ISK" | "JMD" | "JOD" | "JPY" | "KES" | "KHR" | "KMF" | "KRW" | "KWD" | "KZT" | "LBP" | "LKR" | "LTL" | "LVL" | "LYD" | "MAD" | "MDL" | "MGA" | "MKD" | "MMK" | "MOP" | "MUR" | "MXN" | "MYR" | "MZN" | "NAD" | "NGN" | "NIO" | "NOK" | "NPR" | "NZD" | "OMR" | "PAB" | "PEN" | "PHP" | "PKR" | "PLN" | "PYG" | "QAR" | "RON" | "RSD" | "RUB" | "RWF" | "SAR" | "SDG" | "SEK" | "SGD" | "SOS" | "SYP" | "THB" | "TND" | "TOP" | "TRY" | "TTD" | "TWD" | "TZS" | "UAH" | "UGX" | "UYU" | "UZS" | "VEF" | "VND" | "XAF" | "XOF" | "YER" | "ZAR" | "ZMK" | "ZWL";
+export type CurrencyCode = "USD" | "CAD" | "EUR" | "AED" | "AFN" | "ALL" | "AMD" | "ARS" | "AUD" | "AZN" | "BAM" | "BDT" | "BGN" | "BHD" | "BIF" | "BND" | "BOB" | "BRL" | "BWP" | "BYN" | "BZD" | "CDF" | "CHF" | "CLP" | "CNY" | "COP" | "CRC" | "CVE" | "CZK" | "DJF" | "DKK" | "DOP" | "DZD" | "EGP" | "ERN" | "ETB" | "GBP" | "GEL" | "GHS" | "GNF" | "GTQ" | "HKD" | "HNL" | "HRK" | "HUF" | "IDR" | "ILS" | "INR" | "IQD" | "IRR" | "ISK" | "JMD" | "JOD" | "JPY" | "KES" | "KHR" | "KMF" | "KRW" | "KWD" | "KZT" | "LBP" | "LKR" | "LYD" | "MAD" | "MDL" | "MGA" | "MKD" | "MMK" | "MOP" | "MUR" | "MXN" | "MYR" | "MZN" | "NAD" | "NGN" | "NIO" | "NOK" | "NPR" | "NZD" | "OMR" | "PAB" | "PEN" | "PHP" | "PKR" | "PLN" | "PYG" | "QAR" | "RON" | "RSD" | "RUB" | "RWF" | "SAR" | "SDG" | "SEK" | "SGD" | "SOS" | "SSP" | "SYP" | "THB" | "TND" | "TOP" | "TRY" | "TTD" | "TWD" | "TZS" | "UAH" | "UGX" | "UYU" | "UZS" | "VES" | "VND" | "XAF" | "XOF" | "YER" | "ZAR" | "ZMW" | "STN" | "MRU" | "ZWG";
+export declare const ValidCurrencyCodesSet: Set<CurrencyCode>;
 //# sourceMappingURL=types.d.ts.map

package/esm/src/models/currency/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/src/models/currency/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GACpB,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GACrE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GACrE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GACrE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GACrE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GACrE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GACrE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GACrE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GACrE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GACrE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GACrE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GACrE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GACrE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GACrE,KAAK,GAAG,KAAK,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/src/models/currency/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GACpB,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GACrE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GACrE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GACrE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GACrE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GACrE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GACrE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GACrE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GACrE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GACrE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GACrE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GACrE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GACrE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GACrE,KAAK,GAAG,KAAK,CAAC;AAElB,eAAO,MAAM,qBAAqB,mBAehC,CAAC"}

package/esm/src/models/currency/types.js

@@ -10,4 +10,19 @@
  * - Autocompletion in modern IDEs
  * - Protection against typos and invalid values
  */
-export {};
+export const ValidCurrencyCodesSet = new Set([
+    "USD", "CAD", "EUR", "AED", "AFN", "ALL", "AMD", "ARS", "AUD",
+    "AZN", "BAM", "BDT", "BGN", "BHD", "BIF", "BND", "BOB", "BRL",
+    "BWP", "BYN", "BZD", "CDF", "CHF", "CLP", "CNY", "COP", "CRC",
+    "CVE", "CZK", "DJF", "DKK", "DOP", "DZD", "EGP", "ERN", "ETB",
+    "GBP", "GEL", "GHS", "GNF", "GTQ", "HKD", "HNL", "HRK", "HUF",
+    "IDR", "ILS", "INR", "IQD", "IRR", "ISK", "JMD", "JOD", "JPY",
+    "KES", "KHR", "KMF", "KRW", "KWD", "KZT", "LBP", "LKR", "LYD",
+    "MAD", "MDL", "MGA", "MKD", "MMK", "MOP", "MUR", "MXN", "MYR",
+    "MZN", "NAD", "NGN", "NIO", "NOK", "NPR", "NZD", "OMR", "PAB",
+    "PEN", "PHP", "PKR", "PLN", "PYG", "QAR", "RON", "RSD", "RUB",
+    "RWF", "SAR", "SDG", "SEK", "SGD", "SOS", "SSP", "SYP", "THB",
+    "TND", "TOP", "TRY", "TTD", "TWD", "TZS", "UAH", "UGX", "UYU",
+    "UZS", "VES", "VND", "XAF", "XOF", "YER", "ZAR", "ZMW", "STN",
+    "MRU", "ZWG"
+]);

package/esm/src/models/currency/utils.d.ts

@@ -0,0 +1,8 @@
+import type { CurrencyCode } from "./types.js";
+/**
+ * Type guard to check if a string is a valid CurrencyCode.
+ * @param code The string to check.
+ * @returns True if the string is a member of the CurrencyCode union type, false otherwise.
+ */
+export declare function isCurrencyCode(code: string): code is CurrencyCode;
+//# sourceMappingURL=utils.d.ts.map

package/esm/src/models/currency/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/src/models/currency/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,YAAY,CAEjE"}

package/esm/src/models/currency/utils.js

@@ -0,0 +1,9 @@
+import { ValidCurrencyCodesSet } from "./index.js";
+/**
+ * Type guard to check if a string is a valid CurrencyCode.
+ * @param code The string to check.
+ * @returns True if the string is a member of the CurrencyCode union type, false otherwise.
+ */
+export function isCurrencyCode(code) {
+    return ValidCurrencyCodesSet.has(code);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@temboplus/frontend-core",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "description": "A JavaScript/TypeScript package providing common utilities and logic shared across front-end TemboPlus projects.",
   "repository": {
     "type": "git",