@koda-sl/baker-cli 0.476.0 → 0.477.0

package/dist/chunk-JQUPL6IQ.js

@@ -1,136 +0,0 @@
-import {
-  coercePathUrlToUrl,
-  looksLikeHttpUrl
-} from "./chunk-VPBCR6DT.js";
-
-// src/commands/canvas/resolve-paths.ts
-import path from "path";
-function resolveRelativeCanvasPaths(canvas, baseDir) {
-  if (!canvas || typeof canvas !== "object") return canvas;
-  const c = canvas;
-  if (!Array.isArray(c.nodes)) return canvas;
-  return { ...canvas, nodes: c.nodes.map((n) => resolveNode(n, baseDir)) };
-}
-function localPathParam(node) {
-  if (node.type === "ingest") return node.params?.source === "path" ? "path" : null;
-  if (node.type === "hyperframe_render" || node.type === "hyperframe_snapshot") return "composition";
-  return null;
-}
-function resolveNode(node, baseDir) {
-  if (!node || typeof node !== "object") return node;
-  const n = node;
-  const params = n.params;
-  if (!params || typeof params !== "object") return node;
-  const key = localPathParam(n);
-  if (key && isResolvableRelative(params[key])) {
-    return { ...node, params: { ...params, [key]: path.resolve(baseDir, params[key]) } };
-  }
-  return node;
-}
-function isResolvableRelative(value) {
-  return typeof value === "string" && value.length > 0 && !value.includes("[TODO") && !looksLikeHttpUrl(value) && !path.isAbsolute(value);
-}
-
-// src/commands/canvas/normalize-paths.ts
-import { existsSync, realpathSync } from "fs";
-import { writeFile } from "fs/promises";
-import path2 from "path";
-function findWorkspaceRoot(startDir, exists = existsSync, maxDepth = 12) {
-  let dir = path2.resolve(startDir);
-  for (let i = 0; i < maxDepth; i++) {
-    if (exists(path2.join(dir, "package.json"))) return dir;
-    const parent = path2.dirname(dir);
-    if (parent === dir) break;
-    dir = parent;
-  }
-  return null;
-}
-function canvasOutputsRoot(canvasFile, cwd = process.cwd(), exists = existsSync) {
-  const root = findWorkspaceRoot(path2.dirname(path2.resolve(cwd, canvasFile)), exists) ?? cwd;
-  return path2.join(root, "canvas");
-}
-function canonicalize(target) {
-  const abs = path2.resolve(target);
-  let dir = abs;
-  for (; ; ) {
-    try {
-      const real = realpathSync(dir);
-      return dir === abs ? real : path2.join(real, path2.relative(dir, abs));
-    } catch {
-      const parent = path2.dirname(dir);
-      if (parent === dir) return abs;
-      dir = parent;
-    }
-  }
-}
-function isInside(root, target) {
-  const rel = path2.relative(root, target);
-  return rel !== "" && !rel.startsWith("..") && !path2.isAbsolute(rel);
-}
-function toCanvasRelative(canvasDir, target) {
-  return path2.relative(canvasDir, target).split(path2.sep).join("/");
-}
-var RUNTIME_WORKSPACE_ROOT = "/home/user/repo";
-function rewriteTarget(value, workspaceRoot) {
-  if (typeof value !== "string" || value.length === 0) return null;
-  if (value.includes("[TODO") || looksLikeHttpUrl(value) || !path2.isAbsolute(value)) return null;
-  const target = canonicalize(value);
-  if (isInside(workspaceRoot, target)) return target;
-  const fromRuntime = path2.relative(RUNTIME_WORKSPACE_ROOT, path2.normalize(value));
-  if (fromRuntime !== "" && !fromRuntime.startsWith("..") && !path2.isAbsolute(fromRuntime)) {
-    return path2.join(workspaceRoot, fromRuntime);
-  }
-  return null;
-}
-function normalizeCanvasPaths(canvas, canvasDir, workspaceRoot) {
-  if (!canvas || typeof canvas !== "object") return { canvas, rewrites: [] };
-  const c = canvas;
-  if (!Array.isArray(c.nodes)) return { canvas, rewrites: [] };
-  const root = canonicalize(workspaceRoot);
-  const dir = canonicalize(canvasDir);
-  const rewrites = [];
-  const nodes = c.nodes.map((node) => {
-    if (!node || typeof node !== "object") return node;
-    const n = node;
-    const params = n.params;
-    if (!params || typeof params !== "object") return node;
-    const nodeId = typeof n.id === "string" ? n.id : "?";
-    if (n.type === "ingest" && params.source === "path" && looksLikeHttpUrl(params.path)) {
-      rewrites.push({ nodeId, param: "source", from: "path", to: "url" });
-      return { ...node, params: coercePathUrlToUrl(params) };
-    }
-    const key = localPathParam(n);
-    if (!key) return node;
-    const target = rewriteTarget(params[key], root);
-    if (target === null) return node;
-    const to = toCanvasRelative(dir, target);
-    rewrites.push({ nodeId, param: key, from: params[key], to });
-    return { ...node, params: { ...params, [key]: to } };
-  });
-  return rewrites.length === 0 ? { canvas, rewrites } : { canvas: { ...canvas, nodes }, rewrites };
-}
-async function healCanvasPaths(filePath, canvas) {
-  const canvasDir = path2.dirname(filePath);
-  const workspaceRoot = findWorkspaceRoot(canvasDir);
-  if (!workspaceRoot) return { canvas, rewrites: [], text: null };
-  const normalized = normalizeCanvasPaths(canvas, canvasDir, workspaceRoot);
-  if (normalized.rewrites.length === 0) return { ...normalized, text: null };
-  const text = `${JSON.stringify(normalized.canvas, null, 2)}
-`;
-  await writeFile(filePath, text, "utf8");
-  return { ...normalized, text };
-}
-function describeRewrites(rewrites) {
-  return rewrites.map((r) => `  ${r.nodeId}.${r.param}: ${r.from} \u2192 ${r.to}`).join("\n");
-}
-
-export {
-  resolveRelativeCanvasPaths,
-  localPathParam,
-  findWorkspaceRoot,
-  canvasOutputsRoot,
-  normalizeCanvasPaths,
-  healCanvasPaths,
-  describeRewrites
-};
-//# sourceMappingURL=chunk-JQUPL6IQ.js.map

