@koda-sl/baker-cli 0.109.0-dev.2acd65459 → 0.110.1-dev.02d8aed71

package/README.md

@@ -236,7 +236,7 @@ The CLI rejects or automatically corrects common GAQL mistakes before hitting th
 | Pattern | Behavior | Warning/error emitted |
 |---------|----------|-----------------------|
 | Missing LIMIT | Adds `LIMIT 200` | `"Added LIMIT 200. Use --limit to override."` |
-| `keyword.text` | Rewrites to `ad_group_criterion.keyword.text` | `"keyword.text → ad_group_criterion.keyword.text"` |
+| Bare `keyword.text` / `keyword.match_type` | Rewrites to `ad_group_criterion.*` (resource-scoped forms like `shared_criterion.keyword.text` pass through untouched) | `"keyword.text → ad_group_criterion.keyword.text"` |
 | `shopping_performance_view.product_*` | Rewrites to `segments.product_*` | Field renamed |
 | `campaign.status = 'ACTIVE'` | Rewrites to `= 'ENABLED'` | Enum corrected |
 | `segments.conversion_action_name` with `metrics.cost_micros` | Rejects; split into separate conversion-action and spend queries | `INCOMPATIBLE_FIELDS` with `fix.action: "split_query"` |
@@ -1029,7 +1029,7 @@ Notes:
 
 - All write commands take `--file <json>` payloads; explicit flags override file keys. `baker schema ads.linkedin.campaigns.create` for exact args.
 - Money flags (`--bid`, `--daily-budget`, `--total-budget`) require `--currency`.
-- Creative media comes from the Baker library (`--image-id`/`--video-id` from `baker images`/`baker videos` — uploaded to LinkedIn at publish) or as LinkedIn URNs (`--image-urn`/`--video-urn`). Formats: `image|video|text|spotlight|follower|document|carousel|conversation|tla|jobs`; complex formats take `--file` with the full content object. Limits: headline ≤70, text-ad 25/75, intro soft-truncates at 600 chars. TLA sponsors an existing post via `--post-urn`.
+- Creative media comes from the Baker library (`--image-id`/`--video-id` from `baker images`/`baker videos` — uploaded to LinkedIn at publish) or as LinkedIn URNs (`--image-urn`/`--video-urn`). Formats: `image|video|text|spotlight|follower|document|carousel|conversation|tla|jobs`; complex formats take `--file` with the full content object; conversation ads take `--file` with the message flow (`{message: {subject, body, senderName?, buttons[]}}` — buttons `NESTED` (with `nestedMessage`) or `LANDING_PAGE` (with `landingPageUrl`), ≤25 messages, bodies ≤500 chars, labels ≤25). Limits: headline ≤70, text-ad 25/75, intro soft-truncates at 600 chars. TLA sponsors an existing post via `--post-urn`.
 - Lead forms are file-first (`lead-forms create --file form.json`): name, headline (≤60), privacyPolicyUrl, questions[] (≤12; playbook: ≤4 for completion).
 
 #### `audit` — playbook diagnostic

package/dist/cli.js

@@ -957,7 +957,11 @@ var LINKEDIN_LIMITS = {
     carouselCardHeadlineMax: 45,
     carouselCardsMin: 2,
     carouselCardsMax: 10,
-    conversationButtonLabelMax: 25
+    conversationButtonLabelMax: 25,
+    conversationBodyMax: 500,
+    conversationButtonsMax: 5,
+    conversationMessagesMax: 25,
+    conversationSubjectMax: 60
   },
   audience: {
     nameMax: 100,
@@ -1263,10 +1267,68 @@ var carouselCreativeSchema = z3.object({
     })
   ).min(LINKEDIN_LIMITS.creative.carouselCardsMin).max(LINKEDIN_LIMITS.creative.carouselCardsMax)
 });
