@evinvest/kitstart 0.4.0 → 0.6.0

package/dist/core/lead-capture-format.js

@@ -0,0 +1,32 @@
+// Apart from the words themselves, which the client island never imports:
+// the strings arrive as a prop, and a bundler keeps a module's constants.
+/** `{key}` → its value; a key with no value is left as written, visible in review. */
+export function fillText(template, values) {
+    return template.replace(/\{(\w+)\}/g, (all, key) => values[key] ?? all);
+}
+/** `08:00` → `8 h` in French, `8:00` elsewhere; `08:30` → `8 h 30` / `8:30`. */
+function clockText(hhmm, locale) {
+    const [h = "0", m = "00"] = hhmm.split(":");
+    const hour = String(Number(h));
+    if (locale.startsWith("fr"))
+        return m === "00" ? `${hour} h` : `${hour} h ${m}`;
+    return `${hour}:${m}`;
+}
+const WEEKDAY_INDEX = { Monday: 0, Tuesday: 1, Wednesday: 2, Thursday: 3, Friday: 4, Saturday: 5, Sunday: 6 };
+/** The weekday in the page's language: a Monday-anchored date read back through `Intl`. */
+function weekdayText(day, locale) {
+    // 2024-01-01 was a Monday; noon UTC is the same day everywhere it matters.
+    const date = new Date(Date.UTC(2024, 0, 1 + WEEKDAY_INDEX[day], 12));
+    return new Intl.DateTimeFormat(locale, { weekday: "long", timeZone: "UTC" }).format(date);
+}
+/** The promise of the next opening, from real hours — or `null`, never an invented one. */
+export function openingText(opening, text, locale) {
+    if (!opening)
+        return null;
+    const time = clockText(opening.time, locale);
+    if (opening.inDays === 0)
+        return fillText(text.openingToday, { time });
+    if (opening.inDays === 1)
+        return fillText(text.openingTomorrow, { time });
+    return fillText(text.openingLater, { time, day: weekdayText(opening.day, locale) });
+}

package/dist/core/lead-capture-text.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Every word `LeadCapture` prints. Plain strings, not the copy contract's
+ * `Said<F>`: the form is a client island, and a function cannot cross from a
+ * server page into it. A sentence that quotes something names it in braces —
+ * `{need}`, `{day}`, `{time}` — and the component fills it in.
+ *
+ * The kit ships French and English (`LEAD_CAPTURE_TEXT`) so every brand asks
+ * in the same words and an experiment's arms differ only in what it tests; a
+ * brand overrides a key by spreading: `{ ...LEAD_CAPTURE_TEXT.fr, submit: "…" }`.
+ */
+export interface LeadCaptureText {
+    title: string;
+    lede: string;
+    needLabel: string;
+    /** Re-opens a need chosen for the visitor. */
+    needChange: string;
+    localityLabel: string;
+    /** Names the row of communes a tap fills the locality from. */
+    servedLabel: string;
+    phoneLabel: string;
+    /** The soft check under a number that does not read as one; it never blocks. */
+    phoneHint: string;
+    nameLabel: string;
+    /** After an optional field's label. */
+    optional: string;
+    submit: string;
+    privacy: string;
+    /** Heads the other ways to reach the business. */
+    otherChannels: string;
+    call: string;
+    whatsapp: string;
+    sms: string;
+    callback: string;
+    callbackLede: string;
+    /** Posted with the callback and kept with the lead word for word: what was agreed to. */
+    callbackConsent: string;
+    callbackSubmit: string;
+    /** The WhatsApp and SMS message, `{need}` the need's label. */
+    message: string;
+    /** The same when no need is known. */
+    messageGeneric: string;
+    /** When closed: the next opening, from the place's real hours only. */
+    openingToday: string;
+    openingTomorrow: string;
+    /** `{day}` is the weekday in the page's language. */
+    openingLater: string;
+    /** The honeypot's label — read only by a bot filling every field. */
+    honeypotLabel: string;
+}
+export declare const LEAD_CAPTURE_TEXT: Readonly<Record<"fr" | "en", LeadCaptureText>>;

package/dist/core/lead-capture-text.js

