@jmp-technologies/analytics 0.1.20 → 0.1.22

package/dist/index.cjs

@@ -44,6 +44,7 @@ __export(index_exports, {
   isJmpBrowserAnalyticsEnvConfigured: () => isJmpBrowserAnalyticsEnvConfigured,
   isJmpServerContentEnvConfigured: () => isJmpServerContentEnvConfigured,
   isJmpTrackingConsentGranted: () => isJmpTrackingConsentGranted,
+  readJmpPublicEnvFromProcess: () => readJmpPublicEnvFromProcess,
   registerJmpContentWrappers: () => registerJmpContentWrappers,
   setJmpTrackingConsent: () => setJmpTrackingConsent,
   subscribeJmpTrackingConsent: () => subscribeJmpTrackingConsent,
@@ -312,72 +313,12 @@ 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/site-config.ts
-var registeredSite = null;
-function defineJmpSite(definition) {
-  registeredSite = definition;
-  return definition;
-}
-function getJmpSiteDefinition() {
-  return registeredSite;
-}
-function getJmpContentConfig() {
-  const { analyticsUrl, trackingKey } = readJmpPublicEnvFromProcess();
-  if (!analyticsUrl || !trackingKey) {
-    return null;
-  }
-  const site = getJmpSiteDefinition();
-  return {
-    baseUrl: analyticsUrl,
-    trackingKey,
-    contentWrappers: site?.contentWrappers ?? void 0
-  };
-}
-
-// src/index.ts
-var JMP_ANALYTICS_SDK_VERSION = "0.1.20";
+// src/constants.ts
+var JMP_ANALYTICS_SDK_VERSION = "0.1.21";
 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() {
@@ -390,6 +331,9 @@ function readStoredTrackingConsent() {
     return false;
   }
 }
+function initJmpTrackingConsent(requireConsent) {
+  moduleTrackingConsentGranted = requireConsent ? readStoredTrackingConsent() : true;
+}
 function isJmpTrackingConsentGranted() {
   return moduleTrackingConsentGranted;
 }
@@ -420,33 +364,8 @@ function setJmpTrackingConsent(granted) {
     listener();
   }
 }
-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) {
-    return { pathname: pathInput || "/", search: "" };
-  }
-  return {
-    pathname: pathInput.slice(0, qIndex) || "/",
-    search: pathInput.slice(qIndex + 1)
-  };
-}
+
+// 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));
@@ -479,24 +398,75 @@ function pathFromRequestUrl(url) {
     return url.startsWith("/") ? url : "/";
   }
 }
+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;
+  }
+  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) {
+    return { pathname: pathInput || "/", search: "" };
+  }
+  return {
+    pathname: pathInput.slice(0, qIndex) || "/",
+    search: pathInput.slice(qIndex + 1)
+  };
+}
 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;
@@ -528,32 +498,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);
     }
@@ -580,32 +527,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);
     }
@@ -869,6 +793,8 @@ function createJmpAnalytics(config) {
     isTrackingConsentGranted: isJmpTrackingConsentGranted
   };
 }
+
+// src/server/page-view.ts
 async function trackJmpServerPageView(config, options = {}) {
   const baseUrl = normalizeBaseUrl(config.baseUrl);
   const resolvedFetch = config.fetchImpl ?? (typeof globalThis !== "undefined" && globalThis.fetch ? globalThis.fetch.bind(globalThis) : void 0);
@@ -910,6 +836,55 @@ async function trackJmpServerPageView(config, options = {}) {
     throw new Error(`JMP server analytics HTTP ${res.status} \u2014 ${text}`);
   }
 }
