Geography API

import { geography } from '@koshmoney/countries/geography';
 
// Or direct imports
import { getContinent, getRegion } from '@koshmoney/countries/geography';

interface GeographyInfo {
  continent: Continent;
  region: Region;
}
 
type Continent =
  | 'Africa'
  | 'Antarctica'
  | 'Asia'
  | 'Europe'
  | 'North America'
  | 'Oceania'
  | 'South America';
 
type Region =
  | 'Northern Africa' | 'Sub-Saharan Africa'
  | 'Antarctica'
  | 'Central Asia' | 'Eastern Asia' | 'South-eastern Asia'
  | 'Southern Asia' | 'Western Asia'
  | 'Eastern Europe' | 'Northern Europe'
  | 'Southern Europe' | 'Western Europe'
  | 'Caribbean' | 'Central America' | 'Northern America'
  | 'South America'
  | 'Australia and New Zealand' | 'Melanesia'
  | 'Micronesia' | 'Polynesia';

import { geography } from '@koshmoney/countries/geography';
 
geography.getContinent('US'); // 'North America'
geography.getContinent('JP'); // 'Asia'
geography.getContinent('DE'); // 'Europe'
geography.getContinent('AU'); // 'Oceania'
geography.getContinent('BR'); // 'South America'
geography.getContinent('NG'); // 'Africa'
geography.getContinent('XX'); // null

import { geography } from '@koshmoney/countries/geography';
 
geography.getRegion('US'); // 'Northern America'
geography.getRegion('JP'); // 'Eastern Asia'
geography.getRegion('DE'); // 'Western Europe'
geography.getRegion('BR'); // 'South America'
geography.getRegion('IN'); // 'Southern Asia'
geography.getRegion('NG'); // 'Sub-Saharan Africa'

import { geography } from '@koshmoney/countries/geography';
 
geography.getGeography('FR');
// { continent: 'Europe', region: 'Western Europe' }
 
geography.getGeography('JP');
// { continent: 'Asia', region: 'Eastern Asia' }
 
geography.getGeography('XX');
// null

import { geography } from '@koshmoney/countries/geography';
 
geography.getCountriesByContinent('Europe');
// ['AD', 'AL', 'AT', 'AX', 'BA', 'BE', ...]
 
geography.getCountriesByContinent('Antarctica');
// ['AQ', 'BV', 'GS', 'HM', 'TF']

import { geography } from '@koshmoney/countries/geography';
 
geography.getCountriesByRegion('Eastern Asia');
// ['CN', 'HK', 'JP', 'KP', 'KR', 'MO', 'MN', 'TW']
 
geography.getCountriesByRegion('Northern America');
// ['BM', 'CA', 'GL', 'PM', 'US']

import { geography } from '@koshmoney/countries/geography';
 
geography.getContinents();
// ['Africa', 'Antarctica', 'Asia', 'Europe', 'North America', 'Oceania', 'South America']

import { geography } from '@koshmoney/countries/geography';
 
geography.getRegions();
// ['Northern Africa', 'Sub-Saharan Africa', 'Antarctica', 'Central Asia', ...]