@temboplus/frontend-core 0.2.4 → 0.2.6

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;
             }

package/esm/src/models/bank/service.d.ts

@@ -1,106 +0,0 @@
-import { Bank } from "./bank.js";
-/**
- * Regex pattern to validate SWIFT codes.
- * The SWIFT code must follow the format: XXXX XX XX XXX (optional last part for branches).
- * @constant {RegExp}
- */
-export declare const SWIFT_CODE_REGEX: RegExp;
-/**
- * Service for managing bank data.
- * @class BankService
- */
-export declare class BankService {
-    private static instance;
-    private bankList;
-    private bankRecord;
-    private banksByName;
-    private banksByShortName;
-    private staticReferences;
-    private constructor();
-    /**
-     * Gets the singleton instance of BankService.
-     * Creates the instance if it doesn't exist.
-     * @static
-     * @returns {BankService} The singleton instance
-     */
-    static getInstance(): BankService;
-    /**
-     * Initializes the service with bank data.
-     * Should be called once when your application starts.
-     */
-    private initialize;
-    /**
-     * Gets all banks.
-     * @returns {Bank[]} Array of all banks
-     */
-    getAll(): Bank[];
-    /**
-     * Gets all banks as a record.
-     * @returns {Record<string, Bank>} Record of bank SWIFT codes and bank objects
-     */
-    getAllAsRecord(): Record<string, Bank>;
-    /**
-     * Gets static bank references to be used by the Bank class.
-     * @returns {Map<string, Bank>} Map of static references
-     */
-    getStaticReferences(): Map<string, Bank>;
-    /**
-     * Retrieves a bank by its SWIFT code.
-     * @param {string} swiftCode The SWIFT code of the bank.
-     * @returns {Bank | undefined} The bank corresponding to the SWIFT code or `undefined` if not found.
-     */
-    fromSWIFTCode(swiftCode: string): Bank | undefined;
-    /**
-     * Retrieves a bank by its name.
-     * @param {string} bankName The name of the bank.
-     * @returns {Bank | undefined} The bank corresponding to the name or `undefined` if not found.
-     */
-    fromBankName(bankName: string): Bank | undefined;
-    /**
-     * Validates if a given SWIFT/BIC (Bank Identifier Code) is valid.
-     * @param {string | null | undefined} swiftCode - The SWIFT/BIC code to validate.
-     * @returns {boolean} Returns true if the SWIFT code is valid, false otherwise.
-     */
-    isValidSwiftCode(swiftCode?: string | null): boolean;
-    /**
-     * Validates if a given bank name is valid.
-     * @param {string | null | undefined} bankName - The bank name to validate.
-     * @returns {boolean} Returns true if the bank name is valid, false otherwise.
-     */
-    isValidBankName(bankName?: string | null): boolean;
-    /**
-     * Searches for banks that match the given search term.
-     * @param {string} searchTerm - The partial name or SWIFT code to search for.
-     * @param {number} [limit=10] - Maximum number of results to return.
-     * @returns {Bank[]} Array of matching banks, limited to specified count.
-     */
-    search(searchTerm: string, limit?: number): Bank[];
-    /**
-     * Compares two Bank instances for equality by checking their full name, short name, and SWIFT code
-     *
-     * @param {Bank} bank1 - First bank to compare
-     * @param {Bank} bank2 - Second bank to compare
-     * @returns {boolean} True if banks are equal, false otherwise
-     * @private
-     */
-    compare(bank1: Bank, bank2: Bank): boolean;
-    /**
-     * Retrieves all SWIFT codes from the TZ_BANKS list.
-     * @returns {string[]} A list of all SWIFT codes in uppercase.
-     */
-    getAllSwiftCodes(): string[];
-    /**
-     * Checks whether a given SWIFT code is in the correct format.
-     * @param {string} swiftCode The SWIFT code to check.
-     * @returns {boolean} `true` if the SWIFT code matches the expected format; `false` otherwise.
-     */
-    isValidSwiftCodeFormat(swiftCode: string): boolean;
-    /**
-     * Validates whether a given SWIFT code is correct.
-     * It checks both the SWIFT code format and if the SWIFT code exists in the list of valid codes.
-     * @param {string} [swiftCode] The SWIFT code to validate.
-     * @returns {boolean} `true` if valid, otherwise `false`.
-     */
-    validateSWIFTCode: (swiftCode?: string) => boolean;
-}
-//# sourceMappingURL=service.d.ts.map

