@hot-updater/server 0.36.7 → 1.0.0-rc.1

package/dist/insights/bounded/persistence.mjs

@@ -0,0 +1,38 @@
+import { createUUIDv7 } from "@hot-updater/plugin-core";
+//#region src/insights/bounded/persistence.ts
+function createBundleEventRow(input) {
+	const base = {
+		id: createUUIDv7(),
+		install_id: input.installId,
+		user_id: input.userId ?? null,
+		username: input.username ?? null,
+		from_release_id: input.fromReleaseId,
+		to_release_id: input.toReleaseId,
+		to_bundle_id: input.toBundleId,
+		platform: input.platform,
+		app_version: input.appVersion,
+		channel: input.channel,
+		cohort: input.cohort,
+		fingerprint_hash: input.fingerprintHash,
+		sdk_version: input.sdkVersion ?? null,
+		received_at_ms: Date.now()
+	};
+	switch (input.type) {
+		case "UPDATE_APPLIED":
+		case "RECOVERED":
+		case "RELEASE_ADOPTED": return {
+			...base,
+			type: input.type,
+			from_bundle_id: input.fromBundleId,
+			update_strategy: input.updateStrategy
+		};
+		case "UNCHANGED": return {
+			...base,
+			type: input.type,
+			from_bundle_id: null,
+			update_strategy: null
+		};
+	}
+}
+//#endregion
+export { createBundleEventRow };

package/dist/insights/bounded/provider.cjs

