@temboplus/frontend-core 0.2.4 → 0.2.6

package/script/src/models/currency/currency.js

@@ -1,7 +1,38 @@
 "use strict";
+/**
+ * @fileoverview This file contains both the Currency class and CurrencyService class.
+ *
+ * ARCHITECTURE NOTE: Currency and CurrencyService Classes
+ * ======================================================
+ *
+ * These two classes have been intentionally placed in the same file to resolve
+ * a circular dependency issue. The original implementation had these in separate files:
+ *
+ * - Currency class: Defines currency properties and static accessors
+ * - CurrencyService class: Loads currency data and provides instance methods
+ *
+ * The circular dependency occurred because:
+ * 1. Currency needed CurrencyService to initialize its static properties
+ * 2. CurrencyService needed Currency to create Currency instances
+ *
+ * Previous attempts to solve this used setTimeout(0) to defer static initialization,
+ * but this created race conditions where static properties weren't immediately available
+ * after import (Currency.AFN would be undefined on first access).
+ *
+ * By combining both classes in a single file:
+ * - We ensure proper initialization order
+ * - All static properties are immediately available after import
+ * - The public API remains unchanged
+ *
+ * This approach follows the principle that closely related classes with circular
+ * dependencies are best managed in a unified module.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Currency = void 0;
-const service_js_1 = require("./service.js");
+exports.CurrencyService = exports.Currency = void 0;
+const currencies_js_1 = __importDefault(require("../../data/currencies.js"));
 /**
  * Represents a currency with essential details.
  * @class Currency
@@ -119,11 +150,11 @@ class Currency {
     }
     /**
      * Retrieves a currency by its ISO code.
-     * @param {string} code The ISO code of the currency.
+     * @param {CurrencyCode} code The ISO code of the currency.
      * @returns {Currency | undefined} The currency corresponding to the ISO code or `undefined` if not found.
      */
     static fromCode(code) {
-        return service_js_1.CurrencyService.getInstance().fromCode(code);
+        return CurrencyService.getInstance().fromCode(code);
     }
     /**
      * Retrieves a currency by its name.
@@ -131,14 +162,14 @@ class Currency {
      * @returns {Currency | undefined} The currency corresponding to the name or `undefined` if not found.
      */
     static fromName(currencyName) {
-        return service_js_1.CurrencyService.getInstance().fromName(currencyName);
+        return CurrencyService.getInstance().fromName(currencyName);
     }
     /**
      * Returns all available currencies.
      * @returns {Currency[]} Array of all currencies
      */
     static getAll() {
-        return service_js_1.CurrencyService.getInstance().getAll();
+        return CurrencyService.getInstance().getAll();
     }
     /**
      * Validates if a given currency code is valid
@@ -173,6 +204,7 @@ class Currency {
         const text = input.trim();
         if (text.length === 0)
             return undefined;
+        // deno-lint-ignore no-explicit-any
         const currency1 = Currency.fromCode(text);
         if (currency1)
             return currency1;
@@ -211,19 +243,209 @@ class Currency {
     }
 }
 exports.Currency = Currency;
+/**
+ * Service for managing currency data.
+ * @class CurrencyService
+ */
+class CurrencyService {
+    constructor() {
+        Object.defineProperty(this, "currencyList", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+        Object.defineProperty(this, "currencyRecord", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: {}
+        });
+        Object.defineProperty(this, "nameRecord", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: {}
+        });
+        // Static references for direct access through Currency class
+        Object.defineProperty(this, "staticReferences", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+    }
+    /**
+     * Gets the singleton instance of CurrencyService.
+     * Creates the instance if it doesn't exist.
+     * @static
+     * @returns {CurrencyService} The singleton instance
+     */
+    static getInstance() {
+        if (!CurrencyService.instance) {
+            CurrencyService.instance = new CurrencyService();
+            CurrencyService.instance.initialize();
+        }
+        return CurrencyService.instance;
+    }
+    /**
+     * Initializes the service with currency data.
+     * Should be called once when your application starts.
+     */
+    initialize() {
+        try {
+            const data = JSON.parse(JSON.stringify(currencies_js_1.default));
+            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 codeRecord = {};
+            const nameRecord = {};
+            currencies.forEach((currency) => {
+                // Populate code record
+                codeRecord[currency.code] = currency;
+                // Add to record by name
+                nameRecord[currency.name.toUpperCase()] = currency;
+                const upperCode = currency.code.toUpperCase();
+                // Add to static references for uppercase code
+                this.staticReferences.set(upperCode, currency);
+                // Add formatted full name static reference based on name property
+                // Transform from "US Dollar" to "US_DOLLAR"
+                const nameKey = currency.name
+                    .toUpperCase()
+                    .replace(/\s+/g, "_")
+                    .replace(/[-(),.']/g, "")
+                    .replace(/&/g, "AND");
+                this.staticReferences.set(nameKey, currency);
+            });
+            this.currencyRecord = codeRecord;
+            this.nameRecord = nameRecord;
+            this.currencyList = currencies;
+        }
+        catch (error) {
+            console.error("Failed to initialize CurrencyService:", error);
+        }
+    }
+    /**
+     * Gets all currencies.
+     * @returns {Currency[]} Array of all currencies
+     */
+    getAll() {
+        return this.currencyList;
+    }
+    /**
+     * Gets all currencies as a record.
+     * @returns {Record<string, Currency>} Record of currency codes and currency objects
+     */
+    getAllAsRecord() {
+        return this.currencyRecord;
+    }
+    /**
+     * Gets static currency references to be used by the Currency class.
+     * @returns {Map<string, Currency>} Map of static references
+     */
+    getStaticReferences() {
+        return this.staticReferences;
+    }
+    /**
+     * Retrieves a currency by its ISO code.
+     * @param {string} code The ISO code of the currency.
+     * @returns {Currency | undefined} The currency corresponding to the ISO code or `undefined` if not found.
+     */
+    fromCode(code) {
+        return this.currencyRecord[code.trim().toUpperCase()];
+    }
+    /**
+     * Retrieves a currency by its name.
+     * @param {string} currencyName The name of the currency.
+     * @returns {Currency | undefined} The currency corresponding to the name or `undefined` if not found.
+     */
+    fromName(currencyName) {
+        const input = currencyName.trim().toUpperCase();
+        // First try direct lookup in name record
+        const directMatch = this.nameRecord[input];
+        if (directMatch)
+            return directMatch;
+        // If not found, try more lenient matching
+        for (const [name, currObj] of Object.entries(this.nameRecord)) {
+            if (name.toUpperCase() === input) {
+                return currObj;
+            }
+        }
+        // Finally, try case-insensitive exact match
+        return this.currencyList.find((currency) => currency.name.toUpperCase() === input);
+    }
+    /**
+     * Validates if a given ISO currency code is valid
+     *
+     * @param {string | null | undefined} code - The currency code to validate.
+     *   Should be a three-letter ISO currency code (e.g., 'USD', 'EUR').
+     *
+     * @returns {boolean} Returns true if:
+     *   - The currency code is not null/undefined
+     *   - The currency code successfully resolves to a valid Currency instance
+     *   Returns false otherwise.
+     */
+    isValidCode(code) {
+        if (!code)
+            return false;
+        const currency = this.fromCode(code);
+        return !!currency;
+    }
+    /**
+     * Validates if a given currency name is valid
+     *
+     * @param {string | null | undefined} currencyName - The currency name to validate.
+     *
+     * @returns {boolean} Returns true if:
+     *   - The currency name is not null/undefined
+     *   - The currency name successfully resolves to a valid Currency instance
+     *   Returns false otherwise.
+     */
+    isValidName(currencyName) {
+        if (!currencyName)
+            return false;
+        const currency = this.fromName(currencyName);
+        return !!currency;
+    }
+    /**
+     * Gets a regex-ready pattern matching all currency symbols
+     * Pattern is memoized for performance
+     * @returns {string} Pipe-separated pattern of escaped currency symbols
+     *
+     * @example
+     * const pattern = currencyService.getCurrencySymbolPattern();
+     * // Returns something like: "\$|€|\£|¥"
+     */
+    getCurrencySymbolPattern() {
+        const symbols = new Set();
+        Object.values(this.currencyList).forEach((currency) => {
+            symbols.add(this.escapeRegExp(currency.symbol));
+            symbols.add(this.escapeRegExp(currency.symbolNative));
+        });
+        return Array.from(symbols).join("|");
+    }
+    /**
+     * Escapes special characters in a string for use in regular expressions
+     * @private
+     * @param {string} string - The string to escape
+     * @returns {string} The escaped string
+     *
+     * @example
+     * private escapeRegExp("$") // Returns "\$"
+     */
+    escapeRegExp(string) {
+        return string.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    }
+}
+exports.CurrencyService = CurrencyService;
 // Initialize static properties by applying the references from CurrencyService.
-// zero-timeout to defer the initialization until after both modules have been fully loaded.
-// The setTimeout pushes the initialization code to the end of the JavaScript event loop,
-// which happens after all modules are loaded.
-setTimeout(() => {
+(function setupStaticReferences() {
     try {
-        const staticRefs = service_js_1.CurrencyService.getInstance().getStaticReferences();
-        staticRefs.forEach((currency, key) => {
+        const refs = CurrencyService.getInstance().getStaticReferences();
+        refs.forEach((country, key) => {
             // deno-lint-ignore no-explicit-any
-            Currency[key] = currency;
+            Currency[key] = country;
         });
     }
     catch (error) {
-        console.error("Failed to initialize Currency static properties:", error);
+        console.log("Failed to set up static references: ", error);
     }
-}, 0);
+})();

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

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

package/script/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,cAAc,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"}

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

@@ -15,4 +15,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./currency.js"), exports);
-__exportStar(require("./service.js"), exports);
+__exportStar(require("./types.js"), exports);

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

@@ -0,0 +1,20 @@
+/**
+ * @fileoverview Type definitions for ISO currency codes
+ *
+ * These types provide type-safe representations of standard ISO codes:
+ * - CurrencyCode: ISO 4217 currency codes
+ *
+ * Benefits:
+ * - Type-safety at compile time
+ * - Zero runtime overhead (compile away to strings)
+ * - Autocompletion in modern IDEs
+ * - Protection against typos and invalid values
+ */
+/**
+ * ISO 4217 currency codes
+ *
+ * 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";
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * @fileoverview Type definitions for ISO currency codes
+ *
+ * These types provide type-safe representations of standard ISO codes:
+ * - CurrencyCode: ISO 4217 currency codes
+ *
+ * Benefits:
+ * - Type-safety at compile time
+ * - Zero runtime overhead (compile away to strings)
+ * - Autocompletion in modern IDEs
+ * - Protection against typos and invalid values
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/script/src/models/phone_number/global/phone_number.d.ts

@@ -16,6 +16,7 @@
  */
 import { Country } from "../../country/country.js";
 import { PhoneNumberFormat } from "../format.js";
+import type { CountryCode, ISO2CountryCode } from "../../country/types.js";
 /**
  * Options for parsing phone numbers
  */
@@ -24,7 +25,7 @@ export interface PhoneNumberParseOptions {
      * Default country to use when a dial code is shared by multiple countries
      * This can be either a Country object or an ISO country code string
      */
-    defaultCountry?: Country | string;
+    defaultCountry?: Country | CountryCode;
     /**
      * Whether to throw an error when encountering an ambiguous phone number
      * with a shared dial code
@@ -54,7 +55,7 @@ export declare class PhoneNumber {
     /**
      * Gets the country code (ISO) of the phone number
      */
-    get countryCode(): string;
+    get countryCode(): ISO2CountryCode;
     /**
      * Gets the dial code (numeric) of the phone number
      */

package/script/src/models/phone_number/global/phone_number.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"phone_number.d.ts","sourceRoot":"","sources":["../../../../../src/src/models/phone_number/global/phone_number.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAKnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAElC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,oCAAoC;IACpC,OAAO,CAAC,QAAQ,CAAU;IAC1B,gEAAgE;IAChE,OAAO,CAAC,cAAc,CAAS;IAE/B;;;;;;OAMG;IACH,OAAO;IAKP;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAKrB;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED;;OAEG;IACH,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED;;;OAGG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;;;;OAKG;IACH,aAAa,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM;IAoBhD;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAI3B;;;OAGG;IACH,OAAO,CAAC,aAAa;IAIrB;;;;;OAKG;IACH,QAAQ,IAAI,OAAO;IAuCnB;;;;;;;;;OASG;WACW,IAAI,CAChB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,uBAAuB,GAChC,WAAW,GAAG,SAAS;IAsG1B;;;;;;;;;;;;;OAaG;WACW,eAAe,CAC3B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,GACf,WAAW,GAAG,SAAS;IA0D1B;;;;;;OAMG;WACW,YAAY,CACxB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,EACrB,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO;IAsBV;;;;;;OAMG;WACW,uBAAuB,CACnC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,EACrB,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,GACvB,OAAO;IAaV;;;;;OAKG;WACW,EAAE,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,WAAW;IA2BlD;;;;;;;;;OASG;WACW,UAAU,CACtB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,GAAG,SAAS;CAwDvB"}
+{"version":3,"file":"phone_number.d.ts","sourceRoot":"","sources":["../../../../../src/src/models/phone_number/global/phone_number.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAKnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;IAEvC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,oCAAoC;IACpC,OAAO,CAAC,QAAQ,CAAU;IAC1B,gEAAgE;IAChE,OAAO,CAAC,cAAc,CAAS;IAE/B;;;;;;OAMG;IACH,OAAO;IAKP;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,eAAe,CAEjC;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAKrB;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED;;OAEG;IACH,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED;;;OAGG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;;;;OAKG;IACH,aAAa,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM;IAoBhD;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAI3B;;;OAGG;IACH,OAAO,CAAC,aAAa;IAIrB;;;;;OAKG;IACH,QAAQ,IAAI,OAAO;IAuCnB;;;;;;;;;OASG;WACW,IAAI,CAChB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,uBAAuB,GAChC,WAAW,GAAG,SAAS;IAsG1B;;;;;;;;;;;;;OAaG;WACW,eAAe,CAC3B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,GACf,WAAW,GAAG,SAAS;IA0D1B;;;;;;OAMG;WACW,YAAY,CACxB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,EACrB,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO;IAsBV;;;;;;OAMG;WACW,uBAAuB,CACnC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,EACrB,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,GACvB,OAAO;IAaV;;;;;OAKG;WACW,EAAE,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,WAAW;IA2BlD;;;;;;;;;OASG;WACW,UAAU,CACtB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,GAAG,SAAS;CAwDvB"}

package/script/src/models/phone_number/global/service.d.ts

@@ -12,6 +12,7 @@
 import { Country } from "../../country/country.js";
 import { PhoneNumber } from "./phone_number.js";
 import { PhoneNumberFormat } from "../format.js";
+import type { ISO2CountryCode } from "../../country/types.js";
 /**
  * Complete metadata for a country's phone number system
  */
@@ -43,11 +44,9 @@ export interface CountryMetadata {
     _source: string;
 }
 /**
- * Mapping of ISO country codes to their phone metadata
+ * Mapping of ISO country codes to their phone metadata using a Map
  */
-type CountryMetadataMap = {
-    [isoCode: string]: CountryMetadata;
-};
+type CountryMetadataMap = Map<ISO2CountryCode, CountryMetadata>;
 /**
  * Phone number pattern type
  */
@@ -74,7 +73,7 @@ export interface DialCodeInfo {
     /** The national number (without the dial code) */
     nationalNumber: string;
     /** List of country codes that use this dial code */
-    possibleCountries: string[];
+    possibleCountries: ISO2CountryCode[];
 }
 /**
  * Error thrown when a phone number has an ambiguous country due to shared dial code
@@ -83,14 +82,14 @@ export declare class SharedDialCodeError extends Error {
     /** The dial code that's shared */
     dialCode: string;
     /** List of country codes that share this dial code */
-    countries: string[];
+    countries: ISO2CountryCode[];
     /**
      * Creates a new SharedDialCodeError
      *
      * @param dialCode - The shared dial code
      * @param countries - Countries that share this dial code
      */
-    constructor(dialCode: string, countries: string[]);
+    constructor(dialCode: string, countries: ISO2CountryCode[]);
 }
 /**
  * Service for managing global phone number operations
@@ -119,14 +118,14 @@ export declare class GlobalPhoneNumberService {
     /**
      * Gets the metadata for a specific country
      *
-     * @param {string} countryCode - The ISO country code
+     * @param {ISO2CountryCode} countryCode - The ISO country code
      * @returns {CountryMetadata | undefined} The country metadata or undefined if not found
      */
-    getCountryMetadata(countryCode: string): CountryMetadata | undefined;
+    getCountryMetadata(countryCode: ISO2CountryCode): CountryMetadata | undefined;
     /**
      * Gets all country metadata
      *
-     * @returns {CountryMetadataMap} All country metadata
+     * @returns {CountryMetadataMap} All country metadata (as a Map)
      */
     getAllCountryMetadata(): CountryMetadataMap;
     /**
@@ -149,7 +148,7 @@ export declare class GlobalPhoneNumberService {
      * @param dialCode - The dial code to look up
      * @returns The country code or undefined if not found
      */
-    getCountryForDialCode(dialCode: string): string | undefined;
+    getCountryForDialCode(dialCode: string): ISO2CountryCode | undefined;
     /**
      * Extracts dial code information from a phone number
      *
@@ -167,21 +166,22 @@ export declare class GlobalPhoneNumberService {
     /**
      * Determines the most likely type of a phone number
      *
-     * @param {string} countryCode - ISO country code
+     * @param {ISO2CountryCode} countryCode - ISO country code
      * @param {string} nationalNumber - The national number to check
      * @returns {PhoneNumberType} The type of the phone number
      */
-    getNumberType(countryCode: string, nationalNumber: string): PhoneNumberType;
+    getNumberType(countryCode: ISO2CountryCode, nationalNumber: string): PhoneNumberType;
     /**
      * Validates a phone number against country-specific patterns
      *
-     * @param {string} countryCode - ISO country code
+     * @param {ISO2CountryCode} countryCode - ISO country code
      * @param {string} nationalNumber - The national number to validate
      * @returns {boolean} True if the phone number is valid, false otherwise
      */
-    validatePattern(countryCode: string, nationalNumber: string): boolean;
+    validatePattern(countryCode: ISO2CountryCode, nationalNumber: string): boolean;
     /**
      * Formats a phone number according to the country's formatting rules
+     * (No changes needed in this method's logic)
      *
      * @param {string} phoneNumber - The phone number to format
      * @param {PhoneNumberFormat} format - The desired format
@@ -190,6 +190,7 @@ export declare class GlobalPhoneNumberService {
     formatNumber(phoneNumber: string, format?: PhoneNumberFormat): string;
     /**
      * Creates a PhoneNumber from an international format string
+     * (No changes needed in this method's logic)
      *
      * @param {string} phoneNumber - The phone number in international format
      * @returns {PhoneNumber | undefined} The parsed phone number or undefined if invalid
@@ -197,14 +198,16 @@ export declare class GlobalPhoneNumberService {
     parsePhoneNumber(phoneNumber: string): PhoneNumber | undefined;
     /**
      * Creates a PhoneNumber from a phone number with explicit country
+     * (No changes needed in this method's logic)
      *
      * @param {string} phoneNumber - The phone number in any format
      * @param {Country | string} country - The country or country code
      * @returns {PhoneNumber | undefined} The parsed phone number or undefined if invalid
      */
-    parsePhoneNumberWithCountry(phoneNumber: string, country: Country | string): PhoneNumber | undefined;
+    parsePhoneNumberWithCountry(phoneNumber: string, country: Country | ISO2CountryCode): PhoneNumber | undefined;
     /**
      * Extracts the information needed for dialing from one country to another
+     * (No changes needed in this method's logic)
      *
      * @param {string} fromCountry - ISO code of the country dialing from
      * @param {PhoneNumber} phoneNumber - The phone number to dial
@@ -213,6 +216,7 @@ export declare class GlobalPhoneNumberService {
     getDialingString(fromCountry: string, phoneNumber: PhoneNumber): string;
     /**
      * Cleans a phone number by removing all non-digit characters except the leading plus
+     * (No changes needed in this method's logic)
      *
      * @param {string} phoneNumber - The phone number to clean
      * @returns {string} The cleaned phone number
@@ -220,6 +224,7 @@ export declare class GlobalPhoneNumberService {
     cleanPhoneNumber(phoneNumber: string): string;
     /**
      * Extracts the country and national number from an international phone number
+     * (No changes needed in this method's logic - relies on extractDialCode which was updated)
      *
      * @param {string} phoneNumber - The phone number in international format
      * @returns {[Country | undefined, string]} The country and national number
@@ -228,13 +233,14 @@ export declare class GlobalPhoneNumberService {
     /**
      * Gets a list of commonly used examples of valid phone numbers for a country
      *
-     * @param {string} countryCode - The ISO country code
+     * @param {ISO2CountryCode} countryCode - The ISO country code
      * @returns {string[]} Array of example phone numbers
      */
-    getExampleNumbers(countryCode: string): string[];
+    getExampleNumbers(countryCode: ISO2CountryCode): string[];
     /**
      * Generates an example phone number that would match a given pattern
      * This is a simple implementation that handles basic patterns
+     * (No changes needed in this method's logic)
      *
      * @param pattern - The regex pattern
      * @returns A string that would match the pattern
@@ -242,12 +248,13 @@ export declare class GlobalPhoneNumberService {
     private generateExampleFromPattern;
     /**
      * Checks if a phone number is valid for a specific country
+     * (No changes needed in this method's logic)
      *
      * @param {string} phoneNumber - The phone number to validate
-     * @param {string} countryCode - The ISO country code
+     * @param {ISO2CountryCode} countryCode - The ISO country code
      * @returns {boolean} True if the phone number is valid for the country, false otherwise
      */
-    isValidForCountry(phoneNumber: string, countryCode: string): boolean;
+    isValidForCountry(phoneNumber: string, countryCode: ISO2CountryCode): boolean;
     /**
      * Checks if a given dial code exists in our database
      *

package/script/src/models/phone_number/global/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../../src/src/models/phone_number/global/service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,QAAQ,EAAE;QACR,8CAA8C;QAC9C,QAAQ,EAAE,MAAM,CAAC;QACjB,4CAA4C;QAC5C,MAAM,EAAE,MAAM,CAAC;QACf,oCAAoC;QACpC,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,uCAAuC;QACvC,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,sCAAsC;QACtC,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,oCAAoC;QACpC,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,mCAAmC;QACnC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,+BAA+B;QAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,mCAAmC;QACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,KAAK,kBAAkB,GAAG;IACxB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAAC;CACpC,CAAC;AASF;;GAEG;AACH,oBAAY,eAAe;IACzB,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,SAAS,cAAc;IACvB,YAAY,iBAAiB;IAC7B,WAAW,gBAAgB;IAC3B,SAAS,cAAc;IACvB,gBAAgB,qBAAqB;IACrC,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,QAAQ,EAAE,OAAO,CAAC;IAClB,kDAAkD;IAClD,cAAc,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,SAAS,EAAE,MAAM,EAAE,CAAC;IAEpB;;;;;OAKG;gBACS,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE;CASlD;AAED;;GAEG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA2B;IAClD,OAAO,CAAC,eAAe,CAA0B;IACjD,OAAO,CAAC,kBAAkB,CAA6B;IACvD,OAAO,CAAC,WAAW,CAAkB;IAErC;;OAEG;IACH,OAAO;IAEP;;;;;OAKG;WACW,WAAW,IAAI,wBAAwB;IAQrD;;;OAGG;IACH,OAAO,CAAC,UAAU;IAwBlB;;;;;OAKG;IACI,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI3E;;;;OAIG;IACI,qBAAqB,IAAI,kBAAkB;IAIlD;;;;;OAKG;IACI,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE;IAKpE;;;;;OAKG;IACI,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO;IAM3D;;;;;OAKG;IACI,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAWlE;;;;;OAKG;IACI,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAwCrE;;;;;OAKG;IACI,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,EAAE;IAgB3D;;;;;;OAMG;IACI,aAAa,CAClB,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GACrB,eAAe;IAoClB;;;;;;OAMG;IACI,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO;IAmC5E;;;;;;OAMG;IACI,YAAY,CACjB,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,iBAAmD,GAC1D,MAAM;IAOT;;;;;OAKG;IACI,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIrE;;;;;;OAMG;IACI,2BAA2B,CAChC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,OAAO,GAAG,MAAM,GACxB,WAAW,GAAG,SAAS;IAU1B;;;;;;OAMG;IACI,gBAAgB,CACrB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,WAAW,GACvB,MAAM;IAUT;;;;;OAKG;IACI,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAapD;;;;;OAKG;IACI,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,CAAC,OAAO,GAAG,SAAS,EAAE,MAAM,CAAC;IAkBvE;;;;;OAKG;IACI,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE;IAyBvD;;;;;;OAMG;IACH,OAAO,CAAC,0BAA0B;IAgBlC;;;;;;OAMG;IACI,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO;IAQ3E;;;;;OAKG;IACI,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAe9C"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../../src/src/models/phone_number/global/service.ts"],"names":[],"mappings":"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"}