@temboplus/frontend-core 0.2.4 → 0.2.5

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

@@ -1,4 +1,4 @@
-import { Country } from "./country.js";
+import { CONTINENT, Country, SUB_REGION } from "./country.js";
 /**
  * Service for managing country data.
  * @class CountryService
@@ -7,8 +7,10 @@ export declare class CountryService {
     private static instance;
     private countryList;
     private codeRecord;
+    private iso3Record;
     private nameRecord;
-    private fullNameRecord;
+    private continentRecord;
+    private regionRecord;
     private staticReferences;
     private constructor();
     /**
@@ -18,37 +20,71 @@ export declare class CountryService {
      * @returns {CountryService} The singleton instance
      */
     static getInstance(): CountryService;
+    /**
+     * Maps a string continent name to the CONTINENT enum
+     * @param continentName String continent name from JSON
+     * @returns The corresponding CONTINENT enum value
+     */
+    private mapContinent;
+    /**
+     * Maps a string region name to the SUB_REGION enum
+     * @param regionName String region name from JSON
+     * @returns The corresponding SUB_REGION enum value
+     */
+    private mapRegion;
     /**
      * Initializes the service with country data.
      * Should be called once when your application starts.
      */
     private initialize;
+    /**
+     * Initialize the static properties on the Country class
+     */
+    private initializeCountryStatics;
     /**
      * Gets all countries.
      * @returns {Country[]} Array of all countries
      */
     getAll(): Country[];
+    /**
+     * Gets static country references to be used by the Country class.
+     * @returns {Map<string, Country>} Map of static references
+     */
+    getStaticReferences(): Map<string, Country>;
     /**
      * Gets all countries as a record.
      * @returns {Record<string, Country>} Record of country codes and country objects
      */
     getAllAsRecord(): Record<string, Country>;
     /**
-     * Gets static country references to be used by the Country class.
-     * @returns {Map<string, Country>} Map of static references
+     * Gets all countries from a specific continent.
+     * @param {CONTINENT} continent The continent enum value
+     * @returns {Country[]} Array of countries in the specified continent
      */
