@koda-sl/baker-cli 0.524.0 → 0.526.0

package/dist/chunk-FX3MXXYD.js

@@ -0,0 +1,91 @@
+import {
+  definitionPlatformOf,
+  parseDefinitionDelivery,
+  resolveDelivery,
+  resolveFormatList
+} from "./chunk-3N2KAOVM.js";
+import {
+  AD_PLACEMENTS
+} from "./chunk-MCJ5I5LR.js";
+import {
+  CAPABILITY_SURFACES
+} from "./chunk-NSBNIPIW.js";
+import {
+  apiPost
+} from "./chunk-B4UVJCJ4.js";
+
+// src/commands/canvas/scaffold-delivery.ts
+var flagText = (value) => typeof value === "string" || typeof value === "number" ? String(value).trim() || void 0 : void 0;
+function deliveryInputOf(flags, definition, idea) {
+  const platformsFlag = flagText(flags.platforms);
+  const legacyPlatform = flagText(flags.platform);
+  const legacyPlacements = flagText(flags.placements);
+  const aspect = flagText(flags.aspect);
+  const formatsFlag = flagText(flags.formats);
+  const targetAdSet = flagText(flags["target-adset"]);
+  return {
+    ...platformsFlag ? { platformsFlag } : {},
+    ...legacyPlatform ? { legacyPlatform } : {},
+    ...legacyPlacements ? { legacyPlacements } : {},
+    ...aspect ? { aspect } : {},
+    ...formatsFlag ? { formatsFlag } : {},
+    ...idea && idea.length > 0 ? { idea } : {},
+    definition,
+    ...targetAdSet ? { targetAdSet } : {}
+  };
+}
+function namesDelivery(flags) {
+  return [flags.platforms, flags.platform, flags.placements, flags.formats].some((f) => flagText(f) !== void 0);
+}
+var SURFACE_PLATFORMS = {
+  "meta-ads": "meta",
+  "linkedin-ads": "linkedin",
+  "google-ads": "google_demandgen",
+  "x-ads": "x",
+  "chatgpt-ads": "chatgpt"
+};
+async function connectedAdPlatforms() {
+  try {
+    const response = await apiPost("/api/capabilities", {}, { timeoutMs: 15e3 });
+    return response.data.surfaces.filter((s) => s.connected && CAPABILITY_SURFACES.includes(s.surface)).flatMap((s) => SURFACE_PLATFORMS[s.surface] ? [SURFACE_PLATFORMS[s.surface]] : []);
+  } catch {
+    return [];
+  }
+}
+async function scaffoldDelivery(flags, definitionText, idea) {
+  const definition = definitionText === null ? null : parseDefinitionDelivery(definitionText);
+  const input = deliveryInputOf(flags, definition, idea);
+  const resolved = resolveDelivery(input);
+  if (resolved.ok || resolved.error.code !== "platform_required") return resolved;
+  return resolveDelivery({ ...input, connected: await connectedAdPlatforms() });
+}
+function deliveryDefinitionFields(delivery) {
+  const platforms = delivery.platforms.map((p) => p.trim());
+  return {
+    // The collection names whole platforms; a placement named alone records its platform.
+    platforms: [...new Set(platforms.map(platformOfName))],
+    platform: definitionPlatformOf(platforms[0] ?? ""),
+    formats: resolveFormatList(delivery.formats)
+  };
+}
+function platformOfName(name) {
+  return AD_PLACEMENTS.find((p) => p.id === name)?.platform ?? name;
+}
+function deliveryNote(delivery, renderRatio) {
+  const from = {
+    flag: "as asked",
+    idea: "from the idea",
+    definition: "from _definition.md",
+    legacy_definition: "from _definition.md's platform",
+    adset: "from its Meta ad set"
+  };
+  return `Made for ${delivery.platforms.join(", ")} (${from[delivery.source]}): delivers ${delivery.formats.join(", ")}, the ${delivery.lead} designed first (rendered at ${renderRatio}) and every other size re-laid out from it.`;
+}
+
+export {
+  namesDelivery,
+  scaffoldDelivery,
+  deliveryDefinitionFields,
+  deliveryNote
+};
+//# sourceMappingURL=chunk-FX3MXXYD.js.map

package/dist/chunk-GLCHD54W.js

