@aranova/tracking-react 1.9.0 → 1.11.0

package/README.md

@@ -366,11 +366,15 @@ await submit({
   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`, or for extra notes):
-  `updateBooking({ vehicle, notes })` from the same hook. It resolves `updated` / `queued` /
+- Details after booking (when `booking.rules.vehicleDeferred`, for extra notes, or for the site's
+  own "How did you hear about us?" answer):
+  `updateBooking({ vehicle, notes, heardVia })` from the same hook. It resolves `updated` / `queued` /
   `notified_owner` (all saved) or `invalid`, `mismatch`, `conflict`, `not_found`, `failed`
   (only `failed` is worth a retry). To survive a reload, save `booked` (`{ bookingId, attemptKey }`)
-  in `sessionStorage` and pass it back: `updateBooking(details, saved)`.
+  in `sessionStorage` and pass it back: `updateBooking(details, saved)`. `heardVia` is reporting-only
+  and never reaches the shop; it takes the same values as the form's `heardVia` `form_submit` field,
+  so asking it on the success screen instead of the form reports the same. One update per booking,
+  so send it with a deferred vehicle rather than in a second call.
 - Reports the `booking_integration` capability.
 
 ## On-site conversion firing

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

@@ -1,4 +1,4 @@
-import { a as FormSubmitMetadata } from './form-submit-BLb28aCk.mjs';
+import { a as FormSubmitMetadata } from './form-submit-CX-CxJjQ.mjs';
 
 interface ServiceFiring {
     send_to: string;
@@ -45,6 +45,12 @@ interface ConversionConfig {
     linked_hostnames?: string[];
     /** Third-party integrations the site renders UI for; a missing provider means none. */
     integrations?: ConversionIntegrations;
+    /** The lead-form contract (ADR-0024); null from an API that predates it. */
+    lead_forms?: LeadFormsConfig | null;
+}
+interface LeadFormsConfig {
+    /** The registry version the object was published under. */
+    registry_version: number;
 }
 /** Bookable start hours on one weekday, shop wall time (8 = 08:00); both empty = closed. */
 interface BookingDayWindows {
@@ -284,6 +290,12 @@ interface BookingDetailsInput {
         model: string;
     } | null;
     notes?: string | null;
+    /**
+     * The site's own "How did you hear about us?" answer, verbatim — the same values the form's
+     * `form_submit` `heardVia` field carries, so one answer reports the same whether it is asked
+     * on the form or on the success screen. Ours for reporting: never sent to the shop.
+     */
+    heardVia?: string | null;
 }
 interface BookingDetailsOptions {
     /** The `attemptKey` the booking was submitted with; only that submit may add to it. */
@@ -416,8 +428,9 @@ interface SalesBookingsClient {
     /** A booking's current status by the id `submit` returned. */
     status(id: string): Promise<BookingOutcome>;
     /**
-     * Add the vehicle or notes after booking (e.g. `rules.vehicleDeferred`). Pass the booking's
-     * own `attemptKey`. Never rejects: they reach the shop's request, or the owner by text.
+     * Add the vehicle, notes or "How did you hear about us?" after booking (e.g.
+     * `rules.vehicleDeferred`, or an answer asked on the success screen). Pass the booking's own
+     * `attemptKey`. Never rejects: they reach the shop's request, or the owner by text.
      */
     updateBooking(bookingId: string, details: BookingDetailsInput, options: BookingDetailsOptions): Promise<BookingDetailsOutcome>;
 }

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

@@ -1,4 +1,4 @@
-import { a as FormSubmitMetadata } from './form-submit-BLb28aCk.js';
+import { a as FormSubmitMetadata } from './form-submit-CX-CxJjQ.js';
 
 interface ServiceFiring {
     send_to: string;
@@ -45,6 +45,12 @@ interface ConversionConfig {
     linked_hostnames?: string[];
     /** Third-party integrations the site renders UI for; a missing provider means none. */
     integrations?: ConversionIntegrations;
+    /** The lead-form contract (ADR-0024); null from an API that predates it. */
+    lead_forms?: LeadFormsConfig | null;
+}
+interface LeadFormsConfig {
+    /** The registry version the object was published under. */
+    registry_version: number;
 }
 /** Bookable start hours on one weekday, shop wall time (8 = 08:00); both empty = closed. */
 interface BookingDayWindows {
@@ -284,6 +290,12 @@ interface BookingDetailsInput {
         model: string;
     } | null;
     notes?: string | null;
+    /**
+     * The site's own "How did you hear about us?" answer, verbatim — the same values the form's
+     * `form_submit` `heardVia` field carries, so one answer reports the same whether it is asked
+     * on the form or on the success screen. Ours for reporting: never sent to the shop.
+     */
+    heardVia?: string | null;
 }
 interface BookingDetailsOptions {
     /** The `attemptKey` the booking was submitted with; only that submit may add to it. */
@@ -416,8 +428,9 @@ interface SalesBookingsClient {
     /** A booking's current status by the id `submit` returned. */
     status(id: string): Promise<BookingOutcome>;
     /**
-     * Add the vehicle or notes after booking (e.g. `rules.vehicleDeferred`). Pass the booking's
-     * own `attemptKey`. Never rejects: they reach the shop's request, or the owner by text.
+     * Add the vehicle, notes or "How did you hear about us?" after booking (e.g.
+     * `rules.vehicleDeferred`, or an answer asked on the success screen). Pass the booking's own
+     * `attemptKey`. Never rejects: they reach the shop's request, or the owner by text.
      */
     updateBooking(bookingId: string, details: BookingDetailsInput, options: BookingDetailsOptions): Promise<BookingDetailsOutcome>;
 }

package/dist/client.d.mts

@@ -1,10 +1,10 @@
 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-CM8eUPz8.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-DtcwdM_I.mjs';
-import { X as TriggerRegistryConfig, Z as TypedTrackingClient, a as BookingHandoffPrefill, b as BookingIntegration, B as BookableDay } from './ingest-typed-C2OvZ7dp.mjs';
+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 { CountryCode } from 'libphonenumber-js';
-import './form-submit-BLb28aCk.mjs';
+import './form-submit-CX-CxJjQ.mjs';
 import 'zod/mini';
 import 'zod/v4/core';
 
@@ -418,8 +418,8 @@ interface BookingSubmitState {
      */
     booked: BookedAttempt | null;
     /**
-     * Add the vehicle or notes to `booked`, or to `target` (a persisted one). Resolves `not_found`
-     * when there is neither.
+     * Add the vehicle, notes or "How did you hear about us?" to `booked`, or to `target` (a
+     * persisted one). Resolves `not_found` when there is neither.
      */
     updateBooking(details: BookingDetailsInput, target?: BookedAttempt): Promise<BookingDetailsOutcome>;
     /** Back to `idle` with a fresh attempt key, e.g. "book another car". */

package/dist/client.d.ts

@@ -1,10 +1,10 @@
 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-l8ey3Zdm.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-Bx7totlS.js';
-import { X as TriggerRegistryConfig, Z as TypedTrackingClient, a as BookingHandoffPrefill, b as BookingIntegration, B as BookableDay } from './ingest-typed-B-BgEZdW.js';
+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 { CountryCode } from 'libphonenumber-js';
-import './form-submit-BLb28aCk.js';
+import './form-submit-CX-CxJjQ.js';
 import 'zod/mini';
 import 'zod/v4/core';
 
@@ -418,8 +418,8 @@ interface BookingSubmitState {
      */
     booked: BookedAttempt | null;
     /**
-     * Add the vehicle or notes to `booked`, or to `target` (a persisted one). Resolves `not_found`
-     * when there is neither.
+     * Add the vehicle, notes or "How did you hear about us?" to `booked`, or to `target` (a
+     * persisted one). Resolves `not_found` when there is neither.
      */
     updateBooking(details: BookingDetailsInput, target?: BookedAttempt): Promise<BookingDetailsOutcome>;
     /** Back to `idle` with a fresh attempt key, e.g. "book another car". */

package/dist/client.js

@@ -1128,9 +1128,15 @@ function parseConversionConfig(raw) {
     services,
     goals,
     linked_hostnames: Array.isArray(obj.linked_hostnames) ? obj.linked_hostnames.filter((h) => typeof h === "string" && h.length > 0) : [],
-    integrations: parseIntegrations(obj.integrations)
+    integrations: parseIntegrations(obj.integrations),
+    lead_forms: parseLeadForms(obj.lead_forms)
   };
 }
+function parseLeadForms(value) {
+  if (!value || typeof value !== "object") return null;
+  const version2 = value.registry_version;
+  return typeof version2 === "number" ? { registry_version: version2 } : null;
+}
 var CACHE_PREFIX = "_aranova_cfg_";
 function cacheKey(url) {
   return `${CACHE_PREFIX}${url}`;
@@ -2711,6 +2717,7 @@ 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 formSubmitMetadataSchema = z7.strictObject({
   form: z7.strictObject({
     id: z7.string(),
@@ -2721,9 +2728,24 @@ var formSubmitMetadataSchema = z7.strictObject({
           name: z7.string(),
           type: z7.string(),
           label: z7.nullable(z7.string()),
-          value: jsonValueSchema
+          value: jsonValueSchema,
+          role: z7.optional(z7.nullable(contractName))
         })
       )
+    ),
+    kind: z7.optional(z7.nullable(contractName)),
+    contract_version: z7.optional(z7.nullable(z7.int().check(z7.gte(1)))),
+    contract_hash: z7.optional(z7.nullable(z7.string().check(z7.maxLength(64)))),
+    extra: z7.optional(
+      z7.nullable(
+        z7.array(
+          z7.strictObject({
+            key: z7.string().check(z7.maxLength(64)),
+            label: z7.string().check(z7.maxLength(200)),
+            value: jsonValueSchema
+          })
+        ).check(z7.maxLength(20))
+      )
     )
   }),
   page: z7.strictObject({
@@ -4009,7 +4031,7 @@ function GoogleAdsTracking(props) {
 var import_react6 = require("react");
 
 // package.json
-var version = "1.9.0";
+var version = "1.11.0";
 
 // ../tracking-core/src/phone-react.tsx
 var import_react5 = require("react");