@@ -0,0 +1,170 @@
+const require_activeOverview = require("./activeOverview.cjs");
+const require_scan = require("./scan.cjs");
+const require_installationSearch = require("./installationSearch.cjs");
+const require_persistence = require("./persistence.cjs");
+//#region src/insights/bounded/provider.ts
+const isTransitionEventRow = (row) => row.type === "UPDATE_APPLIED" || row.type === "RECOVERED";
+const toHistoryRow = (row) => ({
+	id: row.id,
+	type: row.type,
+	fromBundleId: row.from_bundle_id,
+	toBundleId: row.to_bundle_id,
+	username: row.username,
+	userId: row.user_id,
+	platform: row.platform,
+	appVersion: row.app_version,
+	channel: row.channel,
+	cohort: row.cohort,
+	receivedAtMs: row.received_at_ms
+});
+const isInstalledForBundle = (row, bundleId) => row.type === "UPDATE_APPLIED" && row.to_bundle_id === bundleId;
+const isRecoveredFromBundle = (row, bundleId) => row.type === "RECOVERED" && row.from_bundle_id === bundleId;
+const countDistinctInstallations = (rows) => new Set(rows.map(({ install_id }) => install_id)).size;
+const getInsightsResult = async (persistence, bundleId, window, limit, offset) => {
+	const scope = {
+		persistence,
+		cutoffMs: Date.now()
+	};
+	const rows = (await require_scan.materializeRowsForWindow(scope, window)).filter(isTransitionEventRow);
+	const installedRows = rows.filter((row) => isInstalledForBundle(row, bundleId));
+	const recoveredRows = rows.filter((row) => isRecoveredFromBundle(row, bundleId));
+	const installed = require_scan.collectEventActivity({
+		rows: installedRows,
+		window,
+		cutoffMs: scope.cutoffMs
+	});
+	const recovered = require_scan.collectEventActivity({
+		rows: recoveredRows,
+		window,
+		cutoffMs: scope.cutoffMs
+	});
+	const recentRows = [...installedRows, ...recoveredRows].sort(require_scan.compareEventNewest);
+	return {
+		summary: {
+			installed: installed.summary,
+			recovered: recovered.summary
+		},
+		series: {
+			installed: installed.series,
+			recovered: recovered.series
+		},
+		cohorts: {
+			installed: installed.cohorts,
+			recovered: recovered.cohorts
+		},
+		recentEvents: {
+			data: recentRows.slice(offset, offset + limit).map(toHistoryRow),
+			pagination: {
+				total: recentRows.length,
+				limit,
+				offset
+			}
+		}
+	};
+};
+const getInsightsSummaries = async (persistence, bundleIds, window) => {
+	const normalizedBundleIds = [...new Set(bundleIds)];
+	if (normalizedBundleIds.length === 0) return [];
+	const requestedBundleIds = new Set(normalizedBundleIds);
+	const installedByBundleId = /* @__PURE__ */ new Map();
+	const recoveredByBundleId = /* @__PURE__ */ new Map();
+	const rows = (await require_scan.materializeRowsForWindow({
+		persistence,
+		cutoffMs: Date.now()
+	}, window)).filter(isTransitionEventRow);
+	for (const row of rows) {
+		const bundleId = row.type === "UPDATE_APPLIED" ? row.to_bundle_id : row.from_bundle_id;
+		if (!requestedBundleIds.has(bundleId)) continue;
+		const counts = row.type === "UPDATE_APPLIED" ? installedByBundleId : recoveredByBundleId;
+		const installIds = counts.get(bundleId) ?? /* @__PURE__ */ new Set();
+		installIds.add(row.install_id);
+		counts.set(bundleId, installIds);
+	}
+	return normalizedBundleIds.map((bundleId) => ({
+		bundleId,
+		installed: installedByBundleId.get(bundleId)?.size ?? 0,
+		recovered: recoveredByBundleId.get(bundleId)?.size ?? 0
+	}));
+};
+const createInsightsProvider = (persistence) => Object.freeze({
+	mode: "bounded",
+	maxMatchingRows: require_scan.INSIGHTS_SCAN_MAX_ROWS,
+	async appendBundleEvent(input) {
+		await persistence.append(require_persistence.createBundleEventRow(input));
+	},
+	async getBundleEventSummary(bundleId) {
+		const rows = (await require_scan.materializeEventRows({
+			persistence,
+			cutoffMs: Date.now()
+		})).filter(isTransitionEventRow);
+		return {
+			installed: countDistinctInstallations(rows.filter((row) => isInstalledForBundle(row, bundleId))),
+			recovered: countDistinctInstallations(rows.filter((row) => isRecoveredFromBundle(row, bundleId)))
+		};
+	},
+	getBundleEventSummaries(bundleIds, window) {
+		return getInsightsSummaries(persistence, bundleIds, window);
+	},
+	getBundleEventInsights(bundleId, window, limit, offset) {
+		return getInsightsResult(persistence, bundleId, window, limit, offset);
+	},
+	async getBundleEventOverview() {
+		const rows = await require_scan.materializeEventRows({
+			persistence,
+			cutoffMs: Date.now()
+		});
+		const latestByInstall = /* @__PURE__ */ new Map();
+		for (const row of rows) {
+			const current = latestByInstall.get(row.install_id);
+			if (current === void 0 || require_scan.compareEventNewest(row, current) < 0) latestByInstall.set(row.install_id, row);
+		}
+		const counts = /* @__PURE__ */ new Map();
+		for (const row of latestByInstall.values()) counts.set(row.to_bundle_id, (counts.get(row.to_bundle_id) ?? 0) + 1);
+		return {
+			trackedInstallations: latestByInstall.size,
+			bundles: [...counts].map(([bundleId, installations]) => ({
+				bundleId,
+				installations
+			})).sort((left, right) => right.installations - left.installations || require_scan.compareCodePoints(left.bundleId, right.bundleId))
+		};
+	},
+	async getActiveInstallationOverview(input) {
+		const asOfMs = Date.now();
+		return require_activeOverview.collectActiveInstallationOverview({
+			rows: await require_scan.materializeActiveRows({
+				persistence,
+				cutoffMs: asOfMs
+			}, input.window),
+			asOfMs,
+			window: input.window,
+			...input.userId === void 0 ? {} : { userId: input.userId }
+		});
+	},
+	async searchInstallations(query, limit, offset) {
+		return require_installationSearch.searchEventInstallations({
+			rows: await require_scan.materializeEventRows({
+				persistence,
+				cutoffMs: Date.now()
+			}),
+			query,
+			limit,
+			offset
+		});
+	},
+	async getInstallationHistory(installId, limit, offset) {
+		const ordered = (await require_scan.materializeEventRows({
+			persistence,
+			cutoffMs: Date.now()
+		})).filter((row) => row.install_id === installId && isTransitionEventRow(row)).toSorted(require_scan.compareEventNewest);
+		return {
+			data: ordered.slice(offset, offset + limit).map(toHistoryRow),
+			pagination: {
+				total: ordered.length,
+				limit,
+				offset
+			}
+		};
+	}
+});
+//#endregion
+exports.createInsightsProvider = createInsightsProvider;

