@zernio/node 0.2.690 → 0.2.692

package/dist/index.d.mts

@@ -5321,6 +5321,22 @@ type InstagramPlatformData = {
      * When true, the post is labeled by Instagram as containing AI-generated media. Per Meta, this self-disclosure label is for AI-generated media, not AI-written captions. Applies to feed posts, Reels, Stories, and carousels.
      */
     isAiGenerated?: boolean;
+    /**
+     * When true, Instagram shows the "Paid partnership" label on the post. Applies to feed posts, Reels, and carousels; not supported on Stories (400). Requires an Instagram account connected via Facebook Login; classic Instagram Login accounts get a 400 (instagram_paid_partnership_requires_facebook_login). Implied when brandedContentSponsors is set.
+     */
+    isPaidPartnership?: boolean;
+    /**
+     * Up to 2 brands to tag as sponsors, each an Instagram username (leading @ optional) or a numeric Instagram user ID. Usernames are resolved at publish time via the Business Discovery API on the publishing account; a sponsor that cannot be resolved (private, personal, or nonexistent account) fails the post with a user error naming it. Sponsors must be professional (Business or Creator) accounts. A brand that has pre-approved the creator shows as "Paid partnership with @brand" immediately; otherwise the plain label shows and the brand receives an approval request. Sets isPaidPartnership. Same login and content-type rules as isPaidPartnership.
+     */
+    brandedContentSponsors?: Array<(string)>;
+    /**
+     * When false, comments are turned off on the post right after it is published (Meta exposes this as comment_enabled on the media object). Applies to feed posts, Reels, and carousels; ignored for Stories, which have no comments. Works with both Instagram connection methods. Best-effort: if the toggle fails after a successful publish, the post still succeeds and stays live with comments on.
+     */
+    commentsEnabled?: boolean;
+    /**
+     * Tags the post with a location. The ID of a Facebook Page that has location data (digits only); it is sent to Instagram as location_id. Applies to feed posts, Reels, and the carousel as a whole; Stories and individual carousel slides are unsupported (a Story with locationId is rejected with a 400). A Page without location data or that does not exist fails the post with a user error at publish time.
+     */
+    locationId?: string;
 };
 /**
  * Set to 'story' to publish as a Story. Default posts become Reels or feed depending on media.
@@ -32688,9 +32704,31 @@ type CreateStandaloneAdData = {
          */
         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.
+         * 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 `descriptions` (array) instead.
          */
         description?: string;
