@jmp-technologies/analytics 0.1.12 → 0.1.14

package/dist/index.js

@@ -1,5 +1,6 @@
 import {
   DEFAULT_JMP_BROWSER_PAGE_VIEW_DEDUPE_MS,
+  buildLandingCaptureInlineScript,
   createJmpAnalytics,
   createJmpContentClient,
   createJmpContentClientFromServerEnv,
@@ -16,10 +17,12 @@ import {
   isJmpServerContentEnvConfigured,
   registerJmpContentWrappers,
   registerJmpTrustCapabilities,
+  sendEarlyPageViewBeacon,
   trackJmpServerPageView
-} from "./chunk-ST5BERIA.js";
+} from "./chunk-CCCYRBYK.js";
 export {
   DEFAULT_JMP_BROWSER_PAGE_VIEW_DEDUPE_MS,
+  buildLandingCaptureInlineScript,
   createJmpAnalytics,
   createJmpContentClient,
   createJmpContentClientFromServerEnv,
@@ -36,6 +39,7 @@ export {
   isJmpServerContentEnvConfigured,
   registerJmpContentWrappers,
   registerJmpTrustCapabilities,
+  sendEarlyPageViewBeacon,
   trackJmpServerPageView
 };
 //# sourceMappingURL=index.js.map

package/dist/next.cjs

@@ -1,8 +1,10 @@
 "use strict";
 "use client";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -16,85 +18,214 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/next.tsx
 var next_exports = {};
 __export(next_exports, {
+  JmpLandingCaptureScript: () => JmpLandingCaptureScript,
   JmpNextAnalytics: () => JmpNextAnalytics,
   JmpNextPageViewTracker: () => JmpNextPageViewTracker,
   JmpTrackedMailtoLink: () => JmpTrackedMailtoLink,
   JmpTrackedTelLink: () => JmpTrackedTelLink,
+  buildLandingCaptureInlineScript: () => buildLandingCaptureInlineScript,
   useJmpAnalytics: () => useJmpAnalytics
 });
 module.exports = __toCommonJS(next_exports);
+var import_script = __toESM(require("next/script"), 1);
 var import_react2 = require("react");
 var import_navigation = require("next/navigation");
 
-// src/index.ts
-var DEFAULT_SOURCE = "direct";
-var SESSION_STORAGE_KEY = "jmp_analytics_sid";
-var LANDING_REFERRER_STORAGE_KEY = "jmp_analytics_landing_referer";
-var UTM_SESSION_STORAGE_KEY = "jmp_analytics_utm";
-var UTM_PARAM_KEYS = [
+// src/landing-capture.ts
+var JMP_SESSION_ID_KEY = "jmp_analytics_sid";
+var JMP_LANDING_REFERER_KEY = "jmp_analytics_landing_referer";
+var JMP_UTM_SESSION_KEY = "jmp_analytics_utm";
+var JMP_EARLY_BEACON_PATH_KEY = "jmp_analytics_early_beacon_path";
+var JMP_UTM_PARAM_KEYS = [
   "utm_source",
   "utm_medium",
   "utm_campaign",
   "utm_content",
   "utm_term"
 ];
-function captureAndGetLandingReferer() {
-  if (typeof window === "undefined") {
-    return null;
-  }
+function refererHostFromUrl(referer) {
+  const trimmed = referer.trim();
   try {
-    const stored = sessionStorage.getItem(LANDING_REFERRER_STORAGE_KEY);
-    if (stored?.trim()) {
-      return stored.trim();
-    }
-    const current = document.referrer?.trim();
-    if (!current) {
+    return new URL(trimmed).hostname.replace(/^www\./i, "").toLowerCase();
+  } catch {
+    try {
+      return new URL(`https://${trimmed}`).hostname.replace(/^www\./i, "").toLowerCase();
+    } catch {
       return null;
     }
-    sessionStorage.setItem(LANDING_REFERRER_STORAGE_KEY, current);
-    return current;
-  } catch {
-    return document.referrer?.trim() || null;
   }
 }
-function mergeSessionUtms(metadata) {
-  if (typeof window === "undefined") {
-    return;
+function isExternalReferrerUrl(referer, siteHostname) {
+  const refHost = refererHostFromUrl(referer);
+  if (!refHost) {
+    return false;
+  }
+  const site = siteHostname.replace(/^www\./i, "").toLowerCase();
+  return refHost !== site && !refHost.endsWith(`.${site}`);
+}
+function captureLandingAttribution(siteHostname) {
+  if (typeof document === "undefined" || typeof window === "undefined") {
+    return { landingReferer: null, utm: {} };
   }
+  let landingReferer = null;
+  let utm = {};
   try {
+    const storedReferer = sessionStorage.getItem(JMP_LANDING_REFERER_KEY)?.trim();
+    const currentReferer = document.referrer?.trim();
+    if (currentReferer && isExternalReferrerUrl(currentReferer, siteHostname)) {
+      if (!storedReferer) {
+        sessionStorage.setItem(JMP_LANDING_REFERER_KEY, currentReferer);
+      }
+      landingReferer = storedReferer || currentReferer;
+    } else if (storedReferer) {
+      landingReferer = storedReferer;
+    }
     const params = new URLSearchParams(window.location.search);
-    let stored = {};
-    const raw = sessionStorage.getItem(UTM_SESSION_STORAGE_KEY);
-    if (raw) {
-      const parsed = JSON.parse(raw);
+    const rawUtm = sessionStorage.getItem(JMP_UTM_SESSION_KEY);
+    if (rawUtm) {
+      const parsed = JSON.parse(rawUtm);
       if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
-        stored = parsed;
+        utm = parsed;
       }
     }
     let updated = false;
-    for (const key of UTM_PARAM_KEYS) {
+    for (const key of JMP_UTM_PARAM_KEYS) {
       const value = params.get(key)?.trim();
       if (value) {
-        stored[key] = value;
+        utm[key] = value;
         updated = true;
       }
     }
     if (updated) {
-      sessionStorage.setItem(UTM_SESSION_STORAGE_KEY, JSON.stringify(stored));
+      sessionStorage.setItem(JMP_UTM_SESSION_KEY, JSON.stringify(utm));
     }
-    for (const key of UTM_PARAM_KEYS) {
-      if (metadata[key] === void 0 && stored[key]) {
-        metadata[key] = stored[key];
-      }
+  } catch {
+  }
+  return { landingReferer, utm };
+}
+function getOrCreateSessionIdFromStorage() {
+  if (typeof window === "undefined" || !globalThis.crypto?.randomUUID) {
+    return void 0;
+  }
+  try {
+    let id = sessionStorage.getItem(JMP_SESSION_ID_KEY);
+    if (!id) {
+      id = crypto.randomUUID();
+      sessionStorage.setItem(JMP_SESSION_ID_KEY, id);
     }
+    return id;
+  } catch {
+    return void 0;
+  }
+}
+function wasEarlyBeaconSentForPath(path) {
+  if (typeof window === "undefined") {
+    return false;
+  }
+  try {
+    return sessionStorage.getItem(JMP_EARLY_BEACON_PATH_KEY) === path;
+  } catch {
+    return false;
+  }
+}
+function markEarlyBeaconSentForPath(path) {
+  if (typeof window === "undefined") {
+    return;
+  }
+  try {
+    sessionStorage.setItem(JMP_EARLY_BEACON_PATH_KEY, path);
   } catch {
   }
 }
+function sendEarlyPageViewBeacon(args) {
+  if (typeof window === "undefined" || typeof fetch === "undefined") {
+    return false;
+  }
+  const path = `${window.location.pathname}${window.location.search}` || "/";
+  if (wasEarlyBeaconSentForPath(path)) {
+    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(() => {
+    try {
+      sessionStorage.removeItem(JMP_EARLY_BEACON_PATH_KEY);
+    } catch {
+    }
+  });
+  return true;
+}
+function escapeInlineScript(value) {
+  return value.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
+}
+function buildLandingCaptureInlineScript(args) {
+  const baseUrl = escapeInlineScript(args.baseUrl.replace(/\/$/, ""));
+  const trackingKey = escapeInlineScript(args.trackingKey);
+  return `(function(){try{var k='${trackingKey}',b='${baseUrl}';if(!k||!b)return;var p=location.pathname+location.search||'/';var sentKey='${JMP_EARLY_BEACON_PATH_KEY}';if(sessionStorage.getItem(sentKey)===p)return;var h=location.hostname;var ref=document.referrer||'';function rh(u){try{return new URL(u).hostname.replace(/^www\\./i,'').toLowerCase()}catch(e){try{return new URL('https://'+u).hostname.replace(/^www\\./i,'').toLowerCase()}catch(e2){return null}}}function ext(r){var x=rh(r);if(!x)return false;var s=h.replace(/^www\\./i,'').toLowerCase();return x!==s&&x.slice(-('.'+s).length)!==('.'+s)}if(ref&&ext(ref)&&!sessionStorage.getItem('${JMP_LANDING_REFERER_KEY}'))sessionStorage.setItem('${JMP_LANDING_REFERER_KEY}',ref);var lr=sessionStorage.getItem('${JMP_LANDING_REFERER_KEY}')||'';var sid=sessionStorage.getItem('${JMP_SESSION_ID_KEY}');if(!sid&&crypto&&crypto.randomUUID){sid=crypto.randomUUID();sessionStorage.setItem('${JMP_SESSION_ID_KEY}',sid)}var md={pageHostname:h,earlyBeacon:true};try{var sp=new URLSearchParams(location.search);['utm_source','utm_medium','utm_campaign','utm_content','utm_term'].forEach(function(n){var v=sp.get(n);if(v)md[n]=v})}catch(e){}if(lr)md.referer=lr;var body=JSON.stringify({type:'page_view',path:p,trackingKey:k,sessionId:sid||undefined,metadata:md});var hd={'Content-Type':'application/json','X-JMP-Tracking-Key':k};if(lr)hd['X-JMP-Visitor-Referer']=lr;sessionStorage.setItem(sentKey,p);fetch(b+'/api/events',{method:'POST',headers:hd,body:body,keepalive:true,mode:'cors',credentials:'omit'}).catch(function(){sessionStorage.removeItem(sentKey)})}catch(e){}})();`;
+}
+
+// src/index.ts
+var DEFAULT_SOURCE = "direct";
+function captureAndGetLandingReferer() {
+  if (typeof window === "undefined") {
+    return null;
+  }
+  return captureLandingAttribution(window.location.hostname).landingReferer;
+}
+function mergeSessionUtms(metadata) {
+  if (typeof window === "undefined") {
+    return;
+  }
+  const { utm } = captureLandingAttribution(window.location.hostname);
+  for (const key of JMP_UTM_PARAM_KEYS) {
+    if (metadata[key] === void 0 && utm[key]) {
+      metadata[key] = utm[key];
+    }
+  }
+}
 function splitPathAndSearch(pathInput) {
   const qIndex = pathInput.indexOf("?");
   if (qIndex === -1) {
@@ -118,21 +249,6 @@ function inferDevice() {
   }
   return window.innerWidth < 768 ? "mobile" : "desktop";
 }
-function getOrCreateSessionId() {
-  if (typeof window === "undefined" || !globalThis.crypto?.randomUUID) {
-    return void 0;
-  }
-  try {
-    let id = sessionStorage.getItem(SESSION_STORAGE_KEY);
-    if (!id) {
-      id = crypto.randomUUID();
-      sessionStorage.setItem(SESSION_STORAGE_KEY, id);
-    }
-    return id;
-  } catch {
-    return void 0;
-  }
-}
 function createJmpAnalytics(config) {
   const baseUrl = normalizeBaseUrl(config.baseUrl);
   const resolvedFetch = config.fetchImpl ?? (typeof globalThis !== "undefined" && globalThis.fetch ? globalThis.fetch.bind(globalThis) : void 0);
@@ -156,7 +272,7 @@ function createJmpAnalytics(config) {
         headers["X-JMP-Visitor-Referer"] = landingReferer;
       }
     }
-    const sid = getOrCreateSessionId();
+    const sid = getOrCreateSessionIdFromStorage();
     const payload = { ...body, ...sid ? { sessionId: sid } : {} };
     if (config.debug) {
       console.debug("[@jmp-technologies/analytics]", "POST", url, payload);
@@ -205,7 +321,7 @@ function createJmpAnalytics(config) {
       "Content-Type": "application/json",
       "X-JMP-Tracking-Key": config.trackingKey
     };
-    const sid = getOrCreateSessionId();
+    const sid = getOrCreateSessionIdFromStorage();
     const payload = { ...body, ...sid ? { sessionId: sid } : {} };
     if (config.debug) {
       console.debug("[@jmp-technologies/analytics]", "POST", url, payload);
@@ -277,6 +393,9 @@ 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();
     }
@@ -286,7 +405,7 @@ function createJmpAnalytics(config) {
       const params = new URLSearchParams(
         search ? `?${search}` : window.location.search
       );
-      for (const key of UTM_PARAM_KEYS) {
+      for (const key of JMP_UTM_PARAM_KEYS) {
         const v = params.get(key);
         if (v && metadata[key] === void 0) {
           metadata[key] = v;
@@ -394,6 +513,13 @@ function createJmpAnalytics(config) {
       history.replaceState = replace;
     };
   }
+  if (typeof window !== "undefined") {
+    captureLandingAttribution(window.location.hostname);
+    sendEarlyPageViewBeacon({
+      baseUrl,
+      trackingKey: config.trackingKey
+    });
+  }
   return {
     track,
     trackPageView,
@@ -478,12 +604,35 @@ function JmpTrackedMailtoLink({
 
 // src/next.tsx
 var import_jsx_runtime2 = require("react/jsx-runtime");
+function JmpLandingCaptureScript({
+  baseUrl = process.env.NEXT_PUBLIC_JMP_ANALYTICS_URL,
+  trackingKey = process.env.NEXT_PUBLIC_JMP_TRACKING_KEY
+} = {}) {
+  const resolvedBase = baseUrl?.trim();
+  const resolvedKey = trackingKey?.trim();
+  if (!resolvedBase || !resolvedKey) {
+    return null;
+  }
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+    import_script.default,
+    {
+      id: "jmp-landing-capture",
+      strategy: "beforeInteractive",
+      dangerouslySetInnerHTML: {
+        __html: buildLandingCaptureInlineScript({
+          baseUrl: resolvedBase,
+          trackingKey: resolvedKey
+        })
+      }
+    }
+  );
+}
 function JmpNextPageViewTrackerInner() {
   const pathname = (0, import_navigation.usePathname)();
   const searchParams = (0, import_navigation.useSearchParams)();
   const query = searchParams?.toString() ?? "";
   const path = query ? `${pathname}?${query}` : pathname;
-  (0, import_react2.useEffect)(() => {
+  (0, import_react2.useLayoutEffect)(() => {
     const client = getOrCreateJmpAnalyticsFromBrowserEnv();
     void client?.trackPageView({ path });
   }, [path]);
@@ -493,14 +642,19 @@ function JmpNextPageViewTracker() {
   return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_react2.Suspense, { fallback: null, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(JmpNextPageViewTrackerInner, {}) });
 }
 function JmpNextAnalytics() {
-  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(JmpNextPageViewTracker, {});
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(import_jsx_runtime2.Fragment, { children: [
+    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(JmpLandingCaptureScript, {}),
+    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(JmpNextPageViewTracker, {})
+  ] });
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  JmpLandingCaptureScript,
   JmpNextAnalytics,
   JmpNextPageViewTracker,
   JmpTrackedMailtoLink,
   JmpTrackedTelLink,
+  buildLandingCaptureInlineScript,
   useJmpAnalytics
 });
 //# sourceMappingURL=next.cjs.map