@jmp-technologies/analytics 0.1.26 → 0.1.30

package/dist/index.cjs

@@ -36,6 +36,9 @@ __export(index_exports, {
   getJmpBrowserAnalyticsConfigFromEnv: () => getJmpBrowserAnalyticsConfigFromEnv,
   getJmpContentConfig: () => getJmpContentConfig,
   getJmpFaqs: () => getJmpFaqs,
+  getJmpLandingPageDetail: () => getJmpLandingPageDetail,
+  getJmpLandingPageSitemap: () => getJmpLandingPageSitemap,
+  getJmpLandingPages: () => getJmpLandingPages,
   getJmpRobotsTxt: () => getJmpRobotsTxt,
   getJmpServerContentConfigFromEnv: () => getJmpServerContentConfigFromEnv,
   getJmpSiteDefinition: () => getJmpSiteDefinition,
@@ -47,10 +50,12 @@ __export(index_exports, {
   isJmpServerContentEnvConfigured: () => isJmpServerContentEnvConfigured,
   isJmpTrackingConsentGranted: () => isJmpTrackingConsentGranted,
   markContentWrapper: () => markContentWrapper,
+  normalizeJmpContentManifest: () => normalizeJmpContentManifest,
   readJmpPublicEnvFromProcess: () => readJmpPublicEnvFromProcess,
   registerJmpContentWrappers: () => registerJmpContentWrappers,
   resetContentWrapperDiscoveryForTests: () => resetContentWrapperDiscoveryForTests,
   setJmpTrackingConsent: () => setJmpTrackingConsent,
+  stableJmpManifestFingerprint: () => stableJmpManifestFingerprint,
   subscribeJmpTrackingConsent: () => subscribeJmpTrackingConsent,
   trackJmpServerPageView: () => trackJmpServerPageView
 });
@@ -318,7 +323,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;
 
@@ -859,6 +864,209 @@ async function trackJmpServerPageView(config, options = {}) {
   }
 }
 
+// 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/fetch.ts
 async function getContent(config, path) {
   const text = await getContentText(config, path);
@@ -973,16 +1181,22 @@ function inferTrustWrapperSlots(bundle) {
 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) {
@@ -1073,6 +1287,53 @@ async function getJmpFaqs(config) {
   afterContentWrapperUse(config);
   return data.faqs;
 }
+async function getJmpLandingPages(config, filters) {
+  const params = new URLSearchParams();
+  if (filters?.kind) {
+    params.set("kind", filters.kind);
+  }
+  if (filters?.locale) {
+    params.set("locale", filters.locale);
+  }
+  const query = params.toString();
+  const data = await getContent(
+    config,
+    `/api/content/landing-pages${query ? `?${query}` : ""}`
+  );
+  markContentWrapper("landing");
+  afterContentWrapperUse(config);
+  return data.pages;
+}
+async function getJmpLandingPageDetail(config, kind, slug, locale) {
+  const params = new URLSearchParams();
+  if (locale) {
+    params.set("locale", locale);
+  }
+  const query = params.toString();
+  try {
+    const detail = await getContent(
+      config,
+      `/api/content/landing-pages/${encodeURIComponent(kind)}/${encodeURIComponent(slug)}${query ? `?${query}` : ""}`
+    );
+    markContentWrapper("landing");
+    afterContentWrapperUse(config);
+    return detail;
+  } catch (error) {
+    if (error instanceof Error && error.message.includes("HTTP 404")) {
+      return null;
+    }
+    throw error;
+  }
+}
+async function getJmpLandingPageSitemap(config) {
+  const data = await getContent(
+    config,
+    "/api/content/landing-pages/sitemap"
+  );
+  markContentWrapper("landing");
+  afterContentWrapperUse(config);
+  return data.entries;
+}
 async function getJmpTrustBundle(config) {
   const bundle = await getContent(config, "/api/content/trust");
   markTrustBundleWrappers(bundle);
@@ -1096,7 +1357,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 };
   }
@@ -1109,7 +1371,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",
@@ -1117,10 +1389,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) {
@@ -1146,6 +1415,9 @@ function createJmpContentClient(config) {
     getBlogPosts: () => getJmpBlogPosts(config),
     getBlogPost: (slug) => getJmpBlogPost(config, slug),
     getFaqs: () => getJmpFaqs(config),
+    getLandingPages: (filters) => getJmpLandingPages(config, filters),
+    getLandingPageDetail: (kind, slug, locale) => getJmpLandingPageDetail(config, kind, slug, locale),
+    getLandingPageSitemap: () => getJmpLandingPageSitemap(config),
     getTrustBundle: () => getJmpTrustBundle(config),
     getSiteProfile: () => getJmpSiteProfile(config),
     getRobotsTxt: () => getJmpRobotsTxt(config),
@@ -1216,7 +1488,8 @@ function getJmpContentConfig() {
   return {
     baseUrl: analyticsUrl,
     trackingKey,
-    contentWrappers: site?.contentWrappers ?? void 0
+    contentWrappers: site?.contentWrappers ?? void 0,
+    contentManifest: site?.contentManifest ?? void 0
   };
 }
 
@@ -1282,6 +1555,9 @@ function createJmpContentClientFromServerEnv(overrides) {
   getJmpBrowserAnalyticsConfigFromEnv,
   getJmpContentConfig,
   getJmpFaqs,
+  getJmpLandingPageDetail,
+  getJmpLandingPageSitemap,
+  getJmpLandingPages,
   getJmpRobotsTxt,
   getJmpServerContentConfigFromEnv,
   getJmpSiteDefinition,
@@ -1293,10 +1569,12 @@ function createJmpContentClientFromServerEnv(overrides) {
   isJmpServerContentEnvConfigured,
   isJmpTrackingConsentGranted,
   markContentWrapper,
+  normalizeJmpContentManifest,
   readJmpPublicEnvFromProcess,
   registerJmpContentWrappers,
   resetContentWrapperDiscoveryForTests,
   setJmpTrackingConsent,
+  stableJmpManifestFingerprint,
   subscribeJmpTrackingConsent,
   trackJmpServerPageView
 });