@@ -0,0 +1,57 @@
+const FR = {
+    title: "Recevoir un prix",
+    lede: "Réponse rapide, sans engagement.",
+    needLabel: "Votre besoin",
+    needChange: "Modifier",
+    localityLabel: "Code postal",
+    servedLabel: "Communes desservies",
+    phoneLabel: "Téléphone",
+    phoneHint: "Vérifiez le numéro : 06 12 34 56 78 ou +33 6 12 34 56 78.",
+    nameLabel: "Nom",
+    optional: "facultatif",
+    submit: "Recevoir le prix",
+    privacy: "Votre numéro ne sert qu’à vous répondre.",
+    otherChannels: "Ou contactez-nous",
+    call: "Appeler",
+    whatsapp: "WhatsApp",
+    sms: "SMS",
+    callback: "Rappelez-moi",
+    callbackLede: "Laissez votre numéro, nous vous rappelons.",
+    callbackConsent: "J’accepte d’être rappelé·e à ce numéro au sujet de ma demande.",
+    callbackSubmit: "Être rappelé",
+    message: "Bonjour, j’ai besoin de : {need}.",
+    messageGeneric: "Bonjour, je souhaite un devis.",
+    openingToday: "Nous vous rappelons dès {time}.",
+    openingTomorrow: "Nous vous rappelons demain dès {time}.",
+    openingLater: "Nous vous rappelons {day} dès {time}.",
+    honeypotLabel: "Site web",
+};
+const EN = {
+    title: "Get a price",
+    lede: "A quick answer, no commitment.",
+    needLabel: "What you need",
+    needChange: "Change",
+    localityLabel: "Postcode",
+    servedLabel: "Towns we serve",
+    phoneLabel: "Phone",
+    phoneHint: "Check the number: 06 12 34 56 78 or +33 6 12 34 56 78.",
+    nameLabel: "Name",
+    optional: "optional",
+    submit: "Get the price",
+    privacy: "Your number is used only to answer you.",
+    otherChannels: "Or reach us",
+    call: "Call",
+    whatsapp: "WhatsApp",
+    sms: "Text",
+    callback: "Call me back",
+    callbackLede: "Leave your number and we will call you back.",
+    callbackConsent: "I agree to be called back on this number about my request.",
+    callbackSubmit: "Call me back",
+    message: "Hello, I need: {need}.",
+    messageGeneric: "Hello, I would like a quote.",
+    openingToday: "We call you back from {time}.",
+    openingTomorrow: "We call you back tomorrow from {time}.",
+    openingLater: "We call you back on {day} from {time}.",
+    honeypotLabel: "Website",
+};
+export const LEAD_CAPTURE_TEXT = { fr: FR, en: EN };

package/dist/core/lead.d.ts

@@ -39,7 +39,43 @@ export interface LeadSchema<S extends string> {
      * `null` to accept. Absent → every candidate is a lead.
      */
     validate?: (lead: LeadCandidate) => string | null;
+    /**
+     * The rule for a callback request, which carries a phone and little else —
+     * a form's rule would refuse it for the locality it never asked. Absent →
+     * `validateCallbackLead`: a number we can read.
+     */
+    validateCallback?: (lead: LeadCandidate) => string | null;
+    /**
+     * How the mobile is kept: `typed` (default), exactly as posted, or `e164`,
+     * `+33612345678` when it reads as a number and as typed when it does not.
+     * Opt-in, because a brand's own tooling and tests look rows up by the
+     * number as typed.
+     */
+    mobileFormat?: "typed" | "e164";
 }
+/**
+ * How the lead was asked for: the quote form, or "call me back" — the form cut
+ * to a phone number. Posted as `CHANNEL_FIELD`; anything else, or nothing (a
+ * page cached before the field existed), is `form`.
+ */
+export type LeadChannel = "form" | "callback";
+export declare const LEAD_CHANNELS: readonly LeadChannel[];
+export declare const CHANNEL_FIELD = "channel";
+/**
+ * The callback's consent: a checkbox whose value is the sentence it shows, in
+ * the language it shows it, so the row keeps what was agreed to. Absent → the
+ * callback is refused, as any invalid lead is.
+ */
+export declare const CONSENT_FIELD = "consent";
+/** Longer than any consent sentence; past it, the text is cut, not refused. */
+export declare const MAX_CONSENT = 500;
+/** What a callback lead was agreed to, and when the server accepted it (ISO 8601). */
+export interface LeadConsent {
+    text: string;
+    at: string;
+}
+/** The default callback rule: a phone number that reads as one. */
+export declare function validateCallbackLead(lead: Pick<LeadCandidate, "mobile">): string | null;
 /**
  * A submitted lead. Values are trimmed and capped but not otherwise parsed: a
  * lead that cannot be fully validated is still a lead, and rejecting it loses
@@ -54,8 +90,23 @@ export interface Lead {
     /** The place it was submitted from — its slug — or `null` when unknown. */
     placeSlug: string | null;
     spamVerdict: SpamVerdict | null;
+    /**
+     * Absent on a lead built before the field existed — read it as `form`
+     * (`channelOf`). Every lead the funnel reads has it.
+     */
+    channel?: LeadChannel;
+    /** Only on a callback lead: the consent it was posted with. */
+    consent?: LeadConsent;
 }
