@jmp-technologies/analytics 0.1.27 → 0.1.32

package/dist/react.cjs

@@ -28,6 +28,145 @@ __export(react_exports, {
 module.exports = __toCommonJS(react_exports);
 var import_react = require("react");
 
+// 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;
+  }
+  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 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 {
+    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 extractTelTarget(href) {
+  const raw = href.trim();
+  if (!raw.toLowerCase().startsWith("tel:")) {
+    return null;
+  }
+  const target = decodeURIComponent(
+    raw.slice(4).split("?")[0]?.split(";")[0] ?? ""
+  ).trim();
+  return target || null;
+}
+function extractMailtoTarget(href) {
+  const raw = href.trim();
+  if (!raw.toLowerCase().startsWith("mailto:")) {
+    return null;
+  }
+  const target = decodeURIComponent(
+    raw.slice(7).split("?")[0]?.split(",")[0] ?? ""
+  ).trim();
+  return target || null;
+}
+
 // src/landing-capture.ts
 var JMP_SESSION_ID_KEY = "jmp_analytics_sid";
 var JMP_LANDING_REFERER_KEY = "jmp_analytics_landing_referer";
@@ -166,125 +305,6 @@ function getOrCreateSessionIdFromStorage() {
   }
 }
 
-// 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;
-  }
-  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 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 {
-    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;
-}
-
 // src/constants.ts
 var JMP_ANALYTICS_SDK_VERSION = "0.1.26";
 var JMP_TRACKING_CONSENT_STORAGE_KEY = "jmp_analytics_consent_v1";
@@ -700,14 +720,22 @@ function createJmpAnalytics(config) {
         if (dedupeContactClick(`call_click:${path}`)) {
           return;
         }
-        void trackCallClick(path);
+        const contactTarget = extractTelTarget(href);
+        void trackCallClick(
+          path,
+          contactTarget ? { contactTarget } : void 0
+        );
         return;
       }
       if (classified.kind === "email") {
         if (dedupeContactClick(`email_click:${path}`)) {
           return;
         }
-        void trackEmailClick(path);
+        const contactTarget = extractMailtoTarget(href);
+        void trackEmailClick(
+          path,
+          contactTarget ? { contactTarget } : void 0
+        );
         return;
       }
       if (dedupeContactClick(`contact_click:${classified.channel}:${path}`)) {
@@ -753,6 +781,209 @@ function createJmpAnalytics(config) {
   };
 }
 
