@getlatedev/node 0.2.1193 → 0.2.1195

package/dist/index.d.mts

@@ -11150,6 +11150,9 @@ type Post = {
      */
     queueId?: string;
     createdAt?: string;
+    /**
+     * Last change to the post or to any of its platforms (a publish, a failure, a resolved URL).
+     */
     updatedAt?: string;
 };
 type visibility2 = 'public' | 'private' | 'unlisted';
@@ -14817,13 +14820,14 @@ type WebhookPayloadComment = {
          * Facebook: populated from a Graph API lookup of the parent post. Present when the post is an
          * ad dark post (isDarkPost true, whatever its promotionStatus) or an organic post that is or was
          * boosted (promotionStatus "active", "extendable" or "finished"). Meta does not link a dark post
-         * back to its ad, so id and title are never set on Facebook.
+         * back to its ad, so on Facebook id is set only when exactly one ad on the Page, created before the
+         * dark post, carries the same copy as the post. title is never set on Facebook.
          * Absent for comments on organic posts that are not promoted.
          *
          */
         ad?: {
             /**
-             * Meta ad ID (Instagram only).
+             * Meta ad ID. Instagram: from the webhook. Facebook: only on a dark post matched to a single ad by its copy.
              */
             id?: string;
             /**
@@ -42493,6 +42497,39 @@ type GetAdResponse = ({
      * Only with `live=true`. When the switches were read from the platform; null when the live read failed and the stored values were returned.
      */
     statusReadAt?: (string) | null;
+    /**
+     * Only when `{adId}` is a Facebook ad dark post with no resolvable ad (then `ad` is null).
+     */
+    darkPost?: {
+        platform?: 'facebook';
+        /**
+         * The dark post id, `{pageId}_{postId}`.
+         */
+        platformPostId?: string;
+        pageId?: string;
+        /**
+         * Always true.
+         */
+        isDarkPost?: boolean;
+        /**
+         * Always null: Meta exposes no link from a placement dark post to its ad.
+         */
+        adId?: (string) | null;
+        /**
+         * Zernio Meta Ads account id for the Page, null when none is connected.
+         */
+        accountId?: (string) | null;
+        /**
+         * Zernio Facebook account id of the Page.
+         */
+        facebookAccountId?: string;
+        /**
+         * Meta ad accounts (`act_...`) with synced ads on this Page.
+         */
+        platformAdAccountIds?: Array<(string)>;
+        firstSeenAt?: string;
+        lastActivityAt?: string;
+    };
 });
 type GetAdError = (ErrorResponse | {
     error?: string;

package/dist/index.d.ts

@@ -11150,6 +11150,9 @@ type Post = {
      */
     queueId?: string;
     createdAt?: string;
+    /**
+     * Last change to the post or to any of its platforms (a publish, a failure, a resolved URL).
+     */
     updatedAt?: string;
 };
 type visibility2 = 'public' | 'private' | 'unlisted';
@@ -14817,13 +14820,14 @@ type WebhookPayloadComment = {
          * Facebook: populated from a Graph API lookup of the parent post. Present when the post is an
          * ad dark post (isDarkPost true, whatever its promotionStatus) or an organic post that is or was
          * boosted (promotionStatus "active", "extendable" or "finished"). Meta does not link a dark post
-         * back to its ad, so id and title are never set on Facebook.
+         * back to its ad, so on Facebook id is set only when exactly one ad on the Page, created before the
+         * dark post, carries the same copy as the post. title is never set on Facebook.
          * Absent for comments on organic posts that are not promoted.
          *
          */
         ad?: {
             /**
-             * Meta ad ID (Instagram only).
+             * Meta ad ID. Instagram: from the webhook. Facebook: only on a dark post matched to a single ad by its copy.
              */
             id?: string;
             /**
@@ -42493,6 +42497,39 @@ type GetAdResponse = ({
      * Only with `live=true`. When the switches were read from the platform; null when the live read failed and the stored values were returned.
      */
     statusReadAt?: (string) | null;
+    /**
+     * Only when `{adId}` is a Facebook ad dark post with no resolvable ad (then `ad` is null).
+     */
+    darkPost?: {
+        platform?: 'facebook';
+        /**
+         * The dark post id, `{pageId}_{postId}`.
+         */
+        platformPostId?: string;
+        pageId?: string;
+        /**
+         * Always true.
+         */
+        isDarkPost?: boolean;
+        /**
+         * Always null: Meta exposes no link from a placement dark post to its ad.
+         */
+        adId?: (string) | null;
+        /**
+         * Zernio Meta Ads account id for the Page, null when none is connected.
+         */
+        accountId?: (string) | null;
+        /**
+         * Zernio Facebook account id of the Page.
+         */
+        facebookAccountId?: string;
+        /**
+         * Meta ad accounts (`act_...`) with synced ads on this Page.
+         */
+        platformAdAccountIds?: Array<(string)>;
+        firstSeenAt?: string;
+        lastActivityAt?: string;
+    };
 });
 type GetAdError = (ErrorResponse | {
     error?: string;

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -10643,10 +10643,21 @@ export const getAdsTimeline = <ThrowOnError extends boolean = false>(options: Op
  * - the creative's `effective_object_story_id` (`{pageId}_{postId}` shape, Facebook side)
  * - the creative's `effective_instagram_media_id` (Instagram side)
  *
- * Any of the four resolve to the same ad. Caller doesn't need a translation step.
+ * - an Instagram media id an ad comment arrived on (`comment.platformPostId` of a `comment.received`
+ * carrying `comment.ad.id`), including the extra media Meta creates for placement variants
+ *
+ * Any of these resolve to the same ad. Caller doesn't need a translation step.
  * `creative.creativeFeatures` holds the stored requested settings, which do not confirm
  * platform application.
  *
+ * **Facebook ad dark posts.** Meta gives an ad with per-placement assets one extra unpublished
+ * post per placement, and comments land on it. Meta exposes no link from that post to its ad.
+ * When exactly one ad on the Page, created before the dark post, carries the same copy as the
+ * post, the dark post id resolves to that ad. Otherwise, when the id is a dark post Zernio has
+ * seen comments on and its Page is connected, the response is `ad: null` plus `darkPost`, which
+ * carries the Meta Ads account and the ad accounts running ads for that Page. Read its comments
+ * with GET /v1/ads/{adId}/comments using the same id.
+ *
  * **Status freshness.** `status`, `configuredStatus`, `platformStatus`, `platformAdSetStatus`
  * and `platformCampaignStatus` are the values Zernio last stored. Background sync refreshes
  * them, typically within 15 to 60 minutes (Google up to about 3 hours), and ended or
@@ -11270,6 +11281,12 @@ export const updateAdTrackingTags = <ThrowOnError extends boolean = false>(optio
  * identifiers are read from the ad record (persisted during sync) with a Marketing-API
  * fallback for ads that predate the field.
  *
+ * Comments can land on extra posts Meta creates for placement variants, which the creative
+ * does not report. On Instagram, every media a `comment.received` for this ad arrived on is
+ * read too; on Facebook, every dark post matched to this ad by its copy. They are merged
+ * newest first. With more than one post, `pagination.cursor` is a Zernio cursor covering all
+ * of them: pass it back unchanged.
+ *
  * For Instagram-placed comments, the Instagram account that runs the ad must be connected
  * to Zernio, because 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

package/src/generated/types.gen.ts

@@ -9536,6 +9536,9 @@ export type Post = {
      */
     queueId?: string;
     createdAt?: string;
+    /**
+     * Last change to the post or to any of its platforms (a publish, a failure, a resolved URL).
+     */
     updatedAt?: string;
 };
 
@@ -13372,13 +13375,14 @@ export type WebhookPayloadComment = {
          * Facebook: populated from a Graph API lookup of the parent post. Present when the post is an
          * ad dark post (isDarkPost true, whatever its promotionStatus) or an organic post that is or was
          * boosted (promotionStatus "active", "extendable" or "finished"). Meta does not link a dark post
-         * back to its ad, so id and title are never set on Facebook.
+         * back to its ad, so on Facebook id is set only when exactly one ad on the Page, created before the
+         * dark post, carries the same copy as the post. title is never set on Facebook.
          * Absent for comments on organic posts that are not promoted.
          *
          */
         ad?: {
             /**
-             * Meta ad ID (Instagram only).
+             * Meta ad ID. Instagram: from the webhook. Facebook: only on a dark post matched to a single ad by its copy.
              */
             id?: string;
             /**
@@ -42991,6 +42995,39 @@ export type GetAdResponse = ({
      * Only with `live=true`. When the switches were read from the platform; null when the live read failed and the stored values were returned.
      */
     statusReadAt?: (string) | null;
+    /**
+     * Only when `{adId}` is a Facebook ad dark post with no resolvable ad (then `ad` is null).
+     */
+    darkPost?: {
+        platform?: 'facebook';
+        /**
+         * The dark post id, `{pageId}_{postId}`.
+         */
+        platformPostId?: string;
+        pageId?: string;
+        /**
+         * Always true.
+         */
+        isDarkPost?: boolean;
+        /**
+         * Always null: Meta exposes no link from a placement dark post to its ad.
+         */
+        adId?: (string) | null;
+        /**
+         * Zernio Meta Ads account id for the Page, null when none is connected.
+         */
+        accountId?: (string) | null;
+        /**
+         * Zernio Facebook account id of the Page.
+         */
+        facebookAccountId?: string;
+        /**
+         * Meta ad accounts (`act_...`) with synced ads on this Page.
+         */
+        platformAdAccountIds?: Array<(string)>;
+        firstSeenAt?: string;
+        lastActivityAt?: string;
+    };
 });
 
 export type GetAdError = (ErrorResponse | {