@koda-sl/baker-cli 0.384.0-dev.4699b7308 → 0.384.0-dev.557795bef

package/dist/chunk-RR3KT2E7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/google/write-shared.ts","../src/commands/ads/google/copy-list-usage.ts","../src/commands/ads/google/draft-status.ts","../src/commands/ads/google/stage-streak.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport {\n  GOOGLE_DRAFT_BATCH_MAX,\n  type GoogleDraftListResponse,\n  type GoogleDraftStageBatchResponse,\n  type GoogleDraftStageResponse,\n  googleDraftOpInputSchema,\n  OP_TOO_LARGE_FIX,\n  OP_TOO_LARGE_MESSAGE_START,\n  toMicros,\n} from \"@baker/api/ads-google\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../../client.ts\";\nimport { requireChatId, resolveChatId } from \"../../../env.ts\";\nimport { handleConnectionError, isNotConnectedError } from \"../../../error-handler.ts\";\nimport { repeatedValues } from \"../../../lib/repeatedFlags.ts\";\nimport { capabilityFix } from \"../../capabilities/fix.ts\";\nimport { booleanWordPositionalError } from \"../boolean-word-positional.ts\";\nimport { adCopyHints } from \"../copy-hints.ts\";\nimport { hintLines, withHints } from \"../hints.ts\";\nimport { writeJsonEnvelope } from \"../output.ts\";\nimport { copyListCountFix } from \"./copy-list-usage.ts\";\nimport { renderDraftStatus } from \"./draft-status.ts\";\nimport { recordSingleStage } from \"./stage-streak.ts\";\n\n/**\n * Shared plumbing for the staged Google Ads write commands. Writes NEVER hit\n * the Google Ads API directly: every command stages an op against this chat's\n * draft (`/api/ads/google/draft/stage`), the dashboard shows it as a pending\n * Google Ads change, and the draft applies as one `GoogleAdsService.Mutate`\n * request per advertiser account when the chat is published. `--customer-id` is\n * required on every write — a draft may span several accounts, so nothing is\n * picked for you.\n */\n\nexport function failWriteValidation(message: string): never {\n  writeJsonEnvelope({ ok: false, error: { code: \"VALIDATION_ERROR\", message } });\n  process.exit(1);\n}\n\nexport function requireCustomerId(args: Record<string, unknown>): string {\n  const raw = (args[\"customer-id\"] ?? args.customerId) as string | undefined;\n  if (!raw || !/^\\d{10}$/.test(raw)) {\n    failWriteValidation(\"pass --customer-id as the 10-digit Google Ads customer id (no dashes)\");\n  }\n  return raw;\n}\n\nexport function requireTarget(args: Record<string, unknown>, entity: string): string {\n  // `--flag false` is refused, not documented: citty parses it as the flag set to TRUE plus a stray\n  // positional nobody consumes, so on `conversions update --primary` it silently PROMOTES an action\n  // into what every Maximize Conversions campaign bids toward. Caught here because this is the only\n  // place on this surface that reads positionals, and every target-taking command goes through it.\n  const booleanWord = booleanWordPositionalError(args, entity);\n  if (booleanWord) {\n    failWriteValidation(booleanWord);\n  }\n  const positional = Array.isArray(args._) ? args._[0] : undefined;\n  const target = args.id ?? args.target ?? args.ref ?? positional;\n  if (typeof target !== \"string\" || target.length === 0) {\n    failWriteValidation(`pass the ${entity} resource name or id as the positional argument`);\n  }\n  return target;\n}\n\n/**\n * The targets a bulk status command was given: every positional (comma-separated ones split), plus\n * `--file` with one target per line (blank lines and `#` comments skipped), deduped in order. One\n * call then stages them all as one batch instead of one command per row.\n */\nexport function targetEntries(args: Record<string, unknown>, entity: string): string[] {\n  const booleanWord = booleanWordPositionalError(args, entity);\n  if (booleanWord) {\n    failWriteValidation(booleanWord);\n  }\n  const positionals = Array.isArray(args._) ? args._.filter((v): v is string => typeof v === \"string\") : [];\n  const raw = [...positionals.flatMap((v) => v.split(\",\")), ...rawFileEntries(args.file)]\n    .map((v) => v.trim())\n    .filter(Boolean);\n  const targets = [...new Set(raw)];\n  if (targets.length === 0) {\n    failWriteValidation(`pass the ${entity} resource name(s) as positional arguments and/or --file (one per line)`);\n  }\n  if (targets.length > GOOGLE_DRAFT_BATCH_MAX) {\n    failWriteValidation(`${targets.length} targets exceeds the batch limit of ${GOOGLE_DRAFT_BATCH_MAX} — split them`);\n  }\n  return targets;\n}\n\nexport function requireStringFlag(value: unknown, flag: string): string {\n  if (typeof value !== \"string\" || value.length === 0) {\n    failWriteValidation(`${flag} is required`);\n  }\n  return value;\n}\n\n/** Money flag in major currency units → micros. */\nexport function microsFlag(value: unknown, flag: string): number | undefined {\n  if (value === undefined || value === null || value === \"\") {\n    return undefined;\n  }\n  const num = Number(value);\n  if (Number.isNaN(num) || num <= 0) {\n    failWriteValidation(`${flag} must be a positive amount (major currency units, e.g. 50 or 50.00)`);\n  }\n  return toMicros(num);\n}\n\n/** Split a comma-separated flag into trimmed non-empty values. */\nexport function listFlag(value: unknown): string[] | undefined {\n  if (typeof value !== \"string\" || value.length === 0) {\n    return undefined;\n  }\n  const items = value\n    .split(\",\")\n    .map((v) => v.trim())\n    .filter(Boolean);\n  return items.length > 0 ? items : undefined;\n}\n\nexport interface KeywordEntry {\n  text: string;\n  matchType: string;\n}\n\nconst MATCH_TYPES = new Set([\"EXACT\", \"PHRASE\", \"BROAD\"]);\n\n/**\n * One raw keyword entry → { text, matchType }. A trailing `:EXACT|:PHRASE|:BROAD`\n * suffix overrides the default match type; colons and commas aren't legal in Google\n * keyword text, so the syntax is unambiguous.\n */\nfunction parseKeywordEntry(raw: string, defaultMatch: string | undefined): KeywordEntry {\n  const colon = raw.lastIndexOf(\":\");\n  if (colon > 0) {\n    const suffix = raw\n      .slice(colon + 1)\n      .trim()\n      .toUpperCase();\n    if (MATCH_TYPES.has(suffix)) {\n      return { text: raw.slice(0, colon).trim(), matchType: suffix };\n    }\n    failWriteValidation(`\"${raw}\": \":${raw.slice(colon + 1)}\" is not a match type (EXACT | PHRASE | BROAD)`);\n  }\n  if (!defaultMatch) {\n    failWriteValidation(`\"${raw}\" has no match type — add a :EXACT/:PHRASE/:BROAD suffix or pass --match-type`);\n  }\n  return { text: raw, matchType: defaultMatch };\n}\n\n/**\n * Raw --text value(s) → individual entries: repeated flags and comma-separated\n * both work. The repeats have to come off `rawArgs`, because citty parses a\n * repeated flag down to its last value alone.\n */\nfunction rawTextEntries(value: unknown, rawArgs: readonly string[] | undefined): string[] {\n  return repeatedValues(rawArgs, \"text\", value)\n    .flatMap((v) => v.split(\",\"))\n    .map((v) => v.trim())\n    .filter(Boolean);\n}\n\n/** Newline-separated keyword file: one `text[:MATCH_TYPE]` per line; blank lines and `#` comments skipped. */\nfunction rawFileEntries(path: unknown): string[] {\n  return typeof path === \"string\" && path.length > 0 ? fileLines(path) : [];\n}\n\n/** A text file's entries: one per line, trimmed; blank lines and `#` comments skipped. */\nexport function fileLines(path: string): string[] {\n  return readFileSync(path, \"utf8\")\n    .split(/\\r?\\n/)\n    .map((line) => line.trim())\n    .filter((line) => line.length > 0 && !line.startsWith(\"#\"));\n}\n\n/**\n * The keyword batch a command was invoked with: comma-separated `--text` entries\n * (optional `:MATCH_TYPE` suffix each) plus `--file` lines, deduped, each falling\n * back to `--match-type`. One entry stages exactly like before; many stage as one batch.\n */\nexport function keywordEntries(args: Record<string, unknown>, rawArgs?: readonly string[]): KeywordEntry[] {\n  const defaultMatch = typeof args[\"match-type\"] === \"string\" ? args[\"match-type\"].toUpperCase() : undefined;\n  const raw = [...rawTextEntries(args.text, rawArgs), ...rawFileEntries(args.file)];\n  if (raw.length === 0) {\n    failWriteValidation(\"pass keywords via --text (comma-separated) and/or --file (one per line)\");\n  }\n  if (raw.length > GOOGLE_DRAFT_BATCH_MAX) {\n    failWriteValidation(`${raw.length} keywords exceeds the batch limit of ${GOOGLE_DRAFT_BATCH_MAX}`);\n  }\n  const entries: KeywordEntry[] = [];\n  const seen = new Set<string>();\n  for (const item of raw) {\n    const entry = parseKeywordEntry(item, defaultMatch);\n    const key = JSON.stringify([entry.text, entry.matchType]);\n    if (!seen.has(key)) {\n      seen.add(key);\n      entries.push(entry);\n    }\n  }\n  return entries;\n}\n\n/**\n * The payloads behind `--file`: a path to a JSON file, or the JSON written inline. The file holds one\n * payload object, a JSON array of them, or JSON Lines (one object per line) — many payloads stage as\n * one batch, which is how a bulk change lands in one call instead of hundreds.\n *\n * Inline is here because every doc example already writes it that way — `packages/cli/README.md`\n * and the scaffold's `ads-google.md` both show `--file '{\"type\":\"image\",…}'` — while the arg only\n * ever read a path, so following the documentation answered with a raw ENOENT stack trace. Reading\n * a leading `{` or `[` as the payload makes those examples true rather than making the agent re-learn\n * the one shape that works.\n */\nexport function loadJsonPayloads(path: unknown): Array<Record<string, unknown>> {\n  if (typeof path !== \"string\" || path.length === 0) {\n    return [];\n  }\n  const inline = /^\\s*[[{]/.test(path);\n  const source = inline ? \"inline JSON\" : path;\n  const text = inline ? path : readFileSync(path, \"utf8\");\n  return parsedPayloads(text, source).map((item, index, all) => {\n    if (item === null || typeof item !== \"object\" || Array.isArray(item)) {\n      failWriteValidation(\n        all.length === 1 ? `${source} must contain a JSON object` : `${source}: item ${index} must be a JSON object`,\n      );\n    }\n    return item as Record<string, unknown>;\n  });\n}\n\n/** One JSON value (an array spreads into its items), else JSON Lines; the JSON error when neither parses. */\nfunction parsedPayloads(text: string, source: string): unknown[] {\n  try {\n    const parsed = JSON.parse(text) as unknown;\n    return Array.isArray(parsed) ? parsed : [parsed];\n  } catch (err) {\n    if (!(err instanceof SyntaxError)) {\n      throw err;\n    }\n    const lines = text.split(/\\r?\\n/).filter((line) => line.trim().length > 0);\n    if (lines.length > 1) {\n      return lines.map((line, index) => parseJsonLine(line, index, source));\n    }\n    failWriteValidation(`${source} is not valid JSON: ${err.message}`);\n  }\n}\n\n/** One JSON Lines entry, or the line's own error naming where it is. */\nfunction parseJsonLine(line: string, index: number, source: string): unknown {\n  try {\n    return JSON.parse(line) as unknown;\n  } catch (err) {\n    return failWriteValidation(\n      `${source} line ${index + 1} is not valid JSON: ${err instanceof Error ? err.message : String(err)}`,\n    );\n  }\n}\n\n/** The ONE op payload behind `--file`, for commands that change a single entity. */\nexport function loadJsonFileArg(path: unknown): Record<string, unknown> {\n  const payloads = loadJsonPayloads(path);\n  if (payloads.length > 1) {\n    failWriteValidation(\n      `this command changes one entity, and --file holds ${payloads.length} payloads — stage many changes from one file with \\`baker ads google draft stage --file\\` (one op per item: {\"kind\",\"customerId\",\"target\"?,\"payload\"?})`,\n    );\n  }\n  return payloads[0] ?? {};\n}\n\n/** Flags override file keys — the file is the base, flags are the overrides. */\nexport function mergePayload(file: Record<string, unknown>, flags: Record<string, unknown>): Record<string, unknown> {\n  const merged: Record<string, unknown> = { ...file };\n  for (const [key, value] of Object.entries(flags)) {\n    if (value !== undefined) {\n      merged[key] = value;\n    }\n  }\n  return merged;\n}\n\n/**\n * The `draft amend` patch: exactly one of `--file <path>` (JSON file) or `--patch '<json>'`\n * (inline string), and it must parse to a JSON object — RFC-7386 merge-patch needs an object to\n * merge, and a stray array/scalar would silently no-op or replace the whole payload.\n */\nexport function loadPatchArg(args: Record<string, unknown>): Record<string, unknown> {\n  const file = typeof args.file === \"string\" && args.file.length > 0 ? args.file : undefined;\n  const inline = typeof args.patch === \"string\" && args.patch.length > 0 ? args.patch : undefined;\n  if (Boolean(file) === Boolean(inline)) {\n    failWriteValidation(\"pass exactly one of --file <patch.json> or --patch '<json>'\");\n  }\n  if (file) {\n    return loadJsonFileArg(file);\n  }\n  try {\n    const parsed = JSON.parse(inline as string) as unknown;\n    if (parsed === null || typeof parsed !== \"object\" || Array.isArray(parsed)) {\n      failWriteValidation(\"--patch must be a JSON object\");\n    }\n    return parsed as Record<string, unknown>;\n  } catch (err) {\n    if (err instanceof SyntaxError) {\n      failWriteValidation(`--patch is not valid JSON: ${err.message}`);\n    }\n    throw err;\n  }\n}\n\nexport function handleGoogleError(err: unknown): never {\n  if (err instanceof ApiError) {\n    // Covers both \"no connection\" and staging's 403 for an account this company\n    // never connected — same remedy either way: connect, and pick the account.\n    if (isNotConnectedError(err.code, err.message)) {\n      handleConnectionError(\"google_ads\", err.message);\n    }\n    if (err.message.includes(OP_TOO_LARGE_MESSAGE_START)) {\n      writeJsonEnvelope({\n        ok: false,\n        error: {\n          code: \"OP_TOO_LARGE\",\n          message: err.message,\n          retryable: false,\n          fix: { action: \"split_the_change\", explanation: OP_TOO_LARGE_FIX },\n        },\n      });\n      process.exit(1);\n    }\n    writeJsonEnvelope({ ok: false, error: { code: err.code ?? \"API_ERROR\", message: err.message } });\n    process.exit(1);\n  }\n  writeJsonEnvelope({\n    ok: false,\n    error: { code: \"UNKNOWN\", message: err instanceof Error ? err.message : String(err) },\n  });\n  process.exit(1);\n}\n\ninterface StageEnvelope extends Record<string, unknown> {\n  ok: true;\n  data: GoogleDraftStageResponse;\n}\n\n/**\n * A no-op response isn't a failure — the change was already in place, so nothing was\n * staged. Say so explicitly, otherwise the agent re-stages it or reports work it\n * didn't do.\n */\nfunction noopHints(data: GoogleDraftStageResponse): string[] {\n  return data.staged\n    ? []\n    : [`NOT STAGED — ${data.reason}. Nothing to publish for this change; say so rather than reporting it as done.`];\n}\n\n/**\n * What to tell the agent about the ops a batch didn't stage.\n *\n * Two different things land in `skipped`: a change already in place, and a change Google refuses\n * outright (editing an experiment campaign's status, dates or budget). This hint used to assert the\n * first — \"already in the requested state\" — which read as \"done\" for a refusal the user never heard\n * about. So it leads with each op's own reason and asks for the refusals to be passed on.\n */\nexport function skippedHints(skipped: Array<{ summary: string; reason: string }>, total: number): string[] {\n  if (skipped.length === 0) {\n    return [];\n  }\n  const detail = skipped.map((s) => `${s.summary} — ${s.reason}`).join(\"; \");\n  return [\n    `${skipped.length} of ${total} op(s) NOT STAGED: ${detail}. Don't re-stage them; tell the user which changes couldn't be made and why, then carry on with the rest.`,\n  ];\n}\n\n/**\n * Preflight-validates the op against the shared `@baker/api/ads-google`\n * contract (the same schema the backend enforces), then stages it. Prints the\n * staged envelope — ref, mode (always `live`: publishing reaches the real\n * account), summary, warnings.\n */\nexport async function stageGoogleOp(raw: Record<string, unknown>, hints?: string[]): Promise<void> {\n  const preflight = googleDraftOpInputSchema.safeParse(raw);\n  if (!preflight.success) {\n    const fields = preflight.error.issues.map((issue) => ({ path: issue.path.join(\".\"), message: issue.message }));\n    writeJsonEnvelope({\n      ok: false,\n      error: {\n        code: \"VALIDATION_ERROR\",\n        message: fields.map((f) => (f.path ? `${f.path}: ${f.message}` : f.message)).join(\"; \"),\n        fields,\n        fix: copyListCountFix(raw, preflight.error.issues) ?? capabilityFix(\"google-ads\"),\n      },\n    });\n    process.exit(1);\n  }\n  try {\n    const chatId = requireChatId();\n    const response = await apiPost<StageEnvelope>(\"/api/ads/google/draft/stage\", { chatId, op: preflight.data });\n    const allHints = [\n      ...noopHints(response.data),\n      ...recordSingleStage(chatId, preflight.data.kind),\n      ...(hints ?? []),\n      ...(await adCopyHints(preflight.data)),\n    ];\n    writeJsonEnvelope(withHints(response, allHints));\n  } catch (err) {\n    handleGoogleError(err);\n  }\n}\n\n/** Stage a create op: `{ kind, customerId, payload }`. */\nexport async function stageCreate(\n  kind: string,\n  customerId: string,\n  payload: Record<string, unknown>,\n  hints?: string[],\n): Promise<void> {\n  await stageGoogleOp({ kind, customerId, payload }, hints);\n}\n\ninterface StageBatchEnvelope extends Record<string, unknown> {\n  ok: true;\n  data: GoogleDraftStageBatchResponse;\n}\n\n/**\n * A batch reads every target's before-state and checks each op against the account, which for a few\n * hundred removals outlasts the default 60 s. Timing out early reported a batch as failed that went on\n * to stage, so a retry then collided with the ops it had already staged.\n */\nconst STAGE_BATCH_TIMEOUT_MS = 5 * 60_000;\n\n/**\n * Stage several ops as ONE request (`/stage-batch`) — all-or-nothing on the backend,\n * one rate-limit hit instead of one per keyword. A single op falls through to the\n * plain stage path so its envelope (and amend behavior) stays exactly as before.\n */\nexport async function stageGoogleOps(rawOps: Array<Record<string, unknown>>, hints?: string[]): Promise<void> {\n  if (rawOps.length === 1 && rawOps[0]) {\n    await stageGoogleOp(rawOps[0], hints);\n    return;\n  }\n  const ops: unknown[] = [];\n  for (const [index, raw] of rawOps.entries()) {\n    const preflight = googleDraftOpInputSchema.safeParse(raw);\n    if (!preflight.success) {\n      const fields = preflight.error.issues.map((issue) => ({\n        path: `ops[${index}].${issue.path.join(\".\")}`,\n        message: issue.message,\n      }));\n      writeJsonEnvelope({\n        ok: false,\n        error: {\n          code: \"VALIDATION_ERROR\",\n          message: fields.map((f) => `${f.path}: ${f.message}`).join(\"; \"),\n          fields,\n          fix: copyListCountFix(raw, preflight.error.issues) ?? capabilityFix(\"google-ads\"),\n        },\n      });\n      process.exit(1);\n    }\n    ops.push(preflight.data);\n  }\n  try {\n    const chatId = requireChatId();\n    const response = await apiPost<StageBatchEnvelope>(\n      \"/api/ads/google/draft/stage-batch\",\n      { chatId, ops },\n      { timeoutMs: STAGE_BATCH_TIMEOUT_MS },\n    );\n    const allHints = [\n      ...skippedHints(response.data.skipped ?? [], ops.length),\n      ...(hints ?? []),\n      ...(await adCopyHints(ops)),\n    ];\n    writeJsonEnvelope(withHints(response, allHints));\n  } catch (err) {\n    handleGoogleError(err);\n  }\n}\n\n/** Stage an update op: `{ kind, customerId, target, payload }`. */\nexport async function stageUpdate(\n  kind: string,\n  customerId: string,\n  target: string,\n  payload: Record<string, unknown>,\n  hints?: string[],\n): Promise<void> {\n  await stageGoogleOp({ kind, customerId, target, payload }, hints);\n}\n\n/** Stage a target-only op (pause/resume/remove/detach): `{ kind, customerId, target }`. */\nexport async function stageTarget(kind: string, customerId: string, target: string, hints?: string[]): Promise<void> {\n  await stageGoogleOp({ kind, customerId, target }, hints);\n}\n\nexport async function draftAction(path: string, body: Record<string, unknown>, chat?: unknown): Promise<void> {\n  try {\n    const chatId = resolveChatId(chat);\n    const response = await apiPost<Record<string, unknown>>(path, { chatId, ...body });\n    writeJsonEnvelope(response);\n  } catch (err) {\n    handleGoogleError(err);\n  }\n}\n\ninterface DraftListEnvelope extends Record<string, unknown> {\n  ok: boolean;\n  data?: GoogleDraftListResponse;\n}\n\n/**\n * List the staged draft. By default renders a readable campaign ▸ ad group ▸ ad status tree so the\n * agent can review everything it has staged at a glance; `--json` returns the raw envelope for tools.\n */\nexport async function draftListAction(json: boolean, chat?: unknown): Promise<void> {\n  try {\n    const chatId = resolveChatId(chat);\n    const response = await apiPost<DraftListEnvelope>(\"/api/ads/google/draft\", { chatId });\n    if (json || !response.ok || !response.data) {\n      writeJsonEnvelope(response);\n      return;\n    }\n    process.stdout.write(`${renderDraftStatus(response.data)}${hintLines(response)}\\n`);\n  } catch (err) {\n    handleGoogleError(err);\n  }\n}\n\nexport const customerIdArg = {\n  \"customer-id\": { type: \"string\" as const, description: \"10-digit Google Ads customer id\" },\n};\nexport const fileArg = {\n  file: {\n    type: \"string\" as const,\n    description: \"The op payload: a JSON file path, or the JSON object inline (flags override it)\",\n  },\n};\nexport const fileBatchArg = {\n  file: {\n    type: \"string\" as const,\n    description:\n      \"The op payload: a JSON file path or inline JSON — one object, or a JSON array / JSON Lines of objects to stage many in one call (up to 500)\",\n  },\n};\n\n/** A create command whose payload is a JSON file or inline JSON — one object or an array staged as one batch. */\nexport function fileCreateCommand(\n  name: string,\n  kind: string,\n  description: string,\n  hints?: string[] | ((payload: Record<string, unknown>) => string[]),\n) {\n  return defineCommand({\n    meta: { name, description },\n    args: { ...customerIdArg, ...fileBatchArg },\n    run: async ({ args }) => {\n      const customerId = requireCustomerId(args);\n      const payloads = loadJsonPayloads(args.file);\n      if (payloads.length === 0 || payloads.some((payload) => Object.keys(payload).length === 0)) {\n        failWriteValidation(`${kind} needs --file with the op payload (one object, or a JSON array to stage many)`);\n      }\n      if (payloads.length > GOOGLE_DRAFT_BATCH_MAX) {\n        failWriteValidation(\n          `${payloads.length} payloads exceeds the batch limit of ${GOOGLE_DRAFT_BATCH_MAX} — split the file`,\n        );\n      }\n      const payloadHints = [\n        ...new Set(payloads.flatMap((payload) => (typeof hints === \"function\" ? hints(payload) : (hints ?? [])))),\n      ];\n      await stageGoogleOps(\n        payloads.map((payload) => ({ kind, customerId, payload })),\n        payloadHints,\n      );\n    },\n  });\n}\n\n/**\n * `--bid-modifier` as a number, validated against the range Google actually accepts.\n *\n * Rejecting the (0, 0.1) gap here rather than at the backend is the point: 0 and 0.1 are a hundredth\n * apart in value and mean \"never serve\" versus \"bid a tenth\", so a typo between them is a real spend\n * decision, and the error should arrive before anything is staged.\n */\nexport function bidModifierFlag(value: unknown): number {\n  if (value === undefined || value === null || value === \"\") {\n    failWriteValidation(\n      \"--bid-modifier is required: 1 for no adjustment, 1.25 to bid 25% more, 0.9 to bid 10% less, 0 to stop serving on a device\",\n    );\n  }\n  const num = Number(value);\n  if (Number.isNaN(num) || num < 0 || num > 10 || (num > 0 && num < 0.1)) {\n    failWriteValidation(\"--bid-modifier must be 0 (stop serving on it) or between 0.1 and 10.0\");\n  }\n  return num;\n}\n","import type { z } from \"zod\";\n\n/** Appended to each copy flag's help, so `--help` and `baker schema` say how to pass a comma. */\nexport const AD_COPY_LIST_USAGE =\n  \"repeat the flag once per item, or pass one comma-separated list and wrap an item that contains a comma in double quotes: '\\\"Fast, free quotes\\\",Book today'. A flag given once is read as a list, so a lone item with a comma needs its double quotes too: '\\\"Fast, free quotes\\\"'\";\n\n/** The op's copy-list fields, by the flag an agent passes them with. */\nconst COPY_LIST_FLAG: Readonly<Record<string, string>> = {\n  headlines: \"--headlines\",\n  descriptions: \"--descriptions\",\n  longHeadlines: \"--long-headlines\",\n};\n\ninterface CountRefusal {\n  flag: string;\n  count: number | undefined;\n  bound: string;\n  tooMany: boolean;\n}\n\nfunction valueAt(root: unknown, path: readonly PropertyKey[]): unknown {\n  let node = root;\n  for (const key of path) {\n    if (node === null || typeof node !== \"object\") return undefined;\n    node = (node as Record<PropertyKey, unknown>)[key];\n  }\n  return node;\n}\n\nfunction countRefusal(op: unknown, issue: z.core.$ZodIssue): CountRefusal | undefined {\n  if ((issue.code !== \"too_big\" && issue.code !== \"too_small\") || issue.origin !== \"array\") return undefined;\n  const flag = COPY_LIST_FLAG[String(issue.path.at(-1))];\n  if (!flag) return undefined;\n  const value = valueAt(op, issue.path);\n  const count = Array.isArray(value) ? value.length : undefined;\n  return issue.code === \"too_big\"\n    ? { flag, count, bound: `at most ${issue.maximum}`, tooMany: true }\n    : { flag, count, bound: `at least ${issue.minimum}`, tooMany: false };\n}\n\n/**\n * The fix for a stage refused only for how many headlines, descriptions or long headlines it has.\n *\n * That is a limit on a field the agent named correctly, so the generic \"read `baker capabilities`,\n * do not guess another field name\" sent it through draft list, schema and --help before it saw the\n * cause. Too many items is usually copy cut at its commas — a flag given once is a comma-separated\n * list, so \"Rated 4,5/5\" becomes two items — which is why that case names the forms that keep a\n * comma. Undefined when anything else was refused too, so the capabilities pointer still covers it.\n */\nexport function copyListCountFix(\n  op: unknown,\n  issues: readonly z.core.$ZodIssue[],\n): { action: string; explanation: string } | undefined {\n  const refusals = issues.map((issue) => countRefusal(op, issue));\n  if (refusals.length === 0 || refusals.some((refusal) => refusal === undefined)) return undefined;\n  const counted = refusals.filter((refusal): refusal is CountRefusal => refusal !== undefined);\n  const limits = counted\n    .map(({ flag, count, bound }) => `${flag} has ${count ?? \"the wrong number of\"} items; this ad takes ${bound}.`)\n    .join(\" \");\n  const commaCause = counted.some((refusal) => refusal.tooMany)\n    ? ' If you meant fewer items, the copy was cut at its commas: a flag given once is read as a comma-separated list, so an item with a comma in it (\"Fast, free quotes\", a decimal like \"4,5/5\") becomes two. To keep a comma, ' +\n      `${AD_COPY_LIST_USAGE} — or put the content in --file as JSON.`\n    : \"\";\n  return {\n    action: \"fix_copy_list_count\",\n    explanation: `${limits}${commaCause} ${commaCause ? \"Otherwise add\" : \"Add\"} or drop items to fit the limit, then stage again; the field names are right.`,\n  };\n}\n","import type {\n  GoogleDraftListResponse,\n  GoogleDraftStatusCollection,\n  GoogleDraftStatusNode,\n} from \"@baker/api/ads-google\";\n\n/**\n * Render the staged Google Ads draft as a readable campaign ▸ ad group ▸ ad tree — the CLI\n * counterpart to the dashboard's Google Ads tab, so an agent can review everything it has staged\n * with one command instead of reading raw JSON. Pure: takes the draft-list response, returns text.\n */\n\nconst OPERATION_LABELS: Record<string, string> = {\n  create: \"Creating\",\n  update: \"Updating\",\n  pause: \"Pausing\",\n  resume: \"Resuming\",\n  remove: \"Removing\",\n};\n\nfunction badge(node: GoogleDraftStatusNode): string {\n  const label = node.operation ? OPERATION_LABELS[node.operation] : undefined;\n  if (label) {\n    return label;\n  }\n  return node.existing ? \"on Google Ads\" : \"staged\";\n}\n\nfunction collectionLine(collection: GoogleDraftStatusCollection): string | undefined {\n  const parts: string[] = [];\n  if (collection.added > 0) {\n    parts.push(`+${collection.added}`);\n  }\n  if (collection.existing > 0) {\n    parts.push(`${collection.existing} existing`);\n  }\n  if (collection.removed > 0) {\n    parts.push(`-${collection.removed}`);\n  }\n  // Neither an add nor a remove — a member that stays in the set with a changed value (a device's\n  // bid adjustment). Left out, a draft whose only criterion change is one printed no line at all.\n  if ((collection.updated ?? 0) > 0) {\n    parts.push(`~${collection.updated}`);\n  }\n  return parts.length > 0 ? `${collection.label}: ${parts.join(\", \")}` : undefined;\n}\n\n/**\n * Every advertiser account the tree touches. A draft may legitimately span\n * several, and a criterion id is derived from the keyword's text and match type\n * — so the same keyword carries the same id in every account. The account is\n * printed on each node once there is more than one, and left off when there is not.\n */\nfunction accountsInTree(nodes: readonly GoogleDraftStatusNode[]): Set<string> {\n  const accounts = new Set<string>();\n  const walk = (node: GoogleDraftStatusNode): void => {\n    accounts.add(node.customerId);\n    for (const child of node.children) {\n      walk(child);\n    }\n  };\n  for (const node of nodes) {\n    walk(node);\n  }\n  return accounts;\n}\n\nfunction renderNode(node: GoogleDraftStatusNode, depth: number, lines: string[], showAccount: boolean): void {\n  const indent = \"  \".repeat(depth);\n  const account = showAccount ? ` · account ${node.customerId}` : \"\";\n  lines.push(`${indent}• ${node.name} · ${badge(node)}${account}`);\n  for (const warning of node.warnings ?? []) {\n    lines.push(`${indent}    ⚠ ${warning}`);\n  }\n  for (const collection of node.collections) {\n    const line = collectionLine(collection);\n    if (line) {\n      lines.push(`${indent}    ${line}`);\n    }\n  }\n  for (const child of node.children) {\n    renderNode(child, depth + 1, lines, showAccount);\n  }\n}\n\nconst RESOURCE_ENTITIES = new Set([\n  \"sharedSet\",\n  \"biddingStrategy\",\n  \"audience\",\n  \"conversionAction\",\n  \"label\",\n  \"budget\",\n  \"asset\",\n]);\n\nfunction renderSection(title: string, nodes: GoogleDraftStatusNode[], lines: string[], showAccount: boolean): void {\n  if (nodes.length === 0) {\n    return;\n  }\n  lines.push(\"\");\n  lines.push(title);\n  for (const node of nodes) {\n    renderNode(node, 1, lines, showAccount);\n  }\n}\n\nfunction renderAdvisories(data: GoogleDraftListResponse, lines: string[]): void {\n  const advisories = data.advisories ?? [];\n  // Every advisory is phrased as something to settle BEFORE publishing. On a published draft there\n  // is nothing left to settle here, and printing them reads as work still outstanding on this chat.\n  if (advisories.length === 0 || data.status === \"applied\") {\n    return;\n  }\n  lines.push(\"\");\n  // Two kinds of finding share this block: build-out nudges (\"this ad group has one ad\") and\n  // whole-draft coherence findings (\"this campaign will report zero conversions\", \"two of your\n  // campaigns bid on the same keyword\"). The coherence ones come first and cost money, so the\n  // heading no longer frames the block as optional polish.\n  lines.push(\"Advisories (non-blocking, checked across the whole draft — settle these before you publish)\");\n  for (const advisory of advisories) {\n    lines.push(`  • ${advisory.message}`);\n  }\n}\n\n/**\n * What the publish did, once there is a publish to report.\n *\n * A published Google Ads draft rendered exactly like a staged one — same count, every op still\n * reading \"Creating\" — so the surface `.claude/rules/cli-env.md` sends an agent to for the outcome\n * could not answer, and a failed op was invisible in the human output while sitting in the JSON\n * envelope the whole time. Found by publishing a BUSINESS_LOGO link that Google refused with\n * \"Customer is not verified\": the draft still read \"4 staged changes\". LinkedIn fixed the same\n * shape first; this is its counterpart.\n */\nfunction renderOutcome(data: GoogleDraftListResponse, lines: string[]): void {\n  const counts = new Map<string, number>();\n  for (const op of data.ops) {\n    const status = op.result?.status ?? \"pending\";\n    counts.set(status, (counts.get(status) ?? 0) + 1);\n  }\n  const summary = [...counts].map(([status, count]) => `${count} ${status}`).join(\", \");\n  lines.push(`Google Ads — published · ${summary || `${data.count} op(s)`} · ${data.mode}`);\n  // A failure is the reason to read this at all, so it is named with its error rather than left as\n  // a number to go and look up.\n  for (const op of data.ops) {\n    const status = op.result?.status;\n    if (status !== \"failed\" && status !== \"skipped\") {\n      continue;\n    }\n    const reason = op.result?.error ?? op.result?.skippedBecause ?? \"no reason recorded\";\n    lines.push(`  ✗ ${op.summary} — ${status}: ${reason}`);\n  }\n}\n\nexport function renderDraftStatus(data: GoogleDraftListResponse): string {\n  if (data.status === \"none\" || data.count === 0) {\n    return \"No staged Google Ads changes on this chat.\";\n  }\n  const modeNote =\n    data.mode === \"live\"\n      ? \"Live — publishing writes directly to Google Ads.\"\n      : \"Simulated — publishing completes the whole draft without calling Google Ads.\";\n  const lines: string[] = [];\n  if (data.status === \"applied\") {\n    renderOutcome(data, lines);\n  } else if (data.status === \"publishing\") {\n    lines.push(`Google Ads — publishing ${data.count} change${data.count === 1 ? \"\" : \"s\"} · ${data.mode}`);\n  } else {\n    lines.push(`Google Ads — ${data.count} staged change${data.count === 1 ? \"\" : \"s\"} · ${data.mode}`);\n  }\n  lines.push(modeNote);\n\n  const tree = data.tree ?? [];\n  const showAccount = accountsInTree(tree).size > 1;\n  renderSection(\n    \"Shared resources\",\n    tree.filter((node) => RESOURCE_ENTITIES.has(node.entity)),\n    lines,\n    showAccount,\n  );\n  renderSection(\n    \"Campaigns\",\n    tree.filter((node) => node.entity === \"campaign\"),\n    lines,\n    showAccount,\n  );\n  const rest = tree.filter((node) => !RESOURCE_ENTITIES.has(node.entity) && node.entity !== \"campaign\");\n  renderSection(\"Other\", rest, lines, showAccount);\n  renderAdvisories(data, lines);\n\n  return lines.join(\"\\n\");\n}\n","import { cacheGet, cacheSet } from \"../cache.ts\";\n\n/**\n * Bulk work done as a loop of single commands — one `keywords update` per keyword, one\n * `negative-keywords remove` per term — is one request, one rate-limit hit and one tool call per row;\n * production saw 1,284 of them. The CLI cannot see the loop from inside one call, so it remembers the\n * last few single stages per chat and, once the same kind repeats, says how to do the rest in one call.\n */\n\nexport interface StageStreak {\n  kind: string;\n  count: number;\n  lastAt: number;\n}\n\n/** Singles further apart than this are separate decisions, not a loop. */\nconst STREAK_WINDOW_MS = 5 * 60_000;\n/** The streak length that reads as a loop. */\nconst STREAK_THRESHOLD = 5;\n\nexport function nextStageStreak(previous: StageStreak | undefined, kind: string, now: number): StageStreak {\n  const continues = previous && previous.kind === kind && now - previous.lastAt <= STREAK_WINDOW_MS;\n  return { kind, count: continues ? previous.count + 1 : 1, lastAt: now };\n}\n\n/** The one-call form of a kind, where a command has one beside `draft stage --file`. */\nconst BATCH_FORMS: Record<string, string> = {\n  \"google.keyword.add\": \"`keywords add --file keywords.txt` (one term[:MATCH_TYPE] per line)\",\n  \"google.keyword.update\":\n    \"`keywords pause|resume <resource name> <resource name>…` (or --file, one per line) for status\",\n  \"google.keyword.remove\": \"`draft stage --file` with one google.keyword.remove per target\",\n  \"google.negativeKeyword.add\": \"`negative-keywords add --file terms.txt`\",\n  \"google.sharedSetMember.add\": \"`keyword-lists add --file terms.txt`\",\n  \"google.sharedSetMember.remove\": '`keyword-lists remove --list-ref <id> --text \"a,b,c\"`',\n};\n\nexport function stageStreakHints(streak: StageStreak): string[] {\n  if (streak.count < STREAK_THRESHOLD) {\n    return [];\n  }\n  const form = BATCH_FORMS[streak.kind];\n  return [\n    `LOOP: that is ${streak.count} ${streak.kind} ops staged one command at a time. Stop looping — put every remaining change in one file and stage them in ONE call: \\`baker ads google draft stage --file ops.json --customer-id <id>\\` (a JSON array of {\"kind\",\"target\"?,\"payload\"?}, up to 500, any mix of kinds)${form ? `, or ${form}` : \"\"}. Fix staged ops together with \\`draft amend --file\\`.`,\n  ];\n}\n\nconst STREAK_CACHE = \"stage-streak\";\n\n/** Record one single stage on this chat and return the nudge it earns, if any. Never throws. */\nexport function recordSingleStage(chatId: string, kind: string): string[] {\n  try {\n    const streak = nextStageStreak(cacheGet<StageStreak>(STREAK_CACHE, chatId)?.data, kind, Date.now());\n    cacheSet(STREAK_CACHE, chatId, streak, STREAK_WINDOW_MS);\n    return stageStreakHints(streak);\n  } catch {\n    return [];\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-SEPPFM5S.js

