@koda-sl/baker-cli 0.447.0 → 0.448.0-dev.ccc3c9a37

package/dist/following-CA5BQXYB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/winning-ads/following.ts"],"sourcesContent":["import type { FollowingListResponse } from \"@baker/api/ad-library\";\nimport { defineCommand } from \"citty\";\nimport { apiGet } from \"../../client.ts\";\nimport { applyFieldMask, type OutputFormat, writeJson, writeOutput } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { reportError, splitList } from \"./shared.ts\";\n\nregisterSchema({\n  command: \"winning-ads.following\",\n  description:\n    \"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.\",\n  args: {},\n});\n\n/**\n * Turn the corpus status enum into plain product language. Both unsettled\n * stages read as \"adding…\" — the distinction between enumerating a brand's ads\n * and processing them is ours to manage, not something to explain here.\n */\nfunction displayStatus(status: unknown): string {\n  return status === \"ready\" ? \"ready\" : \"adding…\";\n}\n\nfunction compactFollowed(record: Record<string, unknown>): Record<string, unknown> {\n  return {\n    followed_id: String(record.followed_id ?? \"\"),\n    advertiser_id: String(record.advertiser_id ?? \"\"),\n    label: String(record.label ?? \"\"),\n    status: displayStatus(record.status),\n    active_ad_count: (record.active_ad_count as number) ?? null,\n    total_ad_count: (record.total_ad_count as number) ?? null,\n    family_count: (record.family_count as number) ?? null,\n    adding_discovered: (record.adding_discovered as number) ?? null,\n    adding_enqueued: (record.adding_enqueued as number) ?? null,\n    adding_ingested: (record.adding_ingested as number) ?? null,\n    // Without this a brand we failed to finish looking at is indistinguishable\n    // from one that genuinely runs no ads — both read `ready` with 0 ads.\n    discovery_failed: (record.discovery_failed as boolean) ?? null,\n  };\n}\n\n/**\n * Steer on the two states a caller would otherwise misread: a brand still\n * filling in (its counts are a lie in progress) and one we couldn't finish\n * (its counts are short, and re-following is the retry).\n */\nexport function followingHints(records: Array<Record<string, unknown>>): string[] {\n  const hints: string[] = [];\n  const label = (r: Record<string, unknown>) => String(r.label ?? r.advertiser_id ?? \"\");\n\n  const incomplete = records.filter((r) => r.discovery_failed === true && r.status !== \"adding…\");\n  if (incomplete.length > 0) {\n    hints.push(\n      `${incomplete.length} brand(s) couldn't be fully added: ${incomplete.map(label).join(\", \")}. Their counts are incomplete — re-run \\`baker winning-ads follow <domain>\\` for each to try again.`,\n    );\n  }\n\n  const adding = records.filter((r) => r.status === \"adding…\");\n  if (adding.length > 0) {\n    hints.push(\n      `${adding.length} brand(s) are still being added: ${adding.map(label).join(\", \")}. Their ad counts fill in over the next few minutes — don't report them as final, and don't re-follow to speed it up.`,\n    );\n  }\n  return hints;\n}\n\nfunction followingNormalizer(record: Record<string, unknown>, full: boolean): Record<string, unknown> {\n  const compact = compactFollowed(record);\n  if (!full) {\n    return compact;\n  }\n  return {\n    ...compact,\n    image_url: (record.image_url as string) ?? null,\n    platforms: Array.isArray(record.platforms) ? record.platforms : [],\n  };\n}\n\nexport const followingCommand = defineCommand({\n  meta: {\n    name: \"following\",\n    description:\n      \"List brands you follow, with status (ready / adding…) and cached counts. A brand's counts are only final once it is ready. Example: baker winning-ads following --output md\",\n  },\n  args: {\n    output: { type: \"string\", description: \"Output format: json|files|md\", required: false, default: \"json\" },\n    fields: { type: \"string\", description: \"Comma-separated field names to include\", required: false },\n    full: { type: \"boolean\", description: \"Include image + platforms\", required: false, default: false },\n  },\n  run: async ({ args }) => {\n    try {\n      const data = await apiGet<FollowingListResponse>(\"/api/ad-library/following\");\n      const output = (args.output as OutputFormat) || \"json\";\n      const full = args.full as boolean;\n      const rawList = Array.isArray(data?.following) ? data.following : [];\n\n      const following = rawList.map((f) => followingNormalizer(f as unknown as Record<string, unknown>, full));\n      const hints = followingHints(following);\n\n      if (output === \"json\") {\n        const fields = splitList(args.fields as string | undefined);\n        const rows = fields.length > 0 ? following.map((f) => applyFieldMask(f, fields)) : following;\n        writeJson({ ok: true, data: { following: rows }, hints: hints.length > 0 ? hints : undefined });\n        return;\n      }\n      // `md`/`files` print rows and nothing else, so the envelope's hints are\n      // what carry the steering — `writeOutput` sends them to stderr, which\n      // keeps stdout parseable for anything reading the rows.\n      writeOutput(\n        { ok: true, data: rawList, hints: hints.length > 0 ? hints : undefined },\n        output,\n        args.fields ? (args.fields as string).split(\",\") : undefined,\n        full,\n        followingNormalizer,\n      );\n    } catch (err) {\n      reportError(err);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/fonts-KUCQAR7N.js

