@zernio/node 0.2.1431 → 0.2.1433

package/dist/index.d.mts

@@ -6743,22 +6743,30 @@ type CampaignSubmissionFlag = {
 };
 type code = 'duplicate_media' | 'duplicate_post' | 'view_spike' | 'linked_accounts' | 'cross_operator' | 'unreachable' | 'post_deleted' | 'account_restricted' | 'low_authenticity' | 'x_read_cap' | 'paid_views' | 'organic_unverified';
 /**
- * Facebook only. The media on a comment (sticker, GIF, photo, shared link or video). One attachment per
- * comment, a single object. URLs are expiring Meta CDN links (oe= expiry), so fetch promptly. Instagram
- * comments carry no media.
+ * The media on a comment or reply, one per comment (the first item when the platform returns several).
+ * `type` is the platform's own media kind:
+ *
+ * - Facebook: sticker, animated_image_share, photo, image_share, share or video_inline.
+ * - TikTok: image.
+ * - X: photo, video or animated_gif. A video `url` is an mp4 and `imageUrl` its preview.
+ * - Threads: IMAGE, VIDEO or GIF. Album replies carry no attachment.
+ * - Bluesky: image, video or external (link cards, GIFs arrive this way). A video `url` is an HLS playlist (.m3u8).
+ *
+ * Facebook and Threads URLs are expiring Meta CDN links, so fetch promptly.
+ * Instagram, YouTube, LinkedIn and Reddit comments carry no media.
  *
  */
 type CommentAttachment = {
     /**
-     * Attachment type as Facebook reports it, for example sticker, animated_image_share, photo, image_share, share or video_inline.
+     * The platform's own media kind, see the schema description for each platform's values.
      */
     type: string;
     /**
-     * Rendered image/preview URL (from attachment.media.image.src).
+     * Rendered image or preview URL.
      */
     imageUrl?: string;
     /**
-     * Source URL (from attachment.url). For GIFs this is an l.facebook.com redirect.
+     * Source or playable URL. Facebook GIFs carry an l.facebook.com redirect, X videos an mp4, Bluesky videos an HLS playlist.
      */
     url?: string;
 };
