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

package/dist/discover-BJPZNXUQ.js

@@ -0,0 +1,172 @@
+import {
+  PLANNER_FIELD_DESCRIPTIONS,
+  PLANNER_SOURCE,
+  stampPlannerRows
+} from "./chunk-2Y5V23PU.js";
+import {
+  buildAdsQueryContext,
+  warnDefaults
+} from "./chunk-LIQ4SQ2T.js";
+import "./chunk-XCM6XWOB.js";
+import {
+  buildQueryCacheKey,
+  cacheGet,
+  cacheSet,
+  getManagerIdForCustomer,
+  handleConnectionError,
+  isNotConnectedError,
+  resolveCustomerId,
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-VFIOJD5M.js";
+import "./chunk-NE4F3FHN.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-BJPZNXUQ.js.map

package/dist/domain-R4EIZD2W.js

@@ -0,0 +1,98 @@
+import {
+  failSite
+} from "./chunk-YBP7O5P4.js";
+import "./chunk-NDXBU22S.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-TEINLN64.js";
+import "./chunk-ZJWUBJYQ.js";
+import "./chunk-NE4F3FHN.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-R4EIZD2W.js.map

package/dist/draft-34C3F5U4.js

@@ -0,0 +1,217 @@
+import {
+  CHAT_READ_ARG
+} from "./chunk-PFBQERWX.js";
+import {
+  failApi,
+  failValidation,
+  isTempId
+} from "./chunk-E4MDJBLO.js";
+import {
+  REMOVABLE_DRAFT_OP_KINDS
+} from "./chunk-NDXBU22S.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-TEINLN64.js";
+import "./chunk-ZJWUBJYQ.js";
+import "./chunk-NE4F3FHN.js";
+import {
+  apiPost,
+  validateConvexId
+} from "./chunk-XBOK23HI.js";
+import "./chunk-IFWP3ZDO.js";
+import {
+  requireChatId,
+  resolveChatId
+} from "./chunk-NAWWC5I3.js";
+import {
+  registerSchema,
+  writeJson,
+  writeOutput
+} from "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/actions/draft.ts
+import { defineCommand } from "citty";
+var REMOVE_OP_KINDS = REMOVABLE_DRAFT_OP_KINDS;
+registerSchema({
+  command: "actions.draft.list",
+  description: "Review the action ops staged in THIS chat's draft before publish (creates/updates/completes/discards/links). Staged ops are invisible to `actions list`/`status` until the chat publishes \u2014 use this to verify what will apply and catch duplicates. Takes --chat <id> to read an earlier chat's staged ops instead. Start here: `baker actions draft --output md` for a one-row-per-op table; add --fields to pick columns.",
+  args: {
+    chat: { type: "string", description: CHAT_READ_ARG.description, required: false },
+    output: {
+      type: "string",
+      description: "Output format: json (default, full envelope with status/count/warnings) | md | files. md and files render one row per staged op.",
+      required: false,
+      enum: ["json", "md", "files"]
+    },
+    fields: {
+      type: "string",
+      description: "Comma-separated columns for md/files output, e.g. kind,name,ref,tags",
+      required: false
+    },
+    full: {
+      type: "boolean",
+      description: "Include each op's payload (description, note, reason, blocker) in md/files output",
+      required: false,
+      default: false
+    }
+  }
+});
+var OUTPUT_ARGS = {
+  output: { type: "string", description: "Output format: json|md|files", required: false, default: "json" },
+  fields: { type: "string", description: "Comma-separated field names to include (md/files)", required: false },
+  full: { type: "boolean", description: "Include each op's full payload", required: false, default: false }
+};
+function text(value) {
+  return typeof value === "string" ? value : "";
+}
+function draftOpNormalizer(record, full) {
+  const compact = {
+    kind: text(record.kind),
+    name: text(record.targetName),
+    ref: text(record.tempId) || text(record.targetActionId),
+    tags: Array.isArray(record.tags) ? record.tags.join(",") : ""
+  };
+  if (!full) {
+    return compact;
+  }
+  return {
+    ...compact,
+    description: text(record.description),
+    note: text(record.note),
+    reason: text(record.reason),
+    blocker: text(record.blockerTempId) || text(record.blockerActionId) || text(record.blockerName)
+  };
+}
+registerSchema({
+  command: "actions.draft.remove",
+  description: "Drop a single staged action op from this chat's draft before publish. For a tempId, removing the create cascades into its complete/link ops. For a real action ID, pass --op to say which op to drop. Use this to UNDO a staged op \u2014 never stage `complete` to delete an action.",
+  args: {
+    ref: { type: "string", description: "tempId (temp_*) or real action ID to drop from the draft", required: true },
+    op: {
+      type: "string",
+      description: "Required for real action IDs: which op to drop (update|complete|discard|assign|reopen)",
+      required: false
+    }
+  }
+});
+registerSchema({
+  command: "actions.draft.clear",
+  description: "Discard ALL staged action ops in this chat's draft before publish. Nothing applies on publish. Does not touch already-published actions.",
+  args: {}
+});
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "Show every action op staged in this chat's draft, with footgun warnings. Example: baker actions draft --output md"
+  },
+  args: { chat: CHAT_READ_ARG, ...OUTPUT_ARGS },
+  run: async ({ args }) => {
+    try {
+      const chatId = resolveChatId(args.chat);
+      const response = await apiPost("/api/actions/draft", { chatId });
+      const format = args.output === "md" || args.output === "files" ? args.output : "json";
+      if (format === "json") {
+        writeJson(response);
+        return;
+      }
+      writeOutput(
+        { ok: true, data: response.data.ops },
+        format,
+        args.fields ? args.fields.split(",") : void 0,
+        args.full,
+        draftOpNormalizer
+      );
+      process.stderr.write(`draft status: ${response.data.status}, ${response.data.count} op(s)
+`);
+      for (const warning of response.data.warnings) {
+        process.stderr.write(`warning: ${warning.tempId} \u2014 ${warning.name}
+`);
+      }
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+var removeCommand = defineCommand({
+  meta: {
+    name: "remove",
+    description: "Drop one staged op from the draft. Example: baker actions draft remove temp_abc123  |  baker actions draft remove jx7... --op complete"
+  },
+  args: {
+    ref: { type: "positional", description: "tempId or real action ID", required: false },
+    op: {
+      type: "string",
+      description: "Op kind for real IDs: update|complete|discard|assign|reopen",
+      required: false
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const ref = args.ref;
+      if (!ref) {
+        failValidation("A tempId or action ID is required.");
+      }
+      const chatId = requireChatId();
+      if (isTempId(ref)) {
+        await apiPost("/api/actions/draft-op/remove", {
+          chatId,
+          target: { kind: "tempId", tempId: ref }
+        });
+        writeJson({ ok: true, data: { removed: ref, kind: "tempId" } });
+        return;
+      }
+      validateConvexId(ref);
+      const op = args.op;
+      if (!op || !REMOVE_OP_KINDS.includes(op)) {
+        failValidation(
+          `Removing a staged op for a real action ID requires --op (one of: ${REMOVE_OP_KINDS.join("|")}).`
+        );
+      }
+      await apiPost("/api/actions/draft-op/remove", {
+        chatId,
+        target: { kind: "actionId", actionId: ref, opKind: op }
+      });
+      writeJson({ ok: true, data: { removed: ref, kind: "actionId", op } });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+var clearCommand = defineCommand({
+  meta: {
+    name: "clear",
+    description: "Discard every staged op in this chat's draft. Example: baker actions draft clear"
+  },
+  run: async () => {
+    try {
+      const chatId = requireChatId();
+      await apiPost("/api/actions/draft/clear", { chatId });
+      writeJson({ ok: true, data: { cleared: true } });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+var draftCommand = defineCommand({
+  meta: {
+    name: "draft",
+    description: "Review and edit the action ops staged in this chat BEFORE publish. Subcommands: list (default), remove, clear. Staged ops are invisible to `actions list`/`status` until publish, so check here before finishing. `list` takes --chat <id> to read an earlier chat's staged ops 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: { chat: CHAT_READ_ARG, ...OUTPUT_ARGS },
+  subCommands: {
+    list: listCommand,
+    remove: removeCommand,
+    clear: clearCommand
+  },
+  // Bare `baker actions draft` (no subcommand) shows the staged ops. This must be
+  // `default`, not `run`: citty falls through to `run` after dispatching a subcommand,
+  // so a `run` here would also list the draft on every `remove` / `clear`.
+  default: "list"
+});
+export {
+  draftCommand,
+  draftOpNormalizer
+};
+//# sourceMappingURL=draft-34C3F5U4.js.map