-export type LeadCandidate = Omit<Lead, "spamVerdict">;
+/** The lead's channel, `form` for one that predates the field. */
+export declare function channelOf(lead: Pick<Lead, "channel">): LeadChannel;
+/**
+ * What the form posted, before the funnel judges it: the consent is the
+ * posted sentence, and the funnel stamps when it accepted it.
+ */
+export type LeadCandidate = Omit<Lead, "spamVerdict" | "consent"> & {
+    consentText?: string;
+};
 /**
  * The port the funnel writes through — the commit point. `insert` resolves
  * with the row's id only once the lead is durable; a rejection is a lead the
@@ -78,11 +129,15 @@ export interface LeadStore {
 /**
  * The lead schema's version, shared by every adapter: 1 the Rust server's
  * table (`job`, `zip`, `mobile`, `at`), 2 + the place, 3 + the spam verdict,
- * 4 + the brand's extras. Append only.
+ * 4 + the brand's extras, 5 + the channel and the callback's consent. Append only.
  */
-export declare const LEAD_SCHEMA_VERSION = 4;
+export declare const LEAD_SCHEMA_VERSION = 5;
 /** A field is capped, not rejected: a long answer is still a customer. */
 export declare const MAX_FIELD = 200;
-/** The candidate a form posted, read through the schema's field names. */
+/**
+ * The candidate a form posted, read through the schema's field names. Under
+ * `mobileFormat: "e164"` the mobile is normalised before the brand's rule
+ * sees it.
+ */
 export declare function readCandidate(schema: LeadSchema<string>, form: FormData, placeSlug: string | null): LeadCandidate;
 export declare function validateCandidate(schema: LeadSchema<string>, lead: LeadCandidate): string | null;

package/dist/core/lead.js

@@ -9,19 +9,42 @@
  * `LeadSchema.wire` names the posted fields (a page cached before a rename
  * still delivers) — both deliberate departures from the first design.
  */
+import { isPlausiblePhone, normalizePhone } from "./phone.js";
+export const LEAD_CHANNELS = ["form", "callback"];
+export const CHANNEL_FIELD = "channel";
+/**
+ * The callback's consent: a checkbox whose value is the sentence it shows, in
+ * the language it shows it, so the row keeps what was agreed to. Absent → the
+ * callback is refused, as any invalid lead is.
+ */
+export const CONSENT_FIELD = "consent";
+/** Longer than any consent sentence; past it, the text is cut, not refused. */
+export const MAX_CONSENT = 500;
+/** The default callback rule: a phone number that reads as one. */
+export function validateCallbackLead(lead) {
+    return isPlausiblePhone(lead.mobile) ? null : "a phone number to call back";
+}
+/** The lead's channel, `form` for one that predates the field. */
+export function channelOf(lead) {
+    return lead.channel ?? "form";
+}
 /**
  * The lead schema's version, shared by every adapter: 1 the Rust server's
  * table (`job`, `zip`, `mobile`, `at`), 2 + the place, 3 + the spam verdict,
- * 4 + the brand's extras. Append only.
+ * 4 + the brand's extras, 5 + the channel and the callback's consent. Append only.
  */
-export const LEAD_SCHEMA_VERSION = 4;
+export const LEAD_SCHEMA_VERSION = 5;
 /** A field is capped, not rejected: a long answer is still a customer. */
 export const MAX_FIELD = 200;
 function field(form, name, max) {
     const value = form.get(name);
     return typeof value === "string" ? value.trim().slice(0, max) : null;
 }
