@aranova/tracking-react 0.18.0 → 0.19.0

package/README.md

@@ -112,7 +112,7 @@ export function LeadForm() {
 }
 ```
 
-`fields[].value` can be any JSON value: string, number, boolean, null, array, or object. Values must be JSON-serializable because events are stored as JSONB. Only send reviewed, allowlisted, non-sensitive values; do not send names, emails, phone numbers entered by the visitor, addresses, payment data, medical details, passwords, file contents, or free-text messages.
+`fields[].value` can be any JSON value: string, number, boolean, null, array, or object. Values must be JSON-serializable because events are stored as first-party JSONB. Intentionally submitted lead fields may include raw names, emails, phone numbers, addresses, selections, free-text messages, and submitted file data for first-party analytics and lead operations. Build the array explicitly from the submitted form; the SDK never scrapes arbitrary DOM fields. `File`/`Blob` objects must be converted to a JSON representation, and the complete event metadata must fit the 4 KB limit; upload larger files separately and send their storage reference. Never send passwords, authentication tokens, payment-card/bank credentials, or private keys. Apply the client's privacy notice, consent, retention, and regulated-data requirements. Google offline matching uses normalized, server-side SHA-256-hashed identifiers — not raw free-text/file metadata.
 
 ### Phone clicks (`tel:` taps) — manual or auto-capture
 

package/dist/index.d.mts

@@ -1,9 +1,9 @@
 import * as react from 'react';
 import { ReactNode, CSSProperties, InputHTMLAttributes, ChangeEvent, FocusEvent } from 'react';
-import { T as TrackingParams, a as TrackingInstallSurface, b as TrackingEnvironment, c as TrackingClientContext, d as TrackingEventCreatePayload, e as TrackingSessionUpsertPayload, F as FormSubmitConfig, f as FormSubmitMetadata, G as GtagEnvironmentMap, M as MetaPixelEnvironmentMap, C as ConsentState, g as ConsentChoiceState, h as ConsentSource, P as PhoneConfig, i as ParsedPhone, j as PhoneDisplayFormat } from './phone-utils-DlAQK-gU.mjs';
-export { k as ConsentChoice, D as DEFAULT_DECLINE_TTL_DAYS, l as DEFAULT_PHONE_COUNTRY, J as JsonValue, S as SetConsentOptions, m as TrackedField, n as TrackingInitConfig, o as formSubmitConfigSchema, p as formSubmitMetadataSchema, q as formatPhone, r as formatPhoneAsTyped, s as getConsentChoice, t as getConsentState, u as jsonValueSchema, v as onConsentChange, w as optIn, x as optOut, y as parsePhone, z as phoneField, A as resetConsent, B as setConsentState, E as toE164 } from './phone-utils-DlAQK-gU.mjs';
-import { T as TrackingConfigReference, C as ConversionConfig } from './sales-QqKh6_iy.mjs';
-export { A as AranovaApiError, B as BusinessConfig, a as BusinessConfigFeatures, b as BusinessConfigService, c as CompareTo, d as ConversionConfigStore, e as CurrencyRevenue, f as CustomerCurrencyDelta, g as CustomerCurrencyTotal, h as CustomerGetOptions, i as CustomerGetResult, j as CustomerKpis, k as CustomerKpisDeltas, l as CustomerKpisPrevious, m as CustomerListPage, n as CustomerListQuery, o as CustomerProfile, p as CustomerSegment, q as CustomerSegmentCount, r as CustomerSortField, s as CustomerSummary, t as CustomerSummaryQuery, D as DistinctCustomersByCurrency, G as Granularity, N as NAMED_RANGES, u as NamedRange, P as PublicServiceItem, S as SUPPORTED_CURRENCIES, v as Sale, w as SaleCursorPage, x as SaleFilters, y as SaleInput, z as SaleItem, E as SaleItemInput, F as SaleKeysetSortField, H as SaleListPage, I as SaleListQuery, J as SaleListQueryV2, K as SaleService, L as SaleServiceInput, M as SaleSortField, O as SaleSortOrder, Q as SaleSummary, R as SaleSummaryPrevious, U as SaleSummaryQuery, V as SaleSummaryQueryV2, W as SaleSummaryV2, X as SaleUpdateInput, Y as SalesBusinessClient, Z as SalesCategoryBreakdown, _ as SalesClient, $ as SalesClientConfig, a0 as SalesCustomersClient, a1 as SalesServiceBreakdown, a2 as SalesTransportConfig, a3 as SalesTrendPoint, a4 as SummaryCurrencyDelta, a5 as SummaryDeltas, a6 as SummaryWindow, a7 as SupportedCurrency, a8 as TRACKING_RANGES, a9 as TrackingOverviewRange, aa as createSalesClient, ab as fetchServices, ac as formatDateInTz, ad as formatMoney, ae as fromMinor, af as getTrackingConfigRuntime, ag as resolveConversionConfig, ah as saleCreateSchema, ai as saleItemSchema, aj as saleServiceSchema, ak as saleUpdateSchema, al as salesRequest, am as toMinor } from './sales-QqKh6_iy.mjs';
+import { T as TrackingParams, a as TrackingInstallSurface, b as TrackingEnvironment, c as TrackingClientContext, d as TrackingEventCreatePayload, e as TrackingSessionUpsertPayload, F as FormSubmitConfig, f as FormSubmitMetadata, G as GtagEnvironmentMap, M as MetaPixelEnvironmentMap, C as ConsentState, g as ConsentChoiceState, h as ConsentSource, P as PhoneConfig, i as ParsedPhone, j as PhoneDisplayFormat } from './phone-utils-B2vHJkNz.mjs';
+export { k as ConsentChoice, D as DEFAULT_DECLINE_TTL_DAYS, l as DEFAULT_PHONE_COUNTRY, J as JsonValue, S as SetConsentOptions, m as TrackedField, n as TrackingInitConfig, o as formSubmitConfigSchema, p as formSubmitMetadataSchema, q as formatPhone, r as formatPhoneAsTyped, s as getConsentChoice, t as getConsentState, u as jsonValueSchema, v as onConsentChange, w as optIn, x as optOut, y as parsePhone, z as phoneField, A as resetConsent, B as setConsentState, E as toE164 } from './phone-utils-B2vHJkNz.mjs';
+import { T as TrackingConfigReference, C as ConversionConfig } from './sales--WzOzyiO.mjs';
+export { A as AranovaApiError, B as BusinessConfig, a as BusinessConfigFeatures, b as BusinessConfigService, c as CompareTo, d as ConversionConfigStore, e as ConversionUserData, f as CurrencyRevenue, g as CustomerCurrencyDelta, h as CustomerCurrencyTotal, i as CustomerGetOptions, j as CustomerGetResult, k as CustomerKpis, l as CustomerKpisDeltas, m as CustomerKpisPrevious, n as CustomerListPage, o as CustomerListQuery, p as CustomerProfile, q as CustomerSegment, r as CustomerSegmentCount, s as CustomerSortField, t as CustomerSummary, u as CustomerSummaryQuery, D as DistinctCustomersByCurrency, G as Granularity, N as NAMED_RANGES, v as NamedRange, P as PublicServiceItem, S as SUPPORTED_CURRENCIES, w as Sale, x as SaleCursorPage, y as SaleFilters, z as SaleInput, E as SaleItem, F as SaleItemInput, H as SaleKeysetSortField, I as SaleListPage, J as SaleListQuery, K as SaleListQueryV2, L as SaleService, M as SaleServiceInput, O as SaleSortField, Q as SaleSortOrder, R as SaleSummary, U as SaleSummaryPrevious, V as SaleSummaryQuery, W as SaleSummaryQueryV2, X as SaleSummaryV2, Y as SaleUpdateInput, Z as SalesBusinessClient, _ as SalesCategoryBreakdown, $ as SalesClient, a0 as SalesClientConfig, a1 as SalesCustomersClient, a2 as SalesServiceBreakdown, a3 as SalesTransportConfig, a4 as SalesTrendPoint, a5 as SummaryCurrencyDelta, a6 as SummaryDeltas, a7 as SummaryWindow, a8 as SupportedCurrency, a9 as TRACKING_RANGES, aa as TrackingOverviewRange, ab as clearStashedUserData, ac as createSalesClient, ad as fetchServices, ae as formatDateInTz, af as formatMoney, ag as fromMinor, ah as getTrackingConfigRuntime, ai as resolveConversionConfig, aj as saleCreateSchema, ak as saleItemSchema, al as saleServiceSchema, am as saleUpdateSchema, an as salesRequest, ao as stashUserData, ap as toMinor } from './sales--WzOzyiO.mjs';
 import * as src from 'src';
 import { z } from 'zod';
 import { CountryCode } from 'libphonenumber-js';
@@ -60,7 +60,7 @@ declare function ConsentBanner({ message, title, acceptLabel, declineLabel, poli
 /**
  * Attribution query/cookie keys captured by the SDK.
  */
-declare const TRACKING_PARAM_KEYS: readonly ["gclid", "fbclid", "utm_source", "utm_medium", "utm_campaign", "utm_term", "utm_content"];
+declare const TRACKING_PARAM_KEYS: readonly ["gclid", "wbraid", "gbraid", "fbclid", "utm_source", "utm_medium", "utm_campaign", "utm_term", "utm_content"];
 type TrackingParamKey = (typeof TRACKING_PARAM_KEYS)[number];
 /**
  * Capture tracking params from a URL, persist them to first-party cookies, and

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 import * as react from 'react';
 import { ReactNode, CSSProperties, InputHTMLAttributes, ChangeEvent, FocusEvent } from 'react';
-import { T as TrackingParams, a as TrackingInstallSurface, b as TrackingEnvironment, c as TrackingClientContext, d as TrackingEventCreatePayload, e as TrackingSessionUpsertPayload, F as FormSubmitConfig, f as FormSubmitMetadata, G as GtagEnvironmentMap, M as MetaPixelEnvironmentMap, C as ConsentState, g as ConsentChoiceState, h as ConsentSource, P as PhoneConfig, i as ParsedPhone, j as PhoneDisplayFormat } from './phone-utils-DlAQK-gU.js';
-export { k as ConsentChoice, D as DEFAULT_DECLINE_TTL_DAYS, l as DEFAULT_PHONE_COUNTRY, J as JsonValue, S as SetConsentOptions, m as TrackedField, n as TrackingInitConfig, o as formSubmitConfigSchema, p as formSubmitMetadataSchema, q as formatPhone, r as formatPhoneAsTyped, s as getConsentChoice, t as getConsentState, u as jsonValueSchema, v as onConsentChange, w as optIn, x as optOut, y as parsePhone, z as phoneField, A as resetConsent, B as setConsentState, E as toE164 } from './phone-utils-DlAQK-gU.js';
-import { T as TrackingConfigReference, C as ConversionConfig } from './sales-QqKh6_iy.js';
-export { A as AranovaApiError, B as BusinessConfig, a as BusinessConfigFeatures, b as BusinessConfigService, c as CompareTo, d as ConversionConfigStore, e as CurrencyRevenue, f as CustomerCurrencyDelta, g as CustomerCurrencyTotal, h as CustomerGetOptions, i as CustomerGetResult, j as CustomerKpis, k as CustomerKpisDeltas, l as CustomerKpisPrevious, m as CustomerListPage, n as CustomerListQuery, o as CustomerProfile, p as CustomerSegment, q as CustomerSegmentCount, r as CustomerSortField, s as CustomerSummary, t as CustomerSummaryQuery, D as DistinctCustomersByCurrency, G as Granularity, N as NAMED_RANGES, u as NamedRange, P as PublicServiceItem, S as SUPPORTED_CURRENCIES, v as Sale, w as SaleCursorPage, x as SaleFilters, y as SaleInput, z as SaleItem, E as SaleItemInput, F as SaleKeysetSortField, H as SaleListPage, I as SaleListQuery, J as SaleListQueryV2, K as SaleService, L as SaleServiceInput, M as SaleSortField, O as SaleSortOrder, Q as SaleSummary, R as SaleSummaryPrevious, U as SaleSummaryQuery, V as SaleSummaryQueryV2, W as SaleSummaryV2, X as SaleUpdateInput, Y as SalesBusinessClient, Z as SalesCategoryBreakdown, _ as SalesClient, $ as SalesClientConfig, a0 as SalesCustomersClient, a1 as SalesServiceBreakdown, a2 as SalesTransportConfig, a3 as SalesTrendPoint, a4 as SummaryCurrencyDelta, a5 as SummaryDeltas, a6 as SummaryWindow, a7 as SupportedCurrency, a8 as TRACKING_RANGES, a9 as TrackingOverviewRange, aa as createSalesClient, ab as fetchServices, ac as formatDateInTz, ad as formatMoney, ae as fromMinor, af as getTrackingConfigRuntime, ag as resolveConversionConfig, ah as saleCreateSchema, ai as saleItemSchema, aj as saleServiceSchema, ak as saleUpdateSchema, al as salesRequest, am as toMinor } from './sales-QqKh6_iy.js';
+import { T as TrackingParams, a as TrackingInstallSurface, b as TrackingEnvironment, c as TrackingClientContext, d as TrackingEventCreatePayload, e as TrackingSessionUpsertPayload, F as FormSubmitConfig, f as FormSubmitMetadata, G as GtagEnvironmentMap, M as MetaPixelEnvironmentMap, C as ConsentState, g as ConsentChoiceState, h as ConsentSource, P as PhoneConfig, i as ParsedPhone, j as PhoneDisplayFormat } from './phone-utils-B2vHJkNz.js';
+export { k as ConsentChoice, D as DEFAULT_DECLINE_TTL_DAYS, l as DEFAULT_PHONE_COUNTRY, J as JsonValue, S as SetConsentOptions, m as TrackedField, n as TrackingInitConfig, o as formSubmitConfigSchema, p as formSubmitMetadataSchema, q as formatPhone, r as formatPhoneAsTyped, s as getConsentChoice, t as getConsentState, u as jsonValueSchema, v as onConsentChange, w as optIn, x as optOut, y as parsePhone, z as phoneField, A as resetConsent, B as setConsentState, E as toE164 } from './phone-utils-B2vHJkNz.js';
+import { T as TrackingConfigReference, C as ConversionConfig } from './sales--WzOzyiO.js';
+export { A as AranovaApiError, B as BusinessConfig, a as BusinessConfigFeatures, b as BusinessConfigService, c as CompareTo, d as ConversionConfigStore, e as ConversionUserData, f as CurrencyRevenue, g as CustomerCurrencyDelta, h as CustomerCurrencyTotal, i as CustomerGetOptions, j as CustomerGetResult, k as CustomerKpis, l as CustomerKpisDeltas, m as CustomerKpisPrevious, n as CustomerListPage, o as CustomerListQuery, p as CustomerProfile, q as CustomerSegment, r as CustomerSegmentCount, s as CustomerSortField, t as CustomerSummary, u as CustomerSummaryQuery, D as DistinctCustomersByCurrency, G as Granularity, N as NAMED_RANGES, v as NamedRange, P as PublicServiceItem, S as SUPPORTED_CURRENCIES, w as Sale, x as SaleCursorPage, y as SaleFilters, z as SaleInput, E as SaleItem, F as SaleItemInput, H as SaleKeysetSortField, I as SaleListPage, J as SaleListQuery, K as SaleListQueryV2, L as SaleService, M as SaleServiceInput, O as SaleSortField, Q as SaleSortOrder, R as SaleSummary, U as SaleSummaryPrevious, V as SaleSummaryQuery, W as SaleSummaryQueryV2, X as SaleSummaryV2, Y as SaleUpdateInput, Z as SalesBusinessClient, _ as SalesCategoryBreakdown, $ as SalesClient, a0 as SalesClientConfig, a1 as SalesCustomersClient, a2 as SalesServiceBreakdown, a3 as SalesTransportConfig, a4 as SalesTrendPoint, a5 as SummaryCurrencyDelta, a6 as SummaryDeltas, a7 as SummaryWindow, a8 as SupportedCurrency, a9 as TRACKING_RANGES, aa as TrackingOverviewRange, ab as clearStashedUserData, ac as createSalesClient, ad as fetchServices, ae as formatDateInTz, af as formatMoney, ag as fromMinor, ah as getTrackingConfigRuntime, ai as resolveConversionConfig, aj as saleCreateSchema, ak as saleItemSchema, al as saleServiceSchema, am as saleUpdateSchema, an as salesRequest, ao as stashUserData, ap as toMinor } from './sales--WzOzyiO.js';
 import * as src from 'src';
 import { z } from 'zod';
 import { CountryCode } from 'libphonenumber-js';
@@ -60,7 +60,7 @@ declare function ConsentBanner({ message, title, acceptLabel, declineLabel, poli
 /**
  * Attribution query/cookie keys captured by the SDK.
  */
-declare const TRACKING_PARAM_KEYS: readonly ["gclid", "fbclid", "utm_source", "utm_medium", "utm_campaign", "utm_term", "utm_content"];
+declare const TRACKING_PARAM_KEYS: readonly ["gclid", "wbraid", "gbraid", "fbclid", "utm_source", "utm_medium", "utm_campaign", "utm_term", "utm_content"];
 type TrackingParamKey = (typeof TRACKING_PARAM_KEYS)[number];
 /**
  * Capture tracking params from a URL, persist them to first-party cookies, and

package/dist/index.js

@@ -33,6 +33,7 @@ __export(src_exports, {
   TRACKING_PARAM_KEYS: () => TRACKING_PARAM_KEYS,
   TRACKING_RANGES: () => TRACKING_RANGES,
   captureTrackingParamsFromLocation: () => captureTrackingParamsFromLocation,
+  clearStashedUserData: () => clearStashedUserData,
   createSalesClient: () => createSalesClient,
   createTracking: () => createTracking,
   createTrackingClientContext: () => createTrackingClientContext,
@@ -61,6 +62,7 @@ __export(src_exports, {
   saleUpdateSchema: () => saleUpdateSchema,
   salesRequest: () => salesRequest,
   setConsentState: () => setConsentState,
+  stashUserData: () => stashUserData,
   toE164: () => toE164,
   toMinor: () => toMinor,
   useConsent: () => useConsent,
@@ -79,6 +81,140 @@ var import_react2 = require("react");
 // src/hooks.ts
 var import_react = require("react");
 
+// ../tracking-core/src/phone.ts
+var import_libphonenumber_js = require("libphonenumber-js");
+var DEFAULT_PHONE_COUNTRY = "CA";
+function parsePhone(raw, country) {
+  const region = country ?? DEFAULT_PHONE_COUNTRY;
+  const parsed = (0, import_libphonenumber_js.parsePhoneNumberFromString)(raw ?? "", region);
+  if (!parsed) {
+    return { e164: null, national: "", international: "", country: region, isValid: false };
+  }
+  const isValid = parsed.isValid();
+  return {
+    // E.164 is only surfaced for a *valid* number — a possible-but-invalid input
+    // (e.g. too few digits) still parses but must not be transmitted.
+    e164: isValid ? parsed.number : null,
+    national: parsed.formatNational(),
+    international: parsed.formatInternational(),
+    country: parsed.country ?? region,
+    isValid
+  };
+}
+function toE164(raw, country) {
+  return parsePhone(raw, country).e164;
+}
+function formatPhone(value, format = "national", country) {
+  const parsed = parsePhone(value, country);
+  if (typeof format === "function") return format(parsed);
+  switch (format) {
+    case "international":
+      return parsed.international || value;
+    case "e164":
+      return parsed.e164 ?? value;
+    case "national":
+    default:
+      return parsed.national || value;
+  }
+}
+function formatPhoneAsTyped(raw, country) {
+  return new import_libphonenumber_js.AsYouType(country ?? DEFAULT_PHONE_COUNTRY).input(raw ?? "");
+}
+
+// ../tracking-core/src/user-data.ts
+var EMAIL_SHAPE = /^[^@\s]+@[^@\s]+\.[^@\s]+$/;
+var EMAIL_NAME_HINT = /e[-_]?mail/i;
+var PHONE_NAME_HINT = /(^|[^a-z])(phone|tel|mobile|cell)/i;
+var stash = { email: null, phoneNumber: null };
+function normalizeEmail(raw) {
+  if (typeof raw !== "string") return null;
+  const cleaned = raw.trim().toLowerCase();
+  return EMAIL_SHAPE.test(cleaned) ? cleaned : null;
+}
+function fieldText(field, key) {
+  const value = field[key];
+  return typeof value === "string" ? value : "";
+}
+function extractUserDataFromFormFields(fields, country) {
+  const result = { email: null, phoneNumber: null };
+  if (!Array.isArray(fields)) return result;
+  const passes = [
+    (field, _hint, type) => fieldText(field, "type").toLowerCase() === type,
+    (field, hint) => hint.test(fieldText(field, "name")) || hint.test(fieldText(field, "label"))
+  ];
+  for (const matches of passes) {
+    for (const raw of fields) {
+      if (raw === null || typeof raw !== "object") continue;
+      const field = raw;
+      if (typeof field.value !== "string" || field.value.length === 0) continue;
+      if (result.email === null && matches(field, EMAIL_NAME_HINT, "email")) {
+        result.email = normalizeEmail(field.value);
+      }
+      if (result.phoneNumber === null && matches(field, PHONE_NAME_HINT, "tel")) {
+        try {
+          result.phoneNumber = toE164(field.value, country);
+        } catch {
+        }
+      }
+    }
+    if (result.email !== null && result.phoneNumber !== null) break;
+  }
+  return result;
+}
+function stashUserData(data, country) {
+  const email = normalizeEmail(data.email);
+  let phoneNumber = null;
+  if (typeof data.phone === "string" && data.phone.length > 0) {
+    try {
+      phoneNumber = toE164(data.phone, country);
+    } catch {
+      phoneNumber = null;
+    }
+  }
+  stash = {
+    email: email ?? stash.email,
+    phoneNumber: phoneNumber ?? stash.phoneNumber
+  };
+}
+function stashUserDataFromFormFields(fields, country) {
+  try {
+    const extracted = extractUserDataFromFormFields(fields, country);
+    stash = {
+      email: extracted.email ?? stash.email,
+      phoneNumber: extracted.phoneNumber ?? stash.phoneNumber
+    };
+  } catch {
+  }
+}
+function clearStashedUserData() {
+  stash = { email: null, phoneNumber: null };
+}
+function applyUserDataForConversion(explicit, country) {
+  if (typeof window === "undefined" || typeof window.gtag !== "function") return false;
+  let email = stash.email;
+  let phoneNumber = stash.phoneNumber;
+  if (explicit) {
+    const normalizedEmail = normalizeEmail(explicit.email);
+    if (normalizedEmail) email = normalizedEmail;
+    if (typeof explicit.phone === "string" && explicit.phone.length > 0) {
+      try {
+        phoneNumber = toE164(explicit.phone, country) ?? phoneNumber;
+      } catch {
+      }
+    }
+  }
+  if (email === null && phoneNumber === null) return false;
+  try {
+    window.gtag("set", "user_data", {
+      ...email !== null ? { email } : {},
+      ...phoneNumber !== null ? { phone_number: phoneNumber } : {}
+    });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 // ../tracking-core/src/consent.ts
 var CONSENT_STATE_KEY = "consent_state";
 var CONSENT_TIMESTAMP_KEY = "consent_timestamp";
@@ -164,6 +300,13 @@ function setConsentState(state, options) {
   } catch {
   }
   pushConsentToPlatforms(state);
+  if (state === "denied") {
+    clearStashedUserData();
+    try {
+      if (typeof window.gtag === "function") window.gtag("set", "user_data", null);
+    } catch {
+    }
+  }
   notifyConsentChanged({ state, source: "explicit", updatedAt, expiresAt });
 }
 function optIn() {
@@ -188,6 +331,11 @@ function resetConsent() {
 var TRACKING_COOKIE_MAX_AGE_SECONDS = 7776e3;
 var TRACKING_PARAM_KEYS = [
   "gclid",
+  // Google's iOS/Safari replacement click IDs — issued when privacy features
+  // withhold gclid (wbraid: web-to-web, gbraid: app-to-web). First-class
+  // citizens: captured, persisted, and attributed exactly like gclid.
+  "wbraid",
+  "gbraid",
   "fbclid",
   "utm_source",
   "utm_medium",
@@ -198,6 +346,8 @@ var TRACKING_PARAM_KEYS = [
 function createEmptyTrackingParams() {
   return {
     gclid: null,
+    wbraid: null,
+    gbraid: null,
     fbclid: null,
     utm_source: null,
     utm_medium: null,
@@ -529,6 +679,8 @@ function buildLandingPayloadFields(sessionId, override) {
   if (params === null) return {};
   return {
     landing_gclid: params.gclid ?? null,
+    landing_wbraid: params.wbraid ?? null,
+    landing_gbraid: params.gbraid ?? null,
     landing_fbclid: params.fbclid ?? null,
     landing_utm_source: params.utm_source ?? null,
     landing_utm_medium: params.utm_medium ?? null,
@@ -556,6 +708,8 @@ function createTrackingSessionUpsertPayload(trackingParams, input, context) {
     session_id: input.sessionId,
     visitor_id: input.visitorId ?? null,
     gclid: trackingParams.gclid,
+    wbraid: trackingParams.wbraid,
+    gbraid: trackingParams.gbraid,
     fbclid: trackingParams.fbclid,
     fbc: getFbcCookie(),
     fbp: getFbpCookie(),
@@ -577,6 +731,8 @@ function createTrackingEventCreatePayload(trackingParams, input, context) {
     session_id: input.sessionId,
     event_type: input.eventType,
     gclid: trackingParams.gclid,
+    wbraid: trackingParams.wbraid,
+    gbraid: trackingParams.gbraid,
     fbclid: trackingParams.fbclid,
     fbc: getFbcCookie(),
     fbp: getFbpCookie(),
@@ -606,14 +762,12 @@ function markFired(input) {
   } catch {
   }
 }
-function fireOnce(input) {
+function fireConversionWithConsent(input, options) {
+  if (getConsentState() === "denied") return;
   if (alreadyFired(input)) return;
+  applyUserDataForConversion(options?.userData);
   if (fireGtagConversion(input)) markFired(input);
 }
-function fireConversionWithConsent(input) {
-  if (getConsentState() === "denied") return;
-  fireOnce(input);
-}
 
 // ../tracking-core/src/resources/conversion-config.ts
 function isStringMap(value) {
@@ -1058,6 +1212,7 @@ var TrackingConfigRuntime = class {
       if (!firing || getConsentState() === "denied") continue;
       const currency = item.currency ?? firing.currency ?? null;
       const value = item.value ?? (firing.value_cents != null && currency ? fromMinor(firing.value_cents, currency) : null);
+      applyUserDataForConversion();
       fireGtagConversion({
         sendTo: firing.send_to,
         value,
@@ -1589,6 +1744,8 @@ function createTrackingClient(config) {
       session_id: sessionId,
       visitor_id: visitorId,
       gclid: params.gclid,
+      wbraid: params.wbraid,
+      gbraid: params.gbraid,
       fbclid: params.fbclid,
       fbc: getFbcCookie(),
       fbp: getFbpCookie(),
@@ -1635,6 +1792,13 @@ function createTrackingClient(config) {
   function trackEvent(input) {
     if (destroyed) return;
     if (!input || typeof input.eventType !== "string" || input.eventType.length === 0) return;
+    if (input.eventType === "form_submit" && getConsentState() !== "denied") {
+      try {
+        const fields = input.metadata?.form?.fields;
+        if (fields) stashUserDataFromFormFields(fields, config.phone?.defaultCountry);
+      } catch {
+      }
+    }
     const occurredAt = input.occurredAt instanceof Date ? input.occurredAt.toISOString() : typeof input.occurredAt === "string" ? input.occurredAt : (/* @__PURE__ */ new Date()).toISOString();
     queue.push({
       event_type: input.eventType,
@@ -2598,46 +2762,6 @@ function attachCtaClickCapture(client, config) {
   };
 }
 
-// ../tracking-core/src/phone.ts
-var import_libphonenumber_js = require("libphonenumber-js");
-var DEFAULT_PHONE_COUNTRY = "CA";
-function parsePhone(raw, country) {
-  const region = country ?? DEFAULT_PHONE_COUNTRY;
-  const parsed = (0, import_libphonenumber_js.parsePhoneNumberFromString)(raw ?? "", region);
-  if (!parsed) {
-    return { e164: null, national: "", international: "", country: region, isValid: false };
-  }
-  const isValid = parsed.isValid();
-  return {
-    // E.164 is only surfaced for a *valid* number — a possible-but-invalid input
-    // (e.g. too few digits) still parses but must not be transmitted.
-    e164: isValid ? parsed.number : null,
-    national: parsed.formatNational(),
-    international: parsed.formatInternational(),
-    country: parsed.country ?? region,
-    isValid
-  };
-}
-function toE164(raw, country) {
-  return parsePhone(raw, country).e164;
-}
-function formatPhone(value, format = "national", country) {
-  const parsed = parsePhone(value, country);
-  if (typeof format === "function") return format(parsed);
-  switch (format) {
-    case "international":
-      return parsed.international || value;
-    case "e164":
-      return parsed.e164 ?? value;
-    case "national":
-    default:
-      return parsed.national || value;
-  }
-}
-function formatPhoneAsTyped(raw, country) {
-  return new import_libphonenumber_js.AsYouType(country ?? DEFAULT_PHONE_COUNTRY).input(raw ?? "");
-}
-
 // ../tracking-core/src/triggers/phone-click-capture.ts
 var DEFAULT_TEL_SELECTOR = 'a[href^="tel:"]';
 function safeDecodeURIComponent(value) {
@@ -2747,6 +2871,8 @@ async function salesRequest(config, method, path, body) {
 // ../tracking-core/src/resources/sales/client.ts
 function fireRecordedConversions(firing, input, recorded, sale, currency) {
   if (!firing) return;
+  const userData = input.customer_email || input.customer_phone ? { email: input.customer_email ?? null, phone: input.customer_phone ?? null } : null;
+  if (userData && getConsentState() !== "denied") stashUserData(userData);
   const txnBase = input.external_id ?? sale.id;
   for (const item of recorded) {
     if (!item.service) continue;
@@ -2761,12 +2887,15 @@ function fireRecordedConversions(firing, input, recorded, sale, currency) {
     const config = firing.getFiring(item.service);
     if (!config) continue;
     const cents = item.amount_cents ?? config.value_cents ?? null;
-    fireConversionWithConsent({
-      sendTo: config.send_to,
-      value: cents != null ? fromMinor(cents, currency) : null,
-      currency: config.currency ?? currency,
-      transactionId: `${txnBase}:${item.service}`
-    });
+    fireConversionWithConsent(
+      {
+        sendTo: config.send_to,
+        value: cents != null ? fromMinor(cents, currency) : null,
+        currency: config.currency ?? currency,
+        transactionId: `${txnBase}:${item.service}`
+      },
+      { userData }
+    );
   }
 }
 function createSalesClient(config) {
@@ -2801,6 +2930,7 @@ function createSalesClient(config) {
     recordSale: record,
     trackConversion(key, options) {
       if (config.firing && "fireConversion" in config.firing) {
+        if (options?.userData && getConsentState() !== "denied") stashUserData(options.userData);
         config.firing.fireConversion(key, {
           value: options?.value ?? void 0,
           currency: options?.currency ?? config.defaultCurrency ?? void 0,
@@ -2813,12 +2943,15 @@ function createSalesClient(config) {
       const currency = firing.currency ?? options?.currency ?? config.defaultCurrency ?? null;
       const cents = firing.value_cents ?? null;
       const value = options?.value ?? (cents != null && currency ? fromMinor(cents, currency) : null);
-      fireConversionWithConsent({
-        sendTo: firing.send_to,
-        value,
-        currency,
-        transactionId: options?.transactionId ?? null
-      });
+      fireConversionWithConsent(
+        {
+          sendTo: firing.send_to,
+          value,
+          currency,
+          transactionId: options?.transactionId ?? null
+        },
+        { userData: options?.userData }
+      );
     },
     async list(query) {
       const { cursor, limit, sort, order, want_total, ...filters } = query ?? {};
@@ -3363,7 +3496,7 @@ function GoogleAdsTracking(props) {
 var import_react6 = require("react");
 
 // package.json
-var version = "0.18.0";
+var version = "0.19.0";
 
 // ../tracking-core/src/phone-react.tsx
 var import_react5 = require("react");
@@ -3627,6 +3760,7 @@ function createTracking(options) {
   TRACKING_PARAM_KEYS,
   TRACKING_RANGES,
   captureTrackingParamsFromLocation,
+  clearStashedUserData,
   createSalesClient,
   createTracking,
   createTrackingClientContext,
@@ -3655,6 +3789,7 @@ function createTracking(options) {
   saleUpdateSchema,
   salesRequest,
   setConsentState,
+  stashUserData,
   toE164,
   toMinor,
   useConsent,