@getlatedev/node 0.2.581 → 0.2.582

package/dist/index.d.mts

@@ -4051,6 +4051,9 @@ type ExternalPostSummary = {
         views?: number;
         reach?: number;
         impressions?: number;
+        /**
+         * Percentage, rounded to 2 decimals. Same definition as PostAnalytics.engagementRate: (likes + comments + shares + saves) / (impressions or reach or views) * 100, where the denominator is the first of the three that is non-zero. Clicks and follows are never counted.
+         */
         engagementRate?: number;
         /**
          * When these metrics were last refreshed
@@ -5329,7 +5332,7 @@ type LinkedInAggregateAnalyticsTotalResponse = {
          */
         sends?: number;
         /**
-         * Overall engagement rate as percentage
+         * Overall engagement rate, as a percentage rounded to 2 decimals: (reactions + comments + shares + saves + sends) / impressions * 100. Clicks are not counted, and there is no fallback denominator, so this is 0 whenever impressions is 0. This is NOT the same formula as PostAnalytics.engagementRate on GET /v1/analytics.
          */
         engagementRate?: number;
     };
@@ -5669,6 +5672,9 @@ type PostAnalytics = {
      * Video length in seconds. Currently Instagram Reels only; combine with igReelsAvgWatchTime (ms) to estimate retention. Null when unknown (other platforms, non-video media, or when Instagram does not expose the media URL, e.g. reels with copyrighted audio).
      */
     videoDurationSeconds?: (number) | null;
+    /**
+     * Percentage, rounded to 2 decimals: (likes + comments + shares + saves) / (impressions or reach or views) * 100. Clicks and follows are never counted. The denominator is the FIRST of impressions, reach, views that is non-zero, so it is not the same basis on every post: a post with impressions divides by impressions, one without falls back to reach, then to views. If you need a single consistent basis (e.g. interactions / reach), compute it from the raw fields above. The engagementRate on the LinkedIn account endpoints is a different formula.
+     */
     engagementRate?: number;
     lastUpdated?: string;
 };
