@zernio/node 0.2.824 → 0.2.826

package/dist/index.d.mts

@@ -6316,7 +6316,13 @@ type InboxWebhookAccount = {
  * The conversation context included in inbox webhook payloads.
  */
 type InboxWebhookConversation = {
+    /**
+     * Zernio's internal conversation id (also the message's conversationId). Accepted by every /v1/inbox/conversations/{conversationId} endpoint.
+     */
     id: string;
+    /**
+     * The platform's conversation id. This is the `id` GET /v1/inbox/conversations returns for the same conversation (on Instagram and Messenger it is the participant's IGSID / PSID), so key your records on it to match webhooks with list rows. Also accepted by the conversation endpoints.
+     */
     platformConversationId: string;
     participantId?: string;
     participantName?: string;
@@ -6340,10 +6346,13 @@ type status11 = 'active' | 'archived';
  */
 type InboxWebhookConversationDetail = {
     /**
-     * Internal conversation ID
+     * The platform's conversation id, equal to `conversation.platformConversationId` on inbox webhooks (whose `conversation.id` is Zernio's internal id). Both are accepted by the conversation endpoints.
      */
     id: string;
     platform: 'instagram' | 'facebook' | 'telegram' | 'whatsapp' | 'twitter' | 'reddit' | 'bluesky' | 'sms' | 'slack' | 'tiktok';
+    /**
+     * Same value as `id`.
+     */
     platformConversationId: string;
     /**
      * Contact's platform identifier (IGSID, PSID, wa_id, etc.)
@@ -38242,7 +38251,10 @@ type BoostPostData = {
          */
         status?: 'ACTIVE' | 'PAUSED';
         /**
-         * Meta only. Explicit ad-set `optimization_goal` override. When omitted,
+         * Meta, or TikTok with `goal: video_views`. TikTok: ENGAGED_VIEW (6-second
+         * Focused View, the default) or ENGAGED_VIEW_FIFTEEN (15-second views), both
+         * billed per view (CPV); any other value is a 400. Meta: explicit ad-set
+         * `optimization_goal` override. When omitted,
          * defaults to the value derived from `goal`. Messaging boosts always
          * use CONVERSATIONS and reject another optimizationGoal. Otherwise the value must be compatible
          * with the objective Meta derives from `goal`, not with the objective used
@@ -38329,7 +38341,7 @@ type CreateStandaloneAdData = {
          */
         goal?: 'engagement' | 'traffic' | 'awareness' | 'video_views' | 'lead_generation' | 'lead_conversion' | 'conversions' | 'app_promotion' | 'catalog_sales' | 'page_likes' | 'job_applicants';
         /**
-         * Meta only. Explicit ad-set `optimization_goal` (e.g. `LANDING_PAGE_VIEWS`, `LINK_CLICKS`, `REACH`, `IMPRESSIONS`, `OFFSITE_CONVERSIONS`, `THRUPLAY`, `LEAD_GENERATION`). Overrides the default derived from `goal` (e.g. `traffic` defaults to `LINK_CLICKS`). Forwarded verbatim to Meta, which validates compatibility with the campaign objective and rejects incompatible combinations.
+         * Meta, or TikTok with goal video_views (ENGAGED_VIEW, the 6-second default, or ENGAGED_VIEW_FIFTEEN; both bill per view). Meta: Explicit ad-set `optimization_goal` (e.g. `LANDING_PAGE_VIEWS`, `LINK_CLICKS`, `REACH`, `IMPRESSIONS`, `OFFSITE_CONVERSIONS`, `THRUPLAY`, `LEAD_GENERATION`). Overrides the default derived from `goal` (e.g. `traffic` defaults to `LINK_CLICKS`). Forwarded verbatim to Meta, which validates compatibility with the campaign objective and rejects incompatible combinations.
          */
         optimizationGoal?: string;
         /**

package/dist/index.d.ts

@@ -6316,7 +6316,13 @@ type InboxWebhookAccount = {
  * The conversation context included in inbox webhook payloads.
  */
 type InboxWebhookConversation = {
+    /**
+     * Zernio's internal conversation id (also the message's conversationId). Accepted by every /v1/inbox/conversations/{conversationId} endpoint.
+     */
     id: string;
+    /**
+     * The platform's conversation id. This is the `id` GET /v1/inbox/conversations returns for the same conversation (on Instagram and Messenger it is the participant's IGSID / PSID), so key your records on it to match webhooks with list rows. Also accepted by the conversation endpoints.
+     */
     platformConversationId: string;
     participantId?: string;
     participantName?: string;
@@ -6340,10 +6346,13 @@ type status11 = 'active' | 'archived';
  */
 type InboxWebhookConversationDetail = {
     /**
-     * Internal conversation ID
+     * The platform's conversation id, equal to `conversation.platformConversationId` on inbox webhooks (whose `conversation.id` is Zernio's internal id). Both are accepted by the conversation endpoints.
      */
     id: string;
     platform: 'instagram' | 'facebook' | 'telegram' | 'whatsapp' | 'twitter' | 'reddit' | 'bluesky' | 'sms' | 'slack' | 'tiktok';
+    /**
+     * Same value as `id`.
+     */
     platformConversationId: string;
     /**
      * Contact's platform identifier (IGSID, PSID, wa_id, etc.)
@@ -38242,7 +38251,10 @@ type BoostPostData = {
          */
         status?: 'ACTIVE' | 'PAUSED';
         /**
-         * Meta only. Explicit ad-set `optimization_goal` override. When omitted,
+         * Meta, or TikTok with `goal: video_views`. TikTok: ENGAGED_VIEW (6-second
+         * Focused View, the default) or ENGAGED_VIEW_FIFTEEN (15-second views), both
+         * billed per view (CPV); any other value is a 400. Meta: explicit ad-set
+         * `optimization_goal` override. When omitted,
          * defaults to the value derived from `goal`. Messaging boosts always
          * use CONVERSATIONS and reject another optimizationGoal. Otherwise the value must be compatible
          * with the objective Meta derives from `goal`, not with the objective used
@@ -38329,7 +38341,7 @@ type CreateStandaloneAdData = {
          */
         goal?: 'engagement' | 'traffic' | 'awareness' | 'video_views' | 'lead_generation' | 'lead_conversion' | 'conversions' | 'app_promotion' | 'catalog_sales' | 'page_likes' | 'job_applicants';
         /**
-         * Meta only. Explicit ad-set `optimization_goal` (e.g. `LANDING_PAGE_VIEWS`, `LINK_CLICKS`, `REACH`, `IMPRESSIONS`, `OFFSITE_CONVERSIONS`, `THRUPLAY`, `LEAD_GENERATION`). Overrides the default derived from `goal` (e.g. `traffic` defaults to `LINK_CLICKS`). Forwarded verbatim to Meta, which validates compatibility with the campaign objective and rejects incompatible combinations.
+         * Meta, or TikTok with goal video_views (ENGAGED_VIEW, the 6-second default, or ENGAGED_VIEW_FIFTEEN; both bill per view). Meta: Explicit ad-set `optimization_goal` (e.g. `LANDING_PAGE_VIEWS`, `LINK_CLICKS`, `REACH`, `IMPRESSIONS`, `OFFSITE_CONVERSIONS`, `THRUPLAY`, `LEAD_GENERATION`). Overrides the default derived from `goal` (e.g. `traffic` defaults to `LINK_CLICKS`). Forwarded verbatim to Meta, which validates compatibility with the campaign objective and rejects incompatible combinations.
          */
         optimizationGoal?: string;
         /**

package/dist/index.js

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

package/src/generated/types.gen.ts

@@ -4847,7 +4847,13 @@ export type InboxWebhookAccount = {
  * The conversation context included in inbox webhook payloads.
  */
 export type InboxWebhookConversation = {
+    /**
+     * Zernio's internal conversation id (also the message's conversationId). Accepted by every /v1/inbox/conversations/{conversationId} endpoint.
+     */
     id: string;
+    /**
+     * The platform's conversation id. This is the `id` GET /v1/inbox/conversations returns for the same conversation (on Instagram and Messenger it is the participant's IGSID / PSID), so key your records on it to match webhooks with list rows. Also accepted by the conversation endpoints.
+     */
     platformConversationId: string;
     participantId?: string;
     participantName?: string;
@@ -4873,10 +4879,13 @@ export type status11 = 'active' | 'archived';
  */
 export type InboxWebhookConversationDetail = {
     /**
-     * Internal conversation ID
+     * The platform's conversation id, equal to `conversation.platformConversationId` on inbox webhooks (whose `conversation.id` is Zernio's internal id). Both are accepted by the conversation endpoints.
      */
     id: string;
     platform: 'instagram' | 'facebook' | 'telegram' | 'whatsapp' | 'twitter' | 'reddit' | 'bluesky' | 'sms' | 'slack' | 'tiktok';
+    /**
+     * Same value as `id`.
+     */
     platformConversationId: string;
     /**
      * Contact's platform identifier (IGSID, PSID, wa_id, etc.)
@@ -38852,7 +38861,10 @@ export type BoostPostData = {
          */
         status?: 'ACTIVE' | 'PAUSED';
         /**
-         * Meta only. Explicit ad-set `optimization_goal` override. When omitted,
+         * Meta, or TikTok with `goal: video_views`. TikTok: ENGAGED_VIEW (6-second
+         * Focused View, the default) or ENGAGED_VIEW_FIFTEEN (15-second views), both
+         * billed per view (CPV); any other value is a 400. Meta: explicit ad-set
+         * `optimization_goal` override. When omitted,
          * defaults to the value derived from `goal`. Messaging boosts always
          * use CONVERSATIONS and reject another optimizationGoal. Otherwise the value must be compatible
          * with the objective Meta derives from `goal`, not with the objective used
@@ -38945,7 +38957,7 @@ export type CreateStandaloneAdData = {
          */
         goal?: 'engagement' | 'traffic' | 'awareness' | 'video_views' | 'lead_generation' | 'lead_conversion' | 'conversions' | 'app_promotion' | 'catalog_sales' | 'page_likes' | 'job_applicants';
         /**
-         * Meta only. Explicit ad-set `optimization_goal` (e.g. `LANDING_PAGE_VIEWS`, `LINK_CLICKS`, `REACH`, `IMPRESSIONS`, `OFFSITE_CONVERSIONS`, `THRUPLAY`, `LEAD_GENERATION`). Overrides the default derived from `goal` (e.g. `traffic` defaults to `LINK_CLICKS`). Forwarded verbatim to Meta, which validates compatibility with the campaign objective and rejects incompatible combinations.
+         * Meta, or TikTok with goal video_views (ENGAGED_VIEW, the 6-second default, or ENGAGED_VIEW_FIFTEEN; both bill per view). Meta: Explicit ad-set `optimization_goal` (e.g. `LANDING_PAGE_VIEWS`, `LINK_CLICKS`, `REACH`, `IMPRESSIONS`, `OFFSITE_CONVERSIONS`, `THRUPLAY`, `LEAD_GENERATION`). Overrides the default derived from `goal` (e.g. `traffic` defaults to `LINK_CLICKS`). Forwarded verbatim to Meta, which validates compatibility with the campaign objective and rejects incompatible combinations.
          */
         optimizationGoal?: string;
         /**