@aranova/tracking-react 1.14.0 → 1.14.1

package/dist/client.d.mts

@@ -1,11 +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, s as PhoneConfig, P as ParsedPhone, t as PhoneDisplayFormat } from './phone-utils-Cfdx474X.mjs';
-import { T as TrackingConfigReference, C as ConversionConfig, i as BookingOutcome, g as BookingInput, a as BookingDetailsInput, c as BookingDetailsOutcome, S as SalesBookingsClient, f as BookingFormSubmit, j as BookingSimulation } from './bookings-CDGNZUaH.mjs';
-import { a7 as TriggerRegistryConfig, a9 as TypedTrackingClient, a as BookingHandoffPrefill, b as BookingIntegration, B as BookableDay } from './submit-rqgXl-Wg.mjs';
-export { ai as createLeadFormSubmit } from './submit-rqgXl-Wg.mjs';
+import { G as GtagEnvironmentMap, M as MetaPixelEnvironmentMap, h as ConsentState, f as ConsentChoiceState, g as ConsentSource, T as TrackingParams, b as TrackingEnvironment, u as PhoneConfig, P as ParsedPhone, v as PhoneDisplayFormat } from './phone-utils-CYr6AmEP.mjs';
+import { T as TrackingConfigReference, C as ConversionConfig, h as BookingHandoffPrefill, i as BookingInput, p as BookingOutcome, b as BookingDetailsInput, d as BookingDetailsOutcome, k as BookingIntegration, B as BookableDay, x as LeadFormContracts, S as SalesBookingsClient, g as BookingFormSubmit, t as BookingSimulation, j as BookingInputFor } from './bookings-DFz3BUiP.mjs';
+export { Z as createLeadFormSubmit } from './bookings-DFz3BUiP.mjs';
+import { L as TriggerRegistryConfig, O as TypedTrackingClient } from './ingest-typed-BO6Arbw-.mjs';
 import { CountryCode } from 'libphonenumber-js';
-import './form-submit-C_vJXCxh.mjs';
 import 'zod/mini';
 import 'zod/v4/core';
 
@@ -408,11 +407,11 @@ interface BookedAttempt {
     bookingId: string;
     attemptKey: string;
 }
