@evinvest/kitstart 0.9.0 → 0.10.0

package/dist/server/lead-webhook.d.ts

@@ -1,5 +1,6 @@
 import "server-only";
 import { type Lead, type LeadChannel, type LeadSuspect } from "../core/lead.js";
+import type { LeadFlow } from "../core/pricing/flow.js";
 import type { ServerEnv } from "./env.js";
 import { type TickReport, type WebhookOutbox, type WebhookOutboxOptions } from "./webhook-outbox.js";
 import type { WebhookSigning } from "./webhook-signature.js";
@@ -20,7 +21,44 @@ export interface LeadWebhookContext {
      * body must not carry the property at all.
      */
     suspect?: LeadSuspect;
+    /**
+     * The lead's public reference (`leadRef`, `lead-<row>-<8 hex>`): the one
+     * the page was answered with (`LeadSent.lead`), so a later step on the page
+     * can name the lead the panel knows. Absent only on a context built by hand.
+     */
+    leadRef?: string;
+    /**
+     * How the need was sold and at what price — only under `panelFlow`, and
+     * only on a lead with a flow; otherwise absent, and the body must not carry
+     * the properties. `panelFlowProperties` writes them as the panel reads them.
+     */
+    flow?: PanelFlow;
+}
+/** A lead's sale as the panel's `lead.created` may carry it. */
+export interface PanelFlow {
+    flow: LeadFlow;
+    /** With `estimate` and `fixed` only, always with `pricingValidFrom`. */
+    quotedCents?: number;
+    /** The price list's date, `YYYY-MM-DD`. */
+    pricingValidFrom?: string;
+    /** With `estimate` only, and only when it asked anything: input id → option id, slugs. */
+    estimateInputs?: Readonly<Record<string, string>>;
 }
+/** The sale `ctx.flow` describes, or nothing for a lead without a flow. */
+export declare function panelFlowOf(lead: Pick<Lead, "flow" | "price">): PanelFlow | undefined;
+/**
+ * `ctx.flow` as `lead.created`'s properties: `flow`, then `quoted_cents` and
+ * `pricing_valid_from` together (estimate and fixed), then `estimate_inputs`
+ * (estimate) — the panel's closed vocabulary. Spread into the body's
+ * `properties`; `{}` without a flow.
+ */
+export interface PanelFlowProperties {
+    flow: LeadFlow;
+    quoted_cents?: number;
+    pricing_valid_from?: string;
+    estimate_inputs?: Readonly<Record<string, string>>;
+}
+export declare function panelFlowProperties(flow: PanelFlow | undefined): PanelFlowProperties | Record<string, never>;
 /**
  * What the Service-Arb panel's `lead.created` calls a callback request. Its
  * `properties.channel` is a closed set (`form` | `phone_inbound`) and an event
@@ -42,6 +80,7 @@ export interface LeadWebhook {
     enqueue(lead: Lead, id: number, meta: {
         locale: string;
         formId: string;
+        leadRef?: string;
     }): number;
     tick(): Promise<TickReport>;
     start(intervalMs?: number): void;
@@ -51,6 +90,8 @@ export interface LeadWebhook {
     requeueDead(): number;
     /** Whether a suspect lead is queued, marked (`LeadWebhookOptions.panelSuspect`). */
     readonly panelSuspect: boolean;
