@koda-sl/baker-cli 0.513.0 → 0.514.0-dev.555f7007e

package/README.md

@@ -1412,7 +1412,7 @@ baker ads meta labels detach <label> --campaigns 6123
 baker ads meta labels rename <label> --name …  /  labels delete <label>
 ```
 
-A customer list's file is read in the workspace: every value is normalized and SHA-256 hashed on the machine running the CLI (Meta's normalization: emails lowercased, phones with their country code, names without punctuation, a US zip's first five digits, a birthday as year/month/day); only the hashes are uploaded, in batches of 10,000 (at most 20 per change — 200,000 people), and held by Baker until publish; only counts are printed. A US state is sent as its two-letter code; slashed birthdays are read in the order the file shows, else refused until `--date-format DMY|MDY`; a value-based list reads `1,250.00` and `1.250,00` alike and leaves out a person without a value. The whole change is checked before the first batch uploads, and batches no draft needs are deleted after a day. A replace runs alone — Meta refuses it while the list still processes an earlier upload — and one that fails part-way is closed at once and reported as a half-replaced list; publishing it again waits while Meta still processes it. A lookalike needs `--ratio` and a country, and its seed must already hold people (not a list this chat creates). Label changes stage the object's whole label set (Meta replaces it), read against the labels it has now and applied at publish to the labels it has then. Deletes run last at publish, child before parent, and staging refuses a delete that would strand something live the draft does not also handle.
+A customer list's file is read in the workspace: every value is normalized and SHA-256 hashed on the machine running the CLI (Meta's normalization: emails lowercased, phones with their country code, names without punctuation, a US zip's first five digits, a birthday as year/month/day); only the hashes are uploaded, each person with a masked copy for the review in Baker (`l***@empresa.com`, `***222`), in batches of 10,000 (at most 20 per change — 200,000 people), and held by Baker until publish; only counts are printed. A US state is sent as its two-letter code; slashed birthdays are read in the order the file shows, else refused until `--date-format DMY|MDY`; a value-based list reads `1,250.00` and `1.250,00` alike and leaves out a person without a value. The whole change is checked before the first batch uploads, and batches no draft needs are deleted after a day. A replace runs alone — Meta refuses it while the list still processes an earlier upload — and one that fails part-way is closed at once and reported as a half-replaced list; publishing it again waits while Meta still processes it. A lookalike needs `--ratio` and a country, and its seed must already hold people (not a list this chat creates). Label changes stage the object's whole label set (Meta replaces it), read against the labels it has now and applied at publish to the labels it has then. Deletes run last at publish, child before parent, and staging refuses a delete that would strand something live the draft does not also handle.
 
 `copy <id>` on `campaigns`/`adsets`/`ads` stages Meta's own copy (`POST /{id}/copies`), which keeps everything Meta holds: `--deep` (a campaign's ad sets and ads, an ad set's ads; at most 51 ads), `--to-campaign` / `--to-adset <id|meta_temp_*>`, `--status PAUSED|ACTIVE|INHERITED` (default PAUSED), `--rename top|deep|none`, `--rename-prefix`, `--rename-suffix`, and `--start`/`--end` for the copied ad sets. The copy's `meta_temp_*` ref resolves to its new id at publish, so `adsets update <copy ref> …` in the same chat changes the copy once Meta has made it. A deep copy runs as an asynchronous Meta job the publish waits on.
 
@@ -1662,7 +1662,7 @@ baker ads linkedin account url-params --param "utm_source=linkedin&utm_medium=pa
 baker ads linkedin campaigns update 123456 --audience-expansion off --lan off
 baker ads linkedin campaigns update 123456 --bid 7.50 --daily-budget 100 --currency USD
 
-# Matched audiences (CSV with header; email columns SHA-256 hashed locally).
+# Matched audiences (CSV with header; email columns SHA-256 hashed locally, with a masked copy for the review).
 # Company lists take companyName, domain and the LinkedIn page (linkedinCompanyPageUrl, LinkedIn's own template, or organizationUrn) — the page matches the company exactly
 baker ads linkedin audiences create --name "ABM Tier-1" --type company-list --list-file accounts.csv
 
@@ -1993,6 +1993,23 @@ baker site unstage consent                         # take back one staged settin
 
 `set` takes several flags in one call and stages all of them or none. A staged setting that cannot apply at publish — a home page whose landing is not published yet, a domain another company registered in the meantime — is skipped with its reason on the chat's row and in `baker chats view` → `effects.siteSettings`; everything else in the chat still publishes.
 
+### Ad lead forms (`baker lead-routes`)
+
+Send the leads an ad platform's own lead form collects — a Meta Instant Form, a LinkedIn Lead Gen Form, a Google Ads lead form — to a Google Sheet, a HubSpot form, a webhook, Zapier, an email, Pipedrive, GoHighLevel or ActiveCampaign. One route is one form to one destination. Staged on the chat; from publish, Baker reads the form every five minutes and delivers each new lead once.
+
+```bash
+baker lead-routes list                                                   # live routes (status, delivered, last lead, last problem) + this chat's staged ones
+baker lead-routes fields --platform meta --form <id>                     # the form's questions, as --field names
+baker lead-routes preview --platform meta --form <id> --to hubspotForm   # what the latest leads would send (masked unless --full)
+baker lead-routes set --platform meta --form <id> --to googleSpreadsheet --new-sheet "Meta leads"
+baker lead-routes set --platform linkedin --account <id> --form <id> --to hubspotForm --hubspot-form <id> --field email=email
+baker lead-routes set --platform google --account <customer id> --form <asset id> --to email --email sales@acme.com
+baker lead-routes remove r1                                              # stop at publish
+baker lead-routes unstage r2                                             # take back a staged change (or --all)
+```
+
+`--field <destination key>=<lead field>` is repeatable; without it the destination's defaults apply (a new sheet's standard columns, a HubSpot form's contact fields, the whole lead for a webhook, Zapier or email). `--since YYYY-MM-DD` also sends the leads since that day, at most 30 days back.
+
 ### Google Analytics 4 (`baker ga4`)
 
 GA4 commands for multi-channel audits **and** for configuring what the property measures. Playbook-aligned report presets, property health audits, free-form Data API queries, and staged Admin API writes.

package/dist/account-QX4G4BJ7.js

@@ -0,0 +1,82 @@
+import {
+  csvOrJson,
+  handleLinkedinError,
+  resolveAccountIdArg
+} from "./chunk-BJOK7QD4.js";
+import {
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-ZRP7Y2DM.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-AGBBTTKA.js";
+import "./chunk-NZ34KM46.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-MUS2UTWU.js";
+import {
+  apiGet
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import "./chunk-Q7US4OOA.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-NVCX7IAU.js").then((m) => m.accountUrlParamsCommand)
+  },
+  args: accountDetailCommand.args,
+  default: "detail"
+});
+export {
+  accountCommand
+};
+//# sourceMappingURL=account-QX4G4BJ7.js.map

package/dist/account-QX4G4BJ7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/linkedin/account.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { NO_CACHE_ARG } from \"../../../cache-flag.ts\";\nimport { apiGet } from \"../../../client.ts\";\nimport { writeAdsJson, writeAdsOutput } from \"../output.ts\";\nimport { csvOrJson, handleLinkedinError, resolveAccountIdArg } from \"./shared.ts\";\n\ninterface LinkedinAccountInfo {\n  externalId: string;\n  urn: string;\n  name: string;\n  status: string;\n  type: string;\n  currency?: string;\n  test?: boolean;\n}\n\nconst accountDetailCommand = defineCommand({\n  meta: {\n    name: \"detail\",\n    description: `Single LinkedIn ad account detail (currency, status, type).\n\nExamples:\n  baker ads linkedin account --account-id 503001492\n  baker ads linkedin account --account-urn urn:li:sponsoredAccount:503001492 --output md`,\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"Numeric account ID or urn:li:sponsoredAccount:N\" },\n    \"account-urn\": { type: \"string\", description: \"Alias for --account-id\" },\n    \"no-cache\": NO_CACHE_ARG,\n    output: { type: \"string\", description: \"json|csv|jsonl|md\", default: \"json\" },\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<LinkedinAccountInfo>(\"/api/ads/linkedin/account\", params);\n      const fmt = csvOrJson(args);\n      if (fmt !== \"json\") {\n        writeAdsOutput([data] as unknown as Array<Record<string, unknown>>, fmt);\n        return;\n      }\n      writeAdsJson({ ok: true, data });\n    } catch (err) {\n      handleLinkedinError(err);\n    }\n  },\n});\n\n/**\n * Account-level settings, with the detail read as the default so\n * `baker ads linkedin account --account-id N` keeps working unchanged. A parent\n * must never declare `run` — citty falls through to it after the matched\n * subcommand, which would fire a live account read on every `url-params` stage.\n */\nexport const accountCommand = defineCommand({\n  meta: {\n    name: \"account\",\n    description: `LinkedIn ad account: its detail, and the settings that apply across every ad set in it.\n\nExamples:\n  baker ads linkedin account --account-id 503001492                          — currency, status, type\n  baker ads linkedin account url-params --param utm_source=linkedin          — UTMs for every ad in the account`,\n  },\n  subCommands: {\n    detail: accountDetailCommand,\n    \"url-params\": () => import(\"./write-commands.ts\").then((m) => m.accountUrlParamsCommand),\n  },\n  args: accountDetailCommand.args,\n  default: \"detail\",\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAgB9B,IAAM,uBAAuB,cAAc;AAAA,EACzC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA,EAKf;AAAA,EACA,MAAM;AAAA,IACJ,cAAc,EAAE,MAAM,UAAU,aAAa,kDAAkD;AAAA,IAC/F,eAAe,EAAE,MAAM,UAAU,aAAa,yBAAyB;AAAA,IACvE,YAAY;AAAA,IACZ,QAAQ,EAAE,MAAM,UAAU,aAAa,qBAAqB,SAAS,OAAO;AAAA,EAC9E;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,OAA4B,6BAA6B,MAAM;AAClF,YAAM,MAAM,UAAU,IAAI;AAC1B,UAAI,QAAQ,QAAQ;AAClB,uBAAe,CAAC,IAAI,GAAgD,GAAG;AACvE;AAAA,MACF;AACA,mBAAa,EAAE,IAAI,MAAM,KAAK,CAAC;AAAA,IACjC,SAAS,KAAK;AACZ,0BAAoB,GAAG;AAAA,IACzB;AAAA,EACF;AACF,CAAC;AAQM,IAAM,iBAAiB,cAAc;AAAA,EAC1C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA,EAKf;AAAA,EACA,aAAa;AAAA,IACX,QAAQ;AAAA,IACR,cAAc,MAAM,OAAO,8BAAqB,EAAE,KAAK,CAAC,MAAM,EAAE,uBAAuB;AAAA,EACzF;AAAA,EACA,MAAM,qBAAqB;AAAA,EAC3B,SAAS;AACX,CAAC;","names":[]}

package/dist/account-UFYZS3K6.js

@@ -0,0 +1,82 @@
+import {
+  CHATGPT_ADS_REFERENCE,
+  runChatgptRead
+} from "./chunk-EW7JSTRZ.js";
+import "./chunk-ZRP7Y2DM.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import {
+  apiGet
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.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-QAQXRIEY.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-UFYZS3K6.js.map

package/dist/account-UFYZS3K6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/chatgpt/account.ts"],"sourcesContent":["import type { ChatgptAdsAccount } from \"@baker/api/ads-chatgpt\";\nimport { defineCommand } from \"citty\";\nimport { apiGet } from \"../../../client.ts\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { CHATGPT_ADS_REFERENCE, runChatgptRead } from \"./shared.ts\";\n\nregisterSchema({\n  command: \"ads.chatgpt.account\",\n  description:\n    \"The connected ChatGPT Ads account: name, currency, timezone, status, and the brand and account reviews that decide whether anything in it can serve.\",\n  args: {\n    full: { type: \"boolean\", description: \"Return ChatGPT Ads' own account object\", required: false },\n  },\n});\n\n/** Reviews gate the whole account; say so before anyone tunes a bid under one. */\nexport function accountHints(account: ChatgptAdsAccount): string[] {\n  const hints: string[] = [];\n  if (account.brandReview.status !== \"approved\") {\n    const reason = account.brandReview.reason ? ` (${account.brandReview.reason})` : \"\";\n    hints.push(\n      `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.`,\n    );\n  }\n  if (account.accountReview && account.accountReview.status !== \"approved\") {\n    hints.push(`A separate account review is ${account.accountReview.status}; delivery can wait on it too.`);\n  }\n  if (account.status === \"paused\") {\n    hints.push(\"The whole account is paused, so no campaign in it serves whatever its own status says.\");\n  }\n  return hints;\n}\n\nconst SHOW_ARGS = {\n  full: { type: \"boolean\", description: \"Return ChatGPT Ads' own account object\", required: false },\n} as const;\n\nconst accountShowCommand = defineCommand({\n  meta: {\n    name: \"show\",\n    description: \"The connected ChatGPT Ads account. Example: baker ads chatgpt account\",\n  },\n  args: SHOW_ARGS,\n  run: async ({ args }) => {\n    await runChatgptRead(\n      CHATGPT_ADS_REFERENCE.account,\n      () => apiGet<ChatgptAdsAccount>(\"/api/ads/chatgpt/account\", args.full ? { full: \"true\" } : undefined),\n      (account) => (args.full ? [] : accountHints(account)),\n    );\n  },\n});\n\nexport const accountCommand = defineCommand({\n  meta: {\n    name: \"account\",\n    description: `The connected ChatGPT Ads account. Start here: currency and timezone for every figure, and whether reviews let anything serve.\n\nExamples:\n  baker ads chatgpt account\n  baker ads chatgpt account --full\n  baker ads chatgpt account update --favicon-url https://example.com/icon.png   — staged; applies on publish`,\n  },\n  subCommands: {\n    show: accountShowCommand,\n    update: () => import(\"./account-writes.ts\").then((m) => m.accountUpdateCommand),\n  },\n  // A parent must never declare `run`: citty falls through to it after the matched subcommand.\n  args: SHOW_ARGS,\n  default: \"show\",\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;AACA,SAAS,qBAAqB;AAK9B,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,MAAM,EAAE,MAAM,WAAW,aAAa,0CAA0C,UAAU,MAAM;AAAA,EAClG;AACF,CAAC;AAGM,SAAS,aAAa,SAAsC;AACjE,QAAM,QAAkB,CAAC;AACzB,MAAI,QAAQ,YAAY,WAAW,YAAY;AAC7C,UAAM,SAAS,QAAQ,YAAY,SAAS,KAAK,QAAQ,YAAY,MAAM,MAAM;AACjF,UAAM;AAAA,MACJ,mBAAmB,QAAQ,YAAY,MAAM,GAAG,MAAM;AAAA,IACxD;AAAA,EACF;AACA,MAAI,QAAQ,iBAAiB,QAAQ,cAAc,WAAW,YAAY;AACxE,UAAM,KAAK,gCAAgC,QAAQ,cAAc,MAAM,gCAAgC;AAAA,EACzG;AACA,MAAI,QAAQ,WAAW,UAAU;AAC/B,UAAM,KAAK,wFAAwF;AAAA,EACrG;AACA,SAAO;AACT;AAEA,IAAM,YAAY;AAAA,EAChB,MAAM,EAAE,MAAM,WAAW,aAAa,0CAA0C,UAAU,MAAM;AAClG;AAEA,IAAM,qBAAqB,cAAc;AAAA,EACvC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AAAA,EACA,MAAM;AAAA,EACN,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM;AAAA,MACJ,sBAAsB;AAAA,MACtB,MAAM,OAA0B,4BAA4B,KAAK,OAAO,EAAE,MAAM,OAAO,IAAI,MAAS;AAAA,MACpG,CAAC,YAAa,KAAK,OAAO,CAAC,IAAI,aAAa,OAAO;AAAA,IACrD;AAAA,EACF;AACF,CAAC;AAEM,IAAM,iBAAiB,cAAc;AAAA,EAC1C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMf;AAAA,EACA,aAAa;AAAA,IACX,MAAM;AAAA,IACN,QAAQ,MAAM,OAAO,8BAAqB,EAAE,KAAK,CAAC,MAAM,EAAE,oBAAoB;AAAA,EAChF;AAAA;AAAA,EAEA,MAAM;AAAA,EACN,SAAS;AACX,CAAC;","names":[]}

