@zernio/node 0.2.103 → 0.2.105

package/dist/index.d.mts

@@ -1360,9 +1360,13 @@ type BusinessCenter = {
      */
     name?: string;
     /**
-     * Number of advertisers (ad accounts) reachable under this BC for the calling token
+     * Number of advertisers reachable under this BC for the calling token.
+     * `null` when the BC asset walk returned empty or failed (typical for
+     * agency apps without full BC asset read scope) — distinct from `0`,
+     * which would imply the BC genuinely has no advertisers.
+     *
      */
-    advertiserCount?: number;
+    advertiserCount?: (number) | null;
 };
 /**
  * A single conversion event to relay to the ad platform. All PII fields
@@ -12942,6 +12946,9 @@ type BoostPostData = {
         targeting?: {
             ageMin?: number;
             ageMax?: number;
+            /**
+             * ISO country codes. Required for TikTok boosts (TikTok's ad group requires location_ids); optional on other platforms.
+             */
             countries?: Array<(string)>;
             /**
              * Interest objects from /v1/ads/interests. Each must include id and name.
@@ -13068,7 +13075,7 @@ type CreateStandaloneAdData = {
          */
         body?: string;
         /**
-         * Required on legacy + attach shapes. Meta only.
+         * Required on legacy + attach shapes for Meta. Honoured on TikTok too — passes through to the Spark Ad creative's `call_to_action`. Ignored by other platforms.
          */
         callToAction?: 'LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'BOOK_TRAVEL' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'SUBSCRIBE' | 'WATCH_MORE';
         /**

package/dist/index.d.ts

@@ -1360,9 +1360,13 @@ type BusinessCenter = {
      */
     name?: string;
     /**
-     * Number of advertisers (ad accounts) reachable under this BC for the calling token
+     * Number of advertisers reachable under this BC for the calling token.
+     * `null` when the BC asset walk returned empty or failed (typical for
+     * agency apps without full BC asset read scope) — distinct from `0`,
+     * which would imply the BC genuinely has no advertisers.
+     *
      */
-    advertiserCount?: number;
+    advertiserCount?: (number) | null;
 };
 /**
  * A single conversion event to relay to the ad platform. All PII fields
@@ -12942,6 +12946,9 @@ type BoostPostData = {
         targeting?: {
             ageMin?: number;
             ageMax?: number;
+            /**
+             * ISO country codes. Required for TikTok boosts (TikTok's ad group requires location_ids); optional on other platforms.
+             */
             countries?: Array<(string)>;
             /**
              * Interest objects from /v1/ads/interests. Each must include id and name.
@@ -13068,7 +13075,7 @@ type CreateStandaloneAdData = {
          */
         body?: string;
         /**
-         * Required on legacy + attach shapes. Meta only.
+         * Required on legacy + attach shapes for Meta. Honoured on TikTok too — passes through to the Spark Ad creative's `call_to_action`. Ignored by other platforms.
          */
         callToAction?: 'LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'BOOK_TRAVEL' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'SUBSCRIBE' | 'WATCH_MORE';
         /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zernio/node",
-  "version": "0.2.103",
+  "version": "0.2.105",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/types.gen.ts

@@ -781,9 +781,13 @@ export type BusinessCenter = {
      */
     name?: string;
     /**
-     * Number of advertisers (ad accounts) reachable under this BC for the calling token
+     * Number of advertisers reachable under this BC for the calling token.
+     * `null` when the BC asset walk returned empty or failed (typical for
+     * agency apps without full BC asset read scope) — distinct from `0`,
+     * which would imply the BC genuinely has no advertisers.
+     *
      */
-    advertiserCount?: number;
+    advertiserCount?: (number) | null;
 };
 
 /**
@@ -13273,6 +13277,9 @@ export type BoostPostData = {
         targeting?: {
             ageMin?: number;
             ageMax?: number;
+            /**
+             * ISO country codes. Required for TikTok boosts (TikTok's ad group requires location_ids); optional on other platforms.
+             */
             countries?: Array<(string)>;
             /**
              * Interest objects from /v1/ads/interests. Each must include id and name.
@@ -13402,7 +13409,7 @@ export type CreateStandaloneAdData = {
          */
         body?: string;
         /**
-         * Required on legacy + attach shapes. Meta only.
+         * Required on legacy + attach shapes for Meta. Honoured on TikTok too — passes through to the Spark Ad creative's `call_to_action`. Ignored by other platforms.
          */
         callToAction?: 'LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'BOOK_TRAVEL' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'SUBSCRIBE' | 'WATCH_MORE';
         /**