countries-geo 0.0.1

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Shu Ding
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,62 @@
+<div align="center">
+  <a href="https://countries-geo.vercel.app">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://github.com/godfrednanaowusu/countries-geo/blob/main/www/public/logo.png">
+      <img alt="Countries Geo logo" src="https://github.com/godfrednanaowusu/countries-geo/blob/main/www/public/logo.png" height="128">
+    </picture>
+  </a>
+  <h1>Countries Geo</h1>
+
+[![Bundle Size](https://img.shields.io/bundlephobia/minzip/countries-geo?logo=npm&style=for-the-badge&labelColor=0000FF)](https://npmjs.com/package/countries-geo)
+[![Version](https://img.shields.io/npm/v/countries-geo?logo=npm&style=for-the-badge&labelColor=000000)](https://npmjs.com/package/countries-geo)
+[![License](https://img.shields.io/npm/l/countries-geo?logo=npm&style=for-the-badge&labelColor=000000)](https://npmjs.com/package/countries-geo/LICENSE.md)
+[![Downloads](https://img.shields.io/npm/dm/countries-geo?logo=npm&style=for-the-badge&labelColor=000000)](https://npmjs.com/package/countries-geo)
+[![GitHub Repo stars](https://img.shields.io/github/stars/godfrednanaowusu/countries-geo?style=for-the-badge&logo=github&labelColor=000000)](https://github.com/godfrednanaowusu/countries-geo)
+[![GitHub Forks](https://img.shields.io/github/forks/godfrednanaowusu/countries-geo?style=for-the-badge&logo=github&labelColor=000000)](https://github.com/godfrednanaowusu/countries-geo)
+
+</div>
+
+## Getting Started
+
+Utility that provide simple functions to improve the ease of fetching Continents, Countries, States and Cities..
+
+- Visit our [Site](https://countries-geo.vercel.app) to learn more.
+
+## Documentation
+
+Visit [https://countries-geo.vercel.app/docs](https://countries-geo.vercel.app/docs) to view the full documentation.
+
+## Contributing
+
+Contributions to Countries Geo are welcome and highly appreciated. However, before you jump right into it, we would like you to review our [Contribution Guidelines](/contributing.md) to make sure you have a smooth experience contributing to Countries Geo.
+
+## Installation
+
+### with Yarn
+```sh filename="shell" copy
+$ yarn add countries-geo
+```
+
+### with npm
+```sh filename="shell" copy
+$ npm i countries-geo
+```
+
+### with pnpm
+```sh filename="shell" copy
+$ pnpm add countries-geo
+```
+
+### with Bun
+```sh filename="shell" copy
+$ bun add countries-geo
+````
+
+## Support Countries Geo
+
+To support this project, kindly click on this link.
+[[Contribute](https://opencollective.com/countries-geo/contribute)]
+
+## License
+
+MIT © [Godfred Nana Owusu](https://github.com/godfrednanaowusu)

package/dist/cities.d.ts

@@ -0,0 +1,8 @@
+declare const _default: {
+    getAll: import("./utils/interface").TCity[];
+    sortByIsoCode: import("./utils/interface").TCity[];
+    getByCountry: (iso: string) => import("./utils/interface").TCity[];
+    getByState: (iso: string) => import("./utils/interface").TCity[];
+    getByContinent: (iso: string) => import("./utils/interface").TCity[];
+};
+export default _default;

package/dist/cities.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const cities_1 = require("./utils/cities");
+// Get a list of all cities.
+const getAll = (0, cities_1.cities)()?.sort((a, b) => a.name.localeCompare(b.name));
+// Get an isoCode sorted cities
+const sortByIsoCode = (0, cities_1.cities)()?.sort((a, b) => a.iso.localeCompare(b.iso));
+// Get a state filtered cities
+const getByState = (iso) => (0, cities_1.cities_by_state)(iso);
+// Get a country filtered cities
+const getByCountry = (iso) => (0, cities_1.cities_by_country)(iso);
+// Get a continent filtered cities
+const getByContinent = (iso) => (0, cities_1.cities_by_continent)(iso);
+exports.default = {
+    getAll,
+    sortByIsoCode,
+    getByCountry,
+    getByState,
+    getByContinent
+};

package/dist/continents.d.ts

@@ -0,0 +1,5 @@
+declare const _default: {
+    getAll: import("./utils/interface").TContinent[];
+    sortByIsoCode: import("./utils/interface").TContinent[];
+};
+export default _default;

package/dist/continents.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const continents_1 = require("./utils/continents");
+// Get a list of all continents.
+const getAll = (0, continents_1.continents)()?.sort((a, b) => a.name.localeCompare(b.name));
+// Get an isoCode sorted continents
+const sortByIsoCode = (0, continents_1.continents)()?.sort((a, b) => a.iso.localeCompare(b.iso));
+exports.default = { getAll, sortByIsoCode };

package/dist/countries.d.ts

@@ -0,0 +1,6 @@
+declare const _default: {
+    getAll: import("./utils/interface").TCountry[];
+    sortByIsoCode: import("./utils/interface").TCountry[];
+    getByContinent: (iso: string) => import("./utils/interface").TCountry[];
+};
+export default _default;

package/dist/countries.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const countries_1 = require("./utils/countries");
+// Get a list of all countries.
+const getAll = (0, countries_1.countries)()?.sort((a, b) => a.name.localeCompare(b.name));
+// Get an isoCode sorted countries
+const sortByIsoCode = (0, countries_1.countries)()?.sort((a, b) => a.iso.localeCompare(b.iso));
+// Get a continent filtered countries
+const getByContinent = (iso) => (0, countries_1.countries_by_continent)(iso);
+exports.default = {
+    getAll,
+    sortByIsoCode,
+    getByContinent,
+};

package/dist/data.json

@@ -0,0 +1,691 @@
+[
+    { "i": "AF", "n": "Africa", "cn": [
+            { "i": "DZ", "n": "Algeria", "s": [] },
+            { "i": "AO", "n": "Angola", "s": [] },
+            { "i": "BJ", "n": "Benin", "s": [] },
+            { "i": "BW", "n": "Botswana", "s": [] },
+            { "i": "BF", "n": "Burkina Faso", "s": [] },
+            { "i": "BI", "n": "Burundi", "s": [] },
+            { "i": "CV", "n": "Cabo Verde", "s": [] },
+            { "i": "CM", "n": "Cameroon", "s": [] },
+            { "i": "CF", "n": "Central African Republic", "s": [] },
+            { "i": "TD", "n": "Chad", "s": [] },
+            { "i": "KM", "n": "Comoros", "s": [] },
+            { "i": "CD", "n": "Democratic Republic of the Congo", "s": [] },
+            { "i": "CG", "n": "Republic of the Congo", "s": [] },
+            { "i": "CI", "n": "Côte d'Ivoire", "s": [] },
+            { "i": "DJ", "n": "Djibouti", "s": [] },
+            { "i": "EG", "n": "Egypt", "s": [] },
+            { "i": "GQ", "n": "Equatorial Guinea", "s": [] },
+            { "i": "ER", "n": "Eritrea", "s": [] },
+            { "i": "SZ", "n": "Eswatini", "s": [] },
+            { "i": "ET", "n": "Ethiopia", "s": [] },
+            { "i": "GA", "n": "Gabon", "s": [] },
+            { "i": "GM", "n": "Gambia", "s": [] },
+            { "i": "GH", "n": "Ghana", "s": [
+                    { "i": "AA", "n": "Greater Accra", "c": [
+                            { "i": "AC", "n": "Accra Central" },
+                            { "i": "TE", "n": "Tema" },
+                            { "i": "ACH", "n": "Achimota" },
+                            { "i": "AD", "n": "Adenta" },
+                            { "i": "AS", "n": "Ashaiman" },
+                            { "i": "DO", "n": "Dodowa" },
+                            { "i": "DA", "n": "Dawhenya" },
+                            { "i": "LE", "n": "Lashibi" },
+                            { "i": "MA", "n": "Madina" },
+                            { "i": "NI", "n": "Nungua" },
+                            { "i": "LA", "n": "Labadi" },
+                            { "i": "OS", "n": "Osu" },
+                            { "i": "LEG", "n": "Legon" },
+                            { "i": "TS", "n": "Teshie" },
+                            { "i": "KA", "n": "Kaneshie" },
+                            { "i": "KO", "n": "Korle Bu" },
+                            { "i": "KW", "n": "Kwabenya" },
+                            { "i": "AB", "n": "Abokobi" },
+                            { "i": "AM", "n": "Amasaman" },
+                            { "i": "PR", "n": "Prampram" },
+                            { "i": "SE", "n": "Sege" },
+                            { "i": "SA", "n": "Sakumono" },
+                            { "i": "SP", "n": "Spintex" },
+                            { "i": "TA", "n": "Taifa" },
+                            { "i": "TR", "n": "Trassaco Valley" },
+                            { "i": "DZ", "n": "Dzorwulu" },
+                            { "i": "EA", "n": "East Legon" },
+                            { "i": "HA", "n": "Haatso" },
+                            { "i": "LP", "n": "Lapaz" },
+                            { "i": "MC", "n": "McCarthy Hill" },
+                            { "i": "MI", "n": "Mile 7" },
+                            { "i": "OD", "n": "Odorkor" },
+                            { "i": "OB", "n": "Oblogo" },
+                            { "i": "OY", "n": "Oyibi" },
+                            { "i": "PE", "n": "Pokuase" },
+                            { "i": "SH", "n": "Shiashie" },
+                            { "i": "SU", "n": "Sukura" },
+                            { "i": "TA", "n": "Tabora" },
+                            { "i": "TU", "n": "Tudu" },
+                            { "i": "WE", "n": "Weija" },
+                            { "i": "ZO", "n": "Zongo Junction" },
+                            { "i": "ADM", "n": "Adabraka" },
+                            { "i": "AGR", "n": "Agbogba" },
+                            { "i": "AIR", "n": "Airport Residential Area" },
+                            { "i": "ALG", "n": "Alajo" },
+                            { "i": "APO", "n": "Apollo" },
+                            { "i": "ATI", "n": "Atomic" },
+                            { "i": "BAN", "n": "Banana Inn" },
+                            { "i": "BUK", "n": "Bukom" },
+                            { "i": "CAN", "n": "Cantonments" },
+                            { "i": "CHR", "n": "Chorkor" },
+                            { "i": "DAN", "n": "Dansoman" },
+                            { "i": "FAF", "n": "Fafraha" },
+                            { "i": "GIM", "n": "Gimpa" },
+                            { "i": "JAM", "n": "Jamestown" },
+                            { "i": "KIS", "n": "Kisseman" },
+                            { "i": "KOK", "n": "Kokomlemle" },
+                            { "i": "MAM", "n": "Mamprobi" },
+                            { "i": "NII", "n": "Nii Boi Town" },
+                            { "i": "OPP", "n": "Opeibea" },
+                            { "i": "PAN", "n": "Pantang" },
+                            { "i": "RID", "n": "Ridge" },
+                            { "i": "SAN", "n": "Santa Maria" },
+                            { "i": "SOW", "n": "Sowutuom" },
+                            { "i": "TAN", "n": "Tantra Hills" },
+                            { "i": "TES", "n": "Tesano" },
+                            { "i": "ZEN", "n": "Zenka" }
+                        ] },
+                    { "i": "AH", "n": "Ashanti", "c": [
+                            { "i": "KS", "n": "Kumasi City" },
+                            { "i": "AD", "n": "Adum" },
+                            { "i": "BA", "n": "Bantama" },
+                            { "i": "KN", "n": "Kejetia" },
+                            { "i": "AS", "n": "Asokwa" },
+                            { "i": "AT", "n": "Atonsu" },
+                            { "i": "SU", "n": "Suame" },
+                            { "i": "AB", "n": "Abrepo" },
+                            { "i": "TA", "n": "Tafo" },
+                            { "i": "KW", "n": "Kwadaso" },
+                            { "i": "NH", "n": "Nhyiaeso" },
+                            { "i": "MA", "n": "Manhyia" },
+                            { "i": "SA", "n": "Santasi" },
+                            { "i": "PA", "n": "Patasi" },
+                            { "i": "OB", "n": "Obuasi" },
+                            { "i": "EJ", "n": "Ejisu" },
+                            { "i": "KO", "n": "Konongo" },
+                            { "i": "AG", "n": "Agogo" },
+                            { "i": "MF", "n": "Mampong" },
+                            { "i": "BE", "n": "Bekwai" },
+                            { "i": "JC", "n": "Juaso" },
+                            { "i": "NS", "n": "Nsuta" },
+                            { "i": "OD", "n": "Offinso" },
+                            { "i": "TE", "n": "Tepa" },
+                            { "i": "JU", "n": "Jamasi" },
+                            { "i": "BO", "n": "Bompata" },
+                            { "i": "KU", "n": "Kumawu" },
+                            { "i": "NK", "n": "Nkawie" },
+                            { "i": "AF", "n": "Afrancho" },
+                            { "i": "NY", "n": "Nyinahin" },
+                            { "i": "DW", "n": "Dwinyama" },
+                            { "i": "AH", "n": "Ahwiaa" },
+                            { "i": "KE", "n": "Kenyasi" },
+                            { "i": "PR", "n": "Pramso" },
+                            { "i": "AM", "n": "Ampabame" },
+                            { "i": "TI", "n": "Tikrom" },
+                            { "i": "KY", "n": "Kwaso" },
+                            { "i": "AP", "n": "Apromase" },
+                            { "i": "HE", "n": "Hemang" },
+                            { "i": "BR", "n": "Breso" },
+                            { "i": "KJ", "n": "Kodie" },
+                            { "i": "SE", "n": "Sekyere" },
+                            { "i": "FO", "n": "Foase" },
+                            { "i": "YO", "n": "Yonso" },
+                            { "i": "KT", "n": "KNUST Campus" },
+                            { "i": "KA", "n": "Kaase Industrial Area" },
+                            { "i": "DE", "n": "Deduako" },
+                            { "i": "TR", "n": "Trebuom" },
+                            { "i": "BU", "n": "Buokrom Estate" },
+                            { "i": "TN", "n": "Tanoso" }
+                        ] },
+                    { "i": "BO", "n": "Bono", "c": [
+                            { "i": "SU", "n": "Sunyani" },
+                            { "i": "BE", "n": "Berekum" },
+                            { "i": "DO", "n": "Dormaa Ahenkro" },
+                            { "i": "WA", "n": "Wamfie" },
+                            { "i": "NK", "n": "Nkoranza" },
+                            { "i": "JA", "n": "Jaman North" },
+                            { "i": "TE", "n": "Techiman (Food Trade Hub)" },
+                            { "i": "WE", "n": "Wenchi" },
+                            { "i": "NS", "n": "Nsawkaw" }
+                        ] },
+                    { "i": "BE", "n": "Bono East", "c": [
+                            { "i": "TE", "n": "Techiman" },
+                            { "i": "KP", "n": "Kintampo" },
+                            { "i": "NK", "n": "Nkoranza" },
+                            { "i": "PR", "n": "Prang" },
+                            { "i": "YE", "n": "Yeji (Fishing Port)" },
+                            { "i": "KA", "n": "Kajaji" },
+                            { "i": "JE", "n": "Jema" },
+                            { "i": "BU", "n": "Buoyem" }
+                        ] },
+                    { "i": "CP", "n": "Central", "c": [
+                            { "i": "CA", "n": "Cape Coast" },
+                            { "i": "EL", "n": "Elmina (Historic Port)" },
+                            { "i": "SW", "n": "Swedru" },
+                            { "i": "KA", "n": "Kasoa (Urban Hub)" },
+                            { "i": "WI", "n": "Winneba" },
+                            { "i": "DU", "n": "Dunkwa-on-Offin" },
+                            { "i": "AS", "n": "Assin Fosu" },
+                            { "i": "SA", "n": "Saltpond (Oil Discovery Site)" }
+                        ] },
+                    { "i": "EP", "n": "Eastern", "c": [
+                            { "i": "KO", "n": "Koforidua" },
+                            { "i": "AK", "n": "Akim Oda" },
+                            { "i": "NS", "n": "Nsawam" },
+                            { "i": "SU", "n": "Suhum" },
+                            { "i": "MP", "n": "Mpraeso (Kwahu Plateau)" },
+                            { "i": "DO", "n": "Donkorkrom" },
+                            { "i": "AB", "n": "Aburi (Botanical Gardens)" },
+                            { "i": "AS", "n": "Asamankese" }
+                        ] },
+                    { "i": "NP", "n": "Northern", "c": [
+                            { "i": "TA", "n": "Tamale" },
+                            { "i": "YE", "n": "Yendi" },
+                            { "i": "SA", "n": "Savelugu" },
+                            { "i": "GU", "n": "Gushegu" },
+                            { "i": "KP", "n": "Karaga" },
+                            { "i": "BU", "n": "Buipe (Transport Hub)" },
+                            { "i": "DA", "n": "Damongo" },
+                            { "i": "WA", "n": "Walewale" }
+                        ] },
+                    { "i": "SV", "n": "Savannah", "c": [
+                            { "i": "DA", "n": "Damongo (Regional Capital)" },
+                            { "i": "BO", "n": "Bole" },
+                            { "i": "DO", "n": "Daboya (Salt Mining Town)" },
+                            { "i": "SO", "n": "Sawla" },
+                            { "i": "LA", "n": "Larabanga (Mystic Stone)" },
+                            { "i": "BU", "n": "Busunu" },
+                            { "i": "FU", "n": "Fufulso" },
+                            { "i": "TU", "n": "Tuna" },
+                            { "i": "KP", "n": "Kpalbe" }
+                        ] },
+                    { "i": "UE", "n": "Upper East", "c": [
+                            { "i": "BO", "n": "Bolgatanga (Regional Capital)" },
+                            { "i": "BI", "n": "Bawku" },
+                            { "i": "ZO", "n": "Zuarungu" },
+                            { "i": "NA", "n": "Navrongo" },
+                            { "i": "PA", "n": "Paga (Sacred Crocodile Ponds)" },
+                            { "i": "TE", "n": "Tongo" },
+                            { "i": "BU", "n": "Bongo" },
+                            { "i": "TA", "n": "Talensi" },
+                            { "i": "KA", "n": "Kassena-Nankana" }
+                        ] },
+                    { "i": "UW", "n": "Upper West", "c": [
+                            { "i": "WA", "n": "Wa (Regional Capital)" },
+                            { "i": "TU", "n": "Tumu" },
+                            { "i": "JI", "n": "Jirapa" },
+                            { "i": "NA", "n": "Nadowli" },
+                            { "i": "LA", "n": "Lawra" },
+                            { "i": "HA", "n": "Hamile (Burkina Faso Border)" },
+                            { "i": "WE", "n": "Wellembelle" },
+                            { "i": "DA", "n": "Daffiama" },
+                            { "i": "FU", "n": "Funsi" }
+                        ] },
+                    { "i": "TV", "n": "Volta", "c": [
+                            { "i": "HO", "n": "Ho (Regional Capital)" },
+                            { "i": "KE", "n": "Keta (Historic Slave Port)" },
+                            { "i": "KP", "n": "Kpando" },
+                            { "i": "HO", "n": "Hohoe" },
+                            { "i": "JO", "n": "Jasikan" },
+                            { "i": "DA", "n": "Denu (Beach Resort)" },
+                            { "i": "AF", "n": "Afadjato (Highest Peak in Ghana)" },
+                            { "i": "TO", "n": "Togome" },
+                            { "i": "PE", "n": "Peki" }
+                        ] },
+                    { "i": "WP", "n": "Western", "c": [
+                            { "i": "SE", "n": "Sekondi-Takoradi (Regional Capital)" },
+                            { "i": "TA", "n": "Tarkwa (Gold Mining Hub)" },
+                            { "i": "AS", "n": "Axim (Historic Fort)" },
+                            { "i": "EL", "n": "Elubo (Côte d'Ivoire Border)" },
+                            { "i": "BO", "n": "Bogoso" },
+                            { "i": "PP", "n": "Prestea" },
+                            { "i": "DI", "n": "Dixcove (Fishing Harbor)" },
+                            { "i": "HA", "n": "Half Assini" },
+                            { "i": "NS", "n": "Nsuaem" }
+                        ] },
+                    { "i": "NE", "n": "North East", "c": [
+                            { "i": "NA", "n": "Nalerigu (Regional Capital)" },
+                            { "i": "WA", "n": "Walewale" },
+                            { "i": "GA", "n": "Gambaga" },
+                            { "i": "BI", "n": "Bunkpurugu" },
+                            { "i": "CH", "n": "Chereponi" },
+                            { "i": "YA", "n": "Yagaba" },
+                            { "i": "KU", "n": "Kunkwa" },
+                            { "i": "TE", "n": "Tempani" },
+                            { "i": "NK", "n": "Nakpanduri" }
+                        ] },
+                    { "i": "OT", "n": "Oti", "c": [
+                            { "i": "DA", "n": "Dambai (Regional Capital)" },
+                            { "i": "KA", "n": "Kadjebi" },
+                            { "i": "JA", "n": "Jasikan" },
+                            { "i": "KP", "n": "Kpassa" },
+                            { "i": "NK", "n": "Nkwanta" },
+                            { "i": "BI", "n": "Bisunu (Volta Lake Port)" },
+                            { "i": "CH", "n": "Chinderi" },
+                            { "i": "PU", "n": "Pusupu" },
+                            { "i": "KE", "n": "Kete Krachi" }
+                        ] },
+                    { "i": "WN", "n": "Western North", "c": [
+                            { "i": "SE", "n": "Sefwi Wiawso (Regional Capital)" },
+                            { "i": "BI", "n": "Bibiani (Gold & Timber Hub)" },
+                            { "i": "AS", "n": "Asawinso" },
+                            { "i": "AD", "n": "Adjoafua" },
+                            { "i": "AM", "n": "Awaso (Bauxite Mining)" },
+                            { "i": "JU", "n": "Juaboso" },
+                            { "i": "BE", "n": "Bodi" },
+                            { "i": "SU", "n": "Suhum" },
+                            { "i": "KE", "n": "Kenyasi" }
+                        ] },
+                    { "i": "AS", "n": "Ahafo", "c": [
+                            { "i": "GO", "n": "Goaso" },
+                            { "i": "HW", "n": "Hwidiem" },
+                            { "i": "KU", "n": "Kukuom" },
+                            { "i": "MA", "n": "Manfo" },
+                            { "i": "AC", "n": "Acherensua" },
+                            { "i": "DU", "n": "Duayaw Nkwanta" },
+                            { "i": "KE", "n": "Kenyasi (Mining Hub)" },
+                            { "i": "NK", "n": "Nkasiem" },
+                            { "i": "TE", "n": "Terchire" }
+                        ] }
+                ] },
+            { "i": "GN", "n": "Guinea", "s": [] },
+            { "i": "GW", "n": "Guinea-Bissau", "s": [] },
+            { "i": "KE", "n": "Kenya", "s": [] },
+            { "i": "LS", "n": "Lesotho", "s": [] },
+            { "i": "LR", "n": "Liberia", "s": [] },
+            { "i": "LY", "n": "Libya", "s": [] },
+            { "i": "MG", "n": "Madagascar", "s": [] },
+            { "i": "MW", "n": "Malawi", "s": [] },
+            { "i": "ML", "n": "Mali", "s": [] },
+            { "i": "MR", "n": "Mauritania", "s": [] },
+            { "i": "MU", "n": "Mauritius", "s": [] },
+            { "i": "YT", "n": "Mayotte", "s": [] },
+            { "i": "MA", "n": "Morocco", "s": [] },
+            { "i": "MZ", "n": "Mozambique", "s": [] },
+            { "i": "NA", "n": "Namibia", "s": [] },
+            { "i": "NE", "n": "Niger", "s": [] },
+            { "i": "NG", "n": "Nigeria", "s": [
+                    { "i": "AB", "n": "Abia", "c": [] },
+                    { "i": "AD", "n": "Adamawa", "c": [] },
+                    { "i": "AK", "n": "Akwa Ibom", "c": [] },
+                    { "i": "AN", "n": "Anambra", "c": [] },
+                    { "i": "BA", "n": "Bauchi", "c": [] },
+                    { "i": "BY", "n": "Bayelsa", "c": [] },
+                    { "i": "BE", "n": "Benue", "c": [] },
+                    { "i": "BO", "n": "Borno", "c": [] },
+                    { "i": "CR", "n": "Cross River", "c": [] },
+                    { "i": "DE", "n": "Delta", "c": [] },
+                    { "i": "EB", "n": "Ebonyi", "c": [] },
+                    { "i": "ED", "n": "Edo", "c": [] },
+                    { "i": "EK", "n": "Ekiti", "c": [] },
+                    { "i": "EN", "n": "Enugu", "c": [] },
+                    { "i": "FC", "n": "Federal Capital Territory", "c": [] },
+                    { "i": "GO", "n": "Gombe", "c": [] },
+                    { "i": "IM", "n": "Imo", "c": [] },
+                    { "i": "JI", "n": "Jigawa", "c": [] },
+                    { "i": "KD", "n": "Kaduna", "c": [] },
+                    { "i": "KN", "n": "Kano", "c": [] },
+                    { "i": "KT", "n": "Katsina", "c": [] },
+                    { "i": "KE", "n": "Kebbi", "c": [] },
+                    { "i": "KO", "n": "Kogi", "c": [] },
+                    { "i": "KW", "n": "Kwara", "c": [] },
+                    { "i": "LA", "n": "Lagos", "c": [] },
+                    { "i": "NA", "n": "Nasarawa", "c": [] },
+                    { "i": "NI", "n": "Niger", "c": [] },
+                    { "i": "OG", "n": "Ogun", "c": [
+                            { "i": "AB", "n": "Abeokuta" },
+                            { "i": "ABE", "n": "Abigi" },
+                            { "i": "ADO", "n": "Ado-Odo" },
+                            { "i": "AGB", "n": "Agbara" },
+                            { "i": "AK", "n": "Akowonjo" },
+                            { "i": "AR", "n": "Arepo" },
+                            { "i": "AY", "n": "Ayetoro" },
+                            { "i": "EB", "n": "Ebute Ikorodu" },
+                            { "i": "EW", "n": "Ewekoro" },
+                            { "i": "IF", "n": "Ifo" },
+                            { "i": "IJ", "n": "Ijebu-Igbo" },
+                            { "i": "IJE", "n": "Ijebu-Ode" },
+                            { "i": "IJE2", "n": "Ijebu-Ife" },
+                            { "i": "IJE3", "n": "Ijebu-Mushin" },
+                            { "i": "IK", "n": "Ikene" },
+                            { "i": "IL", "n": "Ilaro" },
+                            { "i": "IMO", "n": "Imeko" },
+                            { "i": "IP", "n": "Ipokia" },
+                            { "i": "IS", "n": "Isara" },
+                            { "i": "IT", "n": "Itori" },
+                            { "i": "KO", "n": "Kobape" },
+                            { "i": "MO", "n": "Mowe" },
+                            { "i": "OB", "n": "Oba" },
+                            { "i": "OBA", "n": "Obalende" },
+                            { "i": "OD", "n": "Ode" },
+                            { "i": "ODE", "n": "Ode-Lemo" },
+                            { "i": "OG", "n": "Ogbere" },
+                            { "i": "OGB", "n": "Ogbogbo" },
+                            { "i": "OGE", "n": "Ogere" },
+                            { "i": "OK", "n": "Oke-Ata" },
+                            { "i": "OKE", "n": "Oke-Igbo" },
+                            { "i": "OL", "n": "Olorunda" },
+                            { "i": "OLO", "n": "Olorunsogo" },
+                            { "i": "ONI", "n": "Onigbedu" },
+                            { "i": "OPA", "n": "Opa" },
+                            { "i": "OPE", "n": "Opeji" },
+                            { "i": "OR", "n": "Orile" },
+                            { "i": "OS", "n": "Ososa" },
+                            { "i": "OW", "n": "Owode" },
+                            { "i": "OWE", "n": "Owode-Egba" },
+                            { "i": "OWO", "n": "Owowo" },
+                            { "i": "SA", "n": "Sagamu" },
+                            { "i": "SH", "n": "Shagamu" },
+                            { "i": "SI", "n": "Siun" },
+                            { "i": "TA", "n": "Tapa" },
+                            { "i": "WAS", "n": "Wasimi" },
+                            { "i": "ILU", "n": "Ilugun" },
+                            { "i": "IJU", "n": "Iju" },
+                            { "i": "ATA", "n": "Atan" },
+                            { "i": "IDI", "n": "Idi-Iroko" },
+                            { "i": "IGB", "n": "Igbesa" },
+                            { "i": "IKO", "n": "Ikorodu" },
+                            { "i": "ILA", "n": "Ilaro" },
+                            { "i": "IPA", "n": "Ipokia" },
+                            { "i": "ISA", "n": "Isaga" },
+                            { "i": "ITI", "n": "Itori" },
+                            { "i": "JEM", "n": "Jemta" },
+                            { "i": "KET", "n": "Ketu" },
+                            { "i": "LIS", "n": "Lisabi" },
+                            { "i": "MAG", "n": "Magboro" },
+                            { "i": "MAK", "n": "Makun" },
+                            { "i": "ODO", "n": "Odogbolu" },
+                            { "i": "OFI", "n": "Ofin" },
+                            { "i": "OGU", "n": "Ogudu" },
+                            { "i": "OKA", "n": "Oka-Akoko" },
+                            { "i": "OLI", "n": "Oliwo" },
+                            { "i": "OLU", "n": "Oluke" },
+                            { "i": "ONA", "n": "Onigbongbo" },
+                            { "i": "ORI", "n": "Orile-Ilugun" },
+                            { "i": "OSI", "n": "Osi" },
+                            { "i": "OTA", "n": "Ota" },
+                            { "i": "OWA", "n": "Owa" },
+                            { "i": "OWO", "n": "Owo" },
+                            { "i": "OYE", "n": "Oye" },
+                            { "i": "SAP", "n": "Sapade" },
+                            { "i": "SOK", "n": "Sokoto" },
+                            { "i": "TAL", "n": "Talafia" },
+                            { "i": "TIN", "n": "Tincan" },
+                            { "i": "TOG", "n": "Togun" },
+                            { "i": "TUN", "n": "Tuntun" },
+                            { "i": "WAS", "n": "Wasimi" },
+                            { "i": "YEW", "n": "Yewa" }
+                        ] },
+                    { "i": "ON", "n": "Ondo", "c": [] },
+                    { "i": "OS", "n": "Osun", "c": [] },
+                    { "i": "OY", "n": "Oyo", "c": [] },
+                    { "i": "PL", "n": "Plateau", "c": [] },
+                    { "i": "RI", "n": "Rivers", "c": [] },
+                    { "i": "SO", "n": "Sokoto", "c": [] },
+                    { "i": "TA", "n": "Taraba", "c": [] },
+                    { "i": "YO", "n": "Yobe", "c": [] },
+                    { "i": "ZA", "n": "Zamfara", "c": [] }
+                ] },
+            { "i": "RE", "n": "Réunion", "s": [] },
+            { "i": "RW", "n": "Rwanda", "s": [] },
+            { "i": "SH", "n": "Saint Helena", "s": [] },
+            { "i": "ST", "n": "São Tomé and Príncipe", "s": [] },
+            { "i": "SN", "n": "Senegal", "s": [] },
+            { "i": "SC", "n": "Seychelles", "s": [] },
+            { "i": "SL", "n": "Sierra Leone", "s": [] },
+            { "i": "SO", "n": "Somalia", "s": [] },
+            { "i": "ZA", "n": "South Africa", "s": [] },
+            { "i": "SS", "n": "South Sudan", "s": [] },
+            { "i": "SD", "n": "Sudan", "s": [] },
+            { "i": "TZ", "n": "Tanzania", "s": [] },
+            { "i": "TG", "n": "Togo", "s": [
+                    {
+                        "i": "MA",
+                        "n": "Maritime",
+                        "c": [
+                            { "i": "LO", "n": "Lomé" },
+                            { "i": "AN", "n": "Aného" },
+                            { "i": "TS", "n": "Tsévié" },
+                            { "i": "VA", "n": "Vogan" },
+                            { "i": "TA", "n": "Tabligbo" }
+                        ]
+                    },
+                    {
+                        "i": "PL",
+                        "n": "Plateaux",
+                        "c": [
+                            { "i": "AT", "n": "Atakpamé" },
+                            { "i": "KP", "n": "Kpalimé" },
+                            { "i": "BA", "n": "Badou" },
+                            { "i": "NK", "n": "Notsé" },
+                            { "i": "SO", "n": "Sotouboua" }
+                        ]
+                    },
+                    {
+                        "i": "CE",
+                        "n": "Centrale",
+                        "c": [
+                            { "i": "SO", "n": "Sokodé" },
+                            { "i": "TB", "n": "Tchamba" },
+                            { "i": "SR", "n": "Sotouboua" },
+                            { "i": "BA", "n": "Bafilo" }
+                        ]
+                    },
+                    {
+                        "i": "KA",
+                        "n": "Kara",
+                        "c": [
+                            { "i": "KA", "n": "Kara" },
+                            { "i": "BA", "n": "Bassar" },
+                            { "i": "NA", "n": "Niamtougou" },
+                            { "i": "PR", "n": "Pagouda" }
+                        ]
+                    },
+                    {
+                        "i": "SA",
+                        "n": "Savanes",
+                        "c": [
+                            { "i": "DA", "n": "Dapaong" },
+                            { "i": "MA", "n": "Mango" },
+                            { "i": "TI", "n": "Tandjouaré" },
+                            { "i": "CE", "n": "Cinkassé" }
+                        ]
+                    }
+                ]
+            },
+            { "i": "TN", "n": "Tunisia", "s": [] },
+            { "i": "UG", "n": "Uganda", "s": [] },
+            { "i": "EH", "n": "Western Sahara", "s": [] },
+            { "i": "ZM", "n": "Zambia", "s": [] },
+            { "i": "ZW", "n": "Zimbabwe", "s": [] }
+        ] },
+    { "i": "AQ", "n": "Antarctica", "cn": [
+            { "i": "AQ-ARG", "n": "Argentine Antarctica", "s": [] },
+            { "i": "AQ-AUS", "n": "Australian Antarctic Territory", "s": [] },
+            { "i": "AQ-CHL", "n": "Chilean Antarctic Territory", "s": [] },
+            { "i": "AQ-FRA", "n": "Adélie Land (France)", "s": [] },
+            { "i": "AQ-NZL", "n": "Ross Dependency (New Zealand)", "s": [] },
+            { "i": "AQ-NOR", "n": "Queen Maud Land (Norway)", "s": [] },
+            { "i": "AQ-GBR", "n": "British Antarctic Territory", "s": [] }
+        ] },
+    {
+        "i": "AS",
+        "n": "Asia",
+        "cn": [
+            { "i": "AF", "n": "Afghanistan", "s": [] },
+            { "i": "AM", "n": "Armenia", "s": [] },
+            { "i": "AZ", "n": "Azerbaijan", "s": [] },
+            { "i": "BH", "n": "Bahrain", "s": [] },
+            { "i": "BD", "n": "Bangladesh", "s": [] },
+            { "i": "BT", "n": "Bhutan", "s": [] },
+            { "i": "BN", "n": "Brunei Darussalam", "s": [] },
+            { "i": "KH", "n": "Cambodia", "s": [] },
+            { "i": "CN", "n": "China", "s": [] },
+            { "i": "CY", "n": "Cyprus", "s": [] },
+            { "i": "GE", "n": "Georgia", "s": [] },
+            { "i": "IN", "n": "India", "s": [] },
+            { "i": "ID", "n": "Indonesia", "s": [] },
+            { "i": "IR", "n": "Iran", "s": [] },
+            { "i": "IQ", "n": "Iraq", "s": [] },
+            { "i": "IL", "n": "Israel", "s": [] },
+            { "i": "JP", "n": "Japan", "s": [] },
+            { "i": "JO", "n": "Jordan", "s": [] },
+            { "i": "KZ", "n": "Kazakhstan", "s": [] },
+            { "i": "KP", "n": "North Korea", "s": [] },
+            { "i": "KR", "n": "South Korea", "s": [] },
+            { "i": "KW", "n": "Kuwait", "s": [] },
+            { "i": "KG", "n": "Kyrgyzstan", "s": [] },
+            { "i": "LA", "n": "Laos", "s": [] },
+            { "i": "LB", "n": "Lebanon", "s": [] },
+            { "i": "MY", "n": "Malaysia", "s": [] },
+            { "i": "MV", "n": "Maldives", "s": [] },
+            { "i": "MN", "n": "Mongolia", "s": [] },
+            { "i": "MM", "n": "Myanmar", "s": [] },
+            { "i": "NP", "n": "Nepal", "s": [] },
+            { "i": "OM", "n": "Oman", "s": [] },
+            { "i": "PK", "n": "Pakistan", "s": [] },
+            { "i": "PH", "n": "Philippines", "s": [] },
+            { "i": "QA", "n": "Qatar", "s": [] },
+            { "i": "RU", "n": "Russia", "s": [] },
+            { "i": "SA", "n": "Saudi Arabia", "s": [] },
+            { "i": "SG", "n": "Singapore", "s": [] },
+            { "i": "LK", "n": "Sri Lanka", "s": [] },
+            { "i": "SY", "n": "Syria", "s": [] },
+            { "i": "TW", "n": "Taiwan", "s": [] },
+            { "i": "TJ", "n": "Tajikistan", "s": [] },
+            { "i": "TH", "n": "Thailand", "s": [] },
+            { "i": "TL", "n": "Timor-Leste", "s": [] },
+            { "i": "TR", "n": "Turkey", "s": [] },
+            { "i": "TM", "n": "Turkmenistan", "s": [] },
+            { "i": "AE", "n": "United Arab Emirates", "s": [] },
+            { "i": "UZ", "n": "Uzbekistan", "s": [] },
+            { "i": "VN", "n": "Vietnam", "s": [] },
+            { "i": "YE", "n": "Yemen", "s": [] }
+        ]
+    },
+    { "i": "EU", "n": "Europe", "cn": [
+            { "i": "AL", "n": "Albania", "s": [] },
+            { "i": "AD", "n": "Andorra", "s": [] },
+            { "i": "AT", "n": "Austria", "s": [] },
+            { "i": "BY", "n": "Belarus", "s": [] },
+            { "i": "BE", "n": "Belgium", "s": [] },
+            { "i": "BA", "n": "Bosnia and Herzegovina", "s": [] },
+            { "i": "BG", "n": "Bulgaria", "s": [] },
+            { "i": "HR", "n": "Croatia", "s": [] },
+            { "i": "CY", "n": "Cyprus", "s": [] },
+            { "i": "CZ", "n": "Czech Republic", "s": [] },
+            { "i": "DK", "n": "Denmark", "s": [] },
+            { "i": "EE", "n": "Estonia", "s": [] },
+            { "i": "FI", "n": "Finland", "s": [] },
+            { "i": "FR", "n": "France", "s": [] },
+            { "i": "DE", "n": "Germany", "s": [] },
+            { "i": "GR", "n": "Greece", "s": [] },
+            { "i": "HU", "n": "Hungary", "s": [] },
+            { "i": "IS", "n": "Iceland", "s": [] },
+            { "i": "IE", "n": "Ireland", "s": [] },
+            { "i": "IT", "n": "Italy", "s": [] },
+            { "i": "LV", "n": "Latvia", "s": [] },
+            { "i": "LI", "n": "Liechtenstein", "s": [] },
+            { "i": "LT", "n": "Lithuania", "s": [] },
+            { "i": "LU", "n": "Luxembourg", "s": [] },
+            { "i": "MT", "n": "Malta", "s": [] },
+            { "i": "MD", "n": "Moldova", "s": [] },
+            { "i": "MC", "n": "Monaco", "s": [] },
+            { "i": "ME", "n": "Montenegro", "s": [] },
+            { "i": "NL", "n": "Netherlands", "s": [] },
+            { "i": "MK", "n": "North Macedonia", "s": [] },
+            { "i": "NO", "n": "Norway", "s": [] },
+            { "i": "PL", "n": "Poland", "s": [] },
+            { "i": "PT", "n": "Portugal", "s": [] },
+            { "i": "RO", "n": "Romania", "s": [] },
+            { "i": "RU", "n": "Russia", "s": [] },
+            { "i": "SM", "n": "San Marino", "s": [] },
+            { "i": "RS", "n": "Serbia", "s": [] },
+            { "i": "SK", "n": "Slovakia", "s": [] },
+            { "i": "SI", "n": "Slovenia", "s": [] },
+            { "i": "ES", "n": "Spain", "s": [] },
+            { "i": "SE", "n": "Sweden", "s": [] },
+            { "i": "CH", "n": "Switzerland", "s": [] },
+            { "i": "TR", "n": "Turkey", "s": [] },
+            { "i": "UA", "n": "Ukraine", "s": [] },
+            { "i": "GB", "n": "United Kingdom", "s": [] },
+            { "i": "VA", "n": "Vatican City", "s": [] }
+        ] },
+    { "i": "NA", "n": "North America", "cn": [
+            { "i": "AG", "n": "Antigua and Barbuda", "s": [] },
+            { "i": "BS", "n": "Bahamas", "s": [] },
+            { "i": "BB", "n": "Barbados", "s": [] },
+            { "i": "BZ", "n": "Belize", "s": [] },
+            { "i": "CA", "n": "Canada", "s": [] },
+            { "i": "CR", "n": "Costa Rica", "s": [] },
+            { "i": "CU", "n": "Cuba", "s": [] },
+            { "i": "DM", "n": "Dominica", "s": [] },
+            { "i": "DO", "n": "Dominican Republic", "s": [] },
+            { "i": "SV", "n": "El Salvador", "s": [] },
+            { "i": "GD", "n": "Grenada", "s": [] },
+            { "i": "GT", "n": "Guatemala", "s": [] },
+            { "i": "HT", "n": "Haiti", "s": [] },
+            { "i": "HN", "n": "Honduras", "s": [] },
+            { "i": "JM", "n": "Jamaica", "s": [] },
+            { "i": "MX", "n": "Mexico", "s": [] },
+            { "i": "NI", "n": "Nicaragua", "s": [] },
+            { "i": "PA", "n": "Panama", "s": [] },
+            { "i": "KN", "n": "Saint Kitts and Nevis", "s": [] },
+            { "i": "LC", "n": "Saint Lucia", "s": [] },
+            { "i": "VC", "n": "Saint Vincent and the Grenadines", "s": [] },
+            { "i": "TT", "n": "Trinidad and Tobago", "s": [] },
+            { "i": "US", "n": "United States", "s": [] }
+        ] },
+    { "i": "OC", "n": "Oceania", "cn": [
+            { "i": "AU", "n": "Australia", "s": [] },
+            { "i": "FJ", "n": "Fiji", "s": [] },
+            { "i": "KI", "n": "Kiribati", "s": [] },
+            { "i": "MH", "n": "Marshall Islands", "s": [] },
+            { "i": "FM", "n": "Micronesia", "s": [] },
+            { "i": "NR", "n": "Nauru", "s": [] },
+            { "i": "NZ", "n": "New Zealand", "s": [] },
+            { "i": "PW", "n": "Palau", "s": [] },
+            { "i": "PG", "n": "Papua New Guinea", "s": [] },
+            { "i": "WS", "n": "Samoa", "s": [] },
+            { "i": "SB", "n": "Solomon Islands", "s": [] },
+            { "i": "TO", "n": "Tonga", "s": [] },
+            { "i": "TV", "n": "Tuvalu", "s": [] },
+            { "i": "VU", "n": "Vanuatu", "s": [] },
+            { "i": "AS", "n": "American Samoa", "s": [] },
+            { "i": "CK", "n": "Cook Islands", "s": [] },
+            { "i": "TL", "n": "Easter Island (Chile)", "s": [] },
+            { "i": "PF", "n": "French Polynesia", "s": [] },
+            { "i": "GU", "n": "Guam", "s": [] },
+            { "i": "NC", "n": "New Caledonia", "s": [] },
+            { "i": "NU", "n": "Niue", "s": [] },
+            { "i": "NF", "n": "Norfolk Island", "s": [] },
+            { "i": "MP", "n": "Northern Mariana Islands", "s": [] },
+            { "i": "UM", "n": "Pacific Remote Islands (US)", "s": [] },
+            { "i": "PN", "n": "Pitcairn Islands", "s": [] },
+            { "i": "TK", "n": "Tokelau", "s": [] },
+            { "i": "WF", "n": "Wallis and Futuna", "s": [] }
+        ] },
+    { "i": "SA", "n": "South America", "cn": [
+            { "i": "AR", "n": "Argentina", "s": [] },
+            { "i": "BO", "n": "Bolivia", "s": [] },
+            { "i": "BR", "n": "Brazil", "s": [] },
+            { "i": "CL", "n": "Chile", "s": [] },
+            { "i": "CO", "n": "Colombia", "s": [] },
+            { "i": "EC", "n": "Ecuador", "s": [] },
+            { "i": "FK", "n": "Falkland Islands (Islas Malvinas)", "s": [] },
+            { "i": "GF", "n": "French Guiana", "s": [] },
+            { "i": "GY", "n": "Guyana", "s": [] },
+            { "i": "PY", "n": "Paraguay", "s": [] },
+            { "i": "PE", "n": "Peru", "s": [] },
+            { "i": "SR", "n": "Suriname", "s": [] },
+            { "i": "UY", "n": "Uruguay", "s": [] },
+            { "i": "VE", "n": "Venezuela", "s": [] }
+        ] }
+]

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import Continents from './continents';
+import Countries from './countries';
+import States from './states';
+import Cities from './cities';
+export { Continents };
+export { Countries };
+export { States };
+export { Cities };

package/dist/index.js

@@ -0,0 +1,14 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Cities = exports.States = exports.Countries = exports.Continents = void 0;
+const continents_1 = __importDefault(require("./continents"));
+exports.Continents = continents_1.default;
+const countries_1 = __importDefault(require("./countries"));
+exports.Countries = countries_1.default;
+const states_1 = __importDefault(require("./states"));
+exports.States = states_1.default;
+const cities_1 = __importDefault(require("./cities"));
+exports.Cities = cities_1.default;

package/dist/states.d.ts

@@ -0,0 +1,13 @@
+declare const _default: {
+    getAll: import("./utils/interface").TState[];
+    sortByIsoCode: import("./utils/interface").TState[];
+    getByCountry: (iso: string) => {
+        iso: string;
+        name: string;
+    }[];
+    getByContinent: (iso: string) => {
+        iso: string;
+        name: string;
+    }[];
+};
+export default _default;

package/dist/states.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const states_1 = require("./utils/states");
+// Get a list of all states.
+const getAll = (0, states_1.states)()?.sort((a, b) => a.name.localeCompare(b.name));
+// Get an isoCode sorted states
+const sortByIsoCode = (0, states_1.states)()?.sort((a, b) => a.iso.localeCompare(b.iso));
+// Get a country filtered states
+const getByCountry = (iso) => (0, states_1.states_by_country)(iso);
+// Get a continent filtered states
+const getByContinent = (iso) => (0, states_1.states_by_continent)(iso);
+exports.default = {
+    getAll,
+    sortByIsoCode,
+    getByCountry,
+    getByContinent
+};

package/dist/utils/cities.d.ts

@@ -0,0 +1,5 @@
+import { TCity } from './interface';
+export declare const cities: () => TCity[];
+export declare const cities_by_state: (iso: string) => TCity[];
+export declare const cities_by_country: (iso: string) => TCity[];
+export declare const cities_by_continent: (iso: string) => TCity[];

package/dist/utils/cities.js

@@ -0,0 +1,66 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cities_by_continent = exports.cities_by_country = exports.cities_by_state = exports.cities = void 0;
+const data_json_1 = __importDefault(require("../data.json"));
+// Cities
+const cities = () => data_json_1.default.flatMap(continent => continent.cn).flatMap(country => country.s || []).flatMap(state => state.c || []).map(city => ({ iso: city.i, name: city.n }));
+exports.cities = cities;
+const cities_by_state = (iso) => {
+    try {
+        // Validate input format (e.g., 'GH-AA')
+        if (!iso || typeof iso !== 'string' || iso.split('-').length !== 2) {
+            return [];
+        }
+        const [countryIso, stateIso] = iso.split('-');
+        // Safely traverse the data structure
+        if (!data_json_1.default || !Array.isArray(data_json_1.default))
+            return [];
+        for (const continent of data_json_1.default) {
+            if (!continent.cn || !Array.isArray(continent.cn))
+                continue;
+            for (const country of continent.cn) {
+                if (country.i === countryIso) {
+                    // Check if states exist and are iterable
+                    if (!country.s || !Array.isArray(country.s))
+                        return [];
+                    const state = country.s.find(s => s.i === stateIso);
+                    // Check if cities exist and are iterable
+                    if (state?.c && Array.isArray(state.c)) {
+                        return state.c.map(city => ({
+                            iso: `${countryIso}-${stateIso}-${city.i}`,
+                            name: city.n
+                        }));
+                    }
+                    return []; // State found but no cities
+                }
+            }
+        }
+        return []; // No matching country/state found
+    }
+    catch (error) {
+        console.error('Error in cities_by_state:', error);
+        return [];
+    }
+};
+exports.cities_by_state = cities_by_state;
+const cities_by_country = (iso) => {
+    return data_json_1.default
+        .flatMap(continent => continent.cn)
+        .find(country => country.i === iso)
+        ?.s?.flatMap(state => state.c || [])
+        ?.map(city => ({ iso: city.i, name: city.n })) || [];
+};
+exports.cities_by_country = cities_by_country;
+const cities_by_continent = (iso) => {
+    const continent = data_json_1.default.find(c => c.i === iso);
+    if (!continent)
+        return [];
+    return continent.cn
+        .flatMap(country => country.s || [])
+        .flatMap(state => state.c || [])
+        .map(city => ({ iso: city.i, name: city.n }));
+};
+exports.cities_by_continent = cities_by_continent;

package/dist/utils/continents.d.ts

@@ -0,0 +1,2 @@
+import { TContinent } from './interface';
+export declare const continents: () => TContinent[];

package/dist/utils/continents.js

@@ -0,0 +1,10 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.continents = void 0;
+const data_json_1 = __importDefault(require("../data.json"));
+// Continents
+const continents = () => data_json_1.default?.map(({ i, n }) => ({ iso: i, name: n }));
+exports.continents = continents;

package/dist/utils/countries.d.ts

@@ -0,0 +1,3 @@
+import { TCountry } from './interface';
+export declare const countries: () => TCountry[];
+export declare const countries_by_continent: (iso: string) => TCountry[];

package/dist/utils/countries.js

@@ -0,0 +1,20 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.countries_by_continent = exports.countries = void 0;
+const data_json_1 = __importDefault(require("../data.json"));
+// Countries
+const countries = () => data_json_1.default?.flatMap(continent => continent?.cn?.map(country => ({ iso: country.i, name: country.n })));
+exports.countries = countries;
+const countries_by_continent = (iso) => {
+    const continent = data_json_1.default?.find(c => c.i === iso);
+    if (!continent)
+        return [];
+    return continent?.cn?.map(country => ({
+        iso: country.i,
+        name: country.n
+    }));
+};
+exports.countries_by_continent = countries_by_continent;

package/dist/utils/interface.d.ts

@@ -0,0 +1,21 @@
+export type TContinentData = {
+    i: string;
+    n: string;
+    cn: any[];
+};
+export type TContinent = {
+    iso: string;
+    name: string;
+};
+export type TCountry = {
+    iso: string;
+    name: string;
+};
+export type TState = {
+    iso: string;
+    name: string;
+};
+export type TCity = {
+    iso: string;
+    name: string;
+};

package/dist/utils/interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/utils/states.d.ts

@@ -0,0 +1,10 @@
+import { TState } from './interface';
+export declare const states: () => TState[];
+export declare const states_by_country: (iso: string) => {
+    iso: string;
+    name: string;
+}[];
+export declare const states_by_continent: (iso: string) => {
+    iso: string;
+    name: string;
+}[];

package/dist/utils/states.js

@@ -0,0 +1,29 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.states_by_continent = exports.states_by_country = exports.states = void 0;
+const data_json_1 = __importDefault(require("../data.json"));
+// States
+const states = () => data_json_1.default.flatMap(continent => continent.cn).map(state => ({ iso: state.i, name: state.n }));
+exports.states = states;
+const states_by_country = (iso) => {
+    for (const continent of data_json_1.default) {
+        const country = continent.cn.find(c => c.i === iso);
+        if (country?.s) {
+            return country.s.map(state => ({ iso: state.i, name: state.n }));
+        }
+    }
+    return [];
+};
+exports.states_by_country = states_by_country;
+const states_by_continent = (iso) => {
+    const continent = data_json_1.default.find(c => c.i === iso);
+    if (!continent)
+        return [];
+    return continent.cn
+        .flatMap(country => country.s || [])
+        .map(state => ({ iso: state.i, name: state.n }));
+};
+exports.states_by_continent = states_by_continent;

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "countries-geo",
+  "version": "0.0.1",
+  "private": false,
+  "description": "Library for fetching Continents, Countries, States and its Cities",
+  "license": "MIT",
+  "repository": "https://github.com/godfrednanaowusu/countries-geo",
+  "bugs": "https://github.com/godfrednanaowusu/countries-geo/issues",
+  "homepage": "https://countries-geo.vercel.app",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "latest",
+    "typescript": "latest"
+  },
+  "files": [
+    "dist/**/*"
+  ],
+  "keywords": [
+    "continents",
+    "countries",
+    "states",
+    "cities",
+    "geo data",
+    "countries-geo"
+  ],
+  "packageManager": "pnpm@9.15.4+sha512.b2dc20e2fc72b3e18848459b37359a32064663e5627a51e4c74b2c29dd8e8e0491483c3abb40789cfd578bf362fb6ba8261b05f0387d76792ed6e23ea3b1b6a0"
+}