@zernio/node 0.2.854 → 0.2.855

package/dist/index.d.mts

@@ -4734,7 +4734,7 @@ type actionSource = 'web' | 'app' | 'offline' | 'crm' | 'phone_call' | 'system_g
  * EXACTLY ONE of the two shapes:
  *
  * - Single-creative: `headline`, `body`, and one of `imageUrl` / `video`,
- * OR `existingPostId` / `objectStoryId` to reuse an organic post.
+ * OR `platformPostId` / `objectStoryId` to reuse an organic post.
  * - Multi-creative: a non-empty `creatives[]` array. Top-level
  * creative fields must NOT be set on this shape.
  *
@@ -4778,11 +4778,16 @@ type CtwaAdRequestBody = {
      */
     adSetName?: string;
     /**
-     * Messaging and CTWA only. Platform post or reel ID, resolved like boost platformPostId. Facebook IDs become object_story_id; Instagram IDs become source_instagram_media_id using the connected Instagram identity. Mutually exclusive with objectStoryId and fresh creative fields.
+     * Messaging and CTWA only. Platform post or reel ID, the same input boostPost takes as platformPostId. Facebook IDs become object_story_id; Instagram IDs become source_instagram_media_id using the connected Instagram identity. Mutually exclusive with objectStoryId and fresh creative fields.
+     */
+    platformPostId?: string;
+    /**
+     * Alias of platformPostId, kept for existing callers. Sending both with different values is a 400.
+     * @deprecated
      */
     existingPostId?: string;
     /**
-     * Messaging and CTWA only. Raw Facebook pageId_postId reference, used as object_story_id even with an Instagram account. Mutually exclusive with existingPostId and fresh creative fields.
+     * Messaging and CTWA only. Raw Facebook pageId_postId reference, used as object_story_id even with an Instagram account. Mutually exclusive with platformPostId and fresh creative fields.
      */
     objectStoryId?: string;
     /**
@@ -4879,17 +4884,22 @@ type CtwaAdRequestBody = {
      * `body` / `imageUrl` / `video`): setting both is a 400,
      * unlike `POST /v1/ads/create` where the top-level fields
      * are silently ignored in multi-creative mode. Each entry
-     * supplies headline, body, and image/video, or an existingPostId or
+     * supplies headline, body, and image/video, or a platformPostId or
      * objectStoryId reference. Fresh and existing creatives can be mixed.
      *
      */
     creatives?: Array<{
         /**
-         * Messaging and CTWA only. Platform post or reel ID, resolved like boost platformPostId. Facebook IDs become object_story_id; Instagram IDs become source_instagram_media_id using the connected Instagram identity. Mutually exclusive with objectStoryId and fresh creative fields.
+         * Messaging and CTWA only. Platform post or reel ID, the same input boostPost takes as platformPostId. Facebook IDs become object_story_id; Instagram IDs become source_instagram_media_id using the connected Instagram identity. Mutually exclusive with objectStoryId and fresh creative fields.
+         */
+        platformPostId?: string;
+        /**
+         * Alias of platformPostId, kept for existing callers. Sending both with different values is a 400.
+         * @deprecated
          */
         existingPostId?: string;
         /**
-         * Messaging and CTWA only. Raw Facebook pageId_postId reference, used as object_story_id even with an Instagram account. Mutually exclusive with existingPostId and fresh creative fields.
+         * Messaging and CTWA only. Raw Facebook pageId_postId reference, used as object_story_id even with an Instagram account. Mutually exclusive with platformPostId and fresh creative fields.
          */
         objectStoryId?: string;
         /**

package/dist/index.d.ts

@@ -4734,7 +4734,7 @@ type actionSource = 'web' | 'app' | 'offline' | 'crm' | 'phone_call' | 'system_g
  * EXACTLY ONE of the two shapes:
  *
  * - Single-creative: `headline`, `body`, and one of `imageUrl` / `video`,
- * OR `existingPostId` / `objectStoryId` to reuse an organic post.
+ * OR `platformPostId` / `objectStoryId` to reuse an organic post.
  * - Multi-creative: a non-empty `creatives[]` array. Top-level
  * creative fields must NOT be set on this shape.
  *
@@ -4778,11 +4778,16 @@ type CtwaAdRequestBody = {
      */
     adSetName?: string;
     /**
-     * Messaging and CTWA only. Platform post or reel ID, resolved like boost platformPostId. Facebook IDs become object_story_id; Instagram IDs become source_instagram_media_id using the connected Instagram identity. Mutually exclusive with objectStoryId and fresh creative fields.
+     * Messaging and CTWA only. Platform post or reel ID, the same input boostPost takes as platformPostId. Facebook IDs become object_story_id; Instagram IDs become source_instagram_media_id using the connected Instagram identity. Mutually exclusive with objectStoryId and fresh creative fields.
+     */
+    platformPostId?: string;
+    /**
+     * Alias of platformPostId, kept for existing callers. Sending both with different values is a 400.
+     * @deprecated
      */
     existingPostId?: string;
     /**
-     * Messaging and CTWA only. Raw Facebook pageId_postId reference, used as object_story_id even with an Instagram account. Mutually exclusive with existingPostId and fresh creative fields.
+     * Messaging and CTWA only. Raw Facebook pageId_postId reference, used as object_story_id even with an Instagram account. Mutually exclusive with platformPostId and fresh creative fields.
      */
     objectStoryId?: string;
     /**
@@ -4879,17 +4884,22 @@ type CtwaAdRequestBody = {
      * `body` / `imageUrl` / `video`): setting both is a 400,
      * unlike `POST /v1/ads/create` where the top-level fields
      * are silently ignored in multi-creative mode. Each entry
-     * supplies headline, body, and image/video, or an existingPostId or
+     * supplies headline, body, and image/video, or a platformPostId or
      * objectStoryId reference. Fresh and existing creatives can be mixed.
      *
      */
     creatives?: Array<{
         /**
-         * Messaging and CTWA only. Platform post or reel ID, resolved like boost platformPostId. Facebook IDs become object_story_id; Instagram IDs become source_instagram_media_id using the connected Instagram identity. Mutually exclusive with objectStoryId and fresh creative fields.
+         * Messaging and CTWA only. Platform post or reel ID, the same input boostPost takes as platformPostId. Facebook IDs become object_story_id; Instagram IDs become source_instagram_media_id using the connected Instagram identity. Mutually exclusive with objectStoryId and fresh creative fields.
+         */
+        platformPostId?: string;
+        /**
+         * Alias of platformPostId, kept for existing callers. Sending both with different values is a 400.
+         * @deprecated
          */
         existingPostId?: string;
         /**
-         * Messaging and CTWA only. Raw Facebook pageId_postId reference, used as object_story_id even with an Instagram account. Mutually exclusive with existingPostId and fresh creative fields.
+         * Messaging and CTWA only. Raw Facebook pageId_postId reference, used as object_story_id even with an Instagram account. Mutually exclusive with platformPostId and fresh creative fields.
          */
         objectStoryId?: 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.854",
+  version: "0.2.855",
   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.854",
+  version: "0.2.855",
   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.854",
+  "version": "0.2.855",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -11747,8 +11747,8 @@ export const sendWhatsAppConversion = <ThrowOnError extends boolean = false>(opt
  * CONVERSATIONS optimization; the campaign objective defaults to OUTCOME_ENGAGEMENT.
  * Supports single-creative and multi-creative shapes. Supersedes POST /v1/ads/ctwa
  * (deprecated, equivalent to `destination: whatsapp`).
- * Existing posts and reels are supported through `existingPostId` or
- * `objectStoryId`, either per creative or at the top level. Omit fresh
+ * Existing posts and reels are supported through `platformPostId` (alias
+ * `existingPostId`) or `objectStoryId`, either per creative or at the top level. Omit fresh
  * media and copy for that creative. Optional `whatsappPhoneNumber` selects
  * a number already paired with the Page (WhatsApp destination only).
  * `accountId` is a Facebook, Instagram or Meta ads (business login) connection;
@@ -11784,15 +11784,15 @@ export const createCallAd = <ThrowOnError extends boolean = false>(options: Opti
  *
  * Supports two mutually-exclusive shapes:
  *
- * - **Single-creative**: supply top-level `headline`, `body`, and one of `imageUrl` / `video`, or an `existingPostId` / `objectStoryId` reference. Creates 1 campaign + 1 ad set + 1 ad.
+ * - **Single-creative**: supply top-level `headline`, `body`, and one of `imageUrl` / `video`, or a `platformPostId` / `objectStoryId` reference. Creates 1 campaign + 1 ad set + 1 ad.
  *
  * - **Multi-creative**: supply a `creatives[]` array with N entries (each carrying fresh media and copy or an existing post reference). Creates 1 campaign + 1 ad set + N ads sharing budget and targeting so Meta A/Bs the creatives inside a single auction instead of fragmenting budget across N parallel campaigns. Recommended when launching multiple creative variants for the same campaign.
  *
  * **Attach shape.** Send `adSetId` (with either creative shape) to add the ads to an EXISTING messaging ad set instead of building a campaign, so the ad set keeps its learning phase, the way to refresh a CTWA creative without resetting delivery. The ad set then owns budget, targeting and schedule, so `budgetAmount`, `budgetType`, `endDate`, `objective`, `countries`, `interests` and `audienceId` are rejected with a 400 alongside it rather than silently dropped. The target ad set's `destination_type` must match the ad's destination (a WhatsApp ad needs a `WHATSAPP` ad set), otherwise Meta would accept an ad that never delivers.
  *
  * Prerequisites enforced by Meta (surfaced as platform_error on failure): the Facebook Page must be paired with a verified WhatsApp Business number, the WhatsApp Business Account must be business-verified, and the Meta access token must carry ads_management.
- * Existing posts and reels are supported through `existingPostId` or
- * `objectStoryId`, either per creative or at the top level. Omit fresh
+ * Existing posts and reels are supported through `platformPostId` (alias
+ * `existingPostId`) or `objectStoryId`, either per creative or at the top level. Omit fresh
  * media and copy for that creative. Optional `whatsappPhoneNumber` selects
  * a number already paired with the Page (WhatsApp destination only).
  */

package/src/generated/types.gen.ts

@@ -3174,7 +3174,7 @@ export type actionSource = 'web' | 'app' | 'offline' | 'crm' | 'phone_call' | 's
  * EXACTLY ONE of the two shapes:
  *
  * - Single-creative: `headline`, `body`, and one of `imageUrl` / `video`,
- * OR `existingPostId` / `objectStoryId` to reuse an organic post.
+ * OR `platformPostId` / `objectStoryId` to reuse an organic post.
  * - Multi-creative: a non-empty `creatives[]` array. Top-level
  * creative fields must NOT be set on this shape.
  *
@@ -3218,11 +3218,16 @@ export type CtwaAdRequestBody = {
      */
     adSetName?: string;
     /**
-     * Messaging and CTWA only. Platform post or reel ID, resolved like boost platformPostId. Facebook IDs become object_story_id; Instagram IDs become source_instagram_media_id using the connected Instagram identity. Mutually exclusive with objectStoryId and fresh creative fields.
+     * Messaging and CTWA only. Platform post or reel ID, the same input boostPost takes as platformPostId. Facebook IDs become object_story_id; Instagram IDs become source_instagram_media_id using the connected Instagram identity. Mutually exclusive with objectStoryId and fresh creative fields.
+     */
+    platformPostId?: string;
+    /**
+     * Alias of platformPostId, kept for existing callers. Sending both with different values is a 400.
+     * @deprecated
      */
     existingPostId?: string;
     /**
-     * Messaging and CTWA only. Raw Facebook pageId_postId reference, used as object_story_id even with an Instagram account. Mutually exclusive with existingPostId and fresh creative fields.
+     * Messaging and CTWA only. Raw Facebook pageId_postId reference, used as object_story_id even with an Instagram account. Mutually exclusive with platformPostId and fresh creative fields.
      */
     objectStoryId?: string;
     /**
@@ -3319,17 +3324,22 @@ export type CtwaAdRequestBody = {
      * `body` / `imageUrl` / `video`): setting both is a 400,
      * unlike `POST /v1/ads/create` where the top-level fields
      * are silently ignored in multi-creative mode. Each entry
-     * supplies headline, body, and image/video, or an existingPostId or
+     * supplies headline, body, and image/video, or a platformPostId or
      * objectStoryId reference. Fresh and existing creatives can be mixed.
      *
      */
     creatives?: Array<{
         /**
-         * Messaging and CTWA only. Platform post or reel ID, resolved like boost platformPostId. Facebook IDs become object_story_id; Instagram IDs become source_instagram_media_id using the connected Instagram identity. Mutually exclusive with objectStoryId and fresh creative fields.
+         * Messaging and CTWA only. Platform post or reel ID, the same input boostPost takes as platformPostId. Facebook IDs become object_story_id; Instagram IDs become source_instagram_media_id using the connected Instagram identity. Mutually exclusive with objectStoryId and fresh creative fields.
+         */
+        platformPostId?: string;
+        /**
+         * Alias of platformPostId, kept for existing callers. Sending both with different values is a 400.
+         * @deprecated
          */
         existingPostId?: string;
         /**
-         * Messaging and CTWA only. Raw Facebook pageId_postId reference, used as object_story_id even with an Instagram account. Mutually exclusive with existingPostId and fresh creative fields.
+         * Messaging and CTWA only. Raw Facebook pageId_postId reference, used as object_story_id even with an Instagram account. Mutually exclusive with platformPostId and fresh creative fields.
          */
         objectStoryId?: string;
         /**