@evinvest/kitstart 0.9.0 → 0.11.0

package/dist/server/notify.d.ts

@@ -15,8 +15,19 @@ export interface LeadMail {
     text: string;
 }
 export type NotifyEnv = Pick<ServerEnv, "smtpUrl" | "notifyTo" | "notifyFrom" | "smsToken">;
+/**
+ * The need's label in the mail's language — the business's, whatever the
+ * visitor's — or `undefined` for one it does not know (a stale form's).
+ */
+export type NeedLabel = (need: string) => string | undefined;
+/** What a mail shows in place of the raw lead: the need as `needLabel` names it, else its id. */
+export interface LeadMailShown {
+    need: string;
+}
 /** A plain default; a brand passes `format` to write it in its own language. */
-export declare function defaultLeadMail(brand: Pick<BrandFacts, "name">, lead: Lead, id: number): LeadMail;
+export declare function defaultLeadMail(brand: Pick<BrandFacts, "name">, lead: Lead, id: number, options?: {
+    needLabel?: NeedLabel | undefined;
+}): LeadMail;
 /**
  * Checked when it is built — at boot, when a brand builds it there — not on
  * the first lead: with SMTP configured, a sender needs a domain to be `leads@`
@@ -29,7 +40,14 @@ export declare const MAIL_PER_MINUTE = 20;
 export declare function leadNotifier(site: {
     brand: BrandFacts;
 }, env: NotifyEnv, options?: {
-    format?: (lead: Lead, id: number) => LeadMail;
+    /** The brand's mail; `shown.need` is the need's label (`needLabel`), else its id. */
+    format?: (lead: Lead, id: number, shown: LeadMailShown) => LeadMail;
+    /**
+     * Names the need in the mail — `lead.subject` is the id the form posted
+     * (`hot_water`), which the business should not have to decode. The labels
+     * the brand hands `LeadCapture` as `needs`, in the mail's language.
+     */
+    needLabel?: NeedLabel;
     log?: Pick<Console, "warn">;
     /** `MAIL_PER_MINUTE` by default: a flood that passes the antispam must not become a mail flood. */
     mailPerMinute?: number;

package/dist/server/notify.js

@@ -1,8 +1,9 @@
 import "server-only";
 import { channelOf } from "../core/lead.js";
 import { parseSmtpUrl, sendMail } from "./smtp.js";
+const shownOf = (lead, needLabel) => ({ need: needLabel?.(lead.subject) ?? lead.subject });
 /** A plain default; a brand passes `format` to write it in its own language. */