+    /** Whether `ctx.flow` is filled in (`LeadWebhookOptions.panelFlow`). */
+    readonly panelFlow: boolean;
     readonly outbox: WebhookOutbox;
 }
 export interface LeadWebhookOptions extends WebhookOutboxOptions {
@@ -66,6 +107,13 @@ export interface LeadWebhookOptions extends WebhookOutboxOptions {
      * suspect, for the brand's body to carry.
      */
     panelSuspect?: boolean;
+    /**
+     * The switch for the sale's properties (`ctx.flow`: `flow`, `quoted_cents`,
+     * `pricing_valid_from`, `estimate_inputs`). Off (the default) until the
+     * panel's `lead.created` accepts them — it refuses an unknown property, and
+     * the outbox would park the lead. The leads table keeps them either way.
+     */
+    panelFlow?: boolean;
 }
 /**
  * The lead webhook, or `null` when it is off: no `LEAD_WEBHOOK_URL`, or no

package/dist/server/lead-webhook.js

@@ -2,6 +2,24 @@ import "server-only";
 import { randomUUID } from "node:crypto";
 import { suspectOf } from "../core/lead.js";
 import { openWebhookOutbox } from "./webhook-outbox.js";
+/** The sale `ctx.flow` describes, or nothing for a lead without a flow. */
+export function panelFlowOf(lead) {
+    if (!lead.flow)
+        return undefined;
+    if (lead.flow === "quote" || !lead.price)
+        return { flow: "quote" };
+    const inputs = lead.flow === "estimate" && lead.price.inputs && Object.keys(lead.price.inputs).length > 0 ? { estimateInputs: lead.price.inputs } : {};
+    return { flow: lead.flow, quotedCents: lead.price.cents, pricingValidFrom: lead.price.validFrom, ...inputs };
+}
+export function panelFlowProperties(flow) {
+    if (!flow)
+        return {};
+    return {
+        flow: flow.flow,
+        ...(flow.quotedCents !== undefined && flow.pricingValidFrom !== undefined ? { quoted_cents: flow.quotedCents, pricing_valid_from: flow.pricingValidFrom } : {}),
+        ...(flow.estimateInputs ? { estimate_inputs: flow.estimateInputs } : {}),
+    };
+}
 /**
  * What the Service-Arb panel's `lead.created` calls a callback request. Its
  * `properties.channel` is a closed set (`form` | `phone_inbound`) and an event
@@ -20,7 +38,7 @@ export function panelChannel(channel) {
  * so a broken setting fails startup rather than a lead.
  */
 export function leadWebhook(site, env, options) {
-    const { buildBody, signing, panelSuspect = false, ...outboxOptions } = options;
+    const { buildBody, signing, panelSuspect = false, panelFlow = false, ...outboxOptions } = options;
     if (!env.leadWebhook || !buildBody)
         return null;
     if (env.leadsDb.kind !== "sqlite")
@@ -30,9 +48,19 @@ export function leadWebhook(site, env, options) {
     return {
         outbox,
         panelSuspect,
+        panelFlow,
         enqueue(lead, id, meta) {
             const suspect = panelSuspect ? suspectOf(lead) : undefined;
-            const ctx = { leadId: id, brandId: site.brand.id, ...meta, at: new Date(now()), idempotencyKey: randomUUID(), ...(suspect ? { suspect } : {}) };
+            const flow = panelFlow ? panelFlowOf(lead) : undefined;
+            const ctx = {
+                leadId: id,
+                brandId: site.brand.id,
+                ...meta,
+                at: new Date(now()),
+                idempotencyKey: randomUUID(),
+                ...(suspect ? { suspect } : {}),
+                ...(flow ? { flow } : {}),
+            };
             const body = JSON.stringify(buildBody(lead, ctx));
             if (typeof body !== "string")
                 throw new Error("buildWebhookBody returned nothing JSON can carry");

package/dist/server/pricing-source.d.ts

@@ -0,0 +1,25 @@
+import "server-only";
+import type { PricingModel } from "../core/pricing/model.js";
+import type { Site } from "../core/site.js";
+/**
+ * The brand's live price list: `GET <base>/pricing`, the whole model with a
+ * label in every locale, over the baked one (`site.pricing`). The same
+ * failure semantics as the place source, for the same reason — a page that
+ * throws under ISR is a bare 500 with no phone: an unreachable source, a
+ * non-200, a body that is not JSON, and a model that does not validate all
+ * serve the baked model. Taken whole or not at all: a page never prices from
+ * half a model. `{}` is the source's "nothing set": the baked model, quietly.
+ */
+export interface PricingSourceOptions {
+    /** The source's base URL, read when asked; `null` → the baked model only. */
+    baseUrl: () => string | null;
+    /** TTL on the fetch itself (see `PlaceSourceOptions`); 600 s. */
+    revalidateSeconds?: number;
+    timeoutMs?: number;
+    log?: Pick<Console, "error">;
+}
+export interface PricingSource {
+    /** The model to price with now: live, else baked, else `null` (every need is a `quote`). Never throws. */
+    model(): Promise<PricingModel | null>;
+}
+export declare function createPricingSource<L extends string, P extends string>(site: Site<L, P>, options: PricingSourceOptions): PricingSource;

package/dist/server/pricing-source.js

@@ -0,0 +1,48 @@
+import "server-only";
+import { parsePricingModel, pricingProblemsFor } from "../core/pricing/validate.js";
+import { PLACE_REVALIDATE_SECONDS } from "./place-source.js";
+const TIMEOUT_MS = 3_000;
+const isEmptyObject = (v) => typeof v === "object" && v !== null && !Array.isArray(v) && Object.keys(v).length === 0;
+export function createPricingSource(site, options) {
+    const revalidate = options.revalidateSeconds ?? PLACE_REVALIDATE_SECONDS;
+    const timeoutMs = options.timeoutMs ?? TIMEOUT_MS;
+    const log = options.log ?? console;
+    const baked = site.pricing ?? null;
+    async function live(base) {
+        const init = { cache: "force-cache", next: { revalidate }, signal: AbortSignal.timeout(timeoutMs) };
+        let response;
+        try {
+            response = await fetch(`${base}/pricing`, init);
+        }
+        catch (cause) {
+            log.error("pricing: source unreachable, pricing from the baked model", cause);
+            return baked;
+        }
+        if (!response.ok) {
+            log.error(`pricing: source answered ${response.status}, pricing from the baked model`);
+            return baked;
+        }
+        let body;
+        try {
+            body = await response.json();
+        }
+        catch (cause) {
+            log.error("pricing: the source's body is not JSON, pricing from the baked model", cause);
+            return baked;
+        }
+        if (isEmptyObject(body))
+            return baked;
+        const problems = pricingProblemsFor(body, site.i18n.locales);
+        if (problems.length > 0) {
+            log.error(`pricing: the source's model is refused whole (${problems.slice(0, 5).join("; ")}), pricing from the baked model`);
+            return baked;
+        }
+        return parsePricingModel(body);
+    }
+    return {
+        async model() {
+            const base = options.baseUrl();
+            return base ? live(base) : baked;
+        },
+    };
+}

package/dist/testing/lead-store-contract.js

@@ -29,10 +29,13 @@ export function describeLeadStoreContract(name, harness) {
                 lead({ subject: "x".repeat(200), locality: "Clermont-Ferrand — 63000" }),
                 lead({ channel: "callback", subject: "", locality: "", consent: { text: "J’accepte d’être rappelé·e.", at: "2026-10-03T10:00:00.000Z" } }),
                 lead({ channel: "callback", consent: { text: "x".repeat(500), at: "2026-10-03T10:00:00.000Z" } }),
+                lead({ flow: "quote" }),
+                lead({ flow: "estimate", price: { cents: 8400, validFrom: "2026-10-01", inputs: { zone: "proche", frequency: "biweekly" } } }),
+                lead({ flow: "fixed", price: { cents: 0, validFrom: "2026-10-01" } }),
             ]) {
                 expect(await store.insert(variant)).toBeGreaterThan(0);
             }
-            expect(await store.count()).toBe(6);
+            expect(await store.count()).toBe(9);
             await store.close();
         });
         it("stands at the current schema version and reports itself healthy", async () => {
@@ -55,10 +58,14 @@ export function describeLeadStoreContract(name, harness) {
                 lead: lead({ submissionId: sid, channel: "callback", consent: { text: "Oui.", at: "2026-10-03T10:00:00.000Z" }, extras: { name: "Ana" } }),
             });
             expect(await store.findSubmission("00000000-0000-4000-8000-000000000000")).toBeNull();
+            // A priced lead reads back at the price it was taken at.
+            const priced = lead({ submissionId: "7c9e6679-7425-40de-944b-e07fc1f90ae7", flow: "estimate", price: { cents: 8400, validFrom: "2026-10-01", inputs: { zone: "proche" } } });
+            const pricedId = await store.insert(priced);
+            expect(await store.findSubmission("7c9e6679-7425-40de-944b-e07fc1f90ae7")).toEqual({ id: pricedId, lead: { ...priced, channel: "form" } });
             // Leads without one (the no-JS post) never collide.
             await store.insert(lead());
             await store.insert(lead());
-            expect(await store.count()).toBe(3);
+            expect(await store.count()).toBe(4);
             await store.close();
         });
         it("keeps what it acknowledged across a close and a reopen", async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evinvest/kitstart",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Landing-site machinery for local-service brands: a site composition root, the Place/Presence/ServiceArea model with a publication gate, host/locale routing, schema.org and SEO builders, the lead funnel with its antispam, and analytics events. Pure core at '.', more subpaths per runtime.",
   "license": "BlueOak-1.0.0",
   "publishConfig": {

package/template/app/[locale]/[location]/page.tsx

@@ -1,6 +1,7 @@
 import { placeMetadata } from "@evinvest/kitstart/next";
 import type { Metadata } from "next";
 import { loadPlace } from "@/views/place/server";
+import { pricing } from "@/shared/config/env";
 import { site } from "@/shared/config/site";
 import { PlaceHome } from "@/views/home";
 
@@ -13,6 +14,7 @@ export async function generateMetadata({ params }: Props): Promise<Metadata> {
 }
 
 export default async function PlaceHomePage({ params }: Props) {
-  const { view, copy, renderedAt } = await loadPlace(params);
-  return <PlaceHome view={view} copy={copy} renderedAt={renderedAt} />;
+  // The price list only where the form is: the other pages of a place need none.
+  const [{ view, copy, renderedAt }, model] = await Promise.all([loadPlace(params), pricing.model()]);
+  return <PlaceHome view={view} copy={copy} renderedAt={renderedAt} model={model} />;
 }

package/template/app/quote/route.ts

@@ -1,6 +1,6 @@
 import { quoteRoute } from "@evinvest/kitstart/next";
 import { TEXT } from "@/entities/content";
-import { notifier, serverEnv } from "@/shared/config/env";
+import { notifier, pricing, serverEnv } from "@/shared/config/env";
 import { site } from "@/shared/config/site";
 
 /** The no-JS path: a plain form POST answered with a 303. */
@@ -9,6 +9,7 @@ export const dynamic = "force-dynamic";
 export const POST = quoteRoute(site, {
   env: serverEnv,
   notifier,
+  pricing,
   unavailable: locale => {
     const t = TEXT[locale];
     const f = { place: site.brand.name, phone: site.brand.phone };

package/template/flake.nix

@@ -3,7 +3,7 @@
     v_flakes.url = "github:valeratrades/v_flakes?ref=v1.6";
     # The lib flake at the tag of the @evinvest/kitstart version in
     # package-lock.json — mkLanding refuses a mismatch.
-    ev.url = "github:EV-invest/lib?ref=@evinvest/kitstart-v0.9.0";
+    ev.url = "github:EV-invest/lib?ref=@evinvest/kitstart-v0.10.0";
     ev.inputs.v_flakes.follows = "v_flakes";
   };
 

package/template/package.json

@@ -20,7 +20,7 @@
   "dependencies": {
     "@evinvest/analytics": "^0.3.0",
     "@evinvest/i18n": "^0.9.0",
-    "@evinvest/kitstart": "^0.9.0",
+    "@evinvest/kitstart": "^0.10.0",
     "@evinvest/marketing": "^0.3.0",
     "@evinvest/uikit": "^0.25.0",
     "next": "16.3.6",

package/template/src/entities/content/model/en.ts

@@ -41,7 +41,7 @@ export const EN = {
   coverageTitle: "Where we work",
   brandPage: { title: "Brand", description: "Cleaning at a fixed price.", open: "Open" },
   contactLabel: "Contact us",
-  subjects: { standard: "Regular cleaning", deep: "Deep cleaning", other: "Other" },
+  subjects: { standard: "Regular cleaning", deep: "Deep cleaning", other: "Other", recurring: "Recurring cleaning" },
   leadCapture: { ...LEAD_CAPTURE_TEXT.en, needLabel: "Service" },
   faqs: [{ q: "Can the price change?", a: "No: the price quoted is the price you pay." }],
 } satisfies Text;

package/template/src/entities/content/model/fr.ts

@@ -41,7 +41,7 @@ export const FR = {
   coverageTitle: "Où nous intervenons",
   brandPage: { title: "Brand", description: "Le ménage à prix fixe.", open: "Ouvrir" },
   contactLabel: "Nous contacter",
-  subjects: { standard: "Ménage courant", deep: "Grand ménage", other: "Autre" },
+  subjects: { standard: "Ménage courant", deep: "Grand ménage", other: "Autre", recurring: "Ménage régulier" },
   leadCapture: { ...LEAD_CAPTURE_TEXT.fr, needLabel: "Prestation" },
   faqs: [{ q: "Le prix peut-il changer ?", a: "Non : le prix annoncé est celui que vous payez." }],
 } satisfies Text;

package/template/src/shared/config/env.ts

@@ -1,5 +1,5 @@
 import "server-only";
-import { createPlaceSource, createServerEnv, leadNotifier, type LeadNotifier } from "@evinvest/kitstart/server";
+import { createPlaceSource, createPricingSource, createServerEnv, leadNotifier, type LeadNotifier } from "@evinvest/kitstart/server";
 import { site } from "./site";
 
 /** Parsed once, lazily: `next build` imports this and must need no secrets. */
@@ -8,6 +8,9 @@ export const serverEnv = createServerEnv(site);
 /** The live place data, when `LOCATIONS_API_URL` is set; baked otherwise. */
 export const places = createPlaceSource(site, { baseUrl: () => serverEnv().locationsApiUrl });
 
+/** The live price list from the same source (`<LOCATIONS_API_URL>/pricing`); `site.pricing` otherwise. */
+export const pricing = createPricingSource(site, { baseUrl: () => serverEnv().locationsApiUrl });
+
 let built: LeadNotifier | undefined;
 
 /** Built at boot (`instrumentation.ts`), so SMTP with no sender fails startup. */

package/template/src/shared/config/lead.ts

@@ -1,8 +1,17 @@
-import { validateLead, type LeadSchema } from "@evinvest/kitstart";
+import { validateLead, type LeadFlows, type LeadSchema } from "@evinvest/kitstart";
 
-export const SUBJECTS = ["standard", "deep", "other"] as const;
+export const SUBJECTS = ["standard", "deep", "other", "recurring"] as const;
 export type Subject = (typeof SUBJECTS)[number];
 
+/**
+ * How each need is sold. `recurring` is priced live from a few answers
+ * (`pricing.ts`) and booked; the rest ask for a quote, and `deep` — priced
+ * from photos — offers to send them on WhatsApp once the place has a number.
+ * The form and the quote route read the same map.
+ */
+export const FLOWS = { recurring: "estimate", standard: "quote", deep: "quote", other: "quote" } as const satisfies LeadFlows;
+export const PHOTO_NEEDS: readonly Subject[] = ["deep"];
+
 /**
  * What the quote form asks, and the one rule worth enforcing: a lead with no
  * way to reach the customer is not a lead. `validateLead` is the number rule
@@ -17,4 +26,5 @@ export const LEAD: LeadSchema<Subject> = {
   // One shape for the mail, the webhook and a dialler: `+33612345678`.
   mobileFormat: "e164",
   validate: validateLead,
+  flows: FLOWS,
 };

package/template/src/shared/config/pricing.ts

@@ -0,0 +1,49 @@
+import type { PricingModel } from "@evinvest/kitstart";
+
+/**
+ * The baked price list: what `recurring` is priced from until the panel
+ * serves one (`GET <LOCATIONS_API_URL>/pricing`), and whenever it is down.
+ * OWNER_TODO: placeholder amounts — the owner sets the real ones in the panel.
+ */
+export const PRICING: PricingModel = {
+  format: 1,
+  currency: "EUR",
+  validFrom: "2026-10-01",
+  roundToCents: 100,
+  minimumCents: 4900,
+  inputs: [
+    {
+      id: "bedrooms",
+      kind: "add",
+      labels: { fr: "Chambres", en: "Bedrooms" },
+      options: [
+        { id: "studio", labels: { fr: "Studio", en: "Studio" }, addCents: 0 },
+        { id: "t2", labels: { fr: "1 chambre", en: "1 bedroom" }, addCents: 1500 },
+        { id: "t3", labels: { fr: "2 chambres", en: "2 bedrooms" }, addCents: 3000 },
+        { id: "t4", labels: { fr: "3 chambres et plus", en: "3 bedrooms or more" }, addCents: 4500 },
+      ],
+    },
+    {
+      id: "surface",
+      kind: "add",
+      labels: { fr: "Surface", en: "Floor area" },
+      options: [
+        { id: "s40", labels: { fr: "Moins de 40 m²", en: "Under 40 m²" }, addCents: 0 },
+        { id: "s70", labels: { fr: "40 à 70 m²", en: "40 to 70 m²" }, addCents: 1000 },
+        { id: "s70p", labels: { fr: "Plus de 70 m²", en: "Over 70 m²" }, addCents: 2500 },
+      ],
+    },
+    {
+      id: "frequency",
+      kind: "discount",
+      labels: { fr: "Fréquence", en: "How often" },
+      options: [
+        { id: "weekly", labels: { fr: "Chaque semaine", en: "Every week" }, discountBp: 1500 },
+        { id: "biweekly", labels: { fr: "Toutes les 2 semaines", en: "Every 2 weeks" }, discountBp: 1000 },
+        { id: "monthly", labels: { fr: "Chaque mois", en: "Every month" }, discountBp: 500 },
+        { id: "once", labels: { fr: "Une fois", en: "Once" }, discountBp: 0 },
+      ],
+    },
+  ],
+  needs: { recurring: { kind: "estimate", baseCents: 4500, inputs: ["bedrooms", "surface", "frequency"] } },
+};

package/template/src/shared/config/site.ts

@@ -2,6 +2,7 @@ import { cardFact, defineSite, SERVICE_AREA_GATE, type OwnerTodo } from "@evinve
 import { i18n } from "./i18n";
 import { LEAD } from "./lead";
 import { PLACES } from "./places";
+import { PRICING } from "./pricing";
 
 /**
  * The brand as the machinery sees it — routing, the lead funnel, schema.org,
@@ -29,6 +30,7 @@ export const site = defineSite({
   places: PLACES,
   publication: SERVICE_AREA_GATE,
   lead: LEAD,
+  pricing: PRICING,
 });
 
 export type PageKey = (typeof site.pageKeys)[number];
@@ -36,4 +38,5 @@ export type PageKey = (typeof site.pageKeys)[number];
 export const OWNER_TODO: readonly OwnerTodo[] = [
   { field: "site.brand.legalName", why: "raison sociale as registered", blocksLaunch: true },
   { field: "assets/card.toml phone", why: "the public number", blocksLaunch: false },
+  { field: "shared/config/pricing.ts", why: "placeholder prices until the panel serves the real ones", blocksLaunch: false },
 ];

package/template/src/views/home/ui/PlaceHome.tsx

@@ -1,8 +1,8 @@
-import { contactOf, placeGraph, type PlaceView } from "@evinvest/kitstart";
+import { contactOf, placeGraph, type PlaceView, type PricingModel } from "@evinvest/kitstart";
 import { CallBar, Coverage, Display, Faq, JsonLd, LeadCapture, Section } from "@evinvest/kitstart/react";
 import type { Copy } from "@/entities/content";
 import type { Locale } from "@/shared/config/i18n";
-import { LEAD } from "@/shared/config/lead";
+import { LEAD, PHOTO_NEEDS } from "@/shared/config/lead";
 import { site } from "@/shared/config/site";
 
 /**
@@ -12,7 +12,7 @@ import { site } from "@/shared/config/site";
  * `site.lead.wire` — restyle it through `classNames`, drive `layout` and
  * `prefer` from an experiment.
  */
-export function PlaceHome({ view, copy, renderedAt }: { view: PlaceView<Locale>; copy: Copy; renderedAt: number }) {
+export function PlaceHome({ view, copy, renderedAt, model }: { view: PlaceView<Locale>; copy: Copy; renderedAt: number; model: PricingModel | null }) {
   const { t, f } = copy;
   const contact = contactOf(site, view.place);
   const graph = placeGraph(site, view, "home", { placeName: f.place, title: t.pages.home.title(f), description: t.pages.home.description(f) }, new Date(renderedAt));
@@ -32,6 +32,9 @@ export function PlaceHome({ view, copy, renderedAt }: { view: PlaceView<Locale>;
             renderedAt={renderedAt}
             wire={LEAD.wire}
             needs={LEAD.subjects.map(s => ({ value: s, label: t.subjects[s] }))}
+            flows={LEAD.flows}
+            pricing={model}
+            photos={PHOTO_NEEDS}
             text={t.leadCapture}
             className="max-w-md"
           />

package/template/tests/bundle_budget.txt

@@ -8,6 +8,8 @@
 # first measurement plus a few percent; change it only in a commit that says why.
 #
 # Over it now, on purpose: the form became `LeadCapture`, a client island
-# (162,985 B gz, +3.2 %) — a warning to pay back, not a new target.
+# (162,985 B gz, +3.2 %) — a warning to pay back, not a new target. The form
+# variants (an estimate's tiles and live price, the priced success) add
+# about 3.9 KB gz more (170,375 B gz, +7.8 %).
 158000
 tolerance 20%

package/template/tests/e2e/flows.spec.ts

@@ -0,0 +1,106 @@
+import { expect, test, type Page } from "@playwright/test";
+
+// The form variants: `recurring` is an estimate, priced live from the baked
+// model (the mock panel's price list is down) and stored at the server's own
+// price; the slot is then set by a call — no booking provider yet.
+
+const hydrated = (page: Page) => expect(page.locator("#quote select")).toHaveCount(0);
+
+async function pickRecurring(page: Page, locale: "fr" | "en") {
+  await page.goto(`/${locale}`);
+  await hydrated(page);
+  await page.getByRole("combobox", { name: locale === "fr" ? "Prestation" : "Service" }).click();
+  await page.getByRole("listbox").getByRole("option", { name: locale === "fr" ? "Ménage régulier" : "Recurring cleaning" }).click();
+}
+
+const form = (page: Page) => page.locator("#quote-form");
+const answer = (page: Page, label: string) => form(page).getByRole("radio", { name: label, exact: true }).check();
+const price = (page: Page) => form(page).locator("[data-price-cents]");
+
+async function contact(page: Page, locale: "fr" | "en") {
+  await form(page).getByLabel(locale === "fr" ? "Code postal" : "Postcode").fill("75011");
+  await form(page).getByLabel(locale === "fr" ? "Téléphone" : "Phone").fill("0612345678");
+}
+
+const quote = (page: Page) => page.waitForResponse(r => r.request().method() === "POST" && new URL(r.url()).pathname === "/quote");
+
+test("an estimate prices the answers live, from the baked model while the panel's is down", async ({ page }) => {
+  await pickRecurring(page, "fr");
+  await expect(form(page).getByText("Répondez aux questions pour voir le prix.")).toBeVisible();
+  await expect(price(page)).toHaveCount(0);
+  await answer(page, "2 chambres");
+  await answer(page, "40 à 70 m²");
+  await answer(page, "Toutes les 2 semaines");
+  // 45 € + 30 € + 10 € = 85 €, less 10 % = 76,50 €, to the euro: 77 €.
+  await expect(price(page)).toHaveAttribute("data-price-cents", "7700");
+  await answer(page, "Une fois");
+  await expect(price(page)).toHaveAttribute("data-price-cents", "8500");
+  await expect(form(page).getByRole("button", { name: "Réserver" })).toBeVisible();
+});
+
+test("the server prices the posted answers itself: a posted amount is ignored", async ({ page }) => {
+  await pickRecurring(page, "fr");
+  await answer(page, "2 chambres");
+  await answer(page, "40 à 70 m²");
+  await answer(page, "Toutes les 2 semaines");
+  await expect(price(page)).toHaveAttribute("data-price-cents", "7700");
+  await contact(page, "fr");
+  // A tampered page: a price of its own, and an answer the screen did not price.
+  await form(page).evaluate(el => {
+    for (const name of ["quoted_cents", "cents", "price"]) {
+      const input = document.createElement("input");
+      input.type = "hidden";
+      input.name = name;
+      input.value = "1";
+      el.append(input);
+    }
+    const t3 = el.querySelector<HTMLInputElement>("input[name=estimate_bedrooms][value=t3]");
+    if (t3) t3.value = "t4";
+  });
+  const answered = quote(page);
+  await form(page).getByRole("button", { name: "Réserver" }).click();
+  // 45 € + 45 € + 10 € = 100 €, less 10 % = 90 €.
+  expect(await (await answered).json()).toMatchObject({ ok: true, cents: 9000 });
+  await expect(page.getByRole("status")).toContainText(/Demande enregistrée au prix de 90\s€\./);
+});
+
+test("a priced lead confirms the server's price and promises a call to set the slot, with no third party", async ({ page }) => {
+  const outside: string[] = [];
+  page.on("request", r => void (new URL(r.url()).hostname !== "localhost" && outside.push(r.url())));
+  await pickRecurring(page, "fr");
+  await answer(page, "Studio");
+  await answer(page, "Moins de 40 m²");
+  await answer(page, "Une fois");
+  await contact(page, "fr");
+  const answered = quote(page);
+  await form(page).getByRole("button", { name: "Réserver" }).click();
+  expect(await (await answered).json()).toMatchObject({ ok: true, cents: 4900, lead: expect.stringMatching(/^lead-\d+-[0-9a-f]{8}$/) });
+  const status = page.getByRole("status");
+  // 45 €, under the 49 € minimum.
+  await expect(status).toContainText(/Demande enregistrée au prix de 49\s€\./);
+  await expect(status).toContainText("Nous vous rappelons pour fixer le créneau.");
+  await expect(status).toBeFocused();
+  await expect(page.locator("iframe")).toHaveCount(0);
+  expect(outside).toEqual([]);
+});
+
+test("in English too", async ({ page }) => {
+  await pickRecurring(page, "en");
+  await answer(page, "1 bedroom");
+  await answer(page, "Over 70 m²");
+  await answer(page, "Every week");
+  // 45 € + 15 € + 25 € = 85 €, less 15 % = 72,25 €, to the euro: 72 €.
+  await expect(price(page)).toHaveAttribute("data-price-cents", "7200");
+  await contact(page, "en");
+  await form(page).getByRole("button", { name: "Book" }).click();
+  const status = page.getByRole("status");
+  await expect(status).toContainText("Request saved at €72.");
+  await expect(status).toContainText("We will call you to set the slot.");
+});
+
+test("a quote need is the form it always was", async ({ page }) => {
+  await page.goto("/fr");
+  await hydrated(page);
+  await expect(form(page).locator("input[name^=estimate_]")).toHaveCount(0);
+  await expect(form(page).getByRole("button", { name: "Recevoir le prix" })).toBeVisible();
+});

package/template/tests/e2e/mock-panel.mjs

@@ -0,0 +1,20 @@
+// The panel's internal endpoints as the e2e suite needs them, on
+// `E2E_MOCK_PORT`: the place's live half (nothing over the baked place), and
+// a price list that is down — so the page prices from the baked model.
+import { createServer } from "node:http";
+
+const port = Number(process.env["E2E_MOCK_PORT"]);
+const json = (res, status, body) => {
+  res.writeHead(status, { "content-type": "application/json" });
+  res.end(JSON.stringify(body));
+};
+
+createServer((req, res) => {
+  const url = new URL(req.url ?? "/", "http://mock");
+  if (url.pathname === "/health") return json(res, 200, { ok: true });
+  if (url.pathname === "/pricing") return json(res, 503, { error: "down" });
+  if (url.pathname === "/locations/paris") {
+    return json(res, 200, {});
+  }
+  return json(res, 404, { error: "no such route" });
+}).listen(port, "127.0.0.1");