@temboplus/frontend-core 0.2.5 → 0.2.6

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":"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"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../../src/src/models/phone_number/global/service.ts"],"names":[],"mappings":"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"}

package/script/src/models/phone_number/global/service.js

@@ -76,12 +76,13 @@ class GlobalPhoneNumberService {
      * Private constructor to enforce singleton pattern
      */
     constructor() {
+        // Use Map for countryMetadata
         Object.defineProperty(this, "countryMetadata", {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: {}
-        });
+            value: new Map()
+        }); // <--- CHANGED
         Object.defineProperty(this, "sharedCountryCodes", {
             enumerable: true,
             configurable: true,
@@ -120,13 +121,14 @@ class GlobalPhoneNumberService {
             const data = JSON.parse(JSON.stringify(phone_patterns_js_1.default));
             // Extract shared country codes
             this.sharedCountryCodes = data._shared_country_codes || {};
-            const countries = Object.entries(data)
+            // Populate the countryMetadata Map
+            const countriesMap = new Map(); // <--- CHANGED
+            Object.entries(data)
                 .filter(([key]) => !key.startsWith("_"))
-                .reduce((result, [key, value]) => {
-                result[key] = value;
-                return result;
-            }, {});
-            this.countryMetadata = countries;
+                .forEach(([key, value]) => {
+                countriesMap.set(key, value); // <--- CHANGED (using .set())
+            });
+            this.countryMetadata = countriesMap; // <--- CHANGED
             this.initialized = true;
         }
         catch (error) {
@@ -136,16 +138,16 @@ 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) {
-        return this.countryMetadata[countryCode];
+        return this.countryMetadata.get(countryCode); // <--- CHANGED (using .get())
     }
     /**
      * Gets all country metadata
      *
-     * @returns {CountryMetadataMap} All country metadata
+     * @returns {CountryMetadataMap} All country metadata (as a Map)
      */
     getAllCountryMetadata() {
         return this.countryMetadata;
@@ -158,6 +160,7 @@ class GlobalPhoneNumberService {
      */
     getCountriesWithDialCode(dialCode) {
         const dialCodeStr = dialCode.toString();
+        // sharedCountryCodes remains an object, access is unchanged
         return this.sharedCountryCodes[dialCodeStr] || [];
     }
     /**
@@ -168,6 +171,7 @@ class GlobalPhoneNumberService {
      */
     isSharedDialCode(dialCode) {
         const dialCodeStr = dialCode.toString();
+        // sharedCountryCodes remains an object, access is unchanged
         const countries = this.sharedCountryCodes[dialCodeStr];
         return countries !== undefined && countries.length > 1;
     }
@@ -178,9 +182,10 @@ class GlobalPhoneNumberService {
      * @returns The country code or undefined if not found
      */
     getCountryForDialCode(dialCode) {
-        for (const [countryCode, metadata] of Object.entries(this.countryMetadata)) {
+        // Iterate over Map entries
+        for (const [countryCode, metadata] of this.countryMetadata.entries()) { // <--- CHANGED (using .entries())
             if (metadata.code.toString() === dialCode) {
-                return countryCode;
+                return countryCode; // No need for type assertion here
             }
         }
         return undefined;
@@ -200,23 +205,24 @@ class GlobalPhoneNumberService {
         for (let i = 3; i >= 1; i--) {
             if (numberWithoutPlus.length <= i)
                 continue;
-            const dialCode = numberWithoutPlus.substring(0, i);
-            // Check if any country has this dial code
+            const potentialDialCode = numberWithoutPlus.substring(0, i); // Renamed for clarity
+            // Check if any country has this dial code by iterating Map values
             let countryFound = false;
-            for (const [_, metadata] of Object.entries(this.countryMetadata)) {
-                if (metadata.code.toString() === dialCode) {
+            for (const metadata of this.countryMetadata.values()) { // <--- CHANGED (using .values())
+                if (metadata.code.toString() === potentialDialCode) {
                     countryFound = true;
                     break;
                 }
             }
             if (countryFound) {
-                const nationalNumber = numberWithoutPlus.substring(dialCode.length);
-                const isShared = this.isSharedDialCode(dialCode);
+                const nationalNumber = numberWithoutPlus.substring(potentialDialCode.length);
+                const isShared = this.isSharedDialCode(potentialDialCode);
+                // Use the existing methods which now work with the Map internally
                 const possibleCountries = isShared
-                    ? this.sharedCountryCodes[dialCode]
-                    : [this.getCountryForDialCode(dialCode) ?? ""];
+                    ? this.sharedCountryCodes[potentialDialCode] // Access shared codes directly
+                    : this.getCountryForDialCode(potentialDialCode) ? [this.getCountryForDialCode(potentialDialCode)] : [];
                 return {
-                    dialCode,
+                    dialCode: potentialDialCode,
                     isShared,
                     nationalNumber,
                     possibleCountries,
@@ -249,7 +255,7 @@ 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
      */
@@ -257,8 +263,10 @@ class GlobalPhoneNumberService {
         if (!countryCode || !nationalNumber) {
             return PhoneNumberType.UNKNOWN;
         }
-        const metadata = this.countryMetadata[countryCode];
-        if (!metadata || !metadata.patterns) {
+        // Use .get() to retrieve metadata
+        const metadata = this.countryMetadata.get(countryCode); // <--- CHANGED (using .get())
+        // Check if metadata exists after .get()
+        if (!metadata || !metadata.patterns) { // <--- ADDED Check for undefined
             return PhoneNumberType.UNKNOWN;
         }
         // Verify that required patterns exist
@@ -285,7 +293,7 @@ class GlobalPhoneNumberService {
     /**
      * 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
      */
@@ -293,8 +301,10 @@ class GlobalPhoneNumberService {
         if (!countryCode || !nationalNumber) {
             return false;
         }
-        const metadata = this.countryMetadata[countryCode];
-        if (!metadata || !metadata.patterns) {
+        // Use .get() to retrieve metadata
+        const metadata = this.countryMetadata.get(countryCode); // <--- CHANGED (using .get())
+        // Check if metadata exists after .get()
+        if (!metadata || !metadata.patterns) { // <--- ADDED Check for undefined
             return false;
         }
         // Verify that required patterns exist
@@ -320,6 +330,7 @@ class GlobalPhoneNumberService {
     }
     /**
      * 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
@@ -333,6 +344,7 @@ class GlobalPhoneNumberService {
     }
     /**
      * 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
@@ -342,6 +354,7 @@ class GlobalPhoneNumberService {
     }
     /**
      * 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
@@ -357,6 +370,7 @@ class GlobalPhoneNumberService {
     }
     /**
      * 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
@@ -372,6 +386,7 @@ class GlobalPhoneNumberService {
     }
     /**
      * 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
@@ -388,6 +403,7 @@ class GlobalPhoneNumberService {
     }
     /**
      * 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
@@ -413,25 +429,29 @@ 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) {
-        const metadata = this.countryMetadata[countryCode];
+        // Use .get() to retrieve metadata
+        const metadata = this.countryMetadata.get(countryCode); // <--- CHANGED (using .get())
         if (!metadata)
-            return [];
+            return []; // <--- ADDED Check for undefined
         const dialCode = metadata.code;
         const examples = [];
-        // Since landline and mobile patterns are required, we can always generate examples
-        // Landline example
-        examples.push(`+${dialCode}${this.generateExampleFromPattern(metadata.patterns.landline)}`);
-        // Mobile example
-        examples.push(`+${dialCode}${this.generateExampleFromPattern(metadata.patterns.mobile)}`);
+        // Ensure patterns exist before trying to generate examples
+        if (metadata.patterns.landline) {
+            examples.push(`+${dialCode}${this.generateExampleFromPattern(metadata.patterns.landline)}`);
+        }
+        if (metadata.patterns.mobile) {
+            examples.push(`+${dialCode}${this.generateExampleFromPattern(metadata.patterns.mobile)}`);
+        }
         return examples;
     }
     /**
      * 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
@@ -450,9 +470,10 @@ class GlobalPhoneNumberService {
     }
     /**
      * 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, countryCode) {
@@ -469,12 +490,12 @@ class GlobalPhoneNumberService {
      * @returns True if the dial code exists, false otherwise
      */
     hasDialCode(dialCode) {
-        // Check if it's a shared dial code
+        // Check if it's a shared dial code (access unchanged)
         if (this.sharedCountryCodes[dialCode]?.length > 0) {
             return true;
         }
-        // Check if any country has this dial code
-        for (const metadata of Object.values(this.countryMetadata)) {
+        // Check if any country has this dial code by iterating Map values
+        for (const metadata of this.countryMetadata.values()) { // <--- CHANGED (using .values())
             if (metadata.code.toString() === dialCode) {
                 return true;
             }