@koda-sl/baker-cli 0.108.0-dev.d66dc8b3d → 0.109.0-dev.2acd65459

package/README.md

@@ -1006,9 +1006,13 @@ 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
+# 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>

package/dist/cli.js

@@ -1226,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"),
@@ -5565,7 +5568,7 @@ registerSchema({
 });
 registerSchema({
   command: "ads.linkedin.creatives.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 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.",
+  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,
@@ -5617,27 +5620,27 @@ registerSchema({
 });
 registerSchema({
   command: "ads.linkedin.creatives.update",
-  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.",
+  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: "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 },
+    headline: { type: "string", description: "New headline", 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 }
   }
 });
@@ -7041,8 +7044,14 @@ Examples:
     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" },
+    "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)" },
@@ -7188,7 +7197,6 @@ var CREATIVE_AMEND_CONTENT_FLAGS = [
   ["thumbnail-urn", "thumbnailUrn"],
   ["title", "title"]
 ];
-var CREATIVE_LIVE_BLOCKED_FILE_KEYS = ["headline", "landingUrl", "cta", "content"];
 function creativeContentPatch(args) {
   const patch = {};
   for (const [flag, key] of CREATIVE_AMEND_CONTENT_FLAGS) {
@@ -7205,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 (LinkedIn makes ad content immutable \u2014 to change copy/media/URL use \`creatives duplicate <id> --headline "\u2026" --replace\`).
+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 }) => {
@@ -7237,26 +7245,13 @@ 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 blocked = [
-      ...Object.keys(contentPatch),
-      ...CREATIVE_LIVE_BLOCKED_FILE_KEYS.filter((key) => file[key] !== void 0)
-    ];
-    if (blocked.length > 0) {
-      failWriteValidation(
-        `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 });
+    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,
+      content: Object.keys(content).length > 0 ? content : void 0
+    });
     await stageOp({ kind: "creative.update", accountId, target, payload });
   }
 });