-export function defaultLeadMail(brand, lead, id) {
+export function defaultLeadMail(brand, lead, id, options = {}) {
     const place = lead.placeSlug ?? "unknown";
     // A callback request is a promise to ring the customer: it says so first.
     const callback = channelOf(lead) === "callback";
@@ -11,7 +12,7 @@ export function defaultLeadMail(brand, lead, id) {
         text: [
             `Lead #${id} — place ${place}${callback ? " — CALL BACK" : ""}${lead.spamVerdict ? ` — suspect (${lead.spamVerdict})` : ""}`,
             "",
-            `Subject  : ${lead.subject}`,
+            `Subject  : ${shownOf(lead, options.needLabel).need}`,
             `Locality : ${lead.locality}`,
             `Mobile   : ${lead.mobile}`,
             ...Object.entries(lead.extras).map(([name, value]) => `${name} : ${value}`),
@@ -32,7 +33,8 @@ export function leadNotifier(site, env, options = {}) {
     const log = options.log ?? console;
     const now = options.now ?? Date.now;
     const cap = options.mailPerMinute ?? MAIL_PER_MINUTE;
-    const format = options.format ?? ((lead, id) => defaultLeadMail(brand, lead, id));
+    const { needLabel } = options;
+    const format = options.format ?? ((lead, id) => defaultLeadMail(brand, lead, id, { needLabel }));
     let window = { start: Number.NEGATIVE_INFINITY, sent: 0 };
     const spend = () => {
         const t = now();
@@ -59,7 +61,7 @@ export function leadNotifier(site, env, options = {}) {
                 log.warn(`lead ${id}: over ${cap} notification mails a minute; stored, not mailed`);
             }
             else if (mail) {
-                const { subject, text } = format(lead, id);
+                const { subject, text } = format(lead, id, shownOf(lead, needLabel));
                 channels.push(sendMail(mail.url, { from: mail.from, to: mail.to, subject, text }, { helo: mail.helo }));
             }
             if (env.smsToken) {

package/dist/server/place-source.js

@@ -29,7 +29,7 @@ export function createPlaceSource(site, options) {
         if (!response.ok)
             return { kind: "failed", status: response.status };
         try {
-            return { kind: "live", place: mergeLive(baked, parsePlaceLive(await response.json(), site.i18n.locales)) };
+            return { kind: "live", place: mergeLive(baked, parsePlaceLive(await response.json(), site.i18n.locales, site.booking ?? {})) };
         }
         catch (cause) {
             // A body that is not the source's shape is the source failing, not the place.

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/server/webhook-outbox.d.ts

@@ -67,6 +67,16 @@ export interface TickReport {
 export interface WebhookOutbox {
     /** Queues a body; synchronous and local, so it can sit before the response. */
     enqueue(body: string, ref?: string | null): number;
+    /**
+     * Queues a body unless a row with the same `ref` was ever queued, in one
+     * statement — two pods racing on one ref queue it once. Answers the new
+     * row, or `null` when the ref was there. With `after`, the row is not sent
+     * until the row of that ref is delivered, and a `409` or `425` for it is
+     * retried: the receiver has not seen what it depends on yet.
+     */
+    enqueueOnce?(body: string, ref: string, after?: string): number | null;
+    /** Whether a row with this `ref` was ever queued, whatever its state. */
+    hasRef?(ref: string): boolean;
     /** One pass over the rows that are due; concurrent calls share the running one. */
     tick(): Promise<TickReport>;
     /** Ticks every `intervalMs` until `stop`; a second call is a no-op. */
@@ -100,4 +110,4 @@ export declare function checkWebhookUrl(value: string, name?: string): string;
  * rows stay, are counted at open, and are not sent to a receiver that never
  * agreed to take them.
  */
-export declare function openWebhookOutbox(path: string, target: WebhookTarget, options?: WebhookOutboxOptions): WebhookOutbox;
+export declare function openWebhookOutbox(path: string, target: WebhookTarget, options?: WebhookOutboxOptions): WebhookOutbox & Required<Pick<WebhookOutbox, "enqueueOnce" | "hasRef">>;

package/dist/server/webhook-outbox.js

@@ -21,7 +21,17 @@ CREATE TABLE IF NOT EXISTS webhook_outbox (
   done_at         INTEGER
 );
 CREATE INDEX IF NOT EXISTS webhook_outbox_due ON webhook_outbox (state, target, next_attempt_at);
+CREATE INDEX IF NOT EXISTS webhook_outbox_ref ON webhook_outbox (ref);
 `;
+/**
+ * Added after the table shipped: a file from before gets it on open. A row's
+ * `after_ref` holds it until the row of that ref is delivered.
+ */
+function addAfterRef(db) {
+    const columns = db.prepare("PRAGMA table_info(webhook_outbox)").all();
+    if (!columns.some(c => column(c, "name") === "after_ref"))
+        db.exec("ALTER TABLE webhook_outbox ADD COLUMN after_ref TEXT");
+}
 /** How much of a receiver's answer a row keeps. */
 const ERROR_CAP = 500;
 const IN_CLUSTER = /(^|\.)svc(\.cluster\.local)?$/;
@@ -103,7 +113,7 @@ async function multiStatus(response, rowId, log) {
     const reasons = rejected.map(r => `#${String(column(r, "index"))}: ${String(column(r, "reason") ?? "rejected")}`);
     return { kind: "delivered", note: `rejected ${reasons.join("; ")}` };
 }
-async function judge(response, rowId, log) {
+async function judge(response, rowId, log, dependent) {
     const status = response.status;
     if (status === 207)
         return multiStatus(response, rowId, log);
@@ -116,6 +126,9 @@ async function judge(response, rowId, log) {
     const why = said ? `${tag}: ${said}` : tag;
     if (status === 408 || status === 429 || status >= 500)
         return { kind: "retry", tag, why, afterMs: retryAfter(response) };
+    // A row that follows another: the receiver may not have taken that one yet.
+    if (dependent && (status === 409 || status === 425))
+        return { kind: "retry", tag, why, afterMs: retryAfter(response) };
     // A rotated key (401, 403) or a receiver moved or not yet deployed (404):
     // fixed by a person, after which the lead must still arrive.
     if (status === 401 || status === 403)
@@ -150,13 +163,19 @@ export function openWebhookOutbox(path, target, options = {}) {
         db.exec("PRAGMA busy_timeout = 5000");
         db.exec("PRAGMA journal_mode = WAL");
         db.exec(SCHEMA);
+        addAfterRef(db);
     }
     catch (error) {
         db.close();
         throw error;
     }
     const insert = db.prepare("INSERT INTO webhook_outbox (target, ref, body, created_at, next_attempt_at) VALUES (?, ?, ?, ?, ?) RETURNING id");
-    const due = db.prepare("SELECT id, ref, body, attempts, created_at FROM webhook_outbox WHERE state = 'pending' AND target = ? AND next_attempt_at <= ? ORDER BY next_attempt_at, id LIMIT ?");
+    const insertOnce = db.prepare("INSERT INTO webhook_outbox (target, ref, body, created_at, next_attempt_at, after_ref) SELECT ?, ?, ?, ?, ?, ? WHERE NOT EXISTS (SELECT 1 FROM webhook_outbox WHERE ref = ?) RETURNING id");
+    const byRef = db.prepare("SELECT 1 FROM webhook_outbox WHERE ref = ? LIMIT 1");
+    // A row waits for the row it follows to be delivered; held, it is not due.
+    const due = db.prepare(`SELECT id, ref, body, attempts, created_at, after_ref FROM webhook_outbox AS o WHERE state = 'pending' AND target = ? AND next_attempt_at <= ?
+       AND (after_ref IS NULL OR EXISTS (SELECT 1 FROM webhook_outbox AS d WHERE d.ref = o.after_ref AND d.state = 'delivered'))
+     ORDER BY next_attempt_at, id LIMIT ?`);
     // A lease: another process ticking the same file skips a row while it is in flight.
     const claim = db.prepare("UPDATE webhook_outbox SET next_attempt_at = ? WHERE id = ? AND state = 'pending' AND next_attempt_at <= ?");
     const finish = db.prepare("UPDATE webhook_outbox SET state = ?, attempts = ?, last_error = ?, done_at = ? WHERE id = ?");
@@ -173,7 +192,7 @@ export function openWebhookOutbox(path, target, options = {}) {
         const plain = Math.min(maxDelay, baseDelay * 2 ** Math.max(0, attempts - 1));
         return Math.min(maxDelay, Math.max(plain + Math.floor(plain * 0.2 * random()), hinted ?? 0));
     }
-    async function deliver(id, body) {
+    async function deliver(id, body, dependent) {
         try {
             const response = await send(target.url, {
                 method: "POST",
@@ -182,7 +201,7 @@ export function openWebhookOutbox(path, target, options = {}) {
                 redirect: "manual",
                 signal: AbortSignal.timeout(timeoutMs),
             });
-            return await judge(response, id, log);
+            return await judge(response, id, log, dependent);
         }
         catch (error) {
             // The name and code only: a fetch error's message is safe, but its cause chain is the runtime's to word.
@@ -202,7 +221,7 @@ export function openWebhookOutbox(path, target, options = {}) {
             const queuedAt = int(row, "created_at");
             if (Number(claim.run(t + timeoutMs + 5_000, id, t).changes) === 0)
                 continue;
-            const verdict = await deliver(id, body);
+            const verdict = await deliver(id, body, text(row, "after_ref") !== null);
             if (verdict.kind === "delivered") {
                 finish.run("delivered", attempts, verdict.note?.slice(0, ERROR_CAP) ?? null, now(), id);
                 report.delivered += 1;
@@ -249,6 +268,14 @@ export function openWebhookOutbox(path, target, options = {}) {
             const t = now();
             return int(insert.get(target.url, ref, body, t, t), "id");
         },
+        enqueueOnce(body, ref, after) {
+            const t = now();
+            const row = insertOnce.get(target.url, ref, body, t, t, after ?? null, ref);
+            return row === undefined ? null : int(row, "id");
+        },
+        hasRef(ref) {
+            return byRef.get(ref) !== undefined;
+        },
         tick,
         start(intervalMs = WEBHOOK_TICK_MS) {
             if (timer)

package/dist/testing/lead-rules.js

@@ -16,7 +16,13 @@ export const PHONE_MATRIX = [
     { mobile: "01 23 45 67 89", valid: true },
     { mobile: "+1 415 555 0123", valid: true },
     { mobile: "+44 7911 123456", valid: true },
-    { mobile: "+12345678", valid: true },
+    { mobile: "+32 470 12 34 56", valid: true },
+    { mobile: "+41 44 668 18 00", valid: true },
+    { mobile: "+49 30 1234567", valid: true },
+    { mobile: "+34 612 345 678", valid: true },
+    { mobile: "+39 06 1234 5678", valid: true },
+    { mobile: "+44 20 7946 0958", valid: true },
+    { mobile: "+352 621 123 456", valid: true },
     { mobile: "０６１２３４５６７８", valid: true },
     { mobile: "(415) 555-0123", valid: false },
     { mobile: "+3361234567", valid: false },
@@ -25,6 +31,14 @@ export const PHONE_MATRIX = [
     { mobile: "06 12 34 56 7", valid: false },
     { mobile: "12 34 56 7", valid: false },
     { mobile: "+1234567", valid: false },
+    // A known plan's number short of its national length (LEAD-FORMS-RETEST-2026-10-03).
+    { mobile: "+12345678", valid: false },
+    { mobile: "+1 415 555 012", valid: false },
+    { mobile: "+44 7911 1234", valid: false },
+    { mobile: "+34 612 345 67", valid: false },
+    { mobile: "+41 44 668 18 0", valid: false },
+    { mobile: "+32 470 123", valid: false },
+    { mobile: "+49 30 1234", valid: false },
     { mobile: "06 12", valid: false },
 ];
 /**

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.11.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/booking/route.ts

@@ -0,0 +1,11 @@
+import { bookingRoute } from "@evinvest/kitstart/next";
+import { serverEnv } from "@/shared/config/env";
+
+/**
+ * A priced lead asking for a slot: `booking.requested@1` to the panel through
+ * the lead webhook's outbox, once its `panelBooking` is on. This template has
+ * no webhook, so the request is answered and dropped.
+ */
+export const dynamic = "force-dynamic";
+
+export const POST = bookingRoute({ env: serverEnv });

package/template/app/quote/confirm/route.ts

@@ -0,0 +1,12 @@
+import { confirmRoute } from "@evinvest/kitstart/next";
+import { TEXT } from "@/entities/content";
+import { pricing } from "@/shared/config/env";
+import { site } from "@/shared/config/site";
+
+/**
+ * A form posted without a script whose price changed lands here: a page that
+ * is never cached, with the fresh price to confirm.
+ */
+export const dynamic = "force-dynamic";
+
+export const GET = confirmRoute(site, { pricing, text: locale => TEXT[locale].leadCapture });

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.11.0";
     ev.inputs.v_flakes.follows = "v_flakes";
   };
 

package/template/package.json

@@ -20,9 +20,9 @@
   "dependencies": {
     "@evinvest/analytics": "^0.3.0",
     "@evinvest/i18n": "^0.9.0",
-    "@evinvest/kitstart": "^0.9.0",
+    "@evinvest/kitstart": "^0.11.0",
     "@evinvest/marketing": "^0.3.0",
-    "@evinvest/uikit": "^0.25.0",
+    "@evinvest/uikit": "^0.26.0",
     "next": "16.3.6",
     "react": "19.3.0",
     "react-dom": "19.3.0",

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/places.ts

@@ -16,5 +16,9 @@ export const PLACES: readonly Place<Locale>[] = [
     channels: { phone: null, whatsapp: null },
     hours: [{ days: ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday"], opens: "08:00", closes: "19:00" }],
     rating: null,
+    // How a priced lead's slot is set. Left out, the card promises a call
+    // (`manual`); the panel's place settings set it live (`PlaceLive.booking`),
+    // e.g. `{ default: "manual", providers: { google_calendar: { url: "https://calendar.app.google/…" } } }`,
+    // and the `booking_provider` experiment picks among them (`bookingOf`).
   },
 ];

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,10 @@ export const site = defineSite({
   places: PLACES,
   publication: SERVICE_AREA_GATE,
   lead: LEAD,
+  pricing: PRICING,
+  // The Cal.com hosts a place's `cal_com` booking may be on. A brand on its
+  // own Cal.com adds its domain: ["cal.com", "cal.brand.fr"].
+  booking: { calComHosts: ["cal.com"] },
 });
 
 export type PageKey = (typeof site.pageKeys)[number];
@@ -36,4 +41,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%