@parseapi/sdk 1.12.5 → 1.12.6

package/README.md

@@ -106,6 +106,15 @@ names. IDs, native-name fields, numeric facts, Date input `format`, and
 input `locale` retain their meaning. Omitting `lang` preserves the existing
 behavior and does not inherit a previous request's choice.
 
+## ISO identifiers
+
+Country uses `iso_alpha3` and `iso_numeric`, State uses the full
+`iso_subdivision` code such as `US-CA`, Language uses `iso_alpha3`, and Currency
+uses `iso_numeric`. Primary `country`, `state`, `language` and `currency` codes
+keep their meaning. Results retain the selected API contract's exact keys,
+values, nulls and nesting. Earlier server contracts retain their earlier ISO
+spellings. Use the existing lookup methods for each resource.
+
 ## Calls
 
 Search the company directory, then refetch an ID you have chosen:
@@ -271,9 +280,7 @@ Source deep adds `standard_offset`, `standard_offset_seconds`, signed `dst_offse
 
 ## Place statistics and optional detail
 
-Country Core contains the everyday reference: `name`, `name_full`, `name_local`, demonym and country codes, continent, region and subregion, currency, calling code, `flag`, language and timezone codes, borders, bloc memberships and `capital: { name, lat, lon }`. Paid Deep adds specialist detail, including population, total area and national statistics. `gdp_usd` and `gdp_per_capita_usd` are current US dollars; `population_growth_percent`, `urban_population_percent` and `internet_users_percent` use a 0–100 percent scale (growth can be negative or exceed 100). GDP per person and these three percentages round once to two decimals in the API response. `elevation_average` is average terrain elevation in meters; `lowest_point.elevation` and `highest_point.elevation` keep their point-specific meaning. Unknown stays null and a known zero stays zero. Country tax references are grouped once as `deep.tax: { name, rate }`; the rate remains a percentage. Read capital from the Core object and read the tax name and rate from the Deep tax object.
-
-Read `name_full` from current responses. The older `full_name` type member remains available for earlier payloads; responses are returned as received, with null values preserved. Historical Deep fields remain readable in earlier responses; they are not added to the current wire result.
+Country Core contains the everyday reference: `name`, `name_full`, `name_local`, demonym, `iso_alpha3` and `iso_numeric` country identifiers, continent, region and subregion, currency, calling code, `flag`, language and timezone codes, borders, bloc memberships and `capital: { name, lat, lon }`. Paid Deep adds specialist detail, including population, total area and national statistics. `gdp_usd` and `gdp_per_capita_usd` are current US dollars; `population_growth_percent`, `urban_population_percent` and `internet_users_percent` use a 0–100 percent scale (growth can be negative or exceed 100). GDP per person and these three percentages round once to two decimals in the API response. `elevation_average` is average terrain elevation in meters; `lowest_point.elevation` and `highest_point.elevation` keep their point-specific meaning. Unknown stays null and a known zero stays zero. Country tax references are grouped once as `deep.tax: { name, rate }`; the rate remains a percentage. Read capital from the Core object and read the tax name and rate from the Deep tax object.
 
 Australian postal lookups include core `localities` with suburb choices (`city`, `state`, `state_name`) on every plan. Null or an omitted field means unknown, while `[]` means the reviewed reference has no eligible choices. `city` stays null when the source is ambiguous, even if there is only one eligible choice. Let the user select their suburb and keep manual entry available. These are geographic choices, not mailing-address verification. [G-NAF source, adaptations and licence](https://parseapi.com/legal/attribution#postal-au).
 
@@ -432,14 +439,14 @@ The ordinary `Domain` type represents unknown availability as `null`. The existi
 ## Stack API
 
 ```typescript
-import type { StackResult } from '@parseapi/sdk';
+import type { Stack } from '@parseapi/sdk';
 
