@koda-sl/baker-cli 0.477.0-dev.55c09e3e8 → 0.478.0

package/dist/follow-IUW3P6KH.js

@@ -0,0 +1,94 @@
+import {
+  PLATFORM_NAMES,
+  reportError
+} from "./chunk-MUHPBWE5.js";
+import {
+  apiPost
+} from "./chunk-7ANWFQEA.js";
+import "./chunk-KODTY7PB.js";
+import "./chunk-H5CGVMQW.js";
+import {
+  brandAccountInput,
+  registerSchema,
+  writeJson
+} from "./chunk-ANYMWCST.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/winning-ads/follow.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "winning-ads.follow",
+  description: "Follow a brand so ALL its ads join your library \u2014 every platform (Meta, LinkedIn, TikTok, Google Ads), every account it runs there (one Facebook page per market, each Google entity) and every country. Paste whatever you have: a website (best \u2014 finds every account it links), a brand name, or any profile / ad-library link. Already-in-corpus brands are subscribed instantly; new brands are queued for ingestion. Accounts only named like the brand come back as `suggestions` with a ready `add-accounts` command.",
+  args: {
+    input: {
+      type: "string",
+      description: "Website (best), brand name, or any profile/ad-library link",
+      required: true
+    },
+    label: { type: "string", description: "Optional display label (defaults to the resolved name)", required: false }
+  }
+});
+function followHints(data) {
+  const hints = [];
+  if (data.status === "added") {
+    hints.push(
+      "This brand is new \u2014 we're adding every ad we can find across all platforms and countries. They appear as ingestion completes; check `baker winning-ads following`."
+    );
+  } else if (data.status === "ambiguous") {
+    hints.push(
+      "Multiple brands matched. Pick one from `candidates` and re-run `follow` with its exact website or link."
+    );
+  }
+  const suggestions = data.suggestions ?? [];
+  const names = suggestions.map((s) => `${s.name} (${PLATFORM_NAMES[s.platform]})`).join(", ");
+  if (data.status === "unconfirmed") {
+    const [first] = suggestions;
+    hints.push(
+      `Nothing followed yet: we found no account we're sure is this brand's, only accounts named like it: ${names}. Follow the brand's own with its link, e.g. baker winning-ads follow "${first ? brandAccountInput(first) : ""}", then add its other markets' accounts with \`add-accounts\`. Or retry with the brand's website.`
+    );
+    return hints;
+  }
+  if (data.advertiser && suggestions.length > 0) {
+    const inputs = suggestions.map(brandAccountInput).join(",");
+    hints.push(
+      `Also found accounts named like this brand, not tracked yet: ${names}. If they are the same brand (another country or language), track them with: baker winning-ads add-accounts ${data.advertiser.advertiser_id} "${inputs}" \u2014 drop any that belong to someone else.`
+    );
+  }
+  return hints.length > 0 ? hints : void 0;
+}
+var followCommand = defineCommand({
+  meta: {
+    name: "follow",
+    description: 'Follow a brand to track ALL its ads \u2014 every platform, every account and country. Paste a website (best), a brand name, or any profile/ad-library link. Example: baker winning-ads follow "barkibu.com"'
+  },
+  args: {
+    input: {
+      type: "positional",
+      description: "Website (best), brand name, or any profile/ad-library link",
+      required: true
+    },
+    label: { type: "string", description: "Optional display label", required: false },
+    platform: {
+      type: "string",
+      description: "Ignored \u2014 every platform is searched. Kept so older commands still run.",
+      required: false
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const body = { input: String(args.input) };
+      if (args.label) {
+        body.label = String(args.label);
+      }
+      const data = await apiPost("/api/ad-library/follow", body);
+      writeJson({ ok: true, data, hints: followHints(data) });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  followCommand,
+  followHints
+};
+//# sourceMappingURL=follow-IUW3P6KH.js.map

package/dist/follow-competitors-YDF5WM4K.js

@@ -0,0 +1,112 @@
+import {
+  reportError,
+  splitList
+} from "./chunk-MUHPBWE5.js";
+import {
+  apiPost
+} from "./chunk-7ANWFQEA.js";
+import "./chunk-KODTY7PB.js";
+import "./chunk-H5CGVMQW.js";
+import {
+  FOLLOW_BATCH_MAX,
+  registerSchema,
+  writeJson
+} from "./chunk-ANYMWCST.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-YDF5WM4K.js.map

package/dist/following-PNOYUSHX.js

@@ -0,0 +1,113 @@
+import {
+  reportError,
+  splitList
+} from "./chunk-MUHPBWE5.js";
+import {
+  apiGet
+} from "./chunk-7ANWFQEA.js";
+import "./chunk-KODTY7PB.js";
+import "./chunk-H5CGVMQW.js";
+import {
+  applyFieldMask,
+  registerSchema,
+  writeJson,
+  writeOutput
+} from "./chunk-ANYMWCST.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-PNOYUSHX.js.map

package/dist/fonts-T4M2DIJV.js

@@ -0,0 +1,34 @@
+import {
+  fetchJson,
+  fontsAdoptCommand,
+  fontsCheckCommand,
+  fontsCommand,
+  fontsFetchCommand,
+  lookupGoogleCss
+} from "./chunk-MN25G3MA.js";
+import "./chunk-JOXSQDDP.js";
+import "./chunk-PBC63KPH.js";
+import "./chunk-HH5PFZ7U.js";
+import "./chunk-ANWV2VTO.js";
+import "./chunk-OST3RA6Q.js";
+import "./chunk-NKXH3I65.js";
+import "./chunk-CPTOHQSJ.js";
+import "./chunk-JRLGQA2T.js";
+import "./chunk-A5VAM472.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import "./chunk-KODTY7PB.js";
+import "./chunk-H5CGVMQW.js";
+import "./chunk-ANYMWCST.js";
+import "./chunk-YQSBHWOI.js";
+export {
+  fetchJson,
+  fontsAdoptCommand,
+  fontsCheckCommand,
+  fontsCommand,
+  fontsFetchCommand,
+  lookupGoogleCss
+};
+//# sourceMappingURL=fonts-T4M2DIJV.js.map

package/dist/forecast-BA26XWJG.js

@@ -0,0 +1,118 @@
+import {
+  LINKEDIN_FORECAST_DEFAULT_DAYS,
+  linkedinForecastRequestSchema
+} from "./chunk-VX45CG4L.js";
+import {
+  exitOnInvalidArgs,
+  handleLinkedinError,
+  loadTargetingArg,
+  resolveAccountIdArg
+} from "./chunk-22WY4M2Y.js";
+import {
+  writeAdsJson
+} from "./chunk-AAF7HL4I.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-O6VUX3O5.js";
+import "./chunk-A5VAM472.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import {
+  apiPost
+} from "./chunk-7ANWFQEA.js";
+import "./chunk-KODTY7PB.js";
+import "./chunk-H5CGVMQW.js";
+import "./chunk-ANYMWCST.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/forecast.ts
+import { defineCommand } from "citty";
+var FLAG_OF_FIELD = {
+  objectiveType: "--objective",
+  costType: "--cost-type",
+  campaignType: "--campaign-type",
+  startDate: "--start",
+  days: "--days",
+  dailyBudget: "--daily-budget",
+  totalBudget: "--total-budget",
+  bid: "--bid",
+  optimizationTarget: "--optimization-target",
+  targetingCriteria: "--targeting"
+};
+function parseMoney(raw) {
+  if (typeof raw !== "string" || raw.trim() === "") return void 0;
+  const m = /^(\d+(?:\.\d+)?)(?:\s+([A-Za-z]{3}))?$/.exec(raw.trim());
+  if (!m?.[1]) return raw;
+  return m[2] ? { amount: m[1], currencyCode: m[2].toUpperCase() } : { amount: m[1] };
+}
+var forecastCommand = defineCommand({
+  meta: {
+    name: "forecast",
+    description: `Forecast what a campaign that doesn't exist yet would deliver \u2014 LinkedIn's own estimate, the "Forecasted results" Campaign Manager shows while building one.
+
+Returns, for the whole period: results (impressions, clicks, leads, spend, \u2026), LinkedIn's unit costs (cpc, cpm, costPerLead, \u2026) and rates (ctr, \u2026), each as { value, low, high }. Unit costs are LinkedIn's per-result estimates and need not equal spend \xF7 results; spend can stay under the budget when the bid or audience caps delivery.
+
+A budget is required (--daily-budget or --total-budget). With --bid it forecasts that manual bid (get one from \`bid-pricing\`); without it, LinkedIn's automated bidding for the objective (LEAD_GENERATION, WEBSITE_VISIT, BRAND_AWARENESS, VIDEO_VIEW \u2014 others need --bid or --optimization-target). The period starts tomorrow (or --start) and lasts --days (default ${LINKEDIN_FORECAST_DEFAULT_DAYS}). Amounts without a currency use the ad account's.
+
+Start here:
+  baker ads linkedin forecast --account-id 503001492 --objective LEAD_GENERATION --total-budget 7250 --days 28 --targeting-file targeting.json
+  baker ads linkedin forecast --account-id 503001492 --objective LEAD_GENERATION --bid 5.57 --cost-type CPC --daily-budget "250 EUR" --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 (e.g. LEAD_GENERATION, WEBSITE_VISIT)" },
+    "cost-type": { type: "string", description: "Bid type of --bid: CPC (default) | CPM | CPV", default: "CPC" },
+    "campaign-type": {
+      type: "string",
+      description: "SPONSORED_UPDATES (default, sponsored content) | SPONSORED_INMAILS | DYNAMIC",
+      default: "SPONSORED_UPDATES"
+    },
+    "daily-budget": { type: "string", description: "e.g. '250' or '250 EUR'" },
+    "total-budget": { type: "string", description: "Budget for the whole period, e.g. '7250' or '7250 EUR'" },
+    bid: { type: "string", description: "Manual bid, e.g. '5.57' or '5.57 EUR'. Omit for automated bidding" },
+    "optimization-target": {
+      type: "string",
+      description: "Automated-bidding goal when --bid is omitted (e.g. MAX_LEAD, MAX_CLICK)"
+    },
+    start: { type: "string", description: "First day, YYYY-MM-DD (default tomorrow, UTC)" },
+    days: { type: "string", description: `Length of the period in days (default ${LINKEDIN_FORECAST_DEFAULT_DAYS})` },
+    targeting: { type: "string", description: "Inline JSON targetingCriteria" },
+    "targeting-file": { type: "string", description: "Path to JSON file with targetingCriteria" },
+    full: { type: "boolean", description: "Also return LinkedIn's daily / 7-day / 30-day series", default: false },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json", default: "json" }
+  },
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    const targetingCriteria = loadTargetingArg(args);
+    const parsed = linkedinForecastRequestSchema.safeParse({
+      accountId,
+      objectiveType: args.objective ? String(args.objective).toUpperCase() : void 0,
+      costType: String(args["cost-type"]).toUpperCase(),
+      campaignType: String(args["campaign-type"]).toUpperCase(),
+      startDate: args.start || void 0,
+      days: args.days ? Number(args.days) : void 0,
+      dailyBudget: parseMoney(args["daily-budget"]),
+      totalBudget: parseMoney(args["total-budget"]),
+      bid: parseMoney(args.bid),
+      optimizationTarget: args["optimization-target"] ? String(args["optimization-target"]).toUpperCase() : void 0,
+      targetingCriteria,
+      full: Boolean(args.full),
+      skipCache: Boolean(args["no-cache"])
+    });
+    if (!parsed.success) exitOnInvalidArgs(parsed.error.issues, FLAG_OF_FIELD);
+    try {
+      const data = await apiPost("/api/ads/linkedin/forecast", parsed.data);
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+export {
+  forecastCommand
+};
+//# sourceMappingURL=forecast-BA26XWJG.js.map

package/dist/forecast-BA26XWJG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/linkedin/forecast.ts"],"sourcesContent":["import { LINKEDIN_FORECAST_DEFAULT_DAYS, linkedinForecastRequestSchema } from \"@baker/api/ads-linkedin/planning\";\nimport { defineCommand } from \"citty\";\nimport { NO_CACHE_ARG } from \"../../../cache-flag.ts\";\nimport { apiPost } from \"../../../client.ts\";\nimport { writeAdsJson } from \"../output.ts\";\nimport { exitOnInvalidArgs, handleLinkedinError, loadTargetingArg, resolveAccountIdArg } from \"./shared.ts\";\n\nconst FLAG_OF_FIELD: Record<string, string> = {\n  objectiveType: \"--objective\",\n  costType: \"--cost-type\",\n  campaignType: \"--campaign-type\",\n  startDate: \"--start\",\n  days: \"--days\",\n  dailyBudget: \"--daily-budget\",\n  totalBudget: \"--total-budget\",\n  bid: \"--bid\",\n  optimizationTarget: \"--optimization-target\",\n  targetingCriteria: \"--targeting\",\n};\n\ntype Money = { amount: string; currencyCode: string };\ntype Range = { value: number; low: number; high: number };\n\ninterface ForecastResult {\n  period: { start: string; end: string; days: number };\n  budget: { daily?: Money; total?: Money };\n  bidding: { mode: \"manual\"; bidType: string; bid: Money } | { mode: \"auto\"; optimizationTarget: string };\n  results: Record<string, Range>;\n  unitCosts: Record<string, Range>;\n  rates: Record<string, Range>;\n  series?: unknown[];\n}\n\n/** \"250\" or \"250 EUR\" → money; no currency means the ad account's. */\nfunction parseMoney(raw: unknown): { amount: string; currencyCode?: string } | string | undefined {\n  if (typeof raw !== \"string\" || raw.trim() === \"\") return undefined;\n  const m = /^(\\d+(?:\\.\\d+)?)(?:\\s+([A-Za-z]{3}))?$/.exec(raw.trim());\n  if (!m?.[1]) return raw;\n  return m[2] ? { amount: m[1], currencyCode: m[2].toUpperCase() } : { amount: m[1] };\n}\n\nexport const forecastCommand = defineCommand({\n  meta: {\n    name: \"forecast\",\n    description: `Forecast what a campaign that doesn't exist yet would deliver — LinkedIn's own estimate, the \"Forecasted results\" Campaign Manager shows while building one.\n\nReturns, for the whole period: results (impressions, clicks, leads, spend, …), LinkedIn's unit costs (cpc, cpm, costPerLead, …) and rates (ctr, …), each as { value, low, high }. Unit costs are LinkedIn's per-result estimates and need not equal spend ÷ results; spend can stay under the budget when the bid or audience caps delivery.\n\nA budget is required (--daily-budget or --total-budget). With --bid it forecasts that manual bid (get one from \\`bid-pricing\\`); without it, LinkedIn's automated bidding for the objective (LEAD_GENERATION, WEBSITE_VISIT, BRAND_AWARENESS, VIDEO_VIEW — others need --bid or --optimization-target). The period starts tomorrow (or --start) and lasts --days (default ${LINKEDIN_FORECAST_DEFAULT_DAYS}). Amounts without a currency use the ad account's.\n\nStart here:\n  baker ads linkedin forecast --account-id 503001492 --objective LEAD_GENERATION --total-budget 7250 --days 28 --targeting-file targeting.json\n  baker ads linkedin forecast --account-id 503001492 --objective LEAD_GENERATION --bid 5.57 --cost-type CPC --daily-budget \"250 EUR\" --targeting-file targeting.json`,\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"Numeric account ID or urn:li:sponsoredAccount:N\" },\n    \"account-urn\": { type: \"string\", description: \"Alias for --account-id\" },\n    objective: { type: \"string\", description: \"Objective type (e.g. LEAD_GENERATION, WEBSITE_VISIT)\" },\n    \"cost-type\": { type: \"string\", description: \"Bid type of --bid: CPC (default) | CPM | CPV\", default: \"CPC\" },\n    \"campaign-type\": {\n      type: \"string\",\n      description: \"SPONSORED_UPDATES (default, sponsored content) | SPONSORED_INMAILS | DYNAMIC\",\n      default: \"SPONSORED_UPDATES\",\n    },\n    \"daily-budget\": { type: \"string\", description: \"e.g. '250' or '250 EUR'\" },\n    \"total-budget\": { type: \"string\", description: \"Budget for the whole period, e.g. '7250' or '7250 EUR'\" },\n    bid: { type: \"string\", description: \"Manual bid, e.g. '5.57' or '5.57 EUR'. Omit for automated bidding\" },\n    \"optimization-target\": {\n      type: \"string\",\n      description: \"Automated-bidding goal when --bid is omitted (e.g. MAX_LEAD, MAX_CLICK)\",\n    },\n    start: { type: \"string\", description: \"First day, YYYY-MM-DD (default tomorrow, UTC)\" },\n    days: { type: \"string\", description: `Length of the period in days (default ${LINKEDIN_FORECAST_DEFAULT_DAYS})` },\n    targeting: { type: \"string\", description: \"Inline JSON targetingCriteria\" },\n    \"targeting-file\": { type: \"string\", description: \"Path to JSON file with targetingCriteria\" },\n    full: { type: \"boolean\", description: \"Also return LinkedIn's daily / 7-day / 30-day series\", default: false },\n    \"no-cache\": NO_CACHE_ARG,\n    output: { type: \"string\", description: \"json\", default: \"json\" },\n  },\n  run: async ({ args }) => {\n    const accountId = resolveAccountIdArg(args);\n    const targetingCriteria = loadTargetingArg(args);\n    const parsed = linkedinForecastRequestSchema.safeParse({\n      accountId,\n      objectiveType: args.objective ? String(args.objective).toUpperCase() : undefined,\n      costType: String(args[\"cost-type\"]).toUpperCase(),\n      campaignType: String(args[\"campaign-type\"]).toUpperCase(),\n      startDate: args.start || undefined,\n      days: args.days ? Number(args.days) : undefined,\n      dailyBudget: parseMoney(args[\"daily-budget\"]),\n      totalBudget: parseMoney(args[\"total-budget\"]),\n      bid: parseMoney(args.bid),\n      optimizationTarget: args[\"optimization-target\"] ? String(args[\"optimization-target\"]).toUpperCase() : undefined,\n      targetingCriteria,\n      full: Boolean(args.full),\n      skipCache: Boolean(args[\"no-cache\"]),\n    });\n    if (!parsed.success) exitOnInvalidArgs(parsed.error.issues, FLAG_OF_FIELD);\n    try {\n      const data = await apiPost<ForecastResult>(\"/api/ads/linkedin/forecast\", parsed.data);\n      writeAdsJson({ ok: true, data });\n    } catch (err) {\n      handleLinkedinError(err);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/forecast-NHG3UHOP.js

@@ -0,0 +1,168 @@
+import {
+  exitWithServiceReadError
+} from "./chunk-4EPGI6I2.js";
+import {
+  failWriteValidation,
+  keywordEntries,
+  microsFlag,
+  requireCustomerId
+} from "./chunk-SBN5UIQY.js";
+import "./chunk-ERSX3MKH.js";
+import "./chunk-26HCUIW2.js";
+import "./chunk-4NZ47VXO.js";
+import "./chunk-D5FY4FAK.js";
+import "./chunk-QKUBK3AD.js";
+import {
+  googleKeywordForecastRequestSchema
+} from "./chunk-7VHPAGPK.js";
+import {
+  getManagerIdForCustomer,
+  writeJsonEnvelope
+} from "./chunk-AAF7HL4I.js";
+import "./chunk-HH5PFZ7U.js";
+import "./chunk-ANWV2VTO.js";
+import "./chunk-UW7PZFWZ.js";
+import "./chunk-NKXH3I65.js";
+import "./chunk-CPTOHQSJ.js";
+import "./chunk-JRLGQA2T.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import {
+  apiPost
+} from "./chunk-7ANWFQEA.js";
+import "./chunk-KODTY7PB.js";
+import "./chunk-H5CGVMQW.js";
+import {
+  registerSchema
+} from "./chunk-ANYMWCST.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-NHG3UHOP.js.map