+var conversationButtonSchema = z3.lazy(
+  () => z3.object({
+    label: z3.string().min(1).max(LINKEDIN_LIMITS.creative.conversationButtonLabelMax),
+    type: z3.enum(["NESTED", "LANDING_PAGE"]),
+    nestedMessage: conversationMessageSchema.optional(),
+    landingPageUrl: httpsUrlSchema.optional()
+  }).superRefine((button, ctx) => {
+    if (button.type === "NESTED" && !button.nestedMessage) {
+      ctx.addIssue({ code: "custom", path: ["nestedMessage"], message: "NESTED buttons need a nestedMessage" });
+    }
+    if (button.type === "LANDING_PAGE" && !button.landingPageUrl) {
+      ctx.addIssue({
+        code: "custom",
+        path: ["landingPageUrl"],
+        message: "LANDING_PAGE buttons need a landingPageUrl"
+      });
+    }
+    if (button.type === "LANDING_PAGE" && button.nestedMessage) {
+      ctx.addIssue({
+        code: "custom",
+        path: ["nestedMessage"],
+        message: "LANDING_PAGE buttons cannot nest a message"
+      });
+    }
+  })
+);
+var conversationMessageSchema = z3.lazy(
+  () => z3.object({
+    subject: z3.string().min(1).max(LINKEDIN_LIMITS.creative.conversationSubjectMax).optional(),
+    body: z3.string().min(1).max(LINKEDIN_LIMITS.creative.conversationBodyMax),
+    senderName: z3.string().min(1).max(100).optional(),
+    buttons: z3.array(conversationButtonSchema).max(LINKEDIN_LIMITS.creative.conversationButtonsMax).optional()
+  })
+);
+function countConversationMessages(message) {
+  return 1 + (message.buttons ?? []).reduce(
+    (sum, button) => sum + (button.nestedMessage ? countConversationMessages(button.nestedMessage) : 0),
+    0
+  );
+}
 var conversationCreativeSchema = z3.object({
   format: z3.literal("conversation"),
   name: z3.string().max(255).optional(),
-  raw: z3.record(z3.string(), z3.unknown())
+  /** Structured flow — publishable via the Conversation Ads API. */
+  message: conversationMessageSchema.optional(),
+  /** Legacy free-form passthrough — preview-only; restage with `message` to publish. */
+  raw: z3.record(z3.string(), z3.unknown()).optional()
+}).superRefine((p, ctx) => {
+  if (Boolean(p.message) === Boolean(p.raw)) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["message"],
+      message: "provide the conversation flow as `message` (legacy `raw` is accepted alone, not alongside it)"
+    });
+  }
+  if (p.message && countConversationMessages(p.message) > LINKEDIN_LIMITS.creative.conversationMessagesMax) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["message"],
+      message: `conversation flows are capped at ${LINKEDIN_LIMITS.creative.conversationMessagesMax} messages`
+    });
+  }
 });
 var tlaCreativeSchema = z3.object({
   format: z3.literal("tla"),
@@ -1323,10 +1385,9 @@ var creativeUpdateSchema = z3.object({
   landingUrl: httpsUrlSchema.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 patch: merged into the staged create (li_temp_* targets) or the
+   * live ad's snapshot content (real targets, direct-content formats) and
+   * re-validated against the full creative schema. Post-based ads reject it.
    */
   content: z3.record(z3.string(), z3.unknown()).optional()
 }).refine((p) => Object.values(p).some((val) => val !== void 0), "update needs at least one field");
@@ -3203,12 +3264,12 @@ function buildCommand(query, ctx) {
   return `baker ads google query "${query}" --customer-id ${ctx.customerId}`;
 }
 var CORRECTION_RULES = [
-  // 1. keyword.text → ad_group_criterion.keyword.text
+  // 1. bare keyword.text → ad_group_criterion.keyword.text (leaves <resource>.keyword.text untouched)
   {
-    matchQuery: /\bkeyword\.text\b/,
+    matchQuery: /(?<![\w.])keyword\.text\b/,
     matchApiError: /keyword\.text/i,
     fix: (ctx) => {
-      const corrected = ctx.originalQuery.replace(/\bkeyword\.text\b/g, "ad_group_criterion.keyword.text");
+      const corrected = ctx.originalQuery.replace(/(?<![\w.])keyword\.text\b/g, "ad_group_criterion.keyword.text");
       return {
         action: "retry_with_modified_query",
         correctedCommand: buildCommand(corrected, ctx),
@@ -3216,12 +3277,15 @@ var CORRECTION_RULES = [
       };
     }
   },
-  // 2. keyword.match_type → ad_group_criterion.keyword.match_type
+  // 2. bare keyword.match_type → ad_group_criterion.keyword.match_type (leaves <resource>.keyword.match_type untouched)
   {
-    matchQuery: /\bkeyword\.match_type\b/,
+    matchQuery: /(?<![\w.])keyword\.match_type\b/,
     matchApiError: /keyword\.match_type/i,
     fix: (ctx) => {
-      const corrected = ctx.originalQuery.replace(/\bkeyword\.match_type\b/g, "ad_group_criterion.keyword.match_type");
+      const corrected = ctx.originalQuery.replace(
+        /(?<![\w.])keyword\.match_type\b/g,
+        "ad_group_criterion.keyword.match_type"
+      );
       return {
         action: "retry_with_modified_query",
         correctedCommand: buildCommand(corrected, ctx),
@@ -4573,12 +4637,12 @@ function buildCommand2(query, customerId) {
 function applyAutoFixes(query, limit) {
   let corrected = query;
   const warnings = [];
-  if (/\bkeyword\.text\b/.test(corrected) && !/ad_group_criterion\.keyword\.text/.test(corrected)) {
-    corrected = corrected.replace(/\bkeyword\.text\b/g, "ad_group_criterion.keyword.text");
+  if (/(?<![\w.])keyword\.text\b/.test(corrected)) {
+    corrected = corrected.replace(/(?<![\w.])keyword\.text\b/g, "ad_group_criterion.keyword.text");
     warnings.push({ code: "FIELD_RENAMED", message: "keyword.text \u2192 ad_group_criterion.keyword.text" });
   }
-  if (/\bkeyword\.match_type\b/.test(corrected) && !/ad_group_criterion\.keyword\.match_type/.test(corrected)) {
-    corrected = corrected.replace(/\bkeyword\.match_type\b/g, "ad_group_criterion.keyword.match_type");
+  if (/(?<![\w.])keyword\.match_type\b/.test(corrected)) {
+    corrected = corrected.replace(/(?<![\w.])keyword\.match_type\b/g, "ad_group_criterion.keyword.match_type");
     warnings.push({ code: "FIELD_RENAMED", message: "keyword.match_type \u2192 ad_group_criterion.keyword.match_type" });
   }
   if (/shopping_performance_view\.product_\w+/.test(corrected)) {
@@ -5492,6 +5556,7 @@ registerSchema({
     ...writeAccountArgs,
     name: { type: "string", description: "New name", required: false },
     objective: { type: "string", description: "New objective", required: false },
+    "cost-type": { type: "string", description: "CPC|CPM|CPV", required: false },
     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 },
@@ -5592,7 +5657,7 @@ registerSchema({
 });
 registerSchema({
   command: "ads.linkedin.creatives.create",
-  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.",
+  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; conversation ads take --file with the message flow ({message: {subject, body (\u2264500), senderName?, buttons \u22645 \xD7 {label \u226425, type NESTED|LANDING_PAGE, nestedMessage?|landingPageUrl?}}}, \u226425 messages). Staged until publish.",
   args: {
     ...writeAccountArgs,
     campaign: { type: "string", description: "Campaign id/URN or li_temp_* ref", required: true },
@@ -5613,8 +5678,24 @@ registerSchema({
     cta: { type: "string", description: "LEARN_MORE|REQUEST_DEMO|SIGN_UP|REGISTER|DOWNLOAD|\u2026", required: false },
     "cta-label": { type: "string", description: "Spotlight CTA label (\u226418 chars)", required: false },
     "post-urn": { type: "string", description: "TLA: post to sponsor (urn:li:share|ugcPost:*)", required: false },
+    "event-urn": {
+      type: "string",
+      description: "Event ads: the LinkedIn event to sponsor (urn:li:event:*)",
+      required: false
+    },
+    "article-url": {
+      type: "string",
+      description: "Article ads: https URL of the article/newsletter to sponsor",
+      required: false
+    },
+    "thumbnail-image-id": {
+      type: "string",
+      description: "Article ads: Baker image id for the link thumbnail",
+      required: false
+    },
+    "thumbnail-urn": { type: "string", description: "Article ads: existing urn:li:image:* thumbnail", required: false },
     "intended-status": { type: "string", description: "DRAFT|ACTIVE|PAUSED (default DRAFT)", required: false },
-    title: { type: "string", description: "Media title", required: false },
+    title: { type: "string", description: "Media title (image/video) or article title", required: false },
     file: { type: "string", description: "JSON file with the full content object", required: false }
   }
 });
@@ -5631,15 +5712,18 @@ registerSchema({
     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 },
+    "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 },
     "thumbnail-image-id": {
       type: "string",
       description: "Baker image id for the article thumbnail",
       required: false
     },
+    "thumbnail-urn": { type: "string", description: "Existing urn:li:image:* thumbnail", 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 }
   }
@@ -7112,7 +7196,7 @@ var creativesCreateCommand = defineCommand36({
   meta: {
     name: "create",
     description: `Stage a new creative (ad). ${STAGED_NOTE}
-Formats: ${CREATIVE_FORMATS.join("|")}. Media comes from the Baker library (--image-id / --video-id from \`baker images\`/\`baker videos\`) or as LinkedIn URNs. Complex formats (carousel, conversation, jobs) take --file with the full content object.
+Formats: ${CREATIVE_FORMATS.join("|")}. Media comes from the Baker library (--image-id / --video-id from \`baker images\`/\`baker videos\`) or as LinkedIn URNs. Complex formats (carousel, jobs) take --file with the full content object. Conversation ads take --file with the message flow ({message: {subject, body, buttons[]}} \u2014 buttons NESTED|LANDING_PAGE, nested messages recurse).
 Examples:
   baker ads linkedin creatives create --campaign li_temp_x2 --format image --image-id <bakerImageId> --intro "Meet the platform\u2026" --headline "Book a demo" --landing-url https://example.com/demo --cta REQUEST_DEMO
   baker ads linkedin creatives create --campaign 123456 --format tla --post-urn urn:li:ugcPost:789`