@koda-sl/baker-cli 0.458.0 → 0.459.0

package/dist/advertisers-S4YJJF36.js

@@ -0,0 +1,119 @@
+import {
+  advertisersHints
+} from "./chunk-XX5DXKEI.js";
+import {
+  RESEARCH_DATA_NOTE,
+  handleResearchError,
+  writeResearchHints,
+  writeResearchJson,
+  writeResearchOutput
+} from "./chunk-2J5N24NW.js";
+import {
+  buildResearchQueryContext,
+  warnDefaults
+} from "./chunk-FEELV5IV.js";
+import "./chunk-7VHPAGPK.js";
+import "./chunk-ZJVHZHYP.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import {
+  apiPost
+} from "./chunk-NUHMHZTZ.js";
+import "./chunk-CE6IE364.js";
+import "./chunk-3XA4JVMY.js";
+import {
+  registerSchema
+} from "./chunk-USFTTDIO.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/research/advertisers.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "research.advertisers",
+  description: 'Returns a ranked list of domains competing for one keyword in Google, with avg SERP position, relevance rating, estimated traffic value and visibility \u2014 domain economics, not ad copy. Despite the name it returns no headlines, descriptions or creative of any kind; for a competitor\'s actual ad copy use `baker research google-ads <competitor.com> --copy` (Google) or `baker winning-ads content <adId>` (Meta/LinkedIn). Start here: `baker research advertisers "<keyword>" --location <cc> --language <code>` to size up who owns a term. If --location and --language are omitted, defaults to United States (us) and English (en). The response includes a query_context object showing which location/language were used.',
+  args: {
+    keyword: {
+      type: "string",
+      description: "Keyword to search (positional). One search term, not a brand or a domain \u2014 this is a SERP query, not an advertiser lookup",
+      required: true
+    },
+    location: {
+      type: "string",
+      description: "Country code (us, uk, es, de...) or DataForSEO location code. Defaults to us (United States) if omitted \u2014 always set this for non-US markets",
+      required: false
+    },
+    language: {
+      type: "string",
+      description: "Language code or name (en, es, spanish...). Defaults to en (English) if omitted \u2014 always set this for non-English markets",
+      required: false
+    },
+    limit: { type: "string", description: "Max results (default: 20, max: 100)", required: false },
+    "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
+  }
+});
+var FIELDS = {
+  domain: "Competing domain (no ad copy is returned \u2014 see hints)",
+  avg_position: "Average SERP position (1 = top)",
+  rating: "Domain relevance rating (0-100)",
+  etv: "Estimated traffic value (USD)",
+  visibility: "SERP visibility score (0-1)"
+};
+var advertisersCommand = defineCommand({
+  meta: {
+    name: "advertisers",
+    description: `Domains competing for a keyword in Google SERPs, with position, relevance, traffic value and visibility. Returns NO ad copy \u2014 for a competitor's headlines and body copy use \`baker research google-ads <competitor.com> --copy\` (Google) or \`baker winning-ads content <adId>\` (Meta/LinkedIn).
+
+Examples:
+  baker research advertisers "running shoes"
+  baker research advertisers "crm software" --location uk --limit 10
+  baker research advertisers "zapatos" --location es --language spanish`
+  },
+  args: {
+    keyword: { type: "positional", description: "Keyword to search", required: true },
+    location: { type: "string", description: "Country code or location code (default: us)", required: false },
+    language: { type: "string", description: "Language code or name (default: en)", required: false },
+    limit: { type: "string", description: "Max results (default: 20, max: 100)", required: false },
+    output: { type: "string", description: "Format: json|csv|md|jsonl", required: false, default: "json" },
+    "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
+  },
+  run: async ({ args }) => {
+    const keyword = args.keyword;
+    const location = args.location || void 0;
+    const language = args.language || void 0;
+    const limit = args.limit ? Number(args.limit) : void 0;
+    const skipCache = args["no-cache"] ? true : void 0;
+    const queryContext = buildResearchQueryContext(location, language);
+    try {
+      const data = await apiPost("/api/research/advertisers", {
+        keyword,
+        location,
+        language,
+        limit,
+        skipCache
+      });
+      warnDefaults(queryContext);
+      const format = args.output || "json";
+      const hints = advertisersHints(data.length, queryContext);
+      if (format !== "json") {
+        writeResearchOutput(data, format);
+        writeResearchHints(hints, format);
+        return;
+      }
+      writeResearchJson({
+        ok: true,
+        data,
+        fields: FIELDS,
+        note: RESEARCH_DATA_NOTE,
+        query_context: queryContext,
+        hints
+      });
+    } catch (err) {
+      handleResearchError(err);
+    }
+  }
+});
+export {
+  advertisersCommand
+};
+//# sourceMappingURL=advertisers-S4YJJF36.js.map