@@ -0,0 +1,228 @@
+import {
+  NUMERIC_ID_REGEX
+} from "./chunk-I2DNBEV6.js";
+
+// ../api/src/ads-google/change-history.ts
+var CHANGE_SCOPES = ["detail", "summary"];
+var CHANGE_SCOPE_MAX_DAYS = {
+  detail: 30,
+  summary: 90
+};
+var DEFAULT_CHANGE_DAYS = 7;
+var MAX_CHANGE_DAYS = CHANGE_SCOPE_MAX_DAYS.summary;
+function isChangeLookbackWithinReach(days, scope) {
+  return days <= CHANGE_SCOPE_MAX_DAYS[scope];
+}
+
+// ../api/src/ads-google/keyword-planning.ts
+import { z } from "zod";
+var ISO_DATE = /^\d{4}-\d{2}-\d{2}$/;
+var micros = z.number().int().positive();
+var FORECAST_MATCH_TYPES = ["EXACT", "PHRASE", "BROAD"];
+var googleForecastBiddingSchema = z.discriminatedUnion("strategy", [
+  z.object({ strategy: z.literal("MANUAL_CPC"), maxCpcBidMicros: micros, dailyBudgetMicros: micros.optional() }),
+  z.object({
+    strategy: z.literal("MAXIMIZE_CLICKS"),
+    dailyTargetSpendMicros: micros,
+    maxCpcBidCeilingMicros: micros.optional()
+  }),
+  z.object({ strategy: z.literal("MAXIMIZE_CONVERSIONS"), dailyTargetSpendMicros: micros })
+]);
+var googleKeywordForecastRequestSchema = z.object({
+  customerId: z.string().regex(NUMERIC_ID_REGEX, "customerId must be the bare numeric customer id"),
+  managerId: z.string().optional(),
+  /** One forecast ad group per entry; most forecasts are a single group. */
+  adGroups: z.array(
+    z.object({
+      keywords: z.array(z.object({ text: z.string().trim().min(1).max(80), matchType: z.enum(FORECAST_MATCH_TYPES) })).min(1)
+    })
+  ).min(1),
+  locationIds: z.array(z.string().regex(NUMERIC_ID_REGEX)).optional(),
+  languageId: z.string().regex(NUMERIC_ID_REGEX).optional(),
+  bidding: googleForecastBiddingSchema,
+  /** Must start in the future and end within a year. Without them Baker forecasts the 30 days from tomorrow. */
+  startDate: z.string().regex(ISO_DATE).optional(),
+  endDate: z.string().regex(ISO_DATE).optional(),
+  currencyCode: z.string().length(3).optional()
+}).refine((body) => body.startDate === void 0 === (body.endDate === void 0), {
+  message: "Give both --start and --end, or neither (the forecast then covers the 30 days from tomorrow)",
+  path: ["endDate"]
+});
+var KEYWORD_FORECAST_SOURCE = "keyword_planner_forecast";
+var googleKeywordForecastResponseSchema = z.object({
+  source: z.literal(KEYWORD_FORECAST_SOURCE),
+  period: z.object({ startDate: z.string(), endDate: z.string() }),
+  forecast_clicks: z.number().nullable(),
+  forecast_cost_micros: z.number().nullable(),
+  forecast_conversions: z.number().nullable(),
+  forecast_average_cpc_micros: z.number().nullable(),
+  forecast_average_cpa_micros: z.number().nullable()
+});
+var googleAdGroupThemesRequestSchema = z.object({
+  customerId: z.string().regex(NUMERIC_ID_REGEX, "customerId must be the bare numeric customer id"),
+  managerId: z.string().optional(),
+  keywords: z.array(z.string().trim().min(1)).min(1),
+  /** Existing ad groups to sort the keywords into: numeric ids or `customers/{cid}/adGroups/{id}`. */
+  adGroups: z.array(z.string().min(1)).min(1)
+});
+var googleAdGroupThemesResponseSchema = z.object({
+  suggestions: z.array(
+    z.object({
+      keyword: z.string(),
+      suggested_keyword: z.string(),
+      match_type: z.string(),
+      ad_group: z.string(),
+      campaign: z.string()
+    })
+  ),
+  unusable_ad_groups: z.array(z.object({ ad_group: z.string(), campaign: z.string() }))
+});
+
+// ../api/src/ads-google/url-options.ts
+import { z as z2 } from "zod";
+var URL_OPTION_LEVELS = ["account", "campaign", "ad_group", "ad"];
+var googleUrlOptionValueSchema = z2.discriminatedUnion("state", [
+  z2.object({ state: z2.literal("set"), value: z2.string() }),
+  z2.object({ state: z2.literal("not_set") }),
+  z2.object({ state: z2.literal("not_read"), reason: z2.string() })
+]);
+var googleUrlOptionsRequestSchema = z2.object({
+  customerId: z2.string().regex(NUMERIC_ID_REGEX, "customerId must be the bare numeric customer id"),
+  managerId: z2.string().optional(),
+  /** Compact by default: only campaigns that actually override the account. `full` lists every campaign. */
+  full: z2.boolean().optional(),
+  skipCache: z2.boolean().optional()
+});
+var googleUrlOptionsCampaignSchema = z2.object({
+  id: z2.string(),
+  name: z2.string(),
+  status: z2.string(),
+  final_url_suffix: googleUrlOptionValueSchema,
+  tracking_url_template: googleUrlOptionValueSchema
+});
+var googleUrlOptionsAdGroupSchema = z2.object({
+  id: z2.string(),
+  name: z2.string(),
+  status: z2.string(),
+  campaign_id: z2.string(),
+  final_url_suffix: googleUrlOptionValueSchema,
+  tracking_url_template: googleUrlOptionValueSchema
+});
+var googleUrlOptionsAdSchema = z2.object({
+  id: z2.string(),
+  status: z2.string(),
+  ad_group_id: z2.string(),
+  campaign_id: z2.string(),
+  final_url_suffix: googleUrlOptionValueSchema,
+  tracking_url_template: googleUrlOptionValueSchema
+});
+var googleUrlOptionsResponseSchema = z2.object({
+  customer_id: z2.string(),
+  account: z2.object({
+    level: z2.literal("account"),
+    read: z2.boolean(),
+    final_url_suffix: googleUrlOptionValueSchema,
+    tracking_url_template: googleUrlOptionValueSchema
+  }),
+  campaigns: z2.object({
+    level: z2.literal("campaign"),
+    read: z2.boolean(),
+    /** Campaigns actually observed. 0 with `read: true` means the account has no non-removed campaigns. */
+    campaigns_read: z2.number().int().nonnegative(),
+    /** Campaigns observed to carry no override of their own — an explicit finding, not an omission. */
+    campaigns_without_override: z2.number().int().nonnegative(),
+    overrides: z2.array(googleUrlOptionsCampaignSchema),
+    /** Compact mode only: campaigns read but not listed because they carry no override. */
+    omitted: z2.number().int().nonnegative()
+  }),
+  /**
+   * Ad groups and ads that carry an override of their own — read by asking Google only for the
+   * entities whose suffix or template IS NOT NULL, so an account of thousands of ads costs one page.
+   * `read: true` with no overrides is a finding: nothing at this level overrides the levels above.
+   * `truncated` means more overriding entities exist than one page listed.
+   */
+  ad_groups: z2.object({
+    level: z2.literal("ad_group"),
+    read: z2.boolean(),
+    overrides: z2.array(googleUrlOptionsAdGroupSchema),
+    truncated: z2.boolean()
+  }),
+  ads: z2.object({
+    level: z2.literal("ad"),
+    read: z2.boolean(),
+    overrides: z2.array(googleUrlOptionsAdSchema),
+    truncated: z2.boolean()
+  }),
+  /** Levels this command could not read. Nothing here may be reported as "not configured". */
+  levels_not_read: z2.array(z2.object({ level: z2.enum(URL_OPTION_LEVELS), reason: z2.string() }))
+});
+var ACCOUNT_URL_OPTIONS_LOCATION = "Google Ads UI \u2192 Admin \u2192 Account settings \u2192 Tracking (account-level tracking template and final URL suffix)";
+var ACCOUNT_URL_OPTIONS_STAGE_COMMAND = 'baker ads google account update --customer-id <id> --final-url-suffix "utm_agency=baker"';
+function isSet(value) {
+  return value.state === "set";
+}
+function entityOverrideHints(label, plural, field, level) {
+  if (!level.read) return [];
+  const hints = [];
+  const overriding = level.overrides.filter((entity) => isSet(entity.final_url_suffix));
+  if (overriding.length > 0) {
+    const named = overriding.slice(0, 5).map((entity) => entity.name || entity.id).join(", ");
+    hints.push(
+      `${overriding.length} ${label}(s) set their own final URL suffix (${named}${overriding.length > 5 ? ", \u2026" : ""}). It REPLACES the campaign and account suffix for every click through it, so an account-wide parameter must be added to theirs too.`
+    );
+  }
+  if (level.truncated) {
+    hints.push(
+      `More ${plural} override the URL options than one page lists \u2014 read them all with \`baker ads google query\` on ${field}.final_url_suffix IS NOT NULL --all before saying which ones do.`
+    );
+  }
+  return hints;
+}
+function urlOptionsHints(report) {
+  const hints = [];
+  const { account, campaigns } = report;
+  if (!account.read) {
+    hints.push(
+      "The account level did NOT read \u2014 its URL options are unknown, not empty. Re-run before telling the user anything about account-wide tagging."
+    );
+  } else if (account.final_url_suffix.state === "not_set") {
+    hints.push(
+      `No account-level final URL suffix is set. An account-wide parameter (agency/partner tagging such as utm_agency=\u2026) belongs at the account level so it reaches every ad \u2014 stage it with \`${ACCOUNT_URL_OPTIONS_STAGE_COMMAND}\` (applies at Publish; the user sees it under ${ACCOUNT_URL_OPTIONS_LOCATION}).`
+    );
+  }
+  if (!campaigns.read) {
+    hints.push(
+      "Campaign-level URL options did NOT read \u2014 do not report that no campaign overrides exist. Re-run before concluding."
+    );
+  } else {
+    const overriding = campaigns.overrides.filter((c) => isSet(c.final_url_suffix));
+    if (overriding.length > 0) {
+      const named = overriding.slice(0, 5).map((c) => c.name || c.id).join(", ");
+      hints.push(
+        `A campaign's final URL suffix REPLACES the account-level one for that campaign \u2014 it does not merge. ${overriding.length} campaign(s) set their own (${named}${overriding.length > 5 ? ", \u2026" : ""}) and will not pick up an account-wide parameter until their own suffix carries it too. Every other campaign read here inherits the account level normally.`
+      );
+    }
+  }
+  hints.push(...entityOverrideHints("ad group", "ad groups", "ad_group", report.ad_groups));
+  hints.push(...entityOverrideHints("ad", "ads", "ad_group_ad.ad", report.ads));
+  const overridingLevelsNotRead = report.levels_not_read.filter((level) => level.level !== "account");
+  if (overridingLevelsNotRead.length > 0) {
+    hints.push(
+      `Not read at this level: ${overridingLevelsNotRead.map((l) => l.level).join(", ")}. A suffix set there still wins over the levels above it.`
+    );
+  }
+  if (campaigns.omitted > 0) {
+    hints.push(`${campaigns.omitted} campaign(s) read with no override of their own are not listed \u2014 pass --full.`);
+  }
+  return hints;
+}
+
+export {
+  CHANGE_SCOPES,
+  CHANGE_SCOPE_MAX_DAYS,
+  DEFAULT_CHANGE_DAYS,
+  isChangeLookbackWithinReach,
+  googleKeywordForecastRequestSchema,
+  urlOptionsHints
+};
+//# sourceMappingURL=chunk-SEPPFM5S.js.map

