@koda-sl/baker-cli 0.107.0-dev.aaab11a02 → 0.109.0-dev.2acd65459

package/README.md

@@ -1006,6 +1006,14 @@ 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 — direct-content ads (text/spotlight/follower/jobs) update IN PLACE;
+# pass only the changed fields, the rest of the ad's current content carries over
+baker ads linkedin creatives update 1458423674 --headline "New headline" --description "New copy."
+
+# Post-based ads (image/video/carousel/…) sponsor a post whose content can't be edited — replace in ONE command:
+# duplicate with overrides (unchanged fields + status carry over) + --replace pauses the original once the copy publishes
+baker ads linkedin creatives duplicate 1458413484 --headline "New headline" --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({
@@ -1225,14 +1226,17 @@ var spotlightCreativeSchema = z3.object({
   ctaLabel: z3.string().min(1).max(LINKEDIN_LIMITS.creative.spotlightCtaMax),
   logoImageId: bakerMediaIdSchema.optional(),
   logoUrn: z3.string().regex(IMAGE_URN_REGEX).optional(),
-  showMemberProfilePhoto: z3.boolean().default(true)
+  showMemberProfilePhoto: z3.boolean().default(true),
+  /** Carried from the live snapshot on updates so LinkedIn's whole-content $set preserves it. */
+  organizationName: z3.string().min(1).max(200).optional()
 });
 var followerCreativeSchema = z3.object({
   format: z3.literal("follower"),
   headline: z3.string().max(LINKEDIN_LIMITS.creative.spotlightHeadlineMax).optional(),
   description: z3.string().max(LINKEDIN_LIMITS.creative.spotlightDescriptionMax).optional(),
   logoImageId: bakerMediaIdSchema.optional(),
-  logoUrn: z3.string().regex(IMAGE_URN_REGEX).optional()
+  logoUrn: z3.string().regex(IMAGE_URN_REGEX).optional(),
+  organizationName: z3.string().min(1).max(200).optional()
 });
 var documentCreativeSchema = z3.object({
   format: z3.literal("document"),
@@ -5413,7 +5417,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 +5440,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 +5462,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 +5495,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 +5568,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. Direct-content ads (text/spotlight/follower/jobs) copy field-by-field; post-based ads re-sponsor the same post \u2014 and since post content can't be edited, duplicate --replace is how post-based ads change copy (direct-content ads update in place via creatives.update instead). --replace stages pausing the original, gated on the new ad publishing successfully, and the copy inherits the source's status.",
+  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,27 +5620,27 @@ 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. Direct-content ads (text/spotlight/follower/jobs) update copy/media/URL IN PLACE \u2014 pass only the changed fields (headline, description, landing-url, image-id, \u2026); the ad's current content carries over. Post-based ads (image/video/carousel/\u2026) can't edit content \u2014 use creatives.duplicate with --replace for those. Passing a li_temp_* ref AMENDS the creative staged in this chat instead. 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 },
-    intro: { type: "string", description: "Amend only: commentary / intro text", required: false },
-    description: { type: "string", description: "Amend only: description (text/spotlight)", required: false },
+    intro: { type: "string", description: "Commentary / intro text", required: false },
+    description: { type: "string", description: "Description (text/spotlight)", required: false },
     "landing-url": { type: "string", description: "New https destination URL", required: false },
     cta: { type: "string", description: "New CTA", required: false },
-    "image-id": { type: "string", description: "Amend only: Baker image library id", required: false },
-    "image-urn": { type: "string", description: "Amend only: existing urn:li:image:*", required: false },
-    "video-id": { type: "string", description: "Amend only: Baker video library id", required: false },
-    "logo-image-id": { type: "string", description: "Amend only: Baker image id for the logo", 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 },
+    "logo-image-id": { type: "string", description: "Baker image id for the logo", required: false },
     "thumbnail-image-id": {
       type: "string",
-      description: "Amend only: Baker image id for the article thumbnail",
+      description: "Baker image id for the article thumbnail",
       required: false
     },
-    title: { type: "string", description: "Amend only: media or article title", required: false },
+    title: { type: "string", description: "Media or article title", required: false },
     file: { type: "string", description: "JSON file with fields to change; flags override file keys", required: false }
   }
 });