package/dist/insights/bounded/provider.d.cts

@@ -0,0 +1,7 @@
+import { InsightsProvider } from "../types.cjs";
+import { InsightsPersistence } from "../persistence.cjs";
+
+//#region src/insights/bounded/provider.d.ts
+declare const createInsightsProvider: (persistence: InsightsPersistence) => InsightsProvider;
+//#endregion
+export { createInsightsProvider };

package/dist/insights/bounded/provider.d.mts

@@ -0,0 +1,7 @@
+import { InsightsProvider } from "../types.mjs";
+import { InsightsPersistence } from "../persistence.mjs";
+
+//#region src/insights/bounded/provider.d.ts
+declare const createInsightsProvider: (persistence: InsightsPersistence) => InsightsProvider;
+//#endregion
+export { createInsightsProvider };

package/dist/insights/bounded/provider.mjs

@@ -0,0 +1,170 @@
+import { collectActiveInstallationOverview } from "./activeOverview.mjs";
+import { INSIGHTS_SCAN_MAX_ROWS, collectEventActivity, compareCodePoints, compareEventNewest, materializeActiveRows, materializeEventRows, materializeRowsForWindow } from "./scan.mjs";
+import { searchEventInstallations } from "./installationSearch.mjs";
+import { createBundleEventRow } from "./persistence.mjs";
+//#region src/insights/bounded/provider.ts
+const isTransitionEventRow = (row) => row.type === "UPDATE_APPLIED" || row.type === "RECOVERED";
+const toHistoryRow = (row) => ({
+	id: row.id,
+	type: row.type,
+	fromBundleId: row.from_bundle_id,
+	toBundleId: row.to_bundle_id,
+	username: row.username,
+	userId: row.user_id,
+	platform: row.platform,
+	appVersion: row.app_version,
+	channel: row.channel,
+	cohort: row.cohort,
+	receivedAtMs: row.received_at_ms
+});
+const isInstalledForBundle = (row, bundleId) => row.type === "UPDATE_APPLIED" && row.to_bundle_id === bundleId;
+const isRecoveredFromBundle = (row, bundleId) => row.type === "RECOVERED" && row.from_bundle_id === bundleId;
+const countDistinctInstallations = (rows) => new Set(rows.map(({ install_id }) => install_id)).size;
+const getInsightsResult = async (persistence, bundleId, window, limit, offset) => {
+	const scope = {
+		persistence,
+		cutoffMs: Date.now()
+	};
+	const rows = (await materializeRowsForWindow(scope, window)).filter(isTransitionEventRow);
+	const installedRows = rows.filter((row) => isInstalledForBundle(row, bundleId));
+	const recoveredRows = rows.filter((row) => isRecoveredFromBundle(row, bundleId));
+	const installed = collectEventActivity({
+		rows: installedRows,
+		window,
+		cutoffMs: scope.cutoffMs
+	});
+	const recovered = collectEventActivity({
+		rows: recoveredRows,
+		window,
+		cutoffMs: scope.cutoffMs
+	});
+	const recentRows = [...installedRows, ...recoveredRows].sort(compareEventNewest);
+	return {
+		summary: {
+			installed: installed.summary,
+			recovered: recovered.summary
+		},
+		series: {
+			installed: installed.series,
+			recovered: recovered.series
+		},
+		cohorts: {
+			installed: installed.cohorts,
+			recovered: recovered.cohorts
+		},
+		recentEvents: {
+			data: recentRows.slice(offset, offset + limit).map(toHistoryRow),
+			pagination: {
+				total: recentRows.length,
+				limit,
+				offset
+			}
+		}
+	};
+};
+const getInsightsSummaries = async (persistence, bundleIds, window) => {
+	const normalizedBundleIds = [...new Set(bundleIds)];
+	if (normalizedBundleIds.length === 0) return [];
+	const requestedBundleIds = new Set(normalizedBundleIds);
+	const installedByBundleId = /* @__PURE__ */ new Map();
+	const recoveredByBundleId = /* @__PURE__ */ new Map();
+	const rows = (await materializeRowsForWindow({
+		persistence,
+		cutoffMs: Date.now()
+	}, window)).filter(isTransitionEventRow);
+	for (const row of rows) {
+		const bundleId = row.type === "UPDATE_APPLIED" ? row.to_bundle_id : row.from_bundle_id;
+		if (!requestedBundleIds.has(bundleId)) continue;
+		const counts = row.type === "UPDATE_APPLIED" ? installedByBundleId : recoveredByBundleId;
+		const installIds = counts.get(bundleId) ?? /* @__PURE__ */ new Set();
+		installIds.add(row.install_id);
+		counts.set(bundleId, installIds);
+	}
+	return normalizedBundleIds.map((bundleId) => ({
+		bundleId,
+		installed: installedByBundleId.get(bundleId)?.size ?? 0,
+		recovered: recoveredByBundleId.get(bundleId)?.size ?? 0
+	}));
+};
+const createInsightsProvider = (persistence) => Object.freeze({
+	mode: "bounded",
+	maxMatchingRows: INSIGHTS_SCAN_MAX_ROWS,
+	async appendBundleEvent(input) {
+		await persistence.append(createBundleEventRow(input));
+	},
+	async getBundleEventSummary(bundleId) {
+		const rows = (await materializeEventRows({
+			persistence,
+			cutoffMs: Date.now()
+		})).filter(isTransitionEventRow);
+		return {
+			installed: countDistinctInstallations(rows.filter((row) => isInstalledForBundle(row, bundleId))),
+			recovered: countDistinctInstallations(rows.filter((row) => isRecoveredFromBundle(row, bundleId)))
+		};
+	},
+	getBundleEventSummaries(bundleIds, window) {
+		return getInsightsSummaries(persistence, bundleIds, window);
+	},
+	getBundleEventInsights(bundleId, window, limit, offset) {
+		return getInsightsResult(persistence, bundleId, window, limit, offset);
+	},
+	async getBundleEventOverview() {
+		const rows = await materializeEventRows({
+			persistence,
+			cutoffMs: Date.now()
+		});
+		const latestByInstall = /* @__PURE__ */ new Map();
+		for (const row of rows) {
+			const current = latestByInstall.get(row.install_id);
+			if (current === void 0 || compareEventNewest(row, current) < 0) latestByInstall.set(row.install_id, row);
+		}
+		const counts = /* @__PURE__ */ new Map();
+		for (const row of latestByInstall.values()) counts.set(row.to_bundle_id, (counts.get(row.to_bundle_id) ?? 0) + 1);
+		return {
+			trackedInstallations: latestByInstall.size,
+			bundles: [...counts].map(([bundleId, installations]) => ({
+				bundleId,
+				installations
+			})).sort((left, right) => right.installations - left.installations || compareCodePoints(left.bundleId, right.bundleId))
+		};
+	},
+	async getActiveInstallationOverview(input) {
+		const asOfMs = Date.now();
+		return collectActiveInstallationOverview({
+			rows: await materializeActiveRows({
+				persistence,
+				cutoffMs: asOfMs
+			}, input.window),
+			asOfMs,
+			window: input.window,
+			...input.userId === void 0 ? {} : { userId: input.userId }
+		});
+	},
+	async searchInstallations(query, limit, offset) {
+		return searchEventInstallations({
+			rows: await materializeEventRows({
+				persistence,
+				cutoffMs: Date.now()
+			}),
+			query,
+			limit,
+			offset
+		});
+	},
+	async getInstallationHistory(installId, limit, offset) {
+		const ordered = (await materializeEventRows({
+			persistence,
+			cutoffMs: Date.now()
+		})).filter((row) => row.install_id === installId && isTransitionEventRow(row)).toSorted(compareEventNewest);
+		return {
+			data: ordered.slice(offset, offset + limit).map(toHistoryRow),
+			pagination: {
+				total: ordered.length,
+				limit,
+				offset
+			}
+		};
+	}
+});
+//#endregion
+export { createInsightsProvider };

