@zernio/node 0.2.758 → 0.2.760

package/src/generated/sdk.gen.ts

@@ -8644,11 +8644,8 @@ export const getAdsTimeline = <ThrowOnError extends boolean = false>(options: Op
  * - the creative's `effective_instagram_media_id` (Instagram side)
  *
  * Any of the four resolve to the same ad. Caller doesn't need a translation step.
- * By default, creative.promotion and creative.creativeFeatures contain stored requested
- * settings, which do not confirm platform application. With `refreshPromotion=true`,
- * Meta promotion metadata is read live and exposed as `ad.creative.promotion`
- * with `promotionStatus`. Only `applied` confirms an offer; `not_returned` means the
- * creative read succeeded without promotion metadata, and `unavailable` means it failed.
+ * `creative.creativeFeatures` holds the stored requested settings, which do not confirm
+ * platform application.
  *
  */
 export const getAd = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetAdData, ThrowOnError>) => {
@@ -9426,11 +9423,8 @@ export const listAdCreatives = <ThrowOnError extends boolean = false>(options: O
  * `existingCreativeId`. Provide exactly one of `imageUrl` (uploaded server-side),
  * `imageHash` (from POST /v1/ads/images or the library list), or `carouselCards` (2-10
  * hand-built cards). The Page (and linked Instagram account, when present) is resolved
- * from `accountId` as the story actor. `promotion` configures an explicit offer separately
- * from Advantage+ `creativeFeatures`. Only when `promotion` is supplied does the response
- * read the creative back from Meta;
- * `promotionStatus: not_returned` means Meta accepted creation but omitted promotion
- * metadata, so the requested offer is not confirmed as applied.
+ * from `accountId` as the story actor. `creativeFeatures` configures Advantage+
+ * enhancements. `promotion` is not supported and any object is rejected with 400.
  */
 export const createAdCreative = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CreateAdCreativeData, ThrowOnError>) => {
     return (options?.client ?? client).post<CreateAdCreativeResponse, CreateAdCreativeError, ThrowOnError>({
@@ -10039,15 +10033,11 @@ export const listGoogleAssetGroups = <ThrowOnError extends boolean = false>(opti
  * - Meta-only multi-creative shape via the creatives array: one ad set with N ads sharing budget and targeting.
  * - Attach shape via adSetId: adds one new ad to an existing ad set, inheriting its budget, targeting, and schedule (Meta, Google Ads, TikTok, and LinkedIn). On LinkedIn adSetId is the existing Campaign id, and the budget, schedule, targeting and bidding fields must be omitted.
  *
- * Meta accepts `promotion` and `creativeFeatures` on the single and attach shapes and
- * as defaults for `creatives[]`. An item replaces the whole feature map; its `promotion`
- * replaces the default offer, and `promotion: null` disables that default for the item.
+ * Meta accepts `creativeFeatures` on the single and attach shapes and as defaults for
+ * `creatives[]`; an item replaces the whole feature map. `promotion` is not supported on any
+ * shape and any object is rejected with 400.
  * Reusing `existingCreativeId` uses the existing creative settings instead of new settings.
  * Requested settings are persisted for lists, exports, and default ad-detail reads.
- * Only ads supplied a `promotion` receive live readback; multi-create batches those reads
- * in groups of up to 50 IDs without per-ad fallback. Inspect `ad.creative.promotionStatus` (or
- * `ads[].creative.promotionStatus`). `not_returned` means Meta omitted the metadata;
- * successful creation does not by itself prove the offer was applied or will display.
  *
  * Per-platform required fields, budget minimums, and video-ad rules are documented on each property below.
  *

package/src/generated/types.gen.ts

@@ -291,11 +291,6 @@ export type Ad = {
          * Public Facebook watch URL for VIDEO-type ads (https://www.facebook.com/watch/?v={videoId}). Null for non-video ads.
          */
         videoUrl?: (string) | null;
-        /**
-         * Meta offer read from the live creative on creation or GET /v1/ads/{adId}. Null when metadata is not returned or cannot be read. Requested values are never echoed as applied.
-         */
-        promotion?: MetaPromotion;
-        promotionStatus?: MetaPromotionStatus;
         /**
          * Meta ad creative id backing this ad. Reusable via existingCreativeId on POST /v1/ads/create.
          */
@@ -1460,6 +1455,10 @@ export type AnalyticsListResponse = {
         platform?: string;
         platformPostUrl?: string;
         isExternal?: boolean;
+        /**
+         * True when this post's metrics include paid delivery, so organic reporting should exclude it. Set for LinkedIn dark posts and for TikTok posts that one of your TikTok ads promotes (Spark / boosted). TikTok exposes no ad flag of its own, so a video created by an uploaded-asset (non-Spark) TikTok ad is posted to the profile with a fresh organic id and cannot be detected: those still report as false.
+         */
+        isAd?: boolean;
         profileId?: (string) | null;
         thumbnailUrl?: string;
         mediaType?: 'image' | 'video' | 'gif' | 'document' | 'carousel' | 'text';
@@ -5750,7 +5749,7 @@ export type MetaAdsPlatformData = {
 };
 
 /**
- * Meta Advantage+ creative enhancements. Map snake_case feature names to OPT_IN or OPT_OUT; Meta validates supported keys and unspecified features default to OPT_OUT. auto_promotion_tag is an enhancement; use the separate promotion field for an explicit offer. The deprecated standard_enhancements bundle is rejected by Meta.
+ * Meta Advantage+ creative enhancements. Map snake_case feature names to OPT_IN or OPT_OUT; Meta validates supported keys and unspecified features default to OPT_OUT. auto_promotion_tag is an Advantage+ enhancement, not the Ads Manager Promotion setting. The deprecated standard_enhancements bundle is rejected by Meta.
  */
 export type MetaCreativeFeatures = {
     [key: string]: ('OPT_IN' | 'OPT_OUT');
@@ -5772,40 +5771,9 @@ export type MetaInstagramIdentityRef = {
 };
 
 /**
- * Meta explicit Promotion offer. Maps to creative_sourcing_spec.promotion_metadata_spec with promotion_source ADVERTISER_INPUT. Dates become Unix seconds. Send null to omit an explicit offer on a new creative or remove it when rebuilding. Creation success alone does not confirm application: inspect promotionStatus in the response.
- */
-export type MetaPromotion = {
-    /**
-     * Promotion type accepted by Meta. PERCENTAGE_OFF values cannot exceed 100.
-     */
-    type: 'AMOUNT_OFF' | 'FREE_RETURN' | 'FREE_SHIPPING' | 'PERCENTAGE_OFF' | 'PROMO_CODE';
-    /**
-     * Nonnegative promotion value passed to Meta unchanged. AMOUNT_OFF units are not confirmed, including major versus minor currency units. For PERCENTAGE_OFF this is the percentage discount, at most 100.
-     */
-    value: number;
-    /**
-     * Optional promotion code.
-     */
-    code?: string;
-    /**
-     * Optional ISO 8601 start timestamp with a timezone offset or Z.
-     */
-    startDate?: string;
-    /**
-     * Optional ISO 8601 end timestamp with a timezone offset or Z. Must be after startDate when both are set.
-     */
-    endDate?: string;
-} | null;
-
-/**
- * Promotion type accepted by Meta. PERCENTAGE_OFF values cannot exceed 100.
- */
-export type type8 = 'AMOUNT_OFF' | 'FREE_RETURN' | 'FREE_SHIPPING' | 'PERCENTAGE_OFF' | 'PROMO_CODE';
-
-/**
- * Meta creative readback result. applied means Meta returned promotion metadata; not_returned means the read succeeded without promotion metadata; unavailable means the read failed. Only applied confirms the returned offer. Missing metadata is not proof that Ads Manager displays the requested Promotion.
+ * Not supported. Meta validates creative_sourcing_spec.promotion_metadata_spec on the create call and then discards it, so a Promotion set through the Marketing API never reaches the creative. Any object is rejected with 400 invalid_field_value. Send null or omit the field, and set the Promotion on the ad in Ads Manager. Verified on 2026-09-11 across Graph v19.0 to v25.0 and every write path.
  */
-export type MetaPromotionStatus = 'applied' | 'not_returned' | 'unavailable';
+export type MetaPromotion = null;
 
 export type Money = {
     /**
@@ -6058,7 +6026,7 @@ export type PortfolioBidStrategy = {
     targetRoas?: (number) | null;
 };
 
-export type type9 = 'TARGET_CPA' | 'TARGET_ROAS' | 'MAXIMIZE_CONVERSIONS' | 'MAXIMIZE_CONVERSION_VALUE';
+export type type8 = 'TARGET_CPA' | 'TARGET_ROAS' | 'MAXIMIZE_CONVERSIONS' | 'MAXIMIZE_CONVERSION_VALUE';
 
 export type Post = {
     _id?: string;
@@ -7381,7 +7349,7 @@ export type UploadedFile = {
     mimeType?: string;
 };
 
-export type type10 = 'image' | 'video' | 'document';
+export type type9 = 'image' | 'video' | 'document';
 
 export type UploadTokenResponse = {
     token?: string;
@@ -10546,7 +10514,7 @@ export type WhatsAppTemplateButton = {
     navigate_screen?: string;
 };
 
-export type type11 = 'quick_reply' | 'url' | 'phone_number' | 'otp' | 'copy_code' | 'flow' | 'mpm' | 'catalog';
+export type type10 = 'quick_reply' | 'url' | 'phone_number' | 'otp' | 'copy_code' | 'flow' | 'mpm' | 'catalog';
 
 /**
  * Required when type is otp
@@ -10708,7 +10676,7 @@ export type WorkflowNode = {
  * integrations (webhook, ai, handoff, start_call).
  *
  */
-export type type12 = 'trigger' | 'send_message' | 'wait_for_reply' | 'condition' | 'set_variable' | 'delay' | 'webhook' | 'ai' | 'handoff' | 'start_call' | 'a_b_split' | 'set_field' | 'enroll_sequence' | 'add_tag' | 'remove_tag' | 'end';
+export type type11 = 'trigger' | 'send_message' | 'wait_for_reply' | 'condition' | 'set_variable' | 'delay' | 'webhook' | 'ai' | 'handoff' | 'start_call' | 'a_b_split' | 'set_field' | 'enroll_sequence' | 'add_tag' | 'remove_tag' | 'end';
 
 /**
  * A single X API operation with its per-call price and the Zernio platform methods that trigger it.
@@ -10844,7 +10812,7 @@ export type XArticleBlock = {
     entity_ranges?: Array<XArticleEntityRange>;
 };
 
-export type type13 = 'unstyled' | 'header-one' | 'header-two' | 'header-three' | 'unordered-list-item' | 'ordered-list-item' | 'blockquote' | 'atomic';
+export type type12 = 'unstyled' | 'header-one' | 'header-two' | 'header-three' | 'unordered-list-item' | 'ordered-list-item' | 'blockquote' | 'atomic';
 
 /**
  * X's snake_case content-state shape. Standard DraftJS camelCase fields such as entityMap, inlineStyleRanges, and entityRanges are rejected.
@@ -10923,7 +10891,7 @@ export type XArticleEntity = {
 
 export type mutability = 'immutable' | 'mutable' | 'segmented';
 
-export type type14 = 'divider' | 'latex';
+export type type13 = 'divider' | 'latex';
 
 /**
  * The referenced entity must exist, and offset plus length must not exceed the containing block's text length.
@@ -33763,12 +33731,6 @@ export type GetAdData = {
          */
         adId: string;
     };
-    query?: {
-        /**
-         * Meta only. Read current promotion metadata from Meta and include promotionStatus. Omit for stored creative settings with no promotion-specific Graph call.
-         */
-        refreshPromotion?: boolean;
-    };
 };
 
 export type GetAdResponse = ({
@@ -33919,10 +33881,9 @@ export type UpdateAdData = {
          * GET /v1/ads/creatives and ignores every other field. Meta creatives are
          * immutable, so any change creates a new creative and repoints the ad; the old
          * creative is retained on the ad account for historical reporting.
-         * `promotion` and `creativeFeatures` are Meta-only. Omitted settings are
-         * preserved from the live creative, including full rebuilds. Send
-         * `promotion: null` to remove the explicit offer from the replacement.
-         * A supplied creativeFeatures map overrides individual existing keys.
+         * `creativeFeatures` is Meta-only. Omitted settings are preserved from the
+         * live creative, including full rebuilds. A supplied creativeFeatures map
+         * overrides individual existing keys.
          * - **TikTok**: patch-style. Pass any subset; `headline` is ignored (TikTok creatives
          * have no headline slot). `body` becomes the in-feed `ad_text`; `linkUrl` becomes
          * `landing_page_url`; `videoUrl` triggers a fresh upload. `description`, `videoId`
@@ -33935,6 +33896,9 @@ export type UpdateAdData = {
          *
          */
         creative?: {
+            /**
+             * Not supported. Meta validates creative_sourcing_spec.promotion_metadata_spec on the create call and then discards it, so a Promotion set through the Marketing API never reaches the creative. Any object is rejected with 400 invalid_field_value. Send null or omit the field, and set the Promotion on the ad in Ads Manager. Verified on 2026-09-11 across Graph v19.0 to v25.0 and every write path.
+             */
             promotion?: MetaPromotion;
             creativeFeatures?: MetaCreativeFeatures;
             /**
@@ -35754,9 +35718,12 @@ export type CreateAdCreativeData = {
          * Appended to every outbound URL (e.g. utm_source=fb).
          */
         urlTags?: string;
+        /**
+         * Not supported. Meta validates creative_sourcing_spec.promotion_metadata_spec on the create call and then discards it, so a Promotion set through the Marketing API never reaches the creative. Any object is rejected with 400 invalid_field_value. Send null or omit the field, and set the Promotion on the ad in Ads Manager. Verified on 2026-09-11 across Graph v19.0 to v25.0 and every write path.
+         */
         promotion?: MetaPromotion;
         /**
-         * Meta only. Applied to each new creative, including standalone and attach shapes. With creatives[], these are defaults; an item replaces the whole feature map, including an empty map. auto_promotion_tag is an enhancement; an explicit offer uses promotion.
+         * Meta only. Applied to each new creative, including standalone and attach shapes. With creatives[], these are defaults; an item replaces the whole feature map, including an empty map. auto_promotion_tag is an Advantage+ enhancement, not the Ads Manager Promotion setting.
          */
         creativeFeatures?: MetaCreativeFeatures;
         /**
@@ -35772,8 +35739,6 @@ export type CreateAdCreativeResponse = ({
      * Platform creative id, reusable via existingCreativeId.
      */
     creativeId?: string;
-    promotion?: MetaPromotion;
-    promotionStatus?: MetaPromotionStatus;
 });
 
 export type CreateAdCreativeError = (unknown | {
@@ -37371,9 +37336,12 @@ export type CreateStandaloneAdData = {
          * Meta only. The RESERVED prediction id the R&F ad set runs on (reserving mints a new id, so pass that one). Requires buyingType RESERVED.
          */
         rfPredictionId?: string;
+        /**
+         * Not supported. Meta validates creative_sourcing_spec.promotion_metadata_spec on the create call and then discards it, so a Promotion set through the Marketing API never reaches the creative. Any object is rejected with 400 invalid_field_value. Send null or omit the field, and set the Promotion on the ad in Ads Manager. Verified on 2026-09-11 across Graph v19.0 to v25.0 and every write path.
+         */
         promotion?: MetaPromotion;
         /**
-         * Meta only. Applied to each new creative, including standalone and attach shapes. With creatives[], these are defaults; an item replaces the whole feature map, including an empty map. auto_promotion_tag is an enhancement; an explicit offer uses promotion.
+         * Meta only. Applied to each new creative, including standalone and attach shapes. With creatives[], these are defaults; an item replaces the whole feature map, including an empty map. auto_promotion_tag is an Advantage+ enhancement, not the Ads Manager Promotion setting.
          */
         creativeFeatures?: MetaCreativeFeatures;
         /**
@@ -37514,10 +37482,6 @@ export type CreateStandaloneAdData = {
          *
          */
         creatives?: Array<{
-            /**
-             * Overrides the top-level offer for this item. Omit to inherit; null disables the inherited offer.
-             */
-            promotion?: MetaPromotion;
             /**
              * Replaces the entire top-level creativeFeatures map for this item. Omit to inherit; an empty map clears these defaults.
              */