package/dist/chunk-K2DBAN3C.js

@@ -1,26 +0,0 @@
-import {
-  writeJsonEnvelope
-} from "./chunk-CGOVXSSY.js";
-import {
-  apiGet
-} from "./chunk-JLCK7K6Y.js";
-
-// src/available-accounts.ts
-var AVAILABLE_ARG = {
-  type: "boolean",
-  description: "List everything the connected login reaches, each marked selected: true|false. Use it when the account, property, site or container the user means is not in the plain list.",
-  required: false
-};
-async function writeAvailableAccounts(platform, onError) {
-  try {
-    writeJsonEnvelope(await apiGet("/api/connections/available", { platform }));
-  } catch (err) {
-    onError(err);
-  }
-}
-
-export {
-  AVAILABLE_ARG,
-  writeAvailableAccounts
-};
-//# sourceMappingURL=chunk-K2DBAN3C.js.map

package/dist/chunk-KKXHGAYA.js

@@ -1,74 +0,0 @@
-import {
-  cacheGet,
-  cacheSet,
-  handleConnectionError,
-  needsConnectionFix,
-  writeJsonEnvelope
-} from "./chunk-CGOVXSSY.js";
-import {
-  ApiError,
-  apiGet
-} from "./chunk-JLCK7K6Y.js";
-import {
-  getEnv
-} from "./chunk-G3UCXCC2.js";
-
-// src/commands/ga4/resolve.ts
-async function fetchProperties(useCache = true) {
-  if (useCache) {
-    const cached = cacheGet("ga4-properties", "list");
-    if (cached) return cached.data;
-  }
-  const params = !useCache ? { "skip-cache": "true" } : void 0;
-  const data = await apiGet("/api/ga4/properties", params);
-  if (useCache) {
-    cacheSet("ga4-properties", "list", data, 60 * 60 * 1e3);
-  }
-  return data;
-}
-async function resolvePropertyId(args) {
-  const fromArgs = args["property-id"];
-  const fromEnv = getEnv().BAKER_GA4_PROPERTY_ID;
-  const propertyId = fromArgs || fromEnv;
-  if (propertyId) return propertyId;
-  const useCache = !args["no-cache"];
-  try {
-    const properties = await fetchProperties(useCache);
-    const [single] = properties;
-    if (properties.length === 1 && single) {
-      process.stderr.write(`Using property "${single.name}" (${single.externalId})
-`);
-      return single.externalId;
-    }
-    if (properties.length === 0) {
-      handleConnectionError("ga4");
-    }
-    const list = properties.map((p) => `  ${p.externalId}  ${p.name}`).join("\n");
-    writeJsonEnvelope({
-      ok: false,
-      error: {
-        code: "MULTIPLE_PROPERTIES",
-        message: `Multiple properties found. Pass --property-id or set BAKER_GA4_PROPERTY_ID:
-${list}`
-      }
-    });
-    process.exit(1);
-  } catch (err) {
-    if (err instanceof ApiError && needsConnectionFix(err.code, err.message)) {
-      handleConnectionError("ga4", err.message);
-    }
-    writeJsonEnvelope({
-      ok: false,
-      error: {
-        code: "RESOLUTION_ERROR",
-        message: "Could not auto-detect property. Pass --property-id or set BAKER_GA4_PROPERTY_ID."
-      }
-    });
-    process.exit(1);
-  }
-}
-
-export {
-  resolvePropertyId
-};
-//# sourceMappingURL=chunk-KKXHGAYA.js.map

