@aranova/tracking-react 1.11.0 → 1.13.0

package/README.md

@@ -362,9 +362,11 @@ await submit({
   `[{ group, options }]` in order, so render one heading per group with its choices under it.
 - `useBookingSlots` / `bookableSlots(rules, { timeZone })` offer exactly the portal's start hours,
   judged by the shop's date. `useBookingSubmit` reuses one attempt key across a double-click or
-  a retry, and sends the visit's `form_submit` once: don't send your own for this form. Add the
-  form's own questions with `formSubmit.extraFields`; a name the booking already reports
-  (`phone`, `email`, ...) is dropped.
+  a retry, and sends the visit's `form_submit` once: don't send your own for this form. It is a
+  typed `booking` submit (ADR-0024): every field carries its contract `role`, `service` is the
+  option keys, `preferred_date` is `YYYY-MM-DD`, `preferred_time` is
+  `{ start: "HH:00", end: null }`, and `drop_off` is `wait-for-it` / `drop-off`. Add the form's own questions with
+  `formSubmit.extraFields`; a name the booking already reports (`phone`, `email`, ...) is dropped.
 - Ask for the last name separately, and a mobile number (the shop's confirmation text goes to it).
 - Details after booking (when `booking.rules.vehicleDeferred`, for extra notes, or for the site's
   own "How did you hear about us?" answer):

package/dist/{bookings-vM_aCNOS.d.ts → bookings-C1HMPjQl.d.ts}

@@ -51,6 +51,40 @@ interface ConversionConfig {
 interface LeadFormsConfig {
     /** The registry version the object was published under. */
     registry_version: number;
+    /** One per form kind a bound consumer needs something from; an absent kind needs nothing. */
+    contracts: LeadFormContract[];
+}
+/** What one kind of form must collect for this business, derived server-side. */
+interface LeadFormContract {
+    form_kind: string;
+    requires: LeadFormRequirement[];
+    /** Each group is satisfied by any one of its roles. */
+    requires_any: Array<{
+        roles: string[];
+        waived: boolean;
+    }>;
+    options: Array<{
+        role: string;
+        options: LeadFormContractOption[];
+    }>;
+    /** Echo on `form_submit` as `form.contract_hash`. */
+    contract_hash: string;
+}
+interface LeadFormRequirement {
+    role: string;
+    /** Required only when `role` holds one of `any_of`; never nested. */
+    required_when: {
+        role: string;
+        any_of: string[];
+    } | null;
+    waived: boolean;
+}
+interface LeadFormContractOption {
+    key: string;
+    label: string;
+    is_non_answer: boolean;
+    /** Dropped from the form; still accepted from a cached config. */
+    deprecated: boolean;
 }
 /** Bookable start hours on one weekday, shop wall time (8 = 08:00); both empty = closed. */
 interface BookingDayWindows {
@@ -263,6 +297,8 @@ declare class TrackingConfigRuntime {
      * link is safe to show stale. Same reference until the next adopt, for `useSyncExternalStore`.
      */
     integrations(): ConversionIntegrations | null;
+    /** The lead-form contracts, from the cached object like `integrations()`. */
+    leadForms(): LeadFormsConfig | null;
     private revalidateNow;
     private expireAuthority;
     private confirm;

package/dist/{bookings-BnXZGgwr.d.mts → bookings-CHpplXU7.d.mts}

@@ -51,6 +51,40 @@ interface ConversionConfig {
 interface LeadFormsConfig {
     /** The registry version the object was published under. */
     registry_version: number;
+    /** One per form kind a bound consumer needs something from; an absent kind needs nothing. */
+    contracts: LeadFormContract[];
+}
+/** What one kind of form must collect for this business, derived server-side. */
+interface LeadFormContract {
+    form_kind: string;
+    requires: LeadFormRequirement[];
+    /** Each group is satisfied by any one of its roles. */
+    requires_any: Array<{
+        roles: string[];
+        waived: boolean;
+    }>;
+    options: Array<{
+        role: string;
+        options: LeadFormContractOption[];
+    }>;
+    /** Echo on `form_submit` as `form.contract_hash`. */
+    contract_hash: string;
+}
+interface LeadFormRequirement {
+    role: string;
+    /** Required only when `role` holds one of `any_of`; never nested. */
+    required_when: {
+        role: string;
+        any_of: string[];
+    } | null;
+    waived: boolean;
+}
+interface LeadFormContractOption {
+    key: string;
+    label: string;
+    is_non_answer: boolean;
+    /** Dropped from the form; still accepted from a cached config. */
+    deprecated: boolean;
 }
 /** Bookable start hours on one weekday, shop wall time (8 = 08:00); both empty = closed. */
 interface BookingDayWindows {
@@ -263,6 +297,8 @@ declare class TrackingConfigRuntime {
      * link is safe to show stale. Same reference until the next adopt, for `useSyncExternalStore`.
      */
     integrations(): ConversionIntegrations | null;
+    /** The lead-form contracts, from the cached object like `integrations()`. */
+    leadForms(): LeadFormsConfig | null;
     private revalidateNow;
     private expireAuthority;
     private confirm;

package/dist/client.d.mts

@@ -1,8 +1,8 @@
 import * as react from 'react';
 import { ReactNode, CSSProperties, InputHTMLAttributes, ChangeEvent, FocusEvent, AnchorHTMLAttributes } from 'react';
 import { G as GtagEnvironmentMap, M as MetaPixelEnvironmentMap, h as ConsentState, f as ConsentChoiceState, g as ConsentSource, T as TrackingParams, b as TrackingEnvironment, j as PhoneConfig, P as ParsedPhone, k as PhoneDisplayFormat } from './phone-utils-BNiSqeF7.mjs';
-import { T as TrackingConfigReference, C as ConversionConfig, i as BookingOutcome, g as BookingInput, a as BookingDetailsInput, c as BookingDetailsOutcome, S as SalesBookingsClient, f as BookingFormSubmit, j as BookingSimulation } from './bookings-BnXZGgwr.mjs';
-import { X as TriggerRegistryConfig, Z as TypedTrackingClient, a as BookingHandoffPrefill, b as BookingIntegration, B as BookableDay } from './ingest-typed-TI6KqVzL.mjs';
+import { T as TrackingConfigReference, C as ConversionConfig, i as BookingOutcome, g as BookingInput, a as BookingDetailsInput, c as BookingDetailsOutcome, S as SalesBookingsClient, f as BookingFormSubmit, j as BookingSimulation } from './bookings-CHpplXU7.mjs';
+import { X as TriggerRegistryConfig, Z as TypedTrackingClient, a as BookingHandoffPrefill, b as BookingIntegration, B as BookableDay } from './ingest-typed-Ckt4R731.mjs';
 import { CountryCode } from 'libphonenumber-js';
 import './form-submit-CX-CxJjQ.mjs';
 import 'zod/mini';

package/dist/client.d.ts

@@ -1,8 +1,8 @@
 import * as react from 'react';
 import { ReactNode, CSSProperties, InputHTMLAttributes, ChangeEvent, FocusEvent, AnchorHTMLAttributes } from 'react';
 import { G as GtagEnvironmentMap, M as MetaPixelEnvironmentMap, h as ConsentState, f as ConsentChoiceState, g as ConsentSource, T as TrackingParams, b as TrackingEnvironment, j as PhoneConfig, P as ParsedPhone, k as PhoneDisplayFormat } from './phone-utils-D12FW8tT.js';
-import { T as TrackingConfigReference, C as ConversionConfig, i as BookingOutcome, g as BookingInput, a as BookingDetailsInput, c as BookingDetailsOutcome, S as SalesBookingsClient, f as BookingFormSubmit, j as BookingSimulation } from './bookings-vM_aCNOS.js';
-import { X as TriggerRegistryConfig, Z as TypedTrackingClient, a as BookingHandoffPrefill, b as BookingIntegration, B as BookableDay } from './ingest-typed-BS9agXM5.js';
+import { T as TrackingConfigReference, C as ConversionConfig, i as BookingOutcome, g as BookingInput, a as BookingDetailsInput, c as BookingDetailsOutcome, S as SalesBookingsClient, f as BookingFormSubmit, j as BookingSimulation } from './bookings-C1HMPjQl.js';
+import { X as TriggerRegistryConfig, Z as TypedTrackingClient, a as BookingHandoffPrefill, b as BookingIntegration, B as BookableDay } from './ingest-typed-sCDoPInT.js';
 import { CountryCode } from 'libphonenumber-js';
 import './form-submit-CX-CxJjQ.js';
 import 'zod/mini';

package/dist/client.js

@@ -1133,9 +1133,58 @@ function parseConversionConfig(raw) {
   };
 }
 function parseLeadForms(value) {
-  if (!value || typeof value !== "object") return null;
-  const version2 = value.registry_version;
-  return typeof version2 === "number" ? { registry_version: version2 } : null;
+  if (!isRecord(value) || typeof value.registry_version !== "number") return null;
+  return {
+    registry_version: value.registry_version,
+    contracts: records(value.contracts).flatMap(
+      (c) => typeof c.form_kind === "string" && typeof c.contract_hash === "string" ? [
+        {
+          form_kind: c.form_kind,
+          requires: records(c.requires).flatMap(
+            (r) => typeof r.role === "string" ? [
+              {
+                role: r.role,
+                required_when: parseCondition(r.required_when),
+                waived: r.waived === true
+              }
+            ] : []
+          ),
+          requires_any: records(c.requires_any).map((g) => ({
+            roles: strings(g.roles),
+            waived: g.waived === true
+          })),
+          options: records(c.options).flatMap(
+            (o) => typeof o.role === "string" ? [{ role: o.role, options: records(o.options).flatMap(parseContractOption) }] : []
+          ),
+          contract_hash: c.contract_hash
+        }
+      ] : []
+    )
+  };
+}
+function parseCondition(value) {
+  if (!isRecord(value) || typeof value.role !== "string") return null;
+  return { role: value.role, any_of: strings(value.any_of) };
+}
+function parseContractOption(value) {
+  if (typeof value.key !== "string" || typeof value.label !== "string") return [];
+  return [
+    {
+      key: value.key,
+      label: value.label,
+      is_non_answer: value.is_non_answer === true,
+      deprecated: value.deprecated === true
+    }
+  ];
+}
+function isRecord(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function records(value) {
+  return Array.isArray(value) ? value.filter(isRecord) : [];
+}
+function strings(value) {
+  return Array.isArray(value) ? value.filter((v) => typeof v === "string") : [];
 }
 var CACHE_PREFIX = "_aranova_cfg_";
 function cacheKey(url) {
@@ -1565,6 +1614,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 = {};
@@ -4031,7 +4084,7 @@ function GoogleAdsTracking(props) {
 var import_react6 = require("react");
 
 // package.json
-var version = "1.11.0";
+var version = "1.13.0";
 
 // ../tracking-core/src/phone-react.tsx
 var import_react5 = require("react");