@zernio/node 0.2.746 → 0.2.748

package/dist/index.d.mts

@@ -21262,6 +21262,53 @@ type CreateInboxConversationData = {
              */
             value: string;
         }>;
+        /**
+         * WhatsApp only. Per-card overrides for a CAROUSEL template, each addressed by the card's card_index. Carousel card body variables restart at {{1}} per card, so they cannot be expressed in the flat templateParams slot order; use this instead. A cardIndex naming a card the approved template does not have, a duplicate cardIndex, or a params count that does not match the card body's token count is rejected with 400 (INVALID_TEMPLATE_CARD_PARAM).
+         */
+        templateCards?: Array<{
+            /**
+             * The card's card_index in the approved template.
+             */
+            cardIndex: number;
+            /**
+             * Values for this card's own body variables, in the card's own {{1}}, {{2}}, ... order (or named-slot order of appearance).
+             */
+            params?: Array<(string)>;
+            /**
+             * Overrides this card's header asset for THIS send. Without it, the card's approved sample asset is sent.
+             */
+            headerMedia?: {
+                /**
+                 * Must match the card header's media type.
+                 */
+                type: 'image' | 'video' | 'document';
+                /**
+                 * Public URL of the asset to send. Must be reachable without auth.
+                 */
+                link?: string;
+                /**
+                 * A Meta media id (from the media upload endpoint), as an alternative to link.
+                 */
+                id?: string;
+            };
+            /**
+             * Values for this card's own buttons, each addressed by the button's index within the card.
+             */
+            buttons?: Array<{
+                /**
+                 * Zero-based position of the button within the card's buttons.
+                 */
+                index: number;
+                /**
+                 * The button kind, which decides how the value is sent.
+                 */
+                subType: 'quick_reply' | 'url';
+                /**
+                 * The value to send (quick_reply payload, or the URL dynamic suffix).
+                 */
+                value: string;
+            }>;
+        }>;
         /**
          * WhatsApp only. Overrides a media-header template's header asset for THIS send, so a template with an image/video/document header can carry a different asset per message (e.g. each recipient their own invoice PDF). Without it, the template's approved sample asset is sent. Provide exactly one of link or id.
          */
