@koda-sl/baker-cli 0.447.0-dev.f5788a631 → 0.447.0

package/dist/discover-M3ZKKFEL.js

@@ -1,172 +0,0 @@
-import {
-  PLANNER_FIELD_DESCRIPTIONS,
-  PLANNER_SOURCE,
-  stampPlannerRows
-} from "./chunk-2Y5V23PU.js";
-import {
-  buildAdsQueryContext,
-  warnDefaults
-} from "./chunk-2SCPDSFN.js";
-import "./chunk-EVYXTT7V.js";
-import {
-  buildQueryCacheKey,
-  cacheGet,
-  cacheSet,
-  getManagerIdForCustomer,
-  handleConnectionError,
-  isNotConnectedError,
-  resolveCustomerId,
-  writeAdsJson,
-  writeAdsOutput
-} from "./chunk-VFIOJD5M.js";
-import "./chunk-XML7AJM3.js";
-import {
-  ApiError,
-  apiPost
-} from "./chunk-XBOK23HI.js";
-import "./chunk-IFWP3ZDO.js";
-import "./chunk-NAWWC5I3.js";
-import {
-  registerSchema
-} from "./chunk-NU7JSWVA.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/ads/google/keywords/discover.ts
-import { defineCommand } from "citty";
-registerSchema({
-  command: "ads.google.keywords.discover",
-  description: 'Discover keyword ideas from seed keywords or URLs. Returns { source: "keyword_planner_estimate", keywords, total_results, next_page_token? }. These are Keyword Planner estimates of total market search volume, not this account\'s data: every row carries a source column and every metric is prefixed planner_ (planner_avg_monthly_searches, planner_competition, ...). Never report a planner_ number as impressions, clicks or any account metric \u2014 read those with `baker ads google query` against the account. If --location and --language are omitted, they default to United States (2840) and English (1000); `query_context` shows which were used.',
-  args: {
-    "customer-id": {
-      type: "string",
-      description: "Google Ads customer ID (10 digits, no dashes). Falls back to BAKER_GOOGLE_ADS_CUSTOMER_ID env var.",
-      required: false
-    },
-    seeds: { type: "string", description: "Comma-separated seed keywords (max 10)", required: false },
-    url: { type: "string", description: "URL to extract keyword ideas from", required: false },
-    location: {
-      type: "string",
-      description: "Geo target ID. Defaults to 2840 (United States) if omitted \u2014 always set this for non-US markets",
-      required: false
-    },
-    language: {
-      type: "string",
-      description: "Language ID. Defaults to 1000 (English) if omitted \u2014 always set this for non-English markets",
-      required: false
-    },
-    limit: { type: "string", description: "Max keyword ideas (default: 20, max: 100)", required: false, default: 20 },
-    cursor: {
-      type: "string",
-      description: "Pagination cursor from previous response (next_page_token)",
-      required: false
-    },
-    output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" },
-    "no-cache": { type: "boolean", description: "Skip cache", required: false }
-  }
-});
-function stampDiscoverResponse(data) {
-  return { ...data, source: PLANNER_SOURCE, keywords: stampPlannerRows(data.keywords ?? []) };
-}
-function buildDiscoverBody(customerId, args) {
-  const body = {
-    customerId,
-    pageSize: args.limit ? Number(args.limit) : 20
-  };
-  const managerId = getManagerIdForCustomer(customerId);
-  if (managerId) body.managerId = managerId;
-  const seeds = args.seeds ? args.seeds.split(",").map((s) => s.trim()).filter(Boolean) : void 0;
-  if (seeds) body.seeds = seeds;
-  if (args.url) body.url = args.url;
-  if (args.location) body.locationIds = [args.location];
-  if (args.language) body.languageId = args.language;
-  if (args.cursor) body.pageToken = args.cursor;
-  return body;
-}
-function handleKeywordError(err) {
-  if (err instanceof ApiError) {
-    if (isNotConnectedError(err.code, err.message)) {
-      handleConnectionError("google_ads", err.message);
-    }
-    const envelope = {
-      ok: false,
-      error: {
-        code: err.code,
-        message: err.message,
-        fix: { action: "reject", explanation: err.message },
-        retryable: err.code === "RATE_LIMITED"
-      }
-    };
-    writeAdsJson(envelope);
-    process.exit(1);
-  }
-  writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
-  process.exit(1);
-}
-var discoverCommand = defineCommand({
-  meta: {
-    name: "discover",
-    description: `Discover new keyword ideas from seed keywords or competitor URLs.
-
-Returns Keyword Planner ESTIMATES of market search volume, not this account's numbers. Every row carries source=keyword_planner_estimate and planner_-prefixed metrics; keep those names when you quote a figure, and never present one as an impression or click count.
-
-Examples:
-  baker ads google keywords discover --customer-id 1234567890 --seeds "running shoes,athletic footwear"
-  baker ads google keywords discover --customer-id 1234567890 --url "https://competitor.com"
-  baker ads google keywords discover --customer-id 1234567890 --seeds "seo tools" --location 2826 --limit 50`
-  },
-  args: {
-    "customer-id": { type: "string", description: "Google Ads customer ID", required: false },
-    seeds: { type: "string", description: "Comma-separated seed keywords", required: false },
-    url: { type: "string", description: "URL to extract ideas from", required: false },
-    location: { type: "string", description: "Geo target ID (default 2840)", required: false },
-    language: { type: "string", description: "Language ID (default 1000)", required: false },
-    limit: { type: "string", description: "Max results (default 20)", required: false },
-    cursor: { type: "string", description: "Pagination cursor from previous response", required: false },
-    "no-cache": { type: "boolean", description: "Skip cache", required: false },
-    output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" }
-  },
-  run: async ({ args }) => {
-    const customerId = await resolveCustomerId(args);
-    const queryContext = buildAdsQueryContext(args.location, args.language);
-    if (!args.seeds && !args.url) {
-      writeAdsJson({
-        ok: false,
-        error: { code: "VALIDATION_ERROR", message: "Provide --seeds or --url (at least one required)" }
-      });
-      process.exit(1);
-    }
-    const body = buildDiscoverBody(customerId, args);
-    const useCache = !args["no-cache"] && !args.cursor;
-    if (!useCache) body.skipCache = true;
-    const cacheKey = buildQueryCacheKey(customerId, JSON.stringify(body));
-    if (useCache) {
-      const cached = cacheGet("keywords", cacheKey);
-      if (cached) {
-        warnDefaults(queryContext);
-        writeAdsJson({ ok: true, data: stampDiscoverResponse(cached.data), cached: true, query_context: queryContext });
-        return;
-      }
-    }
-    try {
-      const data = await apiPost("/api/ads/google/keywords/discover", body);
-      if (useCache) {
-        cacheSet("keywords", cacheKey, data, 24 * 60 * 60 * 1e3);
-      }
-      warnDefaults(queryContext);
-      const stamped = stampDiscoverResponse(data);
-      const format = args.output || "json";
-      if (format !== "json") {
-        writeAdsOutput(stamped.keywords, format);
-        return;
-      }
-      writeAdsJson({ ok: true, data: stamped, fields: PLANNER_FIELD_DESCRIPTIONS, query_context: queryContext });
-    } catch (err) {
-      handleKeywordError(err);
-    }
-  }
-});
-export {
-  discoverCommand,
-  stampDiscoverResponse
-};
-//# sourceMappingURL=discover-M3ZKKFEL.js.map

