@koda-sl/baker-cli 0.489.0 → 0.490.0

package/dist/{write-commands-HCQI4Y27.js → write-commands-PEJBTME6.js}

@@ -1,3 +1,13 @@
+import {
+  adSetDeliveryArgs,
+  adSetDeliveryFromFlags,
+  boostEditArgs,
+  boostEditsFromFlags,
+  budgetBoostArg,
+  budgetBoostsFromFlags,
+  clearArg,
+  clearFromFlags
+} from "./chunk-CP4P6YKM.js";
 import {
   bareAccountId,
   failWriteValidation,
@@ -8,15 +18,22 @@ import {
   parseDateFlag,
   parseMoneyFlag,
   refuseDeleteByUpdate,
+  repeatedListFlag,
   requireTarget,
   stageOp,
   stageStatusChange,
   upper
-} from "./chunk-6JWEGFM5.js";
+} from "./chunk-5C35OW7L.js";
 import {
   buildCustomConversionRule
-} from "./chunk-GOJXKIFQ.js";
-import "./chunk-OP7DNHD2.js";
+} from "./chunk-A4MVVPJ2.js";
+import {
+  VISUAL_ENHANCEMENT_FEATURES
+} from "./chunk-HLVRHBKL.js";
+import "./chunk-QTOZ32SU.js";
+import {
+  repeatedValues
+} from "./chunk-ERSX3MKH.js";
 import "./chunk-SFJW2KED.js";
 import "./chunk-4NZ47VXO.js";
 import "./chunk-D5FY4FAK.js";
@@ -37,6 +54,72 @@ 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" }
@@ -55,7 +138,8 @@ function campaignPayloadFromFlags(args) {
     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")
+    stop_time: parseDateFlag(args.stop, "--stop"),
+    promoted_object: args["catalog-id"] ? { product_catalog_id: String(args["catalog-id"]) } : void 0
   };
 }
 var campaignBudgetArgs = {
@@ -68,13 +152,16 @@ var campaignBudgetArgs = {
     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" }
+  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`
+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,
@@ -92,11 +179,18 @@ Example: baker ads meta campaigns create --name "Q3 Prospecting" --objective OUT
       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 }) => {
+  run: async ({ args, rawArgs }) => {
     const accountId = bareAccountId(args);
-    const payload = mergePayload(loadJsonFileArg(args.file), campaignPayloadFromFlags(args));
+    const payload = mergePayload(loadJsonFileArg(args.file), {
+      ...campaignPayloadFromFlags(args),
+      budgetSchedules: budgetBoostsFromFlags(args, rawArgs)
+    });
     await stageOp({ kind: "campaign.create", accountId, payload });
   }
 });
@@ -104,7 +198,9 @@ 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`
+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 },
@@ -112,13 +208,18 @@ Pass a meta_temp_* ref to amend a campaign staged in this chat. Example: baker a
     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 }) => {
+  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"),
@@ -135,9 +236,18 @@ Pass a meta_temp_* ref to amend a campaign staged in this chat. Example: baker a
     });
   }
 });
-function adSetPayloadFromFlags(args) {
+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),
@@ -150,16 +260,41 @@ function adSetPayloadFromFlags(args) {
     bid_strategy: upper(args["bid-strategy"]),
     start_time: parseDateFlag(args.start, "--start"),
     end_time: parseDateFlag(args.end, "--end"),
-    targeting: args["targeting-file"] ? loadJsonFileArg(args["targeting-file"]) : void 0,
+    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) {
@@ -236,12 +371,32 @@ var adSetWriteArgs = {
   "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. Omit and Baker sets auto-bid; never leave it to Meta, whose default is a bid cap that then fails without an amount."
+    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" },
+  "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",
@@ -253,6 +408,22 @@ var adSetWriteArgs = {
     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({
@@ -262,12 +433,37 @@ var adSetsCreateCommand = defineCommand({
 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`
+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 },
-  run: async ({ args }) => {
+  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 payload = mergePayload(loadJsonFileArg(args.file), adSetPayloadFromFlags(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-X52VG35Y.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 });
   }
 });
@@ -276,17 +472,33 @@ var adSetsUpdateCommand = defineCommand({
     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 },
-  run: async ({ args }) => {
+  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);
-    const merged = mergePayload(loadJsonFileArg(args.file), 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",
@@ -296,8 +508,8 @@ Example: baker ads meta adsets update 6123 --daily-budget 80`
     });
   }
 });
-function creativePayloadFromFlags(args) {
-  const enhancements = args["standard-enhancements"] !== void 0 ? { standardEnhancements: parseEnroll(args["standard-enhancements"]) } : void 0;
+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.
@@ -311,25 +523,62 @@ function creativePayloadFromFlags(args) {
     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"],
-    enhancements
+    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"]) }
+    ...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);
-  return patch ? { type: "SIGN_UP", ...patch } : void 0;
+  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);
@@ -340,26 +589,70 @@ function creativeContentPatch(file, args) {
   const fileCta = fileContent.call_to_action ?? {};
   return { ...fileContent, call_to_action: { ...fileCta, ...cta } };
 }
-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");
-}
 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 (default single)" },
+    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" },
+    "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" },
@@ -376,15 +669,70 @@ Example: baker ads meta creatives create --page 555 --message "Save now" --link
     "video-ref": { type: "string", description: "meta_temp_* ref of a staged video upload" },
     "thumbnail-hash": {
       type: "string",
-      description: "Cover image hash for a video ad (Meta's own cover is used when omitted)"
+      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)" },
-    "standard-enhancements": { type: "string", description: "Advantage+ Creative standard enhancements on|off" },
+    "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 }) => {
+  run: async ({ args, rawArgs }) => {
     const accountId = bareAccountId(args);
-    const payload = mergePayload(loadJsonFileArg(args.file), creativePayloadFromFlags(args));
+    const payload = mergePayload(
+      loadJsonFileArg(args.file),
+      creativePayloadFromFlags(args, rawArgs)
+    );
     if (payload.creativeType === void 0) {
       payload.creativeType = "single";
     }
@@ -424,6 +772,11 @@ Amending a staged (meta_temp_*) creative merges fields into the create. Example:
       // 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,
@@ -445,6 +798,10 @@ Example: baker ads meta ads create --name "Ad 1" --adset meta_temp_as01 --creati
     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 }) => {
@@ -455,7 +812,8 @@ Example: baker ads meta ads create --name "Ad 1" --adset meta_temp_as01 --creati
       adset_id: args.adset,
       creative: args.creative ? { creative_id: String(args.creative) } : void 0,
       status: upper(args.status),
-      tracking_specs: tracking
+      tracking_specs: tracking,
+      conversion_domain: args["conversion-domain"]
     });
     await stageOp({ kind: "ad.create", accountId, payload });
   }