@@ -6606,8 +6645,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 +6829,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 +6858,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 +6909,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 +7031,69 @@ 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; with --replace, the source's status)"
+    },
+    replace: {
+      type: "boolean",
+      description: "Also pause the original once the new ad publishes; the copy inherits the source's status"
+    },
+    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 +7197,6 @@ var CREATIVE_AMEND_CONTENT_FLAGS = [
   ["thumbnail-urn", "thumbnailUrn"],
   ["title", "title"]
 ];
-var CREATIVE_LIVE_UPDATE_KEYS = /* @__PURE__ */ new Set(["headline", "landingUrl", "cta"]);
 function creativeContentPatch(args) {
   const patch = {};
   for (const [flag, key] of CREATIVE_AMEND_CONTENT_FLAGS) {
@@ -7110,30 +7213,30 @@ 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).
+Direct-content ads (text/spotlight/follower/jobs) update copy/media/URL IN PLACE \u2014 changed fields merge into the ad's current content. Post-based ads (image/video/carousel/\u2026) can't edit content; use \`creatives duplicate <id> --headline "\u2026" --replace\` for those. Staged creatives (li_temp_*) accept all content flags and re-validate.
 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>`
+  baker ads linkedin creatives update 1458423674 --headline "Sharper headline" --description "New copy."
+  baker ads linkedin creatives update urn:li:sponsoredCreative:789 --intended-status PAUSED`
   },
   args: {
     id: { type: "positional", description: "Creative id/URN, or li_temp_* ref staged in this chat", required: true },
     ...accountArgs,
     "intended-status": { type: "string", description: "ACTIVE|PAUSED|ARCHIVED|DRAFT" },
     name: { type: "string", description: "New creative name" },
-    intro: { type: "string", description: "Amend only: commentary / intro text" },
+    intro: { type: "string", description: "Commentary / intro text" },
     headline: { type: "string", description: "New headline" },
-    description: { type: "string", description: "Amend only: description (text/spotlight ads)" },
+    description: { type: "string", description: "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: "Amend only: spotlight custom CTA label" },
-    "image-id": { type: "string", description: "Amend only: Baker image library id" },
-    "image-urn": { type: "string", description: "Amend only: existing urn:li:image:*" },
-    "video-id": { type: "string", description: "Amend only: Baker video library id" },
-    "video-urn": { type: "string", description: "Amend only: existing urn:li:video:*" },
-    "logo-image-id": { type: "string", description: "Amend only: Baker image id for the logo" },
-    "thumbnail-image-id": { type: "string", description: "Amend only: Baker image id for the article thumbnail" },
-    "thumbnail-urn": { type: "string", description: "Amend only: existing urn:li:image:* thumbnail" },
-    title: { type: "string", description: "Amend only: media or article title" },
+    "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" },
+    "thumbnail-image-id": { type: "string", description: "Baker image id for the article thumbnail" },
+    "thumbnail-urn": { type: "string", description: "Existing urn:li:image:* thumbnail" },
+    title: { type: "string", description: "Media or article title" },
     file: { type: "string", description: "JSON file with fields to change; flags override file keys" }
   },
   run: async ({ args }) => {
@@ -7142,28 +7245,12 @@ Examples:
     const file = loadJsonFileArg(args.file);
     const contentPatch = creativeContentPatch(args);
     const intendedStatus = args["intended-status"] ? String(args["intended-status"]).toUpperCase() : void 0;
-    if (target.startsWith("li_temp_")) {
-      const fileContent = file.content !== null && typeof file.content === "object" && !Array.isArray(file.content) ? file.content : {};
-      const content = { ...fileContent, ...contentPatch };
-      const payload2 = mergePayload(file, {
-        intendedStatus,
-        content: Object.keys(content).length > 0 ? content : void 0
-      });
-      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) {
-      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\``
-      );
-    }
+    const fileContent = file.content !== null && typeof file.content === "object" && !Array.isArray(file.content) ? file.content : {};
+    const content = { ...fileContent, ...contentPatch };
     const payload = mergePayload(file, {
       intendedStatus,
       name: args.name,
-      headline: contentPatch.headline,
-      landingUrl: contentPatch.landingUrl,
-      cta: contentPatch.cta
+      content: Object.keys(content).length > 0 ? content : void 0
     });
     await stageOp({ kind: "creative.update", accountId, target, payload });
   }