@adkit/cli 1.12.26 → 1.12.28

package/dist/cli.js

@@ -2827,7 +2827,7 @@ var AD_GROUP_LIST_FLAGS2 = ["campaign-ids", "fields", "limit", "offset"];
 var AD_GROUP_CREATE_FLAGS = ["campaign", "name", "status", "budget-daily", "budget-lifetime", "billing-event", "bid-strategy", "optimization", "start-date", "end-date", "pacing", "bid-amount", "event-type", "pixel", "placement", PLATFORM_OVERRIDE_FLAG];
 var AD_GROUP_UPDATE_FLAGS = ["name", "status", "budget-daily", "budget-lifetime", "billing-event", "optimization", "start-date", "end-date", "pacing", "bid-amount", "event-type", "pixel", PLATFORM_OVERRIDE_FLAG];
 var AD_LIST_FLAGS2 = ["ad-group-ids", "campaign-ids", "fields", "limit", "offset"];
-var AD_CREATE_FLAGS = ["ad-group", "name", "status", "media-id", "ad-text", "url", "cta", "display-name", "identity-id", "identity-type", "tracking-pixel", PLATFORM_OVERRIDE_FLAG];
+var AD_CREATE_FLAGS = ["ad-group", "name", "status", "media-id", "existing-post-id", "ad-text", "url", "cta", "display-name", "identity-id", "identity-type", "tracking-pixel", PLATFORM_OVERRIDE_FLAG];
 var AD_UPDATE_FLAGS = ["ad-group", "name", "status", "media-id", "ad-text", "url", "cta", "display-name", "identity-id", "identity-type", "tracking-pixel", PLATFORM_OVERRIDE_FLAG];
 var RESULTS_FLAGS = ["level", "fields", "breakdowns", "from", "to", "sort", "sort-direction", "limit", "offset"];
 function readSingleFlagValue2(flags, key, duplicateHint) {
@@ -2941,7 +2941,8 @@ function buildTikTokBudget(flags) {
 function readTikTokPlacementFlag(flags) {
   const value = readSingleFlagValue2(flags, "placement", "Use comma-separated TikTok placement IDs, or switch to --data for full targeting");
   if (value === void 0) return void 0;
-  const placements = value.split(",").map((entry) => entry.trim()).filter(Boolean);
+  const rawParts = value.split(",");
+  const placements = rawParts.map((entry) => entry.trim()).filter(Boolean);
   if (placements.length === 0) throw new CliError("INVALID_VALUE", "--placement must contain at least one placement ID", "Example: --placement PLACEMENT_TIKTOK");
   return placements;
 }
@@ -2994,14 +2995,23 @@ function buildTikTokAdGroupPayload(flags, mode) {
   return payload;
 }
 function buildTikTokAdCreative(flags) {
+  const isSparkAd = typeof flags["existing-post-id"] === "string";
+  if (isSparkAd && flags["media-id"] !== void 0) throw new CliError("INVALID_VALUE", "Use --existing-post-id or --media-id, not both", "Spark Ads promote an existing post; drop --media-id, or drop --existing-post-id to upload a video");
   const hasCreativeFlag = ["media-id", "ad-text", "url", "cta", "display-name", "identity-id", "identity-type", "tracking-pixel"].some((key) => flags[key] !== void 0);
-  if (!hasCreativeFlag) return void 0;
-  const mediaId = requireFlag(flags, "media-id", "Run: adkit manage tiktok ads create --media-id <uploaded-video-id>");
-  const creative = {
-    adText: requireFlag(flags, "ad-text", "Provide the TikTok ad text"),
-    media: [{ id: mediaId, role: "video" }],
-    url: requireFlag(flags, "url", "Provide the destination URL for the ad")
-  };
+  if (!hasCreativeFlag && !isSparkAd) return void 0;
+  const creative = {};
+  if (isSparkAd) {
+    if (typeof flags.url === "string" && flags.url.trim()) creative.url = flags.url.trim();
+  } else {
+    creative.url = requireFlag(flags, "url", "Provide the destination URL for the ad");
+  }
+  if (isSparkAd) {
+    if (typeof flags["ad-text"] === "string") creative.adText = flags["ad-text"];
+  } else {
+    const mediaId = requireFlag(flags, "media-id", "Run: adkit manage tiktok ads create --media-id <uploaded-video-id>");
+    creative.adText = requireFlag(flags, "ad-text", "Provide the TikTok ad text");
+    creative.media = [{ id: mediaId, role: "video" }];
+  }
   if (typeof flags.cta === "string") creative.cta = flags.cta;
   if (typeof flags["display-name"] === "string") creative.displayName = flags["display-name"];
   if (typeof flags["identity-id"] === "string") creative.identityId = flags["identity-id"];
@@ -3017,6 +3027,7 @@ function buildTikTokAdPayload(flags, mode) {
   if (typeof flags.name === "string") payload.name = flags.name;
   if (typeof flags.status === "string") payload.status = flags.status;
   payload.adType = "video";
+  if (typeof flags["existing-post-id"] === "string") payload.existingPostId = flags["existing-post-id"];
   const creative = buildTikTokAdCreative(flags);
   if (creative) payload.creative = creative;
   if (platformOverrides) payload.platformOverrides = platformOverrides;
@@ -5607,14 +5618,16 @@ ${FLAG.data}
   --name <name>       Ad name
   --status <s>        active, paused
   --media-id <id>     TikTok video ID from tiktok media upload
+  --existing-post-id <id> Spark Ad: promote an existing organic post instead of an uploaded video (needs a BC_AUTH_TT identity)
   --ad-text <text>    Ad text
-  --url <url>         Destination URL
+  --url <url>         Destination URL (required with --media-id; optional with --existing-post-id)
   --cta <type>        learn_more, shop_now, sign_up, download, contact_us, apply_now, book_now
   --identity-id <id>  TikTok profile/identity ID (falls back to account default)
   --identity-type <t> TikTok identity type
 
 Examples:
   adkit manage tiktok ads create --ad-group 1770 --name "Hero video" --media-id v123 --ad-text "Try it today" --url https://example.com --cta learn_more
+  adkit manage tiktok ads create --ad-group 1770 --name "Spark Ad" --existing-post-id 7412
   adkit manage tiktok ads update 1770000000000000000 --status paused --publish`.trim(),
   "tiktok results": `adkit manage tiktok results \u2014 TikTok performance reporting
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adkit/cli",
-  "version": "1.12.26",
+  "version": "1.12.28",
   "description": "The Ads CLI for AI agents — manage Meta & Google ad campaigns, browse the ad library, and generate creatives from your terminal.",
   "keywords": [
     "ads cli",