+        /**
+         * Meta only. Multiple Text Options (Advantage+ Flexible Format): supply 1-5 primary-text
+         * variations and Meta optimises delivery across them, WITHOUT enabling full Dynamic Creative
+         * (`dynamicCreative`). Uses `optimization_type: DEGREES_OF_FREEDOM` on the asset feed, so
+         * multiple ads per ad set are allowed (unlike `dynamicCreative` which is limited to one).
+         * Requires `imageUrl` or `video`, `linkUrl`, and `callToAction`. When set, the top-level
+         * `body` field is used as the `object_story_spec.link_data.message` (the preview text) and
+         * `headlines` must also be present. Mutually exclusive with `dynamicCreative`,
+         * `placementAssets`, `carouselCards`, and `creatives[]`.
+         *
+         */
+        bodies?: Array<(string)>;
+        /**
+         * Meta only. Headline variations for Multiple Text Options. Must be sent alongside `bodies`.
+         * The top-level `headline` field is used as the `object_story_spec.link_data.name`.
+         *
+         */
+        headlines?: Array<(string)>;
+        /**
+         * Meta only. Optional description variations for Multiple Text Options. Sent alongside `bodies` and `headlines`.
+         */
+        descriptions?: Array<(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.
          */

package/dist/index.d.ts

@@ -5321,6 +5321,22 @@ type InstagramPlatformData = {
      * When true, the post is labeled by Instagram as containing AI-generated media. Per Meta, this self-disclosure label is for AI-generated media, not AI-written captions. Applies to feed posts, Reels, Stories, and carousels.
      */
     isAiGenerated?: boolean;
+    /**
+     * When true, Instagram shows the "Paid partnership" label on the post. Applies to feed posts, Reels, and carousels; not supported on Stories (400). Requires an Instagram account connected via Facebook Login; classic Instagram Login accounts get a 400 (instagram_paid_partnership_requires_facebook_login). Implied when brandedContentSponsors is set.
+     */
+    isPaidPartnership?: boolean;
+    /**
+     * Up to 2 brands to tag as sponsors, each an Instagram username (leading @ optional) or a numeric Instagram user ID. Usernames are resolved at publish time via the Business Discovery API on the publishing account; a sponsor that cannot be resolved (private, personal, or nonexistent account) fails the post with a user error naming it. Sponsors must be professional (Business or Creator) accounts. A brand that has pre-approved the creator shows as "Paid partnership with @brand" immediately; otherwise the plain label shows and the brand receives an approval request. Sets isPaidPartnership. Same login and content-type rules as isPaidPartnership.
+     */
+    brandedContentSponsors?: Array<(string)>;
+    /**
+     * When false, comments are turned off on the post right after it is published (Meta exposes this as comment_enabled on the media object). Applies to feed posts, Reels, and carousels; ignored for Stories, which have no comments. Works with both Instagram connection methods. Best-effort: if the toggle fails after a successful publish, the post still succeeds and stays live with comments on.
+     */
+    commentsEnabled?: boolean;
+    /**
+     * Tags the post with a location. The ID of a Facebook Page that has location data (digits only); it is sent to Instagram as location_id. Applies to feed posts, Reels, and the carousel as a whole; Stories and individual carousel slides are unsupported (a Story with locationId is rejected with a 400). A Page without location data or that does not exist fails the post with a user error at publish time.
+     */
+    locationId?: string;
 };
 /**
  * Set to 'story' to publish as a Story. Default posts become Reels or feed depending on media.
@@ -32688,9 +32704,31 @@ type CreateStandaloneAdData = {
          */
         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.
+         * 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 `descriptions` (array) instead.
          */
         description?: string;
+        /**
+         * Meta only. Multiple Text Options (Advantage+ Flexible Format): supply 1-5 primary-text
+         * variations and Meta optimises delivery across them, WITHOUT enabling full Dynamic Creative
+         * (`dynamicCreative`). Uses `optimization_type: DEGREES_OF_FREEDOM` on the asset feed, so
+         * multiple ads per ad set are allowed (unlike `dynamicCreative` which is limited to one).
+         * Requires `imageUrl` or `video`, `linkUrl`, and `callToAction`. When set, the top-level
+         * `body` field is used as the `object_story_spec.link_data.message` (the preview text) and
+         * `headlines` must also be present. Mutually exclusive with `dynamicCreative`,
+         * `placementAssets`, `carouselCards`, and `creatives[]`.
+         *
+         */
+        bodies?: Array<(string)>;
+        /**
+         * Meta only. Headline variations for Multiple Text Options. Must be sent alongside `bodies`.
+         * The top-level `headline` field is used as the `object_story_spec.link_data.name`.
+         *
+         */
+        headlines?: Array<(string)>;
+        /**
+         * Meta only. Optional description variations for Multiple Text Options. Sent alongside `bodies` and `headlines`.
+         */
+        descriptions?: Array<(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.
          */

package/dist/index.js

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

package/src/generated/types.gen.ts

@@ -4117,6 +4117,22 @@ export type InstagramPlatformData = {
      * When true, the post is labeled by Instagram as containing AI-generated media. Per Meta, this self-disclosure label is for AI-generated media, not AI-written captions. Applies to feed posts, Reels, Stories, and carousels.
      */
     isAiGenerated?: boolean;
+    /**
+     * When true, Instagram shows the "Paid partnership" label on the post. Applies to feed posts, Reels, and carousels; not supported on Stories (400). Requires an Instagram account connected via Facebook Login; classic Instagram Login accounts get a 400 (instagram_paid_partnership_requires_facebook_login). Implied when brandedContentSponsors is set.
+     */
+    isPaidPartnership?: boolean;
+    /**
+     * Up to 2 brands to tag as sponsors, each an Instagram username (leading @ optional) or a numeric Instagram user ID. Usernames are resolved at publish time via the Business Discovery API on the publishing account; a sponsor that cannot be resolved (private, personal, or nonexistent account) fails the post with a user error naming it. Sponsors must be professional (Business or Creator) accounts. A brand that has pre-approved the creator shows as "Paid partnership with @brand" immediately; otherwise the plain label shows and the brand receives an approval request. Sets isPaidPartnership. Same login and content-type rules as isPaidPartnership.
+     */
+    brandedContentSponsors?: Array<(string)>;
+    /**
+     * When false, comments are turned off on the post right after it is published (Meta exposes this as comment_enabled on the media object). Applies to feed posts, Reels, and carousels; ignored for Stories, which have no comments. Works with both Instagram connection methods. Best-effort: if the toggle fails after a successful publish, the post still succeeds and stays live with comments on.
+     */
+    commentsEnabled?: boolean;
+    /**
+     * Tags the post with a location. The ID of a Facebook Page that has location data (digits only); it is sent to Instagram as location_id. Applies to feed posts, Reels, and the carousel as a whole; Stories and individual carousel slides are unsupported (a Story with locationId is rejected with a 400). A Page without location data or that does not exist fails the post with a user error at publish time.
+     */
+    locationId?: string;
 };
 
 /**
@@ -33293,9 +33309,31 @@ export type CreateStandaloneAdData = {
          */
         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.
+         * 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 `descriptions` (array) instead.
          */
         description?: string;
+        /**
+         * Meta only. Multiple Text Options (Advantage+ Flexible Format): supply 1-5 primary-text
+         * variations and Meta optimises delivery across them, WITHOUT enabling full Dynamic Creative
+         * (`dynamicCreative`). Uses `optimization_type: DEGREES_OF_FREEDOM` on the asset feed, so
+         * multiple ads per ad set are allowed (unlike `dynamicCreative` which is limited to one).
+         * Requires `imageUrl` or `video`, `linkUrl`, and `callToAction`. When set, the top-level
+         * `body` field is used as the `object_story_spec.link_data.message` (the preview text) and
+         * `headlines` must also be present. Mutually exclusive with `dynamicCreative`,
+         * `placementAssets`, `carouselCards`, and `creatives[]`.
+         *
+         */
+        bodies?: Array<(string)>;
+        /**
+         * Meta only. Headline variations for Multiple Text Options. Must be sent alongside `bodies`.
+         * The top-level `headline` field is used as the `object_story_spec.link_data.name`.
+         *
+         */
+        headlines?: Array<(string)>;
+        /**
+         * Meta only. Optional description variations for Multiple Text Options. Sent alongside `bodies` and `headlines`.
+         */
+        descriptions?: Array<(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.
          */