@koda-sl/baker-cli 0.552.0 → 0.553.0

package/dist/draft-PO5X4UVA.js

@@ -0,0 +1,313 @@
+import {
+  loadPatchArg,
+  requireTarget
+} from "./chunk-NRIKX35V.js";
+import {
+  handleLinkedinError
+} from "./chunk-42JTSTQ3.js";
+import "./chunk-P4MXGSSJ.js";
+import "./chunk-4NZ47VXO.js";
+import {
+  hintLines
+} from "./chunk-D5FY4FAK.js";
+import "./chunk-4H6XLX7E.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-QYH2UZAK.js";
+import "./chunk-Y3SK6EMU.js";
+import "./chunk-XB4NKZAQ.js";
+import "./chunk-E56V3RFO.js";
+import "./chunk-ZANXEMON.js";
+import "./chunk-G6U45QD3.js";
+import "./chunk-4ULGRGBG.js";
+import {
+  CHAT_READ_ARG,
+  DRAFT_FULL_ARG
+} from "./chunk-X32MFGWW.js";
+import "./chunk-RCNAKWK7.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-MSMTG6OC.js";
+import {
+  apiPost
+} from "./chunk-GFWWHCBF.js";
+import "./chunk-JXTNP3B5.js";
+import {
+  requireChatId,
+  resolveChatId
+} from "./chunk-45D6WRCJ.js";
+import "./chunk-CCYZJMZ7.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, full = false) {
+  try {
+    const chatId = resolveChatId(chat);
+    const response = await apiPost("/api/ads/linkedin/draft", {
+      chatId,
+      ...full ? { full: true } : {}
+    });
+    if (json || full || !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, --full for every op's payload too). Example: baker ads linkedin draft"
+  },
+  args: {
+    json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable tree" },
+    full: DRAFT_FULL_ARG,
+    chat: CHAT_READ_ARG
+  },
+  run: async ({ args }) => {
+    await listDraft(args.json === true, args.chat, args.full === true);
+  }
+});
+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: { full: DRAFT_FULL_ARG, 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-PO5X4UVA.js.map

package/dist/draft-QCKJT7XQ.js

@@ -0,0 +1,288 @@
+import {
+  failWriteValidation,
+  schemaArgs
+} from "./chunk-7SNNQCDD.js";
+import {
+  CHATGPT_ADS_REFERENCE,
+  chatgptFailure
+} from "./chunk-FAV6GUOZ.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-QYH2UZAK.js";
+import {
+  CHAT_READ_ARG,
+  DRAFT_FULL_ARG
+} from "./chunk-X32MFGWW.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import {
+  apiPost
+} from "./chunk-GFWWHCBF.js";
+import "./chunk-JXTNP3B5.js";
+import {
+  requireChatId,
+  resolveChatId
+} from "./chunk-45D6WRCJ.js";
+import {
+  registerSchema
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/chatgpt/draft.ts
+import { readFileSync } from "fs";
+import { defineCommand } from "citty";
+
+// src/commands/ads/chatgpt/draft-status.ts
+var OPERATION_LABELS = {
+  create: { staged: "Creating", done: "Created", notDone: "Not created" },
+  update: { staged: "Updating", done: "Updated", notDone: "Not updated" },
+  pause: { staged: "Pausing", done: "Paused", notDone: "Not paused" },
+  resume: { staged: "Resuming", done: "Resumed", notDone: "Not resumed" },
+  archive: { staged: "Archiving", done: "Archived", notDone: "Not archived" }
+};
+var STATUS_HEADINGS = {
+  active: "staged",
+  publishing: "publishing",
+  applied: "published",
+  discarded: "discarded"
+};
+function badge(node) {
+  const label = node.operation ? OPERATION_LABELS[node.operation] : void 0;
+  if (!label) {
+    return node.existing ? "on ChatGPT Ads" : "staged";
+  }
+  if (node.outcome === "applied") {
+    return label.done;
+  }
+  return node.outcome ? `${label.notDone} (${node.outcome})` : label.staged;
+}
+function renderNode(node, depth, out) {
+  const indent = "  ".repeat(depth);
+  out.push(`${indent}${node.entity}: ${node.name} \u2014 ${badge(node)}`);
+  for (const warning of node.warnings ?? []) {
+    out.push(`${indent}  ! ${warning}`);
+  }
+  for (const child of node.children) {
+    renderNode(child, depth + 1, out);
+  }
+}
+function didNotApply(op) {
+  return op.result?.status === "failed" || op.result?.status === "skipped";
+}
+function didApply(op) {
+  return op.result?.status === "applied" || op.result?.status === "simulated";
+}
+function headingLine(draft) {
+  const heading = STATUS_HEADINGS[draft.status] ?? draft.status;
+  if (draft.status !== "applied" && draft.status !== "publishing") {
+    return `ChatGPT Ads: ${draft.count} change${draft.count === 1 ? "" : "s"} ${heading}`;
+  }
+  const applied = draft.ops.filter(didApply).length;
+  const failed = draft.ops.filter(didNotApply).length;
+  return `ChatGPT Ads: ${heading} \xB7 ${applied} applied${failed > 0 ? `, ${failed} failed` : ""}`;
+}
+function renderChatgptDraftStatus(draft) {
+  if (draft.status === "none" || draft.count === 0) {
+    return "No ChatGPT Ads changes staged";
+  }
+  const out = [headingLine(draft), ""];
+  for (const node of draft.tree ?? []) {
+    renderNode(node, 0, out);
+  }
+  const summaryByRef = new Map(draft.ops.map((op) => [op.ref, op.summary]));
+  const problems = draft.ops.filter(didNotApply).map((op) => {
+    if (op.result?.status === "failed") {
+      return `\u2717 ${op.summary} \u2014 failed: ${op.result.error ?? "ChatGPT Ads gave no reason"}`;
+    }
+    const waitedOn = op.result?.skippedBecause;
+    const parent = (waitedOn && summaryByRef.get(waitedOn)) ?? "a change that did not apply";
+    return `\u2717 ${op.summary} \u2014 skipped: waiting on ${parent}, which did not apply`;
+  });
+  if (problems.length > 0) {
+    out.push("", ...problems);
+  }
+  return out.join("\n");
+}
+
+// src/commands/ads/chatgpt/draft.ts
+async function run(call) {
+  try {
+    writeJsonEnvelope({ ok: true, data: await call() });
+  } catch (err) {
+    writeJsonEnvelope({ ...chatgptFailure(err, CHATGPT_ADS_REFERENCE.overview) });
+    process.exit(1);
+  }
+}
+var LIST_ARGS = {
+  json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable tree" },
+  full: DRAFT_FULL_ARG,
+  chat: CHAT_READ_ARG
+};
+registerSchema({
+  command: "ads.chatgpt.draft",
+  description: "Review everything staged for ChatGPT Ads on this chat as a Campaign \u25B8 Ad group \u25B8 Ad tree. After a publish this is the authoritative record: `published \xB7 N applied`, or a `\u2717 \u2026 failed:` line per change that did not land, with ChatGPT Ads' reason.",
+  args: schemaArgs(LIST_ARGS)
+});
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "Review everything staged as a Campaign \u25B8 Ad group \u25B8 Ad tree. Example: baker ads chatgpt draft"
+  },
+  args: LIST_ARGS,
+  run: async ({ args }) => {
+    try {
+      const full = args.full === true;
+      const draft = await apiPost("/api/ads/chatgpt/draft", {
+        chatId: resolveChatId(args.chat),
+        ...full ? { full: true } : {}
+      });
+      if (args.json === true || full) {
+        writeJsonEnvelope({ ok: true, data: draft });
+        return;
+      }
+      process.stdout.write(`${renderChatgptDraftStatus(draft)}
+`);
+    } catch (err) {
+      writeJsonEnvelope({ ...chatgptFailure(err, CHATGPT_ADS_REFERENCE.overview) });
+      process.exit(1);
+    }
+  }
+});
+var SHOW_ARGS = {
+  ref: {
+    type: "positional",
+    description: "Op ref (chatgpt_temp_* for creates), or the target id for a staged update",
+    required: true
+  },
+  chat: CHAT_READ_ARG
+};
+registerSchema({
+  command: "ads.chatgpt.draft.show",
+  description: "The full staged payload, warnings and before-snapshot for one change \u2014 the receipt to check before publishing.",
+  args: schemaArgs(SHOW_ARGS)
+});
+var showCommand = defineCommand({
+  meta: {
+    name: "show",
+    description: "Show one staged change in full. Example: baker ads chatgpt draft show chatgpt_temp_ab12"
+  },
+  args: SHOW_ARGS,
+  run: async ({ args }) => {
+    await run(
+      () => apiPost("/api/ads/chatgpt/draft/show", {
+        chatId: resolveChatId(args.chat),
+        ref: String(args.ref)
+      })
+    );
+  }
+});
+var AMEND_ARGS = {
+  ref: { type: "positional", description: "Op ref or target id", required: true },
+  patch: { type: "positional", description: "JSON object, or @path to a file holding one", required: true }
+};
+registerSchema({
+  command: "ads.chatgpt.draft.amend",
+  description: "Change a staged op in place instead of removing and re-staging it. The patch merges into the payload (JSON merge-patch: `null` deletes a key; money is in micros) and the whole op re-validates.",
+  args: schemaArgs(AMEND_ARGS)
+});
+var amendCommand = defineCommand({
+  meta: {
+    name: "amend",
+    description: `Change a staged op in place. Money in the payload is micros: 20 = 20000000.
+
+Example:
+  baker ads chatgpt draft amend chatgpt_temp_ab12 '{"dailyBudgetMicros": 30000000}'`
+  },
+  args: AMEND_ARGS,
+  run: async ({ args }) => {
+    const raw = String(args.patch);
+    let patch;
+    try {
+      patch = JSON.parse(raw.startsWith("@") ? readFileSync(raw.slice(1), "utf8") : raw);
+    } catch {
+      failWriteValidation("patch must be a JSON object, or @path to a file holding one");
+    }
+    if (patch === null || typeof patch !== "object" || Array.isArray(patch)) {
+      failWriteValidation("patch must be a JSON object");
+    }
+    await run(
+      () => apiPost("/api/ads/chatgpt/draft/amend", {
+        chatId: requireChatId(),
+        ref: String(args.ref),
+        patch
+      })
+    );
+  }
+});
+var REMOVE_ARGS = { ref: { type: "positional", description: "Op ref or target id", required: true } };
+registerSchema({
+  command: "ads.chatgpt.draft.remove",
+  description: "Drop one staged ChatGPT Ads change. Removing a create also drops everything staged under it.",
+  args: schemaArgs(REMOVE_ARGS)
+});
+var removeCommand = defineCommand({
+  meta: {
+    name: "remove",
+    description: "Drop one staged change (and what depends on it). Example: baker ads chatgpt draft remove chatgpt_temp_ab12"
+  },
+  args: REMOVE_ARGS,
+  run: async ({ args }) => {
+    await run(
+      () => apiPost("/api/ads/chatgpt/draft/remove", {
+        chatId: requireChatId(),
+        ref: String(args.ref)
+      })
+    );
+  }
+});
+registerSchema({
+  command: "ads.chatgpt.draft.clear",
+  description: "Drop every staged ChatGPT Ads change on this chat. Nothing reached ChatGPT Ads, so nothing needs reversing.",
+  args: {}
+});
+var clearCommand = defineCommand({
+  meta: {
+    name: "clear",
+    description: "Drop every staged ChatGPT Ads change on this chat. Example: baker ads chatgpt draft clear"
+  },
+  args: {},
+  run: async () => {
+    await run(
+      () => apiPost("/api/ads/chatgpt/draft/clear", {
+        chatId: requireChatId()
+      })
+    );
+  }
+});
+var draftCommand = defineCommand({
+  meta: {
+    name: "draft",
+    description: `Review and edit the ChatGPT Ads changes staged on this chat.
+
+Nothing staged has reached ChatGPT Ads. Everything applies when the chat is
+published, and discarding the chat drops all of it.
+
+Examples:
+  baker ads chatgpt draft                               \u2014 the Campaign \u25B8 Ad group \u25B8 Ad tree
+  baker ads chatgpt draft show chatgpt_temp_ab12        \u2014 one change in full
+  baker ads chatgpt draft list --full                   \u2014 every change in full, in one call
+  baker ads chatgpt draft amend chatgpt_temp_ab12 '{"name":"New"}'
+  baker ads chatgpt draft remove chatgpt_temp_ab12
+  baker ads chatgpt draft clear`
+  },
+  subCommands: {
+    list: listCommand,
+    show: showCommand,
+    amend: amendCommand,
+    remove: removeCommand,
+    clear: clearCommand
+  },
+  // A parent must never declare `run`: citty falls through to it after the
+  // matched subcommand, so every edit would also print the whole draft.
+  args: LIST_ARGS,
+  default: "list"
+});
+export {
+  draftCommand
+};
+//# sourceMappingURL=draft-QCKJT7XQ.js.map