@koda-sl/baker-cli 0.501.0-dev.6e96f50b9 → 0.502.0

package/dist/chunk-5YFQPJVS.js

@@ -0,0 +1,287 @@
+import {
+  failWriteValidation,
+  parseDateFlag,
+  parseMoneyFlag
+} from "./chunk-6R2BU3FJ.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-5YFQPJVS.js.map

package/dist/chunk-5YQATOWK.js

@@ -0,0 +1,66 @@
+import {
+  recordIdeaLines
+} from "./chunk-PFGRHBQY.js";
+import {
+  anchorLines,
+  readIdeaAnchor
+} from "./chunk-VOAWBGRQ.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-EJGAJHLB.js";
+
+// src/commands/creatives/idea-hint.ts
+import path from "path";
+function present(fields) {
+  const said = Object.entries(fields).filter(([, v]) => v !== void 0 && !(Array.isArray(v) && v.length === 0));
+  return Object.fromEntries(said);
+}
+function anchorOut(view, full) {
+  const reference = view.reference ? {
+    ...present({ adId: view.reference.adId, advertiser: view.advertiser }),
+    carry: view.reference.carry,
+    mustKeep: view.reference.mustKeep
+  } : void 0;
+  const compact = present({
+    message: view.message,
+    language: view.language,
+    reference,
+    seriesLead: view.seriesLead,
+    accent: view.accent,
+    cast: view.cast,
+    who: view.who,
+    survives: view.survives
+  });
+  if (!full) return compact;
+  return {
+    ...compact,
+    ...present({ why: view.why, voices: view.voices, voiceIds: view.voiceIds, route: view.route }),
+    changes: view.changes
+  };
+}
+function ideaHint(view) {
+  return `Its idea: ${anchorLines(view).join(" \xB7 ").replace(
+    /[.!?…]+$/u,
+    ""
+  )}. An edit keeps it: change exactly what they named; a change of the idea they asked for is one line under "## Changes" in _definition.md, the reason after the dash.`;
+}
+function withAnchor(response, view, opts) {
+  return {
+    ...response,
+    data: { ...response.data, anchor: anchorOut(view, opts.full) },
+    hints: [ideaHint(view), ...response.hints ?? []]
+  };
+}
+async function readCreativeIdea(slug) {
+  const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();
+  const read = await readIdeaAnchor(path.join(root, "src", "creatives", slug));
+  if (!read) return null;
+  await recordIdeaLines(path.join(root, "canvas"), slug, anchorLines(read.view)).catch(() => void 0);
+  return read.view;
+}
+
+export {
+  withAnchor,
+  readCreativeIdea
+};
+//# sourceMappingURL=chunk-5YQATOWK.js.map