@jmp-technologies/analytics 0.1.26 → 0.1.30

package/dist/react.cjs

@@ -286,7 +286,7 @@ function classifyContactHref(href) {
 }
 
 // src/constants.ts
-var JMP_ANALYTICS_SDK_VERSION = "0.1.25";
+var JMP_ANALYTICS_SDK_VERSION = "0.1.26";
 var JMP_TRACKING_CONSENT_STORAGE_KEY = "jmp_analytics_consent_v1";
 var DEFAULT_JMP_BROWSER_PAGE_VIEW_DEDUPE_MS = 2500;
 
@@ -753,6 +753,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 +975,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 +1020,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 +1034,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 +1052,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) {