@@ -0,0 +1,34 @@
+import {
+  fetchJson,
+  fontsAdoptCommand,
+  fontsCheckCommand,
+  fontsCommand,
+  fontsFetchCommand,
+  lookupGoogleCss
+} from "./chunk-OXKUWTFL.js";
+import "./chunk-KWMYTVHI.js";
+import "./chunk-I4IVUAQN.js";
+import "./chunk-JF5LNI6O.js";
+import "./chunk-F3IVR3V3.js";
+import "./chunk-4KBWL7S4.js";
+import "./chunk-DJPCTTUN.js";
+import "./chunk-BJEW3LST.js";
+import "./chunk-SSVZM3P6.js";
+import "./chunk-MAGSNHYB.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-I2DNBEV6.js";
+import "./chunk-2ZZR2SOF.js";
+import "./chunk-YPCVPDU7.js";
+import "./chunk-D3RTGIT4.js";
+import "./chunk-YQSBHWOI.js";
+export {
+  fetchJson,
+  fontsAdoptCommand,
+  fontsCheckCommand,
+  fontsCommand,
+  fontsFetchCommand,
+  lookupGoogleCss
+};
+//# sourceMappingURL=fonts-KUCQAR7N.js.map

package/dist/forecast-G5KRTVDM.js

@@ -0,0 +1,168 @@
+import {
+  exitWithServiceReadError
+} from "./chunk-CLK2FPAV.js";
+import {
+  failWriteValidation,
+  keywordEntries,
+  microsFlag,
+  requireCustomerId
+} from "./chunk-LLN6WTER.js";
+import "./chunk-ERSX3MKH.js";
+import "./chunk-536R4RRM.js";
+import "./chunk-4NZ47VXO.js";
+import "./chunk-D5FY4FAK.js";
+import "./chunk-YTWNY3RF.js";
+import {
+  googleKeywordForecastRequestSchema
+} from "./chunk-SEPPFM5S.js";
+import {
+  getManagerIdForCustomer,
+  writeJsonEnvelope
+} from "./chunk-6SL6463H.js";
+import "./chunk-JF5LNI6O.js";
+import "./chunk-F3IVR3V3.js";
+import "./chunk-LFGCOAB4.js";
+import "./chunk-DJPCTTUN.js";
+import "./chunk-BJEW3LST.js";
+import "./chunk-SSVZM3P6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-I2DNBEV6.js";
+import {
+  apiPost
+} from "./chunk-MMOTJIV6.js";
+import "./chunk-2ZZR2SOF.js";
+import "./chunk-YPCVPDU7.js";
+import {
+  registerSchema
+} from "./chunk-D3RTGIT4.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-G5KRTVDM.js.map

