@evinvest/sites-contract 0.1.3 → 0.1.5

package/README.md

@@ -3,20 +3,22 @@
 The Service-Arb sites ↔ panel contract, in TS: what a landing reads from the panel and sends
 to it. Its source is the panel — `crates/panel_core` and `contracts/proto/sa/v1` in
 [EV-Service-Arb/sites_panel](https://github.com/EV-Service-Arb/sites_panel) — and this is its
-only TS form. No runtime dependencies, no Node imports: it is bundled into landing pages and
+only TS form. Its one dependency is `@evinvest/experiments` (zero-dep), no Node imports: it is bundled into landing pages and
 the panel's front end.
 
 ```text
-src/generated/contract.ts  panel_core's shapes, vocabularies and limits (`nix run .#gen`)
+src/generated/*.ts         panel_core's shapes, vocabularies and limits (`nix run .#gen`), a
+                           module per constant
 src/generated/wire.ts      the protos as protojson: the envelope, every type's properties
 src/*.ts                   the one TS implementation of what both sides run, held to
                            contracts/vectors with panel_core:
   price      priceOf: what a page runs        pricing         checkPricingModel
   booking    bookingRequested, isLeadRef      booking-config  checkBookingConfig, checkBookingUrl
   place      checkPlaceLive: a place's live settings, field by field
-  phone      normalizePhone, phoneProblem
+  phone      normalizePhone, phoneProblem     message-ref     messageRefOf: a ref as typed
   ingest     siteEvent, ingestBody, uuidV7, isOpaqueId: the only way a site builds an event
-  experiments parseLiveExperiments, declarationProblem
+  experiments parseLiveExperiments, declarationProblem; validWeights, validHoldout are
+             @evinvest/experiments' (what applyOverrides takes), re-exported
 ```
 
 A page bundles what it runs and not the panel's checks: they sit in modules of their own.

package/dist/booking-config.d.ts

@@ -1,4 +1,4 @@
-import type { BookingCode } from "./generated/codes.js";
+import type { BookingCode } from "./generated/booking-codes.js";
 import type { BookingConfig, PageProvider } from "./generated/types.js";
 /** One thing wrong with a place's `booking`: where below it (`""`, `default`, `providers.cal_com.url`) and why. */
 export interface BookingProblem {

package/dist/booking-config.js

@@ -1,5 +1,5 @@
 import { isBookingProvider, isPageProvider } from "./booking.js";
-import { BOOKING_LIMITS as LIMIT } from "./generated/booking.js";
+import { BOOKING_LIMITS as LIMIT } from "./generated/booking-limits.js";
 import { at, isObject } from "./text.js";
 const CAL_SEGMENT = /* @__PURE__ */ new RegExp(LIMIT.calComSegment);
 const LABEL = /^[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?$/;

package/dist/booking.d.ts

@@ -1,4 +1,4 @@
-import { type DayPart } from "./generated/booking.js";
+import { type DayPart } from "./generated/day-parts.js";
 import type { BookingProvider, PageProvider } from "./generated/types.js";
 import type { BookingRequestedV1 } from "./generated/wire.js";
 export declare const isBookingProvider: (v: unknown) => v is BookingProvider;

package/dist/booking.js

@@ -1,4 +1,7 @@
-import { BOOKING_LIMITS as LIMIT, BOOKING_PROVIDERS, DAY_PARTS, PAGE_PROVIDERS } from "./generated/booking.js";
+import { BOOKING_LIMITS as LIMIT } from "./generated/booking-limits.js";
+import { BOOKING_PROVIDERS } from "./generated/booking-providers.js";
+import { DAY_PARTS } from "./generated/day-parts.js";
+import { PAGE_PROVIDERS } from "./generated/page-providers.js";
 import { isDate, isObject } from "./text.js";
 export const isBookingProvider = (v) => BOOKING_PROVIDERS.some(p => p === v);
 export const isPageProvider = (v) => PAGE_PROVIDERS.some(p => p === v);

package/dist/experiments.js

@@ -1,4 +1,5 @@
-import { EXPERIMENT_LIMITS } from "./generated/experiments.js";
+import { validHoldout, validWeights } from "@evinvest/experiments";
+import { EXPERIMENT_LIMITS } from "./generated/experiment-limits.js";
 import { charCount, isObject, trim } from "./text.js";
 /**
  * The panel's answer to `GET …/brands/{brand}/experiments`, or `null` when it is not one: an
@@ -45,10 +46,9 @@ export function declarationProblem(d) {
         return "variant";
     if (new Set(d.variants).size !== d.variants.length)
         return "duplicate_variant";
-    const weightsOk = d.weights.length === d.variants.length && d.weights.every(w => Number.isFinite(w) && w >= 0) && d.weights.reduce((a, b) => a + b, 0) > 0;
-    if (!weightsOk)
+    if (validWeights(d.weights, d.variants.length) === undefined)
         return "weights";
-    if (d.holdout !== undefined && !(Number.isFinite(d.holdout) && d.holdout >= 0 && d.holdout < 1))
+    if (d.holdout !== undefined && validHoldout(d.holdout) === undefined)
         return "holdout";
     if (d.summary !== undefined && charCount(trim(d.summary)) > EXPERIMENT_LIMITS.maxSummary)
         return "summary";

package/dist/generated/booking-codes.d.ts

@@ -0,0 +1,2 @@
+export declare const BOOKING_CODES: readonly ["shape", "unknown_key", "required", "provider_unknown", "provider_shape", "provider_extra", "manual", "url_type", "default_unknown", "default_unset", "format", "scheme", "fragment", "backslash", "userinfo", "ip", "port", "host", "google", "cal_host", "cal_path"];
+export type BookingCode = (typeof BOOKING_CODES)[number];

package/dist/generated/booking-codes.js

@@ -0,0 +1,2 @@
+// AUTO-GENERATED by `nix run .#gen` — do not edit.
+export const BOOKING_CODES = ["shape", "unknown_key", "required", "provider_unknown", "provider_shape", "provider_extra", "manual", "url_type", "default_unknown", "default_unset", "format", "scheme", "fragment", "backslash", "userinfo", "ip", "port", "host", "google", "cal_host", "cal_path"];

package/dist/generated/booking-limits.d.ts

@@ -0,0 +1,6 @@
+export declare const BOOKING_LIMITS: {
+    readonly calComHosts: readonly ["cal.evinvest.ltd", "cal.com"];
+    readonly calComSegment: "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$";
+    readonly leadRef: "^lead-[1-9][0-9]{0,18}-[0-9a-f]{8}$";
+    readonly maxUrl: 2048;
+};

package/dist/generated/booking-limits.js

@@ -0,0 +1,7 @@
+// AUTO-GENERATED by `nix run .#gen` — do not edit.
+export const BOOKING_LIMITS = {
+    "calComHosts": ["cal.evinvest.ltd", "cal.com"],
+    "calComSegment": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$",
+    "leadRef": "^lead-[1-9][0-9]{0,18}-[0-9a-f]{8}$",
+    "maxUrl": 2048,
+};

package/dist/generated/booking-providers.d.ts

@@ -0,0 +1 @@
+export declare const BOOKING_PROVIDERS: readonly ["manual", "link", "google_calendar", "cal_com"];

package/dist/generated/booking-providers.js

@@ -0,0 +1,2 @@
+// AUTO-GENERATED by `nix run .#gen` — do not edit.
+export const BOOKING_PROVIDERS = ["manual", "link", "google_calendar", "cal_com"];

package/dist/generated/booking-statuses.d.ts

@@ -0,0 +1,2 @@
+export declare const BOOKING_STATUSES: readonly ["none", "requested", "booked", "canceled", "done", "no_show"];
+export type BookingStatus = (typeof BOOKING_STATUSES)[number];

package/dist/generated/booking-statuses.js

@@ -0,0 +1,2 @@
+// AUTO-GENERATED by `nix run .#gen` — do not edit.
+export const BOOKING_STATUSES = ["none", "requested", "booked", "canceled", "done", "no_show"];

package/dist/generated/day-parts.d.ts

@@ -0,0 +1,2 @@
+export declare const DAY_PARTS: readonly ["morning", "afternoon", "evening"];
+export type DayPart = (typeof DAY_PARTS)[number];

package/dist/generated/day-parts.js

@@ -0,0 +1,2 @@
+// AUTO-GENERATED by `nix run .#gen` — do not edit.
+export const DAY_PARTS = ["morning", "afternoon", "evening"];

package/dist/generated/days.d.ts

@@ -0,0 +1 @@
+export declare const DAYS: readonly ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday"];

package/dist/generated/days.js

@@ -0,0 +1,2 @@
+// AUTO-GENERATED by `nix run .#gen` — do not edit.
+export const DAYS = ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday"];

package/dist/generated/index.d.ts

@@ -0,0 +1,24 @@
+export * from "./booking-codes.js";
+export * from "./booking-limits.js";
+export * from "./booking-providers.js";
+export * from "./booking-statuses.js";
+export * from "./day-parts.js";
+export * from "./days.js";
+export * from "./experiment-limits.js";
+export * from "./input-kinds.js";
+export * from "./lead-channels.js";
+export * from "./lead-flows.js";
+export * from "./lead-limits.js";
+export * from "./lead-suspects.js";
+export * from "./messengers.js";
+export * from "./page-providers.js";
+export * from "./place-codes.js";
+export * from "./place-fields.js";
+export * from "./place-limits.js";
+export * from "./pricing-codes.js";
+export * from "./pricing-currency.js";
+export * from "./pricing-format.js";
+export * from "./pricing-limits.js";
+export * from "./site-channels.js";
+export * from "./types.js";
+export * from "./wire.js";

package/dist/generated/index.js

@@ -0,0 +1,25 @@
+// AUTO-GENERATED by `nix run .#gen` — do not edit.
+export * from "./booking-codes.js";
+export * from "./booking-limits.js";
+export * from "./booking-providers.js";
+export * from "./booking-statuses.js";
+export * from "./day-parts.js";
+export * from "./days.js";
+export * from "./experiment-limits.js";
+export * from "./input-kinds.js";
+export * from "./lead-channels.js";
+export * from "./lead-flows.js";
+export * from "./lead-limits.js";
+export * from "./lead-suspects.js";
+export * from "./messengers.js";
+export * from "./page-providers.js";
+export * from "./place-codes.js";
+export * from "./place-fields.js";
+export * from "./place-limits.js";
+export * from "./pricing-codes.js";
+export * from "./pricing-currency.js";
+export * from "./pricing-format.js";
+export * from "./pricing-limits.js";
+export * from "./site-channels.js";
+export * from "./types.js";
+export * from "./wire.js";

package/dist/generated/input-kinds.d.ts

@@ -0,0 +1,2 @@
+export declare const INPUT_KINDS: readonly ["add", "multiply", "discount"];
+export type PricingInputKind = (typeof INPUT_KINDS)[number];

package/dist/generated/input-kinds.js

@@ -0,0 +1,2 @@
+// AUTO-GENERATED by `nix run .#gen` — do not edit.
+export const INPUT_KINDS = ["add", "multiply", "discount"];

package/dist/generated/lead-channels.d.ts

@@ -0,0 +1,2 @@
+export declare const LEAD_CHANNELS: readonly ["form", "phone_inbound", "callback", "whatsapp", "telegram"];
+export type LeadChannel = (typeof LEAD_CHANNELS)[number];

package/dist/generated/lead-channels.js

@@ -0,0 +1,2 @@
+// AUTO-GENERATED by `nix run .#gen` — do not edit.
+export const LEAD_CHANNELS = ["form", "phone_inbound", "callback", "whatsapp", "telegram"];

package/dist/generated/lead-flows.d.ts

@@ -0,0 +1,2 @@
+export declare const LEAD_FLOWS: readonly ["quote", "estimate", "fixed"];
+export type LeadFlow = (typeof LEAD_FLOWS)[number];

package/dist/generated/lead-flows.js

@@ -0,0 +1,2 @@
+// AUTO-GENERATED by `nix run .#gen` — do not edit.
+export const LEAD_FLOWS = ["quote", "estimate", "fixed"];

package/dist/generated/lead-limits.d.ts

@@ -0,0 +1,5 @@
+export declare const LEAD_LIMITS: {
+    readonly analyticsId: "^[A-Za-z0-9._:-]{1,128}$";
+    readonly maxEstimateInputs: 12;
+    readonly messageRef: "^[A-Z]{2,4}-[0-9A-HJKMNP-TV-Z]{4,8}$";
+};

package/dist/generated/lead-limits.js

@@ -0,0 +1,6 @@
+// AUTO-GENERATED by `nix run .#gen` — do not edit.
+export const LEAD_LIMITS = {
+    "analyticsId": "^[A-Za-z0-9._:-]{1,128}$",
+    "maxEstimateInputs": 12,
+    "messageRef": "^[A-Z]{2,4}-[0-9A-HJKMNP-TV-Z]{4,8}$",
+};

package/dist/generated/lead-suspects.d.ts

@@ -0,0 +1,2 @@
+export declare const LEAD_SUSPECTS: readonly ["rate_limited", "too_fast"];
+export type LeadSuspect = (typeof LEAD_SUSPECTS)[number];

package/dist/generated/lead-suspects.js

@@ -0,0 +1,2 @@
+// AUTO-GENERATED by `nix run .#gen` — do not edit.
+export const LEAD_SUSPECTS = ["rate_limited", "too_fast"];

package/dist/generated/messengers.d.ts

@@ -0,0 +1 @@
+export declare const MESSENGERS: readonly ["whatsapp", "telegram"];

package/dist/generated/messengers.js

@@ -0,0 +1,2 @@
+// AUTO-GENERATED by `nix run .#gen` — do not edit.
+export const MESSENGERS = ["whatsapp", "telegram"];

package/dist/generated/page-providers.d.ts

@@ -0,0 +1 @@
+export declare const PAGE_PROVIDERS: readonly ["link", "google_calendar", "cal_com"];

package/dist/generated/page-providers.js

@@ -0,0 +1,2 @@
+// AUTO-GENERATED by `nix run .#gen` — do not edit.
+export const PAGE_PROVIDERS = ["link", "google_calendar", "cal_com"];

package/dist/generated/place-codes.d.ts

@@ -0,0 +1,2 @@
+export declare const PLACE_CODES: readonly ["object", "unknown_field", "required", "type", "blank", "too_long", "control", "e164", "telegram_bot", "messenger_unknown", "boolean", "shape", "empty", "too_many", "day", "duplicate", "time", "closes_before_opens", "postal_code", "coordinate", "https_url", "review_url", "locale", "rating_value", "rating_count", "instant"];
+export type PlaceCode = (typeof PLACE_CODES)[number];

package/dist/generated/place-codes.js

@@ -0,0 +1,2 @@
+// AUTO-GENERATED by `nix run .#gen` — do not edit.
+export const PLACE_CODES = ["object", "unknown_field", "required", "type", "blank", "too_long", "control", "e164", "telegram_bot", "messenger_unknown", "boolean", "shape", "empty", "too_many", "day", "duplicate", "time", "closes_before_opens", "postal_code", "coordinate", "https_url", "review_url", "locale", "rating_value", "rating_count", "instant"];

package/dist/generated/place-fields.d.ts

@@ -0,0 +1,2 @@
+export declare const PLACE_FIELDS: readonly ["phone", "whatsapp", "telegram", "messengers", "hours", "serviceArea", "address", "geo", "storefrontPhoto", "landmark", "rating", "booking", "reviewUrl"];
+export type PlaceField = (typeof PLACE_FIELDS)[number];

package/dist/generated/place-fields.js

@@ -0,0 +1,2 @@
+// AUTO-GENERATED by `nix run .#gen` — do not edit.
+export const PLACE_FIELDS = ["phone", "whatsapp", "telegram", "messengers", "hours", "serviceArea", "address", "geo", "storefrontPhoto", "landmark", "rating", "booking", "reviewUrl"];

package/dist/generated/place-limits.d.ts

@@ -0,0 +1,11 @@
+export declare const PLACE_LIMITS: {
+    readonly e164: "^\\+[1-9][0-9]{6,14}$";
+    readonly maxArea: 200;
+    readonly maxHours: 14;
+    readonly maxLocales: 8;
+    readonly maxText: 200;
+    readonly maxUrl: 2048;
+    readonly reviewHosts: readonly ["g.page", "search.google.com"];
+    readonly telegramBot: "^[A-Za-z][A-Za-z0-9_]{1,28}[Bb][Oo][Tt]$";
+    readonly time: "^([01][0-9]|2[0-3]):[0-5][0-9]$";
+};

package/dist/generated/{place.js → place-limits.js}

@@ -1,7 +1,4 @@
 // AUTO-GENERATED by `nix run .#gen` — do not edit.
-export const DAYS = ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday"];
-export const MESSENGERS = ["whatsapp", "telegram"];
-export const PLACE_FIELDS = ["phone", "whatsapp", "telegram", "messengers", "hours", "serviceArea", "address", "geo", "storefrontPhoto", "landmark", "rating", "booking", "reviewUrl"];
 export const PLACE_LIMITS = {
     "e164": "^\\+[1-9][0-9]{6,14}$",
     "maxArea": 200,

package/dist/generated/pricing-codes.d.ts

@@ -0,0 +1,2 @@
+export declare const PRICING_CODES: readonly ["object", "missing", "unknownField", "format", "currency", "date", "int", "slug", "labels", "locale", "label", "list", "duplicate", "kind", "needKind", "noInput", "dearest", "labelMissing"];
+export type PricingCode = (typeof PRICING_CODES)[number];

package/dist/generated/pricing-codes.js

@@ -0,0 +1,2 @@
+// AUTO-GENERATED by `nix run .#gen` — do not edit.
+export const PRICING_CODES = ["object", "missing", "unknownField", "format", "currency", "date", "int", "slug", "labels", "locale", "label", "list", "duplicate", "kind", "needKind", "noInput", "dearest", "labelMissing"];

package/dist/generated/pricing-currency.d.ts

@@ -0,0 +1 @@
+export declare const PRICING_CURRENCY = "EUR";

package/dist/generated/pricing-currency.js

@@ -0,0 +1,2 @@
+// AUTO-GENERATED by `nix run .#gen` — do not edit.
+export const PRICING_CURRENCY = "EUR";

package/dist/generated/pricing-format.d.ts

@@ -0,0 +1 @@
+export declare const PRICING_FORMAT = 1;

package/dist/generated/pricing-format.js

@@ -0,0 +1,2 @@
+// AUTO-GENERATED by `nix run .#gen` — do not edit.
+export const PRICING_FORMAT = 1;

package/dist/generated/{pricing.d.ts → pricing-limits.d.ts}

@@ -1,5 +1,3 @@
-export declare const PRICING_FORMAT = 1;
-export declare const PRICING_CURRENCY = "EUR";
 export declare const PRICING_LIMITS: {
     readonly locale: "^[a-z]{2}(-[A-Z]{2})?$";
     readonly maxDiscountBp: 10000;
@@ -12,5 +10,3 @@ export declare const PRICING_LIMITS: {
     readonly maxPriceCents: 100000000;
     readonly slug: "^[a-z0-9_-]{1,40}$";
 };
-export declare const INPUT_KINDS: readonly ["add", "multiply", "discount"];
-export type PricingInputKind = (typeof INPUT_KINDS)[number];

package/dist/generated/{pricing.js → pricing-limits.js}

@@ -1,6 +1,4 @@
 // AUTO-GENERATED by `nix run .#gen` — do not edit.
-export const PRICING_FORMAT = 1;
-export const PRICING_CURRENCY = "EUR";
 export const PRICING_LIMITS = {
     "locale": "^[a-z]{2}(-[A-Z]{2})?$",
     "maxDiscountBp": 10000,
@@ -13,4 +11,3 @@ export const PRICING_LIMITS = {
     "maxPriceCents": 100000000,
     "slug": "^[a-z0-9_-]{1,40}$",
 };
-export const INPUT_KINDS = ["add", "multiply", "discount"];

package/dist/generated/site-channels.d.ts

@@ -0,0 +1,2 @@
+export declare const SITE_CHANNELS: readonly ["form", "callback", "whatsapp", "telegram"];
+export type SiteChannel = (typeof SITE_CHANNELS)[number];

package/dist/generated/site-channels.js

@@ -0,0 +1,2 @@
+// AUTO-GENERATED by `nix run .#gen` — do not edit.
+export const SITE_CHANNELS = ["form", "callback", "whatsapp", "telegram"];

package/dist/index.d.ts

@@ -1,15 +1,10 @@
-export * from "./generated/booking.js";
-export * from "./generated/codes.js";
-export * from "./generated/experiments.js";
-export * from "./generated/lead.js";
-export * from "./generated/place.js";
-export * from "./generated/pricing.js";
-export type * from "./generated/types.js";
-export * from "./generated/wire.js";
+export * from "./generated/index.js";
 export { bookingRequested, isBookingProvider, isLeadRef, isPageProvider, preferredDateInWindow, type BookingRequested } from "./booking.js";
 export { checkBookingConfig, checkBookingUrl, type BookingProblem } from "./booking-config.js";
 export { declarationProblem, parseLiveExperiments, type DeclarationProblem } from "./experiments.js";
+export { validHoldout, validWeights } from "@evinvest/experiments";
 export { ingestBody, isOpaqueId, siteEvent, uuidV7, type LeadCreated, type SiteEvent, type SiteEventHead, type SiteProperties } from "./ingest.js";
+export { messageRefOf } from "./message-ref.js";
 export { normalizePhone, phoneProblem } from "./phone.js";
 export { checkPlaceLive, isInstant, type PlaceProblem } from "./place.js";
 export { mulBp, priceOf, roundTo, type Price, type PriceLine, type PricingInputs, type PricingLabels } from "./price.js";

package/dist/index.js

@@ -1,14 +1,10 @@
-export * from "./generated/booking.js";
-export * from "./generated/codes.js";
-export * from "./generated/experiments.js";
-export * from "./generated/lead.js";
-export * from "./generated/place.js";
-export * from "./generated/pricing.js";
-export * from "./generated/wire.js";
+export * from "./generated/index.js";
 export { bookingRequested, isBookingProvider, isLeadRef, isPageProvider, preferredDateInWindow } from "./booking.js";
 export { checkBookingConfig, checkBookingUrl } from "./booking-config.js";
 export { declarationProblem, parseLiveExperiments } from "./experiments.js";
+export { validHoldout, validWeights } from "@evinvest/experiments";
 export { ingestBody, isOpaqueId, siteEvent, uuidV7 } from "./ingest.js";
+export { messageRefOf } from "./message-ref.js";
 export { normalizePhone, phoneProblem } from "./phone.js";
 export { checkPlaceLive, isInstant } from "./place.js";
 export { mulBp, priceOf, roundTo } from "./price.js";

package/dist/ingest.d.ts

@@ -1,5 +1,7 @@
 import type { BookingRequested } from "./booking.js";
-import type { LeadFlow, LeadSuspect, SiteChannel } from "./generated/lead.js";
+import type { LeadFlow } from "./generated/lead-flows.js";
+import type { LeadSuspect } from "./generated/lead-suspects.js";
+import type { SiteChannel } from "./generated/site-channels.js";
 import { type Event, type ExperimentsDeclaredV1, type IngestRequest, type LeadCreatedV1, type Registered, type SiteEventKey, type Subject } from "./generated/wire.js";
 /** `lead.created@1`'s properties, their vocabularies as the panel checks them. */
 export type LeadCreated = LeadCreatedV1 & {

package/dist/message-ref.d.ts

@@ -0,0 +1,7 @@
+/**
+ * A ref as an operator types or pastes it ("aq-7k3f ", "Réf. AQ-7K3F", "ref aq 7k3f", "AQ 7K3F")
+ * in the form the landing made it, `AQ-7K3F`, or `null` when it cannot be one
+ * (`contracts/vectors/message-ref.json`). In the code Crockford's look-alikes are read as it
+ * reads them: O is 0, I and L are 1.
+ */
+export declare function messageRefOf(raw: string | null): string | null;

package/dist/message-ref.js

@@ -0,0 +1,22 @@
+import { LEAD_LIMITS } from "./generated/lead-limits.js";
+const MESSAGE_REF = /* @__PURE__ */ new RegExp(LEAD_LIMITS.messageRef);
+/** A label pasted with the ref ("Réf. ", "ref ", "Ref: "): the prefilled WhatsApp line ends "Réf. AQ-7K3F". */
+const REF_LABEL = /^R[EÉ]F(?:[EÉ]RENCE)?(?:[.:#]\s*|\s+)/;
+/** The prefix and the code, apart: a dash, spaces, or both between them. */
+const REF_PARTS = /^([A-Z]{2,4})[\s-]*([0-9A-Z]{4,8})$/;
+/**
+ * A ref as an operator types or pastes it ("aq-7k3f ", "Réf. AQ-7K3F", "ref aq 7k3f", "AQ 7K3F")
+ * in the form the landing made it, `AQ-7K3F`, or `null` when it cannot be one
+ * (`contracts/vectors/message-ref.json`). In the code Crockford's look-alikes are read as it
+ * reads them: O is 0, I and L are 1.
+ */
+export function messageRefOf(raw) {
+    const text = (raw ?? "").trim().toUpperCase().replace(REF_LABEL, "").trim();
+    const parts = REF_PARTS.exec(text);
+    const prefix = parts?.[1];
+    const code = parts?.[2];
+    if (prefix === undefined || code === undefined)
+        return null;
+    const ref = `${prefix}-${code.replace(/O/g, "0").replace(/[IL]/g, "1")}`;
+    return MESSAGE_REF.test(ref) ? ref : null;
+}

package/dist/place.d.ts

@@ -1,4 +1,5 @@
-import type { BookingCode, PlaceCode } from "./generated/codes.js";
+import type { BookingCode } from "./generated/booking-codes.js";
+import type { PlaceCode } from "./generated/place-codes.js";
 import type { PlaceLive } from "./generated/types.js";
 /** One thing wrong with a place's settings: its path (`phone`, `hours[0].opens`, `booking.providers.cal_com.url`) and why. */
 export interface PlaceProblem {

package/dist/place.js

@@ -1,5 +1,7 @@
 import { checkBookingConfig } from "./booking-config.js";
-import { DAYS, MESSENGERS, PLACE_LIMITS as LIMIT } from "./generated/place.js";
+import { DAYS } from "./generated/days.js";
+import { MESSENGERS } from "./generated/messengers.js";
+import { PLACE_LIMITS as LIMIT } from "./generated/place-limits.js";
 import { at, charCount, hasControl, hasWhitespace, isDate, isObject, trim } from "./text.js";
 const E164 = /* @__PURE__ */ new RegExp(LIMIT.e164);
 const TELEGRAM_BOT = /* @__PURE__ */ new RegExp(LIMIT.telegramBot);

package/dist/price.d.ts

@@ -1,4 +1,4 @@
-import type { PricingInputKind } from "./generated/pricing.js";
+import type { PricingInputKind } from "./generated/input-kinds.js";
 import type { PricingInput, PricingModel } from "./generated/types.js";
 /** The answers to an estimate's inputs: input id → option id. */
 export type PricingInputs = Readonly<Record<string, string>>;

package/dist/pricing.d.ts

@@ -1,4 +1,4 @@
-import type { PricingCode } from "./generated/codes.js";
+import type { PricingCode } from "./generated/pricing-codes.js";
 import type { PricingModel } from "./generated/types.js";
 /**
  * One thing wrong with a model: its path from the model's root (`inputs[0].options[2].addCents`,

package/dist/pricing.js

@@ -1,4 +1,7 @@
-import { INPUT_KINDS, PRICING_CURRENCY, PRICING_FORMAT, PRICING_LIMITS as LIMIT } from "./generated/pricing.js";
+import { INPUT_KINDS } from "./generated/input-kinds.js";
+import { PRICING_CURRENCY } from "./generated/pricing-currency.js";
+import { PRICING_FORMAT } from "./generated/pricing-format.js";
+import { PRICING_LIMITS as LIMIT } from "./generated/pricing-limits.js";
 import { effects, mulBp } from "./price.js";
 import { at, isDate, isObject, trim } from "./text.js";
 const SLUG = /* @__PURE__ */ new RegExp(LIMIT.slug);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evinvest/sites-contract",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "The Service-Arb sites ↔ panel contract in TS: the shapes and vocabularies generated from the panel's Rust and protos, and the one TS implementation of what both sides run — pricing, booking and place checks, phone numbers, the ingest events a site sends.",
   "license": "BlueOak-1.0.0",
   "publishConfig": {
@@ -35,6 +35,9 @@
     "typecheck": "tsc --noEmit",
     "prepare": "npm run build"
   },
+  "dependencies": {
+    "@evinvest/experiments": "^0.6.1"
+  },
   "devDependencies": {
     "@types/node": "^22.10.0",
     "typescript": "^5.9.3",

package/dist/generated/booking.d.ts

@@ -1,12 +0,0 @@
-export declare const BOOKING_PROVIDERS: readonly ["manual", "link", "google_calendar", "cal_com"];
-export declare const PAGE_PROVIDERS: readonly ["link", "google_calendar", "cal_com"];
-export declare const BOOKING_LIMITS: {
-    readonly calComHosts: readonly ["cal.evinvest.ltd", "cal.com"];
-    readonly calComSegment: "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$";
-    readonly leadRef: "^lead-[1-9][0-9]{0,18}-[0-9a-f]{8}$";
-    readonly maxUrl: 2048;
-};
-export declare const BOOKING_STATUSES: readonly ["none", "requested", "booked", "canceled", "done", "no_show"];
-export type BookingStatus = (typeof BOOKING_STATUSES)[number];
-export declare const DAY_PARTS: readonly ["morning", "afternoon", "evening"];
-export type DayPart = (typeof DAY_PARTS)[number];

package/dist/generated/booking.js

@@ -1,11 +0,0 @@
-// AUTO-GENERATED by `nix run .#gen` — do not edit.
-export const BOOKING_PROVIDERS = ["manual", "link", "google_calendar", "cal_com"];
-export const PAGE_PROVIDERS = ["link", "google_calendar", "cal_com"];
-export const BOOKING_LIMITS = {
-    "calComHosts": ["cal.evinvest.ltd", "cal.com"],
-    "calComSegment": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$",
-    "leadRef": "^lead-[1-9][0-9]{0,18}-[0-9a-f]{8}$",
-    "maxUrl": 2048,
-};
-export const BOOKING_STATUSES = ["none", "requested", "booked", "canceled", "done", "no_show"];
-export const DAY_PARTS = ["morning", "afternoon", "evening"];

package/dist/generated/codes.d.ts

@@ -1,6 +0,0 @@
-export declare const PRICING_CODES: readonly ["object", "missing", "unknownField", "format", "currency", "date", "int", "slug", "labels", "locale", "label", "list", "duplicate", "kind", "needKind", "noInput", "dearest", "labelMissing"];
-export type PricingCode = (typeof PRICING_CODES)[number];
-export declare const BOOKING_CODES: readonly ["shape", "unknown_key", "required", "provider_unknown", "provider_shape", "provider_extra", "manual", "url_type", "default_unknown", "default_unset", "format", "scheme", "fragment", "backslash", "userinfo", "ip", "port", "host", "google", "cal_host", "cal_path"];
-export type BookingCode = (typeof BOOKING_CODES)[number];
-export declare const PLACE_CODES: readonly ["object", "unknown_field", "required", "type", "blank", "too_long", "control", "e164", "telegram_bot", "messenger_unknown", "boolean", "shape", "empty", "too_many", "day", "duplicate", "time", "closes_before_opens", "postal_code", "coordinate", "https_url", "review_url", "locale", "rating_value", "rating_count", "instant"];
-export type PlaceCode = (typeof PLACE_CODES)[number];

package/dist/generated/codes.js

@@ -1,4 +0,0 @@
-// AUTO-GENERATED by `nix run .#gen` — do not edit.
-export const PRICING_CODES = ["object", "missing", "unknownField", "format", "currency", "date", "int", "slug", "labels", "locale", "label", "list", "duplicate", "kind", "needKind", "noInput", "dearest", "labelMissing"];
-export const BOOKING_CODES = ["shape", "unknown_key", "required", "provider_unknown", "provider_shape", "provider_extra", "manual", "url_type", "default_unknown", "default_unset", "format", "scheme", "fragment", "backslash", "userinfo", "ip", "port", "host", "google", "cal_host", "cal_path"];
-export const PLACE_CODES = ["object", "unknown_field", "required", "type", "blank", "too_long", "control", "e164", "telegram_bot", "messenger_unknown", "boolean", "shape", "empty", "too_many", "day", "duplicate", "time", "closes_before_opens", "postal_code", "coordinate", "https_url", "review_url", "locale", "rating_value", "rating_count", "instant"];

package/dist/generated/lead.d.ts

@@ -1,13 +0,0 @@
-export declare const LEAD_LIMITS: {
-    readonly analyticsId: "^[A-Za-z0-9._:-]{1,128}$";
-    readonly maxEstimateInputs: 12;
-    readonly messageRef: "^[A-Z]{2,4}-[0-9A-HJKMNP-TV-Z]{4,8}$";
-};
-export declare const LEAD_CHANNELS: readonly ["form", "phone_inbound", "callback", "whatsapp", "telegram"];
-export type LeadChannel = (typeof LEAD_CHANNELS)[number];
-export declare const SITE_CHANNELS: readonly ["form", "callback", "whatsapp", "telegram"];
-export type SiteChannel = (typeof SITE_CHANNELS)[number];
-export declare const LEAD_SUSPECTS: readonly ["rate_limited", "too_fast"];
-export type LeadSuspect = (typeof LEAD_SUSPECTS)[number];
-export declare const LEAD_FLOWS: readonly ["quote", "estimate", "fixed"];
-export type LeadFlow = (typeof LEAD_FLOWS)[number];

package/dist/generated/lead.js

@@ -1,10 +0,0 @@
-// AUTO-GENERATED by `nix run .#gen` — do not edit.
-export const LEAD_LIMITS = {
-    "analyticsId": "^[A-Za-z0-9._:-]{1,128}$",
-    "maxEstimateInputs": 12,
-    "messageRef": "^[A-Z]{2,4}-[0-9A-HJKMNP-TV-Z]{4,8}$",
-};
-export const LEAD_CHANNELS = ["form", "phone_inbound", "callback", "whatsapp", "telegram"];
-export const SITE_CHANNELS = ["form", "callback", "whatsapp", "telegram"];
-export const LEAD_SUSPECTS = ["rate_limited", "too_fast"];
-export const LEAD_FLOWS = ["quote", "estimate", "fixed"];

package/dist/generated/place.d.ts

@@ -1,15 +0,0 @@
-export declare const DAYS: readonly ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday"];
-export declare const MESSENGERS: readonly ["whatsapp", "telegram"];
-export declare const PLACE_FIELDS: readonly ["phone", "whatsapp", "telegram", "messengers", "hours", "serviceArea", "address", "geo", "storefrontPhoto", "landmark", "rating", "booking", "reviewUrl"];
-export type PlaceField = (typeof PLACE_FIELDS)[number];
-export declare const PLACE_LIMITS: {
-    readonly e164: "^\\+[1-9][0-9]{6,14}$";
-    readonly maxArea: 200;
-    readonly maxHours: 14;
-    readonly maxLocales: 8;
-    readonly maxText: 200;
-    readonly maxUrl: 2048;
-    readonly reviewHosts: readonly ["g.page", "search.google.com"];
-    readonly telegramBot: "^[A-Za-z][A-Za-z0-9_]{1,28}[Bb][Oo][Tt]$";
-    readonly time: "^([01][0-9]|2[0-3]):[0-5][0-9]$";
-};