@getlatedev/node 0.2.1248 → 0.2.1249

package/dist/index.d.mts

@@ -2580,7 +2580,7 @@ type format = 'single_image' | 'carousel_images_multi_items' | 'carousel_images_
 type AdActivationStatus = 'ACTIVE' | 'PAUSED';
 type AdAnalyticsResponse = {
     /**
-     * Present and true while historical data is being backfilled.
+     * Meta only. Present and true while historical data is being backfilled.
      */
     backfillPending?: boolean;
     ad?: {
@@ -3415,14 +3415,14 @@ type AdsListResponse = {
     ads?: Array<Ad>;
     pagination?: Pagination;
     /**
-     * Present and true while historical data is being backfilled.
+     * Meta only. Present and true while historical data is being backfilled.
      */
     backfillPending?: boolean;
 };
 type AdStatus = 'active' | 'paused' | 'pending_review' | 'rejected' | 'completed' | 'cancelled' | 'error';
 type AdsTimelineResponse = {
     /**
-     * Present and true while historical data is being backfilled.
+     * Meta only. Present and true while historical data is being backfilled.
      */
     backfillPending?: boolean;
     rows?: Array<{
@@ -3719,7 +3719,7 @@ type AdTreeResponse = {
     campaigns?: Array<AdTreeCampaign>;
     pagination?: Pagination;
     /**
-     * Present and true while historical data is being backfilled.
+     * Meta only. Present and true while historical data is being backfilled.
      */
     backfillPending?: boolean;
 };
@@ -5109,7 +5109,7 @@ type transcriptionLanguage = 'auto' | 'en' | 'es';
 type endReason = 'hangup' | 'no_answer' | 'rejected' | 'error';
 type CampaignAnalyticsResponse = {
     /**
-     * Present and true while historical data is being backfilled.
+     * Meta only. Present and true while historical data is being backfilled.
      */
     backfillPending?: boolean;
     campaign?: {

package/dist/index.d.ts

@@ -2580,7 +2580,7 @@ type format = 'single_image' | 'carousel_images_multi_items' | 'carousel_images_
 type AdActivationStatus = 'ACTIVE' | 'PAUSED';
 type AdAnalyticsResponse = {
     /**
-     * Present and true while historical data is being backfilled.
+     * Meta only. Present and true while historical data is being backfilled.
      */
     backfillPending?: boolean;
     ad?: {
@@ -3415,14 +3415,14 @@ type AdsListResponse = {
     ads?: Array<Ad>;
     pagination?: Pagination;
     /**
-     * Present and true while historical data is being backfilled.
+     * Meta only. Present and true while historical data is being backfilled.
      */
     backfillPending?: boolean;
 };
 type AdStatus = 'active' | 'paused' | 'pending_review' | 'rejected' | 'completed' | 'cancelled' | 'error';
 type AdsTimelineResponse = {
     /**
-     * Present and true while historical data is being backfilled.
+     * Meta only. Present and true while historical data is being backfilled.
      */
     backfillPending?: boolean;
     rows?: Array<{
@@ -3719,7 +3719,7 @@ type AdTreeResponse = {
     campaigns?: Array<AdTreeCampaign>;
     pagination?: Pagination;
     /**
-     * Present and true while historical data is being backfilled.
+     * Meta only. Present and true while historical data is being backfilled.
      */
     backfillPending?: boolean;
 };
@@ -5109,7 +5109,7 @@ type transcriptionLanguage = 'auto' | 'en' | 'es';
 type endReason = 'hangup' | 'no_answer' | 'rejected' | 'error';
 type CampaignAnalyticsResponse = {
     /**
-     * Present and true while historical data is being backfilled.
+     * Meta only. Present and true while historical data is being backfilled.
      */
     backfillPending?: boolean;
     campaign?: {

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -9738,6 +9738,13 @@ export const listCommentAutomationLogs = <ThrowOnError extends boolean = false>(
  * 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 730 days max.
  *
+ * History: when an ad account connects, Zernio imports its last 90 days of metrics, so the
+ * metrics hold no data for days before that. When `accountId` or `adAccountId` resolves to a
+ * Meta ad account, a range reaching further back answers `202` with `backfillPending: true` and the
+ * covered part while the older days (up to 730 days back) are imported in the background;
+ * repeat the request until it returns 200.
+ * A request scoped to no Meta account never returns `202`.
+ *
  * To find the Zernio ad behind a comment you see in Meta Business Manager, filter by
  * platformAdId (the Meta ad ID), effectiveObjectStoryId (Facebook), or
  * effectiveInstagramMediaId (Instagram). Those are the post/media the ad's engagement
@@ -10790,6 +10797,13 @@ export const updateAdSetStatus = <ThrowOnError extends boolean = false>(options:
  * ID are grouped into synthetic "Ungrouped" buckets.
  * If no date range is provided, defaults to the last 90 days. Date range is capped at 730 days max.
  *
+ * History: when an ad account connects, Zernio imports its last 90 days of metrics, so the
+ * metrics hold no data for days before that. When `accountId` or `adAccountId` resolves to a
+ * Meta ad account, a range reaching further back answers `202` with `backfillPending: true` and the
+ * covered part while the older days (up to 730 days back) are imported in the background;
+ * repeat the request until it returns 200.
+ * A request scoped to no Meta account never returns `202`.
+ *
  * Pass `timeIncrement=1` to also get a daily breakdown: each node gains a `daily[]` array of
  * per-day metrics (same fields as the aggregated `metrics`) in the same call. Use `dailyLevel`
  * (`campaign` default, or `adset` / `ad`) to choose which levels carry the series. This replaces
@@ -10822,10 +10836,14 @@ export const getAdTree = <ThrowOnError extends boolean = false>(options?: Option
  * ID also includes ads under the linked `facebook` / `instagram` posting account
  * (and vice-versa), the same convention as `/v1/ads/tree` and `/v1/ads`.
  *
- * Date range defaults to the last 90 days. Capped at 730 days. Ranges older
- * than the ingested history return a `202` immediately with the covered part
- * and `backfillPending: true` while the rest is backfilled in the background;
- * repeat the request shortly until it returns 200 with full data.
+ * Date range defaults to the last 90 days. Capped at 730 days.
+ *
+ * History: when an ad account connects, Zernio imports its last 90 days of metrics, so `rows`
+ * hold no data for days before that. When `accountId` or `adAccountId` resolves to a Meta ad
+ * account, a range reaching further back answers `202` with `backfillPending: true` and the
+ * covered part while the older days (up to 730 days back) are imported in the background;
+ * repeat the request until it returns 200.
+ * Other platforms never return `202`.
  *
  * With adAccountId set to a Google customer id this is the customer-level performance report (clicks, cost, impressions, conversions, all conversions per day).
  *
@@ -11176,6 +11194,16 @@ export const removeAdGroupAssets = <ThrowOnError extends boolean = false>(option
  * age/gender/placement/etc. without summing thousands of per-ad reads. `campaignId` is the platform campaign id; pass
  * `platform` when a campaign id could be ambiguous across platforms. If no date range is provided,
  * defaults to the last 90 days. Date range is capped at 730 days max.
+ *
+ * History: when an ad account connects, Zernio imports its last 90 days of metrics. `summary`
+ * and `daily` come from those synced metrics, so they hold no data for days before that.
+ * Breakdowns and Google's impression share are read live from the platform over the requested
+ * range, so they are not limited by the import.
+ * When the campaign belongs to a Meta ad account, a range reaching further back answers `202` with `backfillPending: true` and the
+ * covered part while the older days (up to 730 days back) are imported in the background;
+ * repeat the request until it returns 200.
+ * Other platforms never return `202`.
+ *
  * Google adds searchImpressionShare, searchBudgetLostImpressionShare,
  * searchRankLostImpressionShare, searchTopImpressionShare and searchAbsoluteTopImpressionShare
  * under analytics.summary for the requested inclusive range. These ratios are queried
@@ -11420,6 +11448,15 @@ export const getAdInsightsReport = <ThrowOnError extends boolean = false>(option
  * over the requested date range, and optional demographic breakdowns (Meta, TikTok and LinkedIn only).
  * If no date range is provided, defaults to the last 90 days. Date range is capped at 730 days max.
  *
+ * History: when an ad account connects, Zernio imports its last 90 days of metrics. `summary`
+ * and `daily` come from those synced metrics, so they hold no data for days before that.
+ * Breakdowns are read live from the platform over the requested range, so they are not limited
+ * by the import.
+ * When the ad belongs to a Meta ad account, a range reaching further back answers `202` with `backfillPending: true` and the
+ * covered part while the older days (up to 730 days back) are imported in the background;
+ * repeat the request until it returns 200.
+ * Other platforms never return `202`.
+ *
  */
 export const getAdAnalytics = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetAdAnalyticsData, ThrowOnError>) => {
     return (options?.client ?? client).get<GetAdAnalyticsResponse, GetAdAnalyticsError, ThrowOnError>({

package/src/generated/types.gen.ts

@@ -564,7 +564,7 @@ export type AdActivationStatus = 'ACTIVE' | 'PAUSED';
 
 export type AdAnalyticsResponse = {
     /**
-     * Present and true while historical data is being backfilled.
+     * Meta only. Present and true while historical data is being backfilled.
      */
     backfillPending?: boolean;
     ad?: {
@@ -1424,7 +1424,7 @@ export type AdsListResponse = {
     ads?: Array<Ad>;
     pagination?: Pagination;
     /**
-     * Present and true while historical data is being backfilled.
+     * Meta only. Present and true while historical data is being backfilled.
      */
     backfillPending?: boolean;
 };
@@ -1433,7 +1433,7 @@ export type AdStatus = 'active' | 'paused' | 'pending_review' | 'rejected' | 'co
 
 export type AdsTimelineResponse = {
     /**
-     * Present and true while historical data is being backfilled.
+     * Meta only. Present and true while historical data is being backfilled.
      */
     backfillPending?: boolean;
     rows?: Array<{
@@ -1734,7 +1734,7 @@ export type AdTreeResponse = {
     campaigns?: Array<AdTreeCampaign>;
     pagination?: Pagination;
     /**
-     * Present and true while historical data is being backfilled.
+     * Meta only. Present and true while historical data is being backfilled.
      */
     backfillPending?: boolean;
 };
@@ -3206,7 +3206,7 @@ export type endReason = 'hangup' | 'no_answer' | 'rejected' | 'error';
 
 export type CampaignAnalyticsResponse = {
     /**
-     * Present and true while historical data is being backfilled.
+     * Meta only. Present and true while historical data is being backfilled.
      */
     backfillPending?: boolean;
     campaign?: {