package/dist/chunk-KMMVQ2MR.js

@@ -1,84 +0,0 @@
-import {
-  findWorkspaceRoot
-} from "./chunk-JQUPL6IQ.js";
-
-// src/commands/canvas/unbilled-spend.ts
-import { randomUUID } from "crypto";
-import { mkdir, readdir, readFile, rename, unlink, writeFile } from "fs/promises";
-import path from "path";
-import { z } from "zod";
-var DIR = "unbilled-spend";
-var Held = z.array(
-  z.object({ model: z.string(), inputTokens: z.number(), outputTokens: z.number(), costUsd: z.number() })
-);
-async function holdUnbilledSpend(cacheDir, usage) {
-  if (usage.length === 0) return;
-  const dir = path.join(cacheDir, DIR);
-  await mkdir(dir, { recursive: true });
-  await writeFile(path.join(dir, `${Date.now()}-${randomUUID()}.json`), JSON.stringify(usage), "utf8");
-}
-async function holdWorkspaceSpend(usage) {
-  const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();
-  await holdUnbilledSpend(path.join(root, "canvas", ".cache"), usage).catch(() => {
-  });
-}
-async function takeUnbilledSpend(cacheDir) {
-  const dir = path.join(cacheDir, DIR);
-  const files = await readdir(dir).catch(() => []);
-  const byModel = /* @__PURE__ */ new Map();
-  for (const file of files.filter((f) => f.endsWith(".json"))) {
-    const claimed = path.join(dir, `${file}.${randomUUID()}.taken`);
-    try {
-      await rename(path.join(dir, file), claimed);
-    } catch {
-      continue;
-    }
-    const parsed = Held.safeParse(await readFile(claimed, "utf8").then(JSON.parse, () => null).catch(() => null));
-    await unlink(claimed).catch(() => {
-    });
-    for (const call of parsed.success ? parsed.data : []) {
-      const sum = byModel.get(call.model);
-      byModel.set(
-        call.model,
-        sum ? {
-          model: call.model,
-          inputTokens: sum.inputTokens + call.inputTokens,
-          outputTokens: sum.outputTokens + call.outputTokens,
-          costUsd: sum.costUsd + call.costUsd
-        } : { ...call }
-      );
-    }
-  }
-  return [...byModel.values()];
-}
-async function sendBillingSpend(cacheDir, usage, send) {
-  try {
-    await send();
-    return null;
-  } catch (e) {
-    await holdUnbilledSpend(cacheDir, usage).catch(() => {
-    });
-    return e instanceof Error ? e.message : String(e);
-  }
-}
-function holdWhenSettled(cacheDir, spendOf) {
-  const pending = [];
-  return {
-    settled: (run, outputs) => {
-      pending.push(holdUnbilledSpend(cacheDir, spendOf(run, outputs)).catch(() => {
-      }));
-    },
-    drained: async () => {
-      await Promise.all(pending);
-    }
-  };
-}
-
-export {
-  holdUnbilledSpend,
-  holdWorkspaceSpend,
-  takeUnbilledSpend,
-  sendBillingSpend,
-  holdWhenSettled
-};
-//# sourceMappingURL=chunk-KMMVQ2MR.js.map

