@koda-sl/baker-cli 0.514.0 → 0.515.0-dev.8df53bffe

package/dist/draft-CRDBU6LF.js

@@ -0,0 +1,308 @@
+import {
+  draftAction,
+  draftListAction,
+  failWriteValidation,
+  handleGoogleError,
+  loadJsonPayloads,
+  loadPatchArg,
+  requireTarget,
+  stageGoogleOps
+} from "./chunk-DMJUIUAL.js";
+import "./chunk-ERSX3MKH.js";
+import "./chunk-SCAGMX2I.js";
+import "./chunk-4NZ47VXO.js";
+import "./chunk-D5FY4FAK.js";
+import "./chunk-QPESDKZC.js";
+import "./chunk-Y2JZX6JB.js";
+import "./chunk-IZABTTW5.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-ZRP7Y2DM.js";
+import "./chunk-E44NXCTL.js";
+import "./chunk-EJGAJHLB.js";
+import "./chunk-LNNTHEL7.js";
+import "./chunk-FOMFU2RX.js";
+import "./chunk-PSGIHSNC.js";
+import "./chunk-PONLPYD7.js";
+import {
+  CHAT_READ_ARG
+} from "./chunk-PFBQERWX.js";
+import "./chunk-NSBNIPIW.js";
+import {
+  GOOGLE_DRAFT_BATCH_MAX
+} from "./chunk-MUS2UTWU.js";
+import {
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import {
+  requireChatId
+} from "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/google/draft.ts
+import { defineCommand } from "citty";
+
+// src/commands/ads/google/draft-batch.ts
+function refuseOversized(count, what) {
+  if (count > GOOGLE_DRAFT_BATCH_MAX) {
+    failWriteValidation(
+      `${count} ${what} exceeds the batch limit of ${GOOGLE_DRAFT_BATCH_MAX} \u2014 split the file and run the command once per part`
+    );
+  }
+}
+function stageFileOps(items, customerId) {
+  if (items.length === 0) {
+    failWriteValidation(
+      'pass --file with the ops to stage: a JSON array (or JSON Lines) of {"kind","customerId","target"?,"payload"?}'
+    );
+  }
+  refuseOversized(items.length, "ops");
+  return items.map((item, index) => {
+    if (typeof item.kind !== "string") {
+      failWriteValidation(
+        `item ${index} has no "kind" \u2014 every item is a whole op, e.g. {"kind":"google.keyword.add",\u2026}`
+      );
+    }
+    return item.customerId === void 0 && customerId ? { ...item, customerId } : item;
+  });
+}
+function amendBatchEntries(items) {
+  refuseOversized(items.length, "amends");
+  return items.map((item, index) => {
+    const { ref, patch } = item;
+    if (typeof ref !== "string" || ref.length === 0) {
+      failWriteValidation(`item ${index} has no "ref" \u2014 name the staged op (g_temp_* or its target) to amend`);
+    }
+    if (patch === null || typeof patch !== "object" || Array.isArray(patch)) {
+      failWriteValidation(`item ${index} has no "patch" object \u2014 {"ref":"\u2026","patch":{\u2026fields to change\u2026}}`);
+    }
+    return { ref, patch };
+  });
+}
+
+// src/commands/ads/google/draft-validate.ts
+var QUIET = /* @__PURE__ */ new Set(["accepted", "applied"]);
+function changes(n) {
+  return n === 1 ? "1 change" : `${n} changes`;
+}
+function validationHints(data) {
+  const { refused, blocked, unchecked } = data.counts;
+  const hints = [];
+  if (refused > 0) {
+    hints.push(
+      `${changes(refused)} would fail at publish. Fix each refused op in place with \`draft amend <ref>\` (or \`draft remove <ref>\` if it should not exist), then run \`draft validate\` again before asking the user to publish. Never tell the user a refused change will go live.`
+    );
+  }
+  if (blocked > 0) {
+    hints.push(
+      `${changes(blocked)} would not apply only because a refused change they depend on fails \u2014 fixing the refused one clears them.`
+    );
+  }
+  if (data.publishHeld) {
+    hints.push(
+      "Baker would hold this whole publish: a refused change stops a first publish from sending anything. Fix it first."
+    );
+  }
+  if (unchecked > 0) {
+    hints.push(
+      `${changes(unchecked)} can only be checked by Google at publish (the reason is on each one). Nothing here says they will fail.`
+    );
+  }
+  if (refused + blocked === 0 && !data.publishHeld && data.ops.length > 0) {
+    hints.push(
+      "Google accepted every change it was asked about. The draft is ready for the user to review and publish."
+    );
+  }
+  return hints;
+}
+function validationEnvelope(data, full = false) {
+  const ops = full ? data.ops : data.ops.filter((op) => !QUIET.has(op.verdict));
+  return { ok: true, data: { ...data, ops }, hints: validationHints(data) };
+}
+
+// src/commands/ads/google/draft.ts
+var VALIDATE_DESCRIPTION = `Ask Google whether the whole staged draft would publish \u2014 without applying anything.
+
+Start here, after the last staged change and before telling the user the draft is ready:
+  baker ads google draft validate
+
+Every staged op is built, batched and sent exactly as publish sends it, with Google's validateOnly
+flag, so each verdict is the answer publish would get: accepted | refused | blocked (a change it
+depends on was refused) | unchecked (only publish can check it) | applied (an earlier publish did).
+Compact by default \u2014 counts, plus only the ops that need attention, each with Google's reason.
+Fix refused ops with \`draft amend <ref>\` and validate again.
+
+Examples:
+  baker ads google draft validate
+  baker ads google draft validate --full   # every op, with its built request and Google's raw answer`;
+registerSchema({
+  command: "ads.google.draft.validate",
+  description: VALIDATE_DESCRIPTION,
+  args: {
+    full: {
+      type: "boolean",
+      description: "List every op with its built request and Google's raw answer",
+      required: false
+    }
+  }
+});
+var STAGE_DESCRIPTION = `Stage many Google Ads changes from ONE file, in one call \u2014 any mix of kinds, up to 500 ops.
+
+Start here whenever a change touches more than a few rows (a keyword cleanup, bid changes, pausing
+ads, a list of negatives): write the ops to a file and stage them together instead of running one
+command per row.
+  baker ads google draft stage --file changes.json --customer-id 1234567890
+
+The file is a JSON array (or JSON Lines, one op per line). Each op is what the single commands
+build \u2014 kind, customerId (or --customer-id for all), target for a change to something that exists,
+payload. Read the shape for a kind with \`baker capabilities google-ads\`.
+  [
+    {"kind":"google.keyword.add","payload":{"adGroup":"customers/1234567890/adGroups/111","text":"solar panels","matchType":"PHRASE"}},
+    {"kind":"google.keyword.update","target":"customers/1234567890/adGroupCriteria/111~222","payload":{"status":"PAUSED"}},
+    {"kind":"google.negativeKeyword.add","payload":{"level":"campaign","parent":"222333","text":"free","matchType":"BROAD"}}
+  ]
+An op may name a g_temp_* ref an EARLIER call returned (a campaign or ad group staged before), but
+not another op in the same file \u2014 a ref exists only once its op is staged, so stage new parents first.
+All-or-nothing: one invalid op stages nothing. Ops already in effect come back as skipped.
+Then: baker ads google draft validate`;
+registerSchema({
+  command: "ads.google.draft.stage",
+  description: STAGE_DESCRIPTION,
+  args: {
+    file: {
+      type: "string",
+      description: "JSON array or JSON Lines of ops ({kind, customerId?, target?, payload?}), path or inline",
+      required: true
+    },
+    "customer-id": {
+      type: "string",
+      description: "10-digit customer id for every op that does not name its own",
+      required: false
+    }
+  }
+});
+var BULK_STAGE_HINTS = [
+  "Run `baker ads google draft validate` next: it asks Google about every staged op at once and lists only the ones it would refuse.",
+  'To fix several staged ops, amend them together: `baker ads google draft amend --file amends.json` with [{"ref":"\u2026","patch":{\u2026}}, \u2026].'
+];
+var draftCommand = defineCommand({
+  meta: {
+    name: "draft",
+    description: "Stage many ops from one file, or list, validate, remove, clear, amend, or show staged Google Ads write ops for this chat. `list` and `show` take --chat <id> to read an earlier chat's changes instead."
+  },
+  subCommands: {
+    stage: defineCommand({
+      meta: { name: "stage", description: STAGE_DESCRIPTION },
+      args: {
+        file: {
+          type: "string",
+          description: "JSON array or JSON Lines of ops ({kind, customerId?, target?, payload?}), path or inline"
+        },
+        "customer-id": { type: "string", description: "10-digit customer id for every op that does not name its own" }
+      },
+      run: async ({ args }) => {
+        const customerId = typeof args["customer-id"] === "string" ? args["customer-id"] : void 0;
+        await stageGoogleOps(stageFileOps(loadJsonPayloads(args.file), customerId), BULK_STAGE_HINTS);
+      }
+    }),
+    list: defineCommand({
+      meta: {
+        name: "list",
+        description: "Review everything staged as a campaign \u25B8 ad group \u25B8 ad tree (--json for the raw envelope)"
+      },
+      args: {
+        json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable tree" },
+        chat: CHAT_READ_ARG
+      },
+      run: async ({ args }) => {
+        await draftListAction(args.json === true, args.chat);
+      }
+    }),
+    remove: defineCommand({
+      meta: { name: "remove", description: "Remove one staged op (cascades to dependents)" },
+      args: { ref: { type: "positional", description: "Staged op ref (g_temp_* or target)", required: false } },
+      run: async ({ args }) => {
+        await draftAction("/api/ads/google/draft/remove", { ref: requireTarget(args, "op") });
+      }
+    }),
+    clear: defineCommand({
+      meta: { name: "clear", description: "Discard all staged ops on this chat" },
+      run: async () => {
+        await draftAction("/api/ads/google/draft/clear", {});
+      }
+    }),
+    amend: defineCommand({
+      meta: {
+        name: "amend",
+        description: 'Update a staged op in place \u2014 merges a JSON patch into its payload (RFC-7386: objects deep-merge, null deletes a key, arrays/scalars replace) and re-validates. Use this instead of remove + re-create. Many at once: no ref, and --file holding [{"ref":"g_temp_\u2026","patch":{\u2026}}, \u2026] \u2014 all amended in one call, or none if any is refused.'
+      },
+      args: {
+        ref: {
+          type: "positional",
+          description: "Staged op ref (g_temp_*) or target id/resource name \u2014 leave out to amend many from --file",
+          required: false
+        },
+        file: {
+          type: "string",
+          description: 'JSON file with the patch object \u2014 or, with no ref, a JSON array of {"ref","patch"} amends'
+        },
+        patch: { type: "string", description: "Inline JSON patch object" }
+      },
+      run: async ({ args }) => {
+        const positional = Array.isArray(args._) ? args._[0] : void 0;
+        if (!(args.ref ?? positional) && typeof args.file === "string" && args.file.length > 0) {
+          const amends = amendBatchEntries(loadJsonPayloads(args.file));
+          await draftAction("/api/ads/google/draft/amend-batch", { amends });
+          return;
+        }
+        const ref = requireTarget(args, "op");
+        const patch = loadPatchArg(args);
+        await draftAction("/api/ads/google/draft/amend", { ref, patch });
+      }
+    }),
+    validate: defineCommand({
+      meta: { name: "validate", description: VALIDATE_DESCRIPTION },
+      args: {
+        full: { type: "boolean", description: "List every op with its built request and Google's raw answer" }
+      },
+      run: async ({ args }) => {
+        try {
+          const full = args.full === true;
+          const response = await apiPost(
+            "/api/ads/google/draft/validate",
+            { chatId: requireChatId(), full }
+          );
+          writeJsonEnvelope(response.ok && response.data ? validationEnvelope(response.data, full) : response);
+        } catch (err) {
+          handleGoogleError(err);
+        }
+      }
+    }),
+    show: defineCommand({
+      meta: {
+        name: "show",
+        description: "Print the full staged payload for one op \u2014 the receipt to verify a change looks right before publish (never truncated)."
+      },
+      args: {
+        ref: {
+          type: "positional",
+          description: "Staged op ref (g_temp_*) or target id/resource name",
+          required: false
+        },
+        chat: CHAT_READ_ARG
+      },
+      run: async ({ args }) => {
+        await draftAction("/api/ads/google/draft/show", { ref: requireTarget(args, "op") }, args.chat);
+      }
+    })
+  }
+});
+export {
+  BULK_STAGE_HINTS,
+  draftCommand
+};
+//# sourceMappingURL=draft-CRDBU6LF.js.map

package/dist/draft-P7IDMXWR.js

@@ -0,0 +1,310 @@
+import {
+  loadPatchArg,
+  requireTarget
+} from "./chunk-7I6ZVBLM.js";
+import {
+  handleLinkedinError
+} from "./chunk-BJOK7QD4.js";
+import "./chunk-SCAGMX2I.js";
+import "./chunk-4NZ47VXO.js";
+import {
+  hintLines
+} from "./chunk-D5FY4FAK.js";
+import "./chunk-QPESDKZC.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-ZRP7Y2DM.js";
+import "./chunk-E44NXCTL.js";
+import "./chunk-EJGAJHLB.js";
+import "./chunk-LNNTHEL7.js";
+import "./chunk-FOMFU2RX.js";
+import "./chunk-PSGIHSNC.js";
+import "./chunk-PONLPYD7.js";
+import {
+  CHAT_READ_ARG
+} from "./chunk-PFBQERWX.js";
+import "./chunk-NZ34KM46.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-MUS2UTWU.js";
+import {
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import {
+  requireChatId,
+  resolveChatId
+} from "./chunk-LGK7UWBN.js";
+import "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/draft.ts
+import { defineCommand } from "citty";
+
+// src/commands/ads/linkedin/draft-status.ts
+var OPERATION_LABELS = {
+  create: "Creating",
+  update: "Updating",
+  pause: "Pausing",
+  resume: "Resuming",
+  archive: "Archiving",
+  delete: "Deleting"
+};
+function badge(node) {
+  const label = node.operation ? OPERATION_LABELS[node.operation] : void 0;
+  if (label) {
+    return label;
+  }
+  return node.existing ? "on LinkedIn" : "staged";
+}
+function collectionLine(collection) {
+  const parts = [];
+  if (collection.added > 0) {
+    parts.push(`+${collection.added}`);
+  }
+  if (collection.existing > 0) {
+    parts.push(`${collection.existing} existing`);
+  }
+  if (collection.removed > 0) {
+    parts.push(`-${collection.removed}`);
+  }
+  return parts.length > 0 ? `${collection.label}: ${parts.join(", ")}` : void 0;
+}
+function accountsInTree(nodes) {
+  const accounts = /* @__PURE__ */ new Set();
+  const walk = (node) => {
+    accounts.add(node.accountId);
+    for (const child of node.children) {
+      walk(child);
+    }
+  };
+  for (const node of nodes) {
+    walk(node);
+  }
+  return accounts;
+}
+function renderNode(node, depth, lines, showAccount) {
+  const indent = "  ".repeat(depth);
+  const account = showAccount ? ` \xB7 account ${node.accountId}` : "";
+  lines.push(`${indent}\u2022 ${node.name} \xB7 ${badge(node)}${account}`);
+  for (const warning of node.warnings ?? []) {
+    lines.push(`${indent}    \u26A0 ${warning}`);
+  }
+  for (const collection of node.collections) {
+    const line = collectionLine(collection);
+    if (line) {
+      lines.push(`${indent}    ${line}`);
+    }
+  }
+  for (const child of node.children) {
+    renderNode(child, depth + 1, lines, showAccount);
+  }
+}
+function renderSection(title, nodes, lines, showAccount) {
+  if (nodes.length === 0) {
+    return;
+  }
+  lines.push("");
+  lines.push(title);
+  for (const node of nodes) {
+    renderNode(node, 1, lines, showAccount);
+  }
+}
+var CAMPAIGN_TREE_ENTITIES = /* @__PURE__ */ new Set(["campaignGroup", "campaign", "creative"]);
+function renderOutcome(data, lines) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const op of data.ops ?? []) {
+    const status = op.result?.status ?? "pending";
+    counts.set(status, (counts.get(status) ?? 0) + 1);
+  }
+  const summary = [...counts].map(([status, count]) => `${count} ${status}`).join(", ");
+  lines.push(`LinkedIn Ads \u2014 published \xB7 ${summary || `${data.count} op(s)`} \xB7 ${data.mode}`);
+  for (const op of data.ops ?? []) {
+    const status = op.result?.status;
+    if (status === "applied" && op.result?.error) {
+      lines.push(`  \u26A0 ${op.summary} \u2014 applied in part: ${op.result.error}`);
+      continue;
+    }
+    if (status !== "failed" && status !== "skipped") {
+      continue;
+    }
+    const reason = op.result?.error ?? op.result?.skippedBecause ?? "no reason recorded";
+    lines.push(`  \u2717 ${op.summary} \u2014 ${status}: ${reason}`);
+  }
+}
+function renderDraftStatus(data) {
+  if (data.status === "none" || data.count === 0) {
+    return "No staged LinkedIn changes on this chat.";
+  }
+  const modeNote = data.mode === "live" ? "Live \u2014 publishing writes directly to LinkedIn." : "Simulated \u2014 publishing completes the whole draft without calling LinkedIn.";
+  const lines = [];
+  if (data.status === "applied") {
+    renderOutcome(data, lines);
+  } else if (data.status === "publishing") {
+    lines.push(`LinkedIn Ads \u2014 publishing ${data.count} change${data.count === 1 ? "" : "s"} \xB7 ${data.mode}`);
+  } else {
+    lines.push(`LinkedIn Ads \u2014 ${data.count} staged change${data.count === 1 ? "" : "s"} \xB7 ${data.mode}`);
+  }
+  lines.push(modeNote);
+  const tree = data.tree ?? [];
+  const showAccount = accountsInTree(tree).size > 1;
+  renderSection(
+    "Campaigns",
+    tree.filter((node) => CAMPAIGN_TREE_ENTITIES.has(node.entity)),
+    lines,
+    showAccount
+  );
+  const rest = tree.filter((node) => !CAMPAIGN_TREE_ENTITIES.has(node.entity));
+  renderSection("Other", rest, lines, showAccount);
+  return lines.join("\n");
+}
+
+// src/commands/ads/linkedin/draft.ts
+async function listDraft(json, chat) {
+  try {
+    const chatId = resolveChatId(chat);
+    const response = await apiPost("/api/ads/linkedin/draft", {
+      chatId
+    });
+    if (json || !response.ok || !response.data) {
+      writeJsonEnvelope(response);
+      return;
+    }
+    process.stdout.write(`${renderDraftStatus(response.data)}${hintLines(response)}
+`);
+  } catch (err) {
+    handleLinkedinError(err);
+  }
+}
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "Review everything staged as a Campaign group \u25B8 Campaign \u25B8 Creative tree (--json for the raw envelope). Example: baker ads linkedin draft"
+  },
+  args: {
+    json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable tree" },
+    chat: CHAT_READ_ARG
+  },
+  run: async ({ args }) => {
+    await listDraft(args.json === true, args.chat);
+  }
+});
+var removeCommand = defineCommand({
+  meta: {
+    name: "remove",
+    description: "Drop one staged LinkedIn op. Removing a create cascades to everything that depends on it \u2014 except a company exclusion, which only loses the removed audience and keeps its companies (listed under `updated`). Example: baker ads linkedin draft remove li_temp_abc123"
+  },
+  args: {
+    ref: {
+      type: "positional",
+      description: "Op ref (li_temp_* for creates, target id/URN for updates)",
+      required: true
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const chatId = requireChatId();
+      const response = await apiPost(
+        "/api/ads/linkedin/draft/remove",
+        { chatId, ref: args.ref }
+      );
+      writeJsonEnvelope(response);
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var clearCommand = defineCommand({
+  meta: {
+    name: "clear",
+    description: "Discard ALL staged LinkedIn ops in this chat's draft \u2014 nothing will apply on publish. Example: baker ads linkedin draft clear"
+  },
+  run: async () => {
+    try {
+      const chatId = requireChatId();
+      const response = await apiPost("/api/ads/linkedin/draft/clear", {
+        chatId
+      });
+      writeJsonEnvelope(response);
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var amendCommand = defineCommand({
+  meta: {
+    name: "amend",
+    description: "Update a staged op in place \u2014 merges a JSON patch into its payload (RFC-7386: objects deep-merge, null deletes a key, arrays/scalars replace) and re-validates. Use this instead of remove + re-create."
+  },
+  args: {
+    ref: { type: "positional", description: "Staged op ref (li_temp_*) or target id/URN", required: true },
+    file: { type: "string", description: "JSON file with the patch object" },
+    patch: { type: "string", description: "Inline JSON patch object" }
+  },
+  run: async ({ args }) => {
+    const ref = requireTarget(args, "op");
+    const patch = loadPatchArg(args);
+    try {
+      const chatId = requireChatId();
+      const body = { chatId, ref, patch };
+      const response = await apiPost(
+        "/api/ads/linkedin/draft/amend",
+        body
+      );
+      writeJsonEnvelope(response);
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var showCommand = defineCommand({
+  meta: {
+    name: "show",
+    description: "Print the full staged payload for one op \u2014 the receipt to verify a change looks right before publish (never truncated)."
+  },
+  args: {
+    ref: { type: "positional", description: "Staged op ref (li_temp_*) or target id/URN", required: true },
+    chat: CHAT_READ_ARG
+  },
+  run: async ({ args }) => {
+    const ref = requireTarget(args, "op");
+    try {
+      const chatId = resolveChatId(args.chat);
+      const body = { chatId, ref };
+      const response = await apiPost(
+        "/api/ads/linkedin/draft/show",
+        body
+      );
+      writeJsonEnvelope(response);
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var linkedinDraftCommand = defineCommand({
+  meta: {
+    name: "draft",
+    description: "Review and edit the LinkedIn write ops staged in this chat BEFORE publish. Subcommands: list (default), remove, clear, amend, show. Ops never hit LinkedIn until the chat is published. `list` and `show` take --chat <id> to read an earlier chat's changes instead."
+  },
+  // Declared on the parent too: `default: "list"` dispatches the bare `draft --chat <id>` form, and
+  // citty prints help for a flag the parent does not know instead of forwarding it.
+  args: { chat: CHAT_READ_ARG },
+  subCommands: {
+    list: listCommand,
+    remove: removeCommand,
+    clear: clearCommand,
+    amend: amendCommand,
+    show: showCommand
+  },
+  // A parent must never declare `run`: citty falls through to it *after* running
+  // the matched subcommand, so `draft show <ref>` would also re-list the draft.
+  default: "list"
+});
+export {
+  linkedinDraftCommand
+};
+//# sourceMappingURL=draft-P7IDMXWR.js.map