package/dist/chunk-SEPPFM5S.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../api/src/ads-google/change-history.ts","../../api/src/ads-google/keyword-planning.ts","../../api/src/ads-google/url-options.ts"],"sourcesContent":["/**\n * How far back Google's account history actually reaches, shared by the CLI and the\n * backend so the two layers cannot disagree about the limit.\n *\n * `change_event` carries field-level detail — old → new value and the user who made the\n * change — for the last 30 days. `change_status` reaches 90 days but only reports which\n * resources were added, changed or removed. Past 90 days there is no API at all; the\n * change has to be inferred from performance, or read from the Google Ads web UI.\n */\n\nexport const CHANGE_SCOPES = [\"detail\", \"summary\"] as const;\n\nexport type ChangeScope = (typeof CHANGE_SCOPES)[number];\n\nexport const CHANGE_SCOPE_MAX_DAYS: Record<ChangeScope, number> = {\n  detail: 30,\n  summary: 90,\n};\n\nexport const DEFAULT_CHANGE_DAYS = 7;\n\n/** Longest lookback any history resource can serve. */\nexport const MAX_CHANGE_DAYS = CHANGE_SCOPE_MAX_DAYS.summary;\n\nexport function isChangeLookbackWithinReach(days: number, scope: ChangeScope): boolean {\n  return days <= CHANGE_SCOPE_MAX_DAYS[scope];\n}\n\n/** The cheapest scope that can serve `days`, or null when nothing reaches that far. */\nexport function changeScopeForDays(days: number): ChangeScope | null {\n  return CHANGE_SCOPES.find((scope) => isChangeLookbackWithinReach(days, scope)) ?? null;\n}\n\n/**\n * Why a lookback was refused, and what to do instead. Callers that bypass the CLI get\n * this straight from the API, so it has to carry the way out of the window rather than\n * just the limit that was breached.\n */\nexport function changeLookbackMessage(days: number, scope: ChangeScope): string {\n  const reachable = changeScopeForDays(days);\n  if (reachable && reachable !== scope) {\n    return `Google keeps field-level change detail for ${CHANGE_SCOPE_MAX_DAYS.detail} days only, and ${days} days is outside that window. Use scope \"${reachable}\" to reach back ${CHANGE_SCOPE_MAX_DAYS[reachable]} days — it reports which resources changed, without the old and new values.`;\n  }\n  return `Google's account history reaches back ${MAX_CHANGE_DAYS} days at most, and ${days} days is outside that window. Infer the change from monthly spend per campaign instead; anything older with attribution exists only in the Google Ads web interface, which has no API.`;\n}\n","/**\n * Keyword Planner reads beyond ideas and historical volume: a forecast for a set of keywords\n * (`GenerateKeywordForecastMetrics`, v25 shape) and ad-group themes (`GenerateAdGroupThemes`,\n * which existing ad group each keyword belongs in).\n *\n * The v25 forecast takes a campaign to forecast — languages, locations, ONE bidding strategy and\n * ad groups of keywords — and answers with one set of campaign-level estimates. It has no network\n * choice, no per-keyword bids and no negatives; those were the pre-v18 keyword-plan shape.\n */\nimport { z } from \"zod\";\nimport { NUMERIC_ID_REGEX } from \"./limits\";\n\nconst ISO_DATE = /^\\d{4}-\\d{2}-\\d{2}$/;\nconst micros = z.number().int().positive();\n\nexport const FORECAST_MATCH_TYPES = [\"EXACT\", \"PHRASE\", \"BROAD\"] as const;\n\nexport const googleForecastBiddingSchema = z.discriminatedUnion(\"strategy\", [\n  z.object({ strategy: z.literal(\"MANUAL_CPC\"), maxCpcBidMicros: micros, dailyBudgetMicros: micros.optional() }),\n  z.object({\n    strategy: z.literal(\"MAXIMIZE_CLICKS\"),\n    dailyTargetSpendMicros: micros,\n    maxCpcBidCeilingMicros: micros.optional(),\n  }),\n  z.object({ strategy: z.literal(\"MAXIMIZE_CONVERSIONS\"), dailyTargetSpendMicros: micros }),\n]);\nexport type GoogleForecastBidding = z.infer<typeof googleForecastBiddingSchema>;\n\nexport const googleKeywordForecastRequestSchema = z\n  .object({\n    customerId: z.string().regex(NUMERIC_ID_REGEX, \"customerId must be the bare numeric customer id\"),\n    managerId: z.string().optional(),\n    /** One forecast ad group per entry; most forecasts are a single group. */\n    adGroups: z\n      .array(\n        z.object({\n          keywords: z\n            .array(z.object({ text: z.string().trim().min(1).max(80), matchType: z.enum(FORECAST_MATCH_TYPES) }))\n            .min(1),\n        }),\n      )\n      .min(1),\n    locationIds: z.array(z.string().regex(NUMERIC_ID_REGEX)).optional(),\n    languageId: z.string().regex(NUMERIC_ID_REGEX).optional(),\n    bidding: googleForecastBiddingSchema,\n    /** Must start in the future and end within a year. Without them Baker forecasts the 30 days from tomorrow. */\n    startDate: z.string().regex(ISO_DATE).optional(),\n    endDate: z.string().regex(ISO_DATE).optional(),\n    currencyCode: z.string().length(3).optional(),\n  })\n  .refine((body) => (body.startDate === undefined) === (body.endDate === undefined), {\n    message: \"Give both --start and --end, or neither (the forecast then covers the 30 days from tomorrow)\",\n    path: [\"endDate\"],\n  });\nexport type GoogleKeywordForecastRequest = z.infer<typeof googleKeywordForecastRequestSchema>;\n\nexport const KEYWORD_FORECAST_SOURCE = \"keyword_planner_forecast\" as const;\n\n/** Every number is Google's prediction for the whole forecast period — never an account result. */\nexport const googleKeywordForecastResponseSchema = z.object({\n  source: z.literal(KEYWORD_FORECAST_SOURCE),\n  period: z.object({ startDate: z.string(), endDate: z.string() }),\n  forecast_clicks: z.number().nullable(),\n  forecast_cost_micros: z.number().nullable(),\n  forecast_conversions: z.number().nullable(),\n  forecast_average_cpc_micros: z.number().nullable(),\n  forecast_average_cpa_micros: z.number().nullable(),\n});\nexport type GoogleKeywordForecastResponse = z.infer<typeof googleKeywordForecastResponseSchema>;\n\nexport const googleAdGroupThemesRequestSchema = z.object({\n  customerId: z.string().regex(NUMERIC_ID_REGEX, \"customerId must be the bare numeric customer id\"),\n  managerId: z.string().optional(),\n  keywords: z.array(z.string().trim().min(1)).min(1),\n  /** Existing ad groups to sort the keywords into: numeric ids or `customers/{cid}/adGroups/{id}`. */\n  adGroups: z.array(z.string().min(1)).min(1),\n});\nexport type GoogleAdGroupThemesRequest = z.infer<typeof googleAdGroupThemesRequestSchema>;\n\nexport const googleAdGroupThemesResponseSchema = z.object({\n  suggestions: z.array(\n    z.object({\n      keyword: z.string(),\n      suggested_keyword: z.string(),\n      match_type: z.string(),\n      ad_group: z.string(),\n      campaign: z.string(),\n    }),\n  ),\n  unusable_ad_groups: z.array(z.object({ ad_group: z.string(), campaign: z.string() })),\n});\nexport type GoogleAdGroupThemesResponse = z.infer<typeof googleAdGroupThemesResponseSchema>;\n","/**\n * `ads.google.url-options` — the URL/tracking options in force on an account.\n *\n * Google returns a field ONLY when it holds a value: an unset `final_url_suffix`\n * is not `\"\"`, it is a key that never appears in the row. Reported naively, that\n * is indistinguishable from a read that never happened — and a false \"no suffix\n * is configured\" has already been written into a client's knowledge base from\n * exactly that ambiguity.\n *\n * So every value here is a tagged union, never a bare string:\n *\n * - `{ state: \"set\", value }`   — observed, holds this value\n * - `{ state: \"not_set\" }`      — observed, Google carries no value at this level\n * - `{ state: \"not_read\", reason }` — never observed; says nothing about the account\n *\n * and every level Baker did NOT read is listed explicitly in `levels_not_read`\n * rather than silently omitted. Absence is only a finding when it is `not_set`.\n */\nimport { z } from \"zod\";\nimport { NUMERIC_ID_REGEX } from \"./limits\";\n\n/** Google resolves URL options most-specific-first; these are the levels that can carry one. */\nexport const URL_OPTION_LEVELS = [\"account\", \"campaign\", \"ad_group\", \"ad\"] as const;\nexport type GoogleUrlOptionLevel = (typeof URL_OPTION_LEVELS)[number];\n\nexport const googleUrlOptionValueSchema = z.discriminatedUnion(\"state\", [\n  z.object({ state: z.literal(\"set\"), value: z.string() }),\n  z.object({ state: z.literal(\"not_set\") }),\n  z.object({ state: z.literal(\"not_read\"), reason: z.string() }),\n]);\nexport type GoogleUrlOptionValue = z.infer<typeof googleUrlOptionValueSchema>;\n\nexport const googleUrlOptionsRequestSchema = z.object({\n  customerId: z.string().regex(NUMERIC_ID_REGEX, \"customerId must be the bare numeric customer id\"),\n  managerId: z.string().optional(),\n  /** Compact by default: only campaigns that actually override the account. `full` lists every campaign. */\n  full: z.boolean().optional(),\n  skipCache: z.boolean().optional(),\n});\nexport type GoogleUrlOptionsRequest = z.infer<typeof googleUrlOptionsRequestSchema>;\n\nexport const googleUrlOptionsCampaignSchema = z.object({\n  id: z.string(),\n  name: z.string(),\n  status: z.string(),\n  final_url_suffix: googleUrlOptionValueSchema,\n  tracking_url_template: googleUrlOptionValueSchema,\n});\nexport type GoogleUrlOptionsCampaign = z.infer<typeof googleUrlOptionsCampaignSchema>;\n\nexport const googleUrlOptionsAdGroupSchema = z.object({\n  id: z.string(),\n  name: z.string(),\n  status: z.string(),\n  campaign_id: z.string(),\n  final_url_suffix: googleUrlOptionValueSchema,\n  tracking_url_template: googleUrlOptionValueSchema,\n});\nexport type GoogleUrlOptionsAdGroup = z.infer<typeof googleUrlOptionsAdGroupSchema>;\n\nexport const googleUrlOptionsAdSchema = z.object({\n  id: z.string(),\n  status: z.string(),\n  ad_group_id: z.string(),\n  campaign_id: z.string(),\n  final_url_suffix: googleUrlOptionValueSchema,\n  tracking_url_template: googleUrlOptionValueSchema,\n});\nexport type GoogleUrlOptionsAd = z.infer<typeof googleUrlOptionsAdSchema>;\n\nexport const googleUrlOptionsResponseSchema = z.object({\n  customer_id: z.string(),\n  account: z.object({\n    level: z.literal(\"account\"),\n    read: z.boolean(),\n    final_url_suffix: googleUrlOptionValueSchema,\n    tracking_url_template: googleUrlOptionValueSchema,\n  }),\n  campaigns: z.object({\n    level: z.literal(\"campaign\"),\n    read: z.boolean(),\n    /** Campaigns actually observed. 0 with `read: true` means the account has no non-removed campaigns. */\n    campaigns_read: z.number().int().nonnegative(),\n    /** Campaigns observed to carry no override of their own — an explicit finding, not an omission. */\n    campaigns_without_override: z.number().int().nonnegative(),\n    overrides: z.array(googleUrlOptionsCampaignSchema),\n    /** Compact mode only: campaigns read but not listed because they carry no override. */\n    omitted: z.number().int().nonnegative(),\n  }),\n  /**\n   * Ad groups and ads that carry an override of their own — read by asking Google only for the\n   * entities whose suffix or template IS NOT NULL, so an account of thousands of ads costs one page.\n   * `read: true` with no overrides is a finding: nothing at this level overrides the levels above.\n   * `truncated` means more overriding entities exist than one page listed.\n   */\n  ad_groups: z.object({\n    level: z.literal(\"ad_group\"),\n    read: z.boolean(),\n    overrides: z.array(googleUrlOptionsAdGroupSchema),\n    truncated: z.boolean(),\n  }),\n  ads: z.object({\n    level: z.literal(\"ad\"),\n    read: z.boolean(),\n    overrides: z.array(googleUrlOptionsAdSchema),\n    truncated: z.boolean(),\n  }),\n  /** Levels this command could not read. Nothing here may be reported as \"not configured\". */\n  levels_not_read: z.array(z.object({ level: z.enum(URL_OPTION_LEVELS), reason: z.string() })),\n});\nexport type GoogleUrlOptionsResponse = z.infer<typeof googleUrlOptionsResponseSchema>;\n\n/** Where Google keeps the account-level fields, verbatim, for an agent relaying it to a marketer. */\nexport const ACCOUNT_URL_OPTIONS_LOCATION =\n  \"Google Ads UI → Admin → Account settings → Tracking (account-level tracking template and final URL suffix)\";\n\n/**\n * How the account-level value is staged: `google.customer.update` rides the same `GoogleAdsService.Mutate`\n * batch as every other staged op (`customerOperation`), so it applies at Publish like the rest.\n */\nexport const ACCOUNT_URL_OPTIONS_STAGE_COMMAND =\n  'baker ads google account update --customer-id <id> --final-url-suffix \"utm_agency=baker\"';\n\nfunction isSet(value: GoogleUrlOptionValue): value is { state: \"set\"; value: string } {\n  return value.state === \"set\";\n}\n\n/** What an ad-group or ad level's overrides mean for an account-wide parameter. */\nfunction entityOverrideHints(\n  label: string,\n  plural: string,\n  field: string,\n  level: GoogleUrlOptionsResponse[\"ad_groups\"] | GoogleUrlOptionsResponse[\"ads\"],\n): string[] {\n  if (!level.read) return [];\n  const hints: string[] = [];\n  const overriding: Array<{ id: string; name?: string; final_url_suffix: GoogleUrlOptionValue }> =\n    level.overrides.filter((entity) => isSet(entity.final_url_suffix));\n  if (overriding.length > 0) {\n    const named = overriding\n      .slice(0, 5)\n      .map((entity) => entity.name || entity.id)\n      .join(\", \");\n    hints.push(\n      `${overriding.length} ${label}(s) set their own final URL suffix (${named}${overriding.length > 5 ? \", …\" : \"\"}). It REPLACES the campaign and account suffix for every click through it, so an account-wide parameter must be added to theirs too.`,\n    );\n  }\n  if (level.truncated) {\n    hints.push(\n      `More ${plural} override the URL options than one page lists — read them all with \\`baker ads google query\\` on ${field}.final_url_suffix IS NOT NULL --all before saying which ones do.`,\n    );\n  }\n  return hints;\n}\n\n/**\n * Post-read nudges. The account level is the right home for an account-wide parameter\n * (agency/partner tagging), so a missing account suffix is the finding worth surfacing —\n * and a level that failed to read must never be reported as unset.\n */\nexport function urlOptionsHints(report: GoogleUrlOptionsResponse): string[] {\n  const hints: string[] = [];\n  const { account, campaigns } = report;\n\n  if (!account.read) {\n    hints.push(\n      \"The account level did NOT read — its URL options are unknown, not empty. Re-run before telling the user anything about account-wide tagging.\",\n    );\n  } else if (account.final_url_suffix.state === \"not_set\") {\n    hints.push(\n      `No account-level final URL suffix is set. An account-wide parameter (agency/partner tagging such as utm_agency=…) belongs at the account level so it reaches every ad — stage it with \\`${ACCOUNT_URL_OPTIONS_STAGE_COMMAND}\\` (applies at Publish; the user sees it under ${ACCOUNT_URL_OPTIONS_LOCATION}).`,\n    );\n  }\n\n  if (!campaigns.read) {\n    hints.push(\n      \"Campaign-level URL options did NOT read — do not report that no campaign overrides exist. Re-run before concluding.\",\n    );\n  } else {\n    // `overrides` carries every campaign under --full, not just the overriding ones,\n    // so name the ones that actually set a suffix. Saying \"campaigns listed under\n    // `overrides`\" would tell the agent that campaigns inheriting fine are broken.\n    const overriding = campaigns.overrides.filter((c) => isSet(c.final_url_suffix));\n    if (overriding.length > 0) {\n      const named = overriding\n        .slice(0, 5)\n        .map((c) => c.name || c.id)\n        .join(\", \");\n      hints.push(\n        `A campaign's final URL suffix REPLACES the account-level one for that campaign — it does not merge. ${overriding.length} campaign(s) set their own (${named}${overriding.length > 5 ? \", …\" : \"\"}) and will not pick up an account-wide parameter until their own suffix carries it too. Every other campaign read here inherits the account level normally.`,\n      );\n    }\n  }\n\n  hints.push(...entityOverrideHints(\"ad group\", \"ad groups\", \"ad_group\", report.ad_groups));\n  hints.push(...entityOverrideHints(\"ad\", \"ads\", \"ad_group_ad.ad\", report.ads));\n\n  // Precedence is account → campaign → ad group → ad, most specific winning, so\n  // \"a suffix set there still wins\" only holds for levels BELOW the ones that read.\n  // `account` is the least specific — a campaign, ad-group or ad suffix overrides it —\n  // and it joins `levels_not_read` whenever the customer read fails, which would hand\n  // the agent the precedence backwards. Its own \"did NOT read\" hint above covers it.\n  const overridingLevelsNotRead = report.levels_not_read.filter((level) => level.level !== \"account\");\n  if (overridingLevelsNotRead.length > 0) {\n    hints.push(\n      `Not read at this level: ${overridingLevelsNotRead.map((l) => l.level).join(\", \")}. A suffix set there still wins over the levels above it.`,\n    );\n  }\n\n  if (campaigns.omitted > 0) {\n    hints.push(`${campaigns.omitted} campaign(s) read with no override of their own are not listed — pass --full.`);\n  }\n\n  return hints;\n}\n"],"mappings":"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","names":["z","z"]}

