@jmp-technologies/analytics 0.1.20 → 0.1.22

package/dist/next.cjs

@@ -38,7 +38,9 @@ __export(next_exports, {
   JmpTrackedMailtoLink: () => JmpTrackedMailtoLink,
   JmpTrackedTelLink: () => JmpTrackedTelLink,
   buildLandingCaptureInlineScript: () => buildLandingCaptureInlineScript,
+  getOrCreateJmpAnalyticsForNextApp: () => getOrCreateJmpAnalyticsForNextApp,
   isJmpTrackingConsentGranted: () => isJmpTrackingConsentGranted,
+  readJmpPublicEnvFromProcess: () => readJmpPublicEnvFromProcess,
   setJmpTrackingConsent: () => setJmpTrackingConsent,
   subscribeJmpTrackingConsent: () => subscribeJmpTrackingConsent,
   useJmpAnalytics: () => useJmpAnalytics
@@ -190,6 +192,51 @@ function buildLandingCaptureInlineScript() {
   return `(function(){try{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)}function apexDom(hn){var s=hn.replace(/^www\\./i,'').toLowerCase();if(!s||s==='localhost'||/\\.local$/i.test(s)||s.indexOf('.')<0)return null;return s}function readCk(hn){var apex=apexDom(hn);if(!apex)return '';var pre='${JMP_LANDING_REFERER_COOKIE}=';var parts=document.cookie.split(';');for(var i=0;i<parts.length;i++){var t=parts[i].trim();if(t.indexOf(pre)===0){try{return decodeURIComponent(t.slice(pre.length)).trim()}catch(e){return ''}}}return ''}function writeCk(r,hn){var apex=apexDom(hn);if(!apex)return;var sec=location.protocol==='https:'?'; Secure':'';document.cookie='${JMP_LANDING_REFERER_COOKIE}='+encodeURIComponent(r.slice(0,2048))+'; Domain=.'+apex+'; Path=/; Max-Age=${cookieMaxAge}; SameSite=Lax'+sec}var stored=sessionStorage.getItem('${JMP_LANDING_REFERER_KEY}')||'';var ck=readCk(h);var preserved=stored||ck;var lr='';if(ref&&ext(ref)){sessionStorage.setItem('${JMP_LANDING_REFERER_KEY}',ref);writeCk(ref,h);lr=ref}else{lr=preserved||'';if(lr&&!stored)sessionStorage.setItem('${JMP_LANDING_REFERER_KEY}',lr)}var sid=sessionStorage.getItem('${JMP_SESSION_ID_KEY}');if(!sid&&crypto&&crypto.randomUUID){sid=crypto.randomUUID();sessionStorage.setItem('${JMP_SESSION_ID_KEY}',sid)}try{var sp=new URLSearchParams(location.search);var utm={};var updated=false;['utm_source','utm_medium','utm_campaign','utm_content','utm_term'].forEach(function(n){var v=sp.get(n);if(v){utm[n]=v;updated=true}});if(updated)sessionStorage.setItem('${JMP_UTM_SESSION_KEY}',JSON.stringify(utm))}catch(e){}}catch(e){}})();`;
 }
 
+// src/env-public.ts
+function firstDefined(...values) {
+  for (const v of values) {
+    if (v) return v;
+  }
+  return void 0;
+}
+function readJmpPublicEnvFromProcessEnv() {
+  if (typeof process === "undefined" || !process.env) {
+    return {};
+  }
+  const { env } = process;
+  const analyticsUrl = firstDefined(
+    env.NEXT_PUBLIC_JMP_ANALYTICS_URL,
+    env.PUBLIC_JMP_ANALYTICS_URL
+  );
+  const trackingKey = firstDefined(
+    env.NEXT_PUBLIC_JMP_TRACKING_KEY,
+    env.PUBLIC_JMP_TRACKING_KEY
+  );
+  const requireConsentRaw = firstDefined(
+    env.NEXT_PUBLIC_JMP_ANALYTICS_REQUIRE_CONSENT,
+    env.PUBLIC_JMP_ANALYTICS_REQUIRE_CONSENT
+  );
+  const autoContactRaw = firstDefined(
+    env.NEXT_PUBLIC_JMP_AUTO_CONTACT_LINKS,
+    env.PUBLIC_JMP_AUTO_CONTACT_LINKS
+  );
+  return {
+    analyticsUrl,
+    trackingKey,
+    requireConsent: requireConsentRaw === "true",
+    autoContactLinks: autoContactRaw === "true"
+  };
+}
+function readJmpPublicEnvFromProcess(overrides) {
+  const fromEnv = readJmpPublicEnvFromProcessEnv();
+  return {
+    analyticsUrl: firstDefined(overrides?.analyticsUrl, fromEnv.analyticsUrl),
+    trackingKey: firstDefined(overrides?.trackingKey, fromEnv.trackingKey),
+    requireConsent: overrides?.requireConsent ?? fromEnv.requireConsent,
+    autoContactLinks: overrides?.autoContactLinks ?? fromEnv.autoContactLinks
+  };
+}
+
 // src/contact-link-classifier.ts
 var BOOKING_LINK_HOSTS = [
   "calendly.com",
@@ -309,49 +356,11 @@ function classifyContactHref(href) {
   return null;
 }
 
-// src/env-public.ts
-function readProcessEnv(name) {
-  if (typeof process === "undefined" || !process.env) return void 0;
-  const v = process.env[name];
-  return typeof v === "string" && v.length > 0 ? v : void 0;
-}
-function firstDefined(...values) {
-  for (const v of values) {
-    if (v) return v;
-  }
-  return void 0;
-}
-function readJmpPublicEnvFromProcess(overrides) {
-  const analyticsUrl = firstDefined(
-    overrides?.analyticsUrl,
-    readProcessEnv("NEXT_PUBLIC_JMP_ANALYTICS_URL"),
-    readProcessEnv("PUBLIC_JMP_ANALYTICS_URL")
-  );
-  const trackingKey = firstDefined(
-    overrides?.trackingKey,
-    readProcessEnv("NEXT_PUBLIC_JMP_TRACKING_KEY"),
-    readProcessEnv("PUBLIC_JMP_TRACKING_KEY")
-  );
-  const requireConsentRaw = firstDefined(
-    overrides?.requireConsent !== void 0 ? String(overrides.requireConsent) : void 0,
-    readProcessEnv("NEXT_PUBLIC_JMP_ANALYTICS_REQUIRE_CONSENT"),
-    readProcessEnv("PUBLIC_JMP_ANALYTICS_REQUIRE_CONSENT")
-  );
-  const autoContactRaw = firstDefined(
-    overrides?.autoContactLinks !== void 0 ? String(overrides.autoContactLinks) : void 0,
-    readProcessEnv("NEXT_PUBLIC_JMP_AUTO_CONTACT_LINKS"),
-    readProcessEnv("PUBLIC_JMP_AUTO_CONTACT_LINKS")
-  );
-  return {
-    analyticsUrl,
-    trackingKey,
-    requireConsent: requireConsentRaw === "true",
-    autoContactLinks: autoContactRaw === "true"
-  };
-}
-
-// src/index.ts
+// src/constants.ts
 var JMP_TRACKING_CONSENT_STORAGE_KEY = "jmp_analytics_consent_v1";
+var DEFAULT_JMP_BROWSER_PAGE_VIEW_DEDUPE_MS = 800;
+
+// src/consent.ts
 var moduleTrackingConsentGranted = true;
 var trackingConsentListeners = /* @__PURE__ */ new Set();
 function readStoredTrackingConsent() {
@@ -364,6 +373,9 @@ function readStoredTrackingConsent() {
     return false;
   }
 }
+function initJmpTrackingConsent(requireConsent) {
+  moduleTrackingConsentGranted = requireConsent ? readStoredTrackingConsent() : true;
+}
 function isJmpTrackingConsentGranted() {
   return moduleTrackingConsentGranted;
 }
@@ -394,6 +406,43 @@ function setJmpTrackingConsent(granted) {
     listener();
   }
 }
+
+// src/http.ts
+function responseLooksLikeHtml(body) {
+  const s = body.trimStart();
+  return s.startsWith("<!") || s.toLowerCase().startsWith("<html") || s.startsWith("<") && /<html[\s>]/i.test(s.slice(0, 500));
+}
+function normalizeBaseUrl(baseUrl) {
+  return baseUrl.replace(/\/$/, "");
+}
+function resolveFetch(fetchImpl, context) {
+  const resolved = fetchImpl ?? (typeof globalThis !== "undefined" && globalThis.fetch ? globalThis.fetch.bind(globalThis) : void 0);
+  if (!resolved) {
+    throw new Error(`${context}: fetch is not available; pass fetchImpl in config`);
+  }
+  return resolved;
+}
+function formatApiErrorMessage(status, text, prefix) {
+  if (responseLooksLikeHtml(text)) {
+    return `${prefix} HTTP ${status} \u2014 response was HTML (not the JSON API). Check baseUrl points at the JMP Analytics dashboard.`;
+  }
+  let parsed = {};
+  try {
+    parsed = JSON.parse(text);
+  } catch {
+    parsed = { error: text };
+  }
+  const detail = parsed.error ?? text;
+  return [
+    `${prefix} HTTP ${status}`,
+    parsed.code ? `[${parsed.code}]` : null,
+    detail,
+    parsed.hint ? `Hint: ${parsed.hint}` : null,
+    parsed.expectedDomain ? `Domain in JMP admin: ${parsed.expectedDomain}` : null
+  ].filter(Boolean).join(" \u2014 ");
+}
+
+// src/tracker/helpers.ts
 function captureAndGetLandingReferer() {
   if (typeof window === "undefined") {
     return null;
@@ -421,31 +470,20 @@ function splitPathAndSearch(pathInput) {
     search: pathInput.slice(qIndex + 1)
   };
 }
-function responseLooksLikeHtml(body) {
-  const s = body.trimStart();
-  return s.startsWith("<!") || s.toLowerCase().startsWith("<html") || s.startsWith("<") && /<html[\s>]/i.test(s.slice(0, 500));
-}
-function normalizeBaseUrl(baseUrl) {
-  return baseUrl.replace(/\/$/, "");
-}
 function inferDevice() {
   if (typeof window === "undefined") {
     return "unknown";
   }
   return window.innerWidth < 768 ? "mobile" : "desktop";
 }
+
+// src/tracker/create-jmp-analytics.ts
 function createJmpAnalytics(config) {
   const baseUrl = normalizeBaseUrl(config.baseUrl);
-  const resolvedFetch = config.fetchImpl ?? (typeof globalThis !== "undefined" && globalThis.fetch ? globalThis.fetch.bind(globalThis) : void 0);
-  if (!resolvedFetch) {
-    throw new Error(
-      "createJmpAnalytics: fetch is not available; pass fetchImpl in config"
-    );
-  }
-  const fetchFn = resolvedFetch;
-  moduleTrackingConsentGranted = config.requireConsent ? readStoredTrackingConsent() : true;
+  const fetchFn = resolveFetch(config.fetchImpl, "createJmpAnalytics");
+  initJmpTrackingConsent(config.requireConsent);
   function canSend() {
-    return moduleTrackingConsentGranted;
+    return isJmpTrackingConsentGranted();
   }
   let lastDedupePath = "";
   let lastDedupeAt = 0;
@@ -477,32 +515,9 @@ function createJmpAnalytics(config) {
     });
     if (!res.ok) {
       const text = await res.text();
-      if (responseLooksLikeHtml(text)) {
-        throw new Error(
-          `JMP Analytics HTTP ${res.status} \u2014 ${url} returned HTML (not the JSON API). Set baseUrl / NEXT_PUBLIC_JMP_ANALYTICS_URL to your JMP Analytics dashboard origin (the deployment that includes POST /api/events), not a marketing or client site unless that codebase ships the same API route.`
-        );
-      }
-      let parsed = {};
-      try {
-        parsed = JSON.parse(text);
-      } catch {
-        parsed = { error: text };
-      }
-      const detail = parsed.error ?? text;
-      const segments = [
-        `JMP Analytics HTTP ${res.status}`,
-        parsed.code ? `[${parsed.code}]` : null,
-        detail,
-        parsed.hint ? `Hint: ${parsed.hint}` : null,
-        parsed.expectedDomain ? `Domain in JMP admin: ${parsed.expectedDomain}` : null
-      ].filter(Boolean);
-      const message = segments.join(" \u2014 ");
+      const message = formatApiErrorMessage(res.status, text, "JMP Analytics");
       if (config.debug) {
-        console.debug("[@jmp-technologies/analytics]", "error response", {
-          status: res.status,
-          ...parsed,
-          raw: text
-        });
+        console.debug("[@jmp-technologies/analytics]", "error response", { status: res.status, raw: text });
       }
       throw new Error(message);
     }
@@ -529,32 +544,9 @@ function createJmpAnalytics(config) {
     });
     if (!res.ok) {
       const text = await res.text();
-      if (responseLooksLikeHtml(text)) {
-        throw new Error(
-          `JMP Analytics HTTP ${res.status} \u2014 ${url} returned HTML (not the JSON API). Set baseUrl / NEXT_PUBLIC_JMP_ANALYTICS_URL to your JMP Analytics dashboard origin (the deployment that includes POST /api/leads).`
-        );
-      }
-      let parsed = {};
-      try {
-        parsed = JSON.parse(text);
-      } catch {
-        parsed = { error: text };
-      }
-      const detail = parsed.error ?? text;
-      const segments = [
-        `JMP Analytics HTTP ${res.status}`,
-        parsed.code ? `[${parsed.code}]` : null,
-        detail,
-        parsed.hint ? `Hint: ${parsed.hint}` : null,
-        parsed.expectedDomain ? `Domain in JMP admin: ${parsed.expectedDomain}` : null
-      ].filter(Boolean);
-      const message = segments.join(" \u2014 ");
+      const message = formatApiErrorMessage(res.status, text, "JMP Analytics");
       if (config.debug) {
-        console.debug("[@jmp-technologies/analytics]", "error response", {
-          status: res.status,
-          ...parsed,
-          raw: text
-        });
+        console.debug("[@jmp-technologies/analytics]", "error response", { status: res.status, raw: text });
       }
       throw new Error(message);
     }
@@ -818,13 +810,16 @@ function createJmpAnalytics(config) {
     isTrackingConsentGranted: isJmpTrackingConsentGranted
   };
 }
-var DEFAULT_JMP_BROWSER_PAGE_VIEW_DEDUPE_MS = 800;
+
+// src/env/browser.ts
 function getJmpBrowserAnalyticsConfigFromEnv(overrides) {
   const pub = readJmpPublicEnvFromProcess();
-  if (!pub.analyticsUrl || !pub.trackingKey) return null;
+  const baseUrl = overrides?.baseUrl ?? pub.analyticsUrl;
+  const trackingKey = overrides?.trackingKey ?? pub.trackingKey;
+  if (!baseUrl || !trackingKey) return null;
   return {
-    baseUrl: pub.analyticsUrl,
-    trackingKey: pub.trackingKey,
+    baseUrl,
+    trackingKey,
     pageViewDedupeMs: DEFAULT_JMP_BROWSER_PAGE_VIEW_DEDUPE_MS,
     ...overrides,
     requireConsent: overrides?.requireConsent ?? pub.requireConsent,
@@ -841,11 +836,37 @@ function getOrCreateJmpAnalyticsFromBrowserEnv(overrides) {
   return jmpAnalyticsBrowserSingleton;
 }
 
+// src/env/browser-next.ts
+function readNextAutoContactLinksEnv() {
+  if (typeof process === "undefined" || !process.env) {
+    return void 0;
+  }
+  const { env } = process;
+  const raw = env.NEXT_PUBLIC_JMP_AUTO_CONTACT_LINKS ?? env.PUBLIC_JMP_AUTO_CONTACT_LINKS;
+  return typeof raw === "string" && raw.length > 0 ? raw : void 0;
+}
+function getJmpNextAnalyticsConfigOverrides() {
+  const autoEnv = readNextAutoContactLinksEnv();
+  const autoContactLinks = autoEnv === "false" ? false : autoEnv === "true" ? true : true;
+  return { autoTrackContactLinks: autoContactLinks };
+}
+function getOrCreateJmpAnalyticsForNextApp(overrides) {
+  return getOrCreateJmpAnalyticsFromBrowserEnv({
+    ...getJmpNextAnalyticsConfigOverrides(),
+    ...overrides
+  });
+}
+
 // src/react.tsx
 var import_react = require("react");
 var import_jsx_runtime = require("react/jsx-runtime");
-function useJmpAnalytics() {
-  return (0, import_react.useMemo)(() => getOrCreateJmpAnalyticsFromBrowserEnv(), []);
+function trackCallClickFromCurrentPath() {
+  const path = typeof window !== "undefined" ? window.location.pathname : "/";
+  void getOrCreateJmpAnalyticsFromBrowserEnv()?.trackCallClick(path);
+}
+function trackEmailClickFromCurrentPath() {
+  const path = typeof window !== "undefined" ? window.location.pathname : "/";
+  void getOrCreateJmpAnalyticsFromBrowserEnv()?.trackEmailClick(path);
 }
 function JmpTrackedTelLink({
   href,
@@ -858,9 +879,7 @@ function JmpTrackedTelLink({
       href,
       ...rest,
       onClick: (e) => {
-        const client = getOrCreateJmpAnalyticsFromBrowserEnv();
-        const path = typeof window !== "undefined" ? window.location.pathname : "/";
-        void client?.trackCallClick(path);
+        trackCallClickFromCurrentPath();
         onClick?.(e);
       }
     }
@@ -877,9 +896,7 @@ function JmpTrackedMailtoLink({
       href,
       ...rest,
       onClick: (e) => {
-        const client = getOrCreateJmpAnalyticsFromBrowserEnv();
-        const path = typeof window !== "undefined" ? window.location.pathname : "/";
-        void client?.trackEmailClick(path);
+        trackEmailClickFromCurrentPath();
         onClick?.(e);
       }
     }
@@ -888,8 +905,11 @@ function JmpTrackedMailtoLink({
 
 // src/next.tsx
 var import_jsx_runtime2 = require("react/jsx-runtime");
+function useJmpAnalytics() {
+  return (0, import_react2.useMemo)(() => getOrCreateJmpAnalyticsForNextApp(), []);
+}
 function JmpLandingCaptureScript({
-  trackingKey = process.env.NEXT_PUBLIC_JMP_TRACKING_KEY
+  trackingKey = readJmpPublicEnvFromProcess().trackingKey
 } = {}) {
   if (!trackingKey?.trim()) {
     return null;
@@ -911,7 +931,7 @@ function JmpNextPageViewTrackerInner() {
   const query = searchParams?.toString() ?? "";
   const path = query ? `${pathname}?${query}` : pathname;
   (0, import_react2.useLayoutEffect)(() => {
-    const client = getOrCreateJmpAnalyticsFromBrowserEnv();
+    const client = getOrCreateJmpAnalyticsForNextApp();
     void client?.trackPageView({ path });
   }, [path]);
   return null;
@@ -927,14 +947,21 @@ function useJmpTrackingActive(deferUntilConsent) {
   );
   return !deferUntilConsent || consentGranted;
 }
+function JmpNextAnalyticsBootstrap() {
+  (0, import_react2.useLayoutEffect)(() => {
+    getOrCreateJmpAnalyticsForNextApp();
+  }, []);
+  return null;
+}
 function JmpNextAnalytics({
-  deferUntilConsent = process.env.NEXT_PUBLIC_JMP_ANALYTICS_REQUIRE_CONSENT === "true"
+  deferUntilConsent = readJmpPublicEnvFromProcess().requireConsent === true
 } = {}) {
   const active = useJmpTrackingActive(deferUntilConsent);
   if (!active) {
     return null;
   }
   return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(import_jsx_runtime2.Fragment, { children: [
+    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(JmpNextAnalyticsBootstrap, {}),
     /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(JmpLandingCaptureScript, {}),
     /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(JmpNextPageViewTracker, {})
   ] });
@@ -957,7 +984,9 @@ function JmpSiteRoot({
   JmpTrackedMailtoLink,
   JmpTrackedTelLink,
   buildLandingCaptureInlineScript,
+  getOrCreateJmpAnalyticsForNextApp,
   isJmpTrackingConsentGranted,
+  readJmpPublicEnvFromProcess,
   setJmpTrackingConsent,
   subscribeJmpTrackingConsent,
   useJmpAnalytics