@koda-sl/baker-cli 0.489.0 → 0.490.0

package/dist/instant-experiences-NQ2GWIWL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/meta/instant-experiences.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { apiGet } from \"../../../client.ts\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { writeAdsOutput, writeJsonEnvelope } from \"../output.ts\";\nimport { csvOrJson, handleMetaError } from \"./shared.ts\";\nimport {\n  bareAccountId,\n  failWriteValidation,\n  loadJsonFileArg,\n  mergePayload,\n  requireTarget,\n  stageOp,\n} from \"./write-shared.ts\";\n\n/**\n * Instant Experiences — the full-screen page an ad opens on the phone (Meta's\n * API calls them canvases). Reading lists a Page's experiences; creating and\n * publishing stage on this chat's draft and happen at publish. Meta deletes\n * none and changes only an unpublished one, so a published experience stays\n * in the Page's library as it was made.\n */\n\nconst STAGED_NOTE = \"Staged until publish — review with `baker ads meta draft`.\";\n\ntype Args = Record<string, unknown>;\n\n/** The element flags, in the order they appear on the command line — that order is the experience's. */\nconst ELEMENT_FLAGS = [\"text\", \"button\", \"photo-id\", \"video-id\", \"video-ref\", \"product-set-id\", \"footer\"] as const;\n\nfunction linkPair(flag: string, value: string): { text: string; url: string } {\n  const [text, ...rest] = value.split(\"=>\");\n  const url = rest.join(\"=>\").trim();\n  if (!text?.trim() || !url) {\n    failWriteValidation(`--${flag} takes \"Button text => https://…\" — got \"${value}\"`);\n  }\n  return { text: text.trim(), url };\n}\n\nfunction elementFor(flag: (typeof ELEMENT_FLAGS)[number], value: string): Record<string, unknown> {\n  switch (flag) {\n    case \"text\":\n      return { type: \"text\", text: value };\n    case \"button\":\n      return { type: \"button\", ...linkPair(flag, value) };\n    case \"footer\":\n      return { type: \"footer\", ...linkPair(flag, value) };\n    case \"photo-id\":\n      return { type: \"photo\", photo_id: value };\n    case \"video-id\":\n      return { type: \"video\", video_id: value };\n    case \"video-ref\":\n      return { type: \"video\", videoRef: value };\n    default:\n      return { type: \"product_set\", product_set_id: value };\n  }\n}\n\n/** A command-line token as an element flag and its inline value (`--text=Hello`), if it is one. */\nfunction elementFlagOf(arg: string): { flag: (typeof ELEMENT_FLAGS)[number]; inline?: string } | undefined {\n  if (!arg.startsWith(\"--\")) return undefined;\n  const eq = arg.indexOf(\"=\");\n  const name = eq === -1 ? arg.slice(2) : arg.slice(2, eq);\n  const flag = ELEMENT_FLAGS.find((candidate) => candidate === name);\n  if (!flag) return undefined;\n  return eq === -1 ? { flag } : { flag, inline: arg.slice(eq + 1) };\n}\n\n/** Every element flag, repeatable, read from the command line in order (citty keeps only a flag's last value). */\nexport function canvasElementsFromRawArgs(rawArgs: readonly string[]): Record<string, unknown>[] {\n  const elements: Record<string, unknown>[] = [];\n  const end = rawArgs.indexOf(\"--\");\n  const args = end === -1 ? rawArgs : rawArgs.slice(0, end);\n  for (let i = 0; i < args.length; i++) {\n    const found = elementFlagOf(args[i] ?? \"\");\n    if (!found) continue;\n    const value = found.inline ?? args[++i];\n    if (value === undefined || value.startsWith(\"--\")) failWriteValidation(`--${found.flag} needs a value`);\n    elements.push(elementFor(found.flag, value));\n  }\n  return elements;\n}\n\n// --- List ---\n\nregisterSchema({\n  command: \"ads.meta.instant-experiences\",\n  description:\n    \"A Facebook Page's Instant Experiences — the full-screen pages an ad can open (creatives create --type instant_experience --canvas-id). Shows whether each is published: an ad opens only a published one.\",\n  args: {\n    \"page-id\": { type: \"string\", description: \"Facebook Page id (baker ads meta pages)\", required: true },\n    output: { type: \"string\", description: \"json|csv|jsonl|md\", required: false, default: \"json\" },\n  },\n});\n\nconst listCommand = defineCommand({\n  meta: {\n    name: \"list\",\n    description:\n      \"A Page's Instant Experiences, published or not. Runs by default. Example: baker ads meta instant-experiences --page-id 904238019441800\",\n  },\n  args: {\n    \"page-id\": { type: \"string\", description: \"Facebook Page id — from `baker ads meta pages`\" },\n    output: { type: \"string\", description: \"json|csv|jsonl|md\", default: \"json\" },\n  },\n  run: async ({ args }) => {\n    if (!args[\"page-id\"]) failWriteValidation(\"pass --page-id (from `baker ads meta pages`)\");\n    try {\n      const rows = await apiGet<Record<string, unknown>[]>(\"/api/ads/meta/instant-experiences\", {\n        \"page-id\": String(args[\"page-id\"]),\n      });\n      const hints =\n        rows.length === 0\n          ? [\"This Page has no Instant Experiences. Stage one with `baker ads meta instant-experiences create`.\"]\n          : [\n              \"An ad opens only a published experience (is_published true): `creatives create --type instant_experience --canvas-id <id>`. A published one cannot be changed or deleted.\",\n            ];\n      const fmt = csvOrJson(args);\n      if (fmt !== \"json\") {\n        writeAdsOutput(rows, fmt, undefined, hints);\n        return;\n      }\n      writeJsonEnvelope({ ok: true, data: rows, hints });\n    } catch (err) {\n      handleMetaError(err);\n    }\n  },\n});\n\n// --- Create ---\n\nregisterSchema({\n  command: \"ads.meta.instant-experiences.create\",\n  description:\n    \"Stage a new Instant Experience on a Page — its elements in command-line order — made (and published, unless --unpublished) when the chat publishes. Meta deletes no experience, so it is only ever made at publish.\",\n  args: {\n    \"account-id\": { type: \"string\", description: \"Ad account the change is staged under\", required: false },\n    \"page-id\": { type: \"string\", description: \"The Facebook Page it belongs to\", required: true },\n    name: { type: \"string\", description: \"Name in the Page's Instant Experience library\", required: true },\n    text: { type: \"string\", description: \"A paragraph, repeatable\", required: false },\n    button: { type: \"string\", description: '\"Text => https://…\", repeatable', required: false },\n    \"photo-id\": {\n      type: \"string\",\n      description: \"A photo on the Page, or meta_temp_* of a staged `page-photos upload`, repeatable\",\n      required: false,\n    },\n    \"video-id\": { type: \"string\", description: \"A video of the ad account, repeatable\", required: false },\n    \"video-ref\": { type: \"string\", description: \"meta_temp_* of a staged video upload, repeatable\", required: false },\n    \"product-set-id\": { type: \"string\", description: \"Products of a catalog's product set\", required: false },\n    footer: { type: \"string\", description: '\"Text => https://…\" pinned at the bottom (last)', required: false },\n    background: { type: \"string\", description: \"Background colour, six hex digits\", required: false },\n    unpublished: { type: \"boolean\", description: \"Leave it unpublished (no ad can open it yet)\", required: false },\n    file: { type: \"string\", description: \"JSON file with the whole payload\", required: false },\n  },\n});\n\nexport const instantExperiencesCreateCommand = defineCommand({\n  meta: {\n    name: \"create\",\n    description: `Stage a new Instant Experience (the full-screen page an ad opens). ${STAGED_NOTE}\nElements appear in the order of their flags; every element flag repeats. Published at publish unless --unpublished — an ad opens only a published one, a published one cannot be changed, and Meta deletes none.\nPictures are Page photos (--photo-id: one on the Page, or the ref of a staged \\`page-photos upload\\`; a collection's photo experience takes four); videos come from the ad account (--video-id, or --video-ref of a staged \\`media upload --kind video\\`).\nExample: baker ads meta instant-experiences create --account-id act_123 --page-id 904238019441800 --name \"Spring\" --video-id 1508023623826870 --text \"Our spring range\" --button \"Shop now => https://shop.example/spring\"\nThen: baker ads meta creatives create --type instant_experience --canvas-id meta_temp_… --page 904238019441800 --message \"Tap to explore\" --image-hash …`,\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"Numeric account ID or act_N (the account the ads run from)\" },\n    \"page-id\": { type: \"string\", description: \"The Facebook Page it belongs to — from `baker ads meta pages`\" },\n    name: { type: \"string\", description: \"Name in the Page's Instant Experience library\" },\n    text: { type: \"string\", description: \"A paragraph of text (repeatable)\" },\n    button: { type: \"string\", description: '\"Button text => https://…\" (repeatable)' },\n    \"photo-id\": {\n      type: \"string\",\n      description: \"A photo on the Page, or meta_temp_* of a staged `page-photos upload` (repeatable)\",\n    },\n    \"video-id\": { type: \"string\", description: \"A video of the ad account (repeatable)\" },\n    \"video-ref\": {\n      type: \"string\",\n      description: \"meta_temp_* ref of a staged `media upload --kind video` (repeatable)\",\n    },\n    \"product-set-id\": {\n      type: \"string\",\n      description: \"Products from a catalog's product set, also shown under the ad (collection) — repeatable\",\n    },\n    footer: { type: \"string\", description: '\"Button text => https://…\" pinned at the bottom; must be last' },\n    background: { type: \"string\", description: \"Background colour, six hex digits (e.g. FFFFFF)\" },\n    unpublished: {\n      type: \"boolean\",\n      description: \"Leave it unpublished — it can be changed, but no ad can open it yet\",\n    },\n    file: { type: \"string\", description: \"JSON file with the whole payload (page_id, name, elements[], publish)\" },\n  },\n  run: async ({ args, rawArgs }) => {\n    const accountId = bareAccountId(args as Args);\n    const elements = canvasElementsFromRawArgs(rawArgs);\n    const payload = mergePayload(loadJsonFileArg(args.file), {\n      page_id: args[\"page-id\"] === undefined ? undefined : String(args[\"page-id\"]),\n      name: args.name,\n      background_color: args.background,\n      elements: elements.length > 0 ? elements : undefined,\n      publish: args.unpublished === true ? false : undefined,\n    });\n    await stageOp({ kind: \"canvas.create\", accountId, payload }, [\n      \"An ad opens it with `creatives create --type instant_experience --canvas-id <ref>`.\",\n    ]);\n  },\n});\n\n// --- Update ---\n\nregisterSchema({\n  command: \"ads.meta.instant-experiences.update\",\n  description:\n    \"Rename or publish an UNPUBLISHED Instant Experience at publish. Meta changes nothing on a published one.\",\n  args: {\n    id: { type: \"positional\", description: \"Instant Experience id or meta_temp_* ref\", required: true },\n    \"account-id\": { type: \"string\", description: \"Ad account the change is staged under\", required: false },\n    name: { type: \"string\", description: \"New name\", required: false },\n    publish: { type: \"boolean\", description: \"Publish it so ads can open it\", required: false },\n  },\n});\n\nexport const instantExperiencesUpdateCommand = defineCommand({\n  meta: {\n    name: \"update\",\n    description: `Rename or publish an unpublished Instant Experience. ${STAGED_NOTE}\nExample: baker ads meta instant-experiences update 1788652952402490 --account-id act_123 --publish`,\n  },\n  args: {\n    id: { type: \"positional\", description: \"Instant Experience id or meta_temp_* ref\", required: true },\n    \"account-id\": { type: \"string\", description: \"Numeric account ID or act_N\" },\n    name: { type: \"string\", description: \"New name\" },\n    publish: { type: \"boolean\", description: \"Publish it, so ads can open it — it is then fixed\" },\n  },\n  run: async ({ args }) => {\n    const accountId = bareAccountId(args as Args);\n    await stageOp({\n      kind: \"canvas.update\",\n      accountId,\n      target: requireTarget(args as Args, \"Instant Experience\"),\n      payload: { name: args.name, publish: args.publish === true ? true : undefined },\n    });\n  },\n});\n\nexport const instantExperiencesCommand = defineCommand({\n  meta: {\n    name: \"instant-experiences\",\n    description: `Instant Experiences — the full-screen page an ad opens on the phone (also behind collection ads).\n  baker ads meta instant-experiences --page-id 904238019441800        — list, with whether each is published\n  baker ads meta instant-experiences create --page-id … --name … --text … --button \"Shop => https://…\"\n  baker ads meta instant-experiences update <id> --publish`,\n  },\n  subCommands: {\n    list: listCommand,\n    create: instantExperiencesCreateCommand,\n    update: instantExperiencesUpdateCommand,\n  },\n  args: { \"page-id\": { type: \"string\", description: \"Facebook Page id\" }, output: { type: \"string\", default: \"json\" } },\n  default: \"list\",\n});\n"],"mappings":"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","names":[]}

