@getlatedev/node 0.2.1436 → 0.2.1437

package/dist/index.d.mts

@@ -23503,7 +23503,11 @@ type YouTubeVideoRetentionResponse = {
      */
     provisionalSince?: string;
     /**
-     * Up to 100 points covering the video timeline, aggregated over the date range. Can be empty when YouTube has no retention data for the video in the given range.
+     * Whether YouTube returned startedWatching and stoppedWatching for this curve. When false, both are 0 placeholders in every point, not measured values.
+     */
+    segmentMetricsAvailable?: boolean;
+    /**
+     * Up to 100 points covering the video timeline, aggregated over the date range. Contains only the buckets YouTube reports for that range and is never zero-filled, so it can end before 1.0, skip positions, or be empty.
      */
     retentionCurve?: Array<{
         /**
@@ -23519,11 +23523,11 @@ type YouTubeVideoRetentionResponse = {
          */
         relativeRetentionPerformance?: number;
         /**
-         * Viewers who started watching in this segment. 0 when YouTube has no segment-level data for the video.
+         * Viewers who started watching in this segment. A 0 placeholder when segmentMetricsAvailable is false.
          */
         startedWatching?: number;
         /**
-         * Viewers who stopped watching in this segment. 0 when YouTube has no segment-level data for the video.
+         * Viewers who stopped watching in this segment. A 0 placeholder when segmentMetricsAvailable is false.
          */
         stoppedWatching?: number;
         /**

package/dist/index.d.ts

@@ -23503,7 +23503,11 @@ type YouTubeVideoRetentionResponse = {
      */
     provisionalSince?: string;
     /**
-     * Up to 100 points covering the video timeline, aggregated over the date range. Can be empty when YouTube has no retention data for the video in the given range.
+     * Whether YouTube returned startedWatching and stoppedWatching for this curve. When false, both are 0 placeholders in every point, not measured values.
+     */
+    segmentMetricsAvailable?: boolean;
+    /**
+     * Up to 100 points covering the video timeline, aggregated over the date range. Contains only the buckets YouTube reports for that range and is never zero-filled, so it can end before 1.0, skip positions, or be empty.
      */
     retentionCurve?: Array<{
         /**
@@ -23519,11 +23523,11 @@ type YouTubeVideoRetentionResponse = {
          */
         relativeRetentionPerformance?: number;
         /**
-         * Viewers who started watching in this segment. 0 when YouTube has no segment-level data for the video.
+         * Viewers who started watching in this segment. A 0 placeholder when segmentMetricsAvailable is false.
          */
         startedWatching?: number;
         /**
-         * Viewers who stopped watching in this segment. 0 when YouTube has no segment-level data for the video.
+         * Viewers who stopped watching in this segment. A 0 placeholder when segmentMetricsAvailable is false.
          */
         stoppedWatching?: 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.1436",
+  version: "0.2.1437",
   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.1436",
+  version: "0.2.1437",
   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.1436",
+  "version": "0.2.1437",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -316,11 +316,17 @@ export const getYouTubeDailyViews = <ThrowOnError extends boolean = false>(optio
  * - Up to 100 points (elapsedVideoTimeRatio 0.01-1.0), aggregated over the whole date range. YouTube does not support per-day retention breakdowns.
  * - audienceWatchRatio: the absolute share of viewers watching at that point in the video. It can exceed 1 (rewinds and looping, common on Shorts).
  * - relativeRetentionPerformance: compares against videos of similar length (0 = worst, 0.5 = median, 1 = best).
+ * - Zernio returns exactly the buckets YouTube reports for the requested range and fills none in. A curve that ends before 1.0, or skips a position, means YouTube returned no row there for that range.
+ * - The range ends at toDate (default 3 days ago), so recent views are included only with a later toDate.
  *
  * ### Empty curves
  *
  * YouTube returns an empty curve for videos with very few views or before analytics processing completes (2-3 day delay).
  *
+ * ### startedWatching and stoppedWatching
+ *
+ * YouTube does not return segment-level data for every video. Zernio then fetches the curve without it: `segmentMetricsAvailable` is `false` and both fields are `0` placeholders in every point. When it is `true`, a `0` is the value YouTube reported.
+ *
  */
 export const getYouTubeVideoRetention = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetYouTubeVideoRetentionData, ThrowOnError>) => {
     return (options?.client ?? client).get<GetYouTubeVideoRetentionResponse, GetYouTubeVideoRetentionError, ThrowOnError>({

package/src/generated/types.gen.ts

@@ -22177,7 +22177,11 @@ export type YouTubeVideoRetentionResponse = {
      */
     provisionalSince?: string;
     /**
-     * Up to 100 points covering the video timeline, aggregated over the date range. Can be empty when YouTube has no retention data for the video in the given range.
+     * Whether YouTube returned startedWatching and stoppedWatching for this curve. When false, both are 0 placeholders in every point, not measured values.
+     */
+    segmentMetricsAvailable?: boolean;
+    /**
+     * Up to 100 points covering the video timeline, aggregated over the date range. Contains only the buckets YouTube reports for that range and is never zero-filled, so it can end before 1.0, skip positions, or be empty.
      */
     retentionCurve?: Array<{
         /**
@@ -22193,11 +22197,11 @@ export type YouTubeVideoRetentionResponse = {
          */
         relativeRetentionPerformance?: number;
         /**
-         * Viewers who started watching in this segment. 0 when YouTube has no segment-level data for the video.
+         * Viewers who started watching in this segment. A 0 placeholder when segmentMetricsAvailable is false.
          */
         startedWatching?: number;
         /**
-         * Viewers who stopped watching in this segment. 0 when YouTube has no segment-level data for the video.
+         * Viewers who stopped watching in this segment. A 0 placeholder when segmentMetricsAvailable is false.
          */
         stoppedWatching?: number;
         /**