package/dist/account-assets-J5Z4URLQ.js

@@ -0,0 +1,290 @@
+import {
+  csvOrJson,
+  handleMetaError,
+  resolveAccountIdArg
+} from "./chunk-B2POVFR2.js";
+import "./chunk-Y2JZX6JB.js";
+import {
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-ZRP7Y2DM.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-AGBBTTKA.js";
+import {
+  apiGet
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/account-assets.ts
+import { defineCommand } from "citty";
+function emit(rows, args, hints) {
+  const fmt = csvOrJson(args);
+  if (fmt !== "json") {
+    writeAdsOutput(rows, fmt, void 0, hints);
+    return;
+  }
+  writeJsonEnvelope(hints.length > 0 ? { ok: true, data: rows, hints } : { ok: true, data: rows });
+}
+async function read(path, params, args) {
+  if (args["no-cache"]) params["skip-cache"] = "true";
+  return await apiGet(path, params);
+}
+var outputArg = { type: "string", description: "json|csv|jsonl|md", default: "json" };
+var accountArg = { type: "string", description: "Meta ad account ID (act_...)" };
+var schemaAccount = { type: "string", description: "Meta ad account ID (act_123)", required: false };
+var schemaNoCache = { type: "boolean", description: "Bypass the cache", required: false };
+var schemaOutput = { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" };
+function instagramIdentityHints(rows) {
+  if (rows.length === 0) {
+    return [
+      "No Instagram account is linked to this ad account or its Pages. A creative without --instagram-user cannot run in Instagram feeds, Stories or Reels \u2014 the account owner links one in Meta Business settings (Accounts \u2192 Instagram accounts) and assigns it to the ad account."
+    ];
+  }
+  const listed = rows.filter((row) => row.sources.includes("ad_account") || row.sources.includes("connected"));
+  const hints = ["Pass the id as `creatives create --instagram-user <id>`."];
+  if (listed.length > 0 && listed.length < rows.length) {
+    hints.push(
+      `Use one listed on the ad account (${listed.map((row) => row.username ?? row.id).join(", ")}): when the account lists any, staging refuses an identity it does not list.`
+    );
+  } else if (listed.length === 0) {
+    hints.push(
+      "Only Page identities are listed (page = the Page's linked Instagram account, page_backed = an Instagram presence Meta made for a Page with none). Meta accepts either as --instagram-user; a page_backed one shows the Page's name and picture on Instagram."
+    );
+  }
+  if (new Set(rows.map((row) => row.pageId).filter(Boolean)).size > 1) {
+    hints.push("Several Pages are involved \u2014 use the identity of the Page the creative runs from (--page).");
+  }
+  return hints;
+}
+registerSchema({
+  command: "ads.meta.instagram-accounts",
+  description: "The Instagram accounts an ad on this account can run as \u2014 the id `creatives create --instagram-user` takes. Lists accounts assigned or connected to the ad account and each promotable Page's linked or page-backed one.",
+  args: {
+    "account-id": schemaAccount,
+    "no-cache": schemaNoCache,
+    output: { type: "string", description: "json|csv", required: false, default: "json" }
+  }
+});
+var instagramAccountsCommand = defineCommand({
+  meta: {
+    name: "instagram-accounts",
+    description: "Instagram identities an ad can run as (the --instagram-user id). Start here before creatives create: baker ads meta instagram-accounts --account-id act_123"
+  },
+  args: { "account-id": accountArg, "no-cache": NO_CACHE_ARG, output: outputArg },
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    try {
+      const rows = await read(
+        "/api/ads/meta/instagram-accounts",
+        { "account-id": accountId },
+        args
+      );
+      emit(
+        rows.map((row) => ({ ...row, sources: row.sources.join(",") })),
+        args,
+        instagramIdentityHints(rows)
+      );
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+registerSchema({
+  command: "ads.meta.apps",
+  description: "The apps this ad account can promote (app installs / app engagement), with their store URLs \u2014 the application_id and object_store_url an app ad set's promoted_object takes.",
+  args: { "account-id": schemaAccount, "no-cache": schemaNoCache, output: schemaOutput }
+});
+var appsCommand = defineCommand({
+  meta: {
+    name: "apps",
+    description: "Apps the ad account can promote, for an app ad set's promoted_object. Example: baker ads meta apps --account-id act_123"
+  },
+  args: { "account-id": accountArg, "no-cache": NO_CACHE_ARG, output: outputArg },
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    try {
+      const rows = await read(
+        "/api/ads/meta/apps",
+        { "account-id": accountId },
+        args
+      );
+      emit(
+        rows.map((row) => ({ ...row })),
+        args,
+        rows.length > 0 ? [
+          'An app ad set promotes one: promoted_object {"application_id":"<id>","object_store_url":"<store url>"}. Use a real store URL (itunes / google_play); fb_canvas and instant_game are not app stores.'
+        ] : [
+          "No promotable apps. The app has to be registered in Meta for Developers and its owner has to add this ad account under the app's Advanced settings \u2192 Advertising accounts."
+        ]
+      );
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+registerSchema({
+  command: "ads.meta.dsa-recommendations",
+  description: "Names Meta suggests for the EU Digital Services Act disclosure (who benefits from and who pays for an ad) on this account.",
+  args: { "account-id": schemaAccount, "no-cache": schemaNoCache }
+});
+var dsaRecommendationsCommand = defineCommand({
+  meta: {
+    name: "dsa-recommendations",
+    description: "Meta's suggested DSA beneficiary/payor names for EU ad sets. Example: baker ads meta dsa-recommendations --account-id act_123"
+  },
+  args: { "account-id": accountArg, "no-cache": NO_CACHE_ARG },
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    try {
+      const names = await read("/api/ads/meta/dsa-recommendations", { "account-id": accountId }, args);
+      writeJsonEnvelope({
+        ok: true,
+        data: names,
+        hints: [
+          "An ad set reaching the EU needs dsa_beneficiary and dsa_payor. Baker fills both with the business name when they are missing; pass one of these instead when the user names someone else (an agency paying for a client)."
+        ]
+      });
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+function compactImage(row) {
+  return {
+    hash: row.hash,
+    name: row.name,
+    width: row.width,
+    height: row.height,
+    status: row.status,
+    created_time: row.created_time
+  };
+}
+registerSchema({
+  command: "ads.meta.images",
+  description: "The ad account's image library \u2014 each image_hash a creative can reuse without uploading again. --hash looks one up.",
+  args: {
+    "account-id": schemaAccount,
+    hash: { type: "string", description: "One image hash", required: false },
+    limit: { type: "string", description: "Max rows (default 500)", required: false },
+    full: { type: "boolean", description: "URLs, permalink and which creatives use it", required: false },
+    "no-cache": schemaNoCache,
+    output: schemaOutput
+  }
+});
+var imagesCommand = defineCommand({
+  meta: {
+    name: "images",
+    description: "Image library of the ad account (image hashes). Example: baker ads meta images --account-id act_123 --limit 20; --hash <hash> for one"
+  },
+  args: {
+    "account-id": accountArg,
+    hash: { type: "string", description: "Look up one image hash" },
+    limit: { type: "string", description: "Max rows (default 500)" },
+    full: { type: "boolean", description: "Every field: url, permalink_url, creatives" },
+    "no-cache": NO_CACHE_ARG,
+    output: outputArg
+  },
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    const params = { "account-id": accountId };
+    if (args.hash) params.hash = args.hash;
+    if (args.limit) params.limit = args.limit;
+    try {
+      const rows = await read("/api/ads/meta/images", params, args);
+      emit(args.full ? rows : rows.map(compactImage), args, [
+        "A creative reuses one with its hash (the `image_hash` of a creative file). To push a Baker-library image, stage `media upload` instead."
+      ]);
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+registerSchema({
+  command: "ads.meta.labels",
+  description: "Ad labels defined on the account (Meta's tags for campaigns, ad sets, ads and creatives).",
+  args: { "account-id": schemaAccount, "no-cache": schemaNoCache, output: schemaOutput }
+});
+var labelsListArgs = { "account-id": accountArg, "no-cache": NO_CACHE_ARG, output: outputArg };
+var labelsCommand = defineCommand({
+  meta: {
+    name: "labels",
+    description: `Ad labels on the account (list), or stage label writes: create, rename, delete, attach (file campaigns/ad sets/ads/creatives under one), detach.
+  baker ads meta labels --account-id act_123
+  baker ads meta labels create --name "Q4 launch"
+  baker ads meta labels attach <labelId|meta_temp_\u2026> --campaigns 6123,6124 --ads 6125`
+  },
+  subCommands: {
+    list: () => labelsListCommand,
+    create: () => import("./asset-writes-JLVUAVUZ.js").then((m) => m.labelsCreateCommand),
+    rename: () => import("./asset-writes-JLVUAVUZ.js").then((m) => m.labelsRenameCommand),
+    delete: () => import("./asset-writes-JLVUAVUZ.js").then((m) => m.labelsDeleteCommand),
+    attach: () => import("./asset-writes-JLVUAVUZ.js").then((m) => m.labelsAttachCommand),
+    detach: () => import("./asset-writes-JLVUAVUZ.js").then((m) => m.labelsDetachCommand)
+  },
+  args: labelsListArgs,
+  default: "list"
+});
+var labelsListCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "Ad labels on the account. Runs by default. Example: baker ads meta labels --account-id act_123"
+  },
+  args: labelsListArgs,
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    try {
+      const rows = await read("/api/ads/meta/labels", { "account-id": accountId }, args);
+      emit(rows, args, rows.length === 0 ? ["This account has no ad labels."] : []);
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+registerSchema({
+  command: "ads.meta.high-demand-periods",
+  description: "The budget boosts (high-demand periods) set on a campaign or ad set: when each runs and by how much.",
+  args: {
+    "campaign-id": { type: "string", description: "Campaign or ad set ID", required: true },
+    "no-cache": schemaNoCache,
+    output: schemaOutput
+  }
+});
+var highDemandPeriodsCommand = defineCommand({
+  meta: {
+    name: "high-demand-periods",
+    description: "Budget boosts on a campaign or ad set. Example: baker ads meta high-demand-periods --campaign-id 6123 (stage new ones with --budget-boost on campaigns or adsets create|update)"
+  },
+  args: {
+    "campaign-id": { type: "string", description: "Campaign (or ad set) ID", required: true },
+    "no-cache": NO_CACHE_ARG,
+    output: outputArg
+  },
+  run: async ({ args }) => {
+    try {
+      const rows = await read(
+        "/api/ads/meta/high-demand-periods",
+        { "campaign-id": args["campaign-id"] },
+        args
+      );
+      emit(rows, args, rows.length === 0 ? ["No budget boosts on this campaign."] : []);
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+export {
+  appsCommand,
+  dsaRecommendationsCommand,
+  highDemandPeriodsCommand,
+  imagesCommand,
+  instagramAccountsCommand,
+  instagramIdentityHints,
+  labelsCommand
+};
+//# sourceMappingURL=account-assets-J5Z4URLQ.js.map