@evinvest/kitstart 0.16.0 → 0.18.0

package/dist/core/messenger.js

@@ -0,0 +1,55 @@
+/**
+ * The messenger channels: WhatsApp, where the customer sends our prefilled
+ * message, and Telegram, the brand's bot opened with a deep link. Either way
+ * the lead is posted first, carrying a short reference the customer's message
+ * carries too (`message_ref`) — the one thing that joins the chat to the lead.
+ */
+/** The form field the reference is posted under. */
+export const MESSAGE_REF_FIELD = "message_ref";
+/**
+ * `<PREFIX>-<4..8 chars>` in Crockford base32 without I, L, O, U — read aloud
+ * and typed back without a mix-up. The panel's own rule, the same regex.
+ */
+export const MESSAGE_REF = /^[A-Z]{2,4}-[0-9A-HJKMNP-TV-Z]{4,8}$/;
+/** A brand's reference prefix (`AQ`, `VF`). */
+export const MESSAGE_REF_PREFIX = /^[A-Z]{2,4}$/;
+const CROCKFORD = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+const cryptoBytes = length => crypto.getRandomValues(new Uint8Array(length));
+/**
+ * A fresh reference, `AQ-7K3F`. Not a secret and not unique — 32⁴ per prefix
+ * collide sooner or later, and the panel resolves a reference to the brand's
+ * newest lead — just short enough to survive a chat.
+ */
+export function newMessageRef(prefix, random = cryptoBytes) {
+    if (!MESSAGE_REF_PREFIX.test(prefix))
+        throw new Error(`message ref: the prefix must be 2–4 capital letters, got ${JSON.stringify(prefix)}`);
+    // 32 divides 256: a byte masked to five bits draws each symbol evenly.
+    const body = [...random(4)].map(b => CROCKFORD[b & 31] ?? "0").join("");
+    return `${prefix}-${body}`;
+}
+/** A posted reference, when it is one; anything else is dropped, never refused. */
+export function messageRefOf(value) {
+    if (typeof value !== "string")
+        return null;
+    const ref = value.trim().toUpperCase();
+    return MESSAGE_REF.test(ref) ? ref : null;
+}
+/**
+ * A Telegram bot's username, without `@`: Telegram's own rule for a bot — 5
+ * to 32 characters, a letter first, ending in `bot` — and the panel's.
+ */
+export const TELEGRAM_BOT = /^[A-Za-z][A-Za-z0-9_]{1,28}[Bb][Oo][Tt]$/;
+/**
+ * The bot's deep link, `https://t.me/<bot>?start=<ref>`. The `start`
+ * parameter allows `A-Za-z0-9_-` only — a reference always is — so anything
+ * else is left off rather than encoded into a link the bot would not read.
+ */
+export function telegramHref(bot, start) {
+    const name = bot.replace(/^@/, "");
+    return start && /^[A-Za-z0-9_-]{1,64}$/.test(start) ? `https://t.me/${name}?start=${start}` : `https://t.me/${name}`;
+}
+export function channelsAvailable(facts) {
+    const wa = Boolean(facts?.whatsapp);
+    const tg = Boolean(facts?.telegram);
+    return wa && tg ? "wa,tg" : wa ? "wa" : tg ? "tg" : "none";
+}

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

