@koda-sl/baker-cli 0.497.0 → 0.498.0

package/dist/write-commands-G6423E2M.js

@@ -0,0 +1,206 @@
+import {
+  loadJsonArg,
+  requireTarget,
+  stageOp
+} from "./chunk-AQE4Q7K3.js";
+import "./chunk-D5FY4FAK.js";
+import "./chunk-KBSWQKOT.js";
+import "./chunk-AS46I4WH.js";
+import "./chunk-6UW4J6IU.js";
+import "./chunk-XOHXG5TG.js";
+import {
+  registerSchema
+} from "./chunk-AL6AEGWH.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/tag-manager/write-commands.ts
+import { defineCommand } from "citty";
+var CONTAINER_ARG_DESCRIPTION = "Numeric container id (optional only when one container is connected \u2014 run `baker tag-manager containers`)";
+var ENTITIES = [
+  {
+    entity: "tag",
+    noun: "tag",
+    createHint: 'Payload needs name + type (e.g. "gaawe" for a GA4 event) and usually parameter[] and firingTriggerId[]. Reference a trigger by its numeric id, or by a gtm_temp_* ref if you are staging it in this same chat.',
+    example: '{"name":"GA4 - Generate Lead","type":"gaawe","firingTriggerId":["gtm_temp_trigger_x_0"]}'
+  },
+  {
+    entity: "trigger",
+    noun: "trigger",
+    createHint: 'Payload needs name + type (e.g. "pageview", "click", "customEvent"). Stage the trigger BEFORE the tag that fires on it, then reference it by its gtm_temp_* ref.',
+    example: '{"name":"Form - Submit","type":"formSubmission"}'
+  },
+  {
+    entity: "variable",
+    noun: "variable",
+    createHint: 'Payload needs name + type (e.g. "v" for a data layer variable, "c" for a constant). Other entities reference a variable by NAME as {{Variable Name}}.',
+    example: '{"name":"DL - lead_id","type":"v","parameter":[{"type":"template","key":"name","value":"lead_id"}]}'
+  },
+  {
+    entity: "folder",
+    noun: "folder",
+    createHint: "Payload needs name. Use folders to keep a large container legible.",
+    example: '{"name":"Google Ads"}'
+  }
+];
+for (const { entity, noun, createHint } of ENTITIES) {
+  registerSchema({
+    command: `tagManager.${entity}.create`,
+    description: `Stage the creation of a Tag Manager ${noun}. ${createHint} Staged only \u2014 applies when the chat completes.`,
+    args: {
+      json: { type: "string", description: `Inline JSON ${noun} definition`, required: false },
+      file: { type: "string", description: `Path to a JSON file with the ${noun} definition`, required: false },
+      container: { type: "string", description: CONTAINER_ARG_DESCRIPTION, required: false }
+    }
+  });
+  registerSchema({
+    command: `tagManager.${entity}.update`,
+    description: `Stage an update to an existing Tag Manager ${noun}. Pass the ${noun} id or path as the positional argument and the changed fields as JSON. Read the container first so you send the fields you mean to change.`,
+    args: {
+      json: { type: "string", description: "Inline JSON with the changed fields", required: false },
+      file: { type: "string", description: "Path to a JSON file with the changed fields", required: false },
+      container: { type: "string", description: CONTAINER_ARG_DESCRIPTION, required: false }
+    }
+  });
+  registerSchema({
+    command: `tagManager.${entity}.delete`,
+    description: `Stage the deletion of a Tag Manager ${noun}. Pass its id or path as the positional argument. Deleting is irreversible once the resulting version is published \u2014 confirm with the user first.`,
+    args: {
+      container: { type: "string", description: CONTAINER_ARG_DESCRIPTION, required: false }
+    }
+  });
+}
+function entityCommand(entity, noun, example) {
+  return defineCommand({
+    meta: { name: entity, description: `Stage ${noun} changes on this chat's Tag Manager draft` },
+    subCommands: {
+      create: defineCommand({
+        meta: {
+          name: "create",
+          description: `Stage a new ${noun}
+
+Examples:
+  baker tag-manager ${entity} create --json '${example}'
+  baker tag-manager ${entity} create --file ./${entity}.json`
+        },
+        args: {
+          json: { type: "string", description: "Inline JSON definition", required: false },
+          file: { type: "string", description: "Path to a JSON file", required: false },
+          container: { type: "string", description: CONTAINER_ARG_DESCRIPTION, required: false }
+        },
+        run: async ({ args }) => {
+          await stageOp({
+            kind: `tagManager.${entity}.create`,
+            payload: loadJsonArg(args),
+            ...typeof args.container === "string" ? { containerId: args.container } : {}
+          });
+        }
+      }),
+      update: defineCommand({
+        meta: {
+          name: "update",
+          description: `Stage an update to an existing ${noun} (pass its id or path)`
+        },
+        args: {
+          id: { type: "positional", description: `${noun} id or path`, required: false },
+          json: { type: "string", description: "Inline JSON with changed fields", required: false },
+          file: { type: "string", description: "Path to a JSON file", required: false },
+          container: { type: "string", description: CONTAINER_ARG_DESCRIPTION, required: false }
+        },
+        run: async ({ args }) => {
+          await stageOp({
+            kind: `tagManager.${entity}.update`,
+            target: requireTarget(args, noun),
+            payload: loadJsonArg(args),
+            ...typeof args.container === "string" ? { containerId: args.container } : {}
+          });
+        }
+      }),
+      delete: defineCommand({
+        meta: { name: "delete", description: `Stage the deletion of a ${noun} (pass its id or path)` },
+        args: {
+          id: { type: "positional", description: `${noun} id or path`, required: false },
+          container: { type: "string", description: CONTAINER_ARG_DESCRIPTION, required: false }
+        },
+        run: async ({ args }) => {
+          await stageOp({
+            kind: `tagManager.${entity}.delete`,
+            target: requireTarget(args, noun),
+            ...typeof args.container === "string" ? { containerId: args.container } : {}
+          });
+        }
+      })
+    }
+  });
+}
+var exampleFor = (entity) => ENTITIES.find((e) => e.entity === entity)?.example ?? "{}";
+var tagCommand = entityCommand("tag", "tag", exampleFor("tag"));
+var triggerCommand = entityCommand("trigger", "trigger", exampleFor("trigger"));
+var variableCommand = entityCommand("variable", "variable", exampleFor("variable"));
+var folderCommand = entityCommand("folder", "folder", exampleFor("folder"));
+registerSchema({
+  command: "tagManager.builtin",
+  description: "Enable or disable Tag Manager built-in variables by type (e.g. clickUrl, pageUrl, formId). Built-in variables must be enabled before a trigger or tag can reference them as {{Click URL}}.",
+  args: {
+    types: { type: "string", description: "Comma-separated built-in variable types", required: true },
+    container: { type: "string", description: CONTAINER_ARG_DESCRIPTION, required: false }
+  }
+});
+function builtinTypes(args) {
+  const raw = args.types;
+  if (typeof raw !== "string" || raw.length === 0) {
+    process.stdout.write(
+      `${JSON.stringify({ ok: false, error: { code: "VALIDATION_ERROR", message: "pass --types with comma-separated built-in variable types" } }, null, 2)}
+`
+    );
+    process.exit(1);
+  }
+  return raw.split(",").map((entry) => entry.trim());
+}
+var builtinCommand = defineCommand({
+  meta: {
+    name: "builtin",
+    description: `Enable or disable built-in variables
+
+Examples:
+  baker tag-manager builtin enable --types clickUrl,clickText
+  baker tag-manager builtin disable --types formId`
+  },
+  subCommands: {
+    enable: defineCommand({
+      meta: { name: "enable", description: "Stage enabling built-in variables" },
+      args: {
+        types: { type: "string", description: "Comma-separated types", required: false },
+        container: { type: "string", description: CONTAINER_ARG_DESCRIPTION, required: false }
+      },
+      run: async ({ args }) => {
+        await stageOp({
+          kind: "tagManager.builtInVariable.enable",
+          payload: { type: builtinTypes(args) },
+          ...typeof args.container === "string" ? { containerId: args.container } : {}
+        });
+      }
+    }),
+    disable: defineCommand({
+      meta: { name: "disable", description: "Stage disabling built-in variables" },
+      args: {
+        types: { type: "string", description: "Comma-separated types", required: false },
+        container: { type: "string", description: CONTAINER_ARG_DESCRIPTION, required: false }
+      },
+      run: async ({ args }) => {
+        await stageOp({
+          kind: "tagManager.builtInVariable.disable",
+          payload: { type: builtinTypes(args) },
+          ...typeof args.container === "string" ? { containerId: args.container } : {}
+        });
+      }
+    })
+  }
+});
+export {
+  builtinCommand,
+  folderCommand,
+  tagCommand,
+  triggerCommand,
+  variableCommand
+};
+//# sourceMappingURL=write-commands-G6423E2M.js.map