package/dist/forecast-G5KRTVDM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/google/keywords/forecast.ts"],"sourcesContent":["import {\n  type GoogleForecastBidding,\n  type GoogleKeywordForecastResponse,\n  googleKeywordForecastRequestSchema,\n} from \"@baker/api/ads-google\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../../../client.ts\";\nimport { registerSchema } from \"../../../../schemas.ts\";\nimport { getManagerIdForCustomer } from \"../../cache.ts\";\nimport { writeJsonEnvelope } from \"../../output.ts\";\nimport { exitWithServiceReadError } from \"../service-read-errors.ts\";\nimport { failWriteValidation, keywordEntries, microsFlag, requireCustomerId } from \"../write-shared.ts\";\n\nconst ARGS = {\n  \"customer-id\": { type: \"string\", description: \"Google Ads customer ID (10 digits, no dashes)\" },\n  text: {\n    type: \"string\",\n    description:\n      'Keywords to forecast, comma-separated, optional \":MATCH_TYPE\" suffix each (e.g. \"solar panels:PHRASE,placas solares\")',\n  },\n  file: { type: \"string\", description: \"Text file with one keyword[:MATCH_TYPE] per line\" },\n  \"match-type\": { type: \"string\", description: \"Default match type: EXACT | PHRASE | BROAD\" },\n  \"max-cpc\": {\n    type: \"string\",\n    description: \"Max CPC bid in major currency units — Manual CPC (or the ceiling under Maximize clicks)\",\n  },\n  \"daily-spend\": {\n    type: \"string\",\n    description:\n      \"Daily spend in major currency units — Maximize clicks / Maximize conversions (or the daily budget under Manual CPC)\",\n  },\n  strategy: {\n    type: \"string\",\n    description:\n      \"MANUAL_CPC | MAXIMIZE_CLICKS | MAXIMIZE_CONVERSIONS (default: MANUAL_CPC with --max-cpc alone, else MAXIMIZE_CLICKS)\",\n  },\n  location: { type: \"string\", description: \"Geo target id(s), comma-separated (see `keywords locations`)\" },\n  language: { type: \"string\", description: \"Language id (see `keywords languages`)\" },\n  start: {\n    type: \"string\",\n    description: \"First day forecast, YYYY-MM-DD (future). With --end; default: the 30 days from tomorrow\",\n  },\n  end: { type: \"string\", description: \"Last day forecast, YYYY-MM-DD (within a year)\" },\n  currency: { type: \"string\", description: \"Currency for the money figures (default: the account's)\" },\n} as const;\n\nregisterSchema({\n  command: \"ads.google.keywords.forecast\",\n  description:\n    '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_* } — Google\\'s prediction for the whole period, never an account result.',\n  args: Object.fromEntries(\n    Object.entries(ARGS).map(([name, arg]) => [\n      name,\n      { type: arg.type, description: arg.description, required: false },\n    ]),\n  ),\n});\n\ntype BiddingResult = { ok: true; bidding: GoogleForecastBidding } | { ok: false; message: string };\n\nfunction amount(args: Record<string, unknown>, flag: \"max-cpc\" | \"daily-spend\"): number | undefined {\n  return args[flag] === undefined ? undefined : microsFlag(args[flag], `--${flag}`);\n}\n\nfunction namedStrategy(args: Record<string, unknown>, maxCpc: number | undefined, spend: number | undefined): string {\n  if (typeof args.strategy === \"string\") return args.strategy.toUpperCase();\n  return maxCpc !== undefined && spend === undefined ? \"MANUAL_CPC\" : \"MAXIMIZE_CLICKS\";\n}\n\n/** The forecast's one bidding strategy, read off the flags. */\nexport function forecastBidding(args: Record<string, unknown>): BiddingResult {\n  const maxCpc = amount(args, \"max-cpc\");\n  const spend = amount(args, \"daily-spend\");\n  const strategy = namedStrategy(args, maxCpc, spend);\n  if (strategy === \"MANUAL_CPC\") {\n    if (maxCpc === undefined) return { ok: false, message: \"Manual CPC needs --max-cpc\" };\n    return { ok: true, bidding: { strategy, maxCpcBidMicros: maxCpc, ...(spend ? { dailyBudgetMicros: spend } : {}) } };\n  }\n  if (strategy !== \"MAXIMIZE_CLICKS\" && strategy !== \"MAXIMIZE_CONVERSIONS\") {\n    return {\n      ok: false,\n      message: `--strategy ${strategy} is not one Google forecasts: MANUAL_CPC | MAXIMIZE_CLICKS | MAXIMIZE_CONVERSIONS`,\n    };\n  }\n  if (spend === undefined) return { ok: false, message: `${strategy} needs --daily-spend` };\n  if (strategy === \"MAXIMIZE_CONVERSIONS\") return { ok: true, bidding: { strategy, dailyTargetSpendMicros: spend } };\n  return {\n    ok: true,\n    bidding: { strategy, dailyTargetSpendMicros: spend, ...(maxCpc ? { maxCpcBidCeilingMicros: maxCpc } : {}) },\n  };\n}\n\nfunction hints(data: GoogleKeywordForecastResponse): string[] {\n  const out = [\n    `Google's prediction for ${data.period.startDate}–${data.period.endDate}, not an account result: quote it as a forecast.`,\n  ];\n  if (data.forecast_clicks === null && data.forecast_cost_micros === null) {\n    out.push(\n      \"Google forecast nothing for these keywords — too little search volume in the chosen locations, or the bid is too low to win auctions.\",\n    );\n  }\n  return out;\n}\n\nexport const forecastCommand = defineCommand({\n  meta: {\n    name: \"forecast\",\n    description: `Forecast clicks, cost and conversions for keywords under one bidding strategy (Keyword Planner).\n\nExamples:\n  baker ads google keywords forecast --customer-id 1234567890 --text \"solar panels:PHRASE,placas solares:EXACT\" --max-cpc 1.5 --location 2724 --language 1003\n  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`,\n  },\n  args: ARGS,\n  run: async ({ args, rawArgs }) => {\n    const customerId = requireCustomerId(args);\n    const keywords = keywordEntries(args, rawArgs);\n    const bidding = forecastBidding(args);\n    if (!bidding.ok) failWriteValidation(bidding.message);\n    const managerId = getManagerIdForCustomer(customerId);\n    const request = googleKeywordForecastRequestSchema.safeParse({\n      customerId,\n      ...(managerId ? { managerId } : {}),\n      adGroups: [{ keywords }],\n      ...(args.location\n        ? {\n            locationIds: String(args.location)\n              .split(\",\")\n              .map((id) => id.trim()),\n          }\n        : {}),\n      ...(args.language ? { languageId: String(args.language) } : {}),\n      bidding: bidding.bidding,\n      ...(args.start ? { startDate: args.start } : {}),\n      ...(args.end ? { endDate: args.end } : {}),\n      ...(args.currency ? { currencyCode: String(args.currency).toUpperCase() } : {}),\n    });\n    if (!request.success) {\n      const issue = request.error.issues[0];\n      failWriteValidation(issue ? `${issue.path.join(\".\")}: ${issue.message}` : \"Invalid forecast\");\n    }\n    try {\n      const { data } = await apiPost<{ ok: true; data: GoogleKeywordForecastResponse }>(\n        \"/api/ads/google/keywords/forecast\",\n        request.data,\n      );\n      writeJsonEnvelope({ ok: true, data, hints: hints(data) });\n    } catch (err) {\n      exitWithServiceReadError(err);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/forecast-PI52G2GL.js

@@ -0,0 +1,104 @@
+import {
+  handleLinkedinError,
+  resolveAccountIdArg
+} from "./chunk-EIZMOICE.js";
+import {
+  writeAdsJson
+} from "./chunk-6SL6463H.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-T64IRDKW.js";
+import "./chunk-MAGSNHYB.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-I2DNBEV6.js";
+import {
+  apiPost
+} from "./chunk-MMOTJIV6.js";
+import "./chunk-2ZZR2SOF.js";
+import "./chunk-YPCVPDU7.js";
+import "./chunk-D3RTGIT4.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-PI52G2GL.js.map

package/dist/funding-ZRC25X5I.js

@@ -0,0 +1,85 @@
+import {
+  parseXApiError
+} from "./chunk-M6UNISGO.js";
+import {
+  resolveXAccountId
+} from "./chunk-DMA77LLI.js";
+import {
+  cacheGet,
+  cacheSet,
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-6SL6463H.js";
+import {
+  ApiError,
+  apiGet
+} from "./chunk-MMOTJIV6.js";
+import "./chunk-2ZZR2SOF.js";
+import "./chunk-YPCVPDU7.js";
+import {
+  registerSchema
+} from "./chunk-D3RTGIT4.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-ZRC25X5I.js.map