@parseapi/sdk 1.1.0 → 1.2.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.1.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.
+Version 1.2.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.
 
 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.
 
@@ -210,7 +210,7 @@ Choose enrichment for the question you need answered.
 |---|---|
 | IP | Richer IP fields included with a paid plan. No separate check meter. |
 | Domain | Registration dates, registrar, status and DNSSEC, included with a paid plan. Use `dns` for DNS records and `mx` for mail routing. |
-| Email | A metered deliverability check, using included email checks or enabled on-demand usage. |
+| Email | A metered mailbox check with deliverability, catch-all, status, reason and address hints, using included email checks or enabled on-demand usage. |
 | VAT | A metered registry check where supported, using included VAT checks or enabled on-demand usage. |
 | Phone, Time, Date, Currency, Language, Emoji, IBAN, 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. |
@@ -219,6 +219,10 @@ Choose enrichment for the question you need answered.
 | 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. |
 
+Email deep includes mailbox status and the reason for the result, plus a suggested first name, no-reply flag, plus-address tag and mail service. The suggested name is not a verified identity. Unavailable details are null.
+
+Reasons include `accepted`, `invalid_format`, `invalid_domain`, `no_mail_server`, `mailbox_not_found`, `mailbox_disabled`, `mailbox_full`, `catchall`, `disposable`, `temporary_failure`, `rejected` and `unconfirmed`.
+
 Carrier, caller, and HLR are separate metered operations. Choose them explicitly when you need their answers. Ordinary lookups retry twice by default. Metered checks use one attempt by default. Setting retries explicitly can repeat paid usage.
 
 Without `deep`, the response omits that key. When requested, it is an empty object if access is locked or the operation has no deep fields. Otherwise it contains the available fields. A missing or null field means unknown.

package/dist/index.cjs

@@ -24,7 +24,7 @@ __export(index_exports, {
   parseAPI: () => parseAPI
 });
 module.exports = __toCommonJS(index_exports);
-var VERSION = "1.1.0";
+var VERSION = "1.2.0";
 var API_VERSION = "2.0.0";
 var DEFAULT_BASE_URL = "https://api.parseapi.com";
 var DEFAULT_TIMEOUT_MS = 1e4;

package/dist/index.d.cts

@@ -250,8 +250,19 @@ interface PostalDistance {
     distance_mi: number;
 }
 interface EmailDeep {
+    /** Suggested first name. Not a verified identity. */
+    first_name?: string | null;
+    no_reply?: boolean | null;
+    /** Plus-address tag, without the plus sign. */
+    tag?: string | null;
+    /** Mail service handling the address, such as Google or Microsoft. */
+    mail_provider?: string | null;
     deliverable: boolean | null;
     catchall: boolean | null;
+    /** Mailbox status: deliverable, undeliverable or risky. Null when unavailable. */
+    status?: string | null;
+    /** Why the address received this result, such as mailbox_full or mailbox_not_found. Null when unavailable. */
+    reason?: string | null;
 }
 interface Email {
     email: string;

package/dist/index.d.ts

@@ -250,8 +250,19 @@ interface PostalDistance {
     distance_mi: number;
 }
 interface EmailDeep {
+    /** Suggested first name. Not a verified identity. */
+    first_name?: string | null;
+    no_reply?: boolean | null;
+    /** Plus-address tag, without the plus sign. */
+    tag?: string | null;
+    /** Mail service handling the address, such as Google or Microsoft. */
+    mail_provider?: string | null;
     deliverable: boolean | null;
     catchall: boolean | null;
+    /** Mailbox status: deliverable, undeliverable or risky. Null when unavailable. */
+    status?: string | null;
+    /** Why the address received this result, such as mailbox_full or mailbox_not_found. Null when unavailable. */
+    reason?: string | null;
 }
 interface Email {
     email: string;

package/dist/index.js

@@ -1,5 +1,5 @@
 // src/index.ts
-var VERSION = "1.1.0";
+var VERSION = "1.2.0";
 var API_VERSION = "2.0.0";
 var DEFAULT_BASE_URL = "https://api.parseapi.com";
 var DEFAULT_TIMEOUT_MS = 1e4;

package/package.json

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