@koda-sl/baker-cli 0.516.0 → 0.518.0

package/dist/write-commands-NXJQQ62W.js

@@ -1,1172 +0,0 @@
-import {
-  adSetDeliveryArgs,
-  adSetDeliveryFromFlags,
-  boostEditArgs,
-  boostEditsFromFlags,
-  budgetBoostArg,
-  budgetBoostsFromFlags,
-  clearArg,
-  clearFromFlags
-} from "./chunk-TYXZ2SRW.js";
-import {
-  bareAccountId,
-  failWriteValidation,
-  listFlag,
-  loadJsonFileArg,
-  mergePayload,
-  numberFlag,
-  parseDateFlag,
-  parseMoneyFlag,
-  refuseDeleteByUpdate,
-  repeatedListFlag,
-  requireTarget,
-  stageOp,
-  stageStatusChange,
-  upper
-} from "./chunk-ILPHIYAL.js";
-import {
-  buildCustomConversionRule
-} from "./chunk-Q3GSVLE5.js";
-import {
-  VISUAL_ENHANCEMENT_FEATURES
-} from "./chunk-GDFJOCDO.js";
-import "./chunk-M7QZSEHF.js";
-import {
-  repeatedValues
-} from "./chunk-ERSX3MKH.js";
-import "./chunk-SCAGMX2I.js";
-import "./chunk-4NZ47VXO.js";
-import "./chunk-D5FY4FAK.js";
-import "./chunk-QPESDKZC.js";
-import "./chunk-Y2JZX6JB.js";
-import "./chunk-6DPSWLGY.js";
-import "./chunk-E44NXCTL.js";
-import "./chunk-EJGAJHLB.js";
-import "./chunk-LNNTHEL7.js";
-import "./chunk-FOMFU2RX.js";
-import "./chunk-PSGIHSNC.js";
-import "./chunk-PONLPYD7.js";
-import "./chunk-SOPVIIUW.js";
-import "./chunk-G4FG5EQO.js";
-import "./chunk-NSBNIPIW.js";
-import "./chunk-X7VQFLHI.js";
-import "./chunk-LU4HI4KI.js";
-import "./chunk-LGK7UWBN.js";
-import "./chunk-Q7US4OOA.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"
-    },
-    file: { type: "string", description: "JSON file with the full payload; flags override file keys" }
-  },
-  run: async ({ args, rawArgs }) => {
-    const accountId = 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,
-    file: { type: "string", description: "JSON file with fields to change" }
-  },
-  run: async ({ args, rawArgs }) => {
-    const accountId = 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 = 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,
-    "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 = 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-TXWPDJ2F.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,
-    "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 = 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"
-    },
-    file: { type: "string", description: "JSON file with the full creative payload (carousel cards / dynamic assets)" }
-  },
-  run: async ({ args, rawArgs }) => {
-    const accountId = 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"
-    },
-    file: {
-      type: "string",
-      description: "JSON file with fields to change (content only merges into a staged creative)"
-    }
-  },
-  run: async ({ args }) => {
-    const accountId = 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"
-    },
-    file: { type: "string", description: "JSON file with the full payload" }
-  },
-  run: async ({ args }) => {
-    const accountId = 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" },
-    file: { type: "string", description: "JSON file with fields to change" }
-  },
-  run: async ({ args }) => {
-    const accountId = 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-EYPNMTBH.js");
-    const { requireChatId } = await import("./env-ABXQWHDO.js");
-    const { writeJsonEnvelope } = await import("./output-4QBQEM4C.js");
-    const { handleMetaError } = await import("./shared-CGEJI2RB.js");
-    try {
-      const accountId = 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"
-    },
-    file: {
-      type: "string",
-      description: "JSON (a path, or inline) with lookalike_spec / rule / members / full payload"
-    }
-  },
-  run: async ({ args, rawArgs }) => {
-    const accountId = 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" },
-    file: { type: "string", description: "JSON file with fields to change (rule for a website/engagement audience)" }
-  },
-  run: async ({ args }) => {
-    const accountId = 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 = 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 = 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-EYPNMTBH.js");
-      const { requireChatId } = await import("./env-ABXQWHDO.js");
-      const { writeJsonEnvelope } = await import("./output-4QBQEM4C.js");
-      const { handleMetaError } = await import("./shared-CGEJI2RB.js");
-      try {
-        const accountId = 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-NXJQQ62W.js.map