@koda-sl/baker-cli 0.574.0-dev.19539e5a8 → 0.575.0-dev.85f21462e

package/dist/write-commands-XFYXMTXO.js

@@ -0,0 +1,1169 @@
+import {
+  adSetDeliveryArgs,
+  adSetDeliveryFromFlags,
+  boostEditArgs,
+  boostEditsFromFlags,
+  budgetBoostArg,
+  budgetBoostsFromFlags,
+  clearArg,
+  clearFromFlags
+} from "./chunk-XNUUEUJB.js";
+import {
+  bareAccountId,
+  failWriteValidation,
+  fileArg,
+  listFlag,
+  loadJsonFileArg,
+  mergePayload,
+  numberFlag,
+  parseDateFlag,
+  parseMoneyFlag,
+  refuseDeleteByUpdate,
+  repeatedListFlag,
+  requireTarget,
+  stageOp,
+  stageStatusChange,
+  upper
+} from "./chunk-WFTTF2MP.js";
+import {
+  buildCustomConversionRule
+} from "./chunk-GC5P4KWY.js";
+import {
+  VISUAL_ENHANCEMENT_FEATURES
+} from "./chunk-GDFJOCDO.js";
+import "./chunk-FCD5BPC5.js";
+import {
+  repeatedValues
+} from "./chunk-ERSX3MKH.js";
+import "./chunk-YT6YI47O.js";
+import "./chunk-4NZ47VXO.js";
+import "./chunk-D5FY4FAK.js";
+import "./chunk-HZ7QUFUW.js";
+import "./chunk-QALAJNBG.js";
+import "./chunk-VJUVTMHY.js";
+import "./chunk-T4HIFVNK.js";
+import "./chunk-CGLNCFAG.js";
+import "./chunk-E2G2USTA.js";
+import "./chunk-EFZVDV7F.js";
+import "./chunk-U3LO5TDH.js";
+import "./chunk-TJTCHTR4.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-3WOFZTGC.js";
+import "./chunk-JCFZ7ECN.js";
+import "./chunk-OFSUVUXT.js";
+import "./chunk-OMLZ35HJ.js";
+import "./chunk-NXNOXZGB.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/write-commands.ts
+import { defineCommand } from "citty";
+
+// src/commands/ads/meta/creative-flags.ts
+function parseEnroll(value) {
+  const raw = String(value).toLowerCase();
+  if (raw === "on" || raw === "true" || raw === "opt_in") return "OPT_IN";
+  if (raw === "off" || raw === "false" || raw === "opt_out") return "OPT_OUT";
+  failWriteValidation("--standard-enhancements must be on|off");
+}
+function creativeEnhancementsFromFlags(args, rawArgs) {
+  const visual = repeatedValues(rawArgs, "visual-enhancement", args["visual-enhancement"]);
+  const unknown = visual.filter((feature) => !(feature in VISUAL_ENHANCEMENT_FEATURES));
+  if (unknown.length > 0) {
+    failWriteValidation(
+      `--visual-enhancement ${unknown.join(", ")} is not a feature that changes the media \u2014 one of ${Object.keys(VISUAL_ENHANCEMENT_FEATURES).join(", ")}`
+    );
+  }
+  const standard = args["standard-enhancements"] !== void 0 ? parseEnroll(args["standard-enhancements"]) : void 0;
+  if (!standard && visual.length === 0) return void 0;
+  return {
+    ...standard ? { standardEnhancements: standard } : {},
+    ...visual.length > 0 ? { features: Object.fromEntries(visual.map((feature) => [feature, "OPT_IN"])) } : {}
+  };
+}
+function carouselFlags(args) {
+  const order = args["card-order"];
+  if (order !== void 0 && order !== "fixed" && order !== "optimized") {
+    failWriteValidation("--card-order must be fixed (the order you built) or optimized (Meta reorders)");
+  }
+  const endCard = args["end-card"];
+  return {
+    ...order !== void 0 ? { card_order: String(order) } : {},
+    ...endCard !== void 0 ? { end_card: parseEnroll(endCard) === "OPT_IN" } : {}
+  };
+}
+function welcomeMessageFromFlags(args, rawArgs) {
+  const breakers = repeatedValues(rawArgs, "ice-breaker", args["ice-breaker"]).map((entry) => {
+    const [question, ...rest] = entry.split("=>");
+    const answer = rest.join("=>").trim();
+    if (!question?.trim() || !answer) {
+      failWriteValidation(`--ice-breaker takes "Question => Answer" \u2014 got "${entry}"`);
+    }
+    return { question: question.trim(), answer };
+  });
+  if (args.greeting === void 0 && breakers.length === 0 && args.autofill === void 0) return void 0;
+  return {
+    ...args.greeting !== void 0 ? { greeting: String(args.greeting) } : {},
+    ...breakers.length > 0 ? { iceBreakers: breakers } : {},
+    ...args.autofill !== void 0 ? { autofill: String(args.autofill) } : {}
+  };
+}
+var BUTTON_OPENS = {
+  MESSAGE_PAGE: "MESSENGER",
+  WHATSAPP_MESSAGE: "WHATSAPP",
+  INSTAGRAM_MESSAGE: "INSTAGRAM_DIRECT"
+};
+function conversationAndAppCta(args) {
+  const cta = args.cta === void 0 ? void 0 : String(args.cta).toUpperCase();
+  const destination = args["app-destination"] !== void 0 ? String(args["app-destination"]).toUpperCase() : cta ? BUTTON_OPENS[cta] : void 0;
+  return {
+    ...destination ? { app_destination: destination } : {},
+    ...args["deep-link"] !== void 0 ? { app_link: String(args["deep-link"]) } : {},
+    ...args["app-id"] !== void 0 ? { application: String(args["app-id"]) } : {}
+  };
+}
+
+// src/commands/ads/meta/write-commands.ts
+var STAGED_NOTE = "Staged until publish \u2014 review with `baker ads meta draft`.";
+var accountArgs = {
+  "account-id": { type: "string", description: "Numeric account ID or act_N" }
+};
+function campaignPayloadFromFlags(args) {
+  return {
+    name: args.name,
+    objective: upper(args.objective),
+    status: upper(args.status),
+    special_ad_categories: listFlag(args["special-ad-categories"])?.map((c) => c.toUpperCase()),
+    special_ad_category_country: listFlag(args["special-ad-category-country"])?.map((c) => c.toUpperCase()),
+    buying_type: upper(args["buying-type"]),
+    bid_strategy: upper(args["bid-strategy"]),
+    dailyBudget: parseMoneyFlag(args["daily-budget"], args.currency, "--daily-budget"),
+    lifetimeBudget: parseMoneyFlag(args["lifetime-budget"], args.currency, "--lifetime-budget"),
+    spendCap: parseMoneyFlag(args["spend-cap"], args.currency, "--spend-cap"),
+    adSetBudgetSharing: args["adset-budget-sharing"] === void 0 ? void 0 : Boolean(args["adset-budget-sharing"]),
+    start_time: parseDateFlag(args.start, "--start"),
+    stop_time: parseDateFlag(args.stop, "--stop"),
+    promoted_object: args["catalog-id"] ? { product_catalog_id: String(args["catalog-id"]) } : void 0
+  };
+}
+var campaignBudgetArgs = {
+  "daily-budget": { type: "string", description: "Daily budget (Advantage campaign budget / CBO)" },
+  "lifetime-budget": { type: "string", description: "Lifetime budget" },
+  "spend-cap": { type: "string", description: "Campaign spend cap" },
+  currency: { type: "string", description: "3-letter currency (defaults to the account currency)" },
+  "bid-strategy": {
+    type: "string",
+    description: "LOWEST_COST_WITHOUT_CAP|LOWEST_COST_WITH_BID_CAP|COST_CAP|LOWEST_COST_WITH_MIN_ROAS"
+  },
+  start: { type: "string", description: "Start time (ISO date or epoch ms)" },
+  stop: { type: "string", description: "Stop time" },
+  ...budgetBoostArg
+};
+var campaignsCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage a new campaign. ${STAGED_NOTE}
+Example: baker ads meta campaigns create --name "Q3 Prospecting" --objective OUTCOME_LEADS --daily-budget 50
+Advantage+ (Meta's own "Advantage+ campaign" state) is not a setting: it follows from a campaign budget here, Advantage+ audience (targeting_automation.advantage_audience 1) and automatic placements (no placement lists) on every ad set. Read it back with \`baker ads meta campaigns --fields id,name,advantage_state_info\`.
+Black Friday boost: baker ads meta campaigns create --name "BF" --objective OUTCOME_SALES --daily-budget 50 --budget-boost 2027-11-27T00:00Z..2027-11-28T00:00Z=+100%`
+  },
+  args: {
+    ...accountArgs,
+    name: { type: "string", description: "Campaign name" },
+    objective: {
+      type: "string",
+      description: "OUTCOME_TRAFFIC|OUTCOME_ENGAGEMENT|OUTCOME_LEADS|OUTCOME_SALES|OUTCOME_AWARENESS|OUTCOME_APP_PROMOTION"
+    },
+    status: { type: "string", description: "ACTIVE|PAUSED (default PAUSED)" },
+    "special-ad-categories": { type: "string", description: "CSV: NONE|HOUSING|EMPLOYMENT|CREDIT|\u2026 (default NONE)" },
+    "special-ad-category-country": { type: "string", description: "CSV of 2-letter country codes" },
+    "buying-type": { type: "string", description: "AUCTION|RESERVED (default AUCTION)" },
+    "adset-budget-sharing": {
+      type: "boolean",
+      description: "Let ad sets lend up to 20% of their budget to each other (off unless set; ignored with a campaign budget)"
+    },
+    ...campaignBudgetArgs,
+    "catalog-id": {
+      type: "string",
+      description: "Advantage+ catalog ads: the product catalog the campaign sells from (OUTCOME_SALES) \u2014 from `baker ads meta catalogs`. Fixed at creation; each ad set then names one of its product sets with --product-set-id"
+    },
+    ...fileArg("campaign.create", "JSON file with the full payload; flags override file keys")
+  },
+  run: async ({ args, rawArgs }) => {
+    const accountId = await bareAccountId(args);
+    const payload = mergePayload(loadJsonFileArg(args.file), {
+      ...campaignPayloadFromFlags(args),
+      budgetSchedules: budgetBoostsFromFlags(args, rawArgs)
+    });
+    await stageOp({ kind: "campaign.create", accountId, payload });
+  }
+});
+var campaignsUpdateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: `Stage changes to a campaign. ${STAGED_NOTE}
+Pass a meta_temp_* ref to amend a campaign staged in this chat. Example: baker ads meta campaigns update 6123 --daily-budget 80
+Budget boosts on a live campaign need its daily budget restated in the same command (Meta reads it from the request): baker ads meta campaigns update 6123 --daily-budget 50 --budget-boost 2027-11-27T00:00Z..2027-11-28T00:00Z=+25
+A boost is ADDED to the ones the campaign has (Meta keeps them, even overlapping); take them all away with --clear boosts, or one at a time with --remove-boost / --move-boost (ids from \`baker ads meta high-demand-periods --campaign-id 6123\`): baker ads meta campaigns update 6123 --move-boost 1633135568548763=2027-11-27T06:00Z..2027-11-27T12:00Z`
+  },
+  args: {
+    id: { type: "positional", description: "Campaign id or meta_temp_* ref", required: true },
+    ...accountArgs,
+    name: { type: "string", description: "New name" },
+    status: { type: "string", description: "ACTIVE|PAUSED|ARCHIVED" },
+    ...campaignBudgetArgs,
+    clear: { type: "string", description: "boosts \u2014 take away every budget boost the campaign has now" },
+    ...boostEditArgs,
+    ...fileArg("campaign.update", "JSON file with fields to change")
+  },
+  run: async ({ args, rawArgs }) => {
+    const accountId = await bareAccountId(args);
+    const payload = mergePayload(loadJsonFileArg(args.file), {
+      name: args.name,
+      status: upper(args.status),
+      budgetSchedules: budgetBoostsFromFlags(args, rawArgs),
+      clear: clearOrFail(rawArgs, "campaign"),
+      ...boostEditsFromFlags(args, rawArgs),
+      bid_strategy: upper(args["bid-strategy"]),
+      dailyBudget: parseMoneyFlag(args["daily-budget"], args.currency, "--daily-budget"),
+      lifetimeBudget: parseMoneyFlag(args["lifetime-budget"], args.currency, "--lifetime-budget"),
+      spendCap: parseMoneyFlag(args["spend-cap"], args.currency, "--spend-cap"),
+      start_time: parseDateFlag(args.start, "--start"),
+      stop_time: parseDateFlag(args.stop, "--stop")
+    });
+    refuseDeleteByUpdate(payload, "campaigns");
+    await stageOp({
+      kind: "campaign.update",
+      accountId,
+      target: requireTarget(args, "campaign"),
+      payload
+    });
+  }
+});
+function clearOrFail(rawArgs, entity) {
+  try {
+    return clearFromFlags(rawArgs, entity);
+  } catch (err) {
+    failWriteValidation(err instanceof Error ? err.message : String(err));
+  }
+}
+function adSetPayloadFromFlags(args, rawArgs, file) {
+  const promotedObject = args["promoted-object-file"] ? loadJsonFileArg(args["promoted-object-file"]) : buildPromotedObject(args);
+  return {
+    ...adSetDeliveryFromFlags(args, rawArgs),
+    budgetSchedules: budgetBoostsFromFlags(args, rawArgs),
+    name: args.name,
+    campaign_id: args.campaign,
+    status: upper(args.status),
+    optimization_goal: upper(args["optimization-goal"]),
+    billing_event: upper(args["billing-event"]),
+    destination_type: upper(args["destination-type"]),
+    dailyBudget: parseMoneyFlag(args["daily-budget"], args.currency, "--daily-budget"),
+    lifetimeBudget: parseMoneyFlag(args["lifetime-budget"], args.currency, "--lifetime-budget"),
+    bidAmount: parseMoneyFlag(args["bid-amount"], args.currency, "--bid-amount"),
+    bid_strategy: upper(args["bid-strategy"]),
+    start_time: parseDateFlag(args.start, "--start"),
+    end_time: parseDateFlag(args.end, "--end"),
+    targeting: targetingFromFlags(args, rawArgs, targetingOf(file)),
+    rf_prediction_id: args.reservation,
+    promoted_object: promotedObject && Object.keys(promotedObject).length > 0 ? promotedObject : void 0
+  };
+}
+function targetingOf(file) {
+  const targeting = file.targeting;
+  return targeting && typeof targeting === "object" && !Array.isArray(targeting) ? targeting : void 0;
+}
+function targetingFromFlags(args, rawArgs, fileTargeting) {
+  const file = args["targeting-file"] ? loadJsonFileArg(args["targeting-file"]) : void 0;
+  const base = file ?? fileTargeting;
+  const lists = repeatedValues(rawArgs, "block-list", args["block-list"]);
+  const filters = repeatedValues(rawArgs, "content-filter", args["content-filter"]).map((value) => value.toUpperCase());
+  const categories = repeatedValues(rawArgs, "exclude-publisher-category", args["exclude-publisher-category"]).map(
+    (value) => value.toLowerCase()
+  );
+  const safety = {
+    ...lists.length > 0 ? { excluded_publisher_list_ids: lists } : {},
+    ...filters.length > 0 ? { brand_safety_content_filter_levels: filters } : {},
+    ...categories.length > 0 ? { excluded_publisher_categories: categories } : {}
+  };
+  if (Object.keys(safety).length === 0) return file;
+  return { ...base ?? {}, ...safety };
+}
+function buildPromotedObject(args) {
+  const out = {};
+  if (args["page-id"]) out.page_id = String(args["page-id"]);
+  if (args["pixel-id"]) out.pixel_id = String(args["pixel-id"]);
+  if (args["custom-event-type"]) out.custom_event_type = upper(args["custom-event-type"]);
+  if (args["custom-conversion-id"]) out.custom_conversion_id = String(args["custom-conversion-id"]);
+  if (args["product-set-id"]) out.product_set_id = String(args["product-set-id"]);
+  if (args["app-id"]) out.application_id = String(args["app-id"]);
+  if (args["app-store-url"]) out.object_store_url = String(args["app-store-url"]);
+  if (args["whatsapp-number"]) out.whatsapp_phone_number = String(args["whatsapp-number"]);
+  return out;
+}
+function customConversionRuleFromFlags(args) {
+  const urlContains = args["url-contains"];
+  const ruleFile = args["rule-file"];
+  if (urlContains && ruleFile) {
+    failWriteValidation(
+      "pass either --url-contains or --rule-file, not both \u2014 they are two ways to say the same thing"
+    );
+  }
+  if (ruleFile) {
+    return loadJsonFileArg(ruleFile);
+  }
+  if (!urlContains) {
+    failWriteValidation(
+      "a custom conversion needs a rule \u2014 pass --url-contains '/thank-you' (the common case), or --rule-file with Meta's filter JSON"
+    );
+  }
+  return buildCustomConversionRule({
+    event: args.event ? String(args.event) : void 0,
+    urlContains: String(urlContains)
+  });
+}
+var customConversionsCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage a new Custom Conversion \u2014 a pixel event narrowed by a rule, which an ad set can then optimize toward. ${STAGED_NOTE}
+Meta caps an account at 100 and its delete only archives one, so a duplicate is permanent: check \`baker ads meta custom-conversions\` first.
+Chain an ad set to it in the same chat with --custom-conversion-id meta_temp_*.
+Example: baker ads meta custom-conversions create --name "Lead formulario" --pixel-id 645971030024859 --custom-event-type LEAD --url-contains "/gracias"`
+  },
+  args: {
+    ...accountArgs,
+    name: { type: "string", description: "What the marketer will see in Events Manager and in reports" },
+    "pixel-id": { type: "string", description: "The pixel it counts from \u2014 from `baker ads meta pixels`" },
+    "custom-event-type": {
+      type: "string",
+      description: "Event category Meta files it under: LEAD|PURCHASE|COMPLETE_REGISTRATION|CONTACT|\u2026"
+    },
+    "url-contains": {
+      type: "string",
+      description: "Count the event when the URL contains this, e.g. '/gracias'. The common case."
+    },
+    event: { type: "string", description: "Pixel event the URL narrows (default PageView)" },
+    "rule-file": { type: "string", description: "JSON file with Meta's raw filter, instead of --url-contains" },
+    description: { type: "string", description: "Free-text note shown in Events Manager" },
+    value: { type: "string", description: "Default value of one conversion, when the site sends no value" }
+  },
+  run: async ({ args }) => {
+    const accountId = await bareAccountId(args);
+    await stageOp({
+      kind: "customConversion.create",
+      accountId,
+      payload: {
+        name: args.name,
+        description: args.description,
+        pixel_id: args["pixel-id"] ? String(args["pixel-id"]) : void 0,
+        custom_event_type: upper(args["custom-event-type"]),
+        rule: customConversionRuleFromFlags(args),
+        default_conversion_value: numberFlag(args.value, "--value")
+      }
+    });
+  }
+});
+var adSetWriteArgs = {
+  ...accountArgs,
+  name: { type: "string", description: "Ad set name" },
+  status: { type: "string", description: "ACTIVE|PAUSED|ARCHIVED" },
+  "optimization-goal": { type: "string", description: "LINK_CLICKS|OFFSITE_CONVERSIONS|REACH|LEAD_GENERATION|\u2026" },
+  "billing-event": { type: "string", description: "IMPRESSIONS|LINK_CLICKS|THRUPLAY|\u2026" },
+  "destination-type": { type: "string", description: "WEBSITE|APP|MESSENGER|ON_AD|WHATSAPP|\u2026" },
+  "daily-budget": { type: "string", description: "Daily budget (ABO; omit if the campaign uses CBO)" },
+  "lifetime-budget": { type: "string", description: "Lifetime budget (needs --end)" },
+  "bid-amount": { type: "string", description: "Bid amount (required for COST_CAP / bid-cap strategies)" },
+  "bid-strategy": {
+    type: "string",
+    description: "LOWEST_COST_WITHOUT_CAP (auto-bid) | LOWEST_COST_WITH_BID_CAP | COST_CAP \u2014 needs --bid-amount | LOWEST_COST_WITH_MIN_ROAS \u2014 needs --min-roas. Omit and Baker sets auto-bid (or min-ROAS when --min-roas is given); never leave it to Meta, whose default is a bid cap that then fails without an amount."
+  },
+  ...adSetDeliveryArgs,
+  currency: { type: "string", description: "3-letter currency (defaults to the account currency)" },
+  start: { type: "string", description: "Start time" },
+  end: { type: "string", description: "End time" },
+  "targeting-file": {
+    type: "string",
+    description: "JSON file with the full Meta targeting spec. Ids, never names: look them up with `baker ads meta targeting search|geo|locales` and size it with `targeting estimate`"
+  },
+  "block-list": {
+    type: "string",
+    description: "Repeatable. Keep the ad set off a publisher block list \u2014 an id from `baker ads meta block-lists` or a meta_temp_* ref. On update without --targeting-file, the rest of the live targeting is kept"
+  },
+  "content-filter": {
+    type: "string",
+    description: "Repeatable, one per family: FEED_|FACEBOOK_|AN_ + RELAXED|STANDARD|STRICT \u2014 how strict Meta's content filter next to the ad is (feeds, in-stream/Reels, Audience Network)"
+  },
+  "exclude-publisher-category": {
+    type: "string",
+    description: "Repeatable: dating|gambling (and, for Audience Network / in-stream, debated_social_issues|mature_audiences|tragedy_and_conflict)"
+  },
+  reservation: {
+    type: "string",
+    description: "Create only: a reach-and-frequency reservation this ad set is bought on (id or meta_temp_* from `reach-frequency reserve`); its campaign is --buying-type RESERVED and it takes no budget"
+  },
+  "promoted-object-file": { type: "string", description: "JSON file with the promoted_object" },
+  "page-id": {
+    type: "string",
+    description: "promoted_object.page_id shortcut (required for LEAD_GENERATION / QUALITY_LEAD / PAGE_LIKES goals)"
+  },
+  "pixel-id": { type: "string", description: "promoted_object.pixel_id shortcut" },
+  "custom-event-type": { type: "string", description: "promoted_object.custom_event_type (PURCHASE|LEAD|\u2026)" },
+  "custom-conversion-id": {
+    type: "string",
+    description: "Optimize toward a Custom Conversion \u2014 the id from `baker ads meta custom-conversions`. Use it instead of --pixel-id/--custom-event-type, not alongside: Baker reads the conversion off Meta and fills its pixel, event category and rule."
+  },
+  "product-set-id": {
+    type: "string",
+    description: "Advantage+ catalog ads: the product set this ad set shows (promoted_object.product_set_id) \u2014 from `baker ads meta catalogs --catalog-id <id>`. With OFFSITE_CONVERSIONS pass --custom-event-type (PURCHASE, ADD_TO_CART\u2026); no pixel needed"
+  },
+  "app-id": {
+    type: "string",
+    description: "App ads: the app to promote (promoted_object.application_id) \u2014 from `baker ads meta apps`; needs --app-store-url"
+  },
+  "app-store-url": {
+    type: "string",
+    description: "App ads: the app's App Store / Google Play page (promoted_object.object_store_url)"
+  },
+  "whatsapp-number": {
+    type: "string",
+    description: "Click-to-WhatsApp: the WhatsApp Business number connected to the Page (promoted_object.whatsapp_phone_number)"
+  },
+  file: { type: "string", description: "JSON file with the full payload; flags override" }
+};
+var adSetsCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage a new ad set. ${STAGED_NOTE}
+Chain to a campaign with --campaign (real id or meta_temp_* ref).
+Lead-form goals (LEAD_GENERATION, QUALITY_LEAD) and PAGE_LIKES need --page-id (the Facebook Page the leads/likes belong to).
+Conversion goals take EITHER --pixel-id + --custom-event-type (a standard event) OR --custom-conversion-id (the marketer's own conversion, from 'baker ads meta custom-conversions').
+Example: baker ads meta adsets create --campaign meta_temp_ab12 --name "US 25-54" --optimization-goal LINK_CLICKS --billing-event IMPRESSIONS --daily-budget 50 --targeting-file t.json
+Delivery controls: --min-roas (ROAS goal bidding), --frequency-cap 2/7 (REACH/THRUPLAY), --schedule "Mon-Fri 09-18" (dayparting, lifetime budget only), --pacing no_pacing (bid cap only), --daily-spend-cap/--daily-min-spend (an ad set's share of a campaign budget), --budget-boost (high-demand periods), --attribution 7d_click,1d_view, --dynamic-creative (create only).
+Example: baker ads meta adsets create --campaign 6123 --name "Reach ES" --optimization-goal REACH --billing-event IMPRESSIONS --lifetime-budget 300 --end 2027-02-01 --frequency-cap 2/7 --schedule "Mon-Fri 09-18" --targeting-file t.json`
+  },
+  args: {
+    campaign: { type: "string", description: "Parent campaign id or meta_temp_* ref" },
+    ...adSetWriteArgs,
+    ...fileArg("adSet.create", adSetWriteArgs.file.description),
+    "budget-boost": {
+      type: "string",
+      description: "Raise this ad set's daily budget for a high-demand period, repeatable (on a live ad set, `adsets update --budget-boost` adds one beside those it has): START..END=+AMOUNT or START..END=+PERCENT% (max 800%), at least 3 hours, on quarter hours, all amounts or all percentages. Needs --daily-budget. Example: --budget-boost 2027-11-27T00:00Z..2027-11-28T00:00Z=+50%"
+    },
+    "dynamic-creative": {
+      type: "boolean",
+      description: "Make this a Dynamic Creative ad set: its ONE ad runs a creativeType dynamic creative (Meta mixes the images, videos and texts). Create-only \u2014 Meta fixes it for the ad set's life."
+    },
+    "saved-audience": {
+      type: "string",
+      description: "Start from a saved audience's targeting (id from `baker ads meta audiences saved`) \u2014 copied into the ad set; instead of --targeting-file, and --block-list / --content-filter / --exclude-publisher-category join it"
+    }
+  },
+  run: async ({ args, rawArgs }) => {
+    const accountId = await bareAccountId(args);
+    const file = loadJsonFileArg(args.file);
+    const payload = mergePayload(file, adSetPayloadFromFlags(args, rawArgs, file));
+    if (args["saved-audience"]) {
+      const { savedAudienceTargeting, targetingFromSavedAudience } = await import("./audience-writes-JNVGUHGN.js");
+      const saved = await savedAudienceTargeting(accountId, String(args["saved-audience"]));
+      const merged = targetingFromSavedAudience(saved, payload.targeting);
+      if ("refusal" in merged) failWriteValidation(merged.refusal);
+      payload.targeting = merged.targeting;
+    }
+    await stageOp({ kind: "adSet.create", accountId, payload });
+  }
+});
+var adSetsUpdateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: `Stage changes to an ad set. ${STAGED_NOTE}
+Switching --optimization-goal to a lead-form goal (LEAD_GENERATION, QUALITY_LEAD) or PAGE_LIKES needs --page-id in the same change.
+Take a control away with --clear: baker ads meta adsets update 6123 --clear daily-spend-cap,schedule
+Budget boosts on a live ad set with its own daily budget: add with --budget-boost, take one away with --remove-boost, re-time one with --move-boost (ids from \`baker ads meta high-demand-periods --campaign-id <ad set id>\`).
+Example: baker ads meta adsets update 6123 --daily-budget 80`
+  },
+  args: {
+    id: { type: "positional", description: "Ad set id or meta_temp_* ref", required: true },
+    ...adSetWriteArgs,
+    ...fileArg("adSet.update", adSetWriteArgs.file.description),
+    "budget-boost": {
+      type: "string",
+      description: "Add a budget boost to this ad set (its own daily budget is raised for a high-demand period), repeatable: START..END=+AMOUNT or START..END=+PERCENT% (max 800%), at least 3 hours, on quarter hours. Sent to Meta's boost list for the ad set, so the budget need not be restated. Example: --budget-boost 2027-11-27T00:00Z..2027-11-28T00:00Z=+50%"
+    },
+    ...boostEditArgs,
+    ...clearArg
+  },
+  run: async ({ args, rawArgs }) => {
+    const accountId = await bareAccountId(args);
+    const file = loadJsonFileArg(args.file);
+    const {
+      campaign_id: _drop,
+      billing_event: _be,
+      ...payload
+    } = adSetPayloadFromFlags(args, rawArgs, file);
+    const merged = mergePayload(file, {
+      ...payload,
+      ...boostEditsFromFlags(args, rawArgs),
+      clear: clearOrFail(rawArgs, "adSet")
+    });
+    refuseDeleteByUpdate(merged, "adsets");
+    await stageOp({
+      kind: "adSet.update",
+      accountId,
+      target: requireTarget(args, "ad set"),
+      payload: merged
+    });
+  }
+});
+function creativePayloadFromFlags(args, rawArgs) {
+  const enhancements = creativeEnhancementsFromFlags(args, rawArgs);
+  return {
+    // Leave undefined when --type is omitted so a --file's creativeType survives
+    // mergePayload (any defined flag overrides the file). Defaulted after merge.
+    creativeType: args.type ? String(args.type) : void 0,
+    name: args.name,
+    page_id: args.page,
+    instagram_user_id: args["instagram-user"],
+    message: args.message,
+    link: args.link,
+    headline: args.headline,
+    description: args.description,
+    caption: args.caption,
+    call_to_action: creativeCta(args),
+    welcome_message: welcomeMessageFromFlags(args, rawArgs),
+    applink_treatment: args["applink-treatment"],
+    product_set_id: args["product-set-id"],
+    canvas_id: args["canvas-id"],
+    format: args.format,
+    imageHash: args["image-hash"],
+    imageRef: args["image-ref"],
+    videoId: args["video-id"],
+    videoRef: args["video-ref"],
+    thumbnailHash: args["thumbnail-hash"],
+    thumbnailRef: args["thumbnail-ref"],
+    url_tags: args["url-tags"],
+    shop_destination: args["shop-destination"],
+    multi_advertiser: args["multi-advertiser"],
+    partner: partnerFromFlags(args),
+    object_story_id: args["post-id"],
+    source_instagram_media_id: args["instagram-media-id"],
+    instagram_ad_code: args["ad-code"],
+    collection_thumbnails: collectionThumbnailsFromFlags(rawArgs, args["collection-thumbnail"]),
+    enhancements,
+    ...carouselFlags(args)
+  };
+}
+function collectionThumbnailsFromFlags(rawArgs, parsed) {
+  const values = repeatedValues(rawArgs, "collection-thumbnail", parsed);
+  if (values.length === 0) return void 0;
+  return values.map((value) => {
+    const [elementId = "", index] = value.split(":");
+    return index === void 0 ? { element_id: elementId } : { element_id: elementId, element_child_index: Number(index) };
+  });
+}
+function partnerFromFlags(args) {
+  const partner = {
+    facebook_page_id: args["partner-page"],
+    instagram_user_id: args["partner-instagram"],
+    ad_format: args["partner-format"]
+  };
+  return Object.values(partner).some((value) => value !== void 0) ? partner : void 0;
+}
+function ctaPatchFromFlags(args) {
+  const patch = {
+    ...args.cta ? { type: String(upper(args.cta)) } : {},
+    ...args["lead-form"] === void 0 ? {} : { lead_gen_form_id: String(args["lead-form"]) },
+    ...conversationAndAppCta(args)
+  };
+  return Object.keys(patch).length > 0 ? patch : void 0;
+}
+function creativeCta(args) {
+  const patch = ctaPatchFromFlags(args);
+  if (!patch) return void 0;
+  const opener = Object.entries({
+    MESSENGER: "MESSAGE_PAGE",
+    WHATSAPP: "WHATSAPP_MESSAGE",
+    INSTAGRAM_DIRECT: "INSTAGRAM_MESSAGE"
+  }).find(([app]) => app === patch.app_destination)?.[1];
+  return { type: opener ?? (patch.app_link || patch.application ? "INSTALL_MOBILE_APP" : "SIGN_UP"), ...patch };
+}
+function creativeContentPatch(file, args) {
+  const cta = ctaPatchFromFlags(args);
+  if (!cta) {
+    return void 0;
+  }
+  const fileContent = file.content ?? {};
+  const fileCta = fileContent.call_to_action ?? {};
+  return { ...fileContent, call_to_action: { ...fileCta, ...cta } };
+}
+var adCreativesCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage a new ad creative. ${STAGED_NOTE}
+Single-image/video via flags; carousel/dynamic via --file (creativeType carousel|dynamic).
+Click-to-message: --cta MESSAGE_PAGE|WHATSAPP_MESSAGE|INSTAGRAM_MESSAGE (opens Messenger|WhatsApp|Instagram Direct) + --greeting "Hi!" --ice-breaker "Prices? => From 99 EUR." (ad set: --destination-type MESSENGER --optimization-goal CONVERSATIONS --page-id).
+App ads: --link <App Store / Google Play URL> --cta INSTALL_MOBILE_APP|USE_MOBILE_APP --deep-link myapp://x --app-id <id> --applink-treatment deeplink_with_appstore_fallback.
+Catalog (Advantage+ catalog ads): --type catalog --product-set-id <id> --message "{{product.name}}" --headline "{{product.price}}" --link https://shop.example --format carousel|single|slideshow.
+Instant Experience / collection: --type instant_experience --canvas-id <id or meta_temp_*> --message \u2026 --image-hash \u2026 [--format collection] (build one with \`baker ads meta instant-experiences create\`).
+Reference media by --image-hash (already on Meta) or --image-ref meta_temp_* (a staged media upload).
+Example: baker ads meta creatives create --page 555 --message "Save now" --link https://x.com --headline "Best cover" --image-hash abc123\u2026 --cta SHOP_NOW`
+  },
+  args: {
+    ...accountArgs,
+    type: {
+      type: "string",
+      description: "single|carousel|dynamic|existing_post|catalog|instant_experience (default single)"
+    },
+    "product-set-id": {
+      type: "string",
+      description: "--type catalog: the product set the template shows \u2014 from `baker ads meta catalogs --catalog-id <id>`"
+    },
+    "canvas-id": {
+      type: "string",
+      description: "--type instant_experience: the Instant Experience the ad opens \u2014 an id from `baker ads meta instant-experiences --page-id <id>` (published) or the meta_temp_* ref of one this chat creates"
+    },
+    format: {
+      type: "string",
+      description: "--type catalog: carousel (default) | single (one product per ad) | slideshow. --type instant_experience: standard (default) | collection (products or photos under the ad)"
+    },
+    greeting: {
+      type: "string",
+      description: "Click-to-message: the first message the person reads when the conversation opens (\u2264300 chars)"
+    },
+    "ice-breaker": {
+      type: "string",
+      description: 'Click-to-message, repeatable (max 4): a question the person can tap and your answer \u2014 "Question => Answer"'
+    },
+    autofill: {
+      type: "string",
+      description: "Click-to-message (instead of ice breakers): a message pre-filled for the person to send"
+    },
+    "app-destination": {
+      type: "string",
+      description: "Click-to-message: MESSENGER|WHATSAPP|INSTAGRAM_DIRECT \u2014 implied by --cta MESSAGE_PAGE|WHATSAPP_MESSAGE|INSTAGRAM_MESSAGE"
+    },
+    "deep-link": {
+      type: "string",
+      description: "App ads: where the button opens inside the installed app (e.g. myapp://product/12). --link must be the App Store / Google Play page"
+    },
+    "app-id": {
+      type: "string",
+      description: "App ads: the app the button installs or opens \u2014 from `baker ads meta apps`"
+    },
+    "applink-treatment": {
+      type: "string",
+      description: "App ads: how a deep link opens \u2014 deeplink_with_web_fallback|deeplink_with_appstore_fallback|web_only|automatic"
+    },
+    name: { type: "string", description: "Creative name" },
+    page: { type: "string", description: "Facebook Page id (identity)" },
+    "instagram-user": {
+      type: "string",
+      description: "Instagram account id for IG placements \u2014 from `baker ads meta instagram-accounts`"
+    },
+    message: { type: "string", description: "Primary text" },
+    link: { type: "string", description: "Destination URL (https)" },
+    headline: { type: "string", description: "Headline" },
+    description: { type: "string", description: "Description" },
+    caption: { type: "string", description: "Display URL / caption" },
+    cta: { type: "string", description: "Call-to-action type (SHOP_NOW|LEARN_MORE|SIGN_UP|\u2026)" },
+    "lead-form": {
+      type: "string",
+      description: "Instant form id or meta_temp_* ref from `baker ads meta lead-forms create` \u2014 REQUIRED for an ad set that collects leads on the ad. With a form, --cta must be APPLY_NOW|DOWNLOAD|GET_QUOTE|LEARN_MORE|SIGN_UP|SUBSCRIBE"
+    },
+    "image-hash": { type: "string", description: "Meta ad-image hash (already uploaded)" },
+    "image-ref": { type: "string", description: "meta_temp_* ref of a staged media upload" },
+    "video-id": { type: "string", description: "Meta video id (already uploaded)" },
+    "video-ref": { type: "string", description: "meta_temp_* ref of a staged video upload" },
+    "thumbnail-hash": {
+      type: "string",
+      description: "Cover for a video ad: a picture hash already in the ad account (Meta's own frame is used when no cover is given)"
+    },
+    "thumbnail-ref": {
+      type: "string",
+      description: "Cover for a video ad: meta_temp_* ref of a staged `media upload --kind image` \u2014 how a cover picked from the library is used"
+    },
+    "url-tags": { type: "string", description: "URL tracking params (utm_source=fb&\u2026)" },
+    "shop-destination": {
+      type: "string",
+      description: "website_only keeps a shop advertiser's ad on the website (Meta's v26 default also sends it to the shop); website_and_shop asks for both"
+    },
+    "standard-enhancements": {
+      type: "string",
+      description: "Meta's suggestions to the ad's TEXT on|off \u2014 never changes the picture or video"
+    },
+    "multi-advertiser": {
+      type: "string",
+      description: "opt_out keeps the ad from being shown beside other advertisers' ads after someone engages (Meta opts every new ad IN by default); opt_in asks for it"
+    },
+    "partner-page": {
+      type: "string",
+      description: "Partnership ad: the partner's (creator's or other brand's) Facebook Page id, shown beside yours. Needs --instagram-user on the ad and the partner's approval before it runs"
+    },
+    "partner-instagram": { type: "string", description: "Partnership ad: the partner's Instagram account id" },
+    "partner-format": {
+      type: "string",
+      description: "Partnership ad: both (default \u2014 both identities) | first_only | auto (Meta picks, Instagram only)"
+    },
+    "collection-thumbnail": {
+      type: "string",
+      description: "--format collection over a photo experience, repeat 4 times: an element id of the live experience (`instant-experiences --page-id`), or <product-set element id>:<product index>"
+    },
+    "post-id": {
+      type: "string",
+      description: "--type existing_post: the Facebook post to boost, <page_id>_<post_id> \u2014 from `baker ads meta page-posts --page-id <id>`"
+    },
+    "instagram-media-id": {
+      type: "string",
+      description: "--type existing_post: the Instagram post to boost (with --page and --instagram-user) \u2014 from `baker ads meta instagram-media`"
+    },
+    "ad-code": {
+      type: "string",
+      description: "--type existing_post: a creator's partnership ad code for their Instagram post (with --page)"
+    },
+    "card-order": {
+      type: "string",
+      description: "Carousel only: fixed (default \u2014 every card, in the order built) or optimized (Meta reorders by performance and may show only the top 5)"
+    },
+    "end-card": {
+      type: "string",
+      description: "Carousel only: on adds Meta's card linking to the Page after the last card (default off)"
+    },
+    "visual-enhancement": {
+      type: "string",
+      description: "Repeatable. Let Meta change the media with this feature (e.g. image_uncrop, image_animation, music_generation) \u2014 ONLY when the user asked for it by name; every such feature is off otherwise"
+    },
+    ...fileArg("adCreative.create", "JSON file with the full creative payload (carousel cards / dynamic assets)")
+  },
+  run: async ({ args, rawArgs }) => {
+    const accountId = await bareAccountId(args);
+    const payload = mergePayload(
+      loadJsonFileArg(args.file),
+      creativePayloadFromFlags(args, rawArgs)
+    );
+    if (payload.creativeType === void 0) {
+      payload.creativeType = "single";
+    }
+    await stageOp({ kind: "adCreative.create", accountId, payload });
+  }
+});
+var adCreativesUpdateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: `Stage name/status changes to an ad creative. ${STAGED_NOTE}
+Meta creatives are immutable \u2014 to change content, stage a new creative and repoint the ad.
+Amending a staged (meta_temp_*) creative merges fields into the create. Example: baker ads meta creatives update 998 --name "Renamed"`
+  },
+  args: {
+    id: { type: "positional", description: "Creative id or meta_temp_* ref", required: true },
+    ...accountArgs,
+    name: { type: "string", description: "New name" },
+    status: { type: "string", description: "ACTIVE|PAUSED|ARCHIVED" },
+    cta: { type: "string", description: "Call-to-action type (staged creatives only)" },
+    "lead-form": {
+      type: "string",
+      description: "Instant form id the button opens (staged creatives only) \u2014 `baker ads meta lead-forms` lists them"
+    },
+    ...fileArg("adCreative.update", "JSON file with fields to change (content only merges into a staged creative)")
+  },
+  run: async ({ args }) => {
+    const accountId = await bareAccountId(args);
+    const file = loadJsonFileArg(args.file);
+    const payload = mergePayload(file, {
+      name: args.name,
+      status: upper(args.status),
+      // A creative's content is immutable on Meta, so this only ever lands on a
+      // creative still staged in this chat — which is exactly the fix path when
+      // staging an ad refuses it for naming no instant form.
+      content: creativeContentPatch(file, args)
+    });
+    if (payload.status === "DELETED") {
+      failWriteValidation(
+        "update does not delete \u2014 use `baker ads meta creatives delete <id>` if the user asked to delete it"
+      );
+    }
+    await stageOp({
+      kind: "adCreative.update",
+      accountId,
+      target: requireTarget(args, "creative"),
+      payload
+    });
+  }
+});
+var adsCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage a new ad linking an ad set to a creative. ${STAGED_NOTE}
+Example: baker ads meta ads create --name "Ad 1" --adset meta_temp_as01 --creative meta_temp_cr01`
+  },
+  args: {
+    ...accountArgs,
+    name: { type: "string", description: "Ad name" },
+    adset: { type: "string", description: "Ad set id or meta_temp_* ref" },
+    creative: { type: "string", description: "Creative id or meta_temp_* ref" },
+    status: { type: "string", description: "ACTIVE|PAUSED (default PAUSED)" },
+    "tracking-file": { type: "string", description: "JSON file with tracking_specs" },
+    "conversion-domain": {
+      type: "string",
+      description: "The website domain conversions are counted on (example.com \u2014 no www., no https://). Meta fills it from the link when left out; set it when the site and the pixel's domain differ"
+    },
+    ...fileArg("ad.create", "JSON file with the full payload")
+  },
+  run: async ({ args }) => {
+    const accountId = await bareAccountId(args);
+    const tracking = args["tracking-file"] ? loadJsonFileArg(args["tracking-file"]).tracking_specs : void 0;
+    const payload = mergePayload(loadJsonFileArg(args.file), {
+      name: args.name,
+      adset_id: args.adset,
+      creative: args.creative ? { creative_id: String(args.creative) } : void 0,
+      status: upper(args.status),
+      tracking_specs: tracking,
+      conversion_domain: args["conversion-domain"]
+    });
+    await stageOp({ kind: "ad.create", accountId, payload });
+  }
+});
+var adsUpdateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: `Stage changes to an ad (name/status, or swap its creative). ${STAGED_NOTE}
+Example: baker ads meta ads update 6123 --creative meta_temp_cr02`
+  },
+  args: {
+    id: { type: "positional", description: "Ad id or meta_temp_* ref", required: true },
+    ...accountArgs,
+    name: { type: "string", description: "New name" },
+    status: { type: "string", description: "ACTIVE|PAUSED|ARCHIVED" },
+    creative: { type: "string", description: "New creative id or meta_temp_* ref" },
+    ...fileArg("ad.update", "JSON file with fields to change")
+  },
+  run: async ({ args }) => {
+    const accountId = await bareAccountId(args);
+    const payload = mergePayload(loadJsonFileArg(args.file), {
+      name: args.name,
+      status: upper(args.status),
+      creative: args.creative ? { creative_id: String(args.creative) } : void 0
+    });
+    refuseDeleteByUpdate(payload, "ads");
+    await stageOp({
+      kind: "ad.update",
+      accountId,
+      target: requireTarget(args, "ad"),
+      payload
+    });
+  }
+});
+var adsRetagCommand = defineCommand({
+  meta: {
+    name: "retag",
+    description: `Stage new URL tracking parameters on a LIVE ad \u2014 the fix for a wrong utm_medium, a missing ad id, or any tag already running. ${STAGED_NOTE}
+Start here when a report attributes paid traffic to the wrong channel: --set rewrites only the keys you name and leaves the rest of the string alone.
+Baker clones the ad's own creative behind the scenes, so every button, text variant and enhancement is carried across exactly as Meta holds them \u2014 nothing is retyped.
+Example: baker ads meta ads retag 120252158038400247 --set "utm_medium=paid-social&utm_placement={{placement}}"
+Example: baker ads meta ads retag 120252158038400247 --url-tags "utm_source={{site_source_name}}&utm_medium=paid-social&ad_id={{ad.id}}"`
+  },
+  args: {
+    id: { type: "positional", description: "Ad id (a live ad \u2014 not a meta_temp_* ref)", required: true },
+    ...accountArgs,
+    "url-tags": { type: "string", description: "Replace the WHOLE tracking string" },
+    set: {
+      type: "string",
+      description: 'Rewrite only these keys, keeping the rest: "utm_medium=paid-social&ad_id={{ad.id}}" (repeatable: --set a=1 --set b=2)'
+    }
+  },
+  run: async ({ args, rawArgs }) => {
+    const { apiPost } = await import("./client-DKZM6XTS.js");
+    const { requireChatId } = await import("./env-AMOXYHCA.js");
+    const { writeJsonEnvelope } = await import("./output-W5J5RKRR.js");
+    const { handleMetaError } = await import("./shared-P5UDXZAG.js");
+    try {
+      const accountId = await bareAccountId(args);
+      const urlTags = typeof args["url-tags"] === "string" ? args["url-tags"] : void 0;
+      const setRaw = typeof args.set === "string" ? args.set : void 0;
+      if (urlTags === void 0 === (setRaw === void 0)) {
+        failWriteValidation("pass either --url-tags (the whole string) or --set (the keys to change), not both");
+      }
+      const response = await apiPost("/api/ads/meta/draft/retag", {
+        chatId: requireChatId(),
+        accountId,
+        adId: requireTarget(args, "ad"),
+        urlTags,
+        set: setRaw === void 0 ? void 0 : retagSetPairs(rawArgs, setRaw)
+      });
+      writeJsonEnvelope(response);
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+function retagSetPairs(rawArgs, parsed) {
+  return parseSetPairs(repeatedValues(rawArgs, "set", parsed).join("&"));
+}
+function parseSetPairs(raw) {
+  const pairs = {};
+  for (const part of raw.replace(/^[?&]+/, "").split("&")) {
+    if (part.length === 0) continue;
+    const eq = part.indexOf("=");
+    if (eq <= 0) {
+      failWriteValidation(`--set expects key=value pairs joined by & \u2014 could not read "${part}"`);
+    }
+    pairs[part.slice(0, eq)] = part.slice(eq + 1);
+  }
+  if (Object.keys(pairs).length === 0) {
+    failWriteValidation("--set needs at least one key=value pair");
+  }
+  return pairs;
+}
+var audiencesCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage a new custom audience. ${STAGED_NOTE}
+Inline customer list: --subtype CUSTOM --file with "members": [{"email","phone","country"}] (up to 2,000 people, hashed before storage, uploaded after creation at Publish).
+Customer list: --subtype CUSTOM --customer-file-source USER_PROVIDED_ONLY, then put people in it with \`audiences members add <ref> --file list.csv\` (hashed on this machine). --value-based for a list where each person carries a value (needs the account's value-based terms).
+Lookalike: --subtype LOOKALIKE --lookalike-of <seed audience> --ratio 0.02 --country ES (or --countries ES,PT; --starting-ratio 0.01 for the 1%\u20132% band). The seed needs 100+ people in those countries. Or seed it from the people who converted in live campaigns: --lookalike-of-conversions <campaign or ad set id,\u2026>.
+WEBSITE/ENGAGEMENT: the rule via --file. A rule carries its own window in retention_seconds, so --retention-days is refused next to one, and one audience covers one kind of event source (a Page and an Instagram profile are two audiences).
+Example: baker ads meta audiences create --name "Site visitors 30d" --subtype WEBSITE --file rule.json
+Example: baker ads meta audiences create --name "Customers" --subtype CUSTOM --customer-file-source USER_PROVIDED_ONLY`
+  },
+  args: {
+    ...accountArgs,
+    name: { type: "string", description: "Audience name" },
+    subtype: { type: "string", description: "CUSTOM|WEBSITE|ENGAGEMENT|LOOKALIKE" },
+    description: { type: "string", description: "Description" },
+    "retention-days": {
+      type: "string",
+      description: "Retention window in days \u2014 customer-file audiences only; a rule carries its own retention_seconds"
+    },
+    "customer-file-source": {
+      type: "string",
+      description: "Customer list: where its people came from \u2014 USER_PROVIDED_ONLY (collected from customers directly) | PARTNER_PROVIDED_ONLY | BOTH_USER_AND_PARTNER_PROVIDED"
+    },
+    "value-based": {
+      type: "boolean",
+      description: "Customer list where each person carries a value (LOOKALIKE_VALUE column)"
+    },
+    "lookalike-of": {
+      type: "string",
+      description: "Lookalike: the seed audience id (a live audience \u2014 one this chat creates cannot be a seed yet)"
+    },
+    "lookalike-of-conversions": {
+      type: "string",
+      description: "Lookalike seeded from the people who converted in live campaigns or ad sets (ids, comma-separated or repeated) instead of an audience. Meta wants 100+ conversions in the lookalike's countries."
+    },
+    ratio: { type: "string", description: "Lookalike size: 0.01\u20130.20 of the country, in 0.01 steps" },
+    "starting-ratio": {
+      type: "string",
+      description: "Lookalike band start, below --ratio (0.01 with --ratio 0.03 = the 1%\u20133% band)"
+    },
+    country: { type: "string", description: "Lookalike: one country (ES)" },
+    countries: { type: "string", description: "Lookalike: several countries (ES,PT \u2014 comma-separated or repeated)" },
+    "allow-international-seeds": {
+      type: "boolean",
+      description: "Lookalike: let Meta use seed people from other countries when the seed is thin in these"
+    },
+    ...fileArg("customAudience.create", "JSON (a path, or inline) with lookalike_spec / rule / members / full payload")
+  },
+  run: async ({ args, rawArgs }) => {
+    const accountId = await bareAccountId(args);
+    const file = loadJsonFileArg(args.file);
+    const payload = mergePayload(file, {
+      name: args.name,
+      subtype: upper(args.subtype),
+      description: args.description,
+      retention_days: numberFlag(args["retention-days"], "--retention-days"),
+      customer_file_source: upper(args["customer-file-source"]),
+      is_value_based: args["value-based"] ? true : void 0,
+      lookalike_spec: lookalikeSpecFromFlags(args, file.lookalike_spec, rawArgs)
+    });
+    await stageOp({ kind: "customAudience.create", accountId, payload });
+  }
+});
+function lookalikeSpecFromFlags(args, fromFile, rawArgs) {
+  const base = fromFile && typeof fromFile === "object" ? fromFile : {};
+  const flags = {
+    origin: typeof args["lookalike-of"] === "string" ? [{ id: args["lookalike-of"] }] : void 0,
+    conversions_of: repeatedListFlag(rawArgs, "lookalike-of-conversions", args["lookalike-of-conversions"]),
+    ratio: numberFlag(args.ratio, "--ratio"),
+    starting_ratio: numberFlag(args["starting-ratio"], "--starting-ratio"),
+    country: typeof args.country === "string" ? args.country.toUpperCase() : void 0,
+    countries: repeatedListFlag(rawArgs, "countries", args.countries)?.map((code) => code.toUpperCase()),
+    allow_international_seeds: args["allow-international-seeds"] ? true : void 0
+  };
+  const merged = mergePayload(base, flags);
+  return Object.keys(merged).length > 0 ? merged : void 0;
+}
+var audiencesUpdateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: `Stage changes to a custom audience: name, description, where a customer list came from, its opt-out link, or a website/engagement rule (--file {"rule": \u2026}). A customer list's retention and a lookalike's seed and size are fixed \u2014 a different one is a new audience. Delete with \`audiences delete\`. ${STAGED_NOTE}`
+  },
+  args: {
+    id: { type: "positional", description: "Audience id or meta_temp_* ref", required: true },
+    ...accountArgs,
+    name: { type: "string", description: "New name" },
+    description: { type: "string", description: "New description" },
+    "customer-file-source": {
+      type: "string",
+      description: "USER_PROVIDED_ONLY | PARTNER_PROVIDED_ONLY | BOTH_USER_AND_PARTNER_PROVIDED"
+    },
+    "opt-out-link": { type: "string", description: "https link where people can opt out of this audience" },
+    ...fileArg("customAudience.update", "JSON file with fields to change (rule for a website/engagement audience)")
+  },
+  run: async ({ args }) => {
+    const accountId = await bareAccountId(args);
+    const payload = mergePayload(loadJsonFileArg(args.file), {
+      name: args.name,
+      description: args.description,
+      customer_file_source: upper(args["customer-file-source"]),
+      opt_out_link: args["opt-out-link"]
+    });
+    if (payload.status === "DELETED") {
+      failWriteValidation(
+        "update does not delete \u2014 use `baker ads meta audiences delete <id>` if the user asked to delete it"
+      );
+    }
+    await stageOp({
+      kind: "customAudience.update",
+      accountId,
+      target: requireTarget(args, "audience"),
+      payload
+    });
+  }
+});
+var mediaUploadCommand = defineCommand({
+  meta: {
+    name: "upload",
+    description: `Stage a Baker library image/video upload to Meta. Publishes the hash/id a creative references by --image-ref/--video-ref. ${STAGED_NOTE}
+Example: baker ads meta media upload --kind image --image-id <bakerImageId>`
+  },
+  args: {
+    ...accountArgs,
+    kind: { type: "string", description: "image|video" },
+    "image-id": { type: "string", description: "Baker library image id (for --kind image)" },
+    "video-id": { type: "string", description: "Baker library video id (for --kind video)" },
+    name: { type: "string", description: "Display name / filename hint" }
+  },
+  run: async ({ args }) => {
+    const accountId = await bareAccountId(args);
+    const kind = String(args.kind ?? "").toLowerCase();
+    if (kind !== "image" && kind !== "video") {
+      failWriteValidation("--kind must be image or video");
+    }
+    await stageOp({
+      kind: "media.upload",
+      accountId,
+      payload: { kind, bakerImageId: args["image-id"], bakerVideoId: args["video-id"], name: args.name }
+    });
+  }
+});
+var STATUS_BY_COMMAND = { pause: "PAUSED", resume: "ACTIVE", archive: "ARCHIVED", delete: "DELETED" };
+var STATUS_COMMAND_NOTE = {
+  archive: "Archived stays readable in Ads Manager and can be found with --effective-status ARCHIVED.",
+  delete: "Deleting is permanent and cannot be undone \u2014 Meta removes it and everything under it. Prefer pause or archive unless the user asked to delete."
+};
+function statusCommand(name, kind, label) {
+  const status = STATUS_BY_COMMAND[name];
+  const note = STATUS_COMMAND_NOTE[name];
+  return defineCommand({
+    meta: { name, description: `Stage ${name} for a ${label}. ${note ? `${note} ` : ""}${STAGED_NOTE}` },
+    args: { id: { type: "positional", description: `${label} id`, required: true }, ...accountArgs },
+    run: async ({ args }) => {
+      const accountId = await bareAccountId(args);
+      await stageStatusChange({
+        kind,
+        accountId,
+        target: requireTarget(args, label),
+        status
+      });
+    }
+  });
+}
+function duplicateCommand(entity, label) {
+  return defineCommand({
+    meta: {
+      name: "duplicate",
+      description: `Stage a paused copy of an existing ${label} (reconstructed from its live snapshot). ${STAGED_NOTE}
+--replace also stages a pause of the original, gated on the copy publishing.`
+    },
+    args: {
+      id: { type: "positional", description: `Source ${label} id`, required: true },
+      ...accountArgs,
+      name: { type: "string", description: "Override the copy's name" },
+      replace: { type: "boolean", description: "Pause the original once the copy publishes" }
+    },
+    run: async ({ args }) => {
+      const { apiPost } = await import("./client-DKZM6XTS.js");
+      const { requireChatId } = await import("./env-AMOXYHCA.js");
+      const { writeJsonEnvelope } = await import("./output-W5J5RKRR.js");
+      const { handleMetaError } = await import("./shared-P5UDXZAG.js");
+      try {
+        const accountId = await bareAccountId(args);
+        const chatId = requireChatId();
+        const response = await apiPost("/api/ads/meta/draft/duplicate", {
+          chatId,
+          accountId,
+          entity,
+          sourceId: requireTarget(args, label),
+          overrides: args.name ? { name: args.name } : void 0,
+          replace: Boolean(args.replace)
+        });
+        writeJsonEnvelope(response);
+      } catch (err) {
+        handleMetaError(err);
+      }
+    }
+  });
+}
+var campaignsPauseCommand = statusCommand("pause", "campaign.update", "campaign");
+var campaignsResumeCommand = statusCommand("resume", "campaign.update", "campaign");
+var campaignsArchiveCommand = statusCommand("archive", "campaign.update", "campaign");
+var campaignsDeleteCommand = statusCommand("delete", "campaign.update", "campaign");
+var campaignsDuplicateCommand = duplicateCommand("campaign", "campaign");
+var adSetsPauseCommand = statusCommand("pause", "adSet.update", "ad set");
+var adSetsResumeCommand = statusCommand("resume", "adSet.update", "ad set");
+var adSetsArchiveCommand = statusCommand("archive", "adSet.update", "ad set");
+var adSetsDeleteCommand = statusCommand("delete", "adSet.update", "ad set");
+var adSetsDuplicateCommand = duplicateCommand("adSet", "ad set");
+var adsPauseCommand = statusCommand("pause", "ad.update", "ad");
+var adsResumeCommand = statusCommand("resume", "ad.update", "ad");
+var adsArchiveCommand = statusCommand("archive", "ad.update", "ad");
+var adsDeleteCommand = statusCommand("delete", "ad.update", "ad");
+var adsDuplicateCommand = duplicateCommand("ad", "ad");
+export {
+  adCreativesCreateCommand,
+  adCreativesUpdateCommand,
+  adSetsArchiveCommand,
+  adSetsCreateCommand,
+  adSetsDeleteCommand,
+  adSetsDuplicateCommand,
+  adSetsPauseCommand,
+  adSetsResumeCommand,
+  adSetsUpdateCommand,
+  adsArchiveCommand,
+  adsCreateCommand,
+  adsDeleteCommand,
+  adsDuplicateCommand,
+  adsPauseCommand,
+  adsResumeCommand,
+  adsRetagCommand,
+  adsUpdateCommand,
+  audiencesCreateCommand,
+  audiencesUpdateCommand,
+  campaignsArchiveCommand,
+  campaignsCreateCommand,
+  campaignsDeleteCommand,
+  campaignsDuplicateCommand,
+  campaignsPauseCommand,
+  campaignsResumeCommand,
+  campaignsUpdateCommand,
+  collectionThumbnailsFromFlags,
+  creativeContentPatch,
+  creativeCta,
+  ctaPatchFromFlags,
+  customConversionRuleFromFlags,
+  customConversionsCreateCommand,
+  lookalikeSpecFromFlags,
+  mediaUploadCommand,
+  partnerFromFlags,
+  retagSetPairs,
+  targetingFromFlags
+};
+//# sourceMappingURL=write-commands-XFYXMTXO.js.map