@getlatedev/node 0.2.1093 → 0.2.1095

package/dist/index.js

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

package/src/generated/types.gen.ts

@@ -4006,6 +4006,8 @@ export type actionSource = 'web' | 'app' | 'offline' | 'crm' | 'phone_call' | 's
  * - Single-creative: `headline`, `body`, and one of `imageUrl` / `video`,
  * OR `platformPostId` / `objectStoryId` to reuse an organic post.
  * On POST /v1/ads/messaging, `placementAssets` can replace `imageUrl` / `video`.
+ * - Carousel (messaging and CTWA): `body` and `carouselCards` (2-10 image
+ * cards) instead of `imageUrl` / `video`, top level or per `creatives[]` entry.
  * - Multi-creative: a non-empty `creatives[]` array. Top-level
  * creative fields must NOT be set on this shape.
  *
@@ -4166,6 +4168,21 @@ export type CtwaAdRequestBody = {
             payload: string;
         }>;
     };
+    /**
+     * Messaging and CTWA only (a 400 on POST /v1/ads/call). A hand-built carousel
+     * of 2-10 image cards, sent to Meta as `link_data.child_attachments`; every
+     * card (and the carousel itself) carries the destination's messaging call to
+     * action (WHATSAPP_MESSAGE, MESSAGE_PAGE or INSTAGRAM_MESSAGE), so a tap on any
+     * card opens the conversation. Replaces `imageUrl` / `video` (sending either is
+     * a 400). `body` is required as the primary text; `headline` is optional and
+     * only names the creative (each card has its own `headline`); a top-level
+     * `description` is a 400 (set it per card). `welcomeMessage`,
+     * `whatsappPhoneNumber` and `destinations` apply as on a single-image ad. Also a
+     * 400 with `placementAssets`, `platformPostId`, `existingPostId` or
+     * `objectStoryId`. Single-creative shape; for `creatives[]` set it per entry.
+     *
+     */
+    carouselCards?: Array<MessagingCarouselCard>;
     /**
      * Multi-creative shape: N CTWA ads under one campaign + one
      * ad set, sharing budget and targeting. Mutually exclusive
@@ -4242,6 +4259,10 @@ export type CtwaAdRequestBody = {
              */
             prefillText: string;
         };
+        /**
+         * A 2-10 card carousel for this entry instead of `imageUrl` / `video`; `body` is required. Same rules as the top-level `carouselCards`. Carousel and single-media entries can be mixed on one ad set.
+         */
+        carouselCards?: Array<MessagingCarouselCard>;
     }>;
     /**
      * Attach the creatives to this EXISTING messaging ad set instead of
@@ -7878,6 +7899,32 @@ export type MediaUploadResponse = {
     files?: Array<UploadedFile>;
 };
 
+/**
+ * One card of a messaging ad carousel (Meta link_data.child_attachments). Every card opens the same conversation, so a card has no link of its own.
+ */
+export type MessagingCarouselCard = {
+    /**
+     * Card image. Uploaded to the ad account and sent as the card image_hash (by URL on validateOnly).
+     */
+    imageUrl: string;
+    /**
+     * Card title (Meta name).
+     */
+    headline?: string;
+    /**
+     * Card description, under the title.
+     */
+    description?: string;
+    /**
+     * Optional. Must equal the destination's messaging call to action (WHATSAPP_MESSAGE for whatsapp, MESSAGE_PAGE for messenger, INSTAGRAM_MESSAGE for instagram_direct; with `destinations` the first one listed). Any other value is a 400 naming the card, because Meta refuses a carousel whose cards do not all open the destination.
+     */
+    callToAction?: string;
+    /**
+     * Not accepted: a 400. The card tap opens the conversation, not a website.
+     */
+    linkUrl?: string;
+};
+
 /**
  * Meta (facebook/instagram) options for platformSpecificData on POST /v1/ads/boost and /v1/ads/create. Unknown keys are rejected, not dropped.
  */
@@ -12430,7 +12477,7 @@ export type WebhookPayloadComment = {
         parentCommentId: (string) | null;
         /**
          * Ad context. Present only when the comment was made on paid content.
-         * Instagram: populated from the webhook payload's value.media.ad_id and value.media.ad_title.
+         * Instagram: populated from the webhook payload's value.media.ad_id, value.media.ad_title and value.media.original_media_id, each only when Meta includes it.
          * Facebook: populated via a Graph API lookup of the parent post's promotion_status.
          * Absent for comments on organic posts that are not currently promoted.
          *
@@ -12444,6 +12491,10 @@ export type WebhookPayloadComment = {
              * Ad creative title (Instagram only).
              */
             title?: string;
+            /**
+             * Original media ID that Meta reports for the ad (Instagram only).
+             */
+            originalMediaId?: string;
             /**
              * Facebook promotion status returned by Graph API. Common values:
              * "active" (organic post currently boosted), "ineligible" (dark
@@ -49966,7 +50017,7 @@ export type CreateMessagingAdData = {
      */
     placementAssets?: (MetaPlacementAssets);
     /**
-     * Dry-runs the ad on Meta with execution_options validate_only as ONE inline campaign + ad set + creative + ad (or creative + ad on the existing ad set with `adSetId`). Nothing is uploaded or created and nothing is stored; media is checked by URL. Supports one creative with `imageUrl`, image `placementAssets`, an existing `video.id`, or an existing post. Several creatives, a new `video.url` and video `placementAssets` need uploads first and return 400. Success returns 200 with per-node results; a Meta rejection returns the Meta error.
+     * Dry-runs the ad on Meta with execution_options validate_only as ONE inline campaign + ad set + creative + ad (or creative + ad on the existing ad set with `adSetId`). Nothing is uploaded or created and nothing is stored; media is checked by URL. Supports one creative with `imageUrl`, image `placementAssets`, `carouselCards`, an existing `video.id`, or an existing post. Several creatives, a new `video.url` and video `placementAssets` need uploads first and return 400. Success returns 200 with per-node results; a Meta rejection returns the Meta error.
      */
     validateOnly?: boolean;
 });