@parseapi/sdk 1.7.0 → 1.9.0

package/dist/index.js

@@ -1,5 +1,5 @@
 // src/index.ts
-var VERSION = "1.7.0";
+var VERSION = "1.9.0";
 var API_VERSION = "2.0.0";
 var DEFAULT_BASE_URL = "https://api.parseapi.com";
 var DEFAULT_TIMEOUT_MS = 1e4;
@@ -15,13 +15,16 @@ var ParseAPIError = class extends Error {
   docs;
   /** Send this if you contact support */
   requestId;
-  constructor(status, code, message, docs, requestId) {
+  /** Original Retry-After response header, when supplied. */
+  retryAfter;
+  constructor(status, code, message, docs, requestId, retryAfter = null) {
     super(message);
     this.name = "ParseAPIError";
     this.status = status;
     this.code = code;
     this.docs = docs;
     this.requestId = requestId;
+    this.retryAfter = retryAfter;
   }
 };
 function tariffSelection(result, opts) {
@@ -30,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;
 }
@@ -66,16 +70,20 @@ function metered(path, query) {
 }
 function retryDelayMs(attempt, retryAfter) {
   if (retryAfter) {
-    const seconds = Number(retryAfter);
-    if (Number.isFinite(seconds) && seconds >= 0) {
-      return Math.min(seconds * 1e3, RETRY_AFTER_CAP_MS);
+    const value = retryAfter.trim();
+    if (/^[0-9]+(?:\.[0-9]+)?$/.test(value)) {
+      const seconds = Number(value);
+      return seconds > RETRY_AFTER_CAP_MS / 1e3 ? null : seconds * 1e3;
     }
-    if (Number.isNaN(seconds)) {
-      const date = Date.parse(retryAfter);
-      if (Number.isFinite(date)) return Math.min(Math.max(date - Date.now(), 0), RETRY_AFTER_CAP_MS);
+    if (/^[A-Za-z]{3,9},? /.test(value)) {
+      const date = Date.parse(value);
+      if (Number.isFinite(date)) {
+        const delay = Math.max(date - Date.now(), 0);
+        return delay > RETRY_AFTER_CAP_MS ? null : delay;
+      }
     }
   }
-  return Math.random() * 250 * 2 ** attempt;
+  return Math.random() * Math.min(250 * 2 ** Math.min(attempt, 16), RETRY_AFTER_CAP_MS);
 }
 function parseAPI(apiKey, options = {}) {
   const key = apiKey || env("PARSEAPI_KEY");
@@ -108,7 +116,7 @@ function parseAPI(apiKey, options = {}) {
       const onAbort = () => controller.abort(signal.reason);
       signal?.addEventListener("abort", onAbort, { once: true });
       const timer = setTimeout(() => controller.abort(new DOMException("Request timed out", "TimeoutError")), attemptTimeout);
-      let retryAfter = null;
+      let retryDelay;
       try {
         let res;
         try {
@@ -134,8 +142,8 @@ function parseAPI(apiKey, options = {}) {
             res = void 0;
           }
         }
-        if (res && RETRY_STATUS.has(res.status) && attempt < retries) {
-          retryAfter = res.headers.get("Retry-After");
+        if (res) retryDelay = retryDelayMs(attempt, res.headers.get("Retry-After"));
+        if (res && RETRY_STATUS.has(res.status) && attempt < retries && retryDelay !== null) {
           await res.body?.cancel().catch(() => {
           });
         } else if (res) {
@@ -152,14 +160,15 @@ function parseAPI(apiKey, options = {}) {
             typeof body2.code === "string" ? body2.code : "unknown_error",
             typeof body2.message === "string" ? body2.message : `Request failed with status ${res.status}`,
             typeof body2.docs === "string" ? body2.docs : null,
-            typeof body2.request_id === "string" ? body2.request_id : null
+            typeof body2.request_id === "string" ? body2.request_id : null,
+            res.headers.get("Retry-After")
           );
         }
       } finally {
         clearTimeout(timer);
         signal?.removeEventListener("abort", onAbort);
       }
-      await sleep(retryDelayMs(attempt, retryAfter), signal);
+      await sleep(retryDelay ?? retryDelayMs(attempt, null), signal);
     }
   }
   const enc = encodeURIComponent;
@@ -173,6 +182,12 @@ function parseAPI(apiKey, options = {}) {
     for (const [name, value2] of Object.entries(query)) url.searchParams.set(name, String(value2));
     return !numericJson && url.href.length <= 8e3 ? request("/elevation", query, void 0, opts) : request("/elevation", void 0, void 0, opts, { [selector]: coordinates, ...sampling });
   }
+  const industry = Object.assign(
+    (code, opts) => request(`/industry/${enc(code)}`, deepQuery(opts), void 0, opts),
+    {
+      search: (query, opts) => request("/industry", { q: query, limit: opts?.limit, ...deepQuery(opts) }, void 0, opts)
+    }
+  );
   return {
     /** 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),
@@ -245,7 +260,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.
@@ -258,8 +283,16 @@ function parseAPI(apiKey, options = {}) {
       from: opts?.from,
       ...deepQuery(opts)
     }, void 0, opts),
+    // Keep existing callers on their established HTTP contracts.
     iban: (iban, opts) => request(`/iban/${enc(iban)}`, { country: opts?.country, ...deepQuery(opts) }, void 0, opts),
+    bin: (bin, opts) => request(`/bin/${enc(bin)}`, { deep: opts?.deep }, void 0, opts),
     npi: (npi, opts) => request(`/npi/${enc(npi)}`, deepQuery(opts), void 0, opts),
+    bank: (iban, opts) => request("/bank", void 0, void 0, opts, { iban, country: opts?.country, deep: opts?.deep }),
+    /** Check US routing/account syntax using POST. Does not verify ownership, existence or ACH eligibility. */
+    bankUsAch: (input, opts) => request("/bank", void 0, void 0, opts, { format: "us_ach", country: "US", routing: input.routing, account: input.account }),
+    /** Describe supported input fields and check scope; this does not establish country directory coverage. */
+    bankRequirements: (country, opts) => request("/bank/requirements", { country, format: opts?.format }, void 0, opts),
+    provider: (npi, opts) => request(`/provider/${enc(npi)}`, deepQuery(opts), void 0, opts),
     /** Parse a phone number and its formats. Pass country for national numbers when needed. Deep adds numbering-plan geography. */
     phone: (number, opts) => request(`/phone/${enc(number)}`, { country: opts?.country, ...deepQuery(opts) }, void 0, opts),
     /** Request a metered carrier lookup. No automatic retries by default. */
@@ -274,8 +307,13 @@ function parseAPI(apiKey, options = {}) {
     domain: (domain, opts) => request(`/domain/${enc(domain)}`, deepQuery(opts), void 0, opts),
     asn: (asn, opts) => request(`/asn/${enc(asn)}`, void 0, void 0, opts),
     mac: (mac, opts) => request(`/mac/${enc(mac)}`, void 0, void 0, opts),
-    /** Look up a 6-11 digit card prefix. Keep leading zeros in the input string. */
-    bin: (bin, opts) => request(`/bin/${enc(bin)}`, { deep: opts?.deep }, void 0, opts),
+    /** Look up a 2-11 digit card prefix. Keep leading zeros in the input string. */
+    card: async (bin, opts) => {
+      if (typeof bin !== "string" || bin.length > 64 || !/^[0-9]{2,11}$/.test(bin.replace(/[ \t\r\n-]/g, ""))) {
+        throw new TypeError("parseAPI: Card requires a string containing 2 to 11 digits. Send a prefix only.");
+      }
+      return request(`/card/${enc(bin)}`, deepQuery(opts), void 0, opts);
+    },
     /** Parse a measurement or convert it to `to`. Without `to`, use its type's canonical unit. Invalid input is plain data with `valid: false`. */
     measure: Object.assign(
       (measure, opts) => request(`/measure/${enc(measure)}`, { to: opts?.to, locale: opts?.locale, system: opts?.system }, void 0, opts),
@@ -288,14 +326,14 @@ function parseAPI(apiKey, options = {}) {
     dns: (domain, opts) => request(`/dns/${enc(domain)}`, { type: opts?.type }, void 0, opts),
     mx: (domain, opts) => request(`/mx/${enc(domain)}`, void 0, void 0, opts),
     useragent: (ua, opts) => request("/useragent", deepQuery(opts), { "User-Agent": ua }, opts),
+    /** Identify a vehicle by VIN. Paid deep adds specifications and model-level recall campaigns. */
+    vehicle: (vin, opts) => request(`/vehicle/${enc(vin)}`, deepQuery(opts), void 0, opts),
+    /** Compatibility entry for VIN callers. */
     vin: (vin, opts) => request(`/vin/${enc(vin)}`, deepQuery(opts), void 0, opts),
     /** US NAICS 2022 definitions and hierarchy. */
-    naics: Object.assign(
-      (code, opts) => request(`/naics/${enc(code)}`, deepQuery(opts), void 0, opts),
-      {
-        search: (query, opts) => request("/naics", { q: query, limit: opts?.limit, ...deepQuery(opts) }, void 0, opts)
-      }
-    ),
+    industry,
+    /** Compatibility name for industry. */
+    naics: industry,
     /** Look up the general US duty schedule line. Paid deep adds units and the special and other schedule columns. Add origin with deep to resolve country-specific measures. Without origin, schedule detail remains available and origin-dependent fields are null. A null effective rate is not a zero rate. */
     tariff: Object.assign(
       (code, opts) => request(`/tariff/${enc(code)}`, { origin: opts?.origin, edition: opts?.edition, date: opts?.date, ...deepQuery(opts) }, void 0, opts).then((result) => tariffSelection(result, opts)),

package/package.json

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