@jmp-technologies/analytics 0.1.24 → 0.1.26

package/dist/index.cjs

@@ -30,6 +30,7 @@ __export(index_exports, {
   createJmpContentClient: () => createJmpContentClient,
   createJmpContentClientFromServerEnv: () => createJmpContentClientFromServerEnv,
   defineJmpSite: () => defineJmpSite,
+  getDiscoveredContentWrappers: () => getDiscoveredContentWrappers,
   getJmpBlogPost: () => getJmpBlogPost,
   getJmpBlogPosts: () => getJmpBlogPosts,
   getJmpBrowserAnalyticsConfigFromEnv: () => getJmpBrowserAnalyticsConfigFromEnv,
@@ -41,11 +42,14 @@ __export(index_exports, {
   getJmpSiteProfile: () => getJmpSiteProfile,
   getJmpTrustBundle: () => getJmpTrustBundle,
   getOrCreateJmpAnalyticsFromBrowserEnv: () => getOrCreateJmpAnalyticsFromBrowserEnv,
+  inferTrustWrapperSlots: () => inferTrustWrapperSlots,
   isJmpBrowserAnalyticsEnvConfigured: () => isJmpBrowserAnalyticsEnvConfigured,
   isJmpServerContentEnvConfigured: () => isJmpServerContentEnvConfigured,
   isJmpTrackingConsentGranted: () => isJmpTrackingConsentGranted,
+  markContentWrapper: () => markContentWrapper,
   readJmpPublicEnvFromProcess: () => readJmpPublicEnvFromProcess,
   registerJmpContentWrappers: () => registerJmpContentWrappers,
+  resetContentWrapperDiscoveryForTests: () => resetContentWrapperDiscoveryForTests,
   setJmpTrackingConsent: () => setJmpTrackingConsent,
   subscribeJmpTrackingConsent: () => subscribeJmpTrackingConsent,
   trackJmpServerPageView: () => trackJmpServerPageView
@@ -314,7 +318,7 @@ function classifyContactHref(href) {
 }
 
 // src/constants.ts
-var JMP_ANALYTICS_SDK_VERSION = "0.1.24";
+var JMP_ANALYTICS_SDK_VERSION = "0.1.25";
 var JMP_TRACKING_CONSENT_STORAGE_KEY = "jmp_analytics_consent_v1";
 var DEFAULT_JMP_BROWSER_PAGE_VIEW_DEDUPE_MS = 2500;
 
@@ -902,12 +906,146 @@ async function getContentText(config, path) {
   return text;
 }
 
+// src/content/wrapper-discovery.ts
+var WRAPPER_SLOT_ORDER = [
+  "blog",
+  "faq",
+  "contact",
+  "trust",
+  "trust.summary",
+  "trust.testimonials",
+  "trust.reviews",
+  "trust.stats",
+  "trust.logos",
+  "trust.credentials"
+];
+var discovered = /* @__PURE__ */ new Set();
+var syncTimer = null;
+var pendingSyncConfig = null;
+var reportedDedupeKeys = /* @__PURE__ */ new Set();
+var syncHandler = null;
+function markContentWrapper(slot) {
+  const normalized = slot.trim().toLowerCase();
+  if (!normalized) {
+    return;
+  }
+  discovered.add(normalized);
+}
+function markTrustBundleWrappers(bundle) {
+  for (const slot of inferTrustWrapperSlots(bundle)) {
+    discovered.add(slot);
+  }
+}
+function inferTrustWrapperSlots(bundle) {
+  const slots = /* @__PURE__ */ new Set(["trust"]);
+  const { summary, testimonials, stats, logos, credentials } = bundle;
+  const hasSummary = summary.google_rating != null || summary.google_review_count != null || Boolean(summary.google_reviews_url?.trim()) || Boolean(summary.yelp_url?.trim()) || Boolean(summary.trustpilot_url?.trim()) || Boolean(summary.disclaimer?.trim());
+  if (hasSummary) {
+    slots.add("trust.summary");
+  }
+  let hasTestimonials = false;
+  let hasReviews = false;
+  for (const item of testimonials) {
+    const bucket = item.placement?.trim().toLowerCase();
+    if (bucket === "reviews") {
+      hasReviews = true;
+    } else {
+      hasTestimonials = true;
+    }
+  }
+  if (hasTestimonials) {
+    slots.add("trust.testimonials");
+  }
+  if (hasReviews) {
+    slots.add("trust.reviews");
+  }
+  if (stats.length > 0) {
+    slots.add("trust.stats");
+  }
+  if (logos.length > 0) {
+    slots.add("trust.logos");
+  }
+  if (credentials.length > 0) {
+    slots.add("trust.credentials");
+  }
+  return sortWrapperSlots([...slots]);
+}
+function getDiscoveredContentWrappers() {
+  return sortWrapperSlots([...discovered]);
+}
+function resolveContentWrappersForReport(config) {
+  const explicit = config.contentWrappers ?? [];
+  const auto = getDiscoveredContentWrappers();
+  if (config.contentWrapperMode === "manual") {
+    return sortWrapperSlots([...explicit]);
+  }
+  if (config.contentWrapperMode === "explicit-only") {
+    return sortWrapperSlots([...explicit]);
+  }
+  const merged = /* @__PURE__ */ new Set([...explicit, ...auto]);
+  return sortWrapperSlots([...merged]);
+}
+function hasReportedContentWrappers(dedupeKey) {
+  return reportedDedupeKeys.has(dedupeKey);
+}
+function rememberReportedContentWrappers(dedupeKey) {
+  reportedDedupeKeys.add(dedupeKey);
+}
+function setContentWrapperSyncHandler(handler) {
+  syncHandler = handler;
+}
+function scheduleContentWrapperSync(config) {
+  if (!syncHandler) {
+    return;
+  }
+  pendingSyncConfig = config;
+  if (syncTimer) {
+    clearTimeout(syncTimer);
+  }
+  syncTimer = setTimeout(() => {
+    syncTimer = null;
+    const cfg = pendingSyncConfig;
+    pendingSyncConfig = null;
+    if (!cfg || !syncHandler) {
+      return;
+    }
+    void syncHandler(cfg).catch(() => {
+    });
+  }, 750);
+}
+function resetContentWrapperDiscoveryForTests() {
+  discovered.clear();
+  reportedDedupeKeys.clear();
+  syncHandler = null;
+  if (syncTimer) {
+    clearTimeout(syncTimer);
+    syncTimer = null;
+  }
+  pendingSyncConfig = null;
+}
+function sortWrapperSlots(slots) {
+  const order = new Map(WRAPPER_SLOT_ORDER.map((slot, index) => [slot, index]));
+  return [...new Set(slots)].sort((a, b) => {
+    const ai = order.get(a) ?? 999;
+    const bi = order.get(b) ?? 999;
+    if (ai !== bi) {
+      return ai - bi;
+    }
+    return a.localeCompare(b);
+  });
+}
+
 // src/content/api.ts
+function afterContentWrapperUse(config) {
+  scheduleContentWrapperSync(config);
+}
 async function getJmpBlogPosts(config) {
   const data = await getContent(
     config,
     "/api/content/blog"
   );
+  markContentWrapper("blog");
+  afterContentWrapperUse(config);
   return data.posts;
 }
 async function getJmpBlogPost(config, slug) {
@@ -916,6 +1054,8 @@ async function getJmpBlogPost(config, slug) {
       config,
       `/api/content/blog/${encodeURIComponent(slug)}`
     );
+    markContentWrapper("blog");
+    afterContentWrapperUse(config);
     return data.post;
   } catch (error) {
     if (error instanceof Error && error.message.includes("HTTP 404")) {
@@ -929,35 +1069,35 @@ async function getJmpFaqs(config) {
     config,
     "/api/content/faqs"
   );
+  markContentWrapper("faq");
+  afterContentWrapperUse(config);
   return data.faqs;
 }
 async function getJmpTrustBundle(config) {
-  return getContent(config, "/api/content/trust");
+  const bundle = await getContent(config, "/api/content/trust");
+  markTrustBundleWrappers(bundle);
+  afterContentWrapperUse(config);
+  return bundle;
 }
 async function getJmpSiteProfile(config) {
   const data = await getContent(
     config,
     "/api/content/site"
   );
+  markContentWrapper("contact");
+  afterContentWrapperUse(config);
   return data.site;
 }
 async function getJmpRobotsTxt(config) {
   return getContentText(config, "/api/content/robots");
 }
-var registeredContentWrappers = /* @__PURE__ */ new Set();
-function resolveContentWrappersFromConfig(config) {
-  if (config.contentWrappers?.length) {
-    return [...config.contentWrappers];
-  }
-  return [];
-}
 async function registerJmpContentWrappers(config) {
-  const wrappers = resolveContentWrappersFromConfig(config);
+  const wrappers = resolveContentWrappersForReport(config);
   if (!wrappers.length) {
     return { ok: false, skipped: true };
   }
   const dedupeKey = `${config.trackingKey}:${[...wrappers].sort().join(",")}`;
-  if (registeredContentWrappers.has(dedupeKey)) {
+  if (hasReportedContentWrappers(dedupeKey)) {
     return { ok: true, wrappers };
   }
   const baseUrl = normalizeBaseUrl(config.baseUrl);
@@ -994,10 +1134,11 @@ async function registerJmpContentWrappers(config) {
       [`JMP content wrappers HTTP ${res.status}`, parsed.error, parsed.hint].filter(Boolean).join(" \u2014 ")
     );
   }
-  registeredContentWrappers.add(dedupeKey);
+  rememberReportedContentWrappers(dedupeKey);
   const data = JSON.parse(text);
   return { ok: true, wrappers: data.wrappers ?? wrappers };
 }
+setContentWrapperSyncHandler(registerJmpContentWrappers);
 
 // src/content/client.ts
 function createJmpContentClient(config) {
@@ -1135,6 +1276,7 @@ function createJmpContentClientFromServerEnv(overrides) {
   createJmpContentClient,
   createJmpContentClientFromServerEnv,
   defineJmpSite,
+  getDiscoveredContentWrappers,
   getJmpBlogPost,
   getJmpBlogPosts,
   getJmpBrowserAnalyticsConfigFromEnv,
@@ -1146,11 +1288,14 @@ function createJmpContentClientFromServerEnv(overrides) {
   getJmpSiteProfile,
   getJmpTrustBundle,
   getOrCreateJmpAnalyticsFromBrowserEnv,
+  inferTrustWrapperSlots,
   isJmpBrowserAnalyticsEnvConfigured,
   isJmpServerContentEnvConfigured,
   isJmpTrackingConsentGranted,
+  markContentWrapper,
   readJmpPublicEnvFromProcess,
   registerJmpContentWrappers,
+  resetContentWrapperDiscoveryForTests,
   setJmpTrackingConsent,
   subscribeJmpTrackingConsent,
   trackJmpServerPageView