package/dist/advertisers-S4YJJF36.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/research/advertisers.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { buildResearchQueryContext, warnDefaults } from \"../../geo-context.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { advertisersHints } from \"./hints.ts\";\nimport {\n  handleResearchError,\n  RESEARCH_DATA_NOTE,\n  writeResearchHints,\n  writeResearchJson,\n  writeResearchOutput,\n} from \"./output.ts\";\n\nregisterSchema({\n  command: \"research.advertisers\",\n  description:\n    'Returns a ranked list of domains competing for one keyword in Google, with avg SERP position, relevance rating, estimated traffic value and visibility — domain economics, not ad copy. Despite the name it returns no headlines, descriptions or creative of any kind; for a competitor\\'s actual ad copy use `baker research google-ads <competitor.com> --copy` (Google) or `baker winning-ads content <adId>` (Meta/LinkedIn). Start here: `baker research advertisers \"<keyword>\" --location <cc> --language <code>` to size up who owns a term. If --location and --language are omitted, defaults to United States (us) and English (en). The response includes a query_context object showing which location/language were used.',\n  args: {\n    keyword: {\n      type: \"string\",\n      description:\n        \"Keyword to search (positional). One search term, not a brand or a domain — this is a SERP query, not an advertiser lookup\",\n      required: true,\n    },\n    location: {\n      type: \"string\",\n      description:\n        \"Country code (us, uk, es, de...) or DataForSEO location code. Defaults to us (United States) if omitted — always set this for non-US markets\",\n      required: false,\n    },\n    language: {\n      type: \"string\",\n      description:\n        \"Language code or name (en, es, spanish...). Defaults to en (English) if omitted — always set this for non-English markets\",\n      required: false,\n    },\n    limit: { type: \"string\", description: \"Max results (default: 20, max: 100)\", required: false },\n    \"no-cache\": { type: \"boolean\", description: \"Skip server cache, hit API directly\", required: false },\n  },\n});\n\ninterface Advertiser {\n  domain: string;\n  avg_position: number;\n  rating: number;\n  etv: number;\n  visibility: number;\n}\n\nconst FIELDS: Record<string, string> = {\n  domain: \"Competing domain (no ad copy is returned — see hints)\",\n  avg_position: \"Average SERP position (1 = top)\",\n  rating: \"Domain relevance rating (0-100)\",\n  etv: \"Estimated traffic value (USD)\",\n  visibility: \"SERP visibility score (0-1)\",\n};\n\nexport const advertisersCommand = defineCommand({\n  meta: {\n    name: \"advertisers\",\n    description: `Domains competing for a keyword in Google SERPs, with position, relevance, traffic value and visibility. Returns NO ad copy — for a competitor's headlines and body copy use \\`baker research google-ads <competitor.com> --copy\\` (Google) or \\`baker winning-ads content <adId>\\` (Meta/LinkedIn).\n\nExamples:\n  baker research advertisers \"running shoes\"\n  baker research advertisers \"crm software\" --location uk --limit 10\n  baker research advertisers \"zapatos\" --location es --language spanish`,\n  },\n  args: {\n    keyword: { type: \"positional\", description: \"Keyword to search\", required: true },\n    location: { type: \"string\", description: \"Country code or location code (default: us)\", required: false },\n    language: { type: \"string\", description: \"Language code or name (default: en)\", required: false },\n    limit: { type: \"string\", description: \"Max results (default: 20, max: 100)\", required: false },\n    output: { type: \"string\", description: \"Format: json|csv|md|jsonl\", required: false, default: \"json\" },\n    \"no-cache\": { type: \"boolean\", description: \"Skip server cache, hit API directly\", required: false },\n  },\n  run: async ({ args }) => {\n    const keyword = args.keyword as string;\n    const location = (args.location as string) || undefined;\n    const language = (args.language as string) || undefined;\n    const limit = args.limit ? Number(args.limit) : undefined;\n    const skipCache = args[\"no-cache\"] ? true : undefined;\n    const queryContext = buildResearchQueryContext(location, language);\n\n    try {\n      const data = await apiPost<Advertiser[]>(\"/api/research/advertisers\", {\n        keyword,\n        location,\n        language,\n        limit,\n        skipCache,\n      });\n\n      warnDefaults(queryContext);\n      const format = (args.output as string) || \"json\";\n      const hints = advertisersHints(data.length, queryContext);\n      if (format !== \"json\") {\n        writeResearchOutput(data as unknown as Array<Record<string, unknown>>, format);\n        writeResearchHints(hints, format);\n        return;\n      }\n      writeResearchJson({\n        ok: true,\n        data,\n        fields: FIELDS,\n        note: RESEARCH_DATA_NOTE,\n        query_context: queryContext,\n        hints,\n      });\n    } catch (err) {\n      handleResearchError(err);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAa9B,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,SAAS;AAAA,MACP,MAAM;AAAA,MACN,aACE;AAAA,MACF,UAAU;AAAA,IACZ;AAAA,IACA,UAAU;AAAA,MACR,MAAM;AAAA,MACN,aACE;AAAA,MACF,UAAU;AAAA,IACZ;AAAA,IACA,UAAU;AAAA,MACR,MAAM;AAAA,MACN,aACE;AAAA,MACF,UAAU;AAAA,IACZ;AAAA,IACA,OAAO,EAAE,MAAM,UAAU,aAAa,uCAAuC,UAAU,MAAM;AAAA,IAC7F,YAAY,EAAE,MAAM,WAAW,aAAa,uCAAuC,UAAU,MAAM;AAAA,EACrG;AACF,CAAC;AAUD,IAAM,SAAiC;AAAA,EACrC,QAAQ;AAAA,EACR,cAAc;AAAA,EACd,QAAQ;AAAA,EACR,KAAK;AAAA,EACL,YAAY;AACd;AAEO,IAAM,qBAAqB,cAAc;AAAA,EAC9C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMf;AAAA,EACA,MAAM;AAAA,IACJ,SAAS,EAAE,MAAM,cAAc,aAAa,qBAAqB,UAAU,KAAK;AAAA,IAChF,UAAU,EAAE,MAAM,UAAU,aAAa,+CAA+C,UAAU,MAAM;AAAA,IACxG,UAAU,EAAE,MAAM,UAAU,aAAa,uCAAuC,UAAU,MAAM;AAAA,IAChG,OAAO,EAAE,MAAM,UAAU,aAAa,uCAAuC,UAAU,MAAM;AAAA,IAC7F,QAAQ,EAAE,MAAM,UAAU,aAAa,6BAA6B,UAAU,OAAO,SAAS,OAAO;AAAA,IACrG,YAAY,EAAE,MAAM,WAAW,aAAa,uCAAuC,UAAU,MAAM;AAAA,EACrG;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,UAAU,KAAK;AACrB,UAAM,WAAY,KAAK,YAAuB;AAC9C,UAAM,WAAY,KAAK,YAAuB;AAC9C,UAAM,QAAQ,KAAK,QAAQ,OAAO,KAAK,KAAK,IAAI;AAChD,UAAM,YAAY,KAAK,UAAU,IAAI,OAAO;AAC5C,UAAM,eAAe,0BAA0B,UAAU,QAAQ;AAEjE,QAAI;AACF,YAAM,OAAO,MAAM,QAAsB,6BAA6B;AAAA,QACpE;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF,CAAC;AAED,mBAAa,YAAY;AACzB,YAAM,SAAU,KAAK,UAAqB;AAC1C,YAAM,QAAQ,iBAAiB,KAAK,QAAQ,YAAY;AACxD,UAAI,WAAW,QAAQ;AACrB,4BAAoB,MAAmD,MAAM;AAC7E,2BAAmB,OAAO,MAAM;AAChC;AAAA,MACF;AACA,wBAAkB;AAAA,QAChB,IAAI;AAAA,QACJ;AAAA,QACA,QAAQ;AAAA,QACR,MAAM;AAAA,QACN,eAAe;AAAA,QACf;AAAA,MACF,CAAC;AAAA,IACH,SAAS,KAAK;AACZ,0BAAoB,GAAG;AAAA,IACzB;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/analytics-7XFTQHRQ.js