-    getStaticReferences(): Map<string, Country>;
+    getByContinent(continent: CONTINENT): Country[];
+    /**
+     * 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: SUB_REGION): Country[];
     /**
      * Gets the full name record mapping.
      * @returns {Record<string, Country>} Record of uppercase full name keys to country objects
      */
     getFullNameRecord(): Record<string, Country>;
     /**
-     * Retrieves a country by its ISO code.
-     * @param {string} code The ISO code of the country.
+     * 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: string): Country | undefined;
+    /**
+     * 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: string): Country | undefined;
     /**
      * Retrieves a country by its name.
      * @param {string} countryName The name of the country.

package/script/src/models/country/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../src/src/models/country/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiB;IACxC,OAAO,CAAC,WAAW,CAAiB;IACpC,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,cAAc,CAA+B;IAGrD,OAAO,CAAC,gBAAgB,CAAmC;IAE3D,OAAO;IAEP;;;;;OAKG;IACH,MAAM,CAAC,WAAW,IAAI,cAAc;IAQpC;;;OAGG;IACH,OAAO,CAAC,UAAU;IA2JlB;;;OAGG;IACH,MAAM,IAAI,OAAO,EAAE;IAInB;;;OAGG;IACH,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIzC;;;OAGG;IACH,mBAAmB,IAAI,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;IAI3C;;;OAGG;IACH,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI5C;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAI3C;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAqBlD;;;;;OAKG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,EAAE;IAczD;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO;CAMvD"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../src/src/models/country/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG9D;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiB;IACxC,OAAO,CAAC,WAAW,CAAiB;IACpC,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,UAAU,CAA+B;IAEjD,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,eAAe,CAGrB;IACF,OAAO,CAAC,YAAY,CAGlB;IAGF,OAAO,CAAC,gBAAgB,CAAmC;IAE3D,OAAO;IAEP;;;;;OAKG;IACH,MAAM,CAAC,WAAW,IAAI,cAAc;IAQpC;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAqBpB;;;;OAIG;IACH,OAAO,CAAC,SAAS;IAiDjB;;;OAGG;IACH,OAAO,CAAC,UAAU;IAqIlB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAchC;;;OAGG;IACH,MAAM,IAAI,OAAO,EAAE;IAInB;;;OAGG;IACH,mBAAmB,IAAI,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;IAI3C;;;OAGG;IACH,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIzC;;;;OAIG;IACH,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,EAAE;IAI/C;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,EAAE;IAI1C;;;OAGG;IACH,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI5C;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAI3C;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAI3C;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAgBlD;;;;;OAKG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,EAAE;IAgBzD;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO;CAMvD"}

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

@@ -24,13 +24,26 @@ class CountryService {
             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, "fullNameRecord", {
+        Object.defineProperty(this, "continentRecord", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: {}
+        });
+        Object.defineProperty(this, "regionRecord", {
             enumerable: true,
             configurable: true,
             writable: true,
@@ -57,133 +70,198 @@ class CountryService {
         }
         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 country_js_1.CONTINENT.AFRICA;
+            case "Antarctica":
+                return country_js_1.CONTINENT.ANTARCTICA;
+            case "Asia":
+                return country_js_1.CONTINENT.ASIA;
+            case "Europe":
+                return country_js_1.CONTINENT.EUROPE;
+            case "North America":
+                return country_js_1.CONTINENT.NORTH_AMERICA;
+            case "Oceania":
+                return country_js_1.CONTINENT.OCEANIA;
+            case "South America":
+                return country_js_1.CONTINENT.SOUTH_AMERICA;
+            default:
+                return country_js_1.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 country_js_1.SUB_REGION.AUSTRALIA_AND_NEW_ZEALAND;
+            case "Caribbean":
+                return country_js_1.SUB_REGION.CARIBBEAN;
+            case "Central America":
+                return country_js_1.SUB_REGION.CENTRAL_AMERICA;
+            case "Central Asia":
+                return country_js_1.SUB_REGION.CENTRAL_ASIA;
+            case "Eastern Africa":
+                return country_js_1.SUB_REGION.EASTERN_AFRICA;
+            case "Eastern Asia":
+                return country_js_1.SUB_REGION.EASTERN_ASIA;
+            case "Eastern Europe":
+                return country_js_1.SUB_REGION.EASTERN_EUROPE;
+            case "Melanesia":
+                return country_js_1.SUB_REGION.MELANESIA;
+            case "Micronesia":
+                return country_js_1.SUB_REGION.MICRONESIA;
+            case "Middle Africa":
+                return country_js_1.SUB_REGION.MIDDLE_AFRICA;
+            case "Northern Africa":
+                return country_js_1.SUB_REGION.NORTHERN_AFRICA;
+            case "Northern America":
+                return country_js_1.SUB_REGION.NORTHERN_AMERICA;
+            case "Northern Europe":
+                return country_js_1.SUB_REGION.NORTHERN_EUROPE;
+            case "Polynesia":
+                return country_js_1.SUB_REGION.POLYNESIA;
+            case "South-eastern Asia":
+                return country_js_1.SUB_REGION.SOUTH_EASTERN_ASIA;
+            case "Southern Africa":
+                return country_js_1.SUB_REGION.SOUTHERN_AFRICA;
+            case "Southern Asia":
+                return country_js_1.SUB_REGION.SOUTHERN_ASIA;
+            case "Southern Europe":
+                return country_js_1.SUB_REGION.SOUTHERN_EUROPE;
+            case "Western Africa":
+                return country_js_1.SUB_REGION.WESTERN_AFRICA;
+            case "Western Asia":
+                return country_js_1.SUB_REGION.WESTERN_ASIA;
+            case "Western Europe":
+                return country_js_1.SUB_REGION.WESTERN_EUROPE;
+            default:
+                return country_js_1.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(countries_js_1.default));
-            const countries = Object.values(data).map((c) => new country_js_1.Country(c.name, c.code));
+            // deno-lint-ignore no-explicit-any
+            const countriesData = data.countries || [];
+            // Initialize continent and region records
+            Object.values(country_js_1.CONTINENT).forEach((continent) => {
+                this.continentRecord[continent] = [];
+            });
+            Object.values(country_js_1.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_js_1.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 = {};
-            const fullname_record = {};
             countries.forEach((country) => {
-                // Populate code record
+                // Populate code records
                 code_record[country.code] = country;
+                iso3_record[country.iso3] = country;
                 // Add to record by name
-                name_record[country.name.toUpperCase()] = country;
+                // name_record[country.name.toUpperCase()] = country;
                 // Generate uppercase full name with underscores
-                const fullNameKey = country.name
+                const nameKey = country.name
                     .toUpperCase()
                     .replace(/\s+/g, "_")
                     .replace(/[-(),.']/g, "")
                     .replace(/&/g, "AND");
-                fullname_record[fullNameKey] = country;
-                // Save references for static access
-                this.staticReferences.set(country.code.toUpperCase(), country);
-                this.staticReferences.set(fullNameKey, country);
+                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);
             });
-            // Ensure specific mappings are available
-            if (code_record["US"]) {
-                fullname_record["UNITED_STATES"] = code_record["US"];
-                this.staticReferences.set("UNITED_STATES", code_record["US"]);
-            }
-            // Add specific country mappings
+            // Add specific country mappings for special cases
             // Cocos Islands
             if (code_record["CC"]) {
-                fullname_record["COCOS_ISLANDS"] = code_record["CC"];
+                name_record["COCOS_ISLANDS"] = code_record["CC"];
                 this.staticReferences.set("COCOS_ISLANDS", code_record["CC"]);
             }
-            // Democratic Republic of Congo
-            if (code_record["CD"]) {
-                fullname_record["DEMOCRATIC_REPUBLIC_OF_CONGO"] = code_record["CD"];
-                this.staticReferences.set("DEMOCRATIC_REPUBLIC_OF_CONGO", code_record["CD"]);
-            }
             // Cote d'Ivoire
             if (code_record["CI"]) {
-                fullname_record["COTE_DIVOIRE"] = code_record["CI"];
+                name_record["COTE_DIVOIRE"] = code_record["CI"];
                 this.staticReferences.set("COTE_DIVOIRE", code_record["CI"]);
             }
-            // Falkland Islands
-            if (code_record["FK"]) {
-                fullname_record["FALKLAND_ISLANDS"] = code_record["FK"];
-                this.staticReferences.set("FALKLAND_ISLANDS", code_record["FK"]);
-            }
-            // Holy See (Vatican)
-            if (code_record["VA"]) {
-                fullname_record["HOLY_SEE"] = code_record["VA"];
-                this.staticReferences.set("HOLY_SEE", code_record["VA"]);
-            }
-            // Iran
-            if (code_record["IR"]) {
-                fullname_record["IRAN"] = code_record["IR"];
-                this.staticReferences.set("IRAN", code_record["IR"]);
-            }
-            // North Korea
-            if (code_record["KP"]) {
-                fullname_record["NORTH_KOREA"] = code_record["KP"];
-                this.staticReferences.set("NORTH_KOREA", code_record["KP"]);
-            }
-            // South Korea
-            if (code_record["KR"]) {
-                fullname_record["SOUTH_KOREA"] = code_record["KR"];
-                this.staticReferences.set("SOUTH_KOREA", code_record["KR"]);
-            }
-            // Lao People's Democratic Republic
-            if (code_record["LA"]) {
-                fullname_record["LAO"] = code_record["LA"];
-                this.staticReferences.set("LAO", code_record["LA"]);
-            }
-            // Palestine
-            if (code_record["PS"]) {
-                fullname_record["PALESTINE"] = code_record["PS"];
-                this.staticReferences.set("PALESTINE", code_record["PS"]);
-            }
-            // Macedonia
+            // Macedonia (North Macedonia)
             if (code_record["MK"]) {
-                fullname_record["MACEDONIA"] = code_record["MK"];
+                name_record["MACEDONIA"] = code_record["MK"];
                 this.staticReferences.set("MACEDONIA", code_record["MK"]);
             }
-            // Micronesia
-            if (code_record["FM"]) {
-                fullname_record["MICRONESIA"] = code_record["FM"];
-                this.staticReferences.set("MICRONESIA", code_record["FM"]);
-            }
-            // Moldova
-            if (code_record["MD"]) {
-                fullname_record["MOLDOVA"] = code_record["MD"];
-                this.staticReferences.set("MOLDOVA", code_record["MD"]);
-            }
-            // Taiwan
-            if (code_record["TW"]) {
-                fullname_record["TAIWAN"] = code_record["TW"];
-                this.staticReferences.set("TAIWAN", code_record["TW"]);
-            }
-            // Tanzania
-            if (code_record["TZ"]) {
-                fullname_record["TANZANIA"] = code_record["TZ"];
-                this.staticReferences.set("TANZANIA", code_record["TZ"]);
-            }
             // US Virgin Islands
             if (code_record["VI"]) {
-                fullname_record["VIRGIN_ISLANDS_US"] = 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"]) {
-                fullname_record["VIRGIN_ISLANDS_BRITISH"] = 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.fullNameRecord = fullname_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_js_1.Country[code.toUpperCase()] = country;
+        });
+        // Initialize full name properties
+        Object.entries(this.nameRecord).forEach(([fullName, country]) => {
+            // deno-lint-ignore no-explicit-any
+            country_js_1.Country[fullName] = country;
+        });
+    }
     /**
      * Gets all countries.
      * @returns {Country[]} Array of all countries
@@ -191,6 +269,13 @@ class CountryService {
     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
@@ -199,44 +284,56 @@ class CountryService {
         return this.codeRecord;
     }
     /**
-     * Gets static country references to be used by the Country class.
-     * @returns {Map<string, Country>} Map of static references
+     * Gets all countries from a specific continent.
+     * @param {CONTINENT} continent The continent enum value
+     * @returns {Country[]} Array of countries in the specified continent
      */
