@zernio/node 0.2.132 → 0.2.134

package/dist/index.d.mts

@@ -10453,13 +10453,17 @@ type ListInboxCommentsResponse = ({
          */
         subreddit?: (string) | null;
         /**
-         * True when this row is an ad (boosted/dark post). `platform` is then the comment platform (facebook or instagram), `id` equals `adId`, and the thread is at GET /v1/ads/{adId}/comments.
+         * True when this row is an ad (boosted/dark post). `platform` is then the placement (facebook = the Page dark post / instagram = the IG media), `id` is `{adId}:{placement}`, and the thread is at GET /v1/ads/{adId}/comments?placement={placement}.
          */
         isAd?: boolean;
         /**
-         * Internal Zernio ad id — only on ad rows (same value as `id`).
+         * Internal Zernio ad id — only on ad rows.
          */
         adId?: string;
+        /**
+         * Which side of the ad this row's comments are on — only on ad rows.
+         */
+        placement?: 'facebook' | 'instagram';
     }>;
     pagination?: {
         hasMore?: boolean;
@@ -13819,6 +13823,10 @@ type GetAdCommentsData = {
          */
         cursor?: string;
         limit?: number;
+        /**
+         * Which side of the ad to return comments for. Omit to default to the Instagram side when present, else Facebook. Returns ad_not_commentable if the ad has no such placement.
+         */
+        placement?: 'facebook' | 'instagram';
     };
 };
 type GetAdCommentsResponse = ({
@@ -13831,7 +13839,14 @@ type GetAdCommentsResponse = ({
         cursor?: string;
     };
     meta: {
+        /**
+         * Which side these comments are on (same as `placement`).
+         */
         platform: 'facebook' | 'instagram';
+        /**
+         * The placement these comments are for — useful when you didn't pass ?placement= and want to know which one you got.
+         */
+        placement: 'facebook' | 'instagram';
         /**
          * Internal Zernio ad ID.
          */
@@ -13841,9 +13856,13 @@ type GetAdCommentsResponse = ({
          */
         platformAdId: string;
         /**
-         * Underlying post ID the comments belong to. effective_object_story_id for Facebook, effective_instagram_media_id for Instagram.
+         * Underlying post ID the comments belong to. effective_object_story_id for the Facebook side, effective_instagram_media_id for the Instagram side.
          */
         effectiveStoryId: string;
+        /**
+         * Facebook-only. The connected Facebook Page SocialAccount these comments were read through — pass it as `accountId` (with `effectiveStoryId` as the postId) to /v1/inbox/comments to reply/hide/delete. Null when no connected Page was used (then moderation isn't possible).
+         */
+        facebookAccountId?: (string) | null;
         /**
          * Instagram-only. The Instagram-scoped business ID that owns the boosted media (creative.instagram_user_id).
          */
@@ -13853,7 +13872,7 @@ type GetAdCommentsResponse = ({
          */
         instagramPermalink?: string;
         /**
-         * Instagram-only. The connected Instagram SocialAccount these comments were read through — use it for reply/hide actions via /v1/inbox/comments.
+         * Instagram-only. The connected Instagram SocialAccount these comments were read through — pass it as `accountId` (with `effectiveStoryId` as the postId) to /v1/inbox/comments to reply/hide/delete.
          */
         instagramAccountId?: string;
         /**

package/dist/index.d.ts

@@ -10453,13 +10453,17 @@ type ListInboxCommentsResponse = ({
          */
         subreddit?: (string) | null;
         /**
-         * True when this row is an ad (boosted/dark post). `platform` is then the comment platform (facebook or instagram), `id` equals `adId`, and the thread is at GET /v1/ads/{adId}/comments.
+         * True when this row is an ad (boosted/dark post). `platform` is then the placement (facebook = the Page dark post / instagram = the IG media), `id` is `{adId}:{placement}`, and the thread is at GET /v1/ads/{adId}/comments?placement={placement}.
          */
         isAd?: boolean;
         /**
-         * Internal Zernio ad id — only on ad rows (same value as `id`).
+         * Internal Zernio ad id — only on ad rows.
          */
         adId?: string;
+        /**
+         * Which side of the ad this row's comments are on — only on ad rows.
+         */
+        placement?: 'facebook' | 'instagram';
     }>;
     pagination?: {
         hasMore?: boolean;
@@ -13819,6 +13823,10 @@ type GetAdCommentsData = {
          */
         cursor?: string;
         limit?: number;
+        /**
+         * Which side of the ad to return comments for. Omit to default to the Instagram side when present, else Facebook. Returns ad_not_commentable if the ad has no such placement.
+         */
+        placement?: 'facebook' | 'instagram';
     };
 };
 type GetAdCommentsResponse = ({
@@ -13831,7 +13839,14 @@ type GetAdCommentsResponse = ({
         cursor?: string;
     };
     meta: {
+        /**
+         * Which side these comments are on (same as `placement`).
+         */
         platform: 'facebook' | 'instagram';
+        /**
+         * The placement these comments are for — useful when you didn't pass ?placement= and want to know which one you got.
+         */
+        placement: 'facebook' | 'instagram';
         /**
          * Internal Zernio ad ID.
          */
@@ -13841,9 +13856,13 @@ type GetAdCommentsResponse = ({
          */
         platformAdId: string;
         /**
-         * Underlying post ID the comments belong to. effective_object_story_id for Facebook, effective_instagram_media_id for Instagram.
+         * Underlying post ID the comments belong to. effective_object_story_id for the Facebook side, effective_instagram_media_id for the Instagram side.
          */
         effectiveStoryId: string;
+        /**
+         * Facebook-only. The connected Facebook Page SocialAccount these comments were read through — pass it as `accountId` (with `effectiveStoryId` as the postId) to /v1/inbox/comments to reply/hide/delete. Null when no connected Page was used (then moderation isn't possible).
+         */
+        facebookAccountId?: (string) | null;
         /**
          * Instagram-only. The Instagram-scoped business ID that owns the boosted media (creative.instagram_user_id).
          */
@@ -13853,7 +13872,7 @@ type GetAdCommentsResponse = ({
          */
         instagramPermalink?: string;
         /**
-         * Instagram-only. The connected Instagram SocialAccount these comments were read through — use it for reply/hide actions via /v1/inbox/comments.
+         * Instagram-only. The connected Instagram SocialAccount these comments were read through — pass it as `accountId` (with `effectiveStoryId` as the postId) to /v1/inbox/comments to reply/hide/delete.
          */
         instagramAccountId?: string;
         /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zernio/node",
-  "version": "0.2.132",
+  "version": "0.2.134",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -2082,12 +2082,15 @@ export const deleteTelegramCommands = <ThrowOnError extends boolean = false>(opt
  * Returns posts with comment counts from all connected accounts. Aggregates data across multiple accounts.
  *
  * For users with the Ads add-on (Metronome plans always qualify), the user's Meta ads
- * (boosted/dark posts) are included too, flagged with `isAd: true` and an `adId`. Use
+ * (boosted/dark posts) are included too. There's one row per (ad, placement-with-comments):
+ * an ad that runs on both Facebook feed and Instagram feed produces up to two rows (the
+ * Page dark post and the IG media have separate comment threads), each flagged
+ * `isAd: true` with `adId` and `placement` (`id` is `{adId}:{placement}`). Use
  * `?platform=metaads` to return *only* ad rows; passing `facebook`/`instagram` returns
- * *organic* posts only (no ads); omitting `platform` returns both. Fetch an ad row's
- * thread from GET /v1/ads/{adId}/comments. Ad comment counts are read with the Marketing
- * API token (Facebook) or the connected Instagram account's token (Instagram); an ad
- * whose count can't be read is omitted.
+ * *organic* posts only (no ads); omitting `platform` returns both. Fetch a row's thread
+ * from GET /v1/ads/{adId}/comments?placement={placement}. Ad comment counts are read with
+ * the Marketing API token (Facebook side) or the connected Instagram account's token
+ * (Instagram side); a row whose count can't be read is omitted.
  *
  */
 export const listInboxComments = <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<ListInboxCommentsData, ThrowOnError>) => {
@@ -3485,14 +3488,17 @@ export const getAdAnalytics = <ThrowOnError extends boolean = false>(options: Op
  * regular GET /v1/inbox/comments/{postId} endpoint cannot serve because dark posts are
  * not in Zernio's post database.
  *
- * Resolves the ad's creative effective_object_story_id (Facebook) or
- * effective_instagram_media_id (Instagram) via the Marketing API on each call
- * (cached in-process by the platform client), then fetches comments from the Graph API.
- *
- * For Instagram-placed ads, the Instagram account that runs the ad must be connected
- * to Zernio — comments are read through that account's token. If none of the connected
- * Instagram accounts on the profile can read the ad's media, the call returns
- * ads_connection_required.
+ * An ad that runs on both Facebook feed and Instagram feed has two separate underlying
+ * posts with separate comment threads (the creative's effective_object_story_id and
+ * effective_instagram_media_id). Use the `placement` query param to pick one; with no
+ * param the Instagram side is returned when it exists, otherwise Facebook. The
+ * identifiers are read from the ad record (persisted during sync) with a Marketing-API
+ * fallback for ads that predate the field.
+ *
+ * For Instagram-placed comments, the Instagram account that runs the ad must be connected
+ * to Zernio — those comments are read through that account's token. If no connected
+ * Instagram account on the profile can read the ad's media, the call returns
+ * ads_connection_required (the Facebook side, if any, is still readable via ?placement=facebook).
  *
  * Meta-only. Other ad platforms (TikTok, LinkedIn, Pinterest, Google, X) do not
  * expose a public per-ad comments API and return feature_not_available.

package/src/generated/types.gen.ts

@@ -10455,13 +10455,17 @@ export type ListInboxCommentsResponse = ({
          */
         subreddit?: (string) | null;
         /**
-         * True when this row is an ad (boosted/dark post). `platform` is then the comment platform (facebook or instagram), `id` equals `adId`, and the thread is at GET /v1/ads/{adId}/comments.
+         * True when this row is an ad (boosted/dark post). `platform` is then the placement (facebook = the Page dark post / instagram = the IG media), `id` is `{adId}:{placement}`, and the thread is at GET /v1/ads/{adId}/comments?placement={placement}.
          */
         isAd?: boolean;
         /**
-         * Internal Zernio ad id — only on ad rows (same value as `id`).
+         * Internal Zernio ad id — only on ad rows.
          */
         adId?: string;
+        /**
+         * Which side of the ad this row's comments are on — only on ad rows.
+         */
+        placement?: 'facebook' | 'instagram';
     }>;
     pagination?: {
         hasMore?: boolean;
@@ -14138,6 +14142,10 @@ export type GetAdCommentsData = {
          */
         cursor?: string;
         limit?: number;
+        /**
+         * Which side of the ad to return comments for. Omit to default to the Instagram side when present, else Facebook. Returns ad_not_commentable if the ad has no such placement.
+         */
+        placement?: 'facebook' | 'instagram';
     };
 };
 
@@ -14151,7 +14159,14 @@ export type GetAdCommentsResponse = ({
         cursor?: string;
     };
     meta: {
+        /**
+         * Which side these comments are on (same as `placement`).
+         */
         platform: 'facebook' | 'instagram';
+        /**
+         * The placement these comments are for — useful when you didn't pass ?placement= and want to know which one you got.
+         */
+        placement: 'facebook' | 'instagram';
         /**
          * Internal Zernio ad ID.
          */
@@ -14161,9 +14176,13 @@ export type GetAdCommentsResponse = ({
          */
         platformAdId: string;
         /**
-         * Underlying post ID the comments belong to. effective_object_story_id for Facebook, effective_instagram_media_id for Instagram.
+         * Underlying post ID the comments belong to. effective_object_story_id for the Facebook side, effective_instagram_media_id for the Instagram side.
          */
         effectiveStoryId: string;
+        /**
+         * Facebook-only. The connected Facebook Page SocialAccount these comments were read through — pass it as `accountId` (with `effectiveStoryId` as the postId) to /v1/inbox/comments to reply/hide/delete. Null when no connected Page was used (then moderation isn't possible).
+         */
+        facebookAccountId?: (string) | null;
         /**
          * Instagram-only. The Instagram-scoped business ID that owns the boosted media (creative.instagram_user_id).
          */
@@ -14173,7 +14192,7 @@ export type GetAdCommentsResponse = ({
          */
         instagramPermalink?: string;
         /**
-         * Instagram-only. The connected Instagram SocialAccount these comments were read through — use it for reply/hide actions via /v1/inbox/comments.
+         * Instagram-only. The connected Instagram SocialAccount these comments were read through — pass it as `accountId` (with `effectiveStoryId` as the postId) to /v1/inbox/comments to reply/hide/delete.
          */
         instagramAccountId?: string;
         /**