@parseapi/sdk 0.1.3 → 0.2.1

package/README.md

@@ -25,6 +25,7 @@ await parse.ip.self();
 await parse.email('hello@gmail.com');
 await parse.vat('DE136695976');
 await parse.iban('DE89370400440532013000');
+await parse.npi('1881018208');
 await parse.phone('+14155552671');
 await parse.carrier('+14155552671');
 await parse.caller('+14155552671');
@@ -61,6 +62,7 @@ await parse.weather(40.7128, -74.006);
 await parse.domain('example.com');
 await parse.mx('example.com');
 await parse.useragent(uaString);
+await parse.vin('1HGCM82633A004352');
 await parse.emoji('rocket');
 await parse.emoji.search('fire');
 ```

package/dist/index.cjs

@@ -24,7 +24,7 @@ __export(index_exports, {
   parseAPI: () => parseAPI
 });
 module.exports = __toCommonJS(index_exports);
-var VERSION = "0.1.3";
+var VERSION = "0.2.1";
 var DEFAULT_BASE_URL = "https://api.parseapi.com";
 var DEFAULT_TIMEOUT_MS = 1e4;
 var DEFAULT_RETRIES = 2;
@@ -197,6 +197,7 @@ function parseAPI(apiKey, options = {}) {
       ...deepQuery(opts)
     }),
     iban: (iban, opts) => request(`/iban/${enc(iban)}`, { country: opts?.country }),
+    npi: (npi, opts) => request(`/npi/${enc(npi)}`, deepQuery(opts)),
     phone: (number, opts) => request(`/phone/${enc(number)}`, { country: opts?.country, ...deepQuery(opts) }),
     carrier: (number, opts) => request(`/carrier/${enc(number)}`, { country: opts?.country }),
     caller: (number, opts) => request(`/caller/${enc(number)}`, { country: opts?.country }),
@@ -204,6 +205,13 @@ function parseAPI(apiKey, options = {}) {
     domain: (domain, opts) => request(`/domain/${enc(domain)}`, deepQuery(opts)),
     mx: (domain) => request(`/mx/${enc(domain)}`),
     useragent: (ua, opts) => request("/useragent", deepQuery(opts), { "User-Agent": ua }),
+    vin: (vin, opts) => request(`/vin/${enc(vin)}`, deepQuery(opts)),
+    tariff: Object.assign(
+      (code, opts) => request(`/tariff/${enc(code)}`, { origin: opts?.origin, ...deepQuery(opts) }),
+      {
+        search: (q) => request("/tariff", { q })
+      }
+    ),
     currency: Object.assign(
       (code) => request(`/currency/${enc(code)}`),
       {

package/dist/index.d.cts

@@ -108,6 +108,7 @@ interface State {
     latitude: number | null;
     longitude: number | null;
     population: number | null;
+    /** Total area in km2. */
     area: number | null;
     timezone: string | null;
     timezones: string[];
@@ -141,7 +142,11 @@ interface District {
     latitude: number | null;
     longitude: number | null;
     population: number | null;
+    /** Total area in km2 (land + water, or the official total). */
+    area: number | null;
+    /** Land area in km2. Null when the source publishes total only. */
     land_area: number | null;
+    /** Water area in km2. Null when the source publishes total only. */
     water_area: number | null;
     seat: string | null;
     timezone: string | null;
@@ -151,7 +156,8 @@ interface City {
     name: string;
     local_name: string | null;
     type: string | null;
-    capital: 'country' | 'state' | null;
+    /** What this city is the capital of: country, state, or null. */
+    capital_of: 'country' | 'state' | null;
     state: string | null;
     state_name: string | null;
     district: string | null;
@@ -163,7 +169,11 @@ interface City {
     elevation: number | null;
     elevation_ft: number | null;
     population: number | null;
+    /** Total area in km2 (land + water, or the official total). */
+    area: number | null;
+    /** Land area in km2. Null when the source publishes total only. */
     land_area: number | null;
+    /** Water area in km2. Null when the source publishes total only. */
     water_area: number | null;
     timezone: string | null;
     /** Minted parse id (`city_` + 12 chars). Stable pin via `/city/id/{id}`. */
@@ -205,7 +215,11 @@ interface Postal {
     elevation: number | null;
     elevation_ft: number | null;
     population: number | null;
+    /** Total area in km2. Null when the source has no water split. */
+    area: number | null;
+    /** Land area in km2. Null where the source has none. */
     land_area: number | null;
+    /** Water area in km2. Null where the source has none. */
     water_area: number | null;
     timezone: string | null;
     currency: string | null;
@@ -262,7 +276,8 @@ interface VatDeep {
     name: string | null;
     address: VatAddress | null;
     consultation: string | null;
-    consulted: string | null;
+    /** Registry timestamp of this check, ISO. */
+    consulted_at: string | null;
 }
 interface Vat {
     vat: string | null;
@@ -285,17 +300,156 @@ interface Iban {
     branch: string | null;
     account: string | null;
 }
+interface Npi {
+    /** Normalized 10-digit NPI. Invalid input still echoes the fold. */
+    npi: string | null;
+    valid: boolean;
+    /** Exists in the CMS NPPES registry. */
+    registered: boolean | null;
+    active: boolean | null;
+    /** Date CMS deactivated the NPI, YYYY-MM-DD. Null when still active. */
+    deactivated_at: string | null;
+    /** On the OIG exclusion list. */
+    excluded: boolean | null;
+    /** individual or organization. */
+    type: string | null;
+    name: string | null;
+    first: string | null;
+    last: string | null;
+    credential: string | null;
+    specialty: string | null;
+    /** NUCC taxonomy code. */
+    taxonomy: string | null;
+    address: string | null;
+    city: string | null;
+    state: string | null;
+    state_name: string | null;
+    postal: string | null;
+    country: string | null;
+    phone: string | null;
+    deep?: Deep<NpiDeep>;
+}
+interface NpiEnrollment {
+    /** part_a, part_b, practitioner, dme, order_refer, mdpp. Null when the code is unknown. */
+    type: string | null;
+    specialty: string | null;
+    state: string | null;
+}
+interface NpiDeep {
+    /** In the published Medicare FFS enrollment extract. */
+    medicare?: boolean | null;
+    /** On the CMS opt-out affidavit list. Matched by NPI only. */
+    opt_out?: boolean | null;
+    /** Enrollment rows. [] when medicare is false. */
+    enrollments?: NpiEnrollment[] | null;
+}
+interface HtsMeasure {
+    /** Chapter 99 heading, dotted (9903.01.24). */
+    heading: string;
+    /** The measure text verbatim. */
+    description: string;
+    /** The rate string verbatim ("The duty provided in the applicable subheading + 10%"). */
+    rate: string | null;
+    /** Effective from, ISO YYYY-MM-DD. Null when the schedule states none. */
+    from: string | null;
+    /** Expires, ISO YYYY-MM-DD. Null when open-ended. */
+    until: string | null;
+}
+interface HtsDeep {
+    /** The origin country the measures were resolved for. */
+    origin?: string | null;
+    /** Composed ad valorem percent. Null when the components do not compose cleanly. */
+    effective_rate?: number | null;
+    /** Every Chapter 99 tariff measure that applies to this code from this origin. */
+    measures?: HtsMeasure[] | null;
+}
+interface Hts {
+    /** Normalized code with dots (8471.30.01.00). */
+    hts: string;
+    /** The schedule line verbatim. */
+    description: string;
+    /** Parent descriptions from the schedule outline, outermost first. */
+    lineage: string[];
+    /** Units of quantity (No., kg). */
+    units: string[];
+    /** Column 1 general rate, verbatim. */
+    general: string | null;
+    /** Column 1 special rate, verbatim. */
+    special: string | null;
+    /** Column 2 rate, verbatim. */
+    other: string | null;
+    /** The official release that answered (2026HTSRev17). */
+    revision: string;
+    deep?: Deep<HtsDeep>;
+}
+interface HtsSearchHit {
+    hts: string;
+    description: string;
+    general: string | null;
+}
+interface HtsSearch {
+    q: string;
+    revision: string;
+    /** Up to 20 tariff lines, best match first. */
+    lines: HtsSearchHit[];
+}
+interface VinRecall {
+    /** Government campaign number. */
+    campaign: string;
+    /** Report date, ISO YYYY-MM-DD. */
+    date: string | null;
+    component: string | null;
+    /** The filed summary verbatim. */
+    summary: string | null;
+}
+interface VinDeep {
+    /** Open recall campaigns for the decoded vehicle. [] when none, null when the registry did not answer. */
+    recalls?: VinRecall[] | null;
+}
+interface Vin {
+    /** Normalized VIN, uppercase, no spaces. Invalid input still echoes the fold. */
+    vin: string | null;
+    valid: boolean;
+    year: number | null;
+    make: string | null;
+    model: string | null;
+    trim: string | null;
+    series: string | null;
+    /** Body style (sedan, coupe, suv, pickup). */
+    body: string | null;
+    /** Vehicle type (passenger car, truck, motorcycle, bus, trailer). */
+    type: string | null;
+    doors: number | null;
+    cylinders: number | null;
+    /** Engine displacement in liters. */
+    displacement: number | null;
+    fuel: string | null;
+    horsepower: number | null;
+    /** fwd, rwd, awd, 4wd. */
+    drive: string | null;
+    /** automatic, manual, cvt. */
+    transmission: string | null;
+    manufacturer: string | null;
+    plant_city: string | null;
+    plant_state: string | null;
+    plant_country: string | null;
+    /** Gross vehicle weight rating class as filed. */
+    gvwr: string | null;
+    deep?: Deep<VinDeep>;
+}
 interface Phone {
     phone: string | null;
     valid: boolean;
-    /** What the numbering plan can see. Never voip (that is the carrier field's word). Present when valid. */
-    type?: 'mobile' | 'landline' | 'toll_free' | 'unknown';
-    /** NPA-derived state code (US/CA). Present when valid. */
-    state?: string | null;
-    state_name?: string | null;
     country: string | null;
-    national?: string | null;
-    international?: string | null;
+    /** What the numbering plan can see. Never voip (that is the carrier field's word). Null when invalid. */
+    type: 'mobile' | 'landline' | 'toll_free' | 'unknown' | null;
+    /** NPA-derived state code (US/CA). */
+    state: string | null;
+    state_name: string | null;
+    /** Numbering-plan IANA zone. Null when the prefix covers more than one zone, or invalid. Not the handset. */
+    timezone: string | null;
+    national: string | null;
+    international: string | null;
     /** Always empty. The metered proves are their own endpoints: carrier, caller, hlr. */
     deep?: Record<string, never>;
 }
@@ -303,42 +457,42 @@ interface Carrier {
     phone: string | null;
     valid: boolean;
     country: string | null;
-    /** The network's word, including voip. Present when valid. */
-    type?: 'mobile' | 'landline' | 'voip' | 'toll_free' | 'unknown';
+    /** The network's word, including voip. Null when invalid. */
+    type: 'mobile' | 'landline' | 'voip' | 'toll_free' | 'unknown' | null;
     /** Current carrier display name. Null when the probe had no answer. */
-    carrier?: string | null;
+    carrier: string | null;
     /** Carrier is a known burner number app. Null when carrier is unknown. */
-    burner?: boolean | null;
+    burner: boolean | null;
     /** Issuing rate-center city. */
-    city?: string | null;
-    state?: string | null;
-    state_name?: string | null;
+    city: string | null;
+    state: string | null;
+    state_name: string | null;
 }
 interface Caller {
     phone: string | null;
     valid: boolean;
     country: string | null;
-    /** CNAM record verbatim (all-caps telco artifact). Null when no record or outside NANP. Present when valid. */
-    caller?: string | null;
+    /** CNAM record verbatim (all-caps telco artifact). Null when no record, outside NANP, or invalid. */
+    caller: string | null;
 }
 interface Hlr {
     phone: string | null;
     valid: boolean;
     country: string | null;
-    /** Assigned to a subscriber. Present when valid. */
-    live?: boolean | null;
+    /** Assigned to a subscriber. Null when invalid. */
+    live: boolean | null;
     /** Handset reachable right now. Null means unconfirmed, never no. */
-    connected?: boolean | null;
+    connected: boolean | null;
     /** The six network extras fill on live HLR dips only. Null elsewhere (NANP, failover). */
-    roaming?: boolean | null;
-    roaming_network?: string | null;
+    roaming: boolean | null;
+    roaming_network: string | null;
     /** ISO2, uppercase. */
-    roaming_country?: string | null;
+    roaming_country: string | null;
     /** Current serving network name. */
-    network?: string | null;
-    original_network?: string | null;
-    mcc?: string | null;
-    mnc?: string | null;
+    network: string | null;
+    original_network: string | null;
+    mcc: string | null;
+    mnc: string | null;
 }
 interface MxRecord {
     priority: number;
@@ -809,6 +963,7 @@ declare function parseAPI(apiKey?: string, options?: ParseAPIOptions): {
     iban: (iban: string, opts?: {
         country?: string;
     }) => Promise<Iban>;
+    npi: (npi: string, opts?: DeepOption) => Promise<Npi>;
     phone: (number: string, opts?: {
         country?: string;
     } & DeepOption) => Promise<Phone>;
@@ -824,6 +979,12 @@ declare function parseAPI(apiKey?: string, options?: ParseAPIOptions): {
     domain: (domain: string, opts?: DeepOption) => Promise<Domain>;
     mx: (domain: string) => Promise<Mx>;
     useragent: (ua: string, opts?: DeepOption) => Promise<Useragent>;
+    vin: (vin: string, opts?: DeepOption) => Promise<Vin>;
+    tariff: ((code: string, opts?: {
+        origin?: string;
+    } & DeepOption) => Promise<Hts>) & {
+        search: (q: string) => Promise<HtsSearch>;
+    };
     currency: ((code: string) => Promise<Currency>) & {
         rate: (base: string, quote: string, opts?: {
             date?: string;
@@ -867,4 +1028,4 @@ declare function parseAPI(apiKey?: string, options?: ParseAPIOptions): {
 };
 type ParseAPIClient = ReturnType<typeof parseAPI>;
 
-export { type Bloc, type BlocCountries, type BlocCountryItem, type Caller, type Carrier, type City, type CityNearby, type CityNearest, type CitySearch, type Continent, type ContinentCountries, type ContinentCountryItem, type Country, type CountryStateItem, type CountryStates, type Currency, type CurrencyRate, type DateInfo, type Deep, type District, type Domain, type DomainDeep, type DomainRegistration, type Elevation, type Email, type EmailDeep, type Emoji, type EmojiSearch, type EmojiSkin, type Hlr, type Holiday, type HolidayDate, type HolidayYear, type Iban, type Ip, type IpDeep, type Language, type Mx, type MxRecord, type Name, type ParseAPIClient, ParseAPIError, type ParseAPIOptions, type Phone, type Point, type PointDeep, type Postal, type PostalDistance, type PostalDistanceEnd, type PostalNearby, type PostalNearbyItem, type State, type StateDistrictItem, type StateDistricts, type Timezone, type TimezoneConversionTarget, type TimezoneNextDst, type Useragent, type UseragentBrowserBrand, type UseragentBrowserDeep, type UseragentDeep, type UseragentDeviceDeep, type UseragentEngineDeep, type UseragentOsDeep, type Vat, type VatAddress, type VatDeep, type Weather, type WeatherAir, type WeatherAlert, type WeatherCurrent, type WeatherDay, type WeatherDeep, type WeatherForecastPeriod, type WeatherHistory, type WeatherHour, type WeatherMinute, type WeatherSource, type WeatherStation, parseAPI };
+export { type Bloc, type BlocCountries, type BlocCountryItem, type Caller, type Carrier, type City, type CityNearby, type CityNearest, type CitySearch, type Continent, type ContinentCountries, type ContinentCountryItem, type Country, type CountryStateItem, type CountryStates, type Currency, type CurrencyRate, type DateInfo, type Deep, type District, type Domain, type DomainDeep, type DomainRegistration, type Elevation, type Email, type EmailDeep, type Emoji, type EmojiSearch, type EmojiSkin, type Hlr, type Holiday, type HolidayDate, type HolidayYear, type Hts, type HtsDeep, type HtsMeasure, type HtsSearch, type HtsSearchHit, type Iban, type Ip, type IpDeep, type Language, type Mx, type MxRecord, type Name, type Npi, type NpiDeep, type NpiEnrollment, type ParseAPIClient, ParseAPIError, type ParseAPIOptions, type Phone, type Point, type PointDeep, type Postal, type PostalDistance, type PostalDistanceEnd, type PostalNearby, type PostalNearbyItem, type State, type StateDistrictItem, type StateDistricts, type Timezone, type TimezoneConversionTarget, type TimezoneNextDst, type Useragent, type UseragentBrowserBrand, type UseragentBrowserDeep, type UseragentDeep, type UseragentDeviceDeep, type UseragentEngineDeep, type UseragentOsDeep, type Vat, type VatAddress, type VatDeep, type Vin, type VinDeep, type VinRecall, type Weather, type WeatherAir, type WeatherAlert, type WeatherCurrent, type WeatherDay, type WeatherDeep, type WeatherForecastPeriod, type WeatherHistory, type WeatherHour, type WeatherMinute, type WeatherSource, type WeatherStation, parseAPI };

package/dist/index.d.ts

@@ -108,6 +108,7 @@ interface State {
     latitude: number | null;
     longitude: number | null;
     population: number | null;
+    /** Total area in km2. */
     area: number | null;
     timezone: string | null;
     timezones: string[];
@@ -141,7 +142,11 @@ interface District {
     latitude: number | null;
     longitude: number | null;
     population: number | null;
+    /** Total area in km2 (land + water, or the official total). */
+    area: number | null;
+    /** Land area in km2. Null when the source publishes total only. */
     land_area: number | null;
+    /** Water area in km2. Null when the source publishes total only. */
     water_area: number | null;
     seat: string | null;
     timezone: string | null;
@@ -151,7 +156,8 @@ interface City {
     name: string;
     local_name: string | null;
     type: string | null;
-    capital: 'country' | 'state' | null;
+    /** What this city is the capital of: country, state, or null. */
+    capital_of: 'country' | 'state' | null;
     state: string | null;
     state_name: string | null;
     district: string | null;
@@ -163,7 +169,11 @@ interface City {
     elevation: number | null;
     elevation_ft: number | null;
     population: number | null;
+    /** Total area in km2 (land + water, or the official total). */
+    area: number | null;
+    /** Land area in km2. Null when the source publishes total only. */
     land_area: number | null;
+    /** Water area in km2. Null when the source publishes total only. */
     water_area: number | null;
     timezone: string | null;
     /** Minted parse id (`city_` + 12 chars). Stable pin via `/city/id/{id}`. */
@@ -205,7 +215,11 @@ interface Postal {
     elevation: number | null;
     elevation_ft: number | null;
     population: number | null;
+    /** Total area in km2. Null when the source has no water split. */
+    area: number | null;
+    /** Land area in km2. Null where the source has none. */
     land_area: number | null;
+    /** Water area in km2. Null where the source has none. */
     water_area: number | null;
     timezone: string | null;
     currency: string | null;
@@ -262,7 +276,8 @@ interface VatDeep {
     name: string | null;
     address: VatAddress | null;
     consultation: string | null;
-    consulted: string | null;
+    /** Registry timestamp of this check, ISO. */
+    consulted_at: string | null;
 }
 interface Vat {
     vat: string | null;
@@ -285,17 +300,156 @@ interface Iban {
     branch: string | null;
     account: string | null;
 }
+interface Npi {
+    /** Normalized 10-digit NPI. Invalid input still echoes the fold. */
+    npi: string | null;
+    valid: boolean;
+    /** Exists in the CMS NPPES registry. */
+    registered: boolean | null;
+    active: boolean | null;
+    /** Date CMS deactivated the NPI, YYYY-MM-DD. Null when still active. */
+    deactivated_at: string | null;
+    /** On the OIG exclusion list. */
+    excluded: boolean | null;
+    /** individual or organization. */
+    type: string | null;
+    name: string | null;
+    first: string | null;
+    last: string | null;
+    credential: string | null;
+    specialty: string | null;
+    /** NUCC taxonomy code. */
+    taxonomy: string | null;
+    address: string | null;
+    city: string | null;
+    state: string | null;
+    state_name: string | null;
+    postal: string | null;
+    country: string | null;
+    phone: string | null;
+    deep?: Deep<NpiDeep>;
+}
+interface NpiEnrollment {
+    /** part_a, part_b, practitioner, dme, order_refer, mdpp. Null when the code is unknown. */
+    type: string | null;
+    specialty: string | null;
+    state: string | null;
+}
+interface NpiDeep {
+    /** In the published Medicare FFS enrollment extract. */
+    medicare?: boolean | null;
+    /** On the CMS opt-out affidavit list. Matched by NPI only. */
+    opt_out?: boolean | null;
+    /** Enrollment rows. [] when medicare is false. */
+    enrollments?: NpiEnrollment[] | null;
+}
+interface HtsMeasure {
+    /** Chapter 99 heading, dotted (9903.01.24). */
+    heading: string;
+    /** The measure text verbatim. */
+    description: string;
+    /** The rate string verbatim ("The duty provided in the applicable subheading + 10%"). */
+    rate: string | null;
+    /** Effective from, ISO YYYY-MM-DD. Null when the schedule states none. */
+    from: string | null;
+    /** Expires, ISO YYYY-MM-DD. Null when open-ended. */
+    until: string | null;
+}
+interface HtsDeep {
+    /** The origin country the measures were resolved for. */
+    origin?: string | null;
+    /** Composed ad valorem percent. Null when the components do not compose cleanly. */
+    effective_rate?: number | null;
+    /** Every Chapter 99 tariff measure that applies to this code from this origin. */
+    measures?: HtsMeasure[] | null;
+}
+interface Hts {
+    /** Normalized code with dots (8471.30.01.00). */
+    hts: string;
+    /** The schedule line verbatim. */
+    description: string;
+    /** Parent descriptions from the schedule outline, outermost first. */
+    lineage: string[];
+    /** Units of quantity (No., kg). */
+    units: string[];
+    /** Column 1 general rate, verbatim. */
+    general: string | null;
+    /** Column 1 special rate, verbatim. */
+    special: string | null;
+    /** Column 2 rate, verbatim. */
+    other: string | null;
+    /** The official release that answered (2026HTSRev17). */
+    revision: string;
+    deep?: Deep<HtsDeep>;
+}
+interface HtsSearchHit {
+    hts: string;
+    description: string;
+    general: string | null;
+}
+interface HtsSearch {
+    q: string;
+    revision: string;
+    /** Up to 20 tariff lines, best match first. */
+    lines: HtsSearchHit[];
+}
+interface VinRecall {
+    /** Government campaign number. */
+    campaign: string;
+    /** Report date, ISO YYYY-MM-DD. */
+    date: string | null;
+    component: string | null;
+    /** The filed summary verbatim. */
+    summary: string | null;
+}
+interface VinDeep {
+    /** Open recall campaigns for the decoded vehicle. [] when none, null when the registry did not answer. */
+    recalls?: VinRecall[] | null;
+}
+interface Vin {
+    /** Normalized VIN, uppercase, no spaces. Invalid input still echoes the fold. */
+    vin: string | null;
+    valid: boolean;
+    year: number | null;
+    make: string | null;
+    model: string | null;
+    trim: string | null;
+    series: string | null;
+    /** Body style (sedan, coupe, suv, pickup). */
+    body: string | null;
+    /** Vehicle type (passenger car, truck, motorcycle, bus, trailer). */
+    type: string | null;
+    doors: number | null;
+    cylinders: number | null;
+    /** Engine displacement in liters. */
+    displacement: number | null;
+    fuel: string | null;
+    horsepower: number | null;
+    /** fwd, rwd, awd, 4wd. */
+    drive: string | null;
+    /** automatic, manual, cvt. */
+    transmission: string | null;
+    manufacturer: string | null;
+    plant_city: string | null;
+    plant_state: string | null;
+    plant_country: string | null;
+    /** Gross vehicle weight rating class as filed. */
+    gvwr: string | null;
+    deep?: Deep<VinDeep>;
+}
 interface Phone {
     phone: string | null;
     valid: boolean;
-    /** What the numbering plan can see. Never voip (that is the carrier field's word). Present when valid. */
-    type?: 'mobile' | 'landline' | 'toll_free' | 'unknown';
-    /** NPA-derived state code (US/CA). Present when valid. */
-    state?: string | null;
-    state_name?: string | null;
     country: string | null;
-    national?: string | null;
-    international?: string | null;
+    /** What the numbering plan can see. Never voip (that is the carrier field's word). Null when invalid. */
+    type: 'mobile' | 'landline' | 'toll_free' | 'unknown' | null;
+    /** NPA-derived state code (US/CA). */
+    state: string | null;
+    state_name: string | null;
+    /** Numbering-plan IANA zone. Null when the prefix covers more than one zone, or invalid. Not the handset. */
+    timezone: string | null;
+    national: string | null;
+    international: string | null;
     /** Always empty. The metered proves are their own endpoints: carrier, caller, hlr. */
     deep?: Record<string, never>;
 }
@@ -303,42 +457,42 @@ interface Carrier {
     phone: string | null;
     valid: boolean;
     country: string | null;
-    /** The network's word, including voip. Present when valid. */
-    type?: 'mobile' | 'landline' | 'voip' | 'toll_free' | 'unknown';
+    /** The network's word, including voip. Null when invalid. */
+    type: 'mobile' | 'landline' | 'voip' | 'toll_free' | 'unknown' | null;
     /** Current carrier display name. Null when the probe had no answer. */
-    carrier?: string | null;
+    carrier: string | null;
     /** Carrier is a known burner number app. Null when carrier is unknown. */
-    burner?: boolean | null;
+    burner: boolean | null;
     /** Issuing rate-center city. */
-    city?: string | null;
-    state?: string | null;
-    state_name?: string | null;
+    city: string | null;
+    state: string | null;
+    state_name: string | null;
 }
 interface Caller {
     phone: string | null;
     valid: boolean;
     country: string | null;
-    /** CNAM record verbatim (all-caps telco artifact). Null when no record or outside NANP. Present when valid. */
-    caller?: string | null;
+    /** CNAM record verbatim (all-caps telco artifact). Null when no record, outside NANP, or invalid. */
+    caller: string | null;
 }
 interface Hlr {
     phone: string | null;
     valid: boolean;
     country: string | null;
-    /** Assigned to a subscriber. Present when valid. */
-    live?: boolean | null;
+    /** Assigned to a subscriber. Null when invalid. */
+    live: boolean | null;
     /** Handset reachable right now. Null means unconfirmed, never no. */
-    connected?: boolean | null;
+    connected: boolean | null;
     /** The six network extras fill on live HLR dips only. Null elsewhere (NANP, failover). */
-    roaming?: boolean | null;
-    roaming_network?: string | null;
+    roaming: boolean | null;
+    roaming_network: string | null;
     /** ISO2, uppercase. */
-    roaming_country?: string | null;
+    roaming_country: string | null;
     /** Current serving network name. */
-    network?: string | null;
-    original_network?: string | null;
-    mcc?: string | null;
-    mnc?: string | null;
+    network: string | null;
+    original_network: string | null;
+    mcc: string | null;
+    mnc: string | null;
 }
 interface MxRecord {
     priority: number;
@@ -809,6 +963,7 @@ declare function parseAPI(apiKey?: string, options?: ParseAPIOptions): {
     iban: (iban: string, opts?: {
         country?: string;
     }) => Promise<Iban>;
+    npi: (npi: string, opts?: DeepOption) => Promise<Npi>;
     phone: (number: string, opts?: {
         country?: string;
     } & DeepOption) => Promise<Phone>;
@@ -824,6 +979,12 @@ declare function parseAPI(apiKey?: string, options?: ParseAPIOptions): {
     domain: (domain: string, opts?: DeepOption) => Promise<Domain>;
     mx: (domain: string) => Promise<Mx>;
     useragent: (ua: string, opts?: DeepOption) => Promise<Useragent>;
+    vin: (vin: string, opts?: DeepOption) => Promise<Vin>;
+    tariff: ((code: string, opts?: {
+        origin?: string;
+    } & DeepOption) => Promise<Hts>) & {
+        search: (q: string) => Promise<HtsSearch>;
+    };
     currency: ((code: string) => Promise<Currency>) & {
         rate: (base: string, quote: string, opts?: {
             date?: string;
@@ -867,4 +1028,4 @@ declare function parseAPI(apiKey?: string, options?: ParseAPIOptions): {
 };
 type ParseAPIClient = ReturnType<typeof parseAPI>;
 
-export { type Bloc, type BlocCountries, type BlocCountryItem, type Caller, type Carrier, type City, type CityNearby, type CityNearest, type CitySearch, type Continent, type ContinentCountries, type ContinentCountryItem, type Country, type CountryStateItem, type CountryStates, type Currency, type CurrencyRate, type DateInfo, type Deep, type District, type Domain, type DomainDeep, type DomainRegistration, type Elevation, type Email, type EmailDeep, type Emoji, type EmojiSearch, type EmojiSkin, type Hlr, type Holiday, type HolidayDate, type HolidayYear, type Iban, type Ip, type IpDeep, type Language, type Mx, type MxRecord, type Name, type ParseAPIClient, ParseAPIError, type ParseAPIOptions, type Phone, type Point, type PointDeep, type Postal, type PostalDistance, type PostalDistanceEnd, type PostalNearby, type PostalNearbyItem, type State, type StateDistrictItem, type StateDistricts, type Timezone, type TimezoneConversionTarget, type TimezoneNextDst, type Useragent, type UseragentBrowserBrand, type UseragentBrowserDeep, type UseragentDeep, type UseragentDeviceDeep, type UseragentEngineDeep, type UseragentOsDeep, type Vat, type VatAddress, type VatDeep, type Weather, type WeatherAir, type WeatherAlert, type WeatherCurrent, type WeatherDay, type WeatherDeep, type WeatherForecastPeriod, type WeatherHistory, type WeatherHour, type WeatherMinute, type WeatherSource, type WeatherStation, parseAPI };
+export { type Bloc, type BlocCountries, type BlocCountryItem, type Caller, type Carrier, type City, type CityNearby, type CityNearest, type CitySearch, type Continent, type ContinentCountries, type ContinentCountryItem, type Country, type CountryStateItem, type CountryStates, type Currency, type CurrencyRate, type DateInfo, type Deep, type District, type Domain, type DomainDeep, type DomainRegistration, type Elevation, type Email, type EmailDeep, type Emoji, type EmojiSearch, type EmojiSkin, type Hlr, type Holiday, type HolidayDate, type HolidayYear, type Hts, type HtsDeep, type HtsMeasure, type HtsSearch, type HtsSearchHit, type Iban, type Ip, type IpDeep, type Language, type Mx, type MxRecord, type Name, type Npi, type NpiDeep, type NpiEnrollment, type ParseAPIClient, ParseAPIError, type ParseAPIOptions, type Phone, type Point, type PointDeep, type Postal, type PostalDistance, type PostalDistanceEnd, type PostalNearby, type PostalNearbyItem, type State, type StateDistrictItem, type StateDistricts, type Timezone, type TimezoneConversionTarget, type TimezoneNextDst, type Useragent, type UseragentBrowserBrand, type UseragentBrowserDeep, type UseragentDeep, type UseragentDeviceDeep, type UseragentEngineDeep, type UseragentOsDeep, type Vat, type VatAddress, type VatDeep, type Vin, type VinDeep, type VinRecall, type Weather, type WeatherAir, type WeatherAlert, type WeatherCurrent, type WeatherDay, type WeatherDeep, type WeatherForecastPeriod, type WeatherHistory, type WeatherHour, type WeatherMinute, type WeatherSource, type WeatherStation, parseAPI };

package/dist/index.js

@@ -1,5 +1,5 @@
 // src/index.ts
-var VERSION = "0.1.3";
+var VERSION = "0.2.1";
 var DEFAULT_BASE_URL = "https://api.parseapi.com";
 var DEFAULT_TIMEOUT_MS = 1e4;
 var DEFAULT_RETRIES = 2;
@@ -172,6 +172,7 @@ function parseAPI(apiKey, options = {}) {
       ...deepQuery(opts)
     }),
     iban: (iban, opts) => request(`/iban/${enc(iban)}`, { country: opts?.country }),
+    npi: (npi, opts) => request(`/npi/${enc(npi)}`, deepQuery(opts)),
     phone: (number, opts) => request(`/phone/${enc(number)}`, { country: opts?.country, ...deepQuery(opts) }),
     carrier: (number, opts) => request(`/carrier/${enc(number)}`, { country: opts?.country }),
     caller: (number, opts) => request(`/caller/${enc(number)}`, { country: opts?.country }),
@@ -179,6 +180,13 @@ function parseAPI(apiKey, options = {}) {
     domain: (domain, opts) => request(`/domain/${enc(domain)}`, deepQuery(opts)),
     mx: (domain) => request(`/mx/${enc(domain)}`),
     useragent: (ua, opts) => request("/useragent", deepQuery(opts), { "User-Agent": ua }),
+    vin: (vin, opts) => request(`/vin/${enc(vin)}`, deepQuery(opts)),
+    tariff: Object.assign(
+      (code, opts) => request(`/tariff/${enc(code)}`, { origin: opts?.origin, ...deepQuery(opts) }),
+      {
+        search: (q) => request("/tariff", { q })
+      }
+    ),
     currency: Object.assign(
       (code) => request(`/currency/${enc(code)}`),
       {

package/package.json

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