@koda-sl/baker-cli 0.545.0 → 0.546.0-dev.a72c87f73

package/dist/domain-YYTNWNSF.js

@@ -0,0 +1,101 @@
+import {
+  failSite
+} from "./chunk-F2VUMTCJ.js";
+import "./chunk-UKIS6BLM.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-H4CLWLYF.js";
+import {
+  apiGet,
+  apiPost
+} from "./chunk-B2OHCWYB.js";
+import "./chunk-SVUFNCOE.js";
+import {
+  optionalChatId,
+  requireChatId
+} from "./chunk-E54435XT.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-WCIS4FZH.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/site/domain.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "site.domain.add",
+  description: "Stage connecting a custom domain (a subdomain such as shop.acme.com \u2014 not the bare acme.com) to the company's landings. Applies when the chat is published; then Baker starts verifying it. The client must add a CNAME record pointing the hostname at customers.withbaker.com \u2014 the response's hints give the exact record to ask for. Refused at once when another company already registered it or the company is at its domain limit.",
+  args: { hostname: { type: "string", description: "The subdomain to connect, e.g. shop.acme.com", required: true } }
+});
+registerSchema({
+  command: "site.domain.list",
+  description: "Every custom domain of the company and its status: pending_verification (waiting for the DNS record \u2014 `message` says what is missing), active (live), error, or staged (this chat adds it at publish). Read-only.",
+  args: {}
+});
+registerSchema({
+  command: "site.domain.verify",
+  description: "Re-check a domain that is waiting for verification now instead of waiting for the background check (every few minutes). Use after the client says they added the DNS record. Returns its state and, if it is not live yet, what is still missing. A staged domain cannot be checked until the chat is published.",
+  args: { hostname: { type: "string", description: "A domain from `baker site domain list`", required: true } }
+});
+var addCommand = defineCommand({
+  meta: {
+    name: "add",
+    description: "Stage connecting a custom domain; applies at publish. The client adds a CNAME to customers.withbaker.com.\n\nExample: baker site domain add shop.acme.com"
+  },
+  args: { hostname: { type: "positional", description: "Subdomain, e.g. shop.acme.com", required: true } },
+  run: async ({ args }) => {
+    try {
+      const body = {
+        chatId: requireChatId(),
+        inputs: [{ setting: "customDomain", hostname: String(args.hostname) }]
+      };
+      writeJson(await apiPost("/api/site/stage", body));
+    } catch (err) {
+      failSite(err);
+    }
+  }
+});
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List the company's custom domains and what each is waiting for.\n\nExample: baker site domain list"
+  },
+  run: async () => {
+    try {
+      const chatId = optionalChatId();
+      writeJson(await apiGet("/api/site/domains", chatId ? { chatId } : void 0));
+    } catch (err) {
+      failSite(err);
+    }
+  }
+});
+var verifyCommand = defineCommand({
+  meta: {
+    name: "verify",
+    description: "Re-check a pending domain now, e.g. right after the client added the DNS record.\n\nExample: baker site domain verify shop.acme.com"
+  },
+  args: { hostname: { type: "positional", description: "A domain from `baker site domain list`", required: true } },
+  run: async ({ args }) => {
+    try {
+      const body = { hostname: String(args.hostname) };
+      writeJson(await apiPost("/api/site/domains/verify", body));
+    } catch (err) {
+      failSite(err);
+    }
+  }
+});
+var domainCommand = defineCommand({
+  meta: {
+    name: "domain",
+    description: "Custom domains for the company's landings. Subcommands: add (staged until publish), list, verify.\n\nExamples:\n  baker site domain add shop.acme.com\n  baker site domain list\n  baker site domain verify shop.acme.com"
+  },
+  subCommands: { add: addCommand, list: listCommand, verify: verifyCommand }
+});
+export {
+  domainCommand
+};
+//# sourceMappingURL=domain-YYTNWNSF.js.map

package/dist/download-JMJRYJ37.js