-interface BookingSubmitState {
+interface BookingSubmitState<I = BookingInput> {
     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>;
+    submit(input: I): Promise<BookingOutcome>;
     /**
      * The recorded booking and the key it was sent with; persist it (e.g. `sessionStorage`) to add
      * details after a reload. Null until the server has the booking.
@@ -431,11 +430,13 @@ interface BookingSubmitState {
  * 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. A `pending` answer
  * shows at once (`status: "pending"`) while the final one is polled; the submit stays in flight.
+ * Pass the site's `ARANOVA_LEAD_FORMS` as `contracts` to type the input by the shop's rules.
  */
-declare function useBookingSubmit(bookings: SalesBookingsClient, options?: {
+declare function useBookingSubmit<C extends LeadFormContracts | undefined = undefined>(bookings: SalesBookingsClient, options?: {
     formSubmit?: BookingFormSubmit;
     /** Development only: a simulated create's outcome. The production API ignores it. */
     simulate?: BookingSimulation;
-}): BookingSubmitState;
+    contracts?: C;
+}): BookingSubmitState<C extends LeadFormContracts ? BookingInputFor<C> : BookingInput>;
 
 export { AdPlatformTracking, type AdPlatformTrackingProps, type BookedAttempt, 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,11 +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, s as PhoneConfig, P as ParsedPhone, t as PhoneDisplayFormat } from './phone-utils-D2TGPCQW.js';
-import { T as TrackingConfigReference, C as ConversionConfig, i as BookingOutcome, g as BookingInput, a as BookingDetailsInput, c as BookingDetailsOutcome, S as SalesBookingsClient, f as BookingFormSubmit, j as BookingSimulation } from './bookings-Bw2ImtPd.js';
-import { a7 as TriggerRegistryConfig, a9 as TypedTrackingClient, a as BookingHandoffPrefill, b as BookingIntegration, B as BookableDay } from './submit-DuvP5AGN.js';
-export { ai as createLeadFormSubmit } from './submit-DuvP5AGN.js';
+import { G as GtagEnvironmentMap, M as MetaPixelEnvironmentMap, h as ConsentState, f as ConsentChoiceState, g as ConsentSource, T as TrackingParams, b as TrackingEnvironment, u as PhoneConfig, P as ParsedPhone, v as PhoneDisplayFormat } from './phone-utils-CYr6AmEP.js';
+import { T as TrackingConfigReference, C as ConversionConfig, h as BookingHandoffPrefill, i as BookingInput, p as BookingOutcome, b as BookingDetailsInput, d as BookingDetailsOutcome, k as BookingIntegration, B as BookableDay, x as LeadFormContracts, S as SalesBookingsClient, g as BookingFormSubmit, t as BookingSimulation, j as BookingInputFor } from './bookings-CkfA5XOM.js';
+export { Z as createLeadFormSubmit } from './bookings-CkfA5XOM.js';
+import { L as TriggerRegistryConfig, O as TypedTrackingClient } from './ingest-typed-D7I4aQ7p.js';
 import { CountryCode } from 'libphonenumber-js';
-import './form-submit-C_vJXCxh.js';
 import 'zod/mini';
 import 'zod/v4/core';
 
@@ -408,11 +407,11 @@ interface BookedAttempt {
     bookingId: string;
     attemptKey: string;
 }
-interface BookingSubmitState {
+interface BookingSubmitState<I = BookingInput> {
     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>;
+    submit(input: I): Promise<BookingOutcome>;
     /**
      * The recorded booking and the key it was sent with; persist it (e.g. `sessionStorage`) to add
      * details after a reload. Null until the server has the booking.
@@ -431,11 +430,13 @@ interface BookingSubmitState {
  * 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. A `pending` answer
  * shows at once (`status: "pending"`) while the final one is polled; the submit stays in flight.
+ * Pass the site's `ARANOVA_LEAD_FORMS` as `contracts` to type the input by the shop's rules.
  */
-declare function useBookingSubmit(bookings: SalesBookingsClient, options?: {
+declare function useBookingSubmit<C extends LeadFormContracts | undefined = undefined>(bookings: SalesBookingsClient, options?: {
     formSubmit?: BookingFormSubmit;
     /** Development only: a simulated create's outcome. The production API ignores it. */
     simulate?: BookingSimulation;
-}): BookingSubmitState;
+    contracts?: C;
+}): BookingSubmitState<C extends LeadFormContracts ? BookingInputFor<C> : BookingInput>;
 
 export { AdPlatformTracking, type AdPlatformTrackingProps, type BookedAttempt, 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.js

@@ -3931,6 +3931,157 @@ var LEAD_FORM_ROLE_SPECS = {
   attribution: { primitive: "enum", smsLabel: "", uninteresting: true }
 };
 
+// ../tracking-core/src/lead-forms/submit.ts
+var import_mini4 = require("zod/mini");
+var KNOWN_ROLES = new Set(LEAD_FORM_ROLES);
+var ROLE_ORDER = new Map(LEAD_FORM_ROLES.map((role, index) => [role, index]));
+var ADD_ON = /^add_on:[a-z0-9_-]{1,48}$/;
+var CONTRACT_NAME = /^[a-z][a-z0-9_]{0,47}(:[a-z0-9_-]{1,48})?$/;
+var INPUT_TYPES = {
+  string: "text",
+  text: "textarea",
+  enum: "select",
+  multi_enum: "select",
+  bool: "checkbox",
+  date: "date",
+  time_window: "time",
+  phone: "tel",
+  email: "email",
+  address: "address",
+  number: "number"
+};
+function createLeadFormSubmit(tracking, contracts, options = {}) {
+  registerCapability("typed_form_submit");
+  const settings = { ...typedClientSettings(tracking), ...options };
+  return {
+    submit(input) {
+      const fields = presentFields(input.fields);
+      const { violations, hash } = judgeLeadForm(
+        input.kind,
+        input.formId,
+        fields,
+        contracts,
+        settings
+      );
+      const metadata = {
+        form: {
+          id: input.formId,
+          action: input.action ?? null,
+          fields: fields.map(([role, value]) => ({
+            name: role,
+            type: INPUT_TYPES[primitiveOf(role) ?? "string"],
+            label: labelOf(role),
+            value,
+            role
+          })),
+          kind: input.kind,
+          contract_version: LEAD_FORM_REGISTRY_VERSION,
+          ...hash ? { contract_hash: hash } : {},
+          ...input.extra?.length ? { extra: input.extra } : {},
+          ...violations.length > 0 ? { contract_violations: violations.slice(0, MAX_CONTRACT_VIOLATIONS) } : {}
+        },
+        page: { path: typeof window === "undefined" ? "/" : window.location.pathname }
+      };
+      tracking.trackEvent("form_submit", metadata);
+      return metadata;
+    }
+  };
+}
+function judgeLeadForm(kind, formId, fields, contracts, settings) {
+  const generated = contracts?.contracts[kind];
+  const live = liveContract(settings.trackingConfig, kind);
+  const violations = check(live === void 0 ? generated : fromLive(live), fields);
+  const liveHash = live === void 0 ? void 0 : live?.contract_hash ?? null;
+  if (contracts && (liveHash !== void 0 && (generated?.hash ?? null) !== liveHash || contracts.registryVersion !== LEAD_FORM_REGISTRY_VERSION)) {
+    violations.push({ role: null, rule: "contract_behind" });
+  }
+  if (violations.length > 0 && (settings.debug || settings.environment === "development")) {
+    const message = `[AranovaTracking] lead form "${formId}" (${kind}) breaks its contract: ${violations.map((v) => `${v.rule}${v.role ? ` (${v.role})` : ""}`).join(", ")}`;
+    console.error(message);
+    if (settings.debug) throw new Error(message);
+  }
+  return {
+    violations,
+    hash: liveHash === void 0 ? generated?.hash ?? null : liveHash
+  };
+}
+function liveContract(ref, kind) {
+  const leadForms = ref ? getTrackingConfigRuntime(ref).leadForms() : null;
+  if (!leadForms) return void 0;
+  return leadForms.contracts.find((c) => c.form_kind === kind) ?? null;
+}
+function fromLive(live) {
+  if (!live) return void 0;
+  return {
+    requires: live.requires.map((r) => ({
+      role: r.role,
+      requiredWhen: r.required_when ? { role: r.required_when.role, anyOf: r.required_when.any_of } : null
+    })),
+    requiresAny: live.requires_any.map((g) => g.roles),
+    // Deprecated keys still resolve: a cached form may send them (ADR-0024 §7).
+    options: Object.fromEntries(live.options.map((o) => [o.role, o.options.map((x) => x.key)]))
+  };
+}
+function presentFields(fields) {
+  return Object.entries(fields).map(([role, value]) => [role, normalize(role, value)]).filter((entry) => !isBlank(entry[1])).sort(([a], [b]) => (ROLE_ORDER.get(a) ?? 999) - (ROLE_ORDER.get(b) ?? 999));
+}
+function normalize(role, value) {
+  if (typeof value !== "string") return value;
+  const trimmed = value.trim();
+  const primitive = primitiveOf(role);
+  if (primitive === "phone") return toE164(trimmed) ?? trimmed;
+  if (primitive === "email") return trimmed.toLowerCase();
+  return primitive === "text" ? value : trimmed;
+}
+function isBlank(value) {
+  return value === void 0 || value === null || typeof value === "string" && value.trim() === "" || Array.isArray(value) && value.length === 0;
+}
+function check(contract, fields) {
+  const answered = new Map(fields);
+  const violations = [];
+  for (const [role, value] of fields) {
+    const primitive = primitiveOf(role);
+    if (!primitive) {
+      violations.push({ role: CONTRACT_NAME.test(role) ? role : null, rule: "unknown_role" });
+      continue;
+    }
+    if (!(0, import_mini4.safeParse)(leadFormPrimitiveSchemas[primitive], value).success) {
+      violations.push({ role, rule: "invalid_value" });
+      continue;
+    }
+    const allowed = contract?.options[role] ?? registryOptions(role);
+    if (allowed?.length && optionKeys(value).some((key) => !allowed.includes(key))) {
+      violations.push({ role, rule: "unknown_option" });
+    }
+  }
+  for (const { role, requiredWhen } of contract?.requires ?? []) {
+    const owing = requiredWhen === null || optionKeys(answered.get(requiredWhen.role)).some((key) => requiredWhen.anyOf.includes(key));
+    if (owing && !answered.has(role)) violations.push({ role, rule: "missing_required" });
+  }
+  for (const group of contract?.requiresAny ?? []) {
+    if (!group.some((role) => answered.has(role))) {
+      violations.push({ role: group.join("|"), rule: "missing_any_of" });
+    }
+  }
+  return violations;
+}
+function primitiveOf(role) {
+  if (ADD_ON.test(role)) return "bool";
+  return KNOWN_ROLES.has(role) ? LEAD_FORM_ROLE_SPECS[role].primitive : null;
+}
+function labelOf(role) {
+  if (ADD_ON.test(role)) return role.slice("add_on:".length).replaceAll(/[_-]+/g, " ");
+  return KNOWN_ROLES.has(role) ? LEAD_FORM_ROLE_SPECS[role].smsLabel || null : null;
+}
+function registryOptions(role) {
+  const spec = KNOWN_ROLES.has(role) ? LEAD_FORM_ROLE_SPECS[role] : void 0;
+  return spec && "options" in spec ? spec.options.map((o) => o.key) : void 0;
+}
+function optionKeys(value) {
+  if (typeof value === "string") return [value];
+  return Array.isArray(value) ? value.filter((v) => typeof v === "string") : [];
+}
+
 // ../tracking-core/src/resources/sales/bookings.ts
 var newBookingAttemptKey = uuidV4;
 
@@ -4265,7 +4416,7 @@ function GoogleAdsTracking(props) {
 var import_react6 = require("react");
 
 // package.json
-var version = "1.14.0";
+var version = "1.14.1";
 
 // ../tracking-core/src/phone-react.tsx
 var import_react5 = require("react");
@@ -4587,7 +4738,11 @@ function useBookingSubmit(bookings, options = {}) {
   const attemptKey = (0, import_react7.useRef)(null);
   const [booked, setBooked] = (0, import_react7.useState)(null);
   const inFlight = (0, import_react7.useRef)(null);
-  const { formSubmit, simulate } = options;
+  const { simulate, contracts } = options;
+  const formSubmit = (0, import_react7.useMemo)(
+    () => options.formSubmit && contracts ? { ...options.formSubmit, contracts } : options.formSubmit,
+    [options.formSubmit, contracts]
+  );
   const submit = (0, import_react7.useCallback)(
     (input) => {
       if (inFlight.current) return inFlight.current;
@@ -4639,145 +4794,6 @@ function useBookingSubmit(bookings, options = {}) {
   const status = submitting ? "submitting" : outcome?.status ?? "idle";
   return { status, outcome, booked, submit, updateBooking, reset };
 }
-
-// ../tracking-core/src/lead-forms/submit.ts
-var import_mini4 = require("zod/mini");
-var KNOWN_ROLES = new Set(LEAD_FORM_ROLES);
-var ROLE_ORDER = new Map(LEAD_FORM_ROLES.map((role, index) => [role, index]));
-var ADD_ON = /^add_on:[a-z0-9_-]{1,48}$/;
-var CONTRACT_NAME = /^[a-z][a-z0-9_]{0,47}(:[a-z0-9_-]{1,48})?$/;
-var INPUT_TYPES = {
-  string: "text",
-  text: "textarea",
-  enum: "select",
-  multi_enum: "select",
-  bool: "checkbox",
-  date: "date",
-  time_window: "time",
-  phone: "tel",
-  email: "email",
-  address: "address",
-  number: "number"
-};
-function createLeadFormSubmit(tracking, contracts, options = {}) {
-  registerCapability("typed_form_submit");
-  const settings = { ...typedClientSettings(tracking), ...options };
-  return {
-    submit(input) {
-      const generated = contracts.contracts[input.kind];
-      const live = liveContract(settings.trackingConfig, input.kind);
-      const fields = presentFields(input.fields);
-      const violations = check(live === void 0 ? generated : fromLive(live), fields);
-      const liveHash = live === void 0 ? void 0 : live?.contract_hash ?? null;
-      if (liveHash !== void 0 && (generated?.hash ?? null) !== liveHash || contracts.registryVersion !== LEAD_FORM_REGISTRY_VERSION) {
-        violations.push({ role: null, rule: "contract_behind" });
-      }
-      const hash = liveHash === void 0 ? generated?.hash ?? null : liveHash;
-      const metadata = {
-        form: {
-          id: input.formId,
-          action: input.action ?? null,
-          fields: fields.map(([role, value]) => ({
-            name: role,
-            type: INPUT_TYPES[primitiveOf(role) ?? "string"],
-            label: labelOf(role),
-            value,
-            role
-          })),
-          kind: input.kind,
-          contract_version: LEAD_FORM_REGISTRY_VERSION,
-          ...hash ? { contract_hash: hash } : {},
-          ...input.extra?.length ? { extra: input.extra } : {},
-          ...violations.length > 0 ? { contract_violations: violations.slice(0, MAX_CONTRACT_VIOLATIONS) } : {}
-        },
-        page: { path: typeof window === "undefined" ? "/" : window.location.pathname }
-      };
-      if (violations.length > 0 && (settings.debug || settings.environment === "development")) {
-        const message = `[AranovaTracking] lead form "${input.formId}" (${input.kind}) breaks its contract: ${violations.map((v) => `${v.rule}${v.role ? ` (${v.role})` : ""}`).join(", ")}`;
-        console.error(message);
-        if (settings.debug) throw new Error(message);
-      }
-      tracking.trackEvent("form_submit", metadata);
-      return metadata;
-    }
-  };
-}
-function liveContract(ref, kind) {
-  const leadForms = ref ? getTrackingConfigRuntime(ref).leadForms() : null;
-  if (!leadForms) return void 0;
-  return leadForms.contracts.find((c) => c.form_kind === kind) ?? null;
-}
-function fromLive(live) {
-  if (!live) return void 0;
-  return {
-    requires: live.requires.map((r) => ({
-      role: r.role,
-      requiredWhen: r.required_when ? { role: r.required_when.role, anyOf: r.required_when.any_of } : null
-    })),
-    requiresAny: live.requires_any.map((g) => g.roles),
-    // Deprecated keys still resolve: a cached form may send them (ADR-0024 §7).
-    options: Object.fromEntries(live.options.map((o) => [o.role, o.options.map((x) => x.key)]))
-  };
-}
-function presentFields(fields) {
-  return Object.entries(fields).map(([role, value]) => [role, normalize(role, value)]).filter((entry) => !isBlank(entry[1])).sort(([a], [b]) => (ROLE_ORDER.get(a) ?? 999) - (ROLE_ORDER.get(b) ?? 999));
-}
-function normalize(role, value) {
-  if (typeof value !== "string") return value;
-  const trimmed = value.trim();
-  const primitive = primitiveOf(role);
-  if (primitive === "phone") return toE164(trimmed) ?? trimmed;
-  if (primitive === "email") return trimmed.toLowerCase();
-  return primitive === "text" ? value : trimmed;
-}
-function isBlank(value) {
-  return value === void 0 || value === null || typeof value === "string" && value.trim() === "" || Array.isArray(value) && value.length === 0;
-}
-function check(contract, fields) {
-  const answered = new Map(fields);
-  const violations = [];
-  for (const [role, value] of fields) {
-    const primitive = primitiveOf(role);
-    if (!primitive) {
-      violations.push({ role: CONTRACT_NAME.test(role) ? role : null, rule: "unknown_role" });
-      continue;
-    }
-    if (!(0, import_mini4.safeParse)(leadFormPrimitiveSchemas[primitive], value).success) {
-      violations.push({ role, rule: "invalid_value" });
-      continue;
-    }
-    const allowed = contract?.options[role] ?? registryOptions(role);
-    if (allowed?.length && optionKeys(value).some((key) => !allowed.includes(key))) {
-      violations.push({ role, rule: "unknown_option" });
-    }
-  }
-  for (const { role, requiredWhen } of contract?.requires ?? []) {
-    const owing = requiredWhen === null || optionKeys(answered.get(requiredWhen.role)).some((key) => requiredWhen.anyOf.includes(key));
-    if (owing && !answered.has(role)) violations.push({ role, rule: "missing_required" });
-  }
-  for (const group of contract?.requiresAny ?? []) {
-    if (!group.some((role) => answered.has(role))) {
-      violations.push({ role: group.join("|"), rule: "missing_any_of" });
-    }
-  }
-  return violations;
-}
-function primitiveOf(role) {
-  if (ADD_ON.test(role)) return "bool";
-  return KNOWN_ROLES.has(role) ? LEAD_FORM_ROLE_SPECS[role].primitive : null;
-}
-function labelOf(role) {
-  if (ADD_ON.test(role)) return role.slice("add_on:".length).replaceAll(/[_-]+/g, " ");
-  return KNOWN_ROLES.has(role) ? LEAD_FORM_ROLE_SPECS[role].smsLabel || null : null;
-}
-function registryOptions(role) {
-  const spec = KNOWN_ROLES.has(role) ? LEAD_FORM_ROLE_SPECS[role] : void 0;
-  return spec && "options" in spec ? spec.options.map((o) => o.key) : void 0;
-}
-function optionKeys(value) {
-  if (typeof value === "string") return [value];
-  return Array.isArray(value) ? value.filter((v) => typeof v === "string") : [];
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AdPlatformTracking,