@adkit/cli 1.12.25 → 1.12.27

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,20 @@ 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>");
+  if (!hasCreativeFlag && !isSparkAd) return void 0;
   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 (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 +3024,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;
@@ -3183,6 +3191,12 @@ async function disconnectRedditAccount(client, args, flags) {
   return client.delete(`/manage/reddit/accounts/${adAccountId}`);
 }
 
+// src/commands/linkedin.ts
+async function listLinkedInAvailableAccounts(client, _args, flags) {
+  validateFlags(flags, [], "manage linkedin accounts available");
+  return client.get("/manage/linkedin/accounts/available");
+}
+
 // src/commands/status.ts
 function isStatusResponse(value) {
   if (!value || typeof value !== "object") return false;
@@ -4131,6 +4145,7 @@ Manage platforms:
   google        Google Ads
   tiktok        TikTok Ads
   reddit        Reddit Ads
+  linkedin      LinkedIn Ads
   drafts        Drafts across platforms
 
 Run \`adkit <command> --help\` for details.
@@ -4144,7 +4159,7 @@ var FLAG = {
   budgetDaily: "  --budget-daily <n>  Daily budget in account currency",
   cta: "  --cta <type>        sign_up, learn_more, shop_now, download, get_offer, contact_us, subscribe, get_quote, book_now, apply_now"
 };
-var RAW_PLATFORM_LABELS = { google: "Google", meta: "Meta", reddit: "Reddit", tiktok: "TikTok", x: "X" };
+var RAW_PLATFORM_LABELS = { google: "Google", meta: "Meta", reddit: "Reddit", tiktok: "TikTok", x: "X", linkedin: "LinkedIn" };
 function rawPlatformCommandLine(platform2) {
   return `Raw ${RAW_PLATFORM_LABELS[platform2] ?? platform2} API calls use the shared command: adkit manage platform-api-requests --platform ${platform2} ...`;
 }
@@ -5600,6 +5615,7 @@ ${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
   --cta <type>        learn_more, shop_now, sign_up, download, contact_us, apply_now, book_now
@@ -5608,6 +5624,7 @@ ${FLAG.data}
 
 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 --url https://example.com --cta learn_more
   adkit manage tiktok ads update 1770000000000000000 --status paused --publish`.trim(),
   "tiktok results": `adkit manage tiktok results \u2014 TikTok performance reporting
 
@@ -5663,7 +5680,7 @@ Examples:
 
 Flags:
   --data <json>             Full request object (preferred for agents)
-  --platform <meta|google|tiktok|reddit|x> Target platform (required)
+  --platform <meta|google|tiktok|reddit|x|linkedin> Target platform (required)
   --endpoint <path>          Relative API path (required)
   --payload <json>           JSON body for POST/PUT/PATCH, query params for GET, omit for DELETE
   --method <GET|POST|PUT|PATCH|DELETE>  HTTP method (default: POST)
@@ -5680,7 +5697,8 @@ Examples:
   adkit manage platform-api-requests --platform google --endpoint "customers/123/googleAds:mutate" --payload '{"mutateOperations":[...]}' --request-description "Pause ad" --account 123
   adkit manage platform-api-requests --platform tiktok --endpoint "campaign/get/" --method GET --payload '{"advertiser_id":"123"}' --request-description "List TikTok campaigns" --account 123
   adkit manage platform-api-requests --platform reddit --endpoint "ad_accounts/a2_example/campaigns" --payload '{"name":"Test","objective":"TRAFFIC","configured_status":"PAUSED"}' --request-description "Create paused Reddit campaign" --account a2_example
-  adkit manage platform-api-requests --platform x --endpoint "accounts/18ce54d4x5t/campaigns" --method GET --request-description "List X campaigns" --account 18ce54d4x5t`.trim(),
+  adkit manage platform-api-requests --platform x --endpoint "accounts/18ce54d4x5t/campaigns" --method GET --request-description "List X campaigns" --account 18ce54d4x5t
+  adkit manage platform-api-requests --platform linkedin --endpoint "adCampaignGroups/(account:urn:li:sponsoredAccount:512345678)" --method GET --request-description "List LinkedIn campaign groups" --account 512345678`.trim(),
   manage: `adkit manage \u2014 Ad platform management
 
 Platforms:
@@ -5689,6 +5707,7 @@ Platforms:
   tiktok              TikTok Ads
   reddit              Reddit Ads
   x                   X Ads raw API access
+  linkedin            LinkedIn Ads (account discovery + raw API access)
   drafts              Manage drafts across platforms
   platform-api-requests  Send raw API requests (escape hatch)
 
@@ -5781,6 +5800,19 @@ ${rawPlatformCommandLine("x")}
 
 Examples:
   adkit manage platform-api-requests --platform x --endpoint "accounts/18ce54d4x5t/campaigns" --method GET --request-description "List X campaigns" --account 18ce54d4x5t`.trim(),
+  linkedin: `adkit manage linkedin \u2014 LinkedIn Ads management
+
+Entity groups:
+  accounts available  List LinkedIn ad accounts discoverable from connected workspace logins
+
+Account discovery currently supports "available" only \u2014 connect/disconnect/list are not exposed yet.
+First-class LinkedIn campaign/ad reads and writes are not enabled yet.
+${rawPlatformCommandLine("linkedin")}
+
+General flags:
+${FLAG.account}
+
+Run adkit manage linkedin accounts available to discover ad accounts.`.trim(),
   drafts: `adkit manage drafts \u2014 Manage drafts
 
   list                List all drafts
@@ -6707,7 +6739,7 @@ function readRawRequestData(flags) {
   };
 }
 function readRawRequestFlags(flags) {
-  const platform2 = requireFlag(flags, "platform", "Required: --platform meta, google, tiktok, reddit, or x");
+  const platform2 = requireFlag(flags, "platform", "Required: --platform meta, google, tiktok, reddit, x, or linkedin");
   const method = readRawRequestMethod(flags.method);
   const rawPayload = readRawRequestFlagPayload(flags);
   const payload = readRawRequestPayload({ method, payload: rawPayload, source: "flag" });
@@ -6742,8 +6774,8 @@ function readRawRequestString(input) {
   throw new CliError("MISSING_FLAG", `Missing required field: \`${input.field}\``, input.hint);
 }
 function readRawRequestPlatform(value) {
-  if (value === "meta" || value === "google" || value === "tiktok" || value === "reddit" || value === "x") return value;
-  throw new CliError("INVALID_VALUE", `Invalid platform: ${String(value)}`, "Use meta, google, tiktok, reddit, or x");
+  if (value === "meta" || value === "google" || value === "tiktok" || value === "reddit" || value === "x" || value === "linkedin") return value;
+  throw new CliError("INVALID_VALUE", `Invalid platform: ${String(value)}`, "Use meta, google, tiktok, reddit, x, or linkedin");
 }
 function readRawRequestMethod(value) {
   const method = typeof value === "string" ? value.toUpperCase() : "POST";
@@ -6914,7 +6946,7 @@ async function main() {
         return;
       }
       const platform2 = manageTarget;
-      if (platform2 !== "meta" && platform2 !== "google" && platform2 !== "tiktok" && platform2 !== "reddit" && platform2 !== "x") throw new CliError("UNKNOWN_COMMAND", `Unknown platform: ${platform2}`, "Available: meta, google, tiktok, reddit, x, drafts, platform-api-requests");
+      if (platform2 !== "meta" && platform2 !== "google" && platform2 !== "tiktok" && platform2 !== "reddit" && platform2 !== "x" && platform2 !== "linkedin") throw new CliError("UNKNOWN_COMMAND", `Unknown platform: ${platform2}`, "Available: meta, google, tiktok, reddit, x, linkedin, drafts, platform-api-requests");
       const entity = args[2];
       const action = args[3];
       const restArgs = args.slice(4);
@@ -7541,8 +7573,23 @@ async function main() {
           default:
             throw new CliError("UNKNOWN_COMMAND", `Unknown entity: reddit ${entity}`, "Available: accounts, platform-api-requests");
         }
+      } else if (platform2 === "linkedin") {
+        switch (entity) {
+          case "accounts":
+            switch (action) {
+              case "available":
+                data = await listLinkedInAvailableAccounts(client, restArgs, flags);
+                emptyHint = "No LinkedIn ad accounts available from the connected workspace login.";
+                break;
+              default:
+                throw new CliError("UNKNOWN_COMMAND", `Unknown action: linkedin accounts ${action}`, "Available: available.");
+            }
+            break;
+          default:
+            throw new CliError("UNKNOWN_COMMAND", `Unknown entity: linkedin ${entity}`, "Available: accounts, platform-api-requests");
+        }
       } else if (platform2 === "x") throw new CliError("UNKNOWN_COMMAND", `Unknown entity: x ${entity}`, "Available: platform-api-requests");
-      else throw new CliError("UNKNOWN_COMMAND", "Unknown platform", "Available: meta, google, tiktok, reddit, x, drafts, platform-api-requests");
+      else throw new CliError("UNKNOWN_COMMAND", "Unknown platform", "Available: meta, google, tiktok, reddit, x, linkedin, drafts, platform-api-requests");
       printResult(data, flags, emptyHint, detailEntity);
       return;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adkit/cli",
-  "version": "1.12.25",
+  "version": "1.12.27",
   "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",