@aranova/tracking-react 0.17.0 → 0.17.2

package/dist/index.mjs

@@ -758,8 +758,8 @@ function thresholdMet(goal, eventType, metadata) {
       return typeof metadata.page_name === "string" && metadata.page_name === t.page_name;
     case "page_view":
     case "form_start":
+    case "phone_click":
       return true;
-    // no threshold — fire whenever the detector emits
     default:
       return false;
   }
@@ -1134,6 +1134,27 @@ function getOrCreateTrackingClient(config) {
   globalClientKey = key;
   return globalClient;
 }
+var clientCaptureRegistry = /* @__PURE__ */ new WeakMap();
+function attachClientCapturesOnce(client, build) {
+  let entry = clientCaptureRegistry.get(client);
+  if (entry === void 0) {
+    entry = { detach: build(), refCount: 0 };
+    clientCaptureRegistry.set(client, entry);
+  }
+  entry.refCount += 1;
+  let released = false;
+  return () => {
+    if (released) return;
+    released = true;
+    const current = clientCaptureRegistry.get(client);
+    if (current === void 0) return;
+    current.refCount -= 1;
+    if (current.refCount <= 0) {
+      current.detach();
+      clientCaptureRegistry.delete(client);
+    }
+  };
+}
 function createTrackingClient(config) {
   const flushIntervalMs = config.flushIntervalMs ?? DEFAULT_FLUSH_INTERVAL_MS;
   const maxQueueSize = Math.min(config.maxQueueSize ?? DEFAULT_MAX_QUEUE_SIZE, HARD_MAX_BATCH);
@@ -1418,7 +1439,11 @@ var phoneClickMetadataSchema = z8.object({
   }).strict(),
   section: z8.string().nullable().optional()
 }).strict();
-var phoneClickConfigSchema = z8.object({}).strict();
+var phoneClickConfigSchema = z8.object({
+  autoCapture: z8.object({
+    selector: z8.string().optional()
+  }).strict().optional()
+}).strict();
 
 // ../tracking-core/src/events/scroll-depth.ts
 import { z as z9 } from "zod";
@@ -2054,6 +2079,99 @@ function attachCtaClickCapture(client, config) {
   };
 }
 