@@ -0,0 +1,74 @@
+import {
+  cacheGet,
+  cacheSet,
+  handleConnectionError,
+  needsConnectionFix,
+  writeJsonEnvelope
+} from "./chunk-HPDGVK6R.js";
+import {
+  ApiError,
+  apiGet
+} from "./chunk-B4UVJCJ4.js";
+import {
+  getEnv
+} from "./chunk-52IYZCRS.js";
+
+// src/commands/gsc/resolve.ts
+async function fetchSites(useCache = true) {
+  if (useCache) {
+    const cached = cacheGet("gsc-sites", "list");
+    if (cached) return cached.data;
+  }
+  const params = !useCache ? { "skip-cache": "true" } : void 0;
+  const data = await apiGet("/api/gsc/sites", params);
+  if (useCache) {
+    cacheSet("gsc-sites", "list", data, 60 * 60 * 1e3);
+  }
+  return data;
+}
+async function resolveSiteUrl(args) {
+  const fromArgs = args["site-url"];
+  const fromEnv = getEnv().BAKER_GSC_SITE_URL;
+  const siteUrl = fromArgs || fromEnv;
+  if (siteUrl) return siteUrl;
+  const useCache = !args["no-cache"];
+  try {
+    const sites = await fetchSites(useCache);
+    const [single] = sites;
+    if (sites.length === 1 && single) {
+      process.stderr.write(`Using site "${single.siteUrl}"
+`);
+      return single.siteUrl;
+    }
+    if (sites.length === 0) {
+      handleConnectionError("gsc");
+    }
+    const list = sites.map((s) => `  ${s.siteUrl}  (${s.permissionLevel})`).join("\n");
+    writeJsonEnvelope({
+      ok: false,
+      error: {
+        code: "MULTIPLE_SITES",
+        message: `Multiple sites found. Pass --site-url or set BAKER_GSC_SITE_URL:
+${list}`
+      }
+    });
+    process.exit(1);
+  } catch (err) {
+    if (err instanceof ApiError && needsConnectionFix(err.code, err.message)) {
+      handleConnectionError("gsc", err.message);
+    }
+    writeJsonEnvelope({
+      ok: false,
+      error: {
+        code: "RESOLUTION_ERROR",
+        message: "Could not auto-detect site. Pass --site-url or set BAKER_GSC_SITE_URL."
+      }
+    });
+    process.exit(1);
+  }
+}
+
+export {
+  resolveSiteUrl
+};
+//# sourceMappingURL=chunk-GLCHD54W.js.map

package/dist/chunk-GT77XMOG.js

@@ -0,0 +1,23 @@
+import {
+  creativesRunResponseSchema
+} from "./chunk-HVJJEQDQ.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-B4UVJCJ4.js";
+
+// src/commands/canvas/run-history.ts
+async function fetchRunRecord(runId, post = apiPost) {
+  try {
+    const response = await post("/api/creatives/run", { runId });
+    return creativesRunResponseSchema.parse(response).data;
+  } catch (e) {
+    if (e instanceof ApiError && e.code === "NOT_FOUND") return null;
+    throw e;
+  }
+}
+
+export {
+  fetchRunRecord
+};
+//# sourceMappingURL=chunk-GT77XMOG.js.map

package/dist/chunk-GXPZJ2QN.js

