@getlatedev/node 0.2.236 → 0.2.238

package/dist/index.d.mts

@@ -8445,11 +8445,12 @@ type CreateInviteTokenData = {
          */
         profileIds?: Array<(string)>;
         /**
-         * Org role granted to the invitee. Defaults to 'member'.
+         * Org role granted to the invitee. Defaults to 'member'. 'viewer' creates a read-only member who can view everything in their profile scope but cannot perform any content mutation (publish, edit, delete, connect accounts).
          */
-        role?: 'member' | 'billing_admin';
+        role?: 'member' | 'billing_admin' | 'viewer';
         /**
-         * When true, the invitee can view everything in their profile scope but cannot perform any content mutation (publish, edit, delete, connect accounts).
+         * Deprecated. Use role 'viewer' instead. When true, the invite is created with role 'viewer'. Cannot be combined with role 'billing_admin'.
+         * @deprecated
          */
         readOnly?: boolean;
     };
@@ -18645,6 +18646,10 @@ type CreateStandaloneAdData = {
          * Required on legacy + attach shapes. For X/Twitter this is the tweet text (max 280 chars including a ~24-char URL when `linkUrl` is set). On LinkedIn this is the post commentary (the intro text shown above the ad). Max: Google=90, Pinterest=500.
          */
         body?: string;
+        /**
+         * Meta only (facebook/instagram). Link description — the secondary text shown below the headline (Meta's link_data.description; on video creatives mapped to video_data.link_description). When omitted, Meta auto-pulls the destination URL's OpenGraph description. Applies on legacy, attach, and placementAssets shapes; for multi-creative use creatives[].description (this field is the shared fallback). For multi-text variations use dynamicCreative.descriptions instead.
+         */
+        description?: string;
         /**
          * Required on legacy + attach shapes for Meta. Honoured on TikTok (passes through to the Spark Ad creative's `call_to_action`) and on LinkedIn (the CTA button on the ad; defaults to LEARN_MORE when `linkUrl` is set). LinkedIn accepts: LEARN_MORE, SIGN_UP, DOWNLOAD, SUBSCRIBE, REGISTER, JOIN, ATTEND, REQUEST_DEMO, VIEW_QUOTE, APPLY, SEE_MORE, SHOP_NOW, BUY_NOW. Ignored by Google, Pinterest, and X/Twitter.
          */
@@ -18654,7 +18659,7 @@ type CreateStandaloneAdData = {
          */
         linkUrl?: string;
         /**
-         * Meta Lead Gen forms only (facebook/instagram). The leadgen_forms ID to attach to the ad's creative — create one via POST /v1/ads/lead-forms. REQUIRED when `goal` is `lead_generation`; ignored otherwise. The ad set's promoted_object.page_id + LEAD_GENERATION optimization + destination_type ON_AD are derived automatically from the goal. Both `placementAssets` (per-placement creative) and `dynamicCreative` (multi-text / multi-asset pool, e.g. multiple headlines and primary texts) ARE supported on instant-form lead ads — the form is attached for you, and for `dynamicCreative` the ad set is created as a Dynamic Creative ad set automatically (Meta requires that for any multi-text feed; there is no non-DCO multi-text path). Send a single `imageUrls` entry plus your text variations to get Meta's "Multiple Text Options" behavior on a lead ad.
+         * Meta Lead Gen forms only (facebook/instagram). The leadgen_forms ID to attach to the ad's creative — create one via POST /v1/ads/lead-forms. REQUIRED when `goal` is `lead_generation`, and on every ATTACH (`adSetId`) call that targets a lead ad set (the form attaches per-ad; Meta rejects a formless ad in a lead ad set). Ignored otherwise. The ad set's promoted_object.page_id + LEAD_GENERATION optimization + destination_type ON_AD are derived automatically from the goal. Both `placementAssets` (per-placement creative) and `dynamicCreative` (multi-text / multi-asset pool, e.g. multiple headlines and primary texts) ARE supported on instant-form lead ads — the form is attached for you, and for `dynamicCreative` the ad set is created as a Dynamic Creative ad set automatically (Meta requires that for any multi-text feed; there is no non-DCO multi-text path). Send a single `imageUrls` entry plus your text variations to get Meta's "Multiple Text Options" behavior on a lead ad.
          */
         leadGenFormId?: string;
         /**
@@ -18701,6 +18706,10 @@ type CreateStandaloneAdData = {
             name?: string;
             headline: string;
             body: string;
+            /**
+             * Link description for this ad (link_data.description; video creatives: video_data.link_description). Falls back to the top-level `description`; when both are omitted Meta scrapes the destination URL's OG description.
+             */
+            description?: string;
             /**
              * Image creative. Mutually exclusive with `video`.
              */
@@ -18724,6 +18733,16 @@ type CreateStandaloneAdData = {
          * bid, use `PUT /v1/ads/ad-sets/{adSetId}`. Mutually exclusive
          * with `creatives[]`.
          *
+         * The attached ad takes the full single-creative surface:
+         * `headline`/`body`/`description`/`callToAction` plus either
+         * `imageUrl`/`video` OR `placementAssets` (its own per-placement
+         * Feed/Story assets), and `leadGenFormId` when the target is a
+         * lead ad set (the parent must be ON_AD — true for ad sets
+         * created via goal `lead_generation`; Meta rejects a formless ad
+         * there, so pass the form on EVERY attached ad). This is the way
+         * to build N full ads sharing one ad set: create the first ad
+         * via the normal shape, then attach the rest one call each.
+         *
          * Supported on Meta (facebook, instagram) and TikTok. On TikTok
          * the `adSetId` is the ad group ID; the new ad inherits the
          * ad group's bid + budget + targeting.
@@ -18948,8 +18967,11 @@ type CreateStandaloneAdData = {
          * each placement group on a SINGLE ad (e.g. a 9:16 on Stories/Reels and a 4:5 on Feed).
          * The same thing Meta Ads Manager produces with "different creative per placement",
          * mapped to the creative's `asset_feed_spec` + `asset_customization_rules`. Deterministic
-         * pinning, NOT the auto-optimizing pool of `dynamicCreative` (mutually exclusive, and it
-         * cannot be combined with `creatives[]` or `adSetId`). Shared copy (headline, body, link,
+         * pinning, NOT the auto-optimizing pool of `dynamicCreative` (mutually exclusive). Works
+         * on the legacy single shape AND the attach shape (`adSetId` + placementAssets adds one
+         * placement-customized ad to an existing ad set — the way to build N per-placement ads
+         * sharing one ad set: create the first normally, attach the rest). Cannot be combined
+         * with `creatives[]`. Shared copy (headline, body, link,
          * CTA) comes from the top-level single-creative fields since only the asset varies by
          * placement. Each rule's `placements` accepts the same fields as the top-level
          * `placements` object; Meta enforces co-selection rules and returns an actionable error.

package/dist/index.d.ts

@@ -8445,11 +8445,12 @@ type CreateInviteTokenData = {
          */
         profileIds?: Array<(string)>;
         /**
-         * Org role granted to the invitee. Defaults to 'member'.
+         * Org role granted to the invitee. Defaults to 'member'. 'viewer' creates a read-only member who can view everything in their profile scope but cannot perform any content mutation (publish, edit, delete, connect accounts).
          */
-        role?: 'member' | 'billing_admin';
+        role?: 'member' | 'billing_admin' | 'viewer';
         /**
-         * When true, the invitee can view everything in their profile scope but cannot perform any content mutation (publish, edit, delete, connect accounts).
+         * Deprecated. Use role 'viewer' instead. When true, the invite is created with role 'viewer'. Cannot be combined with role 'billing_admin'.
+         * @deprecated
          */
         readOnly?: boolean;
     };
@@ -18645,6 +18646,10 @@ type CreateStandaloneAdData = {
          * Required on legacy + attach shapes. For X/Twitter this is the tweet text (max 280 chars including a ~24-char URL when `linkUrl` is set). On LinkedIn this is the post commentary (the intro text shown above the ad). Max: Google=90, Pinterest=500.
          */
         body?: string;
+        /**
+         * Meta only (facebook/instagram). Link description — the secondary text shown below the headline (Meta's link_data.description; on video creatives mapped to video_data.link_description). When omitted, Meta auto-pulls the destination URL's OpenGraph description. Applies on legacy, attach, and placementAssets shapes; for multi-creative use creatives[].description (this field is the shared fallback). For multi-text variations use dynamicCreative.descriptions instead.
+         */
+        description?: string;
         /**
          * Required on legacy + attach shapes for Meta. Honoured on TikTok (passes through to the Spark Ad creative's `call_to_action`) and on LinkedIn (the CTA button on the ad; defaults to LEARN_MORE when `linkUrl` is set). LinkedIn accepts: LEARN_MORE, SIGN_UP, DOWNLOAD, SUBSCRIBE, REGISTER, JOIN, ATTEND, REQUEST_DEMO, VIEW_QUOTE, APPLY, SEE_MORE, SHOP_NOW, BUY_NOW. Ignored by Google, Pinterest, and X/Twitter.
          */
@@ -18654,7 +18659,7 @@ type CreateStandaloneAdData = {
          */
         linkUrl?: string;
         /**
-         * Meta Lead Gen forms only (facebook/instagram). The leadgen_forms ID to attach to the ad's creative — create one via POST /v1/ads/lead-forms. REQUIRED when `goal` is `lead_generation`; ignored otherwise. The ad set's promoted_object.page_id + LEAD_GENERATION optimization + destination_type ON_AD are derived automatically from the goal. Both `placementAssets` (per-placement creative) and `dynamicCreative` (multi-text / multi-asset pool, e.g. multiple headlines and primary texts) ARE supported on instant-form lead ads — the form is attached for you, and for `dynamicCreative` the ad set is created as a Dynamic Creative ad set automatically (Meta requires that for any multi-text feed; there is no non-DCO multi-text path). Send a single `imageUrls` entry plus your text variations to get Meta's "Multiple Text Options" behavior on a lead ad.
+         * Meta Lead Gen forms only (facebook/instagram). The leadgen_forms ID to attach to the ad's creative — create one via POST /v1/ads/lead-forms. REQUIRED when `goal` is `lead_generation`, and on every ATTACH (`adSetId`) call that targets a lead ad set (the form attaches per-ad; Meta rejects a formless ad in a lead ad set). Ignored otherwise. The ad set's promoted_object.page_id + LEAD_GENERATION optimization + destination_type ON_AD are derived automatically from the goal. Both `placementAssets` (per-placement creative) and `dynamicCreative` (multi-text / multi-asset pool, e.g. multiple headlines and primary texts) ARE supported on instant-form lead ads — the form is attached for you, and for `dynamicCreative` the ad set is created as a Dynamic Creative ad set automatically (Meta requires that for any multi-text feed; there is no non-DCO multi-text path). Send a single `imageUrls` entry plus your text variations to get Meta's "Multiple Text Options" behavior on a lead ad.
          */
         leadGenFormId?: string;
         /**
@@ -18701,6 +18706,10 @@ type CreateStandaloneAdData = {
             name?: string;
             headline: string;
             body: string;
+            /**
+             * Link description for this ad (link_data.description; video creatives: video_data.link_description). Falls back to the top-level `description`; when both are omitted Meta scrapes the destination URL's OG description.
+             */
+            description?: string;
             /**
              * Image creative. Mutually exclusive with `video`.
              */
@@ -18724,6 +18733,16 @@ type CreateStandaloneAdData = {
          * bid, use `PUT /v1/ads/ad-sets/{adSetId}`. Mutually exclusive
          * with `creatives[]`.
          *
+         * The attached ad takes the full single-creative surface:
+         * `headline`/`body`/`description`/`callToAction` plus either
+         * `imageUrl`/`video` OR `placementAssets` (its own per-placement
+         * Feed/Story assets), and `leadGenFormId` when the target is a
+         * lead ad set (the parent must be ON_AD — true for ad sets
+         * created via goal `lead_generation`; Meta rejects a formless ad
+         * there, so pass the form on EVERY attached ad). This is the way
+         * to build N full ads sharing one ad set: create the first ad
+         * via the normal shape, then attach the rest one call each.
+         *
          * Supported on Meta (facebook, instagram) and TikTok. On TikTok
          * the `adSetId` is the ad group ID; the new ad inherits the
          * ad group's bid + budget + targeting.
@@ -18948,8 +18967,11 @@ type CreateStandaloneAdData = {
          * each placement group on a SINGLE ad (e.g. a 9:16 on Stories/Reels and a 4:5 on Feed).
          * The same thing Meta Ads Manager produces with "different creative per placement",
          * mapped to the creative's `asset_feed_spec` + `asset_customization_rules`. Deterministic
-         * pinning, NOT the auto-optimizing pool of `dynamicCreative` (mutually exclusive, and it
-         * cannot be combined with `creatives[]` or `adSetId`). Shared copy (headline, body, link,
+         * pinning, NOT the auto-optimizing pool of `dynamicCreative` (mutually exclusive). Works
+         * on the legacy single shape AND the attach shape (`adSetId` + placementAssets adds one
+         * placement-customized ad to an existing ad set — the way to build N per-placement ads
+         * sharing one ad set: create the first normally, attach the rest). Cannot be combined
+         * with `creatives[]`. Shared copy (headline, body, link,
          * CTA) comes from the top-level single-creative fields since only the asset varies by
          * placement. Each rule's `placements` accepts the same fields as the top-level
          * `placements` object; Meta enforces co-selection rules and returns an actionable error.

package/dist/index.js

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

package/src/generated/types.gen.ts

@@ -8128,11 +8128,12 @@ export type CreateInviteTokenData = {
          */
         profileIds?: Array<(string)>;
         /**
-         * Org role granted to the invitee. Defaults to 'member'.
+         * Org role granted to the invitee. Defaults to 'member'. 'viewer' creates a read-only member who can view everything in their profile scope but cannot perform any content mutation (publish, edit, delete, connect accounts).
          */
-        role?: 'member' | 'billing_admin';
+        role?: 'member' | 'billing_admin' | 'viewer';
         /**
-         * When true, the invitee can view everything in their profile scope but cannot perform any content mutation (publish, edit, delete, connect accounts).
+         * Deprecated. Use role 'viewer' instead. When true, the invite is created with role 'viewer'. Cannot be combined with role 'billing_admin'.
+         * @deprecated
          */
         readOnly?: boolean;
     };
@@ -19138,6 +19139,10 @@ export type CreateStandaloneAdData = {
          * Required on legacy + attach shapes. For X/Twitter this is the tweet text (max 280 chars including a ~24-char URL when `linkUrl` is set). On LinkedIn this is the post commentary (the intro text shown above the ad). Max: Google=90, Pinterest=500.
          */
         body?: string;
+        /**
+         * Meta only (facebook/instagram). Link description — the secondary text shown below the headline (Meta's link_data.description; on video creatives mapped to video_data.link_description). When omitted, Meta auto-pulls the destination URL's OpenGraph description. Applies on legacy, attach, and placementAssets shapes; for multi-creative use creatives[].description (this field is the shared fallback). For multi-text variations use dynamicCreative.descriptions instead.
+         */
+        description?: string;
         /**
          * Required on legacy + attach shapes for Meta. Honoured on TikTok (passes through to the Spark Ad creative's `call_to_action`) and on LinkedIn (the CTA button on the ad; defaults to LEARN_MORE when `linkUrl` is set). LinkedIn accepts: LEARN_MORE, SIGN_UP, DOWNLOAD, SUBSCRIBE, REGISTER, JOIN, ATTEND, REQUEST_DEMO, VIEW_QUOTE, APPLY, SEE_MORE, SHOP_NOW, BUY_NOW. Ignored by Google, Pinterest, and X/Twitter.
          */
@@ -19147,7 +19152,7 @@ export type CreateStandaloneAdData = {
          */
         linkUrl?: string;
         /**
-         * Meta Lead Gen forms only (facebook/instagram). The leadgen_forms ID to attach to the ad's creative — create one via POST /v1/ads/lead-forms. REQUIRED when `goal` is `lead_generation`; ignored otherwise. The ad set's promoted_object.page_id + LEAD_GENERATION optimization + destination_type ON_AD are derived automatically from the goal. Both `placementAssets` (per-placement creative) and `dynamicCreative` (multi-text / multi-asset pool, e.g. multiple headlines and primary texts) ARE supported on instant-form lead ads — the form is attached for you, and for `dynamicCreative` the ad set is created as a Dynamic Creative ad set automatically (Meta requires that for any multi-text feed; there is no non-DCO multi-text path). Send a single `imageUrls` entry plus your text variations to get Meta's "Multiple Text Options" behavior on a lead ad.
+         * Meta Lead Gen forms only (facebook/instagram). The leadgen_forms ID to attach to the ad's creative — create one via POST /v1/ads/lead-forms. REQUIRED when `goal` is `lead_generation`, and on every ATTACH (`adSetId`) call that targets a lead ad set (the form attaches per-ad; Meta rejects a formless ad in a lead ad set). Ignored otherwise. The ad set's promoted_object.page_id + LEAD_GENERATION optimization + destination_type ON_AD are derived automatically from the goal. Both `placementAssets` (per-placement creative) and `dynamicCreative` (multi-text / multi-asset pool, e.g. multiple headlines and primary texts) ARE supported on instant-form lead ads — the form is attached for you, and for `dynamicCreative` the ad set is created as a Dynamic Creative ad set automatically (Meta requires that for any multi-text feed; there is no non-DCO multi-text path). Send a single `imageUrls` entry plus your text variations to get Meta's "Multiple Text Options" behavior on a lead ad.
          */
         leadGenFormId?: string;
         /**
@@ -19194,6 +19199,10 @@ export type CreateStandaloneAdData = {
             name?: string;
             headline: string;
             body: string;
+            /**
+             * Link description for this ad (link_data.description; video creatives: video_data.link_description). Falls back to the top-level `description`; when both are omitted Meta scrapes the destination URL's OG description.
+             */
+            description?: string;
             /**
              * Image creative. Mutually exclusive with `video`.
              */
@@ -19217,6 +19226,16 @@ export type CreateStandaloneAdData = {
          * bid, use `PUT /v1/ads/ad-sets/{adSetId}`. Mutually exclusive
          * with `creatives[]`.
          *
+         * The attached ad takes the full single-creative surface:
+         * `headline`/`body`/`description`/`callToAction` plus either
+         * `imageUrl`/`video` OR `placementAssets` (its own per-placement
+         * Feed/Story assets), and `leadGenFormId` when the target is a
+         * lead ad set (the parent must be ON_AD — true for ad sets
+         * created via goal `lead_generation`; Meta rejects a formless ad
+         * there, so pass the form on EVERY attached ad). This is the way
+         * to build N full ads sharing one ad set: create the first ad
+         * via the normal shape, then attach the rest one call each.
+         *
          * Supported on Meta (facebook, instagram) and TikTok. On TikTok
          * the `adSetId` is the ad group ID; the new ad inherits the
          * ad group's bid + budget + targeting.
@@ -19441,8 +19460,11 @@ export type CreateStandaloneAdData = {
          * each placement group on a SINGLE ad (e.g. a 9:16 on Stories/Reels and a 4:5 on Feed).
          * The same thing Meta Ads Manager produces with "different creative per placement",
          * mapped to the creative's `asset_feed_spec` + `asset_customization_rules`. Deterministic
-         * pinning, NOT the auto-optimizing pool of `dynamicCreative` (mutually exclusive, and it
-         * cannot be combined with `creatives[]` or `adSetId`). Shared copy (headline, body, link,
+         * pinning, NOT the auto-optimizing pool of `dynamicCreative` (mutually exclusive). Works
+         * on the legacy single shape AND the attach shape (`adSetId` + placementAssets adds one
+         * placement-customized ad to an existing ad set — the way to build N per-placement ads
+         * sharing one ad set: create the first normally, attach the rest). Cannot be combined
+         * with `creatives[]`. Shared copy (headline, body, link,
          * CTA) comes from the top-level single-creative fields since only the asset varies by
          * placement. Each rule's `placements` accepts the same fields as the top-level
          * `placements` object; Meta enforces co-selection rules and returns an actionable error.