@@ -1,4 +1,4 @@
-export { servedLocalities, storefrontOf, type DayOfWeek, type Geo, type OpeningHours, type Place, type PostalAddress, type Presence, type Rating, type ServiceArea, } from "./types.js";
+export { servedLocalities, storefrontOf, type DayOfWeek, type Geo, type MessengerSwitches, 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";

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

@@ -1,5 +1,5 @@
 import type { BookingConfig, BookingRules } from "../booking/model.js";
-import type { Geo, OpeningHours, Place, PostalAddress, Rating, ServiceArea } from "./types.js";
+import type { Geo, MessengerSwitches, OpeningHours, Place, PostalAddress, Rating, ServiceArea } from "./types.js";
 /**
  * The live half of a place, as `GET <source>/locations/<slug>` answers it.
  * Every field is optional: whatever the source leaves out, the baked config
@@ -19,6 +19,10 @@ export interface PlaceLive<L extends string> {
     rating?: Rating;
     /** Validated with the site's Cal.com hosts; one that does not validate is dropped, the baked one kept. */
     booking?: BookingConfig;
+    /** The place's Telegram bot, its username without `@` (`TELEGRAM_BOT`). */
+    telegram?: string;
+    /** The panel's kill switches for the messengers; a key left out is on. */
+    messengers?: MessengerSwitches;
 }
 /**
  * Drops what does not validate instead of failing the page on one bad field.

package/dist/core/place/live.js

@@ -1,4 +1,5 @@
 import { BookingConfigError, parseBookingConfig } from "../booking/validate.js";
+import { TELEGRAM_BOT } from "../messenger.js";
 import { parseInstant } from "./rating.js";
 const DAYS = ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday"];
 const TIME = /^([01]\d|2[0-3]):[0-5]\d$/;
@@ -61,6 +62,17 @@ function landmark(v, locales) {
 function isComplete(record, locales) {
     return locales.every(locale => typeof record[locale] === "string");
 }
+/** Each switch only when it is a boolean: a switch that does not read is left on. */
+function messengers(v) {
+    if (!isObject(v))
+        return undefined;
+    const out = {};
+    if (typeof v.whatsapp === "boolean")
+        out.whatsapp = v.whatsapp;
+    if (typeof v.telegram === "boolean")
+        out.telegram = v.telegram;
+    return Object.keys(out).length > 0 ? out : undefined;
+}
 function booking(v, rules) {
     if (v === undefined || v === null)
         return undefined;
@@ -121,6 +133,12 @@ export function parsePlaceLive(body, locales, rules = {}) {
     const b = booking(body.booking, rules);
     if (b)
         live.booking = b;
+    const bot = str(body.telegram)?.replace(/^@/, "");
+    if (bot && TELEGRAM_BOT.test(bot))
+        live.telegram = bot;
+    const m = messengers(body.messengers);
+    if (m)
+        live.messengers = m;
     return live;
 }
 /**
@@ -131,6 +149,8 @@ export function parsePlaceLive(body, locales, rules = {}) {
 export function mergeLive(baked, live) {
     const front = baked.presence;
     const booking = live.booking ?? baked.booking;
+    const telegram = live.telegram ?? baked.channels.telegram;
+    const switches = live.messengers ?? baked.messengers;
     return {
         ...baked,
         presence: front.kind === "storefront"
@@ -142,10 +162,11 @@ export function mergeLive(baked, live) {
                 landmark: live.landmark ?? front.landmark,
             }
             : front,
-        channels: { phone: live.phone ?? baked.channels.phone, whatsapp: live.whatsapp ?? baked.channels.whatsapp },
+        channels: { phone: live.phone ?? baked.channels.phone, whatsapp: live.whatsapp ?? baked.channels.whatsapp, ...(telegram !== undefined ? { telegram } : {}) },
         serviceArea: live.serviceArea ?? baked.serviceArea,
         hours: live.hours ?? baked.hours,
         rating: live.rating ?? baked.rating,
         ...(booking ? { booking } : {}),
+        ...(switches ? { messengers: switches } : {}),
     };
 }

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

@@ -72,11 +72,22 @@ export interface Place<L extends string> {
     name: Readonly<Record<L, string>>;
     presence: Presence<L>;
     serviceArea: readonly ServiceArea[] | null;
-    /** International numbers as printed; `null` → the brand's own. */
+    /**
+     * International numbers as printed; `null` → the brand's own. `telegram`:
+     * the place's bot, its username without `@` (`PlaceLive.telegram`) —
+     * absent or `null`, no bot; never the brand's.
+     */
     channels: {
         phone: string | null;
         whatsapp: string | null;
+        telegram?: string | null;
     };
+    /**
+     * The panel's switches for the messengers (`PlaceLive.messengers`): `false`
+     * takes one off the lead form's messenger variants (`messengerFacts`) only —
+     * `contactOf`, the header's and the call bar's numbers, keeps it; absent is on.
+     */
+    messengers?: MessengerSwitches;
     hours: readonly OpeningHours[] | null;
     /** Live only. */
     rating: Rating | null;
@@ -86,6 +97,11 @@ export interface Place<L extends string> {
      */
     booking?: BookingConfig;
 }
+/** Which messengers the panel lets a place offer; a key left out is on. */
+export interface MessengerSwitches {
+    whatsapp?: boolean;
+    telegram?: boolean;
+}
 /** The storefront half of a place, or `null` for a service-area business. */
 export declare function storefrontOf<L extends string>(place: Place<L>): Extract<Presence<L>, {
     kind: "storefront";

package/dist/core/site.d.ts

@@ -1,6 +1,7 @@
 import type { LocaleRegistry } from "@evinvest/i18n";
 import type { BookingRules } from "./booking/model.js";
 import type { LeadSchema } from "./lead.js";
+import { type MessengerFacts } from "./messenger.js";
 import type { PublicationPolicy } from "./place/publication.js";
 import type { Place } from "./place/types.js";
 import type { PricingModel } from "./pricing/model.js";
@@ -126,8 +127,14 @@ export declare function assertLaunchable(site: {
 }, todos: readonly OwnerTodo[]): void;
 /** The baked place for a slug, if the site has it. */
 export declare function bakedPlace<L extends string, P extends string>(site: Site<L, P>, slug: string): Place<L> | undefined;
-/** The numbers a place answers on: its own, or the brand's until it has one. */
+/**
+ * The numbers a place answers on: its own, or the brand's until it has one.
+ * The panel's messenger switches (`place.messengers`) do not reach here — they
+ * are the lead form's (`messengerFacts`); the header, the call bar and the
+ * control's channels keep the number.
+ */
 export declare function contactOf(site: Pick<SiteConfig<string, string>, "brand">, place: Place<string>): {
     phone: string | null;
     whatsapp: string | null;
 };
+export declare function messengerFacts(_site: Pick<SiteConfig<string, string>, "brand">, place: Place<string>): MessengerFacts;

package/dist/core/site.js

@@ -1,4 +1,5 @@
 import { bookingConfigProblems, calComHostsProblems } from "./booking/validate.js";
+import { TELEGRAM_BOT } from "./messenger.js";
 import { pricingProblemsFor } from "./pricing/validate.js";
 export function defineSite(config) {
     const pageKeys = Object.keys(config.pages).filter((k) => Object.hasOwn(config.pages, k));
@@ -101,10 +102,30 @@ export function assertLaunchable(site, todos) {
 export function bakedPlace(site, slug) {
     return site.places.find(p => p.slug === slug);
 }
-/** The numbers a place answers on: its own, or the brand's until it has one. */
+/**
+ * The numbers a place answers on: its own, or the brand's until it has one.
+ * The panel's messenger switches (`place.messengers`) do not reach here — they
+ * are the lead form's (`messengerFacts`); the header, the call bar and the
+ * control's channels keep the number.
+ */
 export function contactOf(site, place) {
     return {
         phone: place.channels.phone ?? site.brand.phone,
         whatsapp: place.channels.whatsapp ?? site.brand.phone,
     };
 }
+/**
+ * What a `LeadCapture` `messenger` variant may offer (`messengers`): the
+ * place's own WhatsApp number — never the brand's phone, the chat is answered
+ * by hand at the place — and its bot, each unless the panel switched it off.
+ * A baked bot whose name is not one (`TELEGRAM_BOT`) is none, as a live one is.
+ * Not a fallback for `contactOf`: the control's WhatsApp link keeps the brand's.
+ */
+const validBot = (bot) => (bot && TELEGRAM_BOT.test(bot) ? bot : null);
+export function messengerFacts(_site, place) {
+    const on = place.messengers ?? {};
+    return {
+        whatsapp: on.whatsapp === false ? null : place.channels.whatsapp,
+        telegram: on.telegram === false ? null : validBot(place.channels.telegram),
+    };
+}

package/dist/index.d.ts

@@ -3,21 +3,24 @@
  * the proxy (edge), a client island and a server module can all import it.
  * 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, 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 { assertLaunchable, bakedPlace, cardFact, contactOf, defineSite, messengerFacts, ogLocaleOf, openLaunchBlockers, perLocale, type BrandFacts, type LegacyRedirect, type OwnerTodo, type PageSuffix, type Site, type SiteConfig, type Topology, } from "./core/site.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 MessengerSwitches, 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 { CARD_FIELD, CARD_ID, CHANNEL_FIELD, channelOf, CONSENT_FIELD, LEAD_CHANNELS, LEAD_ERROR_PARAM, LEAD_CARD_PARAM, leadErrorFor, leadErrorOf, LEAD_SCHEMA_VERSION, MAX_CONSENT, MAX_FIELD, readCandidate, rejectionOf, suspectOf, SUBMISSION_FIELD, SUBMISSION_ID, validateCallbackLead, validateCandidate, validateLead, type Lead, type LeadCandidate, type LeadChannel, type LeadError, type PageLeadError, type LeadConsent, type LeadExtra, type LeadPrice, type LeadRejection, type LeadSchema, type LeadStore, type LeadSuspect, type LeadVerdict, type LeadWire, type SpamVerdict, } from "./core/lead.js";
+export { CARD_FIELD, CARD_ID, CHANNEL_FIELD, channelOf, CONSENT_FIELD, isMessengerChannel, LEAD_CHANNELS, LEAD_ERROR_PARAM, LEAD_CARD_PARAM, leadErrorFor, leadErrorOf, LEAD_SCHEMA_VERSION, MAX_CONSENT, MAX_FIELD, readCandidate, rejectionOf, suspectOf, SUBMISSION_FIELD, SUBMISSION_ID, validateCallbackLead, validateCandidate, validateLead, type Lead, type LeadCandidate, type LeadChannel, type LeadError, type PageLeadError, type LeadConsent, type MessengerChannel, type LeadExtra, type LeadPrice, type LeadRejection, type LeadSchema, type LeadStore, type LeadSuspect, type LeadVerdict, type LeadWire, type SpamVerdict, } from "./core/lead.js";
 export { isMobilePhone, isPlausiblePhone, normalizePhone, phoneProblem } from "./core/phone.js";
 export { answeredUnknown, CENTS_BUCKETS, centsBucket, ESTIMATE_FIELD_PREFIX, ESTIMATE_UNKNOWN, estimateField, flowOf, labelOf, LEAD_FLOWS, mulBp, parsePricingModel, priceOf, PRICING_CURRENCY, PRICING_FORMAT, PRICING_LIMITS, PricingModelError, pricingProblems, pricingProblemsFor, readEstimateInputs, roundTo, type AddOption, type DiscountOption, type LeadFlow, type LeadFlows, type MultiplyOption, type NeedPricing, type Price, type PriceLine, type PricingInput, type PricingInputKind, type PricingInputs, type PricingLabels, type PricingModel, } from "./core/pricing/index.js";
 export { flowTextOf, LEAD_CAPTURE_TEXT, type LeadCaptureFlowText, type LeadCaptureText } from "./core/lead-capture-text.js";
+export { LEAD_CAPTURE_MESSENGER_TEXT, messengerTextOf, type LeadCaptureMessengerText } from "./core/messenger-text.js";
+export { channelsAvailable, MESSAGE_REF, MESSAGE_REF_FIELD, MESSAGE_REF_PREFIX, messageRefOf, newMessageRef, TELEGRAM_BOT, telegramHref, type ChannelsAvailable, type MessengerFacts, type MessengerKind, type MessengerMode, type MessengerVariant, type RandomBytes, } from "./core/messenger.js";
+export { MAX_MESSENGER_MESSAGE, messengerMessage, type MessengerMessageInput, type MessengerMessageText } from "./core/messenger-message.js";
 export { fillText, formatCents, 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, ANALYTICS_ID_FIELD, EXPERIMENT_FIELD, FORM_ID_FIELD, leadRef, LOCALE_FIELD, LOCATION_FIELD, PRICE_CHANGED, SHOWN_CENTS_FIELD, VARIANT_FIELD, type AcceptDeps, type Outcome, type SubmitTags, } from "./core/accept.js";
+export { createAcceptLead, ANALYTICS_ID_FIELD, CHANNELS_FIELD, EXPERIMENT_FIELD, FORM_ID_FIELD, leadRef, LOCALE_FIELD, LOCATION_FIELD, PRICE_CHANGED, SHOWN_CENTS_FIELD, submitTagsOf, 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, ANALYTICS_ID, analyticsSink, countsAsPageView, EVENTS, EXPERIMENT_SLUG, experimentProps, type AnalyticsTarget, type IntentChannel, type LeadField, type LeadStep, } from "./core/analytics.js";
-export { AB_COOKIE_PREFIX, AB_FORCE_PARAM, abAssignments, abReset, abVariantUrl, cookieValue, type AbReset, } from "./core/ab-switcher.js";
+export { ALLOWED_PROPS, ANALYTICS_ID, analyticsSink, channelsProps, countsAsPageView, EVENTS, EXPERIMENT_SLUG, experimentProps, qaVisit, type AnalyticsTarget, type IntentChannel, type LeadField, type LeadStep, } from "./core/analytics.js";
+export { AB_COOKIE_PREFIX, AB_FORCE_PARAM, abAssignments, abRunning, abReset, abVariantUrl, cookieValue, type AbReset, } from "./core/ab-switcher.js";
 export { abSwitcherVisible } from "./core/ab-gate.js";
 export type { CallBarText, CopySlice, CoreText, PageMetaCopy, QuoteFormCopy, Said, StatusAction, StatusCopy, StatusScreenText, } from "./core/content.js";
 export { BOOKING_LIMITS, BOOKING_PROVIDERS, BOOKING_STATUSES, BookingConfigError, bookingConfigProblems, BOOKING_EXPERIMENT, bookingHref, bookingOf, bookingRequestedProperties, bookingRequestProblems, calComHostsProblems, DEFAULT_BOOKING, DEFAULT_CAL_COM_HOSTS, isBookingProvider, isLeadRef, isPageProvider, isPreferredPart, parseBookingConfig, parseBookingRequest, PREFERRED_PARTS, type BookingChoice, type BookingConfig, type BookingPrefill, type BookingProvider, type BookingRequest, type BookingRequestedProperties, type BookingRules, type BookingStatus, type OpenBookingConfig, type PageProvider, type PreferredPart, } from "./core/booking/index.js";

package/dist/index.js

@@ -3,21 +3,24 @@
  * the proxy (edge), a client island and a server module can all import it.
  * Runtime-bound halves live on their own subpaths.
  */
-export { assertLaunchable, bakedPlace, cardFact, contactOf, defineSite, ogLocaleOf, openLaunchBlockers, perLocale, } from "./core/site.js";
+export { assertLaunchable, bakedPlace, cardFact, contactOf, defineSite, messengerFacts, ogLocaleOf, openLaunchBlockers, perLocale, } from "./core/site.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 { CARD_FIELD, CARD_ID, CHANNEL_FIELD, channelOf, CONSENT_FIELD, LEAD_CHANNELS, LEAD_ERROR_PARAM, LEAD_CARD_PARAM, leadErrorFor, leadErrorOf, LEAD_SCHEMA_VERSION, MAX_CONSENT, MAX_FIELD, readCandidate, rejectionOf, suspectOf, SUBMISSION_FIELD, SUBMISSION_ID, validateCallbackLead, validateCandidate, validateLead, } from "./core/lead.js";
+export { CARD_FIELD, CARD_ID, CHANNEL_FIELD, channelOf, CONSENT_FIELD, isMessengerChannel, LEAD_CHANNELS, LEAD_ERROR_PARAM, LEAD_CARD_PARAM, leadErrorFor, leadErrorOf, LEAD_SCHEMA_VERSION, MAX_CONSENT, MAX_FIELD, readCandidate, rejectionOf, suspectOf, SUBMISSION_FIELD, SUBMISSION_ID, validateCallbackLead, validateCandidate, validateLead, } from "./core/lead.js";
 export { isMobilePhone, isPlausiblePhone, normalizePhone, phoneProblem } from "./core/phone.js";
 export { answeredUnknown, CENTS_BUCKETS, centsBucket, ESTIMATE_FIELD_PREFIX, ESTIMATE_UNKNOWN, estimateField, flowOf, labelOf, LEAD_FLOWS, mulBp, parsePricingModel, priceOf, PRICING_CURRENCY, PRICING_FORMAT, PRICING_LIMITS, PricingModelError, pricingProblems, pricingProblemsFor, readEstimateInputs, roundTo, } from "./core/pricing/index.js";
 export { flowTextOf, LEAD_CAPTURE_TEXT } from "./core/lead-capture-text.js";
+export { LEAD_CAPTURE_MESSENGER_TEXT, messengerTextOf } from "./core/messenger-text.js";
+export { channelsAvailable, MESSAGE_REF, MESSAGE_REF_FIELD, MESSAGE_REF_PREFIX, messageRefOf, newMessageRef, TELEGRAM_BOT, telegramHref, } from "./core/messenger.js";
+export { MAX_MESSENGER_MESSAGE, messengerMessage } from "./core/messenger-message.js";
 export { fillText, formatCents, 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, ANALYTICS_ID_FIELD, EXPERIMENT_FIELD, FORM_ID_FIELD, leadRef, LOCALE_FIELD, LOCATION_FIELD, PRICE_CHANGED, SHOWN_CENTS_FIELD, VARIANT_FIELD, } from "./core/accept.js";
+export { createAcceptLead, ANALYTICS_ID_FIELD, CHANNELS_FIELD, EXPERIMENT_FIELD, FORM_ID_FIELD, leadRef, LOCALE_FIELD, LOCATION_FIELD, PRICE_CHANGED, SHOWN_CENTS_FIELD, submitTagsOf, 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, ANALYTICS_ID, analyticsSink, countsAsPageView, EVENTS, EXPERIMENT_SLUG, experimentProps, } from "./core/analytics.js";
-export { AB_COOKIE_PREFIX, AB_FORCE_PARAM, abAssignments, abReset, abVariantUrl, cookieValue, } from "./core/ab-switcher.js";
+export { ALLOWED_PROPS, ANALYTICS_ID, analyticsSink, channelsProps, countsAsPageView, EVENTS, EXPERIMENT_SLUG, experimentProps, qaVisit, } from "./core/analytics.js";
+export { AB_COOKIE_PREFIX, AB_FORCE_PARAM, abAssignments, abRunning, abReset, abVariantUrl, cookieValue, } from "./core/ab-switcher.js";
 export { abSwitcherVisible } from "./core/ab-gate.js";
 export { BOOKING_LIMITS, BOOKING_PROVIDERS, BOOKING_STATUSES, BookingConfigError, bookingConfigProblems, BOOKING_EXPERIMENT, bookingHref, bookingOf, bookingRequestedProperties, bookingRequestProblems, calComHostsProblems, DEFAULT_BOOKING, DEFAULT_CAL_COM_HOSTS, isBookingProvider, isLeadRef, isPageProvider, isPreferredPart, parseBookingConfig, parseBookingRequest, PREFERRED_PARTS, } from "./core/booking/index.js";
 export { brandStatusTarget, statusTarget, thanksChannel, thanksSuffix } from "./core/status.js";

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

@@ -56,6 +56,13 @@ export interface QuoteRouteDeps<L extends string> {
      * `<anchor>-callback`.
      */
     anchor?: string;
+    /**
+     * The brand's QA cookie (`AnalyticsBoundary`'s and `AbSwitcher`'s
+     * `qaCookie`). A post carrying it with a value is a test visit: its
+     * `lead_form_submit` and `lead_form_reject` say `forced: true`, as the
+     * browser's events of the same visit do. Absent → no `forced` key.
+     */
+    qaCookie?: string;
     /** Work after the response; `after` from `next/server` by default. */
     defer?: (task: () => Promise<void> | void) => void;
     now?: () => number;

package/dist/next/quote-route.js

@@ -1,7 +1,7 @@
 import { after } from "next/server.js";
 import { CONFIRM_PATH, confirmQuery } from "./confirm-route.js";
-import { createAcceptLead, EXPERIMENT_FIELD, PRICE_CHANGED, VARIANT_FIELD } from "../core/accept.js";
-import { analyticsSink, EVENTS, experimentProps } from "../core/analytics.js";
+import { createAcceptLead, PRICE_CHANGED, submitTagsOf } from "../core/accept.js";
+import { analyticsSink, EVENTS } from "../core/analytics.js";
 import { RateLimiter } from "../core/antispam.js";
 import { CARD_FIELD, CARD_ID, channelOf, LEAD_CARD_PARAM, LEAD_ERROR_PARAM } from "../core/lead.js";
 import { createPlaceView } from "../core/place/view.js";
@@ -54,10 +54,6 @@ function seeOther(location) {
 function json(status, body) {
     return new Response(JSON.stringify(body), { status, headers: { "Content-Type": "application/json", "Cache-Control": "no-store" } });
 }
-const text = (form, name) => {
-    const value = form.get(name);
-    return typeof value === "string" ? value : null;
-};
 /** `LeadCapture`'s own post asks for JSON; a plain form post never does. */
 const wantsJson = (request) => (request.headers.get("accept") ?? "").includes("application/json");
 export function quoteRoute(site, deps) {
@@ -148,6 +144,9 @@ export function quoteRoute(site, deps) {
             const locale = form.get("locale");
             return unavailable(null, typeof locale === "string" && site.i18n.isLocale(locale) ? locale : site.i18n.defaultLocale);
         }
+        // The request's events, marked as the browser's are (`analyticsSink`).
+        const cookies = request.headers.get("cookie") ?? "";
+        const sinkFor = (slug) => analyticsSink({ key: env.posthogKey, host: env.posthogHost, brandId: site.brand.id }, slug, undefined, deps.qaCookie, cookies);
         const outcome = await accept(form, clientKey(request.headers, env.trustedProxy ?? DEV_TRUST), {
             insert: lead => leadStore().insert(lead),
             findSubmission: async (submissionId) => (await leadStore().findSubmission?.(submissionId)) ?? null,
@@ -165,9 +164,10 @@ export function quoteRoute(site, deps) {
                 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, {
+            capture: (lead, formId, tags) => sinkFor(lead.placeSlug).capture(EVENTS.leadSubmit, {
                 form_id: formId,
                 channel: channelOf(lead),
+                ...(lead.messageRef ? { message_ref: lead.messageRef } : {}),
                 ...tags,
             }),
             limiter: (limiter ??= new RateLimiter(env.leadRateLimit?.limit ?? 5, env.leadRateLimit?.windowMs ?? 600_000)),
@@ -191,12 +191,12 @@ export function quoteRoute(site, deps) {
                 return scripted ? json(200, { ok: true, location, lead: outcome.ref, ...price }) : seeOther(location);
             }
             case "invalid": {
-                const tags = experimentProps(text(form, EXPERIMENT_FIELD), text(form, VARIANT_FIELD));
+                const tags = submitTagsOf(form);
                 // The field's role and why — never what was typed.
                 const repriced = outcome.field === PRICE_CHANGED;
                 const props = { form_id: outcome.formId, channel: outcome.channel, field: outcome.field, reason: repriced ? PRICE_CHANGED : "invalid", ...tags };
                 if (env.posthogKey) {
-                    const sink = analyticsSink({ key: env.posthogKey, host: env.posthogHost, brandId: site.brand.id }, outcome.slug);
+                    const sink = sinkFor(outcome.slug);
                     defer(() => sink.capture(EVENTS.formReject, props));
                 }
                 if (scripted)

package/dist/react/AbSwitcherPanel.d.ts

@@ -3,6 +3,8 @@ import type { AbSwitcherProps } from "./ab-switcher-types.js";
  * The QA menu itself, loaded only when `AbSwitcher` lets it: a chip in a
  * corner and, on a tap, each experiment's variants. A tap on a variant is the
  * brand's own force parameter — no other way in. Minimized and hidden live in
- * memory only: a reload brings the chip back.
+ * memory only: a reload brings the chip back. An experiment no cookie assigns
+ * is off: the proxy assigns every running one on the page the menu mounts on,
+ * and would refuse a force for it, so its variants are disabled.
  */
 export declare function AbSwitcherPanel({ experiments, qaCookie, current, forceParam, className, text }: AbSwitcherProps): import("react").JSX.Element | null;

package/dist/react/AbSwitcherPanel.js

@@ -2,25 +2,27 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Badge, Button, cn } from "@evinvest/uikit";
 import { useEffect, useRef, useState } from "react";
-import { abAssignments, abReset, abVariantUrl, AB_FORCE_PARAM } from "../core/ab-switcher.js";
+import { abAssignments, abReset, abRunning, abVariantUrl, AB_FORCE_PARAM } from "../core/ab-switcher.js";
 const TEXT = {
     title: "A/B test switcher",
     reset: "Reset",
     leave: "Leave test",
     minimize: "Minimize",
     hide: "Hide",
-    unassigned: "not assigned",
+    unassigned: "not running",
 };
 /**
  * The QA menu itself, loaded only when `AbSwitcher` lets it: a chip in a
  * corner and, on a tap, each experiment's variants. A tap on a variant is the
  * brand's own force parameter — no other way in. Minimized and hidden live in
- * memory only: a reload brings the chip back.
+ * memory only: a reload brings the chip back. An experiment no cookie assigns
+ * is off: the proxy assigns every running one on the page the menu mounts on,
+ * and would refuse a force for it, so its variants are disabled.
  */
 export function AbSwitcherPanel({ experiments, qaCookie, current, forceParam = AB_FORCE_PARAM, className, text }) {
     const t = { ...TEXT, ...text };
     const keys = experiments.map(e => e.key);
-    const [assigned] = useState(() => current ?? abAssignments(document.cookie, keys));
+    const [assigned] = useState(() => abRunning(current ?? abAssignments(document.cookie, keys), document.cookie, qaCookie));
     const [open, setOpen] = useState(false);
     const [minimized, setMinimized] = useState(false);
     const [hidden, setHidden] = useState(false);
@@ -38,9 +40,11 @@ export function AbSwitcherPanel({ experiments, qaCookie, current, forceParam = A
             document.cookie = c;
         location.replace(plan.url);
     };
+    // The first choice a tap can take gets the focus; with none, the reset.
+    const live = experiments.findIndex(e => assigned[e.key] !== undefined);
     if (hidden)
         return null;
-    return (_jsxs("div", { "data-ab-switcher": "", ref: root, className: cn("fixed right-4 bottom-4 z-40", className), children: [open && (_jsxs("div", { role: "dialog", "aria-label": t.title, className: "absolute right-0 bottom-full mb-2 flex w-80 max-w-[calc(100vw-2rem)] flex-col gap-4 rounded-md border border-border bg-popover p-3 text-ink shadow-md", children: [experiments.map((e, i) => (_jsx(ExperimentRow, { experiment: e, value: assigned[e.key], unassigned: t.unassigned, autoFocus: i === 0, onPick: v => location.assign(abVariantUrl(location.href, e.key, v, forceParam)) }, e.key))), _jsxs("div", { className: "flex flex-wrap gap-2", children: [_jsx(Button, { variant: "primary", size: "touch", className: "flex-1", onClick: () => reset("reassign"), children: t.reset }), _jsx(Button, { variant: "outline", size: "touch", className: "flex-1", onClick: () => reset("leave"), children: t.leave })] }), _jsxs("div", { className: "flex gap-2", children: [_jsx(Button, { variant: "ghost", size: "touch", className: "flex-1", onClick: () => { setMinimized(true); close(true); }, children: t.minimize }), _jsx(Button, { variant: "ghost", size: "touch", className: "flex-1", onClick: () => setHidden(true), children: t.hide })] })] })), _jsxs(Button, { ref: chip, variant: "secondary", size: "touch", icon: minimized, "aria-label": t.title, "aria-expanded": open, className: cn("shadow-md", !minimized && "gap-1.5 px-3"), onClick: () => { if (open)
+    return (_jsxs("div", { "data-ab-switcher": "", ref: root, className: cn("fixed right-4 bottom-4 z-40", className), children: [open && (_jsxs("div", { role: "dialog", "aria-label": t.title, className: "absolute right-0 bottom-full mb-2 flex w-80 max-w-[calc(100vw-2rem)] flex-col gap-4 rounded-md border border-border bg-popover p-3 text-ink shadow-md", children: [experiments.map((e, i) => (_jsx(ExperimentRow, { experiment: e, value: assigned[e.key], unassigned: t.unassigned, autoFocus: i === live, onPick: v => location.assign(abVariantUrl(location.href, e.key, v, forceParam)) }, e.key))), _jsxs("div", { className: "flex flex-wrap gap-2", children: [_jsx(Button, { variant: "primary", size: "touch", autoFocus: live < 0, className: "flex-1", onClick: () => reset("reassign"), children: t.reset }), _jsx(Button, { variant: "outline", size: "touch", className: "flex-1", onClick: () => reset("leave"), children: t.leave })] }), _jsxs("div", { className: "flex gap-2", children: [_jsx(Button, { variant: "ghost", size: "touch", className: "flex-1", onClick: () => { setMinimized(true); close(true); }, children: t.minimize }), _jsx(Button, { variant: "ghost", size: "touch", className: "flex-1", onClick: () => setHidden(true), children: t.hide })] })] })), _jsxs(Button, { ref: chip, variant: "secondary", size: "touch", icon: minimized, "aria-label": t.title, "aria-expanded": open, className: cn("shadow-md", !minimized && "gap-1.5 px-3"), onClick: () => { if (open)
                     close(false);
                 else {
                     setOpen(true);
@@ -72,6 +76,6 @@ function ExperimentRow({ experiment: e, value, unassigned, autoFocus, onPick })
     const labelId = `ab-switcher-${e.key}`;
     return (_jsxs("div", { role: "group", "aria-labelledby": labelId, className: "flex flex-col gap-2", children: [_jsxs("div", { className: "flex items-baseline justify-between gap-2 text-sm", children: [_jsx("span", { id: labelId, className: "font-medium text-ink", children: e.label ?? e.key }), value === undefined && _jsx("span", { className: "text-xs text-ink-soft", children: unassigned })] }), _jsx("div", { className: "flex flex-wrap gap-2", children: e.variants.map((v, i) => {
                     const on = v.value === value;
-                    return (_jsx(Button, { variant: on ? "primary" : "outline", size: "touch", "aria-pressed": on, autoFocus: autoFocus && i === 0, className: "flex-1", onClick: () => onPick(v.value), children: v.label }, v.value));
+                    return (_jsx(Button, { variant: on ? "primary" : "outline", size: "touch", "aria-pressed": on, disabled: value === undefined, autoFocus: autoFocus && i === 0, className: "flex-1", onClick: () => onPick(v.value), children: v.label }, v.value));
                 }) })] }));
 }

package/dist/react/AnalyticsBoundary.d.ts

@@ -12,9 +12,10 @@ export interface AnalyticsBoundaryProps {
     placeSlug: string | null;
     /**
      * The cookie the brand's force parameter sets (`AbSwitcher`'s `qaCookie`).
-     * A visit carrying it is a test: its page views and intents say
+     * A visit carrying it is a test: every event through the boundary's sink —
+     * page views, intents, the lead form's funnel and booking — says
      * `forced: true`, so the QA menu's reloads do not count as a place's
-     * traffic. Read in the browser at each event, never on the server.
+     * traffic. Read in the browser at each event (`analyticsSink`).
      */
     qaCookie?: string;
     children: ReactNode;

package/dist/react/AnalyticsBoundary.js

@@ -3,7 +3,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { ContactLinkTracker } from "@evinvest/marketing/tracker";
 import { usePathname } from "next/navigation.js";
 import { useEffect, useMemo, useState } from "react";
-import { analyticsSink, countsAsPageView, EVENTS, experimentProps } from "../core/analytics.js";
+import { analyticsSink, channelsProps, countsAsPageView, EVENTS, experimentProps } from "../core/analytics.js";
 import { AnalyticsIdContext, AnalyticsSinkContext, experimentOf } from "./analytics-context.js";
 import { newSubmissionId } from "./use-lead-submit.js";
 /**
@@ -11,16 +11,7 @@ import { newSubmissionId } from "./use-lead-submit.js";
  * contact link — or one the tracker cannot classify (`sms:`).
  */
 const INTENT_ATTR = "data-intent";
-const INTENTS = ["form_open", "booking", "sms", "callback"];
-/**
- * Whether the QA cookie is set with a value. Its own copy, not `ab-gate`'s:
- * a module shared with `AbSwitcher` makes Turbopack split it into a chunk of
- * its own, which costs every visitor more than these lines.
- */
-const qaVisit = (name) => document.cookie.split(";").some(c => {
-    const eq = c.indexOf("=");
-    return eq > 0 && c.slice(0, eq).trim() === name && c.slice(eq + 1).trim() !== "";
-});
+const INTENTS = ["form_open", "booking", "sms", "callback", "telegram", "whatsapp_qr"];
 function source() {
     const utm = new URLSearchParams(window.location.search).get("utm_source");
     if (utm)
@@ -41,31 +32,27 @@ export function AnalyticsBoundary({ target, placeSlug, qaCookie, children }) {
     // One visitor for the boundary's life, in memory only: a sink rebuilt for
     // another place keeps it, and a lead posted from the page can name it.
     const [distinctId] = useState(newSubmissionId);
-    const sink = useMemo(() => analyticsSink({ key, host, brandId }, placeSlug, distinctId), [key, host, brandId, placeSlug, distinctId]);
+    const sink = useMemo(() => analyticsSink({ key, host, brandId }, placeSlug, distinctId, qaCookie), [key, host, brandId, placeSlug, distinctId, qaCookie]);
     const pathname = usePathname();
-    // Spread into an event: `{}` without the cookie, so a brand that never
-    // passes `qaCookie` sends exactly what it sent before.
-    const forced = () => (qaCookie && qaVisit(qaCookie) ? { forced: true } : {});
     useEffect(() => {
         if (!countsAsPageView(pathname))
             return;
         sink.capture(EVENTS.pageView, {
             source: source(),
             device: window.matchMedia("(max-width: 767px)").matches ? "mobile" : "desktop",
-            ...forced(),
         });
-    }, [sink, pathname, qaCookie]);
+    }, [sink, pathname]);
     useEffect(() => {
         const onClick = (event) => {
             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, ...experimentOf(el), ...forced() }, { 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, qaCookie]);
+    }, [sink]);
     // A link inside an experiment's island (`LeadCapture`) carries the
     // assignment on itself, which is what the tracker reads.
-    return (_jsx(AnalyticsIdContext.Provider, { value: key ? distinctId : null, children: _jsx(AnalyticsSinkContext.Provider, { value: sink, children: _jsx(ContactLinkTracker, { channels: ["phone", "whatsapp"], onContact: ({ channel, data }) => sink.capture(EVENTS.intent, { channel, ...experimentProps(data["experiment"], data["variant"]), ...forced() }, { transport: "beacon" }), children: children }) }) }));
+    return (_jsx(AnalyticsIdContext.Provider, { value: key ? distinctId : null, children: _jsx(AnalyticsSinkContext.Provider, { value: sink, children: _jsx(ContactLinkTracker, { channels: ["phone", "whatsapp"], onContact: ({ channel, data }) => sink.capture(EVENTS.intent, { channel, ...experimentProps(data["experiment"], data["variant"]), ...channelsProps(data["channelsAvailable"]) }, { transport: "beacon" }), children: children }) }) }));
 }

package/dist/react/LeadCapture.d.ts

@@ -1,6 +1,7 @@
 import { type ReactNode } from "react";
 import { type CaptureChannel } from "../core/channels.js";
 import { type LeadError, type LeadWire, type PageLeadError } from "../core/lead.js";
+import { type MessengerFacts, type MessengerVariant } from "../core/messenger.js";
 import { type LeadCaptureText } from "../core/lead-capture-text.js";
 import { type Place } from "../core/place/types.js";
 import { type LeadFlows } from "../core/pricing/flow.js";
@@ -14,10 +15,11 @@ import { type FieldPart } from "./LeadCaptureFields.js";
 import { type LeadCaptureLayout, type LeadNeedDisplay, type LeadNeedOption } from "./LeadCaptureNeed.js";
 import { type PricePart } from "./LeadCapturePrice.js";
 import { type StepsPart } from "./LeadCaptureSteps.js";
+import type { MessengerPart } from "./messenger/types.js";
 import { type LeadIntro } from "./lead-steps.js";
 import type { PartClassNames } from "./parts.js";
 import { type LeadSent } from "./use-lead-submit.js";
-export type LeadCapturePart = "root" | "head" | "title" | "lede" | "form" | "contact" | "submit" | "trust" | "privacy" | "opening" | "others" | "done" | "needs" | "need" | "summary" | "icon" | "intro" | "introOption" | "stepNext" | FieldPart | ChannelPart | EstimatePart | PricePart | StepsPart | PricedPart | BookingPart;
+export type LeadCapturePart = "root" | "head" | "title" | "lede" | "form" | "contact" | "submit" | "trust" | "privacy" | "opening" | "others" | "done" | "needs" | "need" | "summary" | "icon" | "intro" | "introOption" | "stepNext" | FieldPart | ChannelPart | EstimatePart | PricePart | StepsPart | PricedPart | BookingPart | MessengerPart;
 export interface LeadCaptureProps {
     /** Its hours order the channels; its service area suggests the commune. */
     place: Place<string>;
@@ -117,6 +119,27 @@ export interface LeadCaptureProps {
     channelIcons?: Partial<Record<ChannelIconKey, ReactNode>> | undefined;
     /** Moved first when available — a `default_channel` experiment's arm. */
     prefer?: CaptureChannel | undefined;
+    /**
+     * The `lead_channel` experiment's arm: how the card offers WhatsApp and the
+     * brand's bot (`MessengerVariant`); absent → the control. A place without
+     * WhatsApp falls back to the control (`messengerShownOf`), and every event
+     * says which messengers were there (`channels_available`).
+     */
+    messenger?: MessengerVariant | undefined;
+    /** `messengerFacts(site, place)`: the place's own WhatsApp number and bot, each `null` when off. */
+    messengers?: MessengerFacts | undefined;
+    /** The brand's prefix of the lead's chat reference (`AQ` → `AQ-7K3F`, `message_ref`); without it no reference. */
+    refPrefix?: string | undefined;
+    /** The brand's name: the prefilled message's greeting («Bonjour Aquafix»). */
+    brand?: string | undefined;
+    /**
+     * The estimate's question whose answer is the message's timing line and
+     * in its preview (`{ input: "frequency" }` → «Délai souhaité : 2 sem.»);
+     * nothing until it is answered, nor for «I don't know».
+     */
+    messengerTiming?: {
+        input: string;
+    } | undefined;
     /** The site's assignment: on every event, and posted with the form. Slugs only. */
     experiment?: Experiment | undefined;
     timeZone?: string | undefined;