@getlatedev/node 0.2.1091 → 0.2.1093

package/dist/index.d.mts

@@ -3617,7 +3617,7 @@ type AnalyticsDeltaEntry = {
          */
         replays?: number;
         /**
-         * Facebook Reels only: share of plays still watching at each second of playback, fractions 0 to 1 (Meta post_video_retention_graph). Keys are whole seconds from the start of a play ("3" is the share still watching at 3 s). Loops count as continued playback, so a short Reels curve runs past its length (an 8 s Reel has keys "0" to "12"); Meta returns at most 41 points, so a long Reel covers only its first 40 s. Empty object elsewhere.
+         * Facebook Reels only: share still watching at each second of playback, fractions 0 to 1 (Meta post_video_retention_graph). The base is a subset of plays that Meta selects and does not expose: on small Reels it can be far below views (6 of 51 measured), so a value is a share of that subset, not of all plays. Keys are whole seconds from the start of a play ("3" is the share still watching at 3 s). Loops count as continued playback, so a short Reels curve runs past its length (an 8 s Reel has keys "0" to "12"); Meta returns at most 41 points, so a long Reel covers only its first 40 s. Empty object elsewhere.
          */
         retentionCurve?: {
             [key: string]: (number);
@@ -6924,12 +6924,12 @@ type ErrorResponse = {
      * (every Google account is affected and there is nothing to change on your side),
      * `ACCOUNT` means your own ad account. A Meta 429 carries neither field.
      *
-     * A Zernio Google Ads budget 429 carries `budgetScope` instead, and never
+     * A Zernio Google Ads burst-limit 429 carries `budgetScope` instead, and never
      * `quotaExhausted`: these are Zernio's own limits, applied before the call
-     * reaches Google. `user` is your own burst or daily allowance, so the work is
-     * yours to reschedule; `platform` is the fleet-wide daily budget shared with
-     * every other customer, so only waiting for the reset clears it. The two
-     * scopes are separate axes from `quotaScope`, not the same pool named twice.
+     * reaches Google, and both clear within a minute. `account` is the limit of 15
+     * requests per minute per connected Google Ads account; `user` is the ceiling of
+     * 120 requests per minute per Zernio user across all their Google Ads accounts.
+     * Both are separate axes from `quotaScope`, not the same pool named twice.
      *
      * A failed Meta ad create (`POST /v1/ads/create`, `POST /v1/ads/boost`,
      * `POST /v1/ads/ctwa`) carries `stage`, `adAccountId` and `createdObjects`: where
@@ -6983,9 +6983,9 @@ type ErrorResponse = {
          */
         quotaScope?: 'DEVELOPER' | 'ACCOUNT';
         /**
-         * Zernio Google Ads burst-limit 429 only (never set alongside `quotaExhausted`). `user` is your own per-minute allowance on user-driven Google Ads calls; it clears within a minute.
+         * Zernio Google Ads burst-limit 429 only (never set alongside `quotaExhausted`). `account` is the limit of 15 requests per minute per connected Google Ads account; `user` is the ceiling of 120 requests per minute per Zernio user across all their Google Ads accounts. Both clear within a minute.
          */
-        budgetScope?: 'user';
+        budgetScope?: 'account' | 'user';
         [key: string]: unknown | string | boolean;
     };
 };
@@ -7002,9 +7002,9 @@ type stage = 'media' | 'campaign' | 'adset' | 'creative' | 'ad' | 'activation' |
  */
 type quotaScope = 'DEVELOPER' | 'ACCOUNT';
 /**
- * Zernio Google Ads burst-limit 429 only (never set alongside `quotaExhausted`). `user` is your own per-minute allowance on user-driven Google Ads calls; it clears within a minute.
+ * Zernio Google Ads burst-limit 429 only (never set alongside `quotaExhausted`). `account` is the limit of 15 requests per minute per connected Google Ads account; `user` is the ceiling of 120 requests per minute per Zernio user across all their Google Ads accounts. Both clear within a minute.
  */
-type budgetScope = 'user';
+type budgetScope = 'account' | 'user';
 /**
  * A media item on a native (external/synced) post, as carried by post.external.* webhook payloads. Distinct from the richer MediaItem used for Zernio-authored posts: external items are always already-published and limited to image or video. Kept as a separate schema so the generated SDK model does not collide with MediaItem.
  *
@@ -10543,7 +10543,7 @@ type PostAnalytics = {
      */
     replays?: number;
     /**
-     * Facebook Reels only: share of plays still watching at each second of playback, fractions 0 to 1 (Meta post_video_retention_graph). Keys are whole seconds from the start of a play ("3" is the share still watching at 3 s). Loops count as continued playback, so a short Reels curve runs past its length (an 8 s Reel has keys "0" to "12"); Meta returns at most 41 points, so a long Reel covers only its first 40 s. Empty object for other media and platforms. Views-weighted across accounts like impressionSources.
+     * Facebook Reels only: share still watching at each second of playback, fractions 0 to 1 (Meta post_video_retention_graph). The base is a subset of plays that Meta selects and does not expose: on small Reels it can be far below views (6 of 51 measured), so a value is a share of that subset, not of all plays. Keys are whole seconds from the start of a play ("3" is the share still watching at 3 s). Loops count as continued playback, so a short Reels curve runs past its length (an 8 s Reel has keys "0" to "12"); Meta returns at most 41 points, so a long Reel covers only its first 40 s. Empty object for other media and platforms. Views-weighted across accounts like impressionSources.
      */
     retentionCurve?: {
         [key: string]: (number);
@@ -17983,7 +17983,7 @@ type GetPostTimelineResponse = ({
          */
         replays?: number;
         /**
-         * Facebook Reels only: share of plays still watching at each second of playback, fractions 0 to 1 (Meta post_video_retention_graph). Keys are whole seconds from the start of a play ("3" is the share still watching at 3 s). Loops count as continued playback, so a short Reels curve runs past its length (an 8 s Reel has keys "0" to "12"); Meta returns at most 41 points, so a long Reel covers only its first 40 s. Values are as of this date; empty object elsewhere.
+         * Facebook Reels only: share still watching at each second of playback, fractions 0 to 1 (Meta post_video_retention_graph). The base is a subset of plays that Meta selects and does not expose: on small Reels it can be far below views (6 of 51 measured), so a value is a share of that subset, not of all plays. Keys are whole seconds from the start of a play ("3" is the share still watching at 3 s). Loops count as continued playback, so a short Reels curve runs past its length (an 8 s Reel has keys "0" to "12"); Meta returns at most 41 points, so a long Reel covers only its first 40 s. Values are as of this date; empty object elsewhere.
          */
         retentionCurve?: {
             [key: string]: (number);

package/dist/index.d.ts

@@ -3617,7 +3617,7 @@ type AnalyticsDeltaEntry = {
          */
         replays?: number;
         /**
-         * Facebook Reels only: share of plays still watching at each second of playback, fractions 0 to 1 (Meta post_video_retention_graph). Keys are whole seconds from the start of a play ("3" is the share still watching at 3 s). Loops count as continued playback, so a short Reels curve runs past its length (an 8 s Reel has keys "0" to "12"); Meta returns at most 41 points, so a long Reel covers only its first 40 s. Empty object elsewhere.
+         * Facebook Reels only: share still watching at each second of playback, fractions 0 to 1 (Meta post_video_retention_graph). The base is a subset of plays that Meta selects and does not expose: on small Reels it can be far below views (6 of 51 measured), so a value is a share of that subset, not of all plays. Keys are whole seconds from the start of a play ("3" is the share still watching at 3 s). Loops count as continued playback, so a short Reels curve runs past its length (an 8 s Reel has keys "0" to "12"); Meta returns at most 41 points, so a long Reel covers only its first 40 s. Empty object elsewhere.
          */
         retentionCurve?: {
             [key: string]: (number);
@@ -6924,12 +6924,12 @@ type ErrorResponse = {
      * (every Google account is affected and there is nothing to change on your side),
      * `ACCOUNT` means your own ad account. A Meta 429 carries neither field.
      *
-     * A Zernio Google Ads budget 429 carries `budgetScope` instead, and never
+     * A Zernio Google Ads burst-limit 429 carries `budgetScope` instead, and never
      * `quotaExhausted`: these are Zernio's own limits, applied before the call
-     * reaches Google. `user` is your own burst or daily allowance, so the work is
-     * yours to reschedule; `platform` is the fleet-wide daily budget shared with
-     * every other customer, so only waiting for the reset clears it. The two
-     * scopes are separate axes from `quotaScope`, not the same pool named twice.
+     * reaches Google, and both clear within a minute. `account` is the limit of 15
+     * requests per minute per connected Google Ads account; `user` is the ceiling of
+     * 120 requests per minute per Zernio user across all their Google Ads accounts.
+     * Both are separate axes from `quotaScope`, not the same pool named twice.
      *
      * A failed Meta ad create (`POST /v1/ads/create`, `POST /v1/ads/boost`,
      * `POST /v1/ads/ctwa`) carries `stage`, `adAccountId` and `createdObjects`: where
@@ -6983,9 +6983,9 @@ type ErrorResponse = {
          */
         quotaScope?: 'DEVELOPER' | 'ACCOUNT';
         /**
-         * Zernio Google Ads burst-limit 429 only (never set alongside `quotaExhausted`). `user` is your own per-minute allowance on user-driven Google Ads calls; it clears within a minute.
+         * Zernio Google Ads burst-limit 429 only (never set alongside `quotaExhausted`). `account` is the limit of 15 requests per minute per connected Google Ads account; `user` is the ceiling of 120 requests per minute per Zernio user across all their Google Ads accounts. Both clear within a minute.
          */
-        budgetScope?: 'user';
+        budgetScope?: 'account' | 'user';
         [key: string]: unknown | string | boolean;
     };
 };
@@ -7002,9 +7002,9 @@ type stage = 'media' | 'campaign' | 'adset' | 'creative' | 'ad' | 'activation' |
  */
 type quotaScope = 'DEVELOPER' | 'ACCOUNT';
 /**
- * Zernio Google Ads burst-limit 429 only (never set alongside `quotaExhausted`). `user` is your own per-minute allowance on user-driven Google Ads calls; it clears within a minute.
+ * Zernio Google Ads burst-limit 429 only (never set alongside `quotaExhausted`). `account` is the limit of 15 requests per minute per connected Google Ads account; `user` is the ceiling of 120 requests per minute per Zernio user across all their Google Ads accounts. Both clear within a minute.
  */
-type budgetScope = 'user';
+type budgetScope = 'account' | 'user';
 /**
  * A media item on a native (external/synced) post, as carried by post.external.* webhook payloads. Distinct from the richer MediaItem used for Zernio-authored posts: external items are always already-published and limited to image or video. Kept as a separate schema so the generated SDK model does not collide with MediaItem.
  *
@@ -10543,7 +10543,7 @@ type PostAnalytics = {
      */
     replays?: number;
     /**
-     * Facebook Reels only: share of plays still watching at each second of playback, fractions 0 to 1 (Meta post_video_retention_graph). Keys are whole seconds from the start of a play ("3" is the share still watching at 3 s). Loops count as continued playback, so a short Reels curve runs past its length (an 8 s Reel has keys "0" to "12"); Meta returns at most 41 points, so a long Reel covers only its first 40 s. Empty object for other media and platforms. Views-weighted across accounts like impressionSources.
+     * Facebook Reels only: share still watching at each second of playback, fractions 0 to 1 (Meta post_video_retention_graph). The base is a subset of plays that Meta selects and does not expose: on small Reels it can be far below views (6 of 51 measured), so a value is a share of that subset, not of all plays. Keys are whole seconds from the start of a play ("3" is the share still watching at 3 s). Loops count as continued playback, so a short Reels curve runs past its length (an 8 s Reel has keys "0" to "12"); Meta returns at most 41 points, so a long Reel covers only its first 40 s. Empty object for other media and platforms. Views-weighted across accounts like impressionSources.
      */
     retentionCurve?: {
         [key: string]: (number);
@@ -17983,7 +17983,7 @@ type GetPostTimelineResponse = ({
          */
         replays?: number;
         /**
-         * Facebook Reels only: share of plays still watching at each second of playback, fractions 0 to 1 (Meta post_video_retention_graph). Keys are whole seconds from the start of a play ("3" is the share still watching at 3 s). Loops count as continued playback, so a short Reels curve runs past its length (an 8 s Reel has keys "0" to "12"); Meta returns at most 41 points, so a long Reel covers only its first 40 s. Values are as of this date; empty object elsewhere.
+         * Facebook Reels only: share still watching at each second of playback, fractions 0 to 1 (Meta post_video_retention_graph). The base is a subset of plays that Meta selects and does not expose: on small Reels it can be far below views (6 of 51 measured), so a value is a share of that subset, not of all plays. Keys are whole seconds from the start of a play ("3" is the share still watching at 3 s). Loops count as continued playback, so a short Reels curve runs past its length (an 8 s Reel has keys "0" to "12"); Meta returns at most 41 points, so a long Reel covers only its first 40 s. Values are as of this date; empty object elsewhere.
          */
         retentionCurve?: {
             [key: string]: (number);

package/dist/index.js

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

package/src/generated/types.gen.ts

@@ -1686,7 +1686,7 @@ export type AnalyticsDeltaEntry = {
          */
         replays?: number;
         /**
-         * Facebook Reels only: share of plays still watching at each second of playback, fractions 0 to 1 (Meta post_video_retention_graph). Keys are whole seconds from the start of a play ("3" is the share still watching at 3 s). Loops count as continued playback, so a short Reels curve runs past its length (an 8 s Reel has keys "0" to "12"); Meta returns at most 41 points, so a long Reel covers only its first 40 s. Empty object elsewhere.
+         * Facebook Reels only: share still watching at each second of playback, fractions 0 to 1 (Meta post_video_retention_graph). The base is a subset of plays that Meta selects and does not expose: on small Reels it can be far below views (6 of 51 measured), so a value is a share of that subset, not of all plays. Keys are whole seconds from the start of a play ("3" is the share still watching at 3 s). Loops count as continued playback, so a short Reels curve runs past its length (an 8 s Reel has keys "0" to "12"); Meta returns at most 41 points, so a long Reel covers only its first 40 s. Empty object elsewhere.
          */
         retentionCurve?: {
             [key: string]: (number);
@@ -5146,12 +5146,12 @@ export type ErrorResponse = {
      * (every Google account is affected and there is nothing to change on your side),
      * `ACCOUNT` means your own ad account. A Meta 429 carries neither field.
      *
-     * A Zernio Google Ads budget 429 carries `budgetScope` instead, and never
+     * A Zernio Google Ads burst-limit 429 carries `budgetScope` instead, and never
      * `quotaExhausted`: these are Zernio's own limits, applied before the call
-     * reaches Google. `user` is your own burst or daily allowance, so the work is
-     * yours to reschedule; `platform` is the fleet-wide daily budget shared with
-     * every other customer, so only waiting for the reset clears it. The two
-     * scopes are separate axes from `quotaScope`, not the same pool named twice.
+     * reaches Google, and both clear within a minute. `account` is the limit of 15
+     * requests per minute per connected Google Ads account; `user` is the ceiling of
+     * 120 requests per minute per Zernio user across all their Google Ads accounts.
+     * Both are separate axes from `quotaScope`, not the same pool named twice.
      *
      * A failed Meta ad create (`POST /v1/ads/create`, `POST /v1/ads/boost`,
      * `POST /v1/ads/ctwa`) carries `stage`, `adAccountId` and `createdObjects`: where
@@ -5205,9 +5205,9 @@ export type ErrorResponse = {
          */
         quotaScope?: 'DEVELOPER' | 'ACCOUNT';
         /**
-         * Zernio Google Ads burst-limit 429 only (never set alongside `quotaExhausted`). `user` is your own per-minute allowance on user-driven Google Ads calls; it clears within a minute.
+         * Zernio Google Ads burst-limit 429 only (never set alongside `quotaExhausted`). `account` is the limit of 15 requests per minute per connected Google Ads account; `user` is the ceiling of 120 requests per minute per Zernio user across all their Google Ads accounts. Both clear within a minute.
          */
-        budgetScope?: 'user';
+        budgetScope?: 'account' | 'user';
         [key: string]: unknown | string | boolean;
     };
 };
@@ -5228,9 +5228,9 @@ export type stage = 'media' | 'campaign' | 'adset' | 'creative' | 'ad' | 'activa
 export type quotaScope = 'DEVELOPER' | 'ACCOUNT';
 
 /**
- * Zernio Google Ads burst-limit 429 only (never set alongside `quotaExhausted`). `user` is your own per-minute allowance on user-driven Google Ads calls; it clears within a minute.
+ * Zernio Google Ads burst-limit 429 only (never set alongside `quotaExhausted`). `account` is the limit of 15 requests per minute per connected Google Ads account; `user` is the ceiling of 120 requests per minute per Zernio user across all their Google Ads accounts. Both clear within a minute.
  */
-export type budgetScope = 'user';
+export type budgetScope = 'account' | 'user';
 
 /**
  * A media item on a native (external/synced) post, as carried by post.external.* webhook payloads. Distinct from the richer MediaItem used for Zernio-authored posts: external items are always already-published and limited to image or video. Kept as a separate schema so the generated SDK model does not collide with MediaItem.
@@ -8939,7 +8939,7 @@ export type PostAnalytics = {
      */
     replays?: number;
     /**
-     * Facebook Reels only: share of plays still watching at each second of playback, fractions 0 to 1 (Meta post_video_retention_graph). Keys are whole seconds from the start of a play ("3" is the share still watching at 3 s). Loops count as continued playback, so a short Reels curve runs past its length (an 8 s Reel has keys "0" to "12"); Meta returns at most 41 points, so a long Reel covers only its first 40 s. Empty object for other media and platforms. Views-weighted across accounts like impressionSources.
+     * Facebook Reels only: share still watching at each second of playback, fractions 0 to 1 (Meta post_video_retention_graph). The base is a subset of plays that Meta selects and does not expose: on small Reels it can be far below views (6 of 51 measured), so a value is a share of that subset, not of all plays. Keys are whole seconds from the start of a play ("3" is the share still watching at 3 s). Loops count as continued playback, so a short Reels curve runs past its length (an 8 s Reel has keys "0" to "12"); Meta returns at most 41 points, so a long Reel covers only its first 40 s. Empty object for other media and platforms. Views-weighted across accounts like impressionSources.
      */
     retentionCurve?: {
         [key: string]: (number);
@@ -16728,7 +16728,7 @@ export type GetPostTimelineResponse = ({
          */
         replays?: number;
         /**
-         * Facebook Reels only: share of plays still watching at each second of playback, fractions 0 to 1 (Meta post_video_retention_graph). Keys are whole seconds from the start of a play ("3" is the share still watching at 3 s). Loops count as continued playback, so a short Reels curve runs past its length (an 8 s Reel has keys "0" to "12"); Meta returns at most 41 points, so a long Reel covers only its first 40 s. Values are as of this date; empty object elsewhere.
+         * Facebook Reels only: share still watching at each second of playback, fractions 0 to 1 (Meta post_video_retention_graph). The base is a subset of plays that Meta selects and does not expose: on small Reels it can be far below views (6 of 51 measured), so a value is a share of that subset, not of all plays. Keys are whole seconds from the start of a play ("3" is the share still watching at 3 s). Loops count as continued playback, so a short Reels curve runs past its length (an 8 s Reel has keys "0" to "12"); Meta returns at most 41 points, so a long Reel covers only its first 40 s. Values are as of this date; empty object elsewhere.
          */
         retentionCurve?: {
             [key: string]: (number);