@@ -0,0 +1,432 @@
+import {
+  csvOrJson,
+  daysAgoIso,
+  handleLinkedinError,
+  resolveAccountIdArg,
+  todayIso
+} from "./chunk-QNEKQWJS.js";
+import {
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-OAYHDIW2.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-NUHMHZTZ.js";
+import "./chunk-CE6IE364.js";
+import "./chunk-3XA4JVMY.js";
+import "./chunk-USFTTDIO.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/analytics.ts
+import { defineCommand } from "citty";
+
+// src/commands/ads/linkedin/presets.ts
+var INTENTS = {
+  baseline: {
+    name: "baseline",
+    description: "Spend, impressions, clicks. The default 'how is delivery?' question. Derives CTR, CPC, CPM.",
+    metrics: ["impressions", "clicks", "costInUsd", "costInLocalCurrency", "approximateUniqueImpressions"],
+    derived: ["ctr", "cpc", "cpm", "frequency"]
+  },
+  revenue: {
+    name: "revenue",
+    description: "Spend, conversions, conversion value. 'How much money are we making?'",
+    metrics: [
+      "costInUsd",
+      "externalWebsiteConversions",
+      "externalWebsitePostClickConversions",
+      "externalWebsitePostViewConversions",
+      "conversionValueInLocalCurrency",
+      "oneClickLeads"
+    ]
+  },
+  funnel: {
+    name: "funnel",
+    description: "Impression \u2192 click \u2192 landing \u2192 form open \u2192 lead \u2192 conversion. 'Where do users drop off?'",
+    metrics: [
+      "impressions",
+      "clicks",
+      "landingPageClicks",
+      "oneClickLeadFormOpens",
+      "oneClickLeads",
+      "externalWebsiteConversions",
+      "costInUsd"
+    ],
+    derived: ["ctr", "leadCompletionRate"]
+  },
+  engagement: {
+    name: "engagement",
+    description: "Likes, comments, shares, follows + viral spillover. TLA-aware \u2014 measures organic reach effect.",
+    metrics: [
+      "impressions",
+      "likes",
+      "comments",
+      "shares",
+      "reactions",
+      "follows",
+      "totalEngagements",
+      "viralImpressions",
+      "viralLikes",
+      "viralShares",
+      "viralOneClickLeads",
+      "costInUsd"
+    ]
+  },
+  video: {
+    name: "video",
+    description: "Video watch quartiles + cost. 'How are video creatives holding attention?'",
+    metrics: [
+      "videoStarts",
+      "videoFirstQuartileCompletions",
+      "videoMidpointCompletions",
+      "videoThirdQuartileCompletions",
+      "videoCompletions",
+      "videoViews",
+      "fullScreenPlays",
+      "costInUsd",
+      "impressions"
+    ]
+  },
+  "lead-gen": {
+    name: "lead-gen",
+    description: "Lead Gen Form opens + completions. CLI derives form-completion-rate.",
+    metrics: [
+      "oneClickLeadFormOpens",
+      "oneClickLeads",
+      "viralOneClickLeads",
+      "viralOneClickLeadFormOpens",
+      "costInUsd"
+    ],
+    derived: ["leadCompletionRate"]
+  },
+  inmail: {
+    name: "inmail",
+    description: "Sponsored Message / Conversation Ads \u2014 sends, opens, clicks, lead-gen taps.",
+    metrics: [
+      "sends",
+      "opens",
+      "clicks",
+      "costInUsd",
+      "leadGenerationMailContactInfoShares",
+      "leadGenerationMailInterestedClicks"
+    ]
+  },
+  document: {
+    name: "document",
+    description: "Document Ads \u2014 quartile read-through, completion, downloads.",
+    metrics: [
+      "documentFirstQuartileCompletions",
+      "documentMidpointCompletions",
+      "documentThirdQuartileCompletions",
+      "documentCompletions",
+      "downloadClicks",
+      "costInUsd",
+      "impressions"
+    ]
+  },
+  ranking: {
+    name: "ranking",
+    description: "Frequency + reach metrics for fatigue detection. CLI derives frequency = impressions/uniqueImpressions.",
+    metrics: ["impressions", "clicks", "costInUsd", "approximateUniqueImpressions"],
+    derived: ["frequency", "ctr"]
+  },
+  identity: {
+    name: "identity",
+    description: "Just spend + impressions. Cheap roll-up.",
+    metrics: ["costInUsd", "impressions"]
+  }
+};
+var MEMBER_PIVOTS = /* @__PURE__ */ new Set([
+  "company",
+  "job-title",
+  "job-function",
+  "seniority",
+  "industry",
+  "company-size",
+  "country",
+  "region",
+  "dma"
+]);
+var ALL_PIVOTS = [
+  "none",
+  "campaign",
+  "campaign-group",
+  "creative",
+  "company",
+  "account",
+  "conversion",
+  "job-title",
+  "job-function",
+  "seniority",
+  "industry",
+  "company-size",
+  "country",
+  "region",
+  "dma",
+  "device",
+  "placement",
+  "serving-location",
+  "card-index",
+  "objective",
+  "conversation-node",
+  "conversation-node-button"
+];
+var ALL_LEVELS = ["account", "campaign-group", "campaign", "creative"];
+function listIntents() {
+  return Object.values(INTENTS);
+}
+function isPivot(slug) {
+  return ALL_PIVOTS.includes(slug);
+}
+function isLevel(slug) {
+  return ALL_LEVELS.includes(slug);
+}
+function composeFields(intent, _level, metricsOverride) {
+  const base = metricsOverride && metricsOverride.length > 0 ? metricsOverride : INTENTS[intent].metrics;
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const f of ["pivotValues", "dateRange", ...base]) {
+    if (!seen.has(f)) {
+      seen.add(f);
+      out.push(f);
+    }
+  }
+  return out;
+}
+
+// src/commands/ads/linkedin/analytics.ts
+function commaSplit(input) {
+  if (!input) return void 0;
+  return input.split(",").map((s) => s.trim()).filter(Boolean);
+}
+function parseGranularity(raw) {
+  const v = (raw ?? "DAILY").toUpperCase();
+  if (v === "DAILY" || v === "MONTHLY" || v === "YEARLY" || v === "ALL") {
+    return v;
+  }
+  handleLinkedinError(new Error(`Invalid --granularity "${raw}". Use DAILY | MONTHLY | YEARLY | ALL.`));
+}
+function parseLevel(raw) {
+  const v = raw ?? "account";
+  if (!isLevel(v)) {
+    handleLinkedinError(new Error(`Invalid --level "${raw}". Use one of: ${ALL_LEVELS.join(", ")}.`));
+  }
+  return v;
+}
+function parsePivot(raw) {
+  const v = raw ?? "none";
+  if (!isPivot(v)) {
+    handleLinkedinError(new Error(`Invalid --pivot "${raw}". Use one of: ${ALL_PIVOTS.join(", ")}.`));
+  }
+  return v;
+}
+function parseIntent(raw) {
+  const v = raw ?? "baseline";
+  const known = [
+    "baseline",
+    "revenue",
+    "funnel",
+    "engagement",
+    "video",
+    "lead-gen",
+    "inmail",
+    "document",
+    "ranking",
+    "identity"
+  ];
+  if (!known.includes(v)) {
+    handleLinkedinError(new Error(`Invalid --intent "${raw}". Run --list-intents to see options.`));
+  }
+  return v;
+}
+function resolveDateRange(args) {
+  const start = args.start;
+  const end = args.end;
+  if (start) {
+    return { start, end };
+  }
+  const lastDaysRaw = args["last-days"];
+  const days = lastDaysRaw ? Number(lastDaysRaw) : 7;
+  if (!Number.isFinite(days) || days < 1 || days > 730) {
+    handleLinkedinError(new Error(`Invalid --last-days "${lastDaysRaw}". Use a positive number \u2264 730.`));
+  }
+  return { start: daysAgoIso(days), end: todayIso() };
+}
+function resolveScopeIds(args, level) {
+  if (level === "account") {
+    const id = resolveAccountIdArg(args);
+    return [id];
+  }
+  if (level === "campaign-group") {
+    const raw2 = args["campaign-group-id"] ?? args.ids;
+    if (!raw2) {
+      handleLinkedinError(new Error("Pass --campaign-group-id (CSV for multi) when --level campaign-group."));
+    }
+    return commaSplit(raw2) ?? [];
+  }
+  if (level === "campaign") {
+    const raw2 = args["campaign-id"] ?? args.ids;
+    if (!raw2) {
+      handleLinkedinError(new Error("Pass --campaign-id (CSV for multi) when --level campaign."));
+    }
+    return commaSplit(raw2) ?? [];
+  }
+  const raw = args["creative-id"] ?? args.ids;
+  if (!raw) {
+    handleLinkedinError(new Error("Pass --creative-id (CSV for multi) when --level creative."));
+  }
+  return commaSplit(raw) ?? [];
+}
+function sortRows(rows) {
+  return [...rows].sort((a, b) => {
+    const cs = numberOf(b.costInUsd) - numberOf(a.costInUsd);
+    if (cs !== 0) return cs;
+    return numberOf(b.impressions) - numberOf(a.impressions);
+  });
+}
+function numberOf(v) {
+  if (typeof v === "number") return Number.isFinite(v) ? v : 0;
+  if (typeof v === "string") {
+    const n = Number(v);
+    return Number.isFinite(n) ? n : 0;
+  }
+  return 0;
+}
+var analyticsCommand = defineCommand({
+  meta: {
+    name: "analytics",
+    description: `Performance reporting \u2014 the workhorse for AI agents.
+
+Three-axis design (LinkedIn's superpower over Meta/Google):
+  --level   account | campaign-group | campaign | creative
+  --intent  baseline | revenue | funnel | engagement | video | lead-gen | inmail | document | ranking | identity
+  --pivot   none | job-title | company | industry | seniority | function | company-size | country | region | dma
+            | device | placement | serving-location | card-index | objective
+            | conversation-node | conversation-node-button
+
+Smart defaults:
+  --level account, --intent baseline, --pivot none, --granularity DAILY, last 7 days
+  Pivot on a MEMBER_* dim \u2192 granularity auto-forced to ALL (LinkedIn rejects DAILY+demographic)
+  Demographic data delayed 12-24h with \u22653-event privacy floor \u2014 the CLI flags this in warnings.
+  --pivot dma \u2192 US Nielsen DMA\xAE regions, names resolved. Any report built from it must write "DMA\xAE"
+  and carry Nielsen's notice (returned as the DMA_ATTRIBUTION_REQUIRED warning).
+  Derived metrics injected client-side: ctr, cpc, cpm, frequency, leadCompletionRate
+
+Examples \u2014 common AI questions:
+  # "How is this account doing this week?"
+  baker ads linkedin analytics
+
+  # "Who are we reaching, by job title?" (the LinkedIn killer)
+  baker ads linkedin analytics --level campaign --campaign-id 1234 --pivot job-title --intent baseline --last-days 30
+
+  # "Top companies seeing my ads" (ABM feedback loop)
+  baker ads linkedin analytics --level campaign --campaign-id 1234 --pivot company --last-days 30
+
+  # "Revenue by campaign over Q1"
+  baker ads linkedin analytics --level campaign --campaign-id 1,2,3 --intent revenue --start 2026-01-01 --end 2026-03-31 --granularity MONTHLY
+
+  # "How is the lead form converting?"
+  baker ads linkedin analytics --level campaign --campaign-id 1234 --intent lead-gen
+
+  # Custom field set (escape hatch)
+  baker ads linkedin analytics --metrics impressions,clicks,oneClickLeads --intent identity`
+  },
+  args: {
+    level: { type: "string", description: "Object scope (default: account)" },
+    "account-id": { type: "string", description: "Account ID \u2014 numeric or urn:li:sponsoredAccount:N (level=account)" },
+    "account-urn": { type: "string", description: "Alias for --account-id (URN form)" },
+    "campaign-group-id": { type: "string", description: "Comma-separated IDs (level=campaign-group)" },
+    "campaign-id": { type: "string", description: "Comma-separated IDs (level=campaign)" },
+    "creative-id": { type: "string", description: "Comma-separated IDs (level=creative)" },
+    ids: { type: "string", description: "Generic CSV of IDs at the chosen level (alternative to per-level flags)" },
+    intent: {
+      type: "string",
+      description: "baseline|revenue|funnel|engagement|video|lead-gen|inmail|document|ranking|identity"
+    },
+    pivot: { type: "string", description: "Pivot dim. Default: none. See `--list-pivots`." },
+    metrics: { type: "string", description: "CSV metric override \u2014 bypass --intent's bundle" },
+    "list-intents": { type: "boolean", description: "Print intent definitions and exit" },
+    "list-pivots": { type: "boolean", description: "Print pivot slugs and exit" },
+    start: { type: "string", description: "Start date YYYY-MM-DD (overrides --last-days)" },
+    end: { type: "string", description: "End date YYYY-MM-DD" },
+    "last-days": { type: "string", description: "Window relative to today (default: 7)" },
+    granularity: { type: "string", description: "DAILY|MONTHLY|YEARLY|ALL (default: DAILY)" },
+    limit: { type: "string", description: "Max rows (default: 1000)" },
+    "no-sort": { type: "boolean", description: "Skip default sort by costInUsd desc" },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "Output format json|csv|jsonl|md", default: "json" }
+  },
+  run: async ({ args }) => {
+    if (args["list-intents"]) {
+      writeAdsJson({ ok: true, data: listIntents() });
+      return;
+    }
+    if (args["list-pivots"]) {
+      writeAdsJson({ ok: true, data: ALL_PIVOTS });
+      return;
+    }
+    const level = parseLevel(args.level);
+    const intent = parseIntent(args.intent);
+    const pivot = parsePivot(args.pivot);
+    let granularity = parseGranularity(args.granularity);
+    if (MEMBER_PIVOTS.has(pivot) && granularity === "DAILY") {
+      process.stderr.write(`note: pivot=${pivot} forces --granularity ALL (LinkedIn rejects DAILY + demographic).
+`);
+      granularity = "ALL";
+    }
+    const ids = resolveScopeIds(args, level);
+    if (ids.length === 0) {
+      handleLinkedinError(new Error(`No IDs resolved for --level ${level}`));
+    }
+    const range = resolveDateRange(args);
+    const metrics = commaSplit(args.metrics);
+    const limit = args.limit ? Number(args.limit) : 1e3;
+    const request = {
+      level,
+      ids,
+      intent,
+      pivot,
+      metrics,
+      start: range.start,
+      end: range.end,
+      granularity,
+      limit
+    };
+    try {
+      const data = await apiPost("/api/ads/linkedin/analytics", {
+        request,
+        skipCache: Boolean(args["no-cache"])
+      });
+      const rows = args["no-sort"] ? data.rows : sortRows(data.rows);
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput(rows, fmt, data.fields);
+        return;
+      }
+      writeAdsJson({
+        ok: true,
+        data: {
+          rows,
+          fields: data.fields,
+          warnings: data.warnings,
+          query: data.query,
+          // Echo composed fields so an offline agent can pre-flight w/o this network call.
+          composedFields: composeFields(intent, level, metrics)
+        }
+      });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+export {
+  analyticsCommand
+};
+//# sourceMappingURL=analytics-7XFTQHRQ.js.map

package/dist/analytics-7XFTQHRQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/linkedin/analytics.ts","../src/commands/ads/linkedin/presets.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { NO_CACHE_ARG } from \"../../../cache-flag.ts\";\nimport { apiPost } from \"../../../client.ts\";\nimport { writeAdsJson, writeAdsOutput } from \"../output.ts\";\nimport {\n  ALL_LEVELS,\n  ALL_PIVOTS,\n  composeFields,\n  type IntentName,\n  isLevel,\n  isPivot,\n  type LevelName,\n  listIntents,\n  MEMBER_PIVOTS,\n  type PivotSlug,\n} from \"./presets.ts\";\nimport { csvOrJson, daysAgoIso, handleLinkedinError, resolveAccountIdArg, todayIso } from \"./shared.ts\";\n\ntype Granularity = \"DAILY\" | \"MONTHLY\" | \"YEARLY\" | \"ALL\";\n\ninterface AnalyticsRequest {\n  level: LevelName;\n  ids: string[];\n  intent: IntentName;\n  pivot: PivotSlug;\n  metrics?: string[];\n  start: string;\n  end?: string;\n  granularity: Granularity;\n  limit?: number;\n}\n\ninterface AnalyticsResponse {\n  rows: Array<Record<string, unknown>>;\n  fields: string[];\n  warnings: Array<{ code: string; message: string }>;\n  query: AnalyticsRequest & { metrics: string[] };\n}\n\nfunction commaSplit(input: string | undefined): string[] | undefined {\n  if (!input) return undefined;\n  return input\n    .split(\",\")\n    .map((s) => s.trim())\n    .filter(Boolean);\n}\n\nfunction parseGranularity(raw: string | undefined): Granularity {\n  const v = (raw ?? \"DAILY\").toUpperCase();\n  if (v === \"DAILY\" || v === \"MONTHLY\" || v === \"YEARLY\" || v === \"ALL\") {\n    return v;\n  }\n  handleLinkedinError(new Error(`Invalid --granularity \"${raw}\". Use DAILY | MONTHLY | YEARLY | ALL.`));\n}\n\nfunction parseLevel(raw: string | undefined): LevelName {\n  const v = raw ?? \"account\";\n  if (!isLevel(v)) {\n    handleLinkedinError(new Error(`Invalid --level \"${raw}\". Use one of: ${ALL_LEVELS.join(\", \")}.`));\n  }\n  return v;\n}\n\nfunction parsePivot(raw: string | undefined): PivotSlug {\n  const v = raw ?? \"none\";\n  if (!isPivot(v)) {\n    handleLinkedinError(new Error(`Invalid --pivot \"${raw}\". Use one of: ${ALL_PIVOTS.join(\", \")}.`));\n  }\n  return v;\n}\n\nfunction parseIntent(raw: string | undefined): IntentName {\n  const v = (raw ?? \"baseline\") as IntentName;\n  const known: IntentName[] = [\n    \"baseline\",\n    \"revenue\",\n    \"funnel\",\n    \"engagement\",\n    \"video\",\n    \"lead-gen\",\n    \"inmail\",\n    \"document\",\n    \"ranking\",\n    \"identity\",\n  ];\n  if (!known.includes(v)) {\n    handleLinkedinError(new Error(`Invalid --intent \"${raw}\". Run --list-intents to see options.`));\n  }\n  return v;\n}\n\n/**\n * Resolve start/end dates. Precedence:\n *   1. --start + --end (explicit window)\n *   2. --last-days N → end=today, start=today-N\n *   3. default: last 7 days\n */\nfunction resolveDateRange(args: Record<string, unknown>): { start: string; end?: string } {\n  const start = args.start as string | undefined;\n  const end = args.end as string | undefined;\n  if (start) {\n    return { start, end };\n  }\n  const lastDaysRaw = args[\"last-days\"] as string | undefined;\n  const days = lastDaysRaw ? Number(lastDaysRaw) : 7;\n  if (!Number.isFinite(days) || days < 1 || days > 730) {\n    handleLinkedinError(new Error(`Invalid --last-days \"${lastDaysRaw}\". Use a positive number ≤ 730.`));\n  }\n  return { start: daysAgoIso(days), end: todayIso() };\n}\n\n/**\n * Resolve scope IDs. Each level expects a different flag — but we accept\n * --account-id at every level when level=account, and --campaign-id /\n * --campaign-group-id / --creative-id otherwise. CSV-encoded for multi-id.\n */\nfunction resolveScopeIds(args: Record<string, unknown>, level: LevelName): string[] {\n  if (level === \"account\") {\n    const id = resolveAccountIdArg(args);\n    return [id];\n  }\n  if (level === \"campaign-group\") {\n    const raw = (args[\"campaign-group-id\"] as string | undefined) ?? (args.ids as string | undefined);\n    if (!raw) {\n      handleLinkedinError(new Error(\"Pass --campaign-group-id (CSV for multi) when --level campaign-group.\"));\n    }\n    return commaSplit(raw) ?? [];\n  }\n  if (level === \"campaign\") {\n    const raw = (args[\"campaign-id\"] as string | undefined) ?? (args.ids as string | undefined);\n    if (!raw) {\n      handleLinkedinError(new Error(\"Pass --campaign-id (CSV for multi) when --level campaign.\"));\n    }\n    return commaSplit(raw) ?? [];\n  }\n  // creative\n  const raw = (args[\"creative-id\"] as string | undefined) ?? (args.ids as string | undefined);\n  if (!raw) {\n    handleLinkedinError(new Error(\"Pass --creative-id (CSV for multi) when --level creative.\"));\n  }\n  return commaSplit(raw) ?? [];\n}\n\n/** Sort rows by spend desc when present, otherwise by impressions desc. */\nfunction sortRows(rows: Array<Record<string, unknown>>): Array<Record<string, unknown>> {\n  return [...rows].sort((a, b) => {\n    const cs = numberOf(b.costInUsd) - numberOf(a.costInUsd);\n    if (cs !== 0) return cs;\n    return numberOf(b.impressions) - numberOf(a.impressions);\n  });\n}\n\nfunction numberOf(v: unknown): number {\n  if (typeof v === \"number\") return Number.isFinite(v) ? v : 0;\n  if (typeof v === \"string\") {\n    const n = Number(v);\n    return Number.isFinite(n) ? n : 0;\n  }\n  return 0;\n}\n\nexport const analyticsCommand = defineCommand({\n  meta: {\n    name: \"analytics\",\n    description: `Performance reporting — the workhorse for AI agents.\n\nThree-axis design (LinkedIn's superpower over Meta/Google):\n  --level   account | campaign-group | campaign | creative\n  --intent  baseline | revenue | funnel | engagement | video | lead-gen | inmail | document | ranking | identity\n  --pivot   none | job-title | company | industry | seniority | function | company-size | country | region | dma\n            | device | placement | serving-location | card-index | objective\n            | conversation-node | conversation-node-button\n\nSmart defaults:\n  --level account, --intent baseline, --pivot none, --granularity DAILY, last 7 days\n  Pivot on a MEMBER_* dim → granularity auto-forced to ALL (LinkedIn rejects DAILY+demographic)\n  Demographic data delayed 12-24h with ≥3-event privacy floor — the CLI flags this in warnings.\n  --pivot dma → US Nielsen DMA® regions, names resolved. Any report built from it must write \"DMA®\"\n  and carry Nielsen's notice (returned as the DMA_ATTRIBUTION_REQUIRED warning).\n  Derived metrics injected client-side: ctr, cpc, cpm, frequency, leadCompletionRate\n\nExamples — common AI questions:\n  # \"How is this account doing this week?\"\n  baker ads linkedin analytics\n\n  # \"Who are we reaching, by job title?\" (the LinkedIn killer)\n  baker ads linkedin analytics --level campaign --campaign-id 1234 --pivot job-title --intent baseline --last-days 30\n\n  # \"Top companies seeing my ads\" (ABM feedback loop)\n  baker ads linkedin analytics --level campaign --campaign-id 1234 --pivot company --last-days 30\n\n  # \"Revenue by campaign over Q1\"\n  baker ads linkedin analytics --level campaign --campaign-id 1,2,3 --intent revenue --start 2026-01-01 --end 2026-03-31 --granularity MONTHLY\n\n  # \"How is the lead form converting?\"\n  baker ads linkedin analytics --level campaign --campaign-id 1234 --intent lead-gen\n\n  # Custom field set (escape hatch)\n  baker ads linkedin analytics --metrics impressions,clicks,oneClickLeads --intent identity`,\n  },\n  args: {\n    level: { type: \"string\", description: \"Object scope (default: account)\" },\n    \"account-id\": { type: \"string\", description: \"Account ID — numeric or urn:li:sponsoredAccount:N (level=account)\" },\n    \"account-urn\": { type: \"string\", description: \"Alias for --account-id (URN form)\" },\n    \"campaign-group-id\": { type: \"string\", description: \"Comma-separated IDs (level=campaign-group)\" },\n    \"campaign-id\": { type: \"string\", description: \"Comma-separated IDs (level=campaign)\" },\n    \"creative-id\": { type: \"string\", description: \"Comma-separated IDs (level=creative)\" },\n    ids: { type: \"string\", description: \"Generic CSV of IDs at the chosen level (alternative to per-level flags)\" },\n    intent: {\n      type: \"string\",\n      description: \"baseline|revenue|funnel|engagement|video|lead-gen|inmail|document|ranking|identity\",\n    },\n    pivot: { type: \"string\", description: \"Pivot dim. Default: none. See `--list-pivots`.\" },\n    metrics: { type: \"string\", description: \"CSV metric override — bypass --intent's bundle\" },\n    \"list-intents\": { type: \"boolean\", description: \"Print intent definitions and exit\" },\n    \"list-pivots\": { type: \"boolean\", description: \"Print pivot slugs and exit\" },\n    start: { type: \"string\", description: \"Start date YYYY-MM-DD (overrides --last-days)\" },\n    end: { type: \"string\", description: \"End date YYYY-MM-DD\" },\n    \"last-days\": { type: \"string\", description: \"Window relative to today (default: 7)\" },\n    granularity: { type: \"string\", description: \"DAILY|MONTHLY|YEARLY|ALL (default: DAILY)\" },\n    limit: { type: \"string\", description: \"Max rows (default: 1000)\" },\n    \"no-sort\": { type: \"boolean\", description: \"Skip default sort by costInUsd desc\" },\n    \"no-cache\": NO_CACHE_ARG,\n    output: { type: \"string\", description: \"Output format json|csv|jsonl|md\", default: \"json\" },\n  },\n  run: async ({ args }) => {\n    if (args[\"list-intents\"]) {\n      writeAdsJson({ ok: true, data: listIntents() });\n      return;\n    }\n    if (args[\"list-pivots\"]) {\n      writeAdsJson({ ok: true, data: ALL_PIVOTS });\n      return;\n    }\n\n    const level = parseLevel(args.level as string | undefined);\n    const intent = parseIntent(args.intent as string | undefined);\n    const pivot = parsePivot(args.pivot as string | undefined);\n    let granularity = parseGranularity(args.granularity as string | undefined);\n\n    // CLI-side mirror of the backend's pivot/granularity guard. Backend will\n    // also enforce — this lets us echo the auto-correction in stderr early.\n    if (MEMBER_PIVOTS.has(pivot) && granularity === \"DAILY\") {\n      process.stderr.write(`note: pivot=${pivot} forces --granularity ALL (LinkedIn rejects DAILY + demographic).\\n`);\n      granularity = \"ALL\";\n    }\n\n    const ids = resolveScopeIds(args, level);\n    if (ids.length === 0) {\n      handleLinkedinError(new Error(`No IDs resolved for --level ${level}`));\n    }\n\n    const range = resolveDateRange(args);\n    const metrics = commaSplit(args.metrics as string | undefined);\n    const limit = args.limit ? Number(args.limit) : 1000;\n\n    const request: AnalyticsRequest = {\n      level,\n      ids,\n      intent,\n      pivot,\n      metrics,\n      start: range.start,\n      end: range.end,\n      granularity,\n      limit,\n    };\n\n    try {\n      const data = await apiPost<AnalyticsResponse>(\"/api/ads/linkedin/analytics\", {\n        request,\n        skipCache: Boolean(args[\"no-cache\"]),\n      });\n      const rows = args[\"no-sort\"] ? data.rows : sortRows(data.rows);\n      const fmt = csvOrJson(args);\n      if (fmt !== \"json\") {\n        writeAdsOutput(rows, fmt, data.fields);\n        return;\n      }\n      writeAdsJson({\n        ok: true,\n        data: {\n          rows,\n          fields: data.fields,\n          warnings: data.warnings,\n          query: data.query,\n          // Echo composed fields so an offline agent can pre-flight w/o this network call.\n          composedFields: composeFields(intent, level, metrics),\n        },\n      });\n    } catch (err) {\n      handleLinkedinError(err);\n    }\n  },\n});\n","/**\n * LinkedIn analytics field bundles. Three-axis design:\n *   --intent  → metric bundle (baseline | revenue | funnel | engagement | video |\n *                lead-gen | inmail | document | ranking | identity)\n *   --level   → object scope (account | campaign-group | campaign | creative)\n *   --pivot   → demographic / firmographic breakdown\n *               (none | job-title | company | industry | seniority | function |\n *                company-size | country | region | dma | device | placement | …)\n *\n * Backend recomputes the field list itself (single source of truth in\n * `packages/backend/convex/ads/linkedin/constants.ts`). The CLI keeps a\n * mirror copy so `--list-intents` / `--list-pivots` work offline.\n */\n\nexport type IntentName =\n  | \"baseline\"\n  | \"revenue\"\n  | \"funnel\"\n  | \"engagement\"\n  | \"video\"\n  | \"lead-gen\"\n  | \"inmail\"\n  | \"document\"\n  | \"ranking\"\n  | \"identity\";\n\nexport type LevelName = \"account\" | \"campaign-group\" | \"campaign\" | \"creative\";\n\nexport type PivotSlug =\n  | \"none\"\n  | \"campaign\"\n  | \"campaign-group\"\n  | \"creative\"\n  | \"company\"\n  | \"account\"\n  | \"conversion\"\n  | \"job-title\"\n  | \"job-function\"\n  | \"seniority\"\n  | \"industry\"\n  | \"company-size\"\n  | \"country\"\n  | \"region\"\n  | \"dma\"\n  | \"device\"\n  | \"placement\"\n  | \"serving-location\"\n  | \"card-index\"\n  | \"objective\"\n  | \"conversation-node\"\n  | \"conversation-node-button\";\n\ninterface IntentDefinition {\n  name: IntentName;\n  description: string;\n  metrics: string[];\n  /** Derived (CLI-side) metrics this bundle materializes. Documentation only. */\n  derived?: string[];\n}\n\nexport const INTENTS: Record<IntentName, IntentDefinition> = {\n  baseline: {\n    name: \"baseline\",\n    description: \"Spend, impressions, clicks. The default 'how is delivery?' question. Derives CTR, CPC, CPM.\",\n    metrics: [\"impressions\", \"clicks\", \"costInUsd\", \"costInLocalCurrency\", \"approximateUniqueImpressions\"],\n    derived: [\"ctr\", \"cpc\", \"cpm\", \"frequency\"],\n  },\n  revenue: {\n    name: \"revenue\",\n    description: \"Spend, conversions, conversion value. 'How much money are we making?'\",\n    metrics: [\n      \"costInUsd\",\n      \"externalWebsiteConversions\",\n      \"externalWebsitePostClickConversions\",\n      \"externalWebsitePostViewConversions\",\n      \"conversionValueInLocalCurrency\",\n      \"oneClickLeads\",\n    ],\n  },\n  funnel: {\n    name: \"funnel\",\n    description: \"Impression → click → landing → form open → lead → conversion. 'Where do users drop off?'\",\n    metrics: [\n      \"impressions\",\n      \"clicks\",\n      \"landingPageClicks\",\n      \"oneClickLeadFormOpens\",\n      \"oneClickLeads\",\n      \"externalWebsiteConversions\",\n      \"costInUsd\",\n    ],\n    derived: [\"ctr\", \"leadCompletionRate\"],\n  },\n  engagement: {\n    name: \"engagement\",\n    description: \"Likes, comments, shares, follows + viral spillover. TLA-aware — measures organic reach effect.\",\n    metrics: [\n      \"impressions\",\n      \"likes\",\n      \"comments\",\n      \"shares\",\n      \"reactions\",\n      \"follows\",\n      \"totalEngagements\",\n      \"viralImpressions\",\n      \"viralLikes\",\n      \"viralShares\",\n      \"viralOneClickLeads\",\n      \"costInUsd\",\n    ],\n  },\n  video: {\n    name: \"video\",\n    description: \"Video watch quartiles + cost. 'How are video creatives holding attention?'\",\n    metrics: [\n      \"videoStarts\",\n      \"videoFirstQuartileCompletions\",\n      \"videoMidpointCompletions\",\n      \"videoThirdQuartileCompletions\",\n      \"videoCompletions\",\n      \"videoViews\",\n      \"fullScreenPlays\",\n      \"costInUsd\",\n      \"impressions\",\n    ],\n  },\n  \"lead-gen\": {\n    name: \"lead-gen\",\n    description: \"Lead Gen Form opens + completions. CLI derives form-completion-rate.\",\n    metrics: [\n      \"oneClickLeadFormOpens\",\n      \"oneClickLeads\",\n      \"viralOneClickLeads\",\n      \"viralOneClickLeadFormOpens\",\n      \"costInUsd\",\n    ],\n    derived: [\"leadCompletionRate\"],\n  },\n  inmail: {\n    name: \"inmail\",\n    description: \"Sponsored Message / Conversation Ads — sends, opens, clicks, lead-gen taps.\",\n    metrics: [\n      \"sends\",\n      \"opens\",\n      \"clicks\",\n      \"costInUsd\",\n      \"leadGenerationMailContactInfoShares\",\n      \"leadGenerationMailInterestedClicks\",\n    ],\n  },\n  document: {\n    name: \"document\",\n    description: \"Document Ads — quartile read-through, completion, downloads.\",\n    metrics: [\n      \"documentFirstQuartileCompletions\",\n      \"documentMidpointCompletions\",\n      \"documentThirdQuartileCompletions\",\n      \"documentCompletions\",\n      \"downloadClicks\",\n      \"costInUsd\",\n      \"impressions\",\n    ],\n  },\n  ranking: {\n    name: \"ranking\",\n    description:\n      \"Frequency + reach metrics for fatigue detection. CLI derives frequency = impressions/uniqueImpressions.\",\n    metrics: [\"impressions\", \"clicks\", \"costInUsd\", \"approximateUniqueImpressions\"],\n    derived: [\"frequency\", \"ctr\"],\n  },\n  identity: {\n    name: \"identity\",\n    description: \"Just spend + impressions. Cheap roll-up.\",\n    metrics: [\"costInUsd\", \"impressions\"],\n  },\n};\n\n/** Pivots that LinkedIn rejects with DAILY granularity — CLI auto-forces ALL. */\nexport const MEMBER_PIVOTS = new Set<PivotSlug>([\n  \"company\",\n  \"job-title\",\n  \"job-function\",\n  \"seniority\",\n  \"industry\",\n  \"company-size\",\n  \"country\",\n  \"region\",\n  \"dma\",\n]);\n\nexport const ALL_PIVOTS: PivotSlug[] = [\n  \"none\",\n  \"campaign\",\n  \"campaign-group\",\n  \"creative\",\n  \"company\",\n  \"account\",\n  \"conversion\",\n  \"job-title\",\n  \"job-function\",\n  \"seniority\",\n  \"industry\",\n  \"company-size\",\n  \"country\",\n  \"region\",\n  \"dma\",\n  \"device\",\n  \"placement\",\n  \"serving-location\",\n  \"card-index\",\n  \"objective\",\n  \"conversation-node\",\n  \"conversation-node-button\",\n];\n\nexport const ALL_LEVELS: LevelName[] = [\"account\", \"campaign-group\", \"campaign\", \"creative\"];\n\nexport function getIntent(name: string): IntentDefinition | undefined {\n  return INTENTS[name as IntentName];\n}\n\nexport function listIntents(): IntentDefinition[] {\n  return Object.values(INTENTS);\n}\n\nexport function isPivot(slug: string): slug is PivotSlug {\n  return (ALL_PIVOTS as string[]).includes(slug);\n}\n\nexport function isLevel(slug: string): slug is LevelName {\n  return (ALL_LEVELS as string[]).includes(slug);\n}\n\n/**\n * Compose final field list — intent bundle + identity columns + pivotValues +\n * dateRange. Backend re-validates and recomposes; this is just for offline\n * preview (`baker ads linkedin analytics --list-intents`).\n */\nexport function composeFields(intent: IntentName, _level: LevelName, metricsOverride?: string[]): string[] {\n  const base = metricsOverride && metricsOverride.length > 0 ? metricsOverride : INTENTS[intent].metrics;\n  const seen = new Set<string>();\n  const out: string[] = [];\n  for (const f of [\"pivotValues\", \"dateRange\", ...base]) {\n    if (!seen.has(f)) {\n      seen.add(f);\n      out.push(f);\n    }\n  }\n  return out;\n}\n"],"mappings":"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","names":["raw"]}