@@ -24497,6 +24505,27 @@ type GetDailyMetricsResponse = ({
         clicks?: number;
         views?: number;
     }>;
+    /**
+     * Sums of the whole range for the applied filters.
+     */
+    totals?: {
+        postCount?: number;
+        impressions?: number;
+        /**
+         * Sum of per-post reach, not unique accounts.
+         */
+        reach?: number;
+        likes?: number;
+        comments?: number;
+        shares?: number;
+        saves?: number;
+        clicks?: number;
+        views?: number;
+        /**
+         * Likes, comments, shares and saves (interactions).
+         */
+        engagement?: number;
+    };
 });
 type GetDailyMetricsError = (ErrorResponse | {
     error?: string;
@@ -39241,7 +39270,7 @@ type GetInboxPostCommentsResponse = ({
          */
         isLiked?: boolean;
         /**
-         * Facebook only. The comment's sticker, GIF, photo, share or video, whenever Facebook returns one (replies included). Absent when the comment has no media and on every other platform.
+         * The comment's media, whenever the platform returns one (replies included). Supported on Facebook, TikTok, X, Threads and Bluesky; absent when the comment has no media and on every other platform. See CommentAttachment for each platform's `type` values.
          */
         attachment?: (CommentAttachment);
         /**

package/dist/index.d.ts

@@ -6743,22 +6743,30 @@ type CampaignSubmissionFlag = {
 };
 type code = 'duplicate_media' | 'duplicate_post' | 'view_spike' | 'linked_accounts' | 'cross_operator' | 'unreachable' | 'post_deleted' | 'account_restricted' | 'low_authenticity' | 'x_read_cap' | 'paid_views' | 'organic_unverified';
 /**
- * Facebook only. The media on a comment (sticker, GIF, photo, shared link or video). One attachment per
- * comment, a single object. URLs are expiring Meta CDN links (oe= expiry), so fetch promptly. Instagram
- * comments carry no media.
+ * The media on a comment or reply, one per comment (the first item when the platform returns several).
+ * `type` is the platform's own media kind:
+ *
+ * - Facebook: sticker, animated_image_share, photo, image_share, share or video_inline.
+ * - TikTok: image.
+ * - X: photo, video or animated_gif. A video `url` is an mp4 and `imageUrl` its preview.
+ * - Threads: IMAGE, VIDEO or GIF. Album replies carry no attachment.
+ * - Bluesky: image, video or external (link cards, GIFs arrive this way). A video `url` is an HLS playlist (.m3u8).
+ *
+ * Facebook and Threads URLs are expiring Meta CDN links, so fetch promptly.
+ * Instagram, YouTube, LinkedIn and Reddit comments carry no media.
  *
  */
 type CommentAttachment = {
     /**
-     * Attachment type as Facebook reports it, for example sticker, animated_image_share, photo, image_share, share or video_inline.
+     * The platform's own media kind, see the schema description for each platform's values.
      */
     type: string;
     /**
-     * Rendered image/preview URL (from attachment.media.image.src).
+     * Rendered image or preview URL.
      */
     imageUrl?: string;
     /**
-     * Source URL (from attachment.url). For GIFs this is an l.facebook.com redirect.
+     * Source or playable URL. Facebook GIFs carry an l.facebook.com redirect, X videos an mp4, Bluesky videos an HLS playlist.
      */
     url?: string;
 };
@@ -24497,6 +24505,27 @@ type GetDailyMetricsResponse = ({
         clicks?: number;
         views?: number;
     }>;
+    /**
+     * Sums of the whole range for the applied filters.
+     */
+    totals?: {
+        postCount?: number;
+        impressions?: number;
+        /**
+         * Sum of per-post reach, not unique accounts.
+         */
+        reach?: number;
+        likes?: number;
+        comments?: number;
+        shares?: number;
+        saves?: number;
+        clicks?: number;
+        views?: number;
+        /**
+         * Likes, comments, shares and saves (interactions).
+         */
+        engagement?: number;
+    };
 });
 type GetDailyMetricsError = (ErrorResponse | {
     error?: string;
@@ -39241,7 +39270,7 @@ type GetInboxPostCommentsResponse = ({
          */
         isLiked?: boolean;
         /**
-         * Facebook only. The comment's sticker, GIF, photo, share or video, whenever Facebook returns one (replies included). Absent when the comment has no media and on every other platform.
+         * The comment's media, whenever the platform returns one (replies included). Supported on Facebook, TikTok, X, Threads and Bluesky; absent when the comment has no media and on every other platform. See CommentAttachment for each platform's `type` values.
          */
         attachment?: (CommentAttachment);
         /**

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -524,6 +524,8 @@ export const getYouTubeDemographics = <ThrowOnError extends boolean = false>(opt
  * Each day includes post count, platform distribution, and summed metrics (impressions, reach, likes, comments, shares, saves, clicks, views).
  * Defaults to the last 180 days.
  *
+ * `totals` sums the whole range for the applied filters (pass `accountId` for one account). With attribution "publish" they are the lifetime metrics of posts published in the range, with "received" the engagement that arrived in the range.
+ *
  */
 export const getDailyMetrics = <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<GetDailyMetricsData, ThrowOnError>) => {
     return (options?.client ?? client).get<GetDailyMetricsResponse, GetDailyMetricsError, ThrowOnError>({

package/src/generated/types.gen.ts

@@ -4669,22 +4669,30 @@ export type CampaignSubmissionFlag = {
 export type code = 'duplicate_media' | 'duplicate_post' | 'view_spike' | 'linked_accounts' | 'cross_operator' | 'unreachable' | 'post_deleted' | 'account_restricted' | 'low_authenticity' | 'x_read_cap' | 'paid_views' | 'organic_unverified';
 
 /**
- * Facebook only. The media on a comment (sticker, GIF, photo, shared link or video). One attachment per
- * comment, a single object. URLs are expiring Meta CDN links (oe= expiry), so fetch promptly. Instagram
- * comments carry no media.
+ * The media on a comment or reply, one per comment (the first item when the platform returns several).
+ * `type` is the platform's own media kind:
+ *
+ * - Facebook: sticker, animated_image_share, photo, image_share, share or video_inline.
+ * - TikTok: image.
+ * - X: photo, video or animated_gif. A video `url` is an mp4 and `imageUrl` its preview.
+ * - Threads: IMAGE, VIDEO or GIF. Album replies carry no attachment.
+ * - Bluesky: image, video or external (link cards, GIFs arrive this way). A video `url` is an HLS playlist (.m3u8).
+ *
+ * Facebook and Threads URLs are expiring Meta CDN links, so fetch promptly.
+ * Instagram, YouTube, LinkedIn and Reddit comments carry no media.
  *
  */
 export type CommentAttachment = {
     /**
-     * Attachment type as Facebook reports it, for example sticker, animated_image_share, photo, image_share, share or video_inline.
+     * The platform's own media kind, see the schema description for each platform's values.
      */
     type: string;
     /**
-     * Rendered image/preview URL (from attachment.media.image.src).
+     * Rendered image or preview URL.
      */
     imageUrl?: string;
     /**
-     * Source URL (from attachment.url). For GIFs this is an l.facebook.com redirect.
+     * Source or playable URL. Facebook GIFs carry an l.facebook.com redirect, X videos an mp4, Bluesky videos an HLS playlist.
      */
     url?: string;
 };
@@ -23233,6 +23241,27 @@ export type GetDailyMetricsResponse = ({
         clicks?: number;
         views?: number;
     }>;
+    /**
+     * Sums of the whole range for the applied filters.
+     */
+    totals?: {
+        postCount?: number;
+        impressions?: number;
+        /**
+         * Sum of per-post reach, not unique accounts.
+         */
+        reach?: number;
+        likes?: number;
+        comments?: number;
+        shares?: number;
+        saves?: number;
+        clicks?: number;
+        views?: number;
+        /**
+         * Likes, comments, shares and saves (interactions).
+         */
+        engagement?: number;
+    };
 });
 
 export type GetDailyMetricsError = (ErrorResponse | {
@@ -39017,7 +39046,7 @@ export type GetInboxPostCommentsResponse = ({
          */
         isLiked?: boolean;
         /**
-         * Facebook only. The comment's sticker, GIF, photo, share or video, whenever Facebook returns one (replies included). Absent when the comment has no media and on every other platform.
+         * The comment's media, whenever the platform returns one (replies included). Supported on Facebook, TikTok, X, Threads and Bluesky; absent when the comment has no media and on every other platform. See CommentAttachment for each platform's `type` values.
          */
         attachment?: (CommentAttachment);
         /**