@evinvest/sites-contract 0.1.4 → 0.1.5

package/README.md

@@ -3,7 +3,7 @@
 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
@@ -15,9 +15,10 @@ src/*.ts                   the one TS implementation of what both sides run, hel
   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/experiments.js

@@ -1,3 +1,4 @@
+import { validHoldout, validWeights } from "@evinvest/experiments";
 import { EXPERIMENT_LIMITS } from "./generated/experiment-limits.js";
 import { charCount, isObject, trim } from "./text.js";
 /**
@@ -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/index.d.ts

@@ -2,7 +2,9 @@ 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

@@ -2,7 +2,9 @@ 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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evinvest/sites-contract",
-  "version": "0.1.4",
+  "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",