@koda-sl/baker-cli 0.512.0 → 0.514.0

package/dist/chunk-TVAIOC77.js

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

package/dist/chunk-TVTSA4EN.js

@@ -1,188 +0,0 @@
-import {
-  analyticsErrorEnvelope
-} from "./chunk-D3KLDIPQ.js";
-import {
-  PEOPLE_SEARCH_MAX_TERMS,
-  parsePeopleQuery,
-  peopleLookupRequestSchema
-} from "./chunk-7J3NZBPV.js";
-import {
-  writeJsonEnvelope
-} from "./chunk-ZRP7Y2DM.js";
-import {
-  apiPost
-} from "./chunk-X7VQFLHI.js";
-import {
-  registerSchema
-} from "./chunk-Q7US4OOA.js";
-
-// src/commands/analytics/lookup.ts
-import { readFileSync } from "fs";
-import { defineCommand } from "citty";
-function peopleArgs(args2) {
-  const parts = peopleParts(args2);
-  if (parts.length === 0) return {};
-  const people = parsePeopleQuery(parts).terms.map((term) => term.input);
-  return people.length === 0 ? {} : { people };
-}
-function peopleParts(args2) {
-  return [...args2.person ? [String(args2.person)] : [], ...args2["people-file"] ? [readPeopleFile(args2)] : []];
-}
-function readPeopleFile(args2) {
-  try {
-    return readFileSync(String(args2["people-file"]), "utf8");
-  } catch {
-    return "";
-  }
-}
-function unreadablePeopleFile(args2) {
-  if (!args2["people-file"]) return void 0;
-  const path = String(args2["people-file"]);
-  try {
-    readFileSync(path, "utf8");
-    return void 0;
-  } catch {
-    return `Couldn't read --people-file ${path}. Check the path, or pass the people inline with --person.`;
-  }
-}
-function peopleLimitError(args2) {
-  const unreadable = unreadablePeopleFile(args2);
-  if (unreadable !== void 0) return unreadable;
-  const { terms, dropped } = parsePeopleQuery(peopleParts(args2));
-  if (dropped === 0) return void 0;
-  return `${terms.length + dropped} people named; one search takes up to ${PEOPLE_SEARCH_MAX_TERMS}. Split the list and run each part.`;
-}
-function compactRow(row) {
-  const clicks = [...row.googleClick ? ["google"] : [], ...row.metaClick ? ["meta"] : []];
-  const candidates = {
-    input: row.input,
-    readAs: row.kind,
-    found: row.found,
-    problem: row.problem,
-    contacts: row.contacts,
-    events: row.events,
-    firstSeen: row.firstSeen,
-    lastSeen: row.lastSeen,
-    pageViews: row.pageViews,
-    landings: row.landings,
-    visits: row.visits,
-    formSubmits: row.formSubmits,
-    firstSource: row.firstSource,
-    systemEvents: row.systemEvents,
-    pageEvents: row.pageEvents,
-    uploads: row.uploads,
-    uploadedTo: row.uploadedTo,
-    clicks,
-    knownBy: row.knownBy
-  };
-  return Object.fromEntries(
-    Object.entries(candidates).filter(
-      ([key, value]) => key === "found" || !(value === 0 || value === "" || Array.isArray(value) && value.length === 0)
-    )
-  );
-}
-function lookupHints(data) {
-  const hints = [];
-  if (data.dropped > 0) {
-    hints.push(
-      `${data.dropped} lines past the limit of ${PEOPLE_SEARCH_MAX_TERMS} were not looked up. Run the rest separately.`
-    );
-  }
-  const unseen = data.people.filter((row) => !row.found && row.problem === "");
-  if (unseen.length > 0) {
-    hints.push(
-      `Not seen by Baker: ${unseen.map((row) => row.input).join(", ")}. Baker knows a person by what its pages, Forms and connected systems recorded \u2014 a lead that came in through a form or site Baker does not measure, or a source not connected, is not here.`
-    );
-  }
-  for (const row of data.people.filter((person) => person.problem !== "")) {
-    hints.push(`${row.input}: ${row.problem}`);
-  }
-  const found = data.people.filter((row) => row.found);
-  const neverVisited = found.filter((row) => row.pageViews === 0);
-  if (neverVisited.length > 0) {
-    hints.push(
-      `${neverVisited.length} of ${found.length} found never visited a page Baker publishes: Baker knows them only from what their systems reported, so no landing can be credited with them.`
-    );
-  }
-  if (found.length > 0) {
-    hints.push(
-      `\`baker analytics feed --person '${found[0]?.input}' --days 90\` lists everything one of them did, in order \u2014 add more, comma-separated, to follow several.`
-    );
-  }
-  return hints;
-}
-function lookupReport(data, full = false) {
-  const found = data.people.filter((row) => row.found);
-  return {
-    summary: {
-      searched: data.people.length,
-      found: found.length,
-      notFound: data.people.length - found.length,
-      visitedABakerPage: found.filter((row) => row.pageViews > 0).length
-    },
-    people: full ? data.people : data.people.map(compactRow),
-    hints: lookupHints(data)
-  };
-}
-var NO_PEOPLE = "Name at least one person: --person 'ana@empresa.com, deal:40001234567' or --people-file leads.txt.";
-var args = {
-  person: {
-    type: "string",
-    description: "The people, comma-separated: an email, a phone (+34\u2026), a HubSpot contact id, deal:<HubSpot deal id>, a gclid/fbclid, a browser id. Prefix to be exact: email:, phone:, hubspot:, deal:, gclid:, fbclid:, browser:",
-    required: false
-  },
-  "people-file": {
-    type: "string",
-    description: "A file with one person per line \u2014 a column pasted from a CRM export",
-    required: false
-  },
-  full: {
-    type: "boolean",
-    description: "Every field of every line, zeros included",
-    required: false
-  }
-};
-registerSchema({
-  command: "analytics.lookup",
-  description: "What Baker saw of each person in a list, by email, phone, CRM id, deal or click id",
-  args
-});
-var lookupCommand = defineCommand({
-  meta: {
-    name: "lookup",
-    description: `What Baker saw of each person in a list \u2014 all time, one line each \u2014 by whatever the client holds about them. The reconciliation question: "HubSpot says 26 leads yesterday, which of them does Baker have, and where did they come from".
-
-Start here:
-  baker analytics lookup --person 'ana@empresa.com, +34600111222, 90001234567'
-  baker analytics lookup --person 'deal:40001234567, deal:40001234568'   \u2014 HubSpot deal ids, looked up through the deal's contacts
-  baker analytics lookup --people-file leads.txt                           \u2014 one per line, up to ${PEOPLE_SEARCH_MAX_TERMS}
-
-Each line says whether Baker has them, when it first and last saw them, the pages and Forms they touched, what their systems reported (systemEvents: CRM stages, orders), what Baker uploaded for them to ad platforms, which ad click they carried, and every kind of key they are linked by. A bare number is read as a HubSpot contact id or a phone; prefix it to be exact. Emails and phones are hashed by Baker \u2014 say them to the client as they gave them, never as a hash. Follow one with \`baker analytics feed --person <same value>\`.`
-  },
-  args,
-  run: async ({ args: raw }) => {
-    const { people } = peopleArgs(raw);
-    const parsed = peopleLookupRequestSchema.safeParse({ people: people ?? [] });
-    const invalid = peopleLimitError(raw) ?? (parsed.success ? void 0 : NO_PEOPLE);
-    if (invalid !== void 0 || !parsed.success) {
-      writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message: invalid ?? NO_PEOPLE } });
-      process.exit(1);
-    }
-    try {
-      const response = await apiPost("/api/analytics/people", parsed.data);
-      const { hints, ...data } = lookupReport(response.data, raw.full === true);
-      writeJsonEnvelope({ ok: true, data, ...hints.length > 0 ? { hints } : {} });
-    } catch (error) {
-      writeJsonEnvelope({ ok: false, error: analyticsErrorEnvelope(error) });
-      process.exit(1);
-    }
-  }
-});
-
-export {
-  peopleArgs,
-  peopleLimitError,
-  lookupReport,
-  lookupCommand
-};
-//# sourceMappingURL=chunk-TVTSA4EN.js.map