african-states-and-tribes 2.0.0 → 2.1.0

package/dist/gw-CZCuWEUw.d.mts

@@ -0,0 +1,225 @@
+/**
+ * Get Guinea-Bissau country data
+ * @returns Guinea-Bissau country object
+ */
+declare function getCountry(): Promise<{
+    countryCode: string;
+    phoneCode: number;
+    capitalCity: string;
+    colonialMaster: {
+        name: string;
+        countryCode: string;
+    }[];
+    flagEmoji: string;
+    name: string;
+    currency: string;
+    currencyCode: string;
+    currencySymbol: string;
+    officialLanguage: string;
+    majorEthnicGroups: string[];
+    timezones: {
+        iana: string;
+        gmtOffset: string;
+    }[];
+}>;
+/**
+ * Get Guinea-Bissau states/tribes data
+ * @returns Array of state/tribe data for Guinea-Bissau
+ */
+declare function getStates(): Promise<({
+    capitalCity: string;
+    subdivisions: string[];
+    geoPoliticalZone: string;
+    location: string;
+    name: string;
+    stateCode: string;
+    tribes: string[];
+    type: string;
+} | {
+    capitalCity: string;
+    subdivisions: string[];
+    geoPoliticalZone: string;
+    location: string;
+    name: string;
+    stateCode: string;
+    tribes: string[];
+    type: string;
+} | {
+    capitalCity: string;
+    subdivisions: string[];
+    geoPoliticalZone: string;
+    location: string;
+    name: string;
+    stateCode: string;
+    tribes: string[];
+    type: string;
+} | {
+    capitalCity: string;
+    subdivisions: string[];
+    geoPoliticalZone: string;
+    location: string;
+    name: string;
+    stateCode: string;
+    tribes: string[];
+    type: string;
+} | {
+    capitalCity: string;
+    subdivisions: string[];
+    geoPoliticalZone: string;
+    location: string;
+    name: string;
+    stateCode: string;
+    tribes: string[];
+    type: string;
+} | {
+    capitalCity: string;
+    subdivisions: string[];
+    geoPoliticalZone: string;
+    location: string;
+    name: string;
+    stateCode: string;
+    tribes: string[];
+    type: string;
+} | {
+    capitalCity: string;
+    subdivisions: string[];
+    geoPoliticalZone: string;
+    location: string;
+    name: string;
+    stateCode: string;
+    tribes: string[];
+    type: string;
+} | {
+    capitalCity: string;
+    subdivisions: string[];
+    geoPoliticalZone: string;
+    location: string;
+    name: string;
+    stateCode: string;
+    tribes: string[];
+    type: string;
+} | {
+    capitalCity: string;
+    subdivisions: string[];
+    geoPoliticalZone: string;
+    location: string;
+    name: string;
+    stateCode: string;
+    tribes: string[];
+    type: string;
+})[]>;
+/**
+ * Get Guinea-Bissau country with states/tribes data
+ * @returns Guinea-Bissau country object with states property
+ */
+declare function getCountryAndStates(): Promise<{
+    states: ({
+        capitalCity: string;
+        subdivisions: string[];
+        geoPoliticalZone: string;
+        location: string;
+        name: string;
+        stateCode: string;
+        tribes: string[];
+        type: string;
+    } | {
+        capitalCity: string;
+        subdivisions: string[];
+        geoPoliticalZone: string;
+        location: string;
+        name: string;
+        stateCode: string;
+        tribes: string[];
+        type: string;
+    } | {
+        capitalCity: string;
+        subdivisions: string[];
+        geoPoliticalZone: string;
+        location: string;
+        name: string;
+        stateCode: string;
+        tribes: string[];
+        type: string;
+    } | {
+        capitalCity: string;
+        subdivisions: string[];
+        geoPoliticalZone: string;
+        location: string;
+        name: string;
+        stateCode: string;
+        tribes: string[];
+        type: string;
+    } | {
+        capitalCity: string;
+        subdivisions: string[];
+        geoPoliticalZone: string;
+        location: string;
+        name: string;
+        stateCode: string;
+        tribes: string[];
+        type: string;
+    } | {
+        capitalCity: string;
+        subdivisions: string[];
+        geoPoliticalZone: string;
+        location: string;
+        name: string;
+        stateCode: string;
+        tribes: string[];
+        type: string;
+    } | {
+        capitalCity: string;
+        subdivisions: string[];
+        geoPoliticalZone: string;
+        location: string;
+        name: string;
+        stateCode: string;
+        tribes: string[];
+        type: string;
+    } | {
+        capitalCity: string;
+        subdivisions: string[];
+        geoPoliticalZone: string;
+        location: string;
+        name: string;
+        stateCode: string;
+        tribes: string[];
+        type: string;
+    } | {
+        capitalCity: string;
+        subdivisions: string[];
+        geoPoliticalZone: string;
+        location: string;
+        name: string;
+        stateCode: string;
+        tribes: string[];
+        type: string;
+    })[];
+    countryCode: string;
+    phoneCode: number;
+    capitalCity: string;
+    colonialMaster: {
+        name: string;
+        countryCode: string;
+    }[];
+    flagEmoji: string;
+    name: string;
+    currency: string;
+    currencyCode: string;
+    currencySymbol: string;
+    officialLanguage: string;
+    majorEthnicGroups: string[];
+    timezones: {
+        iana: string;
+        gmtOffset: string;
+    }[];
+}>;
+
+declare const gw_getCountry: typeof getCountry;
+declare const gw_getCountryAndStates: typeof getCountryAndStates;
+declare const gw_getStates: typeof getStates;
+declare namespace gw {
+  export { gw_getCountry as getCountry, gw_getCountryAndStates as getCountryAndStates, gw_getStates as getStates };
+}
+
+export { getCountry as a, getStates as b, getCountryAndStates as c, gw as g };

