@koda-sl/baker-cli 0.513.0 → 0.514.0

package/dist/draft-TRPQCJ4B.js

@@ -0,0 +1,335 @@
+import {
+  failWriteValidation
+} from "./chunk-OR6KVLI5.js";
+import {
+  parseXApiError
+} from "./chunk-FIN4ZXGJ.js";
+import "./chunk-7NF73SCB.js";
+import {
+  writeAdsJson,
+  writeJsonEnvelope
+} from "./chunk-ZRP7Y2DM.js";
+import {
+  CHAT_READ_ARG
+} from "./chunk-PFBQERWX.js";
+import "./chunk-PC3FJEZH.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-46YLDIQG.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import {
+  requireChatId,
+  resolveChatId
+} from "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.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-TRPQCJ4B.js.map

package/dist/draft-TRPQCJ4B.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/x/draft.ts","../src/commands/ads/x/draft-status.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport type {\n  XDraftClearResponse,\n  XDraftListResponse,\n  XDraftRemoveResponse,\n  XDraftShowResponse,\n  XDraftStageResponse,\n} from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../../client.ts\";\nimport { requireChatId, resolveChatId } from \"../../../env.ts\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { CHAT_READ_ARG } from \"../../chat-arg.ts\";\nimport { writeAdsJson, writeJsonEnvelope } from \"../output.ts\";\nimport { renderDraftStatus } from \"./draft-status.ts\";\nimport { parseXApiError } from \"./error-parser.ts\";\nimport { failWriteValidation } from \"./write-shared.ts\";\n\nfunction handleDraftError(err: unknown): never {\n  if (err instanceof ApiError) {\n    writeAdsJson(parseXApiError(err.message, \"—\"));\n    process.exit(1);\n  }\n  writeAdsJson({ ok: false, error: { code: \"NETWORK_ERROR\", message: \"Unexpected error\" } });\n  process.exit(1);\n}\n\nregisterSchema({\n  command: \"ads.x.draft\",\n  description:\n    \"Review everything staged for X Ads on this chat as a Campaign ▸ Ad group ▸ Ad tree. After a publish this is the authoritative record: `published · N applied`, or a `✗ … failed:` line per op that did not land.\",\n  args: {\n    json: { type: \"boolean\", description: \"Raw JSON envelope instead of the readable tree\", required: false },\n    chat: { type: \"string\", description: \"Read another chat's draft instead of this one\", required: false },\n  },\n});\n\nasync function listDraft(json: boolean, chat?: unknown): Promise<void> {\n  try {\n    const chatId = resolveChatId(chat);\n    const response = await apiPost<{ ok: boolean; data?: XDraftListResponse }>(\"/api/ads/x/draft\", { chatId });\n    if (json || !response.ok || !response.data) {\n      writeJsonEnvelope(response);\n      return;\n    }\n    process.stdout.write(`${renderDraftStatus(response.data)}\\n`);\n  } catch (err) {\n    handleDraftError(err);\n  }\n}\n\nconst listCommand = defineCommand({\n  meta: {\n    name: \"list\",\n    description: \"Review everything staged as a Campaign ▸ Ad group ▸ Ad tree. Example: baker ads x draft\",\n  },\n  args: {\n    json: { type: \"boolean\", description: \"Print the raw JSON envelope instead of the readable tree\" },\n    chat: CHAT_READ_ARG,\n  },\n  run: async ({ args }) => {\n    await listDraft(args.json === true, args.chat);\n  },\n});\n\nregisterSchema({\n  command: \"ads.x.draft.show\",\n  description:\n    \"The full staged payload, warnings and before-snapshot for one op — the receipt to check before publishing.\",\n  args: {\n    ref: {\n      type: \"positional\",\n      description: \"Op ref (x_temp_* for creates, the target id for updates)\",\n      required: true,\n    },\n    chat: { type: \"string\", description: \"Read another chat's draft instead of this one\", required: false },\n  },\n});\n\nconst showCommand = defineCommand({\n  meta: {\n    name: \"show\",\n    description: \"Show one staged op in full. Example: baker ads x draft show x_temp_abc123\",\n  },\n  args: {\n    ref: { type: \"positional\", description: \"Op ref, or the target id for a staged update\", required: true },\n    chat: CHAT_READ_ARG,\n  },\n  run: async ({ args }) => {\n    try {\n      const chatId = resolveChatId(args.chat);\n      const response = await apiPost<{ ok: boolean; data?: XDraftShowResponse }>(\"/api/ads/x/draft/show\", {\n        chatId,\n        ref: String(args.ref),\n      });\n      writeJsonEnvelope(response);\n    } catch (err) {\n      handleDraftError(err);\n    }\n  },\n});\n\nregisterSchema({\n  command: \"ads.x.draft.amend\",\n  description:\n    \"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.\",\n  args: {\n    ref: { type: \"positional\", description: \"Op ref or target id\", required: true },\n    patch: { type: \"positional\", description: \"JSON object, or @path to a file holding one\", required: true },\n  },\n});\n\nconst amendCommand = defineCommand({\n  meta: {\n    name: \"amend\",\n    description: `Change a staged op in place.\n\nExample:\n  baker ads x draft amend x_temp_abc '{\"dailyBudgetAmountLocalMicro\": 20000000}'`,\n  },\n  args: {\n    ref: { type: \"positional\", description: \"Op ref or target id\", required: true },\n    patch: { type: \"positional\", description: \"JSON object, or @path to a file\", required: true },\n  },\n  run: async ({ args }) => {\n    const raw = String(args.patch);\n    let patch: unknown;\n    try {\n      patch = JSON.parse(raw.startsWith(\"@\") ? readFileSync(raw.slice(1), \"utf8\") : raw);\n    } catch {\n      failWriteValidation(\"patch must be a JSON object, or @path to a file holding one\");\n    }\n    if (patch === null || typeof patch !== \"object\" || Array.isArray(patch)) {\n      failWriteValidation(\"patch must be a JSON object\");\n    }\n    try {\n      const chatId = requireChatId();\n      const response = await apiPost<{ ok: boolean; data?: XDraftStageResponse }>(\"/api/ads/x/draft/amend\", {\n        chatId,\n        ref: String(args.ref),\n        patch,\n      });\n      writeJsonEnvelope(response);\n    } catch (err) {\n      handleDraftError(err);\n    }\n  },\n});\n\nregisterSchema({\n  command: \"ads.x.draft.remove\",\n  description: \"Drop one staged X op. Removing a create cascades to everything staged that depends on it.\",\n  args: { ref: { type: \"positional\", description: \"Op ref or target id\", required: true } },\n});\n\nconst removeCommand = defineCommand({\n  meta: {\n    name: \"remove\",\n    description: \"Drop one staged op (cascades to its dependents). Example: baker ads x draft remove x_temp_abc123\",\n  },\n  args: { ref: { type: \"positional\", description: \"Op ref or target id\", required: true } },\n  run: async ({ args }) => {\n    try {\n      const chatId = requireChatId();\n      const response = await apiPost<{ ok: boolean; data?: XDraftRemoveResponse }>(\"/api/ads/x/draft/remove\", {\n        chatId,\n        ref: String(args.ref),\n      });\n      writeJsonEnvelope(response);\n    } catch (err) {\n      handleDraftError(err);\n    }\n  },\n});\n\nregisterSchema({\n  command: \"ads.x.draft.clear\",\n  description: \"Drop every staged X op on this chat. Nothing reached X, so nothing needs reversing.\",\n  args: {},\n});\n\nconst clearCommand = defineCommand({\n  meta: { name: \"clear\", description: \"Drop every staged X op on this chat. Example: baker ads x draft clear\" },\n  args: {},\n  run: async () => {\n    try {\n      const chatId = requireChatId();\n      const response = await apiPost<{ ok: boolean; data?: XDraftClearResponse }>(\"/api/ads/x/draft/clear\", { chatId });\n      writeJsonEnvelope(response);\n    } catch (err) {\n      handleDraftError(err);\n    }\n  },\n});\n\nexport const draftCommand = defineCommand({\n  meta: {\n    name: \"draft\",\n    description: `Review and edit the X Ads changes staged on this chat.\n\nNothing staged has reached X. Everything applies when the chat is published,\nand discarding the chat reverses all of it.\n\nExamples:\n  baker ads x draft                       — the Campaign ▸ Ad group ▸ Ad tree\n  baker ads x draft show x_temp_abc123    — one op in full\n  baker ads x draft amend x_temp_abc '{\"name\":\"New\"}'\n  baker ads x draft remove x_temp_abc123\n  baker ads x draft clear`,\n  },\n  subCommands: {\n    list: listCommand,\n    show: showCommand,\n    amend: amendCommand,\n    remove: removeCommand,\n    clear: clearCommand,\n  },\n  // A parent must never declare `run`: citty falls through to it AFTER running\n  // the matched subcommand, so every edit would also trigger a full list.\n  args: { json: { type: \"boolean\", description: \"Raw JSON envelope\" }, chat: CHAT_READ_ARG },\n  default: \"list\",\n});\n","import type { XDraftListResponse, XDraftOpView, XDraftStatusCollection, XDraftStatusNode } from \"@baker/api\";\n\n/**\n * Render the staged X draft as a readable Campaign ▸ Ad group ▸ Ad tree — the\n * counterpart to the Google and LinkedIn renderers, using the identical node\n * shape. Pure: takes the draft-list response, returns text.\n */\n\nconst OPERATION_LABELS: Record<string, string> = {\n  create: \"Creating\",\n  update: \"Updating\",\n  pause: \"Pausing\",\n  resume: \"Resuming\",\n  remove: \"Removing\",\n};\n\nfunction badge(node: XDraftStatusNode): string {\n  const label = node.operation ? OPERATION_LABELS[node.operation] : undefined;\n  return label ?? (node.existing ? \"on X\" : \"staged\");\n}\n\nfunction collectionLine(collection: XDraftStatusCollection): string | undefined {\n  const parts: string[] = [];\n  if (collection.added > 0) {\n    parts.push(`+${collection.added}`);\n  }\n  if (collection.existing > 0) {\n    parts.push(`${collection.existing} existing`);\n  }\n  if (collection.removed > 0) {\n    parts.push(`-${collection.removed}`);\n  }\n  return parts.length > 0 ? `${collection.label}: ${parts.join(\", \")}` : undefined;\n}\n\n/**\n * Every ad account the tree touches. A draft may span several, and two accounts\n * can hold identically-named campaigns — so the account is printed on each node\n * once there is more than one, and left off when there is not.\n */\nfunction accountsInTree(nodes: readonly XDraftStatusNode[]): Set<string> {\n  const accounts = new Set<string>();\n  const walk = (node: XDraftStatusNode): void => {\n    accounts.add(node.accountId);\n    for (const child of node.children) {\n      walk(child);\n    }\n  };\n  for (const node of nodes) {\n    walk(node);\n  }\n  return accounts;\n}\n\nfunction renderNode(node: XDraftStatusNode, depth: number, showAccount: boolean, out: string[]): void {\n  const indent = \"  \".repeat(depth);\n  const account = showAccount ? ` [${node.accountId}]` : \"\";\n  out.push(`${indent}${node.entity}: ${node.name} — ${badge(node)}${account}`);\n  for (const collection of node.collections) {\n    const line = collectionLine(collection);\n    if (line) {\n      out.push(`${indent}  ${line}`);\n    }\n  }\n  for (const warning of node.warnings ?? []) {\n    out.push(`${indent}  ! ${warning}`);\n  }\n  for (const child of node.children) {\n    renderNode(child, depth + 1, showAccount, out);\n  }\n}\n\nconst NO_CHANGES = \"No X Ads changes staged\";\n\nconst STATUS_HEADINGS: Record<string, string> = {\n  active: \"staged\",\n  publishing: \"publishing\",\n  applied: \"published\",\n  discarded: \"discarded\",\n};\n\nfunction didNotApply(op: XDraftOpView): boolean {\n  return op.result?.status === \"failed\" || op.result?.status === \"skipped\";\n}\n\nfunction didApply(op: XDraftOpView): boolean {\n  return op.result?.status === \"applied\" || op.result?.status === \"simulated\";\n}\n\n/**\n * The outcome line, which is the authoritative record after a publish: a draft\n * still reading `publishing` minutes later did not finish, whatever X shows.\n */\nfunction headingLine(draft: XDraftListResponse): string {\n  const heading = STATUS_HEADINGS[draft.status] ?? draft.status;\n  if (draft.status !== \"applied\" && draft.status !== \"publishing\") {\n    return `X Ads: ${draft.count} change${draft.count === 1 ? \"\" : \"s\"} ${heading}`;\n  }\n  const applied = draft.ops.filter(didApply).length;\n  const failed = draft.ops.filter(didNotApply).length;\n  return `X Ads: ${heading} · ${applied} applied${failed > 0 ? `, ${failed} failed` : \"\"}`;\n}\n\nfunction problemLines(draft: XDraftListResponse): string[] {\n  return draft.ops.filter(didNotApply).map((op) => {\n    const reason =\n      op.result?.error ?? `skipped: waiting on ${op.result?.skippedBecause ?? \"a change that did not apply\"}`;\n    return `✗ ${op.summary} — failed: ${reason}`;\n  });\n}\n\nexport function renderDraftStatus(draft: XDraftListResponse): string {\n  if (draft.status === \"none\" || draft.count === 0) {\n    return NO_CHANGES;\n  }\n  const out: string[] = [headingLine(draft), \"\"];\n  const tree = draft.tree ?? [];\n  const showAccount = accountsInTree(tree).size > 1;\n  for (const node of tree) {\n    renderNode(node, 0, showAccount, out);\n  }\n  const problems = problemLines(draft);\n  if (problems.length > 0) {\n    out.push(\"\", ...problems);\n  }\n  return out.join(\"\\n\");\n}\n"],"mappings":"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","names":[]}

