@getlatedev/node 0.2.1436 → 0.2.1438

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;
         /**
@@ -24047,11 +24051,13 @@ type GetFacebookPageInsightsData = {
          * **Live Meta metrics** (current names, post-Nov-2025):
          *
          * - page_media_view (replaces deprecated page_impressions)
+         * - page_total_media_view_unique (reach: unique viewers, replaces deprecated page_impressions_unique). The reach total sums daily unique viewers, not unique people over the range: a viewer seen on several days counts once per day. For a range of exactly 28 days it is Meta's 28-day unique viewers when Meta returns them.
          * - page_views_total
-         * - page_post_engagements
+         * - page_post_engagements (content interactions: reactions, comments, shares and more)
          * - page_video_views
          * - page_video_view_time
          * - page_follows (replaces deprecated page_fans)
+         * - page_actions_post_reactions_like_total, page_actions_post_reactions_love_total, page_actions_post_reactions_wow_total, page_actions_post_reactions_haha_total, page_actions_post_reactions_sorry_total, page_actions_post_reactions_anger_total (reactions by type; like includes care)
          *
          * **Zernio-synthesized** from daily follower snapshots (filling the Nov-2025 gap left by the page_fan_adds / page_fan_removes deprecation):
          *

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;
         /**
@@ -24047,11 +24051,13 @@ type GetFacebookPageInsightsData = {
          * **Live Meta metrics** (current names, post-Nov-2025):
          *
          * - page_media_view (replaces deprecated page_impressions)
+         * - page_total_media_view_unique (reach: unique viewers, replaces deprecated page_impressions_unique). The reach total sums daily unique viewers, not unique people over the range: a viewer seen on several days counts once per day. For a range of exactly 28 days it is Meta's 28-day unique viewers when Meta returns them.
          * - page_views_total
-         * - page_post_engagements
+         * - page_post_engagements (content interactions: reactions, comments, shares and more)
          * - page_video_views
          * - page_video_view_time
          * - page_follows (replaces deprecated page_fans)
+         * - page_actions_post_reactions_like_total, page_actions_post_reactions_love_total, page_actions_post_reactions_wow_total, page_actions_post_reactions_haha_total, page_actions_post_reactions_sorry_total, page_actions_post_reactions_anger_total (reactions by type; like includes care)
          *
          * **Zernio-synthesized** from daily follower snapshots (filling the Nov-2025 gap left by the page_fan_adds / page_fan_removes deprecation):
          *

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.1438",
   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.1438",
   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.1438",
   "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>({
@@ -331,7 +337,7 @@ export const getYouTubeVideoRetention = <ThrowOnError extends boolean = false>(o
 
 /**
  * Get Facebook Page insights
- * Returns page-level Facebook insights (media views, views, post engagements, video metrics, follower counts). The response shape matches /v1/analytics/instagram/account-insights, so the same client handling works across platforms.
+ * Returns page-level Facebook insights (media views, reach, views, post engagements, reaction counts, video metrics, follower counts). The response shape matches /v1/analytics/instagram/account-insights, so the same client handling works across platforms.
  *
  * Max 89 days, defaults to last 30 days.
  *
@@ -344,6 +350,8 @@ export const getYouTubeVideoRetention = <ThrowOnError extends boolean = false>(o
  * - page_fan_adds
  * - page_fan_removes
  *
+ * page_impressions_unique is deprecated above Graph API v25 and is not accepted; use page_total_media_view_unique. Meta's Page Insights reference (https://developers.facebook.com/docs/graph-api/reference/insights) also deprecates a number of Page Insights metrics for all API versions by June 15, 2026.
+ *
  * Use the replacements below. Because Meta did not provide direct adds/removes replacements, Zernio synthesizes followers_gained / followers_lost from the daily follower snapshotter.
  *
  */

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;
         /**
@@ -22755,11 +22759,13 @@ export type GetFacebookPageInsightsData = {
          * **Live Meta metrics** (current names, post-Nov-2025):
          *
          * - page_media_view (replaces deprecated page_impressions)
+         * - page_total_media_view_unique (reach: unique viewers, replaces deprecated page_impressions_unique). The reach total sums daily unique viewers, not unique people over the range: a viewer seen on several days counts once per day. For a range of exactly 28 days it is Meta's 28-day unique viewers when Meta returns them.
          * - page_views_total
-         * - page_post_engagements
+         * - page_post_engagements (content interactions: reactions, comments, shares and more)
          * - page_video_views
          * - page_video_view_time
          * - page_follows (replaces deprecated page_fans)
+         * - page_actions_post_reactions_like_total, page_actions_post_reactions_love_total, page_actions_post_reactions_wow_total, page_actions_post_reactions_haha_total, page_actions_post_reactions_sorry_total, page_actions_post_reactions_anger_total (reactions by type; like includes care)
          *
          * **Zernio-synthesized** from daily follower snapshots (filling the Nov-2025 gap left by the page_fan_adds / page_fan_removes deprecation):
          *