@koda-sl/baker-cli 0.477.0-dev.55c09e3e8 → 0.481.0-dev.2d33e194f

package/dist/write-commands-5TJ3LQ5F.js

@@ -0,0 +1,737 @@
+import {
+  bareAccountId,
+  failWriteValidation,
+  listFlag,
+  loadJsonFileArg,
+  mergePayload,
+  numberFlag,
+  parseDateFlag,
+  parseMoneyFlag,
+  refuseDeleteByUpdate,
+  requireTarget,
+  stageOp,
+  stageStatusChange,
+  upper
+} from "./chunk-QNEX7FEC.js";
+import {
+  buildCustomConversionRule
+} from "./chunk-GOJXKIFQ.js";
+import "./chunk-O3LHCQ7Q.js";
+import "./chunk-GKXMIXEV.js";
+import "./chunk-4NZ47VXO.js";
+import "./chunk-D5FY4FAK.js";
+import "./chunk-D5MF337I.js";
+import "./chunk-LHNL6JM2.js";
+import "./chunk-VHMNSO2B.js";
+import "./chunk-65BQAJMH.js";
+import "./chunk-6GFJFTG6.js";
+import "./chunk-NAMEFVWL.js";
+import "./chunk-GT4UFORX.js";
+import "./chunk-CECS3DHZ.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-KB5XJHQX.js";
+import "./chunk-YONSWWCF.js";
+import "./chunk-QXDEZKAR.js";
+import "./chunk-4DM6OAQ6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/write-commands.ts
+import { defineCommand } from "citty";
+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")
+  };
+}
+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" }
+};
+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`
+  },
+  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,
+    file: { type: "string", description: "JSON file with the full payload; flags override file keys" }
+  },
+  run: async ({ args }) => {
+    const accountId = bareAccountId(args);
+    const payload = mergePayload(loadJsonFileArg(args.file), campaignPayloadFromFlags(args));
+    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`
+  },
+  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,
+    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),
+      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 adSetPayloadFromFlags(args) {
+  const promotedObject = args["promoted-object-file"] ? loadJsonFileArg(args["promoted-object-file"]) : buildPromotedObject(args);
+  return {
+    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: args["targeting-file"] ? loadJsonFileArg(args["targeting-file"]) : void 0,
+    promoted_object: promotedObject && Object.keys(promotedObject).length > 0 ? promotedObject : void 0
+  };
+}
+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"]);
+  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. Omit and Baker sets auto-bid; never leave it to Meta, whose default is a bid cap that then fails without an amount."
+  },
+  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" },
+  "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."
+  },
+  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`
+  },
+  args: { campaign: { type: "string", description: "Parent campaign id or meta_temp_* ref" }, ...adSetWriteArgs },
+  run: async ({ args }) => {
+    const accountId = bareAccountId(args);
+    const payload = mergePayload(loadJsonFileArg(args.file), adSetPayloadFromFlags(args));
+    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.
+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 }) => {
+    const accountId = bareAccountId(args);
+    const {
+      campaign_id: _drop,
+      billing_event: _be,
+      ...payload
+    } = adSetPayloadFromFlags(args);
+    const merged = mergePayload(loadJsonFileArg(args.file), payload);
+    refuseDeleteByUpdate(merged, "adsets");
+    await stageOp({
+      kind: "adSet.update",
+      accountId,
+      target: requireTarget(args, "ad set"),
+      payload: merged
+    });
+  }
+});
+function creativePayloadFromFlags(args) {
+  const enhancements = args["standard-enhancements"] !== void 0 ? { standardEnhancements: parseEnroll(args["standard-enhancements"]) } : void 0;
+  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),
+    imageHash: args["image-hash"],
+    imageRef: args["image-ref"],
+    videoId: args["video-id"],
+    videoRef: args["video-ref"],
+    thumbnailHash: args["thumbnail-hash"],
+    url_tags: args["url-tags"],
+    enhancements
+  };
+}
+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"]) }
+  };
+  return Object.keys(patch).length > 0 ? patch : void 0;
+}
+function creativeCta(args) {
+  const patch = ctaPatchFromFlags(args);
+  return patch ? { type: "SIGN_UP", ...patch } : void 0;
+}
+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 } };
+}
+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).
+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)" },
+    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" },
+    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 image hash for a video ad (Meta's own cover is used when omitted)"
+    },
+    "url-tags": { type: "string", description: "URL tracking params (utm_source=fb&\u2026)" },
+    "standard-enhancements": { type: "string", description: "Advantage+ Creative standard enhancements on|off" },
+    file: { type: "string", description: "JSON file with the full creative payload (carousel cards / dynamic assets)" }
+  },
+  run: async ({ args }) => {
+    const accountId = bareAccountId(args);
+    const payload = mergePayload(loadJsonFileArg(args.file), creativePayloadFromFlags(args));
+    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)
+    });
+    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" },
+    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
+    });
+    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}}"'
+    }
+  },
+  run: async ({ args }) => {
+    const { apiPost } = await import("./client-LY2JCQS2.js");
+    const { requireChatId } = await import("./env-YLOVBOAE.js");
+    const { writeJsonEnvelope } = await import("./output-ZL62UZHQ.js");
+    const { handleMetaError } = await import("./shared-3CGGKICB.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 : parseSetPairs(setRaw)
+      });
+      writeJsonEnvelope(response);
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+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 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`
+  },
+  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"
+    },
+    file: { type: "string", description: "JSON file with lookalike_spec / rule / full payload" }
+  },
+  run: async ({ args }) => {
+    const accountId = bareAccountId(args);
+    const payload = mergePayload(loadJsonFileArg(args.file), {
+      name: args.name,
+      subtype: upper(args.subtype),
+      description: args.description,
+      retention_days: numberFlag(args["retention-days"], "--retention-days")
+    });
+    await stageOp({ kind: "customAudience.create", accountId, payload });
+  }
+});
+var audiencesUpdateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: `Stage name/description changes to a custom audience. ${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" }
+  },
+  run: async ({ args }) => {
+    const accountId = bareAccountId(args);
+    const payload = mergePayload(loadJsonFileArg(args.file), { name: args.name, description: args.description });
+    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-LY2JCQS2.js");
+      const { requireChatId } = await import("./env-YLOVBOAE.js");
+      const { writeJsonEnvelope } = await import("./output-ZL62UZHQ.js");
+      const { handleMetaError } = await import("./shared-3CGGKICB.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,
+  creativeContentPatch,
+  creativeCta,
+  ctaPatchFromFlags,
+  customConversionRuleFromFlags,
+  customConversionsCreateCommand,
+  mediaUploadCommand
+};
+//# sourceMappingURL=write-commands-5TJ3LQ5F.js.map