@jmp-technologies/analytics 0.1.11 → 0.1.14

package/dist/index.d.cts

@@ -1,3 +1,18 @@
+type EarlyPageViewBeaconArgs = {
+    baseUrl: string;
+    trackingKey: string;
+};
+/**
+ * Capture landing referrer/UTMs and send an early page_view (fetch keepalive).
+ * Safe to call from inline script or module init.
+ */
+declare function sendEarlyPageViewBeacon(args: EarlyPageViewBeaconArgs): boolean;
+/** Inline script for Next.js `beforeInteractive` — earliest capture + beacon. */
+declare function buildLandingCaptureInlineScript(args: {
+    baseUrl: string;
+    trackingKey: string;
+}): string;
+
 type JmpEventType = "page_view" | "form_submit" | "call_click" | "email_click";
 type JmpAnalyticsConfig = {
     /** Dashboard origin, e.g. https://analytics.example.com (no trailing slash) */
@@ -14,7 +29,22 @@ type JmpAnalyticsConfig = {
      */
     pageViewDedupeMs?: number;
 };
-type JmpContentConfig = Pick<JmpAnalyticsConfig, "baseUrl" | "trackingKey" | "debug" | "fetchImpl">;
+type JmpContentConfig = Pick<JmpAnalyticsConfig, "baseUrl" | "trackingKey" | "debug" | "fetchImpl"> & {
+    /**
+     * Content wrappers wired in this site's template (blog, faq, trust.*, contact).
+     * Reported via POST /api/content/capabilities so unused dashboard tabs stay hidden.
+     * Call {@link registerJmpContentWrappers} at startup / deploy.
+     */
+    contentWrappers?: JmpContentWrapper[];
+    /**
+     * @deprecated Use `contentWrappers` (e.g. `trust.testimonials` instead of `testimonials`).
+     */
+    trustSlots?: JmpTrustSlot[];
+};
+/** Top-level and trust sub-wrappers the client can declare. */
+type JmpContentWrapper = "blog" | "faq" | "contact" | "trust" | "trust.summary" | "trust.testimonials" | "trust.reviews" | "trust.stats" | "trust.logos" | "trust.credentials";
+/** @deprecated Trust-only shorthand; prefer `JmpContentWrapper`. */
+type JmpTrustSlot = "summary" | "testimonials" | "reviews" | "stats" | "logos" | "credentials";
 type JmpBlogPost = {
     id: string;
     title: string;
@@ -51,11 +81,17 @@ type JmpTestimonial = {
     author_name: string;
     author_descriptor: string | null;
     location: string | null;
+    /** 1–10 (half-star steps on a 5-star scale; 10 = 5.0 stars). */
     rating: number | null;
     image_url: string | null;
     video_url: string | null;
+    /** Optional topic or service line (e.g. roofing). */
     category: string | null;
+    /** Site section key — filter like FAQ `category` (e.g. testimonials, reviews). */
+    placement: string | null;
     source: string | null;
+    /** Optional link to the original review on Google, Yelp, etc. */
+    source_url: string | null;
     featured: boolean;
     sort_order: number;
     updated_at: string;
@@ -216,6 +252,25 @@ declare function getJmpFaqs(config: JmpContentConfig): Promise<JmpFaqItem[]>;
 declare function getJmpTrustBundle(config: JmpContentConfig): Promise<JmpTrustBundle>;
 declare function getJmpSiteProfile(config: JmpContentConfig): Promise<JmpSiteProfile>;
 declare function getJmpRobotsTxt(config: JmpContentConfig): Promise<string>;
+/**
+ * Tell the JMP dashboard which content wrappers this site wires (blog, faq, trust.*, contact).
+ * Safe to call on every cold start; dedupes by tracking key + wrapper list.
+ */
+declare function registerJmpContentWrappers(config: JmpContentConfig): Promise<{
+    ok: true;
+    wrappers: string[];
+} | {
+    ok: false;
+    skipped: true;
+}>;
+/** @deprecated Use {@link registerJmpContentWrappers} with `contentWrappers`. */
+declare function registerJmpTrustCapabilities(config: JmpContentConfig): Promise<{
+    ok: true;
+    slots: JmpTrustSlot[];
+} | {
+    ok: false;
+    skipped: true;
+}>;
 declare function createJmpContentClient(config: JmpContentConfig): {
     getBlogPosts: () => Promise<JmpBlogPost[]>;
     getBlogPost: (slug: string) => Promise<JmpBlogPost | null>;
@@ -223,6 +278,21 @@ declare function createJmpContentClient(config: JmpContentConfig): {
     getTrustBundle: () => Promise<JmpTrustBundle>;
     getSiteProfile: () => Promise<JmpSiteProfile>;
     getRobotsTxt: () => Promise<string>;
+    registerContentWrappers: () => Promise<{
+        ok: true;
+        wrappers: string[];
+    } | {
+        ok: false;
+        skipped: true;
+    }>;
+    /** @deprecated Use registerContentWrappers */
+    registerTrustCapabilities: () => Promise<{
+        ok: true;
+        slots: JmpTrustSlot[];
+    } | {
+        ok: false;
+        skipped: true;
+    }>;
 };
 /** Default `pageViewDedupeMs` when resolving browser config from env (Strict Mode / SPA). */
 declare const DEFAULT_JMP_BROWSER_PAGE_VIEW_DEDUPE_MS = 800;
@@ -251,4 +321,4 @@ type JmpContentClient = ReturnType<typeof createJmpContentClient>;
  */
 declare function createJmpContentClientFromServerEnv(overrides?: Partial<JmpContentConfig>): JmpContentClient | null;
 
-export { DEFAULT_JMP_BROWSER_PAGE_VIEW_DEDUPE_MS, type JmpAnalytics, type JmpAnalyticsConfig, type JmpBlogPost, type JmpContentClient, type JmpContentConfig, type JmpCredential, type JmpEventType, type JmpFaqItem, type JmpPartnerLogo, type JmpServerRequestLike, type JmpSiteProfile, type JmpTestimonial, type JmpTrustBundle, type JmpTrustStat, type JmpTrustSummary, type LeadMetadata, type LeadMetadataValue, type TrackLeadOptions, type TrackPageViewOptions, type TrackServerPageViewOptions, createJmpAnalytics, createJmpContentClient, createJmpContentClientFromServerEnv, getJmpBlogPost, getJmpBlogPosts, getJmpBrowserAnalyticsConfigFromEnv, getJmpFaqs, getJmpRobotsTxt, getJmpServerContentConfigFromEnv, getJmpSiteProfile, getJmpTrustBundle, getOrCreateJmpAnalyticsFromBrowserEnv, isJmpBrowserAnalyticsEnvConfigured, isJmpServerContentEnvConfigured, trackJmpServerPageView };
+export { DEFAULT_JMP_BROWSER_PAGE_VIEW_DEDUPE_MS, type JmpAnalytics, type JmpAnalyticsConfig, type JmpBlogPost, type JmpContentClient, type JmpContentConfig, type JmpContentWrapper, type JmpCredential, type JmpEventType, type JmpFaqItem, type JmpPartnerLogo, type JmpServerRequestLike, type JmpSiteProfile, type JmpTestimonial, type JmpTrustBundle, type JmpTrustSlot, type JmpTrustStat, type JmpTrustSummary, type LeadMetadata, type LeadMetadataValue, type TrackLeadOptions, type TrackPageViewOptions, type TrackServerPageViewOptions, buildLandingCaptureInlineScript, createJmpAnalytics, createJmpContentClient, createJmpContentClientFromServerEnv, getJmpBlogPost, getJmpBlogPosts, getJmpBrowserAnalyticsConfigFromEnv, getJmpFaqs, getJmpRobotsTxt, getJmpServerContentConfigFromEnv, getJmpSiteProfile, getJmpTrustBundle, getOrCreateJmpAnalyticsFromBrowserEnv, isJmpBrowserAnalyticsEnvConfigured, isJmpServerContentEnvConfigured, registerJmpContentWrappers, registerJmpTrustCapabilities, sendEarlyPageViewBeacon, trackJmpServerPageView };

package/dist/index.d.ts

@@ -1,3 +1,18 @@
+type EarlyPageViewBeaconArgs = {
+    baseUrl: string;
+    trackingKey: string;
+};
+/**
+ * Capture landing referrer/UTMs and send an early page_view (fetch keepalive).
+ * Safe to call from inline script or module init.
+ */
+declare function sendEarlyPageViewBeacon(args: EarlyPageViewBeaconArgs): boolean;
+/** Inline script for Next.js `beforeInteractive` — earliest capture + beacon. */
+declare function buildLandingCaptureInlineScript(args: {
+    baseUrl: string;
+    trackingKey: string;
+}): string;
+
 type JmpEventType = "page_view" | "form_submit" | "call_click" | "email_click";
 type JmpAnalyticsConfig = {
     /** Dashboard origin, e.g. https://analytics.example.com (no trailing slash) */
@@ -14,7 +29,22 @@ type JmpAnalyticsConfig = {
      */
     pageViewDedupeMs?: number;
 };
-type JmpContentConfig = Pick<JmpAnalyticsConfig, "baseUrl" | "trackingKey" | "debug" | "fetchImpl">;
+type JmpContentConfig = Pick<JmpAnalyticsConfig, "baseUrl" | "trackingKey" | "debug" | "fetchImpl"> & {
+    /**
+     * Content wrappers wired in this site's template (blog, faq, trust.*, contact).
+     * Reported via POST /api/content/capabilities so unused dashboard tabs stay hidden.
+     * Call {@link registerJmpContentWrappers} at startup / deploy.
+     */
+    contentWrappers?: JmpContentWrapper[];
+    /**
+     * @deprecated Use `contentWrappers` (e.g. `trust.testimonials` instead of `testimonials`).
+     */
+    trustSlots?: JmpTrustSlot[];
+};
+/** Top-level and trust sub-wrappers the client can declare. */
+type JmpContentWrapper = "blog" | "faq" | "contact" | "trust" | "trust.summary" | "trust.testimonials" | "trust.reviews" | "trust.stats" | "trust.logos" | "trust.credentials";
+/** @deprecated Trust-only shorthand; prefer `JmpContentWrapper`. */
+type JmpTrustSlot = "summary" | "testimonials" | "reviews" | "stats" | "logos" | "credentials";
 type JmpBlogPost = {
     id: string;
     title: string;
@@ -51,11 +81,17 @@ type JmpTestimonial = {
     author_name: string;
     author_descriptor: string | null;
     location: string | null;
+    /** 1–10 (half-star steps on a 5-star scale; 10 = 5.0 stars). */
     rating: number | null;
     image_url: string | null;
     video_url: string | null;
+    /** Optional topic or service line (e.g. roofing). */
     category: string | null;
+    /** Site section key — filter like FAQ `category` (e.g. testimonials, reviews). */
+    placement: string | null;
     source: string | null;
+    /** Optional link to the original review on Google, Yelp, etc. */
+    source_url: string | null;
     featured: boolean;
     sort_order: number;
     updated_at: string;
@@ -216,6 +252,25 @@ declare function getJmpFaqs(config: JmpContentConfig): Promise<JmpFaqItem[]>;
 declare function getJmpTrustBundle(config: JmpContentConfig): Promise<JmpTrustBundle>;
 declare function getJmpSiteProfile(config: JmpContentConfig): Promise<JmpSiteProfile>;
 declare function getJmpRobotsTxt(config: JmpContentConfig): Promise<string>;
+/**
+ * Tell the JMP dashboard which content wrappers this site wires (blog, faq, trust.*, contact).
+ * Safe to call on every cold start; dedupes by tracking key + wrapper list.
+ */
+declare function registerJmpContentWrappers(config: JmpContentConfig): Promise<{
+    ok: true;
+    wrappers: string[];
+} | {
+    ok: false;
+    skipped: true;
+}>;
+/** @deprecated Use {@link registerJmpContentWrappers} with `contentWrappers`. */
+declare function registerJmpTrustCapabilities(config: JmpContentConfig): Promise<{
+    ok: true;
+    slots: JmpTrustSlot[];
+} | {
+    ok: false;
+    skipped: true;
+}>;
 declare function createJmpContentClient(config: JmpContentConfig): {
     getBlogPosts: () => Promise<JmpBlogPost[]>;
     getBlogPost: (slug: string) => Promise<JmpBlogPost | null>;
@@ -223,6 +278,21 @@ declare function createJmpContentClient(config: JmpContentConfig): {
     getTrustBundle: () => Promise<JmpTrustBundle>;
     getSiteProfile: () => Promise<JmpSiteProfile>;
     getRobotsTxt: () => Promise<string>;
+    registerContentWrappers: () => Promise<{
+        ok: true;
+        wrappers: string[];
+    } | {
+        ok: false;
+        skipped: true;
+    }>;
+    /** @deprecated Use registerContentWrappers */
+    registerTrustCapabilities: () => Promise<{
+        ok: true;
+        slots: JmpTrustSlot[];
+    } | {
+        ok: false;
+        skipped: true;
+    }>;
 };
 /** Default `pageViewDedupeMs` when resolving browser config from env (Strict Mode / SPA). */
 declare const DEFAULT_JMP_BROWSER_PAGE_VIEW_DEDUPE_MS = 800;
@@ -251,4 +321,4 @@ type JmpContentClient = ReturnType<typeof createJmpContentClient>;
  */
 declare function createJmpContentClientFromServerEnv(overrides?: Partial<JmpContentConfig>): JmpContentClient | null;
 
-export { DEFAULT_JMP_BROWSER_PAGE_VIEW_DEDUPE_MS, type JmpAnalytics, type JmpAnalyticsConfig, type JmpBlogPost, type JmpContentClient, type JmpContentConfig, type JmpCredential, type JmpEventType, type JmpFaqItem, type JmpPartnerLogo, type JmpServerRequestLike, type JmpSiteProfile, type JmpTestimonial, type JmpTrustBundle, type JmpTrustStat, type JmpTrustSummary, type LeadMetadata, type LeadMetadataValue, type TrackLeadOptions, type TrackPageViewOptions, type TrackServerPageViewOptions, createJmpAnalytics, createJmpContentClient, createJmpContentClientFromServerEnv, getJmpBlogPost, getJmpBlogPosts, getJmpBrowserAnalyticsConfigFromEnv, getJmpFaqs, getJmpRobotsTxt, getJmpServerContentConfigFromEnv, getJmpSiteProfile, getJmpTrustBundle, getOrCreateJmpAnalyticsFromBrowserEnv, isJmpBrowserAnalyticsEnvConfigured, isJmpServerContentEnvConfigured, trackJmpServerPageView };
+export { DEFAULT_JMP_BROWSER_PAGE_VIEW_DEDUPE_MS, type JmpAnalytics, type JmpAnalyticsConfig, type JmpBlogPost, type JmpContentClient, type JmpContentConfig, type JmpContentWrapper, type JmpCredential, type JmpEventType, type JmpFaqItem, type JmpPartnerLogo, type JmpServerRequestLike, type JmpSiteProfile, type JmpTestimonial, type JmpTrustBundle, type JmpTrustSlot, type JmpTrustStat, type JmpTrustSummary, type LeadMetadata, type LeadMetadataValue, type TrackLeadOptions, type TrackPageViewOptions, type TrackServerPageViewOptions, buildLandingCaptureInlineScript, createJmpAnalytics, createJmpContentClient, createJmpContentClientFromServerEnv, getJmpBlogPost, getJmpBlogPosts, getJmpBrowserAnalyticsConfigFromEnv, getJmpFaqs, getJmpRobotsTxt, getJmpServerContentConfigFromEnv, getJmpSiteProfile, getJmpTrustBundle, getOrCreateJmpAnalyticsFromBrowserEnv, isJmpBrowserAnalyticsEnvConfigured, isJmpServerContentEnvConfigured, registerJmpContentWrappers, registerJmpTrustCapabilities, sendEarlyPageViewBeacon, trackJmpServerPageView };

package/dist/index.js

@@ -1,5 +1,6 @@
 import {
   DEFAULT_JMP_BROWSER_PAGE_VIEW_DEDUPE_MS,
+  buildLandingCaptureInlineScript,
   createJmpAnalytics,
   createJmpContentClient,
   createJmpContentClientFromServerEnv,
@@ -14,10 +15,14 @@ import {
   getOrCreateJmpAnalyticsFromBrowserEnv,
   isJmpBrowserAnalyticsEnvConfigured,
   isJmpServerContentEnvConfigured,
+  registerJmpContentWrappers,
+  registerJmpTrustCapabilities,
+  sendEarlyPageViewBeacon,
   trackJmpServerPageView
-} from "./chunk-K47RWY4L.js";
+} from "./chunk-CCCYRBYK.js";
 export {
   DEFAULT_JMP_BROWSER_PAGE_VIEW_DEDUPE_MS,
+  buildLandingCaptureInlineScript,
   createJmpAnalytics,
   createJmpContentClient,
   createJmpContentClientFromServerEnv,
@@ -32,6 +37,9 @@ export {
   getOrCreateJmpAnalyticsFromBrowserEnv,
   isJmpBrowserAnalyticsEnvConfigured,
   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,52 +18,237 @@ 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";
-function responseLooksLikeHtml(body) {
-  const s = body.trimStart();
-  return s.startsWith("<!") || s.toLowerCase().startsWith("<html") || s.startsWith("<") && /<html[\s>]/i.test(s.slice(0, 500));
+// 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 refererHostFromUrl(referer) {
+  const trimmed = referer.trim();
+  try {
+    return new URL(trimmed).hostname.replace(/^www\./i, "").toLowerCase();
+  } catch {
+    try {
+      return new URL(`https://${trimmed}`).hostname.replace(/^www\./i, "").toLowerCase();
+    } catch {
+      return null;
+    }
+  }
 }
-function normalizeBaseUrl(baseUrl) {
-  return baseUrl.replace(/\/$/, "");
+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 inferDevice() {
-  if (typeof window === "undefined") {
-    return "unknown";
+function captureLandingAttribution(siteHostname) {
+  if (typeof document === "undefined" || typeof window === "undefined") {
+    return { landingReferer: null, utm: {} };
   }
-  return window.innerWidth < 768 ? "mobile" : "desktop";
+  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);
+    const rawUtm = sessionStorage.getItem(JMP_UTM_SESSION_KEY);
+    if (rawUtm) {
+      const parsed = JSON.parse(rawUtm);
+      if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+        utm = parsed;
+      }
+    }
+    let updated = false;
+    for (const key of JMP_UTM_PARAM_KEYS) {
+      const value = params.get(key)?.trim();
+      if (value) {
+        utm[key] = value;
+        updated = true;
+      }
+    }
+    if (updated) {
+      sessionStorage.setItem(JMP_UTM_SESSION_KEY, JSON.stringify(utm));
+    }
+  } catch {
+  }
+  return { landingReferer, utm };
 }
-function getOrCreateSessionId() {
+function getOrCreateSessionIdFromStorage() {
   if (typeof window === "undefined" || !globalThis.crypto?.randomUUID) {
     return void 0;
   }
   try {
-    let id = sessionStorage.getItem(SESSION_STORAGE_KEY);
+    let id = sessionStorage.getItem(JMP_SESSION_ID_KEY);
     if (!id) {
       id = crypto.randomUUID();
-      sessionStorage.setItem(SESSION_STORAGE_KEY, id);
+      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) {
+    return { pathname: pathInput || "/", search: "" };
+  }
+  return {
+    pathname: pathInput.slice(0, qIndex) || "/",
+    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";
+}
 function createJmpAnalytics(config) {
   const baseUrl = normalizeBaseUrl(config.baseUrl);
   const resolvedFetch = config.fetchImpl ?? (typeof globalThis !== "undefined" && globalThis.fetch ? globalThis.fetch.bind(globalThis) : void 0);
@@ -79,7 +266,13 @@ function createJmpAnalytics(config) {
       "Content-Type": "application/json",
       "X-JMP-Tracking-Key": config.trackingKey
     };
-    const sid = getOrCreateSessionId();
+    if (body.type === "page_view" && typeof window !== "undefined") {
+      const landingReferer = captureAndGetLandingReferer();
+      if (landingReferer) {
+        headers["X-JMP-Visitor-Referer"] = landingReferer;
+      }
+    }
+    const sid = getOrCreateSessionIdFromStorage();
     const payload = { ...body, ...sid ? { sessionId: sid } : {} };
     if (config.debug) {
       console.debug("[@jmp-technologies/analytics]", "POST", url, payload);
@@ -128,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);
@@ -185,28 +378,44 @@ function createJmpAnalytics(config) {
     return false;
   }
   function trackPageView(options) {
-    const pathname = options?.path ?? (typeof window !== "undefined" ? window.location.pathname : "/");
-    const search = typeof window !== "undefined" ? window.location.search.replace(/^\?/, "") : "";
+    const pathFromOptions = options?.path?.trim();
+    let pathname = "/";
+    let search = "";
+    if (pathFromOptions) {
+      const split = splitPathAndSearch(pathFromOptions);
+      pathname = split.pathname;
+      search = split.search;
+    } else if (typeof window !== "undefined") {
+      pathname = window.location.pathname;
+      search = window.location.search.replace(/^\?/, "");
+    }
+    if (!search && typeof window !== "undefined") {
+      search = window.location.search.replace(/^\?/, "");
+    }
     const path = search ? `${pathname}?${search}` : pathname;
+    if (wasEarlyBeaconSentForPath(path)) {
+      return Promise.resolve();
+    }
     if (shouldDedupePageView(pathname)) {
       return Promise.resolve();
     }
     const metadata = options?.metadata && typeof options.metadata === "object" ? { ...options.metadata } : {};
     if (typeof window !== "undefined") {
       metadata.pageHostname = window.location.hostname;
-      const params = new URLSearchParams(window.location.search);
-      for (const key of [
-        "utm_source",
-        "utm_medium",
-        "utm_campaign",
-        "utm_content",
-        "utm_term"
-      ]) {
+      const params = new URLSearchParams(
+        search ? `?${search}` : window.location.search
+      );
+      for (const key of JMP_UTM_PARAM_KEYS) {
         const v = params.get(key);
         if (v && metadata[key] === void 0) {
           metadata[key] = v;
         }
       }
+      mergeSessionUtms(metadata);
+      const landingReferer = captureAndGetLandingReferer();
+      if (landingReferer && metadata.referer === void 0) {
+        metadata.referer = landingReferer;
+      }
     }
     return send({
       type: "page_view",
@@ -304,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,
@@ -388,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]);
@@ -403,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