@zernio/node 0.2.1509 → 0.2.1511

package/dist/index.d.mts

@@ -52141,9 +52141,9 @@ type ListAdCampaignsData = {
          */
         source?: 'zernio' | 'all';
         /**
-         * Filter by derived campaign status (post-aggregation)
+         * Filter by derived campaign status (post-aggregation). `not_deleted` keeps every status except `cancelled`.
          */
-        status?: AdStatus;
+        status?: (AdStatus | 'not_deleted');
         /**
          * End of metrics date range (YYYY-MM-DD, inclusive). Defaults to today. Max 730-day range.
          */
@@ -54052,9 +54052,9 @@ type GetAdTreeData = {
          */
         source?: 'zernio' | 'all';
         /**
-         * Filter by derived campaign status (post-aggregation)
+         * Filter by derived campaign status (post-aggregation). `not_deleted` keeps every status except `cancelled`.
          */
-        status?: AdStatus;
+        status?: (AdStatus | 'not_deleted');
         /**
          * Set to `1` to also return a daily breakdown (mirrors Meta Insights' `time_increment=1`). Only `1` (daily) is supported. See `dailyLevel` to control which levels carry it.
          *
@@ -57133,6 +57133,14 @@ type CreateAdCreativeData = {
             description?: string;
             callToAction?: string;
         }>;
+        /**
+         * Meta only. The Instagram account the creative runs as, mapped to `instagram_user_id`: an id from `GET /v1/ads/instagram-accounts`, including a Page-backed one.
+         *
+         * - Given, it is never swapped. One the ad account cannot use returns 400 `insufficient_permissions` on `instagramAccountId`.
+         * - Omitted, it uses the account linked to the Page. When the ad account has no access to that one, it retries once with an authorized Instagram account, or returns 422 on `instagramAccountId` when there is none.
+         *
+         */
+        instagramAccountId?: string;
         /**
          * Only with `carouselCards` (a 400 without them). Sets `link_data.multi_share_optimized`:
          *
@@ -59883,7 +59891,7 @@ type CreateStandaloneAdData = {
          */
         adSetName?: string;
         /**
-         * Meta only. Exact ad name (the single-creative ad object's name). Overrides the default, which is `name`. (For per-ad names on the multi-creative shape, set `name` on each `creatives[]` entry instead.)
+         * Meta only. Exact ad name, overriding the default `name`. On the multi-creative shape it names every ad, numbered `#1`, `#2`... when there are several, unless a `creatives[]` entry sets its own `name`.
          */
         adName?: string;
         tracking?: AdTracking;

package/dist/index.d.ts

@@ -52141,9 +52141,9 @@ type ListAdCampaignsData = {
          */
         source?: 'zernio' | 'all';
         /**
-         * Filter by derived campaign status (post-aggregation)
+         * Filter by derived campaign status (post-aggregation). `not_deleted` keeps every status except `cancelled`.
          */
-        status?: AdStatus;
+        status?: (AdStatus | 'not_deleted');
         /**
          * End of metrics date range (YYYY-MM-DD, inclusive). Defaults to today. Max 730-day range.
          */
@@ -54052,9 +54052,9 @@ type GetAdTreeData = {
          */
         source?: 'zernio' | 'all';
         /**
-         * Filter by derived campaign status (post-aggregation)
+         * Filter by derived campaign status (post-aggregation). `not_deleted` keeps every status except `cancelled`.
          */
-        status?: AdStatus;
+        status?: (AdStatus | 'not_deleted');
         /**
          * Set to `1` to also return a daily breakdown (mirrors Meta Insights' `time_increment=1`). Only `1` (daily) is supported. See `dailyLevel` to control which levels carry it.
          *
@@ -57133,6 +57133,14 @@ type CreateAdCreativeData = {
             description?: string;
             callToAction?: string;
         }>;
+        /**
+         * Meta only. The Instagram account the creative runs as, mapped to `instagram_user_id`: an id from `GET /v1/ads/instagram-accounts`, including a Page-backed one.
+         *
+         * - Given, it is never swapped. One the ad account cannot use returns 400 `insufficient_permissions` on `instagramAccountId`.
+         * - Omitted, it uses the account linked to the Page. When the ad account has no access to that one, it retries once with an authorized Instagram account, or returns 422 on `instagramAccountId` when there is none.
+         *
+         */
+        instagramAccountId?: string;
         /**
          * Only with `carouselCards` (a 400 without them). Sets `link_data.multi_share_optimized`:
          *
@@ -59883,7 +59891,7 @@ type CreateStandaloneAdData = {
          */
         adSetName?: string;
         /**
-         * Meta only. Exact ad name (the single-creative ad object's name). Overrides the default, which is `name`. (For per-ad names on the multi-creative shape, set `name` on each `creatives[]` entry instead.)
+         * Meta only. Exact ad name, overriding the default `name`. On the multi-creative shape it names every ad, numbered `#1`, `#2`... when there are several, unless a `creatives[]` entry sets its own `name`.
          */
         adName?: string;
         tracking?: AdTracking;

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -13691,7 +13691,7 @@ export const updateAdSetStatus = <ThrowOnError extends boolean = false>(options:
  *
  * Deleting an ad or a campaign is a soft delete: the Ad documents move to `status: cancelled` and are kept indefinitely. Their historical spend still counts toward the metrics of any date range they fall in. There is no pruning job and no retention window.
  *
- * Filter on `status` if your view should hide them, but do that after reading the totals, not before.
+ * Pass `status=not_deleted` if your view should hide them, but do that after reading the totals, not before.
  *
  */
 export const getAdTree = <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<GetAdTreeData, ThrowOnError>) => {
@@ -15399,7 +15399,7 @@ export const listAdCreatives = <ThrowOnError extends boolean = false>(options: O
  *
  * ### Other fields
  *
- * - The Page (and linked Instagram account, when present) is resolved from `accountId` as the story actor.
+ * - The Page (and linked Instagram account, when present) is resolved from `accountId` as the story actor. `instagramAccountId` overrides the Instagram account.
  * - `creativeFeatures` configures Advantage+ enhancements.
  * - `promotion` is not supported and any object is rejected with 400.
  *

package/src/generated/types.gen.ts

@@ -52938,9 +52938,9 @@ export type ListAdCampaignsData = {
          */
         source?: 'zernio' | 'all';
         /**
-         * Filter by derived campaign status (post-aggregation)
+         * Filter by derived campaign status (post-aggregation). `not_deleted` keeps every status except `cancelled`.
          */
-        status?: AdStatus;
+        status?: (AdStatus | 'not_deleted');
         /**
          * End of metrics date range (YYYY-MM-DD, inclusive). Defaults to today. Max 730-day range.
          */
@@ -54921,9 +54921,9 @@ export type GetAdTreeData = {
          */
         source?: 'zernio' | 'all';
         /**
-         * Filter by derived campaign status (post-aggregation)
+         * Filter by derived campaign status (post-aggregation). `not_deleted` keeps every status except `cancelled`.
          */
-        status?: AdStatus;
+        status?: (AdStatus | 'not_deleted');
         /**
          * Set to `1` to also return a daily breakdown (mirrors Meta Insights' `time_increment=1`). Only `1` (daily) is supported. See `dailyLevel` to control which levels carry it.
          *
@@ -58191,6 +58191,14 @@ export type CreateAdCreativeData = {
             description?: string;
             callToAction?: string;
         }>;
+        /**
+         * Meta only. The Instagram account the creative runs as, mapped to `instagram_user_id`: an id from `GET /v1/ads/instagram-accounts`, including a Page-backed one.
+         *
+         * - Given, it is never swapped. One the ad account cannot use returns 400 `insufficient_permissions` on `instagramAccountId`.
+         * - Omitted, it uses the account linked to the Page. When the ad account has no access to that one, it retries once with an authorized Instagram account, or returns 422 on `instagramAccountId` when there is none.
+         *
+         */
+        instagramAccountId?: string;
         /**
          * Only with `carouselCards` (a 400 without them). Sets `link_data.multi_share_optimized`:
          *
@@ -61115,7 +61123,7 @@ export type CreateStandaloneAdData = {
          */
         adSetName?: string;
         /**
-         * Meta only. Exact ad name (the single-creative ad object's name). Overrides the default, which is `name`. (For per-ad names on the multi-creative shape, set `name` on each `creatives[]` entry instead.)
+         * Meta only. Exact ad name, overriding the default `name`. On the multi-creative shape it names every ad, numbered `#1`, `#2`... when there are several, unless a `creatives[]` entry sets its own `name`.
          */
         adName?: string;
         tracking?: AdTracking;