@koda-sl/baker-cli 0.472.0 → 0.473.0

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

@@ -1,737 +0,0 @@
-import {
-  bareAccountId,
-  failWriteValidation,
-  listFlag,
-  loadJsonFileArg,
-  mergePayload,
-  numberFlag,
-  parseDateFlag,
-  parseMoneyFlag,
-  refuseDeleteByUpdate,
-  requireTarget,
-  stageOp,
-  stageStatusChange,
-  upper
-} from "./chunk-3HTJJQJU.js";
-import {
-  buildCustomConversionRule
-} from "./chunk-GOJXKIFQ.js";
-import "./chunk-HR3HS56F.js";
-import "./chunk-ZWQ5QM6L.js";
-import "./chunk-4NZ47VXO.js";
-import "./chunk-D5FY4FAK.js";
-import "./chunk-DDTTMIGQ.js";
-import "./chunk-CXT6Q7KP.js";
-import "./chunk-CNABBWT5.js";
-import "./chunk-SGPQ2NDZ.js";
-import "./chunk-UJSPFZH3.js";
-import "./chunk-73U6LGCH.js";
-import "./chunk-64XIDXCN.js";
-import "./chunk-KGSDVTY6.js";
-import "./chunk-XQIOCIDO.js";
-import "./chunk-QG2WPVKE.js";
-import "./chunk-TSOJM4EO.js";
-import "./chunk-5TTHWWON.js";
-import "./chunk-KCA5CDCU.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-2FJG3EAY.js");
-    const { requireChatId } = await import("./env-ZAXFBZNA.js");
-    const { writeJsonEnvelope } = await import("./output-56JE5PAZ.js");
-    const { handleMetaError } = await import("./shared-3RWMU7M7.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-2FJG3EAY.js");
-      const { requireChatId } = await import("./env-ZAXFBZNA.js");
-      const { writeJsonEnvelope } = await import("./output-56JE5PAZ.js");
-      const { handleMetaError } = await import("./shared-3RWMU7M7.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-5PIVBM2M.js.map