@zernio/node 0.2.82 → 0.2.84

package/dist/index.d.mts

@@ -3110,6 +3110,30 @@ type WebhookPayloadComment = {
          * Parent comment ID if this is a reply
          */
         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`/`ad_title`.
+         * 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.
+         *
+         */
+        ad?: {
+            /**
+             * Meta ad ID (Instagram only).
+             */
+            id?: string;
+            /**
+             * Ad creative title (Instagram only).
+             */
+            title?: string;
+            /**
+             * Facebook promotion status returned by Graph API. Common values:
+             * "active" (organic post currently boosted), "ineligible" (dark
+             * post / ad creative — not promotable because it already is an ad).
+             *
+             */
+            promotionStatus?: string;
+        };
     };
     post: {
         /**
@@ -12199,9 +12223,22 @@ type CreateStandaloneAdData = {
          */
         linkUrl?: string;
         /**
-         * Image creative for Meta/Google/Pinterest on legacy + attach shapes (mutually exclusive with `video`). Not required for Google Search campaigns. For TikTok, this field carries the VIDEO URL (the TikTok ads endpoint is video-only; the field retains the `imageUrl` name for cross-platform consistency). Ignored for X/Twitter.
+         * Image creative for Meta/Google/Pinterest on legacy + attach shapes (mutually exclusive with `video`). Not required for Google Search campaigns. For TikTok, this field carries the VIDEO URL (the TikTok ads endpoint is video-only; the field retains the `imageUrl` name for cross-platform consistency). Ignored for X/Twitter. For Google Display, treated as the landscape image (alias of `images.landscape`); supply `images.square` alongside or the request is rejected.
          */
         imageUrl?: string;
+        /**
+         * Google Display (Responsive Display Ads) only. Google RDA requires both a landscape (1.91:1) and a square (1:1) marketing image; sending only one is rejected upstream as 'Too few.' (NOT_ENOUGH_*_MARKETING_IMAGE_ASSET). Supply both URLs here. Either this field or the legacy `imageUrl` can provide the landscape, but `square` has no legacy counterpart so it must be set here for Display.
+         */
+        images?: {
+            /**
+             * Landscape 1.91:1 marketing image URL (e.g. 1200x628). Also accepted via the top-level `imageUrl` for backward compatibility.
+             */
+            landscape?: string;
+            /**
+             * Square 1:1 marketing image URL (e.g. 1080x1080). Required for Google Display.
+             */
+            square?: string;
+        };
         /**
          * Meta only (facebook, instagram). When set, creates a VIDEO ad on the legacy or attach shape. Mutually exclusive with `imageUrl`. For multi-creative, set `video` per entry inside `creatives[]` instead.
          */

package/dist/index.d.ts

@@ -3110,6 +3110,30 @@ type WebhookPayloadComment = {
          * Parent comment ID if this is a reply
          */
         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`/`ad_title`.
+         * 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.
+         *
+         */
+        ad?: {
+            /**
+             * Meta ad ID (Instagram only).
+             */
+            id?: string;
+            /**
+             * Ad creative title (Instagram only).
+             */
+            title?: string;
+            /**
+             * Facebook promotion status returned by Graph API. Common values:
+             * "active" (organic post currently boosted), "ineligible" (dark
+             * post / ad creative — not promotable because it already is an ad).
+             *
+             */
+            promotionStatus?: string;
+        };
     };
     post: {
         /**
@@ -12199,9 +12223,22 @@ type CreateStandaloneAdData = {
          */
         linkUrl?: string;
         /**
-         * Image creative for Meta/Google/Pinterest on legacy + attach shapes (mutually exclusive with `video`). Not required for Google Search campaigns. For TikTok, this field carries the VIDEO URL (the TikTok ads endpoint is video-only; the field retains the `imageUrl` name for cross-platform consistency). Ignored for X/Twitter.
+         * Image creative for Meta/Google/Pinterest on legacy + attach shapes (mutually exclusive with `video`). Not required for Google Search campaigns. For TikTok, this field carries the VIDEO URL (the TikTok ads endpoint is video-only; the field retains the `imageUrl` name for cross-platform consistency). Ignored for X/Twitter. For Google Display, treated as the landscape image (alias of `images.landscape`); supply `images.square` alongside or the request is rejected.
          */
         imageUrl?: string;
+        /**
+         * Google Display (Responsive Display Ads) only. Google RDA requires both a landscape (1.91:1) and a square (1:1) marketing image; sending only one is rejected upstream as 'Too few.' (NOT_ENOUGH_*_MARKETING_IMAGE_ASSET). Supply both URLs here. Either this field or the legacy `imageUrl` can provide the landscape, but `square` has no legacy counterpart so it must be set here for Display.
+         */
+        images?: {
+            /**
+             * Landscape 1.91:1 marketing image URL (e.g. 1200x628). Also accepted via the top-level `imageUrl` for backward compatibility.
+             */
+            landscape?: string;
+            /**
+             * Square 1:1 marketing image URL (e.g. 1080x1080). Required for Google Display.
+             */
+            square?: string;
+        };
         /**
          * Meta only (facebook, instagram). When set, creates a VIDEO ad on the legacy or attach shape. Mutually exclusive with `imageUrl`. For multi-creative, set `video` per entry inside `creatives[]` instead.
          */

package/package.json

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

package/src/generated/sdk.gen.ts

@@ -3190,7 +3190,7 @@ export const boostPost = <ThrowOnError extends boolean = false>(options: Options
  *
  * **Per-platform required fields** (the platform is inferred from `accountId`):
  * - **Meta (facebook, instagram)**: `accountId`, `adAccountId`, `name`, `goal`, `budgetAmount`, `budgetType`, `headline`, `body`, `imageUrl`, `linkUrl`, `callToAction`.
- * - **Google Ads (Display)**: `accountId`, `adAccountId`, `name`, `goal`, `budgetAmount`, `budgetType`, `headline`, `body`, `linkUrl`, `imageUrl`, `businessName`. `longHeadline` defaults to `headline` if omitted (max 90 chars).
+ * - **Google Ads (Display)**: `accountId`, `adAccountId`, `name`, `goal`, `budgetAmount`, `budgetType`, `headline`, `body`, `linkUrl`, `images.landscape` (1.91:1) + `images.square` (1:1), `businessName`. Google's Responsive Display Ads require BOTH a landscape and a square marketing image; supplying only one is rejected by Google as "Too few.". The legacy top-level `imageUrl` is accepted as an alias for `images.landscape` for back-compat. `longHeadline` defaults to `headline` if omitted (max 90 chars).
  * - **Google Ads (Search)**: `accountId`, `adAccountId`, `name`, `goal`, `budgetAmount`, `budgetType`, `headline`, `body`, `linkUrl`, `businessName`. `imageUrl` is NOT required for Search. Set `campaignType: "search"`.
  * - **TikTok**: `accountId`, `adAccountId`, `name`, `goal`, `budgetAmount`, `budgetType`, `body`, `linkUrl`, `imageUrl` (this field **carries the VIDEO URL** for TikTok; the TikTok ads endpoint is video-only and the field is named `imageUrl` for cross-platform consistency).
  * - **Pinterest**: `accountId`, `adAccountId`, `name`, `goal`, `budgetAmount`, `budgetType`, `headline`, `body`, `imageUrl`, `linkUrl`. Optional `boardId` (auto-creates "Zernio Ads" board if omitted).

package/src/generated/types.gen.ts

@@ -2647,6 +2647,30 @@ export type WebhookPayloadComment = {
          * Parent comment ID if this is a reply
          */
         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`/`ad_title`.
+         * 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.
+         *
+         */
+        ad?: {
+            /**
+             * Meta ad ID (Instagram only).
+             */
+            id?: string;
+            /**
+             * Ad creative title (Instagram only).
+             */
+            title?: string;
+            /**
+             * Facebook promotion status returned by Graph API. Common values:
+             * "active" (organic post currently boosted), "ineligible" (dark
+             * post / ad creative — not promotable because it already is an ad).
+             *
+             */
+            promotionStatus?: string;
+        };
     };
     post: {
         /**
@@ -12509,9 +12533,22 @@ export type CreateStandaloneAdData = {
          */
         linkUrl?: string;
         /**
-         * Image creative for Meta/Google/Pinterest on legacy + attach shapes (mutually exclusive with `video`). Not required for Google Search campaigns. For TikTok, this field carries the VIDEO URL (the TikTok ads endpoint is video-only; the field retains the `imageUrl` name for cross-platform consistency). Ignored for X/Twitter.
+         * Image creative for Meta/Google/Pinterest on legacy + attach shapes (mutually exclusive with `video`). Not required for Google Search campaigns. For TikTok, this field carries the VIDEO URL (the TikTok ads endpoint is video-only; the field retains the `imageUrl` name for cross-platform consistency). Ignored for X/Twitter. For Google Display, treated as the landscape image (alias of `images.landscape`); supply `images.square` alongside or the request is rejected.
          */
         imageUrl?: string;
+        /**
+         * Google Display (Responsive Display Ads) only. Google RDA requires both a landscape (1.91:1) and a square (1:1) marketing image; sending only one is rejected upstream as 'Too few.' (NOT_ENOUGH_*_MARKETING_IMAGE_ASSET). Supply both URLs here. Either this field or the legacy `imageUrl` can provide the landscape, but `square` has no legacy counterpart so it must be set here for Display.
+         */
+        images?: {
+            /**
+             * Landscape 1.91:1 marketing image URL (e.g. 1200x628). Also accepted via the top-level `imageUrl` for backward compatibility.
+             */
+            landscape?: string;
+            /**
+             * Square 1:1 marketing image URL (e.g. 1080x1080). Required for Google Display.
+             */
+            square?: string;
+        };
         /**
          * Meta only (facebook, instagram). When set, creates a VIDEO ad on the legacy or attach shape. Mutually exclusive with `imageUrl`. For multi-creative, set `video` per entry inside `creatives[]` instead.
          */