@koda-sl/baker-cli 0.316.1 → 0.319.0

package/dist/cli.js

@@ -13271,6 +13271,172 @@ var STEP_SUBMIT_TRIGGERS = Object.fromEntries(
 );
 var MAX_CONVERSION_NAME = 80;
 
+// ../api/src/event-ingest/matching.ts
+var MATCH_FIELDS = [
+  "first_name",
+  "last_name",
+  "date_of_birth",
+  "gender",
+  "city",
+  "region",
+  "postal_code",
+  "country"
+];
+var MATCH_COOKIES = ["fbp", "fbc"];
+function tightened(value) {
+  const stripped = value.toLowerCase().replace(/[^\p{L}\p{N}]/gu, "");
+  return stripped === "" ? null : stripped;
+}
+function loosened(value) {
+  const collapsed = value.trim().toLowerCase().replace(/\s+/g, " ");
+  return collapsed === "" ? null : collapsed;
+}
+function birthDate(value) {
+  const digits = value.replace(/\D/g, "");
+  if (!/^\d{8}$/.test(digits)) return null;
+  const month = Number(digits.slice(4, 6));
+  const day = Number(digits.slice(6, 8));
+  if (month < 1 || month > 12 || day < 1 || day > 31) return null;
+  return digits;
+}
+function genderLetter(value) {
+  const first = value.trim().toLowerCase().charAt(0);
+  return first === "f" || first === "m" ? first : null;
+}
+function countryCode(value) {
+  const code = value.trim().toLowerCase();
+  return /^[a-z]{2}$/.test(code) ? code : null;
+}
+var MATCH_SPECS = {
+  first_name: { keep: "hashed", normalize: tightened, meta: "fn", google: "hashed_first_name" },
+  last_name: { keep: "hashed", normalize: tightened, meta: "ln", google: "hashed_last_name" },
+  // Meta only. Google's enhanced conversions have no date of birth, so there is
+  // no destination wanting it in the clear and every reason not to keep one.
+  date_of_birth: { keep: "hashed", normalize: birthDate, meta: "db", google: null },
+  gender: { keep: "plain", normalize: genderLetter, meta: "ge", google: null },
+  city: { keep: "plain", normalize: loosened, meta: "ct", google: "city" },
+  region: { keep: "plain", normalize: loosened, meta: "st", google: "state" },
+  postal_code: { keep: "plain", normalize: loosened, meta: "zp", google: "postal_code" },
+  country: { keep: "plain", normalize: countryCode, meta: "country", google: "country_code" }
+};
+var MATCH_FIELD_FORWARDING = [
+  { field: "email", meta: "em", google: "hashed_email", hashed: true },
+  { field: "phone", meta: "ph", google: "hashed_phone_number", hashed: true },
+  // Kept in the clear — see `resolveOwnId`. The digest is still computed and
+  // still stored beside it, so a Meta forward has one; what changed is that the
+  // sender's own key is now readable, which is the entire reason they sent it.
+  { field: "external_id", meta: "external_id", google: null, hashed: false },
+  ...MATCH_FIELDS.map((field) => ({
+    field,
+    meta: MATCH_SPECS[field].meta,
+    google: MATCH_SPECS[field].google,
+    hashed: MATCH_SPECS[field].keep === "hashed"
+  })),
+  { field: "fbp", meta: "fbp", google: null, hashed: false },
+  { field: "fbc", meta: "fbc", google: null, hashed: false }
+];
+
+// ../api/src/event-ingest/vocabulary.ts
+var INGEST_CLICK_ID_PARAMS = [
+  "gclid",
+  "wbraid",
+  "gbraid",
+  "dclid",
+  "fbclid",
+  "ttclid",
+  "twclid",
+  "li_fat_id",
+  "msclkid",
+  "rdt_cid",
+  "epik",
+  "sccid"
+];
+
+// ../api/src/event-sources/fields.ts
+var MATCH_LABELS = {
+  first_name: "First name",
+  last_name: "Last name",
+  date_of_birth: "Date of birth",
+  gender: "Gender",
+  city: "City",
+  region: "Region",
+  postal_code: "Postcode",
+  country: "Country"
+};
+var CLICK_LABELS = {
+  gclid: "Google click id",
+  wbraid: "Google click id (iOS, web to app)",
+  gbraid: "Google click id (iOS, app)",
+  dclid: "Google click id (Display & Video)",
+  fbclid: "Meta click id",
+  ttclid: "TikTok click id",
+  twclid: "X click id",
+  li_fat_id: "LinkedIn click id",
+  msclkid: "Microsoft click id",
+  rdt_cid: "Reddit click id",
+  epik: "Pinterest click id",
+  sccid: "Snapchat click id"
+};
+var SOURCE_FIELDS = [
+  { field: "event_name", label: "What happened", group: "event" },
+  { field: "event_time", label: "When it happened", group: "event" },
+  { field: "event_id", label: "Its id", group: "event" },
+  { field: "email", label: "Email", group: "person" },
+  { field: "phone", label: "Phone", group: "person" },
+  { field: "external_id", label: "Your own id for the person", group: "person" },
+  ...MATCH_FIELDS.map((field) => ({ field, label: MATCH_LABELS[field], group: "person" })),
+  { field: "value", label: "Amount", group: "money" },
+  { field: "currency", label: "Currency", group: "money" },
+  ...INGEST_CLICK_ID_PARAMS.map((field) => ({ field, label: CLICK_LABELS[field], group: "click" }))
+];
+var SOURCE_FIELD_NAMES = SOURCE_FIELDS.map((spec) => spec.field);
+var FIELD_SET = new Set(SOURCE_FIELD_NAMES);
+function isSourceField(value) {
+  return FIELD_SET.has(value);
+}
+var PROPERTY_ROW_PREFIX = "properties.";
+var PROPERTY_KEY_MAX = 64;
+var PROPERTY_KEY = /^[A-Za-z0-9_][A-Za-z0-9_.-]*$/;
+var RESERVED_PROPERTY_KEYS = ["baker_source", "hubspot_property", "hubspot_value"];
+function isPropertyRow(row) {
+  return row.startsWith(PROPERTY_ROW_PREFIX);
+}
+function propertyKeyOf(row) {
+  return isPropertyRow(row) ? row.slice(PROPERTY_ROW_PREFIX.length) : null;
+}
+function propertyKeyProblem(key) {
+  const trimmed = key.trim();
+  if (trimmed === "") return "A property needs a name.";
+  if (trimmed.length > PROPERTY_KEY_MAX) return `A property name is at most ${PROPERTY_KEY_MAX} characters.`;
+  if (!PROPERTY_KEY.test(trimmed)) {
+    return `"${trimmed}" is not a property name: letters, digits, underscore, dash and dot only, starting with a letter or digit.`;
+  }
+  if (RESERVED_PROPERTY_KEYS.includes(trimmed)) return `"${trimmed}" is written by Baker itself; pick another name.`;
+  return null;
+}
+function mappingRowProblem(row) {
+  if (isSourceField(row)) return null;
+  const key = propertyKeyOf(row);
+  if (key === null) {
+    return `"${row}" is not a field an event can carry. A field is one of ${SOURCE_FIELD_NAMES.join(", ")}; an extra property is spelled properties.<name>.`;
+  }
+  return propertyKeyProblem(key);
+}
+
+// ../api/src/event-sources/template.ts
+var MENTION = /\{\{\s*([^{}]+?)\s*\}\}/g;
+function mentionOf(path48) {
+  return `{{${path48}}}`;
+}
+function templateMentions(template) {
+  const seen = [];
+  for (const match of template.matchAll(MENTION)) {
+    const path48 = (match[1] ?? "").trim();
+    if (path48 !== "" && !seen.includes(path48)) seen.push(path48);
+  }
+  return seen;
+}
+
 // ../api/src/analytics/eventKey.ts
 var SEP = ":";
 function formEventKey(flowSlug, nodeId, triggerId) {
@@ -13305,6 +13471,106 @@ function parseEventKey(key) {
   }
 }
 
