@zernio/node 0.2.1003 → 0.2.1005

package/dist/index.d.mts

@@ -5652,9 +5652,9 @@ type actionSource = 'web' | 'app' | 'offline' | 'crm' | 'phone_call' | 'system_g
  * creative fields must NOT be set on this shape.
  *
  * Existing post references work on messaging and CTWA only (not call ads).
- * They cannot be combined with each other or with headline, body, imageUrl,
- * video, or welcomeMessage. No media is uploaded and the organic post is
- * retained. Fresh creatives still require headline, body, and image or video.
+ * They cannot be combined with each other or with headline, body, imageUrl
+ * or video. `welcomeMessage` works on them (it lives on the ad, not the post).
+ * No media is uploaded and the organic post is retained. Fresh creatives still require headline, body, and image or video.
  *
  * The route enforces this at the Zod boundary; OpenAPI's
  * `required` cannot express the OR cleanly.
@@ -5691,7 +5691,7 @@ type CtwaAdRequestBody = {
      */
     adSetName?: string;
     /**
-     * Messaging and CTWA only. Platform post or reel ID, the same input boostPost takes as platformPostId. Facebook IDs become object_story_id; Instagram IDs become source_instagram_media_id using the connected Instagram identity. Mutually exclusive with objectStoryId and fresh creative fields.
+     * Messaging and CTWA only. Platform post or reel ID, the same input boostPost takes as platformPostId. Facebook IDs become object_story_id; Instagram IDs become source_instagram_media_id run as the media owner (resolved from the media on a Meta ads business-login connection, so no Instagram connection is needed). Mutually exclusive with objectStoryId and fresh creative fields.
      */
     platformPostId?: string;
     /**
@@ -5803,7 +5803,7 @@ type CtwaAdRequestBody = {
      */
     creatives?: Array<{
         /**
-         * Messaging and CTWA only. Platform post or reel ID, the same input boostPost takes as platformPostId. Facebook IDs become object_story_id; Instagram IDs become source_instagram_media_id using the connected Instagram identity. Mutually exclusive with objectStoryId and fresh creative fields.
+         * Messaging and CTWA only. Platform post or reel ID, the same input boostPost takes as platformPostId. Facebook IDs become object_story_id; Instagram IDs become source_instagram_media_id run as the media owner (resolved from the media on a Meta ads business-login connection, so no Instagram connection is needed). Mutually exclusive with objectStoryId and fresh creative fields.
          */
         platformPostId?: string;
         /**
@@ -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
  */
@@ -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

@@ -5652,9 +5652,9 @@ type actionSource = 'web' | 'app' | 'offline' | 'crm' | 'phone_call' | 'system_g
  * creative fields must NOT be set on this shape.
  *
  * Existing post references work on messaging and CTWA only (not call ads).
- * They cannot be combined with each other or with headline, body, imageUrl,
- * video, or welcomeMessage. No media is uploaded and the organic post is
- * retained. Fresh creatives still require headline, body, and image or video.
+ * They cannot be combined with each other or with headline, body, imageUrl
+ * or video. `welcomeMessage` works on them (it lives on the ad, not the post).
+ * No media is uploaded and the organic post is retained. Fresh creatives still require headline, body, and image or video.
  *
  * The route enforces this at the Zod boundary; OpenAPI's
  * `required` cannot express the OR cleanly.
@@ -5691,7 +5691,7 @@ type CtwaAdRequestBody = {
      */
     adSetName?: string;
     /**
-     * Messaging and CTWA only. Platform post or reel ID, the same input boostPost takes as platformPostId. Facebook IDs become object_story_id; Instagram IDs become source_instagram_media_id using the connected Instagram identity. Mutually exclusive with objectStoryId and fresh creative fields.
+     * Messaging and CTWA only. Platform post or reel ID, the same input boostPost takes as platformPostId. Facebook IDs become object_story_id; Instagram IDs become source_instagram_media_id run as the media owner (resolved from the media on a Meta ads business-login connection, so no Instagram connection is needed). Mutually exclusive with objectStoryId and fresh creative fields.
      */
     platformPostId?: string;
     /**
@@ -5803,7 +5803,7 @@ type CtwaAdRequestBody = {
      */
     creatives?: Array<{
         /**
-         * Messaging and CTWA only. Platform post or reel ID, the same input boostPost takes as platformPostId. Facebook IDs become object_story_id; Instagram IDs become source_instagram_media_id using the connected Instagram identity. Mutually exclusive with objectStoryId and fresh creative fields.
+         * Messaging and CTWA only. Platform post or reel ID, the same input boostPost takes as platformPostId. Facebook IDs become object_story_id; Instagram IDs become source_instagram_media_id run as the media owner (resolved from the media on a Meta ads business-login connection, so no Instagram connection is needed). Mutually exclusive with objectStoryId and fresh creative fields.
          */
         platformPostId?: string;
         /**
@@ -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
  */
@@ -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.1003",
+  version: "0.2.1005",
   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.1003",
+  version: "0.2.1005",
   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.1003",
+  "version": "0.2.1005",
   "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

@@ -3861,9 +3861,9 @@ export type actionSource = 'web' | 'app' | 'offline' | 'crm' | 'phone_call' | 's
  * creative fields must NOT be set on this shape.
  *
  * Existing post references work on messaging and CTWA only (not call ads).
- * They cannot be combined with each other or with headline, body, imageUrl,
- * video, or welcomeMessage. No media is uploaded and the organic post is
- * retained. Fresh creatives still require headline, body, and image or video.
+ * They cannot be combined with each other or with headline, body, imageUrl
+ * or video. `welcomeMessage` works on them (it lives on the ad, not the post).
+ * No media is uploaded and the organic post is retained. Fresh creatives still require headline, body, and image or video.
  *
  * The route enforces this at the Zod boundary; OpenAPI's
  * `required` cannot express the OR cleanly.
@@ -3900,7 +3900,7 @@ export type CtwaAdRequestBody = {
      */
     adSetName?: string;
     /**
-     * Messaging and CTWA only. Platform post or reel ID, the same input boostPost takes as platformPostId. Facebook IDs become object_story_id; Instagram IDs become source_instagram_media_id using the connected Instagram identity. Mutually exclusive with objectStoryId and fresh creative fields.
+     * Messaging and CTWA only. Platform post or reel ID, the same input boostPost takes as platformPostId. Facebook IDs become object_story_id; Instagram IDs become source_instagram_media_id run as the media owner (resolved from the media on a Meta ads business-login connection, so no Instagram connection is needed). Mutually exclusive with objectStoryId and fresh creative fields.
      */
     platformPostId?: string;
     /**
@@ -4012,7 +4012,7 @@ export type CtwaAdRequestBody = {
      */
     creatives?: Array<{
         /**
-         * Messaging and CTWA only. Platform post or reel ID, the same input boostPost takes as platformPostId. Facebook IDs become object_story_id; Instagram IDs become source_instagram_media_id using the connected Instagram identity. Mutually exclusive with objectStoryId and fresh creative fields.
+         * Messaging and CTWA only. Platform post or reel ID, the same input boostPost takes as platformPostId. Facebook IDs become object_story_id; Instagram IDs become source_instagram_media_id run as the media owner (resolved from the media on a Meta ads business-login connection, so no Instagram connection is needed). Mutually exclusive with objectStoryId and fresh creative fields.
          */
         platformPostId?: string;
         /**
@@ -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
@@ -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;