@temboplus/frontend-core 0.2.5 → 0.2.6

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

@@ -1,366 +0,0 @@
-import { CONTINENT, Country, SUB_REGION } from "./country.js";
-import file from "../../data/countries.js";
-/**
- * Service for managing country data.
- * @class CountryService
- */
-export class CountryService {
-    constructor() {
-        Object.defineProperty(this, "countryList", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: []
-        });
-        Object.defineProperty(this, "codeRecord", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: {}
-        });
-        Object.defineProperty(this, "iso3Record", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: {}
-        });
-        // private nameRecord: Record<string, Country> = {};
-        Object.defineProperty(this, "nameRecord", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: {}
-        });
-        Object.defineProperty(this, "continentRecord", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: {}
-        });
-        Object.defineProperty(this, "regionRecord", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: {}
-        });
-        // Static references for direct access through Country class
-        Object.defineProperty(this, "staticReferences", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: new Map()
-        });
-    }
-    /**
-     * Gets the singleton instance of CountryService.
-     * Creates the instance if it doesn't exist.
-     * @static
-     * @returns {CountryService} The singleton instance
-     */
-    static getInstance() {
-        if (!CountryService.instance) {
-            CountryService.instance = new CountryService();
-            CountryService.instance.initialize();
-        }
-        return CountryService.instance;
-    }
-    /**
-     * Maps a string continent name to the CONTINENT enum
-     * @param continentName String continent name from JSON
-     * @returns The corresponding CONTINENT enum value
-     */
-    mapContinent(continentName) {
-        switch (continentName) {
-            case "Africa":
-                return CONTINENT.AFRICA;
-            case "Antarctica":
-                return CONTINENT.ANTARCTICA;
-            case "Asia":
-                return CONTINENT.ASIA;
-            case "Europe":
-                return CONTINENT.EUROPE;
-            case "North America":
-                return CONTINENT.NORTH_AMERICA;
-            case "Oceania":
-                return CONTINENT.OCEANIA;
-            case "South America":
-                return CONTINENT.SOUTH_AMERICA;
-            default:
-                return CONTINENT.EUROPE; // Default value
-        }
-    }
-    /**
-     * Maps a string region name to the SUB_REGION enum
-     * @param regionName String region name from JSON
-     * @returns The corresponding SUB_REGION enum value
-     */
-    mapRegion(regionName) {
-        switch (regionName) {
-            case "Australia and New Zealand":
-                return SUB_REGION.AUSTRALIA_AND_NEW_ZEALAND;
-            case "Caribbean":
-                return SUB_REGION.CARIBBEAN;
-            case "Central America":
-                return SUB_REGION.CENTRAL_AMERICA;
-            case "Central Asia":
-                return SUB_REGION.CENTRAL_ASIA;
-            case "Eastern Africa":
-                return SUB_REGION.EASTERN_AFRICA;
-            case "Eastern Asia":
-                return SUB_REGION.EASTERN_ASIA;
-            case "Eastern Europe":
-                return SUB_REGION.EASTERN_EUROPE;
-            case "Melanesia":
-                return SUB_REGION.MELANESIA;
-            case "Micronesia":
-                return SUB_REGION.MICRONESIA;
-            case "Middle Africa":
-                return SUB_REGION.MIDDLE_AFRICA;
-            case "Northern Africa":
-                return SUB_REGION.NORTHERN_AFRICA;
-            case "Northern America":
-                return SUB_REGION.NORTHERN_AMERICA;
-            case "Northern Europe":
-                return SUB_REGION.NORTHERN_EUROPE;
-            case "Polynesia":
-                return SUB_REGION.POLYNESIA;
-            case "South-eastern Asia":
-                return SUB_REGION.SOUTH_EASTERN_ASIA;
-            case "Southern Africa":
-                return SUB_REGION.SOUTHERN_AFRICA;
-            case "Southern Asia":
-                return SUB_REGION.SOUTHERN_ASIA;
-            case "Southern Europe":
-                return SUB_REGION.SOUTHERN_EUROPE;
-            case "Western Africa":
-                return SUB_REGION.WESTERN_AFRICA;
-            case "Western Asia":
-                return SUB_REGION.WESTERN_ASIA;
-            case "Western Europe":
-                return SUB_REGION.WESTERN_EUROPE;
-            default:
-                return SUB_REGION.NORTHERN_EUROPE; // Default value
-        }
-    }
-    /**
-     * Initializes the service with country data.
-     * Should be called once when your application starts.
-     */
-    initialize() {
-        try {
-            // Parse the JSON data
-            const data = JSON.parse(JSON.stringify(file));
-            // deno-lint-ignore no-explicit-any
-            const countriesData = data.countries || [];
-            // Initialize continent and region records
-            Object.values(CONTINENT).forEach((continent) => {
-                this.continentRecord[continent] = [];
-            });
-            Object.values(SUB_REGION).forEach((region) => {
-                this.regionRecord[region] = [];
-            });
-            // Create Country instances from the data
-            const countries = countriesData.map((c) => {
-                const continent = this.mapContinent(c.continent);
-                const region = this.mapRegion(c.region);
-                return new Country(c.name, c.iso_2, c.name_official, c.iso_3, c.flag_emoji, continent, region);
-            });
-            const code_record = {};
-            const iso3_record = {};
-            // const name_record: Record<string, Country> = {};
-            const name_record = {};
-            countries.forEach((country) => {
-                // Populate code records
-                code_record[country.code] = country;
-                iso3_record[country.iso3] = country;
-                // Add to record by name
-                // name_record[country.name.toUpperCase()] = country;
-                // Generate uppercase full name with underscores
-                const nameKey = country.name
-                    .toUpperCase()
-                    .replace(/\s+/g, "_")
-                    .replace(/[-(),.']/g, "")
-                    .replace(/&/g, "AND");
-                name_record[nameKey] = country;
-                // Group countries by continent
-                this.continentRecord[country.continent].push(country);
-                // Group countries by region
-                this.regionRecord[country.region].push(country);
-                this.staticReferences.set(country.code, country);
-                this.staticReferences.set(nameKey, country);
-            });
-            // Add specific country mappings for special cases
-            // Cocos Islands
-            if (code_record["CC"]) {
-                name_record["COCOS_ISLANDS"] = code_record["CC"];
-                this.staticReferences.set("COCOS_ISLANDS", code_record["CC"]);
-            }
-            // Cote d'Ivoire
-            if (code_record["CI"]) {
-                name_record["COTE_DIVOIRE"] = code_record["CI"];
-                this.staticReferences.set("COTE_DIVOIRE", code_record["CI"]);
-            }
-            // Macedonia (North Macedonia)
-            if (code_record["MK"]) {
-                name_record["MACEDONIA"] = code_record["MK"];
-                this.staticReferences.set("MACEDONIA", code_record["MK"]);
-            }
-            // US Virgin Islands
-            if (code_record["VI"]) {
-                name_record["VIRGIN_ISLANDS_US"] = code_record["VI"];
-                this.staticReferences.set("VIRGIN_ISLANDS_US", code_record["VI"]);
-            }
-            // British Virgin Islands
-            if (code_record["VG"]) {
-                name_record["VIRGIN_ISLANDS_BRITISH"] = code_record["VG"];
-                this.staticReferences.set("VIRGIN_ISLANDS_BRITISH", code_record["VG"]);
-            }
-            // Democratic Republic of the Congo
-            if (code_record["CD"]) {
-                name_record["DEMOCRATIC_REPUBLIC_OF_CONGO"] = code_record["CD"];
-                this.staticReferences.set("DEMOCRATIC_REPUBLIC_OF_CONGO", code_record["CD"]);
-            }
-            // Falkland Islands (Malvinas)
-            if (code_record["FK"]) {
-                name_record["FALKLAND_ISLANDS"] = code_record["FK"];
-                this.staticReferences.set("FALKLAND_ISLANDS", code_record["FK"]);
-            }
-            // Lao
-            if (code_record["LA"]) {
-                name_record["LAO"] = code_record["LA"];
-                this.staticReferences.set("LAO", code_record["LA"]);
-            }
-            this.codeRecord = code_record;
-            this.iso3Record = iso3_record;
-            this.nameRecord = name_record;
-            this.countryList = countries;
-            // Initialize static properties on Country class
-            this.initializeCountryStatics();
-        }
-        catch (error) {
-            console.error("Failed to initialize CountryService:", error);
-        }
-    }
-    /**
-     * Initialize the static properties on the Country class
-     */
-    initializeCountryStatics() {
-        // Initialize ISO-2 code properties
-        Object.entries(this.codeRecord).forEach(([code, country]) => {
-            // deno-lint-ignore no-explicit-any
-            Country[code.toUpperCase()] = country;
-        });
-        // Initialize full name properties
-        Object.entries(this.nameRecord).forEach(([fullName, country]) => {
-            // deno-lint-ignore no-explicit-any
-            Country[fullName] = country;
-        });
-    }
-    /**
-     * Gets all countries.
-     * @returns {Country[]} Array of all countries
-     */
-    getAll() {
-        return this.countryList;
-    }
-    /**
-     * Gets static country references to be used by the Country class.
-     * @returns {Map<string, Country>} Map of static references
-     */
-    getStaticReferences() {
-        return this.staticReferences;
-    }
-    /**
-     * Gets all countries as a record.
-     * @returns {Record<string, Country>} Record of country codes and country objects
-     */
-    getAllAsRecord() {
-        return this.codeRecord;
-    }
-    /**
-     * Gets all countries from a specific continent.
-     * @param {CONTINENT} continent The continent enum value
-     * @returns {Country[]} Array of countries in the specified continent
-     */
-    getByContinent(continent) {
-        return this.continentRecord[continent] || [];
-    }
-    /**
-     * Gets all countries from a specific region.
-     * @param {SUB_REGION} region The region enum value
-     * @returns {Country[]} Array of countries in the specified region
-     */
-    getByRegion(region) {
-        return this.regionRecord[region] || [];
-    }
-    /**
-     * Gets the full name record mapping.
-     * @returns {Record<string, Country>} Record of uppercase full name keys to country objects
-     */
-    getFullNameRecord() {
-        return this.nameRecord;
-    }
-    /**
-     * Retrieves a country by its ISO-2 code.
-     * @param {string} code The ISO-2 code of the country.
-     * @returns {Country | undefined} The country corresponding to the ISO code or `undefined` if not found.
-     */
-    fromCode(code) {
-        return this.codeRecord[code.toUpperCase()];
-    }
-    /**
-     * Retrieves a country by its ISO-3 code.
-     * @param {string} iso3 The ISO-3 code of the country.
-     * @returns {Country | undefined} The country corresponding to the ISO-3 code or `undefined` if not found.
-     */
-    fromIso3(iso3) {
-        return this.iso3Record[iso3.toUpperCase()];
-    }
-    /**
-     * Retrieves a country by its name.
-     * @param {string} countryName The name of the country.
-     * @returns {Country | undefined} The country corresponding to the name or `undefined` if not found.
-     */
-    fromName(countryName) {
-        const fullNameKey = countryName
-            .toUpperCase()
-            .replace(/\s+/g, "_")
-            .replace(/[-(),.']/g, "")
-            .replace(/&/g, "AND");
-        const fullNameMatch = this.nameRecord[fullNameKey];
-        if (fullNameMatch)
-            return fullNameMatch;
-        // If not found, try more lenient matching
-        return this.countryList.find((country) => country.name.toLowerCase() === countryName.toLowerCase());
-    }
-    /**
-     * Searches for countries that match the given search term.
-     * @param {string} searchTerm - The partial name or code to search for.
-     * @param {number} [limit=10] - Maximum number of results to return.
-     * @returns {Country[]} Array of matching countries, 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.countryList.filter((country) => country.name.toLowerCase().includes(term) ||
-            country.nameOfficial.toLowerCase().includes(term) ||
-            country.code.toLowerCase().includes(term) ||
-            country.iso3.toLowerCase().includes(term));
-        return results.slice(0, limit);
-    }
-    /**
-     * Compares two Country instances for equality by checking their name and code
-     *
-     * @param {Country} country1 - First country to compare
-     * @param {Country} country2 - Second country to compare
-     * @returns {boolean} True if countries are equal, false otherwise
-     * @private
-     */
-    compare(country1, country2) {
-        return (country1.name === country2.name &&
-            country1.code === country2.code);
-    }
-}

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

@@ -1,96 +0,0 @@
-import { Currency } from "./currency.js";
-/**
- * Service for managing currency data.
- * @class CurrencyService
- */
-export declare class CurrencyService {
-    private static instance;
-    private currencyList;
-    private currencyRecord;
-    private nameRecord;
-    private staticReferences;
-    private constructor();
-    /**
-     * Gets the singleton instance of CurrencyService.
-     * Creates the instance if it doesn't exist.
-     * @static
-     * @returns {CurrencyService} The singleton instance
-     */
-    static getInstance(): CurrencyService;
-    /**
-     * Initializes the service with currency data.
-     * Should be called once when your application starts.
-     */
-    private initialize;
-    /**
-     * Gets all currencies.
-     * @returns {Currency[]} Array of all currencies
-     */
-    getAll(): Currency[];
-    /**
-     * Gets all currencies as a record.
-     * @returns {Record<string, Currency>} Record of currency codes and currency objects
-     */
-    getAllAsRecord(): Record<string, Currency>;
-    /**
-     * Gets static currency references to be used by the Currency class.
-     * @returns {Map<string, Currency>} Map of static references
-     */
-    getStaticReferences(): Map<string, Currency>;
-    /**
-     * Retrieves a currency by its ISO code.
-     * @param {string} code The ISO code of the currency.
-     * @returns {Currency | undefined} The currency corresponding to the ISO code or `undefined` if not found.
-     */
-    fromCode(code: string): Currency | undefined;
-    /**
-     * Retrieves a currency by its name.
-     * @param {string} currencyName The name of the currency.
-     * @returns {Currency | undefined} The currency corresponding to the name or `undefined` if not found.
-     */
-    fromName(currencyName: string): Currency | undefined;
-    /**
-     * Validates if a given ISO currency code is valid
-     *
-     * @param {string | null | undefined} code - The currency code to validate.
-     *   Should be a three-letter ISO currency code (e.g., 'USD', 'EUR').
-     *
-     * @returns {boolean} Returns true if:
-     *   - The currency code is not null/undefined
-     *   - The currency code successfully resolves to a valid Currency instance
-     *   Returns false otherwise.
-     */
-    isValidCode(code?: string | null): boolean;
-    /**
-     * Validates if a given currency name is valid
-     *
-     * @param {string | null | undefined} currencyName - The currency name to validate.
-     *
-     * @returns {boolean} Returns true if:
-     *   - The currency name is not null/undefined
-     *   - The currency name successfully resolves to a valid Currency instance
-     *   Returns false otherwise.
-     */
-    isValidName(currencyName?: string | null): boolean;
-    /**
-     * Gets a regex-ready pattern matching all currency symbols
-     * Pattern is memoized for performance
-     * @returns {string} Pipe-separated pattern of escaped currency symbols
-     *
-     * @example
-     * const pattern = currencyService.getCurrencySymbolPattern();
-     * // Returns something like: "\$|€|\£|¥"
-     */
-    getCurrencySymbolPattern(): string;
-    /**
-     * Escapes special characters in a string for use in regular expressions
-     * @private
-     * @param {string} string - The string to escape
-     * @returns {string} The escaped string
-     *
-     * @example
-     * private escapeRegExp("$") // Returns "\$"
-     */
-    private escapeRegExp;
-}
-//# sourceMappingURL=service.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../src/src/models/currency/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAiBzC;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAkB;IACzC,OAAO,CAAC,YAAY,CAAkB;IACtC,OAAO,CAAC,cAAc,CAAgC;IACtD,OAAO,CAAC,UAAU,CAAgC;IAGlD,OAAO,CAAC,gBAAgB,CAAoC;IAE5D,OAAO;IAEP;;;;;OAKG;IACH,MAAM,CAAC,WAAW,IAAI,eAAe;IAQrC;;;OAGG;IACH,OAAO,CAAC,UAAU;IAmDlB;;;OAGG;IACH,MAAM,IAAI,QAAQ,EAAE;IAIpB;;;OAGG;IACH,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC;IAI1C;;;OAGG;IACH,mBAAmB,IAAI,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC;IAI5C;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAI5C;;;;OAIG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAmBpD;;;;;;;;;;OAUG;IACH,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO;IAM1C;;;;;;;;;OASG;IACH,WAAW,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO;IAMlD;;;;;;;;OAQG;IACH,wBAAwB,IAAI,MAAM;IAUlC;;;;;;;;OAQG;IACH,OAAO,CAAC,YAAY;CAGrB"}

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

@@ -1,194 +0,0 @@
-import { Currency } from "./currency.js";
-import file from "../../data/currencies.js";
-/**
- * Service for managing currency data.
- * @class CurrencyService
- */
-export class CurrencyService {
-    constructor() {
-        Object.defineProperty(this, "currencyList", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: []
-        });
-        Object.defineProperty(this, "currencyRecord", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: {}
-        });
-        Object.defineProperty(this, "nameRecord", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: {}
-        });
-        // Static references for direct access through Currency class
-        Object.defineProperty(this, "staticReferences", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: new Map()
-        });
-    }
-    /**
-     * Gets the singleton instance of CurrencyService.
-     * Creates the instance if it doesn't exist.
-     * @static
-     * @returns {CurrencyService} The singleton instance
-     */
-    static getInstance() {
-        if (!CurrencyService.instance) {
-            CurrencyService.instance = new CurrencyService();
-            CurrencyService.instance.initialize();
-        }
-        return CurrencyService.instance;
-    }
-    /**
-     * Initializes the service with currency data.
-     * Should be called once when your application starts.
-     */
-    initialize() {
-        try {
-            const data = JSON.parse(JSON.stringify(file));
-            const currencies = Object.values(data).map((c) => new Currency(c.symbol, c.name, c.symbol_native, c.decimal_digits, c.rounding, c.code, c.name_plural));
-            const codeRecord = {};
-            const nameRecord = {};
-            currencies.forEach((currency) => {
-                // Populate code record
-                codeRecord[currency.code] = currency;
-                // Add to record by name
-                nameRecord[currency.name.toUpperCase()] = currency;
-                const upperCode = currency.code.toUpperCase();
-                // Add to static references for uppercase code
-                this.staticReferences.set(upperCode, currency);
-                // Add formatted full name static reference based on name property
-                // Transform from "US Dollar" to "US_DOLLAR"
-                const nameKey = currency.name
-                    .toUpperCase()
-                    .replace(/\s+/g, "_")
-                    .replace(/[-(),.']/g, "")
-                    .replace(/&/g, "AND");
-                this.staticReferences.set(nameKey, currency);
-            });
-            this.currencyRecord = codeRecord;
-            this.nameRecord = nameRecord;
-            this.currencyList = currencies;
-        }
-        catch (error) {
-            console.error("Failed to initialize CurrencyService:", error);
-        }
-    }
-    /**
-     * Gets all currencies.
-     * @returns {Currency[]} Array of all currencies
-     */
-    getAll() {
-        return this.currencyList;
-    }
-    /**
-     * Gets all currencies as a record.
-     * @returns {Record<string, Currency>} Record of currency codes and currency objects
-     */
-    getAllAsRecord() {
-        return this.currencyRecord;
-    }
-    /**
-     * Gets static currency references to be used by the Currency class.
-     * @returns {Map<string, Currency>} Map of static references
-     */
-    getStaticReferences() {
-        return this.staticReferences;
-    }
-    /**
-     * Retrieves a currency by its ISO code.
-     * @param {string} code The ISO code of the currency.
-     * @returns {Currency | undefined} The currency corresponding to the ISO code or `undefined` if not found.
-     */
-    fromCode(code) {
-        return this.currencyRecord[code.trim().toUpperCase()];
-    }
-    /**
-     * Retrieves a currency by its name.
-     * @param {string} currencyName The name of the currency.
-     * @returns {Currency | undefined} The currency corresponding to the name or `undefined` if not found.
-     */
-    fromName(currencyName) {
-        const input = currencyName.trim().toUpperCase();
-        // First try direct lookup in name record
-        const directMatch = this.nameRecord[input];
-        if (directMatch)
-            return directMatch;
-        // If not found, try more lenient matching
-        for (const [name, currObj] of Object.entries(this.nameRecord)) {
-            if (name.toUpperCase() === input) {
-                return currObj;
-            }
-        }
-        // Finally, try case-insensitive exact match
-        return this.currencyList.find((currency) => currency.name.toUpperCase() === input);
-    }
-    /**
-     * Validates if a given ISO currency code is valid
-     *
-     * @param {string | null | undefined} code - The currency code to validate.
-     *   Should be a three-letter ISO currency code (e.g., 'USD', 'EUR').
-     *
-     * @returns {boolean} Returns true if:
-     *   - The currency code is not null/undefined
-     *   - The currency code successfully resolves to a valid Currency instance
-     *   Returns false otherwise.
-     */
-    isValidCode(code) {
-        if (!code)
-            return false;
-        const currency = this.fromCode(code);
-        return !!currency;
-    }
-    /**
-     * Validates if a given currency name is valid
-     *
-     * @param {string | null | undefined} currencyName - The currency name to validate.
-     *
-     * @returns {boolean} Returns true if:
-     *   - The currency name is not null/undefined
-     *   - The currency name successfully resolves to a valid Currency instance
-     *   Returns false otherwise.
-     */
-    isValidName(currencyName) {
-        if (!currencyName)
-            return false;
-        const currency = this.fromName(currencyName);
-        return !!currency;
-    }
-    /**
-     * Gets a regex-ready pattern matching all currency symbols
-     * Pattern is memoized for performance
-     * @returns {string} Pipe-separated pattern of escaped currency symbols
-     *
-     * @example
-     * const pattern = currencyService.getCurrencySymbolPattern();
-     * // Returns something like: "\$|€|\£|¥"
-     */
-    getCurrencySymbolPattern() {
-        const symbols = new Set();
-        Object.values(this.currencyList).forEach((currency) => {
-            symbols.add(this.escapeRegExp(currency.symbol));
-            symbols.add(this.escapeRegExp(currency.symbolNative));
-        });
-        return Array.from(symbols).join("|");
-    }
-    /**
-     * Escapes special characters in a string for use in regular expressions
-     * @private
-     * @param {string} string - The string to escape
-     * @returns {string} The escaped string
-     *
-     * @example
-     * private escapeRegExp("$") // Returns "\$"
-     */
-    escapeRegExp(string) {
-        return string.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-    }
-}