package/dist/{landing-WUILAWDS.js → landing-Y6QCTXCZ.js}

@@ -16,7 +16,7 @@ Subcommands:
   baker landing export start      \u2014 download the PUBLISHED landings as a ZIP of plain HTML ("download my landings", "send me the HTML"); \`baker landing export status <id>\` gives the link.`
   },
   subCommands: {
-    inspiration: () => import("./inspiration-XQYHBJY2.js").then((m) => m.inspirationCommand),
+    inspiration: () => import("./inspiration-IX5N724J.js").then((m) => m.inspirationCommand),
     critique: () => import("./critique-BHYJYZDV.js").then((m) => m.critiqueCommand),
     variant: () => import("./variant-5TRRSYBB.js").then((m) => m.variantCommand),
     export: () => import("./export-OLDI32HM.js").then((m) => m.exportCommand)
@@ -25,4 +25,4 @@ Subcommands:
 export {
   landingCommand
 };
-//# sourceMappingURL=landing-WUILAWDS.js.map
+//# sourceMappingURL=landing-Y6QCTXCZ.js.map

package/dist/leads-THI37ZMD.js

@@ -0,0 +1,537 @@
+import {
+  bareAccountId,
+  failWriteValidation,
+  loadJsonFileArg,
+  mergePayload,
+  requireTarget,
+  stageOp,
+  upper
+} from "./chunk-5C35OW7L.js";
+import {
+  isMetaLeadAdsRefusal
+} from "./chunk-A4MVVPJ2.js";
+import "./chunk-HLVRHBKL.js";
+import {
+  csvOrJson,
+  handleMetaError
+} from "./chunk-QTOZ32SU.js";
+import {
+  repeatedValues
+} from "./chunk-ERSX3MKH.js";
+import "./chunk-SFJW2KED.js";
+import "./chunk-4NZ47VXO.js";
+import "./chunk-D5FY4FAK.js";
+import "./chunk-FNA277HP.js";
+import {
+  writeAdsJson,
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-SWL4AAPP.js";
+import "./chunk-5WMTPYKT.js";
+import "./chunk-23H4ZJRP.js";
+import "./chunk-DWX44QL6.js";
+import "./chunk-2FSEESJU.js";
+import "./chunk-CVBKW75S.js";
+import "./chunk-BLAHHMPF.js";
+import "./chunk-XQIOCIDO.js";
+import {
+  ApiError,
+  apiGet
+} from "./chunk-XDZVBX6L.js";
+import "./chunk-N5O67GK5.js";
+import "./chunk-EE72SSB2.js";
+import {
+  registerSchema
+} from "./chunk-WNSE7N75.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/leads.ts
+import { defineCommand as defineCommand2 } from "citty";
+
+// src/commands/ads/meta/lead-form-writes.ts
+import { defineCommand } from "citty";
+var STAGED_NOTE = "Staged until publish \u2014 review with `baker ads meta draft`.";
+var str = (value) => typeof value === "string" && value.length > 0 ? value : void 0;
+function customQuestion(value) {
+  const [label = "", answers] = value.split("=>").map((part) => part.trim());
+  const options = answers?.split("|").map((answer) => answer.trim()).filter(Boolean).map((answer) => ({ value: answer }));
+  return { type: "CUSTOM", label, ...options && options.length > 0 ? { options } : {} };
+}
+function questionsFromFlags(args, rawArgs) {
+  const predefined = (str(args.questions) ?? "").split(",").map((type) => type.trim().toUpperCase()).filter(Boolean).map((type) => ({ type }));
+  const custom = repeatedValues(rawArgs, "question", args.question).map(customQuestion);
+  const all = [...predefined, ...custom];
+  return all.length > 0 ? all : void 0;
+}
+function introFromFlags(args, rawArgs) {
+  const content = repeatedValues(rawArgs, "intro-text", args["intro-text"]);
+  const set = {
+    ...str(args["intro-title"]) ? { title: str(args["intro-title"]) } : {},
+    ...content.length > 0 ? { style: content.length > 1 ? "LIST_STYLE" : "PARAGRAPH_STYLE", content } : {},
+    ...str(args["intro-button"]) ? { buttonText: str(args["intro-button"]) } : {}
+  };
+  return Object.keys(set).length > 0 ? set : void 0;
+}
+function thankYouFromFlags(args) {
+  const fields = {
+    title: str(args["thank-you-title"]),
+    body: str(args["thank-you-body"]),
+    buttonType: upper(args["thank-you-button"]),
+    buttonText: str(args["thank-you-button-text"]),
+    websiteUrl: str(args["thank-you-url"]),
+    businessPhoneNumber: str(args["thank-you-phone"]),
+    countryCode: upper(args["thank-you-country"])
+  };
+  const set = Object.fromEntries(Object.entries(fields).filter(([, value]) => value !== void 0));
+  return Object.keys(set).length > 0 ? set : void 0;
+}
+function trackingFromFlags(args, rawArgs) {
+  const pairs = repeatedValues(rawArgs, "tracking", args.tracking).map((pair) => {
+    const at = pair.indexOf("=");
+    if (at <= 0) failWriteValidation(`--tracking takes name=value, got "${pair}"`);
+    return [pair.slice(0, at).trim(), pair.slice(at + 1).trim()];
+  });
+  return pairs.length > 0 ? Object.fromEntries(pairs) : void 0;
+}
+function leadFormPayloadFromFlags(args, rawArgs) {
+  const quality = args["higher-intent"] ?? args["optimized-for-quality"];
+  return {
+    page_id: str(args["page-id"]),
+    name: str(args.name),
+    locale: upper(args.locale),
+    questionPageHeadline: str(args.headline),
+    questions: questionsFromFlags(args, rawArgs),
+    privacyPolicyUrl: str(args["privacy-policy-url"]),
+    privacyPolicyLinkText: str(args["privacy-link-text"]),
+    followUpActionUrl: str(args["follow-up-url"]),
+    optimizedForQuality: typeof quality === "boolean" ? quality : void 0,
+    intro: introFromFlags(args, rawArgs),
+    thankYou: thankYouFromFlags(args),
+    sharing: str(args.sharing)?.toLowerCase(),
+    smsVerification: args["sms-verification"] === true ? true : void 0,
+    trackingParameters: trackingFromFlags(args, rawArgs)
+  };
+}
+function formFileForStaging(raw) {
+  const data = raw.ok === true && "data" in raw ? raw.data : raw;
+  return data && typeof data === "object" && !Array.isArray(data) ? data : raw;
+}
+var SCREENS = ["intro", "thankYou"];
+function record(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
+}
+function mergeOver(base, over) {
+  const merged = mergePayload(base, over);
+  for (const screen of SCREENS) {
+    const from = record(base[screen]);
+    const to = record(over[screen]);
+    if (from && to) merged[screen] = mergePayload(from, to);
+  }
+  return merged;
+}
+function mergeDuplicateSpec(live, changes, flags) {
+  return mergeOver(mergeOver(live, changes), flags);
+}
+var FORM_FLAG_ARGS = {
+  name: { type: "string", description: "Form name \u2014 unique among the Page's forms (archived ones count)" },
+  locale: {
+    type: "string",
+    description: "Form language, e.g. EN_US, ES_LA, PT_BR, FR_FR, DE_DE (Meta's 32) \u2014 Meta words its own questions in it"
+  },
+  headline: { type: "string", description: "Headline above the questions" },
+  questions: {
+    type: "string",
+    description: "Questions Meta words itself, comma-separated: FULL_NAME,EMAIL,PHONE,WORK_EMAIL,COMPANY_NAME,JOB_TITLE,CITY,ZIP,DOB\u2026"
+  },
+  question: {
+    type: "string",
+    description: 'A custom question, repeatable: "Question?" or multiple choice "Question? => Answer | Answer"'
+  },
+  "privacy-policy-url": { type: "string", description: "Public https privacy policy (required)" },
+  "privacy-link-text": { type: "string", description: "Words of the privacy link (\u226470, default Privacy Policy)" },
+  "follow-up-url": { type: "string", description: "https link of the default View website button" },
+  "higher-intent": {
+    type: "boolean",
+    description: "Higher intent: people review their answers before submitting (default: more volume)"
+  },
+  "optimized-for-quality": { type: "boolean", description: "Same as --higher-intent" },
+  "intro-title": { type: "string", description: "Intro screen title" },
+  "intro-text": { type: "string", description: "Intro paragraph; repeat for bullet points" },
+  "intro-button": { type: "string", description: "Intro screen button text" },
+  "thank-you-title": { type: "string", description: "Thank-you screen title" },
+  "thank-you-body": { type: "string", description: "Thank-you screen text" },
+  "thank-you-button": {
+    type: "string",
+    description: "VIEW_WEBSITE|DOWNLOAD|BOOK_ON_WEBSITE|CALL_BUSINESS|WHATSAPP|P2B_MESSENGER|PROMO_CODE|NONE"
+  },
+  "thank-you-button-text": { type: "string", description: "Thank-you button text" },
+  "thank-you-url": { type: "string", description: "Website the thank-you button opens" },
+  "thank-you-phone": { type: "string", description: "CALL_BUSINESS: phone number, e.g. +14155550100" },
+  "thank-you-country": { type: "string", description: "CALL_BUSINESS: the number's country, e.g. US" },
+  sharing: { type: "string", description: "restricted (only people shown the ad, Meta's default) | open" },
+  "sms-verification": { type: "boolean", description: "Confirm the PHONE answer with a text-message code" },
+  tracking: { type: "string", description: "name=value Meta adds to every lead, repeatable" }
+};
+var SCHEMA_FORM_ARGS = Object.fromEntries(
+  Object.entries(FORM_FLAG_ARGS).map(([key, arg]) => [key, { ...arg, required: false }])
+);
+registerSchema({
+  command: "ads.meta.lead-forms.create",
+  description: "Start here to stage a Page-owned Meta Instant Form. The form is created only when this Session publishes, and it is permanent (Meta archives, never deletes). Use the returned meta_temp_* ref as --lead-form on a creative in the same Session. --file takes the whole spec (questions with keys, options, inlineContext; intro; disclaimer with checkboxes; thankYou; sharing; trackingParameters).",
+  args: {
+    "account-id": { type: "string", description: "Selected Meta ad account, act_<id>", required: true },
+    "page-id": {
+      type: "string",
+      description: "Facebook Page that owns the form \u2014 choose one with this account in promotingAccountIds and hasPageAccessToken: true from `baker ads meta pages`",
+      required: true
+    },
+    ...SCHEMA_FORM_ARGS,
+    file: {
+      type: "string",
+      description: "JSON file with the full form payload; flags override its keys",
+      required: false
+    }
+  }
+});
+var leadFormsCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage a Meta Instant Form on a Facebook Page. ${STAGED_NOTE} The form is permanent once published (archive it to retire it).
+Choose a Page with this account in promotingAccountIds and hasPageAccessToken: true from \`baker ads meta pages\`.
+Example: baker ads meta lead-forms create --account-id act_123 --page-id 456 --name "Free audit" --questions FULL_NAME,EMAIL,PHONE --question "Budget? => Under 1k | 1k+" --privacy-policy-url https://example.com/privacy --follow-up-url https://example.com
+Full spec: --file form.json (see \`baker schema ads.meta.lead-forms.create\` and the ads-meta tool doc).`
+  },
+  args: {
+    "account-id": { type: "string", description: "Selected Meta ad account" },
+    "page-id": { type: "string", description: "Facebook Page ID" },
+    ...FORM_FLAG_ARGS,
+    file: { type: "string", description: "JSON form payload; flags override file keys" }
+  },
+  run: async ({ args, rawArgs }) => {
+    const accountId = bareAccountId(args);
+    const payload = mergePayload(
+      formFileForStaging(loadJsonFileArg(args.file)),
+      leadFormPayloadFromFlags(args, rawArgs)
+    );
+    await stageOp({ kind: "leadForm.create", accountId, payload }, [
+      "An ad opens it with `creatives create --cta SIGN_UP --lead-form <ref>` into an ad set with destination ON_AD."
+    ]);
+  }
+});
+registerSchema({
+  command: "ads.meta.lead-forms.spec",
+  description: "Read a live Instant Form as the exact payload `lead-forms create --file` takes \u2014 the starting point for a changed copy. Lists what could not be carried over.",
+  args: { id: { type: "positional", description: "Instant Form id", required: true } }
+});
+var leadFormsSpecCommand = defineCommand({
+  meta: {
+    name: "spec",
+    description: `A live form as the payload \`lead-forms create --file\` / \`lead-forms duplicate --file\` take.
+Example: baker ads meta lead-forms spec 1460955752594831 > form.json`
+  },
+  args: { id: { type: "positional", description: "Instant Form id", required: true } },
+  run: async ({ args }) => {
+    try {
+      const data = await apiGet("/api/ads/meta/lead-forms/spec", { "form-id": String(args.id) });
+      writeJsonEnvelope({
+        ok: true,
+        data: data.spec,
+        ...data.notCopied.length > 0 ? { hints: [`Not carried over: ${data.notCopied.join("; ")}`] } : {}
+      });
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+registerSchema({
+  command: "ads.meta.lead-forms.duplicate",
+  description: "Stage a NEW Instant Form copied from a live one, with changes \u2014 the only way Meta lets a form change (it keeps a form's questions, texts and settings as made). --file holds the changed keys; flags override both. Point ads at the copy, then archive the original.",
+  args: {
+    id: { type: "positional", description: "Instant Form id to copy", required: true },
+    "account-id": { type: "string", description: "Selected Meta ad account, act_<id>", required: true },
+    ...SCHEMA_FORM_ARGS,
+    name: { type: "string", description: "Name of the copy \u2014 unique on the Page", required: true },
+    file: { type: "string", description: "JSON with the keys to change (same shape as create)", required: false }
+  }
+});
+var leadFormsDuplicateCommand = defineCommand({
+  meta: {
+    name: "duplicate",
+    description: `Stage a changed copy of a live Instant Form (Meta changes nothing on an existing form). ${STAGED_NOTE}
+Example: baker ads meta lead-forms duplicate 1460955752594831 --account-id act_123 --name "Free audit (ES)" --locale ES_LA
+Then point the ads at the copy (\`creatives create --lead-form <ref>\`) and \`lead-forms archive <old id>\`.`
+  },
+  args: {
+    id: { type: "positional", description: "Instant Form id to copy", required: true },
+    "account-id": { type: "string", description: "Selected Meta ad account" },
+    ...FORM_FLAG_ARGS,
+    file: { type: "string", description: "JSON with the keys to change" }
+  },
+  run: async ({ args, rawArgs }) => {
+    const accountId = bareAccountId(args);
+    if (!str(args.name)) failWriteValidation("--name is required: Meta refuses a second form with the same name");
+    let source;
+    try {
+      source = await apiGet("/api/ads/meta/lead-forms/spec", { "form-id": String(args.id) });
+    } catch (err) {
+      handleMetaError(err);
+    }
+    const flags = leadFormPayloadFromFlags(args, rawArgs);
+    const payload = mergeDuplicateSpec(source.spec, formFileForStaging(loadJsonFileArg(args.file)), flags);
+    const notCopied = source.notCopied.length > 0 ? [`Not carried over: ${source.notCopied.join("; ")}`] : [];
+    await stageOp({ kind: "leadForm.create", accountId, payload }, [
+      ...notCopied,
+      `Point the ads at the copy, then \`baker ads meta lead-forms archive ${String(args.id)}\` to retire the original.`
+    ]);
+  }
+});
+function statusCommand(name, status, description) {
+  registerSchema({
+    command: `ads.meta.lead-forms.${name}`,
+    description,
+    args: {
+      id: { type: "positional", description: "Instant Form id", required: true },
+      "account-id": { type: "string", description: "Ad account the change is staged under", required: true }
+    }
+  });
+  return defineCommand({
+    meta: {
+      name,
+      description: `${description} ${STAGED_NOTE}
+Example: baker ads meta lead-forms ${name} 1460955752594831 --account-id act_123`
+    },
+    args: {
+      id: { type: "positional", description: "Instant Form id", required: true },
+      "account-id": { type: "string", description: "Numeric account ID or act_N" }
+    },
+    run: async ({ args }) => {
+      await stageOp({
+        kind: "leadForm.update",
+        accountId: bareAccountId(args),
+        target: requireTarget(args, "Instant Form"),
+        payload: { status }
+      });
+    }
+  });
+}
+var leadFormsArchiveCommand = statusCommand(
+  "archive",
+  "ARCHIVED",
+  "Archive an Instant Form: it leaves the Page's form library and no ad can use it. Meta never deletes a form; this is how one is retired."
+);
+var leadFormsUnarchiveCommand = statusCommand(
+  "unarchive",
+  "ACTIVE",
+  "Bring an archived Instant Form back so ads can use it again."
+);
+
+// src/commands/ads/meta/leads.ts
+registerSchema({
+  command: "ads.meta.lead-forms",
+  description: "List the instant (lead) forms on a Facebook Page, with how many leads each has collected. Start here: a lead is fetched by form id. Use a Page from `baker ads meta pages` with hasPageAccessToken: true.",
+  args: {
+    "page-id": {
+      type: "string",
+      description: "Facebook Page ID \u2014 from `baker ads meta pages` with hasPageAccessToken: true",
+      required: true
+    },
+    full: { type: "boolean", description: "Include each form's questions", required: false },
+    output: { type: "string", description: "json|csv", required: false, default: "json" }
+  }
+});
+registerSchema({
+  command: "ads.meta.leads",
+  description: "Read the leads an instant form collected. Contact details (email, phone) come back masked; pass --full only when the raw values are genuinely needed, e.g. handing them to a CRM.",
+  args: {
+    "form-id": { type: "string", description: "Instant form ID \u2014 from `baker ads meta lead-forms`", required: false },
+    "ad-id": { type: "string", description: "Read the leads of one ad instead of a whole form", required: false },
+    "adset-id": { type: "string", description: "Read the leads of every ad in an ad set", required: false },
+    "campaign-id": { type: "string", description: "Read the leads of every ad in a campaign", required: false },
+    since: { type: "string", description: "Earliest submission date, YYYY-MM-DD", required: false },
+    until: { type: "string", description: "Latest submission date, YYYY-MM-DD (inclusive)", required: false },
+    limit: { type: "string", description: "Leads per page (default 100, max 500)", required: false },
+    after: {
+      type: "string",
+      description: "Cursor from a previous call's nextCursor \u2014 fetches the following page",
+      required: false
+    },
+    full: { type: "boolean", description: "Return raw contact details instead of masked ones", required: false },
+    output: { type: "string", description: "json|csv", required: false, default: "json" }
+  }
+});
+var LEAD_FORMS_CAP = 500;
+function leadFormHints(forms) {
+  if (forms.length === 0) {
+    return ["This Page has NO instant forms. Nothing to read leads from \u2014 the form has to be created first."];
+  }
+  if (forms.length >= LEAD_FORMS_CAP) {
+    return [
+      `PARTIAL LIST \u2014 this Page has at least ${LEAD_FORMS_CAP} instant forms and only the first ${LEAD_FORMS_CAP} came back. Do not describe this as every form on the Page.`
+    ];
+  }
+  const empty = forms.filter((form) => (form.leads_count ?? 0) === 0);
+  if (empty.length === forms.length) {
+    return [
+      "Every form on this Page has collected 0 leads. That is a real, readable answer \u2014 the connection works. Do not retry and do not report it as a permissions problem."
+    ];
+  }
+  return [];
+}
+function handleLeadsError(err) {
+  if (err instanceof ApiError && err.code === "FORBIDDEN" && isMetaLeadAdsRefusal(err.message)) {
+    writeAdsJson({
+      ok: false,
+      error: {
+        code: err.code,
+        message: err.message,
+        fix: { action: "reject", explanation: err.message },
+        retryable: false
+      }
+    });
+    process.exit(1);
+  }
+  handleMetaError(err);
+}
+function leadPageHints(page, full) {
+  const hints = [];
+  if (page.nextCursor) {
+    hints.push(
+      `PARTIAL PAGE \u2014 more leads exist. This is ${page.leads.length} of an unknown larger number; do NOT report it as a total. Fetch the next page with \`--after ${page.nextCursor}\` (repeat until no nextCursor), or narrow the window with --since/--until.`
+    );
+  }
+  if (!full) {
+    hints.push(
+      "Answers that give contact details (email, phone, any question asking for one) are masked. Report on them as they are; pass --full only when the raw values have to leave Baker (a CRM hand-off), and never paste them into the chat otherwise."
+    );
+  }
+  hints.push(...page.hints ?? []);
+  return hints;
+}
+var leadFormsListArgs = {
+  "page-id": { type: "string", description: "Facebook Page ID" },
+  full: { type: "boolean", description: "Include each form's questions" },
+  output: { type: "string", description: "Output format", default: "json" }
+};
+var leadFormsListCommand = defineCommand2({
+  meta: {
+    name: "list",
+    description: "List the Instant Forms on a Facebook Page, with lead counts. Choose a Page with hasPageAccessToken: true from `baker ads meta pages`. Pass --full to include questions."
+  },
+  args: leadFormsListArgs,
+  run: async ({ args }) => {
+    try {
+      const pageId = args["page-id"];
+      if (!pageId) {
+        handleLeadsError(
+          new Error(
+            "--page-id is required. Run `baker ads meta pages` and choose a Page with hasPageAccessToken: true."
+          )
+        );
+      }
+      const params = { "page-id": pageId };
+      if (args.full) params.full = "true";
+      const data = await apiGet("/api/ads/meta/lead-forms", params);
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput(data, fmt);
+        return;
+      }
+      const hints = leadFormHints(data);
+      writeJsonEnvelope(hints.length > 0 ? { ok: true, data, hints } : { ok: true, data });
+    } catch (err) {
+      handleLeadsError(err);
+    }
+  }
+});
+var leadFormsCommand = defineCommand2({
+  meta: {
+    name: "lead-forms",
+    description: `List Instant Forms on a Facebook Page, or stage a new one, a changed copy, an archive.
+A form is permanent on Meta and nothing on it changes once made: to change one, duplicate it with changes and archive the old one.
+Examples:
+  baker ads meta lead-forms --page-id 100635183117758
+  baker ads meta lead-forms --page-id 100635183117758 --full
+  baker ads meta lead-forms create --account-id act_123 --page-id 555 --file form.json
+  baker ads meta lead-forms spec 987654321                       \u2014 a live form as a create --file payload
+  baker ads meta lead-forms duplicate 987654321 --account-id act_123 --name "Free audit (ES)" --locale ES_LA
+  baker ads meta lead-forms archive 987654321 --account-id act_123`
+  },
+  args: leadFormsListArgs,
+  subCommands: {
+    list: leadFormsListCommand,
+    create: leadFormsCreateCommand,
+    spec: leadFormsSpecCommand,
+    duplicate: leadFormsDuplicateCommand,
+    archive: leadFormsArchiveCommand,
+    unarchive: leadFormsUnarchiveCommand
+  },
+  default: "list"
+});
+var leadsCommand = defineCommand2({
+  meta: {
+    name: "leads",
+    description: `Read the leads an instant form collected. Every question comes back; email and phone answers are MASKED unless you pass --full, so you can report on what a form is collecting without moving contact details around.
+
+Examples:
+  baker ads meta leads --form-id 987654321
+  baker ads meta leads --form-id 987654321 --since 2026-08-01 --until 2026-08-31
+  baker ads meta leads --ad-id 6123456789 --limit 50
+  baker ads meta leads --adset-id 6123456780 --since 2026-08-01   # every ad in the ad set (Meta has no ad set edge)
+  baker ads meta leads --form-id 987654321 --after <nextCursor>   # the next page
+  baker ads meta leads --form-id 987654321 --full            # raw contact details \u2014 only when handing leads over
+
+Results are PAGED. A response carrying \`nextCursor\` is not the whole set \u2014 follow it before reporting any total.`
+  },
+  args: {
+    "form-id": { type: "string", description: "Instant form ID (from `baker ads meta lead-forms`)" },
+    "ad-id": { type: "string", description: "Read one ad's leads instead of a whole form" },
+    "adset-id": { type: "string", description: "Read the leads of every ad in an ad set" },
+    "campaign-id": { type: "string", description: "Read the leads of every ad in a campaign" },
+    since: { type: "string", description: "Earliest submission date, YYYY-MM-DD" },
+    until: { type: "string", description: "Latest submission date, YYYY-MM-DD (inclusive)" },
+    limit: { type: "string", description: "Leads per page (default 100, max 500)" },
+    after: { type: "string", description: "Cursor from a previous call's nextCursor" },
+    full: { type: "boolean", description: "Return raw contact details instead of masked ones" },
+    output: { type: "string", description: "Output format", default: "json" }
+  },
+  run: async ({ args }) => {
+    try {
+      const params = {};
+      for (const flag of ["form-id", "ad-id", "adset-id", "campaign-id"]) {
+        const value = args[flag];
+        if (typeof value === "string" && value.length > 0) params[flag] = value;
+      }
+      if (Object.keys(params).length !== 1) {
+        handleLeadsError(
+          new Error("Pass one of --form-id (from `baker ads meta lead-forms`), --ad-id, --adset-id or --campaign-id.")
+        );
+      }
+      if (args.since) params.since = args.since;
+      if (args.until) params.until = args.until;
+      if (args.limit) params.limit = String(args.limit);
+      if (args.after) params.after = String(args.after);
+      if (args.full) params.full = "true";
+      const page = await apiGet("/api/ads/meta/leads", params);
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput(page.leads, fmt);
+        return;
+      }
+      writeJsonEnvelope({
+        ok: true,
+        data: page.leads,
+        ...page.nextCursor ? { nextCursor: page.nextCursor } : {},
+        hints: leadPageHints(page, args.full === true)
+      });
+    } catch (err) {
+      handleLeadsError(err);
+    }
+  }
+});
+export {
+  leadFormHints,
+  leadFormsCommand,
+  leadPageHints,
+  leadsCommand
+};
+//# sourceMappingURL=leads-THI37ZMD.js.map