@zernio/node 0.2.266 → 0.2.268

package/dist/index.d.mts

@@ -19155,9 +19155,22 @@ type CreateStandaloneAdData = {
          */
         budgetType?: 'daily' | 'lifetime';
         /**
-         * Meta only. Publish state of the created ad set + ad. Omitted or ACTIVE publishes live (default, back-compat); PAUSED creates them paused and skips activation, so you can review before they spend.
+         * Meta only. Desired publish state of the ad (and, on the legacy/multi-ad-set shapes, the ad set too).
+         * Omitted or `ACTIVE` publishes live immediately (default). `PAUSED` creates the objects paused and skips
+         * activation — useful to stage ads before they spend. On the attach shape (`adSetId`), only the new ad is
+         * affected; the existing ad set and campaign are already live and are not touched.
+         *
          */
         status?: 'ACTIVE' | 'PAUSED';
+        /**
+         * Meta only. Independent publish state for the CAMPAIGN when the create makes both a new campaign and a
+         * new ad set (legacy shape). When omitted, the campaign follows `status`. Use this to stage a paused
+         * campaign with an active ad set (`status: ACTIVE, campaignStatus: PAUSED`) — the ad set will start
+         * delivering as soon as the campaign is activated later. Ignored when `existingCampaignId` is set (the
+         * campaign is already live and its status is not changed).
+         *
+         */
+        campaignStatus?: 'ACTIVE' | 'PAUSED';
         /**
          * Meta only. Where the budget lives, which selects the Meta budget model:
          * - `adset` (default): ABO (Ad-set Budget Optimization). The budget is set on the
@@ -19302,11 +19315,16 @@ type CreateStandaloneAdData = {
         /**
          * Meta only. Reuse an EXISTING ad creative by id instead of
          * building a new one from the copy/media fields (which are then
-         * ignored). Combine with `existingCampaignId` to build a
-         * multi-ad-set campaign that shares one creative. Mutually
-         * exclusive with `creatives[]`, `dynamicCreative`, and
-         * `placementAssets`. The creative id used is returned as
-         * `creativeId` on the create response.
+         * ignored). Works on both shapes:
+         * - Legacy/multi-ad-set (`existingCampaignId`): combine with
+         * `existingCampaignId` to build a multi-ad-set campaign that
+         * shares one creative across audiences.
+         * - Attach (`adSetId`): combine with `adSetId` to add a second
+         * (or Nth) ad to an existing ad set reusing the same creative —
+         * no `headline`/`body`/`imageUrl` required on the body.
+         * Mutually exclusive with `creatives[]`, `dynamicCreative`, and
+         * `placementAssets`. The creative id is returned as `creativeId`
+         * on the create response.
          *
          */
         existingCreativeId?: string;
@@ -19537,6 +19555,11 @@ type CreateStandaloneAdData = {
          * 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.
          *
+         * 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.
+         *
          * 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`

package/dist/index.d.ts

@@ -19155,9 +19155,22 @@ type CreateStandaloneAdData = {
          */
         budgetType?: 'daily' | 'lifetime';
         /**
-         * Meta only. Publish state of the created ad set + ad. Omitted or ACTIVE publishes live (default, back-compat); PAUSED creates them paused and skips activation, so you can review before they spend.
+         * Meta only. Desired publish state of the ad (and, on the legacy/multi-ad-set shapes, the ad set too).
+         * Omitted or `ACTIVE` publishes live immediately (default). `PAUSED` creates the objects paused and skips
+         * activation — useful to stage ads before they spend. On the attach shape (`adSetId`), only the new ad is
+         * affected; the existing ad set and campaign are already live and are not touched.
+         *
          */
         status?: 'ACTIVE' | 'PAUSED';
+        /**
+         * Meta only. Independent publish state for the CAMPAIGN when the create makes both a new campaign and a
+         * new ad set (legacy shape). When omitted, the campaign follows `status`. Use this to stage a paused
+         * campaign with an active ad set (`status: ACTIVE, campaignStatus: PAUSED`) — the ad set will start
+         * delivering as soon as the campaign is activated later. Ignored when `existingCampaignId` is set (the
+         * campaign is already live and its status is not changed).
+         *
+         */
+        campaignStatus?: 'ACTIVE' | 'PAUSED';
         /**
          * Meta only. Where the budget lives, which selects the Meta budget model:
          * - `adset` (default): ABO (Ad-set Budget Optimization). The budget is set on the
@@ -19302,11 +19315,16 @@ type CreateStandaloneAdData = {
         /**
          * Meta only. Reuse an EXISTING ad creative by id instead of
          * building a new one from the copy/media fields (which are then
-         * ignored). Combine with `existingCampaignId` to build a
-         * multi-ad-set campaign that shares one creative. Mutually
-         * exclusive with `creatives[]`, `dynamicCreative`, and
-         * `placementAssets`. The creative id used is returned as
-         * `creativeId` on the create response.
+         * ignored). Works on both shapes:
+         * - Legacy/multi-ad-set (`existingCampaignId`): combine with
+         * `existingCampaignId` to build a multi-ad-set campaign that
+         * shares one creative across audiences.
+         * - Attach (`adSetId`): combine with `adSetId` to add a second
+         * (or Nth) ad to an existing ad set reusing the same creative —
+         * no `headline`/`body`/`imageUrl` required on the body.
+         * Mutually exclusive with `creatives[]`, `dynamicCreative`, and
+         * `placementAssets`. The creative id is returned as `creativeId`
+         * on the create response.
          *
          */
         existingCreativeId?: string;
@@ -19537,6 +19555,11 @@ type CreateStandaloneAdData = {
          * 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.
          *
+         * 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.
+         *
          * 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`

package/dist/index.js

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

package/src/generated/types.gen.ts

@@ -19660,9 +19660,22 @@ export type CreateStandaloneAdData = {
          */
         budgetType?: 'daily' | 'lifetime';
         /**
-         * Meta only. Publish state of the created ad set + ad. Omitted or ACTIVE publishes live (default, back-compat); PAUSED creates them paused and skips activation, so you can review before they spend.
+         * Meta only. Desired publish state of the ad (and, on the legacy/multi-ad-set shapes, the ad set too).
+         * Omitted or `ACTIVE` publishes live immediately (default). `PAUSED` creates the objects paused and skips
+         * activation — useful to stage ads before they spend. On the attach shape (`adSetId`), only the new ad is
+         * affected; the existing ad set and campaign are already live and are not touched.
+         *
          */
         status?: 'ACTIVE' | 'PAUSED';
+        /**
+         * Meta only. Independent publish state for the CAMPAIGN when the create makes both a new campaign and a
+         * new ad set (legacy shape). When omitted, the campaign follows `status`. Use this to stage a paused
+         * campaign with an active ad set (`status: ACTIVE, campaignStatus: PAUSED`) — the ad set will start
+         * delivering as soon as the campaign is activated later. Ignored when `existingCampaignId` is set (the
+         * campaign is already live and its status is not changed).
+         *
+         */
+        campaignStatus?: 'ACTIVE' | 'PAUSED';
         /**
          * Meta only. Where the budget lives, which selects the Meta budget model:
          * - `adset` (default): ABO (Ad-set Budget Optimization). The budget is set on the
@@ -19807,11 +19820,16 @@ export type CreateStandaloneAdData = {
         /**
          * Meta only. Reuse an EXISTING ad creative by id instead of
          * building a new one from the copy/media fields (which are then
-         * ignored). Combine with `existingCampaignId` to build a
-         * multi-ad-set campaign that shares one creative. Mutually
-         * exclusive with `creatives[]`, `dynamicCreative`, and
-         * `placementAssets`. The creative id used is returned as
-         * `creativeId` on the create response.
+         * ignored). Works on both shapes:
+         * - Legacy/multi-ad-set (`existingCampaignId`): combine with
+         * `existingCampaignId` to build a multi-ad-set campaign that
+         * shares one creative across audiences.
+         * - Attach (`adSetId`): combine with `adSetId` to add a second
+         * (or Nth) ad to an existing ad set reusing the same creative —
+         * no `headline`/`body`/`imageUrl` required on the body.
+         * Mutually exclusive with `creatives[]`, `dynamicCreative`, and
+         * `placementAssets`. The creative id is returned as `creativeId`
+         * on the create response.
          *
          */
         existingCreativeId?: string;
@@ -20042,6 +20060,11 @@ export type CreateStandaloneAdData = {
          * 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.
          *
+         * 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.
+         *
          * 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`