@liiift-studio/sanity-visitor-insights 0.2.2 → 0.3.1

package/dist/server.mjs

@@ -86,19 +86,41 @@ ${detail}`);
 
 // src/core/cutover.ts
 var PREEXISTING = "preexisting";
+function toHistory(cutover) {
+  if (cutover === null || cutover === void 0) return null;
+  if (typeof cutover === "string") return { from: cutover };
+  if (!cutover.from) return null;
+  return cutover;
+}
+function overlaps(aStart, aEnd, bStart, bEnd) {
+  return aStart <= bEnd && (aEnd === null || aEnd >= bStart);
+}
 function coverageForRange(cutovers, eventName, range) {
   if (!(eventName in cutovers)) return { status: "none", reason: "unknown_event" };
-  const cutover = cutovers[eventName];
-  if (cutover === null || cutover === void 0) return { status: "none", reason: "not_instrumented" };
-  if (cutover === PREEXISTING) return { status: "full" };
-  const cutoverTime = Date.parse(cutover);
-  if (Number.isNaN(cutoverTime)) return { status: "none", reason: "unknown_event" };
-  if (Date.parse(range.end) < cutoverTime) return { status: "none", reason: "before_cutover", cutover };
-  if (Date.parse(range.start) < cutoverTime) return { status: "partial", cutover };
+  const history = toHistory(cutovers[eventName]);
+  if (!history) return { status: "none", reason: "not_instrumented" };
+  let cutover;
+  let startsBeforeCutover = false;
+  if (history.from !== PREEXISTING) {
+    const cutoverTime = Date.parse(history.from);
+    if (Number.isNaN(cutoverTime)) return { status: "none", reason: "unknown_event" };
+    cutover = history.from;
+    if (Date.parse(range.end) < cutoverTime) return { status: "none", reason: "before_cutover", cutover };
+    startsBeforeCutover = Date.parse(range.start) < cutoverTime;
+  }
+  const hit = (history.outages ?? []).filter((o) => overlaps(o.start, o.until, range.start, range.end));
+  const swallowed = hit.find((o) => o.start <= range.start && (o.until === null || o.until > range.end));
+  if (swallowed) return { status: "none", reason: "outage", outages: [swallowed], cutover };
+  if (hit.length > 0) return { status: "partial", reason: "spans_outage", outages: hit, cutover };
+  if (startsBeforeCutover) return { status: "partial", reason: "spans_cutover", outages: [], cutover };
   return { status: "full" };
 }
 function applyCoverage(count, coverage) {
   if (coverage.status === "none") {
+    if (coverage.reason === "outage") {
+      const outage = coverage.outages?.[0];
+      return unavailable("outage", outage ? describeOutage(outage) : void 0);
+    }
     return unavailable(
       coverage.reason === "before_cutover" ? "before_cutover" : "not_instrumented",
       coverage.cutover ? `Instrumented from ${coverage.cutover}` : void 0
@@ -106,16 +128,31 @@ function applyCoverage(count, coverage) {
   }
   if (count === null) return unavailable("source_error");
   if (coverage.status === "partial") {
-    return partial(count, coverage.cutover, `Only counted from ${coverage.cutover}, when this event was added`);
+    if (coverage.reason === "spans_outage") {
+      const outage = coverage.outages[0];
+      const from2 = outage?.until ?? outage?.start ?? coverage.cutover ?? "";
+      return partial(count, from2, `Undercounted: ${describeOutage(outage)}`);
+    }
+    const from = coverage.cutover ?? "";
+    return partial(count, from, `Only counted from ${from}, when this event was added`);
   }
   return { status: "ok", value: count };
 }
+function describeOutage(outage) {
+  if (!outage) return "an outage affected part of this range";
+  const period = outage.until ? `${outage.start} to ${outage.until}` : `${outage.start} onwards`;
+  return outage.reason ? `not recorded ${period} (${outage.reason})` : `not recorded ${period}`;
+}
 function coverageNotices(cutovers, eventNames, range) {
   const notices = [];
   for (const name of eventNames) {
     const coverage = coverageForRange(cutovers, name, range);
-    if (coverage.status === "partial") {
+    if (coverage.status === "partial" && coverage.reason === "spans_outage") {
+      notices.push(`${name} was ${describeOutage(coverage.outages[0])}, so figures for this range are too low \u2014 not a real decline.`);
+    } else if (coverage.status === "partial") {
       notices.push(`${name} was instrumented on ${coverage.cutover}; figures before that date are missing, not zero.`);
+    } else if (coverage.status === "none" && coverage.reason === "outage") {
+      notices.push(`${name} was ${describeOutage(coverage.outages?.[0])}, covering this whole range. The figure is unavailable, not zero.`);
     } else if (coverage.status === "none" && coverage.reason === "not_instrumented") {
       notices.push(`${name} is not instrumented on this site, so it cannot be reported for any range.`);
     } else if (coverage.status === "none" && coverage.reason === "before_cutover") {
@@ -370,6 +407,12 @@ function sumFirstMetric(report) {
 
 // src/server/vercel.ts
 var API_BASE = "https://api.vercel.com/v1/query/web-analytics";
+function granularityFor(start, end) {
+  const days = Math.round((Date.parse(`${end}T00:00:00Z`) - Date.parse(`${start}T00:00:00Z`)) / 864e5) + 1;
+  if (days <= 62) return "day";
+  if (days <= 26 * 7) return "week";
+  return "month";
+}
 function createVercelClient(projectId, token, teamId) {
   async function query(path, extra) {
     const params = new URLSearchParams({ projectId, ...extra });
@@ -392,8 +435,11 @@ function createVercelClient(projectId, token, teamId) {
         query("visits/aggregate", {
           since: start,
           until: end,
-          by: "day",
+          by: granularityFor(start, end),
           limit: "100"
+        }).catch((e) => {
+          console.error("Visitor insights: Vercel series unavailable:", e.message);
+          return { data: [] };
         })
       ]);
       const byDate = {};
@@ -1151,6 +1197,8 @@ export {
   createVercelClient,
   createVisitorInsightsHandler,
   daysBetween,
+  describeOutage,
+  eventNameFilter,
   formatInTimeZone,
   isReportName,
   isValidTimeZone,
@@ -1164,6 +1212,7 @@ export {
   resolveRange,
   runDiagnostics,
   shiftDays,
+  sumFirstMetric,
   unavailable,
   validateSiteConfig,
   valueOrNull,