@koda-sl/baker-cli 0.460.0 → 0.462.0

package/dist/follow-competitors-QLIEQDT7.js

@@ -0,0 +1,112 @@
+import {
+  reportError,
+  splitList
+} from "./chunk-POSV2BIJ.js";
+import {
+  apiPost
+} from "./chunk-D4N5ZXEO.js";
+import "./chunk-QYDJJLEE.js";
+import "./chunk-NBPJBJJD.js";
+import {
+  FOLLOW_BATCH_MAX,
+  registerSchema,
+  writeJson
+} from "./chunk-4TCMKTJG.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/winning-ads/follow-competitors.ts
+import { defineCommand } from "citty";
+var BATCH_TIMEOUT_MS = 3e5;
+function buildFollowBatchBody(input) {
+  const seen = /* @__PURE__ */ new Set();
+  const inputs = [];
+  for (const domain of splitList(input.domains)) {
+    const key = domain.toLowerCase();
+    if (seen.has(key)) {
+      continue;
+    }
+    seen.add(key);
+    inputs.push(domain);
+  }
+  return { inputs };
+}
+registerSchema({
+  command: "winning-ads.follow-competitors",
+  description: "Follow MANY brands at once \u2014 the fast way to add every competitor to your library. Pass a comma-separated list of domains (best \u2014 each resolves every platform and every account we can find, every country). One brand failing never blocks the others: the response reports per-brand status (following/added/ambiguous/failed) plus rollup counts. Ideal right after a competitor scan.",
+  args: {
+    domains: {
+      type: "string",
+      description: `Comma-separated domains (best), profile/ad-library URLs, or brand names \u2014 up to ${FOLLOW_BATCH_MAX}. e.g. "deel.com,notion.so,hubspot.com"`,
+      required: true
+    }
+  }
+});
+var followCompetitorsCommand = defineCommand({
+  meta: {
+    name: "follow-competitors",
+    description: 'Follow many brands at once by domain \u2014 add every competitor in one call. Example: baker winning-ads follow-competitors "deel.com,notion.so,hubspot.com"'
+  },
+  args: {
+    domains: {
+      type: "positional",
+      description: "Comma-separated domains (best), URLs, or brand names",
+      required: true
+    },
+    platform: {
+      type: "string",
+      description: "Ignored \u2014 every platform is searched. Kept so older commands still run.",
+      required: false
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const body = buildFollowBatchBody({ domains: String(args.domains ?? "") });
+      if (body.inputs.length === 0) {
+        writeJson({
+          ok: false,
+          error: { code: "VALIDATION_ERROR", message: "Pass at least one domain in --domains." }
+        });
+        process.exit(1);
+      }
+      if (body.inputs.length > FOLLOW_BATCH_MAX) {
+        writeJson({
+          ok: false,
+          error: {
+            code: "VALIDATION_ERROR",
+            message: `Too many brands (${body.inputs.length}). Follow at most ${FOLLOW_BATCH_MAX} per call.`
+          }
+        });
+        process.exit(1);
+      }
+      const data = await apiPost("/api/ad-library/follow-batch", body, {
+        timeoutMs: BATCH_TIMEOUT_MS
+      });
+      const hints = [];
+      if (data.failed_count > 0) {
+        const failed = data.results.filter((r) => r.status === "failed").map((r) => r.input);
+        hints.push(
+          `${data.failed_count} brand(s) couldn't be added: ${failed.join(", ")}. Retry each with its website or Facebook/LinkedIn URL via \`baker winning-ads follow\`.`
+        );
+      }
+      if (data.ambiguous_count > 0) {
+        const ambiguous = data.results.filter((r) => r.status === "ambiguous").map((r) => r.input);
+        hints.push(
+          `${data.ambiguous_count} brand(s) matched multiple advertisers: ${ambiguous.join(", ")}. Re-run \`baker winning-ads follow\` with an exact domain/URL to pick one.`
+        );
+      }
+      if (data.added_count > 0) {
+        hints.push(
+          "Newly added brands are ingesting now \u2014 their winners fill in over the next few minutes. Check `baker winning-ads following` or `baker winning-ads feed`."
+        );
+      }
+      writeJson({ ok: true, data, hints: hints.length > 0 ? hints : void 0 });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  buildFollowBatchBody,
+  followCompetitorsCommand
+};
+//# sourceMappingURL=follow-competitors-QLIEQDT7.js.map

package/dist/follow-competitors-QLIEQDT7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/winning-ads/follow-competitors.ts"],"sourcesContent":["import { FOLLOW_BATCH_MAX, type FollowBatchResponse } from \"@baker/api/ad-library\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { reportError, splitList } from \"./shared.ts\";\n\n// A batch follows each brand sequentially — a paid resolve lookup + an ad-dna add\n// per brand, a few seconds each — so give it far more room than the default\n// request timeout. A timeout is safe anyway: each follow is idempotent, so an\n// already-followed brand returns instantly on a re-run.\nconst BATCH_TIMEOUT_MS = 300_000;\n\n/**\n * Build the `/api/ad-library/follow-batch` body from the CLI flags. Pure so the\n * csv-splitting + de-duplication is unit-testable without the transport. Dedupes\n * case-insensitively (following the same domain twice is a wasted lookup) while\n * preserving the first-seen order + original casing.\n */\nexport function buildFollowBatchBody(input: { domains?: string }): { inputs: string[] } {\n  const seen = new Set<string>();\n  const inputs: string[] = [];\n  for (const domain of splitList(input.domains)) {\n    const key = domain.toLowerCase();\n    if (seen.has(key)) {\n      continue;\n    }\n    seen.add(key);\n    inputs.push(domain);\n  }\n  return { inputs };\n}\n\nregisterSchema({\n  command: \"winning-ads.follow-competitors\",\n  description:\n    \"Follow MANY brands at once — the fast way to add every competitor to your library. Pass a comma-separated list of domains (best — each resolves every platform and every account we can find, every country). One brand failing never blocks the others: the response reports per-brand status (following/added/ambiguous/failed) plus rollup counts. Ideal right after a competitor scan.\",\n  args: {\n    domains: {\n      type: \"string\",\n      description: `Comma-separated domains (best), profile/ad-library URLs, or brand names — up to ${FOLLOW_BATCH_MAX}. e.g. \"deel.com,notion.so,hubspot.com\"`,\n      required: true,\n    },\n  },\n});\n\nexport const followCompetitorsCommand = defineCommand({\n  meta: {\n    name: \"follow-competitors\",\n    description:\n      'Follow many brands at once by domain — add every competitor in one call. Example: baker winning-ads follow-competitors \"deel.com,notion.so,hubspot.com\"',\n  },\n  args: {\n    domains: {\n      type: \"positional\",\n      description: \"Comma-separated domains (best), URLs, or brand names\",\n      required: true,\n    },\n    platform: {\n      type: \"string\",\n      description: \"Ignored — every platform is searched. Kept so older commands still run.\",\n      required: false,\n    },\n  },\n  run: async ({ args }) => {\n    try {\n      const body = buildFollowBatchBody({ domains: String(args.domains ?? \"\") });\n      if (body.inputs.length === 0) {\n        writeJson({\n          ok: false,\n          error: { code: \"VALIDATION_ERROR\", message: \"Pass at least one domain in --domains.\" },\n        });\n        process.exit(1);\n      }\n      if (body.inputs.length > FOLLOW_BATCH_MAX) {\n        writeJson({\n          ok: false,\n          error: {\n            code: \"VALIDATION_ERROR\",\n            message: `Too many brands (${body.inputs.length}). Follow at most ${FOLLOW_BATCH_MAX} per call.`,\n          },\n        });\n        process.exit(1);\n      }\n\n      const data = await apiPost<FollowBatchResponse>(\"/api/ad-library/follow-batch\", body, {\n        timeoutMs: BATCH_TIMEOUT_MS,\n      });\n\n      const hints: string[] = [];\n      if (data.failed_count > 0) {\n        const failed = data.results.filter((r) => r.status === \"failed\").map((r) => r.input);\n        hints.push(\n          `${data.failed_count} brand(s) couldn't be added: ${failed.join(\", \")}. Retry each with its website or Facebook/LinkedIn URL via \\`baker winning-ads follow\\`.`,\n        );\n      }\n      if (data.ambiguous_count > 0) {\n        const ambiguous = data.results.filter((r) => r.status === \"ambiguous\").map((r) => r.input);\n        hints.push(\n          `${data.ambiguous_count} brand(s) matched multiple advertisers: ${ambiguous.join(\", \")}. Re-run \\`baker winning-ads follow\\` with an exact domain/URL to pick one.`,\n        );\n      }\n      if (data.added_count > 0) {\n        hints.push(\n          \"Newly added brands are ingesting now — their winners fill in over the next few minutes. Check `baker winning-ads following` or `baker winning-ads feed`.\",\n        );\n      }\n\n      writeJson({ ok: true, data, hints: hints.length > 0 ? hints : undefined });\n    } catch (err) {\n      reportError(err);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;AACA,SAAS,qBAAqB;AAU9B,IAAM,mBAAmB;AAQlB,SAAS,qBAAqB,OAAmD;AACtF,QAAM,OAAO,oBAAI,IAAY;AAC7B,QAAM,SAAmB,CAAC;AAC1B,aAAW,UAAU,UAAU,MAAM,OAAO,GAAG;AAC7C,UAAM,MAAM,OAAO,YAAY;AAC/B,QAAI,KAAK,IAAI,GAAG,GAAG;AACjB;AAAA,IACF;AACA,SAAK,IAAI,GAAG;AACZ,WAAO,KAAK,MAAM;AAAA,EACpB;AACA,SAAO,EAAE,OAAO;AAClB;AAEA,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,SAAS;AAAA,MACP,MAAM;AAAA,MACN,aAAa,wFAAmF,gBAAgB;AAAA,MAChH,UAAU;AAAA,IACZ;AAAA,EACF;AACF,CAAC;AAEM,IAAM,2BAA2B,cAAc;AAAA,EACpD,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aACE;AAAA,EACJ;AAAA,EACA,MAAM;AAAA,IACJ,SAAS;AAAA,MACP,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,IACA,UAAU;AAAA,MACR,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,EACF;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,QAAI;AACF,YAAM,OAAO,qBAAqB,EAAE,SAAS,OAAO,KAAK,WAAW,EAAE,EAAE,CAAC;AACzE,UAAI,KAAK,OAAO,WAAW,GAAG;AAC5B,kBAAU;AAAA,UACR,IAAI;AAAA,UACJ,OAAO,EAAE,MAAM,oBAAoB,SAAS,yCAAyC;AAAA,QACvF,CAAC;AACD,gBAAQ,KAAK,CAAC;AAAA,MAChB;AACA,UAAI,KAAK,OAAO,SAAS,kBAAkB;AACzC,kBAAU;AAAA,UACR,IAAI;AAAA,UACJ,OAAO;AAAA,YACL,MAAM;AAAA,YACN,SAAS,oBAAoB,KAAK,OAAO,MAAM,qBAAqB,gBAAgB;AAAA,UACtF;AAAA,QACF,CAAC;AACD,gBAAQ,KAAK,CAAC;AAAA,MAChB;AAEA,YAAM,OAAO,MAAM,QAA6B,gCAAgC,MAAM;AAAA,QACpF,WAAW;AAAA,MACb,CAAC;AAED,YAAM,QAAkB,CAAC;AACzB,UAAI,KAAK,eAAe,GAAG;AACzB,cAAM,SAAS,KAAK,QAAQ,OAAO,CAAC,MAAM,EAAE,WAAW,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK;AACnF,cAAM;AAAA,UACJ,GAAG,KAAK,YAAY,gCAAgC,OAAO,KAAK,IAAI,CAAC;AAAA,QACvE;AAAA,MACF;AACA,UAAI,KAAK,kBAAkB,GAAG;AAC5B,cAAM,YAAY,KAAK,QAAQ,OAAO,CAAC,MAAM,EAAE,WAAW,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK;AACzF,cAAM;AAAA,UACJ,GAAG,KAAK,eAAe,2CAA2C,UAAU,KAAK,IAAI,CAAC;AAAA,QACxF;AAAA,MACF;AACA,UAAI,KAAK,cAAc,GAAG;AACxB,cAAM;AAAA,UACJ;AAAA,QACF;AAAA,MACF;AAEA,gBAAU,EAAE,IAAI,MAAM,MAAM,OAAO,MAAM,SAAS,IAAI,QAAQ,OAAU,CAAC;AAAA,IAC3E,SAAS,KAAK;AACZ,kBAAY,GAAG;AAAA,IACjB;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/following-DMTPVBDL.js

@@ -0,0 +1,113 @@
+import {
+  reportError,
+  splitList
+} from "./chunk-POSV2BIJ.js";
+import {
+  apiGet
+} from "./chunk-D4N5ZXEO.js";
+import "./chunk-QYDJJLEE.js";
+import "./chunk-NBPJBJJD.js";
+import {
+  applyFieldMask,
+  registerSchema,
+  writeJson,
+  writeOutput
+} from "./chunk-4TCMKTJG.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/winning-ads/following.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "winning-ads.following",
+  description: "List the brands you follow in your ad-dna library, with each one's status (ready vs still adding) and cached ad counts. A brand still adding has counts that are a lie in progress; one with `discovery_failed` has counts that are short because we couldn't finish looking, which is not the same as it running no ads.",
+  args: {}
+});
+function displayStatus(status) {
+  return status === "ready" ? "ready" : "adding\u2026";
+}
+function compactFollowed(record) {
+  return {
+    followed_id: String(record.followed_id ?? ""),
+    advertiser_id: String(record.advertiser_id ?? ""),
+    label: String(record.label ?? ""),
+    status: displayStatus(record.status),
+    active_ad_count: record.active_ad_count ?? null,
+    total_ad_count: record.total_ad_count ?? null,
+    family_count: record.family_count ?? null,
+    adding_discovered: record.adding_discovered ?? null,
+    adding_enqueued: record.adding_enqueued ?? null,
+    adding_ingested: record.adding_ingested ?? null,
+    // Without this a brand we failed to finish looking at is indistinguishable
+    // from one that genuinely runs no ads — both read `ready` with 0 ads.
+    discovery_failed: record.discovery_failed ?? null
+  };
+}
+function followingHints(records) {
+  const hints = [];
+  const label = (r) => String(r.label ?? r.advertiser_id ?? "");
+  const incomplete = records.filter((r) => r.discovery_failed === true && r.status !== "adding\u2026");
+  if (incomplete.length > 0) {
+    hints.push(
+      `${incomplete.length} brand(s) couldn't be fully added: ${incomplete.map(label).join(", ")}. Their counts are incomplete \u2014 re-run \`baker winning-ads follow <domain>\` for each to try again.`
+    );
+  }
+  const adding = records.filter((r) => r.status === "adding\u2026");
+  if (adding.length > 0) {
+    hints.push(
+      `${adding.length} brand(s) are still being added: ${adding.map(label).join(", ")}. Their ad counts fill in over the next few minutes \u2014 don't report them as final, and don't re-follow to speed it up.`
+    );
+  }
+  return hints;
+}
+function followingNormalizer(record, full) {
+  const compact = compactFollowed(record);
+  if (!full) {
+    return compact;
+  }
+  return {
+    ...compact,
+    image_url: record.image_url ?? null,
+    platforms: Array.isArray(record.platforms) ? record.platforms : []
+  };
+}
+var followingCommand = defineCommand({
+  meta: {
+    name: "following",
+    description: "List brands you follow, with status (ready / adding\u2026) and cached counts. A brand's counts are only final once it is ready. Example: baker winning-ads following --output md"
+  },
+  args: {
+    output: { type: "string", description: "Output format: json|files|md", required: false, default: "json" },
+    fields: { type: "string", description: "Comma-separated field names to include", required: false },
+    full: { type: "boolean", description: "Include image + platforms", required: false, default: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const data = await apiGet("/api/ad-library/following");
+      const output = args.output || "json";
+      const full = args.full;
+      const rawList = Array.isArray(data?.following) ? data.following : [];
+      const following = rawList.map((f) => followingNormalizer(f, full));
+      const hints = followingHints(following);
+      if (output === "json") {
+        const fields = splitList(args.fields);
+        const rows = fields.length > 0 ? following.map((f) => applyFieldMask(f, fields)) : following;
+        writeJson({ ok: true, data: { following: rows }, hints: hints.length > 0 ? hints : void 0 });
+        return;
+      }
+      writeOutput(
+        { ok: true, data: rawList, hints: hints.length > 0 ? hints : void 0 },
+        output,
+        args.fields ? args.fields.split(",") : void 0,
+        full,
+        followingNormalizer
+      );
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  followingCommand,
+  followingHints
+};
+//# sourceMappingURL=following-DMTPVBDL.js.map

package/dist/fonts-2RXRZYNY.js

@@ -0,0 +1,33 @@
+import {
+  fetchJson,
+  fontsAdoptCommand,
+  fontsCheckCommand,
+  fontsCommand,
+  fontsFetchCommand,
+  lookupGoogleCss
+} from "./chunk-JSVR7PDC.js";
+import "./chunk-N6PW6QWC.js";
+import "./chunk-4G6GXPAT.js";
+import "./chunk-PXDISZSC.js";
+import "./chunk-LOOPAOSC.js";
+import "./chunk-G3VNK6DL.js";
+import "./chunk-3GJKFY7A.js";
+import "./chunk-RO5ZC4J6.js";
+import "./chunk-PI3WJP6J.js";
+import "./chunk-ZJVHZHYP.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import "./chunk-QYDJJLEE.js";
+import "./chunk-NBPJBJJD.js";
+import "./chunk-4TCMKTJG.js";
+import "./chunk-YQSBHWOI.js";
+export {
+  fetchJson,
+  fontsAdoptCommand,
+  fontsCheckCommand,
+  fontsCommand,
+  fontsFetchCommand,
+  lookupGoogleCss
+};
+//# sourceMappingURL=fonts-2RXRZYNY.js.map

package/dist/forecast-KMINZQ4C.js

@@ -0,0 +1,168 @@
+import {
+  exitWithServiceReadError
+} from "./chunk-SG3Q24HG.js";
+import {
+  failWriteValidation,
+  keywordEntries,
+  microsFlag,
+  requireCustomerId
+} from "./chunk-63WQ24H2.js";
+import "./chunk-ERSX3MKH.js";
+import "./chunk-S4P2LQ34.js";
+import "./chunk-4NZ47VXO.js";
+import "./chunk-D5FY4FAK.js";
+import "./chunk-KXRAAA6D.js";
+import {
+  googleKeywordForecastRequestSchema
+} from "./chunk-7VHPAGPK.js";
+import {
+  getManagerIdForCustomer,
+  writeJsonEnvelope
+} from "./chunk-V44SLD5J.js";
+import "./chunk-PXDISZSC.js";
+import "./chunk-LOOPAOSC.js";
+import "./chunk-VYERPVW7.js";
+import "./chunk-3GJKFY7A.js";
+import "./chunk-RO5ZC4J6.js";
+import "./chunk-PI3WJP6J.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import {
+  apiPost
+} from "./chunk-D4N5ZXEO.js";
+import "./chunk-QYDJJLEE.js";
+import "./chunk-NBPJBJJD.js";
+import {
+  registerSchema
+} from "./chunk-4TCMKTJG.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/google/keywords/forecast.ts
+import { defineCommand } from "citty";
+var ARGS = {
+  "customer-id": { type: "string", description: "Google Ads customer ID (10 digits, no dashes)" },
+  text: {
+    type: "string",
+    description: 'Keywords to forecast, comma-separated, optional ":MATCH_TYPE" suffix each (e.g. "solar panels:PHRASE,placas solares")'
+  },
+  file: { type: "string", description: "Text file with one keyword[:MATCH_TYPE] per line" },
+  "match-type": { type: "string", description: "Default match type: EXACT | PHRASE | BROAD" },
+  "max-cpc": {
+    type: "string",
+    description: "Max CPC bid in major currency units \u2014 Manual CPC (or the ceiling under Maximize clicks)"
+  },
+  "daily-spend": {
+    type: "string",
+    description: "Daily spend in major currency units \u2014 Maximize clicks / Maximize conversions (or the daily budget under Manual CPC)"
+  },
+  strategy: {
+    type: "string",
+    description: "MANUAL_CPC | MAXIMIZE_CLICKS | MAXIMIZE_CONVERSIONS (default: MANUAL_CPC with --max-cpc alone, else MAXIMIZE_CLICKS)"
+  },
+  location: { type: "string", description: "Geo target id(s), comma-separated (see `keywords locations`)" },
+  language: { type: "string", description: "Language id (see `keywords languages`)" },
+  start: {
+    type: "string",
+    description: "First day forecast, YYYY-MM-DD (future). With --end; default: the 30 days from tomorrow"
+  },
+  end: { type: "string", description: "Last day forecast, YYYY-MM-DD (within a year)" },
+  currency: { type: "string", description: "Currency for the money figures (default: the account's)" }
+};
+registerSchema({
+  command: "ads.google.keywords.forecast",
+  description: 'Forecast clicks, cost, conversions and average CPC / CPA for a set of keywords under one bidding strategy, over a period (Keyword Planner, v25). Start here: `baker ads google keywords forecast --customer-id 1234567890 --text "solar panels:PHRASE,placas solares:EXACT" --max-cpc 1.5 --location 2724 --language 1003`. Returns { source: "keyword_planner_forecast", period, forecast_* } \u2014 Google\'s prediction for the whole period, never an account result.',
+  args: Object.fromEntries(
+    Object.entries(ARGS).map(([name, arg]) => [
+      name,
+      { type: arg.type, description: arg.description, required: false }
+    ])
+  )
+});
+function amount(args, flag) {
+  return args[flag] === void 0 ? void 0 : microsFlag(args[flag], `--${flag}`);
+}
+function namedStrategy(args, maxCpc, spend) {
+  if (typeof args.strategy === "string") return args.strategy.toUpperCase();
+  return maxCpc !== void 0 && spend === void 0 ? "MANUAL_CPC" : "MAXIMIZE_CLICKS";
+}
+function forecastBidding(args) {
+  const maxCpc = amount(args, "max-cpc");
+  const spend = amount(args, "daily-spend");
+  const strategy = namedStrategy(args, maxCpc, spend);
+  if (strategy === "MANUAL_CPC") {
+    if (maxCpc === void 0) return { ok: false, message: "Manual CPC needs --max-cpc" };
+    return { ok: true, bidding: { strategy, maxCpcBidMicros: maxCpc, ...spend ? { dailyBudgetMicros: spend } : {} } };
+  }
+  if (strategy !== "MAXIMIZE_CLICKS" && strategy !== "MAXIMIZE_CONVERSIONS") {
+    return {
+      ok: false,
+      message: `--strategy ${strategy} is not one Google forecasts: MANUAL_CPC | MAXIMIZE_CLICKS | MAXIMIZE_CONVERSIONS`
+    };
+  }
+  if (spend === void 0) return { ok: false, message: `${strategy} needs --daily-spend` };
+  if (strategy === "MAXIMIZE_CONVERSIONS") return { ok: true, bidding: { strategy, dailyTargetSpendMicros: spend } };
+  return {
+    ok: true,
+    bidding: { strategy, dailyTargetSpendMicros: spend, ...maxCpc ? { maxCpcBidCeilingMicros: maxCpc } : {} }
+  };
+}
+function hints(data) {
+  const out = [
+    `Google's prediction for ${data.period.startDate}\u2013${data.period.endDate}, not an account result: quote it as a forecast.`
+  ];
+  if (data.forecast_clicks === null && data.forecast_cost_micros === null) {
+    out.push(
+      "Google forecast nothing for these keywords \u2014 too little search volume in the chosen locations, or the bid is too low to win auctions."
+    );
+  }
+  return out;
+}
+var forecastCommand = defineCommand({
+  meta: {
+    name: "forecast",
+    description: `Forecast clicks, cost and conversions for keywords under one bidding strategy (Keyword Planner).
+
+Examples:
+  baker ads google keywords forecast --customer-id 1234567890 --text "solar panels:PHRASE,placas solares:EXACT" --max-cpc 1.5 --location 2724 --language 1003
+  baker ads google keywords forecast --customer-id 1234567890 --text "crm software" --match-type BROAD --daily-spend 20 --strategy MAXIMIZE_CONVERSIONS --start 2026-11-01 --end 2026-11-30`
+  },
+  args: ARGS,
+  run: async ({ args, rawArgs }) => {
+    const customerId = requireCustomerId(args);
+    const keywords = keywordEntries(args, rawArgs);
+    const bidding = forecastBidding(args);
+    if (!bidding.ok) failWriteValidation(bidding.message);
+    const managerId = getManagerIdForCustomer(customerId);
+    const request = googleKeywordForecastRequestSchema.safeParse({
+      customerId,
+      ...managerId ? { managerId } : {},
+      adGroups: [{ keywords }],
+      ...args.location ? {
+        locationIds: String(args.location).split(",").map((id) => id.trim())
+      } : {},
+      ...args.language ? { languageId: String(args.language) } : {},
+      bidding: bidding.bidding,
+      ...args.start ? { startDate: args.start } : {},
+      ...args.end ? { endDate: args.end } : {},
+      ...args.currency ? { currencyCode: String(args.currency).toUpperCase() } : {}
+    });
+    if (!request.success) {
+      const issue = request.error.issues[0];
+      failWriteValidation(issue ? `${issue.path.join(".")}: ${issue.message}` : "Invalid forecast");
+    }
+    try {
+      const { data } = await apiPost(
+        "/api/ads/google/keywords/forecast",
+        request.data
+      );
+      writeJsonEnvelope({ ok: true, data, hints: hints(data) });
+    } catch (err) {
+      exitWithServiceReadError(err);
+    }
+  }
+});
+export {
+  forecastBidding,
+  forecastCommand
+};
+//# sourceMappingURL=forecast-KMINZQ4C.js.map

package/dist/forecast-YK7PPKD3.js

@@ -0,0 +1,103 @@
+import {
+  handleLinkedinError,
+  resolveAccountIdArg
+} from "./chunk-WSYGMU3A.js";
+import {
+  writeAdsJson
+} from "./chunk-V44SLD5J.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-X7ZODEXJ.js";
+import "./chunk-ZJVHZHYP.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import {
+  apiPost
+} from "./chunk-D4N5ZXEO.js";
+import "./chunk-QYDJJLEE.js";
+import "./chunk-NBPJBJJD.js";
+import "./chunk-4TCMKTJG.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/forecast.ts
+import { readFileSync } from "fs";
+import { defineCommand } from "citty";
+function loadTargeting(args) {
+  const inline = args.targeting;
+  if (inline) {
+    try {
+      return JSON.parse(inline);
+    } catch {
+      handleLinkedinError(new Error("--targeting must be valid JSON."));
+    }
+  }
+  const file = args["targeting-file"];
+  if (file) {
+    try {
+      return JSON.parse(readFileSync(file, "utf-8"));
+    } catch (e) {
+      handleLinkedinError(
+        new Error(`Failed to read --targeting-file: ${e instanceof Error ? e.message : "I/O error"}`)
+      );
+    }
+  }
+  handleLinkedinError(new Error("Pass --targeting-file <path> or --targeting '{...JSON...}'"));
+}
+function parseMoney(raw) {
+  if (!raw) return void 0;
+  const m = /^(\d+(?:\.\d+)?)(?:\s+([A-Z]{3}))?$/.exec(raw.trim());
+  if (!m) {
+    handleLinkedinError(new Error(`Invalid money "${raw}". Use "100" or "100 EUR".`));
+  }
+  return { amount: m[1] ?? "0", currencyCode: m[2] ?? "USD" };
+}
+var forecastCommand = defineCommand({
+  meta: {
+    name: "forecast",
+    description: `Forecast reach + impressions + clicks + spend for a hypothetical campaign.
+
+Wraps /rest/adSupplyForecasts. Useful for greenfield (\xA714) \u2014 answers
+"if we launch with this budget + targeting + objective, what's the expected delivery?"
+
+Examples:
+  baker ads linkedin forecast --account-id 503001492 --objective LEAD_GENERATION --cost-type CPC \\
+    --daily-budget "200 USD" --bid "8 USD" --targeting-file targeting.json`
+  },
+  args: {
+    "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+    "account-urn": { type: "string", description: "Alias for --account-id" },
+    objective: { type: "string", description: "Objective type", required: true },
+    "cost-type": { type: "string", description: "CPC | CPM | CPV | CPS", required: true },
+    "daily-budget": { type: "string", description: "e.g. '200 USD' or '200'" },
+    "total-budget": { type: "string", description: "e.g. '6000 USD'" },
+    bid: { type: "string", description: "Bid e.g. '8 USD'" },
+    targeting: { type: "string", description: "Inline JSON targetingCriteria" },
+    "targeting-file": { type: "string", description: "Path to JSON file with targetingCriteria" },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json", default: "json" }
+  },
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    const targetingCriteria = loadTargeting(args);
+    try {
+      const data = await apiPost("/api/ads/linkedin/forecast", {
+        accountId,
+        objectiveType: String(args.objective),
+        costType: String(args["cost-type"]).toUpperCase(),
+        targetingCriteria,
+        dailyBudget: parseMoney(args["daily-budget"]),
+        totalBudget: parseMoney(args["total-budget"]),
+        bid: parseMoney(args.bid),
+        skipCache: Boolean(args["no-cache"])
+      });
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+export {
+  forecastCommand
+};
+//# sourceMappingURL=forecast-YK7PPKD3.js.map

package/dist/funding-BZ52CED5.js

@@ -0,0 +1,85 @@
+import {
+  parseXApiError
+} from "./chunk-M6UNISGO.js";
+import {
+  resolveXAccountId
+} from "./chunk-7EBQ2WTU.js";
+import {
+  cacheGet,
+  cacheSet,
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-V44SLD5J.js";
+import {
+  ApiError,
+  apiGet
+} from "./chunk-D4N5ZXEO.js";
+import "./chunk-QYDJJLEE.js";
+import "./chunk-NBPJBJJD.js";
+import {
+  registerSchema
+} from "./chunk-4TCMKTJG.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/funding.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.x.funding",
+  description: "List funding instruments for an X Ads account. Returns id, type, currency, credit_limit_local_micro, funded_amount_local_micro, status. Falls back to BAKER_X_ADS_ACCOUNT_ID env var.",
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID (base36)", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    output: { type: "string", description: "Format: json|csv|md", required: false, default: "json" }
+  }
+});
+var fundingCommand = defineCommand({
+  meta: {
+    name: "funding",
+    description: `List funding instruments for an X Ads account.
+
+Examples:
+  baker ads x funding --account-id 18ce53xyz`
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    output: { type: "string", description: "Format: json|csv|md", required: false, default: "json" }
+  },
+  run: async ({ args }) => {
+    const accountId = await resolveXAccountId(args);
+    const useCache = !args["no-cache"];
+    const cacheKey = `funding:${accountId}`;
+    if (useCache) {
+      const cached = cacheGet("x-account-data", cacheKey);
+      if (cached) {
+        writeAdsJson({ ok: true, data: cached.data, cached: true });
+        return;
+      }
+    }
+    try {
+      const params = { "account-id": accountId };
+      if (!useCache) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/x/funding-instruments", params);
+      if (useCache) {
+        cacheSet("x-account-data", cacheKey, data, 60 * 60 * 1e3);
+      }
+      const format = args.output || "json";
+      if (format !== "json") {
+        writeAdsOutput(data, format);
+        return;
+      }
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeAdsJson(parseXApiError(err.message, accountId));
+        process.exit(1);
+      }
+      writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  fundingCommand
+};
+//# sourceMappingURL=funding-BZ52CED5.js.map