🤖 Merge PR DefinitelyTyped#73973 feat(geoip-country): update types for country lookups by @prenaissance

Author: prenaissance

types/geoip-country/index.d.ts

@@ -3,12 +3,31 @@ export interface Lookup {
     range: [number, number];
     /** 2 letter ISO-3166-1 country code https://www.iban.com/country-codes */
     country: string;
+    /** Full country name */
+    name?: string;
+    /** Native country name */
+    native?: string;
+    /** Full capital name */
+    capital?: string;
+    continent?: "AF" | "AN" | "AS" | "EU" | "NA" | "OC" | "SA";
+    continent_name?: "Africa" | "Antarctica" | "Asia" | "Europe" | "North America" | "Oceania" | "South America";
+    /** ISO 639-1 2 letter language codes */
+    languages?: string[];
+    /** ISO 4217 currency codes */
+    currency?: string[];
+    /** Phone number prefixes */
+    phone?: string[];
 }
 
 export type CmpArgs = number | [number];
 export type CmpResult = 1 | -1 | 0 | null;
 
 export function cmp(a: CmpArgs, b: CmpArgs): null | Lookup;
+/**
+ * @param ip ipv4, ipv6 or "dual stack" IP (e.g. `"::ffff:8.8.8.8"`)
+ *
+ * @returns null for local IPs and unknown IP ranges, otherwise an object with country info
+ */
 export function lookup(ip: string | number): null | Lookup;
 export function pretty(ip: string | number | Array<string | number>): string;
 export function startWatchingDataUpdate(cb?: (err?: Error) => void): void;

types/geoip-country/package.json

@@ -1,7 +1,7 @@
 {
     "private": true,
     "name": "@types/geoip-country",
-    "version": "4.0.9999",
+    "version": "5.0.9999",
     "projects": [
         "https://github.com/sapics/geoip-country"
     ],