@temboplus/frontend-core 0.2.1 → 0.2.3

package/script/src/models/bank/bank.js

@@ -1,17 +1,16 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Bank = void 0;
-const banks_js_1 = __importDefault(require("./banks.js"));
+const service_js_1 = require("./service.js");
 /**
  * Represents a bank with essential details.
  * @class Bank
  */
 class Bank {
     /**
-     * Creates a new Bank instance.
+     * Creates a new Bank instance. Private constructor - only BankService can create instances.
+     * Clients should use static methods like Bank.from() or Bank.CRDB instead.
+     *
      * @param {string} _fullName - The full name of the bank
      * @param {string} _shortName - The short name or abbreviated name of the bank
      * @param {string} _swiftCode - The SWIFT code associated with the bank
@@ -35,6 +34,11 @@ class Bank {
             writable: true,
             value: _swiftCode
         });
+        // Make sure only BankService can create Bank instances
+        const callerIsService = new Error().stack?.includes("BankService");
+        if (!callerIsService) {
+            throw new Error("Bank instances cannot be created directly. Use Bank.from() or access via Bank.CRDB, Bank.NMB, etc.");
+        }
     }
     /**
      * Gets the full name of the bank.
@@ -70,7 +74,7 @@ class Bank {
      * @returns {Bank | undefined} The bank corresponding to the SWIFT code or `undefined` if not found.
      */
     static fromSWIFTCode(swiftCode) {
-        return this.getAll().find((b) => b.swiftCode.toUpperCase() === swiftCode.toUpperCase());
+        return service_js_1.BankService.getInstance().fromSWIFTCode(swiftCode);
     }
     /**
      * Retrieves a bank by its short or full name.
@@ -78,19 +82,19 @@ class Bank {
      * @returns {Bank | undefined} The bank corresponding to the full name or `undefined` if not found.
      */
     static fromBankName(bankName) {
-        return this.getAll().find((bank) => bank.fullName.toLowerCase() === bankName.toLowerCase() ||
-            bankName.toLowerCase() === bank.shortName.toLowerCase());
+        return service_js_1.BankService.getInstance().fromBankName(bankName);
+    }
+    /**
+     * Returns all available banks.
+     * @returns {Bank[]} Array of all banks
+     */
+    static getAll() {
+        return service_js_1.BankService.getInstance().getAll();
     }
     /**
      * Validates if a given SWIFT/BIC (Bank Identifier Code) is valid
-     *
-     * @param {string | null | undefined} swiftCode - The SWIFT/BIC code to validate.
-     *   Should be in the format of 8 or 11 characters (e.g., 'NMIBTZTZ' or 'CRDBTZTZXXX').
-     *
-     * @returns {boolean} Returns true if:
-     *   - The SWIFT code is not null/undefined
-     *   - The SWIFT code successfully creates a valid Bank instance
-     *   Returns false otherwise.
+     * @param swiftCode The SWIFT/BIC code to validate
+     * @returns True if the SWIFT code is valid
      */
     static isValidSwiftCode(swiftCode) {
         if (!swiftCode)
@@ -100,14 +104,8 @@ class Bank {
     }
     /**
      * Validates if a given bank name is valid
-     *
-     * @param {string | null | undefined} bankName - The bank name to validate.
-     *   Should be either 'CRDB' or 'NMB'.
-     *
-     * @returns {boolean} Returns true if:
-     *   - The bank name is not null/undefined
-     *   - The bank name successfully creates a valid Bank instance
-     *   Returns false otherwise.
+     * @param bankName The bank name to validate
+     * @returns True if the bank name is valid
      */
     static isValidBankName(bankName) {
         if (!bankName)
@@ -115,22 +113,14 @@ class Bank {
         const bank = Bank.fromBankName(bankName);
         return !!bank;
     }
-    /**
-     * Gets all banks from the JSON data.
-     * @returns {Bank[]} Array of all banks
-     */
-    static getAll() {
-        const data = JSON.parse(JSON.stringify(banks_js_1.default));
-        return data.map((b) => new Bank(b.fullName, b.shortName, b.swiftCode));
-    }
     /**
      * Checks the validity of the bank data
      * @returns true if the bank information is available and valid
      */
     validate() {
         try {
-            return (Bank.fromBankName(this._fullName) !== undefined &&
-                Bank.fromBankName(this._shortName) !== undefined &&
+            return (Bank.fromBankName(this._fullName) !== undefined ||
+                Bank.fromBankName(this._shortName) !== undefined ||
                 Bank.fromSWIFTCode(this._swiftCode) !== undefined);
         }
         catch (_) {
@@ -139,14 +129,8 @@ class Bank {
     }
     /**
      * Attempts to create a Bank instance from a bank name or SWIFT code
-     * First tries to create from bank name, then from SWIFT code if bank name fails
-     *
-     * @param {string} input - The bank name or SWIFT code
-     * @returns {Bank | undefined} A Bank instance if valid input, undefined otherwise
-     *
-     * @example
-     * const bank = Bank.from('CORUTZTZ'); // From SWIFT code
-     * const sameBank = Bank.from('CRDB'); // From bank name
+     * @param input The bank name or SWIFT code
+     * @returns A Bank instance if valid input, undefined otherwise
      */
     static from(input) {
         if (Bank.canConstruct(input)) {
@@ -161,15 +145,8 @@ class Bank {
     }
     /**
      * Validates if the input can be used to construct a valid Bank instance
-     * Checks if the input resolves to the same bank via both name and SWIFT code
-     *
-     * @param {string | null | undefined} input - The bank name or SWIFT code to validate
-     * @returns {boolean} True if input can construct a valid bank, false otherwise
-     *
-     * @example
-     * Bank.canConstruct('CORUTZTZ'); // true
-     * Bank.canConstruct(''); // false
-     * Bank.canConstruct(null); // false
+     * @param input The bank name or SWIFT code to validate
+     * @returns True if input can construct a valid bank, false otherwise
      */
     static canConstruct(input) {
         if (!input || typeof input !== "string")
@@ -182,20 +159,9 @@ class Bank {
         return bankFromSwift !== undefined || bankFromName !== undefined;
     }
     /**
-     * Checks if an unknown value is a Bank instance.
-     * Validates the structural integrity of a bank object.
-     *
-     * @param {unknown} obj - The value to validate
-     * @returns {obj is Bank} Type predicate indicating if the value is a valid Bank
-     *
-     * @example
-     * const maybeBank = JSON.parse(someData);
-     * if (Bank.is(maybeBank)) {
-     *   console.log(maybeBank.fullName); // maybeBank is typed as Bank
-     * }
-     *
-     * @see {@link Bank.fromSWIFTCode} for creating instances from SWIFT codes
-     * @see {@link Bank.fromBankName} for creating instances from bank names
+     * Checks if an unknown value is a Bank instance
+     * @param obj The value to validate
+     * @returns Type predicate indicating if the value is a valid Bank
      */
     static is(obj) {
         if (!obj || typeof obj !== "object")
@@ -209,28 +175,24 @@ class Bank {
         if (typeof maybeBank._swiftCode !== "string")
             return false;
         // Validate against known banks
-        const bankFromSwift = Bank.from(maybeBank._swiftCode);
-        const bankFromName = Bank.from(maybeBank._fullName);
-        const bankFromName2 = Bank.from(maybeBank._shortName);
-        return Boolean(bankFromSwift &&
-            bankFromName &&
-            bankFromName2 &&
-            compare(bankFromName, bankFromName2) &&
-            compare(bankFromSwift, bankFromName) &&
-            compare(bankFromSwift, bankFromName2));
+        const bankFromSwift = Bank.fromSWIFTCode(maybeBank._swiftCode);
+        return Boolean(bankFromSwift);
     }
 }
 exports.Bank = 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
- */
-function compare(bank1, bank2) {
-    return (bank1.fullName === bank2.fullName &&
-        bank1.shortName === bank2.shortName &&
-        bank1.swiftCode === bank2.swiftCode);
-}
+// Initialize static properties by applying the references from BankService.
+// 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(() => {
+    try {
+        const staticRefs = service_js_1.BankService.getInstance().getStaticReferences();
+        staticRefs.forEach((bank, key) => {
+            // deno-lint-ignore no-explicit-any
+            Bank[key] = bank;
+        });
+    }
+    catch (error) {
+        console.error("Failed to initialize Bank static properties:", error);
+    }
+}, 0);

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

@@ -1,4 +1,4 @@
-export * from "./utils.js";
 export * from "./bank.js";
 export * from "./antd_validator.js";
+export * from "./service.js";
 //# sourceMappingURL=index.d.ts.map

package/script/src/models/bank/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/models/bank/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/models/bank/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC"}

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

@@ -14,6 +14,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./utils.js"), exports);
 __exportStar(require("./bank.js"), exports);
 __exportStar(require("./antd_validator.js"), exports);
+__exportStar(require("./service.js"), exports);

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

@@ -0,0 +1,106 @@
+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/script/src/models/bank/service.d.ts.map

@@ -0,0 +1 @@
+{"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/script/src/models/bank/service.js

@@ -0,0 +1,247 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BankService = exports.SWIFT_CODE_REGEX = void 0;
+const bank_js_1 = require("./bank.js");
+const banks_tz_js_1 = __importDefault(require("../../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}
+ */
+exports.SWIFT_CODE_REGEX = /^[A-Z]{4}[A-Z]{2}[A-Z0-9]{2}([A-Z0-9]{3})?$/;
+/**
+ * Service for managing bank data.
+ * @class BankService
+ */
+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(banks_tz_js_1.default));
+            const banks = Object.values(data).map((b) => new bank_js_1.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 exports.SWIFT_CODE_REGEX.test(swiftCode);
+    }
+}
+exports.BankService = BankService;