@@ -21333,7 +21380,7 @@ type CreateInboxConversationResponse = ({
 });
 type CreateInboxConversationError = ({
     error?: string;
-    code?: 'PLATFORM_NOT_SUPPORTED' | 'PLATFORM_LIMITATION' | 'TEMPLATE_REQUIRED' | 'INVALID_TEMPLATE_PARAMS' | 'INVALID_TEMPLATE_BUTTON_PARAM' | 'DIRECT_SEND_NOT_ELIGIBLE' | 'DIRECT_SEND_LIMITED' | 'DIRECT_SEND_BLOCKED';
+    code?: 'PLATFORM_NOT_SUPPORTED' | 'PLATFORM_LIMITATION' | 'TEMPLATE_REQUIRED' | 'INVALID_TEMPLATE_PARAMS' | 'INVALID_TEMPLATE_BUTTON_PARAM' | 'INVALID_TEMPLATE_CARD_PARAM' | 'DIRECT_SEND_NOT_ELIGIBLE' | 'DIRECT_SEND_LIMITED' | 'DIRECT_SEND_BLOCKED';
 } | {
     error?: string;
 } | unknown | {

package/dist/index.d.ts

@@ -21262,6 +21262,53 @@ type CreateInboxConversationData = {
              */
             value: string;
         }>;
+        /**
+         * WhatsApp only. Per-card overrides for a CAROUSEL template, each addressed by the card's card_index. Carousel card body variables restart at {{1}} per card, so they cannot be expressed in the flat templateParams slot order; use this instead. A cardIndex naming a card the approved template does not have, a duplicate cardIndex, or a params count that does not match the card body's token count is rejected with 400 (INVALID_TEMPLATE_CARD_PARAM).
+         */
+        templateCards?: Array<{
+            /**
+             * The card's card_index in the approved template.
+             */
+            cardIndex: number;
+            /**
+             * Values for this card's own body variables, in the card's own {{1}}, {{2}}, ... order (or named-slot order of appearance).
+             */
+            params?: Array<(string)>;
+            /**
+             * Overrides this card's header asset for THIS send. Without it, the card's approved sample asset is sent.
+             */
+            headerMedia?: {
+                /**
+                 * Must match the card header's media type.
+                 */
+                type: 'image' | 'video' | 'document';
+                /**
+                 * Public URL of the asset to send. Must be reachable without auth.
+                 */
+                link?: string;
+                /**
+                 * A Meta media id (from the media upload endpoint), as an alternative to link.
+                 */
+                id?: string;
+            };
+            /**
+             * Values for this card's own buttons, each addressed by the button's index within the card.
+             */
+            buttons?: Array<{
+                /**
+                 * Zero-based position of the button within the card's buttons.
+                 */
+                index: number;
+                /**
+                 * The button kind, which decides how the value is sent.
+                 */
+                subType: 'quick_reply' | 'url';
+                /**
+                 * The value to send (quick_reply payload, or the URL dynamic suffix).
+                 */
+                value: string;
+            }>;
+        }>;
         /**
          * WhatsApp only. Overrides a media-header template's header asset for THIS send, so a template with an image/video/document header can carry a different asset per message (e.g. each recipient their own invoice PDF). Without it, the template's approved sample asset is sent. Provide exactly one of link or id.
          */
@@ -21333,7 +21380,7 @@ type CreateInboxConversationResponse = ({
 });
 type CreateInboxConversationError = ({
     error?: string;
-    code?: 'PLATFORM_NOT_SUPPORTED' | 'PLATFORM_LIMITATION' | 'TEMPLATE_REQUIRED' | 'INVALID_TEMPLATE_PARAMS' | 'INVALID_TEMPLATE_BUTTON_PARAM' | 'DIRECT_SEND_NOT_ELIGIBLE' | 'DIRECT_SEND_LIMITED' | 'DIRECT_SEND_BLOCKED';
+    code?: 'PLATFORM_NOT_SUPPORTED' | 'PLATFORM_LIMITATION' | 'TEMPLATE_REQUIRED' | 'INVALID_TEMPLATE_PARAMS' | 'INVALID_TEMPLATE_BUTTON_PARAM' | 'INVALID_TEMPLATE_CARD_PARAM' | 'DIRECT_SEND_NOT_ELIGIBLE' | 'DIRECT_SEND_LIMITED' | 'DIRECT_SEND_BLOCKED';
 } | {
     error?: string;
 } | unknown | {

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@zernio/node",
-  version: "0.2.746",
+  version: "0.2.748",
   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.746",
+  version: "0.2.748",
   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.746",
+  "version": "0.2.748",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -3591,6 +3591,7 @@ export const listInboxConversations = <ThrowOnError extends boolean = false>(opt
  * - Templates with media headers (image, video, document) are handled automatically: Zernio reads the approved template definition and fills the header at send time with the template's approved sample asset. To send a DIFFERENT asset per message (e.g. a distinct invoice PDF for each recipient), pass the headerMedia field with a public link (or a Meta media id); it overrides the sample for that send.
  * - A template whose approved header format is LOCATION has no header asset to reconstruct at all: Meta only accepts the location at send time, so pass headerLocation (latitude and longitude required) whenever such a template is sent; headerMedia and headerLocation cannot both be supplied.
  * - A button that carries its own value at send time (a copy-code button holding a Pix payment code or a coupon, a flow token) is sent with templateButtonParams, addressed by the button's index; templateParams covers text variables and dynamic URL buttons only.
+ * - CAROUSEL templates take per-card overrides via templateCards, each addressed by the card's card_index, because card body variables restart at {{1}} per card and cannot be expressed in the flat templateParams order.
  * - Template fields are accepted on the JSON body only, not on multipart requests.
  *
  * For a number you already have a thread with, this sends the template into that thread, which also makes it the way to re-engage a contact after the 24-hour customer-service window has closed. Once the recipient replies (opening the 24h window), send freeform messages with the send-message endpoint (POST /v1/inbox/conversations/{conversationId}/messages).
@@ -9985,6 +9986,7 @@ export const listGoogleAssetGroups = <ThrowOnError extends boolean = false>(opti
  * request with Google without creating or persisting resources. Read assets with
  * `GET /v1/ads/campaigns/{campaignId}/asset-groups`. The logo is required; video is
  * optional via `assetGroup.youtubeVideoId`. Brand guidelines are disabled at creation.
+ * All supplied asset links are validated together against Google's minimum asset requirements.
  * PMax rejects ACTIVE creation, portfolio bidding, bid caps, legacy creative fields
  * and attach shapes. Geo and language targeting are supported; omitted geo targets
  * all locations. PMax does not require top-level goal, headline, body or linkUrl.

package/src/generated/types.gen.ts

@@ -20751,6 +20751,53 @@ export type CreateInboxConversationData = {
              */
             value: string;
         }>;
+        /**
+         * WhatsApp only. Per-card overrides for a CAROUSEL template, each addressed by the card's card_index. Carousel card body variables restart at {{1}} per card, so they cannot be expressed in the flat templateParams slot order; use this instead. A cardIndex naming a card the approved template does not have, a duplicate cardIndex, or a params count that does not match the card body's token count is rejected with 400 (INVALID_TEMPLATE_CARD_PARAM).
+         */
+        templateCards?: Array<{
+            /**
+             * The card's card_index in the approved template.
+             */
+            cardIndex: number;
+            /**
+             * Values for this card's own body variables, in the card's own {{1}}, {{2}}, ... order (or named-slot order of appearance).
+             */
+            params?: Array<(string)>;
+            /**
+             * Overrides this card's header asset for THIS send. Without it, the card's approved sample asset is sent.
+             */
+            headerMedia?: {
+                /**
+                 * Must match the card header's media type.
+                 */
+                type: 'image' | 'video' | 'document';
+                /**
+                 * Public URL of the asset to send. Must be reachable without auth.
+                 */
+                link?: string;
+                /**
+                 * A Meta media id (from the media upload endpoint), as an alternative to link.
+                 */
+                id?: string;
+            };
+            /**
+             * Values for this card's own buttons, each addressed by the button's index within the card.
+             */
+            buttons?: Array<{
+                /**
+                 * Zero-based position of the button within the card's buttons.
+                 */
+                index: number;
+                /**
+                 * The button kind, which decides how the value is sent.
+                 */
+                subType: 'quick_reply' | 'url';
+                /**
+                 * The value to send (quick_reply payload, or the URL dynamic suffix).
+                 */
+                value: string;
+            }>;
+        }>;
         /**
          * WhatsApp only. Overrides a media-header template's header asset for THIS send, so a template with an image/video/document header can carry a different asset per message (e.g. each recipient their own invoice PDF). Without it, the template's approved sample asset is sent. Provide exactly one of link or id.
          */
@@ -20824,7 +20871,7 @@ export type CreateInboxConversationResponse = ({
 
 export type CreateInboxConversationError = ({
     error?: string;
-    code?: 'PLATFORM_NOT_SUPPORTED' | 'PLATFORM_LIMITATION' | 'TEMPLATE_REQUIRED' | 'INVALID_TEMPLATE_PARAMS' | 'INVALID_TEMPLATE_BUTTON_PARAM' | 'DIRECT_SEND_NOT_ELIGIBLE' | 'DIRECT_SEND_LIMITED' | 'DIRECT_SEND_BLOCKED';
+    code?: 'PLATFORM_NOT_SUPPORTED' | 'PLATFORM_LIMITATION' | 'TEMPLATE_REQUIRED' | 'INVALID_TEMPLATE_PARAMS' | 'INVALID_TEMPLATE_BUTTON_PARAM' | 'INVALID_TEMPLATE_CARD_PARAM' | 'DIRECT_SEND_NOT_ELIGIBLE' | 'DIRECT_SEND_LIMITED' | 'DIRECT_SEND_BLOCKED';
 } | {
     error?: string;
 } | unknown | {