@getlatedev/node 0.2.1192 → 0.2.1194

package/dist/index.d.mts

@@ -14817,13 +14817,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 +42494,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

@@ -14817,13 +14817,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 +42494,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.1192",
+  version: "0.2.1194",
   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.1192",
+  version: "0.2.1194",
   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.1192",
+  "version": "0.2.1194",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -5717,11 +5717,13 @@ export const createVoiceWebSession = <ThrowOnError extends boolean = false>(opti
 
 /**
  * Dial from the browser softphone
- * Step 2 of the browser softphone handshake: places an outbound call
- * whose answered leg is bridged to the browser registered with the
- * credential from `POST /v1/voice/calls/web`. The call runs through the
- * normal outbound lane, so it is logged as outbound (from = your number,
- * to = target) and recorded per the number's settings.
+ * Step 2 of the browser softphone handshake: rings the browser registered
+ * with the credential from `POST /v1/voice/calls/web` first, and dials
+ * the target only once the browser answers, so the callee's pickup
+ * connects immediately with no ringing after they answer. The call is
+ * logged as outbound (from = your number, to = target) and recorded per
+ * the number's settings. `ringTimeoutSeconds` applies to the target's
+ * phone, not to the browser.
  *
  */
 export const dialVoiceWebCall = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<DialVoiceWebCallData, ThrowOnError>) => {
@@ -10641,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
@@ -11268,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

@@ -13372,13 +13372,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 +42992,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 | {