@liiift-studio/sanity-visitor-insights 0.14.0 → 0.16.0

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import * as sanity from 'sanity';
 import React from 'react';
-import { R as ReportEnvelope, a as ReportName, b as RangeKey, M as MetricValue, A as AcquisitionData, D as DiagnosticReport, J as JourneyData, c as MeasurementHealthData, T as TypefaceInterestData } from './ranges-CEHxJQE6.mjs';
-export { C as CheckStatus, d as Coverage, e as DailyPoint, f as DateRange, g as DiagnosticCheck, E as EventCutover, h as JourneyOutcome, i as JourneyStep, L as LandingPage, P as PREEXISTING, j as REPORT_NAMES, k as ReportError, S as SiteAnalyticsConfig, l as SourceName, m as SourceRow, n as SourceStatus, o as TypefaceInterestRow, U as UnavailableReason, p as coverageForRange, q as isReportName, r as ok, s as partial, t as previousRange, u as resolveRange, v as unavailable, w as validateSiteConfig, x as valueOrNull } from './ranges-CEHxJQE6.mjs';
+import { R as ReportEnvelope, a as ReportName, b as RangeKey, M as MetricValue, A as AcquisitionData, D as DiagnosticReport, J as JourneyData, c as MeasurementHealthData, T as TypefaceInterestData } from './ranges-DvICo5H2.mjs';
+export { C as CaptureBasis, d as CaptureEstimate, e as CaptureModel, f as CheckStatus, g as Coverage, h as DailyPoint, i as DateRange, j as DiagnosticCheck, E as EmailCampaign, k as EventCutover, l as JourneyOutcome, m as JourneyStep, L as LandingPage, P as PREEXISTING, n as REPORT_NAMES, o as ReportError, S as SiteAnalyticsConfig, p as SourceName, q as SourceRow, r as SourceStatus, s as TypefaceInterestRow, U as UnavailableReason, t as coverageForRange, u as estimated, v as isReportName, w as ok, x as partial, y as previousRange, z as resolveRange, B as unavailable, F as validateSiteConfig, G as valueOrNull } from './ranges-DvICo5H2.mjs';
 
 /**
  * The Visitor Insights Studio tool.

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as sanity from 'sanity';
 import React from 'react';
-import { R as ReportEnvelope, a as ReportName, b as RangeKey, M as MetricValue, A as AcquisitionData, D as DiagnosticReport, J as JourneyData, c as MeasurementHealthData, T as TypefaceInterestData } from './ranges-CEHxJQE6.js';
-export { C as CheckStatus, d as Coverage, e as DailyPoint, f as DateRange, g as DiagnosticCheck, E as EventCutover, h as JourneyOutcome, i as JourneyStep, L as LandingPage, P as PREEXISTING, j as REPORT_NAMES, k as ReportError, S as SiteAnalyticsConfig, l as SourceName, m as SourceRow, n as SourceStatus, o as TypefaceInterestRow, U as UnavailableReason, p as coverageForRange, q as isReportName, r as ok, s as partial, t as previousRange, u as resolveRange, v as unavailable, w as validateSiteConfig, x as valueOrNull } from './ranges-CEHxJQE6.js';
+import { R as ReportEnvelope, a as ReportName, b as RangeKey, M as MetricValue, A as AcquisitionData, D as DiagnosticReport, J as JourneyData, c as MeasurementHealthData, T as TypefaceInterestData } from './ranges-DvICo5H2.js';
+export { C as CaptureBasis, d as CaptureEstimate, e as CaptureModel, f as CheckStatus, g as Coverage, h as DailyPoint, i as DateRange, j as DiagnosticCheck, E as EmailCampaign, k as EventCutover, l as JourneyOutcome, m as JourneyStep, L as LandingPage, P as PREEXISTING, n as REPORT_NAMES, o as ReportError, S as SiteAnalyticsConfig, p as SourceName, q as SourceRow, r as SourceStatus, s as TypefaceInterestRow, U as UnavailableReason, t as coverageForRange, u as estimated, v as isReportName, w as ok, x as partial, y as previousRange, z as resolveRange, B as unavailable, F as validateSiteConfig, G as valueOrNull } from './ranges-DvICo5H2.js';
 
 /**
  * The Visitor Insights Studio tool.

package/dist/index.js

@@ -47,6 +47,7 @@ __export(index_exports, {
   VisitorInsightsTool: () => VisitorInsightsTool,
   coverageForRange: () => coverageForRange,
   default: () => index_default,
+  estimated: () => estimated,
   formatCount: () => formatCount,
   formatMoney: () => formatMoney,
   formatPercent: () => formatPercent,
@@ -213,6 +214,21 @@ function MetricFigure({ metric, label, size = 4, unit = "count" }) {
       /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_sanity_ui_compat.Badge, { tone: "caution", fontSize: 0, children: "Partial" })
     ] });
   }
+  if (metric.status === "estimated") {
+    const range = unit === "percent" ? `${metric.low.toFixed(1)}% to ${metric.high.toFixed(1)}%` : `${formatCount(metric.low)} to ${formatCount(metric.high)}`;
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_sanity_ui_compat.Stack, { space: 2, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_sanity_ui_compat.Text, { size, "aria-label": `${label}: estimated ${formatted}, between ${range}. ${metric.basis}`, children: [
+        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { "aria-hidden": "true", children: "~" }),
+        formatted
+      ] }),
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_sanity_ui_compat.Text, { size: 0, muted: true, children: range }),
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_sanity_ui_compat.Badge, { tone: "primary", fontSize: 0, children: "Estimated" })
+    ] });
+  }
+  if (metric.status !== "ok") {
+    const unhandled = metric;
+    void unhandled;
+  }
   return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_sanity_ui_compat.Text, { size, "aria-label": `${label}: ${formatted}`, children: formatted });
 }
 function ComparisonBar({ label, metric, max, tone = "default" }) {
@@ -889,12 +905,71 @@ function MeasurementHealthPanel({ data, previous }) {
       data.shortfallRatio !== null && /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_sanity_ui_compat2.Text, { size: 1, weight: "semibold", children: data.shortfallRatio >= 0 ? `GA4 saw ${formatPercent(data.shortfallRatio, 1)} fewer pageviews than Vercel` : `GA4 saw ${formatPercent(-data.shortfallRatio, 1)} more pageviews than Vercel` }),
       /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_sanity_ui_compat2.Text, { size: 1, muted: true, children: data.interpretation })
     ] }) }),
+    ((data.capture?.estimates?.length ?? 0) > 0 || data.estimatedSessions?.status === "estimated") && /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(import_sanity_ui_compat2.Stack, { space: 3, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_sanity_ui_compat2.Heading, { size: 1, style: sectionHeading, children: "How much GA4 is seeing" }),
+      /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { style: cardGrid, children: (data.capture?.estimates ?? []).map((estimate) => /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_sanity_ui_compat2.Card, { padding: 3, radius: 2, tone: "transparent", border: true, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(import_sanity_ui_compat2.Stack, { space: 3, children: [
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_sanity_ui_compat2.Label, { size: 1, muted: true, children: estimate.basis === "orders" ? "Measured against orders" : estimate.basis === "email" ? "Measured against email clicks" : "Measured against Vercel" }),
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_sanity_ui_compat2.Text, { size: 4, children: formatPercent(Math.min(1, estimate.rate), 0) }),
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(import_sanity_ui_compat2.Text, { size: 0, muted: true, children: [
+          formatCount(estimate.observed),
+          " of ",
+          formatCount(estimate.actual),
+          ". ",
+          estimate.note
+        ] })
+      ] }) }, estimate.basis)) }),
+      data.capture?.discrepancy && /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_sanity_ui_compat2.Card, { padding: 3, radius: 2, tone: "caution", border: true, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(import_sanity_ui_compat2.Stack, { space: 2, children: [
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_sanity_ui_compat2.Text, { size: 1, weight: "medium", children: "The sources disagree, and that is informative" }),
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_sanity_ui_compat2.Text, { size: 1, children: data.capture.discrepancy })
+      ] }) }),
+      data.estimatedSessions && data.estimatedSessions.status === "estimated" && /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_sanity_ui_compat2.Card, { padding: 3, radius: 2, tone: "transparent", border: true, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(import_sanity_ui_compat2.Stack, { space: 3, children: [
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_sanity_ui_compat2.Label, { size: 1, muted: true, children: "Sessions, corrected for what GA4 misses" }),
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(MetricFigure, { metric: data.estimatedSessions, label: "Estimated sessions" })
+      ] }) })
+    ] }),
     (data.daily?.length ?? 0) >= 3 && /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(import_sanity_ui_compat2.Stack, { space: 3, children: [
       /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_sanity_ui_compat2.Heading, { size: 1, style: sectionHeading, children: "Day by day" }),
       /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_sanity_ui_compat2.Text, { size: 1, muted: true, children: "A gap that has always been there is consent and blocking. A gap that opens on one day is an incident." }),
       /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(TrendChart, { points: data.daily ?? [] }),
       data.vercelDailyUnavailable && /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_sanity_ui_compat2.Text, { size: 0, muted: true, children: "Vercel reports this range in weekly buckets, so only the GA4 line is plotted. Choose Week or Month to see both." })
     ] }),
+    (data.campaigns?.length ?? 0) > 0 && /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(import_sanity_ui_compat2.Stack, { space: 3, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_sanity_ui_compat2.Heading, { size: 1, style: sectionHeading, children: "Email campaigns" }),
+      /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_sanity_ui_compat2.Text, { size: 1, muted: true, children: "Clicks are distinct subscribers. Opens are inflated by Apple Mail Privacy Protection, which fetches images on the recipient\u2019s behalf \u2014 so sort on clicks, not opens." }),
+      /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+        SortableTable,
+        {
+          caption: "Email campaigns by clicks",
+          initialSort: "clicks",
+          rows: data.campaigns ?? [],
+          rowKey: (c) => `${c.sentAt}-${c.title}`,
+          filterOn: (c) => `${c.title} ${c.subject}`,
+          filterPlaceholder: "Filter campaigns",
+          exportName: "email-campaigns",
+          columns: [
+            {
+              key: "title",
+              label: "Campaign",
+              sortValue: (c) => c.title,
+              render: (c) => /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(import_sanity_ui_compat2.Stack, { space: 1, children: [
+                /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_sanity_ui_compat2.Text, { size: 1, children: c.title }),
+                /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_sanity_ui_compat2.Text, { size: 0, muted: true, children: c.sentAt.slice(0, 10) })
+              ] })
+            },
+            { key: "sent", label: "Sent", numeric: true, sortValue: (c) => c.sent, render: (c) => /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_sanity_ui_compat2.Text, { size: 1, children: formatCount(c.sent) }) },
+            { key: "opens", label: "Opens", numeric: true, sortValue: (c) => c.opens, render: (c) => /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_sanity_ui_compat2.Text, { size: 1, muted: true, children: formatCount(c.opens) }) },
+            { key: "clicks", label: "Clicks", numeric: true, sortValue: (c) => c.clicks, render: (c) => /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_sanity_ui_compat2.Text, { size: 1, children: formatCount(c.clicks) }) },
+            {
+              key: "unsub",
+              label: "Unsubscribed",
+              numeric: true,
+              sortValue: (c) => c.unsubscribed,
+              render: (c) => /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_sanity_ui_compat2.Text, { size: 1, muted: true, children: formatCount(c.unsubscribed) })
+            }
+          ]
+        }
+      )
+    ] }),
     Object.keys(data.orderStatuses ?? {}).length > 0 && /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(import_sanity_ui_compat2.Stack, { space: 3, children: [
       /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_sanity_ui_compat2.Heading, { size: 1, style: sectionHeading, children: "Order statuses in this range" }),
       /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_sanity_ui_compat2.Text, { size: 1, muted: true, children: "What the orders actually say, before any filtering. Use these values to set which statuses count as a sale." }),
@@ -907,6 +982,20 @@ function MeasurementHealthPanel({ data, previous }) {
       /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_sanity_ui_compat2.Heading, { size: 1, style: sectionHeading, children: "Context" }),
       /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_sanity_ui_compat2.Text, { size: 1, muted: true, children: "Different units to the figures above, and to each other. Shown for scale, never differenced." }),
       /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { style: cardGrid, children: [
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_sanity_ui_compat2.Card, { padding: 3, radius: 2, tone: "transparent", border: true, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(import_sanity_ui_compat2.Stack, { space: 3, children: [
+          /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_sanity_ui_compat2.Label, { size: 1, muted: true, children: "Mailing list" }),
+          /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { style: figureRow, children: [
+            /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(MetricFigure, { metric: metricOr(data.audience, OLDER_ROUTE), label: "Mailing list members" }),
+            /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+              Delta,
+              {
+                current: metricSortValue(data.audience),
+                previous: metricSortValue(previous?.audience)
+              }
+            )
+          ] }),
+          /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_sanity_ui_compat2.Text, { size: 0, muted: true, children: "Mailchimp\u2019s own count. Not consent-gated or blockable, so it replaces the site\u2019s subscribe event rather than sitting beside it." })
+        ] }) }),
         /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_sanity_ui_compat2.Card, { padding: 3, radius: 2, tone: "transparent", border: true, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(import_sanity_ui_compat2.Stack, { space: 3, children: [
           /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_sanity_ui_compat2.Label, { size: 1, muted: true, children: "Revenue" }),
           /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { style: figureRow, children: [
@@ -1448,7 +1537,8 @@ function RangeSelector({
 var SOURCE_LABEL = {
   ga4: "Google Analytics",
   vercel: "Vercel",
-  sanity: "Orders"
+  sanity: "Orders",
+  mailchimp: "Mailchimp"
 };
 function SourceStatusRow({ sources }) {
   const degraded = Object.entries(sources).filter(([, s]) => s.status !== "ok");
@@ -1598,6 +1688,9 @@ function VisitorInsightsTool(props) {
 }
 
 // src/types.ts
+function estimated(value, low, high, basis) {
+  return { status: "estimated", value, low, high, basis };
+}
 function ok(value) {
   return { status: "ok", value };
 }
@@ -1686,6 +1779,9 @@ function validateSiteConfig(config) {
     ["orders.totalField", config.orders?.totalField],
     ["orders.typefacesField", config.orders?.typefacesField]
   ];
+  for (const name of Object.keys(config.orders?.licenceFields ?? {})) {
+    fieldSlots.push([`orders.licenceFields.${name}`, name]);
+  }
   for (const [field, value] of fieldSlots) {
     if (!value) continue;
     if (!FIELD_PATH.test(value)) {
@@ -1840,6 +1936,7 @@ var index_default = visitorInsights;
   TypefaceInterestPanel,
   VisitorInsightsTool,
   coverageForRange,
+  estimated,
   formatCount,
   formatMoney,
   formatPercent,