@aranova/tracking-react 1.12.0 → 1.14.0

package/README.md

@@ -195,6 +195,32 @@ page unload it records the **active** (visible) time spent on the page plus the
 depth reached, delivered via a keepalive beacon so the final page still counts. This powers
 per-page dwell and drop-off in the dashboard Analytics tab; there is nothing to configure.
 
+## Typed lead forms
+
+Generate the site's lead-form contract once and send submits through it, so a dropped required
+field fails `tsc` instead of losing leads:
+
+```bash
+npx @aranova/tracking-cli forms gen   # writes src/aranova-lead-forms.ts; `forms check` in CI
+```
+
+```tsx
+import { createLeadFormSubmit, slotFields } from "@aranova/tracking-react";
+import { ARANOVA_LEAD_FORMS } from "@/aranova-lead-forms";
+
+const leadForms = createLeadFormSubmit(useTracking(), ARANOVA_LEAD_FORMS);
+leadForms.submit({
+  formId: "booking-form",
+  kind: "booking",
+  fields: { given_name: values.firstName, phone: values.phone, ...slotFields(values.slot) },
+});
+```
+
+Development logs each contract violation, `debug` throws, production sends anyway tagged
+`form.contract_violations`. A malformed hand-built `form_submit` is salvaged in production
+(tagged `invalid_shape`) rather than dropped. Full guide:
+[docs/tracking-package/lead-forms.md](../../docs/tracking-package/lead-forms.md).
+
 ## Phone Fields
 
 Bundled `libphonenumber-js`: parse/format utils + a React input. Display is configurable; the
@@ -362,9 +388,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-v_ucn93l.d.ts → bookings-Bw2ImtPd.d.ts}

@@ -1,4 +1,4 @@
-import { a as FormSubmitMetadata } from './form-submit-CX-CxJjQ.js';
+import { b as FormSubmitMetadata } from './form-submit-C_vJXCxh.js';
 
 interface ServiceFiring {
     send_to: string;
@@ -297,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-Lmi0o_PA.d.mts → bookings-CDGNZUaH.d.mts}

@@ -1,4 +1,4 @@
-import { a as FormSubmitMetadata } from './form-submit-CX-CxJjQ.mjs';
+import { b as FormSubmitMetadata } from './form-submit-C_vJXCxh.mjs';
 
 interface ServiceFiring {
     send_to: string;
@@ -297,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,10 +1,11 @@
 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-Lmi0o_PA.mjs';
-import { X as TriggerRegistryConfig, Z as TypedTrackingClient, a as BookingHandoffPrefill, b as BookingIntegration, B as BookableDay } from './ingest-typed-PKFEuJ8E.mjs';
+import { G as GtagEnvironmentMap, M as MetaPixelEnvironmentMap, h as ConsentState, f as ConsentChoiceState, g as ConsentSource, T as TrackingParams, b as TrackingEnvironment, s as PhoneConfig, P as ParsedPhone, t as PhoneDisplayFormat } from './phone-utils-Cfdx474X.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-CDGNZUaH.mjs';
+import { a7 as TriggerRegistryConfig, a9 as TypedTrackingClient, a as BookingHandoffPrefill, b as BookingIntegration, B as BookableDay } from './submit-rqgXl-Wg.mjs';
+export { ai as createLeadFormSubmit } from './submit-rqgXl-Wg.mjs';
 import { CountryCode } from 'libphonenumber-js';
-import './form-submit-CX-CxJjQ.mjs';
+import './form-submit-C_vJXCxh.mjs';
 import 'zod/mini';
 import 'zod/v4/core';
 

package/dist/client.d.ts

@@ -1,10 +1,11 @@
 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-v_ucn93l.js';
-import { X as TriggerRegistryConfig, Z as TypedTrackingClient, a as BookingHandoffPrefill, b as BookingIntegration, B as BookableDay } from './ingest-typed-B9I1c7jr.js';
+import { G as GtagEnvironmentMap, M as MetaPixelEnvironmentMap, h as ConsentState, f as ConsentChoiceState, g as ConsentSource, T as TrackingParams, b as TrackingEnvironment, s as PhoneConfig, P as ParsedPhone, t as PhoneDisplayFormat } from './phone-utils-D2TGPCQW.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-Bw2ImtPd.js';
+import { a7 as TriggerRegistryConfig, a9 as TypedTrackingClient, a as BookingHandoffPrefill, b as BookingIntegration, B as BookableDay } from './submit-DuvP5AGN.js';
+export { ai as createLeadFormSubmit } from './submit-DuvP5AGN.js';
 import { CountryCode } from 'libphonenumber-js';
-import './form-submit-CX-CxJjQ.js';
+import './form-submit-C_vJXCxh.js';
 import 'zod/mini';
 import 'zod/v4/core';