@@ -0,0 +1,172 @@
+import {
+  videosDownloadResponseSchema
+} from "./chunk-UKIS6BLM.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-H4CLWLYF.js";
+import {
+  ApiError,
+  apiPost,
+  validateConvexId
+} from "./chunk-B2OHCWYB.js";
+import "./chunk-SVUFNCOE.js";
+import "./chunk-E54435XT.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-WCIS4FZH.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/videos/download.ts
+import { mkdir, open, rm, stat } from "fs/promises";
+import path from "path";
+import { Readable } from "stream";
+import { pipeline } from "stream/promises";
+import { defineCommand } from "citty";
+var DEFAULT_TIMEOUT_SECONDS = 20 * 60;
+var POLL_INTERVAL_MS = 1e4;
+registerSchema({
+  command: "videos.download",
+  description: "Save a library video (one from `videos search`, or one the user attached in chat) as a local .mp4 to edit with ffmpeg or a canvas ingest node. Waits while the file is prepared.",
+  args: {
+    id: { type: "string", description: "Library video ID", required: true },
+    out: { type: "string", description: "Directory to write the file into (created if missing)", required: true },
+    "timeout-seconds": {
+      type: "string",
+      description: `How long to wait for the file to be prepared (default ${DEFAULT_TIMEOUT_SECONDS})`,
+      required: false
+    }
+  }
+});
+async function awaitDownloadUrl(ask, options) {
+  const deadline = options.now() + options.timeoutMs;
+  for (; ; ) {
+    const answer = await ask();
+    if (answer.status === "ready") return { ready: true, url: answer.url, filename: answer.filename };
+    if (options.now() + options.intervalMs > deadline) return { ready: false, lastStatus: answer.status };
+    await options.sleep(options.intervalMs);
+  }
+}
+async function saveVideoFile(url, outDir, filename) {
+  await mkdir(outDir, { recursive: true });
+  const { name: stem, ext } = path.parse(path.basename(filename));
+  for (let n = 1; ; n++) {
+    const file = path.join(outDir, `${stem}${n === 1 ? "" : `-${n}`}${ext || ".mp4"}`);
+    let handle;
+    try {
+      handle = await open(file, "wx");
+    } catch (err) {
+      if (err instanceof Error && "code" in err && err.code === "EEXIST") continue;
+      throw err;
+    }
+    try {
+      const response = await fetch(url);
+      if (!response.ok || !response.body)
+        throw new Error(`The video file could not be fetched (HTTP ${response.status})`);
+      await pipeline(Readable.fromWeb(response.body), handle.createWriteStream());
+    } catch (err) {
+      await handle.close().catch(() => void 0);
+      await rm(file, { force: true });
+      throw err;
+    }
+    return { file, bytes: (await stat(file)).size };
+  }
+}
+async function downloadLibraryVideo(args, deps) {
+  let wait;
+  try {
+    wait = await awaitDownloadUrl(deps.ask, { timeoutMs: args.timeoutMs, intervalMs: args.intervalMs, ...deps });
+  } catch (err) {
+    if (!(err instanceof ApiError)) throw err;
+    const fix = err.fix ?? (err.code === "CONFLICT" ? {
+      action: "continue_without",
+      explanation: "Tell the user why this video cannot be used and carry on without it."
+    } : void 0);
+    return { ok: false, error: { code: err.code, message: err.message, ...fix ? { fix } : {} } };
+  }
+  if (!wait.ready) {
+    return {
+      ok: false,
+      error: {
+        code: "TIMEOUT",
+        message: wait.lastStatus === "processing" ? "The video is still being uploaded to the library." : "The library is still preparing a downloadable file of this video.",
+        fix: {
+          action: "wait_and_retry",
+          explanation: "Tell the user the video is still being prepared, carry on with the rest of the job, and run this command again in a few minutes. Do not abort the whole job."
+        }
+      }
+    };
+  }
+  try {
+    const saved = await saveVideoFile(wait.url, path.resolve(args.out), wait.filename);
+    return {
+      ok: true,
+      data: saved,
+      hints: [
+        `Edit ${saved.file} with ffprobe/ffmpeg, or feed it to a canvas ingest node as { source: "path", path, expect: "video" }. The library video is unchanged.`
+      ]
+    };
+  } catch (err) {
+    return {
+      ok: false,
+      error: { code: "DOWNLOAD_FAILED", message: err instanceof Error ? err.message : String(err) }
+    };
+  }
+}
+function positiveInt(value) {
+  const parsed = typeof value === "string" ? Number.parseInt(value, 10) : Number.NaN;
+  return Number.isInteger(parsed) && parsed > 0 ? parsed : void 0;
+}
+var downloadCommand = defineCommand({
+  meta: {
+    name: "download",
+    description: "Save a library video as a local .mp4 so you can edit it (ffmpeg, canvas ingest node). Use it for a video the user attached in chat, or one found with `videos search`. Waits up to 20 minutes while the file is prepared.\n\nExample: baker videos download j571abc123def --out /tmp/clips"
+  },
+  args: {
+    id: { type: "positional", description: "Library video ID", required: true },
+    out: { type: "string", description: "Directory to write the file into", required: true },
+    "timeout-seconds": {
+      type: "string",
+      description: `How long to wait for the file (default ${DEFAULT_TIMEOUT_SECONDS})`,
+      required: false
+    }
+  },
+  run: async ({ args }) => {
+    const id = String(args.id ?? "");
+    try {
+      validateConvexId(id);
+    } catch (err) {
+      writeJson({
+        ok: false,
+        error: { code: "VALIDATION_ERROR", message: err instanceof Error ? err.message : "Invalid video ID" }
+      });
+      process.exit(1);
+    }
+    const result = await downloadLibraryVideo(
+      {
+        id,
+        out: String(args.out ?? ""),
+        timeoutMs: (positiveInt(args["timeout-seconds"]) ?? DEFAULT_TIMEOUT_SECONDS) * 1e3,
+        intervalMs: POLL_INTERVAL_MS
+      },
+      {
+        ask: async () => videosDownloadResponseSchema.parse(await apiPost("/api/videos/download", { id })),
+        now: Date.now,
+        sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms))
+      }
+    );
+    writeJson(result);
+    if (!result.ok) process.exit(1);
+  }
+});
+export {
+  awaitDownloadUrl,
+  downloadCommand,
+  downloadLibraryVideo,
+  saveVideoFile
+};
+//# sourceMappingURL=download-JMJRYJ37.js.map