-    getStaticReferences() {
-        return this.staticReferences;
+    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.fullNameRecord;
+        return this.nameRecord;
     }
     /**
-     * Retrieves a country by its ISO code.
-     * @param {string} code The ISO code of the country.
+     * 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) {
-        // First try direct lookup in name record
-        const directMatch = this.nameRecord[countryName.toUpperCase()];
-        if (directMatch)
-            return directMatch;
-        // Then try full name record
         const fullNameKey = countryName
             .toUpperCase()
             .replace(/\s+/g, "_")
             .replace(/[-(),.']/g, "")
             .replace(/&/g, "AND");
-        const fullNameMatch = this.fullNameRecord[fullNameKey];
+        const fullNameMatch = this.nameRecord[fullNameKey];
         if (fullNameMatch)
             return fullNameMatch;
         // If not found, try more lenient matching
@@ -255,7 +352,9 @@ class CountryService {
         if (term.length === 0)
             return [];
         const results = this.countryList.filter((country) => country.name.toLowerCase().includes(term) ||
-            country.code.toLowerCase().includes(term));
+            country.nameOfficial.toLowerCase().includes(term) ||
+            country.code.toLowerCase().includes(term) ||
+            country.iso3.toLowerCase().includes(term));
         return results.slice(0, limit);
     }
     /**