package/dist/chunk-SQ7DRYCC.js

@@ -0,0 +1,150 @@
+import {
+  GEO_TARGET_COUNTRIES,
+  LANGUAGE_CONSTANTS
+} from "./chunk-I2DNBEV6.js";
+
+// src/geo-context.ts
+function toOptions(names) {
+  return Object.entries(names).map(([id, name]) => ({ id, name })).sort((a, b) => a.name.localeCompare(b.name));
+}
+var GOOGLE_ADS_LOCATIONS = toOptions(GEO_TARGET_COUNTRIES);
+var GOOGLE_ADS_LANGUAGES = toOptions(LANGUAGE_CONSTANTS);
+var DATAFORSEO_LOCATIONS = [
+  { code: "us", name: "United States" },
+  { code: "uk", name: "United Kingdom" },
+  { code: "gb", name: "United Kingdom" },
+  { code: "ca", name: "Canada" },
+  { code: "au", name: "Australia" },
+  { code: "de", name: "Germany" },
+  { code: "fr", name: "France" },
+  { code: "es", name: "Spain" },
+  { code: "it", name: "Italy" },
+  { code: "br", name: "Brazil" },
+  { code: "mx", name: "Mexico" },
+  { code: "nl", name: "Netherlands" },
+  { code: "be", name: "Belgium" },
+  { code: "at", name: "Austria" },
+  { code: "ch", name: "Switzerland" },
+  { code: "pt", name: "Portugal" },
+  { code: "se", name: "Sweden" },
+  { code: "no", name: "Norway" },
+  { code: "dk", name: "Denmark" },
+  { code: "fi", name: "Finland" },
+  { code: "ie", name: "Ireland" },
+  { code: "nz", name: "New Zealand" },
+  { code: "in", name: "India" },
+  { code: "jp", name: "Japan" },
+  { code: "kr", name: "South Korea" },
+  { code: "sg", name: "Singapore" },
+  { code: "ar", name: "Argentina" },
+  { code: "cl", name: "Chile" },
+  { code: "co", name: "Colombia" },
+  { code: "pe", name: "Peru" },
+  { code: "pl", name: "Poland" },
+  { code: "cz", name: "Czech Republic" },
+  { code: "ro", name: "Romania" },
+  { code: "hu", name: "Hungary" },
+  { code: "za", name: "South Africa" },
+  { code: "il", name: "Israel" },
+  { code: "ae", name: "United Arab Emirates" },
+  { code: "sa", name: "Saudi Arabia" },
+  { code: "tr", name: "Turkey" },
+  { code: "ph", name: "Philippines" },
+  { code: "th", name: "Thailand" },
+  { code: "my", name: "Malaysia" },
+  { code: "id", name: "Indonesia" },
+  { code: "vn", name: "Vietnam" },
+  { code: "tw", name: "Taiwan" },
+  { code: "hk", name: "Hong Kong" }
+];
+var DATAFORSEO_LANGUAGES = [
+  { code: "en", name: "English" },
+  { code: "es", name: "Spanish" },
+  { code: "fr", name: "French" },
+  { code: "de", name: "German" },
+  { code: "it", name: "Italian" },
+  { code: "pt", name: "Portuguese" },
+  { code: "nl", name: "Dutch" },
+  { code: "ja", name: "Japanese" },
+  { code: "ko", name: "Korean" },
+  { code: "zh", name: "Chinese" },
+  { code: "ar", name: "Arabic" },
+  { code: "ru", name: "Russian" },
+  { code: "pl", name: "Polish" },
+  { code: "tr", name: "Turkish" },
+  { code: "sv", name: "Swedish" },
+  { code: "no", name: "Norwegian" },
+  { code: "da", name: "Danish" },
+  { code: "fi", name: "Finnish" }
+];
+function toRecord(list) {
+  const map = {};
+  for (const item of list) {
+    const key = item.id ?? item.code;
+    if (key) map[key] = item.name;
+  }
+  return map;
+}
+var researchLocationMap = toRecord(DATAFORSEO_LOCATIONS);
+var researchLanguageMap = toRecord(DATAFORSEO_LANGUAGES);
+function buildAdsQueryContext(locationArg, languageArg) {
+  const locationId = locationArg ?? "2840";
+  const languageId = languageArg ?? "1000";
+  const locationIsDefault = !locationArg;
+  const languageIsDefault = !languageArg;
+  const locationName = GEO_TARGET_COUNTRIES[locationId] ?? `ID ${locationId}`;
+  const languageName = LANGUAGE_CONSTANTS[languageId] ?? `ID ${languageId}`;
+  const ctx = {
+    location: `${locationName} (${locationId})`,
+    language: `${languageName} (${languageId})`,
+    location_is_default: locationIsDefault,
+    language_is_default: languageIsDefault
+  };
+  if (locationIsDefault || languageIsDefault) {
+    const parts = [];
+    if (locationIsDefault) parts.push("--location");
+    if (languageIsDefault) parts.push("--language");
+    ctx.defaults_warning = `Location and/or language were not specified \u2014 using defaults. Results are for ${locationName} in ${languageName}. Pass ${parts.join(" and ")} to target a different market.`;
+  }
+  return ctx;
+}
+function buildResearchQueryContext(locationArg, languageArg, options) {
+  const skipLocation = options?.skipLocation ?? false;
+  const locationCode = locationArg ?? "us";
+  const languageCode = languageArg ?? "en";
+  const locationIsDefault = !locationArg && !skipLocation;
+  const languageIsDefault = !languageArg;
+  const locationName = researchLocationMap[locationCode.toLowerCase()] ?? `code ${locationCode}`;
+  const languageName = researchLanguageMap[languageCode.toLowerCase()] ?? `code ${languageCode}`;
+  const ctx = {
+    location: skipLocation ? "N/A" : `${locationName} (${locationCode})`,
+    language: `${languageName} (${languageCode})`,
+    location_is_default: locationIsDefault,
+    language_is_default: languageIsDefault
+  };
+  const defaultParts = [];
+  if (locationIsDefault) defaultParts.push("--location");
+  if (languageIsDefault) defaultParts.push("--language");
+  if (defaultParts.length > 0) {
+    const market = skipLocation ? `${languageName}` : `${locationName} in ${languageName}`;
+    ctx.defaults_warning = `Location and/or language were not specified \u2014 using defaults. Results are for ${market}. Pass ${defaultParts.join(" and ")} to target a different market.`;
+  }
+  return ctx;
+}
+function warnDefaults(ctx) {
+  if (ctx.defaults_warning) {
+    process.stderr.write(`
+[WARNING] ${ctx.defaults_warning}
+
+`);
+  }
+}
+
+export {
+  GOOGLE_ADS_LOCATIONS,
+  GOOGLE_ADS_LANGUAGES,
+  buildAdsQueryContext,
+  buildResearchQueryContext,
+  warnDefaults
+};
+//# sourceMappingURL=chunk-SQ7DRYCC.js.map