package/dist/gw-CZCuWEUw.d.ts

@@ -0,0 +1,225 @@
+/**
+ * Get Guinea-Bissau country data
+ * @returns Guinea-Bissau country object
+ */
+declare function getCountry(): Promise<{
+    countryCode: string;
+    phoneCode: number;
+    capitalCity: string;
+    colonialMaster: {
+        name: string;
+        countryCode: string;
+    }[];
+    flagEmoji: string;
+    name: string;
+    currency: string;
+    currencyCode: string;
+    currencySymbol: string;
+    officialLanguage: string;
+    majorEthnicGroups: string[];
+    timezones: {
+        iana: string;
+        gmtOffset: string;
+    }[];
+}>;
+/**
+ * Get Guinea-Bissau states/tribes data
+ * @returns Array of state/tribe data for Guinea-Bissau
+ */
+declare function getStates(): Promise<({
+    capitalCity: string;
+    subdivisions: string[];
+    geoPoliticalZone: string;
+    location: string;
+    name: string;
+    stateCode: string;
+    tribes: string[];
+    type: string;
+} | {
+    capitalCity: string;
+    subdivisions: string[];
+    geoPoliticalZone: string;
+    location: string;
+    name: string;
+    stateCode: string;
+    tribes: string[];
+    type: string;
+} | {
+    capitalCity: string;
+    subdivisions: string[];
+    geoPoliticalZone: string;
+    location: string;
+    name: string;
+    stateCode: string;
+    tribes: string[];
+    type: string;
+} | {
+    capitalCity: string;
+    subdivisions: string[];
+    geoPoliticalZone: string;
+    location: string;
+    name: string;
+    stateCode: string;
+    tribes: string[];
+    type: string;
+} | {
+    capitalCity: string;
+    subdivisions: string[];
+    geoPoliticalZone: string;
+    location: string;
+    name: string;
+    stateCode: string;
+    tribes: string[];
+    type: string;
+} | {
+    capitalCity: string;
+    subdivisions: string[];
+    geoPoliticalZone: string;
+    location: string;
+    name: string;
+    stateCode: string;
+    tribes: string[];
+    type: string;
+} | {
+    capitalCity: string;
+    subdivisions: string[];
+    geoPoliticalZone: string;
+    location: string;
+    name: string;
+    stateCode: string;
+    tribes: string[];
+    type: string;
+} | {
+    capitalCity: string;
+    subdivisions: string[];
+    geoPoliticalZone: string;
+    location: string;
+    name: string;
+    stateCode: string;
+    tribes: string[];
+    type: string;
+} | {
+    capitalCity: string;
+    subdivisions: string[];
+    geoPoliticalZone: string;
+    location: string;
+    name: string;
+    stateCode: string;
+    tribes: string[];
+    type: string;
+})[]>;
+/**
+ * Get Guinea-Bissau country with states/tribes data
+ * @returns Guinea-Bissau country object with states property
+ */
+declare function getCountryAndStates(): Promise<{
+    states: ({
+        capitalCity: string;
+        subdivisions: string[];
+        geoPoliticalZone: string;
+        location: string;
+        name: string;
+        stateCode: string;
+        tribes: string[];
+        type: string;
+    } | {
+        capitalCity: string;
+        subdivisions: string[];
+        geoPoliticalZone: string;
+        location: string;
+        name: string;
+        stateCode: string;
+        tribes: string[];
+        type: string;
+    } | {
+        capitalCity: string;
+        subdivisions: string[];
+        geoPoliticalZone: string;
+        location: string;
+        name: string;
+        stateCode: string;
+        tribes: string[];
+        type: string;
+    } | {
+        capitalCity: string;
+        subdivisions: string[];
+        geoPoliticalZone: string;
+        location: string;
+        name: string;
+        stateCode: string;
+        tribes: string[];
+        type: string;
+    } | {
+        capitalCity: string;
+        subdivisions: string[];
+        geoPoliticalZone: string;
+        location: string;
+        name: string;
+        stateCode: string;
+        tribes: string[];
+        type: string;
+    } | {
+        capitalCity: string;
+        subdivisions: string[];
+        geoPoliticalZone: string;
+        location: string;
+        name: string;
+        stateCode: string;
+        tribes: string[];
+        type: string;
+    } | {
+        capitalCity: string;
+        subdivisions: string[];
+        geoPoliticalZone: string;
+        location: string;
+        name: string;
+        stateCode: string;
+        tribes: string[];
+        type: string;
+    } | {
+        capitalCity: string;
+        subdivisions: string[];
+        geoPoliticalZone: string;
+        location: string;
+        name: string;
+        stateCode: string;
+        tribes: string[];
+        type: string;
+    } | {
+        capitalCity: string;
+        subdivisions: string[];
+        geoPoliticalZone: string;
+        location: string;
+        name: string;
+        stateCode: string;
+        tribes: string[];
+        type: string;
+    })[];
+    countryCode: string;
+    phoneCode: number;
+    capitalCity: string;
+    colonialMaster: {
+        name: string;
+        countryCode: string;
+    }[];
+    flagEmoji: string;
+    name: string;
+    currency: string;
+    currencyCode: string;
+    currencySymbol: string;
+    officialLanguage: string;
+    majorEthnicGroups: string[];
+    timezones: {
+        iana: string;
+        gmtOffset: string;
+    }[];
+}>;
+
+declare const gw_getCountry: typeof getCountry;
+declare const gw_getCountryAndStates: typeof getCountryAndStates;
+declare const gw_getStates: typeof getStates;
+declare namespace gw {
+  export { gw_getCountry as getCountry, gw_getCountryAndStates as getCountryAndStates, gw_getStates as getStates };
+}
+
+export { getCountry as a, getStates as b, getCountryAndStates as c, gw as g };

