@zernio/node 0.2.1002 → 0.2.1004

package/dist/index.d.mts

@@ -12472,7 +12472,7 @@ type ValueRuleSet = {
 type Verification = {
     id?: string;
     status?: 'pending' | 'approved' | 'expired' | 'max_attempts_reached' | 'canceled' | 'delivery_failed';
-    channel?: 'sms';
+    channel?: 'sms' | 'whatsapp';
     to?: string;
     expiresAt?: string;
     attempts?: number;
@@ -12489,7 +12489,7 @@ type Verification = {
     resend?: boolean;
 };
 type status29 = 'pending' | 'approved' | 'expired' | 'max_attempts_reached' | 'canceled' | 'delivery_failed';
-type channel4 = 'sms';
+type channel4 = 'sms' | 'whatsapp';
 /**
  * Individual webhook configuration for receiving real-time notifications
  */
@@ -32989,7 +32989,7 @@ type SubmitPhoneNumberKycData = {
          */
         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. Not needed without areaCode: a whole pair with no stock, or an address in a geographic-match country whose area has no stock, is pre-ordered on its own (see preOrder in the response).
+         * 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. Without areaCode it accepts the pre-order a previous submit offered with 409 code area_pre_order_available (a geographic-match country whose address area has no stock): resend the same body with preOrder true and the order is placed for that area. A whole pair with no stock is pre-ordered without either flag.
          */
         preOrder?: boolean;
         /**
@@ -33044,7 +33044,7 @@ type SubmitPhoneNumberKycData = {
 type SubmitPhoneNumberKycResponse = ({
     status?: 'kyc_submitted' | 'kyc_reused' | 'kyc_already_submitted';
     /**
-     * True when this submission placed a pre-order instead of an order from stock: the country and type had nothing deliverable, the picked areaCode was sold out (preOrder: true sent), or the country requires the number's area to cover the registered address and that area has no stock (the carrier is then asked for a number in exactly that area). The number stays `pending_regulatory` until we get it, from regular stock the moment it returns or sourced by the carrier (usually 2 to 4 weeks, never guaranteed), and is not billed until active. Releasing it (DELETE /v1/phone-numbers/{id}) cancels the pre-order. A pre-order is one number: `quantity` above 1 is rejected with 400.
+     * True when this submission placed a pre-order instead of an order from stock: the country and type had nothing deliverable, the picked areaCode was sold out (preOrder: true sent), or the country requires the number's area to cover the registered address, that area has no stock, and the caller accepted the offer (preOrder true after a 409 area_pre_order_available; the carrier is then asked for a number in exactly that area). The number stays `pending_regulatory` until we get it, from regular stock the moment it returns or sourced by the carrier (usually 2 to 4 weeks, never guaranteed), and is not billed until active. Releasing it (DELETE /v1/phone-numbers/{id}) cancels the pre-order. A pre-order is one number: `quantity` above 1 is rejected with 400.
      */
     preOrder?: boolean;
     /**
@@ -33811,7 +33811,7 @@ type SubmitWhatsAppNumberKycData = {
          */
         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. Not needed without areaCode: a whole pair with no stock, or an address in a geographic-match country whose area has no stock, is pre-ordered on its own (see preOrder in the response).
+         * 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. Without areaCode it accepts the pre-order a previous submit offered with 409 code area_pre_order_available (a geographic-match country whose address area has no stock): resend the same body with preOrder true and the order is placed for that area. A whole pair with no stock is pre-ordered without either flag.
          */
         preOrder?: boolean;
         /**
@@ -33862,7 +33862,7 @@ type SubmitWhatsAppNumberKycData = {
 type SubmitWhatsAppNumberKycResponse = ({
     status?: 'kyc_submitted' | 'kyc_reused' | 'kyc_already_submitted';
     /**
-     * True when this submission placed a pre-order instead of an order from stock: the country and type had nothing deliverable, the picked areaCode was sold out (preOrder: true sent), or the country requires the number's area to cover the registered address and that area has no stock (the carrier is then asked for a number in exactly that area). The number stays `pending_regulatory` until we get it, from regular stock the moment it returns or sourced by the carrier (usually 2 to 4 weeks, never guaranteed), and is not billed until active. Releasing it (DELETE /v1/phone-numbers/{id}) cancels the pre-order. A pre-order is one number: `quantity` above 1 is rejected with 400.
+     * True when this submission placed a pre-order instead of an order from stock: the country and type had nothing deliverable, the picked areaCode was sold out (preOrder: true sent), or the country requires the number's area to cover the registered address, that area has no stock, and the caller accepted the offer (preOrder true after a 409 area_pre_order_available; the carrier is then asked for a number in exactly that area). The number stays `pending_regulatory` until we get it, from regular stock the moment it returns or sourced by the carrier (usually 2 to 4 weeks, never guaranteed), and is not billed until active. Releasing it (DELETE /v1/phone-numbers/{id}) cancels the pre-order. A pre-order is one number: `quantity` above 1 is rejected with 400.
      */
     preOrder?: boolean;
     /**
@@ -51741,20 +51741,17 @@ type RunCommerceCatalogSyncError = (ErrorResponse | {
 } | unknown);
 type CreateVerificationData = {
     body: {
+        channel: 'sms' | 'whatsapp';
         /**
-         * SMS-only for now.
-         */
-        channel: 'sms';
-        /**
-         * E.164 phone number.
+         * E.164 phone number. WhatsApp only delivers to a phone number, never to a username.
          */
         to: string;
         /**
-         * The SMS-enabled number on your account to send from. Defaults to your only SMS number.
+         * The number on your account to send from: an SMS-enabled number for `sms`, a connected WhatsApp number for `whatsapp`. Defaults to your only number on that channel.
          */
         from?: string;
         /**
-         * Your app or business name, rendered in the message. Defaults to your account name. Letters, numbers, and basic punctuation only.
+         * Your app or business name, rendered in the SMS message. Defaults to your account name. Not shown on WhatsApp, where Meta fixes the message and shows your WhatsApp display name. Letters, numbers, and basic punctuation only.
          */
         brandName?: string;
         codeLength?: number;

package/dist/index.d.ts

@@ -12472,7 +12472,7 @@ type ValueRuleSet = {
 type Verification = {
     id?: string;
     status?: 'pending' | 'approved' | 'expired' | 'max_attempts_reached' | 'canceled' | 'delivery_failed';
-    channel?: 'sms';
+    channel?: 'sms' | 'whatsapp';
     to?: string;
     expiresAt?: string;
     attempts?: number;
@@ -12489,7 +12489,7 @@ type Verification = {
     resend?: boolean;
 };
 type status29 = 'pending' | 'approved' | 'expired' | 'max_attempts_reached' | 'canceled' | 'delivery_failed';
-type channel4 = 'sms';
+type channel4 = 'sms' | 'whatsapp';
 /**
  * Individual webhook configuration for receiving real-time notifications
  */
@@ -32989,7 +32989,7 @@ type SubmitPhoneNumberKycData = {
          */
         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. Not needed without areaCode: a whole pair with no stock, or an address in a geographic-match country whose area has no stock, is pre-ordered on its own (see preOrder in the response).
+         * 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. Without areaCode it accepts the pre-order a previous submit offered with 409 code area_pre_order_available (a geographic-match country whose address area has no stock): resend the same body with preOrder true and the order is placed for that area. A whole pair with no stock is pre-ordered without either flag.
          */
         preOrder?: boolean;
         /**
@@ -33044,7 +33044,7 @@ type SubmitPhoneNumberKycData = {
 type SubmitPhoneNumberKycResponse = ({
     status?: 'kyc_submitted' | 'kyc_reused' | 'kyc_already_submitted';
     /**
-     * True when this submission placed a pre-order instead of an order from stock: the country and type had nothing deliverable, the picked areaCode was sold out (preOrder: true sent), or the country requires the number's area to cover the registered address and that area has no stock (the carrier is then asked for a number in exactly that area). The number stays `pending_regulatory` until we get it, from regular stock the moment it returns or sourced by the carrier (usually 2 to 4 weeks, never guaranteed), and is not billed until active. Releasing it (DELETE /v1/phone-numbers/{id}) cancels the pre-order. A pre-order is one number: `quantity` above 1 is rejected with 400.
+     * True when this submission placed a pre-order instead of an order from stock: the country and type had nothing deliverable, the picked areaCode was sold out (preOrder: true sent), or the country requires the number's area to cover the registered address, that area has no stock, and the caller accepted the offer (preOrder true after a 409 area_pre_order_available; the carrier is then asked for a number in exactly that area). The number stays `pending_regulatory` until we get it, from regular stock the moment it returns or sourced by the carrier (usually 2 to 4 weeks, never guaranteed), and is not billed until active. Releasing it (DELETE /v1/phone-numbers/{id}) cancels the pre-order. A pre-order is one number: `quantity` above 1 is rejected with 400.
      */
     preOrder?: boolean;
     /**
@@ -33811,7 +33811,7 @@ type SubmitWhatsAppNumberKycData = {
          */
         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. Not needed without areaCode: a whole pair with no stock, or an address in a geographic-match country whose area has no stock, is pre-ordered on its own (see preOrder in the response).
+         * 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. Without areaCode it accepts the pre-order a previous submit offered with 409 code area_pre_order_available (a geographic-match country whose address area has no stock): resend the same body with preOrder true and the order is placed for that area. A whole pair with no stock is pre-ordered without either flag.
          */
         preOrder?: boolean;
         /**
@@ -33862,7 +33862,7 @@ type SubmitWhatsAppNumberKycData = {
 type SubmitWhatsAppNumberKycResponse = ({
     status?: 'kyc_submitted' | 'kyc_reused' | 'kyc_already_submitted';
     /**
-     * True when this submission placed a pre-order instead of an order from stock: the country and type had nothing deliverable, the picked areaCode was sold out (preOrder: true sent), or the country requires the number's area to cover the registered address and that area has no stock (the carrier is then asked for a number in exactly that area). The number stays `pending_regulatory` until we get it, from regular stock the moment it returns or sourced by the carrier (usually 2 to 4 weeks, never guaranteed), and is not billed until active. Releasing it (DELETE /v1/phone-numbers/{id}) cancels the pre-order. A pre-order is one number: `quantity` above 1 is rejected with 400.
+     * True when this submission placed a pre-order instead of an order from stock: the country and type had nothing deliverable, the picked areaCode was sold out (preOrder: true sent), or the country requires the number's area to cover the registered address, that area has no stock, and the caller accepted the offer (preOrder true after a 409 area_pre_order_available; the carrier is then asked for a number in exactly that area). The number stays `pending_regulatory` until we get it, from regular stock the moment it returns or sourced by the carrier (usually 2 to 4 weeks, never guaranteed), and is not billed until active. Releasing it (DELETE /v1/phone-numbers/{id}) cancels the pre-order. A pre-order is one number: `quantity` above 1 is rejected with 400.
      */
     preOrder?: boolean;
     /**
@@ -51741,20 +51741,17 @@ type RunCommerceCatalogSyncError = (ErrorResponse | {
 } | unknown);
 type CreateVerificationData = {
     body: {
+        channel: 'sms' | 'whatsapp';
         /**
-         * SMS-only for now.
-         */
-        channel: 'sms';
-        /**
-         * E.164 phone number.
+         * E.164 phone number. WhatsApp only delivers to a phone number, never to a username.
          */
         to: string;
         /**
-         * The SMS-enabled number on your account to send from. Defaults to your only SMS number.
+         * The number on your account to send from: an SMS-enabled number for `sms`, a connected WhatsApp number for `whatsapp`. Defaults to your only number on that channel.
          */
         from?: string;
         /**
-         * Your app or business name, rendered in the message. Defaults to your account name. Letters, numbers, and basic punctuation only.
+         * Your app or business name, rendered in the SMS message. Defaults to your account name. Not shown on WhatsApp, where Meta fixes the message and shows your WhatsApp display name. Letters, numbers, and basic punctuation only.
          */
         brandName?: string;
         codeLength?: number;

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@zernio/node",
-  version: "0.2.1002",
+  version: "0.2.1004",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

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.1002",
+  version: "0.2.1004",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/package.json

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

package/src/generated/sdk.gen.ts

@@ -15638,10 +15638,22 @@ export const runCommerceCatalogSync = <ThrowOnError extends boolean = false>(opt
  * one per 60 seconds (429 with `retryAfterSeconds` inside the cooldown).
  * The stored brandName/codeLength/ttlMinutes win on a resend.
  *
- * Codes deliver by SMS from a phone number on your account (`from`
- * optional when you own exactly one SMS-enabled number) and the message
- * uses a fixed template. Each accepted send bills one verification fee
- * plus the standard message rate.
+ * Codes deliver from a number on your account (`from` optional when
+ * you own exactly one number on the channel), always with a fixed
+ * template:
+ *
+ * - `sms`: from an SMS-enabled number. Each accepted send bills one
+ * verification fee plus the standard message rate.
+ * - `whatsapp`: from a connected WhatsApp number, as a Meta
+ * AUTHENTICATION template with a copy-code button. The first
+ * WhatsApp verification on a WhatsApp Business Account creates the
+ * `zernio_verify_code` template there and answers 422
+ * `template_pending` until Meta approves it (usually minutes; retry
+ * after `retryAfterSeconds`). Meta fixes the message text, so
+ * `brandName` is not shown and the code's validity is not stated in
+ * the message (`ttlMinutes` is still enforced). Each accepted send
+ * bills one verification fee; Meta bills its authentication rate to
+ * your WhatsApp Business Account.
  *
  */
 export const createVerification = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CreateVerificationData, ThrowOnError>) => {

package/src/generated/types.gen.ts

@@ -10993,7 +10993,7 @@ export type ValueRuleSet = {
 export type Verification = {
     id?: string;
     status?: 'pending' | 'approved' | 'expired' | 'max_attempts_reached' | 'canceled' | 'delivery_failed';
-    channel?: 'sms';
+    channel?: 'sms' | 'whatsapp';
     to?: string;
     expiresAt?: string;
     attempts?: number;
@@ -11012,7 +11012,7 @@ export type Verification = {
 
 export type status29 = 'pending' | 'approved' | 'expired' | 'max_attempts_reached' | 'canceled' | 'delivery_failed';
 
-export type channel4 = 'sms';
+export type channel4 = 'sms' | 'whatsapp';
 
 /**
  * Individual webhook configuration for receiving real-time notifications
@@ -32881,7 +32881,7 @@ export type SubmitPhoneNumberKycData = {
          */
         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. Not needed without areaCode: a whole pair with no stock, or an address in a geographic-match country whose area has no stock, is pre-ordered on its own (see preOrder in the response).
+         * 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. Without areaCode it accepts the pre-order a previous submit offered with 409 code area_pre_order_available (a geographic-match country whose address area has no stock): resend the same body with preOrder true and the order is placed for that area. A whole pair with no stock is pre-ordered without either flag.
          */
         preOrder?: boolean;
         /**
@@ -32937,7 +32937,7 @@ export type SubmitPhoneNumberKycData = {
 export type SubmitPhoneNumberKycResponse = ({
     status?: 'kyc_submitted' | 'kyc_reused' | 'kyc_already_submitted';
     /**
-     * True when this submission placed a pre-order instead of an order from stock: the country and type had nothing deliverable, the picked areaCode was sold out (preOrder: true sent), or the country requires the number's area to cover the registered address and that area has no stock (the carrier is then asked for a number in exactly that area). The number stays `pending_regulatory` until we get it, from regular stock the moment it returns or sourced by the carrier (usually 2 to 4 weeks, never guaranteed), and is not billed until active. Releasing it (DELETE /v1/phone-numbers/{id}) cancels the pre-order. A pre-order is one number: `quantity` above 1 is rejected with 400.
+     * True when this submission placed a pre-order instead of an order from stock: the country and type had nothing deliverable, the picked areaCode was sold out (preOrder: true sent), or the country requires the number's area to cover the registered address, that area has no stock, and the caller accepted the offer (preOrder true after a 409 area_pre_order_available; the carrier is then asked for a number in exactly that area). The number stays `pending_regulatory` until we get it, from regular stock the moment it returns or sourced by the carrier (usually 2 to 4 weeks, never guaranteed), and is not billed until active. Releasing it (DELETE /v1/phone-numbers/{id}) cancels the pre-order. A pre-order is one number: `quantity` above 1 is rejected with 400.
      */
     preOrder?: boolean;
     /**
@@ -33759,7 +33759,7 @@ export type SubmitWhatsAppNumberKycData = {
          */
         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. Not needed without areaCode: a whole pair with no stock, or an address in a geographic-match country whose area has no stock, is pre-ordered on its own (see preOrder in the response).
+         * 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. Without areaCode it accepts the pre-order a previous submit offered with 409 code area_pre_order_available (a geographic-match country whose address area has no stock): resend the same body with preOrder true and the order is placed for that area. A whole pair with no stock is pre-ordered without either flag.
          */
         preOrder?: boolean;
         /**
@@ -33811,7 +33811,7 @@ export type SubmitWhatsAppNumberKycData = {
 export type SubmitWhatsAppNumberKycResponse = ({
     status?: 'kyc_submitted' | 'kyc_reused' | 'kyc_already_submitted';
     /**
-     * True when this submission placed a pre-order instead of an order from stock: the country and type had nothing deliverable, the picked areaCode was sold out (preOrder: true sent), or the country requires the number's area to cover the registered address and that area has no stock (the carrier is then asked for a number in exactly that area). The number stays `pending_regulatory` until we get it, from regular stock the moment it returns or sourced by the carrier (usually 2 to 4 weeks, never guaranteed), and is not billed until active. Releasing it (DELETE /v1/phone-numbers/{id}) cancels the pre-order. A pre-order is one number: `quantity` above 1 is rejected with 400.
+     * True when this submission placed a pre-order instead of an order from stock: the country and type had nothing deliverable, the picked areaCode was sold out (preOrder: true sent), or the country requires the number's area to cover the registered address, that area has no stock, and the caller accepted the offer (preOrder true after a 409 area_pre_order_available; the carrier is then asked for a number in exactly that area). The number stays `pending_regulatory` until we get it, from regular stock the moment it returns or sourced by the carrier (usually 2 to 4 weeks, never guaranteed), and is not billed until active. Releasing it (DELETE /v1/phone-numbers/{id}) cancels the pre-order. A pre-order is one number: `quantity` above 1 is rejected with 400.
      */
     preOrder?: boolean;
     /**
@@ -53165,20 +53165,17 @@ export type RunCommerceCatalogSyncError = (ErrorResponse | {
 
 export type CreateVerificationData = {
     body: {
+        channel: 'sms' | 'whatsapp';
         /**
-         * SMS-only for now.
-         */
-        channel: 'sms';
-        /**
-         * E.164 phone number.
+         * E.164 phone number. WhatsApp only delivers to a phone number, never to a username.
          */
         to: string;
         /**
-         * The SMS-enabled number on your account to send from. Defaults to your only SMS number.
+         * The number on your account to send from: an SMS-enabled number for `sms`, a connected WhatsApp number for `whatsapp`. Defaults to your only number on that channel.
          */
         from?: string;
         /**
-         * Your app or business name, rendered in the message. Defaults to your account name. Letters, numbers, and basic punctuation only.
+         * Your app or business name, rendered in the SMS message. Defaults to your account name. Not shown on WhatsApp, where Meta fixes the message and shows your WhatsApp display name. Letters, numbers, and basic punctuation only.
          */
         brandName?: string;
         codeLength?: number;