@zernio/node 0.2.749 → 0.2.751

package/dist/index.d.mts

@@ -26548,6 +26548,11 @@ type PurchasePhoneNumberData = {
          *
          */
         areaCode?: string;
+        /**
+         * One exact number to buy, in E.164, taken from GET /v1/phone-numbers/available. Hard constraint: when it is no longer available (bought by someone else, or WhatsApp's buy-time check rejects it) the purchase fails with 409 code PHONE_NUMBER_UNAVAILABLE instead of assigning another number; search again and pick another. Only for countries and types that activate instantly: a regulated one (202 kyc_required) returns 400 when phoneNumber is set.
+         *
+         */
+        phoneNumber?: string;
         /**
          * A phone number is the unit; WhatsApp is one optional feature. Pass false to buy a STANDALONE number (Calls/SMS only): provisioning skips the Meta pre-verify/OTP steps and the number activates immediately. Omitted defaults to the WhatsApp provisioning path. WhatsApp can be connected to a standalone number later from the connect flow.
          *
@@ -26614,7 +26619,7 @@ type PurchasePhoneNumberError = (unknown | {
     error?: string;
 } | {
     error?: string;
-    code?: 'PURCHASE_VELOCITY' | 'AREA_CODE_UNAVAILABLE';
+    code?: 'PURCHASE_VELOCITY' | 'AREA_CODE_UNAVAILABLE' | 'PHONE_NUMBER_UNAVAILABLE';
 });
 type ListPhoneNumberCountriesResponse = ({
     countries?: Array<{
@@ -26722,11 +26727,22 @@ type SearchAvailablePhoneNumbersResponse = ({
      */
     requireSms?: boolean;
     numbers?: Array<{
+        /**
+         * E.164. Pass it as `phoneNumber` on POST /v1/phone-numbers/purchase to buy this exact number.
+         */
         phoneNumber?: string;
         /**
          * Provider capability list for this number (e.g. voice, sms, mms).
          */
         features?: Array<(string)>;
+        /**
+         * Town or rate center the number belongs to, as the carrier names it (e.g. WACO).
+         */
+        locality?: string;
+        /**
+         * true when the carrier added this number because too few matched your filters, so it may be outside the requested prefix or locality.
+         */
+        bestEffort?: boolean;
     }>;
 });
 type SearchAvailablePhoneNumbersError = (unknown | {
@@ -26905,6 +26921,11 @@ type PurchaseWhatsAppPhoneNumberData = {
          *
          */
         country?: string;
+        /**
+         * One exact number to buy, in E.164, taken from GET /v1/phone-numbers/available. Fails with 409 code PHONE_NUMBER_UNAVAILABLE when it is no longer available.
+         *
+         */
+        phoneNumber?: string;
         /**
          * Optional idempotency key. Send the same value when retrying a purchase: if a number was already bought under this key, the API returns { status: "already_purchased", numberId, phoneNumber } instead of provisioning a second number. Generate a fresh key for each genuinely new purchase.
          *
@@ -26948,7 +26969,7 @@ type PurchaseWhatsAppPhoneNumberError = (unknown | {
     error?: string;
 } | {
     error?: string;
-    code?: 'PURCHASE_VELOCITY' | 'AREA_CODE_UNAVAILABLE';
+    code?: 'PURCHASE_VELOCITY' | 'AREA_CODE_UNAVAILABLE' | 'PHONE_NUMBER_UNAVAILABLE';
 });
 type ListWhatsAppNumberCountriesResponse = ({
     countries?: Array<{
@@ -26995,6 +27016,8 @@ type SearchAvailableWhatsAppNumbersResponse = ({
     numberType?: string;
     numbers?: Array<{
         phoneNumber?: string;
+        locality?: string;
+        bestEffort?: boolean;
     }>;
 });
 type SearchAvailableWhatsAppNumbersError = (unknown | {
@@ -36650,7 +36673,7 @@ type CreateStandaloneAdData = {
          */
         multiAdvertiser?: 'OPT_IN' | 'OPT_OUT';
         /**
-         * Google Performance Max validates the complete atomic campaign and asset group with no resource creation or local persistence. Google validation still downloads image URLs and consumes quota. On Meta, validates the complete inline campaign, ad set, creative and ad with execution_options validate_only. Nothing is uploaded or created, and validation bypasses Idempotency-Key storage. Supports a single image, existing video.id or existingCreativeId; media pools, new video uploads, creatives[], adSetId and RESERVED buying return 400. Existing campaign or creative nodes are marked skipped. Success returns 200 with per-node results; Meta rejection returns an error.
+         * Google Performance Max validates the complete atomic campaign and asset group with no resource creation or local persistence. Google validation still downloads image URLs and consumes quota. On Meta, validates the complete inline campaign, ad set, creative and ad with execution_options validate_only. Nothing is uploaded or created, and validation bypasses Idempotency-Key storage. Supports a single image, all-image placementAssets with per-rule copy, existing video.id or existingCreativeId; other media pools, new video uploads, creatives[], adSetId and RESERVED buying return 400. Placement validation uses existing Instagram identities only. Existing campaign or creative nodes are marked skipped. Success returns 200 with per-node results; Meta rejection returns an error.
          */
         validateOnly?: boolean;
         /**
@@ -36710,7 +36733,7 @@ type CreateStandaloneAdData = {
          * `body` field is used as the `object_story_spec.link_data.message` (the preview text) and
          * `headlines` must also be present. On a video creative the copy lands in
          * `video_data.message` / `video_data.title` instead of `link_data`. Mutually exclusive
-         * with `dynamicCreative`, `placementAssets`, `carouselCards`, and `creatives[]`.
+         * with `dynamicCreative`, `placementAssets`, `carouselCards`, and `creatives[]`. For placement-specific copy, use the singular `placementAssets.rules[].body` and `headline` fields instead.
          *
          */
         bodies?: Array<(string)>;
@@ -37293,15 +37316,19 @@ type CreateStandaloneAdData = {
          * 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
+         * with `creatives[]` or top-level `bodies`/`headlines`/`descriptions` arrays. Each rule
+         * can override `headline`, `body` and `description` with one string per field. Omitted
+         * fields and unmatched placements use the top-level copy; `linkUrl` and `callToAction`
+         * remain shared. Zernio emits labelled text with `optimization_type: PLACEMENT`.
+         * Multiple text options rotating within a placement are not supported by this input. Each rule's `placements` accepts the same fields as the top-level
          * `placements` object; Meta enforces co-selection rules and returns an actionable error.
          *
-         * Note on text rendering: Meta suppresses primary text and headline on fullscreen
-         * placements (Stories and Reels) in actual ad delivery; the fields are accepted and
-         * the ad publishes, but the copy is not shown to users. For visible copy on those
-         * placements, bake the text into the creative image or video itself.
+         * Meta controls text rendering by placement and format. Validation accepts these fields
+         * but does not prove that every field appears in delivery. Preview the ad; put copy that
+         * must always be visible into the image or video itself.
+         *
+         * `validateOnly: true` supports all-image placementAssets without uploading or creating
+         * anything. Video placement validation remains unsupported because it requires uploads.
          *
          * A block is all-image OR all-video, never mixed (Meta's asset_feed_spec carries one ad
          * format). Image mode: `defaultImageUrl` + `rules[].imageUrl`. Video mode:
@@ -37338,6 +37365,18 @@ type CreateStandaloneAdData = {
                  * Video mode (optional). Poster image for this rule's video; auto-generated when omitted.
                  */
                 thumbnailUrl?: string;
+                /**
+                 * One headline pinned to this rule. Omit to inherit the top-level headline.
+                 */
+                headline?: string;
+                /**
+                 * One primary text pinned to this rule. Omit to inherit the top-level body.
+                 */
+                body?: string;
+                /**
+                 * One link description pinned to this rule. Omit to inherit the top-level description.
+                 */
+                description?: string;
                 /**
                  * Placements this asset is pinned to. At least one field must be set (an empty rule is invalid; that role is served by the default asset). Same enums as the top-level `placements` object.
                  */

package/dist/index.d.ts

@@ -26548,6 +26548,11 @@ type PurchasePhoneNumberData = {
          *
          */
         areaCode?: string;
+        /**
+         * One exact number to buy, in E.164, taken from GET /v1/phone-numbers/available. Hard constraint: when it is no longer available (bought by someone else, or WhatsApp's buy-time check rejects it) the purchase fails with 409 code PHONE_NUMBER_UNAVAILABLE instead of assigning another number; search again and pick another. Only for countries and types that activate instantly: a regulated one (202 kyc_required) returns 400 when phoneNumber is set.
+         *
+         */
+        phoneNumber?: string;
         /**
          * A phone number is the unit; WhatsApp is one optional feature. Pass false to buy a STANDALONE number (Calls/SMS only): provisioning skips the Meta pre-verify/OTP steps and the number activates immediately. Omitted defaults to the WhatsApp provisioning path. WhatsApp can be connected to a standalone number later from the connect flow.
          *
@@ -26614,7 +26619,7 @@ type PurchasePhoneNumberError = (unknown | {
     error?: string;
 } | {
     error?: string;
-    code?: 'PURCHASE_VELOCITY' | 'AREA_CODE_UNAVAILABLE';
+    code?: 'PURCHASE_VELOCITY' | 'AREA_CODE_UNAVAILABLE' | 'PHONE_NUMBER_UNAVAILABLE';
 });
 type ListPhoneNumberCountriesResponse = ({
     countries?: Array<{
@@ -26722,11 +26727,22 @@ type SearchAvailablePhoneNumbersResponse = ({
      */
     requireSms?: boolean;
     numbers?: Array<{
+        /**
+         * E.164. Pass it as `phoneNumber` on POST /v1/phone-numbers/purchase to buy this exact number.
+         */
         phoneNumber?: string;
         /**
          * Provider capability list for this number (e.g. voice, sms, mms).
          */
         features?: Array<(string)>;
+        /**
+         * Town or rate center the number belongs to, as the carrier names it (e.g. WACO).
+         */
+        locality?: string;
+        /**
+         * true when the carrier added this number because too few matched your filters, so it may be outside the requested prefix or locality.
+         */
+        bestEffort?: boolean;
     }>;
 });
 type SearchAvailablePhoneNumbersError = (unknown | {
@@ -26905,6 +26921,11 @@ type PurchaseWhatsAppPhoneNumberData = {
          *
          */
         country?: string;
+        /**
+         * One exact number to buy, in E.164, taken from GET /v1/phone-numbers/available. Fails with 409 code PHONE_NUMBER_UNAVAILABLE when it is no longer available.
+         *
+         */
+        phoneNumber?: string;
         /**
          * Optional idempotency key. Send the same value when retrying a purchase: if a number was already bought under this key, the API returns { status: "already_purchased", numberId, phoneNumber } instead of provisioning a second number. Generate a fresh key for each genuinely new purchase.
          *
@@ -26948,7 +26969,7 @@ type PurchaseWhatsAppPhoneNumberError = (unknown | {
     error?: string;
 } | {
     error?: string;
-    code?: 'PURCHASE_VELOCITY' | 'AREA_CODE_UNAVAILABLE';
+    code?: 'PURCHASE_VELOCITY' | 'AREA_CODE_UNAVAILABLE' | 'PHONE_NUMBER_UNAVAILABLE';
 });
 type ListWhatsAppNumberCountriesResponse = ({
     countries?: Array<{
@@ -26995,6 +27016,8 @@ type SearchAvailableWhatsAppNumbersResponse = ({
     numberType?: string;
     numbers?: Array<{
         phoneNumber?: string;
+        locality?: string;
+        bestEffort?: boolean;
     }>;
 });
 type SearchAvailableWhatsAppNumbersError = (unknown | {
@@ -36650,7 +36673,7 @@ type CreateStandaloneAdData = {
          */
         multiAdvertiser?: 'OPT_IN' | 'OPT_OUT';
         /**
-         * Google Performance Max validates the complete atomic campaign and asset group with no resource creation or local persistence. Google validation still downloads image URLs and consumes quota. On Meta, validates the complete inline campaign, ad set, creative and ad with execution_options validate_only. Nothing is uploaded or created, and validation bypasses Idempotency-Key storage. Supports a single image, existing video.id or existingCreativeId; media pools, new video uploads, creatives[], adSetId and RESERVED buying return 400. Existing campaign or creative nodes are marked skipped. Success returns 200 with per-node results; Meta rejection returns an error.
+         * Google Performance Max validates the complete atomic campaign and asset group with no resource creation or local persistence. Google validation still downloads image URLs and consumes quota. On Meta, validates the complete inline campaign, ad set, creative and ad with execution_options validate_only. Nothing is uploaded or created, and validation bypasses Idempotency-Key storage. Supports a single image, all-image placementAssets with per-rule copy, existing video.id or existingCreativeId; other media pools, new video uploads, creatives[], adSetId and RESERVED buying return 400. Placement validation uses existing Instagram identities only. Existing campaign or creative nodes are marked skipped. Success returns 200 with per-node results; Meta rejection returns an error.
          */
         validateOnly?: boolean;
         /**
@@ -36710,7 +36733,7 @@ type CreateStandaloneAdData = {
          * `body` field is used as the `object_story_spec.link_data.message` (the preview text) and
          * `headlines` must also be present. On a video creative the copy lands in
          * `video_data.message` / `video_data.title` instead of `link_data`. Mutually exclusive
-         * with `dynamicCreative`, `placementAssets`, `carouselCards`, and `creatives[]`.
+         * with `dynamicCreative`, `placementAssets`, `carouselCards`, and `creatives[]`. For placement-specific copy, use the singular `placementAssets.rules[].body` and `headline` fields instead.
          *
          */
         bodies?: Array<(string)>;
@@ -37293,15 +37316,19 @@ type CreateStandaloneAdData = {
          * 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
+         * with `creatives[]` or top-level `bodies`/`headlines`/`descriptions` arrays. Each rule
+         * can override `headline`, `body` and `description` with one string per field. Omitted
+         * fields and unmatched placements use the top-level copy; `linkUrl` and `callToAction`
+         * remain shared. Zernio emits labelled text with `optimization_type: PLACEMENT`.
+         * Multiple text options rotating within a placement are not supported by this input. Each rule's `placements` accepts the same fields as the top-level
          * `placements` object; Meta enforces co-selection rules and returns an actionable error.
          *
-         * Note on text rendering: Meta suppresses primary text and headline on fullscreen
-         * placements (Stories and Reels) in actual ad delivery; the fields are accepted and
-         * the ad publishes, but the copy is not shown to users. For visible copy on those
-         * placements, bake the text into the creative image or video itself.
+         * Meta controls text rendering by placement and format. Validation accepts these fields
+         * but does not prove that every field appears in delivery. Preview the ad; put copy that
+         * must always be visible into the image or video itself.
+         *
+         * `validateOnly: true` supports all-image placementAssets without uploading or creating
+         * anything. Video placement validation remains unsupported because it requires uploads.
          *
          * A block is all-image OR all-video, never mixed (Meta's asset_feed_spec carries one ad
          * format). Image mode: `defaultImageUrl` + `rules[].imageUrl`. Video mode:
@@ -37338,6 +37365,18 @@ type CreateStandaloneAdData = {
                  * Video mode (optional). Poster image for this rule's video; auto-generated when omitted.
                  */
                 thumbnailUrl?: string;
+                /**
+                 * One headline pinned to this rule. Omit to inherit the top-level headline.
+                 */
+                headline?: string;
+                /**
+                 * One primary text pinned to this rule. Omit to inherit the top-level body.
+                 */
+                body?: string;
+                /**
+                 * One link description pinned to this rule. Omit to inherit the top-level description.
+                 */
+                description?: string;
                 /**
                  * Placements this asset is pinned to. At least one field must be set (an empty rule is invalid; that role is served by the default asset). Same enums as the top-level `placements` object.
                  */

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -5797,8 +5797,9 @@ export const releasePhoneNumber = <ThrowOnError extends boolean = false>(options
 
 /**
  * Purchase phone number
- * Payment-first: you do not pick a specific number, the system provisions one and
- * auto-assigns it. With usage-based billing active and a payment method on file, the
+ * Payment-first: the system provisions a number and auto-assigns it, unless you pass
+ * `phoneNumber` to buy one exact number from `GET /v1/phone-numbers/available`. With
+ * usage-based billing active and a payment method on file, the
  * number provisions inline and bills per month on your usage-based invoice (there is
  * no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`;
  * a regulated country returns `202` with `status: "kyc_required"` and a `kycUrl`.
@@ -5840,7 +5841,9 @@ export const listPhoneNumberCountries = <ThrowOnError extends boolean = false>(o
  * country (default US). Optional filters narrow the results. The country
  * must be offerable (see GET /v1/phone-numbers/countries). Voice
  * capability is always required; pass `sms=true` to only see numbers that
- * can also text (SMS support is per-number, not per-country).
+ * can also text (SMS support is per-number, not per-country). Numbers a
+ * purchase would refuse are left out, and any result's `phoneNumber` can
+ * be bought exactly by passing it to POST /v1/phone-numbers/purchase.
  *
  */
 export const searchAvailablePhoneNumbers = <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<SearchAvailablePhoneNumbersData, ThrowOnError>) => {
@@ -5895,8 +5898,9 @@ export const getWhatsAppPhoneNumbers = <ThrowOnError extends boolean = false>(op
  * Deprecated alias of `/v1/phone-numbers/purchase`; same contract. New
  * integrations should use that path.
  *
- * Payment-first: you do not pick a specific number, the system provisions one and
- * auto-assigns it. With usage-based billing active and a payment method on file, the
+ * Payment-first: the system provisions a number and auto-assigns it, unless you pass
+ * `phoneNumber` to buy one exact number from `GET /v1/phone-numbers/available`. With
+ * usage-based billing active and a payment method on file, the
  * number provisions inline and bills per month on your usage-based invoice (there is
  * no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`;
  * a regulated country returns `202` with `status: "kyc_required"` and a `kycUrl`.

package/src/generated/types.gen.ts

@@ -26404,6 +26404,11 @@ export type PurchasePhoneNumberData = {
          *
          */
         areaCode?: string;
+        /**
+         * One exact number to buy, in E.164, taken from GET /v1/phone-numbers/available. Hard constraint: when it is no longer available (bought by someone else, or WhatsApp's buy-time check rejects it) the purchase fails with 409 code PHONE_NUMBER_UNAVAILABLE instead of assigning another number; search again and pick another. Only for countries and types that activate instantly: a regulated one (202 kyc_required) returns 400 when phoneNumber is set.
+         *
+         */
+        phoneNumber?: string;
         /**
          * A phone number is the unit; WhatsApp is one optional feature. Pass false to buy a STANDALONE number (Calls/SMS only): provisioning skips the Meta pre-verify/OTP steps and the number activates immediately. Omitted defaults to the WhatsApp provisioning path. WhatsApp can be connected to a standalone number later from the connect flow.
          *
@@ -26472,7 +26477,7 @@ export type PurchasePhoneNumberError = (unknown | {
     error?: string;
 } | {
     error?: string;
-    code?: 'PURCHASE_VELOCITY' | 'AREA_CODE_UNAVAILABLE';
+    code?: 'PURCHASE_VELOCITY' | 'AREA_CODE_UNAVAILABLE' | 'PHONE_NUMBER_UNAVAILABLE';
 });
 
 export type ListPhoneNumberCountriesResponse = ({
@@ -26584,11 +26589,22 @@ export type SearchAvailablePhoneNumbersResponse = ({
      */
     requireSms?: boolean;
     numbers?: Array<{
+        /**
+         * E.164. Pass it as `phoneNumber` on POST /v1/phone-numbers/purchase to buy this exact number.
+         */
         phoneNumber?: string;
         /**
          * Provider capability list for this number (e.g. voice, sms, mms).
          */
         features?: Array<(string)>;
+        /**
+         * Town or rate center the number belongs to, as the carrier names it (e.g. WACO).
+         */
+        locality?: string;
+        /**
+         * true when the carrier added this number because too few matched your filters, so it may be outside the requested prefix or locality.
+         */
+        bestEffort?: boolean;
     }>;
 });
 
@@ -26775,6 +26791,11 @@ export type PurchaseWhatsAppPhoneNumberData = {
          *
          */
         country?: string;
+        /**
+         * One exact number to buy, in E.164, taken from GET /v1/phone-numbers/available. Fails with 409 code PHONE_NUMBER_UNAVAILABLE when it is no longer available.
+         *
+         */
+        phoneNumber?: string;
         /**
          * Optional idempotency key. Send the same value when retrying a purchase: if a number was already bought under this key, the API returns { status: "already_purchased", numberId, phoneNumber } instead of provisioning a second number. Generate a fresh key for each genuinely new purchase.
          *
@@ -26820,7 +26841,7 @@ export type PurchaseWhatsAppPhoneNumberError = (unknown | {
     error?: string;
 } | {
     error?: string;
-    code?: 'PURCHASE_VELOCITY' | 'AREA_CODE_UNAVAILABLE';
+    code?: 'PURCHASE_VELOCITY' | 'AREA_CODE_UNAVAILABLE' | 'PHONE_NUMBER_UNAVAILABLE';
 });
 
 export type ListWhatsAppNumberCountriesResponse = ({
@@ -26871,6 +26892,8 @@ export type SearchAvailableWhatsAppNumbersResponse = ({
     numberType?: string;
     numbers?: Array<{
         phoneNumber?: string;
+        locality?: string;
+        bestEffort?: boolean;
     }>;
 });
 
@@ -37259,7 +37282,7 @@ export type CreateStandaloneAdData = {
          */
         multiAdvertiser?: 'OPT_IN' | 'OPT_OUT';
         /**
-         * Google Performance Max validates the complete atomic campaign and asset group with no resource creation or local persistence. Google validation still downloads image URLs and consumes quota. On Meta, validates the complete inline campaign, ad set, creative and ad with execution_options validate_only. Nothing is uploaded or created, and validation bypasses Idempotency-Key storage. Supports a single image, existing video.id or existingCreativeId; media pools, new video uploads, creatives[], adSetId and RESERVED buying return 400. Existing campaign or creative nodes are marked skipped. Success returns 200 with per-node results; Meta rejection returns an error.
+         * Google Performance Max validates the complete atomic campaign and asset group with no resource creation or local persistence. Google validation still downloads image URLs and consumes quota. On Meta, validates the complete inline campaign, ad set, creative and ad with execution_options validate_only. Nothing is uploaded or created, and validation bypasses Idempotency-Key storage. Supports a single image, all-image placementAssets with per-rule copy, existing video.id or existingCreativeId; other media pools, new video uploads, creatives[], adSetId and RESERVED buying return 400. Placement validation uses existing Instagram identities only. Existing campaign or creative nodes are marked skipped. Success returns 200 with per-node results; Meta rejection returns an error.
          */
         validateOnly?: boolean;
         /**
@@ -37319,7 +37342,7 @@ export type CreateStandaloneAdData = {
          * `body` field is used as the `object_story_spec.link_data.message` (the preview text) and
          * `headlines` must also be present. On a video creative the copy lands in
          * `video_data.message` / `video_data.title` instead of `link_data`. Mutually exclusive
-         * with `dynamicCreative`, `placementAssets`, `carouselCards`, and `creatives[]`.
+         * with `dynamicCreative`, `placementAssets`, `carouselCards`, and `creatives[]`. For placement-specific copy, use the singular `placementAssets.rules[].body` and `headline` fields instead.
          *
          */
         bodies?: Array<(string)>;
@@ -37902,15 +37925,19 @@ export type CreateStandaloneAdData = {
          * 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
+         * with `creatives[]` or top-level `bodies`/`headlines`/`descriptions` arrays. Each rule
+         * can override `headline`, `body` and `description` with one string per field. Omitted
+         * fields and unmatched placements use the top-level copy; `linkUrl` and `callToAction`
+         * remain shared. Zernio emits labelled text with `optimization_type: PLACEMENT`.
+         * Multiple text options rotating within a placement are not supported by this input. Each rule's `placements` accepts the same fields as the top-level
          * `placements` object; Meta enforces co-selection rules and returns an actionable error.
          *
-         * Note on text rendering: Meta suppresses primary text and headline on fullscreen
-         * placements (Stories and Reels) in actual ad delivery; the fields are accepted and
-         * the ad publishes, but the copy is not shown to users. For visible copy on those
-         * placements, bake the text into the creative image or video itself.
+         * Meta controls text rendering by placement and format. Validation accepts these fields
+         * but does not prove that every field appears in delivery. Preview the ad; put copy that
+         * must always be visible into the image or video itself.
+         *
+         * `validateOnly: true` supports all-image placementAssets without uploading or creating
+         * anything. Video placement validation remains unsupported because it requires uploads.
          *
          * A block is all-image OR all-video, never mixed (Meta's asset_feed_spec carries one ad
          * format). Image mode: `defaultImageUrl` + `rules[].imageUrl`. Video mode:
@@ -37947,6 +37974,18 @@ export type CreateStandaloneAdData = {
                  * Video mode (optional). Poster image for this rule's video; auto-generated when omitted.
                  */
                 thumbnailUrl?: string;
+                /**
+                 * One headline pinned to this rule. Omit to inherit the top-level headline.
+                 */
+                headline?: string;
+                /**
+                 * One primary text pinned to this rule. Omit to inherit the top-level body.
+                 */
+                body?: string;
+                /**
+                 * One link description pinned to this rule. Omit to inherit the top-level description.
+                 */
+                description?: string;
                 /**
                  * Placements this asset is pinned to. At least one field must be set (an empty rule is invalid; that role is served by the default asset). Same enums as the top-level `placements` object.
                  */