-const result: StackResult = await parse.stack("example.com");
+const result: Stack = await parse.stack("example.com");
 ```
 
-Pass a public hostname without a scheme, path, port or IP address. Stack checks static homepage HTML and response headers. It returns the checked URL, original `checked_at` time and eight technology arrays. `StackResult` describes that current result. The existing `Stack` interface keeps its older required coverage members for source compatibility; the current response omits `scope`, `pages` and `partial`.
+Pass a public hostname without a scheme, path, port or IP address. Stack checks static homepage HTML and response headers. It returns the checked URL, original `checked_at` time and eight technology arrays. The existing `stack()` method returns this `Stack` model.
 
-`cms`, `servers`, `frameworks`, `ecommerce`, `analytics`, `chat`, `payments` and `hosting` are arrays because a site can use several technologies in each category. Each entry contains `technology`, `name` and nullable `version`. Technology codes are open strings. A successful check uses empty arrays for categories with no matches. When no HTML page could be checked, `checked_at` and all categories are null. Unknown or conflicting versions are null. Missing detections do not prove absence.
+`cms`, `servers`, `frameworks`, `ecommerce`, `analytics`, `chat`, `payments` and `hosting` are arrays because a site can use several technologies in each category. Each entry contains `technology`, `name` and nullable `version`. Technology codes are open strings. A successful check uses empty arrays for categories with no matches. When no HTML page could be checked, `checked_at` and all categories are null. Unknown or conflicting versions are null. Detections describe the checked homepage.
 
 Successful checks may be reused for up to 24 hours. `pretty` optionally formats the wire JSON. Stack uses your plan's request allowance and API version 2.0.0 selected by this client.
 

package/dist/index.cjs

@@ -448,7 +448,7 @@ var EmojiCatalog = class {
 };
 
 // src/index.ts
-var VERSION = "1.12.5";
+var VERSION = "1.12.6";
 var API_VERSION = "2.0.0";
 var DEFAULT_BASE_URL = "https://api.parseapi.com";
 var DEFAULT_TIMEOUT_MS = 1e4;
@@ -750,7 +750,7 @@ function parseAPI(apiKey, options = {}) {
     caller: (number, opts) => request(`/caller/${enc(number)}`, { country: opts?.country }, void 0, opts),
     /** Look up phone status at the last check. Live means assigned and connected means reachable at that check. Cached results may be returned. Null means unconfirmed. Deep adds network diagnostics within the same metered lookup. No automatic retries by default. */
     hlr: (number, opts) => request(`/hlr/${enc(number)}`, { country: opts?.country, ...deepQuery(opts) }, void 0, opts),
-    /** Identify website technologies by category, with homepage or bounded site coverage metadata. */
+    /** Identify technologies in static homepage HTML and response headers. */
     stack: (domain, opts) => request(`/stack/${enc(domain)}`, { ...deepQuery(opts), pretty: opts?.pretty }, void 0, opts),
     /** Check registration: available is true, false or null when unknown. Paid Deep adds available registration details. */
     domain: (domain, opts) => request(`/domain/${enc(domain)}`, deepQuery(opts), void 0, opts),

package/dist/index.d.cts

@@ -72,7 +72,13 @@ interface Country {
     deep?: Deep<CountryDeep>;
     /** IANA timezones used by the country. */
     timezones: string[] | null;
+    /** ISO 3166-1 alpha-3 country code. */
+    iso_alpha3?: string | null;
+    /** ISO 3166-1 numeric country code. */
+    iso_numeric?: number | null;
+    /** @deprecated Older servers use iso3. Read iso_alpha3 on the current contract. */
     iso3?: string | null;
+    /** @deprecated Older servers use numeric. Read iso_numeric on the current contract. */
     numeric?: number | null;
     /** Official long name. */
     name_full?: string | null;
@@ -114,9 +120,14 @@ interface State {
     country_name: string | null;
     latitude: number | null;
     longitude: number | null;
-    timezone: string | null;
     timezones: string[];
-    iso_3166_2: string | null;
+    /** Full ISO 3166-2 subdivision code, including its country prefix. */
+    iso_subdivision?: string | null;
+    /** @deprecated Legacy candidate spelling. Read iso_subdivision on the current contract. */
+    iso?: string | null;
+    fips: string | null;
+    area_codes: string[] | null;
+    capital: StateCapital;
     deep?: Deep<StateDeep>;
 }
 interface StateDistrictItem {
@@ -147,7 +158,6 @@ interface District {
     country_name: string | null;
     latitude: number | null;
     longitude: number | null;
-    timezone: string | null;
     timezones: string[];
     deep?: Deep<DistrictDeep>;
 }
@@ -349,11 +359,6 @@ interface Stack {
     url: string;
     /** Time of the check, or null when no HTML page could be checked. */
     checked_at: string | null;
-    scope: 'homepage' | 'site';
-    /** Number of successfully checked HTML pages. */
-    pages: number;
-    /** True for homepage-only or incomplete bounded checks; null when no HTML page could be checked. False never guarantees every page was visited. */
-    partial: boolean | null;
     /** Collections are null when no HTML page could be checked and empty when no matches were found. */
     cms: StackTechnology[] | null;
     servers: StackTechnology[] | null;
@@ -478,6 +483,11 @@ interface Language {
     script: string | null;
     direction: 'ltr' | 'rtl' | string;
     deep?: Deep<LanguageDeep>;
+    /** ISO 639-3 language code. */
+    iso_alpha3?: string | null;
+    /** @deprecated Older servers use iso3. Read iso_alpha3 on the current contract. */
+    iso3?: string | null;
+    countries?: string[] | null;
 }
 /** 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 {
@@ -1191,7 +1201,9 @@ interface CountryDeep {
     urban_population?: number | null;
     /** Share of population using the internet, from 0 to 100. */
     internet_users?: number | null;
+    /** @deprecated Older deep contract. Current ISO identifiers live in Core. */
     iso3: string;
+    /** @deprecated Older deep contract. Current iso_numeric lives in Core. */
     numeric: number;
     full_name: string | null;
     demonym: string | null;
@@ -1252,18 +1264,19 @@ interface CountryElevationPoint {
     elevation: number;
 }
 interface StateDeep {
+    /** @deprecated Older deep contract. Read Core iso_subdivision on the current contract. */
+    iso_3166_2?: string | null;
     population: number | null;
     /** @deprecated No longer returned. Retained for source compatibility. */
     population_period?: string | null;
     /** Total area in km2. */
     area: number | null;
-    fips: string | null;
-    capital: string | null;
-    area_codes: string[];
-    /** Levy name, such as VAT, GST or sales tax. Null when unknown or not applicable. */
-    tax: string | null;
-    /** State or province reference rate in percent. Country, state and postal rates are alternative references, not additive. */
-    tax_rate: number | null;
+    tax: StateTax;
+    /** @deprecated Historical Deep read members. */
+    fips?: string | null;
+    capital?: string | null;
+    area_codes?: string[];
+    tax_rate?: number | null;
 }
 interface DistrictDeep {
     population: number | null;
@@ -1355,8 +1368,10 @@ interface HlrDeep {
     mnc: string | null;
 }
 interface LanguageDeep {
-    iso3: string | null;
-    countries: string[];
+    /** @deprecated Older deep contract. Read Core iso_alpha3 on the current contract. */
+    iso3?: string | null;
+    /** @deprecated Older deep contract. Current country associations live in Core. */
+    countries?: string[] | null;
 }
 interface NameDeep {
     gender: 'male' | 'female' | null;
@@ -1604,6 +1619,29 @@ interface CityNearbyCoordinates extends CityCollection {
     radius: number;
     unit: string;
 }
+/** Minimal related records returned in Company Core. Rich Deep records stay separate. */
+interface CompanyIndustryReference {
+    type: string;
+    code: string;
+}
+interface CompanyPhoneReference {
+    number: string;
+    country?: string | null;
+    e164?: string | null;
+}
+interface CompanyEmailReference {
+    address: string;
+}
+interface StateTax {
+    name: string | null;
+    /** Reference rate in percent. Choose the geographic scope for the task. */
+    rate: number | null;
+}
+interface StateCapital {
+    name: string | null;
+    lat: number | null;
+    lon: number | null;
+}
 
 /** Every non-2xx response from the API. Branch on `code`, never on `message`. */
 declare class ParseAPIError extends Error {
@@ -1873,8 +1911,8 @@ interface DomainResult {
     available: boolean | null;
     deep?: Deep<DomainResultDeep>;
 }
-/** The current eleven-field Stack response, without obsolete coverage members. */
-type StackResult = Omit<Stack, 'scope' | 'pages' | 'partial'>;
+/** Alias for the current Stack response. */
+type StackResult = Stack;
 
 interface EmojiCatalogLookupOptions {
     deep?: boolean;
@@ -2279,7 +2317,7 @@ declare function parseAPI(apiKey?: string, options?: ParseAPIOptions): {
     caller: (number: string, opts?: CallerOptions) => Promise<Caller>;
     /** Look up phone status at the last check. Live means assigned and connected means reachable at that check. Cached results may be returned. Null means unconfirmed. Deep adds network diagnostics within the same metered lookup. No automatic retries by default. */
     hlr: (number: string, opts?: HlrOptions) => Promise<Hlr>;
-    /** Identify website technologies by category, with homepage or bounded site coverage metadata. */
+    /** Identify technologies in static homepage HTML and response headers. */
     stack: (domain: string, opts?: StackOptions) => Promise<Stack>;
     /** Check registration: available is true, false or null when unknown. Paid Deep adds available registration details. */
     domain: (domain: string, opts?: DomainOptions) => Promise<Domain>;
@@ -2431,4 +2469,4 @@ interface CityNearbyCall {
     (name: string, opts: CityNearbyOptions): Promise<CityNearby | CityCollection>;
 }
 
-export { type Address, type AddressOptions, type AddressSearch, type AddressSearchOptions, type AddressSuggestion, type AgentTask, type AgentTaskInput, type AgentTaskLookupInput, type AgentTaskResult, type Asn, type AsnOptions, BULK_CHECKS, type Bin, type BinOptions, ParseAPIError as BulkAPIError, type BulkClient, type BulkClientOptions, type BulkJob, type BulkPreview, type BulkPreviewInput, type BulkQuote, type BulkRequestOptions, type BulkResult, type BulkStartInput, type BulkStatus, type BulkUpload, type BulkUploadInput, type Caller, type CallerOptions, type Card, type CardDeep, type CardOptions, type Carrier, type CarrierDeep, type CarrierOptions, type City, type CityAmbiguityCandidate, type CityAncestorsOptions, type CityCollection, type CityCollectionFilters, type CityDeep, type CityDistance, type CityDistanceOptions, type CityGrain, type CityIdCall, type CityIdOptions, type CityList, type CityListOptions, type CityLookupCall, type CityMatch, type CityNearby, type CityNearbyCall, type CityNearbyCoordinates, type CityNearbyCoordinatesOptions, type CityNearbyOptions, type CityNearest, type CityNearestCall, type CityNearestOptions, type CityOptions, type CityPagingOptions, type CityParent, type CityRelations, type CityRelationsOptions, type CityResource, type CityResponseOptions, type CityScopeOptions, type CitySearch, type CitySearchCall, type CitySearchOptions, type CitySort, type Company, type CompanyCandidate, type CompanyCountry, type CompanyCoverage, type CompanyCoverageOptions, type CompanyDeep, type CompanyEmailAddress, type CompanyIdOptions, type CompanyMatch, type CompanyOptions, type CompanyPhoneNumber, type CompanyProfile, type CompanyProfileAddress, type CompanyProfileDeep, type CompanyProfileDomain, type CompanyProfileEmail, type CompanyProfileEmployees, type CompanyProfileFounding, type CompanyProfileIdentifier, type CompanyProfileIndustry, type CompanyProfileJurisdiction, type CompanyProfileListing, type CompanyProfilePhone, type CompanyProfileRegistration, type CompanyProfileRegistrationAddress, type CompanyProfileRegistrationLegalForm, type CompanyProfileSource, type CompanyProfileWebsite, type CompanySearch, type CompanySearchOptions, type CompanySocialProfile, type Continent, type ContinentCountries, type ContinentCountriesOptions, type ContinentCountryItem, type ContinentOptions, type Country, type CountryCapital, type CountryDeep, type CountryElevationPoint, type CountryEmergency, type CountryOptions, type CountryStateItem, type CountryStates, type CountryStatesOptions, type CountryTax, type DateInfo, type DateInfoDeep, type DateOptions, type DateTodayOptions, type Deep, type District, type DistrictDeep, type DistrictOptions, type Dns, type DnsOptions, type DnsRecord, type Domain, type DomainDeep, type DomainOptions, type DomainRegistration, type DomainRegistrationResult, type DomainResult, type DomainResultDeep, type Elevation, type ElevationLocations, type ElevationOptions, type Email, type EmailDeep, type EmailOptions, type Emoji, type EmojiArtwork, type EmojiArtworkSource, type EmojiBrowse, type EmojiBrowseOptions, EmojiCatalog, type EmojiCatalogConvertOptions, type EmojiCatalogData, EmojiCatalogError, type EmojiCatalogLocalization, type EmojiCatalogLookupOptions, type EmojiCatalogOptions, type EmojiCatalogParseOptions, type EmojiCatalogRegexOptions, type EmojiCatalogScope, type EmojiCatalogSearchFacts, type EmojiCatalogSearchOptions, type EmojiCategories, type EmojiCategory, type EmojiConversion, type EmojiConvertOptions, type EmojiDeep, type EmojiMetadata, type EmojiNativeSearchFacts, type EmojiNotice, type EmojiOptions, type EmojiParse, type EmojiParseOptions, type EmojiPosition, type EmojiSearch, type EmojiSearchOptions, type EmojiShortcodeSourceMetadata, type EmojiSkin, type EmojiSource, type EmojiUnresolved, type EmojiVariant, type Hlr, type HlrDeep, type HlrOptions, type Holiday, type HolidayDate, type HolidayDateOptions, type HolidayOptions, type HolidayYear, type Industry, type IndustryChild, type IndustryCorrection, type IndustryDeep, type IndustryExclusion, type IndustryMatch, type IndustryOptions, type IndustrySearch, type IndustrySearchItem, type IndustrySearchOptions, type Ip, type IpDeep, type IpOptions, type IpSelfOptions, type Language, type LanguageDeep, type LanguageOption, type LanguageOptions, type Mx, type MxOptions, type MxRecord, type Naics, type NaicsChild, type NaicsCorrection, type NaicsDeep, type NaicsExclusion, type NaicsMatch, type NaicsOptions, type NaicsSearch, type NaicsSearchItem, type NaicsSearchOptions, type Name, type NameDeep, type NameOptions, type ParseAPIClient, ParseAPIError, type ParseAPIOptions, type Phone, type PhoneDeep, type PhoneOptions, type Point, type PointCity, type PointDeep, type PointOptions, type Postal, type PostalDeep, type PostalDistance, type PostalDistanceEnd, type PostalDistanceOptions, type PostalLocality, type PostalMetro, type PostalMetrosDeep, type PostalNearby, type PostalNearbyItem, type PostalNearbyOptions, type PostalOptions, type Preflight, type PreflightCost, type PreflightEmailCapacity, type PreflightOperation, type PreflightOperationEstimate, type PreflightPooledCapacity, type PreflightSpendCapacity, type PreflightTask, type PropertyTax, type RequestOptions, type Stack, type StackOptions, type StackResult, type StackTechnology, type State, type StateDeep, type StateDistrictDeep, type StateDistrictItem, type StateDistricts, type StateDistrictsOptions, type StateOptions, type Time, type TimeAtOptions, type TimeLocation, type TimeLocationCandidate, type TimeLocationInput, type TimeOptions, type TimeResolution, type TimeResolutionAlternative, type TimeSeason, type TimeTransition, type TimeTransitionState, type TimeZoneEntry, type TimeZones, type TimeZonesOptions, type Timezone, type TimezoneAtOptions, type TimezoneConversionTarget, type TimezoneConversionTargetDeep, type TimezoneDeep, type TimezoneNextDst, type TimezoneOptions, type Useragent, type UseragentBrowserBrand, type UseragentBrowserDeep, type UseragentDeep, type UseragentDeviceDeep, type UseragentEngineDeep, type UseragentOptions, type UseragentOsDeep, type Weather, type WeatherAir, type WeatherAlert, type WeatherCurrent, type WeatherCurrentDeep, type WeatherDay, type WeatherDeep, type WeatherForecastPeriod, type WeatherHistory, type WeatherHour, type WeatherMinute, type WeatherOptions, type WeatherStation, createBulkClient, parseAPI };
+export { type Address, type AddressOptions, type AddressSearch, type AddressSearchOptions, type AddressSuggestion, type AgentTask, type AgentTaskInput, type AgentTaskLookupInput, type AgentTaskResult, type Asn, type AsnOptions, BULK_CHECKS, type Bin, type BinOptions, ParseAPIError as BulkAPIError, type BulkClient, type BulkClientOptions, type BulkJob, type BulkPreview, type BulkPreviewInput, type BulkQuote, type BulkRequestOptions, type BulkResult, type BulkStartInput, type BulkStatus, type BulkUpload, type BulkUploadInput, type Caller, type CallerOptions, type Card, type CardDeep, type CardOptions, type Carrier, type CarrierDeep, type CarrierOptions, type City, type CityAmbiguityCandidate, type CityAncestorsOptions, type CityCollection, type CityCollectionFilters, type CityDeep, type CityDistance, type CityDistanceOptions, type CityGrain, type CityIdCall, type CityIdOptions, type CityList, type CityListOptions, type CityLookupCall, type CityMatch, type CityNearby, type CityNearbyCall, type CityNearbyCoordinates, type CityNearbyCoordinatesOptions, type CityNearbyOptions, type CityNearest, type CityNearestCall, type CityNearestOptions, type CityOptions, type CityPagingOptions, type CityParent, type CityRelations, type CityRelationsOptions, type CityResource, type CityResponseOptions, type CityScopeOptions, type CitySearch, type CitySearchCall, type CitySearchOptions, type CitySort, type Company, type CompanyCandidate, type CompanyCountry, type CompanyCoverage, type CompanyCoverageOptions, type CompanyDeep, type CompanyEmailAddress, type CompanyEmailReference, type CompanyIdOptions, type CompanyIndustryReference, type CompanyMatch, type CompanyOptions, type CompanyPhoneNumber, type CompanyPhoneReference, type CompanyProfile, type CompanyProfileAddress, type CompanyProfileDeep, type CompanyProfileDomain, type CompanyProfileEmail, type CompanyProfileEmployees, type CompanyProfileFounding, type CompanyProfileIdentifier, type CompanyProfileIndustry, type CompanyProfileJurisdiction, type CompanyProfileListing, type CompanyProfilePhone, type CompanyProfileRegistration, type CompanyProfileRegistrationAddress, type CompanyProfileRegistrationLegalForm, type CompanyProfileSource, type CompanyProfileWebsite, type CompanySearch, type CompanySearchOptions, type CompanySocialProfile, type Continent, type ContinentCountries, type ContinentCountriesOptions, type ContinentCountryItem, type ContinentOptions, type Country, type CountryCapital, type CountryDeep, type CountryElevationPoint, type CountryEmergency, type CountryOptions, type CountryStateItem, type CountryStates, type CountryStatesOptions, type CountryTax, type DateInfo, type DateInfoDeep, type DateOptions, type DateTodayOptions, type Deep, type District, type DistrictDeep, type DistrictOptions, type Dns, type DnsOptions, type DnsRecord, type Domain, type DomainDeep, type DomainOptions, type DomainRegistration, type DomainRegistrationResult, type DomainResult, type DomainResultDeep, type Elevation, type ElevationLocations, type ElevationOptions, type Email, type EmailDeep, type EmailOptions, type Emoji, type EmojiArtwork, type EmojiArtworkSource, type EmojiBrowse, type EmojiBrowseOptions, EmojiCatalog, type EmojiCatalogConvertOptions, type EmojiCatalogData, EmojiCatalogError, type EmojiCatalogLocalization, type EmojiCatalogLookupOptions, type EmojiCatalogOptions, type EmojiCatalogParseOptions, type EmojiCatalogRegexOptions, type EmojiCatalogScope, type EmojiCatalogSearchFacts, type EmojiCatalogSearchOptions, type EmojiCategories, type EmojiCategory, type EmojiConversion, type EmojiConvertOptions, type EmojiDeep, type EmojiMetadata, type EmojiNativeSearchFacts, type EmojiNotice, type EmojiOptions, type EmojiParse, type EmojiParseOptions, type EmojiPosition, type EmojiSearch, type EmojiSearchOptions, type EmojiShortcodeSourceMetadata, type EmojiSkin, type EmojiSource, type EmojiUnresolved, type EmojiVariant, type Hlr, type HlrDeep, type HlrOptions, type Holiday, type HolidayDate, type HolidayDateOptions, type HolidayOptions, type HolidayYear, type Industry, type IndustryChild, type IndustryCorrection, type IndustryDeep, type IndustryExclusion, type IndustryMatch, type IndustryOptions, type IndustrySearch, type IndustrySearchItem, type IndustrySearchOptions, type Ip, type IpDeep, type IpOptions, type IpSelfOptions, type Language, type LanguageDeep, type LanguageOption, type LanguageOptions, type Mx, type MxOptions, type MxRecord, type Naics, type NaicsChild, type NaicsCorrection, type NaicsDeep, type NaicsExclusion, type NaicsMatch, type NaicsOptions, type NaicsSearch, type NaicsSearchItem, type NaicsSearchOptions, type Name, type NameDeep, type NameOptions, type ParseAPIClient, ParseAPIError, type ParseAPIOptions, type Phone, type PhoneDeep, type PhoneOptions, type Point, type PointCity, type PointDeep, type PointOptions, type Postal, type PostalDeep, type PostalDistance, type PostalDistanceEnd, type PostalDistanceOptions, type PostalLocality, type PostalMetro, type PostalMetrosDeep, type PostalNearby, type PostalNearbyItem, type PostalNearbyOptions, type PostalOptions, type Preflight, type PreflightCost, type PreflightEmailCapacity, type PreflightOperation, type PreflightOperationEstimate, type PreflightPooledCapacity, type PreflightSpendCapacity, type PreflightTask, type PropertyTax, type RequestOptions, type Stack, type StackOptions, type StackResult, type StackTechnology, type State, type StateCapital, type StateDeep, type StateDistrictDeep, type StateDistrictItem, type StateDistricts, type StateDistrictsOptions, type StateOptions, type StateTax, type Time, type TimeAtOptions, type TimeLocation, type TimeLocationCandidate, type TimeLocationInput, type TimeOptions, type TimeResolution, type TimeResolutionAlternative, type TimeSeason, type TimeTransition, type TimeTransitionState, type TimeZoneEntry, type TimeZones, type TimeZonesOptions, type Timezone, type TimezoneAtOptions, type TimezoneConversionTarget, type TimezoneConversionTargetDeep, type TimezoneDeep, type TimezoneNextDst, type TimezoneOptions, type Useragent, type UseragentBrowserBrand, type UseragentBrowserDeep, type UseragentDeep, type UseragentDeviceDeep, type UseragentEngineDeep, type UseragentOptions, type UseragentOsDeep, type Weather, type WeatherAir, type WeatherAlert, type WeatherCurrent, type WeatherCurrentDeep, type WeatherDay, type WeatherDeep, type WeatherForecastPeriod, type WeatherHistory, type WeatherHour, type WeatherMinute, type WeatherOptions, type WeatherStation, createBulkClient, parseAPI };

package/dist/index.d.ts

@@ -72,7 +72,13 @@ interface Country {
     deep?: Deep<CountryDeep>;
     /** IANA timezones used by the country. */
     timezones: string[] | null;
+    /** ISO 3166-1 alpha-3 country code. */
+    iso_alpha3?: string | null;
+    /** ISO 3166-1 numeric country code. */
+    iso_numeric?: number | null;
+    /** @deprecated Older servers use iso3. Read iso_alpha3 on the current contract. */
     iso3?: string | null;
+    /** @deprecated Older servers use numeric. Read iso_numeric on the current contract. */
     numeric?: number | null;
     /** Official long name. */
     name_full?: string | null;
@@ -114,9 +120,14 @@ interface State {
     country_name: string | null;
     latitude: number | null;
     longitude: number | null;
-    timezone: string | null;
     timezones: string[];
-    iso_3166_2: string | null;
+    /** Full ISO 3166-2 subdivision code, including its country prefix. */
+    iso_subdivision?: string | null;
+    /** @deprecated Legacy candidate spelling. Read iso_subdivision on the current contract. */
+    iso?: string | null;
+    fips: string | null;
+    area_codes: string[] | null;
+    capital: StateCapital;
     deep?: Deep<StateDeep>;
 }
 interface StateDistrictItem {
@@ -147,7 +158,6 @@ interface District {
     country_name: string | null;
     latitude: number | null;
     longitude: number | null;
-    timezone: string | null;
     timezones: string[];
     deep?: Deep<DistrictDeep>;
 }
@@ -349,11 +359,6 @@ interface Stack {
     url: string;
     /** Time of the check, or null when no HTML page could be checked. */
     checked_at: string | null;
-    scope: 'homepage' | 'site';
-    /** Number of successfully checked HTML pages. */
-    pages: number;
-    /** True for homepage-only or incomplete bounded checks; null when no HTML page could be checked. False never guarantees every page was visited. */
-    partial: boolean | null;
     /** Collections are null when no HTML page could be checked and empty when no matches were found. */
     cms: StackTechnology[] | null;
     servers: StackTechnology[] | null;
@@ -478,6 +483,11 @@ interface Language {
     script: string | null;
     direction: 'ltr' | 'rtl' | string;
     deep?: Deep<LanguageDeep>;
+    /** ISO 639-3 language code. */
+    iso_alpha3?: string | null;
+    /** @deprecated Older servers use iso3. Read iso_alpha3 on the current contract. */
+    iso3?: string | null;
+    countries?: string[] | null;
 }
 /** 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 {
@@ -1191,7 +1201,9 @@ interface CountryDeep {
     urban_population?: number | null;
     /** Share of population using the internet, from 0 to 100. */
     internet_users?: number | null;
+    /** @deprecated Older deep contract. Current ISO identifiers live in Core. */
     iso3: string;
+    /** @deprecated Older deep contract. Current iso_numeric lives in Core. */
     numeric: number;
     full_name: string | null;
     demonym: string | null;
@@ -1252,18 +1264,19 @@ interface CountryElevationPoint {
     elevation: number;
 }
 interface StateDeep {
+    /** @deprecated Older deep contract. Read Core iso_subdivision on the current contract. */
+    iso_3166_2?: string | null;
     population: number | null;
     /** @deprecated No longer returned. Retained for source compatibility. */
     population_period?: string | null;
     /** Total area in km2. */
     area: number | null;
-    fips: string | null;
-    capital: string | null;
-    area_codes: string[];
-    /** Levy name, such as VAT, GST or sales tax. Null when unknown or not applicable. */
-    tax: string | null;
-    /** State or province reference rate in percent. Country, state and postal rates are alternative references, not additive. */
-    tax_rate: number | null;
+    tax: StateTax;
+    /** @deprecated Historical Deep read members. */
+    fips?: string | null;
+    capital?: string | null;
+    area_codes?: string[];
+    tax_rate?: number | null;
 }
 interface DistrictDeep {
     population: number | null;
@@ -1355,8 +1368,10 @@ interface HlrDeep {
     mnc: string | null;
 }
 interface LanguageDeep {
-    iso3: string | null;
-    countries: string[];
+    /** @deprecated Older deep contract. Read Core iso_alpha3 on the current contract. */
+    iso3?: string | null;
+    /** @deprecated Older deep contract. Current country associations live in Core. */
+    countries?: string[] | null;
 }
 interface NameDeep {
     gender: 'male' | 'female' | null;
@@ -1604,6 +1619,29 @@ interface CityNearbyCoordinates extends CityCollection {
     radius: number;
     unit: string;
 }
+/** Minimal related records returned in Company Core. Rich Deep records stay separate. */
+interface CompanyIndustryReference {
+    type: string;
+    code: string;
+}
+interface CompanyPhoneReference {
+    number: string;
+    country?: string | null;
+    e164?: string | null;
+}
+interface CompanyEmailReference {
+    address: string;
+}
+interface StateTax {
+    name: string | null;
+    /** Reference rate in percent. Choose the geographic scope for the task. */
+    rate: number | null;
+}
+interface StateCapital {
+    name: string | null;
+    lat: number | null;
+    lon: number | null;
+}
 
 /** Every non-2xx response from the API. Branch on `code`, never on `message`. */
 declare class ParseAPIError extends Error {
@@ -1873,8 +1911,8 @@ interface DomainResult {
     available: boolean | null;
     deep?: Deep<DomainResultDeep>;
 }
-/** The current eleven-field Stack response, without obsolete coverage members. */
-type StackResult = Omit<Stack, 'scope' | 'pages' | 'partial'>;
+/** Alias for the current Stack response. */
+type StackResult = Stack;
 
 interface EmojiCatalogLookupOptions {
     deep?: boolean;
@@ -2279,7 +2317,7 @@ declare function parseAPI(apiKey?: string, options?: ParseAPIOptions): {
     caller: (number: string, opts?: CallerOptions) => Promise<Caller>;
     /** Look up phone status at the last check. Live means assigned and connected means reachable at that check. Cached results may be returned. Null means unconfirmed. Deep adds network diagnostics within the same metered lookup. No automatic retries by default. */
     hlr: (number: string, opts?: HlrOptions) => Promise<Hlr>;
-    /** Identify website technologies by category, with homepage or bounded site coverage metadata. */
+    /** Identify technologies in static homepage HTML and response headers. */
     stack: (domain: string, opts?: StackOptions) => Promise<Stack>;
     /** Check registration: available is true, false or null when unknown. Paid Deep adds available registration details. */
     domain: (domain: string, opts?: DomainOptions) => Promise<Domain>;
@@ -2431,4 +2469,4 @@ interface CityNearbyCall {
     (name: string, opts: CityNearbyOptions): Promise<CityNearby | CityCollection>;
 }
 
-export { type Address, type AddressOptions, type AddressSearch, type AddressSearchOptions, type AddressSuggestion, type AgentTask, type AgentTaskInput, type AgentTaskLookupInput, type AgentTaskResult, type Asn, type AsnOptions, BULK_CHECKS, type Bin, type BinOptions, ParseAPIError as BulkAPIError, type BulkClient, type BulkClientOptions, type BulkJob, type BulkPreview, type BulkPreviewInput, type BulkQuote, type BulkRequestOptions, type BulkResult, type BulkStartInput, type BulkStatus, type BulkUpload, type BulkUploadInput, type Caller, type CallerOptions, type Card, type CardDeep, type CardOptions, type Carrier, type CarrierDeep, type CarrierOptions, type City, type CityAmbiguityCandidate, type CityAncestorsOptions, type CityCollection, type CityCollectionFilters, type CityDeep, type CityDistance, type CityDistanceOptions, type CityGrain, type CityIdCall, type CityIdOptions, type CityList, type CityListOptions, type CityLookupCall, type CityMatch, type CityNearby, type CityNearbyCall, type CityNearbyCoordinates, type CityNearbyCoordinatesOptions, type CityNearbyOptions, type CityNearest, type CityNearestCall, type CityNearestOptions, type CityOptions, type CityPagingOptions, type CityParent, type CityRelations, type CityRelationsOptions, type CityResource, type CityResponseOptions, type CityScopeOptions, type CitySearch, type CitySearchCall, type CitySearchOptions, type CitySort, type Company, type CompanyCandidate, type CompanyCountry, type CompanyCoverage, type CompanyCoverageOptions, type CompanyDeep, type CompanyEmailAddress, type CompanyIdOptions, type CompanyMatch, type CompanyOptions, type CompanyPhoneNumber, type CompanyProfile, type CompanyProfileAddress, type CompanyProfileDeep, type CompanyProfileDomain, type CompanyProfileEmail, type CompanyProfileEmployees, type CompanyProfileFounding, type CompanyProfileIdentifier, type CompanyProfileIndustry, type CompanyProfileJurisdiction, type CompanyProfileListing, type CompanyProfilePhone, type CompanyProfileRegistration, type CompanyProfileRegistrationAddress, type CompanyProfileRegistrationLegalForm, type CompanyProfileSource, type CompanyProfileWebsite, type CompanySearch, type CompanySearchOptions, type CompanySocialProfile, type Continent, type ContinentCountries, type ContinentCountriesOptions, type ContinentCountryItem, type ContinentOptions, type Country, type CountryCapital, type CountryDeep, type CountryElevationPoint, type CountryEmergency, type CountryOptions, type CountryStateItem, type CountryStates, type CountryStatesOptions, type CountryTax, type DateInfo, type DateInfoDeep, type DateOptions, type DateTodayOptions, type Deep, type District, type DistrictDeep, type DistrictOptions, type Dns, type DnsOptions, type DnsRecord, type Domain, type DomainDeep, type DomainOptions, type DomainRegistration, type DomainRegistrationResult, type DomainResult, type DomainResultDeep, type Elevation, type ElevationLocations, type ElevationOptions, type Email, type EmailDeep, type EmailOptions, type Emoji, type EmojiArtwork, type EmojiArtworkSource, type EmojiBrowse, type EmojiBrowseOptions, EmojiCatalog, type EmojiCatalogConvertOptions, type EmojiCatalogData, EmojiCatalogError, type EmojiCatalogLocalization, type EmojiCatalogLookupOptions, type EmojiCatalogOptions, type EmojiCatalogParseOptions, type EmojiCatalogRegexOptions, type EmojiCatalogScope, type EmojiCatalogSearchFacts, type EmojiCatalogSearchOptions, type EmojiCategories, type EmojiCategory, type EmojiConversion, type EmojiConvertOptions, type EmojiDeep, type EmojiMetadata, type EmojiNativeSearchFacts, type EmojiNotice, type EmojiOptions, type EmojiParse, type EmojiParseOptions, type EmojiPosition, type EmojiSearch, type EmojiSearchOptions, type EmojiShortcodeSourceMetadata, type EmojiSkin, type EmojiSource, type EmojiUnresolved, type EmojiVariant, type Hlr, type HlrDeep, type HlrOptions, type Holiday, type HolidayDate, type HolidayDateOptions, type HolidayOptions, type HolidayYear, type Industry, type IndustryChild, type IndustryCorrection, type IndustryDeep, type IndustryExclusion, type IndustryMatch, type IndustryOptions, type IndustrySearch, type IndustrySearchItem, type IndustrySearchOptions, type Ip, type IpDeep, type IpOptions, type IpSelfOptions, type Language, type LanguageDeep, type LanguageOption, type LanguageOptions, type Mx, type MxOptions, type MxRecord, type Naics, type NaicsChild, type NaicsCorrection, type NaicsDeep, type NaicsExclusion, type NaicsMatch, type NaicsOptions, type NaicsSearch, type NaicsSearchItem, type NaicsSearchOptions, type Name, type NameDeep, type NameOptions, type ParseAPIClient, ParseAPIError, type ParseAPIOptions, type Phone, type PhoneDeep, type PhoneOptions, type Point, type PointCity, type PointDeep, type PointOptions, type Postal, type PostalDeep, type PostalDistance, type PostalDistanceEnd, type PostalDistanceOptions, type PostalLocality, type PostalMetro, type PostalMetrosDeep, type PostalNearby, type PostalNearbyItem, type PostalNearbyOptions, type PostalOptions, type Preflight, type PreflightCost, type PreflightEmailCapacity, type PreflightOperation, type PreflightOperationEstimate, type PreflightPooledCapacity, type PreflightSpendCapacity, type PreflightTask, type PropertyTax, type RequestOptions, type Stack, type StackOptions, type StackResult, type StackTechnology, type State, type StateDeep, type StateDistrictDeep, type StateDistrictItem, type StateDistricts, type StateDistrictsOptions, type StateOptions, type Time, type TimeAtOptions, type TimeLocation, type TimeLocationCandidate, type TimeLocationInput, type TimeOptions, type TimeResolution, type TimeResolutionAlternative, type TimeSeason, type TimeTransition, type TimeTransitionState, type TimeZoneEntry, type TimeZones, type TimeZonesOptions, type Timezone, type TimezoneAtOptions, type TimezoneConversionTarget, type TimezoneConversionTargetDeep, type TimezoneDeep, type TimezoneNextDst, type TimezoneOptions, type Useragent, type UseragentBrowserBrand, type UseragentBrowserDeep, type UseragentDeep, type UseragentDeviceDeep, type UseragentEngineDeep, type UseragentOptions, type UseragentOsDeep, type Weather, type WeatherAir, type WeatherAlert, type WeatherCurrent, type WeatherCurrentDeep, type WeatherDay, type WeatherDeep, type WeatherForecastPeriod, type WeatherHistory, type WeatherHour, type WeatherMinute, type WeatherOptions, type WeatherStation, createBulkClient, parseAPI };
+export { type Address, type AddressOptions, type AddressSearch, type AddressSearchOptions, type AddressSuggestion, type AgentTask, type AgentTaskInput, type AgentTaskLookupInput, type AgentTaskResult, type Asn, type AsnOptions, BULK_CHECKS, type Bin, type BinOptions, ParseAPIError as BulkAPIError, type BulkClient, type BulkClientOptions, type BulkJob, type BulkPreview, type BulkPreviewInput, type BulkQuote, type BulkRequestOptions, type BulkResult, type BulkStartInput, type BulkStatus, type BulkUpload, type BulkUploadInput, type Caller, type CallerOptions, type Card, type CardDeep, type CardOptions, type Carrier, type CarrierDeep, type CarrierOptions, type City, type CityAmbiguityCandidate, type CityAncestorsOptions, type CityCollection, type CityCollectionFilters, type CityDeep, type CityDistance, type CityDistanceOptions, type CityGrain, type CityIdCall, type CityIdOptions, type CityList, type CityListOptions, type CityLookupCall, type CityMatch, type CityNearby, type CityNearbyCall, type CityNearbyCoordinates, type CityNearbyCoordinatesOptions, type CityNearbyOptions, type CityNearest, type CityNearestCall, type CityNearestOptions, type CityOptions, type CityPagingOptions, type CityParent, type CityRelations, type CityRelationsOptions, type CityResource, type CityResponseOptions, type CityScopeOptions, type CitySearch, type CitySearchCall, type CitySearchOptions, type CitySort, type Company, type CompanyCandidate, type CompanyCountry, type CompanyCoverage, type CompanyCoverageOptions, type CompanyDeep, type CompanyEmailAddress, type CompanyEmailReference, type CompanyIdOptions, type CompanyIndustryReference, type CompanyMatch, type CompanyOptions, type CompanyPhoneNumber, type CompanyPhoneReference, type CompanyProfile, type CompanyProfileAddress, type CompanyProfileDeep, type CompanyProfileDomain, type CompanyProfileEmail, type CompanyProfileEmployees, type CompanyProfileFounding, type CompanyProfileIdentifier, type CompanyProfileIndustry, type CompanyProfileJurisdiction, type CompanyProfileListing, type CompanyProfilePhone, type CompanyProfileRegistration, type CompanyProfileRegistrationAddress, type CompanyProfileRegistrationLegalForm, type CompanyProfileSource, type CompanyProfileWebsite, type CompanySearch, type CompanySearchOptions, type CompanySocialProfile, type Continent, type ContinentCountries, type ContinentCountriesOptions, type ContinentCountryItem, type ContinentOptions, type Country, type CountryCapital, type CountryDeep, type CountryElevationPoint, type CountryEmergency, type CountryOptions, type CountryStateItem, type CountryStates, type CountryStatesOptions, type CountryTax, type DateInfo, type DateInfoDeep, type DateOptions, type DateTodayOptions, type Deep, type District, type DistrictDeep, type DistrictOptions, type Dns, type DnsOptions, type DnsRecord, type Domain, type DomainDeep, type DomainOptions, type DomainRegistration, type DomainRegistrationResult, type DomainResult, type DomainResultDeep, type Elevation, type ElevationLocations, type ElevationOptions, type Email, type EmailDeep, type EmailOptions, type Emoji, type EmojiArtwork, type EmojiArtworkSource, type EmojiBrowse, type EmojiBrowseOptions, EmojiCatalog, type EmojiCatalogConvertOptions, type EmojiCatalogData, EmojiCatalogError, type EmojiCatalogLocalization, type EmojiCatalogLookupOptions, type EmojiCatalogOptions, type EmojiCatalogParseOptions, type EmojiCatalogRegexOptions, type EmojiCatalogScope, type EmojiCatalogSearchFacts, type EmojiCatalogSearchOptions, type EmojiCategories, type EmojiCategory, type EmojiConversion, type EmojiConvertOptions, type EmojiDeep, type EmojiMetadata, type EmojiNativeSearchFacts, type EmojiNotice, type EmojiOptions, type EmojiParse, type EmojiParseOptions, type EmojiPosition, type EmojiSearch, type EmojiSearchOptions, type EmojiShortcodeSourceMetadata, type EmojiSkin, type EmojiSource, type EmojiUnresolved, type EmojiVariant, type Hlr, type HlrDeep, type HlrOptions, type Holiday, type HolidayDate, type HolidayDateOptions, type HolidayOptions, type HolidayYear, type Industry, type IndustryChild, type IndustryCorrection, type IndustryDeep, type IndustryExclusion, type IndustryMatch, type IndustryOptions, type IndustrySearch, type IndustrySearchItem, type IndustrySearchOptions, type Ip, type IpDeep, type IpOptions, type IpSelfOptions, type Language, type LanguageDeep, type LanguageOption, type LanguageOptions, type Mx, type MxOptions, type MxRecord, type Naics, type NaicsChild, type NaicsCorrection, type NaicsDeep, type NaicsExclusion, type NaicsMatch, type NaicsOptions, type NaicsSearch, type NaicsSearchItem, type NaicsSearchOptions, type Name, type NameDeep, type NameOptions, type ParseAPIClient, ParseAPIError, type ParseAPIOptions, type Phone, type PhoneDeep, type PhoneOptions, type Point, type PointCity, type PointDeep, type PointOptions, type Postal, type PostalDeep, type PostalDistance, type PostalDistanceEnd, type PostalDistanceOptions, type PostalLocality, type PostalMetro, type PostalMetrosDeep, type PostalNearby, type PostalNearbyItem, type PostalNearbyOptions, type PostalOptions, type Preflight, type PreflightCost, type PreflightEmailCapacity, type PreflightOperation, type PreflightOperationEstimate, type PreflightPooledCapacity, type PreflightSpendCapacity, type PreflightTask, type PropertyTax, type RequestOptions, type Stack, type StackOptions, type StackResult, type StackTechnology, type State, type StateCapital, type StateDeep, type StateDistrictDeep, type StateDistrictItem, type StateDistricts, type StateDistrictsOptions, type StateOptions, type StateTax, type Time, type TimeAtOptions, type TimeLocation, type TimeLocationCandidate, type TimeLocationInput, type TimeOptions, type TimeResolution, type TimeResolutionAlternative, type TimeSeason, type TimeTransition, type TimeTransitionState, type TimeZoneEntry, type TimeZones, type TimeZonesOptions, type Timezone, type TimezoneAtOptions, type TimezoneConversionTarget, type TimezoneConversionTargetDeep, type TimezoneDeep, type TimezoneNextDst, type TimezoneOptions, type Useragent, type UseragentBrowserBrand, type UseragentBrowserDeep, type UseragentDeep, type UseragentDeviceDeep, type UseragentEngineDeep, type UseragentOptions, type UseragentOsDeep, type Weather, type WeatherAir, type WeatherAlert, type WeatherCurrent, type WeatherCurrentDeep, type WeatherDay, type WeatherDeep, type WeatherForecastPeriod, type WeatherHistory, type WeatherHour, type WeatherMinute, type WeatherOptions, type WeatherStation, createBulkClient, parseAPI };

package/dist/index.js

@@ -416,7 +416,7 @@ var EmojiCatalog = class {
 };
 
 // src/index.ts
-var VERSION = "1.12.5";
+var VERSION = "1.12.6";
 var API_VERSION = "2.0.0";
 var DEFAULT_BASE_URL = "https://api.parseapi.com";
 var DEFAULT_TIMEOUT_MS = 1e4;
@@ -718,7 +718,7 @@ function parseAPI(apiKey, options = {}) {
     caller: (number, opts) => request(`/caller/${enc(number)}`, { country: opts?.country }, void 0, opts),
     /** Look up phone status at the last check. Live means assigned and connected means reachable at that check. Cached results may be returned. Null means unconfirmed. Deep adds network diagnostics within the same metered lookup. No automatic retries by default. */
     hlr: (number, opts) => request(`/hlr/${enc(number)}`, { country: opts?.country, ...deepQuery(opts) }, void 0, opts),
-    /** Identify website technologies by category, with homepage or bounded site coverage metadata. */
+    /** Identify technologies in static homepage HTML and response headers. */
     stack: (domain, opts) => request(`/stack/${enc(domain)}`, { ...deepQuery(opts), pretty: opts?.pretty }, void 0, opts),
     /** Check registration: available is true, false or null when unknown. Paid Deep adds available registration details. */
     domain: (domain, opts) => request(`/domain/${enc(domain)}`, deepQuery(opts), void 0, opts),

package/package.json

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