@jmp-technologies/analytics 0.1.16 → 0.1.18

package/dist/react.cjs

@@ -33,7 +33,6 @@ var JMP_SESSION_ID_KEY = "jmp_analytics_sid";
 var JMP_LANDING_REFERER_KEY = "jmp_analytics_landing_referer";
 var JMP_LANDING_REFERER_COOKIE = "jmp_lr";
 var JMP_UTM_SESSION_KEY = "jmp_analytics_utm";
-var JMP_EARLY_BEACON_PATH_KEY = "jmp_analytics_early_beacon_path";
 var LANDING_REFERER_COOKIE_MAX_AGE_SEC = 30 * 60;
 var JMP_UTM_PARAM_KEYS = [
   "utm_source",
@@ -119,11 +118,9 @@ function captureLandingAttribution(siteHostname) {
     const preservedReferer = storedReferer || cookieReferer;
     const currentReferer = document.referrer?.trim() || null;
     if (currentReferer && isExternalReferrerUrl(currentReferer, siteHostname)) {
-      if (!storedReferer) {
-        sessionStorage.setItem(JMP_LANDING_REFERER_KEY, currentReferer);
-      }
+      sessionStorage.setItem(JMP_LANDING_REFERER_KEY, currentReferer);
       writeLandingRefererCookie(currentReferer, siteHostname);
-      landingReferer = preservedReferer || currentReferer;
+      landingReferer = currentReferer;
     } else if (preservedReferer) {
       landingReferer = preservedReferer;
       if (!storedReferer) {
@@ -168,75 +165,164 @@ function getOrCreateSessionIdFromStorage() {
     return void 0;
   }
 }
-function wasEarlyBeaconSentForPath(path) {
-  if (typeof window === "undefined") {
-    return false;
+
+// src/contact-link-classifier.ts
+var BOOKING_LINK_HOSTS = [
+  "calendly.com",
+  "cal.com",
+  "acuityscheduling.com",
+  "calendar.google.com",
+  "calendar.app.google",
+  "bookings.microsoft.com",
+  "outlook.office.com",
+  "outlook.office365.com",
+  "book.ms",
+  "setmore.com",
+  "simplybook.me",
+  "oncehub.com",
+  "scheduleonce.com",
+  "youcanbook.me",
+  "savvycal.com",
+  "tidycal.com",
+  "zohobookings.com",
+  "square.site",
+  "squareup.com",
+  "meetings.hubspot.com",
+  "jobber.com",
+  "housecallpro.com",
+  "servicetitan.com",
+  "thryv.com",
+  "honeybook.com",
+  "dubsado.com",
+  "fresha.com",
+  "booksy.com",
+  "vagaro.com",
+  "mindbodyonline.com",
+  "mindbody.io",
+  "janeapp.com",
+  "cliniko.com",
+  "practicebetter.io"
+];
+var WHATSAPP_HOSTS = ["wa.me", "api.whatsapp.com", "whatsapp.com"];
+function hostnameMatches(host, pattern) {
+  const h = host.toLowerCase();
+  const p = pattern.toLowerCase();
+  return h === p || h.endsWith(`.${p}`);
+}
+function isMapsHost(host, pathname) {
+  if (hostnameMatches(host, "maps.apple.com")) {
+    return true;
   }
-  try {
-    return sessionStorage.getItem(JMP_EARLY_BEACON_PATH_KEY) === path;
-  } catch {
-    return false;
+  if (hostnameMatches(host, "maps.app.goo.gl")) {
+    return true;
   }
+  if (hostnameMatches(host, "google.com") || hostnameMatches(host, "google.co")) {
+    return pathname === "/maps" || pathname.startsWith("/maps/") || pathname.startsWith("/local");
+  }
+  return false;
 }
-function markEarlyBeaconSentForPath(path) {
-  if (typeof window === "undefined") {
-    return;
+function isWhatsAppHost(host, pathname) {
+  for (const pattern of WHATSAPP_HOSTS) {
+    if (!hostnameMatches(host, pattern)) {
+      continue;
+    }
+    if (pattern === "whatsapp.com") {
+      return pathname.startsWith("/send");
+    }
+    return true;
+  }
+  return false;
+}
+function isBookingHost(host) {
+  for (const pattern of BOOKING_LINK_HOSTS) {
+    if (hostnameMatches(host, pattern)) {
+      return true;
+    }
+  }
+  return false;
+}
+function classifyContactHref(href) {
+  const raw = href.trim();
+  if (!raw || raw.startsWith("#") || raw.startsWith("javascript:")) {
+    return null;
+  }
+  const lower = raw.toLowerCase();
+  if (lower.startsWith("tel:")) {
+    return { kind: "call" };
+  }
+  if (lower.startsWith("mailto:")) {
+    return { kind: "email" };
   }
+  if (lower.startsWith("sms:") || lower.startsWith("smsto:")) {
+    return { kind: "contact_click", channel: "sms", linkHost: null };
+  }
+  if (lower.startsWith("geo:")) {
+    return { kind: "contact_click", channel: "maps", linkHost: null };
+  }
+  if (raw.startsWith("/") || raw.startsWith("?")) {
+    return null;
+  }
+  let url;
   try {
-    sessionStorage.setItem(JMP_EARLY_BEACON_PATH_KEY, path);
+    url = new URL(raw);
   } catch {
+    return null;
+  }
+  if (url.protocol !== "http:" && url.protocol !== "https:") {
+    return null;
   }
+  const host = url.hostname.toLowerCase();
+  const pathname = url.pathname.toLowerCase();
+  if (isWhatsAppHost(host, pathname)) {
+    return { kind: "contact_click", channel: "whatsapp", linkHost: host };
+  }
+  if (isMapsHost(host, pathname)) {
+    return { kind: "contact_click", channel: "maps", linkHost: host };
+  }
+  if (isBookingHost(host)) {
+    return { kind: "contact_click", channel: "booking", linkHost: host };
+  }
+  return null;
 }
-function sendEarlyPageViewBeacon(args) {
-  if (typeof window === "undefined" || typeof fetch === "undefined") {
+
+// src/index.ts
+var JMP_TRACKING_CONSENT_STORAGE_KEY = "jmp_analytics_consent_v1";
+var moduleTrackingConsentGranted = true;
+var trackingConsentListeners = /* @__PURE__ */ new Set();
+function readStoredTrackingConsent() {
+  if (typeof window === "undefined") {
     return false;
   }
-  const path = `${window.location.pathname}${window.location.search}` || "/";
-  if (wasEarlyBeaconSentForPath(path)) {
+  try {
+    return localStorage.getItem(JMP_TRACKING_CONSENT_STORAGE_KEY) === "granted";
+  } catch {
     return false;
   }
-  const { landingReferer, utm } = captureLandingAttribution(window.location.hostname);
-  const sessionId = getOrCreateSessionIdFromStorage();
-  const metadata = {
-    pageHostname: window.location.hostname,
-    earlyBeacon: true,
-    ...utm
-  };
-  if (landingReferer) {
-    metadata.referer = landingReferer;
-  }
-  const payload = {
-    type: "page_view",
-    path,
-    trackingKey: args.trackingKey,
-    ...sessionId ? { sessionId } : {},
-    metadata
-  };
-  const headers = {
-    "Content-Type": "application/json",
-    "X-JMP-Tracking-Key": args.trackingKey
-  };
-  if (landingReferer) {
-    headers["X-JMP-Visitor-Referer"] = landingReferer;
-  }
-  markEarlyBeaconSentForPath(path);
-  void fetch(`${args.baseUrl.replace(/\/$/, "")}/api/events`, {
-    method: "POST",
-    headers,
-    body: JSON.stringify(payload),
-    keepalive: true,
-    mode: "cors",
-    credentials: "omit"
-  }).catch(() => {
+}
+function isJmpTrackingConsentGranted() {
+  return moduleTrackingConsentGranted;
+}
+function setJmpTrackingConsent(granted) {
+  if (moduleTrackingConsentGranted === granted) {
+    return;
+  }
+  moduleTrackingConsentGranted = granted;
+  if (typeof window !== "undefined") {
     try {
-      sessionStorage.removeItem(JMP_EARLY_BEACON_PATH_KEY);
+      localStorage.setItem(
+        JMP_TRACKING_CONSENT_STORAGE_KEY,
+        granted ? "granted" : "denied"
+      );
     } catch {
     }
-  });
-  return true;
+    if (granted) {
+      captureLandingAttribution(window.location.hostname);
+    }
+  }
+  for (const listener of trackingConsentListeners) {
+    listener();
+  }
 }
-
-// src/index.ts
 function captureAndGetLandingReferer() {
   if (typeof window === "undefined") {
     return null;
@@ -286,9 +372,16 @@ function createJmpAnalytics(config) {
     );
   }
   const fetchFn = resolvedFetch;
+  moduleTrackingConsentGranted = config.requireConsent ? readStoredTrackingConsent() : true;
+  function canSend() {
+    return moduleTrackingConsentGranted;
+  }
   let lastDedupePath = "";
   let lastDedupeAt = 0;
   async function send(body) {
+    if (!canSend()) {
+      return;
+    }
     const url = `${baseUrl}/api/events`;
     const headers = {
       "Content-Type": "application/json",
@@ -344,6 +437,9 @@ function createJmpAnalytics(config) {
     }
   }
   async function sendLead(body) {
+    if (!canSend()) {
+      return;
+    }
     const url = `${baseUrl}/api/leads`;
     const headers = {
       "Content-Type": "application/json",
@@ -406,6 +502,9 @@ function createJmpAnalytics(config) {
     return false;
   }
   function trackPageView(options) {
+    if (!canSend()) {
+      return Promise.resolve();
+    }
     const pathFromOptions = options?.path?.trim();
     let pathname = "/";
     let search = "";
@@ -421,9 +520,6 @@ function createJmpAnalytics(config) {
       search = window.location.search.replace(/^\?/, "");
     }
     const path = search ? `${pathname}?${search}` : pathname;
-    if (wasEarlyBeaconSentForPath(path)) {
-      return Promise.resolve();
-    }
     if (shouldDedupePageView(pathname)) {
       return Promise.resolve();
     }
@@ -474,6 +570,20 @@ function createJmpAnalytics(config) {
       metadata: metadata ?? {}
     });
   }
+  function trackContactClick(path, options) {
+    const metadata = {
+      ...options.metadata && typeof options.metadata === "object" ? options.metadata : {},
+      channel: options.channel
+    };
+    if (options.linkHost) {
+      metadata.linkHost = options.linkHost;
+    }
+    return send({
+      type: "contact_click",
+      path: path || "/",
+      metadata
+    });
+  }
   function trackLead(options) {
     const path = options?.path ?? (typeof window !== "undefined" ? window.location.pathname : "/");
     const body = { path: path || "/" };
@@ -506,7 +616,20 @@ function createJmpAnalytics(config) {
     if (type === "call_click") {
       return trackCallClick(payload.path, payload.metadata);
     }
-    return trackEmailClick(payload.path, payload.metadata);
+    if (type === "email_click") {
+      return trackEmailClick(payload.path, payload.metadata);
+    }
+    const meta = payload.metadata ?? {};
+    const channel = typeof meta.channel === "string" ? meta.channel : "";
+    const linkHost = typeof meta.linkHost === "string" ? meta.linkHost : null;
+    if (channel !== "sms" && channel !== "whatsapp" && channel !== "maps" && channel !== "booking") {
+      return Promise.resolve();
+    }
+    return trackContactClick(payload.path, {
+      channel,
+      linkHost,
+      metadata: meta
+    });
   }
   function subscribeToSpaNavigation() {
     if (typeof window === "undefined") {
@@ -540,12 +663,75 @@ function createJmpAnalytics(config) {
       history.replaceState = replace;
     };
   }
-  if (typeof window !== "undefined") {
+  let lastContactClickKey = "";
+  let lastContactClickAt = 0;
+  function subscribeContactLinkAutoTrack() {
+    if (typeof window === "undefined" || typeof document === "undefined") {
+      return () => {
+      };
+    }
+    const handler = (event) => {
+      if (!canSend()) {
+        return;
+      }
+      const target = event.target;
+      if (!(target instanceof Element)) {
+        return;
+      }
+      const anchor = target.closest("a[href]");
+      if (!(anchor instanceof HTMLAnchorElement)) {
+        return;
+      }
+      if (anchor.closest("[data-jmp-no-track]")) {
+        return;
+      }
+      const href = anchor.getAttribute("href") ?? "";
+      const classified = classifyContactHref(href);
+      if (!classified) {
+        return;
+      }
+      const path = window.location.pathname;
+      if (classified.kind === "call") {
+        if (dedupeContactClick(`call_click:${path}`)) {
+          return;
+        }
+        void trackCallClick(path);
+        return;
+      }
+      if (classified.kind === "email") {
+        if (dedupeContactClick(`email_click:${path}`)) {
+          return;
+        }
+        void trackEmailClick(path);
+        return;
+      }
+      if (dedupeContactClick(`contact_click:${classified.channel}:${path}`)) {
+        return;
+      }
+      void trackContactClick(path, {
+        channel: classified.channel,
+        linkHost: classified.linkHost
+      });
+    };
+    document.addEventListener("click", handler, { capture: true });
+    return () => {
+      document.removeEventListener("click", handler, { capture: true });
+    };
+  }
+  function dedupeContactClick(key) {
+    const now = Date.now();
+    if (key === lastContactClickKey && now - lastContactClickAt < 1e3) {
+      return true;
+    }
+    lastContactClickKey = key;
+    lastContactClickAt = now;
+    return false;
+  }
+  if (typeof window !== "undefined" && canSend()) {
     captureLandingAttribution(window.location.hostname);
-    sendEarlyPageViewBeacon({
-      baseUrl,
-      trackingKey: config.trackingKey
-    });
+  }
+  if (typeof window !== "undefined" && config.autoTrackContactLinks && canSend()) {
+    subscribeContactLinkAutoTrack();
   }
   return {
     track,
@@ -553,8 +739,12 @@ function createJmpAnalytics(config) {
     trackFormSubmit,
     trackCallClick,
     trackEmailClick,
+    trackContactClick,
     trackLead,
-    subscribeToSpaNavigation
+    subscribeToSpaNavigation,
+    subscribeContactLinkAutoTrack,
+    setTrackingConsent: setJmpTrackingConsent,
+    isTrackingConsentGranted: isJmpTrackingConsentGranted
   };
 }
 var DEFAULT_JMP_BROWSER_PAGE_VIEW_DEDUPE_MS = 800;
@@ -567,11 +757,15 @@ function getJmpBrowserAnalyticsConfigFromEnv(overrides) {
   const baseUrl = readProcessEnv("NEXT_PUBLIC_JMP_ANALYTICS_URL");
   const trackingKey = readProcessEnv("NEXT_PUBLIC_JMP_TRACKING_KEY");
   if (!baseUrl || !trackingKey) return null;
+  const requireConsentFromEnv = readProcessEnv("NEXT_PUBLIC_JMP_ANALYTICS_REQUIRE_CONSENT") === "true";
+  const autoTrackContactLinksFromEnv = readProcessEnv("NEXT_PUBLIC_JMP_AUTO_CONTACT_LINKS") === "true";
   return {
     baseUrl,
     trackingKey,
     pageViewDedupeMs: DEFAULT_JMP_BROWSER_PAGE_VIEW_DEDUPE_MS,
-    ...overrides
+    ...overrides,
+    requireConsent: overrides?.requireConsent ?? requireConsentFromEnv,
+    autoTrackContactLinks: overrides?.autoTrackContactLinks ?? autoTrackContactLinksFromEnv
   };
 }
 var jmpAnalyticsBrowserSingleton = null;