@koda-sl/baker-cli 0.106.0-dev.a605c0acb → 0.107.0-dev.aaab11a02

package/README.md

@@ -1006,6 +1006,11 @@ 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"
 
+# 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
+# A second update to the same real URN also merges into the already-staged update op.
+
 # Review / undo before publish; after publish shows per-op results (applied/simulated/failed/skipped)
 baker ads linkedin draft
 baker ads linkedin draft remove li_temp_x2   # removing a create cascades to dependents

package/dist/cli.js

@@ -1042,6 +1042,7 @@ var IMAGE_URN_REGEX = /^urn:li:image:.+$/;
 var VIDEO_URN_REGEX = /^urn:li:video:.+$/;
 var DOCUMENT_URN_REGEX = /^urn:li:document:.+$/;
 var POST_URN_REGEX = /^urn:li:(share|ugcPost):\d+$/;
+var EVENT_URN_REGEX = /^urn:li:event:\d+$/;
 var ORGANIZATION_URN_REGEX = /^urn:li:organization:\d+$/;
 var TARGETING_FACET_URN_REGEX = /^urn:li:adTargetingFacet:[a-zA-Z]+$/;
 
@@ -1117,7 +1118,7 @@ function validateCampaignBudgets(p, ctx, { requireBudget }) {
   if (requireBudget && !p.dailyBudget && !p.totalBudget) {
     ctx.addIssue({ code: "custom", path: ["dailyBudget"], message: "set dailyBudget and/or totalBudget" });
   }
-  if (p.totalBudget && !p.dailyBudget && !p.runSchedule?.end) {
+  if (requireBudget && p.totalBudget && !p.dailyBudget && !p.runSchedule?.end) {
     ctx.addIssue({
       code: "custom",
       path: ["runSchedule", "end"],
@@ -1212,6 +1213,9 @@ var textCreativeSchema = z3.object({
   landingUrl: httpsUrlSchema,
   imageId: bakerMediaIdSchema.optional(),
   imageUrn: z3.string().regex(IMAGE_URN_REGEX).optional()
+}).refine((p) => p.imageId ? !p.imageUrn : Boolean(p.imageUrn), {
+  message: "text ads require a 100\xD7100 image \u2014 provide exactly one of imageId (Baker library) or imageUrn (already on LinkedIn)",
+  path: ["imageId"]
 });
 var spotlightCreativeSchema = z3.object({
   format: z3.literal("spotlight"),
@@ -1272,6 +1276,23 @@ var jobsCreativeSchema = z3.object({
   headlinePreset: z3.string().min(1),
   buttonLabelPreset: z3.string().min(1)
 });
+var eventCreativeSchema = z3.object({
+  format: z3.literal("event"),
+  commentary: commentarySchema,
+  eventUrn: z3.string().regex(EVENT_URN_REGEX, "expected urn:li:event:*")
+});
+var articleCreativeSchema = z3.object({
+  format: z3.literal("article"),
+  commentary: commentarySchema,
+  source: httpsUrlSchema,
+  title: z3.string().min(1).max(200),
+  description: z3.string().max(300).optional(),
+  thumbnailImageId: bakerMediaIdSchema.optional(),
+  thumbnailUrn: z3.string().regex(IMAGE_URN_REGEX).optional()
+}).refine((p) => !(p.thumbnailImageId && p.thumbnailUrn), {
+  message: "provide at most one of thumbnailImageId (Baker library) or thumbnailUrn (already on LinkedIn)",
+  path: ["thumbnailImageId"]
+});
 var creativeContentSchema = z3.discriminatedUnion("format", [
   imageCreativeSchema,
   videoCreativeSchema,
@@ -1282,7 +1303,9 @@ var creativeContentSchema = z3.discriminatedUnion("format", [
   carouselCreativeSchema,
   conversationCreativeSchema,
   tlaCreativeSchema,
-  jobsCreativeSchema
+  jobsCreativeSchema,
+  eventCreativeSchema,
+  articleCreativeSchema
 ]);
 var creativeCreateSchema = z3.object({
   campaign: parentRefSchema,
@@ -1294,7 +1317,14 @@ var creativeUpdateSchema = z3.object({
   name: z3.string().max(255).optional(),
   headline: headlineSchema.optional(),
   landingUrl: httpsUrlSchema.optional(),
-  cta: z3.enum(CTA_TYPES).optional()
+  cta: z3.enum(CTA_TYPES).optional(),
+  /**
+   * Amend-only content patch: valid when the target is a li_temp_* staged
+   * create — merged into the staged content and re-validated against the
+   * full creative schema. Creatives already on LinkedIn have immutable
+   * content; the backend rejects it for real targets.
+   */
+  content: z3.record(z3.string(), z3.unknown()).optional()
 }).refine((p) => Object.values(p).some((val) => val !== void 0), "update needs at least one field");
 var listRowSchema = z3.record(z3.string(), z3.string());
 var audienceCreateSchema = z3.object({
@@ -1391,7 +1421,7 @@ var LINKEDIN_DRAFT_OP_KINDS = [
 ];
 var linkedinDraftOpKindSchema = z3.enum(LINKEDIN_DRAFT_OP_KINDS);
 var accountIdSchema = z3.string().regex(NUMERIC_ID_REGEX, "accountId must be the bare numeric ad account id");
-var updateTargetSchema = z3.union([z3.string().regex(URN_REGEX), z3.string().regex(NUMERIC_ID_REGEX)]);
+var updateTargetSchema = z3.union([z3.string().regex(URN_REGEX), z3.string().regex(NUMERIC_ID_REGEX), tempRefSchema]);
 function createOp(kind, payload) {
   return z3.object({ kind: z3.literal(kind), accountId: accountIdSchema, payload });
 }
@@ -1434,7 +1464,9 @@ var linkedinDraftStageResponseSchema = z4.object({
   mode: linkedinWriteModeSchema,
   dependsOn: z4.array(z4.string()),
   summary: z4.string(),
-  warnings: z4.array(z4.string())
+  warnings: z4.array(z4.string()),
+  /** True when the op amended an already-staged op in place instead of appending a new one. */
+  amended: z4.boolean().optional()
 });
 var linkedinDraftOpViewSchema = z4.object({
   ref: z4.string(),
@@ -5388,9 +5420,13 @@ registerSchema({
 });
 registerSchema({
   command: "ads.linkedin.campaign-groups.update",
-  description: "Stage changes to an existing campaign group (name, schedule, budget, status). Captures a before-snapshot for the dashboard diff. Applies on chat publish.",
+  description: "Stage changes to an existing campaign group (name, schedule, budget, status). Captures a before-snapshot for the dashboard diff. Pass a li_temp_* ref to AMEND a group staged in this chat. Applies on chat publish.",
   args: {
-    id: { type: "positional", description: "Campaign group id or URN", required: true },
+    id: {
+      type: "positional",
+      description: "Campaign group id/URN, or li_temp_* ref staged in this chat",
+      required: true
+    },
     ...writeAccountArgs,
     name: { type: "string", description: "New name", required: false },
     start: { type: "string", description: "New schedule start", required: false },
@@ -5434,9 +5470,9 @@ registerSchema({
 });
 registerSchema({
   command: "ads.linkedin.campaigns.update",
-  description: "Stage changes to an existing campaign \u2014 budget, bid, targeting, schedule, flags, status. Only pass what changes; a before-snapshot powers the dashboard diff. Applies on chat publish.",
+  description: "Stage changes to an existing campaign \u2014 budget, bid, targeting, schedule, flags, status. Only pass what changes; a before-snapshot powers the dashboard diff. Pass a li_temp_* ref to AMEND a campaign staged in this chat (fields merge into the staged create). Applies on chat publish.",
   args: {
-    id: { type: "positional", description: "Campaign id or URN", required: true },
+    id: { type: "positional", description: "Campaign id/URN, or li_temp_* ref staged in this chat", required: true },
     ...writeAccountArgs,
     name: { type: "string", description: "New name", required: false },
     objective: { type: "string", description: "New objective", required: false },
@@ -5517,13 +5553,13 @@ registerSchema({
 });
 registerSchema({
   command: "ads.linkedin.creatives.create",
-  description: "Stage a new creative (ad). Formats: image|video|text|spotlight|follower|document|carousel|conversation|tla|jobs. Media: --image-id/--video-id reference the Baker library (`baker images`/`baker videos`) and upload to LinkedIn at publish; --image-urn/--video-urn reference media already on LinkedIn. Limits: headline \u226470 (text ads \u226425), intro soft-truncates at 600 chars, landing URL must be https. Complex formats take --file with the full content object. Staged until publish.",
+  description: "Stage a new creative (ad). Formats: image|video|text|spotlight|follower|document|carousel|conversation|tla|jobs|event|article. Media: --image-id/--video-id reference the Baker library (`baker images`/`baker videos`) and upload to LinkedIn at publish; --image-urn/--video-urn reference media already on LinkedIn. Limits: headline \u226470 (text ads \u226425), intro soft-truncates at 600 chars, landing URL must be https. Complex formats take --file with the full content object. Staged until publish.",
   args: {
     ...writeAccountArgs,
     campaign: { type: "string", description: "Campaign id/URN or li_temp_* ref", required: true },
     format: {
       type: "string",
-      description: "image|video|text|spotlight|follower|document|carousel|conversation|tla|jobs",
+      description: "image|video|text|spotlight|follower|document|carousel|conversation|tla|jobs|event|article",
       required: true
     },
     "image-id": { type: "string", description: "Baker image library id", required: false },
@@ -5545,13 +5581,28 @@ registerSchema({
 });
 registerSchema({
   command: "ads.linkedin.creatives.update",
-  description: "Stage changes to an existing creative (intendedStatus, name). Applies on chat publish.",
+  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.",
   args: {
-    id: { type: "positional", description: "Creative id or URN", required: true },
+    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 },
-    file: { type: "string", description: "JSON file with fields to change", 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 },
+    "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 },
+    "thumbnail-image-id": {
+      type: "string",
+      description: "Amend only: Baker image id for the article thumbnail",
+      required: false
+    },
+    title: { type: "string", description: "Amend only: media or article title", required: false },
+    file: { type: "string", description: "JSON file with fields to change; flags override file keys", required: false }
   }
 });
 registerSchema({
@@ -6755,6 +6806,7 @@ var campaignGroupsUpdateCommand = defineCommand36({
   meta: {
     name: "update",
     description: `Stage changes to an existing campaign group. ${STAGED_NOTE}
+Pass a li_temp_* ref to amend a group staged in this chat \u2014 fields merge into the staged create.
 Example: baker ads linkedin campaign-groups update 635137195 --total-budget 8000 --currency EUR`
   },
   args: {
@@ -6849,6 +6901,7 @@ var campaignsUpdateCommand = defineCommand36({
   meta: {
     name: "update",
     description: `Stage changes to an existing campaign (budget, bid, targeting, flags, schedule, status). ${STAGED_NOTE}
+Pass a li_temp_* ref to amend a campaign staged in this chat \u2014 fields merge into the staged create.
 Example: baker ads linkedin campaigns update 123456 --daily-budget 100 --currency EUR --audience-expansion off`
   },
   args: {
@@ -6947,7 +7000,9 @@ var CREATIVE_FORMATS = [
   "carousel",
   "conversation",
   "tla",
-  "jobs"
+  "jobs",
+  "event",
+  "article"
 ];
 var creativesCreateCommand = defineCommand36({
   meta: {
@@ -6974,8 +7029,12 @@ Examples:
     cta: { type: "string", description: "LEARN_MORE|REQUEST_DEMO|SIGN_UP|REGISTER|DOWNLOAD|\u2026" },
     "cta-label": { type: "string", description: "Spotlight custom CTA label (\u226418 chars)" },
     "post-urn": { type: "string", description: "TLA: existing post to sponsor (urn:li:share|ugcPost:*)" },
+    "event-urn": { type: "string", description: "Event ads: the LinkedIn event to sponsor (urn:li:event:*)" },
+    "article-url": { type: "string", description: "Article ads: https URL of the article/newsletter to sponsor" },
+    "thumbnail-image-id": { type: "string", description: "Article ads: Baker image id for the link thumbnail" },
+    "thumbnail-urn": { type: "string", description: "Article ads: existing urn:li:image:* thumbnail" },
     "intended-status": { type: "string", description: "DRAFT|ACTIVE|PAUSED (default DRAFT)" },
-    title: { type: "string", description: "Media title" },
+    title: { type: "string", description: "Media title (image/video) or article title" },
     file: { type: "string", description: "JSON file with the full content object; flags override" }
   },
   run: async ({ args }) => {
@@ -7001,7 +7060,12 @@ Examples:
       cta: args.cta ? String(args.cta).toUpperCase() : void 0,
       ctaLabel: args["cta-label"],
       postUrn: args["post-urn"],
-      mediaTitle: args.title
+      eventUrn: args["event-urn"],
+      source: args["article-url"],
+      thumbnailImageId: args["thumbnail-image-id"],
+      thumbnailUrn: args["thumbnail-urn"],
+      mediaTitle: args.title,
+      title: args.title
     });
     await stageOp({
       kind: "creative.create",
@@ -7014,31 +7078,94 @@ Examples:
     });
   }
 });
+var CREATIVE_AMEND_CONTENT_FLAGS = [
+  ["intro", "commentary"],
+  ["headline", "headline"],
+  ["description", "description"],
+  ["landing-url", "landingUrl"],
+  ["cta-label", "ctaLabel"],
+  ["image-id", "imageId"],
+  ["image-urn", "imageUrn"],
+  ["video-id", "videoId"],
+  ["video-urn", "videoUrn"],
+  ["logo-image-id", "logoImageId"],
+  ["thumbnail-image-id", "thumbnailImageId"],
+  ["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) {
+    if (args[flag] !== void 0) {
+      patch[key] = args[flag];
+    }
+  }
+  if (args.cta !== void 0) {
+    patch.cta = String(args.cta).toUpperCase();
+  }
+  return patch;
+}
 var creativesUpdateCommand = defineCommand36({
   meta: {
     name: "update",
-    description: `Stage changes to an existing creative. ${STAGED_NOTE}
-Example: baker ads linkedin creatives update urn:li:sponsoredCreative:789 --intended-status PAUSED`
+    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).
+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>`
   },
   args: {
-    id: { type: "positional", description: "Creative id or URN", required: true },
+    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" },
-    file: { type: "string", description: "JSON file with fields to change" }
+    intro: { type: "string", description: "Amend only: commentary / intro text" },
+    headline: { type: "string", description: "New headline" },
+    description: { type: "string", description: "Amend only: 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" },
+    file: { type: "string", description: "JSON file with fields to change; flags override file keys" }
   },
   run: async ({ args }) => {
     const accountId = bareAccountId(args);
-    const payload = mergePayload(loadJsonFileArg(args.file), {
-      intendedStatus: args["intended-status"] ? String(args["intended-status"]).toUpperCase() : void 0,
-      name: args.name
-    });
-    await stageOp({
-      kind: "creative.update",
-      accountId,
-      target: requireTarget(args, "creative"),
-      payload
+    const target = requireTarget(args, "creative");
+    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 payload = mergePayload(file, {
+      intendedStatus,
+      name: args.name,
+      headline: contentPatch.headline,
+      landingUrl: contentPatch.landingUrl,
+      cta: contentPatch.cta
     });
+    await stageOp({ kind: "creative.update", accountId, target, payload });
   }
 });
 var AUDIENCE_TYPES2 = ["company-list", "user-list", "retargeting", "engagement"];