@parseapi/sdk 0.1.1 → 0.1.2

package/README.md

@@ -41,7 +41,9 @@ await parse.continent.countries('NA');
 await parse.currency('USD');
 await parse.currency.rate('USD', 'EUR');
 await parse.language('en');
+await parse.name('BILLY OSHALL');
 await parse.timezone('America/New_York');
+await parse.timezone(40.7128, -74.006);
 await parse.holiday('US', { year: 2026 });
 await parse.holiday.date('US', '2026-12-25');
 await parse.elevation(35.2271, -80.8431);

package/dist/index.cjs

@@ -24,7 +24,7 @@ __export(index_exports, {
   parseAPI: () => parseAPI
 });
 module.exports = __toCommonJS(index_exports);
-var VERSION = "0.1.1";
+var VERSION = "0.1.2";
 var DEFAULT_BASE_URL = "https://api.parseapi.com";
 var DEFAULT_TIMEOUT_MS = 1e4;
 var DEFAULT_RETRIES = 2;
@@ -118,6 +118,18 @@ function parseAPI(apiKey, options = {}) {
   }
   const enc = encodeURIComponent;
   const deepQuery = (opts) => opts?.deep ? { deep: true } : {};
+  function timezone(idOrLat, lonOrOpts, opts) {
+    if (typeof idOrLat === "number") {
+      return request("/timezone", {
+        lat: idOrLat,
+        lon: typeof lonOrOpts === "number" ? lonOrOpts : void 0,
+        at: opts?.at
+      });
+    }
+    return request(`/timezone/${enc(idOrLat)}`, {
+      at: lonOrOpts && typeof lonOrOpts === "object" ? lonOrOpts.at : void 0
+    });
+  }
   return {
     ip: Object.assign(
       (ip, opts) => request(`/ip/${enc(ip)}`, deepQuery(opts)),
@@ -175,7 +187,8 @@ function parseAPI(apiKey, options = {}) {
       }
     ),
     language: (code) => request(`/language/${enc(code)}`),
-    timezone: (id, opts) => request(`/timezone/${enc(id)}`, { at: opts?.at }),
+    name: (name) => request(`/name/${enc(name)}`),
+    timezone,
     holiday: Object.assign(
       (country, opts) => request(`/holiday/${enc(country)}`, { year: opts?.year }),
       {

package/dist/index.d.cts

@@ -15,6 +15,7 @@ interface IpDeep {
     datacenter: boolean;
     relay: boolean;
     tor: boolean;
+    vpn: boolean;
     provider: string;
 }
 interface Ip {
@@ -38,6 +39,8 @@ interface Continent {
 interface ContinentCountryItem {
     country: string;
     name: string;
+    emoji?: string | null;
+    calling_code?: string | null;
 }
 interface ContinentCountries {
     continent: string;
@@ -52,6 +55,8 @@ interface Country {
     local_name: string | null;
     demonym: string | null;
     capital: string | null;
+    capital_lat: number | null;
+    capital_lon: number | null;
     continent: string;
     region: string | null;
     subregion: string | null;
@@ -61,6 +66,7 @@ interface Country {
     currency_name: string | null;
     currency_symbol: string | null;
     tld: string | null;
+    calling_code: string | null;
     emoji: string | null;
     languages: string[];
     borders: string[];
@@ -189,6 +195,7 @@ interface EmailDeep {
 }
 interface Email {
     email: string;
+    didyoumean: string | null;
     valid: boolean;
     domain: string | null;
     domain_valid: boolean | null;
@@ -197,12 +204,17 @@ interface Email {
     deep?: Deep<EmailDeep>;
 }
 interface PhoneDeep {
-    type: 'mobile' | 'landline' | 'toll_free' | 'unknown';
-    region: string;
+    type: 'mobile' | 'landline' | 'voip' | 'toll_free' | 'unknown';
+    carrier: string | null;
+    /** Carrier is a known burner number app. Null when carrier is unknown. */
+    burner: boolean | null;
+    city: string | null;
+    state: string | null;
+    state_name: string | null;
 }
 interface Phone {
+    phone: string | null;
     valid: boolean;
-    e164: string | null;
     country: string | null;
     national: string | null;
     international: string | null;
@@ -227,7 +239,7 @@ interface DomainDeep {
     ns: string[];
     mx: MxRecord[];
     txt: string[];
-    provider: string;
+    mailhost: string;
     registration: DomainRegistration;
 }
 interface Domain {
@@ -303,6 +315,18 @@ interface Language {
     direction: 'ltr' | 'rtl' | string;
     countries: string[];
 }
+/** A parsed person name. Junk input returns valid: false, never an error. Gender comes from dictionary data and is null when the data does not decide. */
+interface Name {
+    name: string;
+    valid: boolean;
+    prefix: string | null;
+    first: string | null;
+    middle: string | null;
+    last: string | null;
+    suffix: string | null;
+    gender: 'male' | 'female' | null;
+    salutation: 'Mr' | 'Ms' | null;
+}
 interface CurrencyRate {
     base: string;
     quote: string;
@@ -317,12 +341,14 @@ interface TimezoneNextDst {
     abbreviation: string;
 }
 interface Timezone {
-    timezone: string;
+    latitude?: number;
+    longitude?: number;
+    timezone: string | null;
     name: string | null;
-    abbreviation: string;
-    offset: string;
-    offset_minutes: number;
-    dst: boolean;
+    abbreviation: string | null;
+    offset: string | null;
+    offset_minutes: number | null;
+    dst: boolean | null;
     next_dst: TimezoneNextDst | null;
 }
 interface Holiday {
@@ -352,8 +378,8 @@ interface Elevation {
     resolution: number | null;
 }
 interface PointDeep {
-    city: CityNearest;
-    timezone: Timezone;
+    city: CityNearest | null;
+    timezone: Timezone | null;
 }
 interface Point {
     latitude: number;
@@ -531,9 +557,15 @@ declare function parseAPI(apiKey?: string, options?: ParseAPIOptions): {
         rate: (base: string, quote: string) => Promise<CurrencyRate>;
     };
     language: (code: string) => Promise<Language>;
-    timezone: (id: string, opts?: {
-        at?: string;
-    }) => Promise<Timezone>;
+    name: (name: string) => Promise<Name>;
+    timezone: {
+        (id: string, opts?: {
+            at?: string;
+        }): Promise<Timezone>;
+        (lat: number, lon: number, opts?: {
+            at?: string;
+        }): Promise<Timezone>;
+    };
     holiday: ((country: string, opts?: {
         year?: number;
     }) => Promise<HolidayYear>) & {
@@ -550,4 +582,4 @@ declare function parseAPI(apiKey?: string, options?: ParseAPIOptions): {
 };
 type ParseAPIClient = ReturnType<typeof parseAPI>;
 
-export { type City, type CityNearest, type CitySearch, type Continent, type ContinentCountries, type ContinentCountryItem, type Country, type CountryStateItem, type CountryStates, type Currency, type CurrencyRate, type Deep, type District, type Domain, type DomainDeep, type DomainRegistration, type Elevation, type Email, type EmailDeep, type Emoji, type EmojiSearch, type EmojiSkin, type Holiday, type HolidayDate, type HolidayYear, type Ip, type IpDeep, type Language, type Mx, type MxRecord, type ParseAPIClient, ParseAPIError, type ParseAPIOptions, type Phone, type PhoneDeep, type Point, type PointDeep, type Postal, type PostalDistance, type PostalDistanceEnd, type PostalNearby, type PostalNearbyItem, type State, type StateDistrictItem, type StateDistricts, type Timezone, type TimezoneNextDst, type Useragent, type UseragentBrowserBrand, type UseragentBrowserDeep, type UseragentDeep, type UseragentDeviceDeep, type UseragentEngineDeep, type UseragentOsDeep, type Weather, type WeatherAlert, type WeatherDeep, type WeatherForecastPeriod, parseAPI };
+export { type City, type CityNearest, type CitySearch, type Continent, type ContinentCountries, type ContinentCountryItem, type Country, type CountryStateItem, type CountryStates, type Currency, type CurrencyRate, type Deep, type District, type Domain, type DomainDeep, type DomainRegistration, type Elevation, type Email, type EmailDeep, type Emoji, type EmojiSearch, type EmojiSkin, type Holiday, type HolidayDate, type HolidayYear, type Ip, type IpDeep, type Language, type Mx, type MxRecord, type Name, type ParseAPIClient, ParseAPIError, type ParseAPIOptions, type Phone, type PhoneDeep, type Point, type PointDeep, type Postal, type PostalDistance, type PostalDistanceEnd, type PostalNearby, type PostalNearbyItem, type State, type StateDistrictItem, type StateDistricts, type Timezone, type TimezoneNextDst, type Useragent, type UseragentBrowserBrand, type UseragentBrowserDeep, type UseragentDeep, type UseragentDeviceDeep, type UseragentEngineDeep, type UseragentOsDeep, type Weather, type WeatherAlert, type WeatherDeep, type WeatherForecastPeriod, parseAPI };

package/dist/index.d.ts

@@ -15,6 +15,7 @@ interface IpDeep {
     datacenter: boolean;
     relay: boolean;
     tor: boolean;
+    vpn: boolean;
     provider: string;
 }
 interface Ip {
@@ -38,6 +39,8 @@ interface Continent {
 interface ContinentCountryItem {
     country: string;
     name: string;
+    emoji?: string | null;
+    calling_code?: string | null;
 }
 interface ContinentCountries {
     continent: string;
@@ -52,6 +55,8 @@ interface Country {
     local_name: string | null;
     demonym: string | null;
     capital: string | null;
+    capital_lat: number | null;
+    capital_lon: number | null;
     continent: string;
     region: string | null;
     subregion: string | null;
@@ -61,6 +66,7 @@ interface Country {
     currency_name: string | null;
     currency_symbol: string | null;
     tld: string | null;
+    calling_code: string | null;
     emoji: string | null;
     languages: string[];
     borders: string[];
@@ -189,6 +195,7 @@ interface EmailDeep {
 }
 interface Email {
     email: string;
+    didyoumean: string | null;
     valid: boolean;
     domain: string | null;
     domain_valid: boolean | null;
@@ -197,12 +204,17 @@ interface Email {
     deep?: Deep<EmailDeep>;
 }
 interface PhoneDeep {
-    type: 'mobile' | 'landline' | 'toll_free' | 'unknown';
-    region: string;
+    type: 'mobile' | 'landline' | 'voip' | 'toll_free' | 'unknown';
+    carrier: string | null;
+    /** Carrier is a known burner number app. Null when carrier is unknown. */
+    burner: boolean | null;
+    city: string | null;
+    state: string | null;
+    state_name: string | null;
 }
 interface Phone {
+    phone: string | null;
     valid: boolean;
-    e164: string | null;
     country: string | null;
     national: string | null;
     international: string | null;
@@ -227,7 +239,7 @@ interface DomainDeep {
     ns: string[];
     mx: MxRecord[];
     txt: string[];
-    provider: string;
+    mailhost: string;
     registration: DomainRegistration;
 }
 interface Domain {
@@ -303,6 +315,18 @@ interface Language {
     direction: 'ltr' | 'rtl' | string;
     countries: string[];
 }
+/** A parsed person name. Junk input returns valid: false, never an error. Gender comes from dictionary data and is null when the data does not decide. */
+interface Name {
+    name: string;
+    valid: boolean;
+    prefix: string | null;
+    first: string | null;
+    middle: string | null;
+    last: string | null;
+    suffix: string | null;
+    gender: 'male' | 'female' | null;
+    salutation: 'Mr' | 'Ms' | null;
+}
 interface CurrencyRate {
     base: string;
     quote: string;
@@ -317,12 +341,14 @@ interface TimezoneNextDst {
     abbreviation: string;
 }
 interface Timezone {
-    timezone: string;
+    latitude?: number;
+    longitude?: number;
+    timezone: string | null;
     name: string | null;
-    abbreviation: string;
-    offset: string;
-    offset_minutes: number;
-    dst: boolean;
+    abbreviation: string | null;
+    offset: string | null;
+    offset_minutes: number | null;
+    dst: boolean | null;
     next_dst: TimezoneNextDst | null;
 }
 interface Holiday {
@@ -352,8 +378,8 @@ interface Elevation {
     resolution: number | null;
 }
 interface PointDeep {
-    city: CityNearest;
-    timezone: Timezone;
+    city: CityNearest | null;
+    timezone: Timezone | null;
 }
 interface Point {
     latitude: number;
@@ -531,9 +557,15 @@ declare function parseAPI(apiKey?: string, options?: ParseAPIOptions): {
         rate: (base: string, quote: string) => Promise<CurrencyRate>;
     };
     language: (code: string) => Promise<Language>;
-    timezone: (id: string, opts?: {
-        at?: string;
-    }) => Promise<Timezone>;
+    name: (name: string) => Promise<Name>;
+    timezone: {
+        (id: string, opts?: {
+            at?: string;
+        }): Promise<Timezone>;
+        (lat: number, lon: number, opts?: {
+            at?: string;
+        }): Promise<Timezone>;
+    };
     holiday: ((country: string, opts?: {
         year?: number;
     }) => Promise<HolidayYear>) & {
@@ -550,4 +582,4 @@ declare function parseAPI(apiKey?: string, options?: ParseAPIOptions): {
 };
 type ParseAPIClient = ReturnType<typeof parseAPI>;
 
-export { type City, type CityNearest, type CitySearch, type Continent, type ContinentCountries, type ContinentCountryItem, type Country, type CountryStateItem, type CountryStates, type Currency, type CurrencyRate, type Deep, type District, type Domain, type DomainDeep, type DomainRegistration, type Elevation, type Email, type EmailDeep, type Emoji, type EmojiSearch, type EmojiSkin, type Holiday, type HolidayDate, type HolidayYear, type Ip, type IpDeep, type Language, type Mx, type MxRecord, type ParseAPIClient, ParseAPIError, type ParseAPIOptions, type Phone, type PhoneDeep, type Point, type PointDeep, type Postal, type PostalDistance, type PostalDistanceEnd, type PostalNearby, type PostalNearbyItem, type State, type StateDistrictItem, type StateDistricts, type Timezone, type TimezoneNextDst, type Useragent, type UseragentBrowserBrand, type UseragentBrowserDeep, type UseragentDeep, type UseragentDeviceDeep, type UseragentEngineDeep, type UseragentOsDeep, type Weather, type WeatherAlert, type WeatherDeep, type WeatherForecastPeriod, parseAPI };
+export { type City, type CityNearest, type CitySearch, type Continent, type ContinentCountries, type ContinentCountryItem, type Country, type CountryStateItem, type CountryStates, type Currency, type CurrencyRate, type Deep, type District, type Domain, type DomainDeep, type DomainRegistration, type Elevation, type Email, type EmailDeep, type Emoji, type EmojiSearch, type EmojiSkin, type Holiday, type HolidayDate, type HolidayYear, type Ip, type IpDeep, type Language, type Mx, type MxRecord, type Name, type ParseAPIClient, ParseAPIError, type ParseAPIOptions, type Phone, type PhoneDeep, type Point, type PointDeep, type Postal, type PostalDistance, type PostalDistanceEnd, type PostalNearby, type PostalNearbyItem, type State, type StateDistrictItem, type StateDistricts, type Timezone, type TimezoneNextDst, type Useragent, type UseragentBrowserBrand, type UseragentBrowserDeep, type UseragentDeep, type UseragentDeviceDeep, type UseragentEngineDeep, type UseragentOsDeep, type Weather, type WeatherAlert, type WeatherDeep, type WeatherForecastPeriod, parseAPI };

package/dist/index.js

@@ -1,5 +1,5 @@
 // src/index.ts
-var VERSION = "0.1.1";
+var VERSION = "0.1.2";
 var DEFAULT_BASE_URL = "https://api.parseapi.com";
 var DEFAULT_TIMEOUT_MS = 1e4;
 var DEFAULT_RETRIES = 2;
@@ -93,6 +93,18 @@ function parseAPI(apiKey, options = {}) {
   }
   const enc = encodeURIComponent;
   const deepQuery = (opts) => opts?.deep ? { deep: true } : {};
+  function timezone(idOrLat, lonOrOpts, opts) {
+    if (typeof idOrLat === "number") {
+      return request("/timezone", {
+        lat: idOrLat,
+        lon: typeof lonOrOpts === "number" ? lonOrOpts : void 0,
+        at: opts?.at
+      });
+    }
+    return request(`/timezone/${enc(idOrLat)}`, {
+      at: lonOrOpts && typeof lonOrOpts === "object" ? lonOrOpts.at : void 0
+    });
+  }
   return {
     ip: Object.assign(
       (ip, opts) => request(`/ip/${enc(ip)}`, deepQuery(opts)),
@@ -150,7 +162,8 @@ function parseAPI(apiKey, options = {}) {
       }
     ),
     language: (code) => request(`/language/${enc(code)}`),
-    timezone: (id, opts) => request(`/timezone/${enc(id)}`, { at: opts?.at }),
+    name: (name) => request(`/name/${enc(name)}`),
+    timezone,
     holiday: Object.assign(
       (country, opts) => request(`/holiday/${enc(country)}`, { year: opts?.year }),
       {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@parseapi/sdk",
-	"version": "0.1.1",
+	"version": "0.1.2",
 	"description": "Official parseAPI client for Node and TypeScript. One key, minimal JSON, fast.",
 	"keywords": [
 		"parseapi",