@getlatedev/node 0.2.1178 → 0.2.1180

package/dist/index.d.mts

@@ -6326,8 +6326,9 @@ type CtwaAdRequestBody = {
     /**
      * Messaging and CTWA only (a 400 on POST /v1/ads/call). A hand-built carousel
      * of 2-10 image cards, sent to Meta in the order given as
-     * `link_data.child_attachments` (Meta may reorder them for performance, since
-     * `multi_share_optimized` defaults to true and no field fixes the order today); every
+     * `link_data.child_attachments` (by default Meta may reorder them for performance,
+     * since `multi_share_optimized` defaults to true; `optimizeCardOrder: false` keeps
+     * the order given); every
      * card (and the carousel itself) carries the destination's messaging call to
      * action (WHATSAPP_MESSAGE, MESSAGE_PAGE or INSTAGRAM_MESSAGE), so a tap on any
      * card opens the conversation. Replaces `imageUrl` / `video` (sending either is
@@ -6340,6 +6341,16 @@ type CtwaAdRequestBody = {
      *
      */
     carouselCards?: Array<MessagingCarouselCard>;
+    /**
+     * Only with `carouselCards` (a 400 without them). Sets the creative's
+     * `link_data.multi_share_optimized`. `false` keeps the cards in the order given;
+     * Meta then takes at most 5 cards, so `false` with more than 5 `carouselCards` is a
+     * 400. `true` lets Meta pick and reorder the cards for performance (up to 10).
+     * Omitted, nothing is sent and Meta's default (`true`) applies. Single-creative
+     * shape; for `creatives[]` set it per entry.
+     *
+     */
+    optimizeCardOrder?: boolean;
     /**
      * Multi-creative shape: N CTWA ads under one campaign + one
      * ad set, sharing budget and targeting. Mutually exclusive
@@ -21690,7 +21701,7 @@ type GetConnectUrlData = {
          *
          * `facebook_login`: the Facebook Login dialog, i.e. "Instagram API with Facebook Login". The user authorizes a Facebook Page that has a linked Instagram professional account, and every API call for that account then runs through the Page. Use this when the customer manages Instagram through a Page and expects the Facebook consent screen. Because the user has to pick which Page to connect, the callback continues at the account-selection step, `/v1/connect/instagram/select-account`.
          *
-         * `facebook_login` supports `headless=true` like the other selection platforms: the callback redirects to your `redirect_url` with `profileId`, `tempToken`, `platform=instagram`, `step=select_account` and `connect_token`, which you pass into the select-account endpoints to finish. The default `instagram_login` has no selection step, so it connects the account directly.
+         * `facebook_login` supports `headless=true` like the other selection platforms: the callback redirects to your `redirect_url` with `profileId`, `tempToken`, `platform=instagram`, `step=select_account`, `userProfile` (the Facebook user's profile, same shape and encoding as the Facebook `step=select_page` redirect) and `connect_token`. Pass `profileId`, `tempToken` and `connect_token` into the select-account endpoints to finish. The default `instagram_login` has no selection step, so it connects the account directly.
          *
          */
         loginMethod?: 'instagram_login' | 'facebook_login';
@@ -21749,7 +21760,8 @@ type GetConnectUrlData = {
          * - `granted_pages_not_listed`: Pages were ticked but Meta listed none the user can manage, and a
          * direct read of each ticked Page returned no access token.
          *
-         * Headless Facebook success (`step=select_page`): `userProfile` is JSON that was
+         * Headless Facebook success (`step=select_page`) and headless Instagram `facebook_login` success
+         * (`step=select_account`): `userProfile` is JSON that was
          * percent-encoded once before being set as a query param, so it is encoded twice on the wire.
          * After your framework decodes the query string once, run one more decodeURIComponent (or
          * equivalent) and then JSON.parse it. `tempToken` and `connect_token` are plain values.
@@ -44850,6 +44862,10 @@ type CreateAdCreativeData = {
             description?: string;
             callToAction?: string;
         }>;
+        /**
+         * Only with `carouselCards` (a 400 without them). Sets `link_data.multi_share_optimized`: `false` keeps the cards in the order given, and Meta then takes at most 5 cards, so `false` with more than 5 cards is a 400; `true` lets Meta reorder them for performance. Omitted, nothing is sent and Meta's default (`true`) applies.
+         */
+        optimizeCardOrder?: boolean;
         /**
          * Appended to every outbound URL (e.g. utm_source=fb).
          */
@@ -47907,9 +47923,9 @@ type CreateStandaloneAdData = {
          *
          * Meta only. Hand-built carousel: 2-10 authored cards, sent in the order given as
          * the creative's `link_data.child_attachments`. Unlike `dynamicCreative`,
-         * you author every card's copy and link, but Meta may still reorder the cards
-         * for performance (`multi_share_optimized` defaults to true and Zernio does not
-         * send it), and no field fixes the order today. Requires top-level `body`
+         * you author every card's copy and link, but by default Meta may still reorder the
+         * cards for performance (`multi_share_optimized` defaults to true); send
+         * `optimizeCardOrder: false` to keep the order given. Requires top-level `body`
          * and `callToAction`; `linkUrl` is also required UNLESS `leadGenFormId` is set. Those
          * become the ad's own Destination and button (`link_data.link` / `link_data.call_to_action`),
          * and double as the per-card fallback when a card omits its own.
@@ -47943,6 +47959,16 @@ type CreateStandaloneAdData = {
              */
             callToAction?: string;
         }>;
+        /**
+         * Meta only (a 400 on any other platform), and only with `carouselCards` (a 400
+         * without them). Sets the creative's `link_data.multi_share_optimized`. `false`
+         * keeps the cards in the order given; Meta then takes at most 5 cards, so `false`
+         * with more than 5 `carouselCards` is a 400. `true` lets Meta pick and reorder the
+         * cards for performance (up to 10). Omitted, nothing is sent and Meta's default
+         * (`true`) applies.
+         *
+         */
+        optimizeCardOrder?: boolean;
         /**
          * Meta only. Language the top-level copy is written in (e.g. `en`, `pt_BR`), used by the `translations` default rule. Defaults to `en`. Meta rejects a language asset feed whose default rule carries no locales of its own. Must NOT also appear as an entry in `translations`.
          */

package/dist/index.d.ts

@@ -6326,8 +6326,9 @@ type CtwaAdRequestBody = {
     /**
      * Messaging and CTWA only (a 400 on POST /v1/ads/call). A hand-built carousel
      * of 2-10 image cards, sent to Meta in the order given as
-     * `link_data.child_attachments` (Meta may reorder them for performance, since
-     * `multi_share_optimized` defaults to true and no field fixes the order today); every
+     * `link_data.child_attachments` (by default Meta may reorder them for performance,
+     * since `multi_share_optimized` defaults to true; `optimizeCardOrder: false` keeps
+     * the order given); every
      * card (and the carousel itself) carries the destination's messaging call to
      * action (WHATSAPP_MESSAGE, MESSAGE_PAGE or INSTAGRAM_MESSAGE), so a tap on any
      * card opens the conversation. Replaces `imageUrl` / `video` (sending either is
@@ -6340,6 +6341,16 @@ type CtwaAdRequestBody = {
      *
      */
     carouselCards?: Array<MessagingCarouselCard>;
+    /**
+     * Only with `carouselCards` (a 400 without them). Sets the creative's
+     * `link_data.multi_share_optimized`. `false` keeps the cards in the order given;
+     * Meta then takes at most 5 cards, so `false` with more than 5 `carouselCards` is a
+     * 400. `true` lets Meta pick and reorder the cards for performance (up to 10).
+     * Omitted, nothing is sent and Meta's default (`true`) applies. Single-creative
+     * shape; for `creatives[]` set it per entry.
+     *
+     */
+    optimizeCardOrder?: boolean;
     /**
      * Multi-creative shape: N CTWA ads under one campaign + one
      * ad set, sharing budget and targeting. Mutually exclusive
@@ -21690,7 +21701,7 @@ type GetConnectUrlData = {
          *
          * `facebook_login`: the Facebook Login dialog, i.e. "Instagram API with Facebook Login". The user authorizes a Facebook Page that has a linked Instagram professional account, and every API call for that account then runs through the Page. Use this when the customer manages Instagram through a Page and expects the Facebook consent screen. Because the user has to pick which Page to connect, the callback continues at the account-selection step, `/v1/connect/instagram/select-account`.
          *
-         * `facebook_login` supports `headless=true` like the other selection platforms: the callback redirects to your `redirect_url` with `profileId`, `tempToken`, `platform=instagram`, `step=select_account` and `connect_token`, which you pass into the select-account endpoints to finish. The default `instagram_login` has no selection step, so it connects the account directly.
+         * `facebook_login` supports `headless=true` like the other selection platforms: the callback redirects to your `redirect_url` with `profileId`, `tempToken`, `platform=instagram`, `step=select_account`, `userProfile` (the Facebook user's profile, same shape and encoding as the Facebook `step=select_page` redirect) and `connect_token`. Pass `profileId`, `tempToken` and `connect_token` into the select-account endpoints to finish. The default `instagram_login` has no selection step, so it connects the account directly.
          *
          */
         loginMethod?: 'instagram_login' | 'facebook_login';
@@ -21749,7 +21760,8 @@ type GetConnectUrlData = {
          * - `granted_pages_not_listed`: Pages were ticked but Meta listed none the user can manage, and a
          * direct read of each ticked Page returned no access token.
          *
-         * Headless Facebook success (`step=select_page`): `userProfile` is JSON that was
+         * Headless Facebook success (`step=select_page`) and headless Instagram `facebook_login` success
+         * (`step=select_account`): `userProfile` is JSON that was
          * percent-encoded once before being set as a query param, so it is encoded twice on the wire.
          * After your framework decodes the query string once, run one more decodeURIComponent (or
          * equivalent) and then JSON.parse it. `tempToken` and `connect_token` are plain values.
@@ -44850,6 +44862,10 @@ type CreateAdCreativeData = {
             description?: string;
             callToAction?: string;
         }>;
+        /**
+         * Only with `carouselCards` (a 400 without them). Sets `link_data.multi_share_optimized`: `false` keeps the cards in the order given, and Meta then takes at most 5 cards, so `false` with more than 5 cards is a 400; `true` lets Meta reorder them for performance. Omitted, nothing is sent and Meta's default (`true`) applies.
+         */
+        optimizeCardOrder?: boolean;
         /**
          * Appended to every outbound URL (e.g. utm_source=fb).
          */
@@ -47907,9 +47923,9 @@ type CreateStandaloneAdData = {
          *
          * Meta only. Hand-built carousel: 2-10 authored cards, sent in the order given as
          * the creative's `link_data.child_attachments`. Unlike `dynamicCreative`,
-         * you author every card's copy and link, but Meta may still reorder the cards
-         * for performance (`multi_share_optimized` defaults to true and Zernio does not
-         * send it), and no field fixes the order today. Requires top-level `body`
+         * you author every card's copy and link, but by default Meta may still reorder the
+         * cards for performance (`multi_share_optimized` defaults to true); send
+         * `optimizeCardOrder: false` to keep the order given. Requires top-level `body`
          * and `callToAction`; `linkUrl` is also required UNLESS `leadGenFormId` is set. Those
          * become the ad's own Destination and button (`link_data.link` / `link_data.call_to_action`),
          * and double as the per-card fallback when a card omits its own.
@@ -47943,6 +47959,16 @@ type CreateStandaloneAdData = {
              */
             callToAction?: string;
         }>;
+        /**
+         * Meta only (a 400 on any other platform), and only with `carouselCards` (a 400
+         * without them). Sets the creative's `link_data.multi_share_optimized`. `false`
+         * keeps the cards in the order given; Meta then takes at most 5 cards, so `false`
+         * with more than 5 `carouselCards` is a 400. `true` lets Meta pick and reorder the
+         * cards for performance (up to 10). Omitted, nothing is sent and Meta's default
+         * (`true`) applies.
+         *
+         */
+        optimizeCardOrder?: boolean;
         /**
          * Meta only. Language the top-level copy is written in (e.g. `en`, `pt_BR`), used by the `translations` default rule. Defaults to `en`. Meta rejects a language asset feed whose default rule carries no locales of its own. Must NOT also appear as an entry in `translations`.
          */

package/dist/index.js

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

package/src/generated/types.gen.ts

@@ -4505,8 +4505,9 @@ export type CtwaAdRequestBody = {
     /**
      * Messaging and CTWA only (a 400 on POST /v1/ads/call). A hand-built carousel
      * of 2-10 image cards, sent to Meta in the order given as
-     * `link_data.child_attachments` (Meta may reorder them for performance, since
-     * `multi_share_optimized` defaults to true and no field fixes the order today); every
+     * `link_data.child_attachments` (by default Meta may reorder them for performance,
+     * since `multi_share_optimized` defaults to true; `optimizeCardOrder: false` keeps
+     * the order given); every
      * card (and the carousel itself) carries the destination's messaging call to
      * action (WHATSAPP_MESSAGE, MESSAGE_PAGE or INSTAGRAM_MESSAGE), so a tap on any
      * card opens the conversation. Replaces `imageUrl` / `video` (sending either is
@@ -4519,6 +4520,16 @@ export type CtwaAdRequestBody = {
      *
      */
     carouselCards?: Array<MessagingCarouselCard>;
+    /**
+     * Only with `carouselCards` (a 400 without them). Sets the creative's
+     * `link_data.multi_share_optimized`. `false` keeps the cards in the order given;
+     * Meta then takes at most 5 cards, so `false` with more than 5 `carouselCards` is a
+     * 400. `true` lets Meta pick and reorder the cards for performance (up to 10).
+     * Omitted, nothing is sent and Meta's default (`true`) applies. Single-creative
+     * shape; for `creatives[]` set it per entry.
+     *
+     */
+    optimizeCardOrder?: boolean;
     /**
      * Multi-creative shape: N CTWA ads under one campaign + one
      * ad set, sharing budget and targeting. Mutually exclusive
@@ -20641,7 +20652,7 @@ export type GetConnectUrlData = {
          *
          * `facebook_login`: the Facebook Login dialog, i.e. "Instagram API with Facebook Login". The user authorizes a Facebook Page that has a linked Instagram professional account, and every API call for that account then runs through the Page. Use this when the customer manages Instagram through a Page and expects the Facebook consent screen. Because the user has to pick which Page to connect, the callback continues at the account-selection step, `/v1/connect/instagram/select-account`.
          *
-         * `facebook_login` supports `headless=true` like the other selection platforms: the callback redirects to your `redirect_url` with `profileId`, `tempToken`, `platform=instagram`, `step=select_account` and `connect_token`, which you pass into the select-account endpoints to finish. The default `instagram_login` has no selection step, so it connects the account directly.
+         * `facebook_login` supports `headless=true` like the other selection platforms: the callback redirects to your `redirect_url` with `profileId`, `tempToken`, `platform=instagram`, `step=select_account`, `userProfile` (the Facebook user's profile, same shape and encoding as the Facebook `step=select_page` redirect) and `connect_token`. Pass `profileId`, `tempToken` and `connect_token` into the select-account endpoints to finish. The default `instagram_login` has no selection step, so it connects the account directly.
          *
          */
         loginMethod?: 'instagram_login' | 'facebook_login';
@@ -20700,7 +20711,8 @@ export type GetConnectUrlData = {
          * - `granted_pages_not_listed`: Pages were ticked but Meta listed none the user can manage, and a
          * direct read of each ticked Page returned no access token.
          *
-         * Headless Facebook success (`step=select_page`): `userProfile` is JSON that was
+         * Headless Facebook success (`step=select_page`) and headless Instagram `facebook_login` success
+         * (`step=select_account`): `userProfile` is JSON that was
          * percent-encoded once before being set as a query param, so it is encoded twice on the wire.
          * After your framework decodes the query string once, run one more decodeURIComponent (or
          * equivalent) and then JSON.parse it. `tempToken` and `connect_token` are plain values.
@@ -45515,6 +45527,10 @@ export type CreateAdCreativeData = {
             description?: string;
             callToAction?: string;
         }>;
+        /**
+         * Only with `carouselCards` (a 400 without them). Sets `link_data.multi_share_optimized`: `false` keeps the cards in the order given, and Meta then takes at most 5 cards, so `false` with more than 5 cards is a 400; `true` lets Meta reorder them for performance. Omitted, nothing is sent and Meta's default (`true`) applies.
+         */
+        optimizeCardOrder?: boolean;
         /**
          * Appended to every outbound URL (e.g. utm_source=fb).
          */
@@ -48722,9 +48738,9 @@ export type CreateStandaloneAdData = {
          *
          * Meta only. Hand-built carousel: 2-10 authored cards, sent in the order given as
          * the creative's `link_data.child_attachments`. Unlike `dynamicCreative`,
-         * you author every card's copy and link, but Meta may still reorder the cards
-         * for performance (`multi_share_optimized` defaults to true and Zernio does not
-         * send it), and no field fixes the order today. Requires top-level `body`
+         * you author every card's copy and link, but by default Meta may still reorder the
+         * cards for performance (`multi_share_optimized` defaults to true); send
+         * `optimizeCardOrder: false` to keep the order given. Requires top-level `body`
          * and `callToAction`; `linkUrl` is also required UNLESS `leadGenFormId` is set. Those
          * become the ad's own Destination and button (`link_data.link` / `link_data.call_to_action`),
          * and double as the per-card fallback when a card omits its own.
@@ -48758,6 +48774,16 @@ export type CreateStandaloneAdData = {
              */
             callToAction?: string;
         }>;
+        /**
+         * Meta only (a 400 on any other platform), and only with `carouselCards` (a 400
+         * without them). Sets the creative's `link_data.multi_share_optimized`. `false`
+         * keeps the cards in the order given; Meta then takes at most 5 cards, so `false`
+         * with more than 5 `carouselCards` is a 400. `true` lets Meta pick and reorder the
+         * cards for performance (up to 10). Omitted, nothing is sent and Meta's default
+         * (`true`) applies.
+         *
+         */
+        optimizeCardOrder?: boolean;
         /**
          * Meta only. Language the top-level copy is written in (e.g. `en`, `pt_BR`), used by the `translations` default rule. Defaults to `en`. Meta rejects a language asset feed whose default rule carries no locales of its own. Must NOT also appear as an entry in `translations`.
          */