@@ -505,14 +863,14 @@ Example: baker ads meta ads retag 120252158038400247 --url-tags "utm_source={{si
     "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}}"'
+      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 }) => {
+  run: async ({ args, rawArgs }) => {
     const { apiPost } = await import("./client-WL2FKW4T.js");
     const { requireChatId } = await import("./env-5MUVYE2L.js");
     const { writeJsonEnvelope } = await import("./output-GWIP6ROX.js");
-    const { handleMetaError } = await import("./shared-NDRFKAH7.js");
+    const { handleMetaError } = await import("./shared-3IBNDEFL.js");
     try {
       const accountId = bareAccountId(args);
       const urlTags = typeof args["url-tags"] === "string" ? args["url-tags"] : void 0;
@@ -525,7 +883,7 @@ Example: baker ads meta ads retag 120252158038400247 --url-tags "utm_source={{si
         accountId,
         adId: requireTarget(args, "ad"),
         urlTags,
-        set: setRaw === void 0 ? void 0 : parseSetPairs(setRaw)
+        set: setRaw === void 0 ? void 0 : retagSetPairs(rawArgs, setRaw)
       });
       writeJsonEnvelope(response);
     } catch (err) {
@@ -533,6 +891,9 @@ Example: baker ads meta ads retag 120252158038400247 --url-tags "utm_source={{si
     }
   }
 });
+function retagSetPairs(rawArgs, parsed) {
+  return parseSetPairs(repeatedValues(rawArgs, "set", parsed).join("&"));
+}
 function parseSetPairs(raw) {
   const pairs = {};
   for (const part of raw.replace(/^[?&]+/, "").split("&")) {
@@ -551,10 +912,12 @@ function parseSetPairs(raw) {
 var audiencesCreateCommand = defineCommand({
   meta: {
     name: "create",
-    description: `Stage a new custom audience shell. ${STAGED_NOTE}
-LOOKALIKE/WEBSITE/ENGAGEMENT specifics go via --file (lookalike_spec / rule). Member-list upload is not staged in v1.
-A WEBSITE/ENGAGEMENT 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`
+    description: `Stage a new custom audience. ${STAGED_NOTE}
+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,
@@ -565,34 +928,94 @@ Example: baker ads meta audiences create --name "Site visitors 30d" --subtype WE
       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 file with lookalike_spec / rule / full payload" }
   },
-  run: async ({ args }) => {
+  run: async ({ args, rawArgs }) => {
     const accountId = bareAccountId(args);
-    const payload = mergePayload(loadJsonFileArg(args.file), {
+    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")
+      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 name/description changes to a custom audience. ${STAGED_NOTE}`
+    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" },
-    file: { type: "string", description: "JSON file with fields to change" }
+    "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 });
+    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,
@@ -666,7 +1089,7 @@ function duplicateCommand(entity, label) {
       const { apiPost } = await import("./client-WL2FKW4T.js");
       const { requireChatId } = await import("./env-5MUVYE2L.js");
       const { writeJsonEnvelope } = await import("./output-GWIP6ROX.js");
-      const { handleMetaError } = await import("./shared-NDRFKAH7.js");
+      const { handleMetaError } = await import("./shared-3IBNDEFL.js");
       try {
         const accountId = bareAccountId(args);
         const chatId = requireChatId();
@@ -727,11 +1150,16 @@ export {
   campaignsPauseCommand,
   campaignsResumeCommand,
   campaignsUpdateCommand,
+  collectionThumbnailsFromFlags,
   creativeContentPatch,
   creativeCta,
   ctaPatchFromFlags,
   customConversionRuleFromFlags,
   customConversionsCreateCommand,
-  mediaUploadCommand
+  lookalikeSpecFromFlags,
+  mediaUploadCommand,
+  partnerFromFlags,
+  retagSetPairs,
+  targetingFromFlags
 };
-//# sourceMappingURL=write-commands-HCQI4Y27.js.map
+//# sourceMappingURL=write-commands-PEJBTME6.js.map