package/dist/insights/bounded/scan.cjs

@@ -0,0 +1,144 @@
+const require_errors = require("../errors.cjs");
+const require_activeOverview = require("./activeOverview.cjs");
+//#region src/insights/bounded/scan.ts
+const INSIGHTS_SCAN_MAX_ROWS = 5e4;
+const INSIGHTS_MATERIALIZATION_LIMIT = INSIGHTS_SCAN_MAX_ROWS + 1;
+const INSIGHTS_SCAN_PAGE_SIZE = 1e3;
+const INSIGHTS_LOWER_BOUND_ID = "00000000-0000-0000-0000-000000000000";
+const compareCodePoints = (left, right) => {
+	if (left < right) return -1;
+	if (left > right) return 1;
+	return 0;
+};
+const compareEventNewest = (left, right) => right.received_at_ms - left.received_at_ms || compareCodePoints(right.id, left.id);
+const compareEventOldest = (left, right) => left.received_at_ms - right.received_at_ms || compareCodePoints(left.id, right.id);
+const materializeEventRows = async (scope) => {
+	const rows = [];
+	const seenIds = /* @__PURE__ */ new Set();
+	let after = scope.lowerBoundMs === void 0 ? void 0 : {
+		receivedAtMs: scope.lowerBoundMs,
+		id: INSIGHTS_LOWER_BOUND_ID
+	};
+	while (rows.length < INSIGHTS_MATERIALIZATION_LIMIT) {
+		const limit = Math.min(INSIGHTS_SCAN_PAGE_SIZE, INSIGHTS_MATERIALIZATION_LIMIT - rows.length);
+		const page = await scope.persistence.scan({
+			beforeReceivedAtMs: scope.cutoffMs,
+			...after === void 0 ? {} : { after },
+			limit
+		});
+		if (page.length === 0) break;
+		if (page.length > limit) throw new InsightsPersistenceOrderError();
+		let previous = after === void 0 ? void 0 : {
+			received_at_ms: after.receivedAtMs,
+			id: after.id
+		};
+		for (const row of page) {
+			if (row.received_at_ms >= scope.cutoffMs || previous !== void 0 && compareEventOldest(previous, row) >= 0 || seenIds.has(row.id)) throw new InsightsPersistenceOrderError();
+			seenIds.add(row.id);
+			rows.push(row);
+			previous = row;
+		}
+		const last = page.at(-1);
+		if (last !== void 0) after = {
+			receivedAtMs: last.received_at_ms,
+			id: last.id
+		};
+		if (rows.length > 5e4) throw new require_errors.InsightsScanLimitExceededError(INSIGHTS_SCAN_MAX_ROWS);
+	}
+	return rows;
+};
+var InsightsPersistenceOrderError = class extends Error {
+	name = "InsightsPersistenceOrderError";
+	constructor() {
+		super("Insights persistence did not advance its scan cursor.");
+	}
+};
+const materializeActiveRows = async (scope, window) => {
+	const definition = require_activeOverview.getActiveWindowDefinition(window);
+	const durationMs = definition.bucketCount * definition.bucketSizeMs;
+	return (await materializeEventRows({
+		...scope,
+		lowerBoundMs: scope.cutoffMs - durationMs
+	})).filter((row) => row.received_at_ms >= scope.cutoffMs - durationMs && require_activeOverview.ACTIVE_BUNDLE_EVENT_TYPES.includes(row.type));
+};
+const startOfUtcHour = (value) => {
+	const date = new Date(value);
+	return Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate(), date.getUTCHours());
+};
+const startOfUtcDay = (value) => {
+	const date = new Date(value);
+	return Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate());
+};
+const getWindowRange = (window, now) => {
+	if (window === "24h") return {
+		sizeMs: 3600 * 1e3,
+		rangeStart: startOfUtcHour(now) - 1380 * 60 * 1e3
+	};
+	const days = window === "7d" ? 7 : 30;
+	return {
+		sizeMs: 1440 * 60 * 1e3,
+		rangeStart: startOfUtcDay(now) - (days - 1) * 24 * 60 * 60 * 1e3
+	};
+};
+const materializeRowsForWindow = async (scope, window) => {
+	if (window === "all") return materializeEventRows(scope);
+	const range = getWindowRange(window, scope.cutoffMs);
+	return (await materializeEventRows({
+		...scope,
+		lowerBoundMs: range.rangeStart
+	})).filter(({ received_at_ms }) => received_at_ms >= range.rangeStart);
+};
+const bucketStart = (receivedAtMs, sizeMs) => sizeMs === 3600 * 1e3 ? startOfUtcHour(receivedAtMs) : startOfUtcDay(receivedAtMs);
+const createSeries = (request) => {
+	const range = request.window === "all" ? void 0 : getWindowRange(request.window, request.cutoffMs);
+	const sizeMs = range?.sizeMs ?? 1440 * 60 * 1e3;
+	const installIdsByBucket = /* @__PURE__ */ new Map();
+	let oldestMs = request.cutoffMs;
+	for (const row of request.rows) {
+		oldestMs = Math.min(oldestMs, row.received_at_ms);
+		const start = bucketStart(row.received_at_ms, sizeMs);
+		const installIds = installIdsByBucket.get(start) ?? /* @__PURE__ */ new Set();
+		installIds.add(row.install_id);
+		installIdsByBucket.set(start, installIds);
+	}
+	const first = range?.rangeStart ?? startOfUtcDay(oldestMs);
+	const last = bucketStart(request.cutoffMs, sizeMs);
+	return Array.from({ length: Math.floor((last - first) / sizeMs) + 1 }, (_, index) => {
+		const start = first + index * sizeMs;
+		return {
+			bucketStartMs: start,
+			value: installIdsByBucket.get(start)?.size ?? 0
+		};
+	});
+};
+const collectEventActivity = (request) => {
+	const range = request.window === "all" ? void 0 : getWindowRange(request.window, request.cutoffMs);
+	const rows = range === void 0 ? request.rows : request.rows.filter(({ received_at_ms }) => received_at_ms >= range.rangeStart && received_at_ms < request.cutoffMs);
+	const installs = /* @__PURE__ */ new Set();
+	const installsByCohort = /* @__PURE__ */ new Map();
+	for (const row of rows) {
+		installs.add(row.install_id);
+		const cohort = installsByCohort.get(row.cohort) ?? /* @__PURE__ */ new Set();
+		cohort.add(row.install_id);
+		installsByCohort.set(row.cohort, cohort);
+	}
+	return {
+		summary: installs.size,
+		cohorts: [...installsByCohort].sort(([left], [right]) => compareCodePoints(left, right)).map(([cohort, installIds]) => ({
+			cohort,
+			value: installIds.size
+		})),
+		series: createSeries({
+			...request,
+			rows
+		})
+	};
+};
+//#endregion
+exports.INSIGHTS_SCAN_MAX_ROWS = INSIGHTS_SCAN_MAX_ROWS;
+exports.collectEventActivity = collectEventActivity;
+exports.compareCodePoints = compareCodePoints;
+exports.compareEventNewest = compareEventNewest;
+exports.materializeActiveRows = materializeActiveRows;
+exports.materializeEventRows = materializeEventRows;
+exports.materializeRowsForWindow = materializeRowsForWindow;

