@koda-sl/baker-cli 0.542.0 → 0.544.0

package/dist/insights-7NC2JFXU.js

@@ -1,658 +0,0 @@
-import {
-  placementFormatNote,
-  previewFormatForPosition
-} from "./chunk-GC5P4KWY.js";
-import "./chunk-GDFJOCDO.js";
-import {
-  csvOrJson,
-  getDateRange,
-  handleMetaError
-} from "./chunk-KDDHMKTU.js";
-import {
-  metaBreakdownSyncedHint,
-  syncedFirstHint
-} from "./chunk-Y2FAUFWK.js";
-import "./chunk-QALAJNBG.js";
-import {
-  writeAdsJson,
-  writeAdsOutput,
-  writeJsonEnvelope
-} from "./chunk-EAHBTBVR.js";
-import {
-  NO_CACHE_ARG
-} from "./chunk-3PG7O3ZW.js";
-import "./chunk-SOPVIIUW.js";
-import "./chunk-G4FG5EQO.js";
-import {
-  apiGet,
-  apiPost
-} from "./chunk-C35UMKYG.js";
-import "./chunk-ELAYD7O3.js";
-import "./chunk-LBIF6FJY.js";
-import "./chunk-TRXGJZDL.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/ads/meta/insights.ts
-import { defineCommand } from "citty";
-
-// src/commands/ads/meta/insights-actions.ts
-var MIXED_ACTION_FIELDS = /* @__PURE__ */ new Set([
-  "actions",
-  "unique_actions",
-  "action_values",
-  "cost_per_action_type",
-  "cost_per_unique_action_type",
-  "conversions",
-  "conversion_values",
-  "cost_per_conversion"
-]);
-var ENGAGEMENT_TYPES = /* @__PURE__ */ new Set([
-  "page_engagement",
-  "post_engagement",
-  "post",
-  "comment",
-  "like",
-  "photo_view",
-  "video_view",
-  "post_reaction",
-  "post_interaction_gross",
-  "post_interaction_net"
-]);
-var ENGAGEMENT_PREFIX = "onsite_conversion.post_";
-var COMBINED_TYPE = /_add_(?:\d+_s_calls|meta_leads)$/;
-var ALIAS_PREFIXES = [
-  "omni_",
-  "offsite_conversion.fb_pixel_",
-  "onsite_web_app_",
-  "onsite_web_",
-  "app_custom_event.fb_mobile_"
-];
-var LEAD_ALIASES = /* @__PURE__ */ new Set(["onsite_conversion.lead_grouped", "leadgen_grouped"]);
-function canonicalType(type) {
-  if (LEAD_ALIASES.has(type)) return "lead";
-  if (type.startsWith("offsite_conversion.fb_pixel_custom")) return type;
-  const prefix = ALIAS_PREFIXES.find((p) => type.startsWith(p));
-  return prefix ? type.slice(prefix.length) : type;
-}
-function isNoise(type) {
-  return ENGAGEMENT_TYPES.has(type) || type.startsWith(ENGAGEMENT_PREFIX) || COMBINED_TYPE.test(type);
-}
-function isActionArray(value) {
-  return Array.isArray(value) && value.every((entry) => typeof entry === "object" && entry !== null && typeof entry.action_type === "string");
-}
-function representative(canonical, family) {
-  const pick = family.find((entry) => entry.action_type === `omni_${canonical}`) ?? family.find((entry) => entry.action_type === canonical) ?? family.reduce((best, entry) => Number(entry.value) > Number(best.value) ? entry : best);
-  return { ...pick, action_type: canonical };
-}
-function sliceOf(entry) {
-  return Object.entries(entry).filter(([key]) => key.startsWith("action_") && key !== "action_type");
-}
-function collapse(entries) {
-  const families = /* @__PURE__ */ new Map();
-  for (const entry of entries) {
-    const key = JSON.stringify([canonicalType(entry.action_type), sliceOf(entry)]);
-    families.set(key, [...families.get(key) ?? [], entry]);
-  }
-  return [...families.values()].map((family) => representative(canonicalType(family[0]?.action_type ?? ""), family));
-}
-function keepNamed(entries, wanted) {
-  const raw = entries.filter(
-    (entry) => wanted.includes(entry.action_type) && canonicalType(entry.action_type) !== entry.action_type || wanted.some((name) => entry.action_type.endsWith(`.${name}`))
-  );
-  const named = collapse(entries).filter((entry) => wanted.includes(entry.action_type));
-  return [...named, ...raw.filter((entry) => !named.some((kept) => kept.action_type === entry.action_type))];
-}
-function compactArray(field, entries, wanted, dropped) {
-  if (!MIXED_ACTION_FIELDS.has(field)) return collapse(entries);
-  if (wanted) return keepNamed(entries, wanted);
-  const kept = entries.filter((entry) => {
-    if (!isNoise(entry.action_type)) return true;
-    dropped.add(entry.action_type);
-    return false;
-  });
-  return collapse(kept);
-}
-function compactInsightsRows(rows, options) {
-  const dropped = /* @__PURE__ */ new Set();
-  const compacted = rows.map(
-    (row) => Object.fromEntries(
-      Object.entries(row).map(([field, value]) => [
-        field,
-        isActionArray(value) ? compactArray(field, value, options.actionTypes, dropped) : value
-      ])
-    )
-  );
-  return { rows: compacted, dropped: [...dropped] };
-}
-var COUNT_FIELDS = /* @__PURE__ */ new Set(["actions", "unique_actions", "conversions"]);
-var CUSTOM_EVENT_PREFIX = "offsite_conversion.fb_pixel_custom";
-function columnOf(field, entry) {
-  const slice = sliceOf(entry).map(([, value]) => String(value));
-  return slice.length === 0 ? `${field}.${entry.action_type}` : `${field}.${entry.action_type}[${slice.join(",")}]`;
-}
-function round2(value) {
-  return Math.round(value * 100) / 100;
-}
-function pricedEntry(field, entry, priceAll) {
-  if (!COUNT_FIELDS.has(field) || sliceOf(entry).length > 0) return false;
-  return priceAll || entry.action_type.startsWith(CUSTOM_EVENT_PREFIX);
-}
-function insightsTable(rows, fields, options = {}) {
-  const priceAll = options.priceAll ?? false;
-  const period = ["date_start", "date_stop"].filter(
-    (field) => !fields.includes(field) && rows.some((row) => row[field] !== void 0)
-  );
-  const columns = [...period, ...fields].flatMap((field) => {
-    const counts = /* @__PURE__ */ new Set();
-    const costs = /* @__PURE__ */ new Set();
-    for (const row of rows) {
-      const value = row[field];
-      if (!isActionArray(value)) continue;
-      for (const entry of value) {
-        counts.add(columnOf(field, entry));
-        if (pricedEntry(field, entry, priceAll) && row.spend !== void 0)
-          costs.add(`cost_per.${columnOf(field, entry)}`);
-      }
-    }
-    return counts.size === 0 ? [field] : [...counts, ...costs];
-  });
-  const flat = rows.map((row) => {
-    const out = {};
-    const spend = Number(row.spend);
-    for (const [field, value] of Object.entries(row)) {
-      if (!isActionArray(value)) {
-        out[field] = value;
-        continue;
-      }
-      for (const entry of value) {
-        const column = columnOf(field, entry);
-        out[column] = entry.value;
-        const count = Number(entry.value);
-        if (pricedEntry(field, entry, priceAll) && Number.isFinite(spend) && count > 0) {
-          out[`cost_per.${column}`] = round2(spend / count);
-        }
-      }
-    }
-    return out;
-  });
-  return { rows: flat, columns };
-}
-var FUNNEL_COLUMNS = ["result_type", "results", "cvr", "cost_per_result"];
-var RESULT_PRIORITY = [
-  "purchase",
-  "complete_registration",
-  "lead",
-  "submit_application",
-  "subscribe",
-  "start_trial",
-  "schedule",
-  "contact",
-  "initiate_checkout",
-  "add_payment_info",
-  "add_to_cart"
-];
-function countOf(actions, type) {
-  return actions.filter((entry) => entry.action_type === type).reduce((sum, entry) => sum + Number(entry.value), 0);
-}
-function resultTypeOf(actions, wanted) {
-  const present = new Set(actions.map((entry) => entry.action_type));
-  const named = (wanted ?? []).find((name) => [...present].some((type) => type === name || type.endsWith(`.${name}`)));
-  if (named) return [...present].find((type) => type === named || type.endsWith(`.${named}`)) ?? null;
-  const standard = RESULT_PRIORITY.find((type) => present.has(type));
-  if (standard) return standard;
-  const custom = actions.filter((entry) => entry.action_type.startsWith(CUSTOM_EVENT_PREFIX)).sort((a, b) => Number(b.value) - Number(a.value));
-  return custom[0]?.action_type ?? null;
-}
-function withFunnelResults(rows, options) {
-  return rows.map((row) => {
-    const actions = isActionArray(row.actions) ? row.actions : [];
-    const resultType = resultTypeOf(actions, options.actionTypes);
-    const results = resultType === null ? null : countOf(actions, resultType);
-    const linkClicks = row.inline_link_clicks !== void 0 ? Number(row.inline_link_clicks) : countOf(actions, "link_click");
-    const spend = Number(row.spend);
-    return {
-      ...row,
-      result_type: resultType,
-      results,
-      cvr: results !== null && linkClicks > 0 ? round2(results / linkClicks * 100) : null,
-      cost_per_result: results !== null && results > 0 && Number.isFinite(spend) ? round2(spend / results) : null
-    };
-  });
-}
-
-// src/commands/ads/meta/placement-delivery.ts
-var MIN_IMPRESSIONS = 20;
-var SILENT_FRACTION_OF_REFERENCE = 0.1;
-var PLAYING_REFERENCE_RATE = 0.5;
-function toNumber(value) {
-  const n = Number(value);
-  return Number.isFinite(n) ? n : 0;
-}
-function sumActionValues(value) {
-  if (!Array.isArray(value)) return 0;
-  return value.reduce((total, entry) => {
-    const item = entry;
-    return total + toNumber(item?.value);
-  }, 0);
-}
-function aggregate(rows) {
-  const byPlacement = /* @__PURE__ */ new Map();
-  let totalImpressions = 0;
-  for (const row of rows) {
-    const position = row.platform_position;
-    if (typeof position !== "string" || position.length === 0) continue;
-    const platform = typeof row.publisher_platform === "string" ? row.publisher_platform : "";
-    const impressions = toNumber(row.impressions);
-    totalImpressions += impressions;
-    const key = `${platform}/${position}`;
-    const current = byPlacement.get(key) ?? { platform, position, impressions: 0, plays: 0, playRate: 0, share: 0 };
-    current.impressions += impressions;
-    current.plays += sumActionValues(row.video_play_actions);
-    byPlacement.set(key, current);
-  }
-  return [...byPlacement.values()].map((placement) => ({
-    ...placement,
-    playRate: placement.impressions > 0 ? placement.plays / placement.impressions : 0,
-    share: totalImpressions > 0 ? placement.impressions / totalImpressions : 0
-  }));
-}
-function previewCommand(placement) {
-  const format = previewFormatForPosition(placement.position, placement.platform);
-  return format ? `\`baker ads meta preview --creative-id <id> --placement ${placement.position} --platform ${placement.platform}\`` : `no preview format is known for ${placement.position}, so Meta's renderer cannot confirm it \u2014 say the placement is unverified rather than filling the gap`;
-}
-function isSingleAdQuery(rows) {
-  const adIds = /* @__PURE__ */ new Set();
-  for (const row of rows) {
-    if (typeof row.ad_id !== "string" || row.ad_id.length === 0) return false;
-    adIds.add(row.ad_id);
-  }
-  return adIds.size === 1;
-}
-function placementDeliveryHints(rows) {
-  const carriesVideoMetrics = rows.some((row) => Array.isArray(row.video_play_actions));
-  if (!carriesVideoMetrics || !isSingleAdQuery(rows)) return [];
-  const placements = aggregate(rows);
-  const judgeable = placements.filter((p) => p.impressions >= MIN_IMPRESSIONS);
-  const impressions = judgeable.reduce((total, p) => total + p.impressions, 0);
-  const reference = impressions > 0 ? judgeable.reduce((total, p) => total + p.plays, 0) / impressions : 0;
-  if (reference < PLAYING_REFERENCE_RATE) return [];
-  const silent = judgeable.filter((p) => p.playRate < reference * SILENT_FRACTION_OF_REFERENCE).sort((a, b) => b.impressions - a.impressions);
-  if (silent.length === 0) {
-    const worst = [...judgeable].sort((a, b) => a.playRate - b.playRate)[0];
-    return [
-      `Checked every placement above ${MIN_IMPRESSIONS} impressions against this ad's own play rate (${(reference * 100).toFixed(0)}%): no placement is failing to play the video${worst ? `, the lowest being ${worst.platform}/${worst.position} at ${(worst.playRate * 100).toFixed(0)}%` : ""}. So placements do not explain a "it shows as a still image" report \u2014 rule out autoplay off or data saver in the viewer's own app, which renders every video as its cover frame account-wide.`
-    ];
-  }
-  const hints = silent.map((placement) => {
-    const note = placementFormatNote(placement.position);
-    const documented = note ? ` Meta documents this placement: ${note.note}` : "";
-    return `${placement.platform}/${placement.position} delivered ${placement.impressions.toLocaleString("en-US")} impressions (${(placement.share * 100).toFixed(1)}% of the total) and ${placement.plays.toLocaleString("en-US")} video plays \u2014 it may not be rendering the video. This is account evidence, not a rule: confirm what Meta renders there with ${previewCommand(placement)} before you say anything about it.${documented}`;
-  });
-  const combinedShare = silent.reduce((total, placement) => total + placement.share, 0) * 100;
-  hints.push(
-    `Those placements are ${combinedShare.toFixed(1)}% of delivery in this query. State that share before proposing to remove them \u2014 and note that removing placements from a live ad set is a targeting change, which Meta counts as a significant edit that re-enters the learning phase.`
-  );
-  return hints;
-}
-
-// src/commands/ads/meta/presets.ts
-var INSIGHTS_INTENTS = {
-  baseline: {
-    name: "baseline",
-    description: "Spend, impressions, clicks, CTR, CPC, CPM. The default question: 'how is delivery?'",
-    fields: ["impressions", "reach", "frequency", "spend", "clicks", "ctr", "cpc", "cpm"]
-  },
-  revenue: {
-    name: "revenue",
-    description: "Spend, conversions, action_values, purchase_roas. 'How much money are we making?'",
-    fields: ["spend", "actions", "action_values", "conversions", "conversion_values", "purchase_roas"],
-    actionBreakdowns: ["action_type"]
-  },
-  funnel: {
-    name: "funnel",
-    description: "Impression \u2192 click \u2192 landing page \u2192 action. 'Where do users drop off?'",
-    fields: ["impressions", "clicks", "inline_link_clicks", "outbound_clicks", "actions", "spend"],
-    actionBreakdowns: ["action_type"]
-  },
-  ranking: {
-    name: "ranking",
-    description: "Quality, engagement, conversion-rate rankings. 'Which creatives need a refresh?'",
-    fields: ["impressions", "spend", "ctr", "quality_ranking", "engagement_rate_ranking", "conversion_rate_ranking"]
-  },
-  video: {
-    name: "video",
-    description: "Watch funnel, thruplay cost. 'How are video creatives holding attention?'",
-    fields: [
-      "impressions",
-      "spend",
-      "video_play_actions",
-      "video_p25_watched_actions",
-      "video_p50_watched_actions",
-      "video_p75_watched_actions",
-      "video_p100_watched_actions",
-      "video_thruplay_watched_actions",
-      "cost_per_thruplay"
-    ]
-  },
-  identity: {
-    name: "identity",
-    description: "Just the names + spend \u2014 for cheap roll-up summaries.",
-    fields: ["spend", "impressions"]
-  }
-};
-var IDENTITY_FIELDS_BY_LEVEL = {
-  account: ["account_id", "account_name", "account_currency"],
-  campaign: ["campaign_id", "campaign_name", "objective"],
-  adset: ["adset_id", "adset_name", "campaign_id", "campaign_name"],
-  ad: ["ad_id", "ad_name", "adset_id", "adset_name", "campaign_id", "campaign_name"]
-};
-function composeFields(intent, level) {
-  const intentFields = INSIGHTS_INTENTS[intent].fields;
-  const identity = IDENTITY_FIELDS_BY_LEVEL[level];
-  const seen = /* @__PURE__ */ new Set();
-  const out = [];
-  for (const f of [...identity, ...intentFields]) {
-    if (!seen.has(f)) {
-      seen.add(f);
-      out.push(f);
-    }
-  }
-  return out;
-}
-function getIntent(name) {
-  return INSIGHTS_INTENTS[name];
-}
-function listIntents() {
-  return Object.values(INSIGHTS_INTENTS);
-}
-
-// src/commands/ads/meta/insights.ts
-var POLL_FIRST_MS = 5e3;
-var POLL_LONGEST_MS = 3e4;
-var POLL_MAX_MS = 10 * 6e4;
-function asyncPollDelayMs(attempt) {
-  return Math.min(Math.round(POLL_FIRST_MS * 1.5 ** attempt), POLL_LONGEST_MS);
-}
-var DEFAULT_ATTRIBUTION_WINDOWS = ["7d_click", "1d_view"];
-var DEFAULT_FILTERING = [{ field: "impressions", operator: "GREATER_THAN", value: 0 }];
-function commaSplit(input) {
-  if (!input) return void 0;
-  return input.split(",").map((s) => s.trim()).filter(Boolean);
-}
-function parseFiltering(raw) {
-  if (!raw) return void 0;
-  try {
-    return JSON.parse(raw);
-  } catch {
-    handleMetaError(new Error("Invalid --filtering JSON"));
-  }
-}
-function pickIntent(name) {
-  if (!name) return "baseline";
-  const found = getIntent(name);
-  if (!found) {
-    handleMetaError(new Error(`Unknown --intent: ${name}. Use --list-intents to see options.`));
-  }
-  return found.name;
-}
-function pickLevel(args) {
-  const raw = args.level;
-  if (!raw) return "account";
-  if (raw !== "account" && raw !== "campaign" && raw !== "adset" && raw !== "ad") {
-    handleMetaError(new Error("--level must be one of: account|campaign|adset|ad"));
-  }
-  return raw;
-}
-function shouldAutoAsync(body) {
-  const breakdownCount = (body.breakdowns ?? []).length;
-  if (body.level === "ad" && breakdownCount > 0 && body.object.startsWith("act_")) {
-    return true;
-  }
-  if (breakdownCount > 2) {
-    return true;
-  }
-  if (body.since && body.until) {
-    const days = (Date.parse(body.until) - Date.parse(body.since)) / 864e5;
-    if (days > 90) {
-      return true;
-    }
-  }
-  return false;
-}
-function wantsAsync(asyncFlag, body) {
-  if (asyncFlag === true) return true;
-  if (asyncFlag === false) return false;
-  return shouldAutoAsync(body);
-}
-function applyDateRange(body, args) {
-  const range = getDateRange(args);
-  if (range.datePreset) body.datePreset = range.datePreset;
-  if (range.since) body.since = range.since;
-  if (range.until) body.until = range.until;
-  if (!body.datePreset && !(body.since && body.until)) {
-    body.datePreset = "last_7d";
-  }
-}
-function buildFiltering(args) {
-  const explicit = parseFiltering(args.filtering);
-  if (explicit) return explicit;
-  if (args["include-undelivered"]) return void 0;
-  return DEFAULT_FILTERING;
-}
-function buildAttributionWindows(args) {
-  const explicit = commaSplit(args["attribution-windows"]);
-  if (explicit) return explicit;
-  return DEFAULT_ATTRIBUTION_WINDOWS;
-}
-function buildBody(args) {
-  const intent = pickIntent(args.intent);
-  const level = pickLevel(args);
-  const intentDef = getIntent(intent);
-  const explicitFields = commaSplit(args.fields);
-  const fields = explicitFields ?? composeFields(intent, level);
-  const breakdowns = commaSplit(args.breakdowns);
-  const actionBreakdowns = commaSplit(args["action-breakdowns"]) ?? intentDef?.actionBreakdowns;
-  const body = {
-    object: args.object,
-    level,
-    fields,
-    timeIncrement: args["time-increment"],
-    breakdowns,
-    actionBreakdowns,
-    filtering: buildFiltering(args),
-    attributionWindows: buildAttributionWindows(args),
-    useAccountAttributionSetting: Boolean(args["use-account-attribution"]),
-    useUnifiedAttributionSetting: Boolean(args["use-unified-attribution"]),
-    limit: args.limit ? Number(args.limit) : 1e3,
-    skipCache: Boolean(args["no-cache"])
-  };
-  applyDateRange(body, args);
-  return body;
-}
-async function pollAsync(reportRunId) {
-  const start = Date.now();
-  for (let attempt = 0; Date.now() - start < POLL_MAX_MS; attempt++) {
-    const status = await apiGet(
-      "/api/ads/meta/insights/async/status",
-      { "report-run-id": reportRunId }
-    );
-    if (status.async_status === "Job Completed") return;
-    if (status.async_status === "Job Failed" || status.async_status === "Job Skipped") {
-      handleMetaError(new Error(`Async insights job ${status.async_status}`));
-    }
-    process.stderr.write(
-      `Async insights ${status.async_status ?? "queued"} (${Math.round(status.async_percent_completion ?? 0)}%)\u2026
-`
-    );
-    await new Promise((resolve) => setTimeout(resolve, asyncPollDelayMs(attempt)));
-  }
-  handleMetaError(new Error("Async insights polling timed out after 10 minutes"));
-}
-async function runAsync(body) {
-  const submit = await apiPost("/api/ads/meta/insights/async", body);
-  process.stderr.write(`Async insights job: ${submit.reportRunId}
-`);
-  await pollAsync(submit.reportRunId);
-  return apiPost("/api/ads/meta/insights/async/result", {
-    reportRunId: submit.reportRunId,
-    fields: body.fields,
-    limit: body.limit
-  });
-}
-function sortRowsBySpendDesc(rows) {
-  return [...rows].sort((a, b) => {
-    const sa = Number(a.spend ?? 0);
-    const sb = Number(b.spend ?? 0);
-    if (Number.isNaN(sa) || Number.isNaN(sb)) return 0;
-    return sb - sa;
-  });
-}
-function syncedHintOf(body) {
-  const breakdowns = body.breakdowns ?? [];
-  if (breakdowns.length > 0) return metaBreakdownSyncedHint(breakdowns);
-  const level = body.level === "adset" ? "ad_group" : body.level;
-  return syncedFirstHint("meta", level);
-}
-function shapeRows(rows, args) {
-  if (args.full) return { rows, hints: [] };
-  const actionTypes = commaSplit(args["action-types"]);
-  const { rows: compacted, dropped } = compactInsightsRows(rows, { actionTypes });
-  const compact = args.intent === "funnel" ? withFunnelResults(compacted, { actionTypes }) : compacted;
-  if (dropped.length === 0) return { rows: compact, hints: [] };
-  const named = dropped.slice(0, 4).join(", ");
-  const more = dropped.length > 4 ? ` and ${dropped.length - 4} more` : "";
-  return {
-    rows: compact,
-    hints: [
-      `Engagement and combined action types were left out (${named}${more}); --action-types <type> keeps one, --full returns every raw action.`
-    ]
-  };
-}
-var insightsCommand = defineCommand({
-  meta: {
-    name: "insights",
-    description: `Performance reporting \u2014 the main Meta tool for AI agents.
-
-Smart defaults so the AI doesn't have to remember every flag:
-  --level account                       (set --level campaign|adset|ad to drill in)
-  --intent baseline                     (or revenue|funnel|ranking|video|identity)
-  --date-preset last_7d                 (override with --since/--until)
-  --attribution-windows 7d_click,1d_view  (the only ones still working post Jan 2026)
-  filter: impressions > 0               (skip undelivered rows; --include-undelivered to keep)
-  sort: spend descending                (when result fits in memory)
-  auto-async when query is heavy (level=ad + breakdowns, big date ranges, etc.)
-
-Identity fields (campaign_name, ad_name etc.) are appended automatically based on --level so rows
-are self-describing.
-
-Examples \u2014 common AI questions:
-  # "How is GreenLeaf doing this week?"
-  baker ads meta insights --object act_123
-
-  # "Which campaigns are profitable?"
-  baker ads meta insights --object act_123 --level campaign --intent revenue --date-preset last_28d
-
-  # "Which creatives need a refresh?"
-  baker ads meta insights --object act_123 --level ad --intent ranking --date-preset last_14d
-
-  # "Where do users drop off the funnel?"
-  baker ads meta insights --object act_123 --intent funnel
-
-  # "Should we shift budget to Instagram?"
-  baker ads meta insights --object act_123 --level adset --breakdowns publisher_platform,platform_position
-
-  # "How many sign-ups and leads per month?" \u2014 one call, one row per month
-  baker ads meta insights --object act_123 --intent revenue --action-types complete_registration,lead --time-increment monthly --since 2026-01-01 --until 2026-03-31
-
-  # Custom field set (escape hatch)
-  baker ads meta insights --object act_123 --fields impressions,spend,actions
-
-Action arrays (actions, cost_per_action_type, conversions, \u2026) are compact: Meta's aliases of one conversion
-(omni_, offsite_conversion.fb_pixel_, onsite_web_ \u2026) collapse to one entry under its plain name
-(complete_registration, lead, purchase), and engagement counts (likes, saves, video views) are left out.
---action-types keeps only the named types; --full returns Meta's raw arrays. --output md|csv gives each
-action type its own column (actions.lead, cost_per_action_type.lead); a custom event, or every type --action-types
-names, also gets its cost (cost_per.conversions.<type> = spend / count). --intent funnel adds result_type, results,
-cvr (% of link clicks) and cost_per_result to each row; --action-types <type> picks which action is the result.
-
-Async is automatic for heavy queries; pass --async to force it, or --no-async to refuse fallback.`
-  },
-  args: {
-    object: {
-      type: "string",
-      description: "Object ID \u2014 act_<id> for account, or a campaign/adset/ad ID"
-    },
-    level: { type: "string", description: "account|campaign|adset|ad (default: account)" },
-    intent: { type: "string", description: "baseline|revenue|funnel|ranking|video|identity (default: baseline)" },
-    fields: { type: "string", description: "Comma-separated field list (overrides --intent bundle)" },
-    "list-intents": { type: "boolean", description: "Print available intents and exit" },
-    "date-preset": { type: "string", description: "Meta date preset (last_7d, last_28d, today, ...)" },
-    since: { type: "string", description: "Custom start date YYYY-MM-DD" },
-    until: { type: "string", description: "Custom end date YYYY-MM-DD" },
-    "time-increment": { type: "string", description: "1 (day) | monthly | all_days" },
-    breakdowns: { type: "string", description: "Comma-separated breakdowns (e.g. publisher_platform,age)" },
-    "action-types": {
-      type: "string",
-      description: "Keep only these action types in actions/cost_per_action_type/conversions \u2014 plain names (complete_registration,lead,purchase), a raw Meta name, or a custom event's name"
-    },
-    full: { type: "boolean", description: "Return Meta's raw action arrays: every alias and engagement type" },
-    "action-breakdowns": {
-      type: "string",
-      description: "Slice the actions[] array (default: action_type for revenue/funnel)"
-    },
-    filtering: { type: "string", description: "Override default filter \u2014 JSON array of {field,operator,value}" },
-    "include-undelivered": { type: "boolean", description: "Keep rows where impressions=0 (off by default)" },
-    "attribution-windows": {
-      type: "string",
-      description: "Override default 7d_click,1d_view (only 1d_view, 1d_click, 7d_click, 28d_click work post Jan 2026)"
-    },
-    "use-account-attribution": { type: "boolean", description: "Use account-saved attribution setting" },
-    "use-unified-attribution": { type: "boolean", description: "Use ad-set unified attribution setting" },
-    limit: { type: "string", description: "Max rows (default 1000)" },
-    // Declaring `no-async` too would be a trap: citty resolves it to `async: false`
-    // and never fills an arg of that name, so the declaration reads as supported
-    // while nothing consumes it.
-    async: { type: "boolean", description: "Force the async submit-and-poll path (--no-async refuses it)" },
-    "no-sort": { type: "boolean", description: "Skip default spend-desc sort" },
-    "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.object) {
-      writeAdsJson({
-        ok: false,
-        error: { code: "VALIDATION_ERROR", message: "Missing required argument: --object" }
-      });
-      process.exit(1);
-    }
-    const body = buildBody(args);
-    const fmt = csvOrJson(args);
-    const wantAsync = wantsAsync(args.async, body);
-    try {
-      const rows = wantAsync ? await runAsync(body) : await apiPost("/api/ads/meta/insights", body);
-      const shaped = shapeRows(args["no-sort"] ? rows : sortRowsBySpendDesc(rows), args);
-      const sorted = shaped.rows;
-      if (fmt !== "json") {
-        const fields = args.intent === "funnel" && !args.full ? [...body.fields, ...FUNNEL_COLUMNS] : body.fields;
-        const table = args.full || fmt === "jsonl" ? { rows: sorted, columns: fields } : insightsTable(sorted, fields, { priceAll: args["action-types"] !== void 0 });
-        writeAdsOutput(table.rows, fmt, table.columns, shaped.hints);
-        return;
-      }
-      const synced = syncedHintOf(body);
-      const hints = [...placementDeliveryHints(sorted), ...shaped.hints, ...synced === null ? [] : [synced]];
-      writeJsonEnvelope({ ok: true, data: sorted, hints });
-    } catch (err) {
-      handleMetaError(err);
-    }
-  }
-});
-export {
-  asyncPollDelayMs,
-  insightsCommand,
-  wantsAsync
-};
-//# sourceMappingURL=insights-7NC2JFXU.js.map