+// src/content/manifest.ts
+var JMP_CONTENT_MANIFEST_VERSION = 1;
+var TRUST_SECTIONS = /* @__PURE__ */ new Set([
+  "summary",
+  "testimonials",
+  "reviews",
+  "stats",
+  "logos",
+  "credentials"
+]);
+function normalizeKey(value) {
+  return value.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function isValidExtraKey(key) {
+  return /^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(key);
+}
+var MAX_EXTERNAL_ADMIN_LINKS = 10;
+var MAX_EXTERNAL_ADMIN_LINK_LABEL_LENGTH = 80;
+var EXTERNAL_ADMIN_LINK_ID_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+function tryNormalizeHttpUrl(input) {
+  if (typeof input !== "string" || !input.trim()) {
+    return null;
+  }
+  try {
+    const url = new URL(input.trim());
+    if (url.protocol !== "https:" && url.protocol !== "http:") {
+      return null;
+    }
+    return url.toString().replace(/\/$/, "");
+  } catch {
+    return null;
+  }
+}
+function normalizeShopifyExternalSource(shopify) {
+  if (!shopify || typeof shopify !== "object") {
+    return null;
+  }
+  const adminUrl = tryNormalizeHttpUrl(shopify.adminUrl);
+  const storeUrl = tryNormalizeHttpUrl(shopify.storeUrl);
+  if (!adminUrl && !storeUrl) {
+    return null;
+  }
+  return {
+    ...adminUrl ? { adminUrl } : {},
+    ...storeUrl ? { storeUrl } : {}
+  };
+}
+function normalizeExternalAdminLinkEntries(links) {
+  if (!Array.isArray(links)) {
+    return [];
+  }
+  const seenIds = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const raw of links) {
+    if (!raw || typeof raw !== "object" || out.length >= MAX_EXTERNAL_ADMIN_LINKS) {
+      continue;
+    }
+    const id = typeof raw.id === "string" ? raw.id.trim().toLowerCase().replace(/[^a-z0-9-]+/g, "-").replace(/^-+|-+$/g, "") : "";
+    const label = typeof raw.label === "string" ? raw.label.trim().slice(0, MAX_EXTERNAL_ADMIN_LINK_LABEL_LENGTH) : "";
+    const url = tryNormalizeHttpUrl(raw.url);
+    if (!id || !label || !url || !EXTERNAL_ADMIN_LINK_ID_PATTERN.test(id) || seenIds.has(id)) {
+      continue;
+    }
+    seenIds.add(id);
+    out.push({ id, label, url });
+  }
+  return out;
+}
+function normalizeExternalSources(externalSources) {
+  if (!externalSources || typeof externalSources !== "object") {
+    return null;
+  }
+  const studioUrl = tryNormalizeHttpUrl(externalSources.sanity?.studioUrl);
+  const shopify = normalizeShopifyExternalSource(externalSources.shopify);
+  const links = normalizeExternalAdminLinkEntries(externalSources.links);
+  if (!studioUrl && !shopify && links.length === 0) {
+    return null;
+  }
+  return {
+    ...studioUrl ? { sanity: { studioUrl } } : {},
+    ...shopify ? { shopify } : {},
+    ...links.length > 0 ? { links } : {}
+  };
+}
+function normalizeJmpContentManifest(input) {
+  if (!input || typeof input !== "object") {
+    return null;
+  }
+  const routes = normalizeRoutes(input.routes);
+  const externalSources = normalizeExternalSources(input.externalSources);
+  const trust = normalizeTrust(input.trust);
+  const contact = normalizeContact(input.contact);
+  if (routes.length === 0 && !externalSources && !trust && !contact) {
+    return null;
+  }
+  return {
+    version: JMP_CONTENT_MANIFEST_VERSION,
+    ...routes.length > 0 ? { routes } : {},
+    ...externalSources ? { externalSources } : {},
+    ...trust ? { trust } : {},
+    ...contact ? { contact } : {}
+  };
+}
+function normalizeRoutes(routes) {
+  if (!Array.isArray(routes)) {
+    return [];
+  }
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const raw of routes) {
+    if (!raw || typeof raw !== "object") continue;
+    const wrapper = typeof raw.wrapper === "string" ? raw.wrapper.trim().toLowerCase() : "";
+    const pattern = typeof raw.pattern === "string" ? raw.pattern.trim() : "";
+    if (!wrapper || !pattern) continue;
+    const dedupe = `${wrapper}:${pattern}`;
+    if (seen.has(dedupe)) continue;
+    seen.add(dedupe);
+    out.push({
+      wrapper,
+      pattern,
+      ...typeof raw.index === "string" && raw.index.trim() ? { index: raw.index.trim() } : {},
+      ...typeof raw.label === "string" && raw.label.trim() ? { label: raw.label.trim() } : {}
+    });
+  }
+  return out;
+}
+function normalizeTrust(trust) {
+  if (!trust || typeof trust !== "object") return null;
+  const blocks = normalizeTrustBlocks(trust.blocks);
+  const labels = normalizeTrustLabels(trust.labels);
+  const mergeTestimonialsReviews = trust.mergeTestimonialsReviews === true;
+  if (blocks.length === 0 && !labels && !mergeTestimonialsReviews) return null;
+  return {
+    ...blocks.length > 0 ? { blocks } : {},
+    ...labels ? { labels } : {},
+    ...mergeTestimonialsReviews ? { mergeTestimonialsReviews: true } : {}
+  };
+}
+function normalizeTrustBlocks(blocks) {
+  if (!Array.isArray(blocks)) return [];
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const raw of blocks) {
+    if (!raw || typeof raw !== "object") continue;
+    const section = typeof raw.section === "string" ? raw.section.trim().toLowerCase() : "";
+    if (!TRUST_SECTIONS.has(section) || seen.has(section)) continue;
+    seen.add(section);
+    out.push({
+      section,
+      ...typeof raw.label === "string" && raw.label.trim() ? { label: raw.label.trim() } : {}
+    });
+  }
+  return out;
+}
+function normalizeTrustLabels(labels) {
+  if (!labels || typeof labels !== "object") return null;
+  const out = {};
+  for (const [key, value] of Object.entries(labels)) {
+    if (TRUST_SECTIONS.has(key) && typeof value === "string" && value.trim()) {
+      out[key] = value.trim();
+    }
+  }
+  return Object.keys(out).length > 0 ? out : null;
+}
+function normalizeContact(contact) {
+  if (!contact || typeof contact !== "object") return null;
+  const extras = normalizeContactExtras(contact.extras);
+  return extras.length > 0 ? { extras } : null;
+}
+function normalizeContactExtras(extras) {
+  if (!Array.isArray(extras)) return [];
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const raw of extras) {
+    if (!raw || typeof raw !== "object") continue;
+    const label = typeof raw.label === "string" ? raw.label.trim() : "";
+    const key = normalizeKey(
+      typeof raw.key === "string" && raw.key.trim() ? raw.key : label
+    );
+    if (!key || !label || !isValidExtraKey(key) || seen.has(key)) continue;
+    seen.add(key);
+    out.push({ key, label });
+  }
+  return out;
+}
+function stableJmpManifestFingerprint(manifest) {
+  return manifest ? JSON.stringify(manifest) : "";
+}
+function inferWrapperSlotsFromManifest(manifest) {
+  const slots = /* @__PURE__ */ new Set();
+  for (const route of manifest?.routes ?? []) {
+    slots.add(route.wrapper);
+  }
+  for (const block of manifest?.trust?.blocks ?? []) {
+    slots.add(`trust.${block.section}`);
+    slots.add("trust");
+  }
+  if (manifest?.contact?.extras?.length) {
+    slots.add("contact");
+  }
+  return [...slots];
+}
+
 // src/content/wrapper-discovery.ts
 var WRAPPER_SLOT_ORDER = [
   "blog",
@@ -772,16 +1003,22 @@ var syncHandler = null;
 function getDiscoveredContentWrappers() {
   return sortWrapperSlots([...discovered]);
 }
+function resolveContentManifestForReport(config) {
+  return normalizeJmpContentManifest(config.contentManifest);
+}
 function resolveContentWrappersForReport(config) {
   const explicit = config.contentWrappers ?? [];
   const auto = getDiscoveredContentWrappers();
+  const fromManifest = inferWrapperSlotsFromManifest(
+    resolveContentManifestForReport(config)
+  );
   if (config.contentWrapperMode === "manual") {
-    return sortWrapperSlots([...explicit]);
+    return sortWrapperSlots([...explicit, ...fromManifest]);
   }
   if (config.contentWrapperMode === "explicit-only") {
-    return sortWrapperSlots([...explicit]);
+    return sortWrapperSlots([...explicit, ...fromManifest]);
   }
-  const merged = /* @__PURE__ */ new Set([...explicit, ...auto]);
+  const merged = /* @__PURE__ */ new Set([...explicit, ...auto, ...fromManifest]);
   return sortWrapperSlots([...merged]);
 }
 function hasReportedContentWrappers(dedupeKey) {
@@ -811,7 +1048,8 @@ async function registerJmpContentWrappers(config) {
   if (!wrappers.length) {
     return { ok: false, skipped: true };
   }
-  const dedupeKey = `${config.trackingKey}:${[...wrappers].sort().join(",")}`;
+  const manifest = resolveContentManifestForReport(config);
+  const dedupeKey = `${config.trackingKey}:${[...wrappers].sort().join(",")}:${stableJmpManifestFingerprint(manifest)}`;
   if (hasReportedContentWrappers(dedupeKey)) {
     return { ok: true, wrappers };
   }
@@ -824,7 +1062,17 @@ async function registerJmpContentWrappers(config) {
   }
   const url = `${baseUrl}/api/content/capabilities`;
   if (config.debug) {
-    console.debug("[@jmp-technologies/analytics]", "POST", url, { wrappers });
+    console.debug("[@jmp-technologies/analytics]", "POST", url, {
+      wrappers,
+      manifest
+    });
+  }
+  const body = {
+    wrappers,
+    sdkVersion: JMP_ANALYTICS_SDK_VERSION
+  };
+  if (manifest) {
+    body.manifest = manifest;
   }
   const res = await resolvedFetch(url, {
     method: "POST",
@@ -832,10 +1080,7 @@ async function registerJmpContentWrappers(config) {
       "Content-Type": "application/json",
       "X-JMP-Tracking-Key": config.trackingKey
     },
-    body: JSON.stringify({
-      wrappers,
-      sdkVersion: JMP_ANALYTICS_SDK_VERSION
-    })
+    body: JSON.stringify(body)
   });
   const text = await res.text();
   if (!res.ok) {
@@ -937,13 +1182,21 @@ var import_jsx_runtime = require("react/jsx-runtime");
 function useJmpAnalytics() {
   return (0, import_react.useMemo)(() => getOrCreateJmpAnalyticsFromBrowserEnv(), []);
 }
-function trackCallClickFromCurrentPath() {
+function trackCallClickFromHref(href) {
   const path = typeof window !== "undefined" ? window.location.pathname : "/";
-  void getOrCreateJmpAnalyticsFromBrowserEnv()?.trackCallClick(path);
+  const contactTarget = extractTelTarget(href);
+  void getOrCreateJmpAnalyticsFromBrowserEnv()?.trackCallClick(
+    path,
+    contactTarget ? { contactTarget } : void 0
+  );
 }
-function trackEmailClickFromCurrentPath() {
+function trackEmailClickFromHref(href) {
   const path = typeof window !== "undefined" ? window.location.pathname : "/";
-  void getOrCreateJmpAnalyticsFromBrowserEnv()?.trackEmailClick(path);
+  const contactTarget = extractMailtoTarget(href);
+  void getOrCreateJmpAnalyticsFromBrowserEnv()?.trackEmailClick(
+    path,
+    contactTarget ? { contactTarget } : void 0
+  );
 }
 function JmpTrackedTelLink({
   href,
@@ -957,7 +1210,7 @@ function JmpTrackedTelLink({
       "data-jmp-tracked": "true",
       ...rest,
       onClick: (e) => {
-        trackCallClickFromCurrentPath();
+        trackCallClickFromHref(href);
         onClick?.(e);
       }
     }
@@ -975,7 +1228,7 @@ function JmpTrackedMailtoLink({
       "data-jmp-tracked": "true",
       ...rest,
       onClick: (e) => {
-        trackEmailClickFromCurrentPath();
+        trackEmailClickFromHref(href);
         onClick?.(e);
       }
     }