-/** The candidate a form posted, read through the schema's field names. */
+/**
+ * The candidate a form posted, read through the schema's field names. Under
+ * `mobileFormat: "e164"` the mobile is normalised before the brand's rule
+ * sees it.
+ */
 export function readCandidate(schema, form, placeSlug) {
     const extras = {};
     for (const extra of schema.extras ?? []) {
@@ -29,14 +52,25 @@ export function readCandidate(schema, form, placeSlug) {
         if (value)
             extras[extra.name] = value;
     }
+    const mobile = field(form, schema.wire.mobile, MAX_FIELD) ?? "";
+    const callback = form.get(CHANNEL_FIELD) === "callback";
+    const consent = callback ? field(form, CONSENT_FIELD, MAX_CONSENT) : null;
     return {
         subject: field(form, schema.wire.subject, MAX_FIELD) ?? "",
         locality: field(form, schema.wire.locality, MAX_FIELD) ?? "",
-        mobile: field(form, schema.wire.mobile, MAX_FIELD) ?? "",
+        mobile: schema.mobileFormat === "e164" ? (normalizePhone(mobile) ?? mobile) : mobile,
         extras,
         placeSlug,
+        channel: callback ? "callback" : "form",
+        ...(consent ? { consentText: consent } : {}),
     };
 }
 export function validateCandidate(schema, lead) {
+    if (channelOf(lead) === "callback") {
+        // Not the brand's to waive: calling someone back needs their word for it.
+        if (!lead.consentText)
+            return "consent to be called back";
+        return (schema.validateCallback ?? validateCallbackLead)(lead);
+    }
     return schema.validate?.(lead) ?? null;
 }

package/dist/core/phone.d.ts

@@ -0,0 +1,19 @@
+/**
+ * A phone number as the funnel keeps it: E.164 when the typed value is one we
+ * can read, otherwise exactly as typed. Soft by design — a number we cannot
+ * parse is still a way to reach someone, and refusing it loses the customer.
+ *
+ * Only the French national plan is read (every brand of the vertical is in
+ * France): `06 12 34 56 78`, `+33 (0)6 …`, `0033 6 …` and a mobile typed
+ * without its trunk zero (`6 12 34 56 78`) all become `+33612345678`. Any
+ * other international number is compacted (`+44 7911 123456` →
+ * `+447911123456`); anything else is `null`.
+ */
+export declare function normalizePhone(raw: string): string | null;
+/** Whether a typed number reads as one — the form's soft check, never a block. */
+export declare function isPlausiblePhone(raw: string): boolean;
+/**
+ * A French mobile (`+33 6…`, `+33 7…`) — the one kind an SMS reaches. A
+ * landline answers a text with silence, so the channel is not offered for it.
+ */
+export declare function isMobilePhone(raw: string): boolean;

package/dist/core/phone.js

@@ -0,0 +1,39 @@
+/**
+ * A phone number as the funnel keeps it: E.164 when the typed value is one we
+ * can read, otherwise exactly as typed. Soft by design — a number we cannot
+ * parse is still a way to reach someone, and refusing it loses the customer.
+ *
+ * Only the French national plan is read (every brand of the vertical is in
+ * France): `06 12 34 56 78`, `+33 (0)6 …`, `0033 6 …` and a mobile typed
+ * without its trunk zero (`6 12 34 56 78`) all become `+33612345678`. Any
+ * other international number is compacted (`+44 7911 123456` →
+ * `+447911123456`); anything else is `null`.
+ */
+export function normalizePhone(raw) {
+    let s = raw.replace(/\(0\)/g, "").replace(/[\s.\-()/ ]/g, "");
+    if (s.startsWith("00"))
+        s = `+${s.slice(2)}`;
+    if (s.startsWith("+33")) {
+        const national = /^\+330?([1-9]\d{8})$/.exec(s);
+        return national ? `+33${national[1]}` : null;
+    }
+    const trunk = /^0([1-9]\d{8})$/.exec(s);
+    if (trunk)
+        return `+33${trunk[1]}`;
+    if (/^[1-9]\d{8}$/.test(s))
+        return `+33${s}`;
+    if (/^\+[1-9]\d{7,14}$/.test(s))
+        return s;
+    return null;
+}
+/** Whether a typed number reads as one — the form's soft check, never a block. */
+export function isPlausiblePhone(raw) {
+    return normalizePhone(raw) !== null;
+}
+/**
+ * A French mobile (`+33 6…`, `+33 7…`) — the one kind an SMS reaches. A
+ * landline answers a text with silence, so the channel is not offered for it.
+ */
+export function isMobilePhone(raw) {
+    return /^\+33[67]\d{8}$/.test(normalizePhone(raw) ?? "");
+}

package/dist/core/place/hours.d.ts

@@ -0,0 +1,15 @@
+import type { DayOfWeek, OpeningHours } from "./types.js";
+/** Every place of the vertical is in France; a brand elsewhere passes its own. */
+export declare const DEFAULT_TIME_ZONE = "Europe/Paris";
+/** The next opening after a closed moment, read from the place's real hours only. */
+export interface Opening {
+    day: DayOfWeek;
+    /** `HH:MM`, local time, as the hours say it. */
+    time: string;
+    /** 0 today, 1 tomorrow, … up to 7. */
+    inDays: number;
+}
+/** Whether the place is open at `at`. Hours we do not have are not a guess: `null`. */
+export declare function isOpenAt(hours: readonly OpeningHours[] | null, at: Date, timeZone?: string): boolean | null;
+/** The first opening after `at`, within a week — `null` with no hours, or when open now. */
+export declare function nextOpening(hours: readonly OpeningHours[] | null, at: Date, timeZone?: string): Opening | null;

package/dist/core/place/hours.js

@@ -0,0 +1,68 @@
+/** Every place of the vertical is in France; a brand elsewhere passes its own. */
+export const DEFAULT_TIME_ZONE = "Europe/Paris";
+const WEEK = ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday"];
+const formatters = new Map();
+/** The wall clock at `timeZone`: Monday-first day index and minutes since midnight. */
+function localTime(at, timeZone) {
+    let fmt = formatters.get(timeZone);
+    if (!fmt) {
+        fmt = new Intl.DateTimeFormat("en-US", { timeZone, weekday: "long", hour: "2-digit", minute: "2-digit", hourCycle: "h23" });
+        formatters.set(timeZone, fmt);
+    }
+    const parts = fmt.formatToParts(at);
+    const part = (type) => parts.find(p => p.type === type)?.value ?? "";
+    const day = WEEK.findIndex(d => d === part("weekday"));
+    return { day: day < 0 ? 0 : day, minutes: Number(part("hour")) * 60 + Number(part("minute")) };
+}
+/** `HH:MM` → minutes; `24:00` is the end of the day. `null` for anything else. */
+function clock(hhmm) {
+    const m = /^(\d{1,2}):(\d{2})$/.exec(hhmm);
+    if (!m)
+        return null;
+    const minutes = Number(m[1]) * 60 + Number(m[2]);
+    return minutes <= 24 * 60 ? minutes : null;
+}
+/** The slots as minute ranges per day; a slot closing at or before it opens runs past midnight. */
+function ranges(hours) {
+    const out = [];
+    for (const slot of hours) {
+        const from = clock(slot.opens);
+        const to = clock(slot.closes);
+        if (from === null || to === null)
+            continue;
+        for (const name of slot.days) {
+            const day = WEEK.indexOf(name);
+            if (to > from)
+                out.push({ day, from, to, carried: false });
+            else {
+                out.push({ day, from, to: 24 * 60, carried: false });
+                out.push({ day: (day + 1) % 7, from: 0, to, carried: true });
+            }
+        }
+    }
+    return out;
+}
+/** Whether the place is open at `at`. Hours we do not have are not a guess: `null`. */
+export function isOpenAt(hours, at, timeZone = DEFAULT_TIME_ZONE) {
+    if (!hours || hours.length === 0)
+        return null;
+    const now = localTime(at, timeZone);
+    return ranges(hours).some(r => r.day === now.day && now.minutes >= r.from && now.minutes < r.to);
+}
+/** The first opening after `at`, within a week — `null` with no hours, or when open now. */
+export function nextOpening(hours, at, timeZone = DEFAULT_TIME_ZONE) {
+    if (isOpenAt(hours, at, timeZone) !== false || !hours)
+        return null;
+    const now = localTime(at, timeZone);
+    const slots = ranges(hours).filter(r => !r.carried);
+    for (let inDays = 0; inDays <= 7; inDays++) {
+        const day = (now.day + inDays) % 7;
+        const starts = slots.filter(r => r.day === day && (inDays > 0 || r.from > now.minutes)).map(r => r.from);
+        if (starts.length === 0)
+            continue;
+        const from = Math.min(...starts);
+        const name = WEEK[day] ?? "Monday";
+        return { day: name, time: `${String(Math.floor(from / 60)).padStart(2, "0")}:${String(from % 60).padStart(2, "0")}`, inDays };
+    }
+    return null;
+}

package/dist/core/place/index.d.ts

@@ -1,5 +1,6 @@
 export { servedLocalities, storefrontOf, type DayOfWeek, type Geo, type OpeningHours, type Place, type PostalAddress, type Presence, type Rating, type ServiceArea, } from "./types.js";
 export { isPublished, publicationGaps, SERVICE_AREA_GATE, STOREFRONT_GATE, type PublicationField, type PublicationPolicy, } from "./publication.js";
+export { DEFAULT_TIME_ZONE, isOpenAt, nextOpening, type Opening } from "./hours.js";
 export { freshRating, parseInstant, RATING_MAX_AGE_DAYS } from "./rating.js";
 export { mergeLive, parsePlaceLive, type PlaceLive } from "./live.js";
 export { createPlaceView, placeHref, placeOrigin, placeUrl, siteOrigin, type LinkBase, type LinkMode, type OriginFacts, type PlaceView, } from "./view.js";

package/dist/core/place/index.js

@@ -1,5 +1,6 @@
 export { servedLocalities, storefrontOf, } from "./types.js";
 export { isPublished, publicationGaps, SERVICE_AREA_GATE, STOREFRONT_GATE, } from "./publication.js";
+export { DEFAULT_TIME_ZONE, isOpenAt, nextOpening } from "./hours.js";
 export { freshRating, parseInstant, RATING_MAX_AGE_DAYS } from "./rating.js";
 export { mergeLive, parsePlaceLive } from "./live.js";
 export { createPlaceView, placeHref, placeOrigin, placeUrl, siteOrigin, } from "./view.js";

package/dist/index.d.ts

@@ -4,14 +4,18 @@
  * Runtime-bound halves live on their own subpaths.
  */
 export { assertLaunchable, bakedPlace, cardFact, contactOf, defineSite, ogLocaleOf, openLaunchBlockers, perLocale, type BrandFacts, type LegacyRedirect, type OwnerTodo, type PageSuffix, type Site, type SiteConfig, type Topology, } from "./core/site.js";
-export { createPlaceView, freshRating, parseInstant, isPublished, mergeLive, parsePlaceLive, placeHref, placeOrigin, placeUrl, publicationGaps, RATING_MAX_AGE_DAYS, servedLocalities, SERVICE_AREA_GATE, siteOrigin, STOREFRONT_GATE, storefrontOf, type DayOfWeek, type Geo, type LinkBase, type LinkMode, type OpeningHours, type OriginFacts, type Place, type PlaceLive, type PlaceView, type PostalAddress, type Presence, type PublicationField, type PublicationPolicy, type Rating, type ServiceArea, } from "./core/place/index.js";
+export { createPlaceView, DEFAULT_TIME_ZONE, freshRating, isOpenAt, nextOpening, parseInstant, isPublished, mergeLive, parsePlaceLive, placeHref, placeOrigin, placeUrl, publicationGaps, RATING_MAX_AGE_DAYS, servedLocalities, SERVICE_AREA_GATE, siteOrigin, STOREFRONT_GATE, storefrontOf, type DayOfWeek, type Geo, type LinkBase, type LinkMode, type Opening, type OpeningHours, type OriginFacts, type Place, type PlaceLive, type PlaceView, type PostalAddress, type Presence, type PublicationField, type PublicationPolicy, type Rating, type ServiceArea, } from "./core/place/index.js";
 export { createRouting, GONE, GONE_HEADER, gonePath, goneHeader, HOST_MARK, LANG_COOKIE, LANG_COOKIE_MAX_AGE, NON_PAGE_ROUTES, parseGoneHeader, parsePlaceParam, PASS_PATHS, placeParam, pointSuffixes, THANKS, type Decision, type RequestFacts, type Routing, } from "./core/routing.js";
-export { LEAD_SCHEMA_VERSION, MAX_FIELD, readCandidate, validateCandidate, type Lead, type LeadCandidate, type LeadExtra, type LeadSchema, type LeadStore, type LeadWire, type SpamVerdict, } from "./core/lead.js";
+export { CHANNEL_FIELD, channelOf, CONSENT_FIELD, LEAD_CHANNELS, LEAD_SCHEMA_VERSION, MAX_CONSENT, MAX_FIELD, readCandidate, validateCallbackLead, validateCandidate, type Lead, type LeadCandidate, type LeadChannel, type LeadConsent, type LeadExtra, type LeadSchema, type LeadStore, type LeadWire, type SpamVerdict, } from "./core/lead.js";
+export { isMobilePhone, isPlausiblePhone, normalizePhone } from "./core/phone.js";
+export { LEAD_CAPTURE_TEXT, type LeadCaptureText } from "./core/lead-capture-text.js";
+export { fillText, openingText } from "./core/lead-capture-format.js";
+export { channelHref, resolveChannels, smsHref, type CaptureChannel, type ChannelFacts, type ChannelOptions, type ResolvedChannels, } from "./core/channels.js";
 export { checkTiming, HONEYPOT_FIELD, LEGACY_HONEYPOT_FIELDS, MIN_FILL_MS, RATE_LIMIT_MAX_KEYS, RateLimiter, RENDERED_AT_FIELD, screen, type Screening, } from "./core/antispam.js";
-export { createAcceptLead, FORM_ID_FIELD, LOCALE_FIELD, LOCATION_FIELD, type AcceptDeps, type Outcome, } from "./core/accept.js";
+export { createAcceptLead, EXPERIMENT_FIELD, FORM_ID_FIELD, LOCALE_FIELD, LOCATION_FIELD, VARIANT_FIELD, type AcceptDeps, type Outcome, type SubmitTags, } from "./core/accept.js";
 export { areaServedNodes, breadcrumbNode, businessId, businessNode, faqPageNode, offerNodes, organizationId, organizationNode, placeGraph, websiteId, type OfferInput, type PageGraphCopy, type QuestionAnswer, } from "./core/seo/ld.js";
 export { AI_CRAWLERS, ogImageUrl, robotsFor, sitemapFor, type RobotsFile, type RobotsRule, type SitemapEntry, } from "./core/seo/sitemap.js";
-export { ALLOWED_PROPS, analyticsSink, countsAsPageView, EVENTS, type AnalyticsTarget, type IntentChannel, } from "./core/analytics.js";
+export { ALLOWED_PROPS, analyticsSink, countsAsPageView, EVENTS, EXPERIMENT_SLUG, experimentProps, type AnalyticsTarget, type IntentChannel, type LeadField, type LeadStep, } from "./core/analytics.js";
 export type { CallBarText, CopySlice, CoreText, PageMetaCopy, QuoteFormCopy, Said, StatusAction, StatusCopy, StatusScreenText, } from "./core/content.js";
 export { brandStatusTarget, statusTarget, type StatusTarget } from "./core/status.js";
 export { createLocaleRegistry, type LocaleRegistry } from "@evinvest/i18n";

package/dist/index.js

@@ -4,14 +4,18 @@
  * Runtime-bound halves live on their own subpaths.
  */
 export { assertLaunchable, bakedPlace, cardFact, contactOf, defineSite, ogLocaleOf, openLaunchBlockers, perLocale, } from "./core/site.js";
-export { createPlaceView, freshRating, parseInstant, isPublished, mergeLive, parsePlaceLive, placeHref, placeOrigin, placeUrl, publicationGaps, RATING_MAX_AGE_DAYS, servedLocalities, SERVICE_AREA_GATE, siteOrigin, STOREFRONT_GATE, storefrontOf, } from "./core/place/index.js";
+export { createPlaceView, DEFAULT_TIME_ZONE, freshRating, isOpenAt, nextOpening, parseInstant, isPublished, mergeLive, parsePlaceLive, placeHref, placeOrigin, placeUrl, publicationGaps, RATING_MAX_AGE_DAYS, servedLocalities, SERVICE_AREA_GATE, siteOrigin, STOREFRONT_GATE, storefrontOf, } from "./core/place/index.js";
 export { createRouting, GONE, GONE_HEADER, gonePath, goneHeader, HOST_MARK, LANG_COOKIE, LANG_COOKIE_MAX_AGE, NON_PAGE_ROUTES, parseGoneHeader, parsePlaceParam, PASS_PATHS, placeParam, pointSuffixes, THANKS, } from "./core/routing.js";
-export { LEAD_SCHEMA_VERSION, MAX_FIELD, readCandidate, validateCandidate, } from "./core/lead.js";
+export { CHANNEL_FIELD, channelOf, CONSENT_FIELD, LEAD_CHANNELS, LEAD_SCHEMA_VERSION, MAX_CONSENT, MAX_FIELD, readCandidate, validateCallbackLead, validateCandidate, } from "./core/lead.js";
+export { isMobilePhone, isPlausiblePhone, normalizePhone } from "./core/phone.js";
+export { LEAD_CAPTURE_TEXT } from "./core/lead-capture-text.js";
+export { fillText, openingText } from "./core/lead-capture-format.js";
+export { channelHref, resolveChannels, smsHref, } from "./core/channels.js";
 export { checkTiming, HONEYPOT_FIELD, LEGACY_HONEYPOT_FIELDS, MIN_FILL_MS, RATE_LIMIT_MAX_KEYS, RateLimiter, RENDERED_AT_FIELD, screen, } from "./core/antispam.js";
-export { createAcceptLead, FORM_ID_FIELD, LOCALE_FIELD, LOCATION_FIELD, } from "./core/accept.js";
+export { createAcceptLead, EXPERIMENT_FIELD, FORM_ID_FIELD, LOCALE_FIELD, LOCATION_FIELD, VARIANT_FIELD, } from "./core/accept.js";
 export { areaServedNodes, breadcrumbNode, businessId, businessNode, faqPageNode, offerNodes, organizationId, organizationNode, placeGraph, websiteId, } from "./core/seo/ld.js";
 export { AI_CRAWLERS, ogImageUrl, robotsFor, sitemapFor, } from "./core/seo/sitemap.js";
-export { ALLOWED_PROPS, analyticsSink, countsAsPageView, EVENTS, } from "./core/analytics.js";
+export { ALLOWED_PROPS, analyticsSink, countsAsPageView, EVENTS, EXPERIMENT_SLUG, experimentProps, } from "./core/analytics.js";
 export { brandStatusTarget, statusTarget } from "./core/status.js";
 // A landing needs these beside the machinery; re-exported by name so a brand
 // imports one package and the list here is the whole surface.

package/dist/next/quote-route.d.ts

@@ -1,8 +1,9 @@
 import { RateLimiter } from "../core/antispam.js";
-import type { LeadStore } from "../core/lead.js";
+import { type LeadStore } from "../core/lead.js";
 import type { Place } from "../core/place/types.js";
 import { type Site } from "../core/site.js";
 import type { ServerEnv } from "../server/env.js";
+import type { LeadWebhook } from "../server/lead-webhook.js";
 import type { LeadNotifier } from "../server/notify.js";
 /**
  * `app/quote/route.ts` — the no-JS path, and the one that has to keep working:
@@ -10,7 +11,7 @@ import type { LeadNotifier } from "../server/notify.js";
  *
  * ```ts
  * export const dynamic = "force-dynamic";
- * export const POST = quoteRoute(site, { env: serverEnv, notifier, unavailable });
+ * export const POST = quoteRoute(site, { env: serverEnv, notifier, webhook, unavailable });
  * ```
  */
 export interface UnavailableCopy {
@@ -23,6 +24,13 @@ export interface QuoteRouteDeps<L extends string> {
     env: () => Pick<ServerEnv, "leadsDb" | "posthogKey" | "posthogHost" | "trustedProxy">;
     /** Built once (and at boot, by the brand) so a missing sender fails startup, not a lead. */
     notifier: () => LeadNotifier;
+    /**
+     * The signed lead webhook, or `null` when it is off (`leadWebhook`). A lead
+     * is queued before the 303 and sent after it; the brand's
+     * `instrumentation.ts` should `start()` it so a restart resumes the queue
+     * without waiting for the next lead.
+     */
+    webhook?: () => LeadWebhook | null;
     /** The self-contained 500's words, when the store refused the lead. */
     unavailable: (locale: L, place: Place<L> | null) => UnavailableCopy;
     /** Opened on first use (`next build` imports the route); defaults to `LEADS_DB_URL`'s. */

package/dist/next/quote-route.js

@@ -2,6 +2,7 @@ import { after } from "next/server.js";
 import { createAcceptLead } from "../core/accept.js";
 import { analyticsSink, EVENTS } from "../core/analytics.js";
 import { RateLimiter } from "../core/antispam.js";
+import { channelOf } from "../core/lead.js";
 import { createPlaceView } from "../core/place/view.js";
 import { createRouting, THANKS } from "../core/routing.js";
 import { bakedPlace, contactOf } from "../core/site.js";
@@ -56,6 +57,15 @@ export function quoteRoute(site, deps) {
     const log = deps.log ?? console;
     let store;
     let notifier;
+    let webhook;
+    const leadWebhook = () => {
+        if (webhook === undefined) {
+            webhook = deps.webhook?.() ?? null;
+            // Idempotent: a brand that started it at boot keeps its timer.
+            webhook?.start();
+        }
+        return webhook;
+    };
     const leadStore = () => {
         store ??= deps.store ? deps.store() : openLeadStore(deps.env().leadsDb);
         return store;
@@ -104,8 +114,17 @@ export function quoteRoute(site, deps) {
                 notifier ??= deps.notifier();
                 return notifier.notify(lead, id);
             },
-            capture: (lead, formId) => analyticsSink({ key: env.posthogKey, host: env.posthogHost, brandId: site.brand.id }, lead.placeSlug).capture(EVENTS.leadSubmit, {
+            enqueue: (lead, id, meta) => {
+                const hook = leadWebhook();
+                if (!hook)
+                    return;
+                hook.enqueue(lead, id, meta);
+                defer(() => hook.tick().then(() => undefined, error => log.error("quote: the webhook delivery after a lead failed", error)));
+            },
+            capture: (lead, formId, tags) => analyticsSink({ key: env.posthogKey, host: env.posthogHost, brandId: site.brand.id }, lead.placeSlug).capture(EVENTS.leadSubmit, {
                 form_id: formId,
+                channel: channelOf(lead),
+                ...tags,
             }),
             limiter,
             now: deps.now?.() ?? Date.now(),

package/dist/react/AnalyticsBoundary.js

@@ -3,10 +3,14 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { ContactLinkTracker } from "@evinvest/marketing/tracker";
 import { usePathname } from "next/navigation.js";
 import { useEffect, useMemo } from "react";
-import { analyticsSink, countsAsPageView, EVENTS } from "../core/analytics.js";
-/** `data-intent` on a link or button marks a conversion intent that is not a contact link. */
+import { analyticsSink, countsAsPageView, EVENTS, experimentProps } from "../core/analytics.js";
+import { AnalyticsSinkContext, experimentOf } from "./analytics-context.js";
+/**
+ * `data-intent` on a link or button marks a conversion intent that is not a
+ * contact link — or one the tracker cannot classify (`sms:`).
+ */
 const INTENT_ATTR = "data-intent";
-const INTENTS = ["form_open", "booking"];
+const INTENTS = ["form_open", "booking", "sms", "callback"];
 function source() {
     const utm = new URLSearchParams(window.location.search).get("utm_source");
     if (utm)
@@ -46,10 +50,12 @@ export function AnalyticsBoundary({ target, placeSlug, children }) {
             const el = event.target instanceof Element ? event.target.closest(`[${INTENT_ATTR}]`) : null;
             const channel = el?.getAttribute(INTENT_ATTR);
             if (channel && INTENTS.some(i => i === channel))
-                sink.capture(EVENTS.intent, { channel }, { transport: "beacon" });
+                sink.capture(EVENTS.intent, { channel, ...experimentOf(el) }, { transport: "beacon" });
         };
         document.addEventListener("click", onClick, { capture: true });
         return () => document.removeEventListener("click", onClick, { capture: true });
     }, [sink]);
-    return (_jsx(ContactLinkTracker, { channels: ["phone", "whatsapp"], onContact: ({ channel }) => sink.capture(EVENTS.intent, { channel }, { transport: "beacon" }), children: children }));
+    // A link inside an experiment's island (`LeadCapture`) carries the
+    // assignment on itself, which is what the tracker reads.
+    return (_jsx(AnalyticsSinkContext.Provider, { value: sink, children: _jsx(ContactLinkTracker, { channels: ["phone", "whatsapp"], onContact: ({ channel, data }) => sink.capture(EVENTS.intent, { channel, ...experimentProps(data["experiment"], data["variant"]) }, { transport: "beacon" }), children: children }) }));
 }