@aranova/tracking-react 1.12.0 → 1.14.0

package/dist/client.js

@@ -36,6 +36,7 @@ __export(client_exports, {
   ConsentBanner: () => ConsentBanner,
   GoogleAdsTracking: () => GoogleAdsTracking,
   PhoneField: () => PhoneField,
+  createLeadFormSubmit: () => createLeadFormSubmit,
   createTracking: () => createTracking,
   useBookingHandoffUrl: () => useBookingHandoffUrl,
   useBookingIntegration: () => useBookingIntegration,
@@ -305,7 +306,8 @@ var TRACKING_CAPABILITIES = [
   "cta_click_capture",
   "form_capture",
   "phone_click_capture",
-  "phone_fields"
+  "phone_fields",
+  "typed_form_submit"
 ];
 var CAPABILITY_DOM_ATTRIBUTE = "data-aranova-capability";
 var registered = /* @__PURE__ */ new Set();
@@ -1614,6 +1616,10 @@ var TrackingConfigRuntime = class {
   integrations() {
     return this.current?.integrations ?? null;
   }
+  /** The lead-form contracts, from the cached object like `integrations()`. */
+  leadForms() {
+    return this.current?.lead_forms ?? null;
+  }
   async revalidateNow() {
     try {
       const headers = {};
@@ -2676,7 +2682,7 @@ function createTrackingClient(config) {
 }
 
 // ../tracking-core/src/ingest-typed.ts
-var import_mini2 = require("zod/mini");
+var import_mini3 = require("zod/mini");
 
 // ../tracking-core/src/events/cta-click.ts
 var z3 = __toESM(require("zod/mini"));
@@ -2766,7 +2772,19 @@ var jsonValueSchema = z7.lazy(
     z7.record(z7.string(), jsonValueSchema)
   ])
 ).register(z7.globalRegistry, { id: "JsonSerializableValue" });
-var contractName = z7.string().check(z7.regex(/^[a-z][a-z0-9_]{0,47}(:[a-z0-9_-]{1,48})?$/));
+var contractNameSchema = z7.string().check(z7.regex(/^[a-z][a-z0-9_]{0,47}(:[a-z0-9_-]{1,48})?$/));
+var contractName = contractNameSchema;
+var violationRole = z7.string().check(
+  z7.maxLength(200),
+  z7.regex(
+    /^[a-z][a-z0-9_]{0,47}(:[a-z0-9_-]{1,48})?(\|[a-z][a-z0-9_]{0,47}(:[a-z0-9_-]{1,48})?)*$/
+  )
+);
+var MAX_CONTRACT_VIOLATIONS = 50;
+var contractViolationSchema = z7.strictObject({
+  role: z7.nullable(violationRole),
+  rule: z7.string().check(z7.regex(/^[a-z][a-z_]{0,47}$/))
+});
 var formSubmitMetadataSchema = z7.strictObject({
   form: z7.strictObject({
     id: z7.string(),
@@ -2795,6 +2813,9 @@ var formSubmitMetadataSchema = z7.strictObject({
           })
         ).check(z7.maxLength(20))
       )
+    ),
+    contract_violations: z7.optional(
+      z7.nullable(z7.array(contractViolationSchema).check(z7.maxLength(MAX_CONTRACT_VIOLATIONS)))
     )
   }),
   page: z7.strictObject({
@@ -3028,24 +3049,88 @@ function getEventDefinition(name) {
   return EVENT_REGISTRY[name];
 }
 
+// ../tracking-core/src/form-submit-salvage.ts
+var import_mini2 = require("zod/mini");
+var formShape = formSubmitMetadataSchema.shape.form.shape;
+var INVALID_SHAPE = { role: null, rule: "invalid_shape" };
+function salvageFormSubmit(metadata) {
+  if (!isRecord2(metadata) || !isRecord2(metadata.form)) return null;
+  const form = metadata.form;
+  const page = isRecord2(metadata.page) ? metadata.page : {};
+  const reported = Array.isArray(form.contract_violations) ? form.contract_violations.filter((v) => (0, import_mini2.safeParse)(contractViolationSchema, v).success) : [];
+  const salvaged = {
+    form: {
+      id: typeof form.id === "string" ? form.id : String(form.id ?? ""),
+      action: typeof form.action === "string" ? form.action : null,
+      fields: Array.isArray(form.fields) ? form.fields.filter(isRecord2).map(salvageField) : [],
+      ...valid("kind", form.kind),
+      ...valid("contract_version", form.contract_version),
+      ...valid("contract_hash", form.contract_hash),
+      ...valid("extra", form.extra),
+      contract_violations: [...reported, INVALID_SHAPE].slice(-MAX_CONTRACT_VIOLATIONS)
+    },
+    page: { path: typeof page.path === "string" ? page.path : currentPath2() }
+  };
+  const parsed = (0, import_mini2.safeParse)(formSubmitMetadataSchema, salvaged);
+  return parsed.success ? parsed.data : null;
+}
+function salvageField(field) {
+  return {
+    name: String(field.name ?? ""),
+    type: String(field.type ?? ""),
+    label: typeof field.label === "string" ? field.label : null,
+    value: toJson(field.value),
+    ...typeof field.role === "string" && (0, import_mini2.safeParse)(contractNameSchema, field.role).success ? { role: field.role } : {}
+  };
+}
+function valid(key, value) {
+  if (value == null || !(0, import_mini2.safeParse)(formShape[key], value).success) return {};
+  return { [key]: value };
+}
+function toJson(value) {
+  if (value === null || typeof value === "string" || typeof value === "boolean") return value;
+  if (typeof value === "number") return Number.isFinite(value) ? value : null;
+  if (typeof value === "bigint") return value.toString();
+  if (value instanceof Date) return Number.isNaN(value.getTime()) ? null : value.toISOString();
+  if (Array.isArray(value)) return value.map(toJson);
+  if (isRecord2(value)) {
+    return Object.fromEntries(
+      Object.entries(value).filter(([, v]) => v !== void 0).map(([k, v]) => [k, toJson(v)])
+    );
+  }
+  return null;
+}
+function isRecord2(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function currentPath2() {
+  return typeof window === "undefined" ? "/" : window.location.pathname;
+}
+
 // ../tracking-core/src/ingest-typed.ts
+var clientSettings = /* @__PURE__ */ new WeakMap();
+function typedClientSettings(client) {
+  return clientSettings.get(client) ?? {};
+}
 function createTypedClient(raw, registry, options = {}) {
   const debug = options.debug ?? false;
   if (registry.manual?.form_submit) registerCapability("form_capture");
-  return {
+  const client = {
     trackEvent(eventType, metadata, opts) {
       const def = getEventDefinition(eventType);
+      let sent = metadata;
       if (debug) {
-        (0, import_mini2.parse)(def.metadataSchema, metadata);
-      } else if (!(0, import_mini2.safeParse)(def.metadataSchema, metadata).success) {
+        (0, import_mini3.parse)(def.metadataSchema, metadata);
+      } else if (!(0, import_mini3.safeParse)(def.metadataSchema, metadata).success) {
+        sent = eventType === "form_submit" ? salvageFormSubmit(metadata) : null;
         console.warn(
-          `[AranovaTracking] trackEvent: metadata for "${eventType}" failed schema validation; event dropped`
+          sent ? `[AranovaTracking] trackEvent: metadata for "form_submit" failed schema validation; sent salvaged` : `[AranovaTracking] trackEvent: metadata for "${eventType}" failed schema validation; event dropped`
         );
-        return;
+        if (!sent) return;
       }
       raw.trackEvent({
         eventType,
-        metadata,
+        metadata: sent,
         pageUrl: opts?.pageUrl ?? null,
         occurredAt: opts?.occurredAt ?? null
       });
@@ -3054,6 +3139,8 @@ function createTypedClient(raw, registry, options = {}) {
     getSessionId: raw.getSessionId.bind(raw),
     getVisitorId: raw.getVisitorId.bind(raw)
   };
+  clientSettings.set(client, options);
+  return client;
 }
 
 // ../tracking-core/src/triggers/time-on-site.ts
@@ -3124,7 +3211,7 @@ function attachSpecificPageVisit(client, config) {
   }
   const { pages } = config;
   const firedSet = /* @__PURE__ */ new Set();
-  function check() {
+  function check2() {
     const path = window.location.pathname;
     for (const { name, pathPattern } of pages) {
       pathPattern.lastIndex = 0;
@@ -3144,20 +3231,20 @@ function attachSpecificPageVisit(client, config) {
   const originalReplaceState = history.replaceState.bind(history);
   function patchedPushState(...args) {
     originalPushState(...args);
-    setTimeout(check, 0);
+    setTimeout(check2, 0);
   }
   function patchedReplaceState(...args) {
     originalReplaceState(...args);
-    setTimeout(check, 0);
+    setTimeout(check2, 0);
   }
   history.pushState = patchedPushState;
   history.replaceState = patchedReplaceState;
-  window.addEventListener("popstate", check);
-  check();
+  window.addEventListener("popstate", check2);
+  check2();
   return () => {
     history.pushState = originalPushState;
     history.replaceState = originalReplaceState;
-    window.removeEventListener("popstate", check);
+    window.removeEventListener("popstate", check2);
   };
 }
 
@@ -3260,7 +3347,7 @@ function attachScrollDepth(client, config) {
   }
   const thresholds = new Set(config.thresholds);
   let firedForPath = /* @__PURE__ */ new Set();
-  let currentPath2 = window.location.pathname;
+  let currentPath3 = window.location.pathname;
   let rafId = null;
   const gate = createBaselineGate();
   function checkThresholds() {
@@ -3276,7 +3363,7 @@ function attachScrollDepth(client, config) {
           eventType: "scroll_depth",
           metadata: {
             depth_percent: threshold,
-            page: { path: currentPath2 }
+            page: { path: currentPath3 }
           },
           pageUrl: window.location.href,
           occurredAt: null
@@ -3293,8 +3380,8 @@ function attachScrollDepth(client, config) {
   }
   function resetIfPathChanged() {
     const newPath = window.location.pathname;
-    if (newPath === currentPath2) return;
-    currentPath2 = newPath;
+    if (newPath === currentPath3) return;
+    currentPath3 = newPath;
     firedForPath = /* @__PURE__ */ new Set();
     gate.rebaseline();
   }
@@ -3356,14 +3443,14 @@ function attachMultiPageSession(client, config) {
   function hasFired() {
     return storage.getItem(FIRED_KEY) === "1";
   }
-  function check() {
-    const currentPath2 = window.location.pathname;
-    if (currentPath2 === lastCheckedPath) return;
-    lastCheckedPath = currentPath2;
+  function check2() {
+    const currentPath3 = window.location.pathname;
+    if (currentPath3 === lastCheckedPath) return;
+    lastCheckedPath = currentPath3;
     resetIfSessionChanged();
     if (hasFired()) return;
     const paths = getDistinctPaths();
-    paths.add(currentPath2);
+    paths.add(currentPath3);
     saveDistinctPaths(paths);
     if (paths.size >= pageThreshold) {
       storage.setItem(FIRED_KEY, "1");
@@ -3382,20 +3469,20 @@ function attachMultiPageSession(client, config) {
   const originalReplaceState = history.replaceState.bind(history);
   function patchedPushState(...args) {
     originalPushState(...args);
-    setTimeout(check, 0);
+    setTimeout(check2, 0);
   }
   function patchedReplaceState(...args) {
     originalReplaceState(...args);
-    setTimeout(check, 0);
+    setTimeout(check2, 0);
   }
   history.pushState = patchedPushState;
   history.replaceState = patchedReplaceState;
-  window.addEventListener("popstate", check);
-  check();
+  window.addEventListener("popstate", check2);
+  check2();
   return () => {
     history.pushState = originalPushState;
     history.replaceState = originalReplaceState;
-    window.removeEventListener("popstate", check);
+    window.removeEventListener("popstate", check2);
   };
 }
 
@@ -3408,7 +3495,7 @@ function attachFormStart(client, config) {
   }
   const selector = config.selector ?? "form";
   let firedForms = /* @__PURE__ */ new Set();
-  let currentPath2 = window.location.pathname;
+  let currentPath3 = window.location.pathname;
   let pendingTap = null;
   function getFormKey(form) {
     if (form.id) return `id:${form.id}`;
@@ -3459,8 +3546,8 @@ function attachFormStart(client, config) {
   }
   function resetIfPathChanged() {
     const newPath = window.location.pathname;
-    if (newPath === currentPath2) return;
-    currentPath2 = newPath;
+    if (newPath === currentPath3) return;
+    currentPath3 = newPath;
     firedForms = /* @__PURE__ */ new Set();
   }
   const originalPushState = history.pushState.bind(history);
@@ -3501,7 +3588,7 @@ function attachPageExit(client) {
     return () => {
     };
   }
-  let currentPath2 = window.location.pathname;
+  let currentPath3 = window.location.pathname;
   let activeSince = document.visibilityState === "visible" ? Date.now() : null;
   let accumulatedMs = 0;
   let maxScrollPercent = null;
@@ -3551,9 +3638,9 @@ function attachPageExit(client) {
   }
   function onNavigate() {
     const newPath = window.location.pathname;
-    if (newPath === currentPath2) return;
-    emitSegment(currentPath2, false);
-    currentPath2 = newPath;
+    if (newPath === currentPath3) return;
+    emitSegment(currentPath3, false);
+    currentPath3 = newPath;
     maxScrollPercent = null;
     gate.rebaseline();
     accumulatedMs = 0;
@@ -3561,13 +3648,13 @@ function attachPageExit(client) {
   }
   function onVisibilityChange() {
     if (document.visibilityState === "hidden") {
-      emitSegment(currentPath2, true);
+      emitSegment(currentPath3, true);
     } else {
       activeSince = Date.now();
     }
   }
   function onPageHide() {
-    emitSegment(currentPath2, true);
+    emitSegment(currentPath3, true);
   }
   const unsubscribeNav = onHistoryChange(onNavigate);
   window.addEventListener("scroll", onScroll, { passive: true });
@@ -3746,6 +3833,104 @@ function attachPhoneClickCapture(client, config) {
   };
 }
 
+// ../tracking-core/src/lead-forms/lead-forms.gen.ts
+var z15 = __toESM(require("zod/mini"));
+var LEAD_FORM_REGISTRY_VERSION = 2;
+var LEAD_FORM_ROLES = [
+  "given_name",
+  "family_name",
+  "phone",
+  "email",
+  "service",
+  "preferred_date",
+  "preferred_time",
+  "note",
+  "visit",
+  "intent",
+  "vehicle",
+  "drop_off",
+  "address",
+  "patient_type",
+  "matter",
+  "language",
+  "products",
+  "goal",
+  "business_type",
+  "lead_volume",
+  "attribution"
+];
+var leadFormPrimitiveSchemas = /* @__PURE__ */ (() => ({
+  string: z15.string().check(z15.maxLength(120)),
+  text: z15.string().check(z15.maxLength(2e3)),
+  enum: z15.string().check(z15.regex(/^[a-z0-9-]{1,48}$/)),
+  multi_enum: z15.array(z15.string().check(z15.regex(/^[a-z0-9-]{1,48}$/))).check(z15.maxLength(10)),
+  bool: z15.boolean(),
+  date: z15.string().check(z15.regex(/^\d{4}-\d{2}-\d{2}$/)),
+  time_window: z15.strictObject({
+    start: z15.string().check(z15.regex(/^([01]\d|2[0-3]):[0-5]\d$/)),
+    end: z15.nullable(z15.string().check(z15.regex(/^([01]\d|2[0-3]):[0-5]\d$/))),
+    label: z15.optional(z15.string().check(z15.maxLength(60)))
+  }),
+  phone: z15.string().check(z15.regex(/^\+[1-9]\d{6,14}$/)),
+  email: z15.string().check(z15.maxLength(320), z15.regex(/^[^\s@]+@[^\s@]+$/)),
+  address: z15.strictObject({
+    line1: z15.string().check(z15.maxLength(120)),
+    line2: z15.optional(z15.string().check(z15.maxLength(120))),
+    city: z15.optional(z15.string().check(z15.maxLength(120))),
+    region: z15.optional(z15.string().check(z15.maxLength(120))),
+    postal_code: z15.optional(z15.string().check(z15.maxLength(120))),
+    country: z15.optional(z15.string().check(z15.maxLength(120)))
+  }),
+  number: z15.number()
+}))();
+var LEAD_FORM_ROLE_SPECS = {
+  given_name: { primitive: "string", smsLabel: "", contactIdentity: true },
+  family_name: { primitive: "string", smsLabel: "", contactIdentity: true },
+  phone: { primitive: "phone", smsLabel: "", contactIdentity: true },
+  email: { primitive: "email", smsLabel: "", contactIdentity: true },
+  service: { primitive: "multi_enum", smsLabel: "Service" },
+  preferred_date: { primitive: "date", smsLabel: "Date" },
+  preferred_time: { primitive: "time_window", smsLabel: "Time" },
+  note: { primitive: "text", smsLabel: "Note" },
+  visit: {
+    primitive: "enum",
+    smsLabel: "Visit",
+    options: [
+      { key: "in-shop", label: "In shop" },
+      { key: "in-home", label: "In home" },
+      { key: "remote", label: "Remote" },
+      { key: "on-site", label: "On site" }
+    ]
+  },
+  intent: {
+    primitive: "enum",
+    smsLabel: "Wants",
+    options: [
+      { key: "book", label: "Book" },
+      { key: "quote", label: "Quote" }
+    ]
+  },
+  vehicle: { primitive: "string", smsLabel: "Vehicle" },
+  drop_off: {
+    primitive: "enum",
+    smsLabel: "Drop-off",
+    options: [
+      { key: "wait-for-it", label: "Waiting" },
+      { key: "drop-off", label: "Dropping off" }
+    ]
+  },
+  address: { primitive: "address", smsLabel: "Address" },
+  patient_type: { primitive: "enum", smsLabel: "Patient" },
+  matter: { primitive: "enum", smsLabel: "Matter" },
+  language: { primitive: "enum", smsLabel: "Language" },
+  products: { primitive: "multi_enum", smsLabel: "Products" },
+  goal: { primitive: "enum", smsLabel: "Goal" },
+  business_type: { primitive: "enum", smsLabel: "Business" },
+  lead_volume: { primitive: "enum", smsLabel: "Lead volume" },
+  add_on: { primitive: "bool", smsLabel: "" },
+  attribution: { primitive: "enum", smsLabel: "", uninteresting: true }
+};
+
 // ../tracking-core/src/resources/sales/bookings.ts
 var newBookingAttemptKey = uuidV4;
 
@@ -4080,7 +4265,7 @@ function GoogleAdsTracking(props) {
 var import_react6 = require("react");
 
 // package.json
-var version = "1.12.0";
+var version = "1.14.0";
 
 // ../tracking-core/src/phone-react.tsx
 var import_react5 = require("react");
@@ -4251,7 +4436,11 @@ function createTracking(options) {
       [rawClient, conversionStore]
     );
     const client = (0, import_react6.useMemo)(
-      () => createTypedClient(conversionClient, triggers, { debug }),
+      () => createTypedClient(conversionClient, triggers, {
+        debug,
+        environment,
+        trackingConfig
+      }),
       [conversionClient]
     );
     (0, import_react6.useEffect)(() => {
@@ -4450,6 +4639,145 @@ function useBookingSubmit(bookings, options = {}) {
   const status = submitting ? "submitting" : outcome?.status ?? "idle";
   return { status, outcome, booked, submit, updateBooking, reset };
 }
+
+// ../tracking-core/src/lead-forms/submit.ts
+var import_mini4 = require("zod/mini");
+var KNOWN_ROLES = new Set(LEAD_FORM_ROLES);
+var ROLE_ORDER = new Map(LEAD_FORM_ROLES.map((role, index) => [role, index]));
+var ADD_ON = /^add_on:[a-z0-9_-]{1,48}$/;
+var CONTRACT_NAME = /^[a-z][a-z0-9_]{0,47}(:[a-z0-9_-]{1,48})?$/;
+var INPUT_TYPES = {
+  string: "text",
+  text: "textarea",
+  enum: "select",
+  multi_enum: "select",
+  bool: "checkbox",
+  date: "date",
+  time_window: "time",
+  phone: "tel",
+  email: "email",
+  address: "address",
+  number: "number"
+};
+function createLeadFormSubmit(tracking, contracts, options = {}) {
+  registerCapability("typed_form_submit");
+  const settings = { ...typedClientSettings(tracking), ...options };
+  return {
+    submit(input) {
+      const generated = contracts.contracts[input.kind];
+      const live = liveContract(settings.trackingConfig, input.kind);
+      const fields = presentFields(input.fields);
+      const violations = check(live === void 0 ? generated : fromLive(live), fields);
+      const liveHash = live === void 0 ? void 0 : live?.contract_hash ?? null;
+      if (liveHash !== void 0 && (generated?.hash ?? null) !== liveHash || contracts.registryVersion !== LEAD_FORM_REGISTRY_VERSION) {
+        violations.push({ role: null, rule: "contract_behind" });
+      }
+      const hash = liveHash === void 0 ? generated?.hash ?? null : liveHash;
+      const metadata = {
+        form: {
+          id: input.formId,
+          action: input.action ?? null,
+          fields: fields.map(([role, value]) => ({
+            name: role,
+            type: INPUT_TYPES[primitiveOf(role) ?? "string"],
+            label: labelOf(role),
+            value,
+            role
+          })),
+          kind: input.kind,
+          contract_version: LEAD_FORM_REGISTRY_VERSION,
+          ...hash ? { contract_hash: hash } : {},
+          ...input.extra?.length ? { extra: input.extra } : {},
+          ...violations.length > 0 ? { contract_violations: violations.slice(0, MAX_CONTRACT_VIOLATIONS) } : {}
+        },
+        page: { path: typeof window === "undefined" ? "/" : window.location.pathname }
+      };
+      if (violations.length > 0 && (settings.debug || settings.environment === "development")) {
+        const message = `[AranovaTracking] lead form "${input.formId}" (${input.kind}) breaks its contract: ${violations.map((v) => `${v.rule}${v.role ? ` (${v.role})` : ""}`).join(", ")}`;
+        console.error(message);
+        if (settings.debug) throw new Error(message);
+      }
+      tracking.trackEvent("form_submit", metadata);
+      return metadata;
+    }
+  };
+}
+function liveContract(ref, kind) {
+  const leadForms = ref ? getTrackingConfigRuntime(ref).leadForms() : null;
+  if (!leadForms) return void 0;
+  return leadForms.contracts.find((c) => c.form_kind === kind) ?? null;
+}
+function fromLive(live) {
+  if (!live) return void 0;
+  return {
+    requires: live.requires.map((r) => ({
+      role: r.role,
+      requiredWhen: r.required_when ? { role: r.required_when.role, anyOf: r.required_when.any_of } : null
+    })),
+    requiresAny: live.requires_any.map((g) => g.roles),
+    // Deprecated keys still resolve: a cached form may send them (ADR-0024 §7).
+    options: Object.fromEntries(live.options.map((o) => [o.role, o.options.map((x) => x.key)]))
+  };
+}
+function presentFields(fields) {
+  return Object.entries(fields).map(([role, value]) => [role, normalize(role, value)]).filter((entry) => !isBlank(entry[1])).sort(([a], [b]) => (ROLE_ORDER.get(a) ?? 999) - (ROLE_ORDER.get(b) ?? 999));
+}
+function normalize(role, value) {
+  if (typeof value !== "string") return value;
+  const trimmed = value.trim();
+  const primitive = primitiveOf(role);
+  if (primitive === "phone") return toE164(trimmed) ?? trimmed;
+  if (primitive === "email") return trimmed.toLowerCase();
+  return primitive === "text" ? value : trimmed;
+}
+function isBlank(value) {
+  return value === void 0 || value === null || typeof value === "string" && value.trim() === "" || Array.isArray(value) && value.length === 0;
+}
+function check(contract, fields) {
+  const answered = new Map(fields);
+  const violations = [];
+  for (const [role, value] of fields) {
+    const primitive = primitiveOf(role);
+    if (!primitive) {
+      violations.push({ role: CONTRACT_NAME.test(role) ? role : null, rule: "unknown_role" });
+      continue;
+    }
+    if (!(0, import_mini4.safeParse)(leadFormPrimitiveSchemas[primitive], value).success) {
+      violations.push({ role, rule: "invalid_value" });
+      continue;
+    }
+    const allowed = contract?.options[role] ?? registryOptions(role);
+    if (allowed?.length && optionKeys(value).some((key) => !allowed.includes(key))) {
+      violations.push({ role, rule: "unknown_option" });
+    }
+  }
+  for (const { role, requiredWhen } of contract?.requires ?? []) {
+    const owing = requiredWhen === null || optionKeys(answered.get(requiredWhen.role)).some((key) => requiredWhen.anyOf.includes(key));
+    if (owing && !answered.has(role)) violations.push({ role, rule: "missing_required" });
+  }
+  for (const group of contract?.requiresAny ?? []) {
+    if (!group.some((role) => answered.has(role))) {
+      violations.push({ role: group.join("|"), rule: "missing_any_of" });
+    }
+  }
+  return violations;
+}
+function primitiveOf(role) {
+  if (ADD_ON.test(role)) return "bool";
+  return KNOWN_ROLES.has(role) ? LEAD_FORM_ROLE_SPECS[role].primitive : null;
+}
+function labelOf(role) {
+  if (ADD_ON.test(role)) return role.slice("add_on:".length).replaceAll(/[_-]+/g, " ");
+  return KNOWN_ROLES.has(role) ? LEAD_FORM_ROLE_SPECS[role].smsLabel || null : null;
+}
+function registryOptions(role) {
+  const spec = KNOWN_ROLES.has(role) ? LEAD_FORM_ROLE_SPECS[role] : void 0;
+  return spec && "options" in spec ? spec.options.map((o) => o.key) : void 0;
+}
+function optionKeys(value) {
+  if (typeof value === "string") return [value];
+  return Array.isArray(value) ? value.filter((v) => typeof v === "string") : [];
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AdPlatformTracking,
@@ -4457,6 +4785,7 @@ function useBookingSubmit(bookings, options = {}) {
   ConsentBanner,
   GoogleAdsTracking,
   PhoneField,
+  createLeadFormSubmit,
   createTracking,
   useBookingHandoffUrl,
   useBookingIntegration,