+// ../api/src/analytics/sends.ts
+var SEND_PLATFORMS = ["meta", "googleAds", "linkedinInsightTag", "twitterAds", "googleAnalytics"];
+function isSendPlatform(value) {
+  return SEND_PLATFORMS.includes(value);
+}
+var SEND_PLATFORM_SPECS = {
+  meta: {
+    title: "Meta",
+    eventMeans: "A Meta event name \u2014 Lead, Purchase, Schedule, or one of your own",
+    eventKind: "name",
+    credentialFields: ["accessToken", "datasetId"],
+    setupHint: "Add the Conversions API access token and dataset id to the Meta pixel in Tracking"
+  },
+  googleAds: {
+    title: "Google Ads",
+    eventMeans: "One of the account's conversion actions, picked from its list",
+    eventKind: "id",
+    credentialFields: ["oauthProviderId"],
+    setupHint: "Connect the Google Ads conversion tag to a Google Ads account in Tracking"
+  },
+  linkedinInsightTag: {
+    title: "LinkedIn",
+    eventMeans: "The id of a conversion rule in LinkedIn Campaign Manager",
+    eventKind: "id",
+    credentialFields: ["oauthProviderId"],
+    setupHint: "Connect the LinkedIn Insight Tag to a LinkedIn account in Tracking"
+  },
+  twitterAds: {
+    title: "X",
+    eventMeans: "The event tag id from X Events Manager, like tw-oka17-abc12",
+    eventKind: "id",
+    credentialFields: ["oauthProviderId"],
+    setupHint: "Connect the X pixel to an X Ads account in Tracking"
+  },
+  googleAnalytics: {
+    title: "Google Analytics",
+    eventMeans: "A GA4 event name \u2014 generate_lead, purchase, or one of your own",
+    eventKind: "name",
+    credentialFields: ["apiSecret"],
+    setupHint: "Add the Measurement Protocol API secret to the Google Analytics tag in Tracking"
+  }
+};
+var SEND_ORIGINS = ["server", "website", "any"];
+var MAX_SEND_ID = 64;
+var MAX_SEND_EVENT_KEY = 320;
+function sendEventIsTemplated(event) {
+  return templateMentions(event).length > 0;
+}
+function sendEventProblem(platform, event) {
+  if (!isSendPlatform(platform)) return null;
+  if (!sendEventIsTemplated(event)) return null;
+  const spec = SEND_PLATFORM_SPECS[platform];
+  if (spec.eventKind === "name") return null;
+  return `${spec.title} identifies a conversion by an id it issued, so it cannot be written from the event. Paste the id; pass what varies as an extra parameter instead.`;
+}
+
+// ../api/src/analytics/destinations.ts
+var CONVERSION_SEND_PREFIX = "conversionSend:";
+function isConversionSend(type) {
+  return type.startsWith(CONVERSION_SEND_PREFIX);
+}
+var SERVER_SIDE_SENDER_TAG = {
+  metaCapi: "meta",
+  googleAdsCapi: "googleAds",
+  linkedinCapi: "linkedinInsightTag",
+  twitterAdsCapi: "twitterAds",
+  ga4Mp: "googleAnalytics"
+};
+var DESTINATION_NAMES = {
+  email: "Email",
+  httpWebhook: "HTTP Webhook",
+  zapier: "Zapier",
+  tiktok: "TikTok Pixel",
+  pinterest: "Pinterest Tag",
+  googleTagManager: "Google Tag Manager",
+  amplitude: "Amplitude",
+  hotjar: "Hotjar",
+  clarity: "Microsoft Clarity",
+  hubspot: "HubSpot Events",
+  vwo: "VWO",
+  posthog: "PostHog",
+  datafast: "DataFast",
+  code: "Custom Code",
+  pipedrive: "Pipedrive",
+  googleSpreadsheet: "Google Sheets",
+  hubspotForm: "HubSpot Form",
+  goHighlevelContact: "GoHighLevel",
+  crmble: "Crmble"
+};
+function destinationKey(type) {
+  const platform = isConversionSend(type) ? type.slice(CONVERSION_SEND_PREFIX.length) : type;
+  return SERVER_SIDE_SENDER_TAG[platform] ?? platform;
+}
+function destinationName(type) {
+  if (type === "") return "";
+  const key = destinationKey(type);
+  if (isSendPlatform(key)) return SEND_PLATFORM_SPECS[key].title;
+  return DESTINATION_NAMES[key] ?? type;
+}
+
 // ../api/src/analytics/events.ts
 import { z as z28 } from "zod";
 
