@zernio/node 0.2.102 → 0.2.104

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
@@ -4726,6 +4730,10 @@ type GetDailyMetricsError = ({
 });
 type GetBestTimeToPostData = {
     query?: {
+        /**
+         * Filter by social account ID. Omit for all accounts.
+         */
+        accountId?: string;
         /**
          * Filter by platform (e.g. "instagram", "tiktok"). Omit for all platforms.
          */
@@ -4768,6 +4776,10 @@ type GetBestTimeToPostError = ({
 });
 type GetContentDecayData = {
     query?: {
+        /**
+         * Filter by social account ID. Omit for all accounts.
+         */
+        accountId?: string;
         /**
          * Filter by platform (e.g. "instagram", "tiktok"). Omit for all platforms.
          */
@@ -4810,6 +4822,10 @@ type GetContentDecayError = ({
 });
 type GetPostingFrequencyData = {
     query?: {
+        /**
+         * Filter by social account ID. Omit for all accounts.
+         */
+        accountId?: string;
         /**
          * Filter by platform (e.g. "instagram", "tiktok"). Omit for all platforms.
          */
@@ -12930,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.

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
@@ -4726,6 +4730,10 @@ type GetDailyMetricsError = ({
 });
 type GetBestTimeToPostData = {
     query?: {
+        /**
+         * Filter by social account ID. Omit for all accounts.
+         */
+        accountId?: string;
         /**
          * Filter by platform (e.g. "instagram", "tiktok"). Omit for all platforms.
          */
@@ -4768,6 +4776,10 @@ type GetBestTimeToPostError = ({
 });
 type GetContentDecayData = {
     query?: {
+        /**
+         * Filter by social account ID. Omit for all accounts.
+         */
+        accountId?: string;
         /**
          * Filter by platform (e.g. "instagram", "tiktok"). Omit for all platforms.
          */
@@ -4810,6 +4822,10 @@ type GetContentDecayError = ({
 });
 type GetPostingFrequencyData = {
     query?: {
+        /**
+         * Filter by social account ID. Omit for all accounts.
+         */
+        accountId?: string;
         /**
          * Filter by platform (e.g. "instagram", "tiktok"). Omit for all platforms.
          */
@@ -12930,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.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zernio/node",
-  "version": "0.2.102",
+  "version": "0.2.104",
   "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;
 };
 
 /**
@@ -4342,6 +4346,10 @@ export type GetDailyMetricsError = ({
 
 export type GetBestTimeToPostData = {
     query?: {
+        /**
+         * Filter by social account ID. Omit for all accounts.
+         */
+        accountId?: string;
         /**
          * Filter by platform (e.g. "instagram", "tiktok"). Omit for all platforms.
          */
@@ -4387,6 +4395,10 @@ export type GetBestTimeToPostError = ({
 
 export type GetContentDecayData = {
     query?: {
+        /**
+         * Filter by social account ID. Omit for all accounts.
+         */
+        accountId?: string;
         /**
          * Filter by platform (e.g. "instagram", "tiktok"). Omit for all platforms.
          */
@@ -4432,6 +4444,10 @@ export type GetContentDecayError = ({
 
 export type GetPostingFrequencyData = {
     query?: {
+        /**
+         * Filter by social account ID. Omit for all accounts.
+         */
+        accountId?: string;
         /**
          * Filter by platform (e.g. "instagram", "tiktok"). Omit for all platforms.
          */
@@ -13261,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.