package/dist/chunk-SQ7DRYCC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/geo-context.ts"],"sourcesContent":["import { GEO_TARGET_COUNTRIES, LANGUAGE_CONSTANTS } from \"@baker/api/ads-google\";\n\nfunction toOptions(names: Record<string, string>): Array<{ id: string; name: string }> {\n  return Object.entries(names)\n    .map(([id, name]) => ({ id, name }))\n    .sort((a, b) => a.name.localeCompare(b.name));\n}\n\n/**\n * Every country and language Google targets, from the shared constant tables. This used to be a\n * hand-kept list of 45 markets, which made `keywords locations` — documented as listing all of\n * them — quietly wrong about the other 174, and rendered any market outside it as \"ID 2404\".\n */\nexport const GOOGLE_ADS_LOCATIONS: Array<{ id: string; name: string }> = toOptions(GEO_TARGET_COUNTRIES);\n\nexport const GOOGLE_ADS_LANGUAGES: Array<{ id: string; name: string }> = toOptions(LANGUAGE_CONSTANTS);\n\nconst DATAFORSEO_LOCATIONS: Array<{ code: string; name: string }> = [\n  { code: \"us\", name: \"United States\" },\n  { code: \"uk\", name: \"United Kingdom\" },\n  { code: \"gb\", name: \"United Kingdom\" },\n  { code: \"ca\", name: \"Canada\" },\n  { code: \"au\", name: \"Australia\" },\n  { code: \"de\", name: \"Germany\" },\n  { code: \"fr\", name: \"France\" },\n  { code: \"es\", name: \"Spain\" },\n  { code: \"it\", name: \"Italy\" },\n  { code: \"br\", name: \"Brazil\" },\n  { code: \"mx\", name: \"Mexico\" },\n  { code: \"nl\", name: \"Netherlands\" },\n  { code: \"be\", name: \"Belgium\" },\n  { code: \"at\", name: \"Austria\" },\n  { code: \"ch\", name: \"Switzerland\" },\n  { code: \"pt\", name: \"Portugal\" },\n  { code: \"se\", name: \"Sweden\" },\n  { code: \"no\", name: \"Norway\" },\n  { code: \"dk\", name: \"Denmark\" },\n  { code: \"fi\", name: \"Finland\" },\n  { code: \"ie\", name: \"Ireland\" },\n  { code: \"nz\", name: \"New Zealand\" },\n  { code: \"in\", name: \"India\" },\n  { code: \"jp\", name: \"Japan\" },\n  { code: \"kr\", name: \"South Korea\" },\n  { code: \"sg\", name: \"Singapore\" },\n  { code: \"ar\", name: \"Argentina\" },\n  { code: \"cl\", name: \"Chile\" },\n  { code: \"co\", name: \"Colombia\" },\n  { code: \"pe\", name: \"Peru\" },\n  { code: \"pl\", name: \"Poland\" },\n  { code: \"cz\", name: \"Czech Republic\" },\n  { code: \"ro\", name: \"Romania\" },\n  { code: \"hu\", name: \"Hungary\" },\n  { code: \"za\", name: \"South Africa\" },\n  { code: \"il\", name: \"Israel\" },\n  { code: \"ae\", name: \"United Arab Emirates\" },\n  { code: \"sa\", name: \"Saudi Arabia\" },\n  { code: \"tr\", name: \"Turkey\" },\n  { code: \"ph\", name: \"Philippines\" },\n  { code: \"th\", name: \"Thailand\" },\n  { code: \"my\", name: \"Malaysia\" },\n  { code: \"id\", name: \"Indonesia\" },\n  { code: \"vn\", name: \"Vietnam\" },\n  { code: \"tw\", name: \"Taiwan\" },\n  { code: \"hk\", name: \"Hong Kong\" },\n];\n\nconst DATAFORSEO_LANGUAGES: Array<{ code: string; name: string }> = [\n  { code: \"en\", name: \"English\" },\n  { code: \"es\", name: \"Spanish\" },\n  { code: \"fr\", name: \"French\" },\n  { code: \"de\", name: \"German\" },\n  { code: \"it\", name: \"Italian\" },\n  { code: \"pt\", name: \"Portuguese\" },\n  { code: \"nl\", name: \"Dutch\" },\n  { code: \"ja\", name: \"Japanese\" },\n  { code: \"ko\", name: \"Korean\" },\n  { code: \"zh\", name: \"Chinese\" },\n  { code: \"ar\", name: \"Arabic\" },\n  { code: \"ru\", name: \"Russian\" },\n  { code: \"pl\", name: \"Polish\" },\n  { code: \"tr\", name: \"Turkish\" },\n  { code: \"sv\", name: \"Swedish\" },\n  { code: \"no\", name: \"Norwegian\" },\n  { code: \"da\", name: \"Danish\" },\n  { code: \"fi\", name: \"Finnish\" },\n];\n\nfunction toRecord<T extends { id?: string; code?: string; name: string }>(list: T[]): Record<string, string> {\n  const map: Record<string, string> = {};\n  for (const item of list) {\n    const key = item.id ?? item.code;\n    if (key) map[key] = item.name;\n  }\n  return map;\n}\n\nconst researchLocationMap = toRecord(DATAFORSEO_LOCATIONS);\nconst researchLanguageMap = toRecord(DATAFORSEO_LANGUAGES);\n\nexport interface QueryContext {\n  location: string;\n  language: string;\n  location_is_default: boolean;\n  language_is_default: boolean;\n  defaults_warning?: string;\n}\n\nexport function buildAdsQueryContext(locationArg: string | undefined, languageArg: string | undefined): QueryContext {\n  const locationId = locationArg ?? \"2840\";\n  const languageId = languageArg ?? \"1000\";\n  const locationIsDefault = !locationArg;\n  const languageIsDefault = !languageArg;\n\n  const locationName = GEO_TARGET_COUNTRIES[locationId] ?? `ID ${locationId}`;\n  const languageName = LANGUAGE_CONSTANTS[languageId] ?? `ID ${languageId}`;\n\n  const ctx: QueryContext = {\n    location: `${locationName} (${locationId})`,\n    language: `${languageName} (${languageId})`,\n    location_is_default: locationIsDefault,\n    language_is_default: languageIsDefault,\n  };\n\n  if (locationIsDefault || languageIsDefault) {\n    const parts: string[] = [];\n    if (locationIsDefault) parts.push(\"--location\");\n    if (languageIsDefault) parts.push(\"--language\");\n    ctx.defaults_warning =\n      `Location and/or language were not specified — using defaults. ` +\n      `Results are for ${locationName} in ${languageName}. ` +\n      `Pass ${parts.join(\" and \")} to target a different market.`;\n  }\n\n  return ctx;\n}\n\nexport function buildResearchQueryContext(\n  locationArg: string | undefined,\n  languageArg: string | undefined,\n  options?: { skipLocation?: boolean },\n): QueryContext {\n  const skipLocation = options?.skipLocation ?? false;\n  const locationCode = locationArg ?? \"us\";\n  const languageCode = languageArg ?? \"en\";\n  const locationIsDefault = !locationArg && !skipLocation;\n  const languageIsDefault = !languageArg;\n\n  const locationName = researchLocationMap[locationCode.toLowerCase()] ?? `code ${locationCode}`;\n  const languageName = researchLanguageMap[languageCode.toLowerCase()] ?? `code ${languageCode}`;\n\n  const ctx: QueryContext = {\n    location: skipLocation ? \"N/A\" : `${locationName} (${locationCode})`,\n    language: `${languageName} (${languageCode})`,\n    location_is_default: locationIsDefault,\n    language_is_default: languageIsDefault,\n  };\n\n  const defaultParts: string[] = [];\n  if (locationIsDefault) defaultParts.push(\"--location\");\n  if (languageIsDefault) defaultParts.push(\"--language\");\n\n  if (defaultParts.length > 0) {\n    const market = skipLocation ? `${languageName}` : `${locationName} in ${languageName}`;\n    ctx.defaults_warning =\n      `Location and/or language were not specified — using defaults. ` +\n      `Results are for ${market}. ` +\n      `Pass ${defaultParts.join(\" and \")} to target a different market.`;\n  }\n\n  return ctx;\n}\n\nexport function warnDefaults(ctx: QueryContext): void {\n  if (ctx.defaults_warning) {\n    process.stderr.write(`\\n[WARNING] ${ctx.defaults_warning}\\n\\n`);\n  }\n}\n"],"mappings":"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","names":[]}