@aranova/tracking-react 1.9.0 → 1.11.0

package/dist/{form-submit-BLb28aCk.d.mts → form-submit-CX-CxJjQ.d.mts}

@@ -10,43 +10,6 @@ import * as z from 'zod/mini';
 type JsonValue = string | number | boolean | null | JsonValue[] | {
     [key: string]: JsonValue;
 };
-/**
- * Metadata for a manually fired `form_submit` event.
- *
- * Register the event with `manual: { form_submit: {} }`, then call
- * `trackEvent('form_submit', metadata)` from the host site's submit handler.
- *
- * `fields` is optional. If present, each value must be JSON-serializable. Client
- * integrations may intentionally capture raw submitted lead data (including name,
- * email, phone, address, selections, and free text) for first-party analytics and
- * lead operations. Submitted file data is supported after conversion to a
- * JSON-serializable representation; upload larger files separately and send a storage
- * reference. Never include credentials, authentication tokens, payment-card or bank
- * secrets, or private keys.
- *
- * No byte limit is enforced on this metadata, here or on the server — `fields` and its
- * values are unbounded. Keep inlined payloads small anyway: a submit fired just before
- * navigation flushes over `keepalive`, which browsers cap near 64 KB and drop silently.
- *
- * @example
- * ```ts
- * tracking.trackEvent('form_submit', {
- *   form: {
- *     id: 'lead-form',
- *     action: '/api/lead',
- *     fields: [
- *       {
- *         name: 'service_interest',
- *         type: 'select',
- *         label: 'Service interest',
- *         value: 'teeth_whitening',
- *       },
- *     ],
- *   },
- *   page: { path: window.location.pathname },
- * });
- * ```
- */
 declare const formSubmitMetadataSchema: z.ZodMiniObject<{
     form: z.ZodMiniObject<{
         id: z.ZodMiniString<string>;
@@ -56,7 +19,16 @@ declare const formSubmitMetadataSchema: z.ZodMiniObject<{
             type: z.ZodMiniString<string>;
             label: z.ZodMiniNullable<z.ZodMiniString<string>>;
             value: z.ZodMiniType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+            role: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniString<string>>>;
         }, z.core.$strict>>>;
+        kind: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniString<string>>>;
+        contract_version: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniInt>>;
+        contract_hash: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniString<string>>>;
+        extra: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniArray<z.ZodMiniObject<{
+            key: z.ZodMiniString<string>;
+            label: z.ZodMiniString<string>;
+            value: z.ZodMiniType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+        }, z.core.$strict>>>>;
     }, z.core.$strict>;
     page: z.ZodMiniObject<{
         path: z.ZodMiniString<string>;

package/dist/{form-submit-BLb28aCk.d.ts → form-submit-CX-CxJjQ.d.ts}

@@ -10,43 +10,6 @@ import * as z from 'zod/mini';
 type JsonValue = string | number | boolean | null | JsonValue[] | {
     [key: string]: JsonValue;
 };
-/**
- * Metadata for a manually fired `form_submit` event.
- *
- * Register the event with `manual: { form_submit: {} }`, then call
- * `trackEvent('form_submit', metadata)` from the host site's submit handler.
- *
- * `fields` is optional. If present, each value must be JSON-serializable. Client
- * integrations may intentionally capture raw submitted lead data (including name,
- * email, phone, address, selections, and free text) for first-party analytics and
- * lead operations. Submitted file data is supported after conversion to a
- * JSON-serializable representation; upload larger files separately and send a storage
- * reference. Never include credentials, authentication tokens, payment-card or bank
- * secrets, or private keys.
- *
- * No byte limit is enforced on this metadata, here or on the server — `fields` and its
- * values are unbounded. Keep inlined payloads small anyway: a submit fired just before
- * navigation flushes over `keepalive`, which browsers cap near 64 KB and drop silently.
- *
- * @example
- * ```ts
- * tracking.trackEvent('form_submit', {
- *   form: {
- *     id: 'lead-form',
- *     action: '/api/lead',
- *     fields: [
- *       {
- *         name: 'service_interest',
- *         type: 'select',
- *         label: 'Service interest',
- *         value: 'teeth_whitening',
- *       },
- *     ],
- *   },
- *   page: { path: window.location.pathname },
- * });
- * ```
- */
 declare const formSubmitMetadataSchema: z.ZodMiniObject<{
     form: z.ZodMiniObject<{
         id: z.ZodMiniString<string>;
@@ -56,7 +19,16 @@ declare const formSubmitMetadataSchema: z.ZodMiniObject<{
             type: z.ZodMiniString<string>;
             label: z.ZodMiniNullable<z.ZodMiniString<string>>;
             value: z.ZodMiniType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+            role: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniString<string>>>;
         }, z.core.$strict>>>;
+        kind: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniString<string>>>;
+        contract_version: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniInt>>;
+        contract_hash: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniString<string>>>;
+        extra: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniArray<z.ZodMiniObject<{
+            key: z.ZodMiniString<string>;
+            label: z.ZodMiniString<string>;
+            value: z.ZodMiniType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+        }, z.core.$strict>>>>;
     }, z.core.$strict>;
     page: z.ZodMiniObject<{
         path: z.ZodMiniString<string>;

package/dist/index.d.mts

@@ -1,12 +1,12 @@
 export { AdPlatformTracking, AdPlatformTrackingProps, BookedAttempt, BookingHandoffLink, BookingHandoffLinkProps, BookingHandoffOptions, BookingSubmitState, BookingSubmitStatus, ConsentBanner, ConsentBannerProps, CreateTrackingOptions, CreateTrackingResult, GoogleAdsTracking, GoogleAdsTrackingProps, PhoneField, PhoneFieldApi, PhoneFieldProps, PhoneInputProps, TrackingProviderProps, UseConsentResult, UseCookiePreferencesOptions, UseCookiePreferencesResult, UsePhoneFieldOptions, createTracking, useBookingHandoffUrl, useBookingIntegration, useBookingSlots, useBookingSubmit, useConsent, useConsentState, useCookiePreferences, useGclid, usePhoneConfig, usePhoneField, useTrackingParams } from '@aranova/tracking-react/client';
-import { T as TrackingParams, a as TrackingInstallSurface, b as TrackingEnvironment, c as TrackingClientContext, d as TrackingEventCreatePayload, e as TrackingSessionUpsertPayload } from './phone-utils-CM8eUPz8.mjs';
-export { C as ConsentChoice, f as ConsentChoiceState, g as ConsentSource, h as ConsentState, D as DEFAULT_DECLINE_TTL_DAYS, i as DEFAULT_PHONE_COUNTRY, G as GtagEnvironmentMap, M as MetaPixelEnvironmentMap, P as ParsedPhone, j as PhoneConfig, k as PhoneDisplayFormat, S as SetConsentOptions, l as TrackedField, m as TrackingInitConfig, n as formatPhone, o as formatPhoneAsTyped, p as getConsentChoice, q as getConsentState, r as onConsentChange, s as optIn, t as optOut, u as parsePhone, v as phoneField, w as resetConsent, x as setConsentState, y as toE164 } from './phone-utils-CM8eUPz8.mjs';
-export { A as AranovaApiError, B as BusinessConfig, a as BusinessConfigFeatures, b as BusinessConfigService, C as CompareTo, c as ConversionUserData, d as CurrencyRevenue, e as CustomerCurrencyDelta, f as CustomerCurrencyTotal, g as CustomerGetOptions, h as CustomerGetResult, i as CustomerKpis, j as CustomerKpisDeltas, k as CustomerKpisPrevious, l as CustomerListPage, m as CustomerListQuery, n as CustomerProfile, o as CustomerSegment, p as CustomerSegmentCount, q as CustomerSortField, r as CustomerSummary, s as CustomerSummaryQuery, D as DistinctCustomersByCurrency, E as EffectiveSaleProperty, G as Granularity, N as NAMED_RANGES, t as NamedRange, P as PublicServiceItem, S as SALE_SOURCES, u as SUPPORTED_CURRENCIES, v as Sale, w as SaleBuiltinRequirableField, x as SaleCursorPage, y as SaleFilters, z as SaleInput, F as SaleItem, H as SaleItemInput, I as SaleKeysetSortField, J as SaleListPage, K as SaleListQuery, L as SaleListQueryV2, M as SalePropertyOption, O as SalePropertyType, Q as SaleService, R as SaleServiceInput, T as SaleSortField, U as SaleSortOrder, V as SaleSource, W as SaleSourceFacts, X as SaleSummary, Y as SaleSummaryPrevious, Z as SaleSummaryQuery, _ as SaleSummaryQueryV2, $ as SaleSummaryV2, a0 as SaleUpdateInput, a1 as SalesBusinessClient, a2 as SalesCategoryBreakdown, a3 as SalesClient, a4 as SalesClientConfig, a5 as SalesCustomersClient, a6 as SalesServiceBreakdown, a7 as SalesTransportConfig, a8 as SalesTrendPoint, a9 as SummaryCurrencyDelta, aa as SummaryDeltas, ab as SummaryWindow, ac as SupportedCurrency, ad as TRACKING_RANGES, ae as TrackingOverviewRange, af as clearStashedUserData, ag as createSalesClient, ah as currencySchema, ai as fetchServices, aj as formatDateInTz, ak as formatMoney, al as fromMinor, am as saleCreateSchema, an as saleItemSchema, ao as saleServiceSchema, ap as saleUpdateSchema, aq as salesRequest, ar as stashUserData, as as toMinor } from './sales-Dil7TNV_.mjs';
-export { B as BookingDetailsFailure, a as BookingDetailsInput, b as BookingDetailsOptions, c as BookingDetailsOutcome, d as BookingDetailsStatus, e as BookingDropOff, f as BookingFormSubmit, g as BookingInput, h as BookingMode, i as BookingOutcome, j as BookingSimulation, k as BookingSubmitOptions, C as ConversionConfig, l as ConversionConfigStore, F as FormSubmitField, S as SalesBookingsClient, T as TrackingConfigReference, m as getTrackingConfigRuntime, n as newBookingAttemptKey, r as resolveConversionConfig, o as resolveTrackingConfigUrl } from './bookings-DtcwdM_I.mjs';
-export { A as AutomaticEventName, B as BookableDay, a as BookingHandoffPrefill, b as BookingIntegration, c as BookingOption, d as BookingOptionGroup, e as BookingProvider, f as BookingRules, C as CtaClickConfig, g as CtaClickMetadata, E as EVENT_SEMANTICS, h as EventCategory, i as EventClientVisibility, j as EventConfig, k as EventKind, l as EventMetadata, m as EventName, n as EventOutcomeRole, o as EventSemantics, F as FormStartConfig, p as FormStartMetadata, q as FormStepConfig, r as FormStepMetadata, M as ManualEventName, s as MultiPageSessionConfig, t as MultiPageSessionMetadata, P as PageExitConfig, u as PageExitMetadata, v as PageIdentity, w as PageViewConfig, x as PageViewMetadata, y as PhoneClickConfig, z as PhoneClickMetadata, R as RegisteredAutomaticEvents, D as RegisteredManualEvents, S as ScrollDepthConfig, G as ScrollDepthMetadata, H as SdkHeartbeatConfig, I as SdkHeartbeatMetadata, J as SiteLinkArrivalConfig, K as SiteLinkArrivalMetadata, L as SiteLinkClickConfig, N as SiteLinkClickMetadata, O as SpecificPageName, Q as SpecificPageVisitConfig, T as SpecificPageVisitMetadata, U as TimeOnSiteConfig, V as TimeOnSiteMetadata, W as TrackableEvent, X as TriggerRegistryConfig, Y as TypedTrackEventOptions, Z as TypedTrackingClient, _ as bookableSlots, $ as buildBookingHandoffUrl, a0 as getBookingIntegration, a1 as getEventSemantics, a2 as groupBookingOptions, a3 as shopToday } from './ingest-typed-C2OvZ7dp.mjs';
-export { F as FormSubmitConfig, a as FormSubmitMetadata, J as JsonValue } from './form-submit-BLb28aCk.mjs';
+import { T as TrackingParams, a as TrackingInstallSurface, b as TrackingEnvironment, c as TrackingClientContext, d as TrackingEventCreatePayload, e as TrackingSessionUpsertPayload } from './phone-utils-BNiSqeF7.mjs';
+export { C as ConsentChoice, f as ConsentChoiceState, g as ConsentSource, h as ConsentState, D as DEFAULT_DECLINE_TTL_DAYS, i as DEFAULT_PHONE_COUNTRY, G as GtagEnvironmentMap, M as MetaPixelEnvironmentMap, P as ParsedPhone, j as PhoneConfig, k as PhoneDisplayFormat, S as SetConsentOptions, l as TrackedField, m as TrackingInitConfig, n as formatPhone, o as formatPhoneAsTyped, p as getConsentChoice, q as getConsentState, r as onConsentChange, s as optIn, t as optOut, u as parsePhone, v as phoneField, w as resetConsent, x as setConsentState, y as toE164 } from './phone-utils-BNiSqeF7.mjs';
+export { A as AranovaApiError, B as BusinessConfig, a as BusinessConfigFeatures, b as BusinessConfigService, C as CompareTo, c as ConversionUserData, d as CurrencyRevenue, e as CustomerCurrencyDelta, f as CustomerCurrencyTotal, g as CustomerGetOptions, h as CustomerGetResult, i as CustomerKpis, j as CustomerKpisDeltas, k as CustomerKpisPrevious, l as CustomerListPage, m as CustomerListQuery, n as CustomerProfile, o as CustomerSegment, p as CustomerSegmentCount, q as CustomerSortField, r as CustomerSummary, s as CustomerSummaryQuery, D as DistinctCustomersByCurrency, E as EffectiveSaleProperty, G as Granularity, N as NAMED_RANGES, t as NamedRange, P as PublicServiceItem, S as SALE_SOURCES, u as SUPPORTED_CURRENCIES, v as Sale, w as SaleBuiltinRequirableField, x as SaleCursorPage, y as SaleFilters, z as SaleInput, F as SaleItem, H as SaleItemInput, I as SaleKeysetSortField, J as SaleListPage, K as SaleListQuery, L as SaleListQueryV2, M as SalePropertyOption, O as SalePropertyType, Q as SaleService, R as SaleServiceInput, T as SaleSortField, U as SaleSortOrder, V as SaleSource, W as SaleSourceFacts, X as SaleSummary, Y as SaleSummaryPrevious, Z as SaleSummaryQuery, _ as SaleSummaryQueryV2, $ as SaleSummaryV2, a0 as SaleUpdateInput, a1 as SalesBusinessClient, a2 as SalesCategoryBreakdown, a3 as SalesClient, a4 as SalesClientConfig, a5 as SalesCustomersClient, a6 as SalesServiceBreakdown, a7 as SalesTransportConfig, a8 as SalesTrendPoint, a9 as SummaryCurrencyDelta, aa as SummaryDeltas, ab as SummaryWindow, ac as SupportedCurrency, ad as TRACKING_RANGES, ae as TrackingOverviewRange, af as clearStashedUserData, ag as createSalesClient, ah as currencySchema, ai as fetchServices, aj as formatDateInTz, ak as formatMoney, al as fromMinor, am as saleCreateSchema, an as saleItemSchema, ao as saleServiceSchema, ap as saleUpdateSchema, aq as salesRequest, ar as stashUserData, as as toMinor } from './sales-CSV0H3iG.mjs';
+export { B as BookingDetailsFailure, a as BookingDetailsInput, b as BookingDetailsOptions, c as BookingDetailsOutcome, d as BookingDetailsStatus, e as BookingDropOff, f as BookingFormSubmit, g as BookingInput, h as BookingMode, i as BookingOutcome, j as BookingSimulation, k as BookingSubmitOptions, C as ConversionConfig, l as ConversionConfigStore, F as FormSubmitField, S as SalesBookingsClient, T as TrackingConfigReference, m as getTrackingConfigRuntime, n as newBookingAttemptKey, r as resolveConversionConfig, o as resolveTrackingConfigUrl } from './bookings-BnXZGgwr.mjs';
+export { A as AutomaticEventName, B as BookableDay, a as BookingHandoffPrefill, b as BookingIntegration, c as BookingOption, d as BookingOptionGroup, e as BookingProvider, f as BookingRules, C as CtaClickConfig, g as CtaClickMetadata, E as EVENT_SEMANTICS, h as EventCategory, i as EventClientVisibility, j as EventConfig, k as EventKind, l as EventMetadata, m as EventName, n as EventOutcomeRole, o as EventSemantics, F as FormStartConfig, p as FormStartMetadata, q as FormStepConfig, r as FormStepMetadata, M as ManualEventName, s as MultiPageSessionConfig, t as MultiPageSessionMetadata, P as PageExitConfig, u as PageExitMetadata, v as PageIdentity, w as PageViewConfig, x as PageViewMetadata, y as PhoneClickConfig, z as PhoneClickMetadata, R as RegisteredAutomaticEvents, D as RegisteredManualEvents, S as ScrollDepthConfig, G as ScrollDepthMetadata, H as SdkHeartbeatConfig, I as SdkHeartbeatMetadata, J as SiteLinkArrivalConfig, K as SiteLinkArrivalMetadata, L as SiteLinkClickConfig, N as SiteLinkClickMetadata, O as SpecificPageName, Q as SpecificPageVisitConfig, T as SpecificPageVisitMetadata, U as TimeOnSiteConfig, V as TimeOnSiteMetadata, W as TrackableEvent, X as TriggerRegistryConfig, Y as TypedTrackEventOptions, Z as TypedTrackingClient, _ as bookableSlots, $ as buildBookingHandoffUrl, a0 as getBookingIntegration, a1 as getEventSemantics, a2 as groupBookingOptions, a3 as shopToday } from './ingest-typed-TI6KqVzL.mjs';
+export { F as FormSubmitConfig, a as FormSubmitMetadata, J as JsonValue } from './form-submit-CX-CxJjQ.mjs';
+import * as z from 'zod/mini';
 export { CountryCode } from 'libphonenumber-js';
-import 'zod/mini';
 import 'zod/v4/core';
 
 /**
@@ -100,4 +100,175 @@ interface TrackingClient {
     destroy: () => void;
 }
 
-export { TRACKING_PARAM_KEYS, type TrackingClient, TrackingClientContext, TrackingEventCreatePayload, TrackingInstallSurface, TrackingParams, TrackingSessionUpsertPayload, captureTrackingParamsFromLocation, createTrackingClientContext, createTrackingEventCreatePayload, createTrackingSessionUpsertPayload };
+/** Bump-on-change registry version; travels on every contract-typed form_submit. */
+declare const LEAD_FORM_REGISTRY_VERSION = 1;
+declare const LEAD_FORM_KINDS: readonly ["booking", "quote", "contact", "consult", "callback"];
+/** What a form is for; `form_id` stays the instance handle. */
+type LeadFormKind = (typeof LEAD_FORM_KINDS)[number];
+declare const LEAD_FORM_ROLES: readonly ["given_name", "family_name", "phone", "email", "service", "preferred_date", "preferred_time", "note", "visit", "intent", "vehicle", "drop_off", "address", "patient_type", "matter", "language", "products", "goal", "business_type", "lead_volume", "attribution"];
+/** A role from the registry, or `add_on:<key>` for a yes/no extra with its own label. */
+type LeadFormRole = (typeof LEAD_FORM_ROLES)[number] | `add_on:${string}`;
+declare const LEAD_FORM_PRIMITIVES: readonly ["string", "text", "enum", "multi_enum", "bool", "date", "time_window", "phone", "email", "address", "number"];
+type LeadFormPrimitive = (typeof LEAD_FORM_PRIMITIVES)[number];
+/** The wire schema of each primitive's value. */
+declare const leadFormPrimitiveSchemas: {
+    readonly string: z.ZodMiniString<string>;
+    readonly text: z.ZodMiniString<string>;
+    readonly enum: z.ZodMiniString<string>;
+    readonly multi_enum: z.ZodMiniArray<z.ZodMiniString<string>>;
+    readonly bool: z.ZodMiniBoolean<boolean>;
+    readonly date: z.ZodMiniString<string>;
+    readonly time_window: z.ZodMiniObject<{
+        start: z.ZodMiniString<string>;
+        end: z.ZodMiniNullable<z.ZodMiniString<string>>;
+        label: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    }, z.core.$strict>;
+    readonly phone: z.ZodMiniString<string>;
+    readonly email: z.ZodMiniString<string>;
+    readonly address: z.ZodMiniObject<{
+        line1: z.ZodMiniString<string>;
+        line2: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        city: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        region: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        postal_code: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        country: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    }, z.core.$strict>;
+    readonly number: z.ZodMiniNumber<number>;
+};
+interface LeadFormRoleOption {
+    key: string;
+    label: string;
+    isNonAnswer?: true;
+}
+interface LeadFormRoleSpec {
+    primitive: LeadFormPrimitive;
+    smsLabel: string;
+    contactIdentity?: true;
+    uninteresting?: true;
+    options?: readonly LeadFormRoleOption[];
+}
+/** Every role's primitive and text label; `add_on` is the template for `add_on:<key>`. */
+declare const LEAD_FORM_ROLE_SPECS: {
+    readonly given_name: {
+        readonly primitive: "string";
+        readonly smsLabel: "";
+        readonly contactIdentity: true;
+    };
+    readonly family_name: {
+        readonly primitive: "string";
+        readonly smsLabel: "";
+        readonly contactIdentity: true;
+    };
+    readonly phone: {
+        readonly primitive: "phone";
+        readonly smsLabel: "";
+        readonly contactIdentity: true;
+    };
+    readonly email: {
+        readonly primitive: "email";
+        readonly smsLabel: "";
+        readonly contactIdentity: true;
+    };
+    readonly service: {
+        readonly primitive: "enum";
+        readonly smsLabel: "Service";
+    };
+    readonly preferred_date: {
+        readonly primitive: "date";
+        readonly smsLabel: "Date";
+    };
+    readonly preferred_time: {
+        readonly primitive: "time_window";
+        readonly smsLabel: "Time";
+    };
+    readonly note: {
+        readonly primitive: "text";
+        readonly smsLabel: "Note";
+    };
+    readonly visit: {
+        readonly primitive: "enum";
+        readonly smsLabel: "Visit";
+        readonly options: readonly [{
+            readonly key: "in-shop";
+            readonly label: "In shop";
+        }, {
+            readonly key: "in-home";
+            readonly label: "In home";
+        }, {
+            readonly key: "remote";
+            readonly label: "Remote";
+        }, {
+            readonly key: "on-site";
+            readonly label: "On site";
+        }];
+    };
+    readonly intent: {
+        readonly primitive: "enum";
+        readonly smsLabel: "Wants";
+        readonly options: readonly [{
+            readonly key: "book";
+            readonly label: "Book";
+        }, {
+            readonly key: "quote";
+            readonly label: "Quote";
+        }];
+    };
+    readonly vehicle: {
+        readonly primitive: "string";
+        readonly smsLabel: "Vehicle";
+    };
+    readonly drop_off: {
+        readonly primitive: "enum";
+        readonly smsLabel: "Drop-off";
+        readonly options: readonly [{
+            readonly key: "wait-for-it";
+            readonly label: "Waiting";
+        }, {
+            readonly key: "drop-off";
+            readonly label: "Dropping off";
+        }];
+    };
+    readonly address: {
+        readonly primitive: "address";
+        readonly smsLabel: "Address";
+    };
+    readonly patient_type: {
+        readonly primitive: "enum";
+        readonly smsLabel: "Patient";
+    };
+    readonly matter: {
+        readonly primitive: "enum";
+        readonly smsLabel: "Matter";
+    };
+    readonly language: {
+        readonly primitive: "enum";
+        readonly smsLabel: "Language";
+    };
+    readonly products: {
+        readonly primitive: "multi_enum";
+        readonly smsLabel: "Products";
+    };
+    readonly goal: {
+        readonly primitive: "enum";
+        readonly smsLabel: "Goal";
+    };
+    readonly business_type: {
+        readonly primitive: "enum";
+        readonly smsLabel: "Business";
+    };
+    readonly lead_volume: {
+        readonly primitive: "enum";
+        readonly smsLabel: "Lead volume";
+    };
+    readonly add_on: {
+        readonly primitive: "bool";
+        readonly smsLabel: "";
+    };
+    readonly attribution: {
+        readonly primitive: "enum";
+        readonly smsLabel: "";
+        readonly uninteresting: true;
+    };
+};
+
+export { LEAD_FORM_KINDS, LEAD_FORM_PRIMITIVES, LEAD_FORM_REGISTRY_VERSION, LEAD_FORM_ROLES, LEAD_FORM_ROLE_SPECS, type LeadFormKind, type LeadFormPrimitive, type LeadFormRole, type LeadFormRoleOption, type LeadFormRoleSpec, TRACKING_PARAM_KEYS, type TrackingClient, TrackingClientContext, TrackingEventCreatePayload, TrackingInstallSurface, TrackingParams, TrackingSessionUpsertPayload, captureTrackingParamsFromLocation, createTrackingClientContext, createTrackingEventCreatePayload, createTrackingSessionUpsertPayload, leadFormPrimitiveSchemas };

package/dist/index.d.ts

@@ -1,12 +1,12 @@
 export { AdPlatformTracking, AdPlatformTrackingProps, BookedAttempt, BookingHandoffLink, BookingHandoffLinkProps, BookingHandoffOptions, BookingSubmitState, BookingSubmitStatus, ConsentBanner, ConsentBannerProps, CreateTrackingOptions, CreateTrackingResult, GoogleAdsTracking, GoogleAdsTrackingProps, PhoneField, PhoneFieldApi, PhoneFieldProps, PhoneInputProps, TrackingProviderProps, UseConsentResult, UseCookiePreferencesOptions, UseCookiePreferencesResult, UsePhoneFieldOptions, createTracking, useBookingHandoffUrl, useBookingIntegration, useBookingSlots, useBookingSubmit, useConsent, useConsentState, useCookiePreferences, useGclid, usePhoneConfig, usePhoneField, useTrackingParams } from '@aranova/tracking-react/client';
-import { T as TrackingParams, a as TrackingInstallSurface, b as TrackingEnvironment, c as TrackingClientContext, d as TrackingEventCreatePayload, e as TrackingSessionUpsertPayload } from './phone-utils-l8ey3Zdm.js';
-export { C as ConsentChoice, f as ConsentChoiceState, g as ConsentSource, h as ConsentState, D as DEFAULT_DECLINE_TTL_DAYS, i as DEFAULT_PHONE_COUNTRY, G as GtagEnvironmentMap, M as MetaPixelEnvironmentMap, P as ParsedPhone, j as PhoneConfig, k as PhoneDisplayFormat, S as SetConsentOptions, l as TrackedField, m as TrackingInitConfig, n as formatPhone, o as formatPhoneAsTyped, p as getConsentChoice, q as getConsentState, r as onConsentChange, s as optIn, t as optOut, u as parsePhone, v as phoneField, w as resetConsent, x as setConsentState, y as toE164 } from './phone-utils-l8ey3Zdm.js';
-export { A as AranovaApiError, B as BusinessConfig, a as BusinessConfigFeatures, b as BusinessConfigService, C as CompareTo, c as ConversionUserData, d as CurrencyRevenue, e as CustomerCurrencyDelta, f as CustomerCurrencyTotal, g as CustomerGetOptions, h as CustomerGetResult, i as CustomerKpis, j as CustomerKpisDeltas, k as CustomerKpisPrevious, l as CustomerListPage, m as CustomerListQuery, n as CustomerProfile, o as CustomerSegment, p as CustomerSegmentCount, q as CustomerSortField, r as CustomerSummary, s as CustomerSummaryQuery, D as DistinctCustomersByCurrency, E as EffectiveSaleProperty, G as Granularity, N as NAMED_RANGES, t as NamedRange, P as PublicServiceItem, S as SALE_SOURCES, u as SUPPORTED_CURRENCIES, v as Sale, w as SaleBuiltinRequirableField, x as SaleCursorPage, y as SaleFilters, z as SaleInput, F as SaleItem, H as SaleItemInput, I as SaleKeysetSortField, J as SaleListPage, K as SaleListQuery, L as SaleListQueryV2, M as SalePropertyOption, O as SalePropertyType, Q as SaleService, R as SaleServiceInput, T as SaleSortField, U as SaleSortOrder, V as SaleSource, W as SaleSourceFacts, X as SaleSummary, Y as SaleSummaryPrevious, Z as SaleSummaryQuery, _ as SaleSummaryQueryV2, $ as SaleSummaryV2, a0 as SaleUpdateInput, a1 as SalesBusinessClient, a2 as SalesCategoryBreakdown, a3 as SalesClient, a4 as SalesClientConfig, a5 as SalesCustomersClient, a6 as SalesServiceBreakdown, a7 as SalesTransportConfig, a8 as SalesTrendPoint, a9 as SummaryCurrencyDelta, aa as SummaryDeltas, ab as SummaryWindow, ac as SupportedCurrency, ad as TRACKING_RANGES, ae as TrackingOverviewRange, af as clearStashedUserData, ag as createSalesClient, ah as currencySchema, ai as fetchServices, aj as formatDateInTz, ak as formatMoney, al as fromMinor, am as saleCreateSchema, an as saleItemSchema, ao as saleServiceSchema, ap as saleUpdateSchema, aq as salesRequest, ar as stashUserData, as as toMinor } from './sales-DJJpMY_c.js';
-export { B as BookingDetailsFailure, a as BookingDetailsInput, b as BookingDetailsOptions, c as BookingDetailsOutcome, d as BookingDetailsStatus, e as BookingDropOff, f as BookingFormSubmit, g as BookingInput, h as BookingMode, i as BookingOutcome, j as BookingSimulation, k as BookingSubmitOptions, C as ConversionConfig, l as ConversionConfigStore, F as FormSubmitField, S as SalesBookingsClient, T as TrackingConfigReference, m as getTrackingConfigRuntime, n as newBookingAttemptKey, r as resolveConversionConfig, o as resolveTrackingConfigUrl } from './bookings-Bx7totlS.js';
-export { A as AutomaticEventName, B as BookableDay, a as BookingHandoffPrefill, b as BookingIntegration, c as BookingOption, d as BookingOptionGroup, e as BookingProvider, f as BookingRules, C as CtaClickConfig, g as CtaClickMetadata, E as EVENT_SEMANTICS, h as EventCategory, i as EventClientVisibility, j as EventConfig, k as EventKind, l as EventMetadata, m as EventName, n as EventOutcomeRole, o as EventSemantics, F as FormStartConfig, p as FormStartMetadata, q as FormStepConfig, r as FormStepMetadata, M as ManualEventName, s as MultiPageSessionConfig, t as MultiPageSessionMetadata, P as PageExitConfig, u as PageExitMetadata, v as PageIdentity, w as PageViewConfig, x as PageViewMetadata, y as PhoneClickConfig, z as PhoneClickMetadata, R as RegisteredAutomaticEvents, D as RegisteredManualEvents, S as ScrollDepthConfig, G as ScrollDepthMetadata, H as SdkHeartbeatConfig, I as SdkHeartbeatMetadata, J as SiteLinkArrivalConfig, K as SiteLinkArrivalMetadata, L as SiteLinkClickConfig, N as SiteLinkClickMetadata, O as SpecificPageName, Q as SpecificPageVisitConfig, T as SpecificPageVisitMetadata, U as TimeOnSiteConfig, V as TimeOnSiteMetadata, W as TrackableEvent, X as TriggerRegistryConfig, Y as TypedTrackEventOptions, Z as TypedTrackingClient, _ as bookableSlots, $ as buildBookingHandoffUrl, a0 as getBookingIntegration, a1 as getEventSemantics, a2 as groupBookingOptions, a3 as shopToday } from './ingest-typed-B-BgEZdW.js';
-export { F as FormSubmitConfig, a as FormSubmitMetadata, J as JsonValue } from './form-submit-BLb28aCk.js';
+import { T as TrackingParams, a as TrackingInstallSurface, b as TrackingEnvironment, c as TrackingClientContext, d as TrackingEventCreatePayload, e as TrackingSessionUpsertPayload } from './phone-utils-D12FW8tT.js';
+export { C as ConsentChoice, f as ConsentChoiceState, g as ConsentSource, h as ConsentState, D as DEFAULT_DECLINE_TTL_DAYS, i as DEFAULT_PHONE_COUNTRY, G as GtagEnvironmentMap, M as MetaPixelEnvironmentMap, P as ParsedPhone, j as PhoneConfig, k as PhoneDisplayFormat, S as SetConsentOptions, l as TrackedField, m as TrackingInitConfig, n as formatPhone, o as formatPhoneAsTyped, p as getConsentChoice, q as getConsentState, r as onConsentChange, s as optIn, t as optOut, u as parsePhone, v as phoneField, w as resetConsent, x as setConsentState, y as toE164 } from './phone-utils-D12FW8tT.js';
+export { A as AranovaApiError, B as BusinessConfig, a as BusinessConfigFeatures, b as BusinessConfigService, C as CompareTo, c as ConversionUserData, d as CurrencyRevenue, e as CustomerCurrencyDelta, f as CustomerCurrencyTotal, g as CustomerGetOptions, h as CustomerGetResult, i as CustomerKpis, j as CustomerKpisDeltas, k as CustomerKpisPrevious, l as CustomerListPage, m as CustomerListQuery, n as CustomerProfile, o as CustomerSegment, p as CustomerSegmentCount, q as CustomerSortField, r as CustomerSummary, s as CustomerSummaryQuery, D as DistinctCustomersByCurrency, E as EffectiveSaleProperty, G as Granularity, N as NAMED_RANGES, t as NamedRange, P as PublicServiceItem, S as SALE_SOURCES, u as SUPPORTED_CURRENCIES, v as Sale, w as SaleBuiltinRequirableField, x as SaleCursorPage, y as SaleFilters, z as SaleInput, F as SaleItem, H as SaleItemInput, I as SaleKeysetSortField, J as SaleListPage, K as SaleListQuery, L as SaleListQueryV2, M as SalePropertyOption, O as SalePropertyType, Q as SaleService, R as SaleServiceInput, T as SaleSortField, U as SaleSortOrder, V as SaleSource, W as SaleSourceFacts, X as SaleSummary, Y as SaleSummaryPrevious, Z as SaleSummaryQuery, _ as SaleSummaryQueryV2, $ as SaleSummaryV2, a0 as SaleUpdateInput, a1 as SalesBusinessClient, a2 as SalesCategoryBreakdown, a3 as SalesClient, a4 as SalesClientConfig, a5 as SalesCustomersClient, a6 as SalesServiceBreakdown, a7 as SalesTransportConfig, a8 as SalesTrendPoint, a9 as SummaryCurrencyDelta, aa as SummaryDeltas, ab as SummaryWindow, ac as SupportedCurrency, ad as TRACKING_RANGES, ae as TrackingOverviewRange, af as clearStashedUserData, ag as createSalesClient, ah as currencySchema, ai as fetchServices, aj as formatDateInTz, ak as formatMoney, al as fromMinor, am as saleCreateSchema, an as saleItemSchema, ao as saleServiceSchema, ap as saleUpdateSchema, aq as salesRequest, ar as stashUserData, as as toMinor } from './sales-BegN5t_z.js';
+export { B as BookingDetailsFailure, a as BookingDetailsInput, b as BookingDetailsOptions, c as BookingDetailsOutcome, d as BookingDetailsStatus, e as BookingDropOff, f as BookingFormSubmit, g as BookingInput, h as BookingMode, i as BookingOutcome, j as BookingSimulation, k as BookingSubmitOptions, C as ConversionConfig, l as ConversionConfigStore, F as FormSubmitField, S as SalesBookingsClient, T as TrackingConfigReference, m as getTrackingConfigRuntime, n as newBookingAttemptKey, r as resolveConversionConfig, o as resolveTrackingConfigUrl } from './bookings-vM_aCNOS.js';
+export { A as AutomaticEventName, B as BookableDay, a as BookingHandoffPrefill, b as BookingIntegration, c as BookingOption, d as BookingOptionGroup, e as BookingProvider, f as BookingRules, C as CtaClickConfig, g as CtaClickMetadata, E as EVENT_SEMANTICS, h as EventCategory, i as EventClientVisibility, j as EventConfig, k as EventKind, l as EventMetadata, m as EventName, n as EventOutcomeRole, o as EventSemantics, F as FormStartConfig, p as FormStartMetadata, q as FormStepConfig, r as FormStepMetadata, M as ManualEventName, s as MultiPageSessionConfig, t as MultiPageSessionMetadata, P as PageExitConfig, u as PageExitMetadata, v as PageIdentity, w as PageViewConfig, x as PageViewMetadata, y as PhoneClickConfig, z as PhoneClickMetadata, R as RegisteredAutomaticEvents, D as RegisteredManualEvents, S as ScrollDepthConfig, G as ScrollDepthMetadata, H as SdkHeartbeatConfig, I as SdkHeartbeatMetadata, J as SiteLinkArrivalConfig, K as SiteLinkArrivalMetadata, L as SiteLinkClickConfig, N as SiteLinkClickMetadata, O as SpecificPageName, Q as SpecificPageVisitConfig, T as SpecificPageVisitMetadata, U as TimeOnSiteConfig, V as TimeOnSiteMetadata, W as TrackableEvent, X as TriggerRegistryConfig, Y as TypedTrackEventOptions, Z as TypedTrackingClient, _ as bookableSlots, $ as buildBookingHandoffUrl, a0 as getBookingIntegration, a1 as getEventSemantics, a2 as groupBookingOptions, a3 as shopToday } from './ingest-typed-BS9agXM5.js';
+export { F as FormSubmitConfig, a as FormSubmitMetadata, J as JsonValue } from './form-submit-CX-CxJjQ.js';
+import * as z from 'zod/mini';
 export { CountryCode } from 'libphonenumber-js';
-import 'zod/mini';
 import 'zod/v4/core';
 
 /**
@@ -100,4 +100,175 @@ interface TrackingClient {
     destroy: () => void;
 }
 
-export { TRACKING_PARAM_KEYS, type TrackingClient, TrackingClientContext, TrackingEventCreatePayload, TrackingInstallSurface, TrackingParams, TrackingSessionUpsertPayload, captureTrackingParamsFromLocation, createTrackingClientContext, createTrackingEventCreatePayload, createTrackingSessionUpsertPayload };
+/** Bump-on-change registry version; travels on every contract-typed form_submit. */
+declare const LEAD_FORM_REGISTRY_VERSION = 1;
+declare const LEAD_FORM_KINDS: readonly ["booking", "quote", "contact", "consult", "callback"];
+/** What a form is for; `form_id` stays the instance handle. */
+type LeadFormKind = (typeof LEAD_FORM_KINDS)[number];
+declare const LEAD_FORM_ROLES: readonly ["given_name", "family_name", "phone", "email", "service", "preferred_date", "preferred_time", "note", "visit", "intent", "vehicle", "drop_off", "address", "patient_type", "matter", "language", "products", "goal", "business_type", "lead_volume", "attribution"];
+/** A role from the registry, or `add_on:<key>` for a yes/no extra with its own label. */
+type LeadFormRole = (typeof LEAD_FORM_ROLES)[number] | `add_on:${string}`;
+declare const LEAD_FORM_PRIMITIVES: readonly ["string", "text", "enum", "multi_enum", "bool", "date", "time_window", "phone", "email", "address", "number"];
+type LeadFormPrimitive = (typeof LEAD_FORM_PRIMITIVES)[number];
+/** The wire schema of each primitive's value. */
+declare const leadFormPrimitiveSchemas: {
+    readonly string: z.ZodMiniString<string>;
+    readonly text: z.ZodMiniString<string>;
+    readonly enum: z.ZodMiniString<string>;
+    readonly multi_enum: z.ZodMiniArray<z.ZodMiniString<string>>;
+    readonly bool: z.ZodMiniBoolean<boolean>;
+    readonly date: z.ZodMiniString<string>;
+    readonly time_window: z.ZodMiniObject<{
+        start: z.ZodMiniString<string>;
+        end: z.ZodMiniNullable<z.ZodMiniString<string>>;
+        label: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    }, z.core.$strict>;
+    readonly phone: z.ZodMiniString<string>;
+    readonly email: z.ZodMiniString<string>;
+    readonly address: z.ZodMiniObject<{
+        line1: z.ZodMiniString<string>;
+        line2: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        city: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        region: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        postal_code: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        country: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    }, z.core.$strict>;
+    readonly number: z.ZodMiniNumber<number>;
+};
+interface LeadFormRoleOption {
+    key: string;
+    label: string;
+    isNonAnswer?: true;
+}
+interface LeadFormRoleSpec {
+    primitive: LeadFormPrimitive;
+    smsLabel: string;
+    contactIdentity?: true;
+    uninteresting?: true;
+    options?: readonly LeadFormRoleOption[];
+}
+/** Every role's primitive and text label; `add_on` is the template for `add_on:<key>`. */
+declare const LEAD_FORM_ROLE_SPECS: {
+    readonly given_name: {
+        readonly primitive: "string";
+        readonly smsLabel: "";
+        readonly contactIdentity: true;
+    };
+    readonly family_name: {
+        readonly primitive: "string";
+        readonly smsLabel: "";
+        readonly contactIdentity: true;
+    };
+    readonly phone: {
+        readonly primitive: "phone";
+        readonly smsLabel: "";
+        readonly contactIdentity: true;
+    };
+    readonly email: {
+        readonly primitive: "email";
+        readonly smsLabel: "";
+        readonly contactIdentity: true;
+    };
+    readonly service: {
+        readonly primitive: "enum";
+        readonly smsLabel: "Service";
+    };
+    readonly preferred_date: {
+        readonly primitive: "date";
+        readonly smsLabel: "Date";
+    };
+    readonly preferred_time: {
+        readonly primitive: "time_window";
+        readonly smsLabel: "Time";
+    };
+    readonly note: {
+        readonly primitive: "text";
+        readonly smsLabel: "Note";
+    };
+    readonly visit: {
+        readonly primitive: "enum";
+        readonly smsLabel: "Visit";
+        readonly options: readonly [{
+            readonly key: "in-shop";
+            readonly label: "In shop";
+        }, {
+            readonly key: "in-home";
+            readonly label: "In home";
+        }, {
+            readonly key: "remote";
+            readonly label: "Remote";
+        }, {
+            readonly key: "on-site";
+            readonly label: "On site";
+        }];
+    };
+    readonly intent: {
+        readonly primitive: "enum";
+        readonly smsLabel: "Wants";
+        readonly options: readonly [{
+            readonly key: "book";
+            readonly label: "Book";
+        }, {
+            readonly key: "quote";
+            readonly label: "Quote";
+        }];
+    };
+    readonly vehicle: {
+        readonly primitive: "string";
+        readonly smsLabel: "Vehicle";
+    };
+    readonly drop_off: {
+        readonly primitive: "enum";
+        readonly smsLabel: "Drop-off";
+        readonly options: readonly [{
+            readonly key: "wait-for-it";
+            readonly label: "Waiting";
+        }, {
+            readonly key: "drop-off";
+            readonly label: "Dropping off";
+        }];
+    };
+    readonly address: {
+        readonly primitive: "address";
+        readonly smsLabel: "Address";
+    };
+    readonly patient_type: {
+        readonly primitive: "enum";
+        readonly smsLabel: "Patient";
+    };
+    readonly matter: {
+        readonly primitive: "enum";
+        readonly smsLabel: "Matter";
+    };
+    readonly language: {
+        readonly primitive: "enum";
+        readonly smsLabel: "Language";
+    };
+    readonly products: {
+        readonly primitive: "multi_enum";
+        readonly smsLabel: "Products";
+    };
+    readonly goal: {
+        readonly primitive: "enum";
+        readonly smsLabel: "Goal";
+    };
+    readonly business_type: {
+        readonly primitive: "enum";
+        readonly smsLabel: "Business";
+    };
+    readonly lead_volume: {
+        readonly primitive: "enum";
+        readonly smsLabel: "Lead volume";
+    };
+    readonly add_on: {
+        readonly primitive: "bool";
+        readonly smsLabel: "";
+    };
+    readonly attribution: {
+        readonly primitive: "enum";
+        readonly smsLabel: "";
+        readonly uninteresting: true;
+    };
+};
+
+export { LEAD_FORM_KINDS, LEAD_FORM_PRIMITIVES, LEAD_FORM_REGISTRY_VERSION, LEAD_FORM_ROLES, LEAD_FORM_ROLE_SPECS, type LeadFormKind, type LeadFormPrimitive, type LeadFormRole, type LeadFormRoleOption, type LeadFormRoleSpec, TRACKING_PARAM_KEYS, type TrackingClient, TrackingClientContext, TrackingEventCreatePayload, TrackingInstallSurface, TrackingParams, TrackingSessionUpsertPayload, captureTrackingParamsFromLocation, createTrackingClientContext, createTrackingEventCreatePayload, createTrackingSessionUpsertPayload, leadFormPrimitiveSchemas };