@liiift-studio/sanity-visitor-insights 0.30.0 → 0.31.0

package/dist/server.js

@@ -1057,7 +1057,7 @@ function fromOrders(ga4Purchases, sanityOrders) {
     rate: ga4Purchases / sanityOrders,
     observed: ga4Purchases,
     actual: sanityOrders,
-    note: `GA4 purchases against the ${sanityOrders} orders that exist \u2014 the same event on both sides. Small numbers move it a long way: one more or fewer order shifts this rate by about ${swing} points.`
+    note: `GA4 purchases against the ${sanityOrders} orders that exist \u2014 the same event on both sides. Small numbers move it a long way: one more or fewer purchase seen by GA4 shifts this rate by about ${swing} points.`
   };
 }
 function fromPageviews(ga4Pageviews, vercelPageviews) {
@@ -1080,6 +1080,13 @@ function fromEmail(ga4Sessions, mailchimpClicks) {
     note: "GA4 sessions from the campaign against Mailchimp\u2019s unique clicks. A cohort whose true size is known exactly."
   };
 }
+function samplingInterval(estimate) {
+  const n = estimate.actual;
+  if (!Number.isFinite(n) || n <= 0) return { low: estimate.rate, high: estimate.rate };
+  const p = Math.min(1, Math.max(0, estimate.rate));
+  const error = 2 * Math.sqrt(Math.max(p * (1 - p), 0.02) / n);
+  return { low: Math.max(0, p - error), high: Math.min(1, p + error) };
+}
 var TRUST = ["orders", "email", "pageviews"];
 function captureModel(candidates) {
   const estimates = candidates.filter((e) => e !== null).sort((a, b) => TRUST.indexOf(a.basis) - TRUST.indexOf(b.basis));
@@ -1088,9 +1095,8 @@ function captureModel(candidates) {
   }
   const rates = estimates.map((e) => e.rate);
   const rate = estimates[0].rate;
-  const low = Math.min(...rates);
-  const high = Math.max(...rates);
-  return { estimates, rate, low, high, discrepancy: describeDisagreement(estimates) };
+  const spread = estimates.length > 1 ? { low: Math.min(...rates), high: Math.max(...rates) } : samplingInterval(estimates[0]);
+  return { estimates, rate, low: spread.low, high: spread.high, discrepancy: describeDisagreement(estimates) };
 }
 function describeDisagreement(estimates) {
   if (estimates.length < 2) return null;
@@ -1147,7 +1153,7 @@ function interpret(ga4Views, vercelViews, shortfall, consent) {
     return `${base} How much of that is consent refusal cannot be measured until the consent_granted event is instrumented, so the difference is currently unexplained rather than attributed.`;
   }
   const consentPercent = Math.round((1 - consent.value / 100) * 100);
-  return `${base} Around ${consentPercent}% of sessions did not grant analytics consent, which accounts for part of it. The remainder is unexplained \u2014 ad-blocking and bot filtering are plausible but are not separately measurable.`;
+  return `${base} Of the visitors GA4 did record, at least ${consentPercent}% declined analytics consent. That is measured inside GA4's own sample, so it does not explain the visitors missing from it \u2014 anyone who refused before being counted is in neither figure. The gap itself stays unexplained; ad-blocking and bot filtering are plausible and are not separately measurable.`;
 }
 function calendarDays(start, end) {
   const first = Date.parse(`${start}T00:00:00Z`);
@@ -1316,9 +1322,18 @@ async function measurementHealth(input) {
       revenue = unavailable("source_error");
     }
   }
-  const shortfallRatio = ga4Pageviews.status !== "unavailable" && vercelPageviews.status !== "unavailable" && vercelPageviews.value > 0 ? (vercelPageviews.value - ga4Pageviews.value) / vercelPageviews.value : null;
   const vercelDates = Object.keys(vercelByDate);
-  const vercelIsDaily = vercelDates.length === 0 || vercelDates.length > daysInRange(range) * 0.7;
+  const vercelIsDaily = vercelDates.length > 0 && vercelDates.length > daysInRange(range) * 0.7;
+  const unsettled = new Set(provisionalDates(range));
+  const settledGa4 = [...ga4ByDate.entries()].filter(([date]) => !unsettled.has(date));
+  const settledVercel = vercelIsDaily ? Object.entries(vercelByDate).filter(([date]) => !unsettled.has(date)) : [];
+  const settledShortfall = (() => {
+    if (settledGa4.length === 0 || settledVercel.length === 0) return null;
+    const ga4Total = settledGa4.reduce((sum, [, value]) => sum + value, 0);
+    const vercelTotal = settledVercel.reduce((sum, [, value]) => sum + (value ?? 0), 0);
+    return vercelTotal > 0 ? (vercelTotal - ga4Total) / vercelTotal : null;
+  })();
+  const shortfallRatio = settledShortfall !== null ? settledShortfall : ga4Pageviews.status !== "unavailable" && vercelPageviews.status !== "unavailable" && vercelPageviews.value > 0 ? (vercelPageviews.value - ga4Pageviews.value) / vercelPageviews.value : null;
   const seriesDates = vercelIsDaily ? Array.from(/* @__PURE__ */ new Set([...ga4ByDate.keys(), ...vercelDates])) : Array.from(ga4ByDate.keys());
   const daily = seriesDates.sort().map((date) => ({
     date,