@zernio/node 0.2.784 → 0.2.786

package/dist/index.d.mts

@@ -1529,11 +1529,39 @@ declare const Late: typeof Zernio;
 /**
  * Base error class for Zernio API errors
  */
+/**
+ * The canonical error envelope the API returns. Everything but `error` is
+ * optional, and every field is surfaced on ZernioApiError: dropping any of them
+ * leaves callers unable to tell apart failures the API distinguishes. For a
+ * Meta pass-through in particular, `platformError.subcode` is the only thing
+ * that separates a closed messaging window from a blocked recipient, since both
+ * arrive as code `platform_api_error`.
+ */
+interface ZernioErrorBody {
+    error?: string;
+    message?: string;
+    type?: string;
+    code?: string;
+    param?: string;
+    platform?: string;
+    platformError?: Record<string, unknown>;
+    details?: Record<string, unknown>;
+}
 declare class ZernioApiError extends Error {
     readonly statusCode: number;
     readonly code?: string;
     readonly details?: Record<string, unknown>;
-    constructor(message: string, statusCode: number, code?: string, details?: Record<string, unknown>);
+    /** Error class, e.g. invalid_request_error, platform_error, rate_limit_error. */
+    readonly type?: string;
+    /** The request field that caused the error, when the API names one. */
+    readonly param?: string;
+    /** Upstream platform, present when type is platform_error. */
+    readonly platform?: string;
+    /** The upstream platform's own payload, verbatim (Meta: code, subcode, fbtrace_id). */
+    readonly platformError?: Record<string, unknown>;
+    /** The parsed response body exactly as the API sent it, for anything not modelled above. */
+    readonly body?: ZernioErrorBody;
+    constructor(message: string, statusCode: number, code?: string, details?: Record<string, unknown>, body?: ZernioErrorBody);
     /**
      * Check if this is a rate limit error
      */
@@ -1568,7 +1596,7 @@ declare class RateLimitError extends ZernioApiError {
     readonly limit?: number;
     readonly remaining?: number;
     readonly resetAt?: Date;
-    constructor(message: string, limit?: number, remaining?: number, resetAt?: Date);
+    constructor(message: string, limit?: number, remaining?: number, resetAt?: Date, body?: ZernioErrorBody);
     /**
      * Get seconds until rate limit resets
      */
@@ -1579,17 +1607,12 @@ declare class RateLimitError extends ZernioApiError {
  */
 declare class ValidationError extends ZernioApiError {
     readonly fields?: Record<string, string[]>;
-    constructor(message: string, fields?: Record<string, string[]>);
+    constructor(message: string, fields?: Record<string, string[]>, body?: ZernioErrorBody);
 }
 /**
  * Parse an error response from the API
  */
-declare function parseApiError(response: Response, body?: {
-    error?: string;
-    message?: string;
-    code?: string;
-    details?: Record<string, unknown>;
-}): ZernioApiError;
+declare function parseApiError(response: Response, body?: ZernioErrorBody): ZernioApiError;
 
 type AccountsListResponse = {
     accounts: Array<SocialAccount>;
@@ -7421,6 +7444,10 @@ type PhoneNumberStockWatch = {
      * The watched number type, or null when the watch covers every type in the country.
      */
     numberType: ('local' | 'mobile' | 'national' | 'toll_free') | null;
+    /**
+     * The watched area code (NDC), or null when the watch covers every area.
+     */
+    areaCode?: (string) | null;
     createdAt: string;
 };
 /**
@@ -11258,6 +11285,14 @@ type WebhookPayloadPhoneNumberStockAvailable = {
              */
             availableCount: number;
         }>;
+        /**
+         * Set when the watch named an area: the area code (NDC) that is back in stock.
+         */
+        areaCode?: string;
+        /**
+         * The name of that area, when known.
+         */
+        areaName?: string;
     };
     /**
      * UTC time at which Zernio generated this event (set once when the event payload is built, before delivery is queued). Retries and redeliveries keep the original value, so it reflects the event, not the delivery attempt.
@@ -24695,7 +24730,7 @@ type ReplyToInboxReviewResponse = ({
     };
     platform?: string;
 });
-type ReplyToInboxReviewError = ({
+type ReplyToInboxReviewError = (ErrorResponse | {
     error?: string;
 } | unknown);
 type DeleteInboxReviewReplyData = {
@@ -27300,6 +27335,24 @@ type CheckPhoneNumberAvailabilityResponse = ({
          */
         count?: number;
     }>;
+    /**
+     * Areas that had stock in the last 90 days and have none now. Pass one as `areaCode` with `preOrder: true` on the KYC submit when `preOrderable` is true, or watch it with POST /v1/phone-numbers/stock-watches.
+     *
+     */
+    soldOutAreas?: Array<{
+        /**
+         * Area code (national destination code).
+         */
+        ndc?: string;
+        /**
+         * Area name.
+         */
+        name?: string;
+        /**
+         * Whether this area can be pre-ordered: the carrier sources a number in it (usually 2 to 4 weeks, never guaranteed).
+         */
+        preOrderable?: boolean;
+    }>;
 });
 type CheckPhoneNumberAvailabilityError = (unknown | {
     error?: string;
@@ -27575,6 +27628,24 @@ type CheckWhatsAppNumberAvailabilityResponse = ({
          */
         count?: number;
     }>;
+    /**
+     * Areas that had stock in the last 90 days and have none now. Pass one as `areaCode` with `preOrder: true` on the KYC submit when `preOrderable` is true, or watch it with POST /v1/phone-numbers/stock-watches.
+     *
+     */
+    soldOutAreas?: Array<{
+        /**
+         * Area code (national destination code).
+         */
+        ndc?: string;
+        /**
+         * Area name.
+         */
+        name?: string;
+        /**
+         * Whether this area can be pre-ordered: the carrier sources a number in it (usually 2 to 4 weeks, never guaranteed).
+         */
+        preOrderable?: boolean;
+    }>;
 });
 type CheckWhatsAppNumberAvailabilityError = (unknown | {
     error?: string;
@@ -27686,6 +27757,10 @@ type SubmitPhoneNumberKycData = {
          * Area code (NDC) the number must be in. Hard constraint: an empty area pool fails with 409 code AREA_CODE_UNAVAILABLE instead of ordering from another area. Omit for any area. Options come from GET /v1/phone-numbers/availability (areaOptions); the purchase 202 kycUrl echoes the areaCode picked at purchase time so it can be passed here.
          */
         areaCode?: string;
+        /**
+         * With areaCode: pre-order that area when it has no stock (an area listed in soldOutAreas with preOrderable true) instead of failing with AREA_CODE_UNAVAILABLE. The carrier sources a number in that area.
+         */
+        preOrder?: boolean;
         /**
          * End user's legal first name. Required when the country has an action/ID-verification (Onfido) requirement.
          */
@@ -28450,6 +28525,10 @@ type SubmitWhatsAppNumberKycData = {
          * Area code (NDC) the number must be in. Hard constraint: an empty area pool fails with 409 code AREA_CODE_UNAVAILABLE instead of ordering from another area. Omit for any area. Options come from GET /v1/phone-numbers/availability (areaOptions); the purchase 202 kycUrl echoes the areaCode picked at purchase time so it can be passed here.
          */
         areaCode?: string;
+        /**
+         * With areaCode: pre-order that area when it has no stock (an area listed in soldOutAreas with preOrderable true) instead of failing with AREA_CODE_UNAVAILABLE. The carrier sources a number in that area.
+         */
+        preOrder?: boolean;
         /**
          * End user's legal first name. Required when the country has an action/ID-verification (Onfido) requirement.
          */
@@ -28836,6 +28915,10 @@ type CreatePhoneNumberStockWatchData = {
          * Narrow the watch to one number type. Omit to be notified when any type in the country is back.
          */
         numberType?: 'local' | 'mobile' | 'national' | 'toll_free';
+        /**
+         * Narrow the watch to one area code (NDC). Requires numberType.
+         */
+        areaCode?: string;
     };
 };
 type CreatePhoneNumberStockWatchResponse = (PhoneNumberStockWatch);

package/dist/index.d.ts

@@ -1529,11 +1529,39 @@ declare const Late: typeof Zernio;
 /**
  * Base error class for Zernio API errors
  */
+/**
+ * The canonical error envelope the API returns. Everything but `error` is
+ * optional, and every field is surfaced on ZernioApiError: dropping any of them
+ * leaves callers unable to tell apart failures the API distinguishes. For a
+ * Meta pass-through in particular, `platformError.subcode` is the only thing
+ * that separates a closed messaging window from a blocked recipient, since both
+ * arrive as code `platform_api_error`.
+ */
+interface ZernioErrorBody {
+    error?: string;
+    message?: string;
+    type?: string;
+    code?: string;
+    param?: string;
+    platform?: string;
+    platformError?: Record<string, unknown>;
+    details?: Record<string, unknown>;
+}
 declare class ZernioApiError extends Error {
     readonly statusCode: number;
     readonly code?: string;
     readonly details?: Record<string, unknown>;
-    constructor(message: string, statusCode: number, code?: string, details?: Record<string, unknown>);
+    /** Error class, e.g. invalid_request_error, platform_error, rate_limit_error. */
+    readonly type?: string;
+    /** The request field that caused the error, when the API names one. */
+    readonly param?: string;
+    /** Upstream platform, present when type is platform_error. */
+    readonly platform?: string;
+    /** The upstream platform's own payload, verbatim (Meta: code, subcode, fbtrace_id). */
+    readonly platformError?: Record<string, unknown>;
+    /** The parsed response body exactly as the API sent it, for anything not modelled above. */
+    readonly body?: ZernioErrorBody;
+    constructor(message: string, statusCode: number, code?: string, details?: Record<string, unknown>, body?: ZernioErrorBody);
     /**
      * Check if this is a rate limit error
      */
@@ -1568,7 +1596,7 @@ declare class RateLimitError extends ZernioApiError {
     readonly limit?: number;
     readonly remaining?: number;
     readonly resetAt?: Date;
-    constructor(message: string, limit?: number, remaining?: number, resetAt?: Date);
+    constructor(message: string, limit?: number, remaining?: number, resetAt?: Date, body?: ZernioErrorBody);
     /**
      * Get seconds until rate limit resets
      */
@@ -1579,17 +1607,12 @@ declare class RateLimitError extends ZernioApiError {
  */
 declare class ValidationError extends ZernioApiError {
     readonly fields?: Record<string, string[]>;
-    constructor(message: string, fields?: Record<string, string[]>);
+    constructor(message: string, fields?: Record<string, string[]>, body?: ZernioErrorBody);
 }
 /**
  * Parse an error response from the API
  */
-declare function parseApiError(response: Response, body?: {
-    error?: string;
-    message?: string;
-    code?: string;
-    details?: Record<string, unknown>;
-}): ZernioApiError;
+declare function parseApiError(response: Response, body?: ZernioErrorBody): ZernioApiError;
 
 type AccountsListResponse = {
     accounts: Array<SocialAccount>;
@@ -7421,6 +7444,10 @@ type PhoneNumberStockWatch = {
      * The watched number type, or null when the watch covers every type in the country.
      */
     numberType: ('local' | 'mobile' | 'national' | 'toll_free') | null;
+    /**
+     * The watched area code (NDC), or null when the watch covers every area.
+     */
+    areaCode?: (string) | null;
     createdAt: string;
 };
 /**
@@ -11258,6 +11285,14 @@ type WebhookPayloadPhoneNumberStockAvailable = {
              */
             availableCount: number;
         }>;
+        /**
+         * Set when the watch named an area: the area code (NDC) that is back in stock.
+         */
+        areaCode?: string;
+        /**
+         * The name of that area, when known.
+         */
+        areaName?: string;
     };
     /**
      * UTC time at which Zernio generated this event (set once when the event payload is built, before delivery is queued). Retries and redeliveries keep the original value, so it reflects the event, not the delivery attempt.
@@ -24695,7 +24730,7 @@ type ReplyToInboxReviewResponse = ({
     };
     platform?: string;
 });
-type ReplyToInboxReviewError = ({
+type ReplyToInboxReviewError = (ErrorResponse | {
     error?: string;
 } | unknown);
 type DeleteInboxReviewReplyData = {
@@ -27300,6 +27335,24 @@ type CheckPhoneNumberAvailabilityResponse = ({
          */
         count?: number;
     }>;
+    /**
+     * Areas that had stock in the last 90 days and have none now. Pass one as `areaCode` with `preOrder: true` on the KYC submit when `preOrderable` is true, or watch it with POST /v1/phone-numbers/stock-watches.
+     *
+     */
+    soldOutAreas?: Array<{
+        /**
+         * Area code (national destination code).
+         */
+        ndc?: string;
+        /**
+         * Area name.
+         */
+        name?: string;
+        /**
+         * Whether this area can be pre-ordered: the carrier sources a number in it (usually 2 to 4 weeks, never guaranteed).
+         */
+        preOrderable?: boolean;
+    }>;
 });
 type CheckPhoneNumberAvailabilityError = (unknown | {
     error?: string;
@@ -27575,6 +27628,24 @@ type CheckWhatsAppNumberAvailabilityResponse = ({
          */
         count?: number;
     }>;
+    /**
+     * Areas that had stock in the last 90 days and have none now. Pass one as `areaCode` with `preOrder: true` on the KYC submit when `preOrderable` is true, or watch it with POST /v1/phone-numbers/stock-watches.
+     *
+     */
+    soldOutAreas?: Array<{
+        /**
+         * Area code (national destination code).
+         */
+        ndc?: string;
+        /**
+         * Area name.
+         */
+        name?: string;
+        /**
+         * Whether this area can be pre-ordered: the carrier sources a number in it (usually 2 to 4 weeks, never guaranteed).
+         */
+        preOrderable?: boolean;
+    }>;
 });
 type CheckWhatsAppNumberAvailabilityError = (unknown | {
     error?: string;
@@ -27686,6 +27757,10 @@ type SubmitPhoneNumberKycData = {
          * Area code (NDC) the number must be in. Hard constraint: an empty area pool fails with 409 code AREA_CODE_UNAVAILABLE instead of ordering from another area. Omit for any area. Options come from GET /v1/phone-numbers/availability (areaOptions); the purchase 202 kycUrl echoes the areaCode picked at purchase time so it can be passed here.
          */
         areaCode?: string;
+        /**
+         * With areaCode: pre-order that area when it has no stock (an area listed in soldOutAreas with preOrderable true) instead of failing with AREA_CODE_UNAVAILABLE. The carrier sources a number in that area.
+         */
+        preOrder?: boolean;
         /**
          * End user's legal first name. Required when the country has an action/ID-verification (Onfido) requirement.
          */
@@ -28450,6 +28525,10 @@ type SubmitWhatsAppNumberKycData = {
          * Area code (NDC) the number must be in. Hard constraint: an empty area pool fails with 409 code AREA_CODE_UNAVAILABLE instead of ordering from another area. Omit for any area. Options come from GET /v1/phone-numbers/availability (areaOptions); the purchase 202 kycUrl echoes the areaCode picked at purchase time so it can be passed here.
          */
         areaCode?: string;
+        /**
+         * With areaCode: pre-order that area when it has no stock (an area listed in soldOutAreas with preOrderable true) instead of failing with AREA_CODE_UNAVAILABLE. The carrier sources a number in that area.
+         */
+        preOrder?: boolean;
         /**
          * End user's legal first name. Required when the country has an action/ID-verification (Onfido) requirement.
          */
@@ -28836,6 +28915,10 @@ type CreatePhoneNumberStockWatchData = {
          * Narrow the watch to one number type. Omit to be notified when any type in the country is back.
          */
         numberType?: 'local' | 'mobile' | 'national' | 'toll_free';
+        /**
+         * Narrow the watch to one area code (NDC). Requires numberType.
+         */
+        areaCode?: string;
     };
 };
 type CreatePhoneNumberStockWatchResponse = (PhoneNumberStockWatch);

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@zernio/node",
-  version: "0.2.784",
+  version: "0.2.786",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",
@@ -4756,12 +4756,17 @@ var downloadTikTokVideo = (options) => {
 
 // src/errors.ts
 var ZernioApiError = class _ZernioApiError extends Error {
-  constructor(message, statusCode, code, details) {
+  constructor(message, statusCode, code, details, body) {
     super(message);
     this.name = "ZernioApiError";
     this.statusCode = statusCode;
     this.code = code;
     this.details = details;
+    this.type = body?.type;
+    this.param = body?.param;
+    this.platform = body?.platform;
+    this.platformError = body?.platformError;
+    this.body = body;
     if (Error.captureStackTrace) {
       Error.captureStackTrace(this, _ZernioApiError);
     }
@@ -4805,8 +4810,8 @@ var ZernioApiError = class _ZernioApiError extends Error {
 };
 var LateApiError = ZernioApiError;
 var RateLimitError = class extends ZernioApiError {
-  constructor(message, limit, remaining, resetAt) {
-    super(message, 429, "rate_limit_exceeded");
+  constructor(message, limit, remaining, resetAt, body) {
+    super(message, 429, body?.code ?? "rate_limit_exceeded", body?.details, body);
     this.name = "RateLimitError";
     this.limit = limit;
     this.remaining = remaining;
@@ -4821,8 +4826,8 @@ var RateLimitError = class extends ZernioApiError {
   }
 };
 var ValidationError = class extends ZernioApiError {
-  constructor(message, fields) {
-    super(message, 400, "validation_error", { fields });
+  constructor(message, fields, body) {
+    super(message, 400, body?.code ?? "validation_error", body?.details ?? { fields }, body);
     this.name = "ValidationError";
     this.fields = fields;
   }
@@ -4839,13 +4844,14 @@ function parseApiError(response, body) {
       message,
       limit ? parseInt(limit, 10) : void 0,
       remaining ? parseInt(remaining, 10) : void 0,
-      reset ? new Date(parseInt(reset, 10) * 1e3) : void 0
+      reset ? new Date(parseInt(reset, 10) * 1e3) : void 0,
+      body
     );
   }
   if (response.status === 400 && details?.fields) {
-    return new ValidationError(message, details.fields);
+    return new ValidationError(message, details.fields, body);
   }
-  return new ZernioApiError(message, response.status, code, details);
+  return new ZernioApiError(message, response.status, code, details, body);
 }
 
 // src/client.ts

package/dist/index.mjs

@@ -5,7 +5,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 // package.json
 var package_default = {
   name: "@zernio/node",
-  version: "0.2.784",
+  version: "0.2.786",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",
@@ -4725,12 +4725,17 @@ var downloadTikTokVideo = (options) => {
 
 // src/errors.ts
 var ZernioApiError = class _ZernioApiError extends Error {
-  constructor(message, statusCode, code, details) {
+  constructor(message, statusCode, code, details, body) {
     super(message);
     this.name = "ZernioApiError";
     this.statusCode = statusCode;
     this.code = code;
     this.details = details;
+    this.type = body?.type;
+    this.param = body?.param;
+    this.platform = body?.platform;
+    this.platformError = body?.platformError;
+    this.body = body;
     if (Error.captureStackTrace) {
       Error.captureStackTrace(this, _ZernioApiError);
     }
@@ -4774,8 +4779,8 @@ var ZernioApiError = class _ZernioApiError extends Error {
 };
 var LateApiError = ZernioApiError;
 var RateLimitError = class extends ZernioApiError {
-  constructor(message, limit, remaining, resetAt) {
-    super(message, 429, "rate_limit_exceeded");
+  constructor(message, limit, remaining, resetAt, body) {
+    super(message, 429, body?.code ?? "rate_limit_exceeded", body?.details, body);
     this.name = "RateLimitError";
     this.limit = limit;
     this.remaining = remaining;
@@ -4790,8 +4795,8 @@ var RateLimitError = class extends ZernioApiError {
   }
 };
 var ValidationError = class extends ZernioApiError {
-  constructor(message, fields) {
-    super(message, 400, "validation_error", { fields });
+  constructor(message, fields, body) {
+    super(message, 400, body?.code ?? "validation_error", body?.details ?? { fields }, body);
     this.name = "ValidationError";
     this.fields = fields;
   }
@@ -4808,13 +4813,14 @@ function parseApiError(response, body) {
       message,
       limit ? parseInt(limit, 10) : void 0,
       remaining ? parseInt(remaining, 10) : void 0,
-      reset ? new Date(parseInt(reset, 10) * 1e3) : void 0
+      reset ? new Date(parseInt(reset, 10) * 1e3) : void 0,
+      body
     );
   }
   if (response.status === 400 && details?.fields) {
-    return new ValidationError(message, details.fields);
+    return new ValidationError(message, details.fields, body);
   }
-  return new ZernioApiError(message, response.status, code, details);
+  return new ZernioApiError(message, response.status, code, details, body);
 }
 
 // src/client.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zernio/node",
-  "version": "0.2.784",
+  "version": "0.2.786",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/errors.ts

@@ -1,22 +1,57 @@
 /**
  * Base error class for Zernio API errors
  */
+/**
+ * The canonical error envelope the API returns. Everything but `error` is
+ * optional, and every field is surfaced on ZernioApiError: dropping any of them
+ * leaves callers unable to tell apart failures the API distinguishes. For a
+ * Meta pass-through in particular, `platformError.subcode` is the only thing
+ * that separates a closed messaging window from a blocked recipient, since both
+ * arrive as code `platform_api_error`.
+ */
+export interface ZernioErrorBody {
+  error?: string;
+  message?: string;
+  type?: string;
+  code?: string;
+  param?: string;
+  platform?: string;
+  platformError?: Record<string, unknown>;
+  details?: Record<string, unknown>;
+}
+
 export class ZernioApiError extends Error {
   public readonly statusCode: number;
   public readonly code?: string;
   public readonly details?: Record<string, unknown>;
+  /** Error class, e.g. invalid_request_error, platform_error, rate_limit_error. */
+  public readonly type?: string;
+  /** The request field that caused the error, when the API names one. */
+  public readonly param?: string;
+  /** Upstream platform, present when type is platform_error. */
+  public readonly platform?: string;
+  /** The upstream platform's own payload, verbatim (Meta: code, subcode, fbtrace_id). */
+  public readonly platformError?: Record<string, unknown>;
+  /** The parsed response body exactly as the API sent it, for anything not modelled above. */
+  public readonly body?: ZernioErrorBody;
 
   constructor(
     message: string,
     statusCode: number,
     code?: string,
-    details?: Record<string, unknown>
+    details?: Record<string, unknown>,
+    body?: ZernioErrorBody
   ) {
     super(message);
     this.name = 'ZernioApiError';
     this.statusCode = statusCode;
     this.code = code;
     this.details = details;
+    this.type = body?.type;
+    this.param = body?.param;
+    this.platform = body?.platform;
+    this.platformError = body?.platformError;
+    this.body = body;
 
     // Maintains proper stack trace for where error was thrown
     if (Error.captureStackTrace) {
@@ -82,9 +117,12 @@ export class RateLimitError extends ZernioApiError {
     message: string,
     limit?: number,
     remaining?: number,
-    resetAt?: Date
+    resetAt?: Date,
+    body?: ZernioErrorBody
   ) {
-    super(message, 429, 'rate_limit_exceeded');
+    // The envelope's own code wins when the API sent one: a Google Ads quota
+    // 429 and a Zernio rate limit are different failures.
+    super(message, 429, body?.code ?? 'rate_limit_exceeded', body?.details, body);
     this.name = 'RateLimitError';
     this.limit = limit;
     this.remaining = remaining;
@@ -106,8 +144,8 @@ export class RateLimitError extends ZernioApiError {
 export class ValidationError extends ZernioApiError {
   public readonly fields?: Record<string, string[]>;
 
-  constructor(message: string, fields?: Record<string, string[]>) {
-    super(message, 400, 'validation_error', { fields });
+  constructor(message: string, fields?: Record<string, string[]>, body?: ZernioErrorBody) {
+    super(message, 400, body?.code ?? 'validation_error', body?.details ?? { fields }, body);
     this.name = 'ValidationError';
     this.fields = fields;
   }
@@ -118,7 +156,7 @@ export class ValidationError extends ZernioApiError {
  */
 export function parseApiError(
   response: Response,
-  body?: { error?: string; message?: string; code?: string; details?: Record<string, unknown> }
+  body?: ZernioErrorBody
 ): ZernioApiError {
   const message = body?.error || body?.message || response.statusText || 'Unknown error';
   const code = body?.code;
@@ -134,14 +172,15 @@ export function parseApiError(
       message,
       limit ? parseInt(limit, 10) : undefined,
       remaining ? parseInt(remaining, 10) : undefined,
-      reset ? new Date(parseInt(reset, 10) * 1000) : undefined
+      reset ? new Date(parseInt(reset, 10) * 1000) : undefined,
+      body
     );
   }
 
   // Handle validation errors
   if (response.status === 400 && details?.fields) {
-    return new ValidationError(message, details.fields as Record<string, string[]>);
+    return new ValidationError(message, details.fields as Record<string, string[]>, body);
   }
 
-  return new ZernioApiError(message, response.status, code, details);
+  return new ZernioApiError(message, response.status, code, details, body);
 }

package/src/generated/sdk.gen.ts

@@ -6642,6 +6642,11 @@ export const disableVoiceOnNumber = <ThrowOnError extends boolean = false>(optio
  * `preOrderable: true` does not need a watch: submit KYC and the carrier
  * sources the number to order.
  *
+ * Pass `areaCode` (with `numberType`) to watch one sold-out area, for
+ * example an entry of `soldOutAreas` from
+ * GET /v1/phone-numbers/availability. Area stock is checked live on the
+ * same 6h cadence.
+ *
  */
 export const createPhoneNumberStockWatch = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CreatePhoneNumberStockWatchData, ThrowOnError>) => {
     return (options?.client ?? client).post<CreatePhoneNumberStockWatchResponse, CreatePhoneNumberStockWatchError, ThrowOnError>({

package/src/generated/types.gen.ts

@@ -6059,6 +6059,10 @@ export type PhoneNumberStockWatch = {
      * The watched number type, or null when the watch covers every type in the country.
      */
     numberType: ('local' | 'mobile' | 'national' | 'toll_free') | null;
+    /**
+     * The watched area code (NDC), or null when the watch covers every area.
+     */
+    areaCode?: (string) | null;
     createdAt: string;
 };
 
@@ -10042,6 +10046,14 @@ export type WebhookPayloadPhoneNumberStockAvailable = {
              */
             availableCount: number;
         }>;
+        /**
+         * Set when the watch named an area: the area code (NDC) that is back in stock.
+         */
+        areaCode?: string;
+        /**
+         * The name of that area, when known.
+         */
+        areaName?: string;
     };
     /**
      * UTC time at which Zernio generated this event (set once when the event payload is built, before delivery is queued). Retries and redeliveries keep the original value, so it reflects the event, not the delivery attempt.
@@ -24353,7 +24365,7 @@ export type ReplyToInboxReviewResponse = ({
     platform?: string;
 });
 
-export type ReplyToInboxReviewError = ({
+export type ReplyToInboxReviewError = (ErrorResponse | {
     error?: string;
 } | unknown);
 
@@ -27179,6 +27191,24 @@ export type CheckPhoneNumberAvailabilityResponse = ({
          */
         count?: number;
     }>;
+    /**
+     * Areas that had stock in the last 90 days and have none now. Pass one as `areaCode` with `preOrder: true` on the KYC submit when `preOrderable` is true, or watch it with POST /v1/phone-numbers/stock-watches.
+     *
+     */
+    soldOutAreas?: Array<{
+        /**
+         * Area code (national destination code).
+         */
+        ndc?: string;
+        /**
+         * Area name.
+         */
+        name?: string;
+        /**
+         * Whether this area can be pre-ordered: the carrier sources a number in it (usually 2 to 4 weeks, never guaranteed).
+         */
+        preOrderable?: boolean;
+    }>;
 });
 
 export type CheckPhoneNumberAvailabilityError = (unknown | {
@@ -27468,6 +27498,24 @@ export type CheckWhatsAppNumberAvailabilityResponse = ({
          */
         count?: number;
     }>;
+    /**
+     * Areas that had stock in the last 90 days and have none now. Pass one as `areaCode` with `preOrder: true` on the KYC submit when `preOrderable` is true, or watch it with POST /v1/phone-numbers/stock-watches.
+     *
+     */
+    soldOutAreas?: Array<{
+        /**
+         * Area code (national destination code).
+         */
+        ndc?: string;
+        /**
+         * Area name.
+         */
+        name?: string;
+        /**
+         * Whether this area can be pre-ordered: the carrier sources a number in it (usually 2 to 4 weeks, never guaranteed).
+         */
+        preOrderable?: boolean;
+    }>;
 });
 
 export type CheckWhatsAppNumberAvailabilityError = (unknown | {
@@ -27584,6 +27632,10 @@ export type SubmitPhoneNumberKycData = {
          * Area code (NDC) the number must be in. Hard constraint: an empty area pool fails with 409 code AREA_CODE_UNAVAILABLE instead of ordering from another area. Omit for any area. Options come from GET /v1/phone-numbers/availability (areaOptions); the purchase 202 kycUrl echoes the areaCode picked at purchase time so it can be passed here.
          */
         areaCode?: string;
+        /**
+         * With areaCode: pre-order that area when it has no stock (an area listed in soldOutAreas with preOrderable true) instead of failing with AREA_CODE_UNAVAILABLE. The carrier sources a number in that area.
+         */
+        preOrder?: boolean;
         /**
          * End user's legal first name. Required when the country has an action/ID-verification (Onfido) requirement.
          */
@@ -28401,6 +28453,10 @@ export type SubmitWhatsAppNumberKycData = {
          * Area code (NDC) the number must be in. Hard constraint: an empty area pool fails with 409 code AREA_CODE_UNAVAILABLE instead of ordering from another area. Omit for any area. Options come from GET /v1/phone-numbers/availability (areaOptions); the purchase 202 kycUrl echoes the areaCode picked at purchase time so it can be passed here.
          */
         areaCode?: string;
+        /**
+         * With areaCode: pre-order that area when it has no stock (an area listed in soldOutAreas with preOrderable true) instead of failing with AREA_CODE_UNAVAILABLE. The carrier sources a number in that area.
+         */
+        preOrder?: boolean;
         /**
          * End user's legal first name. Required when the country has an action/ID-verification (Onfido) requirement.
          */
@@ -28814,6 +28870,10 @@ export type CreatePhoneNumberStockWatchData = {
          * Narrow the watch to one number type. Omit to be notified when any type in the country is back.
          */
         numberType?: 'local' | 'mobile' | 'national' | 'toll_free';
+        /**
+         * Narrow the watch to one area code (NDC). Requires numberType.
+         */
+        areaCode?: string;
     };
 };