@koda-sl/baker-cli 0.514.0 → 0.515.0-dev.8df53bffe

package/dist/site-AI3BFWRK.js

@@ -0,0 +1,180 @@
+import {
+  SiteArgsError,
+  failSite,
+  parseSetArgs
+} from "./chunk-RGR6TSTJ.js";
+import "./chunk-NZ34KM46.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-MUS2UTWU.js";
+import {
+  apiGet,
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import {
+  optionalChatId,
+  requireChatId
+} from "./chunk-LGK7UWBN.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/site/index.ts
+import { readFileSync } from "fs";
+import { defineCommand } from "citty";
+registerSchema({
+  command: "site.show",
+  description: "Start here: the company's site settings as they will be after this chat publishes \u2014 cookie consent (consent), what Baker records (analyticsCollection), search engines (indexing), the home page (homePage, null = the first published landing), time zone, download format (exportProfile, null = default) and custom domains with their status \u2014 plus `staged`: what this chat changed, each with before/after. Hints name other open chats that already staged a site setting. Read-only.",
+  args: {
+    chat: {
+      type: "string",
+      description: "Read another chat's staged settings instead of this chat's (a chat id from `baker chats list`)",
+      required: false
+    }
+  }
+});
+registerSchema({
+  command: "site.set",
+  description: "Stage one or more site settings in one call; all apply when the chat is published, none mid-chat. Combine flags freely: `baker site set --consent recovery --indexing on`. Restaging a setting replaces what this chat staged before. Any member's chat may change these \u2014 the person who publishes is the review. --consent: bypass (no banner, maximum tracking), recovery (banner; declines still send anonymized pings \u2014 the usual EU choice), strict (banner; declines send nothing), external (the site's own consent tool). --collection: full, aggregate (counts only, nobody identifiable), off (Baker records nothing). --home takes a published landing slug (or one this chat is building); \"none\" restores the default. Always ask the user before hiding the site from search engines or reducing what Baker records.",
+  args: {
+    consent: { type: "string", description: "bypass | recovery | strict | external", required: false },
+    collection: { type: "string", description: "full | aggregate | off", required: false },
+    payloads: {
+      type: "string",
+      description: "on | off \u2014 keep a copy of each lead (only with --collection full)",
+      required: false
+    },
+    indexing: { type: "string", description: "on | off \u2014 show the site in search engines", required: false },
+    home: { type: "string", description: "Landing slug to serve at the site root, or none", required: false },
+    "home-mode": {
+      type: "string",
+      description: "rewrite (default; the root shows the landing) | redirect (the root sends visitors to /<slug>)",
+      required: false
+    },
+    timezone: { type: "string", description: "IANA time zone, e.g. Europe/Madrid", required: false },
+    "export-profile": {
+      type: "string",
+      description: 'Only the download-format fields to change, as JSON (e.g. {"htmlOutput":"fragment"}) or @path/to/profile.json. A second call adds to the first; Publish lays them over the format saved then',
+      required: false
+    }
+  }
+});
+registerSchema({
+  command: "site.unstage",
+  description: "Take back a site setting this chat staged, before publish \u2014 the same as discarding its row in the chat's Settings review. The key is the setting (consent, analyticsCollection, indexing, homePage, timezone, exportProfile) or customDomain:<hostname>; --all takes back every one. Never touches what is already live.",
+  args: {
+    key: { type: "string", description: "A `key` from `baker site show` \u2192 staged", required: false },
+    all: { type: "boolean", description: "Take back every staged site setting", required: false }
+  }
+});
+var showCommand = defineCommand({
+  meta: {
+    name: "show",
+    description: "Show the site settings as they will be after this chat publishes, and what this chat staged.\n\nExample: baker site show"
+  },
+  args: {
+    chat: { type: "string", description: "Another chat's id, to read what it staged", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const chatId = typeof args.chat === "string" && args.chat.length > 0 ? args.chat : optionalChatId();
+      writeJson(await apiGet("/api/site", chatId ? { chatId } : void 0));
+    } catch (err) {
+      failSite(err);
+    }
+  }
+});
+var setCommand = defineCommand({
+  meta: {
+    name: "set",
+    description: "Stage site settings; they apply when the chat is published.\n\nExamples:\n  baker site set --consent recovery\n  baker site set --collection aggregate\n  baker site set --indexing off\n  baker site set --home oferta --home-mode redirect\n  baker site set --home none\n  baker site set --timezone Europe/Madrid\n  baker site set --export-profile @profile.json"
+  },
+  args: {
+    consent: { type: "string", description: "bypass | recovery | strict | external", required: false },
+    collection: { type: "string", description: "full | aggregate | off", required: false },
+    payloads: { type: "string", description: "on | off (with --collection full)", required: false },
+    indexing: { type: "string", description: "on | off", required: false },
+    home: { type: "string", description: "Landing slug, or none", required: false },
+    "home-mode": { type: "string", description: "rewrite | redirect", required: false },
+    timezone: { type: "string", description: "IANA time zone", required: false },
+    "export-profile": {
+      type: "string",
+      description: "Fields to change, as JSON or @path; added to any staged earlier, laid over the saved format at Publish",
+      required: false
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const inputs = parseSetArgs(
+        {
+          consent: args.consent,
+          collection: args.collection,
+          payloads: args.payloads,
+          indexing: args.indexing,
+          home: args.home,
+          "home-mode": args["home-mode"],
+          timezone: args.timezone,
+          "export-profile": args["export-profile"]
+        },
+        (path) => readFileSync(path, "utf8")
+      );
+      const body = { chatId: requireChatId(), inputs };
+      writeJson(await apiPost("/api/site/stage", body));
+    } catch (err) {
+      failSite(err);
+    }
+  }
+});
+var unstageCommand = defineCommand({
+  meta: {
+    name: "unstage",
+    description: "Take back a staged site setting before publish.\n\nExamples:\n  baker site unstage consent\n  baker site unstage customDomain:shop.acme.com\n  baker site unstage --all"
+  },
+  args: {
+    key: { type: "positional", description: "The setting key from `baker site show` \u2192 staged", required: false },
+    all: { type: "boolean", description: "Take back every staged site setting", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const key = typeof args.key === "string" && args.key.length > 0 ? args.key : void 0;
+      if (key === void 0 === (args.all !== true)) {
+        throw new SiteArgsError("Pass one setting key (see `baker site show` \u2192 staged) or --all.");
+      }
+      const body = { chatId: requireChatId(), ...key ? { key } : { all: true } };
+      writeJson(await apiPost("/api/site/draft-op/remove", body));
+    } catch (err) {
+      failSite(err);
+    }
+  }
+});
+var siteCommand = defineCommand({
+  meta: {
+    name: "site",
+    description: `The company's site settings: cookie consent, what Baker records, search engines, home page, time zone, landing download format, custom domains. Every change stages on this chat and applies when it is published. Subcommands: show, set, unstage, domain.
+
+Examples:
+  baker site show
+  baker site set --consent recovery --indexing on
+  baker site set --home oferta
+  baker site domain add shop.acme.com
+  baker site unstage homePage
+Full guide: __tooling__/docs/tools/baker/site.md`
+  },
+  subCommands: {
+    show: showCommand,
+    set: setCommand,
+    unstage: unstageCommand,
+    domain: () => import("./domain-A66DHOTQ.js").then((m) => m.domainCommand)
+  }
+});
+export {
+  siteCommand
+};
+//# sourceMappingURL=site-AI3BFWRK.js.map

package/dist/sources-AOF2YDYX.js

@@ -0,0 +1,457 @@
+import {
+  hubspotDefaultMapping,
+  hubspotTriggerInputSchema
+} from "./chunk-N2QX57K3.js";
+import {
+  hubspotRefusal
+} from "./chunk-KMY7AD3N.js";
+import "./chunk-NEYWS2DQ.js";
+import "./chunk-GRQ2AXDX.js";
+import {
+  ConversionArgsError,
+  onlyOnce
+} from "./chunk-NB2FU6EZ.js";
+import "./chunk-JOE42ZW6.js";
+import {
+  SOURCE_FIELD_NAMES,
+  mappingRowProblem,
+  templateMentions
+} from "./chunk-NKQWDEB7.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-ZRP7Y2DM.js";
+import "./chunk-SAAXU7QR.js";
+import {
+  HUBSPOT_DEAL_CONTACTS,
+  HUBSPOT_OBJECTS,
+  REJECTION_MESSAGES,
+  readsAssociatedContact,
+  validateEventName
+} from "./chunk-NZ34KM46.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-MUS2UTWU.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/analytics/sources.ts
+import { defineCommand } from "citty";
+var args = {
+  server: {
+    type: "boolean",
+    description: "The client's own server door: one address for their developers, made once and the same for ever after, counting at once in Baker's own format (`baker analytics sending-events` has the contract). Prints it; nothing else to set",
+    required: false
+  },
+  create: {
+    type: "boolean",
+    description: "Make an address for a tool that cannot be told what to send (a CRM webhook, an automation step). Needs --name. Its first send is kept as a sample and counted as nothing until --map",
+    required: false
+  },
+  "create-hubspot": {
+    type: "boolean",
+    description: "Make a HubSpot event: HubSpot keeps each change to --property for Baker (Baker's app subscribes the account to that property with the condition as HubSpot's own filter, and nothing else), and every contact whose new value satisfies --operator --value is an event, counted within a minute. Needs --property (names, kinds and operators from `baker hubspot contacts properties`); --operator defaults to `is`; --value repeats for a list (`is` on a dropdown) or a between; --name is optional and defaults to the trigger's words; --field rows (names from `baker hubspot contacts fields`) replace the default rows they name. Counts from now on, never earlier contacts",
+    required: false
+  },
+  "create-activecampaign": {
+    type: "boolean",
+    description: "Make an ActiveCampaign event source: when this chat is published, ActiveCampaign's own webhook is set up on the account to send --events here, and each one counts as `activecampaign.<event>` (a contact subscribing is `activecampaign.subscribe`) from then on \u2014 a scheduled agent can run on any of them (`baker scheduled-agents create --trigger event.received --event activecampaign.deal_update`). --events defaults to subscribe,contact_tag_added,deal_add,deal_update; --name to ActiveCampaign; --account picks the connection when there are several. Removing the source takes the webhook off the account",
+    required: false
+  },
+  events: {
+    type: "string",
+    description: "With --create-activecampaign: ActiveCampaign's events, comma-separated \u2014 subscribe, unsubscribe, update, contact_tag_added, contact_tag_removed, subscriber_note, contact_task_add, sent, open, click, reply, forward, share, bounce, list_add, deal_add, deal_update, deal_note_add, deal_task_add, deal_task_complete, deal_pipeline_add, deal_stage_add, deal_tasktype_add, account_add, account_update, account_contact_add, account_contact_update",
+    required: false
+  },
+  account: {
+    type: "string",
+    description: "With --create-activecampaign: which ActiveCampaign connection, by id, when the company has more than one (the refusal lists them)",
+    required: false
+  },
+  "set-trigger": {
+    type: "boolean",
+    description: "Change what a HubSpot event watches. Needs --source and the same --property --operator --value as --create-hubspot. The rows stay; it counts from now on under the new trigger",
+    required: false
+  },
+  preview: {
+    type: "boolean",
+    description: "Ask HubSpot what --property --operator --value would count today, and read one real contact \u2014 the one most recently there, or --contact \u2014 with the properties the --field rows mention (the defaults when none), to check every row against real data BEFORE --create-hubspot. Makes nothing",
+    required: false
+  },
+  object: {
+    type: "string",
+    description: "With --create-hubspot or --preview: what the trigger is on \u2014 `contact` (the default), `deal` or `lead`. A deal's and a lead's event is about the contact the record is associated with: its rows read the record's own properties bare ({{amount}}, {{dealstage}}, {{hs_pipeline_stage}}) and the contact's as {{contact.<name>}} (`baker hubspot deals fields` / `baker hubspot leads fields`). A deal's amount defaults to its own amount in its currency; a lead has none, so it counts the step rather than money. Use `lead` for qualification and disqualification \u2014 HubSpot records both as a lead stage, and nothing on the contact or the deal says a lead was disqualified",
+    required: false
+  },
+  contacts: {
+    type: "string",
+    description: "With --object deal or --object lead (on --create-hubspot or --set-trigger): whose event it is \u2014 `every` (the default: every contact on the record, each its own event; on a deal each worth the deal's amount) or `first` (the record's first contact only)",
+    required: false
+  },
+  property: {
+    type: "string",
+    description: "With --create-hubspot, --set-trigger or --preview: the property to watch, by HubSpot's internal name (lifecyclestage, hs_lead_status, a custom one on a contact; dealstage, amount, closedate on a deal; hs_pipeline_stage, hs_lead_label on a lead) \u2014 any property, whatever its kind",
+    required: false
+  },
+  operator: {
+    type: "string",
+    description: "With --property: how the property has to read. By the property's kind \u2014 select: is, isNot, isEmpty, isNotEmpty \xB7 text: is, isNot, contains, doesNotContain, startsWith, endsWith, isEmpty, isNotEmpty \xB7 number: equal, notEqual, lessThan, lessThanOrEqual, greaterThan, greaterThanOrEqual, isEmpty, isNotEmpty \xB7 date: is, isBefore, isAfter, isOnOrBefore, isOnOrAfter, isBetween, isEmpty, isNotEmpty \xB7 yes/no: is, isNot. `is` when unsaid",
+    required: false
+  },
+  value: {
+    type: "string",
+    description: "With --property: the value, as HubSpot spells it \u2014 a dropdown's internal value (customer, QUALIFIED\u2026), a number, a YYYY-MM-DD, true/false. Repeat it for a list (--value lead --value customer) or the two ends of isBetween; none for isEmpty / isNotEmpty",
+    required: false
+  },
+  conditions: {
+    type: "string",
+    description: 'With --create-hubspot, --set-trigger or --preview, instead of --property/--operator/--value: several conditions combined the way a Form\'s filter combines them, as JSON \u2014 `{"logic":"And","conditions":[{"property":"lifecyclestage","values":["customer"]},{"logic":"Or","conditions":[{"property":"country","values":["Spain"]},{"property":"amount","operator":"greaterThan","values":["1000"]}]}]}`. `logic` is And (every row) or Or (any row); a row is a condition or a group with its own logic, one level deep; at most 10 conditions. The event fires when a change to any named property makes the whole combination hold',
+    required: false
+  },
+  contact: {
+    type: "string",
+    description: "With --preview: the record to draw the sample from \u2014 a HubSpot id, or text to search (an email or a name for a contact, a deal's or a lead's name). The one most recently satisfying the trigger when unsaid",
+    required: false
+  },
+  "amount-property": {
+    type: "string",
+    description: "With --create-hubspot or --set-amount: a NUMBER property of the watched object to read as the event's amount (a deal value synced onto the contact; a deal's own `amount` is read by default on a deal). Needs --currency beside it",
+    required: false
+  },
+  currency: {
+    type: "string",
+    description: "With --amount-property: the three-letter currency the property is in, like EUR or USD",
+    required: false
+  },
+  "set-amount": {
+    type: "boolean",
+    description: "Change where a HubSpot-read source takes its amount from. Needs --source; with --amount-property and --currency it reads them, with neither it stops reading an amount",
+    required: false
+  },
+  backfill: {
+    type: "boolean",
+    description: "Count a HubSpot event's history: every moment its trigger came to hold since --since, at the instant HubSpot says it did. Needs --source and --since. Nothing is invented \u2014 a record that merely satisfies the trigger today is not an event today, and only moments HubSpot has a timestamp for are counted. Dry without --write. Reach for it when an event was made after the deals it should have counted, or after fixing one that was refusing everything it received",
+    required: false
+  },
+  since: {
+    type: "string",
+    description: "With --backfill: the date to count this event's history from, `2026-09-19` or an ISO instant. At most 400 days back \u2014 the store keeps no more",
+    required: false
+  },
+  before: {
+    type: "string",
+    description: "With --backfill: carry on from where a capped run stopped, by passing back the `reachedBack` it returned. One run reads at most 500 records, most recently changed first, so a capped run has covered the newest and the rest are the ones nearest --since \u2014 narrowing --since cannot reach them, this can. Repeat until `capped` is false; nothing is counted twice. It bounds which records are read, never which of their moments count: those are still the whole of --since to now",
+    required: false
+  },
+  write: {
+    type: "boolean",
+    description: "With --backfill: actually count what it found. Without it nothing is counted and the answer says what would be. Events inside the last 72 hours are uploaded to this event's ad platforms within minutes of counting, which spends real budget",
+    required: false
+  },
+  name: {
+    type: "string",
+    description: "The tool the source is for \u2014 HubSpot, Zapier, Stripe. It is the event's name when the payload does not say one, and every event it sends carries it as `baker_source`",
+    required: false
+  },
+  map: {
+    type: "boolean",
+    description: "Set what each field is read from. For an address this starts counting; needs --source, and one --field per row. With no --field the guess is used, which is right for a tool already sending Baker's own format. For a HubSpot-read source it replaces the whole mapping (the row list is on the source as `mapping`; empty means HubSpot's standard properties), so repeat every row you want kept",
+    required: false
+  },
+  source: { type: "string", description: "The source id, from the list", required: false },
+  field: {
+    type: "string",
+    description: `<field>=<template>, repeatable. A template is text with {{path}} mentions, one thing per mention: --field email={{contact.email}} --field currency=EUR --field first_name="{{who.first}} {{who.last}}". A bare path (--field email=contact.email) is read as its mention when the sample has that path, so the short spelling still works. Fields: ${SOURCE_FIELD_NAMES.join(", ")}. An EXTRA PROPERTY of the event \u2014 a plan, a stage, anything Measure \u2192 Events should break it down by and a send may pass on to a platform \u2014 is --field properties.<name>=<template>, e.g. --field properties.plan={{plan_tier}}. Paths come from \`paths\` on the source's sample; for a HubSpot event they are contact property names (\`baker hubspot contacts fields\`) plus \`id\` for the contact id`,
+    required: false
+  },
+  pause: {
+    type: "boolean",
+    description: "Stop counting a source's arrivals; they are answered and dropped. Needs --source",
+    required: false
+  },
+  resume: { type: "boolean", description: "Count a paused source's arrivals again. Needs --source", required: false },
+  remove: {
+    type: "boolean",
+    description: "Delete a source; its address stops working at once. Needs --source",
+    required: false
+  },
+  full: {
+    type: "boolean",
+    description: "Also return each source's masked sample body. The paths and the guess are always returned; the body is only for reading what a path held",
+    required: false
+  }
+};
+registerSchema({
+  command: "analytics.sources",
+  description: "Where events reach Baker from a server: the client's own server door, HubSpot events Baker reads, and ActiveCampaign events its webhook sends \u2014 what each one watches and reads, and how it is doing",
+  args
+});
+function flagValueAt(argv, flag, index) {
+  const arg = argv[index] ?? "";
+  if (arg === flag) return argv[index + 1];
+  return arg.startsWith(`${flag}=`) ? arg.slice(flag.length + 1) : void 0;
+}
+function parseRepeated(argv, flag) {
+  const values = [];
+  for (let index = 0; index < argv.length; index += 1) {
+    const value = flagValueAt(argv, flag, index);
+    if (value !== void 0) values.push(value);
+  }
+  return values;
+}
+function parseFieldArgs(argv) {
+  const mapping = {};
+  for (const pair of parseRepeated(argv, "--field")) {
+    const eq = pair.indexOf("=");
+    const field = eq === -1 ? pair : pair.slice(0, eq);
+    const path = eq === -1 ? "" : pair.slice(eq + 1).trim();
+    const problem = mappingRowProblem(field);
+    if (problem !== null) throw new ConversionArgsError(problem);
+    if (path === "") throw new ConversionArgsError(`--field ${field} needs a path: --field ${field}=<dotted.path>.`);
+    mapping[field] = path;
+  }
+  return mapping;
+}
+function amountArgs(raw, argv) {
+  const amountProperty = onlyOnce(raw["amount-property"], "--amount-property", argv);
+  const currency = onlyOnce(raw.currency, "--currency", argv);
+  if (amountProperty === void 0 !== (currency === void 0)) {
+    throw new ConversionArgsError("--amount-property and --currency go together: name both or neither.");
+  }
+  return {
+    ...amountProperty === void 0 ? {} : { amountProperty },
+    ...currency === void 0 ? {} : { currency }
+  };
+}
+var NO_VALUE_OPERATORS = /* @__PURE__ */ new Set(["isEmpty", "isNotEmpty"]);
+function triggerArgs(raw, argv, verb) {
+  const conditions = onlyOnce(raw.conditions, "--conditions", argv);
+  if (conditions !== void 0) return conditionsArg(conditions, raw, verb);
+  const property = onlyOnce(raw.property, "--property", argv);
+  const operator = onlyOnce(raw.operator, "--operator", argv) ?? "is";
+  const values = argv.length === 0 && typeof raw.value === "string" ? [raw.value] : parseRepeated(argv, "--value");
+  if (property === void 0) {
+    throw new ConversionArgsError(
+      `--${verb} needs --property <name> [--operator <op>] --value <value>\u2026, from \`baker hubspot contacts properties\`.`
+    );
+  }
+  if (values.length === 0 && !NO_VALUE_OPERATORS.has(operator)) {
+    throw new ConversionArgsError(
+      `--${verb} needs --value <value> (repeat it for a list); only --operator isEmpty / isNotEmpty take none.`
+    );
+  }
+  return { property, operator, values };
+}
+function conditionsArg(text, raw, verb) {
+  if (raw.property !== void 0 || raw.value !== void 0 || raw.operator !== void 0) {
+    throw new ConversionArgsError(`--${verb} takes --conditions or --property/--operator/--value, not both.`);
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(text);
+  } catch {
+    throw new ConversionArgsError(
+      '--conditions is JSON: {"logic":"And","conditions":[{"property":"lifecyclestage","values":["customer"]}]}.'
+    );
+  }
+  const checked = hubspotTriggerInputSchema.safeParse(parsed);
+  if (!checked.success) {
+    throw new ConversionArgsError(`--conditions: ${checked.error.issues.map((issue) => issue.message).join("; ")}`);
+  }
+  return parsed;
+}
+function objectArg(raw, argv) {
+  const object = onlyOnce(raw.object, "--object", argv) ?? "contact";
+  if (!HUBSPOT_OBJECTS.includes(object)) {
+    throw new ConversionArgsError(`--object is one of ${HUBSPOT_OBJECTS.join(", ")}, not "${object}".`);
+  }
+  return object;
+}
+function contactsArg(raw, argv) {
+  const contacts = onlyOnce(raw.contacts, "--contacts", argv);
+  if (contacts === void 0) return void 0;
+  if (!HUBSPOT_DEAL_CONTACTS.includes(contacts)) {
+    throw new ConversionArgsError(`--contacts is one of ${HUBSPOT_DEAL_CONTACTS.join(", ")}, not "${contacts}".`);
+  }
+  return contacts;
+}
+function createHubspotArgs(raw, argv, name) {
+  const mapping = parseFieldArgs(argv);
+  const object = objectArg(raw, argv);
+  const contacts = contactsArg(raw, argv);
+  if (contacts !== void 0 && !readsAssociatedContact(object)) {
+    throw new ConversionArgsError(
+      "--contacts says whose event a deal's or a lead's is; it needs --object deal or --object lead."
+    );
+  }
+  return {
+    // A contact is the wire's default, so it is left unsaid — the way the schema reads it back.
+    ...object === "contact" ? {} : { object },
+    trigger: triggerArgs(raw, argv, "create-hubspot"),
+    ...contacts === void 0 ? {} : { contacts },
+    ...name === void 0 ? {} : { name },
+    ...Object.keys(mapping).length === 0 ? {} : { mapping },
+    ...amountArgs(raw, argv)
+  };
+}
+function previewArgs(raw, argv) {
+  const rows = parseFieldArgs(argv);
+  const object = objectArg(raw, argv);
+  const templates = Object.values(Object.keys(rows).length === 0 ? hubspotDefaultMapping("", object) : rows);
+  const properties = [...new Set(templates.flatMap((template) => templateMentions(template ?? "")))];
+  const contact = onlyOnce(raw.contact, "--contact", argv);
+  return {
+    ...object === "contact" ? {} : { object },
+    trigger: triggerArgs(raw, argv, "preview"),
+    properties,
+    ...contact === void 0 ? {} : { contact }
+  };
+}
+var VERBS = [
+  "server",
+  "create",
+  "create-hubspot",
+  "create-activecampaign",
+  "set-trigger",
+  "preview",
+  "backfill",
+  "set-amount",
+  "map",
+  "pause",
+  "resume",
+  "remove"
+];
+function checkedName(raw, argv) {
+  const name = onlyOnce(raw.name, "--name", argv);
+  if (name === void 0 || validateEventName(name) === null) return name;
+  throw new ConversionArgsError(
+    `"${name}" cannot be an event name, and the name is what every event this source raises will carry. ${REJECTION_MESSAGES.invalid_name}`
+  );
+}
+function backfillArgs(raw, argv, sourceId) {
+  const since = onlyOnce(raw.since, "--since", argv);
+  if (since === void 0) {
+    throw new ConversionArgsError(
+      "--backfill needs --since <date>, e.g. --since 2026-09-19. Nothing before it is read."
+    );
+  }
+  const before = onlyOnce(raw.before, "--before", argv);
+  return {
+    sourceId,
+    since,
+    ...before === void 0 ? {} : { before },
+    ...raw.write === true ? { write: true } : {}
+  };
+}
+function createActiveCampaignArgs(raw, argv, name) {
+  const events = onlyOnce(raw.events, "--events", argv);
+  const account = onlyOnce(raw.account, "--account", argv);
+  return {
+    ...name === void 0 ? {} : { name },
+    ...events === void 0 ? {} : {
+      events: events.split(",").map((item) => item.trim()).filter((item) => item !== "")
+    },
+    ...account === void 0 ? {} : { account }
+  };
+}
+function createRequest(verb, raw, argv, name) {
+  if (verb === "create") {
+    if (name === void 0) throw new ConversionArgsError("--create needs --name <tool>.");
+    return { create: { name } };
+  }
+  if (verb === "create-hubspot") return { createHubspot: createHubspotArgs(raw, argv, name) };
+  if (verb === "create-activecampaign") return { createActiveCampaign: createActiveCampaignArgs(raw, argv, name) };
+  return null;
+}
+function sourcesRequest(raw, argv) {
+  const name = checkedName(raw, argv);
+  const source = onlyOnce(raw.source, "--source", argv);
+  const verbs = VERBS.filter((verb2) => raw[verb2] === true);
+  if (verbs.length > 1) throw new ConversionArgsError(`One of --${verbs.join(", --")} per call.`);
+  const verb = verbs[0];
+  if (verb === void 0) return {};
+  if (verb === "server") return { server: {} };
+  const made = createRequest(verb, raw, argv, name);
+  if (made !== null) return made;
+  if (verb === "preview") return { preview: previewArgs(raw, argv) };
+  if (source === void 0) throw new ConversionArgsError(`--${verb} needs --source <id>, from the list.`);
+  if (verb === "backfill") return { backfill: backfillArgs(raw, argv, source) };
+  if (verb === "set-trigger") {
+    const contacts = contactsArg(raw, argv);
+    return {
+      setTrigger: {
+        sourceId: source,
+        trigger: triggerArgs(raw, argv, verb),
+        ...contacts === void 0 ? {} : { contacts }
+      }
+    };
+  }
+  if (verb === "set-amount") return { setAmount: { sourceId: source, ...amountArgs(raw, argv) } };
+  if (verb === "map") return { map: { sourceId: source, mapping: parseFieldArgs(argv) } };
+  return { [verb]: { sourceId: source } };
+}
+function handleError(err) {
+  if (err instanceof ApiError) {
+    const refusal = hubspotRefusal(err.code, err.message);
+    writeJsonEnvelope({
+      ok: false,
+      error: refusal === null ? { code: err.code, message: err.message } : { code: refusal.code, message: err.message, fix: refusal.fix }
+    });
+    process.exit(1);
+  }
+  writeJsonEnvelope({
+    ok: false,
+    error: { code: "NETWORK_ERROR", message: err instanceof Error ? err.message : "Unexpected error" }
+  });
+  process.exit(1);
+}
+var sourcesCommand = defineCommand({
+  meta: {
+    name: "sources",
+    description: 'Where events reach Baker from a server, and what each one reads. Two doors. **The client\'s own server**: `--server` prints one address for their developers \u2014 made once, the same for ever, counting at once, Baker\'s own `POST /v1/events` format (`baker analytics sending-events` has the contract, `X-Baker-Mode: test` rehearses). **HubSpot events**: HubSpot keeps each change to a watched property in a journal Baker reads every half minute \u2014 Baker\'s app subscribes the account to that one property with the condition as HubSpot\'s own filter, so an account with a million contacts costs nothing to watch \u2014 on every plan, nothing to set up in HubSpot. The trigger is *when a contact\'s* property satisfies a condition \u2014 the same conditions a Form\'s filters take: `--property lifecyclestage --value customer` (a dropdown; `--value lead --value customer` for either), `--property deal_value --operator greaterThan --value 1000`, `--property email --operator endsWith --value @acme.com`, `--property closed_at --operator isAfter --value 2026-01-01`, `--property phone --operator isEmpty`. Several conditions combine the way a Form\'s filter does \u2014 `--conditions \'{"logic":"And","conditions":[{"property":"lifecyclestage","values":["customer"]},{"property":"country","values":["Spain"]}]}\'` (AND / OR, groups one level deep, 10 conditions at most) in place of --property/--operator/--value, on --create-hubspot, --set-trigger and --preview; the event fires when a change to any named property makes the whole combination hold. `baker hubspot contacts properties` lists every property with its kind, the operators that kind takes and a dropdown\'s values; `baker hubspot contacts fields` every property a row can read. `--preview --property \u2026 [--operator \u2026] --value \u2026 [--field \u2026] [--contact <id or email>]` says how many contacts satisfy it today (NOT counted \u2014 only contacts that come to satisfy it from now on are) and reads one real contact so every row can be checked against real data; then `--create-hubspot --property \u2026 --value \u2026 --name "Deal won" --field email={{work_email}} --field value={{deal_value}} --field currency=EUR` makes the event, rows over the defaults (email, phone, the contact id, name, address, hs_google_click_id, hs_facebook_click_id). `--set-trigger --source <id> --property \u2026 --operator \u2026 --value \u2026` changes what an event watches later (rows kept, counting from now on). Every row is a template \u2014 text with {{property}} mentions, one thing per mention; `--map --source <id> --field \u2026` replaces the whole row set later, `--amount-property <number property> --currency EUR` is the short spelling for the amount rows. Each event is an ordinary event named after the source, carrying `baker_source`, listed by `feed --source <name>`, counted with `conversions` under `page:<name>`, and sent to the ad platforms with `sends`. **ActiveCampaign events**: `--create-activecampaign [--events subscribe,deal_update] [--name \u2026] [--account <id>]` stages a source that the ActiveCampaign webhook sends to once the chat is published; each arrival is an event called `activecampaign.<event>` \u2014 whatever the source is called \u2014 carrying the contact and the rest of the ActiveCampaign payload as `properties.*` (the stage of a deal, the tag, the campaign), which is what a scheduled agent on `event.received --event activecampaign.<event>` runs on. `--pause`, `--resume`, `--remove` by --source; removing an ActiveCampaign source deletes its webhook. `--create --name <tool>` still makes an address for a tool that cannot be told what to send; its first send is a masked sample counted as nothing until `--map` confirms the rows.'
+  },
+  args,
+  run: async ({ args: raw }) => {
+    try {
+      const request = sourcesRequest(raw, process.argv);
+      const response = await apiPost("/api/analytics/sources", request);
+      const full = raw.full === true;
+      const sources = response.data.sources.map((source) => {
+        const { sample, ...rest } = source;
+        return full || sample === void 0 ? source : { ...rest, sample: { receivedAt: sample.receivedAt } };
+      });
+      writeJsonEnvelope({
+        ok: true,
+        data: {
+          sources,
+          ...response.data.preview === void 0 ? {} : { preview: response.data.preview },
+          ...response.data.staged === void 0 ? {} : { staged: response.data.staged }
+        },
+        ...response.hints && response.hints.length > 0 ? { hints: response.hints } : {}
+      });
+    } catch (err) {
+      if (err instanceof ConversionArgsError) {
+        handleError(new ApiError("VALIDATION_ERROR", err.message));
+      }
+      handleError(err);
+    }
+  }
+});
+export {
+  parseFieldArgs,
+  parseRepeated,
+  sourcesCommand,
+  sourcesRequest
+};
+//# sourceMappingURL=sources-AOF2YDYX.js.map

package/dist/sources-DVMJEXEX.js

@@ -0,0 +1,30 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/testimonials/sources/index.ts
+import { defineCommand } from "citty";
+var sourcesCommand = defineCommand({
+  meta: {
+    name: "sources",
+    description: `The review pages the testimonials come from: Google Maps, Trustpilot, Yelp, Tripadvisor, G2, Capterra, Amazon, App Store, Google Play. Subcommands: add, list, sync, schedule, reset, remove.
+
+Examples:
+  baker testimonials sources add https://www.trustpilot.com/review/acme.com
+  baker testimonials sources list
+  baker testimonials sources sync <source-id>
+  baker testimonials sources schedule <source-id> --every monthly
+  baker testimonials sources reset <source-id>     # unstick an import that never finished
+  baker testimonials sources remove <source-id>`
+  },
+  subCommands: {
+    add: () => import("./add-YCJ6RXPG.js").then((m) => m.addCommand),
+    list: () => import("./list-3HOASRXD.js").then((m) => m.listCommand),
+    sync: () => import("./sync-2AI7LKKN.js").then((m) => m.syncCommand),
+    schedule: () => import("./schedule-UTRVEWPE.js").then((m) => m.scheduleCommand),
+    reset: () => import("./reset-DD37KDXQ.js").then((m) => m.resetCommand),
+    remove: () => import("./remove-6LE3XNRG.js").then((m) => m.removeCommand)
+  }
+});
+export {
+  sourcesCommand
+};
+//# sourceMappingURL=sources-DVMJEXEX.js.map