package/dist/chunk-L66QWXPF.js

@@ -1,97 +0,0 @@
-import {
-  JEV_MODEL,
-  askJev
-} from "./chunk-3YNHIJCI.js";
-
-// src/engine/lib/remembered-nouls.ts
-import { createHash } from "crypto";
-import { readFile } from "fs/promises";
-
-// src/engine/lib/file-lock.ts
-import { randomUUID } from "crypto";
-import { mkdir, rename, rm, stat, writeFile } from "fs/promises";
-import path from "path";
-var LOCK_STALE_MS = 1e4;
-var LOCK_WAIT_MS = 20;
-async function updateLockedFile(file, change) {
-  await mkdir(path.dirname(file), { recursive: true });
-  const lock = `${file}.lock`;
-  await acquireLock(lock);
-  try {
-    const temp = `${file}.${process.pid}.${randomUUID()}.tmp`;
-    await writeFile(temp, await change(), "utf8");
-    await rename(temp, file);
-  } finally {
-    await rm(lock, { force: true });
-  }
-}
-async function acquireLock(lock) {
-  for (; ; ) {
-    try {
-      await writeFile(lock, String(process.pid), { flag: "wx" });
-      return;
-    } catch (e) {
-      if (e.code !== "EEXIST") throw e;
-    }
-    const held = await stat(lock).catch(() => null);
-    if (held && Date.now() - held.mtimeMs > LOCK_STALE_MS) await rm(lock, { force: true });
-    await new Promise((resolve) => setTimeout(resolve, LOCK_WAIT_MS));
-  }
-}
-
-// src/engine/lib/remembered-nouls.ts
-var PER_REQUEST = 200;
-var MAX_REMEMBERED = 2e4;
-function keyOf(question) {
-  return createHash("sha256").update(JSON.stringify([JEV_MODEL, question.instructions])).digest("hex").slice(0, 32);
-}
-async function remembered(file) {
-  const parsed = await readFile(file, "utf8").then(JSON.parse, () => ({}));
-  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return {};
-  return Object.fromEntries(
-    Object.entries(parsed).filter((e) => typeof e[1] === "number")
-  );
-}
-async function rememberedNouls(questions, opts) {
-  if (questions.length === 0) return [];
-  const keys = questions.map(keyOf);
-  const known = opts.file ? await remembered(opts.file) : {};
-  const missing = [...new Set(keys.filter((k) => known[k] === void 0))];
-  const byKey = new Map(questions.map((q, i) => [keys[i], q]));
-  const batches = [];
-  for (let i = 0; i < missing.length; i += PER_REQUEST) batches.push(missing.slice(i, i + PER_REQUEST));
-  const answered = await Promise.all(
-    batches.map((batch) => opts.ask(batch.flatMap((k) => byKey.get(k) ?? [])).catch(() => null))
-  );
-  if (answered.some((a) => a === null || a.length === 0)) return null;
-  const fresh = {};
-  batches.forEach((batch, b) => {
-    batch.forEach((k, i) => {
-      const answer = answered[b]?.[i];
-      if (answer !== void 0) fresh[k] = answer;
-    });
-  });
-  const all = { ...known, ...fresh };
-  const file = opts.file;
-  if (file && missing.length > 0) {
-    await updateLockedFile(file, async () => {
-      const kept = Object.entries({ ...await remembered(file), ...fresh }).slice(-MAX_REMEMBERED);
-      return JSON.stringify(Object.fromEntries(kept));
-    }).catch(() => void 0);
-  }
-  const answers = keys.map((k) => all[k]);
-  return answers.every((a) => a !== void 0) ? answers : null;
-}
-function jevAsker(onSpend) {
-  return (questions) => askJev(questions, onSpend);
-}
-function rememberedJev(file, onSpend) {
-  const ask = jevAsker(onSpend);
-  return (questions) => rememberedNouls(questions, { ask, file });
-}
-
-export {
-  updateLockedFile,
-  rememberedJev
-};
-//# sourceMappingURL=chunk-L66QWXPF.js.map

