@aranova/tracking-react 0.18.1 → 0.19.1

package/dist/sales.mjs

@@ -1,3 +1,76 @@
+// ../tracking-core/src/phone.ts
+import { AsYouType, parsePhoneNumberFromString } from "libphonenumber-js";
+var DEFAULT_PHONE_COUNTRY = "CA";
+function parsePhone(raw, country) {
+  const region = country ?? DEFAULT_PHONE_COUNTRY;
+  const parsed = 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;
+}
+
+// ../tracking-core/src/user-data.ts
+var EMAIL_SHAPE = /^[^@\s]+@[^@\s]+\.[^@\s]+$/;
+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 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 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";
@@ -77,13 +150,18 @@ function markFired(input) {
   } catch {
   }
 }
-function fireOnce(input) {
-  if (alreadyFired(input)) return;
-  if (fireGtagConversion(input)) markFired(input);
-}
-function fireConversionWithConsent(input) {
-  if (getConsentState() === "denied") return;
-  fireOnce(input);
+function fireConversionWithConsent(input, options) {
+  if (getConsentState() === "denied") return "denied";
+  if (alreadyFired(input)) return "duplicate";
+  if (!isValidSendTo(input.sendTo)) return "invalid";
+  try {
+    applyUserDataForConversion(options?.userData);
+    if (!fireGtagConversion(input)) return "retryable";
+    markFired(input);
+    return "fired";
+  } catch {
+    return "retryable";
+  }
 }
 
 // ../tracking-core/src/events/page-view.ts
@@ -205,6 +283,8 @@ function formatDateInTz(iso, timeZone, opts, locale) {
 // ../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;
@@ -219,12 +299,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) {
@@ -259,6 +342,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,
@@ -271,12 +355,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 ?? {};