@koda-sl/baker-cli 0.107.0-dev.aaab11a02 → 0.108.0-dev.d66dc8b3d

package/README.md

@@ -1006,6 +1006,10 @@ baker ads linkedin conversions create --name "Demo booked" --type LEAD --method
 # Safe duplication — stage-time read of the source → staged DRAFT create ("Duplicate ad", never "Link to original")
 baker ads linkedin campaigns duplicate 123456 --name "New variant"
 
+# Change copy/media/URL on a LIVE ad — LinkedIn makes ad content immutable, so this is ONE command:
+# duplicate with overrides (unchanged fields carry over) + --replace pauses the original once the copy publishes
+baker ads linkedin creatives duplicate 1458413484 --headline "New headline" --description "New copy." --replace
+
 # Amend staged ops in place — `update <li_temp_ref>` merges into the staged create and re-validates
 baker ads linkedin creatives update li_temp_x3 --headline "Sharper headline" --image-id <bakerImageId>
 baker ads linkedin campaigns update li_temp_x2 --daily-budget 100 --currency EUR

package/dist/cli.js

@@ -1056,7 +1056,8 @@ var parentRefSchema = z3.union([
 ]);
 var moneySchema = z3.object({
   amount: z3.string().regex(/^\d+(\.\d{1,2})?$/, "expected a decimal amount like 50 or 50.00").refine((val) => Number(val) > 0, "amount must be greater than zero"),
-  currencyCode: z3.string().length(3)
+  /** LinkedIn ad accounts are single-currency — when omitted, staging fills it from the account. */
+  currencyCode: z3.string().length(3).optional()
 });
 var runScheduleSchema = z3.object({
   start: z3.number().int().positive(),
@@ -1125,7 +1126,7 @@ function validateCampaignBudgets(p, ctx, { requireBudget }) {
       message: "totalBudget-only campaigns need runSchedule.end"
     });
   }