package/dist/insights/bounded/scan.mjs

@@ -0,0 +1,138 @@
+import { InsightsScanLimitExceededError } from "../errors.mjs";
+import { ACTIVE_BUNDLE_EVENT_TYPES, getActiveWindowDefinition } from "./activeOverview.mjs";
+//#region src/insights/bounded/scan.ts
+const INSIGHTS_SCAN_MAX_ROWS = 5e4;
+const INSIGHTS_MATERIALIZATION_LIMIT = INSIGHTS_SCAN_MAX_ROWS + 1;
+const INSIGHTS_SCAN_PAGE_SIZE = 1e3;
+const INSIGHTS_LOWER_BOUND_ID = "00000000-0000-0000-0000-000000000000";
+const compareCodePoints = (left, right) => {
+	if (left < right) return -1;
+	if (left > right) return 1;
+	return 0;
+};
+const compareEventNewest = (left, right) => right.received_at_ms - left.received_at_ms || compareCodePoints(right.id, left.id);
+const compareEventOldest = (left, right) => left.received_at_ms - right.received_at_ms || compareCodePoints(left.id, right.id);
+const materializeEventRows = async (scope) => {
+	const rows = [];
+	const seenIds = /* @__PURE__ */ new Set();
+	let after = scope.lowerBoundMs === void 0 ? void 0 : {
+		receivedAtMs: scope.lowerBoundMs,
+		id: INSIGHTS_LOWER_BOUND_ID
+	};
+	while (rows.length < INSIGHTS_MATERIALIZATION_LIMIT) {
+		const limit = Math.min(INSIGHTS_SCAN_PAGE_SIZE, INSIGHTS_MATERIALIZATION_LIMIT - rows.length);
+		const page = await scope.persistence.scan({
+			beforeReceivedAtMs: scope.cutoffMs,
+			...after === void 0 ? {} : { after },
+			limit
+		});
+		if (page.length === 0) break;
+		if (page.length > limit) throw new InsightsPersistenceOrderError();
+		let previous = after === void 0 ? void 0 : {
+			received_at_ms: after.receivedAtMs,
+			id: after.id
+		};
+		for (const row of page) {
+			if (row.received_at_ms >= scope.cutoffMs || previous !== void 0 && compareEventOldest(previous, row) >= 0 || seenIds.has(row.id)) throw new InsightsPersistenceOrderError();
+			seenIds.add(row.id);
+			rows.push(row);
+			previous = row;
+		}
+		const last = page.at(-1);
+		if (last !== void 0) after = {
+			receivedAtMs: last.received_at_ms,
+			id: last.id
+		};
+		if (rows.length > 5e4) throw new InsightsScanLimitExceededError(INSIGHTS_SCAN_MAX_ROWS);
+	}
+	return rows;
+};
+var InsightsPersistenceOrderError = class extends Error {
+	name = "InsightsPersistenceOrderError";
+	constructor() {
+		super("Insights persistence did not advance its scan cursor.");
+	}
+};
+const materializeActiveRows = async (scope, window) => {
+	const definition = getActiveWindowDefinition(window);
+	const durationMs = definition.bucketCount * definition.bucketSizeMs;
+	return (await materializeEventRows({
+		...scope,
+		lowerBoundMs: scope.cutoffMs - durationMs
+	})).filter((row) => row.received_at_ms >= scope.cutoffMs - durationMs && ACTIVE_BUNDLE_EVENT_TYPES.includes(row.type));
+};
+const startOfUtcHour = (value) => {
+	const date = new Date(value);
+	return Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate(), date.getUTCHours());
+};
+const startOfUtcDay = (value) => {
+	const date = new Date(value);
+	return Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate());
+};
+const getWindowRange = (window, now) => {
+	if (window === "24h") return {
+		sizeMs: 3600 * 1e3,
+		rangeStart: startOfUtcHour(now) - 1380 * 60 * 1e3
+	};
+	const days = window === "7d" ? 7 : 30;
+	return {
+		sizeMs: 1440 * 60 * 1e3,
+		rangeStart: startOfUtcDay(now) - (days - 1) * 24 * 60 * 60 * 1e3
+	};
+};
+const materializeRowsForWindow = async (scope, window) => {
+	if (window === "all") return materializeEventRows(scope);
+	const range = getWindowRange(window, scope.cutoffMs);
+	return (await materializeEventRows({
+		...scope,
+		lowerBoundMs: range.rangeStart
+	})).filter(({ received_at_ms }) => received_at_ms >= range.rangeStart);
+};
+const bucketStart = (receivedAtMs, sizeMs) => sizeMs === 3600 * 1e3 ? startOfUtcHour(receivedAtMs) : startOfUtcDay(receivedAtMs);
+const createSeries = (request) => {
+	const range = request.window === "all" ? void 0 : getWindowRange(request.window, request.cutoffMs);
+	const sizeMs = range?.sizeMs ?? 1440 * 60 * 1e3;
+	const installIdsByBucket = /* @__PURE__ */ new Map();
+	let oldestMs = request.cutoffMs;
+	for (const row of request.rows) {
+		oldestMs = Math.min(oldestMs, row.received_at_ms);
+		const start = bucketStart(row.received_at_ms, sizeMs);
+		const installIds = installIdsByBucket.get(start) ?? /* @__PURE__ */ new Set();
+		installIds.add(row.install_id);
+		installIdsByBucket.set(start, installIds);
+	}
+	const first = range?.rangeStart ?? startOfUtcDay(oldestMs);
+	const last = bucketStart(request.cutoffMs, sizeMs);
+	return Array.from({ length: Math.floor((last - first) / sizeMs) + 1 }, (_, index) => {
+		const start = first + index * sizeMs;
+		return {
+			bucketStartMs: start,
+			value: installIdsByBucket.get(start)?.size ?? 0
+		};
+	});
+};
+const collectEventActivity = (request) => {
+	const range = request.window === "all" ? void 0 : getWindowRange(request.window, request.cutoffMs);
+	const rows = range === void 0 ? request.rows : request.rows.filter(({ received_at_ms }) => received_at_ms >= range.rangeStart && received_at_ms < request.cutoffMs);
+	const installs = /* @__PURE__ */ new Set();
+	const installsByCohort = /* @__PURE__ */ new Map();
+	for (const row of rows) {
+		installs.add(row.install_id);
+		const cohort = installsByCohort.get(row.cohort) ?? /* @__PURE__ */ new Set();
+		cohort.add(row.install_id);
+		installsByCohort.set(row.cohort, cohort);
+	}
+	return {
+		summary: installs.size,
+		cohorts: [...installsByCohort].sort(([left], [right]) => compareCodePoints(left, right)).map(([cohort, installIds]) => ({
+			cohort,
+			value: installIds.size
+		})),
+		series: createSeries({
+			...request,
+			rows
+		})
+	};
+};
+//#endregion
+export { INSIGHTS_SCAN_MAX_ROWS, collectEventActivity, compareCodePoints, compareEventNewest, materializeActiveRows, materializeEventRows, materializeRowsForWindow };