@aranova/tracking-react 1.13.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

package/dist/{bookings-C1HMPjQl.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;

package/dist/{bookings-CHpplXU7.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;

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-CHpplXU7.mjs';
-import { X as TriggerRegistryConfig, Z as TypedTrackingClient, a as BookingHandoffPrefill, b as BookingIntegration, B as BookableDay } from './ingest-typed-Ckt4R731.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-C1HMPjQl.js';
-import { X as TriggerRegistryConfig, Z as TypedTrackingClient, a as BookingHandoffPrefill, b as BookingIntegration, B as BookableDay } from './ingest-typed-sCDoPInT.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';