@aranova/tracking-react 1.2.5 → 1.4.0

package/README.md

@@ -278,6 +278,83 @@ npx @aranova/tracking-cli gen          # reads ARANOVA_TRACKING_SECRET_KEY from
 See the full guide: [sales-tracking.md](https://github.com/AranovaIO/aranova_internal/blob/master/docs/tracking-package/sales-tracking.md)
 and the CLI reference: [cli.md](https://github.com/AranovaIO/aranova_internal/blob/master/docs/tracking-package/cli.md).
 
+## Booking handoff (booking integrations)
+
+When the business books through an integration (AutoLeap today), the published tracking config
+carries `integrations.autoleap.booking`. After a lead form's successful submit (and after
+`form_submit` fires), offer the optional "Pick your time" step:
+
+```tsx
+import { BookingHandoffLink } from "@aranova/tracking-react";
+import { ARANOVA_TRACKING_CONFIG } from "@/aranova-services";
+
+<BookingHandoffLink
+  trackingConfig={ARANOVA_TRACKING_CONFIG}
+  fallbackUrl="https://myalp.io/…" // baked last resort when no config has loaded
+  prefill={{ firstName, lastName, phone, email }}
+>
+  Pick your time
+</BookingHandoffLink>;
+```
+
+- The link is the shop's own booking page from the live config, else `fallbackUrl`; it renders
+  nothing unless it is `https://myalp.io/…`. The phone goes out as digits.
+- It shows even when `enabled` is false: the customer always has a way to book.
+- `useBookingIntegration(trackingConfig)` returns the live provider (or null before a config
+  loads), from the shared config runtime (no extra fetch): `enabled`, `fallbackUrl`,
+  `acceptsBookings`, `timezone`, `configVersion`, `rules` and `options`.
+  `getBookingIntegration(integrations)` and `buildBookingHandoffUrl(url, prefill)` are the
+  React-free equivalents.
+- Reports the `booking_handoff` capability.
+
+## Website bookings (booking integrations)
+
+When `acceptsBookings` is true the site can book straight into the shop's system through Aranova's
+API. The SDK is headless; build the form in the site's own design system:
+
+```tsx
+import { useBookingIntegration, useBookingSlots, useBookingSubmit } from "@aranova/tracking-react";
+
+const booking = useBookingIntegration(ARANOVA_TRACKING_CONFIG);
+const days = useBookingSlots(ARANOVA_TRACKING_CONFIG); // [{ date, weekday, morning, afternoon }]
+const { status, outcome, submit } = useBookingSubmit(conversions.bookings, {
+  formSubmit: { tracking, formId: "booking-form" },
+});
+
+await submit({
+  startDate: "2026-10-06",
+  startHour: 9,
+  firstName,
+  lastName,
+  phone,
+  email,
+  vehicle: { year: 2019, make: "Toyota", model: "RAV4" },
+  dropOff: "dropOff", // only when booking.rules.dropOffOptions is non-empty
+  services: ["brakes"], // keys from booking.options
+  notes,
+  marketingSmsConsent, // the customer's own unchecked opt-in; never default it on
+});
+```
+
+- `conversions` is the site's one `createSalesClient({ apiKey, endpoint, firing: getTrackingConfigRuntime(...) })`;
+  `.bookings` reads the rules from that runtime.
+- `outcome.status`: `created` (the shop texts and emails the customer itself; send nothing of
+  your own), `pending` (same success; still being sent, the owner is alerted if it fails),
+  `failed` (success copy plus `outcome.fallbackUrl`, the prefilled shop page), `invalid`
+  (`outcome.message`, nothing sent), `stale` (the times changed; the config is refetched).
+- `outcome.mode` (and `booking.mode` before submitting): `live` for every real customer;
+  `test` (sent to the shop's test lead source) or `simulated` (never sent) on a test visit or a
+  non-production API. Show a small "test booking" note when it isn't `live`.
+- Development only: `useBookingSubmit(bookings, { simulate: "failed" })` forces a simulated
+  outcome (`created`, `rejected`, `unknown`, `failed`) to exercise each screen. The production
+  API ignores it. Test locally against the local API **and** the local CDN; the SDK warns in the
+  console when the endpoint is localhost but the config comes from production.
+- `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.
+- Ask for the last name separately, and a mobile number (the shop's confirmation text goes to it).
+- Reports the `booking_integration` capability.
+
 ## On-site conversion firing
 
 Run `tracking-cli gen` once to emit `ARANOVA_TRACKING_CONFIG`, then use that

package/dist/{tracking-config-runtime-C6H7ofmo.d.ts → bookings-CqCuuyP6.d.mts}

@@ -1,3 +1,5 @@
+import { a as FormSubmitMetadata } from './form-submit-BLb28aCk.mjs';
+
 interface ServiceFiring {
     send_to: string;
     /** Action's configured default value (cents); the SDK fires it only when a sale has no amount. */
@@ -41,6 +43,60 @@ interface ConversionConfig {
     goals: ConversionGoal[];
     /** Sibling hostnames of this site (roster minus self); the cross-site linker's targets. */
     linked_hostnames?: string[];
+    /** Third-party integrations the site renders UI for; a missing provider means none. */
+    integrations?: ConversionIntegrations;
+}
+/** Bookable start hours on one weekday, shop wall time (8 = 08:00); both empty = closed. */
+interface BookingDayWindows {
+    morning: number[];
+    afternoon: number[];
+}
+interface BookingRulesConfig {
+    min_days_ahead: number;
+    max_days_ahead: number;
+    /** Keyed `monday` … `sunday`. */
+    hours: Record<string, BookingDayWindows>;
+    /** `YYYY-MM-DD` shop dates the portal refuses although the weekday is open. */
+    closed_dates: string[];
+    /** `YYYY-MM-DD` shop dates whose start hours replace their weekday's; never also closed. */
+    special_hours: Record<string, BookingDayWindows>;
+    vehicle_required: boolean;
+    /** Empty when the shop hides the drop-off question. */
+    drop_off_options: string[];
+}
+/** One service choice on the site's booking form; the shop system's ids stay server-side. */
+interface BookingOptionConfig {
+    /** What the site posts in `services`. */
+    key: string;
+    label: string;
+}
+/** Where a booking went; decided by the API. A real customer always gets `live`. */
+declare const BOOKING_MODES: readonly ["live", "test", "simulated"];
+/**
+ * `live`: the shop's real queue. `test`: a real request on the shop's test lead source, never
+ * counted. `simulated`: never sent; nothing reached the shop or the customer.
+ */
+type BookingMode = (typeof BOOKING_MODES)[number];
+/** `integrations.autoleap.booking` — never carries a secret. */
+interface AutoLeapBookingConfig {
+    /** False: show only `fallback_url`. The site never blocks the customer on it. */
+    enabled: boolean;
+    /** The shop's own booking page; always present. */
+    fallback_url: string;
+    timezone: string;
+    /** Snapshot the rules came from; null before the first one. */
+    config_version: number | null;
+    /** `enabled` and at least one option mapped: the site may post a booking. */
+    accepts_bookings: boolean;
+    rules: BookingRulesConfig | null;
+    options: BookingOptionConfig[];
+    /** Development objects only: `test` or `simulated`, so a dev page can say so up front. */
+    mode?: BookingMode;
+}
+interface ConversionIntegrations {
+    autoleap?: {
+        booking: AutoLeapBookingConfig;
+    };
 }
 interface ConversionConfigStore {
     /** Firing config for a goal/service key, or null when it doesn't fire on-site. */
@@ -190,6 +246,11 @@ declare class TrackingConfigRuntime {
     listGoals(): ConversionGoal[];
     /** Sibling hostnames for the linker — read from the cached object even while unconfirmed. */
     linkedHostnames(): readonly string[];
+    /**
+     * Integration blocks, from the cached object even while unconfirmed: the booking fallback
+     * link is safe to show stale. Same reference until the next adopt, for `useSyncExternalStore`.
+     */
+    integrations(): ConversionIntegrations | null;
     private revalidateNow;
     private expireAuthority;
     private confirm;
@@ -199,4 +260,107 @@ declare class TrackingConfigRuntime {
 }
 declare function getTrackingConfigRuntime(ref: TrackingConfigReference, fetchImpl?: typeof fetch): TrackingConfigRuntime;
 
-export { type ConversionConfig as C, type TrackingConfigReference as T, type ConversionConfigStore as a, resolveTrackingConfigUrl as b, TrackingConfigRuntime as c, getTrackingConfigRuntime as g, resolveConversionConfig as r };
+/** A UUID v4 from Web Crypto, with a `getRandomValues` (then `Math.random`) fallback. */
+declare function uuidV4(): string;
+
+/** Developer-only outcomes for a simulated create; the production API ignores them. */
+declare const BOOKING_SIMULATIONS: readonly ["created", "rejected", "unknown", "failed"];
+declare const BOOKING_DROP_OFF_OPTIONS: readonly ["waitForIt", "dropOff"];
+type BookingDropOff = (typeof BOOKING_DROP_OFF_OPTIONS)[number];
+type BookingSimulation = (typeof BOOKING_SIMULATIONS)[number];
+/** What the booking form collected. Dates and hours are the shop's wall time. */
+interface BookingInput {
+    /** `YYYY-MM-DD`, one of `bookableSlots(...)`'s dates. */
+    startDate: string;
+    /** A start hour offered on that date (8 = 08:00). */
+    startHour: number;
+    firstName: string;
+    /** Required: the shop's system needs it, and a single-word name has none to split off. */
+    lastName: string;
+    /** Mobile number; the shop texts its confirmation to it. */
+    phone: string;
+    email?: string | null;
+    vehicle?: {
+        year: number;
+        make: string;
+        model: string;
+    } | null;
+    /** Ask only when the rules list drop-off options. */
+    dropOff?: BookingDropOff | null;
+    /** Option keys from `useBookingIntegration(...).options`. */
+    services: string[];
+    notes?: string | null;
+    /**
+     * The customer's own opt-in to marketing texts. Never default it on (CASL). Service texts
+     * about this booking need no opt-in and are always on.
+     */
+    marketingSmsConsent?: boolean;
+}
+/** The form's `form_submit`, sent once per booking attempt and tied to this visit. */
+interface BookingFormSubmit {
+    /** The site's tracking client (`useTracking()`): the booking takes the visit it reports. */
+    tracking: {
+        trackEvent(eventType: "form_submit", metadata: FormSubmitMetadata): void;
+        getSessionId(): string;
+    };
+    /** The `<form id>`, so `form_start` and `form_submit` line up. */
+    formId: string;
+}
+type BookingOutcome = 
+/** The shop has the request; it texts and emails the customer itself. */
+{
+    status: "created";
+    id: string;
+    requestCode: string | null;
+    mode: BookingMode;
+}
+/** Received and still being sent; the shop confirms. Show the same success. */
+ | {
+    status: "pending";
+    id: string;
+    mode: BookingMode;
+}
+/**
+ * Not created. Still a success for the customer: show the prefilled shop booking link.
+ * `id` is null when the booking never reached Aranova (offline, rate-limited, booking off).
+ */
+ | {
+    status: "failed";
+    id: string | null;
+    fallbackUrl: string | null;
+    mode: BookingMode;
+}
+/** The booking breaks the shop's rules; `message` is customer-safe. Nothing was sent. */
+ | {
+    status: "invalid";
+    message: string;
+    reasons: string[];
+}
+/** The shop's times changed since the form loaded; the config is being refetched. */
+ | {
+    status: "stale";
+    message: string;
+};
+interface BookingSubmitOptions {
+    attemptKey: string;
+    formSubmit?: BookingFormSubmit;
+    /**
+     * Development only: force a simulated create's outcome to exercise the success, pending and
+     * fallback screens. The production API ignores it, so it can never change a real booking.
+     */
+    simulate?: BookingSimulation;
+}
+interface SalesBookingsClient {
+    /**
+     * Send one booking. Never rejects for an API outcome: every answer is a {@link BookingOutcome}.
+     * Pass the same `attemptKey` (a UUID, `newBookingAttemptKey()`) on a retry of the same submit,
+     * so a double-click or a network retry can never book twice.
+     */
+    submit(input: BookingInput, options: BookingSubmitOptions): Promise<BookingOutcome>;
+    /** A booking's current status by the id `submit` returned. */
+    status(id: string): Promise<BookingOutcome>;
+}
+/** A fresh per-submit key. Keep it for retries of the same submit; mint a new one after. */
+declare const newBookingAttemptKey: typeof uuidV4;
+
+export { type BookingDropOff as B, type ConversionConfig as C, type SalesBookingsClient as S, type TrackingConfigReference as T, type BookingFormSubmit as a, type BookingInput as b, type BookingMode as c, type BookingOutcome as d, type BookingSimulation as e, type BookingSubmitOptions as f, type ConversionConfigStore as g, getTrackingConfigRuntime as h, resolveTrackingConfigUrl as i, type BookingDayWindows as j, type ConversionIntegrations as k, TrackingConfigRuntime as l, newBookingAttemptKey as n, resolveConversionConfig as r };

package/dist/{tracking-config-runtime-C6H7ofmo.d.mts → bookings-DIu1ho6v.d.ts}

@@ -1,3 +1,5 @@
+import { a as FormSubmitMetadata } from './form-submit-BLb28aCk.js';
+
 interface ServiceFiring {
     send_to: string;
     /** Action's configured default value (cents); the SDK fires it only when a sale has no amount. */
@@ -41,6 +43,60 @@ interface ConversionConfig {
     goals: ConversionGoal[];
     /** Sibling hostnames of this site (roster minus self); the cross-site linker's targets. */
     linked_hostnames?: string[];
+    /** Third-party integrations the site renders UI for; a missing provider means none. */
+    integrations?: ConversionIntegrations;
+}
+/** Bookable start hours on one weekday, shop wall time (8 = 08:00); both empty = closed. */
+interface BookingDayWindows {
+    morning: number[];
+    afternoon: number[];
+}
+interface BookingRulesConfig {
+    min_days_ahead: number;
+    max_days_ahead: number;
+    /** Keyed `monday` … `sunday`. */
+    hours: Record<string, BookingDayWindows>;
+    /** `YYYY-MM-DD` shop dates the portal refuses although the weekday is open. */
+    closed_dates: string[];
+    /** `YYYY-MM-DD` shop dates whose start hours replace their weekday's; never also closed. */
+    special_hours: Record<string, BookingDayWindows>;
+    vehicle_required: boolean;
+    /** Empty when the shop hides the drop-off question. */
+    drop_off_options: string[];
+}
+/** One service choice on the site's booking form; the shop system's ids stay server-side. */
+interface BookingOptionConfig {
+    /** What the site posts in `services`. */
+    key: string;
+    label: string;
+}
+/** Where a booking went; decided by the API. A real customer always gets `live`. */
+declare const BOOKING_MODES: readonly ["live", "test", "simulated"];
+/**
+ * `live`: the shop's real queue. `test`: a real request on the shop's test lead source, never
+ * counted. `simulated`: never sent; nothing reached the shop or the customer.
+ */
+type BookingMode = (typeof BOOKING_MODES)[number];
+/** `integrations.autoleap.booking` — never carries a secret. */
+interface AutoLeapBookingConfig {
+    /** False: show only `fallback_url`. The site never blocks the customer on it. */
+    enabled: boolean;
+    /** The shop's own booking page; always present. */
+    fallback_url: string;
+    timezone: string;
+    /** Snapshot the rules came from; null before the first one. */
+    config_version: number | null;
+    /** `enabled` and at least one option mapped: the site may post a booking. */
+    accepts_bookings: boolean;
+    rules: BookingRulesConfig | null;
+    options: BookingOptionConfig[];
+    /** Development objects only: `test` or `simulated`, so a dev page can say so up front. */
+    mode?: BookingMode;
+}
+interface ConversionIntegrations {
+    autoleap?: {
+        booking: AutoLeapBookingConfig;
+    };
 }
 interface ConversionConfigStore {
     /** Firing config for a goal/service key, or null when it doesn't fire on-site. */
@@ -190,6 +246,11 @@ declare class TrackingConfigRuntime {
     listGoals(): ConversionGoal[];
     /** Sibling hostnames for the linker — read from the cached object even while unconfirmed. */
     linkedHostnames(): readonly string[];
+    /**
+     * Integration blocks, from the cached object even while unconfirmed: the booking fallback
+     * link is safe to show stale. Same reference until the next adopt, for `useSyncExternalStore`.
+     */
+    integrations(): ConversionIntegrations | null;
     private revalidateNow;
     private expireAuthority;
     private confirm;
@@ -199,4 +260,107 @@ declare class TrackingConfigRuntime {
 }
 declare function getTrackingConfigRuntime(ref: TrackingConfigReference, fetchImpl?: typeof fetch): TrackingConfigRuntime;
 
-export { type ConversionConfig as C, type TrackingConfigReference as T, type ConversionConfigStore as a, resolveTrackingConfigUrl as b, TrackingConfigRuntime as c, getTrackingConfigRuntime as g, resolveConversionConfig as r };
+/** A UUID v4 from Web Crypto, with a `getRandomValues` (then `Math.random`) fallback. */
+declare function uuidV4(): string;
+
+/** Developer-only outcomes for a simulated create; the production API ignores them. */
+declare const BOOKING_SIMULATIONS: readonly ["created", "rejected", "unknown", "failed"];
+declare const BOOKING_DROP_OFF_OPTIONS: readonly ["waitForIt", "dropOff"];
+type BookingDropOff = (typeof BOOKING_DROP_OFF_OPTIONS)[number];
+type BookingSimulation = (typeof BOOKING_SIMULATIONS)[number];
+/** What the booking form collected. Dates and hours are the shop's wall time. */
+interface BookingInput {
+    /** `YYYY-MM-DD`, one of `bookableSlots(...)`'s dates. */
+    startDate: string;
+    /** A start hour offered on that date (8 = 08:00). */
+    startHour: number;
+    firstName: string;
+    /** Required: the shop's system needs it, and a single-word name has none to split off. */
+    lastName: string;
+    /** Mobile number; the shop texts its confirmation to it. */
+    phone: string;
+    email?: string | null;
+    vehicle?: {
+        year: number;
+        make: string;
+        model: string;
+    } | null;
+    /** Ask only when the rules list drop-off options. */
+    dropOff?: BookingDropOff | null;
+    /** Option keys from `useBookingIntegration(...).options`. */
+    services: string[];
+    notes?: string | null;
+    /**
+     * The customer's own opt-in to marketing texts. Never default it on (CASL). Service texts
+     * about this booking need no opt-in and are always on.
+     */
+    marketingSmsConsent?: boolean;
+}
+/** The form's `form_submit`, sent once per booking attempt and tied to this visit. */
+interface BookingFormSubmit {
+    /** The site's tracking client (`useTracking()`): the booking takes the visit it reports. */
+    tracking: {
+        trackEvent(eventType: "form_submit", metadata: FormSubmitMetadata): void;
+        getSessionId(): string;
+    };
+    /** The `<form id>`, so `form_start` and `form_submit` line up. */
+    formId: string;
+}
+type BookingOutcome = 
+/** The shop has the request; it texts and emails the customer itself. */
+{
+    status: "created";
+    id: string;
+    requestCode: string | null;
+    mode: BookingMode;
+}
+/** Received and still being sent; the shop confirms. Show the same success. */
+ | {
+    status: "pending";
+    id: string;
+    mode: BookingMode;
+}
+/**
+ * Not created. Still a success for the customer: show the prefilled shop booking link.
+ * `id` is null when the booking never reached Aranova (offline, rate-limited, booking off).
+ */
+ | {
+    status: "failed";
+    id: string | null;
+    fallbackUrl: string | null;
+    mode: BookingMode;
+}
+/** The booking breaks the shop's rules; `message` is customer-safe. Nothing was sent. */
+ | {
+    status: "invalid";
+    message: string;
+    reasons: string[];
+}
+/** The shop's times changed since the form loaded; the config is being refetched. */
+ | {
+    status: "stale";
+    message: string;
+};
+interface BookingSubmitOptions {
+    attemptKey: string;
+    formSubmit?: BookingFormSubmit;
+    /**
+     * Development only: force a simulated create's outcome to exercise the success, pending and
+     * fallback screens. The production API ignores it, so it can never change a real booking.
+     */
+    simulate?: BookingSimulation;
+}
+interface SalesBookingsClient {
+    /**
+     * Send one booking. Never rejects for an API outcome: every answer is a {@link BookingOutcome}.
+     * Pass the same `attemptKey` (a UUID, `newBookingAttemptKey()`) on a retry of the same submit,
+     * so a double-click or a network retry can never book twice.
+     */
+    submit(input: BookingInput, options: BookingSubmitOptions): Promise<BookingOutcome>;
+    /** A booking's current status by the id `submit` returned. */
+    status(id: string): Promise<BookingOutcome>;
+}
+/** A fresh per-submit key. Keep it for retries of the same submit; mint a new one after. */
+declare const newBookingAttemptKey: typeof uuidV4;
+
+export { type BookingDropOff as B, type ConversionConfig as C, type SalesBookingsClient as S, type TrackingConfigReference as T, type BookingFormSubmit as a, type BookingInput as b, type BookingMode as c, type BookingOutcome as d, type BookingSimulation as e, type BookingSubmitOptions as f, type ConversionConfigStore as g, getTrackingConfigRuntime as h, resolveTrackingConfigUrl as i, type BookingDayWindows as j, type ConversionIntegrations as k, TrackingConfigRuntime as l, newBookingAttemptKey as n, resolveConversionConfig as r };

package/dist/client.d.mts

@@ -1,9 +1,10 @@
 import * as react from 'react';
-import { ReactNode, CSSProperties, InputHTMLAttributes, ChangeEvent, FocusEvent } from 'react';
-import { G as GtagEnvironmentMap, M as MetaPixelEnvironmentMap, h as ConsentState, f as ConsentChoiceState, g as ConsentSource, T as TrackingParams, b as TrackingEnvironment, k as PhoneConfig, P as ParsedPhone, l as PhoneDisplayFormat } from './phone-utils-qLfVpQI7.mjs';
-import { T as TrackingConfigReference, C as ConversionConfig } from './tracking-config-runtime-C6H7ofmo.mjs';
-import { L as TriggerRegistryConfig, O as TypedTrackingClient } from './ingest-typed-oAwnKqH2.mjs';
+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, d as BookingOutcome, b as BookingInput, S as SalesBookingsClient, a as BookingFormSubmit, e as BookingSimulation } from './bookings-CqCuuyP6.mjs';
+import { W as TriggerRegistryConfig, Y as TypedTrackingClient, a as BookingHandoffPrefill, b as BookingIntegration, B as BookableDay } from './ingest-typed-D7UZr0EM.mjs';
 import { CountryCode } from 'libphonenumber-js';
+import './form-submit-BLb28aCk.mjs';
 import 'zod/mini';
 import 'zod/v4/core';
 
@@ -369,4 +370,56 @@ interface PhoneFieldProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "t
  */
 declare const PhoneField: react.ForwardRefExoticComponent<PhoneFieldProps & react.RefAttributes<HTMLInputElement>>;
 
-export { AdPlatformTracking, type AdPlatformTrackingProps, ConsentBanner, type ConsentBannerProps, type CreateTrackingOptions, type CreateTrackingResult, GoogleAdsTracking, type GoogleAdsTrackingProps, PhoneField, type PhoneFieldApi, type PhoneFieldProps, type PhoneInputProps, type TrackingProviderProps, type UseConsentResult, type UseCookiePreferencesOptions, type UseCookiePreferencesResult, type UsePhoneFieldOptions, createTracking, useConsent, useConsentState, useCookiePreferences, useGclid, usePhoneConfig, usePhoneField, useTrackingParams };
+/**
+ * The site's booking provider from the live runtime config, or null before one loads.
+ *
+ * Pass the same `ARANOVA_TRACKING_CONFIG` reference given to `createTracking`; the config
+ * runtime is shared, so this adds no fetch.
+ */
+declare function useBookingIntegration(trackingConfig: TrackingConfigReference | undefined): BookingIntegration | null;
+interface BookingHandoffOptions {
+    /** Baked copy of the booking link, used when no runtime config has loaded. */
+    fallbackUrl?: string;
+    prefill?: BookingHandoffPrefill;
+}
+/**
+ * The prefilled handoff URL, or null when neither the runtime config nor `fallbackUrl` names a
+ * usable link. For sites that render the link with their own button component.
+ */
+declare function useBookingHandoffUrl(trackingConfig: TrackingConfigReference | undefined, { fallbackUrl, prefill }?: BookingHandoffOptions): string | null;
+interface BookingHandoffLinkProps extends Omit<AnchorHTMLAttributes<HTMLAnchorElement>, "href">, BookingHandoffOptions {
+    trackingConfig?: TrackingConfigReference;
+    children: ReactNode;
+}
+/**
+ * The optional "pick your time" step after a form submit: the shop's booking page, prefilled.
+ * Renders nothing when neither the runtime config nor `fallbackUrl` names a usable link.
+ */
+declare function BookingHandoffLink({ trackingConfig, fallbackUrl, prefill, children, target, rel, ...anchorProps }: BookingHandoffLinkProps): ReactNode;
+/**
+ * Every bookable day and its start hours, split morning / afternoon, from the live rules.
+ * Empty until the config loads or when the shop takes no online bookings. Recomputed each
+ * render (cheap), so a tab left open past midnight never offers yesterday's notice window.
+ */
+declare function useBookingSlots(trackingConfig: TrackingConfigReference | undefined): BookableDay[];
+type BookingSubmitStatus = "idle" | "submitting" | BookingOutcome["status"];
+interface BookingSubmitState {
+    status: BookingSubmitStatus;
+    outcome: BookingOutcome | null;
+    /** Send the booking. A retry of an unanswered or refused submit reuses its attempt key. */
+    submit(input: BookingInput): Promise<BookingOutcome>;
+    /** Back to `idle` with a fresh attempt key, e.g. "book another car". */
+    reset(): void;
+}
+/**
+ * Submit state for a booking form over `salesClient.bookings`. Owns the parts that are easy to
+ * get wrong: one attempt key per submit (a double-click never books twice), the visit's
+ * `form_submit`, the stale-config refetch, and the fallback link on failure.
+ */
+declare function useBookingSubmit(bookings: SalesBookingsClient, options?: {
+    formSubmit?: BookingFormSubmit;
+    /** Development only: a simulated create's outcome. The production API ignores it. */
+    simulate?: BookingSimulation;
+}): BookingSubmitState;
+
+export { AdPlatformTracking, type AdPlatformTrackingProps, BookingHandoffLink, type BookingHandoffLinkProps, type BookingHandoffOptions, type BookingSubmitState, type BookingSubmitStatus, ConsentBanner, type ConsentBannerProps, type CreateTrackingOptions, type CreateTrackingResult, GoogleAdsTracking, type GoogleAdsTrackingProps, PhoneField, type PhoneFieldApi, type PhoneFieldProps, type PhoneInputProps, type TrackingProviderProps, type UseConsentResult, type UseCookiePreferencesOptions, type UseCookiePreferencesResult, type UsePhoneFieldOptions, createTracking, useBookingHandoffUrl, useBookingIntegration, useBookingSlots, useBookingSubmit, useConsent, useConsentState, useCookiePreferences, useGclid, usePhoneConfig, usePhoneField, useTrackingParams };

package/dist/client.d.ts

@@ -1,9 +1,10 @@
 import * as react from 'react';
-import { ReactNode, CSSProperties, InputHTMLAttributes, ChangeEvent, FocusEvent } from 'react';
-import { G as GtagEnvironmentMap, M as MetaPixelEnvironmentMap, h as ConsentState, f as ConsentChoiceState, g as ConsentSource, T as TrackingParams, b as TrackingEnvironment, k as PhoneConfig, P as ParsedPhone, l as PhoneDisplayFormat } from './phone-utils-qLfVpQI7.js';
-import { T as TrackingConfigReference, C as ConversionConfig } from './tracking-config-runtime-C6H7ofmo.js';
-import { L as TriggerRegistryConfig, O as TypedTrackingClient } from './ingest-typed-CUpdCtmM.js';
+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, d as BookingOutcome, b as BookingInput, S as SalesBookingsClient, a as BookingFormSubmit, e as BookingSimulation } from './bookings-DIu1ho6v.js';
+import { W as TriggerRegistryConfig, Y as TypedTrackingClient, a as BookingHandoffPrefill, b as BookingIntegration, B as BookableDay } from './ingest-typed-D2S3Kb8m.js';
 import { CountryCode } from 'libphonenumber-js';
+import './form-submit-BLb28aCk.js';
 import 'zod/mini';
 import 'zod/v4/core';
 
@@ -369,4 +370,56 @@ interface PhoneFieldProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "t
  */
 declare const PhoneField: react.ForwardRefExoticComponent<PhoneFieldProps & react.RefAttributes<HTMLInputElement>>;
 
-export { AdPlatformTracking, type AdPlatformTrackingProps, ConsentBanner, type ConsentBannerProps, type CreateTrackingOptions, type CreateTrackingResult, GoogleAdsTracking, type GoogleAdsTrackingProps, PhoneField, type PhoneFieldApi, type PhoneFieldProps, type PhoneInputProps, type TrackingProviderProps, type UseConsentResult, type UseCookiePreferencesOptions, type UseCookiePreferencesResult, type UsePhoneFieldOptions, createTracking, useConsent, useConsentState, useCookiePreferences, useGclid, usePhoneConfig, usePhoneField, useTrackingParams };
+/**
+ * The site's booking provider from the live runtime config, or null before one loads.
+ *
+ * Pass the same `ARANOVA_TRACKING_CONFIG` reference given to `createTracking`; the config
+ * runtime is shared, so this adds no fetch.
+ */
+declare function useBookingIntegration(trackingConfig: TrackingConfigReference | undefined): BookingIntegration | null;
+interface BookingHandoffOptions {
+    /** Baked copy of the booking link, used when no runtime config has loaded. */
+    fallbackUrl?: string;
+    prefill?: BookingHandoffPrefill;
+}
+/**
+ * The prefilled handoff URL, or null when neither the runtime config nor `fallbackUrl` names a
+ * usable link. For sites that render the link with their own button component.
+ */
+declare function useBookingHandoffUrl(trackingConfig: TrackingConfigReference | undefined, { fallbackUrl, prefill }?: BookingHandoffOptions): string | null;
+interface BookingHandoffLinkProps extends Omit<AnchorHTMLAttributes<HTMLAnchorElement>, "href">, BookingHandoffOptions {
+    trackingConfig?: TrackingConfigReference;
+    children: ReactNode;
+}
+/**
+ * The optional "pick your time" step after a form submit: the shop's booking page, prefilled.
+ * Renders nothing when neither the runtime config nor `fallbackUrl` names a usable link.
+ */
+declare function BookingHandoffLink({ trackingConfig, fallbackUrl, prefill, children, target, rel, ...anchorProps }: BookingHandoffLinkProps): ReactNode;
+/**
+ * Every bookable day and its start hours, split morning / afternoon, from the live rules.
+ * Empty until the config loads or when the shop takes no online bookings. Recomputed each
+ * render (cheap), so a tab left open past midnight never offers yesterday's notice window.
+ */
+declare function useBookingSlots(trackingConfig: TrackingConfigReference | undefined): BookableDay[];
+type BookingSubmitStatus = "idle" | "submitting" | BookingOutcome["status"];
+interface BookingSubmitState {
+    status: BookingSubmitStatus;
+    outcome: BookingOutcome | null;
+    /** Send the booking. A retry of an unanswered or refused submit reuses its attempt key. */
+    submit(input: BookingInput): Promise<BookingOutcome>;
+    /** Back to `idle` with a fresh attempt key, e.g. "book another car". */
+    reset(): void;
+}
+/**
+ * Submit state for a booking form over `salesClient.bookings`. Owns the parts that are easy to
+ * get wrong: one attempt key per submit (a double-click never books twice), the visit's
+ * `form_submit`, the stale-config refetch, and the fallback link on failure.
+ */
+declare function useBookingSubmit(bookings: SalesBookingsClient, options?: {
+    formSubmit?: BookingFormSubmit;
+    /** Development only: a simulated create's outcome. The production API ignores it. */
+    simulate?: BookingSimulation;
+}): BookingSubmitState;
+
+export { AdPlatformTracking, type AdPlatformTrackingProps, BookingHandoffLink, type BookingHandoffLinkProps, type BookingHandoffOptions, type BookingSubmitState, type BookingSubmitStatus, ConsentBanner, type ConsentBannerProps, type CreateTrackingOptions, type CreateTrackingResult, GoogleAdsTracking, type GoogleAdsTrackingProps, PhoneField, type PhoneFieldApi, type PhoneFieldProps, type PhoneInputProps, type TrackingProviderProps, type UseConsentResult, type UseCookiePreferencesOptions, type UseCookiePreferencesResult, type UsePhoneFieldOptions, createTracking, useBookingHandoffUrl, useBookingIntegration, useBookingSlots, useBookingSubmit, useConsent, useConsentState, useCookiePreferences, useGclid, usePhoneConfig, usePhoneField, useTrackingParams };