package/dist/chunk-LHKCZG2R.js

@@ -1,136 +0,0 @@
-import {
-  handleConnectionError,
-  needsConnectionFix,
-  writeAdsJson
-} from "./chunk-CGOVXSSY.js";
-import {
-  ApiError
-} from "./chunk-JLCK7K6Y.js";
-import {
-  getEnv
-} from "./chunk-G3UCXCC2.js";
-
-// src/commands/ads/meta/shared.ts
-var DAY_MS = 864e5;
-function metaForbiddenFix(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 envelope = {
-      ok: false,
-      error: {
-        code: err.code,
-        message: err.message,
-        fix: err.code === "FORBIDDEN" ? 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-LHKCZG2R.js.map

package/dist/chunk-LHKCZG2R.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/ads/meta/shared.ts"],"sourcesContent":["import { ApiError } from \"../../../client.ts\";\nimport { getEnv } from \"../../../env.ts\";\nimport { handleConnectionError, needsConnectionFix } from \"../../../error-handler.ts\";\nimport { writeAdsJson } from \"../output.ts\";\nimport type { AdsErrorEnvelope, QueryFix } from \"../types.ts\";\n\nconst DAY_MS = 86_400_000;\n\n/**\n * Meta answers a permission refusal (Graph codes 200/10/294) with a bare\n * \"Permissions error\" that covers two causes needing opposite remedies: a\n * consent grant the connection never got — nothing validates Meta's granted\n * scopes after connect, unlike HubSpot's `requireCapability` — or a role the\n * user lacks on one asset, since a Pixel/Dataset, Page or catalog lives in a\n * Business and is assigned separately from the ad account. Only the blast radius\n * separates them, so hand the agent that test rather than a verdict: guessing\n * \"reconnect\" wastes the user's time on an unassigned asset, and ruling it out\n * strands a connection that really is short a scope.\n */\nexport function metaForbiddenFix(message: string): QueryFix {\n  if (message.includes(\"has not accepted Meta's Lead Generation Terms\")) {\n    return {\n      action: \"reject\",\n      explanation: `${message}\\n\\nMeta 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.`,\n    };\n  }\n  return {\n    action: \"reject\",\n    explanation: [\n      message,\n      \"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.\",\n      \"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.\",\n      \"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 — the client assigns that asset to the connected user or partner in Meta Business settings, under the asset's own section (Data sources → Datasets for a pixel).\",\n      \"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 — never present the task as verified when this step was skipped.\",\n    ].join(\"\\n\\n\"),\n  };\n}\n\nexport function handleMetaError(err: unknown): never {\n  if (err instanceof ApiError) {\n    if (needsConnectionFix(err.code, err.message)) {\n      handleConnectionError(\"meta_ads\", err.message);\n    }\n    const envelope: AdsErrorEnvelope = {\n      ok: false,\n      error: {\n        code: err.code,\n        message: err.message,\n        fix: err.code === \"FORBIDDEN\" ? metaForbiddenFix(err.message) : { action: \"reject\", explanation: err.message },\n        retryable: err.code === \"RATE_LIMITED\" || err.code === \"UNAVAILABLE\" || err.code === \"INTERNAL_ERROR\",\n      },\n    };\n    writeAdsJson(envelope);\n    process.exit(1);\n  }\n  const message = err instanceof Error ? err.message : \"Unexpected error\";\n  writeAdsJson({ ok: false, error: { code: \"NETWORK_ERROR\", message } });\n  process.exit(1);\n}\n\nconst ACCOUNT_ID_RE = /^(act_)?[0-9]+$/;\n\n/** Pull the default Meta ad account ID from `--account-id` arg or `BAKER_META_AD_ACCOUNT_ID` env. */\nexport function resolveAccountIdArg(args: Record<string, unknown>): string {\n  const fromArgs = args[\"account-id\"] as string | undefined;\n  const id = fromArgs || getEnv().BAKER_META_AD_ACCOUNT_ID;\n  if (!id) {\n    writeAdsJson({\n      ok: false,\n      error: {\n        code: \"MISSING_ACCOUNT_ID\",\n        message: \"Pass --account-id or set BAKER_META_AD_ACCOUNT_ID. Run `baker ads meta accounts` to find IDs.\",\n      },\n    });\n    process.exit(1);\n  }\n  if (!ACCOUNT_ID_RE.test(id)) {\n    writeAdsJson({\n      ok: false,\n      error: {\n        code: \"INVALID_ACCOUNT_ID\",\n        message: `Invalid account ID \"${id}\". Expected numeric ID, optionally prefixed with \"act_\".`,\n      },\n    });\n    process.exit(1);\n  }\n  return id.startsWith(\"act_\") ? id : `act_${id}`;\n}\n\nexport function getDateRange(args: Record<string, unknown>): { datePreset?: string; since?: string; until?: string } {\n  const datePreset = args[\"date-preset\"] as string | undefined;\n  const since = args.since as string | undefined;\n  const until = args.until as string | undefined;\n  if (since && until) return { since, until };\n  return { datePreset: datePreset ?? \"last_7d\" };\n}\n\nexport function todayIso(): string {\n  return new Date().toISOString().slice(0, 10);\n}\n\nexport function daysAgoIso(days: number): string {\n  return new Date(Date.now() - days * DAY_MS).toISOString().slice(0, 10);\n}\n\nexport function csvOrJson(args: Record<string, unknown>): string {\n  return (args.output as string | undefined) ?? \"json\";\n}\n\n/**\n * Matched by Meta itself, so finding one entity by name reads only the rows that\n * match instead of the whole account.\n */\nexport const NAME_CONTAINS_ARG = {\n  type: \"string\",\n  description:\n    \"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\",\n} as const;\n\n/**\n * Default to ACTIVE-only on listings — that's almost always what an AI agent or\n * a human glance wants. Pass `--effective-status ACTIVE,PAUSED` to override, or\n * `--all-statuses` to drop the filter entirely.\n */\nexport function resolveEffectiveStatus(args: Record<string, unknown>): string | undefined {\n  if (args[\"all-statuses\"]) {\n    return undefined;\n  }\n  const explicit = args[\"effective-status\"] as string | undefined;\n  if (explicit) {\n    return explicit;\n  }\n  return \"ACTIVE\";\n}\n\n/**\n * An empty listing under a status filter reads exactly like \"nothing exists\":\n * a paused campaign's ad sets are CAMPAIGN_PAUSED, so the ACTIVE default hides\n * every one of them. Say which filter produced the empty list and how to widen it.\n */\nexport function statusFilterHints(\n  rows: ReadonlyArray<unknown>,\n  effectiveStatus: string | undefined,\n  noun: string,\n): string[] {\n  if (rows.length > 0 || effectiveStatus === undefined) return [];\n  if (effectiveStatus === \"ACTIVE\") {\n    return [\n      `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.`,\n    ];\n  }\n  return [\n    `No ${noun} with effective_status ${effectiveStatus}. Re-run with --all-statuses to see every status before concluding there are none.`,\n  ];\n}\n"],"mappings":"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","names":[]}