-  if (p.dailyBudget) {
+  if (p.dailyBudget?.currencyCode) {
     const min = currencyMinimums(p.dailyBudget.currencyCode).dailyBudgetMin;
     if (Number(p.dailyBudget.amount) < min) {
       ctx.addIssue({
@@ -1135,7 +1136,7 @@ function validateCampaignBudgets(p, ctx, { requireBudget }) {
       });
     }
   }
-  if (p.unitCost) {
+  if (p.unitCost?.currencyCode) {
     const min = currencyMinimums(p.unitCost.currencyCode).unitCostMin;
     if (Number(p.unitCost.amount) < min) {
       ctx.addIssue({
@@ -5413,7 +5414,11 @@ registerSchema({
     start: { type: "string", description: "Run schedule start (ISO date or epoch ms)", required: true },
     end: { type: "string", description: "Run schedule end", required: false },
     "total-budget": { type: "string", description: "Lifetime budget amount", required: false },
-    currency: { type: "string", description: "3-letter currency code (required with money flags)", required: false },
+    currency: {
+      type: "string",
+      description: "3-letter currency code (defaults to the ad account currency)",
+      required: false
+    },
     status: { type: "string", description: "DRAFT|ACTIVE|PAUSED (default DRAFT)", required: false },
     file: { type: "string", description: "JSON payload file; flags override file keys", required: false }
   }
@@ -5432,7 +5437,11 @@ registerSchema({
     start: { type: "string", description: "New schedule start", required: false },
     end: { type: "string", description: "New schedule end", required: false },
     "total-budget": { type: "string", description: "New lifetime budget", required: false },
-    currency: { type: "string", description: "3-letter currency code", required: false },
+    currency: {
+      type: "string",
+      description: "3-letter currency code (defaults to the ad account currency)",
+      required: false
+    },
     status: { type: "string", description: "ACTIVE|PAUSED|ARCHIVED", required: false },
     file: { type: "string", description: "JSON file with fields to change", required: false }
   }
@@ -5450,7 +5459,11 @@ registerSchema({
     bid: { type: "string", description: "Manual bid amount (unitCost)", required: false },
     "daily-budget": { type: "string", description: "Daily budget amount", required: false },
     "total-budget": { type: "string", description: "Lifetime budget amount", required: false },
-    currency: { type: "string", description: "3-letter currency code (required with money flags)", required: false },
+    currency: {
+      type: "string",
+      description: "3-letter currency code (defaults to the ad account currency)",
+      required: false
+    },
     start: { type: "string", description: "Run schedule start", required: false },
     end: { type: "string", description: "Run schedule end", required: false },
     locale: { type: "string", description: "Profile locale like en_US (default en_US)", required: false },
@@ -5479,7 +5492,11 @@ registerSchema({
     bid: { type: "string", description: "New manual bid", required: false },
     "daily-budget": { type: "string", description: "New daily budget", required: false },
     "total-budget": { type: "string", description: "New lifetime budget", required: false },
-    currency: { type: "string", description: "3-letter currency code", required: false },
+    currency: {
+      type: "string",
+      description: "3-letter currency code (defaults to the ad account currency)",
+      required: false
+    },
     start: { type: "string", description: "New schedule start", required: false },
     end: { type: "string", description: "New schedule end", required: false },
     "targeting-file": { type: "string", description: "JSON file with replacement targetingCriteria", required: false },
@@ -5548,8 +5565,27 @@ registerSchema({
 });
 registerSchema({
   command: "ads.linkedin.creatives.duplicate",
-  description: "Stage a copy of an existing creative by re-sponsoring its underlying post into a new DRAFT creative (--file can override the target campaign).",
-  args: duplicateArgs
+  description: "Stage a copy of an existing ad, optionally with new content \u2014 the ONLY way to change copy/media/URL on a live ad (LinkedIn makes ad content immutable after creation). Direct-content ads (text/spotlight/follower/jobs) copy field-by-field; post-based ads re-sponsor the same post. --replace also stages pausing the original, gated on the new ad publishing successfully.",
+  args: {
+    id: { type: "positional", description: "Source creative id or URN", required: true },
+    ...writeAccountArgs,
+    campaign: { type: "string", description: "Stage the copy under a different ad set", required: false },
+    "intended-status": { type: "string", description: "Status for the copy (default DRAFT)", required: false },
+    replace: { type: "boolean", description: "Also pause the original once the new ad publishes", required: false },
+    headline: { type: "string", description: "New headline", required: false },
+    description: { type: "string", description: "New description (text/spotlight)", required: false },
+    intro: { type: "string", description: "New commentary / intro text", required: false },
+    "landing-url": { type: "string", description: "New https destination URL", required: false },
+    cta: { type: "string", description: "New CTA", required: false },
+    "cta-label": { type: "string", description: "Spotlight custom CTA label", required: false },
+    "image-id": { type: "string", description: "Baker image library id", required: false },
+    "image-urn": { type: "string", description: "Existing urn:li:image:*", required: false },
+    "video-id": { type: "string", description: "Baker video library id", required: false },
+    "video-urn": { type: "string", description: "Existing urn:li:video:*", required: false },
+    "logo-image-id": { type: "string", description: "Baker image id for the logo", required: false },
+    title: { type: "string", description: "Media title", required: false },
+    file: { type: "string", description: "JSON file with field overrides for the copy", required: false }
+  }
 });
 registerSchema({
   command: "ads.linkedin.creatives.create",
@@ -5581,13 +5617,13 @@ registerSchema({
 });
 registerSchema({
   command: "ads.linkedin.creatives.update",
-  description: "Stage changes to an existing creative (intendedStatus, name, headline, landing-url, cta), or AMEND a creative staged in this chat by passing its li_temp_* ref \u2014 amends accept the content flags from creatives.create (headline, intro, description, image-id, landing-url, cta, \u2026) and merge into the staged ad, re-validating the result. Use this to apply feedback to staged ads instead of remove + re-create. Applies on chat publish.",
+  description: "Stage changes to an existing creative (intendedStatus, name only \u2014 LinkedIn makes ad content immutable; to change copy/media/URL use creatives.duplicate with --replace), or AMEND a creative staged in this chat by passing its li_temp_* ref \u2014 amends accept the content flags from creatives.create (headline, intro, description, image-id, landing-url, cta, \u2026) and merge into the staged ad, re-validating the result. Use amends to apply feedback to staged ads instead of remove + re-create. Applies on chat publish.",
   args: {
     id: { type: "positional", description: "Creative id/URN, or li_temp_* ref staged in this chat", required: true },
     ...writeAccountArgs,
     "intended-status": { type: "string", description: "ACTIVE|PAUSED|ARCHIVED|DRAFT", required: false },
     name: { type: "string", description: "New creative name", required: false },
-    headline: { type: "string", description: "New headline", required: false },
+    headline: { type: "string", description: "Amend only: new headline", required: false },
     intro: { type: "string", description: "Amend only: commentary / intro text", required: false },
     description: { type: "string", description: "Amend only: description (text/spotlight)", required: false },
     "landing-url": { type: "string", description: "New https destination URL", required: false },
@@ -6606,8 +6642,11 @@ function parseMoneyFlag(amount, currency, flag) {
   if (amount === void 0 || amount === null || amount === "") {
     return void 0;
   }
+  if (currency === void 0 || currency === null || currency === "") {
+    return { amount: String(amount) };
+  }
   if (typeof currency !== "string" || currency.length !== 3) {
-    failWriteValidation(`${flag} needs --currency (3-letter code matching the ad account, e.g. EUR)`);
+    failWriteValidation(`${flag} got an invalid --currency (expected a 3-letter code like EUR)`);
   }
   return { amount: String(amount), currencyCode: currency.toUpperCase() };
 }
@@ -6787,7 +6826,7 @@ Example: baker ads linkedin campaign-groups create --name "Q3 ABM" --start 2026-
     start: { type: "string", description: "Run schedule start (ISO date or epoch ms)" },
     end: { type: "string", description: "Run schedule end" },
     "total-budget": { type: "string", description: "Lifetime budget amount" },
-    currency: { type: "string", description: "3-letter currency code (required with money flags)" },
+    currency: { type: "string", description: "3-letter currency code (defaults to the ad account currency)" },
     status: { type: "string", description: "DRAFT|ACTIVE|PAUSED (default DRAFT)" },
     file: { type: "string", description: "JSON file with the full payload; flags override file keys" }
   },
@@ -6816,7 +6855,7 @@ Example: baker ads linkedin campaign-groups update 635137195 --total-budget 8000
     start: { type: "string", description: "New run schedule start" },
     end: { type: "string", description: "New run schedule end" },
     "total-budget": { type: "string", description: "New lifetime budget" },
-    currency: { type: "string", description: "3-letter currency code" },
+    currency: { type: "string", description: "3-letter currency code (defaults to the ad account currency)" },
     status: { type: "string", description: "ACTIVE|PAUSED|ARCHIVED|\u2026" },
     file: { type: "string", description: "JSON file with fields to change" }
   },
@@ -6867,7 +6906,7 @@ var campaignFlagArgs = {
   bid: { type: "string", description: "Manual bid (unitCost) \u2014 playbook mandates manual bidding" },
   "daily-budget": { type: "string", description: "Daily budget amount" },
   "total-budget": { type: "string", description: "Lifetime budget amount" },
-  currency: { type: "string", description: "3-letter currency code (required with money flags)" },
+  currency: { type: "string", description: "3-letter currency code (defaults to the ad account currency)" },
   start: { type: "string", description: "Run schedule start (ISO date or epoch ms)" },
   end: { type: "string", description: "Run schedule end" },
   locale: { type: "string", description: "Profile locale like en_US" },
@@ -6989,7 +7028,63 @@ Example: baker ads linkedin ${cliGroup} duplicate 123456 --name "New variant"`
 }
 var campaignsDuplicateCommand = duplicateCommand("campaign", "campaigns");
 var campaignGroupsDuplicateCommand = duplicateCommand("campaignGroup", "campaign-groups");
-var creativesDuplicateCommand = duplicateCommand("creative", "creatives");
+var creativesDuplicateCommand = defineCommand36({
+  meta: {
+    name: "duplicate",
+    description: `Stage a copy of an existing ad, optionally with new content \u2014 the ONLY way to change copy/media/URL on a live ad (LinkedIn makes ad content immutable). ${STAGED_NOTE}
+--replace also pauses the original once the new ad publishes (skipped if the new ad fails).
+Examples:
+  baker ads linkedin creatives duplicate 1458413484 --headline "10x Demos, Same Team" --description "AI handles every demo request." --replace
+  baker ads linkedin creatives duplicate urn:li:sponsoredCreative:789 --campaign 799305464`
+  },
+  args: {
+    id: { type: "positional", description: "Source creative id or URN", required: true },
+    ...accountArgs,
+    campaign: { type: "string", description: "Stage the copy under a different ad set (id/URN or li_temp_*)" },
+    "intended-status": { type: "string", description: "Status for the copy (default DRAFT)" },
+    replace: { type: "boolean", description: "Also pause the original once the new ad publishes" },
+    intro: { type: "string", description: "New commentary / intro text" },
+    headline: { type: "string", description: "New headline" },
+    description: { type: "string", description: "New description (text/spotlight ads)" },
+    "landing-url": { type: "string", description: "New https destination URL" },
+    cta: { type: "string", description: "New CTA (LEARN_MORE|REQUEST_DEMO|\u2026)" },
+    "cta-label": { type: "string", description: "Spotlight custom CTA label" },
+    "image-id": { type: "string", description: "Baker image library id" },
+    "image-urn": { type: "string", description: "Existing urn:li:image:*" },
+    "video-id": { type: "string", description: "Baker video library id" },
+    "video-urn": { type: "string", description: "Existing urn:li:video:*" },
+    "logo-image-id": { type: "string", description: "Baker image id for the logo" },
+    title: { type: "string", description: "Media title" },
+    file: { type: "string", description: "JSON file with field overrides for the copy" }
+  },
+  run: async ({ args }) => {
+    try {
+      const chatId = requireChatId();
+      const file = loadJsonFileArg(args.file);
+      const fileContent = file.content !== null && typeof file.content === "object" && !Array.isArray(file.content) ? file.content : {};
+      const content = { ...fileContent, ...creativeContentPatch(args) };
+      const overrides = mergePayload(file, {
+        campaign: args.campaign,
+        intendedStatus: args["intended-status"] ? String(args["intended-status"]).toUpperCase() : void 0,
+        content: Object.keys(content).length > 0 ? content : void 0
+      });
+      const response = await apiPost(
+        "/api/ads/linkedin/draft/duplicate",
+        {
+          chatId,
+          accountId: bareAccountId(args),
+          entity: "creative",
+          sourceId: requireTarget(args, "creative"),
+          ...Object.keys(overrides).length > 0 ? { overrides } : {},
+          ...args.replace ? { replace: true } : {}
+        }
+      );
+      writeJsonEnvelope(response);
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
 var CREATIVE_FORMATS = [
   "image",
   "video",
@@ -7093,7 +7188,7 @@ var CREATIVE_AMEND_CONTENT_FLAGS = [
   ["thumbnail-urn", "thumbnailUrn"],
   ["title", "title"]
 ];
-var CREATIVE_LIVE_UPDATE_KEYS = /* @__PURE__ */ new Set(["headline", "landingUrl", "cta"]);
+var CREATIVE_LIVE_BLOCKED_FILE_KEYS = ["headline", "landingUrl", "cta", "content"];
 function creativeContentPatch(args) {
   const patch = {};
   for (const [flag, key] of CREATIVE_AMEND_CONTENT_FLAGS) {
@@ -7110,7 +7205,7 @@ var creativesUpdateCommand = defineCommand36({
   meta: {
     name: "update",
     description: `Stage changes to an existing creative, or amend a creative staged in this chat by passing its li_temp_* ref. ${STAGED_NOTE}
-Staged creatives (li_temp_*) accept the content flags from \`creatives create\` \u2014 fields merge into the staged ad and re-validate. Creatives already on LinkedIn only accept --intended-status/--name/--headline/--landing-url/--cta (content is immutable \u2014 use \`creatives duplicate\` for a new version).
+Staged creatives (li_temp_*) accept the content flags from \`creatives create\` \u2014 fields merge into the staged ad and re-validate. Creatives already on LinkedIn only accept --intended-status/--name (LinkedIn makes ad content immutable \u2014 to change copy/media/URL use \`creatives duplicate <id> --headline "\u2026" --replace\`).
 Examples:
   baker ads linkedin creatives update urn:li:sponsoredCreative:789 --intended-status PAUSED
   baker ads linkedin creatives update li_temp_a1b2 --headline "Sharper headline" --image-id <bakerImageId>`
@@ -7152,19 +7247,16 @@ Examples:
       await stageOp({ kind: "creative.update", accountId, target, payload: payload2 });
       return;
     }
-    const immutable = Object.keys(contentPatch).filter((key) => !CREATIVE_LIVE_UPDATE_KEYS.has(key));
-    if (immutable.length > 0) {
+    const blocked = [
+      ...Object.keys(contentPatch),
+      ...CREATIVE_LIVE_BLOCKED_FILE_KEYS.filter((key) => file[key] !== void 0)
+    ];
+    if (blocked.length > 0) {
       failWriteValidation(
-        `creative content is immutable on LinkedIn (${immutable.join(", ")}) \u2014 pass a li_temp_* ref to amend a creative staged in this chat, or use \`creatives duplicate\``
+        `LinkedIn can't change ad content once created (${[...new Set(blocked)].join(", ")}) \u2014 stage a replacement instead: \`baker ads linkedin creatives duplicate ${target} --headline "\u2026" --replace\` copies this ad with your changes and pauses the original when published. (li_temp_* refs staged in this chat stay fully editable.)`
       );
     }
-    const payload = mergePayload(file, {
-      intendedStatus,
-      name: args.name,
-      headline: contentPatch.headline,
-      landingUrl: contentPatch.landingUrl,
-      cta: contentPatch.cta
-    });
+    const payload = mergePayload(file, { intendedStatus, name: args.name });
     await stageOp({ kind: "creative.update", accountId, target, payload });
   }
 });