@iann29/rastro 0.1.0-alpha.9 → 0.1.0

package/dist/component/reports.d.ts

@@ -21,6 +21,9 @@ export declare const overview: import("convex/server").RegisteredQuery<"public",
         visitors: number;
         conversions: number;
         revenueCents: number;
+        durationMs: number;
+        continuedSessions: number;
+        newVisitors: number;
     }[];
     topSources: {
         value: string;
@@ -62,6 +65,16 @@ export declare const overview: import("convex/server").RegisteredQuery<"public",
         count: number;
         revenueCents: number;
     }[];
+    topMediums: {
+        value: string;
+        count: number;
+        revenueCents: number;
+    }[];
+    topOutbound: {
+        value: string;
+        count: number;
+        revenueCents: number;
+    }[];
     metadata: {
         visitors: {
             basis: "bucketOccurrences" | "estimatedUnique";
@@ -71,15 +84,19 @@ export declare const overview: import("convex/server").RegisteredQuery<"public",
             precision: number | null;
         };
         breakdowns: {
-            topSources: "eventVolume";
-            topCampaigns: "eventVolume";
-            topPages: "eventVolume";
-            topCountries: "eventVolume";
-            topDevices: "eventVolume";
-            topBrowsers: "eventVolume";
+            topSources: "eventVolume" | "sessions";
+            topCampaigns: "eventVolume" | "sessions";
+            topPages: "eventVolume" | "pageviews";
+            topCountries: "eventVolume" | "sessions";
+            topDevices: "eventVolume" | "sessions";
+            topBrowsers: "eventVolume" | "sessions";
             topEvents: "eventVolume";
             topGoals: "goalCompletionVolume";
+            topMediums: "eventVolume" | "sessions";
+            topOutbound: "eventVolume";
         };
+        dimensionsSince: number | null;
+        engagement: "counted" | "unavailable";
         coverage: {
             state: "complete" | "partial" | "retained" | "unavailable";
             generation: 1 | null;
@@ -91,7 +108,7 @@ export declare const overview: import("convex/server").RegisteredQuery<"public",
             from: number;
             to: number;
             boundary: "inclusive";
-            timezone: "UTC";
+            timezone: string;
         };
         features: {
             sessionReplay: "unsupported";
@@ -127,6 +144,16 @@ export declare const liveVisitors: import("convex/server").RegisteredQuery<"publ
     eventCount: number;
     previousPath?: string | undefined;
     movedAt?: number | undefined;
+    entryPath?: string | undefined;
+    returning?: boolean | undefined;
+    utmCampaign?: string | undefined;
+    affiliateSlug?: string | undefined;
+    conversionCount?: number | undefined;
+    funnel?: {
+        funnelId: import("convex/values").GenericId<"funnels">;
+        step: number;
+        steps: number;
+    } | undefined;
 }[]>>;
 /**
  * Every route the sites served in the range and the transitions between
@@ -187,7 +214,7 @@ export declare const siteMap: import("convex/server").RegisteredQuery<"public",
             from: number;
             to: number;
             boundary: "inclusive";
-            timezone: "UTC";
+            timezone: string;
         };
         visitors: {
             basis: "estimatedUnique";
@@ -233,6 +260,7 @@ export declare const listSessions: import("convex/server").RegisteredQuery<"publ
         lastSeenAt: number;
         latitude?: number | undefined;
         longitude?: number | undefined;
+        newVisitor?: boolean | undefined;
         os: string;
         pageviewCount: number;
         referrer?: string | undefined;
@@ -399,7 +427,7 @@ export declare const goalsReport: import("convex/server").RegisteredQuery<"publi
             from: number;
             to: number;
             boundary: "inclusive";
-            timezone: "UTC";
+            timezone: string;
         };
     };
 }>>;
@@ -430,7 +458,7 @@ export declare const funnelsReport: import("convex/server").RegisteredQuery<"pub
             from: number;
             to: number;
             boundary: "inclusive";
-            timezone: "UTC";
+            timezone: string;
         };
     };
     active: boolean;
@@ -482,7 +510,7 @@ export declare const affiliatesReport: import("convex/server").RegisteredQuery<"
             from: number;
             to: number;
             boundary: "inclusive";
-            timezone: "UTC";
+            timezone: string;
         };
         uniqueVisitors: {
             basis: "estimatedUnique" | "exactLegacy";
@@ -541,7 +569,7 @@ export declare const vitalsReport: import("convex/server").RegisteredQuery<"publ
             from: number;
             to: number;
             boundary: "inclusive";
-            timezone: "UTC";
+            timezone: string;
         };
     };
 }>>;
@@ -554,7 +582,7 @@ export declare const dataCoverage: import("convex/server").RegisteredQuery<"publ
     from: number;
     to: number;
     datasets: {
-        dataset: "affiliates" | "conversions" | "events" | "funnels" | "goals" | "overviewDay" | "overviewHour" | "sessions" | "siteMap" | "vitals";
+        dataset: "affiliates" | "conversions" | "events" | "funnels" | "goals" | "overviewDay" | "overviewHour" | "overviewLocalDay" | "sessions" | "siteMap" | "vitals";
         coverage: {
             state: "complete" | "partial" | "retained" | "unavailable";
             generation: 1 | null;
@@ -574,6 +602,9 @@ type MetricTotals = {
     visitors: number;
     conversions: number;
     revenueCents: number;
+    durationMs: number;
+    continuedSessions: number;
+    newVisitors: number;
 };
 export {};
 //# sourceMappingURL=reports.d.ts.map

package/dist/component/reports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reports.d.ts","sourceRoot":"","sources":["../../src/component/reports.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"reports.d.ts","sourceRoot":"","sources":["../../src/component/reports.ts"],"names":[],"mappings":"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"}

package/dist/component/reports.js

@@ -4,6 +4,7 @@ import { query } from "./_generated/server.js";
 import { AGGREGATE_SHARDS, DAY_MS, FEATURE_REPORT_BYTE_RESERVE, FEATURE_REPORT_DOCUMENT_RESERVE, HOUR_MS, HOURLY_AGGREGATE_SHARDS, MAX_AFFILIATES_PER_SITE, MAX_FUNNELS_PER_SITE, MAX_FEATURE_ROLLUP_DAYS, MAX_FEATURE_ROLLUP_ROWS, MAX_GOALS_PER_SITE, MAX_JOURNEY_EVENTS, MAX_LIVE_VISITORS, MAX_OVERVIEW_AGGREGATE_ROWS, MAX_REPORT_BUCKETS, MAX_REPORT_RANGE_DAYS, MAX_REPORT_SITES, MAX_SITE_MAP_ROUTES_PER_DAY, MAX_SITE_MAP_ROWS, MAX_VITALS_REPORT_ROWS, REPORT_ROLLUP_SHARDS, ROUTE_TRANSITION_SLOTS, SITE_MAP_OTHER_ROUTE, VITALS_REPORT_PAGE_LIMIT, } from "./constants.js";
 import { createVisitorSketch, estimateVisitors, unionVisitorSketches, } from "./cardinality.js";
 import { fail } from "./errors.js";
+import { isLocalDayAligned, localDayStart, localDayStarts, localDayTimezone, sharedLocalTimezone, } from "./localTime.js";
 import { compareJourneyEvents, hydrateEventContexts, loadSessionJourneyEvents, loadVisitorJourneyEvents, } from "./eventStore.js";
 import { isPlainRecord } from "./guards.js";
 import { affiliateFieldsValidator, eventFieldsValidator, funnelFieldsValidator, goalFieldsValidator, sessionFieldsValidator, vitalMetricValidator, } from "./validators.js";
@@ -39,6 +40,16 @@ const liveSessionDocumentValidator = v.object({
     eventCount: v.number(),
     previousPath: v.optional(v.string()),
     movedAt: v.optional(v.number()),
+    entryPath: v.optional(v.string()),
+    returning: v.optional(v.boolean()),
+    utmCampaign: v.optional(v.string()),
+    affiliateSlug: v.optional(v.string()),
+    conversionCount: v.optional(v.number()),
+    funnel: v.optional(v.object({
+        funnelId: v.id("funnels"),
+        step: v.number(),
+        steps: v.number(),
+    })),
 });
 const conversionDocumentValidator = v.object({
     _id: v.id("conversions"),
@@ -69,6 +80,12 @@ const metricTotalsValidator = v.object({
     visitors: v.number(),
     conversions: v.number(),
     revenueCents: v.number(),
+    // Engagement: summed session duration, sessions that reached a second
+    // pageview, and first-ever sessions of a visitor. Zero for buckets older
+    // than the counters; metadata.engagement says whether the range is covered.
+    durationMs: v.number(),
+    continuedSessions: v.number(),
+    newVisitors: v.number(),
 });
 const timePointValidator = metricTotalsValidator.extend({
     timestamp: v.number(),
@@ -78,6 +95,10 @@ const topItemValidator = v.object({
     count: v.number(),
     revenueCents: v.number(),
 });
+// What a breakdown's `count` is: pageviews for pages and sessions for the
+// other dimensions once every bucket in the range carries those counters,
+// raw event volume for ranges that reach back before they existed.
+const breakdownBasisValidator = v.union(v.literal("pageviews"), v.literal("sessions"), v.literal("eventVolume"));
 const coverageStateValidator = v.union(v.literal("complete"), v.literal("partial"), v.literal("retained"), v.literal("unavailable"));
 const resultCoverageValidator = v.object({
     state: coverageStateValidator,
@@ -90,7 +111,8 @@ const rangeSemanticsValidator = v.object({
     from: v.number(),
     to: v.number(),
     boundary: v.literal("inclusive"),
-    timezone: v.literal("UTC"),
+    // "UTC", or the site timezone whose calendar days a daily overview used.
+    timezone: v.string(),
 });
 const reportMetadataValidator = v.object({
     basis: v.union(v.literal("dailyRollup"), v.literal("boundedLegacy")),
@@ -119,6 +141,10 @@ export const overview = query({
         topBrowsers: v.array(topItemValidator),
         topEvents: v.array(topItemValidator),
         topGoals: v.array(topItemValidator),
+        // The session's lowercase utm_medium, ranked like campaigns.
+        topMediums: v.array(topItemValidator),
+        // Destination hosts of outbound clicks, ranked by clicks.
+        topOutbound: v.array(topItemValidator),
         metadata: v.object({
             visitors: v.object({
                 basis: v.union(v.literal("estimatedUnique"), v.literal("bucketOccurrences")),
@@ -128,15 +154,25 @@ export const overview = query({
                 precision: v.union(v.number(), v.null()),
             }),
             breakdowns: v.object({
-                topSources: v.literal("eventVolume"),
-                topCampaigns: v.literal("eventVolume"),
-                topPages: v.literal("eventVolume"),
-                topCountries: v.literal("eventVolume"),
-                topDevices: v.literal("eventVolume"),
-                topBrowsers: v.literal("eventVolume"),
+                topSources: breakdownBasisValidator,
+                topCampaigns: breakdownBasisValidator,
+                topPages: breakdownBasisValidator,
+                topCountries: breakdownBasisValidator,
+                topDevices: breakdownBasisValidator,
+                topBrowsers: breakdownBasisValidator,
                 topEvents: v.literal("eventVolume"),
                 topGoals: v.literal("goalCompletionVolume"),
+                topMediums: breakdownBasisValidator,
+                topOutbound: v.literal("eventVolume"),
             }),
+            // Since when every site in the request records the medium and outbound
+            // slots; null while one of them has not stamped it. A range that starts
+            // earlier ranks those two breakdowns from partial data.
+            dimensionsSince: v.union(v.number(), v.null()),
+            // "counted" when every bucket in the range carries the engagement
+            // counters, so bounce rate, duration, pages per session and new
+            // visitors can be derived from the totals; "unavailable" otherwise.
+            engagement: v.union(v.literal("counted"), v.literal("unavailable")),
             coverage: resultCoverageValidator,
             range: rangeSemanticsValidator,
             features: v.object({
@@ -150,11 +186,13 @@ export const overview = query({
     handler: async (ctx, args) => {
         const siteIds = validateSiteIds(args.siteIds);
         const currencies = new Set();
+        const siteTimezones = [];
         for (const siteId of siteIds) {
             const site = await ctx.db.get("sites", siteId);
             if (!site)
                 fail("NOT_FOUND", "site not found", { siteId: String(siteId) });
             currencies.add(site.currency ?? "USD");
+            siteTimezones.push(localDayTimezone(site.timezone));
         }
         if (currencies.size !== 1) {
             fail("CURRENCY_MISMATCH", "overview sites must use the same currency", {
@@ -168,10 +206,47 @@ export const overview = query({
             fail("INVALID_ARGUMENT", "hourly reports are limited to 24 hours");
         }
         const intervalMs = interval === "hour" ? HOUR_MS : DAY_MS;
-        requireAlignedRange(from, to, intervalMs, `${interval} overview`);
-        const firstBucket = Math.floor(from / intervalMs) * intervalMs;
-        const lastBucket = Math.floor(to / intervalMs) * intervalMs;
-        const bucketCount = Math.floor((lastBucket - firstBucket) / intervalMs) + 1;
+        // Sites that share a timezone answer a daily range that covers whole
+        // calendar days in that zone from their local-day buckets; any other
+        // daily range must cover whole UTC days, as before.
+        const siteTimezone = interval === "day" ? sharedLocalTimezone(siteTimezones) : undefined;
+        const localDays = siteTimezone !== undefined && isLocalDayAligned(from, to, siteTimezone);
+        if (!localDays) {
+            requireAlignedRange(from, to, intervalMs, `${interval} overview`, siteTimezone);
+        }
+        const granularity = localDays
+            ? "localDay"
+            : interval;
+        const controls = await Promise.all(siteIds.map((siteId) => ctx.db
+            .query("analyticsCoverage")
+            .withIndex("by_siteId", (range) => range.eq("siteId", siteId))
+            .unique()));
+        // Local-day buckets are complete from each site's stamp (its first ingest
+        // after the upgrade or after a timezone change, plus the safety delay).
+        // Buckets before it belong to another zone's days or to no complete day
+        // and are left out; the coverage says since when the days are whole.
+        let localDaysFrom = Number.POSITIVE_INFINITY;
+        if (localDays) {
+            localDaysFrom = controls.reduce((latest, control) => control?.localDaySince === undefined
+                ? Number.POSITIVE_INFINITY
+                : Math.max(latest, control.localDaySince), 0);
+        }
+        const bucketStarts = localDays
+            ? localDayStarts(from, to, siteTimezone)
+            : [];
+        const bucketStartSet = new Set(bucketStarts);
+        const localDaysFirstBucket = localDays && Number.isFinite(localDaysFrom)
+            ? localDayStart(localDaysFrom, siteTimezone)
+            : Number.POSITIVE_INFINITY;
+        const firstBucket = localDays
+            ? bucketStarts[0]
+            : Math.floor(from / intervalMs) * intervalMs;
+        const lastBucket = localDays
+            ? bucketStarts[bucketStarts.length - 1]
+            : Math.floor(to / intervalMs) * intervalMs;
+        const bucketCount = localDays
+            ? bucketStarts.length
+            : Math.floor((lastBucket - firstBucket) / intervalMs) + 1;
         const perSiteLimit = bucketCount *
             (interval === "hour" ? HOURLY_AGGREGATE_SHARDS : AGGREGATE_SHARDS);
         if (perSiteLimit * siteIds.length > MAX_OVERVIEW_AGGREGATE_ROWS) {
@@ -184,21 +259,28 @@ export const overview = query({
         const pointVisitorSketches = new Map();
         let visitorsComplete = true;
         const dimensions = new Map();
-        const overviewDataset = interval === "hour"
+        const overviewDataset = granularity === "hour"
             ? "overviewHour"
-            : "overviewDay";
+            : granularity === "day"
+                ? "overviewDay"
+                : "overviewLocalDay";
         await assertSourceAvailable(ctx, siteIds, [overviewDataset], from);
         for (const siteId of siteIds) {
             const buckets = await ctx.db
                 .query("aggregateBuckets")
                 .withIndex("by_siteId_and_granularity_and_bucketStart", (range) => range
                 .eq("siteId", siteId)
-                .eq("granularity", interval)
+                .eq("granularity", granularity)
                 .gte("bucketStart", firstBucket)
                 .lte("bucketStart", lastBucket))
                 .take(perSiteLimit + 1);
             failIfIncomplete(buckets, perSiteLimit, "overview aggregate buckets");
             for (const bucket of buckets) {
+                if (localDays &&
+                    (!bucketStartSet.has(bucket.bucketStart) ||
+                        bucket.bucketStart < localDaysFirstBucket)) {
+                    continue;
+                }
                 addMetrics(totals, bucket);
                 const point = points.get(bucket.bucketStart) ?? emptyTotals();
                 addMetrics(point, bucket);
@@ -217,16 +299,39 @@ export const overview = query({
                         value: dimension.value,
                         count: 0,
                         revenueCents: 0,
+                        pageviews: 0,
+                        sessions: 0,
                     };
                     current.count += dimension.count;
                     current.revenueCents += dimension.revenueCents;
+                    current.pageviews += dimension.pageviews ?? 0;
+                    current.sessions += dimension.sessions ?? 0;
                     dimensions.set(key, current);
                 }
             }
         }
-        const top = (type) => [...dimensions.entries()]
+        // Pages rank by pageviews and the other dimensions by sessions once every
+        // site's counters are proven for the whole range; before that stamp a
+        // bucket may hold slots without them, so the ranking stays event volume.
+        const countersProven = controls.every((control) => control?.countersSince !== undefined && from >= control.countersSince);
+        const pageBasis = countersProven
+            ? "pageviews"
+            : "eventVolume";
+        const sessionBasis = countersProven
+            ? "sessions"
+            : "eventVolume";
+        const top = (type, basis) => [...dimensions.entries()]
             .filter(([key]) => key.startsWith(`${type}:`))
-            .map(([, value]) => value)
+            .map(([, item]) => ({
+            value: item.value,
+            count: basis === "pageviews"
+                ? item.pageviews
+                : basis === "sessions"
+                    ? item.sessions
+                    : item.count,
+            revenueCents: item.revenueCents,
+        }))
+            .filter((item) => item.count > 0 || item.revenueCents > 0)
             .sort((left, right) => right.count - left.count || left.value.localeCompare(right.value))
             .slice(0, 10);
         if (visitorsComplete) {
@@ -239,6 +344,17 @@ export const overview = query({
             datasets: [overviewDataset],
             complete: visitorsComplete,
         });
+        if (localDays) {
+            // The stamp, not the oldest row, says where the site's days begin.
+            const availableFrom = Number.isFinite(localDaysFrom)
+                ? Math.max(coverage.availableFrom ?? 0, localDaysFrom)
+                : null;
+            coverage.availableFrom = availableFrom;
+            if (coverage.state === "complete" &&
+                (availableFrom === null || from < availableFrom)) {
+                coverage.state = availableFrom === null ? "unavailable" : "partial";
+            }
+        }
         const visitorBasis = visitorsComplete ? "estimatedUnique" : "bucketOccurrences";
         return {
             from,
@@ -249,14 +365,16 @@ export const overview = query({
             timeSeries: [...points.entries()]
                 .sort(([left], [right]) => left - right)
                 .map(([timestamp, metrics]) => ({ timestamp, ...metrics })),
-            topSources: top("source"),
-            topCampaigns: top("campaign"),
-            topPages: top("page"),
-            topCountries: top("country"),
-            topDevices: top("device"),
-            topBrowsers: top("browser"),
-            topEvents: top("event"),
-            topGoals: top("goal"),
+            topSources: top("source", sessionBasis),
+            topCampaigns: top("campaign", sessionBasis),
+            topPages: top("page", pageBasis),
+            topCountries: top("country", sessionBasis),
+            topDevices: top("device", sessionBasis),
+            topBrowsers: top("browser", sessionBasis),
+            topEvents: top("event", "eventVolume"),
+            topGoals: top("goal", "eventVolume"),
+            topMediums: top("medium", sessionBasis),
+            topOutbound: top("outbound", "eventVolume"),
             metadata: {
                 visitors: {
                     basis: visitorBasis,
@@ -266,17 +384,25 @@ export const overview = query({
                     precision: visitorsComplete ? 6 : null,
                 },
                 breakdowns: {
-                    topSources: "eventVolume",
-                    topCampaigns: "eventVolume",
-                    topPages: "eventVolume",
-                    topCountries: "eventVolume",
-                    topDevices: "eventVolume",
-                    topBrowsers: "eventVolume",
+                    topSources: sessionBasis,
+                    topCampaigns: sessionBasis,
+                    topPages: pageBasis,
+                    topCountries: sessionBasis,
+                    topDevices: sessionBasis,
+                    topBrowsers: sessionBasis,
                     topEvents: "eventVolume",
                     topGoals: "goalCompletionVolume",
+                    topMediums: sessionBasis,
+                    topOutbound: "eventVolume",
                 },
+                dimensionsSince: controls.every((control) => control?.dimensionsSince !== undefined)
+                    ? Math.max(...controls.map((control) => control.dimensionsSince))
+                    : null,
+                engagement: countersProven
+                    ? "counted"
+                    : "unavailable",
                 coverage,
-                range: rangeSemantics(from, to),
+                range: rangeSemantics(from, to, localDays ? siteTimezone : "UTC"),
                 features: {
                     sessionReplay: "unsupported",
                     errorInsights: "unsupported",
@@ -338,6 +464,14 @@ export const liveVisitors = query({
             eventCount: row.eventCount,
             ...(row.previousPath ? { previousPath: row.previousPath } : {}),
             ...(row.movedAt !== undefined ? { movedAt: row.movedAt } : {}),
+            ...(row.entryPath ? { entryPath: row.entryPath } : {}),
+            ...(row.returning !== undefined ? { returning: row.returning } : {}),
+            ...(row.utmCampaign ? { utmCampaign: row.utmCampaign } : {}),
+            ...(row.affiliateSlug ? { affiliateSlug: row.affiliateSlug } : {}),
+            ...(row.conversionCount !== undefined
+                ? { conversionCount: row.conversionCount }
+                : {}),
+            ...(row.funnel ? { funnel: row.funnel } : {}),
         }));
     },
 });
@@ -1157,7 +1291,7 @@ export const vitalsReport = query({
         };
     },
 });
-const coverageDatasetValidator = v.union(v.literal("overviewHour"), v.literal("overviewDay"), v.literal("events"), v.literal("sessions"), v.literal("conversions"), v.literal("goals"), v.literal("funnels"), v.literal("affiliates"), v.literal("vitals"), v.literal("siteMap"));
+const coverageDatasetValidator = v.union(v.literal("overviewHour"), v.literal("overviewDay"), v.literal("overviewLocalDay"), v.literal("events"), v.literal("sessions"), v.literal("conversions"), v.literal("goals"), v.literal("funnels"), v.literal("affiliates"), v.literal("vitals"), v.literal("siteMap"));
 export const dataCoverage = query({
     args: {
         siteId: v.id("sites"),
@@ -1178,6 +1312,7 @@ export const dataCoverage = query({
         const datasets = [
             "overviewHour",
             "overviewDay",
+            "overviewLocalDay",
             "events",
             "sessions",
             "conversions",
@@ -1448,8 +1583,14 @@ async function sourceSetRange(ctx, siteId, sources) {
     };
 }
 async function sourceRange(ctx, siteId, source) {
-    if (source === "overviewHour" || source === "overviewDay") {
-        const granularity = source === "overviewHour" ? "hour" : "day";
+    if (source === "overviewHour" ||
+        source === "overviewDay" ||
+        source === "overviewLocalDay") {
+        const granularity = source === "overviewHour"
+            ? "hour"
+            : source === "overviewDay"
+                ? "day"
+                : "localDay";
         const [first, last] = await Promise.all([
             ctx.db
                 .query("aggregateBuckets")
@@ -1572,6 +1713,9 @@ function emptyTotals() {
         visitors: 0,
         conversions: 0,
         revenueCents: 0,
+        durationMs: 0,
+        continuedSessions: 0,
+        newVisitors: 0,
     };
 }
 function addMetrics(target, source) {
@@ -1584,6 +1728,9 @@ function addMetrics(target, source) {
     target.visitors += source.visitors;
     target.conversions += source.conversions;
     target.revenueCents += source.revenueCents;
+    target.durationMs += source.durationMs ?? 0;
+    target.continuedSessions += source.continuedSessions ?? 0;
+    target.newVisitors += source.newVisitors ?? 0;
 }
 function validateSiteIds(siteIds) {
     const unique = [...new Set(siteIds)];
@@ -1607,17 +1754,25 @@ function validateRange(from, to, maxDays) {
 function isAlignedRange(from, to, intervalMs) {
     return from % intervalMs === 0 && (to + 1) % intervalMs === 0;
 }
-function requireAlignedRange(from, to, intervalMs, report) {
+function requireAlignedRange(from, to, intervalMs, report, siteTimezone) {
     if (!isAlignedRange(from, to, intervalMs)) {
-        fail("REPORT_INCOMPLETE", `${report} requires complete inclusive UTC bucket boundaries`, { from, to, intervalMs, timezone: "UTC" });
+        fail("REPORT_INCOMPLETE", siteTimezone
+            ? `${report} requires complete inclusive UTC bucket boundaries, or whole calendar days in ${siteTimezone}`
+            : `${report} requires complete inclusive UTC bucket boundaries`, {
+            from,
+            to,
+            intervalMs,
+            timezone: "UTC",
+            siteTimezone: siteTimezone ?? null,
+        });
     }
 }
-function rangeSemantics(from, to) {
+function rangeSemantics(from, to, timezone = "UTC") {
     return {
         from,
         to,
         boundary: "inclusive",
-        timezone: "UTC",
+        timezone,
     };
 }
 function parseKeysetPagination(options, scope) {