@zernio/node 0.2.119 → 0.2.120

package/dist/index.d.mts

@@ -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

@@ -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.119",
+  "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

@@ -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;
     };