@@ -0,0 +1,225 @@
+import {
+  BRAND_DIR,
+  inkLuma,
+  logoArtwork
+} from "./chunk-T6PTG6VM.js";
+import {
+  fetchExternalBytes
+} from "./chunk-SWNCS2OD.js";
+import {
+  apiGet,
+  apiPost
+} from "./chunk-B4UVJCJ4.js";
+
+// src/commands/canvas/clientLogo.ts
+import { mkdir, readFile, writeFile } from "fs/promises";
+import * as cheerio from "cheerio";
+import path from "path";
+function decideClientLogo(domain, lookup) {
+  if (!domain) return { use: false, reason: "no_domain" };
+  const verdict = lookup?.brandMatch?.verdict;
+  if (verdict === "mismatch") {
+    return { use: false, reason: "mismatch", ...lookup?.brandMatch?.name ? { wrongBrand: lookup.brandMatch.name } : {} };
+  }
+  if (verdict !== "confirmed") return { use: false, reason: "unverified" };
+  const url = lookup?.hits?.map((hit) => hit.imageUrl ?? hit.sourceUrl).find((candidate) => Boolean(candidate));
+  return url ? { use: true, url } : { use: false, reason: "no_hits" };
+}
+function clientLogoMissNote(decision, domain) {
+  switch (decision.reason) {
+    case "no_domain":
+      return "Baker has no website on record for this company, so their mark could not be looked up.";
+    case "mismatch":
+      return `The mark found for \`${domain}\` belongs to ${decision.wrongBrand ?? "a different company"}, not to this client, so it was not used.`;
+    default:
+      return `No brand mark could be confirmed for \`${domain}\`, so nothing was placed.`;
+  }
+}
+function hostOf(site) {
+  try {
+    return new URL(/^https?:\/\//i.test(site) ? site : `https://${site}`).hostname.replace(/^www\./i, "").toLowerCase();
+  } catch {
+    return null;
+  }
+}
+var NOT_THE_LOGO = /favicon|apple-touch|sprite|(?:^|[/_.-])icons?(?:[/_.-]|$)|client|customer|partner|testimonial|trust|badge|award/i;
+function sayings(hit, url) {
+  const meta = hit.providerMeta ?? {};
+  const given = ["alt", "class", "id", "title"].map((key) => typeof meta[key] === "string" ? meta[key] : "");
+  return [new URL(url).pathname, hit.name ?? "", hit.description ?? "", ...given].join(" ");
+}
+function logoFromExtract(hits, domain) {
+  const own = hostOf(domain);
+  if (!own) return null;
+  const candidates = hits.flatMap((hit) => {
+    const url = hit.url ?? hit.imageUrl ?? hit.sourceUrl;
+    const host = url ? hostOf(url) : null;
+    if (!url || !host || host !== own && !host.endsWith(`.${own}`)) return [];
+    const said = sayings(hit, url);
+    if (!/logo/i.test(said) || NOT_THE_LOGO.test(said)) return [];
+    return [{ url, score: (/\.svg(?:\?|$)/i.test(url) ? 2 : 0) + (/logo/i.test(new URL(url).pathname) ? 1 : 0) }];
+  });
+  candidates.sort((a, b) => b.score - a.score || a.url.length - b.url.length);
+  return candidates[0]?.url ?? null;
+}
+var MAX_INLINE_SVG = 3e5;
+var BRAND_PLACES = "header, nav, [role=banner]";
+var IMAGE_ADDRESS = ["src", "data-src", "data-lazy-src", "data-original"];
+function logoFromPage(html, pageUrl, domain) {
+  const own = hostOf(domain);
+  if (!own) return null;
+  const $ = cheerio.load(html);
+  for (const el of $(`${BRAND_PLACES}`).find("img, svg").toArray()) {
+    const node = $(el);
+    const said = [node, node.closest("a")].flatMap((n) => ["class", "id", "alt", "aria-label", "title"].map((k) => n.attr(k) ?? "")).join(" ");
+    if (!/logo/i.test(said) || NOT_THE_LOGO.test(said)) continue;
+    if (el.tagName === "svg") {
+      const svg = standaloneSvg($, node);
+      if (svg) return { kind: "svg", svg };
+      continue;
+    }
+    const url = IMAGE_ADDRESS.map((k) => node.attr(k)?.trim() ?? "").filter((a) => a !== "" && !a.startsWith("data:")).map((a) => absolute(a, pageUrl)).find((a) => a !== null);
+    const host = url ? hostOf(url) : null;
+    if (url && host && (host === own || host.endsWith(`.${own}`))) return { kind: "url", url };
+  }
+  return null;
+}
+function absolute(address, base) {
+  try {
+    const url = new URL(address, base);
+    return /^https?:$/.test(url.protocol) ? url.href : null;
+  } catch {
+    return null;
+  }
+}
+function standaloneSvg($, node) {
+  const draws = node.find("path, circle, rect, polygon, polyline, ellipse, line, text").length > 0;
+  if (!draws || node.find("use").length > 0) return null;
+  const copy = node.clone();
+  if (!copy.attr("xmlns")) copy.attr("xmlns", "http://www.w3.org/2000/svg");
+  const svg = $.html(copy);
+  return svg.length <= MAX_INLINE_SVG ? svg : null;
+}
+function logoTone(inkLuma2) {
+  return inkLuma2 !== null && inkLuma2 > 170 ? "dark" : "light";
+}
+function withLogoRegistered(tokensJson, logo) {
+  if (tokensJson === null) return null;
+  let tokens;
+  try {
+    tokens = JSON.parse(tokensJson);
+  } catch {
+    return null;
+  }
+  if (!tokens || typeof tokens !== "object" || Array.isArray(tokens)) return null;
+  const doc = tokens;
+  const logos = Array.isArray(doc.logos) ? doc.logos : [];
+  if (logos.some((l) => l?.path === logo.path)) return null;
+  const next = { ...doc, logos: [...logos, { variant: "logo", background: logo.background, path: logo.path }] };
+  return `${JSON.stringify(next, null, 2)}
+`;
+}
+function logoMissingHint(company, domain) {
+  return `No logo on file for ${company}: add it on the Brand page${domain ? ` (we could not find it on ${domain})` : ""}.`;
+}
+function extensionOf(url) {
+  return /\.(svg|png|jpg|jpeg|webp)(?:\?|$)/i.exec(url)?.[1]?.toLowerCase() ?? "svg";
+}
+var MAX_LOGO_BYTES = 3e6;
+async function downloaded(url) {
+  try {
+    const { buffer } = await fetchExternalBytes(url, { maxBytes: MAX_LOGO_BYTES });
+    return buffer.byteLength > 0 ? { bytes: buffer, extension: extensionOf(url) } : null;
+  } catch {
+    return null;
+  }
+}
+async function logoOnSite(domain) {
+  const host = hostOf(domain);
+  if (!host) return null;
+  const page = `https://${host}/`;
+  try {
+    const { buffer } = await fetchExternalBytes(page, { maxBytes: MAX_LOGO_BYTES });
+    const found = logoFromPage(buffer.toString("utf8"), page, domain);
+    if (found?.kind === "svg") return { bytes: Buffer.from(found.svg, "utf8"), extension: "svg" };
+    const file = found ? await downloaded(found.url) : null;
+    if (file) return file;
+  } catch {
+  }
+  try {
+    const listed = await apiPost("/api/images/extract", { url: page, limit: 50 });
+    const url = logoFromExtract(listed.hits ?? [], domain);
+    return url ? await downloaded(url) : null;
+  } catch {
+    return null;
+  }
+}
+async function logoSource(domain) {
+  let lookup = null;
+  if (domain) {
+    try {
+      lookup = await apiPost("/api/images/logo", { domain, variant: "logo", autoIngest: 1 });
+    } catch {
+      lookup = null;
+    }
+  }
+  const decision = decideClientLogo(domain, lookup);
+  if (decision.use) {
+    const file = await downloaded(decision.url);
+    if (file) return file;
+  }
+  if (domain && !(decision.use === false && decision.reason === "mismatch")) {
+    const file = await logoOnSite(domain);
+    if (file) return file;
+  }
+  return { note: clientLogoMissNote(decision.use ? { use: false, reason: "no_hits" } : decision, domain) };
+}
+async function inkOf(bytes) {
+  try {
+    return inkLuma((await logoArtwork(bytes)).data);
+  } catch {
+    return null;
+  }
+}
+async function fetchClientLogo(root = ".") {
+  let domain;
+  let company;
+  try {
+    const found = await apiGet("/api/company");
+    domain = found.data.domain?.trim() || void 0;
+    company = found.data.name;
+  } catch {
+    domain = void 0;
+  }
+  const named = { ...domain ? { domain } : {}, ...company ? { company } : {} };
+  const source = await logoSource(domain);
+  if ("note" in source) return { ok: false, reason: source.note, ...named };
+  try {
+    const tone = logoTone(await inkOf(source.bytes));
+    const dir = path.join(root, BRAND_DIR, "logos");
+    await mkdir(dir, { recursive: true });
+    const file = path.join(dir, `logo-${tone}.${source.extension}`);
+    await writeFile(file, source.bytes);
+    await registerLogo(root, path.join(BRAND_DIR, "logos", path.basename(file)), tone);
+    return { ok: true, path: file, ...named };
+  } catch {
+    return { ok: false, reason: clientLogoMissNote({ use: false, reason: "no_hits" }, domain), ...named };
+  }
+}
+async function registerLogo(root, relative, background) {
+  const tokensPath = path.join(root, BRAND_DIR, "tokens.json");
+  const next = withLogoRegistered(await readFile(tokensPath, "utf8").catch(() => null), { path: relative, background });
+  if (next !== null) await writeFile(tokensPath, next, "utf8").catch(() => void 0);
+}
+async function withClientLogo(root, kit, reread, fetch = fetchClientLogo) {
+  if (kit.logo) return { kit };
+  const fetched = await fetch(root).catch(() => null);
+  if (fetched?.ok) return { kit: await reread() };
+  return { kit, hint: logoMissingHint(fetched?.company ?? "your company", fetched?.domain) };
+}
+
+export {
+  fetchClientLogo,
+  withClientLogo
+};
+//# sourceMappingURL=chunk-GXPZJ2QN.js.map

package/dist/chunk-HPAGYPAF.js

@@ -0,0 +1,175 @@
+import {
+  termsRefusalFix
+} from "./chunk-QALAJNBG.js";
+import {
+  handleConnectionError,
+  isOrganizationReadRefusal,
+  needsConnectionFix,
+  writeAdsJson,
+  writeJsonEnvelope
+} from "./chunk-HPDGVK6R.js";
+import {
+  ApiError
+} from "./chunk-B4UVJCJ4.js";
+import {
+  getEnv
+} from "./chunk-52IYZCRS.js";
+
+// ../api/src/ads-meta/permissionGates.ts
+var META_PERMISSION_NOT_ENABLED_MESSAGE = {
+  catalog: "Catalog changes need the Catalog permission for Meta \u2014 ask a Baker admin to turn it on, then reconnect Meta. Everything else on Meta keeps working: tell the user, and carry on with the rest of the job.",
+  pagePosts: "Facebook Page posts need the Page posts permission for Meta \u2014 ask a Baker admin to turn it on, then reconnect Meta. Everything else on Meta keeps working: tell the user, and carry on with the rest of the job."
+};
+var META_PERMISSION_RECONNECT_MESSAGE = {
+  catalog: "Catalog changes need the Catalog permission for Meta. It is turned on for this company, but this Meta connection was made before, so it does not hold it \u2014 ask the user to reconnect Meta in the dashboard, then try again. Everything else on Meta keeps working meanwhile.",
+  pagePosts: "Facebook Page posts need the Page posts permission for Meta. It is turned on for this company, but this Meta connection was made before, so it does not hold it \u2014 ask the user to reconnect Meta in the dashboard, then try again. Everything else on Meta keeps working meanwhile."
+};
+var META_UNREQUESTED_PERMISSION_MESSAGE = {
+  comments: "Reading and moderating comments on ads needs Meta permissions Baker's Meta connection does not ask for yet (reading people's comments and managing them on the Page). Tell the user that comment moderation happens in Meta Business Suite for now, and carry on with the rest of the job.",
+  instagramMedia: "Listing an Instagram account's posts needs a Meta permission Baker's Meta connection does not ask for yet. Ask the user for the post's link or id instead, or boost it from Meta Business Suite, and carry on."
+};
+var META_PAGE_ADS_PERMISSION_REMEDY = "A Baker admin turns it on with the lead ads switch for this company; then the user reconnects Meta in the dashboard. Tell the user, and carry on with the rest of the job.";
+function isMetaPermissionGateRefusal(message) {
+  return [
+    ...Object.values(META_PERMISSION_NOT_ENABLED_MESSAGE),
+    ...Object.values(META_PERMISSION_RECONNECT_MESSAGE),
+    ...Object.values(META_UNREQUESTED_PERMISSION_MESSAGE),
+    META_PAGE_ADS_PERMISSION_REMEDY
+  ].some((refusal) => message.includes(refusal));
+}
+
+// src/commands/ads/meta/shared.ts
+var DAY_MS = 864e5;
+function metaForbiddenFix(message) {
+  if (isMetaPermissionGateRefusal(message)) {
+    return { action: "reject", explanation: message };
+  }
+  if (message.includes("has not accepted Meta's Lead Generation Terms")) {
+    return {
+      action: "reject",
+      explanation: `${message}
+
+Meta confirmed the Page's terms status using its Page access. Give the Page owner the terms link in the error and ask them to accept it before trying the form or lead ad set again. Do not suggest reconnecting Meta for this refusal; continue with other work that does not require the form or ad set.`
+    };
+  }
+  return {
+    action: "reject",
+    explanation: [
+      message,
+      "This is a permission refusal, not a dead connection, and Meta returns the same code for two causes with opposite remedies. Tell them apart by how much else works before you answer.",
+      "If other reads on this account are ALSO refused (campaigns, ad sets, insights), the connection is short a permission it was never granted. Only the user can widen it, by reconnecting Meta from the dashboard.",
+      "If those reads work and only this object is refused, the asset (pixel/dataset, Page, or catalog) belongs to a Business the connected user holds no role in. Ad-account access does not carry asset access and reconnecting cannot grant it \u2014 the client assigns that asset to the connected user or partner in Meta Business settings, under the asset's own section (Data sources \u2192 Datasets for a pixel).",
+      "Either way do not retry the same call, and do not abort the wider job. Continue with what you can read, and state in your answer that this specific check could not run and why \u2014 never present the task as verified when this step was skipped."
+    ].join("\n\n")
+  };
+}
+function handleMetaError(err) {
+  if (err instanceof ApiError) {
+    if (needsConnectionFix(err.code, err.message)) {
+      handleConnectionError("meta_ads", err.message);
+    }
+    const terms = termsRefusalFix(err.code, err.message);
+    if (terms) {
+      writeJsonEnvelope({
+        ok: false,
+        error: { code: terms.code, message: err.message, fix: terms.fix, retryable: false }
+      });
+      process.exit(1);
+    }
+    const envelope = {
+      ok: false,
+      error: {
+        code: err.code,
+        message: err.message,
+        fix: err.code === "FORBIDDEN" && !isOrganizationReadRefusal(err.message) ? metaForbiddenFix(err.message) : { action: "reject", explanation: err.message },
+        retryable: err.code === "RATE_LIMITED" || err.code === "UNAVAILABLE" || err.code === "INTERNAL_ERROR"
+      }
+    };
+    writeAdsJson(envelope);
+    process.exit(1);
+  }
+  const message = err instanceof Error ? err.message : "Unexpected error";
+  writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message } });
+  process.exit(1);
+}
+var ACCOUNT_ID_RE = /^(act_)?[0-9]+$/;
+function resolveAccountIdArg(args) {
+  const fromArgs = args["account-id"];
+  const id = fromArgs || getEnv().BAKER_META_AD_ACCOUNT_ID;
+  if (!id) {
+    writeAdsJson({
+      ok: false,
+      error: {
+        code: "MISSING_ACCOUNT_ID",
+        message: "Pass --account-id or set BAKER_META_AD_ACCOUNT_ID. Run `baker ads meta accounts` to find IDs."
+      }
+    });
+    process.exit(1);
+  }
+  if (!ACCOUNT_ID_RE.test(id)) {
+    writeAdsJson({
+      ok: false,
+      error: {
+        code: "INVALID_ACCOUNT_ID",
+        message: `Invalid account ID "${id}". Expected numeric ID, optionally prefixed with "act_".`
+      }
+    });
+    process.exit(1);
+  }
+  return id.startsWith("act_") ? id : `act_${id}`;
+}
+function getDateRange(args) {
+  const datePreset = args["date-preset"];
+  const since = args.since;
+  const until = args.until;
+  if (since && until) return { since, until };
+  return { datePreset: datePreset ?? "last_7d" };
+}
+function todayIso() {
+  return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+}
+function daysAgoIso(days) {
+  return new Date(Date.now() - days * DAY_MS).toISOString().slice(0, 10);
+}
+function csvOrJson(args) {
+  return args.output ?? "json";
+}
+var NAME_CONTAINS_ARG = {
+  type: "string",
+  description: "Only rows whose name contains this text, matched by Meta before anything is returned. Start here to find one entity by name: --name-contains octubre --all-statuses"
+};
+function resolveEffectiveStatus(args) {
+  if (args["all-statuses"]) {
+    return void 0;
+  }
+  const explicit = args["effective-status"];
+  if (explicit) {
+    return explicit;
+  }
+  return "ACTIVE";
+}
+function statusFilterHints(rows, effectiveStatus, noun) {
+  if (rows.length > 0 || effectiveStatus === void 0) return [];
+  if (effectiveStatus === "ACTIVE") {
+    return [
+      `No ACTIVE ${noun}. The ACTIVE filter hides paused, archived and in-review ones (under a paused campaign or ad set that is all of them), so this does NOT mean none exist. Re-run with --all-statuses before concluding there are none.`
+    ];
+  }
+  return [
+    `No ${noun} with effective_status ${effectiveStatus}. Re-run with --all-statuses to see every status before concluding there are none.`
+  ];
+}
+
+export {
+  metaForbiddenFix,
+  handleMetaError,
+  resolveAccountIdArg,
+  getDateRange,
+  todayIso,
+  daysAgoIso,
+  csvOrJson,
+  NAME_CONTAINS_ARG,
+  resolveEffectiveStatus,
+  statusFilterHints
+};
+//# sourceMappingURL=chunk-HPAGYPAF.js.map