@temboplus/frontend-core 0.2.5 → 0.2.7

package/esm/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/esm/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":"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;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;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,GAAG,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC;AAUhE;;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,eAAe,EAAE,CAAC;CACtC;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,SAAS,EAAE,eAAe,EAAE,CAAC;IAE7B;;;;;OAKG;gBACS,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE;CAS3D;AAED;;GAEG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA2B;IAElD,OAAO,CAAC,eAAe,CAAiC;IACxD,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;IAyBlB;;;;;OAKG;IACI,kBAAkB,CAAC,WAAW,EAAE,eAAe,GAAG,eAAe,GAAG,SAAS;IAIpF;;;;OAIG;IACI,qBAAqB,IAAI,kBAAkB;IAIlD;;;;;OAKG;IACI,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE;IAMpE;;;;;OAKG;IACI,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO;IAO3D;;;;;OAKG;IACI,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAU3E;;;;;OAKG;IACI,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAyCrE;;;;;OAKG;IACI,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,EAAE;IAgB3D;;;;;;OAMG;IACI,aAAa,CAClB,WAAW,EAAE,eAAe,EAC5B,cAAc,EAAE,MAAM,GACrB,eAAe;IAsClB;;;;;;OAMG;IACI,eAAe,CAAC,WAAW,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO;IAsCrF;;;;;;;OAOG;IACI,YAAY,CACjB,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,iBAAmD,GAC1D,MAAM;IAOT;;;;;;OAMG;IACI,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIrE;;;;;;;OAOG;IACI,2BAA2B,CAChC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,OAAO,GAAG,eAAe,GACjC,WAAW,GAAG,SAAS;IAU1B;;;;;;;OAOG;IACI,gBAAgB,CACrB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,WAAW,GACvB,MAAM;IAUT;;;;;;OAMG;IACI,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAapD;;;;;;OAMG;IACI,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,CAAC,OAAO,GAAG,SAAS,EAAE,MAAM,CAAC;IAkBvE;;;;;OAKG;IACI,iBAAiB,CAAC,WAAW,EAAE,eAAe,GAAG,MAAM,EAAE;IA4BhE;;;;;;;OAOG;IACH,OAAO,CAAC,0BAA0B;IAgBlC;;;;;;;OAOG;IACI,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe,GAAG,OAAO;IAQpF;;;;;OAKG;IACI,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAe9C"}

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

@@ -69,12 +69,13 @@ export 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,
@@ -113,13 +114,14 @@ export class GlobalPhoneNumberService {
             const data = JSON.parse(JSON.stringify(phonePatterns));
             // 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) {
@@ -129,16 +131,16 @@ export 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;
@@ -151,6 +153,7 @@ export class GlobalPhoneNumberService {
      */
     getCountriesWithDialCode(dialCode) {
         const dialCodeStr = dialCode.toString();
+        // sharedCountryCodes remains an object, access is unchanged
         return this.sharedCountryCodes[dialCodeStr] || [];
     }
     /**
@@ -161,6 +164,7 @@ export 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;
     }
@@ -171,9 +175,10 @@ export 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;
@@ -193,23 +198,24 @@ export 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,
@@ -242,7 +248,7 @@ export 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
      */
@@ -250,8 +256,10 @@ export 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
@@ -278,7 +286,7 @@ export 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
      */
@@ -286,8 +294,10 @@ export 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
@@ -313,6 +323,7 @@ export 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
@@ -326,6 +337,7 @@ export 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
@@ -335,6 +347,7 @@ export 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
@@ -350,6 +363,7 @@ export 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
@@ -365,6 +379,7 @@ export 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
@@ -381,6 +396,7 @@ export 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
@@ -406,25 +422,29 @@ export 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
@@ -443,9 +463,10 @@ export 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) {
@@ -462,12 +483,12 @@ export 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;
             }

package/package.json

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

package/script/src/data/countries.d.ts

@@ -15,7 +15,7 @@ declare const _default: {
     coverage: string;
     contact_info: string;
     notes: string;
-    countries: {
+    countries: ({
         name: string;
         name_official: string;
         iso_2: string;
@@ -23,7 +23,17 @@ declare const _default: {
         flag_emoji: string;
         continent: string;
         region: string;
-    }[];
+        currency_iso_code: string;
+    } | {
+        name: string;
+        name_official: string;
+        iso_2: string;
+        iso_3: string;
+        flag_emoji: string;
+        continent: string;
+        region: string;
+        currency_iso_code: null;
+    })[];
 };
 export default _default;
 //# sourceMappingURL=countries.d.ts.map