@koda-sl/baker-cli 0.501.0-dev.6e96f50b9 → 0.502.0

package/dist/instant-experiences-Y53I7FT4.js

@@ -1,258 +0,0 @@
-import {
-  bareAccountId,
-  failWriteValidation,
-  loadJsonFileArg,
-  mergePayload,
-  requireTarget,
-  stageOp
-} from "./chunk-YIN6QNZD.js";
-import "./chunk-5B2WEPYR.js";
-import "./chunk-GDFJOCDO.js";
-import {
-  csvOrJson,
-  handleMetaError
-} from "./chunk-B2POVFR2.js";
-import "./chunk-ERSX3MKH.js";
-import "./chunk-KJZPCLQE.js";
-import "./chunk-4NZ47VXO.js";
-import "./chunk-D5FY4FAK.js";
-import "./chunk-QPESDKZC.js";
-import "./chunk-Y2JZX6JB.js";
-import {
-  writeAdsOutput,
-  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-UI6BKYQD.js";
-import {
-  apiGet
-} from "./chunk-X7VQFLHI.js";
-import "./chunk-LU4HI4KI.js";
-import "./chunk-LGK7UWBN.js";
-import {
-  registerSchema
-} from "./chunk-Q7US4OOA.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/ads/meta/instant-experiences.ts
-import { defineCommand } from "citty";
-var STAGED_NOTE = "Staged until publish \u2014 review with `baker ads meta draft`.";
-var ELEMENT_FLAGS = ["text", "button", "photo-id", "video-id", "video-ref", "product-set-id", "footer"];
-function linkPair(flag, value) {
-  const [text, ...rest] = value.split("=>");
-  const url = rest.join("=>").trim();
-  if (!text?.trim() || !url) {
-    failWriteValidation(`--${flag} takes "Button text => https://\u2026" \u2014 got "${value}"`);
-  }
-  return { text: text.trim(), url };
-}
-function elementFor(flag, value) {
-  switch (flag) {
-    case "text":
-      return { type: "text", text: value };
-    case "button":
-      return { type: "button", ...linkPair(flag, value) };
-    case "footer":
-      return { type: "footer", ...linkPair(flag, value) };
-    case "photo-id":
-      return { type: "photo", photo_id: value };
-    case "video-id":
-      return { type: "video", video_id: value };
-    case "video-ref":
-      return { type: "video", videoRef: value };
-    default:
-      return { type: "product_set", product_set_id: value };
-  }
-}
-function elementFlagOf(arg) {
-  if (!arg.startsWith("--")) return void 0;
-  const eq = arg.indexOf("=");
-  const name = eq === -1 ? arg.slice(2) : arg.slice(2, eq);
-  const flag = ELEMENT_FLAGS.find((candidate) => candidate === name);
-  if (!flag) return void 0;
-  return eq === -1 ? { flag } : { flag, inline: arg.slice(eq + 1) };
-}
-function canvasElementsFromRawArgs(rawArgs) {
-  const elements = [];
-  const end = rawArgs.indexOf("--");
-  const args = end === -1 ? rawArgs : rawArgs.slice(0, end);
-  for (let i = 0; i < args.length; i++) {
-    const found = elementFlagOf(args[i] ?? "");
-    if (!found) continue;
-    const value = found.inline ?? args[++i];
-    if (value === void 0 || value.startsWith("--")) failWriteValidation(`--${found.flag} needs a value`);
-    elements.push(elementFor(found.flag, value));
-  }
-  return elements;
-}
-registerSchema({
-  command: "ads.meta.instant-experiences",
-  description: "A Facebook Page's Instant Experiences \u2014 the full-screen pages an ad can open (creatives create --type instant_experience --canvas-id). Shows whether each is published: an ad opens only a published one.",
-  args: {
-    "page-id": { type: "string", description: "Facebook Page id (baker ads meta pages)", required: true },
-    output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
-  }
-});
-var listCommand = defineCommand({
-  meta: {
-    name: "list",
-    description: "A Page's Instant Experiences, published or not. Runs by default. Example: baker ads meta instant-experiences --page-id 904238019441800"
-  },
-  args: {
-    "page-id": { type: "string", description: "Facebook Page id \u2014 from `baker ads meta pages`" },
-    output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
-  },
-  run: async ({ args }) => {
-    if (!args["page-id"]) failWriteValidation("pass --page-id (from `baker ads meta pages`)");
-    try {
-      const rows = await apiGet("/api/ads/meta/instant-experiences", {
-        "page-id": String(args["page-id"])
-      });
-      const hints = rows.length === 0 ? ["This Page has no Instant Experiences. Stage one with `baker ads meta instant-experiences create`."] : [
-        "An ad opens only a published experience (is_published true): `creatives create --type instant_experience --canvas-id <id>`. A published one cannot be changed or deleted."
-      ];
-      const fmt = csvOrJson(args);
-      if (fmt !== "json") {
-        writeAdsOutput(rows, fmt, void 0, hints);
-        return;
-      }
-      writeJsonEnvelope({ ok: true, data: rows, hints });
-    } catch (err) {
-      handleMetaError(err);
-    }
-  }
-});
-registerSchema({
-  command: "ads.meta.instant-experiences.create",
-  description: "Stage a new Instant Experience on a Page \u2014 its elements in command-line order \u2014 made (and published, unless --unpublished) when the chat publishes. Meta deletes no experience, so it is only ever made at publish.",
-  args: {
-    "account-id": { type: "string", description: "Ad account the change is staged under", required: false },
-    "page-id": { type: "string", description: "The Facebook Page it belongs to", required: true },
-    name: { type: "string", description: "Name in the Page's Instant Experience library", required: true },
-    text: { type: "string", description: "A paragraph, repeatable", required: false },
-    button: { type: "string", description: '"Text => https://\u2026", repeatable', required: false },
-    "photo-id": {
-      type: "string",
-      description: "A photo on the Page, or meta_temp_* of a staged `page-photos upload`, repeatable",
-      required: false
-    },
-    "video-id": { type: "string", description: "A video of the ad account, repeatable", required: false },
-    "video-ref": { type: "string", description: "meta_temp_* of a staged video upload, repeatable", required: false },
-    "product-set-id": { type: "string", description: "Products of a catalog's product set", required: false },
-    footer: { type: "string", description: '"Text => https://\u2026" pinned at the bottom (last)', required: false },
-    background: { type: "string", description: "Background colour, six hex digits", required: false },
-    unpublished: { type: "boolean", description: "Leave it unpublished (no ad can open it yet)", required: false },
-    file: { type: "string", description: "JSON file with the whole payload", required: false }
-  }
-});
-var instantExperiencesCreateCommand = defineCommand({
-  meta: {
-    name: "create",
-    description: `Stage a new Instant Experience (the full-screen page an ad opens). ${STAGED_NOTE}
-Elements appear in the order of their flags; every element flag repeats. Published at publish unless --unpublished \u2014 an ad opens only a published one, a published one cannot be changed, and Meta deletes none.
-Pictures are Page photos (--photo-id: one on the Page, or the ref of a staged \`page-photos upload\`; a collection's photo experience takes four); videos come from the ad account (--video-id, or --video-ref of a staged \`media upload --kind video\`).
-Example: baker ads meta instant-experiences create --account-id act_123 --page-id 904238019441800 --name "Spring" --video-id 1508023623826870 --text "Our spring range" --button "Shop now => https://shop.example/spring"
-Then: baker ads meta creatives create --type instant_experience --canvas-id meta_temp_\u2026 --page 904238019441800 --message "Tap to explore" --image-hash \u2026`
-  },
-  args: {
-    "account-id": { type: "string", description: "Numeric account ID or act_N (the account the ads run from)" },
-    "page-id": { type: "string", description: "The Facebook Page it belongs to \u2014 from `baker ads meta pages`" },
-    name: { type: "string", description: "Name in the Page's Instant Experience library" },
-    text: { type: "string", description: "A paragraph of text (repeatable)" },
-    button: { type: "string", description: '"Button text => https://\u2026" (repeatable)' },
-    "photo-id": {
-      type: "string",
-      description: "A photo on the Page, or meta_temp_* of a staged `page-photos upload` (repeatable)"
-    },
-    "video-id": { type: "string", description: "A video of the ad account (repeatable)" },
-    "video-ref": {
-      type: "string",
-      description: "meta_temp_* ref of a staged `media upload --kind video` (repeatable)"
-    },
-    "product-set-id": {
-      type: "string",
-      description: "Products from a catalog's product set, also shown under the ad (collection) \u2014 repeatable"
-    },
-    footer: { type: "string", description: '"Button text => https://\u2026" pinned at the bottom; must be last' },
-    background: { type: "string", description: "Background colour, six hex digits (e.g. FFFFFF)" },
-    unpublished: {
-      type: "boolean",
-      description: "Leave it unpublished \u2014 it can be changed, but no ad can open it yet"
-    },
-    file: { type: "string", description: "JSON file with the whole payload (page_id, name, elements[], publish)" }
-  },
-  run: async ({ args, rawArgs }) => {
-    const accountId = bareAccountId(args);
-    const elements = canvasElementsFromRawArgs(rawArgs);
-    const payload = mergePayload(loadJsonFileArg(args.file), {
-      page_id: args["page-id"] === void 0 ? void 0 : String(args["page-id"]),
-      name: args.name,
-      background_color: args.background,
-      elements: elements.length > 0 ? elements : void 0,
-      publish: args.unpublished === true ? false : void 0
-    });
-    await stageOp({ kind: "canvas.create", accountId, payload }, [
-      "An ad opens it with `creatives create --type instant_experience --canvas-id <ref>`."
-    ]);
-  }
-});
-registerSchema({
-  command: "ads.meta.instant-experiences.update",
-  description: "Rename or publish an UNPUBLISHED Instant Experience at publish. Meta changes nothing on a published one.",
-  args: {
-    id: { type: "positional", description: "Instant Experience id or meta_temp_* ref", required: true },
-    "account-id": { type: "string", description: "Ad account the change is staged under", required: false },
-    name: { type: "string", description: "New name", required: false },
-    publish: { type: "boolean", description: "Publish it so ads can open it", required: false }
-  }
-});
-var instantExperiencesUpdateCommand = defineCommand({
-  meta: {
-    name: "update",
-    description: `Rename or publish an unpublished Instant Experience. ${STAGED_NOTE}
-Example: baker ads meta instant-experiences update 1788652952402490 --account-id act_123 --publish`
-  },
-  args: {
-    id: { type: "positional", description: "Instant Experience id or meta_temp_* ref", required: true },
-    "account-id": { type: "string", description: "Numeric account ID or act_N" },
-    name: { type: "string", description: "New name" },
-    publish: { type: "boolean", description: "Publish it, so ads can open it \u2014 it is then fixed" }
-  },
-  run: async ({ args }) => {
-    const accountId = bareAccountId(args);
-    await stageOp({
-      kind: "canvas.update",
-      accountId,
-      target: requireTarget(args, "Instant Experience"),
-      payload: { name: args.name, publish: args.publish === true ? true : void 0 }
-    });
-  }
-});
-var instantExperiencesCommand = defineCommand({
-  meta: {
-    name: "instant-experiences",
-    description: `Instant Experiences \u2014 the full-screen page an ad opens on the phone (also behind collection ads).
-  baker ads meta instant-experiences --page-id 904238019441800        \u2014 list, with whether each is published
-  baker ads meta instant-experiences create --page-id \u2026 --name \u2026 --text \u2026 --button "Shop => https://\u2026"
-  baker ads meta instant-experiences update <id> --publish`
-  },
-  subCommands: {
-    list: listCommand,
-    create: instantExperiencesCreateCommand,
-    update: instantExperiencesUpdateCommand
-  },
-  args: { "page-id": { type: "string", description: "Facebook Page id" }, output: { type: "string", default: "json" } },
-  default: "list"
-});
-export {
-  canvasElementsFromRawArgs,
-  instantExperiencesCommand,
-  instantExperiencesCreateCommand,
-  instantExperiencesUpdateCommand
-};
-//# sourceMappingURL=instant-experiences-Y53I7FT4.js.map

package/dist/intent-QTQIHE32.js

@@ -1,95 +0,0 @@
-import {
-  handleResearchError,
-  writeResearchJson,
-  writeResearchOutput
-} from "./chunk-GSKZ3ZDO.js";
-import {
-  buildResearchQueryContext,
-  warnDefaults
-} from "./chunk-4D5HZ7V3.js";
-import "./chunk-43PAN3L2.js";
-import "./chunk-PTRCB7AR.js";
-import {
-  apiPost
-} from "./chunk-X7VQFLHI.js";
-import "./chunk-LU4HI4KI.js";
-import "./chunk-LGK7UWBN.js";
-import {
-  registerSchema
-} from "./chunk-Q7US4OOA.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/research/intent.ts
-import { defineCommand } from "citty";
-registerSchema({
-  command: "research.intent",
-  description: "Classify Google Search intent for keywords. Determines if someone searching is looking to buy, research, or navigate. If --language is omitted, defaults to English (en). The response includes a query_context object showing which language was used.",
-  args: {
-    keywords: {
-      type: "string",
-      description: "Comma-separated keywords (min 3 chars each, max 1000 keywords)",
-      required: true
-    },
-    language: {
-      type: "string",
-      description: "Language code or name. Defaults to en (English) if omitted \u2014 always set this for non-English keywords",
-      required: false
-    },
-    "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
-  }
-});
-var FIELDS = {
-  keyword: "The keyword analyzed",
-  intent: "Primary Google Search intent: informational, navigational, commercial, transactional",
-  probability: "Confidence score 0.0-1.0"
-};
-var intentCommand = defineCommand({
-  meta: {
-    name: "intent",
-    description: `Classify Google Search intent for keywords. Returns intent type and confidence.
-
-Examples:
-  baker research intent "buy running shoes,best running shoes 2026,how to tie running shoes"
-  baker research intent "crm software" --language spanish`
-  },
-  args: {
-    keywords: { type: "positional", description: "Comma-separated keywords", required: true },
-    language: { type: "string", description: "Language code or name (default: en)", required: false },
-    output: { type: "string", description: "Format: json|csv|md|jsonl", required: false, default: "json" },
-    "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
-  },
-  run: async ({ args }) => {
-    const rawKeywords = args.keywords;
-    const keywords = rawKeywords.split(",").map((k) => k.trim()).filter((k) => k.length >= 3);
-    if (keywords.length === 0) {
-      writeResearchJson({
-        ok: false,
-        error: { code: "VALIDATION_ERROR", message: "Provide at least one keyword (min 3 chars each)" }
-      });
-      process.exit(1);
-    }
-    const language = args.language || void 0;
-    const skipCache = args["no-cache"] ? true : void 0;
-    const queryContext = buildResearchQueryContext(void 0, language, { skipLocation: true });
-    try {
-      const data = await apiPost("/api/research/intent", {
-        keywords,
-        language,
-        skipCache
-      });
-      warnDefaults(queryContext);
-      const format = args.output || "json";
-      if (format !== "json") {
-        writeResearchOutput(data, format);
-        return;
-      }
-      writeResearchJson({ ok: true, data, fields: FIELDS, query_context: queryContext });
-    } catch (err) {
-      handleResearchError(err);
-    }
-  }
-});
-export {
-  intentCommand
-};
-//# sourceMappingURL=intent-QTQIHE32.js.map

package/dist/keyword-gap-SSWMMVI2.js

@@ -1,130 +0,0 @@
-import {
-  RESEARCH_DATA_NOTE,
-  handleResearchError,
-  writeResearchHints,
-  writeResearchJson,
-  writeResearchOutput
-} from "./chunk-GSKZ3ZDO.js";
-import {
-  buildResearchQueryContext,
-  warnDefaults
-} from "./chunk-4D5HZ7V3.js";
-import "./chunk-43PAN3L2.js";
-import "./chunk-PTRCB7AR.js";
-import {
-  apiPost
-} from "./chunk-X7VQFLHI.js";
-import "./chunk-LU4HI4KI.js";
-import "./chunk-LGK7UWBN.js";
-import {
-  registerSchema
-} from "./chunk-Q7US4OOA.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/research/keyword-gap.ts
-import { defineCommand } from "citty";
-registerSchema({
-  command: "research.keyword-gap",
-  description: "Find keywords a competitor ranks for (organic or paid) that you don't. Discovers expansion opportunities. If --location and --language are omitted, defaults to United States (us) and English (en). The response includes a query_context object showing which location/language were used.",
-  args: {
-    competitor: { type: "string", description: "Competitor domain (positional 1)", required: true },
-    ours: { type: "string", description: "Your domain (positional 2)", required: true },
-    location: {
-      type: "string",
-      description: "Country code (us, uk, es, de...) or DataForSEO location code. Defaults to us (United States); set it for any non-US market.",
-      required: false
-    },
-    language: {
-      type: "string",
-      description: "Language code or name. Defaults to en (English) if omitted \u2014 always set this for non-English markets",
-      required: false
-    },
-    type: { type: "string", description: "Filter: paid, organic, all (default: all)", required: false },
-    limit: { type: "string", description: "Max results per page (default: 50, max: 1000)", required: false },
-    offset: { type: "string", description: "Pagination offset (default: 0)", required: false },
-    "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
-  }
-});
-var FIELDS = {
-  keyword: "Keyword in the gap (they rank, you don't)",
-  search_volume: "Monthly search volume",
-  cpc: "Cost per click USD",
-  their_position: "Competitor's ranking position"
-};
-var keywordGapCommand = defineCommand({
-  meta: {
-    name: "keyword-gap",
-    description: `Find keywords a competitor has that you don't. Supports pagination via --offset.
-
-Examples:
-  baker research keyword-gap "competitor.com" "mysite.com"
-  baker research keyword-gap "competitor.com" "mysite.com" --type paid --limit 100
-  baker research keyword-gap "competitor.com" "mysite.com" --offset 50 --limit 50`
-  },
-  args: {
-    competitor: { type: "positional", description: "Competitor domain", required: true },
-    ours: { type: "positional", description: "Your domain", required: true },
-    location: { type: "string", description: "Country code or location code (default: us)", required: false },
-    language: { type: "string", description: "Language code or name (default: en)", required: false },
-    type: { type: "string", description: "Filter: paid, organic, all (default: all)", required: false },
-    limit: { type: "string", description: "Max results per page (default: 50, max: 1000)", required: false },
-    offset: { type: "string", description: "Pagination offset (default: 0)", required: false },
-    output: { type: "string", description: "Format: json|csv|md|jsonl", required: false, default: "json" },
-    "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
-  },
-  run: async ({ args }) => {
-    const competitor = args.competitor;
-    const ours = args.ours;
-    const location = args.location || void 0;
-    const language = args.language || void 0;
-    const type = args.type || void 0;
-    const limit = args.limit ? Number(args.limit) : void 0;
-    const offset = args.offset ? Number(args.offset) : void 0;
-    const skipCache = args["no-cache"] ? true : void 0;
-    const queryContext = buildResearchQueryContext(location, language);
-    try {
-      const result = await apiPost("/api/research/keyword-gap", {
-        competitor,
-        ours,
-        location,
-        language,
-        type,
-        limit,
-        offset,
-        skipCache
-      });
-      const currentOffset = offset ?? 0;
-      const currentLimit = limit ?? 50;
-      const hasMore = currentOffset + result.data.length < result.total_count;
-      warnDefaults(queryContext);
-      const format = args.output || "json";
-      if (format !== "json") {
-        writeResearchOutput(result.data, format);
-        writeResearchHints([RESEARCH_DATA_NOTE], format);
-        return;
-      }
-      writeResearchJson({
-        ok: true,
-        your_domain: ours,
-        competitor_domain: competitor,
-        data: result.data,
-        fields: FIELDS,
-        note: RESEARCH_DATA_NOTE,
-        total_count: result.total_count,
-        query_context: queryContext,
-        pagination: {
-          offset: currentOffset,
-          limit: currentLimit,
-          has_more: hasMore,
-          next_offset: hasMore ? currentOffset + currentLimit : void 0
-        }
-      });
-    } catch (err) {
-      handleResearchError(err);
-    }
-  }
-});
-export {
-  keywordGapCommand
-};
-//# sourceMappingURL=keyword-gap-SSWMMVI2.js.map

package/dist/keyword-metrics-6UKUK6GT.js

@@ -1,198 +0,0 @@
-import {
-  keywordMetricsHints
-} from "./chunk-DNSXOUNC.js";
-import {
-  RESEARCH_DATA_NOTE,
-  handleResearchError,
-  writeResearchHints,
-  writeResearchJson,
-  writeResearchOutput
-} from "./chunk-GSKZ3ZDO.js";
-import {
-  buildResearchQueryContext,
-  warnDefaults
-} from "./chunk-4D5HZ7V3.js";
-import "./chunk-43PAN3L2.js";
-import {
-  RESEARCH_KEYWORD_METRICS_MAX_KEYWORDS
-} from "./chunk-MWD6JTOY.js";
-import "./chunk-CAZGM2NX.js";
-import "./chunk-NZS3KEQ2.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-UI6BKYQD.js";
-import "./chunk-PTRCB7AR.js";
-import {
-  apiPost
-} from "./chunk-X7VQFLHI.js";
-import "./chunk-LU4HI4KI.js";
-import "./chunk-LGK7UWBN.js";
-import {
-  registerSchema
-} from "./chunk-Q7US4OOA.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/research/keyword-metrics.ts
-import { defineCommand } from "citty";
-
-// src/commands/research/keyword-metrics-rows.ts
-var KEYWORD_METRICS_SOURCE = "keyword_planner_estimate_via_dataforseo";
-function toOutputRow(row, options) {
-  const out = {
-    source: KEYWORD_METRICS_SOURCE,
-    keyword: row.keyword,
-    planner_search_volume: row.search_volume,
-    planner_cpc: row.cpc,
-    planner_low_top_of_page_bid: row.low_top_of_page_bid,
-    planner_high_top_of_page_bid: row.high_top_of_page_bid,
-    planner_competition: row.competition,
-    planner_competition_index: row.competition_index
-  };
-  if (options.clickstream) {
-    out.clickstream_search_volume = row.clickstream_search_volume;
-  }
-  if (options.full) {
-    out.keyword_difficulty = row.keyword_difficulty;
-    out.main_intent = row.main_intent;
-    out.planner_monthly_searches = row.monthly_searches;
-  }
-  return out;
-}
-function keywordMetricsFields(options) {
-  const fields = {
-    source: `Always "${KEYWORD_METRICS_SOURCE}". Every planner_ column below is Google's Keyword Planner ESTIMATE of total market volume, resold by DataForSEO \u2014 the same number \`baker ads google keywords metrics\` returns, not an independent measurement of it. Columns without the planner_ prefix are DataForSEO's own.`,
-    keyword: "The keyword asked for. A row with every metric null means DataForSEO holds no data on it \u2014 not that nobody searches it.",
-    planner_search_volume: "ESTIMATE: average monthly searches across the whole market, last 12 months",
-    planner_cpc: "ESTIMATE: average cost per click in USD (a single blended figure, not a top-of-page range)",
-    planner_low_top_of_page_bid: "ESTIMATE: low-range top-of-page bid in USD",
-    planner_high_top_of_page_bid: "ESTIMATE: high-range top-of-page bid in USD",
-    planner_competition: "ESTIMATE: competition level \u2014 LOW, MEDIUM or HIGH",
-    planner_competition_index: "ESTIMATE: competition index 0-100 (higher = more advertisers)"
-  };
-  if (options.clickstream) {
-    fields.clickstream_search_volume = "DataForSEO's OWN volume estimate, from clickstream panels \u2014 not Google's, and the only number here that is a genuine second opinion on demand. Expect it to differ from planner_search_volume; that is the point.";
-  }
-  if (options.full) {
-    fields.keyword_difficulty = "DataForSEO's 0-100 estimate of how hard ranking in the organic top 10 would be";
-    fields.main_intent = "DataForSEO's intent classification: informational, navigational, commercial or transactional";
-    fields.planner_monthly_searches = "ESTIMATE: 12-month volume breakdown ({year, month, search_volume})";
-  }
-  return fields;
-}
-
-// src/commands/research/keyword-metrics.ts
-registerSchema({
-  command: "research.keyword-metrics",
-  description: "Search volume, CPC, top-of-page bids and competition for a list of keywords you name \u2014 no domain needed. This is the command for sizing a market you have keywords for; the domain-bound ones (keywords-for-site, keyword-gap) answer a different question and should not be used as a workaround for this one. The volume is Google's Keyword Planner figure resold by DataForSEO, so it is not a second opinion on `baker ads google keywords metrics` \u2014 for that, pass --clickstream. If --location and --language are omitted, defaults to United States (us) and English (en). The response includes a query_context object showing which location/language were used.",
-  args: {
-    keywords: {
-      type: "string",
-      description: `Comma-separated keywords (max ${RESEARCH_KEYWORD_METRICS_MAX_KEYWORDS}, 80 chars each)`,
-      required: true
-    },
-    location: {
-      type: "string",
-      description: "Country code (us, mx, br, es...) or DataForSEO location code. Defaults to us (United States) if omitted \u2014 always set this for non-US markets",
-      required: false
-    },
-    language: {
-      type: "string",
-      description: "Language code or name. Defaults to en (English) if omitted \u2014 always set this for non-English markets",
-      required: false
-    },
-    clickstream: {
-      type: "boolean",
-      description: "Also return DataForSEO's own panel-derived volume (clickstream_search_volume), the only genuinely independent estimate of demand available here. Costs 2x.",
-      required: false
-    },
-    full: {
-      type: "boolean",
-      description: "Add keyword difficulty, search intent and the 12-month volume trend to each row",
-      required: false
-    },
-    "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
-  }
-});
-var keywordMetricsCommand = defineCommand({
-  meta: {
-    name: "keyword-metrics",
-    description: `Volume, CPC and competition for keywords you name. No domain required.
-
-Numbers are Keyword Planner ESTIMATES of total market volume, resold by DataForSEO \u2014 every column carrying one is named planner_. Pass --clickstream for DataForSEO's own independent estimate alongside.
-
-Examples:
-  baker research keyword-metrics "chatbot whatsapp,agente whatsapp ecommerce" --location mx --language es
-  baker research keyword-metrics "chatbot whatsapp" --location br --language pt --clickstream
-  baker research keyword-metrics "crm software,best crm" --full --output md`
-  },
-  args: {
-    keywords: { type: "positional", description: "Comma-separated keywords", required: true },
-    location: { type: "string", description: "Country code or location code (default: us)", required: false },
-    language: { type: "string", description: "Language code or name (default: en)", required: false },
-    clickstream: { type: "boolean", description: "Add DataForSEO's own volume estimate (costs 2x)", required: false },
-    full: { type: "boolean", description: "Add difficulty, intent and the 12-month trend", required: false },
-    output: { type: "string", description: "Format: json|csv|md|jsonl", required: false, default: "json" },
-    "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
-  },
-  run: async ({ args }) => {
-    const keywords = args.keywords.split(",").map((k) => k.trim()).filter(Boolean);
-    if (keywords.length === 0) {
-      writeResearchJson({
-        ok: false,
-        error: { code: "VALIDATION_ERROR", message: "Provide at least one keyword" }
-      });
-      process.exit(1);
-    }
-    if (keywords.length > RESEARCH_KEYWORD_METRICS_MAX_KEYWORDS) {
-      writeResearchJson({
-        ok: false,
-        error: {
-          code: "VALIDATION_ERROR",
-          message: `Maximum ${RESEARCH_KEYWORD_METRICS_MAX_KEYWORDS} keywords per request`,
-          fix: {
-            action: "retry_with_changes",
-            explanation: `You sent ${keywords.length}. Split the list into batches of ${RESEARCH_KEYWORD_METRICS_MAX_KEYWORDS} and run the command once per batch \u2014 each batch is a separate charge, so batch by priority.`
-          }
-        }
-      });
-      process.exit(1);
-    }
-    const location = args.location || void 0;
-    const language = args.language || void 0;
-    const clickstream = Boolean(args.clickstream);
-    const full = Boolean(args.full);
-    const queryContext = buildResearchQueryContext(location, language);
-    try {
-      const result = await apiPost("/api/research/keyword-metrics", {
-        keywords,
-        location,
-        language,
-        includeClickstream: clickstream,
-        skipCache: args["no-cache"] ? true : void 0
-      });
-      const columns = { clickstream, full };
-      const rows = result.data.map((row) => toOutputRow(row, columns));
-      const hints = keywordMetricsHints({ rows: result.data, asked: keywords, clickstream, queryContext });
-      warnDefaults(queryContext);
-      const format = args.output || "json";
-      if (format !== "json") {
-        writeResearchOutput(rows, format);
-        writeResearchHints([...hints, RESEARCH_DATA_NOTE], format);
-        return;
-      }
-      writeResearchJson({
-        ok: true,
-        data: rows,
-        fields: keywordMetricsFields(columns),
-        note: RESEARCH_DATA_NOTE,
-        hints,
-        query_context: queryContext
-      });
-    } catch (err) {
-      handleResearchError(err);
-    }
-  }
-});
-export {
-  keywordMetricsCommand
-};
-//# sourceMappingURL=keyword-metrics-6UKUK6GT.js.map