package/dist/x-JGV5D7AV.js

@@ -0,0 +1,47 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/index.ts
+import { defineCommand } from "citty";
+var xCommand = defineCommand({
+  meta: {
+    name: "x",
+    description: `X (Twitter) Ads commands. Read campaigns, line items, promoted tweets, creatives, audiences, and analytics.
+
+Start here:
+  baker ads x accounts                              \u2014 list accessible X Ads accounts
+  baker ads x stats sync --list-presets             \u2014 see available stats presets
+  baker ads x targeting-constants --constant locations --q "Madrid"
+
+Examples:
+  baker ads x campaigns --account-id 18ce53xyz
+  baker ads x line-items --account-id 18ce53xyz --campaign-ids abc
+  baker ads x promoted-tweets --account-id 18ce53xyz
+  baker ads x stats sync --preset campaign-engagement-7d --entity-ids abc,def
+  baker ads x stats job-create --entity CAMPAIGN --entity-ids abc \\
+    --start-time 2026-04-01T00:00:00Z --end-time 2026-05-01T00:00:00Z \\
+    --metric-groups ENGAGEMENT,BILLING --segmentation-type LOCATIONS
+
+The CLI auto-detects --account-id when exactly one X Ads account is connected, or via BAKER_X_ADS_ACCOUNT_ID.
+Full guide: __tooling__/docs/tools/baker/ads-x.md`
+  },
+  subCommands: {
+    accounts: () => import("./accounts-4HPLJD7O.js").then((m) => m.accountsCommand),
+    funding: () => import("./funding-O5ZRZN7D.js").then((m) => m.fundingCommand),
+    campaigns: () => import("./campaigns-NTEP5DKT.js").then((m) => m.campaignsCommand),
+    "line-items": () => import("./line-items-LU7VFYJ3.js").then((m) => m.lineItemsCommand),
+    "promoted-tweets": () => import("./promoted-tweets-EW3VXPZU.js").then((m) => m.promotedTweetsCommand),
+    tweets: () => import("./tweets-SGNWR3H5.js").then((m) => m.tweetsCommand),
+    cards: () => import("./cards-UZ3TAVOU.js").then((m) => m.cardsCommand),
+    draft: () => import("./draft-KYARHXHR.js").then((m) => m.draftCommand),
+    media: () => import("./media-2JCAFWCU.js").then((m) => m.mediaCommand),
+    audiences: () => import("./audiences-2342U7XH.js").then((m) => m.audiencesCommand),
+    "targeting-criteria": () => import("./targeting-criteria-GMWARSTV.js").then((m) => m.targetingCriteriaCommand),
+    "targeting-constants": () => import("./targeting-constants-ARGJ3QQV.js").then((m) => m.targetingConstantsCommand),
+    "active-entities": () => import("./active-entities-2TRODKWO.js").then((m) => m.activeEntitiesCommand),
+    stats: () => import("./stats-TVQVRDQS.js").then((m) => m.statsCommand)
+  }
+});
+export {
+  xCommand
+};
+//# sourceMappingURL=x-JGV5D7AV.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@koda-sl/baker-cli",
-  "version": "0.497.0",
+  "version": "0.498.0",
   "description": "AI-agent-first CLI for interacting with Baker, including the Baker creative canvas.",
   "type": "module",
   "bin": {
@@ -26,6 +26,7 @@
     "test": "vitest run"
   },
   "dependencies": {
+    "@astrojs/compiler": "^4.0.0",
     "@t3-oss/env-core": "^0.13.10",
     "cheerio": "^1.2.0",
     "chroma-js": "^3.2.0",

package/dist/account-EF6OPUJT.js

@@ -1,80 +0,0 @@
-import {
-  CHATGPT_ADS_REFERENCE,
-  runChatgptRead
-} from "./chunk-ACDLKTUP.js";
-import "./chunk-2VIZ4UUZ.js";
-import {
-  apiGet
-} from "./chunk-6YLNY6CK.js";
-import "./chunk-D5NEIESR.js";
-import "./chunk-57KKVDDR.js";
-import {
-  registerSchema
-} from "./chunk-QANGHND7.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/ads/chatgpt/account.ts
-import { defineCommand } from "citty";
-registerSchema({
-  command: "ads.chatgpt.account",
-  description: "The connected ChatGPT Ads account: name, currency, timezone, status, and the brand and account reviews that decide whether anything in it can serve.",
-  args: {
-    full: { type: "boolean", description: "Return ChatGPT Ads' own account object", required: false }
-  }
-});
-function accountHints(account) {
-  const hints = [];
-  if (account.brandReview.status !== "approved") {
-    const reason = account.brandReview.reason ? ` (${account.brandReview.reason})` : "";
-    hints.push(
-      `Brand review is ${account.brandReview.status}${reason}: nothing in this account serves until it is approved. Fix it in ChatGPT Ads Manager before changing campaigns.`
-    );
-  }
-  if (account.accountReview && account.accountReview.status !== "approved") {
-    hints.push(`A separate account review is ${account.accountReview.status}; delivery can wait on it too.`);
-  }
-  if (account.status === "paused") {
-    hints.push("The whole account is paused, so no campaign in it serves whatever its own status says.");
-  }
-  return hints;
-}
-var SHOW_ARGS = {
-  full: { type: "boolean", description: "Return ChatGPT Ads' own account object", required: false }
-};
-var accountShowCommand = defineCommand({
-  meta: {
-    name: "show",
-    description: "The connected ChatGPT Ads account. Example: baker ads chatgpt account"
-  },
-  args: SHOW_ARGS,
-  run: async ({ args }) => {
-    await runChatgptRead(
-      CHATGPT_ADS_REFERENCE.account,
-      () => apiGet("/api/ads/chatgpt/account", args.full ? { full: "true" } : void 0),
-      (account) => args.full ? [] : accountHints(account)
-    );
-  }
-});
-var accountCommand = defineCommand({
-  meta: {
-    name: "account",
-    description: `The connected ChatGPT Ads account. Start here: currency and timezone for every figure, and whether reviews let anything serve.
-
-Examples:
-  baker ads chatgpt account
-  baker ads chatgpt account --full
-  baker ads chatgpt account update --favicon-url https://example.com/icon.png   \u2014 staged; applies on publish`
-  },
-  subCommands: {
-    show: accountShowCommand,
-    update: () => import("./account-writes-VWU4FRGQ.js").then((m) => m.accountUpdateCommand)
-  },
-  // A parent must never declare `run`: citty falls through to it after the matched subcommand.
-  args: SHOW_ARGS,
-  default: "show"
-});
-export {
-  accountCommand,
-  accountHints
-};
-//# sourceMappingURL=account-EF6OPUJT.js.map

package/dist/account-RKULYCBU.js

@@ -1,138 +0,0 @@
-import {
-  handleMetaError,
-  resolveAccountIdArg
-} from "./chunk-RUHZ7BRN.js";
-import {
-  writeJsonEnvelope
-} from "./chunk-2VIZ4UUZ.js";
-import {
-  NO_CACHE_ARG
-} from "./chunk-U6RONIJC.js";
-import {
-  apiGet
-} from "./chunk-6YLNY6CK.js";
-import "./chunk-D5NEIESR.js";
-import "./chunk-57KKVDDR.js";
-import "./chunk-QANGHND7.js";
-import "./chunk-YQSBHWOI.js";
-
-// ../api/src/ads-meta/accountHealth.ts
-var ACCOUNT_STATUS = {
-  1: "ACTIVE",
-  2: "DISABLED",
-  3: "UNSETTLED",
-  7: "PENDING_RISK_REVIEW",
-  8: "PENDING_SETTLEMENT",
-  9: "IN_GRACE_PERIOD",
-  100: "PENDING_CLOSURE",
-  101: "CLOSED",
-  201: "ANY_ACTIVE",
-  202: "ANY_CLOSED"
-};
-var DISABLE_REASON = {
-  1: "ads integrity policy",
-  2: "ads IP review",
-  3: "payment risk",
-  4: "gray account shut down",
-  5: "ads AFC review",
-  6: "business integrity review",
-  7: "permanently closed",
-  8: "unused reseller account",
-  9: "unused account",
-  10: "umbrella ad account",
-  11: "Business Manager integrity policy",
-  12: "misrepresented ad account",
-  13: "legal entity de-share",
-  14: "thread review",
-  15: "compromised ad account"
-};
-var DELIVERS_ANYWAY = /* @__PURE__ */ new Set([1, 9]);
-function statusBlocker(account) {
-  const status = account.account_status;
-  if (status === void 0 || status === 1) return void 0;
-  const name = ACCOUNT_STATUS[status] ?? `status ${status}`;
-  const reason = account.disable_reason ? DISABLE_REASON[account.disable_reason] : void 0;
-  const why = reason ? ` (${reason})` : "";
-  if (DELIVERS_ANYWAY.has(status)) {
-    return `the ad account is ${name}${why}: a payment failed and Meta stops delivery when the grace period ends \u2014 the account owner settles it in Meta Billing`;
-  }
-  return `the ad account is ${name}${why}, so nothing on it delivers \u2014 only the account owner can resolve that with Meta (Account Quality / Billing)`;
-}
-function metaAccountDeliveryBlockers(account) {
-  const blockers = [];
-  const status = statusBlocker(account);
-  if (status) blockers.push(status);
-  const hasFunding = Boolean(account.funding_source || account.funding_source_details?.id);
-  if (!hasFunding && !account.is_prepay_account) {
-    blockers.push(
-      "the ad account has no payment method, so Meta accepts its ads but delivers none (they wait in PENDING_BILLING_INFO) \u2014 the account owner adds one in Meta Billing"
-    );
-  }
-  if (spendCapReached(account)) {
-    blockers.push(
-      "the ad account has reached its spending limit, so Meta stops delivering every ad on it \u2014 an admin raises or removes the limit in Meta Billing \u2192 Payment settings, or Baker can change it as part of a chat"
-    );
-  }
-  return blockers;
-}
-function spendCapReached(account) {
-  const cap = Number(account.spend_cap ?? "0");
-  const spent = Number(account.amount_spent ?? "0");
-  return Number.isFinite(cap) && Number.isFinite(spent) && cap > 0 && spent >= cap;
-}
-
-// src/commands/ads/meta/account.ts
-import { defineCommand } from "citty";
-var accountCommand = defineCommand({
-  meta: {
-    name: "account",
-    description: `Show single Meta ad account detail (currency, timezone, balance, business) and whether it can deliver:
-a hint names a disabled account or a missing payment method, which Meta never refuses at publish \u2014 its ads just never run.
-\`bakerPermissions\` says which per-company Meta permissions (leadAds, catalog, pagePosts) are switched on for this
-company and held by the connection; a hint names any that still needs the user to reconnect Meta.
-
-Examples:
-  baker ads meta account --account-id act_123
-  BAKER_META_AD_ACCOUNT_ID=act_123 baker ads meta account`
-  },
-  args: {
-    "account-id": { type: "string", description: "Meta ad account ID (act_...)" },
-    "no-cache": NO_CACHE_ARG
-  },
-  run: async ({ args }) => {
-    const accountId = resolveAccountIdArg(args);
-    try {
-      const params = { "account-id": accountId };
-      if (args["no-cache"]) params["skip-cache"] = "true";
-      const data = await apiGet("/api/ads/meta/account", params);
-      const permissionHints = data.bakerPermissions ? accountPermissionHints(data.bakerPermissions) : [];
-      writeJsonEnvelope({ ok: true, data, hints: [...accountDeliveryHints(data), ...permissionHints] });
-    } catch (err) {
-      handleMetaError(err);
-    }
-  }
-});
-function accountDeliveryHints(account) {
-  const blockers = metaAccountDeliveryBlockers(account);
-  if (blockers.length === 0) return ["The account can deliver: it is active and has a payment method."];
-  return [
-    ...blockers.map((blocker) => `Cannot deliver: ${blocker}.`),
-    "Staging still works and publishing still applies the changes, but nothing serves until this is fixed \u2014 tell the user before they publish anything they expect to run."
-  ];
-}
-var PERMISSION_LABEL = {
-  leadAds: "Lead ads (instant forms and their leads)",
-  catalog: "Catalog changes",
-  pagePosts: "Facebook Page posts"
-};
-function accountPermissionHints(permissions) {
-  return Object.keys(PERMISSION_LABEL).filter((key) => permissions[key].reconnectNeeded).map(
-    (key) => `${PERMISSION_LABEL[key]}: switched on for this company, but this Meta connection predates it \u2014 ask the user to reconnect Meta in the dashboard before relying on it.`
-  );
-}
-export {
-  accountCommand,
-  accountDeliveryHints,
-  accountPermissionHints
-};
-//# sourceMappingURL=account-RKULYCBU.js.map

package/dist/account-RKULYCBU.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../api/src/ads-meta/accountHealth.ts","../src/commands/ads/meta/account.ts"],"sourcesContent":["/**\n * Whether a Meta ad account can deliver at all — read off the account node.\n *\n * Meta stages and publishes ads on an account that cannot pay or is disabled\n * without a word: the docs say an account with no funding source can \"still\n * create ads but these ads will get no delivery\", and they sit in\n * PENDING_BILLING_INFO. Nothing in the publish answer says so, so the only\n * place to catch it is a read of the account before something goes live.\n */\n\n/** The account fields this reads (all in `ACCOUNT_FIELDS`). */\nexport interface MetaAccountHealthFields {\n  account_status?: number;\n  disable_reason?: number;\n  funding_source?: string;\n  funding_source_details?: { id?: string; display_string?: string; type?: number } | null;\n  is_prepay_account?: boolean;\n  /** Minor units as a string; \"0\" is no limit. */\n  spend_cap?: string;\n  amount_spent?: string;\n  /** What the person whose connection Baker uses may do on the account (MANAGE, ADVERTISE, ANALYZE, DRAFT). */\n  user_tasks?: string[];\n}\n\n/** `account_status` values, from the Ad Account reference (v25.0). 1 is the only one that delivers. */\nconst ACCOUNT_STATUS: Readonly<Record<number, string>> = {\n  1: \"ACTIVE\",\n  2: \"DISABLED\",\n  3: \"UNSETTLED\",\n  7: \"PENDING_RISK_REVIEW\",\n  8: \"PENDING_SETTLEMENT\",\n  9: \"IN_GRACE_PERIOD\",\n  100: \"PENDING_CLOSURE\",\n  101: \"CLOSED\",\n  201: \"ANY_ACTIVE\",\n  202: \"ANY_CLOSED\",\n};\n\n/** Why an account is disabled, when it is (`disable_reason`). */\nconst DISABLE_REASON: Readonly<Record<number, string>> = {\n  1: \"ads integrity policy\",\n  2: \"ads IP review\",\n  3: \"payment risk\",\n  4: \"gray account shut down\",\n  5: \"ads AFC review\",\n  6: \"business integrity review\",\n  7: \"permanently closed\",\n  8: \"unused reseller account\",\n  9: \"unused account\",\n  10: \"umbrella ad account\",\n  11: \"Business Manager integrity policy\",\n  12: \"misrepresented ad account\",\n  13: \"legal entity de-share\",\n  14: \"thread review\",\n  15: \"compromised ad account\",\n};\n\n/**\n * In grace period, Meta still delivers while a failed payment is retried, so\n * it is a warning that delivery is about to stop rather than a stop.\n */\nconst DELIVERS_ANYWAY = new Set([1, 9]);\n\nfunction statusBlocker(account: MetaAccountHealthFields): string | undefined {\n  const status = account.account_status;\n  if (status === undefined || status === 1) return undefined;\n  const name = ACCOUNT_STATUS[status] ?? `status ${status}`;\n  const reason = account.disable_reason ? DISABLE_REASON[account.disable_reason] : undefined;\n  const why = reason ? ` (${reason})` : \"\";\n  if (DELIVERS_ANYWAY.has(status)) {\n    return `the ad account is ${name}${why}: a payment failed and Meta stops delivery when the grace period ends — the account owner settles it in Meta Billing`;\n  }\n  return `the ad account is ${name}${why}, so nothing on it delivers — only the account owner can resolve that with Meta (Account Quality / Billing)`;\n}\n\n/**\n * Plain reasons this account will not deliver, empty when it can. Each names\n * who can fix it, since nothing Baker stages can.\n */\nexport function metaAccountDeliveryBlockers(account: MetaAccountHealthFields): string[] {\n  const blockers: string[] = [];\n  const status = statusBlocker(account);\n  if (status) blockers.push(status);\n  const hasFunding = Boolean(account.funding_source || account.funding_source_details?.id);\n  if (!hasFunding && !account.is_prepay_account) {\n    blockers.push(\n      \"the ad account has no payment method, so Meta accepts its ads but delivers none (they wait in PENDING_BILLING_INFO) — the account owner adds one in Meta Billing\",\n    );\n  }\n  if (spendCapReached(account)) {\n    blockers.push(\n      \"the ad account has reached its spending limit, so Meta stops delivering every ad on it — an admin raises or removes the limit in Meta Billing → Payment settings, or Baker can change it as part of a chat\",\n    );\n  }\n  return blockers;\n}\n\n/** `spend_cap` \"0\" (or absent) is no limit; a limit reached stops all delivery until it is raised. */\nfunction spendCapReached(account: MetaAccountHealthFields): boolean {\n  const cap = Number(account.spend_cap ?? \"0\");\n  const spent = Number(account.amount_spent ?? \"0\");\n  return Number.isFinite(cap) && Number.isFinite(spent) && cap > 0 && spent >= cap;\n}\n\n/** Statuses on which Meta takes no new ads or edits: only the account owner and Meta can change them. */\nconst REFUSES_WRITES = new Set([2, 101]);\n\n/** Where an account owner reads why Meta restricted an account and asks for a review. */\nexport const META_ACCOUNT_QUALITY_URL = \"https://www.facebook.com/accountquality\";\n\n/**\n * Why Meta will refuse this change on this account at publish, or `undefined`.\n *\n * Only explicit evidence refuses: an account whose status is missing from the\n * read says nothing. A `removal` (a delete, a pause) is let through, because it\n * takes nothing live and is what someone cleaning up a disabled account does.\n */\nexport function metaAccountWriteRefusal(\n  account: MetaAccountHealthFields,\n  change: \"change\" | \"removal\",\n): string | undefined {\n  return accessRefusal(account.user_tasks) ?? statusRefusal(account, change);\n}\n\n/** Tasks that let a person publish changes on an ad account; ANALYZE and DRAFT do not. */\nconst PUBLISHING_TASKS = new Set([\"MANAGE\", \"ADVERTISE\"]);\n\nfunction accessRefusal(tasks: readonly string[] | undefined): string | undefined {\n  if (!tasks || tasks.length === 0 || tasks.some((task) => PUBLISHING_TASKS.has(task))) return undefined;\n  return 'the person who connected Meta to Baker can only view this ad account, so Meta refuses every change Baker would publish on it — an admin of the ad account gives them the \"Manage campaigns\" permission in Meta Business settings → Ad accounts (https://business.facebook.com/settings/ad-accounts), then this can be staged again';\n}\n\nfunction statusRefusal(account: MetaAccountHealthFields, change: \"change\" | \"removal\"): string | undefined {\n  const status = account.account_status;\n  if (status === undefined || !REFUSES_WRITES.has(status) || change === \"removal\") return undefined;\n  const reason = account.disable_reason ? DISABLE_REASON[account.disable_reason] : undefined;\n  const why = reason ? ` (${reason})` : \"\";\n  return `the ad account is ${ACCOUNT_STATUS[status]}${why}, so Meta refuses new ads and edits on it — only the account owner can resolve that with Meta, in Account Quality (${META_ACCOUNT_QUALITY_URL}); nothing can be staged here until then`;\n}\n","import { type MetaAccountHealthFields, metaAccountDeliveryBlockers } from \"@baker/api/ads-meta/accountHealth\";\nimport type { MetaPermissionStates } from \"@baker/api/ads-meta/permissionGates\";\nimport { defineCommand } from \"citty\";\nimport { NO_CACHE_ARG } from \"../../../cache-flag.ts\";\nimport { apiGet } from \"../../../client.ts\";\nimport { writeJsonEnvelope } from \"../output.ts\";\nimport { handleMetaError, resolveAccountIdArg } from \"./shared.ts\";\n\nexport const accountCommand = defineCommand({\n  meta: {\n    name: \"account\",\n    description: `Show single Meta ad account detail (currency, timezone, balance, business) and whether it can deliver:\na hint names a disabled account or a missing payment method, which Meta never refuses at publish — its ads just never run.\n\\`bakerPermissions\\` says which per-company Meta permissions (leadAds, catalog, pagePosts) are switched on for this\ncompany and held by the connection; a hint names any that still needs the user to reconnect Meta.\n\nExamples:\n  baker ads meta account --account-id act_123\n  BAKER_META_AD_ACCOUNT_ID=act_123 baker ads meta account`,\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"Meta ad account ID (act_...)\" },\n    \"no-cache\": NO_CACHE_ARG,\n  },\n  run: async ({ args }) => {\n    const accountId = resolveAccountIdArg(args);\n    try {\n      const params: Record<string, string> = { \"account-id\": accountId };\n      if (args[\"no-cache\"]) params[\"skip-cache\"] = \"true\";\n      const data = await apiGet<\n        Record<string, unknown> & MetaAccountHealthFields & { bakerPermissions?: MetaPermissionStates }\n      >(\"/api/ads/meta/account\", params);\n      const permissionHints = data.bakerPermissions ? accountPermissionHints(data.bakerPermissions) : [];\n      writeJsonEnvelope({ ok: true, data, hints: [...accountDeliveryHints(data), ...permissionHints] });\n    } catch (err) {\n      handleMetaError(err);\n    }\n  },\n});\n\n/** Whether ads on this account can run at all, said once, in the words staging warns with. */\nexport function accountDeliveryHints(account: MetaAccountHealthFields): string[] {\n  const blockers = metaAccountDeliveryBlockers(account);\n  if (blockers.length === 0) return [\"The account can deliver: it is active and has a payment method.\"];\n  return [\n    ...blockers.map((blocker) => `Cannot deliver: ${blocker}.`),\n    \"Staging still works and publishing still applies the changes, but nothing serves until this is fixed — tell the user before they publish anything they expect to run.\",\n  ];\n}\n\nconst PERMISSION_LABEL: Record<keyof MetaPermissionStates, string> = {\n  leadAds: \"Lead ads (instant forms and their leads)\",\n  catalog: \"Catalog changes\",\n  pagePosts: \"Facebook Page posts\",\n};\n\n/** One hint per permission switched on for this company that the current Meta connection does not hold yet. */\nexport function accountPermissionHints(permissions: MetaPermissionStates): string[] {\n  return (Object.keys(PERMISSION_LABEL) as (keyof MetaPermissionStates)[])\n    .filter((key) => permissions[key].reconnectNeeded)\n    .map(\n      (key) =>\n        `${PERMISSION_LABEL[key]}: switched on for this company, but this Meta connection predates it — ask the user to reconnect Meta in the dashboard before relying on it.`,\n    );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAyBA,IAAM,iBAAmD;AAAA,EACvD,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AACP;AAGA,IAAM,iBAAmD;AAAA,EACvD,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AACN;AAMA,IAAM,kBAAkB,oBAAI,IAAI,CAAC,GAAG,CAAC,CAAC;AAEtC,SAAS,cAAc,SAAsD;AAC3E,QAAM,SAAS,QAAQ;AACvB,MAAI,WAAW,UAAa,WAAW,EAAG,QAAO;AACjD,QAAM,OAAO,eAAe,MAAM,KAAK,UAAU,MAAM;AACvD,QAAM,SAAS,QAAQ,iBAAiB,eAAe,QAAQ,cAAc,IAAI;AACjF,QAAM,MAAM,SAAS,KAAK,MAAM,MAAM;AACtC,MAAI,gBAAgB,IAAI,MAAM,GAAG;AAC/B,WAAO,qBAAqB,IAAI,GAAG,GAAG;AAAA,EACxC;AACA,SAAO,qBAAqB,IAAI,GAAG,GAAG;AACxC;AAMO,SAAS,4BAA4B,SAA4C;AACtF,QAAM,WAAqB,CAAC;AAC5B,QAAM,SAAS,cAAc,OAAO;AACpC,MAAI,OAAQ,UAAS,KAAK,MAAM;AAChC,QAAM,aAAa,QAAQ,QAAQ,kBAAkB,QAAQ,wBAAwB,EAAE;AACvF,MAAI,CAAC,cAAc,CAAC,QAAQ,mBAAmB;AAC7C,aAAS;AAAA,MACP;AAAA,IACF;AAAA,EACF;AACA,MAAI,gBAAgB,OAAO,GAAG;AAC5B,aAAS;AAAA,MACP;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAGA,SAAS,gBAAgB,SAA2C;AAClE,QAAM,MAAM,OAAO,QAAQ,aAAa,GAAG;AAC3C,QAAM,QAAQ,OAAO,QAAQ,gBAAgB,GAAG;AAChD,SAAO,OAAO,SAAS,GAAG,KAAK,OAAO,SAAS,KAAK,KAAK,MAAM,KAAK,SAAS;AAC/E;;;ACpGA,SAAS,qBAAqB;AAMvB,IAAM,iBAAiB,cAAc;AAAA,EAC1C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQf;AAAA,EACA,MAAM;AAAA,IACJ,cAAc,EAAE,MAAM,UAAU,aAAa,+BAA+B;AAAA,IAC5E,YAAY;AAAA,EACd;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,YAAY,oBAAoB,IAAI;AAC1C,QAAI;AACF,YAAM,SAAiC,EAAE,cAAc,UAAU;AACjE,UAAI,KAAK,UAAU,EAAG,QAAO,YAAY,IAAI;AAC7C,YAAM,OAAO,MAAM,OAEjB,yBAAyB,MAAM;AACjC,YAAM,kBAAkB,KAAK,mBAAmB,uBAAuB,KAAK,gBAAgB,IAAI,CAAC;AACjG,wBAAkB,EAAE,IAAI,MAAM,MAAM,OAAO,CAAC,GAAG,qBAAqB,IAAI,GAAG,GAAG,eAAe,EAAE,CAAC;AAAA,IAClG,SAAS,KAAK;AACZ,sBAAgB,GAAG;AAAA,IACrB;AAAA,EACF;AACF,CAAC;AAGM,SAAS,qBAAqB,SAA4C;AAC/E,QAAM,WAAW,4BAA4B,OAAO;AACpD,MAAI,SAAS,WAAW,EAAG,QAAO,CAAC,iEAAiE;AACpG,SAAO;AAAA,IACL,GAAG,SAAS,IAAI,CAAC,YAAY,mBAAmB,OAAO,GAAG;AAAA,IAC1D;AAAA,EACF;AACF;AAEA,IAAM,mBAA+D;AAAA,EACnE,SAAS;AAAA,EACT,SAAS;AAAA,EACT,WAAW;AACb;AAGO,SAAS,uBAAuB,aAA6C;AAClF,SAAQ,OAAO,KAAK,gBAAgB,EACjC,OAAO,CAAC,QAAQ,YAAY,GAAG,EAAE,eAAe,EAChD;AAAA,IACC,CAAC,QACC,GAAG,iBAAiB,GAAG,CAAC;AAAA,EAC5B;AACJ;","names":[]}

package/dist/account-ZKJFX2GK.js

@@ -1,80 +0,0 @@
-import {
-  csvOrJson,
-  handleLinkedinError,
-  resolveAccountIdArg
-} from "./chunk-2YTBPRRG.js";
-import {
-  writeAdsJson,
-  writeAdsOutput
-} from "./chunk-2VIZ4UUZ.js";
-import {
-  NO_CACHE_ARG
-} from "./chunk-U6RONIJC.js";
-import "./chunk-O37VU7FG.js";
-import "./chunk-CAZGM2NX.js";
-import "./chunk-NZS3KEQ2.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-XQIOCIDO.js";
-import "./chunk-WTJSMYY2.js";
-import {
-  apiGet
-} from "./chunk-6YLNY6CK.js";
-import "./chunk-D5NEIESR.js";
-import "./chunk-57KKVDDR.js";
-import "./chunk-QANGHND7.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/ads/linkedin/account.ts
-import { defineCommand } from "citty";
-var accountDetailCommand = defineCommand({
-  meta: {
-    name: "detail",
-    description: `Single LinkedIn ad account detail (currency, status, type).
-
-Examples:
-  baker ads linkedin account --account-id 503001492
-  baker ads linkedin account --account-urn urn:li:sponsoredAccount:503001492 --output md`
-  },
-  args: {
-    "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
-    "account-urn": { type: "string", description: "Alias for --account-id" },
-    "no-cache": NO_CACHE_ARG,
-    output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
-  },
-  run: async ({ args }) => {
-    const accountId = resolveAccountIdArg(args);
-    try {
-      const params = { "account-id": accountId };
-      if (args["no-cache"]) params["skip-cache"] = "true";
-      const data = await apiGet("/api/ads/linkedin/account", params);
-      const fmt = csvOrJson(args);
-      if (fmt !== "json") {
-        writeAdsOutput([data], fmt);
-        return;
-      }
-      writeAdsJson({ ok: true, data });
-    } catch (err) {
-      handleLinkedinError(err);
-    }
-  }
-});
-var accountCommand = defineCommand({
-  meta: {
-    name: "account",
-    description: `LinkedIn ad account: its detail, and the settings that apply across every ad set in it.
-
-Examples:
-  baker ads linkedin account --account-id 503001492                          \u2014 currency, status, type
-  baker ads linkedin account url-params --param utm_source=linkedin          \u2014 UTMs for every ad in the account`
-  },
-  subCommands: {
-    detail: accountDetailCommand,
-    "url-params": () => import("./write-commands-N74CDMQM.js").then((m) => m.accountUrlParamsCommand)
-  },
-  args: accountDetailCommand.args,
-  default: "detail"
-});
-export {
-  accountCommand
-};
-//# sourceMappingURL=account-ZKJFX2GK.js.map