@koda-sl/baker-cli 0.489.0-dev.63e618e80 → 0.490.0

package/dist/chunk-C7NWUCLQ.js

@@ -0,0 +1,64 @@
+import {
+  REF_PREFIX
+} from "./chunk-JQH5VG6F.js";
+
+// src/commands/canvas/node-preview.ts
+var MAX_PARAMS_PREVIEW_LENGTH = 4e3;
+var SPEC_KEYS = [
+  "model",
+  "format",
+  "mode",
+  "aspect_ratio",
+  "image_size",
+  "resolution",
+  "duration",
+  "subject_type",
+  "font_size",
+  "expect",
+  "source",
+  "path",
+  "url"
+];
+var BODY_KEYS = ["prompt", "text", "subject_description"];
+function scalarField(params, key) {
+  const value = params[key];
+  if (typeof value === "number") return String(value);
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  return trimmed && !trimmed.startsWith(REF_PREFIX) ? trimmed : void 0;
+}
+function compactJson(params) {
+  try {
+    const json = JSON.stringify(params);
+    return json && json !== "{}" ? json : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function cap(text) {
+  return text.length > MAX_PARAMS_PREVIEW_LENGTH ? `${text.slice(0, MAX_PARAMS_PREVIEW_LENGTH - 1)}\u2026` : text;
+}
+function nodeParamsPreview(params, deps) {
+  const refsLine = deps && deps.length > 0 ? `refs: ${deps.join(", ")}` : void 0;
+  if (!params || typeof params !== "object") return refsLine;
+  const own = params;
+  const nested = (key) => own[key] && typeof own[key] === "object" && !Array.isArray(own[key]) ? own[key] : {};
+  const record = { ...nested("paint"), ...nested("words"), ...own };
+  const spec = [];
+  for (const key of SPEC_KEYS) {
+    const value = scalarField(record, key);
+    if (value !== void 0) spec.push(`${key}: ${value}`);
+  }
+  if (refsLine) spec.push(refsLine);
+  const body = BODY_KEYS.map((key) => scalarField(record, key)).find(Boolean);
+  const header = spec.join("\n");
+  const composed = header && body ? `${header}
+
+${body}` : header || body || compactJson(record);
+  return composed ? cap(composed) : void 0;
+}
+
+export {
+  nodeParamsPreview
+};
+//# sourceMappingURL=chunk-C7NWUCLQ.js.map

package/dist/chunk-CP4P6YKM.js

@@ -0,0 +1,287 @@
+import {
+  failWriteValidation,
+  parseDateFlag,
+  parseMoneyFlag
+} from "./chunk-5C35OW7L.js";
+import {
+  repeatedValues
+} from "./chunk-ERSX3MKH.js";
+
+// src/commands/ads/meta/delivery-flags.ts
+function text(value) {
+  return typeof value === "string" && value.length > 0 ? value : void 0;
+}
+function frequencyCapFlag(value) {
+  const raw = text(value);
+  if (raw === void 0) {
+    return void 0;
+  }
+  const match = /^(\d+)\s*\/\s*(\d+)\s*d?$/i.exec(raw.trim());
+  if (!match) {
+    failWriteValidation(
+      `--frequency-cap takes N/D \u2014 at most N impressions per person every D days, e.g. 2/7 (got "${raw}")`
+    );
+  }
+  return [{ event: "IMPRESSIONS", interval_days: Number(match[2]), max_frequency: Number(match[1]) }];
+}
+var DAY_INDEX = { sun: 0, mon: 1, tue: 2, wed: 3, thu: 4, fri: 5, sat: 6 };
+function dayIndex(name, flag) {
+  const index = DAY_INDEX[name.slice(0, 3).toLowerCase()];
+  if (index === void 0) {
+    failWriteValidation(`${flag}: "${name}" is not a day \u2014 use Mon, Tue, \u2026 Sun`);
+  }
+  return index;
+}
+function scheduleDays(spec) {
+  if (/^(daily|every ?day|all)$/i.test(spec)) {
+    return [0, 1, 2, 3, 4, 5, 6];
+  }
+  return spec.split(",").flatMap((part) => {
+    const [from, to] = part.split("-").map((day) => day.trim());
+    if (!from) {
+      return [];
+    }
+    const start = dayIndex(from, "--schedule");
+    if (!to) {
+      return [start];
+    }
+    const end = dayIndex(to, "--schedule");
+    const days = [];
+    for (let day = start; days.length < 7; day = (day + 1) % 7) {
+      days.push(day);
+      if (day === end) break;
+    }
+    return days;
+  });
+}
+function hourMinute(value) {
+  const [hours = "", minutes = "0"] = value.split(":");
+  return Number(hours) * 60 + Number(minutes);
+}
+function scheduleBlock(raw, timezone) {
+  const match = /^(.+?)\s+(\d{1,2}(?::\d{2})?)\s*-\s*(\d{1,2}(?::\d{2})?)$/.exec(raw.trim());
+  if (!match?.[1] || !match[2] || !match[3]) {
+    failWriteValidation(
+      `--schedule takes "<days> <from>-<to>", e.g. "Mon-Fri 09-18" or "sat,sun 10:00-14:00" (got "${raw}")`
+    );
+  }
+  return {
+    days: scheduleDays(match[1]),
+    start_minute: hourMinute(match[2]),
+    end_minute: hourMinute(match[3]),
+    timezone_type: timezone
+  };
+}
+function dayPartingFromFlags(args, rawArgs) {
+  const blocks = repeatedValues(rawArgs, "schedule", args.schedule).map((block) => {
+    const { timezone_type: _clock, ...rest } = scheduleBlock(block, "USER");
+    return rest;
+  });
+  return blocks.length > 0 ? blocks : void 0;
+}
+function scheduleTimezone(value) {
+  const raw = text(value)?.toLowerCase();
+  if (raw === void 0 || raw === "viewer" || raw === "user") {
+    return "USER";
+  }
+  if (raw === "account" || raw === "advertiser") {
+    return "ADVERTISER";
+  }
+  failWriteValidation(`--schedule-timezone takes viewer or account (got "${raw}")`);
+}
+var ATTRIBUTION_EVENTS = {
+  click: "CLICK_THROUGH",
+  view: "VIEW_THROUGH",
+  engaged_view: "ENGAGED_VIDEO_VIEW",
+  engaged_video_view: "ENGAGED_VIDEO_VIEW"
+};
+function attributionFlag(value) {
+  const raw = text(value);
+  if (raw === void 0) {
+    return void 0;
+  }
+  return raw.split(",").map((window) => {
+    const match = /^(\d+)d_([a-z_]+)$/i.exec(window.trim());
+    const event = match?.[2] ? ATTRIBUTION_EVENTS[match[2].toLowerCase()] : void 0;
+    if (!match || !event) {
+      failWriteValidation(`--attribution takes windows like 7d_click,1d_view,1d_engaged_view (got "${window}")`);
+    }
+    return { event_type: event, window_days: Number(match[1]) };
+  });
+}
+function numberArg(value, flag) {
+  const raw = text(value);
+  if (raw === void 0) {
+    return void 0;
+  }
+  const n = Number(raw);
+  if (!Number.isFinite(n)) {
+    failWriteValidation(`${flag} must be a number`);
+  }
+  return n;
+}
+function adSetDeliveryFromFlags(args, rawArgs) {
+  const timezone = scheduleTimezone(args["schedule-timezone"]);
+  const blocks = repeatedValues(rawArgs, "schedule", args.schedule).map((block) => scheduleBlock(block, timezone));
+  if (args["schedule-timezone"] !== void 0 && blocks.length === 0) {
+    failWriteValidation(
+      "--schedule-timezone says whose clock --schedule follows, so it goes with --schedule \u2014 pass the hours again with it"
+    );
+  }
+  const delivery = {
+    minRoas: numberArg(args["min-roas"], "--min-roas"),
+    frequency_control_specs: frequencyCapFlag(args["frequency-cap"]),
+    adset_schedule: blocks.length > 0 ? blocks : void 0,
+    pacing: text(args.pacing)?.toLowerCase(),
+    dailyMinSpendTarget: parseMoneyFlag(args["daily-min-spend"], args.currency, "--daily-min-spend"),
+    dailySpendCap: parseMoneyFlag(args["daily-spend-cap"], args.currency, "--daily-spend-cap"),
+    lifetimeMinSpendTarget: parseMoneyFlag(args["lifetime-min-spend"], args.currency, "--lifetime-min-spend"),
+    lifetimeSpendCap: parseMoneyFlag(args["lifetime-spend-cap"], args.currency, "--lifetime-spend-cap"),
+    is_dynamic_creative: args["dynamic-creative"] === void 0 ? void 0 : Boolean(args["dynamic-creative"]),
+    attribution_spec: attributionFlag(args.attribution)
+  };
+  return Object.fromEntries(Object.entries(delivery).filter(([, value]) => value !== void 0));
+}
+function budgetBoost(raw, currency) {
+  const match = /^(.+?)\.\.(.+?)=\+?(\d+(?:\.\d{1,3})?)(%?)$/.exec(raw.trim());
+  if (!match?.[1] || !match[2] || !match[3]) {
+    failWriteValidation(
+      `--budget-boost takes START..END=+AMOUNT or START..END=+PERCENT%, e.g. 2027-11-27T00:00Z..2027-11-28T00:00Z=+50% (got "${raw}")`
+    );
+  }
+  const period = {
+    time_start: parseDateFlag(match[1], "--budget-boost start"),
+    time_end: parseDateFlag(match[2], "--budget-boost end")
+  };
+  return match[4] === "%" ? { ...period, increasePercent: Number(match[3]) } : { ...period, increase: parseMoneyFlag(match[3], currency, "--budget-boost") };
+}
+function budgetBoostsFromFlags(args, rawArgs) {
+  const boosts = repeatedValues(rawArgs, "budget-boost", args["budget-boost"]);
+  return boosts.length > 0 ? boosts.map((boost) => budgetBoost(boost, args.currency)) : void 0;
+}
+function boostMove(raw) {
+  const match = /^(\d+)=(.+?)\.\.(.+)$/.exec(raw.trim());
+  if (!match?.[1] || !match[2] || !match[3]) {
+    failWriteValidation(
+      `--move-boost takes ID=START..END, e.g. 1633135568548763=2027-11-27T06:00Z..2027-11-27T12:00Z (got "${raw}")`
+    );
+  }
+  return {
+    id: match[1],
+    time_start: parseDateFlag(match[2], "--move-boost start"),
+    time_end: parseDateFlag(match[3], "--move-boost end")
+  };
+}
+function boostEditsFromFlags(args, rawArgs) {
+  const removed = repeatedValues(rawArgs, "remove-boost", args["remove-boost"]).flatMap((value) => value.split(",")).map((value) => value.trim()).filter(Boolean);
+  const moved = repeatedValues(rawArgs, "move-boost", args["move-boost"]);
+  return {
+    ...removed.length > 0 ? { removeBoosts: removed } : {},
+    ...moved.length > 0 ? { moveBoosts: moved.map(boostMove) } : {}
+  };
+}
+var boostEditArgs = {
+  "remove-boost": {
+    type: "string",
+    description: "Take one budget boost away, by its id from `baker ads meta high-demand-periods --campaign-id <id>` \u2014 repeatable or comma-separated. The others stay."
+  },
+  "move-boost": {
+    type: "string",
+    description: "Move one budget boost to another window, keeping its raise: ID=START..END, repeatable, at least 3 hours, on quarter hours. Meta has no boost update, so publish adds the same raise on the new window, then deletes the old boost. Example: --move-boost 1633135568548763=2027-11-27T06:00Z..2027-11-27T12:00Z"
+  }
+};
+var adSetDeliveryArgs = {
+  "min-roas": {
+    type: "string",
+    description: "Minimum ROAS for LOWEST_COST_WITH_MIN_ROAS bidding, as a multiple of spend: 2.5 = 250%. Needs --optimization-goal VALUE. Under a min-ROAS campaign budget every ad set needs its own. Example: --bid-strategy LOWEST_COST_WITH_MIN_ROAS --min-roas 2.5"
+  },
+  "frequency-cap": {
+    type: "string",
+    description: "At most N impressions per person every D days, as N/D \u2014 REACH and THRUPLAY goals only. Example: --frequency-cap 2/7"
+  },
+  schedule: {
+    type: "string",
+    description: 'Run ads only in these hours (dayparting), repeatable: "<days> <from>-<to>", whole hours. Needs --lifetime-budget and --end. Example: --schedule "Mon-Fri 09-18" --schedule "Sat 10-14"'
+  },
+  "schedule-timezone": {
+    type: "string",
+    description: "Whose clock --schedule follows: viewer (default) or account"
+  },
+  pacing: {
+    type: "string",
+    description: "standard (default) | no_pacing (accelerated \u2014 spends as fast as it can; LOWEST_COST_WITH_BID_CAP only) | day_parting (set by --schedule)"
+  },
+  "daily-min-spend": {
+    type: "string",
+    description: "Ad set spend limit under a DAILY campaign budget: spend at least this per day (best effort)"
+  },
+  "daily-spend-cap": {
+    type: "string",
+    description: "Ad set spend limit under a DAILY campaign budget: spend at most this per day. Example: --daily-spend-cap 15"
+  },
+  "lifetime-min-spend": {
+    type: "string",
+    description: "Ad set spend limit under a LIFETIME campaign budget: spend at least this in total"
+  },
+  "lifetime-spend-cap": {
+    type: "string",
+    description: "Ad set spend limit under a LIFETIME campaign budget: spend at most this in total"
+  },
+  attribution: {
+    type: "string",
+    description: "Attribution windows Meta optimizes on: 1d_click or 7d_click, plus 1d_view and/or 1d_engaged_view \u2014 conversion goals only; LINK_CLICKS, LANDING_PAGE_VIEWS and REACH take 1d_click alone. Fixed when the ad set is created: Meta refuses a change on a live ad set. Example: --attribution 7d_click,1d_view"
+  }
+};
+var budgetBoostArg = {
+  "budget-boost": {
+    type: "string",
+    description: "Raise the daily budget for a high-demand period, repeatable: START..END=+AMOUNT or START..END=+PERCENT% (max 800%), at least 3 hours, on quarter hours, all amounts or all percentages. Needs --daily-budget in the same command (the current one, on update). Example: --budget-boost 2027-11-27T00:00Z..2027-11-28T00:00Z=+50%"
+  }
+};
+var CLEAR_FLAGS = {
+  "daily-min-spend": "dailyMinSpendTarget",
+  "daily-spend-cap": "dailySpendCap",
+  "lifetime-min-spend": "lifetimeMinSpendTarget",
+  "lifetime-spend-cap": "lifetimeSpendCap",
+  schedule: "adset_schedule",
+  boosts: "budgetSchedules",
+  "budget-boost": "budgetSchedules"
+};
+var NOT_CLEARABLE = {
+  "min-roas": "a ROAS floor goes with ROAS goal bidding \u2014 switch --bid-strategy (e.g. LOWEST_COST_WITHOUT_CAP) and Baker drops the floor",
+  "frequency-cap": "Meta keeps a frequency cap on a reach ad set whatever is sent (an empty cap is accepted and ignored) \u2014 set another with --frequency-cap"
+};
+function clearFromFlags(rawArgs, entity) {
+  const names = repeatedValues(rawArgs, "clear", void 0).flatMap((value) => value.split(",")).map((value) => value.trim().toLowerCase()).filter(Boolean);
+  if (names.length === 0) return void 0;
+  const fields = names.map((name) => {
+    const why = NOT_CLEARABLE[name];
+    if (why) throw new Error(`--clear ${name}: ${why}`);
+    const field = CLEAR_FLAGS[name];
+    if (!field || entity === "campaign" && field !== "budgetSchedules") {
+      const takes = entity === "campaign" ? "boosts" : Object.keys(CLEAR_FLAGS).join(", ");
+      throw new Error(`--clear takes ${takes} \u2014 not "${name}"`);
+    }
+    return field;
+  });
+  return [...new Set(fields)];
+}
+var clearArg = {
+  clear: {
+    type: "string",
+    description: "Take a delivery control away (repeatable or comma-separated): daily-min-spend, daily-spend-cap, lifetime-min-spend, lifetime-spend-cap, schedule (back to standard pacing), boosts (every budget boost it has now). A ROAS floor goes by switching --bid-strategy; Meta keeps a reach ad set's frequency cap."
+  }
+};
+
+export {
+  dayPartingFromFlags,
+  adSetDeliveryFromFlags,
+  budgetBoostsFromFlags,
+  boostEditsFromFlags,
+  boostEditArgs,
+  adSetDeliveryArgs,
+  budgetBoostArg,
+  clearFromFlags,
+  clearArg
+};
+//# sourceMappingURL=chunk-CP4P6YKM.js.map

package/dist/chunk-CP4P6YKM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/meta/delivery-flags.ts"],"sourcesContent":["import { repeatedValues } from \"../../../lib/repeatedFlags.ts\";\nimport { failWriteValidation, parseDateFlag, parseMoneyFlag } from \"./write-shared.ts\";\n\n/**\n * The delivery-control flags of `campaigns`/`adsets create|update`, read into\n * the staged payload: a minimum ROAS, a frequency cap, an ad schedule and\n * pacing, ad set spend limits, Dynamic Creative, attribution windows and\n * budget boosts (high-demand periods). Each flag is a compact spelling of one\n * Meta field; `--file` still takes Meta's own shapes for anything these miss.\n */\n\ntype Args = Record<string, unknown>;\n\nfunction text(value: unknown): string | undefined {\n  return typeof value === \"string\" && value.length > 0 ? value : undefined;\n}\n\n/** `2/7` → at most 2 impressions per person every 7 days. */\nfunction frequencyCapFlag(value: unknown): Record<string, unknown>[] | undefined {\n  const raw = text(value);\n  if (raw === undefined) {\n    return undefined;\n  }\n  const match = /^(\\d+)\\s*\\/\\s*(\\d+)\\s*d?$/i.exec(raw.trim());\n  if (!match) {\n    failWriteValidation(\n      `--frequency-cap takes N/D — at most N impressions per person every D days, e.g. 2/7 (got \"${raw}\")`,\n    );\n  }\n  return [{ event: \"IMPRESSIONS\", interval_days: Number(match[2]), max_frequency: Number(match[1]) }];\n}\n\nconst DAY_INDEX: Record<string, number> = { sun: 0, mon: 1, tue: 2, wed: 3, thu: 4, fri: 5, sat: 6 };\n\nfunction dayIndex(name: string, flag: string): number {\n  const index = DAY_INDEX[name.slice(0, 3).toLowerCase()];\n  if (index === undefined) {\n    failWriteValidation(`${flag}: \"${name}\" is not a day — use Mon, Tue, … Sun`);\n  }\n  return index;\n}\n\n/** `Mon-Fri`, `sat,sun`, `daily` → Meta's day numbers (0 = Sunday). */\nfunction scheduleDays(spec: string): number[] {\n  if (/^(daily|every ?day|all)$/i.test(spec)) {\n    return [0, 1, 2, 3, 4, 5, 6];\n  }\n  return spec.split(\",\").flatMap((part) => {\n    const [from, to] = part.split(\"-\").map((day) => day.trim());\n    if (!from) {\n      return [];\n    }\n    const start = dayIndex(from, \"--schedule\");\n    if (!to) {\n      return [start];\n    }\n    const end = dayIndex(to, \"--schedule\");\n    const days: number[] = [];\n    for (let day = start; days.length < 7; day = (day + 1) % 7) {\n      days.push(day);\n      if (day === end) break;\n    }\n    return days;\n  });\n}\n\nfunction hourMinute(value: string): number {\n  const [hours = \"\", minutes = \"0\"] = value.split(\":\");\n  return Number(hours) * 60 + Number(minutes);\n}\n\n/** `Mon-Fri 09-18` → one ad schedule block. */\nfunction scheduleBlock(raw: string, timezone: string): Record<string, unknown> {\n  const match = /^(.+?)\\s+(\\d{1,2}(?::\\d{2})?)\\s*-\\s*(\\d{1,2}(?::\\d{2})?)$/.exec(raw.trim());\n  if (!match?.[1] || !match[2] || !match[3]) {\n    failWriteValidation(\n      `--schedule takes \"<days> <from>-<to>\", e.g. \"Mon-Fri 09-18\" or \"sat,sun 10:00-14:00\" (got \"${raw}\")`,\n    );\n  }\n  return {\n    days: scheduleDays(match[1]),\n    start_minute: hourMinute(match[2]),\n    end_minute: hourMinute(match[3]),\n    timezone_type: timezone,\n  };\n}\n\n/** Every `--schedule` as Meta's day-parting blocks with no clock named — a reach-and-frequency quote takes them so. */\nexport function dayPartingFromFlags(args: Args, rawArgs: readonly string[] | undefined): unknown[] | undefined {\n  const blocks = repeatedValues(rawArgs, \"schedule\", args.schedule).map((block) => {\n    const { timezone_type: _clock, ...rest } = scheduleBlock(block, \"USER\");\n    return rest;\n  });\n  return blocks.length > 0 ? blocks : undefined;\n}\n\nfunction scheduleTimezone(value: unknown): string {\n  const raw = text(value)?.toLowerCase();\n  if (raw === undefined || raw === \"viewer\" || raw === \"user\") {\n    return \"USER\";\n  }\n  if (raw === \"account\" || raw === \"advertiser\") {\n    return \"ADVERTISER\";\n  }\n  failWriteValidation(`--schedule-timezone takes viewer or account (got \"${raw}\")`);\n}\n\nconst ATTRIBUTION_EVENTS: Record<string, string> = {\n  click: \"CLICK_THROUGH\",\n  view: \"VIEW_THROUGH\",\n  engaged_view: \"ENGAGED_VIDEO_VIEW\",\n  engaged_video_view: \"ENGAGED_VIDEO_VIEW\",\n};\n\n/** `7d_click,1d_view` → Meta's attribution_spec. */\nfunction attributionFlag(value: unknown): Record<string, unknown>[] | undefined {\n  const raw = text(value);\n  if (raw === undefined) {\n    return undefined;\n  }\n  return raw.split(\",\").map((window) => {\n    const match = /^(\\d+)d_([a-z_]+)$/i.exec(window.trim());\n    const event = match?.[2] ? ATTRIBUTION_EVENTS[match[2].toLowerCase()] : undefined;\n    if (!match || !event) {\n      failWriteValidation(`--attribution takes windows like 7d_click,1d_view,1d_engaged_view (got \"${window}\")`);\n    }\n    return { event_type: event, window_days: Number(match[1]) };\n  });\n}\n\nfunction numberArg(value: unknown, flag: string): number | undefined {\n  const raw = text(value);\n  if (raw === undefined) {\n    return undefined;\n  }\n  const n = Number(raw);\n  if (!Number.isFinite(n)) {\n    failWriteValidation(`${flag} must be a number`);\n  }\n  return n;\n}\n\n/** The ad set delivery controls the flags name; keys a flag left unset stay undefined. */\nexport function adSetDeliveryFromFlags(args: Args, rawArgs: readonly string[] | undefined): Record<string, unknown> {\n  const timezone = scheduleTimezone(args[\"schedule-timezone\"]);\n  const blocks = repeatedValues(rawArgs, \"schedule\", args.schedule).map((block) => scheduleBlock(block, timezone));\n  if (args[\"schedule-timezone\"] !== undefined && blocks.length === 0) {\n    failWriteValidation(\n      \"--schedule-timezone says whose clock --schedule follows, so it goes with --schedule — pass the hours again with it\",\n    );\n  }\n  const delivery: Record<string, unknown> = {\n    minRoas: numberArg(args[\"min-roas\"], \"--min-roas\"),\n    frequency_control_specs: frequencyCapFlag(args[\"frequency-cap\"]),\n    adset_schedule: blocks.length > 0 ? blocks : undefined,\n    pacing: text(args.pacing)?.toLowerCase(),\n    dailyMinSpendTarget: parseMoneyFlag(args[\"daily-min-spend\"], args.currency, \"--daily-min-spend\"),\n    dailySpendCap: parseMoneyFlag(args[\"daily-spend-cap\"], args.currency, \"--daily-spend-cap\"),\n    lifetimeMinSpendTarget: parseMoneyFlag(args[\"lifetime-min-spend\"], args.currency, \"--lifetime-min-spend\"),\n    lifetimeSpendCap: parseMoneyFlag(args[\"lifetime-spend-cap\"], args.currency, \"--lifetime-spend-cap\"),\n    is_dynamic_creative: args[\"dynamic-creative\"] === undefined ? undefined : Boolean(args[\"dynamic-creative\"]),\n    attribution_spec: attributionFlag(args.attribution),\n  };\n  return Object.fromEntries(Object.entries(delivery).filter(([, value]) => value !== undefined));\n}\n\n/** `START..END=+25` (an amount) or `START..END=+50%` (a percentage) → one high-demand period. */\nfunction budgetBoost(raw: string, currency: unknown): Record<string, unknown> {\n  const match = /^(.+?)\\.\\.(.+?)=\\+?(\\d+(?:\\.\\d{1,3})?)(%?)$/.exec(raw.trim());\n  if (!match?.[1] || !match[2] || !match[3]) {\n    failWriteValidation(\n      `--budget-boost takes START..END=+AMOUNT or START..END=+PERCENT%, e.g. 2027-11-27T00:00Z..2027-11-28T00:00Z=+50% (got \"${raw}\")`,\n    );\n  }\n  const period = {\n    time_start: parseDateFlag(match[1], \"--budget-boost start\"),\n    time_end: parseDateFlag(match[2], \"--budget-boost end\"),\n  };\n  return match[4] === \"%\"\n    ? { ...period, increasePercent: Number(match[3]) }\n    : { ...period, increase: parseMoneyFlag(match[3], currency, \"--budget-boost\") };\n}\n\n/** Every `--budget-boost`, or undefined when none was given. */\nexport function budgetBoostsFromFlags(args: Args, rawArgs: readonly string[] | undefined): unknown[] | undefined {\n  const boosts = repeatedValues(rawArgs, \"budget-boost\", args[\"budget-boost\"]);\n  return boosts.length > 0 ? boosts.map((boost) => budgetBoost(boost, args.currency)) : undefined;\n}\n\n/** `ID=START..END` → one live boost moved to a new window. */\nfunction boostMove(raw: string): Record<string, unknown> {\n  const match = /^(\\d+)=(.+?)\\.\\.(.+)$/.exec(raw.trim());\n  if (!match?.[1] || !match[2] || !match[3]) {\n    failWriteValidation(\n      `--move-boost takes ID=START..END, e.g. 1633135568548763=2027-11-27T06:00Z..2027-11-27T12:00Z (got \"${raw}\")`,\n    );\n  }\n  return {\n    id: match[1],\n    time_start: parseDateFlag(match[2], \"--move-boost start\"),\n    time_end: parseDateFlag(match[3], \"--move-boost end\"),\n  };\n}\n\n/** Every `--remove-boost` and `--move-boost` on a live campaign or ad set. */\nexport function boostEditsFromFlags(args: Args, rawArgs: readonly string[] | undefined): Record<string, unknown> {\n  const removed = repeatedValues(rawArgs, \"remove-boost\", args[\"remove-boost\"])\n    .flatMap((value) => value.split(\",\"))\n    .map((value) => value.trim())\n    .filter(Boolean);\n  const moved = repeatedValues(rawArgs, \"move-boost\", args[\"move-boost\"]);\n  return {\n    ...(removed.length > 0 ? { removeBoosts: removed } : {}),\n    ...(moved.length > 0 ? { moveBoosts: moved.map(boostMove) } : {}),\n  };\n}\n\nexport const boostEditArgs = {\n  \"remove-boost\": {\n    type: \"string\",\n    description:\n      \"Take one budget boost away, by its id from `baker ads meta high-demand-periods --campaign-id <id>` — repeatable or comma-separated. The others stay.\",\n  },\n  \"move-boost\": {\n    type: \"string\",\n    description:\n      \"Move one budget boost to another window, keeping its raise: ID=START..END, repeatable, at least 3 hours, on quarter hours. Meta has no boost update, so publish adds the same raise on the new window, then deletes the old boost. Example: --move-boost 1633135568548763=2027-11-27T06:00Z..2027-11-27T12:00Z\",\n  },\n} as const;\n\n/** Arg definitions for the ad set delivery-control flags, shared by create and update. */\nexport const adSetDeliveryArgs = {\n  \"min-roas\": {\n    type: \"string\",\n    description:\n      \"Minimum ROAS for LOWEST_COST_WITH_MIN_ROAS bidding, as a multiple of spend: 2.5 = 250%. Needs --optimization-goal VALUE. Under a min-ROAS campaign budget every ad set needs its own. Example: --bid-strategy LOWEST_COST_WITH_MIN_ROAS --min-roas 2.5\",\n  },\n  \"frequency-cap\": {\n    type: \"string\",\n    description:\n      \"At most N impressions per person every D days, as N/D — REACH and THRUPLAY goals only. Example: --frequency-cap 2/7\",\n  },\n  schedule: {\n    type: \"string\",\n    description:\n      'Run ads only in these hours (dayparting), repeatable: \"<days> <from>-<to>\", whole hours. Needs --lifetime-budget and --end. Example: --schedule \"Mon-Fri 09-18\" --schedule \"Sat 10-14\"',\n  },\n  \"schedule-timezone\": {\n    type: \"string\",\n    description: \"Whose clock --schedule follows: viewer (default) or account\",\n  },\n  pacing: {\n    type: \"string\",\n    description:\n      \"standard (default) | no_pacing (accelerated — spends as fast as it can; LOWEST_COST_WITH_BID_CAP only) | day_parting (set by --schedule)\",\n  },\n  \"daily-min-spend\": {\n    type: \"string\",\n    description: \"Ad set spend limit under a DAILY campaign budget: spend at least this per day (best effort)\",\n  },\n  \"daily-spend-cap\": {\n    type: \"string\",\n    description:\n      \"Ad set spend limit under a DAILY campaign budget: spend at most this per day. Example: --daily-spend-cap 15\",\n  },\n  \"lifetime-min-spend\": {\n    type: \"string\",\n    description: \"Ad set spend limit under a LIFETIME campaign budget: spend at least this in total\",\n  },\n  \"lifetime-spend-cap\": {\n    type: \"string\",\n    description: \"Ad set spend limit under a LIFETIME campaign budget: spend at most this in total\",\n  },\n  attribution: {\n    type: \"string\",\n    description:\n      \"Attribution windows Meta optimizes on: 1d_click or 7d_click, plus 1d_view and/or 1d_engaged_view — conversion goals only; LINK_CLICKS, LANDING_PAGE_VIEWS and REACH take 1d_click alone. Fixed when the ad set is created: Meta refuses a change on a live ad set. Example: --attribution 7d_click,1d_view\",\n  },\n} as const;\n\nexport const budgetBoostArg = {\n  \"budget-boost\": {\n    type: \"string\",\n    description:\n      \"Raise the daily budget for a high-demand period, repeatable: START..END=+AMOUNT or START..END=+PERCENT% (max 800%), at least 3 hours, on quarter hours, all amounts or all percentages. Needs --daily-budget in the same command (the current one, on update). Example: --budget-boost 2027-11-27T00:00Z..2027-11-28T00:00Z=+50%\",\n  },\n} as const;\n\nconst CLEAR_FLAGS: Readonly<Record<string, string>> = {\n  \"daily-min-spend\": \"dailyMinSpendTarget\",\n  \"daily-spend-cap\": \"dailySpendCap\",\n  \"lifetime-min-spend\": \"lifetimeMinSpendTarget\",\n  \"lifetime-spend-cap\": \"lifetimeSpendCap\",\n  schedule: \"adset_schedule\",\n  boosts: \"budgetSchedules\",\n  \"budget-boost\": \"budgetSchedules\",\n};\n\nconst NOT_CLEARABLE: Readonly<Record<string, string>> = {\n  \"min-roas\":\n    \"a ROAS floor goes with ROAS goal bidding — switch --bid-strategy (e.g. LOWEST_COST_WITHOUT_CAP) and Baker drops the floor\",\n  \"frequency-cap\":\n    \"Meta keeps a frequency cap on a reach ad set whatever is sent (an empty cap is accepted and ignored) — set another with --frequency-cap\",\n};\n\n/**\n * What `--clear` takes away (repeatable or comma-separated), named by the\n * flag that set it. A campaign clears only its budget boosts.\n */\nexport function clearFromFlags(\n  rawArgs: readonly string[] | undefined,\n  entity: \"adSet\" | \"campaign\",\n): string[] | undefined {\n  const names = repeatedValues(rawArgs, \"clear\", undefined)\n    .flatMap((value) => value.split(\",\"))\n    .map((value) => value.trim().toLowerCase())\n    .filter(Boolean);\n  if (names.length === 0) return undefined;\n  const fields = names.map((name) => {\n    const why = NOT_CLEARABLE[name];\n    if (why) throw new Error(`--clear ${name}: ${why}`);\n    const field = CLEAR_FLAGS[name];\n    if (!field || (entity === \"campaign\" && field !== \"budgetSchedules\")) {\n      const takes = entity === \"campaign\" ? \"boosts\" : Object.keys(CLEAR_FLAGS).join(\", \");\n      throw new Error(`--clear takes ${takes} — not \"${name}\"`);\n    }\n    return field;\n  });\n  return [...new Set(fields)];\n}\n\nexport const clearArg = {\n  clear: {\n    type: \"string\",\n    description:\n      \"Take a delivery control away (repeatable or comma-separated): daily-min-spend, daily-spend-cap, lifetime-min-spend, lifetime-spend-cap, schedule (back to standard pacing), boosts (every budget boost it has now). A ROAS floor goes by switching --bid-strategy; Meta keeps a reach ad set's frequency cap.\",\n  },\n} as const;\n"],"mappings":"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","names":[]}