package/dist/draft-KQACMPH2.js

@@ -0,0 +1,313 @@
+import {
+  loadPatchArg,
+  requireTarget
+} from "./chunk-7LYJVM7L.js";
+import {
+  handleLinkedinError
+} from "./chunk-EGW3D3RW.js";
+import "./chunk-3W4IORXH.js";
+import "./chunk-4NZ47VXO.js";
+import {
+  hintLines
+} from "./chunk-D5FY4FAK.js";
+import "./chunk-NGQ5J4FV.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-MGWAZXY6.js";
+import "./chunk-VWOKPC3T.js";
+import "./chunk-BGT5ZA4L.js";
+import "./chunk-JF2XP76K.js";
+import "./chunk-SYLPRIFM.js";
+import "./chunk-XBR7TSZN.js";
+import "./chunk-DGUN7FUH.js";
+import {
+  CHAT_READ_ARG,
+  DRAFT_FULL_ARG
+} from "./chunk-X32MFGWW.js";
+import "./chunk-UKIS6BLM.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-H4CLWLYF.js";
+import {
+  apiPost
+} from "./chunk-B2OHCWYB.js";
+import "./chunk-SVUFNCOE.js";
+import {
+  requireChatId,
+  resolveChatId
+} from "./chunk-E54435XT.js";
+import "./chunk-WCIS4FZH.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-KQACMPH2.js.map