@getlatedev/node 0.2.1108 → 0.2.1110

package/src/generated/sdk.gen.ts

@@ -10654,6 +10654,11 @@ export const getAdReview = <ThrowOnError extends boolean = false>(options: Optio
  * creative (`asset_feed_spec`). Video items include Meta's poster thumbnail and the
  * video's Meta id when available.
  *
+ * Boosted Instagram posts (creatives with no image of their own) return the original
+ * post's media: the image, the video with its cover as `thumbnailUrl`, or every child of a
+ * carousel post with `index`. When the connection cannot read the Instagram post, the item
+ * is a 1080px rendering of the creative instead.
+ *
  * Reads Meta live rather than the stored creative blob because Meta's signed fbcdn
  * URLs carry an `oe=<hex>` expiration (image_url ~24 h, video source ~12 d). Treat
  * URLs as short-lived: re-fetch this endpoint before serving or downloading assets

package/src/generated/types.gen.ts

@@ -9040,6 +9040,10 @@ export type PlatformAnalytics = {
      * Failure detail. On failed entries, why the post failed to publish. On unavailable entries, why analytics cannot be synced (e.g. Google Business Profile, a TikTok upload that never received a video id). On pending entries, the most recent analytics sync error for the account (null while no sync has failed), cleared after the next successful sync.
      */
     errorMessage?: (string) | null;
+    /**
+     * Stable machine-readable reason for errorMessage. post_not_found: the post was deleted or is no longer visible to the account. permission_missing: the last analytics sync of the Facebook account failed because the Page no longer grants pages_read_engagement (pending entries only). null: no stable code, read errorMessage. New values may be added.
+     */
+    errorCode?: ('post_not_found' | 'permission_missing') | null;
 };
 
 export type status24 = 'published' | 'failed';
@@ -9049,6 +9053,11 @@ export type status24 = 'published' | 'failed';
  */
 export type syncStatus2 = 'synced' | 'pending' | 'unavailable';
 
+/**
+ * Stable machine-readable reason for errorMessage. post_not_found: the post was deleted or is no longer visible to the account. permission_missing: the last analytics sync of the Facebook account failed because the Page no longer grants pages_read_engagement (pending entries only). null: no stable code, read errorMessage. New values may be added.
+ */
+export type errorCode = 'post_not_found' | 'permission_missing';
+
 export type PlatformTarget = {
     /**
      * Supported values: twitter, threads, instagram, youtube, facebook, linkedin, pinterest, reddit, tiktok, bluesky, googlebusiness, telegram
@@ -13610,8 +13619,15 @@ export type WebhookPayloadMessage = {
         isStoryMention?: boolean;
         /**
          * Click attribution forwarded verbatim from Meta. Populated only on
-         * the FIRST inbound message after the click; absent on subsequent
-         * messages of the same conversation. On Instagram and Messenger a
+         * the first inbound message Meta attaches it to, and absent on the
+         * other messages of the same conversation. That is not always the
+         * first message after the click: on Instagram Click-to-Direct Meta
+         * usually delivers the ad post itself first, as an attachment-only
+         * `share` / `ig_post` message with no referral, and attaches the
+         * referral to the message right after it. The first referral of a
+         * conversation is also stored on the conversation as
+         * `metadata.meta_ad_*` (`GET /v1/inbox/conversations/{conversationId}`),
+         * so read it there instead of matching webhooks. On Instagram and Messenger a
          * RETURNING click also attaches it to the first message that
          * follows, so read it on every `message.received` for per-click
          * attribution; a click that opens an existing thread WITHOUT a
@@ -27082,10 +27098,12 @@ export type GetInboxConversationResponse = ({
          * Ad-click attribution for a conversation that started from a Meta ad.
          * Absent when the conversation did not originate from an ad click.
          *
-         * Captured once, on the first inbound message after the click, and never
-         * overwritten. If the same person later clicks a different ad, the
-         * original values are kept. Meta only sends the referral on that first
-         * message.
+         * Captured once, from the first inbound message Meta attaches the referral
+         * to, and never overwritten. If the same person later clicks a different
+         * ad, the original values are kept. On Instagram Click-to-Direct that is
+         * usually not the first message: Meta first delivers the ad post as an
+         * attachment-only `share` / `ig_post` message with no referral, then
+         * attaches the referral to the next message.
          *
          * This operation currently returns only the `meta_ad_*` family, which
          * covers Instagram Click-to-Direct and Facebook Messenger