package/dist/experiments-4V242DG2.js

@@ -0,0 +1,236 @@
+import {
+  bareAccountId,
+  failWriteValidation,
+  parseDateFlag,
+  requireTarget,
+  stageOp
+} from "./chunk-BX6B25KK.js";
+import {
+  handleLinkedinError
+} from "./chunk-IRM273C7.js";
+import "./chunk-SCAGMX2I.js";
+import "./chunk-4NZ47VXO.js";
+import "./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 "./chunk-PC3FJEZH.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-46YLDIQG.js";
+import {
+  apiGet
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/experiments.ts
+import { defineCommand } from "citty";
+var STAGED_NOTE = "Staged until publish \u2014 review with `baker ads linkedin draft`.";
+var accountArgs = {
+  "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+  "account-urn": { type: "string", description: "Alias for --account-id" }
+};
+var STOP_AT = {
+  "end-date": "AUTO_STOP_AT_END_DATE",
+  winner: "AUTO_STOP_AT_WINNER",
+  never: "AUTO_STOP_DISABLED"
+};
+function stopAtArg(value) {
+  if (value === void 0) {
+    return void 0;
+  }
+  const mapped = STOP_AT[String(value)];
+  if (!mapped) {
+    failWriteValidation(`--stop-at must be one of ${Object.keys(STOP_AT).join("|")}`);
+  }
+  return mapped;
+}
+function numberArg(value, flag) {
+  if (value === void 0) {
+    return void 0;
+  }
+  const parsed = Number(value);
+  if (!Number.isInteger(parsed)) {
+    failWriteValidation(`${flag} must be a whole number`);
+  }
+  return parsed;
+}
+var experimentsListCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List the ad account's A/B tests, newest first: name, state (what was asked), running (what LinkedIn is doing: PENDING|RUNNING|ON_HOLD|STOPPED|ENDED), metric, dates and the two versions (ad sets + traffic split). Runs by default."
+  },
+  args: { ...accountArgs },
+  run: async ({ args }) => {
+    try {
+      const data = await apiGet("/api/ads/linkedin/experiments", {
+        "account-id": bareAccountId(args)
+      });
+      writeJsonEnvelope({ ok: true, data });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var experimentsGetCommand = defineCommand({
+  meta: {
+    name: "get",
+    description: "One A/B test with LinkedIn's setup checks (an ERROR keeps it from running \u2014 e.g. NO_ACTIVE_CREATIVES; a WARNING may skew it) and its latest result: the winning version, p-value, and each version's confidence interval for the metric. `result: null` until LinkedIn computes the first one (daily)."
+  },
+  args: {
+    id: { type: "positional", description: "A/B test id from `experiments`", required: true },
+    ...accountArgs
+  },
+  run: async ({ args }) => {
+    try {
+      const data = await apiGet("/api/ads/linkedin/experiments", {
+        "account-id": bareAccountId(args),
+        id: requireTarget(args, "A/B test")
+      });
+      writeJsonEnvelope({ ok: true, data });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var experimentsCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage an A/B test between two ad sets of the SAME campaign: LinkedIn splits the audience so each member sees only one version, and calls a winner on the metric. ${STAGED_NOTE}
+Rules LinkedIn enforces: exactly 2 ad sets, same campaign, that campaign must NOT share its budget across ad sets, at most 90 days, confidence 51\u201399 (90+ recommended), each ad set needs an active ad. Best practice: two new ad sets identical but for the one thing tested, equal budgets, 3+ weeks.
+Examples:
+  baker ads linkedin experiments create --name "Image vs video" --version-a li_temp_x1 --version-b li_temp_x2 --metric CPC --start 2026-11-01 --end 2026-11-28
+  baker ads linkedin experiments create --name "Headline test" --version-a 896802423 --name-a "Pain" --version-b 896812053 --name-b "Gain" --metric CPM --start 2026-11-01 --end 2026-12-01 --stop-at winner --confidence 95`
+  },
+  args: {
+    ...accountArgs,
+    name: { type: "string", description: "Test name (\u2264100)", required: true },
+    description: { type: "string", description: "What is being tested" },
+    "version-a": { type: "string", description: "Ad set id/URN or li_temp_* ref for version A", required: true },
+    "version-b": { type: "string", description: "Ad set id/URN or li_temp_* ref for version B", required: true },
+    "name-a": { type: "string", description: "Version A label (default A)" },
+    "name-b": { type: "string", description: "Version B label (default B)" },
+    "weight-a": { type: "string", description: "Version A share of the audience, 1\u201399 (default 50; B gets the rest)" },
+    metric: { type: "string", description: "CPC|CPM|CPV (video ad sets)|CPMS (message ads)", required: true },
+    confidence: { type: "string", description: "51\u201399 (default 90)" },
+    start: { type: "string", description: "Start date (ISO or epoch ms)", required: true },
+    end: { type: "string", description: "End date (\u226490 days after start)", required: true },
+    "stop-at": {
+      type: "string",
+      description: "end-date (default, pauses both) | winner | never (ad sets keep running)"
+    },
+    draft: { type: "boolean", description: "Create it set up but not running" }
+  },
+  run: async ({ args }) => {
+    const weightA = numberArg(args["weight-a"], "--weight-a") ?? 50;
+    await stageOp({
+      kind: "experiment.create",
+      accountId: bareAccountId(args),
+      payload: {
+        name: args.name,
+        description: args.description,
+        keyMetric: args.metric ? String(args.metric).toUpperCase() : void 0,
+        confidence: numberArg(args.confidence, "--confidence"),
+        start: parseDateFlag(args.start, "--start"),
+        end: parseDateFlag(args.end, "--end"),
+        autoStop: stopAtArg(args["stop-at"]),
+        state: args.draft ? "DRAFT" : void 0,
+        cells: [
+          { name: args["name-a"] ?? "A", campaign: args["version-a"], trafficWeight: weightA },
+          { name: args["name-b"] ?? "B", campaign: args["version-b"], trafficWeight: 100 - weightA }
+        ]
+      }
+    });
+  }
+});
+var experimentsUpdateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: `Stage changes to an A/B test. Once it has started only the name, description, end date (still \u226490 days from start), confidence and when it stops can change \u2014 the versions are fixed. ${STAGED_NOTE}
+Example: baker ads linkedin experiments update 5633011 --end 2026-12-15 --stop-at winner`
+  },
+  args: {
+    id: { type: "positional", description: "A/B test id", required: true },
+    ...accountArgs,
+    name: { type: "string", description: "New name" },
+    description: { type: "string", description: "New description" },
+    end: { type: "string", description: "New end date" },
+    confidence: { type: "string", description: "51\u201399" },
+    "stop-at": { type: "string", description: "end-date|winner|never" }
+  },
+  run: async ({ args }) => {
+    await stageOp({
+      kind: "experiment.update",
+      accountId: bareAccountId(args),
+      target: requireTarget(args, "A/B test"),
+      payload: {
+        name: args.name,
+        description: args.description,
+        end: parseDateFlag(args.end, "--end"),
+        confidence: numberArg(args.confidence, "--confidence"),
+        autoStop: stopAtArg(args["stop-at"])
+      }
+    });
+  }
+});
+function experimentStateCommand(name, state, what) {
+  return defineCommand({
+    meta: {
+      name,
+      description: `Stage ${what}. ${STAGED_NOTE}
+Example: baker ads linkedin experiments ${name} 5633011`
+    },
+    args: {
+      id: { type: "positional", description: "A/B test id", required: true },
+      ...accountArgs
+    },
+    run: async ({ args }) => {
+      await stageOp({
+        kind: "experiment.update",
+        accountId: bareAccountId(args),
+        target: requireTarget(args, "A/B test"),
+        payload: { state }
+      });
+    }
+  });
+}
+var experimentsCommand = defineCommand({
+  meta: {
+    name: "experiments",
+    description: `LinkedIn A/B tests: two ad sets of one campaign shown to separate halves of the audience, with a winner called on CPC/CPM/CPV/CPMS.
+Examples:
+  baker ads linkedin experiments                       # list
+  baker ads linkedin experiments get 5633011           # setup checks + result
+  baker ads linkedin experiments create --name "Image vs video" --version-a <ad set> --version-b <ad set> --metric CPC --start 2026-11-01 --end 2026-11-28
+  baker ads linkedin experiments pause|start|end 5633011`
+  },
+  subCommands: {
+    list: experimentsListCommand,
+    get: experimentsGetCommand,
+    create: experimentsCreateCommand,
+    update: experimentsUpdateCommand,
+    start: experimentStateCommand("start", "ACTIVE", "starting (or resuming) an A/B test"),
+    pause: experimentStateCommand("pause", "PAUSED", "pausing an A/B test \u2014 both ad sets pause, the end date stays"),
+    end: experimentStateCommand("end", "CANCELED", "ending an A/B test for good")
+  },
+  args: { ...accountArgs },
+  default: "list"
+});
+export {
+  experimentsCommand
+};
+//# sourceMappingURL=experiments-4V242DG2.js.map

package/dist/experiments-4V242DG2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/linkedin/experiments.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { apiGet } from \"../../../client.ts\";\nimport { writeJsonEnvelope } from \"../output.ts\";\nimport { handleLinkedinError } from \"./shared.ts\";\nimport { bareAccountId, failWriteValidation, parseDateFlag, requireTarget, stageOp } from \"./write-shared.ts\";\n\nconst STAGED_NOTE = \"Staged until publish — review with `baker ads linkedin draft`.\";\n\nconst accountArgs = {\n  \"account-id\": { type: \"string\", description: \"Numeric account ID or urn:li:sponsoredAccount:N\" },\n  \"account-urn\": { type: \"string\", description: \"Alias for --account-id\" },\n} as const;\n\nconst STOP_AT: Record<string, string> = {\n  \"end-date\": \"AUTO_STOP_AT_END_DATE\",\n  winner: \"AUTO_STOP_AT_WINNER\",\n  never: \"AUTO_STOP_DISABLED\",\n};\n\nfunction stopAtArg(value: unknown): string | undefined {\n  if (value === undefined) {\n    return undefined;\n  }\n  const mapped = STOP_AT[String(value)];\n  if (!mapped) {\n    failWriteValidation(`--stop-at must be one of ${Object.keys(STOP_AT).join(\"|\")}`);\n  }\n  return mapped;\n}\n\nfunction numberArg(value: unknown, flag: string): number | undefined {\n  if (value === undefined) {\n    return undefined;\n  }\n  const parsed = Number(value);\n  if (!Number.isInteger(parsed)) {\n    failWriteValidation(`${flag} must be a whole number`);\n  }\n  return parsed;\n}\n\nconst experimentsListCommand = defineCommand({\n  meta: {\n    name: \"list\",\n    description:\n      \"List the ad account's A/B tests, newest first: name, state (what was asked), running (what LinkedIn is doing: PENDING|RUNNING|ON_HOLD|STOPPED|ENDED), metric, dates and the two versions (ad sets + traffic split). Runs by default.\",\n  },\n  args: { ...accountArgs },\n  run: async ({ args }) => {\n    try {\n      const data = await apiGet<unknown[]>(\"/api/ads/linkedin/experiments\", {\n        \"account-id\": bareAccountId(args as Record<string, unknown>),\n      });\n      writeJsonEnvelope({ ok: true, data });\n    } catch (err) {\n      handleLinkedinError(err);\n    }\n  },\n});\n\nconst experimentsGetCommand = defineCommand({\n  meta: {\n    name: \"get\",\n    description:\n      \"One A/B test with LinkedIn's setup checks (an ERROR keeps it from running — e.g. NO_ACTIVE_CREATIVES; a WARNING may skew it) and its latest result: the winning version, p-value, and each version's confidence interval for the metric. `result: null` until LinkedIn computes the first one (daily).\",\n  },\n  args: {\n    id: { type: \"positional\", description: \"A/B test id from `experiments`\", required: true },\n    ...accountArgs,\n  },\n  run: async ({ args }) => {\n    try {\n      const data = await apiGet<unknown>(\"/api/ads/linkedin/experiments\", {\n        \"account-id\": bareAccountId(args as Record<string, unknown>),\n        id: requireTarget(args as Record<string, unknown>, \"A/B test\"),\n      });\n      writeJsonEnvelope({ ok: true, data });\n    } catch (err) {\n      handleLinkedinError(err);\n    }\n  },\n});\n\nconst experimentsCreateCommand = defineCommand({\n  meta: {\n    name: \"create\",\n    description: `Stage an A/B test between two ad sets of the SAME campaign: LinkedIn splits the audience so each member sees only one version, and calls a winner on the metric. ${STAGED_NOTE}\nRules LinkedIn enforces: exactly 2 ad sets, same campaign, that campaign must NOT share its budget across ad sets, at most 90 days, confidence 51–99 (90+ recommended), each ad set needs an active ad. Best practice: two new ad sets identical but for the one thing tested, equal budgets, 3+ weeks.\nExamples:\n  baker ads linkedin experiments create --name \"Image vs video\" --version-a li_temp_x1 --version-b li_temp_x2 --metric CPC --start 2026-11-01 --end 2026-11-28\n  baker ads linkedin experiments create --name \"Headline test\" --version-a 896802423 --name-a \"Pain\" --version-b 896812053 --name-b \"Gain\" --metric CPM --start 2026-11-01 --end 2026-12-01 --stop-at winner --confidence 95`,\n  },\n  args: {\n    ...accountArgs,\n    name: { type: \"string\", description: \"Test name (≤100)\", required: true },\n    description: { type: \"string\", description: \"What is being tested\" },\n    \"version-a\": { type: \"string\", description: \"Ad set id/URN or li_temp_* ref for version A\", required: true },\n    \"version-b\": { type: \"string\", description: \"Ad set id/URN or li_temp_* ref for version B\", required: true },\n    \"name-a\": { type: \"string\", description: \"Version A label (default A)\" },\n    \"name-b\": { type: \"string\", description: \"Version B label (default B)\" },\n    \"weight-a\": { type: \"string\", description: \"Version A share of the audience, 1–99 (default 50; B gets the rest)\" },\n    metric: { type: \"string\", description: \"CPC|CPM|CPV (video ad sets)|CPMS (message ads)\", required: true },\n    confidence: { type: \"string\", description: \"51–99 (default 90)\" },\n    start: { type: \"string\", description: \"Start date (ISO or epoch ms)\", required: true },\n    end: { type: \"string\", description: \"End date (≤90 days after start)\", required: true },\n    \"stop-at\": {\n      type: \"string\",\n      description: \"end-date (default, pauses both) | winner | never (ad sets keep running)\",\n    },\n    draft: { type: \"boolean\", description: \"Create it set up but not running\" },\n  },\n  run: async ({ args }) => {\n    const weightA = numberArg(args[\"weight-a\"], \"--weight-a\") ?? 50;\n    await stageOp({\n      kind: \"experiment.create\",\n      accountId: bareAccountId(args as Record<string, unknown>),\n      payload: {\n        name: args.name,\n        description: args.description,\n        keyMetric: args.metric ? String(args.metric).toUpperCase() : undefined,\n        confidence: numberArg(args.confidence, \"--confidence\"),\n        start: parseDateFlag(args.start, \"--start\"),\n        end: parseDateFlag(args.end, \"--end\"),\n        autoStop: stopAtArg(args[\"stop-at\"]),\n        state: args.draft ? \"DRAFT\" : undefined,\n        cells: [\n          { name: args[\"name-a\"] ?? \"A\", campaign: args[\"version-a\"], trafficWeight: weightA },\n          { name: args[\"name-b\"] ?? \"B\", campaign: args[\"version-b\"], trafficWeight: 100 - weightA },\n        ],\n      },\n    });\n  },\n});\n\nconst experimentsUpdateCommand = defineCommand({\n  meta: {\n    name: \"update\",\n    description: `Stage changes to an A/B test. Once it has started only the name, description, end date (still ≤90 days from start), confidence and when it stops can change — the versions are fixed. ${STAGED_NOTE}\nExample: baker ads linkedin experiments update 5633011 --end 2026-12-15 --stop-at winner`,\n  },\n  args: {\n    id: { type: \"positional\", description: \"A/B test id\", required: true },\n    ...accountArgs,\n    name: { type: \"string\", description: \"New name\" },\n    description: { type: \"string\", description: \"New description\" },\n    end: { type: \"string\", description: \"New end date\" },\n    confidence: { type: \"string\", description: \"51–99\" },\n    \"stop-at\": { type: \"string\", description: \"end-date|winner|never\" },\n  },\n  run: async ({ args }) => {\n    await stageOp({\n      kind: \"experiment.update\",\n      accountId: bareAccountId(args as Record<string, unknown>),\n      target: requireTarget(args as Record<string, unknown>, \"A/B test\"),\n      payload: {\n        name: args.name,\n        description: args.description,\n        end: parseDateFlag(args.end, \"--end\"),\n        confidence: numberArg(args.confidence, \"--confidence\"),\n        autoStop: stopAtArg(args[\"stop-at\"]),\n      },\n    });\n  },\n});\n\nfunction experimentStateCommand(\n  name: \"start\" | \"pause\" | \"end\",\n  state: \"ACTIVE\" | \"PAUSED\" | \"CANCELED\",\n  what: string,\n) {\n  return defineCommand({\n    meta: {\n      name,\n      description: `Stage ${what}. ${STAGED_NOTE}\nExample: baker ads linkedin experiments ${name} 5633011`,\n    },\n    args: {\n      id: { type: \"positional\", description: \"A/B test id\", required: true },\n      ...accountArgs,\n    },\n    run: async ({ args }) => {\n      await stageOp({\n        kind: \"experiment.update\",\n        accountId: bareAccountId(args as Record<string, unknown>),\n        target: requireTarget(args as Record<string, unknown>, \"A/B test\"),\n        payload: { state },\n      });\n    },\n  });\n}\n\nexport const experimentsCommand = defineCommand({\n  meta: {\n    name: \"experiments\",\n    description: `LinkedIn A/B tests: two ad sets of one campaign shown to separate halves of the audience, with a winner called on CPC/CPM/CPV/CPMS.\nExamples:\n  baker ads linkedin experiments                       # list\n  baker ads linkedin experiments get 5633011           # setup checks + result\n  baker ads linkedin experiments create --name \"Image vs video\" --version-a <ad set> --version-b <ad set> --metric CPC --start 2026-11-01 --end 2026-11-28\n  baker ads linkedin experiments pause|start|end 5633011`,\n  },\n  subCommands: {\n    list: experimentsListCommand,\n    get: experimentsGetCommand,\n    create: experimentsCreateCommand,\n    update: experimentsUpdateCommand,\n    start: experimentStateCommand(\"start\", \"ACTIVE\", \"starting (or resuming) an A/B test\"),\n    pause: experimentStateCommand(\"pause\", \"PAUSED\", \"pausing an A/B test — both ad sets pause, the end date stays\"),\n    end: experimentStateCommand(\"end\", \"CANCELED\", \"ending an A/B test for good\"),\n  },\n  args: { ...accountArgs },\n  default: \"list\",\n});\n"],"mappings":"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","names":[]}