+// ../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;
+}
+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 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) {
+  try {
+    return decodeURIComponent(value);
+  } catch {
+    return value;
+  }
+}
+function resolvePhoneNumber(el) {
+  const href = el instanceof HTMLAnchorElement ? el.href : el.getAttribute("href") ?? "";
+  const raw = safeDecodeURIComponent(href.replace(/^tel:/i, "").split(";")[0]).trim();
+  return toE164(raw) ?? raw;
+}
+function attachPhoneClickCapture(client, config) {
+  if (typeof window === "undefined" || typeof document === "undefined") {
+    return () => {
+    };
+  }
+  const autoCapture = config.autoCapture;
+  if (!autoCapture) {
+    return () => {
+    };
+  }
+  const selector = autoCapture.selector ?? DEFAULT_TEL_SELECTOR;
+  function onClick(event) {
+    const target = event.target;
+    if (!(target instanceof Element)) return;
+    let matched = null;
+    try {
+      matched = target.closest(selector);
+    } catch {
+      return;
+    }
+    if (matched === null) return;
+    const metadata = {
+      phone_number: resolvePhoneNumber(matched),
+      page: { path: window.location.pathname },
+      section: matched.getAttribute("data-aranova-section")
+    };
+    client.trackEvent({
+      eventType: "phone_click",
+      metadata,
+      pageUrl: window.location.href,
+      occurredAt: null
+    });
+  }
+  document.addEventListener("click", onClick, true);
+  return () => {
+    document.removeEventListener("click", onClick, true);
+  };
+}
+
 // ../tracking-core/src/resources/sales/errors.ts
 var AranovaApiError = class extends Error {
   constructor(message, options) {
@@ -2381,46 +2499,6 @@ async function fetchServices(config) {
   return salesRequest(config, "GET", "/services");
 }
 
-// ../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;
-}
-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 AsYouType(country ?? DEFAULT_PHONE_COUNTRY).input(raw ?? "");
-}
-
 // ../tracking-core/src/phone-field.ts
 function phoneField(name, raw, country) {
   return { name, type: "phone", value: toE164(raw, country) };
@@ -2743,7 +2821,7 @@ function GoogleAdsTracking(props) {
 import { createContext as createContext2, useContext as useContext2, useEffect as useEffect5, useMemo as useMemo4 } from "react";
 
 // package.json
-var version = "0.17.0";
+var version = "0.17.2";
 
 // ../tracking-core/src/phone-react.tsx
 import {
@@ -2913,7 +2991,6 @@ function createTracking(options) {
       }
     }, [metaPixelId, metaPixelIdsKey]);
     useEffect5(() => {
-      const detachers = [];
       const rawClient = getOrCreateTrackingClient({
         apiKey,
         endpoint,
@@ -2924,43 +3001,50 @@ function createTracking(options) {
         activeGtagIds: resolvedGtagIds,
         debug
       });
-      const conversionStore = conversionConfig ? resolveConversionConfig({
-        cdnUrl: conversionConfig.cdnUrl,
-        baked: conversionConfig.baked
-      }) : null;
-      const detectorClient = conversionStore ? withConversionAutoFire(rawClient, createConversionAutoFire(conversionStore)) : rawClient;
-      detachers.push(attachAutoPageView(detectorClient));
-      detachers.push(attachBfcacheRestore(detectorClient));
-      detachers.push(attachPageExit(detectorClient));
-      const timeOnSite = triggers.automatic.time_on_site;
-      if (timeOnSite) {
-        detachers.push(attachTimeOnSite(detectorClient, timeOnSite));
-      }
-      const specificPageVisit = triggers.automatic.specific_page_visit;
-      if (specificPageVisit) {
-        detachers.push(attachSpecificPageVisit(detectorClient, specificPageVisit));
-      }
-      const scrollDepth = triggers.automatic.scroll_depth;
-      if (scrollDepth) {
-        detachers.push(attachScrollDepth(detectorClient, scrollDepth));
-      }
-      const multiPageSession = triggers.automatic.multi_page_session;
-      if (multiPageSession) {
-        detachers.push(attachMultiPageSession(detectorClient, multiPageSession));
-      }
-      const formStart = triggers.automatic.form_start;
-      if (formStart) {
-        detachers.push(attachFormStart(detectorClient, formStart));
-      }
-      const ctaClick = triggers.manual?.cta_click;
-      if (ctaClick) {
-        detachers.push(attachCtaClickCapture(detectorClient, ctaClick));
-      }
-      return () => {
-        for (let i = detachers.length - 1; i >= 0; i--) {
-          detachers[i]();
+      return attachClientCapturesOnce(rawClient, () => {
+        const detachers = [];
+        const conversionStore = conversionConfig ? resolveConversionConfig({
+          cdnUrl: conversionConfig.cdnUrl,
+          baked: conversionConfig.baked
+        }) : null;
+        const detectorClient = conversionStore ? withConversionAutoFire(rawClient, createConversionAutoFire(conversionStore)) : rawClient;
+        detachers.push(attachAutoPageView(detectorClient));
+        detachers.push(attachBfcacheRestore(detectorClient));
+        detachers.push(attachPageExit(detectorClient));
+        const timeOnSite = triggers.automatic.time_on_site;
+        if (timeOnSite) {
+          detachers.push(attachTimeOnSite(detectorClient, timeOnSite));
+        }
+        const specificPageVisit = triggers.automatic.specific_page_visit;
+        if (specificPageVisit) {
+          detachers.push(attachSpecificPageVisit(detectorClient, specificPageVisit));
         }
-      };
+        const scrollDepth = triggers.automatic.scroll_depth;
+        if (scrollDepth) {
+          detachers.push(attachScrollDepth(detectorClient, scrollDepth));
+        }
+        const multiPageSession = triggers.automatic.multi_page_session;
+        if (multiPageSession) {
+          detachers.push(attachMultiPageSession(detectorClient, multiPageSession));
+        }
+        const formStart = triggers.automatic.form_start;
+        if (formStart) {
+          detachers.push(attachFormStart(detectorClient, formStart));
+        }
+        const ctaClick = triggers.manual?.cta_click;
+        if (ctaClick) {
+          detachers.push(attachCtaClickCapture(detectorClient, ctaClick));
+        }
+        const phoneClick = triggers.manual?.phone_click;
+        if (phoneClick) {
+          detachers.push(attachPhoneClickCapture(detectorClient, phoneClick));
+        }
+        return () => {
+          for (let i = detachers.length - 1; i >= 0; i--) {
+            detachers[i]();
+          }
+        };
+      });
     }, []);
     return /* @__PURE__ */ jsx3(TrackingContext.Provider, { value: client, children: /* @__PURE__ */ jsx3(PhoneConfigProvider, { value: phone ?? null, children }) });
   }