@zernio/node 0.2.205 → 0.2.207

package/dist/index.d.mts

@@ -18044,36 +18044,53 @@ type CreateStandaloneAdData = {
             adFormat?: 'SINGLE_IMAGE' | 'CAROUSEL_IMAGE';
         };
         /**
-         * Meta only. Placement asset customization: pin a SPECIFIC image to each placement
-         * group on a SINGLE ad (e.g. a 9:16 image on Stories/Reels and a 4:5 on Feed). This
-         * is the same thing Meta Ads Manager produces with "different creative per placement",
-         * mapped to the creative's `asset_feed_spec` + `asset_customization_rules`. It is
-         * deterministic pinning, NOT the auto-optimizing pool of `dynamicCreative` (the two are
-         * mutually exclusive, and it cannot be combined with `creatives[]` or `adSetId`). The
-         * shared copy (headline, body, link, CTA) comes from the top-level single-creative
-         * fields (`headline`, `body`, `linkUrl`, `callToAction`) since only the image varies by
+         * Meta only. Placement asset customization: pin a SPECIFIC asset (image OR video) to
+         * each placement group on a SINGLE ad (e.g. a 9:16 on Stories/Reels and a 4:5 on Feed).
+         * The same thing Meta Ads Manager produces with "different creative per placement",
+         * mapped to the creative's `asset_feed_spec` + `asset_customization_rules`. Deterministic
+         * pinning, NOT the auto-optimizing pool of `dynamicCreative` (mutually exclusive, and it
+         * cannot be combined with `creatives[]` or `adSetId`). Shared copy (headline, body, link,
+         * CTA) comes from the top-level single-creative fields since only the asset varies by
          * placement. Each rule's `placements` accepts the same fields as the top-level
          * `placements` object; Meta enforces co-selection rules and returns an actionable error.
          *
+         * A block is all-image OR all-video, never mixed (Meta's asset_feed_spec carries one ad
+         * format). Image mode: `defaultImageUrl` + `rules[].imageUrl`. Video mode:
+         * `defaultVideoUrl` + `rules[].videoUrl` (optional `thumbnailUrl`/`defaultThumbnailUrl`
+         * posters; Meta auto-generates when omitted). Exactly one catch-all default is required.
+         *
          */
         placementAssets?: {
             /**
-             * Catch-all image for any placement not matched by a rule. REQUIRED — Meta mandates
-             * a default asset customization rule (empty placement spec, lowest priority) on every
-             * placement-customized creative.
-             *
+             * Image mode. Catch-all image for any placement no rule matches. Required in image mode (Meta mandates a default rule).
+             */
+            defaultImageUrl?: string;
+            /**
+             * Video mode. Catch-all video for any placement no rule matches. Required in video mode.
              */
-            defaultImageUrl: string;
+            defaultVideoUrl?: string;
             /**
-             * One entry per placement group you want to pin a specific image to.
+             * Video mode (optional). Poster image for the default video; Meta auto-generates one when omitted.
+             */
+            defaultThumbnailUrl?: string;
+            /**
+             * One entry per placement group you want to pin a specific asset to.
              */
             rules: Array<{
                 /**
-                 * The image to deliver for this rule's placements.
+                 * Image mode. The image to deliver for this rule's placements.
                  */
-                imageUrl: string;
+                imageUrl?: string;
                 /**
-                 * Placements this image is pinned to. At least one field must be set (an empty rule is invalid — that role is served by defaultImageUrl). Same enums as the top-level `placements` object.
+                 * Video mode. The video to deliver for this rule's placements.
+                 */
+                videoUrl?: string;
+                /**
+                 * Video mode (optional). Poster image for this rule's video; auto-generated when omitted.
+                 */
+                thumbnailUrl?: string;
+                /**
+                 * Placements this asset is pinned to. At least one field must be set (an empty rule is invalid — that role is served by the default asset). Same enums as the top-level `placements` object.
                  */
                 placements: {
                     publisherPlatforms?: Array<('facebook' | 'instagram' | 'threads' | 'messenger' | 'audience_network')>;
@@ -18594,9 +18611,13 @@ type SearchAdTargetingError = (unknown | {
 type EstimateAdReachData = {
     body: {
         /**
-         * Social account ID on the target ad platform.
+         * Zernio social account ID on the target ad platform (the estimate runs against its platform).
          */
         accountId: string;
+        /**
+         * Required. The platform ad-account ID the reach call runs against (Meta act_..., LinkedIn numeric sponsoredAccount ID, Pinterest ad-account ID, X account ID) - every backing reach API is scoped to one ad account. Get it from GET /v1/ads/accounts.
+         */
+        adAccountId: string;
         /**
          * The targeting spec to estimate. Same shape used by POST /v1/ads/create.
          */

package/dist/index.d.ts

@@ -18044,36 +18044,53 @@ type CreateStandaloneAdData = {
             adFormat?: 'SINGLE_IMAGE' | 'CAROUSEL_IMAGE';
         };
         /**
-         * Meta only. Placement asset customization: pin a SPECIFIC image to each placement
-         * group on a SINGLE ad (e.g. a 9:16 image on Stories/Reels and a 4:5 on Feed). This
-         * is the same thing Meta Ads Manager produces with "different creative per placement",
-         * mapped to the creative's `asset_feed_spec` + `asset_customization_rules`. It is
-         * deterministic pinning, NOT the auto-optimizing pool of `dynamicCreative` (the two are
-         * mutually exclusive, and it cannot be combined with `creatives[]` or `adSetId`). The
-         * shared copy (headline, body, link, CTA) comes from the top-level single-creative
-         * fields (`headline`, `body`, `linkUrl`, `callToAction`) since only the image varies by
+         * Meta only. Placement asset customization: pin a SPECIFIC asset (image OR video) to
+         * each placement group on a SINGLE ad (e.g. a 9:16 on Stories/Reels and a 4:5 on Feed).
+         * The same thing Meta Ads Manager produces with "different creative per placement",
+         * mapped to the creative's `asset_feed_spec` + `asset_customization_rules`. Deterministic
+         * pinning, NOT the auto-optimizing pool of `dynamicCreative` (mutually exclusive, and it
+         * cannot be combined with `creatives[]` or `adSetId`). Shared copy (headline, body, link,
+         * CTA) comes from the top-level single-creative fields since only the asset varies by
          * placement. Each rule's `placements` accepts the same fields as the top-level
          * `placements` object; Meta enforces co-selection rules and returns an actionable error.
          *
+         * A block is all-image OR all-video, never mixed (Meta's asset_feed_spec carries one ad
+         * format). Image mode: `defaultImageUrl` + `rules[].imageUrl`. Video mode:
+         * `defaultVideoUrl` + `rules[].videoUrl` (optional `thumbnailUrl`/`defaultThumbnailUrl`
+         * posters; Meta auto-generates when omitted). Exactly one catch-all default is required.
+         *
          */
         placementAssets?: {
             /**
-             * Catch-all image for any placement not matched by a rule. REQUIRED — Meta mandates
-             * a default asset customization rule (empty placement spec, lowest priority) on every
-             * placement-customized creative.
-             *
+             * Image mode. Catch-all image for any placement no rule matches. Required in image mode (Meta mandates a default rule).
+             */
+            defaultImageUrl?: string;
+            /**
+             * Video mode. Catch-all video for any placement no rule matches. Required in video mode.
              */
-            defaultImageUrl: string;
+            defaultVideoUrl?: string;
             /**
-             * One entry per placement group you want to pin a specific image to.
+             * Video mode (optional). Poster image for the default video; Meta auto-generates one when omitted.
+             */
+            defaultThumbnailUrl?: string;
+            /**
+             * One entry per placement group you want to pin a specific asset to.
              */
             rules: Array<{
                 /**
-                 * The image to deliver for this rule's placements.
+                 * Image mode. The image to deliver for this rule's placements.
                  */
-                imageUrl: string;
+                imageUrl?: string;
                 /**
-                 * Placements this image is pinned to. At least one field must be set (an empty rule is invalid — that role is served by defaultImageUrl). Same enums as the top-level `placements` object.
+                 * Video mode. The video to deliver for this rule's placements.
+                 */
+                videoUrl?: string;
+                /**
+                 * Video mode (optional). Poster image for this rule's video; auto-generated when omitted.
+                 */
+                thumbnailUrl?: string;
+                /**
+                 * Placements this asset is pinned to. At least one field must be set (an empty rule is invalid — that role is served by the default asset). Same enums as the top-level `placements` object.
                  */
                 placements: {
                     publisherPlatforms?: Array<('facebook' | 'instagram' | 'threads' | 'messenger' | 'audience_network')>;
@@ -18594,9 +18611,13 @@ type SearchAdTargetingError = (unknown | {
 type EstimateAdReachData = {
     body: {
         /**
-         * Social account ID on the target ad platform.
+         * Zernio social account ID on the target ad platform (the estimate runs against its platform).
          */
         accountId: string;
+        /**
+         * Required. The platform ad-account ID the reach call runs against (Meta act_..., LinkedIn numeric sponsoredAccount ID, Pinterest ad-account ID, X account ID) - every backing reach API is scoped to one ad account. Get it from GET /v1/ads/accounts.
+         */
+        adAccountId: string;
         /**
          * The targeting spec to estimate. Same shape used by POST /v1/ads/create.
          */

package/dist/index.js

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

package/src/generated/types.gen.ts

@@ -18509,36 +18509,53 @@ export type CreateStandaloneAdData = {
             adFormat?: 'SINGLE_IMAGE' | 'CAROUSEL_IMAGE';
         };
         /**
-         * Meta only. Placement asset customization: pin a SPECIFIC image to each placement
-         * group on a SINGLE ad (e.g. a 9:16 image on Stories/Reels and a 4:5 on Feed). This
-         * is the same thing Meta Ads Manager produces with "different creative per placement",
-         * mapped to the creative's `asset_feed_spec` + `asset_customization_rules`. It is
-         * deterministic pinning, NOT the auto-optimizing pool of `dynamicCreative` (the two are
-         * mutually exclusive, and it cannot be combined with `creatives[]` or `adSetId`). The
-         * shared copy (headline, body, link, CTA) comes from the top-level single-creative
-         * fields (`headline`, `body`, `linkUrl`, `callToAction`) since only the image varies by
+         * Meta only. Placement asset customization: pin a SPECIFIC asset (image OR video) to
+         * each placement group on a SINGLE ad (e.g. a 9:16 on Stories/Reels and a 4:5 on Feed).
+         * The same thing Meta Ads Manager produces with "different creative per placement",
+         * mapped to the creative's `asset_feed_spec` + `asset_customization_rules`. Deterministic
+         * pinning, NOT the auto-optimizing pool of `dynamicCreative` (mutually exclusive, and it
+         * cannot be combined with `creatives[]` or `adSetId`). Shared copy (headline, body, link,
+         * CTA) comes from the top-level single-creative fields since only the asset varies by
          * placement. Each rule's `placements` accepts the same fields as the top-level
          * `placements` object; Meta enforces co-selection rules and returns an actionable error.
          *
+         * A block is all-image OR all-video, never mixed (Meta's asset_feed_spec carries one ad
+         * format). Image mode: `defaultImageUrl` + `rules[].imageUrl`. Video mode:
+         * `defaultVideoUrl` + `rules[].videoUrl` (optional `thumbnailUrl`/`defaultThumbnailUrl`
+         * posters; Meta auto-generates when omitted). Exactly one catch-all default is required.
+         *
          */
         placementAssets?: {
             /**
-             * Catch-all image for any placement not matched by a rule. REQUIRED — Meta mandates
-             * a default asset customization rule (empty placement spec, lowest priority) on every
-             * placement-customized creative.
-             *
+             * Image mode. Catch-all image for any placement no rule matches. Required in image mode (Meta mandates a default rule).
+             */
+            defaultImageUrl?: string;
+            /**
+             * Video mode. Catch-all video for any placement no rule matches. Required in video mode.
              */
-            defaultImageUrl: string;
+            defaultVideoUrl?: string;
             /**
-             * One entry per placement group you want to pin a specific image to.
+             * Video mode (optional). Poster image for the default video; Meta auto-generates one when omitted.
+             */
+            defaultThumbnailUrl?: string;
+            /**
+             * One entry per placement group you want to pin a specific asset to.
              */
             rules: Array<{
                 /**
-                 * The image to deliver for this rule's placements.
+                 * Image mode. The image to deliver for this rule's placements.
+                 */
+                imageUrl?: string;
+                /**
+                 * Video mode. The video to deliver for this rule's placements.
+                 */
+                videoUrl?: string;
+                /**
+                 * Video mode (optional). Poster image for this rule's video; auto-generated when omitted.
                  */
-                imageUrl: string;
+                thumbnailUrl?: string;
                 /**
-                 * Placements this image is pinned to. At least one field must be set (an empty rule is invalid — that role is served by defaultImageUrl). Same enums as the top-level `placements` object.
+                 * Placements this asset is pinned to. At least one field must be set (an empty rule is invalid — that role is served by the default asset). Same enums as the top-level `placements` object.
                  */
                 placements: {
                     publisherPlatforms?: Array<('facebook' | 'instagram' | 'threads' | 'messenger' | 'audience_network')>;
@@ -19089,9 +19106,13 @@ export type SearchAdTargetingError = (unknown | {
 export type EstimateAdReachData = {
     body: {
         /**
-         * Social account ID on the target ad platform.
+         * Zernio social account ID on the target ad platform (the estimate runs against its platform).
          */
         accountId: string;
+        /**
+         * Required. The platform ad-account ID the reach call runs against (Meta act_..., LinkedIn numeric sponsoredAccount ID, Pinterest ad-account ID, X account ID) - every backing reach API is scoped to one ad account. Get it from GET /v1/ads/accounts.
+         */
+        adAccountId: string;
         /**
          * The targeting spec to estimate. Same shape used by POST /v1/ads/create.
          */