@zernio/node 0.2.118 → 0.2.120

package/dist/index.d.mts

@@ -2876,9 +2876,9 @@ type SnapchatPlatformData = {
  */
 type contentType3 = 'story' | 'saved_story' | 'spotlight';
 type SocialAccount = {
-    _id?: string;
-    platform?: 'tiktok' | 'instagram' | 'facebook' | 'youtube' | 'linkedin' | 'twitter' | 'threads' | 'pinterest' | 'reddit' | 'bluesky' | 'googlebusiness' | 'telegram' | 'snapchat' | 'discord' | 'whatsapp' | 'linkedinads' | 'metaads' | 'pinterestads' | 'tiktokads' | 'xads' | 'googleads';
-    profileId?: (string | Profile);
+    _id: string;
+    platform: 'tiktok' | 'instagram' | 'facebook' | 'youtube' | 'linkedin' | 'twitter' | 'threads' | 'pinterest' | 'reddit' | 'bluesky' | 'googlebusiness' | 'telegram' | 'snapchat' | 'discord' | 'whatsapp' | 'linkedinads' | 'metaads' | 'pinterestads' | 'tiktokads' | 'xads' | 'googleads';
+    profileId: (string | Profile);
     username?: string;
     displayName?: string;
     /**
@@ -2889,7 +2889,7 @@ type SocialAccount = {
      * Full profile URL for the connected account on its platform.
      */
     profileUrl?: string;
-    isActive?: boolean;
+    isActive: boolean;
     /**
      * Follower count (only included if user has analytics add-on)
      */
@@ -5950,11 +5950,11 @@ type ListAccountsData = {
     };
 };
 type ListAccountsResponse = ({
-    accounts?: Array<SocialAccount>;
+    accounts: Array<SocialAccount>;
     /**
      * Whether user has analytics add-on access
      */
-    hasAnalyticsAccess?: boolean;
+    hasAnalyticsAccess: boolean;
     /**
      * Only present when page/limit params are provided
      */
@@ -12985,7 +12985,7 @@ type ListAdsData = {
          */
         campaignId?: string;
         /**
-         * Start of metrics date range (YYYY-MM-DD). Defaults to 90 days ago.
+         * Start of metrics date range (YYYY-MM-DD). Defaults to 90 days ago. Ranges older than 90 days trigger an on-demand platform fetch when scoped to a specific accountId.
          */
         fromDate?: string;
         limit?: number;
@@ -13004,7 +13004,7 @@ type ListAdsData = {
         source?: 'zernio' | 'all';
         status?: AdStatus;
         /**
-         * End of metrics date range (YYYY-MM-DD). Defaults to today. Max 90-day range.
+         * End of metrics date range (YYYY-MM-DD). Defaults to today. Max 730-day range.
          */
         toDate?: string;
     };
@@ -13293,7 +13293,7 @@ type GetAdTreeData = {
          */
         adAccountId?: string;
         /**
-         * Start of metrics date range (YYYY-MM-DD). Defaults to 90 days ago.
+         * Start of metrics date range (YYYY-MM-DD). Defaults to 90 days ago. Ranges older than 90 days trigger an on-demand platform fetch when scoped to a specific accountId.
          */
         fromDate?: string;
         /**
@@ -13318,7 +13318,7 @@ type GetAdTreeData = {
          */
         status?: AdStatus;
         /**
-         * End of metrics date range (YYYY-MM-DD). Defaults to today. Max 90-day range.
+         * End of metrics date range (YYYY-MM-DD). Defaults to today. Max 730-day range.
          */
         toDate?: string;
     };
@@ -13427,11 +13427,11 @@ type GetAdAnalyticsData = {
          */
         breakdowns?: string;
         /**
-         * Start of date range (YYYY-MM-DD). Defaults to 90 days ago.
+         * Start of date range (YYYY-MM-DD). Defaults to 90 days ago. Ranges older than 90 days trigger an on-demand platform fetch.
          */
         fromDate?: string;
         /**
-         * End of date range (YYYY-MM-DD). Defaults to today. Max 90-day range.
+         * End of date range (YYYY-MM-DD). Defaults to today. Max 730-day range.
          */
         toDate?: string;
     };

package/dist/index.d.ts

@@ -2876,9 +2876,9 @@ type SnapchatPlatformData = {
  */
 type contentType3 = 'story' | 'saved_story' | 'spotlight';
 type SocialAccount = {
-    _id?: string;
-    platform?: 'tiktok' | 'instagram' | 'facebook' | 'youtube' | 'linkedin' | 'twitter' | 'threads' | 'pinterest' | 'reddit' | 'bluesky' | 'googlebusiness' | 'telegram' | 'snapchat' | 'discord' | 'whatsapp' | 'linkedinads' | 'metaads' | 'pinterestads' | 'tiktokads' | 'xads' | 'googleads';
-    profileId?: (string | Profile);
+    _id: string;
+    platform: 'tiktok' | 'instagram' | 'facebook' | 'youtube' | 'linkedin' | 'twitter' | 'threads' | 'pinterest' | 'reddit' | 'bluesky' | 'googlebusiness' | 'telegram' | 'snapchat' | 'discord' | 'whatsapp' | 'linkedinads' | 'metaads' | 'pinterestads' | 'tiktokads' | 'xads' | 'googleads';
+    profileId: (string | Profile);
     username?: string;
     displayName?: string;
     /**
@@ -2889,7 +2889,7 @@ type SocialAccount = {
      * Full profile URL for the connected account on its platform.
      */
     profileUrl?: string;
-    isActive?: boolean;
+    isActive: boolean;
     /**
      * Follower count (only included if user has analytics add-on)
      */
@@ -5950,11 +5950,11 @@ type ListAccountsData = {
     };
 };
 type ListAccountsResponse = ({
-    accounts?: Array<SocialAccount>;
+    accounts: Array<SocialAccount>;
     /**
      * Whether user has analytics add-on access
      */
-    hasAnalyticsAccess?: boolean;
+    hasAnalyticsAccess: boolean;
     /**
      * Only present when page/limit params are provided
      */
@@ -12985,7 +12985,7 @@ type ListAdsData = {
          */
         campaignId?: string;
         /**
-         * Start of metrics date range (YYYY-MM-DD). Defaults to 90 days ago.
+         * Start of metrics date range (YYYY-MM-DD). Defaults to 90 days ago. Ranges older than 90 days trigger an on-demand platform fetch when scoped to a specific accountId.
          */
         fromDate?: string;
         limit?: number;
@@ -13004,7 +13004,7 @@ type ListAdsData = {
         source?: 'zernio' | 'all';
         status?: AdStatus;
         /**
-         * End of metrics date range (YYYY-MM-DD). Defaults to today. Max 90-day range.
+         * End of metrics date range (YYYY-MM-DD). Defaults to today. Max 730-day range.
          */
         toDate?: string;
     };
@@ -13293,7 +13293,7 @@ type GetAdTreeData = {
          */
         adAccountId?: string;
         /**
-         * Start of metrics date range (YYYY-MM-DD). Defaults to 90 days ago.
+         * Start of metrics date range (YYYY-MM-DD). Defaults to 90 days ago. Ranges older than 90 days trigger an on-demand platform fetch when scoped to a specific accountId.
          */
         fromDate?: string;
         /**
@@ -13318,7 +13318,7 @@ type GetAdTreeData = {
          */
         status?: AdStatus;
         /**
-         * End of metrics date range (YYYY-MM-DD). Defaults to today. Max 90-day range.
+         * End of metrics date range (YYYY-MM-DD). Defaults to today. Max 730-day range.
          */
         toDate?: string;
     };
@@ -13427,11 +13427,11 @@ type GetAdAnalyticsData = {
          */
         breakdowns?: string;
         /**
-         * Start of date range (YYYY-MM-DD). Defaults to 90 days ago.
+         * Start of date range (YYYY-MM-DD). Defaults to 90 days ago. Ranges older than 90 days trigger an on-demand platform fetch.
          */
         fromDate?: string;
         /**
-         * End of date range (YYYY-MM-DD). Defaults to today. Max 90-day range.
+         * End of date range (YYYY-MM-DD). Defaults to today. Max 730-day range.
          */
         toDate?: string;
     };

package/package.json

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

package/src/generated/sdk.gen.ts

@@ -3228,7 +3228,8 @@ export const listCommentAutomationLogs = <ThrowOnError extends boolean = false>(
  * List ads
  * Returns a paginated list of ads with metrics computed over an optional date range.
  * Use source=all to include externally-synced ads from platform ad managers.
- * If no date range is provided, defaults to the last 90 days. Date range is capped at 90 days max.
+ * If no date range is provided, defaults to the last 90 days. Date range is capped at 730 days max.
+ * Ranges older than 90 days trigger a one-time on-demand fetch from the platform when scoped to a specific accountId, then serve from cache on subsequent requests.
  *
  */
 export const listAds = <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<ListAdsData, ThrowOnError>) => {
@@ -3390,7 +3391,8 @@ export const updateAdSetStatus = <ThrowOnError extends boolean = false>(options:
  * Metrics are computed over an optional date range, then rolled up from ad level to ad set
  * and campaign levels. Pagination is at the campaign level. Ads without a campaign or ad set
  * ID are grouped into synthetic "Ungrouped" buckets.
- * If no date range is provided, defaults to the last 90 days. Date range is capped at 90 days max.
+ * If no date range is provided, defaults to the last 90 days. Date range is capped at 730 days max.
+ * Ranges older than 90 days trigger a one-time on-demand fetch from the platform when scoped to a specific accountId, then serve from cache on subsequent requests.
  *
  */
 export const getAdTree = <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<GetAdTreeData, ThrowOnError>) => {
@@ -3446,7 +3448,8 @@ export const deleteAd = <ThrowOnError extends boolean = false>(options: OptionsL
  * Get ad analytics
  * Returns detailed performance analytics for an ad. Includes summary metrics, a daily timeline
  * over the requested date range, and optional demographic breakdowns (Meta and TikTok only).
- * If no date range is provided, defaults to the last 90 days. Date range is capped at 90 days max.
+ * If no date range is provided, defaults to the last 90 days. Date range is capped at 730 days max.
+ * Ranges older than 90 days trigger a one-time on-demand fetch from the platform, then serve from cache on subsequent requests.
  *
  */
 export const getAdAnalytics = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetAdAnalyticsData, ThrowOnError>) => {

package/src/generated/types.gen.ts

@@ -2378,9 +2378,9 @@ export type SnapchatPlatformData = {
 export type contentType3 = 'story' | 'saved_story' | 'spotlight';
 
 export type SocialAccount = {
-    _id?: string;
-    platform?: 'tiktok' | 'instagram' | 'facebook' | 'youtube' | 'linkedin' | 'twitter' | 'threads' | 'pinterest' | 'reddit' | 'bluesky' | 'googlebusiness' | 'telegram' | 'snapchat' | 'discord' | 'whatsapp' | 'linkedinads' | 'metaads' | 'pinterestads' | 'tiktokads' | 'xads' | 'googleads';
-    profileId?: (string | Profile);
+    _id: string;
+    platform: 'tiktok' | 'instagram' | 'facebook' | 'youtube' | 'linkedin' | 'twitter' | 'threads' | 'pinterest' | 'reddit' | 'bluesky' | 'googlebusiness' | 'telegram' | 'snapchat' | 'discord' | 'whatsapp' | 'linkedinads' | 'metaads' | 'pinterestads' | 'tiktokads' | 'xads' | 'googleads';
+    profileId: (string | Profile);
     username?: string;
     displayName?: string;
     /**
@@ -2391,7 +2391,7 @@ export type SocialAccount = {
      * Full profile URL for the connected account on its platform.
      */
     profileUrl?: string;
-    isActive?: boolean;
+    isActive: boolean;
     /**
      * Follower count (only included if user has analytics add-on)
      */
@@ -5659,11 +5659,11 @@ export type ListAccountsData = {
 };
 
 export type ListAccountsResponse = ({
-    accounts?: Array<SocialAccount>;
+    accounts: Array<SocialAccount>;
     /**
      * Whether user has analytics add-on access
      */
-    hasAnalyticsAccess?: boolean;
+    hasAnalyticsAccess: boolean;
     /**
      * Only present when page/limit params are provided
      */
@@ -13276,7 +13276,7 @@ export type ListAdsData = {
          */
         campaignId?: string;
         /**
-         * Start of metrics date range (YYYY-MM-DD). Defaults to 90 days ago.
+         * Start of metrics date range (YYYY-MM-DD). Defaults to 90 days ago. Ranges older than 90 days trigger an on-demand platform fetch when scoped to a specific accountId.
          */
         fromDate?: string;
         limit?: number;
@@ -13295,7 +13295,7 @@ export type ListAdsData = {
         source?: 'zernio' | 'all';
         status?: AdStatus;
         /**
-         * End of metrics date range (YYYY-MM-DD). Defaults to today. Max 90-day range.
+         * End of metrics date range (YYYY-MM-DD). Defaults to today. Max 730-day range.
          */
         toDate?: string;
     };
@@ -13611,7 +13611,7 @@ export type GetAdTreeData = {
          */
         adAccountId?: string;
         /**
-         * Start of metrics date range (YYYY-MM-DD). Defaults to 90 days ago.
+         * Start of metrics date range (YYYY-MM-DD). Defaults to 90 days ago. Ranges older than 90 days trigger an on-demand platform fetch when scoped to a specific accountId.
          */
         fromDate?: string;
         /**
@@ -13636,7 +13636,7 @@ export type GetAdTreeData = {
          */
         status?: AdStatus;
         /**
-         * End of metrics date range (YYYY-MM-DD). Defaults to today. Max 90-day range.
+         * End of metrics date range (YYYY-MM-DD). Defaults to today. Max 730-day range.
          */
         toDate?: string;
     };
@@ -13757,11 +13757,11 @@ export type GetAdAnalyticsData = {
          */
         breakdowns?: string;
         /**
-         * Start of date range (YYYY-MM-DD). Defaults to 90 days ago.
+         * Start of date range (YYYY-MM-DD). Defaults to 90 days ago. Ranges older than 90 days trigger an on-demand platform fetch.
          */
         fromDate?: string;
         /**
-         * End of date range (YYYY-MM-DD). Defaults to today. Max 90-day range.
+         * End of date range (YYYY-MM-DD). Defaults to today. Max 730-day range.
          */
         toDate?: string;
     };