package/esm/src/models/bank/service.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../src/src/models/bank/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,QAAgD,CAAC;AAE9E;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,gBAAgB,CAA4B;IAGpD,OAAO,CAAC,gBAAgB,CAAgC;IAExD,OAAO;IAEP;;;;;OAKG;IACH,MAAM,CAAC,WAAW,IAAI,WAAW;IAQjC;;;OAGG;IACH,OAAO,CAAC,UAAU;IA0ClB;;;OAGG;IACH,MAAM,IAAI,IAAI,EAAE;IAIhB;;;OAGG;IACH,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC;IAItC;;;OAGG;IACH,mBAAmB,IAAI,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC;IAIxC;;;;OAIG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAKlD;;;;OAIG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAqChD;;;;OAIG;IACH,gBAAgB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO;IAKpD;;;;OAIG;IACH,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO;IAKlD;;;;;OAKG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,IAAI,EAAE;IAetD;;;;;;;OAOG;IACH,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,OAAO;IAQ1C;;;OAGG;IACH,gBAAgB,IAAI,MAAM,EAAE;IAI5B;;;;OAIG;IACH,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIlD;;;;;OAKG;IACH,iBAAiB,eAAgB,MAAM,KAAG,OAAO,CAQ/C;CACH"}

package/esm/src/models/bank/service.js

