@zernio/node 0.2.813 → 0.2.815

package/dist/index.d.mts

@@ -37765,6 +37765,46 @@ type BoostPostData = {
          * TikTok only. Run the Spark post in a Smart+ campaign (goal `conversions` = Smart+ Web Conversions, `lead_generation` = Smart+ Lead Generation) instead of a regular campaign. Requires `sparkAuthCode` (the Smart+ ad runs the post under the identity that redeeming its Spark code creates; a Business Center-owned post is not accepted there) and `promotedObject.pixelId` + `customEventType`. `app_promotion` is not available on a Spark post. Rejected with a 400 on other platforms. A Smart+ Spark ad uses a dynamic CTA portfolio, sent as ad_configuration.call_to_action_id (TikTok does not accept a named call to action there): Zernio creates one per ad account and reuses it, and `callToAction` is rejected with a 400 on this path.
          */
         smartPlus?: boolean;
+        /**
+         * TikTok Smart+ only (requires `smartPlus: true`). Several Spark posts as creatives of ONE Smart+ ad, each with its own post code (TikTok allows 1-50 per ad; posts from different creators mix). Replaces `platformPostId` + `sparkAuthCode`. Without `adSetId` it creates campaign + ad group + one ad carrying all of them; with `adSetId` it creates one new ad with all of them in that ad group. Rejected with a 400 on other platforms.
+         */
+        sparkPosts?: Array<{
+            /**
+             * TikTok post (item) id.
+             */
+            platformPostId: string;
+            /**
+             * That post's Spark code.
+             */
+            sparkAuthCode: string;
+        }>;
+        /**
+         * TikTok Smart+ Web Conversions only (requires `smartPlus: true`, goal `conversions`). Promo codes or offers TikTok highlights on the ad (Ads Manager's "Add promo code or offer"). A promo code needs shoppers to enter it at checkout; an entry without `promoCode` is an offer applied automatically. Rejected with a 400 on other platforms and on Lead Generation campaigns.
+         */
+        promoCodes?: Array<{
+            discountType: 'PERCENTAGE' | 'CASH';
+            /**
+             * PERCENTAGE: integer 1-100. CASH: amount greater than 0 in discountCurrency.
+             */
+            discountValue: number;
+            /**
+             * ISO 4217; required for CASH.
+             */
+            discountCurrency?: string;
+            /**
+             * Code entered at checkout; omit for an automatic offer.
+             */
+            promoCode?: string;
+            minimumPurchaseType?: 'QUANTITY' | 'SUBTOTAL';
+            /**
+             * Required with minimumPurchaseType; QUANTITY is an integer >= 0, SUBTOTAL an amount > 0.
+             */
+            minimumPurchaseValue?: number;
+            /**
+             * ISO 4217; required for SUBTOTAL.
+             */
+            minimumPurchaseCurrency?: string;
+        }>;
         /**
          * TikTok-only on this endpoint. The pixel a Website Conversion ad group
          * optimizes toward, so a Spark Ad built from an existing organic post can

package/dist/index.d.ts

@@ -37765,6 +37765,46 @@ type BoostPostData = {
          * TikTok only. Run the Spark post in a Smart+ campaign (goal `conversions` = Smart+ Web Conversions, `lead_generation` = Smart+ Lead Generation) instead of a regular campaign. Requires `sparkAuthCode` (the Smart+ ad runs the post under the identity that redeeming its Spark code creates; a Business Center-owned post is not accepted there) and `promotedObject.pixelId` + `customEventType`. `app_promotion` is not available on a Spark post. Rejected with a 400 on other platforms. A Smart+ Spark ad uses a dynamic CTA portfolio, sent as ad_configuration.call_to_action_id (TikTok does not accept a named call to action there): Zernio creates one per ad account and reuses it, and `callToAction` is rejected with a 400 on this path.
          */
         smartPlus?: boolean;
+        /**
+         * TikTok Smart+ only (requires `smartPlus: true`). Several Spark posts as creatives of ONE Smart+ ad, each with its own post code (TikTok allows 1-50 per ad; posts from different creators mix). Replaces `platformPostId` + `sparkAuthCode`. Without `adSetId` it creates campaign + ad group + one ad carrying all of them; with `adSetId` it creates one new ad with all of them in that ad group. Rejected with a 400 on other platforms.
+         */
+        sparkPosts?: Array<{
+            /**
+             * TikTok post (item) id.
+             */
+            platformPostId: string;
+            /**
+             * That post's Spark code.
+             */
+            sparkAuthCode: string;
+        }>;
+        /**
+         * TikTok Smart+ Web Conversions only (requires `smartPlus: true`, goal `conversions`). Promo codes or offers TikTok highlights on the ad (Ads Manager's "Add promo code or offer"). A promo code needs shoppers to enter it at checkout; an entry without `promoCode` is an offer applied automatically. Rejected with a 400 on other platforms and on Lead Generation campaigns.
+         */
+        promoCodes?: Array<{
+            discountType: 'PERCENTAGE' | 'CASH';
+            /**
+             * PERCENTAGE: integer 1-100. CASH: amount greater than 0 in discountCurrency.
+             */
+            discountValue: number;
+            /**
+             * ISO 4217; required for CASH.
+             */
+            discountCurrency?: string;
+            /**
+             * Code entered at checkout; omit for an automatic offer.
+             */
+            promoCode?: string;
+            minimumPurchaseType?: 'QUANTITY' | 'SUBTOTAL';
+            /**
+             * Required with minimumPurchaseType; QUANTITY is an integer >= 0, SUBTOTAL an amount > 0.
+             */
+            minimumPurchaseValue?: number;
+            /**
+             * ISO 4217; required for SUBTOTAL.
+             */
+            minimumPurchaseCurrency?: string;
+        }>;
         /**
          * TikTok-only on this endpoint. The pixel a Website Conversion ad group
          * optimizes toward, so a Spark Ad built from an existing organic post can

package/dist/index.js

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

package/src/generated/types.gen.ts

@@ -38368,6 +38368,46 @@ export type BoostPostData = {
          * TikTok only. Run the Spark post in a Smart+ campaign (goal `conversions` = Smart+ Web Conversions, `lead_generation` = Smart+ Lead Generation) instead of a regular campaign. Requires `sparkAuthCode` (the Smart+ ad runs the post under the identity that redeeming its Spark code creates; a Business Center-owned post is not accepted there) and `promotedObject.pixelId` + `customEventType`. `app_promotion` is not available on a Spark post. Rejected with a 400 on other platforms. A Smart+ Spark ad uses a dynamic CTA portfolio, sent as ad_configuration.call_to_action_id (TikTok does not accept a named call to action there): Zernio creates one per ad account and reuses it, and `callToAction` is rejected with a 400 on this path.
          */
         smartPlus?: boolean;
+        /**
+         * TikTok Smart+ only (requires `smartPlus: true`). Several Spark posts as creatives of ONE Smart+ ad, each with its own post code (TikTok allows 1-50 per ad; posts from different creators mix). Replaces `platformPostId` + `sparkAuthCode`. Without `adSetId` it creates campaign + ad group + one ad carrying all of them; with `adSetId` it creates one new ad with all of them in that ad group. Rejected with a 400 on other platforms.
+         */
+        sparkPosts?: Array<{
+            /**
+             * TikTok post (item) id.
+             */
+            platformPostId: string;
+            /**
+             * That post's Spark code.
+             */
+            sparkAuthCode: string;
+        }>;
+        /**
+         * TikTok Smart+ Web Conversions only (requires `smartPlus: true`, goal `conversions`). Promo codes or offers TikTok highlights on the ad (Ads Manager's "Add promo code or offer"). A promo code needs shoppers to enter it at checkout; an entry without `promoCode` is an offer applied automatically. Rejected with a 400 on other platforms and on Lead Generation campaigns.
+         */
+        promoCodes?: Array<{
+            discountType: 'PERCENTAGE' | 'CASH';
+            /**
+             * PERCENTAGE: integer 1-100. CASH: amount greater than 0 in discountCurrency.
+             */
+            discountValue: number;
+            /**
+             * ISO 4217; required for CASH.
+             */
+            discountCurrency?: string;
+            /**
+             * Code entered at checkout; omit for an automatic offer.
+             */
+            promoCode?: string;
+            minimumPurchaseType?: 'QUANTITY' | 'SUBTOTAL';
+            /**
+             * Required with minimumPurchaseType; QUANTITY is an integer >= 0, SUBTOTAL an amount > 0.
+             */
+            minimumPurchaseValue?: number;
+            /**
+             * ISO 4217; required for SUBTOTAL.
+             */
+            minimumPurchaseCurrency?: string;
+        }>;
         /**
          * TikTok-only on this endpoint. The pixel a Website Conversion ad group
          * optimizes toward, so a Spark Ad built from an existing organic post can