+
+// src/content/fetch.ts
+async function getContent(config, path) {
+  const text = await getContentText(config, path);
+  try {
+    return JSON.parse(text);
+  } catch {
+    const baseUrl = normalizeBaseUrl(config.baseUrl);
+    const url = `${baseUrl}${path}`;
+    throw new Error(`JMP content HTTP 200 \u2014 ${url} returned invalid JSON.`);
+  }
+}
+async function getContentText(config, path) {
+  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("JMP content: fetch is not available; pass fetchImpl in config");
+  }
+  const url = `${baseUrl}${path}`;
+  if (config.debug) {
+    console.debug("[@jmp-technologies/analytics]", "GET", url);
+  }
+  const res = await resolvedFetch(url, {
+    method: "GET",
+    headers: {
+      "X-JMP-Tracking-Key": config.trackingKey
+    }
+  });
+  const text = await res.text();
+  if (!res.ok) {
+    if (responseLooksLikeHtml(text)) {
+      throw new Error(
+        `JMP content HTTP ${res.status} \u2014 ${url} returned HTML (not the JSON API). Set baseUrl to your JMP Analytics dashboard origin.`
+      );
+    }
+    let parsed = {};
+    try {
+      parsed = JSON.parse(text);
+    } catch {
+      parsed = { error: text };
+    }
+    throw new Error(
+      [`JMP content HTTP ${res.status}`, parsed.error, parsed.hint].filter(Boolean).join(" \u2014 ")
+    );
+  }
+  return text;
+}
+
+// src/content/api.ts
 async function getJmpBlogPosts(config) {
   const data = await getContent(
     config,
@@ -1005,6 +980,8 @@ async function registerJmpContentWrappers(config) {
   const data = JSON.parse(text);
   return { ok: true, wrappers: data.wrappers ?? wrappers };
 }
+
+// src/content/client.ts
 function createJmpContentClient(config) {
   return {
     getBlogPosts: () => getJmpBlogPosts(config),
@@ -1016,58 +993,61 @@ function createJmpContentClient(config) {
     registerContentWrappers: () => registerJmpContentWrappers(config)
   };
 }
-async function getContent(config, path) {
-  const text = await getContentText(config, path);
-  try {
-    return JSON.parse(text);
-  } catch {
-    const baseUrl = normalizeBaseUrl(config.baseUrl);
-    const url = `${baseUrl}${path}`;
-    throw new Error(`JMP content HTTP 200 \u2014 ${url} returned invalid JSON.`);
+
+// src/env-public.ts
+function firstDefined(...values) {
+  for (const v of values) {
+    if (v) return v;
   }
+  return void 0;
 }
-async function getContentText(config, path) {
-  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("JMP content: fetch is not available; pass fetchImpl in config");
-  }
-  const url = `${baseUrl}${path}`;
-  if (config.debug) {
-    console.debug("[@jmp-technologies/analytics]", "GET", url);
+function readJmpPublicEnvFromProcessEnv() {
+  if (typeof process === "undefined" || !process.env) {
+    return {};
   }
-  const res = await resolvedFetch(url, {
-    method: "GET",
-    headers: {
-      "X-JMP-Tracking-Key": config.trackingKey
-    }
-  });
-  const text = await res.text();
-  if (!res.ok) {
-    if (responseLooksLikeHtml(text)) {
-      throw new Error(
-        `JMP content HTTP ${res.status} \u2014 ${url} returned HTML (not the JSON API). Set baseUrl to your JMP Analytics dashboard origin.`
-      );
-    }
-    let parsed = {};
-    try {
-      parsed = JSON.parse(text);
-    } catch {
-      parsed = { error: text };
-    }
-    throw new Error(
-      [`JMP content HTTP ${res.status}`, parsed.error, parsed.hint].filter(Boolean).join(" \u2014 ")
-    );
-  }
-  return text;
+  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"
+  };
 }
-var DEFAULT_JMP_BROWSER_PAGE_VIEW_DEDUPE_MS = 800;
+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/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,
@@ -1076,8 +1056,10 @@ function getJmpBrowserAnalyticsConfigFromEnv(overrides) {
 }
 function getJmpServerContentConfigFromEnv(overrides) {
   const pub = readJmpPublicEnvFromProcess();
-  if (!pub.analyticsUrl || !pub.trackingKey) return null;
-  return { baseUrl: pub.analyticsUrl, trackingKey: pub.trackingKey, ...overrides };
+  const baseUrl = overrides?.baseUrl ?? pub.analyticsUrl;
+  const trackingKey = overrides?.trackingKey ?? pub.trackingKey;
+  if (!baseUrl || !trackingKey) return null;
+  return { baseUrl, trackingKey, ...overrides };
 }
 function isJmpBrowserAnalyticsEnvConfigured() {
   const pub = readJmpPublicEnvFromProcess();
@@ -1100,6 +1082,28 @@ function createJmpContentClientFromServerEnv(overrides) {
   if (!config) return null;
   return createJmpContentClient(config);
 }
+
+// src/site-config.ts
+var registeredSite = null;
+function defineJmpSite(definition) {
+  registeredSite = definition;
+  return definition;
+}
+function getJmpSiteDefinition() {
+  return registeredSite;
+}
+function getJmpContentConfig() {
+  const { analyticsUrl, trackingKey } = readJmpPublicEnvFromProcess();
+  if (!analyticsUrl || !trackingKey) {
+    return null;
+  }
+  const site = getJmpSiteDefinition();
+  return {
+    baseUrl: analyticsUrl,
+    trackingKey,
+    contentWrappers: site?.contentWrappers ?? void 0
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BOOKING_LINK_HOSTS,
@@ -1126,6 +1130,7 @@ function createJmpContentClientFromServerEnv(overrides) {
   isJmpBrowserAnalyticsEnvConfigured,
   isJmpServerContentEnvConfigured,
   isJmpTrackingConsentGranted,
+  readJmpPublicEnvFromProcess,
   registerJmpContentWrappers,
   setJmpTrackingConsent,
   subscribeJmpTrackingConsent,