@aranova/tracking-react 1.9.0 → 1.10.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-CUes6H05.d.mts}

@@ -284,6 +284,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 +422,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-D5TT6D8w.d.ts}

@@ -284,6 +284,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 +422,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,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-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 { 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-CUes6H05.mjs';
+import { X as TriggerRegistryConfig, Z as TypedTrackingClient, a as BookingHandoffPrefill, b as BookingIntegration, B as BookableDay } from './ingest-typed-CfjE2F18.mjs';
 import { CountryCode } from 'libphonenumber-js';
 import './form-submit-BLb28aCk.mjs';
 import 'zod/mini';
@@ -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,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-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 { 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-D5TT6D8w.js';
+import { X as TriggerRegistryConfig, Z as TypedTrackingClient, a as BookingHandoffPrefill, b as BookingIntegration, B as BookableDay } from './ingest-typed-CNeWyI0U.js';
 import { CountryCode } from 'libphonenumber-js';
 import './form-submit-BLb28aCk.js';
 import 'zod/mini';
@@ -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

@@ -4009,7 +4009,7 @@ function GoogleAdsTracking(props) {
 var import_react6 = require("react");
 
 // package.json
-var version = "1.9.0";
+var version = "1.10.0";
 
 // ../tracking-core/src/phone-react.tsx
 var import_react5 = require("react");