@@ -15236,7 +15242,7 @@ type GetLinkedInPostAnalyticsResponse = ({
          */
         views?: number;
         /**
-         * Engagement rate as percentage
+         * Engagement rate, as a percentage rounded to 2 decimals: (likes + comments + shares + clicks + saves + sends) / impressions * 100. Unlike PostAnalytics.engagementRate on GET /v1/analytics, this one DOES count clicks and has no fallback denominator, so it is 0 whenever impressions is 0. For organization accounts the value is the rate LinkedIn returns, not one computed here.
          */
         engagementRate?: number;
     };

package/dist/index.d.ts

@@ -4051,6 +4051,9 @@ type ExternalPostSummary = {
         views?: number;
         reach?: number;
         impressions?: number;
+        /**
+         * Percentage, rounded to 2 decimals. Same definition as PostAnalytics.engagementRate: (likes + comments + shares + saves) / (impressions or reach or views) * 100, where the denominator is the first of the three that is non-zero. Clicks and follows are never counted.
+         */
         engagementRate?: number;
         /**
          * When these metrics were last refreshed
@@ -5329,7 +5332,7 @@ type LinkedInAggregateAnalyticsTotalResponse = {
          */
         sends?: number;
         /**
-         * Overall engagement rate as percentage
+         * Overall engagement rate, as a percentage rounded to 2 decimals: (reactions + comments + shares + saves + sends) / impressions * 100. Clicks are not counted, and there is no fallback denominator, so this is 0 whenever impressions is 0. This is NOT the same formula as PostAnalytics.engagementRate on GET /v1/analytics.
          */
         engagementRate?: number;
     };
@@ -5669,6 +5672,9 @@ type PostAnalytics = {
      * Video length in seconds. Currently Instagram Reels only; combine with igReelsAvgWatchTime (ms) to estimate retention. Null when unknown (other platforms, non-video media, or when Instagram does not expose the media URL, e.g. reels with copyrighted audio).
      */
     videoDurationSeconds?: (number) | null;
+    /**
+     * Percentage, rounded to 2 decimals: (likes + comments + shares + saves) / (impressions or reach or views) * 100. Clicks and follows are never counted. The denominator is the FIRST of impressions, reach, views that is non-zero, so it is not the same basis on every post: a post with impressions divides by impressions, one without falls back to reach, then to views. If you need a single consistent basis (e.g. interactions / reach), compute it from the raw fields above. The engagementRate on the LinkedIn account endpoints is a different formula.
+     */
     engagementRate?: number;
     lastUpdated?: string;
 };
@@ -15236,7 +15242,7 @@ type GetLinkedInPostAnalyticsResponse = ({
          */
         views?: number;
         /**
-         * Engagement rate as percentage
+         * Engagement rate, as a percentage rounded to 2 decimals: (likes + comments + shares + clicks + saves + sends) / impressions * 100. Unlike PostAnalytics.engagementRate on GET /v1/analytics, this one DOES count clicks and has no fallback denominator, so it is 0 whenever impressions is 0. For organization accounts the value is the rate LinkedIn returns, not one computed here.
          */
         engagementRate?: 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.581",
+  version: "0.2.582",
   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.581",
+  version: "0.2.582",
   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.581",
+  "version": "0.2.582",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/types.gen.ts

@@ -2852,6 +2852,9 @@ export type ExternalPostSummary = {
         views?: number;
         reach?: number;
         impressions?: number;
+        /**
+         * Percentage, rounded to 2 decimals. Same definition as PostAnalytics.engagementRate: (likes + comments + shares + saves) / (impressions or reach or views) * 100, where the denominator is the first of the three that is non-zero. Clicks and follows are never counted.
+         */
         engagementRate?: number;
         /**
          * When these metrics were last refreshed
@@ -4174,7 +4177,7 @@ export type LinkedInAggregateAnalyticsTotalResponse = {
          */
         sends?: number;
         /**
-         * Overall engagement rate as percentage
+         * Overall engagement rate, as a percentage rounded to 2 decimals: (reactions + comments + shares + saves + sends) / impressions * 100. Clicks are not counted, and there is no fallback denominator, so this is 0 whenever impressions is 0. This is NOT the same formula as PostAnalytics.engagementRate on GET /v1/analytics.
          */
         engagementRate?: number;
     };
@@ -4538,6 +4541,9 @@ export type PostAnalytics = {
      * Video length in seconds. Currently Instagram Reels only; combine with igReelsAvgWatchTime (ms) to estimate retention. Null when unknown (other platforms, non-video media, or when Instagram does not expose the media URL, e.g. reels with copyrighted audio).
      */
     videoDurationSeconds?: (number) | null;
+    /**
+     * Percentage, rounded to 2 decimals: (likes + comments + shares + saves) / (impressions or reach or views) * 100. Clicks and follows are never counted. The denominator is the FIRST of impressions, reach, views that is non-zero, so it is not the same basis on every post: a post with impressions divides by impressions, one without falls back to reach, then to views. If you need a single consistent basis (e.g. interactions / reach), compute it from the raw fields above. The engagementRate on the LinkedIn account endpoints is a different formula.
+     */
     engagementRate?: number;
     lastUpdated?: string;
 };
@@ -14668,7 +14674,7 @@ export type GetLinkedInPostAnalyticsResponse = ({
          */
         views?: number;
         /**
-         * Engagement rate as percentage
+         * Engagement rate, as a percentage rounded to 2 decimals: (likes + comments + shares + clicks + saves + sends) / impressions * 100. Unlike PostAnalytics.engagementRate on GET /v1/analytics, this one DOES count clicks and has no fallback denominator, so it is 0 whenever impressions is 0. For organization accounts the value is the rate LinkedIn returns, not one computed here.
          */
         engagementRate?: number;
     };