@zernio/node 0.2.750 → 0.2.752

package/dist/index.d.mts

@@ -36673,7 +36673,7 @@ type CreateStandaloneAdData = {
          */
         multiAdvertiser?: 'OPT_IN' | 'OPT_OUT';
         /**
-         * Google Performance Max validates the complete atomic campaign and asset group with no resource creation or local persistence. Google validation still downloads image URLs and consumes quota. On Meta, validates the complete inline campaign, ad set, creative and ad with execution_options validate_only. Nothing is uploaded or created, and validation bypasses Idempotency-Key storage. Supports a single image, existing video.id or existingCreativeId; media pools, new video uploads, creatives[], adSetId and RESERVED buying return 400. Existing campaign or creative nodes are marked skipped. Success returns 200 with per-node results; Meta rejection returns an error.
+         * Google Performance Max validates the complete atomic campaign and asset group with no resource creation or local persistence. Google validation still downloads image URLs and consumes quota. On Meta, validates the complete inline campaign, ad set, creative and ad with execution_options validate_only. Nothing is uploaded or created, and validation bypasses Idempotency-Key storage. Supports a single image, all-image placementAssets with per-rule copy, existing video.id or existingCreativeId; other media pools, new video uploads, creatives[], adSetId and RESERVED buying return 400. Placement validation uses existing Instagram identities only. Existing campaign or creative nodes are marked skipped. Success returns 200 with per-node results; Meta rejection returns an error.
          */
         validateOnly?: boolean;
         /**
@@ -36699,6 +36699,10 @@ type CreateStandaloneAdData = {
          * - `campaign`: CBO (Campaign Budget Optimization / Advantage Campaign Budget). The
          * budget AND `bidStrategy` are set on the CAMPAIGN, and Meta distributes spend
          * across ad sets automatically.
+         * The returned ad stores the applied `budgetLevel` and budget in `campaignBudget`
+         * for CBO or `adSetBudget` for ABO. Edit CBO budgets with
+         * `PUT /v1/ads/campaigns/{campaignId}` and ABO budgets with
+         * `PUT /v1/ads/ad-sets/{adSetId}`.
          * Meta requires the budget at exactly one level, never both. Non-Meta platforms ignore
          * this field. Ignored on the attach shape (`adSetId`), which inherits the existing budget.
          *
@@ -36733,7 +36737,7 @@ type CreateStandaloneAdData = {
          * `body` field is used as the `object_story_spec.link_data.message` (the preview text) and
          * `headlines` must also be present. On a video creative the copy lands in
          * `video_data.message` / `video_data.title` instead of `link_data`. Mutually exclusive
-         * with `dynamicCreative`, `placementAssets`, `carouselCards`, and `creatives[]`.
+         * with `dynamicCreative`, `placementAssets`, `carouselCards`, and `creatives[]`. For placement-specific copy, use the singular `placementAssets.rules[].body` and `headline` fields instead.
          *
          */
         bodies?: Array<(string)>;
@@ -37316,15 +37320,19 @@ type CreateStandaloneAdData = {
          * on the legacy single shape AND the attach shape (`adSetId` + placementAssets adds one
          * placement-customized ad to an existing ad set, the way to build N per-placement ads
          * sharing one ad set: create the first normally, attach the rest). Cannot be combined
-         * with `creatives[]`. 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
+         * with `creatives[]` or top-level `bodies`/`headlines`/`descriptions` arrays. Each rule
+         * can override `headline`, `body` and `description` with one string per field. Omitted
+         * fields and unmatched placements use the top-level copy; `linkUrl` and `callToAction`
+         * remain shared. Zernio emits labelled text with `optimization_type: PLACEMENT`.
+         * Multiple text options rotating within a placement are not supported by this input. Each rule's `placements` accepts the same fields as the top-level
          * `placements` object; Meta enforces co-selection rules and returns an actionable error.
          *
-         * Note on text rendering: Meta suppresses primary text and headline on fullscreen
-         * placements (Stories and Reels) in actual ad delivery; the fields are accepted and
-         * the ad publishes, but the copy is not shown to users. For visible copy on those
-         * placements, bake the text into the creative image or video itself.
+         * Meta controls text rendering by placement and format. Validation accepts these fields
+         * but does not prove that every field appears in delivery. Preview the ad; put copy that
+         * must always be visible into the image or video itself.
+         *
+         * `validateOnly: true` supports all-image placementAssets without uploading or creating
+         * anything. Video placement validation remains unsupported because it requires uploads.
          *
          * 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:
@@ -37361,6 +37369,18 @@ type CreateStandaloneAdData = {
                  * Video mode (optional). Poster image for this rule's video; auto-generated when omitted.
                  */
                 thumbnailUrl?: string;
+                /**
+                 * One headline pinned to this rule. Omit to inherit the top-level headline.
+                 */
+                headline?: string;
+                /**
+                 * One primary text pinned to this rule. Omit to inherit the top-level body.
+                 */
+                body?: string;
+                /**
+                 * One link description pinned to this rule. Omit to inherit the top-level description.
+                 */
+                description?: 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.
                  */

package/dist/index.d.ts

@@ -36673,7 +36673,7 @@ type CreateStandaloneAdData = {
          */
         multiAdvertiser?: 'OPT_IN' | 'OPT_OUT';
         /**
-         * Google Performance Max validates the complete atomic campaign and asset group with no resource creation or local persistence. Google validation still downloads image URLs and consumes quota. On Meta, validates the complete inline campaign, ad set, creative and ad with execution_options validate_only. Nothing is uploaded or created, and validation bypasses Idempotency-Key storage. Supports a single image, existing video.id or existingCreativeId; media pools, new video uploads, creatives[], adSetId and RESERVED buying return 400. Existing campaign or creative nodes are marked skipped. Success returns 200 with per-node results; Meta rejection returns an error.
+         * Google Performance Max validates the complete atomic campaign and asset group with no resource creation or local persistence. Google validation still downloads image URLs and consumes quota. On Meta, validates the complete inline campaign, ad set, creative and ad with execution_options validate_only. Nothing is uploaded or created, and validation bypasses Idempotency-Key storage. Supports a single image, all-image placementAssets with per-rule copy, existing video.id or existingCreativeId; other media pools, new video uploads, creatives[], adSetId and RESERVED buying return 400. Placement validation uses existing Instagram identities only. Existing campaign or creative nodes are marked skipped. Success returns 200 with per-node results; Meta rejection returns an error.
          */
         validateOnly?: boolean;
         /**
@@ -36699,6 +36699,10 @@ type CreateStandaloneAdData = {
          * - `campaign`: CBO (Campaign Budget Optimization / Advantage Campaign Budget). The
          * budget AND `bidStrategy` are set on the CAMPAIGN, and Meta distributes spend
          * across ad sets automatically.
+         * The returned ad stores the applied `budgetLevel` and budget in `campaignBudget`
+         * for CBO or `adSetBudget` for ABO. Edit CBO budgets with
+         * `PUT /v1/ads/campaigns/{campaignId}` and ABO budgets with
+         * `PUT /v1/ads/ad-sets/{adSetId}`.
          * Meta requires the budget at exactly one level, never both. Non-Meta platforms ignore
          * this field. Ignored on the attach shape (`adSetId`), which inherits the existing budget.
          *
@@ -36733,7 +36737,7 @@ type CreateStandaloneAdData = {
          * `body` field is used as the `object_story_spec.link_data.message` (the preview text) and
          * `headlines` must also be present. On a video creative the copy lands in
          * `video_data.message` / `video_data.title` instead of `link_data`. Mutually exclusive
-         * with `dynamicCreative`, `placementAssets`, `carouselCards`, and `creatives[]`.
+         * with `dynamicCreative`, `placementAssets`, `carouselCards`, and `creatives[]`. For placement-specific copy, use the singular `placementAssets.rules[].body` and `headline` fields instead.
          *
          */
         bodies?: Array<(string)>;
@@ -37316,15 +37320,19 @@ type CreateStandaloneAdData = {
          * on the legacy single shape AND the attach shape (`adSetId` + placementAssets adds one
          * placement-customized ad to an existing ad set, the way to build N per-placement ads
          * sharing one ad set: create the first normally, attach the rest). Cannot be combined
-         * with `creatives[]`. 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
+         * with `creatives[]` or top-level `bodies`/`headlines`/`descriptions` arrays. Each rule
+         * can override `headline`, `body` and `description` with one string per field. Omitted
+         * fields and unmatched placements use the top-level copy; `linkUrl` and `callToAction`
+         * remain shared. Zernio emits labelled text with `optimization_type: PLACEMENT`.
+         * Multiple text options rotating within a placement are not supported by this input. Each rule's `placements` accepts the same fields as the top-level
          * `placements` object; Meta enforces co-selection rules and returns an actionable error.
          *
-         * Note on text rendering: Meta suppresses primary text and headline on fullscreen
-         * placements (Stories and Reels) in actual ad delivery; the fields are accepted and
-         * the ad publishes, but the copy is not shown to users. For visible copy on those
-         * placements, bake the text into the creative image or video itself.
+         * Meta controls text rendering by placement and format. Validation accepts these fields
+         * but does not prove that every field appears in delivery. Preview the ad; put copy that
+         * must always be visible into the image or video itself.
+         *
+         * `validateOnly: true` supports all-image placementAssets without uploading or creating
+         * anything. Video placement validation remains unsupported because it requires uploads.
          *
          * 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:
@@ -37361,6 +37369,18 @@ type CreateStandaloneAdData = {
                  * Video mode (optional). Poster image for this rule's video; auto-generated when omitted.
                  */
                 thumbnailUrl?: string;
+                /**
+                 * One headline pinned to this rule. Omit to inherit the top-level headline.
+                 */
+                headline?: string;
+                /**
+                 * One primary text pinned to this rule. Omit to inherit the top-level body.
+                 */
+                body?: string;
+                /**
+                 * One link description pinned to this rule. Omit to inherit the top-level description.
+                 */
+                description?: 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.
                  */

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -8196,6 +8196,10 @@ export const getCampaignBidding = <ThrowOnError extends boolean = false>(options
  * | `platformSpecificData.spendCap` | Yes | 400 | 400 |
  * | `accountId` (empty campaigns) | Yes | - | - |
  *
+ * Meta budget edits check the live campaign budget, so an older local ABO stamp
+ * cannot block a CBO campaign. A successful edit repairs local ad budget fields.
+ * A live ABO campaign still returns 409 with the ad-set budget endpoint.
+ *
  * On Google: `LOWEST_COST_WITHOUT_CAP` = Maximize Conversions, `COST_CAP` +
  * `bidAmount` = Target CPA, `LOWEST_COST_WITH_MIN_ROAS` + `roasAverageFloor` =
  * Target ROAS, `LOWEST_COST_WITH_BID_CAP` + `bidAmount` = Maximize Clicks with a

package/src/generated/types.gen.ts

@@ -37282,7 +37282,7 @@ export type CreateStandaloneAdData = {
          */
         multiAdvertiser?: 'OPT_IN' | 'OPT_OUT';
         /**
-         * Google Performance Max validates the complete atomic campaign and asset group with no resource creation or local persistence. Google validation still downloads image URLs and consumes quota. On Meta, validates the complete inline campaign, ad set, creative and ad with execution_options validate_only. Nothing is uploaded or created, and validation bypasses Idempotency-Key storage. Supports a single image, existing video.id or existingCreativeId; media pools, new video uploads, creatives[], adSetId and RESERVED buying return 400. Existing campaign or creative nodes are marked skipped. Success returns 200 with per-node results; Meta rejection returns an error.
+         * Google Performance Max validates the complete atomic campaign and asset group with no resource creation or local persistence. Google validation still downloads image URLs and consumes quota. On Meta, validates the complete inline campaign, ad set, creative and ad with execution_options validate_only. Nothing is uploaded or created, and validation bypasses Idempotency-Key storage. Supports a single image, all-image placementAssets with per-rule copy, existing video.id or existingCreativeId; other media pools, new video uploads, creatives[], adSetId and RESERVED buying return 400. Placement validation uses existing Instagram identities only. Existing campaign or creative nodes are marked skipped. Success returns 200 with per-node results; Meta rejection returns an error.
          */
         validateOnly?: boolean;
         /**
@@ -37308,6 +37308,10 @@ export type CreateStandaloneAdData = {
          * - `campaign`: CBO (Campaign Budget Optimization / Advantage Campaign Budget). The
          * budget AND `bidStrategy` are set on the CAMPAIGN, and Meta distributes spend
          * across ad sets automatically.
+         * The returned ad stores the applied `budgetLevel` and budget in `campaignBudget`
+         * for CBO or `adSetBudget` for ABO. Edit CBO budgets with
+         * `PUT /v1/ads/campaigns/{campaignId}` and ABO budgets with
+         * `PUT /v1/ads/ad-sets/{adSetId}`.
          * Meta requires the budget at exactly one level, never both. Non-Meta platforms ignore
          * this field. Ignored on the attach shape (`adSetId`), which inherits the existing budget.
          *
@@ -37342,7 +37346,7 @@ export type CreateStandaloneAdData = {
          * `body` field is used as the `object_story_spec.link_data.message` (the preview text) and
          * `headlines` must also be present. On a video creative the copy lands in
          * `video_data.message` / `video_data.title` instead of `link_data`. Mutually exclusive
-         * with `dynamicCreative`, `placementAssets`, `carouselCards`, and `creatives[]`.
+         * with `dynamicCreative`, `placementAssets`, `carouselCards`, and `creatives[]`. For placement-specific copy, use the singular `placementAssets.rules[].body` and `headline` fields instead.
          *
          */
         bodies?: Array<(string)>;
@@ -37925,15 +37929,19 @@ export type CreateStandaloneAdData = {
          * on the legacy single shape AND the attach shape (`adSetId` + placementAssets adds one
          * placement-customized ad to an existing ad set, the way to build N per-placement ads
          * sharing one ad set: create the first normally, attach the rest). Cannot be combined
-         * with `creatives[]`. 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
+         * with `creatives[]` or top-level `bodies`/`headlines`/`descriptions` arrays. Each rule
+         * can override `headline`, `body` and `description` with one string per field. Omitted
+         * fields and unmatched placements use the top-level copy; `linkUrl` and `callToAction`
+         * remain shared. Zernio emits labelled text with `optimization_type: PLACEMENT`.
+         * Multiple text options rotating within a placement are not supported by this input. Each rule's `placements` accepts the same fields as the top-level
          * `placements` object; Meta enforces co-selection rules and returns an actionable error.
          *
-         * Note on text rendering: Meta suppresses primary text and headline on fullscreen
-         * placements (Stories and Reels) in actual ad delivery; the fields are accepted and
-         * the ad publishes, but the copy is not shown to users. For visible copy on those
-         * placements, bake the text into the creative image or video itself.
+         * Meta controls text rendering by placement and format. Validation accepts these fields
+         * but does not prove that every field appears in delivery. Preview the ad; put copy that
+         * must always be visible into the image or video itself.
+         *
+         * `validateOnly: true` supports all-image placementAssets without uploading or creating
+         * anything. Video placement validation remains unsupported because it requires uploads.
          *
          * 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:
@@ -37970,6 +37978,18 @@ export type CreateStandaloneAdData = {
                  * Video mode (optional). Poster image for this rule's video; auto-generated when omitted.
                  */
                 thumbnailUrl?: string;
+                /**
+                 * One headline pinned to this rule. Omit to inherit the top-level headline.
+                 */
+                headline?: string;
+                /**
+                 * One primary text pinned to this rule. Omit to inherit the top-level body.
+                 */
+                body?: string;
+                /**
+                 * One link description pinned to this rule. Omit to inherit the top-level description.
+                 */
+                description?: 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.
                  */