@zernio/node 0.2.267 → 0.2.269

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;
@@ -19418,6 +19436,10 @@ type CreateStandaloneAdData = {
          * additionally enforces co-selection rules (e.g. some positions require their parent
          * publisher platform) and returns an actionable error which we surface. Non-Meta
          * platforms reject this field.
+         * Mutually exclusive with `rawTargeting` — sending both returns a 422. If you need
+         * manual placements alongside raw targeting, include `publisher_platforms`,
+         * `facebook_positions`, `instagram_positions`, etc. directly inside the `rawTargeting`
+         * object using Meta's snake_case field names.
          *
          */
         placements?: {
@@ -19449,9 +19471,11 @@ type CreateStandaloneAdData = {
          * business places, etc.) — exactly the shape `GET /v1/ads/{adId}` returns for external ads. Use it to
          * clone a campaign's targeting EXACTLY, preserving advanced fields the camelCase targeting fields can't
          * model. Mutually exclusive with the camelCase targeting fields (countries/regions/cities/interests/
-         * ageMin/...), `audienceId`, and `savedTargetingId` (sending both → 422). Sent as-is; Meta validates and
-         * surfaces any errors. If cloning an EU campaign, also pass `dsaBeneficiary` / `dsaPayor` (those are
-         * separate fields, not part of targeting).
+         * ageMin/.../placements), `audienceId`, and `savedTargetingId` (sending both → 422). Sent as-is; Meta
+         * validates and surfaces any errors. If cloning an EU campaign, also pass `dsaBeneficiary` / `dsaPayor`
+         * (those are separate fields, not part of targeting).
+         * To set manual placements alongside rawTargeting, include Meta's placement fields directly inside this
+         * object: `publisher_platforms`, `facebook_positions`, `instagram_positions`, etc.
          *
          */
         rawTargeting?: {

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;
@@ -19418,6 +19436,10 @@ type CreateStandaloneAdData = {
          * additionally enforces co-selection rules (e.g. some positions require their parent
          * publisher platform) and returns an actionable error which we surface. Non-Meta
          * platforms reject this field.
+         * Mutually exclusive with `rawTargeting` — sending both returns a 422. If you need
+         * manual placements alongside raw targeting, include `publisher_platforms`,
+         * `facebook_positions`, `instagram_positions`, etc. directly inside the `rawTargeting`
+         * object using Meta's snake_case field names.
          *
          */
         placements?: {
@@ -19449,9 +19471,11 @@ type CreateStandaloneAdData = {
          * business places, etc.) — exactly the shape `GET /v1/ads/{adId}` returns for external ads. Use it to
          * clone a campaign's targeting EXACTLY, preserving advanced fields the camelCase targeting fields can't
          * model. Mutually exclusive with the camelCase targeting fields (countries/regions/cities/interests/
-         * ageMin/...), `audienceId`, and `savedTargetingId` (sending both → 422). Sent as-is; Meta validates and
-         * surfaces any errors. If cloning an EU campaign, also pass `dsaBeneficiary` / `dsaPayor` (those are
-         * separate fields, not part of targeting).
+         * ageMin/.../placements), `audienceId`, and `savedTargetingId` (sending both → 422). Sent as-is; Meta
+         * validates and surfaces any errors. If cloning an EU campaign, also pass `dsaBeneficiary` / `dsaPayor`
+         * (those are separate fields, not part of targeting).
+         * To set manual placements alongside rawTargeting, include Meta's placement fields directly inside this
+         * object: `publisher_platforms`, `facebook_positions`, `instagram_positions`, etc.
          *
          */
         rawTargeting?: {

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@zernio/node",
-  version: "0.2.267",
+  version: "0.2.269",
   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.267",
+  version: "0.2.269",
   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.267",
+  "version": "0.2.269",
   "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;
@@ -19923,6 +19941,10 @@ export type CreateStandaloneAdData = {
          * additionally enforces co-selection rules (e.g. some positions require their parent
          * publisher platform) and returns an actionable error which we surface. Non-Meta
          * platforms reject this field.
+         * Mutually exclusive with `rawTargeting` — sending both returns a 422. If you need
+         * manual placements alongside raw targeting, include `publisher_platforms`,
+         * `facebook_positions`, `instagram_positions`, etc. directly inside the `rawTargeting`
+         * object using Meta's snake_case field names.
          *
          */
         placements?: {
@@ -19954,9 +19976,11 @@ export type CreateStandaloneAdData = {
          * business places, etc.) — exactly the shape `GET /v1/ads/{adId}` returns for external ads. Use it to
          * clone a campaign's targeting EXACTLY, preserving advanced fields the camelCase targeting fields can't
          * model. Mutually exclusive with the camelCase targeting fields (countries/regions/cities/interests/
-         * ageMin/...), `audienceId`, and `savedTargetingId` (sending both → 422). Sent as-is; Meta validates and
-         * surfaces any errors. If cloning an EU campaign, also pass `dsaBeneficiary` / `dsaPayor` (those are
-         * separate fields, not part of targeting).
+         * ageMin/.../placements), `audienceId`, and `savedTargetingId` (sending both → 422). Sent as-is; Meta
+         * validates and surfaces any errors. If cloning an EU campaign, also pass `dsaBeneficiary` / `dsaPayor`
+         * (those are separate fields, not part of targeting).
+         * To set manual placements alongside rawTargeting, include Meta's placement fields directly inside this
+         * object: `publisher_platforms`, `facebook_positions`, `instagram_positions`, etc.
          *
          */
         rawTargeting?: {