package/dist/domain-TH7KIC2T.js

@@ -1,98 +0,0 @@
-import {
-  failSite
-} from "./chunk-4SNOWJV7.js";
-import "./chunk-6HJAHLLA.js";
-import "./chunk-GXDLWBOY.js";
-import "./chunk-WYCVJIHD.js";
-import "./chunk-ZJWUBJYQ.js";
-import "./chunk-XML7AJM3.js";
-import {
-  apiGet,
-  apiPost
-} from "./chunk-XBOK23HI.js";
-import "./chunk-IFWP3ZDO.js";
-import {
-  optionalChatId,
-  requireChatId
-} from "./chunk-NAWWC5I3.js";
-import {
-  registerSchema,
-  writeJson
-} from "./chunk-NU7JSWVA.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-TH7KIC2T.js.map

package/dist/draft-CRE2Y24G.js

@@ -1,328 +0,0 @@
-import {
-  failWriteValidation
-} from "./chunk-3X3446TG.js";
-import {
-  parseXApiError
-} from "./chunk-M6UNISGO.js";
-import "./chunk-C6U6UDHJ.js";
-import {
-  writeAdsJson,
-  writeJsonEnvelope
-} from "./chunk-VFIOJD5M.js";
-import {
-  CHAT_READ_ARG
-} from "./chunk-PFBQERWX.js";
-import "./chunk-6HJAHLLA.js";
-import "./chunk-GXDLWBOY.js";
-import "./chunk-WYCVJIHD.js";
-import "./chunk-ZJWUBJYQ.js";
-import "./chunk-XML7AJM3.js";
-import {
-  ApiError,
-  apiPost
-} from "./chunk-XBOK23HI.js";
-import "./chunk-IFWP3ZDO.js";
-import {
-  requireChatId,
-  resolveChatId
-} from "./chunk-NAWWC5I3.js";
-import {
-  registerSchema
-} from "./chunk-NU7JSWVA.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: "string", 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: "string", description: "Op ref or target id", required: true },
-    patch: { type: "string", 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: "string", 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-CRE2Y24G.js.map