@temboplus/frontend-core 0.2.4 → 0.2.6

package/esm/src/models/amount/amount.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"amount.d.ts","sourceRoot":"","sources":["../../../../src/src/models/amount/amount.ts"],"names":[],"mappings":"AAOA,QAAA,MAAM,YAAY,QAA2C,CAAC;AAE9D,cAAM,MAAM;IACV,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IAEpC,OAAO;IAcP;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,CACT,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,YAAY,GAAE,MAAc,GAC3B,MAAM,GAAG,SAAS;IAkCrB;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;OAEG;IACH,IAAI,qBAAqB,IAAI,MAAM,CAKlC;IAED;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CACjB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAC9B,YAAY,GAAE,MAAc,GAC3B,OAAO;IAQV;;;;;;OAMG;WACW,EAAE,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,MAAM;IA4B7C;;;OAGG;IACI,QAAQ,IAAI,OAAO;CAO3B;AAgDD,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"amount.d.ts","sourceRoot":"","sources":["../../../../src/src/models/amount/amount.ts"],"names":[],"mappings":"AAMA,QAAA,MAAM,YAAY,QAA2C,CAAC;AAE9D,cAAM,MAAM;IACV,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IAEpC,OAAO;IAcP;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,CACT,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,YAAY,GAAE,MAAc,GAC3B,MAAM,GAAG,SAAS;IAkCrB;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;OAEG;IACH,IAAI,qBAAqB,IAAI,MAAM,CAKlC;IAED;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CACjB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAC9B,YAAY,GAAE,MAAc,GAC3B,OAAO;IAQV;;;;;;OAMG;WACW,EAAE,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,MAAM;IA4B7C;;;OAGG;IACI,QAAQ,IAAI,OAAO;CAO3B;AAgDD,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC"}

package/esm/src/models/amount/amount.js

@@ -1,6 +1,6 @@
 // Regex explanation:
 // ^(?:\d{1,3}(?:,\d{3})*|\d+) - Either grouped digits with commas OR just digits
-import { CurrencyService } from "../currency/service.js";
+import { CurrencyService } from "../currency/currency.js";
 // (?:\.\d+)?$ - Optional decimal part with any number of digits
 const AMOUNT_REGEX = /^(?:\d{1,3}(?:,\d{3})*|\d+)(?:\.\d+)?$/;
 class Amount {

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

@@ -1,3 +1,26 @@
+/**
+ * @fileoverview This file contains both the Bank class and BankService class.
+ *
+ * ARCHITECTURE NOTE: Bank and BankService Classes
+ * ===============================================
+ *
+ * These two classes have been intentionally placed in the same file to follow
+ * the established domain model pattern used with Country and Currency classes.
+ *
+ * - Bank class: Defines bank properties and static accessors
+ * - BankService class: Loads bank data and provides instance methods
+ *
+ * Benefits of this approach:
+ * 1. Prevents circular dependencies between the classes
+ * 2. Ensures static properties are immediately available on import
+ * 3. Maintains a consistent architectural pattern across domain models
+ * 4. Encapsulates all bank-related functionality in a single module
+ *
+ * This implementation follows the "Smart Models, Dumb Services" pattern where
+ * the Bank class provides a rich public API through static methods that delegate
+ * to the internal BankService. Meanwhile, BankService handles data loading and
+ * indexing without being directly exposed to external code.
+ */
 /**
  * Represents a bank with essential details.
  * @class Bank
@@ -127,4 +150,108 @@ export declare class Bank {
      */
     static is(obj: unknown): obj is Bank;
 }
+/**
+ * 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=bank.d.ts.map

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

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

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

@@ -1,4 +1,27 @@
-import { BankService } from "./service.js";
+/**
+ * @fileoverview This file contains both the Bank class and BankService class.
+ *
+ * ARCHITECTURE NOTE: Bank and BankService Classes
+ * ===============================================
+ *
+ * These two classes have been intentionally placed in the same file to follow
+ * the established domain model pattern used with Country and Currency classes.
+ *
+ * - Bank class: Defines bank properties and static accessors
+ * - BankService class: Loads bank data and provides instance methods
+ *
+ * Benefits of this approach:
+ * 1. Prevents circular dependencies between the classes
+ * 2. Ensures static properties are immediately available on import
+ * 3. Maintains a consistent architectural pattern across domain models
+ * 4. Encapsulates all bank-related functionality in a single module
+ *
+ * This implementation follows the "Smart Models, Dumb Services" pattern where
+ * the Bank class provides a rich public API through static methods that delegate
+ * to the internal BankService. Meanwhile, BankService handles data loading and
+ * indexing without being directly exposed to external code.
+ */
+import file from "../../data/banks_tz.js";
 /**
  * Represents a bank with essential details.
  * @class Bank
@@ -176,11 +199,245 @@ export class Bank {
         return Boolean(bankFromSwift);
     }
 }
-// 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(() => {
+/**
+ * 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);
+    }
+}
+(function setupStaticReferences() {
     try {
         const staticRefs = BankService.getInstance().getStaticReferences();
         staticRefs.forEach((bank, key) => {
@@ -191,4 +448,4 @@ setTimeout(() => {
     catch (error) {
         console.error("Failed to initialize Bank static properties:", error);
     }
-}, 0);
+})();

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

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

package/esm/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,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,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"}

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

@@ -1,3 +1,2 @@
 export * from "./bank.js";
 export * from "./antd_validator.js";
-export * from "./service.js";