package/dist/index.d.mts

@@ -1,3 +1,20 @@
+type RegionResult = {
+    capitalCity: string;
+    country: string;
+    countryCode: string;
+    geoPoliticalZone: string;
+    location: string;
+    name: string;
+    stateCode: string;
+    subdivisions: string[];
+    tribes: string[];
+    type: string;
+};
+
+/**
+ * Retrieves all African countries with their metadata.
+ * @returns Array of country objects with countryCode property.
+ */
 declare function getCountries(): Promise<({
     countryCode: string;
     phoneCode: number;
@@ -1019,6 +1036,10 @@ declare function getCountries(): Promise<({
         gmtOffset: string;
     }[];
 })[]>;
+/**
+ * Retrieves all African countries and embeds their tribe data as states.
+ * @returns Array of country objects with states property containing tribe data.
+ */
 declare function getCountriesAndStates(): Promise<({
     states: unknown[];
     countryCode: string;
@@ -2094,8 +2115,29 @@ declare function getCountriesAndStates(): Promise<({
         gmtOffset: string;
     }[];
 })[]>;
+/**
+ * Retrieves a single African country by its code.
+ * @param countryCode - The ISO code of the country.
+ * @returns The country object or empty object if not found.
+ */
 declare function getCountry(countryCode: string): Promise<{}>;
+/**
+ * Retrieves a country and its tribe data as states by country code.
+ * @param countryCode - The ISO code of the country.
+ * @returns Country object with states property or empty object if not found.
+ */
 declare function getCountryAndState(countryCode: string): Promise<{}>;
+/**
+ * Retrieves tribe data (states) for a given country code.
+ * @param countryCode - The ISO code of the country.
+ * @returns Array of tribe data objects for the country.
+ */
 declare function getCountryStates(countryCode: string): Promise<unknown[]>;
+/**
+ * Finds all regions where a specific tribe is located across Africa
+ * @param tribeName - The name of the tribe to search for
+ * @returns Promise resolving to an array of objects containing combined state and country information where the tribe is found
+ */
+declare function getTribeRegion(tribeName: string): Promise<RegionResult[]>;
 
-export { getCountries, getCountriesAndStates, getCountry, getCountryAndState, getCountryStates };
+export { getCountries, getCountriesAndStates, getCountry, getCountryAndState, getCountryStates, getTribeRegion };

package/dist/index.d.ts

@@ -1,3 +1,20 @@
+type RegionResult = {
+    capitalCity: string;
+    country: string;
+    countryCode: string;
+    geoPoliticalZone: string;
+    location: string;
+    name: string;
+    stateCode: string;
+    subdivisions: string[];
+    tribes: string[];
+    type: string;
+};
+
+/**
+ * Retrieves all African countries with their metadata.
+ * @returns Array of country objects with countryCode property.
+ */
 declare function getCountries(): Promise<({
     countryCode: string;
     phoneCode: number;
@@ -1019,6 +1036,10 @@ declare function getCountries(): Promise<({
         gmtOffset: string;
     }[];
 })[]>;
+/**
+ * Retrieves all African countries and embeds their tribe data as states.
+ * @returns Array of country objects with states property containing tribe data.
+ */
 declare function getCountriesAndStates(): Promise<({
     states: unknown[];
     countryCode: string;
@@ -2094,8 +2115,29 @@ declare function getCountriesAndStates(): Promise<({
         gmtOffset: string;
     }[];
 })[]>;
+/**
+ * Retrieves a single African country by its code.
+ * @param countryCode - The ISO code of the country.
+ * @returns The country object or empty object if not found.
+ */
 declare function getCountry(countryCode: string): Promise<{}>;
+/**
+ * Retrieves a country and its tribe data as states by country code.
+ * @param countryCode - The ISO code of the country.
+ * @returns Country object with states property or empty object if not found.
+ */
 declare function getCountryAndState(countryCode: string): Promise<{}>;
+/**
+ * Retrieves tribe data (states) for a given country code.
+ * @param countryCode - The ISO code of the country.
+ * @returns Array of tribe data objects for the country.
+ */
 declare function getCountryStates(countryCode: string): Promise<unknown[]>;
+/**
+ * Finds all regions where a specific tribe is located across Africa
+ * @param tribeName - The name of the tribe to search for
+ * @returns Promise resolving to an array of objects containing combined state and country information where the tribe is found
+ */
+declare function getTribeRegion(tribeName: string): Promise<RegionResult[]>;
 
-export { getCountries, getCountriesAndStates, getCountry, getCountryAndState, getCountryStates };
+export { getCountries, getCountriesAndStates, getCountry, getCountryAndState, getCountryStates, getTribeRegion };

package/dist/index.js

@@ -3652,7 +3652,7 @@ var require_KE = __commonJS({
           location: "Central Kenya",
           name: "Laikipia",
           stateCode: "LAI",
-          tribes: ["Laikipiak Maasai"],
+          tribes: ["Laikipiak Maasai", "Kalenjin"],
           type: "province"
         },
         LAMU: {
@@ -3672,7 +3672,7 @@ var require_KE = __commonJS({
           location: "Central Kenya",
           name: "Machakos",
           stateCode: "MKS",
-          tribes: ["Kikuyu"],
+          tribes: ["Kikuyu", "Kamba"],
           type: "province"
         },
         MOMBASA: {
@@ -5750,7 +5750,7 @@ var require_NG = __commonJS({
           type: "state"
         },
         ANAMBRA: {
-          capitalCity: "Akwa",
+          capitalCity: "Awka",
           subdivisions: [
             "Aguata",
             "Anambra East",
@@ -9992,7 +9992,8 @@ __export(src_exports, {
   getCountriesAndStates: () => getCountriesAndStates,
   getCountry: () => getCountry,
   getCountryAndState: () => getCountryAndState,
-  getCountryStates: () => getCountryStates
+  getCountryStates: () => getCountryStates,
+  getTribeRegion: () => getTribeRegion
 });
 module.exports = __toCommonJS(src_exports);
 
@@ -10211,7 +10212,7 @@ var countries_default = {
         countryCode: "FR"
       }
     ],
-    countryCode: "",
+    countryCode: "DZ",
     flagEmoji: "\u{1F1E9}\u{1F1FF}",
     name: "Algeria",
     currency: "Algerian dinar",
@@ -10605,7 +10606,7 @@ var countries_default = {
     currencyCode: "KES",
     currencySymbol: "KSh",
     officialLanguage: "English",
-    majorEthnicGroups: ["Kalenjin", "Kikuyu", "Luo", "Maasai"],
+    majorEthnicGroups: ["Digo", "Kalenjin", "Kikuyu", "Luhya", "Luo", "Maasai"],
     timezones: [
       {
         iana: "Africa/Nairobi",
@@ -11466,11 +11467,40 @@ async function getCountryStates(countryCode) {
   const tribes = await getTribeData(countryCode);
   return tribes;
 }
+async function getTribeRegion(tribeName) {
+  const countries = await getCountriesAndStates();
+  const regions = [];
+  countries.forEach((country) => {
+    if (country.states && Array.isArray(country.states)) {
+      const matchingStates = country.states.filter(
+        (state) => state.tribes?.some(
+          (tribe) => tribe.toLowerCase().includes(tribeName.toLowerCase())
+        )
+      );
+      matchingStates.forEach((state) => {
+        regions.push({
+          capitalCity: state.capitalCity,
+          country: country.name,
+          countryCode: country.countryCode,
+          geoPoliticalZone: state.geoPoliticalZone || "",
+          location: state.location || "",
+          name: state.name,
+          stateCode: state.stateCode,
+          subdivisions: state.subdivisions || [],
+          tribes: state.tribes || [],
+          type: state.type || ""
+        });
+      });
+    }
+  });
+  return regions;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   getCountries,
   getCountriesAndStates,
   getCountry,
   getCountryAndState,
-  getCountryStates
+  getCountryStates,
+  getTribeRegion
 });