@koda-sl/baker-cli 0.534.0-dev.911a80433 → 0.535.0

package/dist/draft-3E352XHY.js

@@ -0,0 +1,335 @@
+import {
+  failWriteValidation
+} from "./chunk-A4T5JI75.js";
+import {
+  parseXApiError
+} from "./chunk-FIN4ZXGJ.js";
+import "./chunk-3FEOMQUT.js";
+import {
+  writeAdsJson,
+  writeJsonEnvelope
+} from "./chunk-SBFNGJ4C.js";
+import {
+  CHAT_READ_ARG
+} from "./chunk-PFBQERWX.js";
+import "./chunk-HVJJEQDQ.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-46YLDIQG.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-X6AHLUC7.js";
+import "./chunk-TM5UTSE4.js";
+import {
+  requireChatId,
+  resolveChatId
+} from "./chunk-6THXOWAP.js";
+import {
+  registerSchema
+} from "./chunk-S6WPMD3V.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/draft.ts
+import { readFileSync } from "fs";
+import { defineCommand } from "citty";
+
+// src/commands/ads/x/draft-status.ts
+var OPERATION_LABELS = {
+  create: "Creating",
+  update: "Updating",
+  pause: "Pausing",
+  resume: "Resuming",
+  remove: "Removing"
+};
+function badge(node) {
+  const label = node.operation ? OPERATION_LABELS[node.operation] : void 0;
+  return label ?? (node.existing ? "on X" : "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, showAccount, out) {
+  const indent = "  ".repeat(depth);
+  const account = showAccount ? ` [${node.accountId}]` : "";
+  out.push(`${indent}${node.entity}: ${node.name} \u2014 ${badge(node)}${account}`);
+  for (const collection of node.collections) {
+    const line = collectionLine(collection);
+    if (line) {
+      out.push(`${indent}  ${line}`);
+    }
+  }
+  for (const warning of node.warnings ?? []) {
+    out.push(`${indent}  ! ${warning}`);
+  }
+  for (const child of node.children) {
+    renderNode(child, depth + 1, showAccount, out);
+  }
+}
+var NO_CHANGES = "No X Ads changes staged";
+var STATUS_HEADINGS = {
+  active: "staged",
+  publishing: "publishing",
+  applied: "published",
+  discarded: "discarded"
+};
+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 `X Ads: ${draft.count} change${draft.count === 1 ? "" : "s"} ${heading}`;
+  }
+  const applied = draft.ops.filter(didApply).length;
+  const failed = draft.ops.filter(didNotApply).length;
+  return `X Ads: ${heading} \xB7 ${applied} applied${failed > 0 ? `, ${failed} failed` : ""}`;
+}
+function problemLines(draft) {
+  return draft.ops.filter(didNotApply).map((op) => {
+    const reason = op.result?.error ?? `skipped: waiting on ${op.result?.skippedBecause ?? "a change that did not apply"}`;
+    return `\u2717 ${op.summary} \u2014 failed: ${reason}`;
+  });
+}
+function renderDraftStatus(draft) {
+  if (draft.status === "none" || draft.count === 0) {
+    return NO_CHANGES;
+  }
+  const out = [headingLine(draft), ""];
+  const tree = draft.tree ?? [];
+  const showAccount = accountsInTree(tree).size > 1;
+  for (const node of tree) {
+    renderNode(node, 0, showAccount, out);
+  }
+  const problems = problemLines(draft);
+  if (problems.length > 0) {
+    out.push("", ...problems);
+  }
+  return out.join("\n");
+}
+
+// src/commands/ads/x/draft.ts
+function handleDraftError(err) {
+  if (err instanceof ApiError) {
+    writeAdsJson(parseXApiError(err.message, "\u2014"));
+    process.exit(1);
+  }
+  writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+  process.exit(1);
+}
+registerSchema({
+  command: "ads.x.draft",
+  description: "Review everything staged for X 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 op that did not land.",
+  args: {
+    json: { type: "boolean", description: "Raw JSON envelope instead of the readable tree", required: false },
+    chat: { type: "string", description: "Read another chat's draft instead of this one", required: false }
+  }
+});
+async function listDraft(json, chat) {
+  try {
+    const chatId = resolveChatId(chat);
+    const response = await apiPost("/api/ads/x/draft", { chatId });
+    if (json || !response.ok || !response.data) {
+      writeJsonEnvelope(response);
+      return;
+    }
+    process.stdout.write(`${renderDraftStatus(response.data)}
+`);
+  } catch (err) {
+    handleDraftError(err);
+  }
+}
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "Review everything staged as a Campaign \u25B8 Ad group \u25B8 Ad tree. Example: baker ads x 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);
+  }
+});
+registerSchema({
+  command: "ads.x.draft.show",
+  description: "The full staged payload, warnings and before-snapshot for one op \u2014 the receipt to check before publishing.",
+  args: {
+    ref: {
+      type: "positional",
+      description: "Op ref (x_temp_* for creates, the target id for updates)",
+      required: true
+    },
+    chat: { type: "string", description: "Read another chat's draft instead of this one", required: false }
+  }
+});
+var showCommand = defineCommand({
+  meta: {
+    name: "show",
+    description: "Show one staged op in full. Example: baker ads x draft show x_temp_abc123"
+  },
+  args: {
+    ref: { type: "positional", description: "Op ref, or the target id for a staged update", required: true },
+    chat: CHAT_READ_ARG
+  },
+  run: async ({ args }) => {
+    try {
+      const chatId = resolveChatId(args.chat);
+      const response = await apiPost("/api/ads/x/draft/show", {
+        chatId,
+        ref: String(args.ref)
+      });
+      writeJsonEnvelope(response);
+    } catch (err) {
+      handleDraftError(err);
+    }
+  }
+});
+registerSchema({
+  command: "ads.x.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) and the whole op re-validates.",
+  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 }
+  }
+});
+var amendCommand = defineCommand({
+  meta: {
+    name: "amend",
+    description: `Change a staged op in place.
+
+Example:
+  baker ads x draft amend x_temp_abc '{"dailyBudgetAmountLocalMicro": 20000000}'`
+  },
+  args: {
+    ref: { type: "positional", description: "Op ref or target id", required: true },
+    patch: { type: "positional", description: "JSON object, or @path to a file", required: true }
+  },
+  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");
+    }
+    try {
+      const chatId = requireChatId();
+      const response = await apiPost("/api/ads/x/draft/amend", {
+        chatId,
+        ref: String(args.ref),
+        patch
+      });
+      writeJsonEnvelope(response);
+    } catch (err) {
+      handleDraftError(err);
+    }
+  }
+});
+registerSchema({
+  command: "ads.x.draft.remove",
+  description: "Drop one staged X op. Removing a create cascades to everything staged that depends on it.",
+  args: { ref: { type: "positional", description: "Op ref or target id", required: true } }
+});
+var removeCommand = defineCommand({
+  meta: {
+    name: "remove",
+    description: "Drop one staged op (cascades to its dependents). Example: baker ads x draft remove x_temp_abc123"
+  },
+  args: { ref: { type: "positional", description: "Op ref or target id", required: true } },
+  run: async ({ args }) => {
+    try {
+      const chatId = requireChatId();
+      const response = await apiPost("/api/ads/x/draft/remove", {
+        chatId,
+        ref: String(args.ref)
+      });
+      writeJsonEnvelope(response);
+    } catch (err) {
+      handleDraftError(err);
+    }
+  }
+});
+registerSchema({
+  command: "ads.x.draft.clear",
+  description: "Drop every staged X op on this chat. Nothing reached X, so nothing needs reversing.",
+  args: {}
+});
+var clearCommand = defineCommand({
+  meta: { name: "clear", description: "Drop every staged X op on this chat. Example: baker ads x draft clear" },
+  args: {},
+  run: async () => {
+    try {
+      const chatId = requireChatId();
+      const response = await apiPost("/api/ads/x/draft/clear", { chatId });
+      writeJsonEnvelope(response);
+    } catch (err) {
+      handleDraftError(err);
+    }
+  }
+});
+var draftCommand = defineCommand({
+  meta: {
+    name: "draft",
+    description: `Review and edit the X Ads changes staged on this chat.
+
+Nothing staged has reached X. Everything applies when the chat is published,
+and discarding the chat reverses all of it.
+
+Examples:
+  baker ads x draft                       \u2014 the Campaign \u25B8 Ad group \u25B8 Ad tree
+  baker ads x draft show x_temp_abc123    \u2014 one op in full
+  baker ads x draft amend x_temp_abc '{"name":"New"}'
+  baker ads x draft remove x_temp_abc123
+  baker ads x 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 running
+  // the matched subcommand, so every edit would also trigger a full list.
+  args: { json: { type: "boolean", description: "Raw JSON envelope" }, chat: CHAT_READ_ARG },
+  default: "list"
+});
+export {
+  draftCommand
+};
+//# sourceMappingURL=draft-3E352XHY.js.map

package/dist/draft-4HU72A2M.js

@@ -0,0 +1,240 @@
+import {
+  handleMetaError
+} from "./chunk-6ZX3Q4X7.js";
+import {
+  hintLines
+} from "./chunk-D5FY4FAK.js";
+import "./chunk-QALAJNBG.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-SBFNGJ4C.js";
+import {
+  CHAT_READ_ARG
+} from "./chunk-PFBQERWX.js";
+import {
+  apiPost
+} from "./chunk-X6AHLUC7.js";
+import "./chunk-TM5UTSE4.js";
+import {
+  requireChatId,
+  resolveChatId
+} from "./chunk-6THXOWAP.js";
+import {
+  registerSchema
+} from "./chunk-S6WPMD3V.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/draft.ts
+import { defineCommand } from "citty";
+
+// src/commands/ads/meta/draft-status.ts
+var STATUS_HEADINGS = {
+  active: "staged",
+  publishing: "publishing",
+  applied: "published",
+  partial: "published with failures",
+  discarded: "discarded",
+  none: "none"
+};
+function plural(count, word) {
+  return `${count} ${word}${count === 1 ? "" : "s"}`;
+}
+function headingLine(draft) {
+  const heading = STATUS_HEADINGS[draft.status];
+  if (draft.status === "active" || draft.status === "discarded") {
+    return `Meta Ads \u2014 ${plural(draft.count, "change")} ${heading} \xB7 ${draft.mode}`;
+  }
+  const counts = /* @__PURE__ */ new Map();
+  for (const op of draft.ops) {
+    const status = op.result?.status ?? "pending";
+    counts.set(status, (counts.get(status) ?? 0) + 1);
+  }
+  const summary = [...counts].map(([status, count]) => `${count} ${status}`).join(", ");
+  return `Meta Ads \u2014 ${heading} \xB7 ${summary} \xB7 ${draft.mode}`;
+}
+function failedPart(result) {
+  const landed = result.landed ? ` (${result.landed})` : "";
+  return `\u2717 failed: ${result.error ?? "no reason recorded"}${landed}`;
+}
+function resultPart(op) {
+  const result = op.result;
+  if (!result) {
+    return void 0;
+  }
+  if (result.status === "failed") {
+    return failedPart(result);
+  }
+  if (result.status === "skipped") {
+    const because = result.skippedBecause;
+    if (because && op.dependsOn.includes(because)) {
+      return `\u2717 skipped: ${because} did not apply`;
+    }
+    return `\u2717 skipped: ${because ?? "a change it needs did not apply"}`;
+  }
+  const id = result.id ?? result.hash;
+  const applied = `\u2713 ${result.status}${id ? ` \u2192 ${id}` : ""}`;
+  const verification = result.verification;
+  if (verification && verification.status !== "confirmed") {
+    return `${applied} (read-back ${verification.status}${verification.note ? `: ${verification.note}` : ""})`;
+  }
+  return applied;
+}
+function opLine(op, showAccount) {
+  const parts = [op.ref, op.kind, op.summary];
+  if (op.target && op.target !== op.ref) {
+    parts.push(`target ${op.target}`);
+  }
+  if (showAccount) {
+    parts.push(`account ${op.accountId}`);
+  }
+  if (op.dependsOn.length > 0) {
+    parts.push(`after ${op.dependsOn.join(", ")}`);
+  }
+  const result = resultPart(op);
+  if (result) {
+    parts.push(result);
+  }
+  return `  ${parts.join(" \xB7 ").replace(/[\r\n]+/g, " ")}`;
+}
+function renderDraftStatus(draft) {
+  if (draft.status === "none" || draft.count === 0) {
+    return "No staged Meta changes on this chat.";
+  }
+  const lines = [headingLine(draft)];
+  if (draft.status === "active") {
+    lines.push("Publishing makes every change real on the ad account.");
+  }
+  lines.push("");
+  const showAccount = new Set(draft.ops.map((op) => op.accountId)).size > 1;
+  for (const op of draft.ops) {
+    lines.push(opLine(op, showAccount));
+  }
+  if (draft.advisories.length > 0) {
+    lines.push("", "Advisories");
+    for (const advisory of draft.advisories) {
+      lines.push(`  ! ${advisory.ref}: ${advisory.message}`);
+    }
+  }
+  lines.push("", "Full staged payload for one op: baker ads meta draft show <ref> \xB7 raw envelope: --json");
+  return lines.join("\n");
+}
+
+// src/commands/ads/meta/draft.ts
+registerSchema({
+  command: "ads.meta.draft",
+  description: "Review every Meta op staged on this chat, one line each: ref \xB7 kind \xB7 summary \xB7 what it waits on, and after a publish \u2713 applied \u2192 id or \u2717 failed: <error>. `draft show <ref>` prints one op's full payload.",
+  args: {
+    json: { type: "boolean", description: "Raw JSON envelope instead of the readable list", required: false },
+    chat: { type: "string", description: "Read another chat's draft instead of this one", required: false }
+  }
+});
+async function listDraft(json, chat) {
+  try {
+    const chatId = resolveChatId(chat);
+    const response = await apiPost("/api/ads/meta/draft", { chatId });
+    if (json || !response.ok || !response.data) {
+      writeJsonEnvelope(response);
+      return;
+    }
+    process.stdout.write(`${renderDraftStatus(response.data)}${hintLines(response)}
+`);
+  } catch (err) {
+    handleMetaError(err);
+  }
+}
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "Show every Meta write op staged in this chat, one line each (ref \xB7 kind \xB7 summary \xB7 dependencies \xB7 post-publish result); --json for the raw envelope. Publishing reaches the real ad account, so review this before you finish. Example: baker ads meta draft"
+  },
+  args: {
+    json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable list" },
+    chat: CHAT_READ_ARG
+  },
+  run: async ({ args }) => {
+    await listDraft(args.json === true, args.chat);
+  }
+});
+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). Example: baker ads meta draft show meta_temp_abc123"
+  },
+  args: {
+    ref: { type: "positional", description: "Op ref (meta_temp_* for creates, target id for updates)", required: true },
+    // `show` always prints the envelope; `--json` is the spelling `list` taught, so it is accepted here too.
+    json: { type: "boolean", description: "Accepted for symmetry with list; show always prints the JSON envelope" },
+    chat: CHAT_READ_ARG
+  },
+  run: async ({ args }) => {
+    try {
+      const chatId = resolveChatId(args.chat);
+      const response = await apiPost("/api/ads/meta/draft/show", {
+        chatId,
+        ref: args.ref
+      });
+      writeJsonEnvelope(response);
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+var removeCommand = defineCommand({
+  meta: {
+    name: "remove",
+    description: "Drop one staged Meta op. Removing a create cascades to everything that depends on it. Example: baker ads meta draft remove meta_temp_abc123"
+  },
+  args: {
+    ref: { type: "positional", description: "Op ref (meta_temp_* for creates, target id for updates)", required: true }
+  },
+  run: async ({ args }) => {
+    try {
+      const chatId = requireChatId();
+      const response = await apiPost("/api/ads/meta/draft/remove", {
+        chatId,
+        ref: args.ref
+      });
+      writeJsonEnvelope(response);
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+var clearCommand = defineCommand({
+  meta: {
+    name: "clear",
+    description: "Discard ALL staged Meta ops in this chat's draft \u2014 nothing will apply on publish. Example: baker ads meta draft clear"
+  },
+  run: async () => {
+    try {
+      const chatId = requireChatId();
+      const response = await apiPost("/api/ads/meta/draft/clear", {
+        chatId
+      });
+      writeJsonEnvelope(response);
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+var metaDraftCommand = defineCommand({
+  meta: {
+    name: "draft",
+    description: "Review and edit the Meta write ops staged in this chat BEFORE publish. Subcommands: list (default), show, remove, clear. Ops never hit Meta 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: {
+    json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable list" },
+    chat: CHAT_READ_ARG
+  },
+  subCommands: { list: listCommand, show: showCommand, remove: removeCommand, clear: clearCommand },
+  // `default` (not `run`) dispatches the bare invocation: citty falls through to `run`
+  // after dispatching a subcommand, so a `run` here would list the draft a second time
+  // on every `draft list` / `draft remove` / `draft clear`.
+  default: "list"
+});
+export {
+  metaDraftCommand
+};
+//# sourceMappingURL=draft-4HU72A2M.js.map