@@ -13464,11 +13730,15 @@ var analyticsBeaconClickIdsSchema = z28.object({
   gclid: z28.string().max(255).optional(),
   wbraid: z28.string().max(255).optional(),
   gbraid: z28.string().max(255).optional(),
+  dclid: z28.string().max(255).optional(),
   fbclid: z28.string().max(255).optional(),
   ttclid: z28.string().max(255).optional(),
   twclid: z28.string().max(255).optional(),
   liFatId: z28.string().max(255).optional(),
-  msclkid: z28.string().max(255).optional()
+  msclkid: z28.string().max(255).optional(),
+  rdtCid: z28.string().max(255).optional(),
+  epik: z28.string().max(255).optional(),
+  sccid: z28.string().max(255).optional()
 });
 var analyticsBeaconIdentitySchema = z28.object({
   /** Lowercase hex SHA-256. Anything else is dropped rather than stored. */
@@ -13624,218 +13894,169 @@ var analyticsBeaconPayloadSchema = z28.object({
   consent: z28.object({ analytics: z28.boolean() }).optional()
 });
 
-// ../api/src/event-ingest/matching.ts
-var MATCH_FIELDS = [
-  "first_name",
-  "last_name",
-  "date_of_birth",
-  "gender",
-  "city",
-  "region",
-  "postal_code",
-  "country"
-];
-var MATCH_COOKIES = ["fbp", "fbc"];
-function tightened(value) {
-  const stripped = value.toLowerCase().replace(/[^\p{L}\p{N}]/gu, "");
-  return stripped === "" ? null : stripped;
-}
-function loosened(value) {
-  const collapsed = value.trim().toLowerCase().replace(/\s+/g, " ");
-  return collapsed === "" ? null : collapsed;
-}
-function birthDate(value) {
-  const digits = value.replace(/\D/g, "");
-  if (!/^\d{8}$/.test(digits)) return null;
-  const month = Number(digits.slice(4, 6));
-  const day = Number(digits.slice(6, 8));
-  if (month < 1 || month > 12 || day < 1 || day > 31) return null;
-  return digits;
+// ../api/src/analytics/triggers.ts
+var TRIGGERS = {
+  "calendlyEvent.eventScheduled": {
+    what: "Call booked",
+    meaning: "Somebody picked a slot and confirmed it. This is the booking."
+  },
+  "calendlyEvent.dateAndTimeSelected": {
+    what: "Time picked",
+    meaning: "Somebody chose a slot but has not confirmed the booking yet."
+  },
+  "calendlyEvent.eventTypeViewed": {
+    what: "Calendar opened",
+    meaning: "The calendar appeared. Nobody has picked a time yet.",
+    lifecycle: true
+  },
+  "calendlyEvent.profilePageViewed": {
+    what: "Booking page shown",
+    meaning: "Calendly's own page appeared. Nobody has picked a time yet.",
+    lifecycle: true
+  },
+  "customForm.onFormSubmitted": {
+    what: "Form submitted",
+    meaning: "Somebody filled this step in and sent it."
+  },
+  "highlevelEvent.appointmentScheduled": {
+    what: "Appointment booked",
+    meaning: "Somebody picked a slot and confirmed it. This is the booking."
+  },
+  "highlevelEvent.calendarLoaded": {
+    what: "Calendar finished loading",
+    meaning: "The calendar appeared. Nobody has picked a time yet.",
+    lifecycle: true
+  },
+  "highlevelFormEvent.formSubmitted": {
+    what: "Form submitted",
+    meaning: "Somebody filled the form in and sent it."
+  },
+  "highlevelFormEvent.formLoaded": {
+    what: "Form finished loading",
+    meaning: "The form appeared. Nobody has typed anything yet.",
+    lifecycle: true
+  },
+  "hubspotForm.onFormSubmitted": {
+    what: "Form submitted",
+    meaning: "Somebody filled the form in and sent it. This is the one that means a lead."
+  },
+  "hubspotForm.onBeforeFormSubmit": {
+    what: "Form about to be sent",
+    meaning: "Fires an instant before the form is sent \u2014 not the same as it arriving.",
+    lifecycle: true
+  },
+  "hubspotForm.onFormReady": {
+    what: "Form finished loading",
+    meaning: "The form appeared. Nobody has typed anything yet.",
+    lifecycle: true
+  },
+  "hubspotForm.onBeforeFormInit": {
+    what: "Form starting to load",
+    meaning: "Fires before the form has even drawn. It only means the page was opened.",
+    lifecycle: true
+  },
+  "hubspotMeeting.onMeetingScheduled": {
+    what: "Meeting booked",
+    meaning: "Somebody picked a slot and confirmed it. This is the booking."
+  },
+  "link.onClick": {
+    what: "Link clicked",
+    meaning: "Somebody clicked the link on this step and left for wherever it points."
+  },
+  "savvycalEvent.scheduled": {
+    what: "Call booked",
+    meaning: "Somebody picked a slot and confirmed it. This is the booking."
+  },
+  "text.onTextDisplayed": {
+    what: "Screen shown",
+    meaning: "This screen appeared. On a thank-you screen that is the outcome; elsewhere it is not."
+  },
+  "text.onButtonClicked": {
+    what: "Button pressed",
+    meaning: "Somebody pressed the button on this screen."
+  }
+};
+function triggerDescription(triggerId) {
+  return TRIGGERS[triggerId];
 }
-function genderLetter(value) {
-  const first = value.trim().toLowerCase().charAt(0);
-  return first === "f" || first === "m" ? first : null;
+
+// ../api/src/analytics/feedNoise.ts
+var BOOKKEEPING_TYPES = /* @__PURE__ */ new Set([
+  "visitor_new",
+  "session_start",
+  "identify",
+  "form_step_view",
+  "side_effect_settled"
+]);
+var SUBMIT_TRIGGERS = new Set(Object.values(STEP_SUBMIT_TRIGGERS));
+function isEmbedLifecycle(row) {
+  return row.eventType === "form_trigger" && triggerDescription(row.triggerId)?.lifecycle === true;
 }
-function countryCode(value) {
-  const code = value.trim().toLowerCase();
-  return /^[a-z]{2}$/.test(code) ? code : null;
+function isBookkeepingRow(row) {
+  if (BOOKKEEPING_TYPES.has(row.eventType)) return true;
+  if (isEmbedLifecycle(row)) return true;
+  return row.eventType === "form_trigger" && SUBMIT_TRIGGERS.has(row.triggerId);
 }
-var MATCH_SPECS = {
-  first_name: { keep: "hashed", normalize: tightened, meta: "fn", google: "hashed_first_name" },
-  last_name: { keep: "hashed", normalize: tightened, meta: "ln", google: "hashed_last_name" },
-  // Meta only. Google's enhanced conversions have no date of birth, so there is
-  // no destination wanting it in the clear and every reason not to keep one.
-  date_of_birth: { keep: "hashed", normalize: birthDate, meta: "db", google: null },
-  gender: { keep: "plain", normalize: genderLetter, meta: "ge", google: null },
-  city: { keep: "plain", normalize: loosened, meta: "ct", google: "city" },
-  region: { keep: "plain", normalize: loosened, meta: "st", google: "state" },
-  postal_code: { keep: "plain", normalize: loosened, meta: "zp", google: "postal_code" },
-  country: { keep: "plain", normalize: countryCode, meta: "country", google: "country_code" }
-};
-var MATCH_FIELD_FORWARDING = [
-  { field: "email", meta: "em", google: "hashed_email", hashed: true },
-  { field: "phone", meta: "ph", google: "hashed_phone_number", hashed: true },
-  // Kept in the clear — see `resolveOwnId`. The digest is still computed and
-  // still stored beside it, so a Meta forward has one; what changed is that the
-  // sender's own key is now readable, which is the entire reason they sent it.
-  { field: "external_id", meta: "external_id", google: null, hashed: false },
-  ...MATCH_FIELDS.map((field) => ({
-    field,
-    meta: MATCH_SPECS[field].meta,
-    google: MATCH_SPECS[field].google,
-    hashed: MATCH_SPECS[field].keep === "hashed"
-  })),
-  { field: "fbp", meta: "fbp", google: null, hashed: false },
-  { field: "fbc", meta: "fbc", google: null, hashed: false }
-];
 
-// ../api/src/event-ingest/vocabulary.ts
-var INGEST_CLICK_ID_PARAMS = [
+// ../api/src/analytics/identityLinks.ts
+var IDENTITY_KEY_KINDS = [
+  "email",
+  "phone",
+  "external",
+  "browser",
   "gclid",
   "wbraid",
   "gbraid",
+  "dclid",
   "fbclid",
   "ttclid",
   "twclid",
   "li_fat_id",
-  "msclkid"
+  "msclkid",
+  "rdt_cid",
+  "epik",
+  "sccid",
+  "fbp",
+  "fbc"
 ];
+var ADDRESS_BOOK_FILL_KINDS = IDENTITY_KEY_KINDS.filter((kind) => kind !== "browser");
 
-// ../api/src/event-sources/fields.ts
-var MATCH_LABELS = {
-  first_name: "First name",
-  last_name: "Last name",
-  date_of_birth: "Date of birth",
-  gender: "Gender",
-  city: "City",
-  region: "Region",
-  postal_code: "Postcode",
-  country: "Country"
-};
-var CLICK_LABELS = {
-  gclid: "Google click id",
-  wbraid: "Google click id (iOS, web to app)",
-  gbraid: "Google click id (iOS, app)",
-  fbclid: "Meta click id",
-  ttclid: "TikTok click id",
-  twclid: "X click id",
-  li_fat_id: "LinkedIn click id",
-  msclkid: "Microsoft click id"
+// ../api/src/analytics/matchKeys.ts
+var CONTACT_KEYS = ["email", "phone", "external_id", "baker_id"];
+var MATCH_KEY_FIELDS = [...CONTACT_KEYS, ...INGEST_CLICK_ID_PARAMS, ...MATCH_COOKIES];
+var MATCH_KEY_LABELS = {
+  email: "email",
+  phone: "phone",
+  external_id: "external ID",
+  baker_id: "Baker ID",
+  gclid: "Google click",
+  wbraid: "Google click (wbraid)",
+  gbraid: "Google click (gbraid)",
+  dclid: "Google Display click",
+  fbclid: "Meta click",
+  ttclid: "TikTok click",
+  twclid: "X click",
+  li_fat_id: "LinkedIn click",
+  msclkid: "Microsoft click",
+  rdt_cid: "Reddit click",
+  epik: "Pinterest click",
+  sccid: "Snapchat click",
+  fbp: "Meta browser cookie",
+  fbc: "Meta click cookie"
 };
-var SOURCE_FIELDS = [
-  { field: "event_name", label: "What happened", group: "event" },
-  { field: "event_time", label: "When it happened", group: "event" },
-  { field: "event_id", label: "Its id", group: "event" },
-  { field: "email", label: "Email", group: "person" },
-  { field: "phone", label: "Phone", group: "person" },
-  { field: "external_id", label: "Your own id for the person", group: "person" },
-  ...MATCH_FIELDS.map((field) => ({ field, label: MATCH_LABELS[field], group: "person" })),
-  { field: "value", label: "Amount", group: "money" },
-  { field: "currency", label: "Currency", group: "money" },
-  ...INGEST_CLICK_ID_PARAMS.map((field) => ({ field, label: CLICK_LABELS[field], group: "click" }))
-];
-var SOURCE_FIELD_NAMES = SOURCE_FIELDS.map((spec) => spec.field);
-var FIELD_SET = new Set(SOURCE_FIELD_NAMES);
-function isSourceField(value) {
-  return FIELD_SET.has(value);
-}
-var PROPERTY_ROW_PREFIX = "properties.";
-var PROPERTY_KEY_MAX = 64;
-var PROPERTY_KEY = /^[A-Za-z0-9_][A-Za-z0-9_.-]*$/;
-var RESERVED_PROPERTY_KEYS = ["baker_source", "hubspot_property", "hubspot_value"];
-function isPropertyRow(row) {
-  return row.startsWith(PROPERTY_ROW_PREFIX);
-}
-function propertyKeyOf(row) {
-  return isPropertyRow(row) ? row.slice(PROPERTY_ROW_PREFIX.length) : null;
-}
-function propertyKeyProblem(key) {
-  const trimmed = key.trim();
-  if (trimmed === "") return "A property needs a name.";
-  if (trimmed.length > PROPERTY_KEY_MAX) return `A property name is at most ${PROPERTY_KEY_MAX} characters.`;
-  if (!PROPERTY_KEY.test(trimmed)) {
-    return `"${trimmed}" is not a property name: letters, digits, underscore, dash and dot only, starting with a letter or digit.`;
-  }
-  if (RESERVED_PROPERTY_KEYS.includes(trimmed)) return `"${trimmed}" is written by Baker itself; pick another name.`;
-  return null;
-}
-function mappingRowProblem(row) {
-  if (isSourceField(row)) return null;
-  const key = propertyKeyOf(row);
-  if (key === null) {
-    return `"${row}" is not a field an event can carry. A field is one of ${SOURCE_FIELD_NAMES.join(", ")}; an extra property is spelled properties.<name>.`;
-  }
-  return propertyKeyProblem(key);
-}
-
-// ../api/src/event-sources/template.ts
-var MENTION = /\{\{\s*([^{}]+?)\s*\}\}/g;
-function mentionOf(path48) {
-  return `{{${path48}}}`;
-}
-function templateMentions(template) {
-  const seen = [];
-  for (const match of template.matchAll(MENTION)) {
-    const path48 = (match[1] ?? "").trim();
-    if (path48 !== "" && !seen.includes(path48)) seen.push(path48);
-  }
-  return seen;
-}
-
-// ../api/src/analytics/sends.ts
-var SEND_PLATFORMS = ["meta", "googleAds", "linkedinInsightTag", "twitterAds", "googleAnalytics"];
-function isSendPlatform(value) {
-  return SEND_PLATFORMS.includes(value);
-}
-var SEND_PLATFORM_SPECS = {
-  meta: {
-    title: "Meta",
-    eventMeans: "A Meta event name \u2014 Lead, Purchase, Schedule, or one of your own",
-    eventKind: "name",
-    credentialFields: ["accessToken", "datasetId"],
-    setupHint: "Add the Conversions API access token and dataset id to the Meta pixel in Tracking"
-  },
-  googleAds: {
-    title: "Google Ads",
-    eventMeans: "One of the account's conversion actions, picked from its list",
-    eventKind: "id",
-    credentialFields: ["oauthProviderId"],
-    setupHint: "Connect the Google Ads conversion tag to a Google Ads account in Tracking"
-  },
-  linkedinInsightTag: {
-    title: "LinkedIn",
-    eventMeans: "The id of a conversion rule in LinkedIn Campaign Manager",
-    eventKind: "id",
-    credentialFields: ["oauthProviderId"],
-    setupHint: "Connect the LinkedIn Insight Tag to a LinkedIn account in Tracking"
-  },
-  twitterAds: {
-    title: "X",
-    eventMeans: "The event tag id from X Events Manager, like tw-oka17-abc12",
-    eventKind: "id",
-    credentialFields: ["oauthProviderId"],
-    setupHint: "Connect the X pixel to an X Ads account in Tracking"
-  },
-  googleAnalytics: {
-    title: "Google Analytics",
-    eventMeans: "A GA4 event name \u2014 generate_lead, purchase, or one of your own",
-    eventKind: "name",
-    credentialFields: ["apiSecret"],
-    setupHint: "Add the Measurement Protocol API secret to the Google Analytics tag in Tracking"
+function carries(userData, field) {
+  for (const key of [field, `${field}_sha256`, `${field}_preview`]) {
+    const value = userData[key];
+    if (typeof value === "string" && value !== "") return true;
   }
-};
-var SEND_ORIGINS = ["server", "website", "any"];
-var MAX_SEND_ID = 64;
-var MAX_SEND_EVENT_KEY = 320;
-function sendEventIsTemplated(event) {
-  return templateMentions(event).length > 0;
+  return false;
 }
-function sendEventProblem(platform, event) {
-  if (!isSendPlatform(platform)) return null;
-  if (!sendEventIsTemplated(event)) return null;
-  const spec = SEND_PLATFORM_SPECS[platform];
-  if (spec.eventKind === "name") return null;
-  return `${spec.title} identifies a conversion by an id it issued, so it cannot be written from the event. Paste the id; pass what varies as an extra parameter instead.`;
+function rowMatchKeys(userData) {
+  if (userData === void 0) return [];
+  return MATCH_KEY_FIELDS.filter((field) => carries(userData, field)).map((field) => ({
+    field,
+    label: MATCH_KEY_LABELS[field] ?? field
+  }));
 }
 
 // ../api/src/analytics/sendPayload.ts
@@ -13858,11 +14079,15 @@ var CLICK_LABELS2 = {
   gclid: "Google click id",
   wbraid: "Google click id (web-to-app)",
   gbraid: "Google click id (app-to-web)",
+  dclid: "Google click id (Display & Video)",
   fbclid: "Meta click id",
   ttclid: "TikTok click id",
   twclid: "X click id",
   li_fat_id: "LinkedIn click id",
-  msclkid: "Microsoft click id"
+  msclkid: "Microsoft click id",
+  rdt_cid: "Reddit click id",
+  epik: "Pinterest click id",
+  sccid: "Snapchat click id"
 };
 var PERSON_FIELDS = MATCH_FIELD_FORWARDING.map((row) => ({
   name: row.field,
@@ -14572,9 +14797,15 @@ var analyticsQueryRequestSchema = z31.object({
   /**
    * One browser, by its cookie id.
    *
-   * Narrows `people` to a single person, and replays that person's whole
-   * history on `session` — every visit they made, not just the one. Given
-   * with `sessionId`, the session wins and this is ignored.
+   * Narrows `people` to a single person, narrows `stream` to everything
+   * that person did, and replays that person's whole history on `session` —
+   * every visit they made, not just the one. Given with `sessionId`, the
+   * session wins and this is ignored.
+   *
+   * On `stream` it is a seed rather than a cookie filter: the browser plus
+   * every address, phone, click id and platform cookie ever seen beside it.
+   * Filtering on the cookie alone would drop exactly the rows the reader
+   * came for — a deal a CRM posted names the person and carries no cookie.
    */
   anonId: z31.string().max(120).optional(),
   /**
@@ -15633,7 +15864,8 @@ var analyticsVisitorRowSchema = z31.object({
   campaignParams: z31.record(z31.string(), z31.string()),
   /**
    * The click ids this person arrived on, by their own names — `gclid`,
-   * `fbclid`, `msclkid`, `li_fat_id`, `ttclid`, `twclid`, `wbraid`, `gbraid`.
+   * `fbclid`, `msclkid`, `li_fat_id`, `ttclid`, `twclid`, `wbraid`, `gbraid`,
+   * `dclid`, `rdt_cid`, `epik`, `sccid`.
    *
    * Only the ones that were present. The endpoint has always returned all eight
    * columns and nothing above it carried them, so the one screen whose subject
@@ -29229,9 +29461,15 @@ var EVENT_INGEST_BODY_MAX_BYTES = 8 * 1024 * 1024;
 var EVENT_INGEST_REQUESTS_PER_MINUTE = 60;
 var FUTURE_TOLERANCE_MS = 5 * 6e4;
 var MAX_EVENT_NAME = 80;
+var EVENT_NAME = /^[\p{L}\p{N}][\p{L}\p{M}\p{N} ._-]*$/u;
+function validateEventName(name) {
+  const value = typeof name === "string" ? name.trim() : "";
+  if (value === "" || value.length > MAX_EVENT_NAME || !EVENT_NAME.test(value)) return "invalid_name";
+  return null;
+}
 var REJECTION_MESSAGES = {
   invalid_event_id: "event_id, when sent, must be 1-128 characters of A-Z a-z 0-9 . _ : -",
-  invalid_name: "event_name is required: up to 80 characters of letters, digits, spaces, . _ and -",
+  invalid_name: "event_name is required: up to 80 characters of letters (any language), digits, spaces, . _ and -, starting with a letter or a digit",
   missing_identity: "user_data named nobody, and no url named a page",
   invalid_timestamp: "event_time must be an ISO-8601 instant with an offset or Unix seconds, and not in the future",
   invalid_value: "value and currency go together: a non-negative decimal and an ISO-4217 code",
@@ -29259,8 +29497,8 @@ var EVENT_FIELDS = [
   {
     name: "event_name",
     need: "required",
-    takes: `What happened. Up to ${MAX_EVENT_NAME} characters of letters, digits, spaces, . _ and -`,
-    note: "The only required field. Use one of the standard names below wherever one fits \u2014 anything else is yours to invent."
+    takes: `What happened. Up to ${MAX_EVENT_NAME} characters of letters, digits, spaces, . _ and -, starting with a letter or a digit`,
+    note: 'The only required field. Use one of the standard names below wherever one fits \u2014 anything else is yours to invent, in whatever language you name things in: a letter is a letter in any script, and "Matr\xEDcula Realizada" is a name.'
   },
   {
     name: "event_time",
@@ -29311,7 +29549,7 @@ var EVENT_FIELDS = [
     name: "the ad click ids",
     need: "optional",
     under: true,
-    takes: "The click id that brought them, if you kept it, under the name the platform stamps on the link: gclid, wbraid, gbraid, fbclid, ttclid, twclid, li_fat_id, msclkid.",
+    takes: "The click id that brought them, if you kept it, under the name the platform stamps on the link: gclid, wbraid, gbraid, dclid, fbclid, ttclid, twclid, li_fat_id, msclkid, rdt_cid, epik, sccid (Snapchat's ScCid, in any case).",
     note: "A click id names a person too \u2014 it is enough on its own, and it attributes the event to the campaign that earned it."
   },
   {
@@ -30121,6 +30359,40 @@ function mergeStoredWithCounts(stored, reported) {
   }).sort((a, b) => a.name.localeCompare(b.name));
 }
 
+// src/commands/analytics/feedRows.ts
+function isStreamRow(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function enrich(row) {
+  const out = { ...row };
+  const destination = typeof row.sideEffectType === "string" ? row.sideEffectType : "";
+  if (destination !== "") out.destination = destinationName(destination);
+  const keys = rowMatchKeys(row.userData);
+  if (keys.length > 0) out.matchedBy = keys.map((key) => key.field);
+  return out;
+}
+function shapeFeed(stream, everything) {
+  if (!Array.isArray(stream)) return { rows: [], heldBack: 0 };
+  const rows = stream.filter(isStreamRow);
+  const kept = everything ? rows : rows.filter((row) => !isBookkeepingRow({ eventType: row.eventType ?? "", triggerId: row.triggerId ?? "" }));
+  return { rows: kept.map(enrich), heldBack: rows.length - kept.length };
+}
+function feedHints(shape) {
+  const hints2 = [];
+  if (shape.heldBack > 0) {
+    hints2.push(
+      `${shape.heldBack} ${shape.heldBack === 1 ? "row is" : "rows are"} not listed: rows recorded to work the reports out \u2014 identifications, step views, session starts, a destination's answer already folded onto its dispatch \u2014 and embedded forms and calendars announcing that they drew. Add --everything to see them.`
+    );
+  }
+  const upload = shape.rows.find((row) => row.sideEffectType !== void 0 && row.eventId !== void 0);
+  if (upload !== void 0) {
+    hints2.push(
+      `A delivery row carries the event it was made for in \`eventId\`. \`baker analytics feed --uid ${String(upload.eventId)}\` returns that event and every upload made for it, each with the platform's verdict.`
+    );
+  }
+  return hints2;
+}
+
 // src/commands/analytics/flowConversionKeys.ts
 function formKeyRefusal(eventKey, tree, slug) {
   const parsed = parseEventKey(eventKey);
@@ -30752,10 +31024,10 @@ function sendsWrite(args4) {
   return parsed.data;
 }
 function sendsView(response, full) {
-  const { carries, templateFields, ...rest } = response.data;
+  const { carries: carries2, templateFields, ...rest } = response.data;
   return {
     ok: true,
-    data: { ...rest, ...full ? { carries, templateFields } : {} },
+    data: { ...rest, ...full ? { carries: carries2, templateFields } : {} },
     ...response.hints && response.hints.length > 0 ? { hints: response.hints } : {}
   };
 }
@@ -31009,6 +31281,7 @@ import { z as z36 } from "zod";
 var SOURCE_KINDS = ["webhook", "hubspot"];
 var SOURCE_STATUSES = ["learning", "counting", "paused"];
 var SOURCE_NAME_MAX = 80;
+var sourceNameSchema = z36.string().trim().min(1).max(SOURCE_NAME_MAX).refine((name) => validateEventName(name) === null, REJECTION_MESSAGES.invalid_name);
 var sourceIdSchema = z36.string().min(1);
 var sourceMappingSchema = z36.record(z36.string(), z36.string().min(1)).superRefine((mapping, ctx) => {
   for (const row of Object.keys(mapping)) {
@@ -31084,10 +31357,10 @@ var hubspotPreviewSchema = z36.strictObject({
 var sourcesRequestSchema = z36.strictObject({
   /** The company's own server door: made once, `counting` from the start, the same address for ever after. */
   server: z36.strictObject({}).optional(),
-  create: z36.strictObject({ name: z36.string().trim().min(1).max(SOURCE_NAME_MAX) }).optional(),
+  create: z36.strictObject({ name: sourceNameSchema }).optional(),
   /** A HubSpot event: read every five minutes, counting from now. The labels are looked up server-side. */
   createHubspot: z36.strictObject({
-    name: z36.string().trim().min(1).max(SOURCE_NAME_MAX).optional(),
+    name: sourceNameSchema.optional(),
     /** A contact, or a deal. A deal's event is about its contact, read through `contact.<property>` rows. */
     object: hubspotObjectSchema.default("contact"),
     trigger: hubspotTriggerInputSchema,
@@ -31113,11 +31386,46 @@ var sourcesRequestSchema = z36.strictObject({
     amountProperty: z36.string().trim().min(1).optional(),
     currency: currencyCodeSchema.optional()
   }).optional(),
+  /**
+   * Count a HubSpot event's history: every moment its trigger came to hold
+   * since `since`, read out of HubSpot's own property history.
+   *
+   * Not the thing a source deliberately refuses to do. A source never
+   * backfills the **present state** — somebody who already satisfies a
+   * condition is not an event today — and this reports only moments HubSpot
+   * has a timestamp for, so nothing is invented. Dry unless `write`.
+   */
+  backfill: z36.strictObject({
+    sourceId: sourceIdSchema,
+    /** ISO instant, or Unix milliseconds. Bounded by the 400 days the store keeps. */
+    since: z36.union([z36.string().trim().min(1), z36.number()]),
+    /**
+     * Where a capped run carries on from: only records last changed at or
+     * before this instant are read.
+     *
+     * The **read** is what it bounds, never the history. Records are chosen
+     * most-recently-changed first, so a run that reaches its cap has covered
+     * the newest of them and the rest are the ones nearest `since` — which
+     * no shorter window can reach, because shortening one only drops
+     * candidates from the old end and hands back the same newest records
+     * again. `reachedBack` is the value to pass here, and the moments each
+     * record is then judged on are still the whole of `since` to now.
+     */
+    before: z36.union([z36.string().trim().min(1), z36.number()]).optional(),
+    /** Without it, nothing is counted and the answer says what would be. */
+    write: z36.boolean().optional()
+  }).optional(),
   map: z36.strictObject({ sourceId: sourceIdSchema, mapping: sourceMappingSchema }).optional(),
   pause: z36.strictObject({ sourceId: sourceIdSchema }).optional(),
   resume: z36.strictObject({ sourceId: sourceIdSchema }).optional(),
   remove: z36.strictObject({ sourceId: sourceIdSchema }).optional()
 });
+var sourceRefusalSchema = z36.strictObject({
+  at: z36.number(),
+  count: z36.number(),
+  code: z36.string(),
+  reason: z36.string()
+});
 var detectedFieldSchema = z36.strictObject({
   path: z36.string(),
   confidence: z36.enum(["key", "value"])
@@ -31145,6 +31453,14 @@ var sourceViewSchema = z36.strictObject({
   /** Why the last delivery could not be counted, in product words; absent when the last one was. */
   lastError: z36.string().optional(),
   lastArrivalAt: z36.number().optional(),
+  /**
+   * What its last delivery **refused, event by event** — which `lastError` is
+   * not and `lastArrivalAt` cannot be. A source refusing everything it
+   * receives has no arrival and no read failure, so without this it reads as
+   * one nobody has sent anything to. `refusalWords` turns it into the
+   * sentence a person is shown. Cleared by the next delivery that counts.
+   */
+  lastRefusal: sourceRefusalSchema.optional(),
   /** The first send, masked, while learning. Kept once confirmed. */
   sample: z36.strictObject({ receivedAt: z36.number(), body: z36.string() }).optional(),
   /** Field → template; empty means the guess (an address) or the defaults (a HubSpot read). */
@@ -31166,12 +31482,37 @@ var stagedSourceOpSchema = z36.strictObject({
   mapping: z36.record(z36.string(), z36.string()).optional(),
   status: z36.enum(["paused", "counting"]).optional()
 });
+var backfillResultSchema = z36.strictObject({
+  sourceId: z36.string(),
+  name: z36.string(),
+  since: z36.number(),
+  /** Records whose history was read. */
+  examined: z36.number(),
+  /** Moments the trigger came to hold, across them. */
+  entries: z36.number(),
+  /** Of those, already counted — the journal got there first, or a previous run did. */
+  alreadyCounted: z36.number(),
+  /** What a `write` run would hand over, or did. */
+  pending: z36.number(),
+  /** Whether the read stopped at its cap; {@link BackfillResult.reachedBack} is where to carry on from. */
+  capped: z36.boolean(),
+  /**
+   * How far back the read got: the instant the oldest record it examined was
+   * last changed. Only on a capped run, and it is the next run's `before`.
+   */
+  reachedBack: z36.number().optional(),
+  counted: z36.number().optional(),
+  refused: z36.number().optional(),
+  refusedReason: z36.string().optional()
+});
 var sourcesResponseSchema = z36.strictObject({
   ok: z36.literal(true),
   data: z36.strictObject({
     sources: z36.array(sourceViewSchema),
     /** Only when the request carried `preview`. */
     preview: hubspotPreviewSchema.optional(),
+    /** Only when the request carried `backfill`. */
+    backfill: backfillResultSchema.optional(),
     /** What this chat has staged, when one is attached: applied at Publish, dropped with a discard. */
     staged: z36.array(stagedSourceOpSchema).optional()
   }),
@@ -31282,6 +31623,26 @@ var args2 = {
     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`",
@@ -31445,14 +31806,37 @@ var VERBS = [
   "create-hubspot",
   "set-trigger",
   "preview",
+  "backfill",
   "set-amount",
   "map",
   "pause",
   "resume",
   "remove"
 ];
-function sourcesRequest(raw, argv) {
+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 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.`);
@@ -31466,6 +31850,7 @@ function sourcesRequest(raw, argv) {
   if (verb === "create-hubspot") return { createHubspot: createHubspotArgs(raw, argv, name) };
   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 {
@@ -31754,7 +32139,10 @@ async function runPreset(args4, options) {
       process.exit(1);
     }
     const data = pruneForAgent(response.data, args4.full === true);
+    const feed = "stream" in data ? shapeFeed(data.stream, args4.everything === true) : void 0;
+    if (feed !== void 0) data.stream = feed.rows;
     const hints2 = [
+      ...feed === void 0 ? [] : feedHints(feed),
       // The platform the ad blocks were scoped to, so the tagging hint can
       // only speak about the inventory it was actually given. `adParams` is one
       // platform's list; a hint drawn from it without knowing which platform
@@ -31984,7 +32372,8 @@ function feedNarrowing(args4) {
     ...args4.kind ? { eventKey: String(args4.kind) } : {},
     ...args4.send ? { sendId: String(args4.send) } : {},
     ...args4["sent-to"] ? { sentTo: String(args4["sent-to"]) } : {},
-    ...args4.uid ? { eventUid: String(args4.uid) } : {}
+    ...args4.uid ? { eventUid: String(args4.uid) } : {},
+    ...args4.person ? { anonId: String(args4.person) } : {}
   };
 }
 var feedCommand = presetCommand({
@@ -32026,6 +32415,16 @@ var feedCommand = presetCommand({
       type: "string",
       description: "One kind of event, by the key `baker analytics conversions` lists (page:Deal won, form:contact:\u2026)",
       required: false
+    },
+    person: {
+      type: "string",
+      description: "One person and everything they did, seeded by a browser id from the `anonId` on any row. A seed rather than a cookie filter: the store resolves it to the whole person \u2014 across devices, and across every address, phone, customer id, ad click and platform cookie ever seen beside that browser \u2014 so a deal their CRM posted, which carries no cookie at all, is on the list beside the page view that named them",
+      required: false
+    },
+    everything: {
+      type: "boolean",
+      description: "Include the rows held back by default: the ones recorded so the reports can be worked out (identifications, step views, session starts, a destination's answer already folded onto its dispatch) and embedded forms and calendars announcing that they drew. Reach for it when debugging the collector rather than an integration \u2014 an embed that draws and never fires again is only visible here",
+      required: false
     }
   },
   resolve: (args4) => feedRequest(args4)