@parseapi/sdk 1.8.0 → 1.10.0

package/README.md

@@ -17,7 +17,7 @@ Get a key at [parseapi.com](https://parseapi.com). The client also reads `PARSEA
 
 ## API versions
 
-Version 1.7.0 explicitly selects the API contract supported by this SDK. It sends `Parse-Version: 2.0.0` on every lookup so responses match the API contract supported by the package. Your key and the team's saved default stay the same.
+This SDK explicitly selects the API contract supported by this SDK. It sends `Parse-Version: 2.0.0` on every lookup so responses match the API contract supported by the package. Your key and the team's saved default stay the same.
 
 Upgrade the dependency in staging, review the [release notes](https://parseapi.com/docs/releases), and test the application before deploying the same code and dependency version to production. Commit your dependency lockfile so the tested package travels with your deployment. Future major SDK upgrades can select a newer API contract.
 
@@ -80,6 +80,36 @@ behavior and does not inherit a previous request's choice.
 
 ## Calls
 
+Search the company directory, then refetch an ID you have chosen:
+
+```ts
+const candidates = await parse.company.search({ query: 'Cloudflare', country: 'US' });
+// After the caller chooses a candidate, retain its id for later lookups.
+const chosenId = 'co_xw3f22es6cjq';
+const company = await parse.company.id(chosenId, { deep: true });
+const coverage = await parse.company.coverage();
+```
+
+Company search accepts at most one of `query`, `domain`, `ticker`, or `identifier`, or discovers candidates using country or exact industry filters.
+Use `exchange` with a ticker, or `authority` with an identifier. `country`, `limit`
+and the returned `next` cursor narrow or page the same search. Pass the cursor as
+`cursor` with the same selector, filters and limit. Each result has its own
+`match` and optional `deep`. The SDK returns all candidates without choosing one.
+Directory methods accept `signal`, `timeoutMs` and `retries`, and omit `lang`.
+Directory deep adds detail in the same pooled request on every plan.
+
+Company directory social profiles contain `platform`, `url` and `handle`; unknown metadata stays null. Phone and email records use `type` for the source-reported purpose. Earlier response fields remain readable by the client.
+Coverage describes the current directory edition. Empty listings do not establish
+private ownership. Deep source entries attribute selected enrichment fields, and
+logo URLs are returned without fetching images. The existing `company(number)`
+call still parses national registration numbers and returns `Company`.
+
+Discovery example: `await parse.company.search({ country: 'US', industry: '0700', industry_type: 'sic' });`
+
+Supply `industry` and `industry_type` together. The supported namespace is `sic`, with an exact four-digit string such as `0700`; leading zeros are meaningful. Country-only discovery is also supported. Filters intersect and may narrow an existing selector. Country matches the profile country, not a headquarters or operating-presence claim. Unknown values do not match a requested filter. Filter-only candidates use `match.field: "filters"` and `match.value: null`; reuse the same filters and limit with a returned cursor. Counts describe this directory edition, not complete country coverage.
+
+
+
 One method per endpoint, named after the route.
 
 ```ts
@@ -101,6 +131,11 @@ await parse.postal.distance('28202', '10001', { country: 'US' });
 await parse.address('1600 Pennsylvania Ave NW, Washington DC', { country: 'US' });
 await parse.address.search('1600 Pennsylvania', { country: 'US', postal: '20500' });
 await parse.company('51 824 753 556', { country: 'AU' });
+await parse.company.id('co_xw3f22es6cjq', { deep: true });
+await parse.company.search({ domain: 'cloudflare.com' });
+await parse.company.search({ ticker: 'NET', exchange: 'NYSE' });
+await parse.company.search({ identifier: '0001477333', authority: 'SEC' });
+await parse.company.coverage();
 await parse.city('charlotte', { country: 'US' });
 await parse.city.id('city_mb8mbqrkz8zb');
 await parse.city.search('char', { country: 'US', limit: 10 });
@@ -303,8 +338,8 @@ Choose enrichment for the question you need answered.
 | Phone, Time, Date, Currency, Language, Emoji, Bank, Point | Optional detail in the same pooled request on every plan. |
 | Country, State, District, City, Postal | The place profile on paid plans, including demographic and tax facts where held. |
 | Name, Industry | Name evidence or the industry definition profile on paid plans. |
-| NPI | Deactivation date, Medicare enrollment, opt-out and enrollment rows from stored sources on paid plans. Exclusion evidence stays core. |
-| Vehicle, Tariff, Company | The complete product detail bag on paid plans. |
+| Vehicle, Tariff, Company (national number) | The complete product detail bag on paid plans. |
+| Company directory | Profile detail in the same pooled request on every plan. Search detail belongs to each company result. |
 | Weather | Specialist current measurements and the existing forecast, alert, air and history bag on paid plans. |
 | Carrier, HLR | Optional diagnostic detail within the same metered core unit, including Free allowance units. No second gate or additional check. |
 

package/dist/index.cjs

@@ -24,7 +24,7 @@ __export(index_exports, {
   parseAPI: () => parseAPI
 });
 module.exports = __toCommonJS(index_exports);
-var VERSION = "1.8.0";
+var VERSION = "1.10.0";
 var API_VERSION = "2.0.0";
 var DEFAULT_BASE_URL = "https://api.parseapi.com";
 var DEFAULT_TIMEOUT_MS = 1e4;
@@ -58,6 +58,7 @@ function tariffSelection(result, opts) {
   }
   return result;
 }
+var requestControls = (opts) => ({ signal: opts?.signal, timeoutMs: opts?.timeoutMs, retries: opts?.retries });
 function env(name) {
   return typeof process !== "undefined" ? process.env?.[name] : void 0;
 }
@@ -213,6 +214,16 @@ function parseAPI(apiKey, options = {}) {
     }
   );
   return {
+    /** Create a bounded task. Reuse the same request ID and inputs on retries. */
+    task: Object.assign(
+      (input, requestId, opts) => request("/task", void 0, { "Idempotency-Key": requestId }, opts, input),
+      {
+        get: (id, opts) => request(`/task/${enc(id)}`, void 0, void 0, opts),
+        cancel: (id, opts) => request(`/task/${enc(id)}/cancel`, void 0, void 0, opts, {}),
+        /** Reuse requestId with identical inputs to recover the saved result without another lookup or charge. */
+        lookup: (id, input, requestId, opts) => request(`/task/${enc(id)}/lookup`, void 0, { "Idempotency-Key": requestId }, opts, input)
+      }
+    ),
     /** Estimate task access, capacity and additional charges. Requires a secret key. Reserves no units or money and does not enforce the supplied budget. */
     preflight: (task, opts) => request("/preflight", void 0, void 0, opts, task),
     /** Look up an IP. `deep: true` adds enrichment included with a paid plan, without a separate check meter. */
@@ -284,7 +295,17 @@ function parseAPI(apiKey, options = {}) {
         search: (query, opts) => request("/address", { q: query, country: opts?.country, postal: opts?.postal, city: opts?.city, state: opts?.state, ip: opts?.ip }, void 0, opts)
       }
     ),
-    company: (number, opts) => request(`/company/${enc(number)}`, { country: opts?.country, ...deepQuery(opts) }, void 0, opts),
+    company: Object.assign(
+      (number, opts) => request(`/company/${enc(number)}`, { country: opts?.country, ...deepQuery(opts) }, void 0, opts),
+      {
+        /** Look up a stable directory ID. Requested deep belongs to this profile. */
+        id: (id, opts) => request(`/company/id/${enc(id)}`, deepQuery(opts), void 0, requestControls(opts)),
+        /** Return candidates without selecting a match. Use one selector, country, exact industry, filters. */
+        search: (opts) => request("/company", { q: opts.query, domain: opts.domain, ticker: opts.ticker, identifier: opts.identifier, country: opts.country, industry: opts.industry, industry_type: opts.industry_type, exchange: opts.exchange, authority: opts.authority, limit: opts.limit, cursor: opts.cursor, ...deepQuery(opts) }, void 0, requestControls(opts)),
+        /** Describe the directory edition and its counts. Counts do not establish complete country coverage. */
+        coverage: (opts) => request("/company/directory/coverage", void 0, void 0, requestControls(opts))
+      }
+    ),
     /**
      * Parse an email and check its format and domain.
      * `deep: true` explicitly requests a metered deliverability check using included checks or enabled on-demand usage.

package/dist/index.d.cts

@@ -1132,6 +1132,180 @@ interface Company {
     postal: string | null;
     deep?: Deep<CompanyDeep>;
 }
+/** Directory listing claims. Exchange and symbol remain separate from legal identifiers. */
+interface CompanyProfileListing {
+    exchange: string;
+    symbol: string;
+}
+interface CompanyProfileAddress {
+    type: string;
+    street: string | null;
+    city: string | null;
+    state: string | null;
+    postal: string | null;
+    country: string | null;
+}
+interface CompanyProfileJurisdiction {
+    country: string | null;
+    state: string | null;
+}
+interface CompanyProfileWebsite {
+    domain: string;
+    url: string | null;
+}
+interface CompanyProfileIdentifier {
+    type: string;
+    authority: string;
+    value: string;
+}
+interface CompanyProfileIndustry {
+    type: string;
+    code: string;
+    name: string | null;
+}
+/** Source-stated founding value. Precision is year, month, day, or a future open value. */
+interface CompanyProfileFounding {
+    value: string;
+    precision: string;
+}
+/** Reported workforce count for the stated basis, scope and measurement date. */
+interface CompanyProfileEmployees {
+    count: number;
+    as_of: string;
+    /** Open string: headcount, full_time or full_time_equivalent. Older responses omit it. */
+    basis?: string | null;
+    /** Open string, currently legal_entity or consolidated_group. */
+    scope: string;
+    /** Open string, currently reported. */
+    method: string;
+    approximate: boolean;
+}
+/** Legal form recorded by a register; codes remain open strings. */
+interface CompanyProfileRegistrationLegalForm {
+    code: string;
+    name: string;
+}
+/** Source-recorded principal address. State and country_raw are not inferred ISO codes. */
+interface CompanyProfileRegistrationAddress {
+    kind: string;
+    line1: string | null;
+    line2: string | null;
+    city: string | null;
+    state: string | null;
+    postal: string | null;
+    country_raw: string | null;
+}
+/** Registry-scoped legal facts; registration does not establish current operation or tax exemption. */
+interface CompanyProfileRegistration {
+    authority: string;
+    number: string;
+    jurisdiction: CompanyProfileJurisdiction;
+    role: string;
+    legal_form: CompanyProfileRegistrationLegalForm;
+    status: string;
+    /** This register's reported entity-form date, not universal incorporation or founding. */
+    formation_date: string | null;
+    address: CompanyProfileRegistrationAddress | null;
+}
+/** Attribution for selected enrichment fields, not the whole company profile. */
+interface CompanyProfileSource {
+    type: string;
+    url: string;
+    fields: string[];
+    observed_at: string;
+    /** Explicit source update timestamp or null; employee measurement dates remain in as_of. */
+    updated_at: string | null;
+}
+/** Selected public business contacts. Purpose is source-reported or null. */
+interface CompanyProfilePhone {
+    number: string;
+    kind: string | null;
+}
+interface CompanyProfileEmail {
+    address: string;
+    kind: string | null;
+}
+/** An associated domain and its recorded URL, when known. */
+type CompanyProfileDomain = CompanyProfileWebsite;
+interface CompanySocialProfile {
+    platform: string | null;
+    url: string;
+    handle: string | null;
+}
+interface CompanyPhoneNumber {
+    number: string;
+    type: string | null;
+}
+interface CompanyEmailAddress {
+    address: string;
+    type: string | null;
+}
+/** Directory detail, distinct from national-number CompanyDeep. Missing or null facts remain unknown. */
+interface CompanyProfileDeep {
+    legal_name?: string | null;
+    aliases?: string[] | null;
+    jurisdiction?: CompanyProfileJurisdiction | null;
+    status?: string | null;
+    domains?: CompanyProfileDomain[] | null;
+    social_profiles?: CompanySocialProfile[] | null;
+    phone_numbers?: CompanyPhoneNumber[] | null;
+    email_addresses?: CompanyEmailAddress[] | null;
+    /** Earlier directory responses. */
+    websites?: CompanyProfileWebsite[] | null;
+    identifiers?: CompanyProfileIdentifier[] | null;
+    incorporated?: string | null;
+    addresses?: CompanyProfileAddress[] | null;
+    industries?: CompanyProfileIndustry[] | null;
+    parent?: string | null;
+    description?: string | null;
+    /** Returned asset URL only. The SDK does not fetch it. */
+    logo?: string | null;
+    socials?: string[] | null;
+    phones?: CompanyProfilePhone[] | null;
+    emails?: CompanyProfileEmail[] | null;
+    /** Founding claim, distinct from legal incorporation. Year-only dates stay year-only. */
+    founded?: CompanyProfileFounding | null;
+    employees?: CompanyProfileEmployees | null;
+    /** Empty means no admitted registration facts; older editions may omit this member. */
+    registrations?: CompanyProfileRegistration[] | null;
+    sources?: CompanyProfileSource[] | null;
+}
+interface CompanyProfile {
+    id: string;
+    name: string;
+    country: string | null;
+    website: string | null;
+    listings: CompanyProfileListing[] | null;
+    address: CompanyProfileAddress | null;
+    deep?: Deep<CompanyProfileDeep>;
+}
+/** Why a candidate matched. Field/type/authority/exchange values remain extensible strings. */
+interface CompanyMatch {
+    field?: string | null;
+    value?: string | null;
+    type?: string | null;
+    authority?: string | null;
+    exchange?: string | null;
+}
+interface CompanyCandidate extends CompanyProfile {
+    match: CompanyMatch;
+}
+interface CompanySearch {
+    companies: CompanyCandidate[];
+    next: string | null;
+}
+/** Edition counts describe the records available, not all companies in a country. */
+interface CompanyCoverage {
+    scope: string;
+    label: string;
+    description: string;
+    snapshot_at: string;
+    companies: number;
+    countries: string[];
+    with_website: number;
+    with_listings: number;
+    with_address: number;
+}
 /** A direct child industry code. */
 interface NaicsChild {
     naics: string;
@@ -1578,7 +1752,7 @@ interface IbanDeep {
 
 /** A proposed task contains operation counts, never lookup inputs. */
 interface PreflightOperation {
-    operation: 'email' | 'domain' | 'dns' | 'mx' | 'country';
+    operation: 'email' | 'domain' | 'dns' | 'mx' | 'country' | 'vat' | 'carrier' | 'caller' | 'hlr' | 'ip' | 'phone' | 'postal';
     /** Positive integer, at most 100000. */
     count: number;
     deep?: boolean;
@@ -1659,6 +1833,16 @@ interface Preflight {
     operations: PreflightOperationEstimate[];
     cost: PreflightCost;
     capacity: {
+        meters?: Record<string, {
+            advisory: true;
+            required_max: number;
+            included_limit: number;
+            reserved_at_snapshot: number | null;
+            unallocated_included_at_snapshot: number | null;
+            on_demand_enabled: boolean | null;
+            on_demand_unit_price_usd: string | null;
+            reset_at: number;
+        }>;
         pooled_requests: PreflightPooledCapacity;
         email_verifications: PreflightEmailCapacity;
         shared_on_demand_spend: PreflightSpendCapacity;
@@ -1672,6 +1856,58 @@ interface Preflight {
     warnings: string[];
 }
 
+/** Additional-charge budget enforced only for lookups run through this task. */
+interface AgentTaskInput {
+    operations: PreflightOperation[];
+    budget_usd: string;
+}
+interface AgentTaskLookupInput {
+    operation: PreflightOperation['operation'];
+    value: string;
+    deep?: boolean;
+    country?: string;
+}
+interface AgentTask {
+    id: string;
+    status: string;
+    api_version: string;
+    created_at: string;
+    expires_at: string;
+    result_expires_at: string;
+    budget: {
+        currency: string;
+        enforced: true;
+        maximum_usd: string;
+        spent_usd: string;
+        reserved_usd: string;
+        remaining_usd: string;
+    };
+    operations: {
+        operation: string;
+        deep: boolean;
+        count: number;
+        allocated: number;
+        completed: number;
+        remaining: number;
+    }[];
+}
+/** Inspect status_code and result. Saved errors also replay without new usage. */
+interface AgentTaskResult<T = unknown> {
+    status_code: number;
+    result: T;
+    receipt: {
+        task_id: string;
+        request_id: string;
+        operation: string;
+        deep: boolean;
+        metered_unit: boolean;
+        additional_cost_usd: string;
+        checked_at: string;
+        api_version: string;
+        retry_after?: string;
+    };
+}
+
 /** Every non-2xx response from the API. Branch on `code`, never on `message`. */
 declare class ParseAPIError extends Error {
     /** HTTP status */
@@ -1776,6 +2012,30 @@ type AddressSearchOptions = {
 type CompanyOptions = LanguageOption & {
     country?: string;
 } & DeepOption & RequestOptions;
+/** Refetch a directory company by its stable co_ ID. */
+type CompanyIdOptions = DeepOption & RequestOptions;
+/** Choose at most one selector, or discover by country, exact industry. The API validates filters and cursors. */
+type CompanySearchOptions = {
+    /** Company name search. Sent as q. */
+    query?: string;
+    domain?: string;
+    ticker?: string;
+    identifier?: string;
+    /** ISO2 country filter. */
+    country?: string;
+    /** Exact four-digit SIC code string, preserving leading zeros. Requires industry_type. */
+    industry?: string;
+    /** Industry namespace; currently sic. Requires industry. */
+    industry_type?: string;
+    /** Exchange filter for ticker searches. */
+    exchange?: string;
+    /** Issuing authority filter for identifier searches. */
+    authority?: string;
+    limit?: number;
+    /** Opaque next-page cursor. Keep the same selector and filters. */
+    cursor?: string;
+} & DeepOption & RequestOptions;
+type CompanyCoverageOptions = RequestOptions;
 /** `deep: true` requests a metered deliverability check. No automatic retries by default. */
 type EmailOptions = DeepOption & RequestOptions;
 /** `deep: true` requests a metered registry check where supported. `from` is your own VAT number. */
@@ -1943,6 +2203,13 @@ interface DeepOption {
     deep?: boolean;
 }
 declare function parseAPI(apiKey?: string, options?: ParseAPIOptions): {
+    /** Create a bounded task. Reuse the same request ID and inputs on retries. */
+    task: ((input: AgentTaskInput, requestId: string, opts?: RequestOptions) => Promise<AgentTask>) & {
+        get: (id: string, opts?: RequestOptions) => Promise<AgentTask>;
+        cancel: (id: string, opts?: RequestOptions) => Promise<AgentTask>;
+        /** Reuse requestId with identical inputs to recover the saved result without another lookup or charge. */
+        lookup: <T = unknown>(id: string, input: AgentTaskLookupInput, requestId: string, opts?: RequestOptions) => Promise<AgentTaskResult<T>>;
+    };
     /** Estimate task access, capacity and additional charges. Requires a secret key. Reserves no units or money and does not enforce the supplied budget. */
     preflight: (task: PreflightTask, opts?: RequestOptions) => Promise<Preflight>;
     /** Look up an IP. `deep: true` adds enrichment included with a paid plan, without a separate check meter. */
@@ -1978,7 +2245,14 @@ declare function parseAPI(apiKey?: string, options?: ParseAPIOptions): {
         /** Find address suggestions using the context supplied. Prefer postal, or city and state, from the form. ip is an optional end-user locality hint for server-side calls. An empty result has reason more_input, missing_context or no_matches. Suggestions have reason null. Operational failures are errors. */
         search: (query: string, opts?: AddressSearchOptions) => Promise<AddressSearch>;
     };
-    company: (number: string, opts?: CompanyOptions) => Promise<Company>;
+    company: ((number: string, opts?: CompanyOptions) => Promise<Company>) & {
+        /** Look up a stable directory ID. Requested deep belongs to this profile. */
+        id: (id: string, opts?: CompanyIdOptions) => Promise<CompanyProfile>;
+        /** Return candidates without selecting a match. Use one selector, country, exact industry, filters. */
+        search: (opts: CompanySearchOptions) => Promise<CompanySearch>;
+        /** Describe the directory edition and its counts. Counts do not establish complete country coverage. */
+        coverage: (opts?: CompanyCoverageOptions) => Promise<CompanyCoverage>;
+    };
     /**
      * Parse an email and check its format and domain.
      * `deep: true` explicitly requests a metered deliverability check using included checks or enabled on-demand usage.
@@ -2081,4 +2355,4 @@ type IbanOptions = {
 type NpiOptions = LanguageOption & DeepOption & RequestOptions;
 type BinOptions = DeepOption & RequestOptions;
 
-export { type Address, type AddressOptions, type AddressSearch, type AddressSearchOptions, type AddressSuggestion, type Asn, type AsnOptions, type Bank, type BankChecks, type BankDeep, type BankDirectory, type BankIssue, type BankOptions, type BankRequirementField, type BankRequirements, type BankRequirementsOptions, type BankUsAch, type BankUsAchChecks, type BankUsAchInput, type Bin, type BinOptions, type Bloc, type BlocCountries, type BlocCountriesOptions, type BlocCountryItem, type BlocOptions, type Caller, type CallerOptions, type Card, type CardDeep, type CardOptions, type Carrier, type CarrierDeep, type CarrierOptions, type City, type CityDeep, type CityIdOptions, type CityNearby, type CityNearbyOptions, type CityNearest, type CityNearestOptions, type CityOptions, type CitySearch, type CitySearchOptions, type Company, type CompanyCountry, type CompanyDeep, type CompanyOptions, type Continent, type ContinentCountries, type ContinentCountriesOptions, type ContinentCountryItem, type ContinentOptions, type Country, type CountryDeep, type CountryElevationPoint, type CountryEmergency, type CountryOptions, type CountryStateItem, type CountryStates, type CountryStatesOptions, type Currency, type CurrencyDeep, type CurrencyOptions, type CurrencyRate, type CurrencyRateOptions, 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 Elevation, type ElevationLocations, type ElevationOptions, type Email, type EmailDeep, type EmailOptions, type Emoji, type EmojiDeep, type EmojiOptions, type EmojiSearch, type EmojiSearchOptions, type EmojiSkin, type Hlr, type HlrDeep, type HlrOptions, type Holiday, type HolidayDate, type HolidayDateOptions, type HolidayOptions, type HolidayYear, type Iban, type IbanDeep, type IbanOptions, 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 Mac, type MacOptions, type Measure, type MeasureChoice, type MeasureOptions, type MeasureUnit, type MeasureUnits, type MeasureUnitsOptions, 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 Npi, type NpiDeep, type NpiEnrollment, type NpiOptions, 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 Provider, type ProviderDeep, type ProviderEnrollment, type ProviderOptions, type ProviderSource, type ProviderSources, type ProviderTaxonomy, type RequestOptions, type Stack, type StackOptions, type StackTechnology, type State, type StateDeep, type StateDistrictDeep, type StateDistrictItem, type StateDistricts, type StateDistrictsOptions, type StateOptions, type Tariff, type TariffDeep, type TariffMeasure, type TariffOptions, type TariffSearch, type TariffSearchHit, type TariffSearchOptions, 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 Vat, type VatAddress, type VatDeep, type VatOptions, type Vehicle, type VehicleDeep, type VehicleOptions, type VehicleRecall, type Vin, type VinDeep, type VinOptions, type VinRecall, 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, parseAPI };
+export { type Address, type AddressOptions, type AddressSearch, type AddressSearchOptions, type AddressSuggestion, type AgentTask, type AgentTaskInput, type AgentTaskLookupInput, type AgentTaskResult, type Asn, type AsnOptions, type Bank, type BankChecks, type BankDeep, type BankDirectory, type BankIssue, type BankOptions, type BankRequirementField, type BankRequirements, type BankRequirementsOptions, type BankUsAch, type BankUsAchChecks, type BankUsAchInput, type Bin, type BinOptions, type Bloc, type BlocCountries, type BlocCountriesOptions, type BlocCountryItem, type BlocOptions, type Caller, type CallerOptions, type Card, type CardDeep, type CardOptions, type Carrier, type CarrierDeep, type CarrierOptions, type City, type CityDeep, type CityIdOptions, type CityNearby, type CityNearbyOptions, type CityNearest, type CityNearestOptions, type CityOptions, type CitySearch, type CitySearchOptions, 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 CountryDeep, type CountryElevationPoint, type CountryEmergency, type CountryOptions, type CountryStateItem, type CountryStates, type CountryStatesOptions, type Currency, type CurrencyDeep, type CurrencyOptions, type CurrencyRate, type CurrencyRateOptions, 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 Elevation, type ElevationLocations, type ElevationOptions, type Email, type EmailDeep, type EmailOptions, type Emoji, type EmojiDeep, type EmojiOptions, type EmojiSearch, type EmojiSearchOptions, type EmojiSkin, type Hlr, type HlrDeep, type HlrOptions, type Holiday, type HolidayDate, type HolidayDateOptions, type HolidayOptions, type HolidayYear, type Iban, type IbanDeep, type IbanOptions, 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 Mac, type MacOptions, type Measure, type MeasureChoice, type MeasureOptions, type MeasureUnit, type MeasureUnits, type MeasureUnitsOptions, 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 Npi, type NpiDeep, type NpiEnrollment, type NpiOptions, 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 Provider, type ProviderDeep, type ProviderEnrollment, type ProviderOptions, type ProviderSource, type ProviderSources, type ProviderTaxonomy, type RequestOptions, type Stack, type StackOptions, type StackTechnology, type State, type StateDeep, type StateDistrictDeep, type StateDistrictItem, type StateDistricts, type StateDistrictsOptions, type StateOptions, type Tariff, type TariffDeep, type TariffMeasure, type TariffOptions, type TariffSearch, type TariffSearchHit, type TariffSearchOptions, 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 Vat, type VatAddress, type VatDeep, type VatOptions, type Vehicle, type VehicleDeep, type VehicleOptions, type VehicleRecall, type Vin, type VinDeep, type VinOptions, type VinRecall, 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, parseAPI };

package/dist/index.d.ts

@@ -1132,6 +1132,180 @@ interface Company {
     postal: string | null;
     deep?: Deep<CompanyDeep>;
 }
+/** Directory listing claims. Exchange and symbol remain separate from legal identifiers. */
+interface CompanyProfileListing {
+    exchange: string;
+    symbol: string;
+}
+interface CompanyProfileAddress {
+    type: string;
+    street: string | null;
+    city: string | null;
+    state: string | null;
+    postal: string | null;
+    country: string | null;
+}
+interface CompanyProfileJurisdiction {
+    country: string | null;
+    state: string | null;
+}
+interface CompanyProfileWebsite {
+    domain: string;
+    url: string | null;
+}
+interface CompanyProfileIdentifier {
+    type: string;
+    authority: string;
+    value: string;
+}
+interface CompanyProfileIndustry {
+    type: string;
+    code: string;
+    name: string | null;
+}
+/** Source-stated founding value. Precision is year, month, day, or a future open value. */
+interface CompanyProfileFounding {
+    value: string;
+    precision: string;
+}
+/** Reported workforce count for the stated basis, scope and measurement date. */
+interface CompanyProfileEmployees {
+    count: number;
+    as_of: string;
+    /** Open string: headcount, full_time or full_time_equivalent. Older responses omit it. */
+    basis?: string | null;
+    /** Open string, currently legal_entity or consolidated_group. */
+    scope: string;
+    /** Open string, currently reported. */
+    method: string;
+    approximate: boolean;
+}
+/** Legal form recorded by a register; codes remain open strings. */
+interface CompanyProfileRegistrationLegalForm {
+    code: string;
+    name: string;
+}
+/** Source-recorded principal address. State and country_raw are not inferred ISO codes. */
+interface CompanyProfileRegistrationAddress {
+    kind: string;
+    line1: string | null;
+    line2: string | null;
+    city: string | null;
+    state: string | null;
+    postal: string | null;
+    country_raw: string | null;
+}
+/** Registry-scoped legal facts; registration does not establish current operation or tax exemption. */
+interface CompanyProfileRegistration {
+    authority: string;
+    number: string;
+    jurisdiction: CompanyProfileJurisdiction;
+    role: string;
+    legal_form: CompanyProfileRegistrationLegalForm;
+    status: string;
+    /** This register's reported entity-form date, not universal incorporation or founding. */
+    formation_date: string | null;
+    address: CompanyProfileRegistrationAddress | null;
+}
+/** Attribution for selected enrichment fields, not the whole company profile. */
+interface CompanyProfileSource {
+    type: string;
+    url: string;
+    fields: string[];
+    observed_at: string;
+    /** Explicit source update timestamp or null; employee measurement dates remain in as_of. */
+    updated_at: string | null;
+}
+/** Selected public business contacts. Purpose is source-reported or null. */
+interface CompanyProfilePhone {
+    number: string;
+    kind: string | null;
+}
+interface CompanyProfileEmail {
+    address: string;
+    kind: string | null;
+}
+/** An associated domain and its recorded URL, when known. */
+type CompanyProfileDomain = CompanyProfileWebsite;
+interface CompanySocialProfile {
+    platform: string | null;
+    url: string;
+    handle: string | null;
+}
+interface CompanyPhoneNumber {
+    number: string;
+    type: string | null;
+}
+interface CompanyEmailAddress {
+    address: string;
+    type: string | null;
+}
+/** Directory detail, distinct from national-number CompanyDeep. Missing or null facts remain unknown. */
+interface CompanyProfileDeep {
+    legal_name?: string | null;
+    aliases?: string[] | null;
+    jurisdiction?: CompanyProfileJurisdiction | null;
+    status?: string | null;
+    domains?: CompanyProfileDomain[] | null;
+    social_profiles?: CompanySocialProfile[] | null;
+    phone_numbers?: CompanyPhoneNumber[] | null;
+    email_addresses?: CompanyEmailAddress[] | null;
+    /** Earlier directory responses. */
+    websites?: CompanyProfileWebsite[] | null;
+    identifiers?: CompanyProfileIdentifier[] | null;
+    incorporated?: string | null;
+    addresses?: CompanyProfileAddress[] | null;
+    industries?: CompanyProfileIndustry[] | null;
+    parent?: string | null;
+    description?: string | null;
+    /** Returned asset URL only. The SDK does not fetch it. */
+    logo?: string | null;
+    socials?: string[] | null;
+    phones?: CompanyProfilePhone[] | null;
+    emails?: CompanyProfileEmail[] | null;
+    /** Founding claim, distinct from legal incorporation. Year-only dates stay year-only. */
+    founded?: CompanyProfileFounding | null;
+    employees?: CompanyProfileEmployees | null;
+    /** Empty means no admitted registration facts; older editions may omit this member. */
+    registrations?: CompanyProfileRegistration[] | null;
+    sources?: CompanyProfileSource[] | null;
+}
+interface CompanyProfile {
+    id: string;
+    name: string;
+    country: string | null;
+    website: string | null;
+    listings: CompanyProfileListing[] | null;
+    address: CompanyProfileAddress | null;
+    deep?: Deep<CompanyProfileDeep>;
+}
+/** Why a candidate matched. Field/type/authority/exchange values remain extensible strings. */
+interface CompanyMatch {
+    field?: string | null;
+    value?: string | null;
+    type?: string | null;
+    authority?: string | null;
+    exchange?: string | null;
+}
+interface CompanyCandidate extends CompanyProfile {
+    match: CompanyMatch;
+}
+interface CompanySearch {
+    companies: CompanyCandidate[];
+    next: string | null;
+}
+/** Edition counts describe the records available, not all companies in a country. */
+interface CompanyCoverage {
+    scope: string;
+    label: string;
+    description: string;
+    snapshot_at: string;
+    companies: number;
+    countries: string[];
+    with_website: number;
+    with_listings: number;
+    with_address: number;
+}
 /** A direct child industry code. */
 interface NaicsChild {
     naics: string;
@@ -1578,7 +1752,7 @@ interface IbanDeep {
 
 /** A proposed task contains operation counts, never lookup inputs. */
 interface PreflightOperation {
-    operation: 'email' | 'domain' | 'dns' | 'mx' | 'country';
+    operation: 'email' | 'domain' | 'dns' | 'mx' | 'country' | 'vat' | 'carrier' | 'caller' | 'hlr' | 'ip' | 'phone' | 'postal';
     /** Positive integer, at most 100000. */
     count: number;
     deep?: boolean;
@@ -1659,6 +1833,16 @@ interface Preflight {
     operations: PreflightOperationEstimate[];
     cost: PreflightCost;
     capacity: {
+        meters?: Record<string, {
+            advisory: true;
+            required_max: number;
+            included_limit: number;
+            reserved_at_snapshot: number | null;
+            unallocated_included_at_snapshot: number | null;
+            on_demand_enabled: boolean | null;
+            on_demand_unit_price_usd: string | null;
+            reset_at: number;
+        }>;
         pooled_requests: PreflightPooledCapacity;
         email_verifications: PreflightEmailCapacity;
         shared_on_demand_spend: PreflightSpendCapacity;
@@ -1672,6 +1856,58 @@ interface Preflight {
     warnings: string[];
 }
 
+/** Additional-charge budget enforced only for lookups run through this task. */
+interface AgentTaskInput {
+    operations: PreflightOperation[];
+    budget_usd: string;
+}
+interface AgentTaskLookupInput {
+    operation: PreflightOperation['operation'];
+    value: string;
+    deep?: boolean;
+    country?: string;
+}
+interface AgentTask {
+    id: string;
+    status: string;
+    api_version: string;
+    created_at: string;
+    expires_at: string;
+    result_expires_at: string;
+    budget: {
+        currency: string;
+        enforced: true;
+        maximum_usd: string;
+        spent_usd: string;
+        reserved_usd: string;
+        remaining_usd: string;
+    };
+    operations: {
+        operation: string;
+        deep: boolean;
+        count: number;
+        allocated: number;
+        completed: number;
+        remaining: number;
+    }[];
+}
+/** Inspect status_code and result. Saved errors also replay without new usage. */
+interface AgentTaskResult<T = unknown> {
+    status_code: number;
+    result: T;
+    receipt: {
+        task_id: string;
+        request_id: string;
+        operation: string;
+        deep: boolean;
+        metered_unit: boolean;
+        additional_cost_usd: string;
+        checked_at: string;
+        api_version: string;
+        retry_after?: string;
+    };
+}
+
 /** Every non-2xx response from the API. Branch on `code`, never on `message`. */
 declare class ParseAPIError extends Error {
     /** HTTP status */
@@ -1776,6 +2012,30 @@ type AddressSearchOptions = {
 type CompanyOptions = LanguageOption & {
     country?: string;
 } & DeepOption & RequestOptions;
+/** Refetch a directory company by its stable co_ ID. */
+type CompanyIdOptions = DeepOption & RequestOptions;
+/** Choose at most one selector, or discover by country, exact industry. The API validates filters and cursors. */
+type CompanySearchOptions = {
+    /** Company name search. Sent as q. */
+    query?: string;
+    domain?: string;
+    ticker?: string;
+    identifier?: string;
+    /** ISO2 country filter. */
+    country?: string;
+    /** Exact four-digit SIC code string, preserving leading zeros. Requires industry_type. */
+    industry?: string;
+    /** Industry namespace; currently sic. Requires industry. */
+    industry_type?: string;
+    /** Exchange filter for ticker searches. */
+    exchange?: string;
+    /** Issuing authority filter for identifier searches. */
+    authority?: string;
+    limit?: number;
+    /** Opaque next-page cursor. Keep the same selector and filters. */
+    cursor?: string;
+} & DeepOption & RequestOptions;
+type CompanyCoverageOptions = RequestOptions;
 /** `deep: true` requests a metered deliverability check. No automatic retries by default. */
 type EmailOptions = DeepOption & RequestOptions;
 /** `deep: true` requests a metered registry check where supported. `from` is your own VAT number. */
@@ -1943,6 +2203,13 @@ interface DeepOption {
     deep?: boolean;
 }
 declare function parseAPI(apiKey?: string, options?: ParseAPIOptions): {
+    /** Create a bounded task. Reuse the same request ID and inputs on retries. */
+    task: ((input: AgentTaskInput, requestId: string, opts?: RequestOptions) => Promise<AgentTask>) & {
+        get: (id: string, opts?: RequestOptions) => Promise<AgentTask>;
+        cancel: (id: string, opts?: RequestOptions) => Promise<AgentTask>;
+        /** Reuse requestId with identical inputs to recover the saved result without another lookup or charge. */
+        lookup: <T = unknown>(id: string, input: AgentTaskLookupInput, requestId: string, opts?: RequestOptions) => Promise<AgentTaskResult<T>>;
+    };
     /** Estimate task access, capacity and additional charges. Requires a secret key. Reserves no units or money and does not enforce the supplied budget. */
     preflight: (task: PreflightTask, opts?: RequestOptions) => Promise<Preflight>;
     /** Look up an IP. `deep: true` adds enrichment included with a paid plan, without a separate check meter. */
@@ -1978,7 +2245,14 @@ declare function parseAPI(apiKey?: string, options?: ParseAPIOptions): {
         /** Find address suggestions using the context supplied. Prefer postal, or city and state, from the form. ip is an optional end-user locality hint for server-side calls. An empty result has reason more_input, missing_context or no_matches. Suggestions have reason null. Operational failures are errors. */
         search: (query: string, opts?: AddressSearchOptions) => Promise<AddressSearch>;
     };
-    company: (number: string, opts?: CompanyOptions) => Promise<Company>;
+    company: ((number: string, opts?: CompanyOptions) => Promise<Company>) & {
+        /** Look up a stable directory ID. Requested deep belongs to this profile. */
+        id: (id: string, opts?: CompanyIdOptions) => Promise<CompanyProfile>;
+        /** Return candidates without selecting a match. Use one selector, country, exact industry, filters. */
+        search: (opts: CompanySearchOptions) => Promise<CompanySearch>;
+        /** Describe the directory edition and its counts. Counts do not establish complete country coverage. */
+        coverage: (opts?: CompanyCoverageOptions) => Promise<CompanyCoverage>;
+    };
     /**
      * Parse an email and check its format and domain.
      * `deep: true` explicitly requests a metered deliverability check using included checks or enabled on-demand usage.
@@ -2081,4 +2355,4 @@ type IbanOptions = {
 type NpiOptions = LanguageOption & DeepOption & RequestOptions;
 type BinOptions = DeepOption & RequestOptions;
 
-export { type Address, type AddressOptions, type AddressSearch, type AddressSearchOptions, type AddressSuggestion, type Asn, type AsnOptions, type Bank, type BankChecks, type BankDeep, type BankDirectory, type BankIssue, type BankOptions, type BankRequirementField, type BankRequirements, type BankRequirementsOptions, type BankUsAch, type BankUsAchChecks, type BankUsAchInput, type Bin, type BinOptions, type Bloc, type BlocCountries, type BlocCountriesOptions, type BlocCountryItem, type BlocOptions, type Caller, type CallerOptions, type Card, type CardDeep, type CardOptions, type Carrier, type CarrierDeep, type CarrierOptions, type City, type CityDeep, type CityIdOptions, type CityNearby, type CityNearbyOptions, type CityNearest, type CityNearestOptions, type CityOptions, type CitySearch, type CitySearchOptions, type Company, type CompanyCountry, type CompanyDeep, type CompanyOptions, type Continent, type ContinentCountries, type ContinentCountriesOptions, type ContinentCountryItem, type ContinentOptions, type Country, type CountryDeep, type CountryElevationPoint, type CountryEmergency, type CountryOptions, type CountryStateItem, type CountryStates, type CountryStatesOptions, type Currency, type CurrencyDeep, type CurrencyOptions, type CurrencyRate, type CurrencyRateOptions, 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 Elevation, type ElevationLocations, type ElevationOptions, type Email, type EmailDeep, type EmailOptions, type Emoji, type EmojiDeep, type EmojiOptions, type EmojiSearch, type EmojiSearchOptions, type EmojiSkin, type Hlr, type HlrDeep, type HlrOptions, type Holiday, type HolidayDate, type HolidayDateOptions, type HolidayOptions, type HolidayYear, type Iban, type IbanDeep, type IbanOptions, 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 Mac, type MacOptions, type Measure, type MeasureChoice, type MeasureOptions, type MeasureUnit, type MeasureUnits, type MeasureUnitsOptions, 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 Npi, type NpiDeep, type NpiEnrollment, type NpiOptions, 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 Provider, type ProviderDeep, type ProviderEnrollment, type ProviderOptions, type ProviderSource, type ProviderSources, type ProviderTaxonomy, type RequestOptions, type Stack, type StackOptions, type StackTechnology, type State, type StateDeep, type StateDistrictDeep, type StateDistrictItem, type StateDistricts, type StateDistrictsOptions, type StateOptions, type Tariff, type TariffDeep, type TariffMeasure, type TariffOptions, type TariffSearch, type TariffSearchHit, type TariffSearchOptions, 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 Vat, type VatAddress, type VatDeep, type VatOptions, type Vehicle, type VehicleDeep, type VehicleOptions, type VehicleRecall, type Vin, type VinDeep, type VinOptions, type VinRecall, 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, parseAPI };
+export { type Address, type AddressOptions, type AddressSearch, type AddressSearchOptions, type AddressSuggestion, type AgentTask, type AgentTaskInput, type AgentTaskLookupInput, type AgentTaskResult, type Asn, type AsnOptions, type Bank, type BankChecks, type BankDeep, type BankDirectory, type BankIssue, type BankOptions, type BankRequirementField, type BankRequirements, type BankRequirementsOptions, type BankUsAch, type BankUsAchChecks, type BankUsAchInput, type Bin, type BinOptions, type Bloc, type BlocCountries, type BlocCountriesOptions, type BlocCountryItem, type BlocOptions, type Caller, type CallerOptions, type Card, type CardDeep, type CardOptions, type Carrier, type CarrierDeep, type CarrierOptions, type City, type CityDeep, type CityIdOptions, type CityNearby, type CityNearbyOptions, type CityNearest, type CityNearestOptions, type CityOptions, type CitySearch, type CitySearchOptions, 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 CountryDeep, type CountryElevationPoint, type CountryEmergency, type CountryOptions, type CountryStateItem, type CountryStates, type CountryStatesOptions, type Currency, type CurrencyDeep, type CurrencyOptions, type CurrencyRate, type CurrencyRateOptions, 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 Elevation, type ElevationLocations, type ElevationOptions, type Email, type EmailDeep, type EmailOptions, type Emoji, type EmojiDeep, type EmojiOptions, type EmojiSearch, type EmojiSearchOptions, type EmojiSkin, type Hlr, type HlrDeep, type HlrOptions, type Holiday, type HolidayDate, type HolidayDateOptions, type HolidayOptions, type HolidayYear, type Iban, type IbanDeep, type IbanOptions, 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 Mac, type MacOptions, type Measure, type MeasureChoice, type MeasureOptions, type MeasureUnit, type MeasureUnits, type MeasureUnitsOptions, 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 Npi, type NpiDeep, type NpiEnrollment, type NpiOptions, 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 Provider, type ProviderDeep, type ProviderEnrollment, type ProviderOptions, type ProviderSource, type ProviderSources, type ProviderTaxonomy, type RequestOptions, type Stack, type StackOptions, type StackTechnology, type State, type StateDeep, type StateDistrictDeep, type StateDistrictItem, type StateDistricts, type StateDistrictsOptions, type StateOptions, type Tariff, type TariffDeep, type TariffMeasure, type TariffOptions, type TariffSearch, type TariffSearchHit, type TariffSearchOptions, 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 Vat, type VatAddress, type VatDeep, type VatOptions, type Vehicle, type VehicleDeep, type VehicleOptions, type VehicleRecall, type Vin, type VinDeep, type VinOptions, type VinRecall, 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, parseAPI };

package/dist/index.js

@@ -1,5 +1,5 @@
 // src/index.ts
-var VERSION = "1.8.0";
+var VERSION = "1.10.0";
 var API_VERSION = "2.0.0";
 var DEFAULT_BASE_URL = "https://api.parseapi.com";
 var DEFAULT_TIMEOUT_MS = 1e4;
@@ -33,6 +33,7 @@ function tariffSelection(result, opts) {
   }
   return result;
 }
+var requestControls = (opts) => ({ signal: opts?.signal, timeoutMs: opts?.timeoutMs, retries: opts?.retries });
 function env(name) {
   return typeof process !== "undefined" ? process.env?.[name] : void 0;
 }
@@ -188,6 +189,16 @@ function parseAPI(apiKey, options = {}) {
     }
   );
   return {
+    /** Create a bounded task. Reuse the same request ID and inputs on retries. */
+    task: Object.assign(
+      (input, requestId, opts) => request("/task", void 0, { "Idempotency-Key": requestId }, opts, input),
+      {
+        get: (id, opts) => request(`/task/${enc(id)}`, void 0, void 0, opts),
+        cancel: (id, opts) => request(`/task/${enc(id)}/cancel`, void 0, void 0, opts, {}),
+        /** Reuse requestId with identical inputs to recover the saved result without another lookup or charge. */
+        lookup: (id, input, requestId, opts) => request(`/task/${enc(id)}/lookup`, void 0, { "Idempotency-Key": requestId }, opts, input)
+      }
+    ),
     /** Estimate task access, capacity and additional charges. Requires a secret key. Reserves no units or money and does not enforce the supplied budget. */
     preflight: (task, opts) => request("/preflight", void 0, void 0, opts, task),
     /** Look up an IP. `deep: true` adds enrichment included with a paid plan, without a separate check meter. */
@@ -259,7 +270,17 @@ function parseAPI(apiKey, options = {}) {
         search: (query, opts) => request("/address", { q: query, country: opts?.country, postal: opts?.postal, city: opts?.city, state: opts?.state, ip: opts?.ip }, void 0, opts)
       }
     ),
-    company: (number, opts) => request(`/company/${enc(number)}`, { country: opts?.country, ...deepQuery(opts) }, void 0, opts),
+    company: Object.assign(
+      (number, opts) => request(`/company/${enc(number)}`, { country: opts?.country, ...deepQuery(opts) }, void 0, opts),
+      {
+        /** Look up a stable directory ID. Requested deep belongs to this profile. */
+        id: (id, opts) => request(`/company/id/${enc(id)}`, deepQuery(opts), void 0, requestControls(opts)),
+        /** Return candidates without selecting a match. Use one selector, country, exact industry, filters. */
+        search: (opts) => request("/company", { q: opts.query, domain: opts.domain, ticker: opts.ticker, identifier: opts.identifier, country: opts.country, industry: opts.industry, industry_type: opts.industry_type, exchange: opts.exchange, authority: opts.authority, limit: opts.limit, cursor: opts.cursor, ...deepQuery(opts) }, void 0, requestControls(opts)),
+        /** Describe the directory edition and its counts. Counts do not establish complete country coverage. */
+        coverage: (opts) => request("/company/directory/coverage", void 0, void 0, requestControls(opts))
+      }
+    ),
     /**
      * Parse an email and check its format and domain.
      * `deep: true` explicitly requests a metered deliverability check using included checks or enabled on-demand usage.

package/package.json

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