@@ -1,240 +0,0 @@
-import { Bank } from "./bank.js";
-import file from "../../data/banks_tz.js";
-/**
- * Regex pattern to validate SWIFT codes.
- * The SWIFT code must follow the format: XXXX XX XX XXX (optional last part for branches).
- * @constant {RegExp}
- */
-export const SWIFT_CODE_REGEX = /^[A-Z]{4}[A-Z]{2}[A-Z0-9]{2}([A-Z0-9]{3})?$/;
-/**
- * Service for managing bank data.
- * @class BankService
- */
-export class BankService {
-    constructor() {
-        Object.defineProperty(this, "bankList", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: []
-        });
-        Object.defineProperty(this, "bankRecord", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: {}
-        });
-        Object.defineProperty(this, "banksByName", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: {}
-        });
-        Object.defineProperty(this, "banksByShortName", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: {}
-        });
-        // Static references for direct access through Bank class
-        Object.defineProperty(this, "staticReferences", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: new Map()
-        });
-        /**
-         * Validates whether a given SWIFT code is correct.
-         * It checks both the SWIFT code format and if the SWIFT code exists in the list of valid codes.
-         * @param {string} [swiftCode] The SWIFT code to validate.
-         * @returns {boolean} `true` if valid, otherwise `false`.
-         */
-        Object.defineProperty(this, "validateSWIFTCode", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: (swiftCode) => {
-                if (!swiftCode)
-                    return false;
-                const normalizedCode = swiftCode.trim().toUpperCase();
-                return (this.isValidSwiftCodeFormat(normalizedCode) &&
-                    this.getAllSwiftCodes().includes(normalizedCode));
-            }
-        });
-    }
-    /**
-     * Gets the singleton instance of BankService.
-     * Creates the instance if it doesn't exist.
-     * @static
-     * @returns {BankService} The singleton instance
-     */
-    static getInstance() {
-        if (!BankService.instance) {
-            BankService.instance = new BankService();
-            BankService.instance.initialize();
-        }
-        return BankService.instance;
-    }
-    /**
-     * Initializes the service with bank data.
-     * Should be called once when your application starts.
-     */
-    initialize() {
-        try {
-            const data = JSON.parse(JSON.stringify(file));
-            const banks = Object.values(data).map((b) => new Bank(b.fullName, b.shortName, b.swiftCode));
-            const swiftCodeRecord = {};
-            const nameRecord = {};
-            const shortNameRecord = {};
-            banks.forEach((bank) => {
-                // Populate records
-                swiftCodeRecord[bank.swiftCode.toUpperCase()] = bank;
-                nameRecord[bank.fullName.toUpperCase()] = bank;
-                shortNameRecord[bank.shortName.toUpperCase()] = bank;
-                // Add to static references with uppercase short name
-                const shortName = bank.shortName.toUpperCase();
-                this.staticReferences.set(shortName, bank);
-                // Handle bank names with spaces (like "GT BANK")
-                if (shortName.includes(" ")) {
-                    const noSpaceName = shortName.replace(/\s+/g, "_");
-                    this.staticReferences.set(noSpaceName, bank);
-                }
-            });
-            this.bankRecord = swiftCodeRecord;
-            this.banksByName = nameRecord;
-            this.banksByShortName = shortNameRecord;
-            this.bankList = banks;
-        }
-        catch (error) {
-            console.error("Failed to initialize BankService:", error);
-        }
-    }
-    /**
-     * Gets all banks.
-     * @returns {Bank[]} Array of all banks
-     */
-    getAll() {
-        return this.bankList;
-    }
-    /**
-     * Gets all banks as a record.
-     * @returns {Record<string, Bank>} Record of bank SWIFT codes and bank objects
-     */
-    getAllAsRecord() {
-        return this.bankRecord;
-    }
-    /**
-     * Gets static bank references to be used by the Bank class.
-     * @returns {Map<string, Bank>} Map of static references
-     */
-    getStaticReferences() {
-        return this.staticReferences;
-    }
-    /**
-     * Retrieves a bank by its SWIFT code.
-     * @param {string} swiftCode The SWIFT code of the bank.
-     * @returns {Bank | undefined} The bank corresponding to the SWIFT code or `undefined` if not found.
-     */
-    fromSWIFTCode(swiftCode) {
-        if (!swiftCode || typeof swiftCode !== "string")
-            return;
-        return this.bankRecord[swiftCode.toUpperCase()];
-    }
-    /**
-     * Retrieves a bank by its name.
-     * @param {string} bankName The name of the bank.
-     * @returns {Bank | undefined} The bank corresponding to the name or `undefined` if not found.
-     */
-    fromBankName(bankName) {
-        if (!bankName || typeof bankName !== "string")
-            return;
-        // First try shortname exact match
-        const bankByShortName = this.banksByShortName[bankName.toUpperCase()];
-        if (bankByShortName)
-            return bankByShortName;
-        // Next try fullname exact match
-        const bankByName = this.banksByName[bankName.toUpperCase()];
-        if (bankByName)
-            return bankByName;
-        // If not found, try more lenient matching on full name
-        for (const [name, bankObj] of Object.entries(this.banksByName)) {
-            if (bankName.toUpperCase() === name.toUpperCase()) {
-                return bankObj;
-            }
-        }
-        // Try lenient matching on short name
-        for (const [shortName, bankObj] of Object.entries(this.banksByShortName)) {
-            if (bankName.toUpperCase() === shortName.toUpperCase()) {
-                return bankObj;
-            }
-        }
-        // Legacy fallback - case insensitive exact match
-        return this.bankList.find((bank) => bank.fullName.toLowerCase() === bankName.toLowerCase() ||
-            bankName.toLowerCase() === bank.shortName.toLowerCase());
-    }
-    /**
-     * Validates if a given SWIFT/BIC (Bank Identifier Code) is valid.
-     * @param {string | null | undefined} swiftCode - The SWIFT/BIC code to validate.
-     * @returns {boolean} Returns true if the SWIFT code is valid, false otherwise.
-     */
-    isValidSwiftCode(swiftCode) {
-        if (!swiftCode)
-            return false;
-        return !!this.fromSWIFTCode(swiftCode);
-    }
-    /**
-     * Validates if a given bank name is valid.
-     * @param {string | null | undefined} bankName - The bank name to validate.
-     * @returns {boolean} Returns true if the bank name is valid, false otherwise.
-     */
-    isValidBankName(bankName) {
-        if (!bankName)
-            return false;
-        return !!this.fromBankName(bankName);
-    }
-    /**
-     * Searches for banks that match the given search term.
-     * @param {string} searchTerm - The partial name or SWIFT code to search for.
-     * @param {number} [limit=10] - Maximum number of results to return.
-     * @returns {Bank[]} Array of matching banks, limited to specified count.
-     */
-    search(searchTerm, limit = 10) {
-        if (!searchTerm || typeof searchTerm !== "string")
-            return [];
-        const term = searchTerm.toLowerCase().trim();
-        if (term.length === 0)
-            return [];
-        const results = this.bankList.filter((bank) => bank.fullName.toLowerCase().includes(term) ||
-            bank.shortName.toLowerCase().includes(term) ||
-            bank.swiftCode.toLowerCase().includes(term));
-        return results.slice(0, limit);
-    }
-    /**
-     * Compares two Bank instances for equality by checking their full name, short name, and SWIFT code
-     *
-     * @param {Bank} bank1 - First bank to compare
-     * @param {Bank} bank2 - Second bank to compare
-     * @returns {boolean} True if banks are equal, false otherwise
-     * @private
-     */
-    compare(bank1, bank2) {
-        return (bank1.fullName === bank2.fullName &&
-            bank1.shortName === bank2.shortName &&
-            bank1.swiftCode === bank2.swiftCode);
-    }
-    /**
-     * Retrieves all SWIFT codes from the TZ_BANKS list.
-     * @returns {string[]} A list of all SWIFT codes in uppercase.
-     */
-    getAllSwiftCodes() {
-        return this.bankList.map((bank) => bank.swiftCode.toUpperCase());
-    }
-    /**
-     * Checks whether a given SWIFT code is in the correct format.
-     * @param {string} swiftCode The SWIFT code to check.
-     * @returns {boolean} `true` if the SWIFT code matches the expected format; `false` otherwise.
-     */
-    isValidSwiftCodeFormat(swiftCode) {
-        return SWIFT_CODE_REGEX.test(swiftCode);
-    }
-}