@hot-updater/plugin-insights 1.0.0-rc.20

package/dist/client/state.mjs

@@ -0,0 +1,119 @@
+//#region src/client/state.ts
+const DAY_MS = 864e5;
+/** The UTC day of a time, as `YYYY-MM-DD`. */
+const utcDay = (time) => new Date(time).toISOString().slice(0, 10);
+/** The start of a time's UTC day, in milliseconds. */
+const utcDayStart = (time) => Math.floor(time / DAY_MS) * DAY_MS;
+const sameReport = (left, right) => left.day === right.day && left.channel === right.channel && left.appVersion === right.appVersion && left.bundleId === right.bundleId && left.releaseId === right.releaseId && left.userId === right.userId;
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const isNullableString = (value) => value === null || typeof value === "string";
+const parseReport = (value) => {
+	if (value === null) return null;
+	try {
+		const report = JSON.parse(value);
+		if (isRecord(report) && typeof report.day === "string" && typeof report.channel === "string" && typeof report.appVersion === "string" && typeof report.bundleId === "string" && isNullableString(report.releaseId) && isNullableString(report.userId)) return {
+			day: report.day,
+			channel: report.channel,
+			appVersion: report.appVersion,
+			bundleId: report.bundleId,
+			releaseId: report.releaseId,
+			userId: report.userId
+		};
+	} catch {}
+	return null;
+};
+const parseFailures = (value) => {
+	if (value === null) return null;
+	try {
+		const failures = JSON.parse(value);
+		if (isRecord(failures) && typeof failures.day === "string" && Array.isArray(failures.keys) && failures.keys.every((key) => typeof key === "string")) return {
+			day: failures.day,
+			keys: failures.keys
+		};
+	} catch {}
+	return null;
+};
+/**
+* The Insights plugin's memory across launches, in its plugin storage. Every
+* read tolerates a missing or unreadable value, and a storage failure only
+* costs a report that would otherwise have been skipped.
+*/
+const createInsightsState = (storage) => {
+	/** The server said Insights is off during this runtime. */
+	let pausedThisRuntime = false;
+	const read = (key) => {
+		try {
+			return storage.get(key);
+		} catch {
+			return null;
+		}
+	};
+	const write = (key, value) => {
+		try {
+			storage.set(key, value);
+		} catch {}
+	};
+	return {
+		/**
+		* Whether reporting pauses: the server answered that Insights is off
+		* during this runtime or in the 24 hours before `now`. A pause that
+		* starts after `now`, from a clock that went back, has ended.
+		*/
+		isPaused(now) {
+			if (pausedThisRuntime) return true;
+			const pausedAt = Number(read("pausedAt"));
+			return Number.isFinite(pausedAt) && pausedAt > 0 && pausedAt <= now && now < pausedAt + DAY_MS;
+		},
+		pause(now) {
+			pausedThisRuntime = true;
+			write("pausedAt", String(now));
+		},
+		/** The server stored a report, so Insights is on. */
+		resume() {
+			if (read("pausedAt") !== null) write("pausedAt", null);
+		},
+		/** Whether a launch report repeats what the installation reported that day. */
+		repeatsReport(report) {
+			const last = parseReport(read("report"));
+			return last !== null && sameReport(last, report);
+		},
+		/** Records a delivered report that says what runs. */
+		recordReport(report) {
+			write("report", JSON.stringify(report));
+		},
+		/**
+		* Forgets the last report after a delivered download or failure, so the
+		* next launch reports again, as the server records it after one.
+		*/
+		forgetReport() {
+			if (read("report") !== null) write("report", null);
+		},
+		/** Whether a failure was already reported, or refused, that day. */
+		hasFailure(day, key) {
+			const failures = parseFailures(read("failures"));
+			return failures?.day === day && failures.keys.includes(key);
+		},
+		recordFailure(day, key) {
+			const failures = parseFailures(read("failures"));
+			const keys = failures?.day === day ? failures.keys : [];
+			if (keys.includes(key)) return;
+			write("failures", JSON.stringify({
+				day,
+				keys: [...keys, key].slice(-32)
+			}));
+		},
+		readUserId() {
+			try {
+				const user = JSON.parse(read("user") ?? "null");
+				return isRecord(user) && typeof user.userId === "string" ? user.userId : null;
+			} catch {
+				return null;
+			}
+		},
+		writeUserId(userId) {
+			write("user", userId === null ? null : JSON.stringify({ userId }));
+		}
+	};
+};
+//#endregion
+export { createInsightsState, utcDay, utcDayStart };

package/dist/internal.cjs

@@ -0,0 +1,9 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_errors = require("./server/errors.cjs");
+const require_eventInput = require("./server/eventInput.cjs");
+const require_schema = require("./server/schema.cjs");
+const require_routes = require("./server/routes.cjs");
+exports.DAILY_EVENTS = require_schema.DAILY_EVENTS;
+exports.EVENT_BODY_MAX_BYTES = require_eventInput.EVENT_BODY_MAX_BYTES;
+exports.INSIGHTS_ROUTES = require_routes.INSIGHTS_ROUTES;
+exports.InsightsBadRequestError = require_errors.InsightsBadRequestError;

package/dist/internal.d.cts

@@ -0,0 +1,5 @@
+import { InsightsBadRequestError } from "./server/errors.cjs";
+import { EVENT_BODY_MAX_BYTES } from "./server/eventInput.cjs";
+import { INSIGHTS_ROUTES } from "./server/routes.cjs";
+import { DAILY_EVENTS } from "./server/schema.cjs";
+export { DAILY_EVENTS, EVENT_BODY_MAX_BYTES, INSIGHTS_ROUTES, InsightsBadRequestError };

package/dist/internal.d.mts

@@ -0,0 +1,5 @@
+import { InsightsBadRequestError } from "./server/errors.mjs";
+import { EVENT_BODY_MAX_BYTES } from "./server/eventInput.mjs";
+import { INSIGHTS_ROUTES } from "./server/routes.mjs";
+import { DAILY_EVENTS } from "./server/schema.mjs";
+export { DAILY_EVENTS, EVENT_BODY_MAX_BYTES, INSIGHTS_ROUTES, InsightsBadRequestError };

package/dist/internal.mjs

@@ -0,0 +1,5 @@
+import { InsightsBadRequestError } from "./server/errors.mjs";
+import { EVENT_BODY_MAX_BYTES } from "./server/eventInput.mjs";
+import { DAILY_EVENTS } from "./server/schema.mjs";
+import { INSIGHTS_ROUTES } from "./server/routes.mjs";
+export { DAILY_EVENTS, EVENT_BODY_MAX_BYTES, INSIGHTS_ROUTES, InsightsBadRequestError };

package/dist/server/contract.cjs

@@ -0,0 +1,193 @@
+const require_eventRow = require("./eventRow.cjs");
+let _hot_updater_plugin_core = require("@hot-updater/plugin-core");
+//#region src/server/contract.ts
+const encoder = new TextEncoder();
+/** Exact UTF-8 byte ordering, without case folding or Unicode normalization. */
+const compareInsightsText = (left, right) => {
+	const a = encoder.encode(left);
+	const b = encoder.encode(right);
+	for (let index = 0; index < Math.min(a.length, b.length); index += 1) if (a[index] !== b[index]) return a[index] - b[index];
+	return a.length - b.length;
+};
+const isWellFormedText = (value) => {
+	for (const character of value) {
+		const point = character.codePointAt(0);
+		if (point >= 55296 && point <= 57343) return false;
+	}
+	return true;
+};
+const isIdentity = (value) => typeof value === "string" && value.length > 0 && value.length <= 255 && isWellFormedText(value);
+const isText = (value) => typeof value === "string" && value.length > 0 && isWellFormedText(value);
+const isTimestamp = (value) => typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+const isLimit = (value) => isTimestamp(value) && value >= 1 && value <= 101;
+const hasOnlyKeys = (value, keys) => Object.keys(value).every((key) => keys.includes(key));
+const hasScope = (value) => (value.platform === "ios" || value.platform === "android") && isText(value.channel);
+const isBundleFilter = (value, withKind = false) => {
+	if (!require_eventRow.isRecord(value) || !hasScope(value)) return false;
+	const keys = [
+		"platform",
+		"channel",
+		"type",
+		...withKind ? ["kind"] : []
+	];
+	return value.type === "RECOVERED" ? isText(value.fromBundleId) && hasOnlyKeys(value, [...keys, "fromBundleId"]) : (value.type === "UPDATE_DOWNLOADED" || value.type === "UPDATE_APPLIED" || value.type === "UPDATE_FAILED") && isText(value.toBundleId) && hasOnlyKeys(value, [...keys, "toBundleId"]);
+};
+const isEventFilter = (value) => {
+	if (!require_eventRow.isRecord(value)) return false;
+	if (value.kind === "all") return hasOnlyKeys(value, ["kind"]);
+	if (value.kind === "installationMovement") return isIdentity(value.installId) && hasOnlyKeys(value, ["kind", "installId"]);
+	return value.kind === "bundle" && isBundleFilter(value, true);
+};
+const validateRow = (model, row, result = false) => {
+	try {
+		require_eventRow.validateBundleEventFields(row);
+		if (!require_eventRow.isRecord(row) || typeof row.id !== "string" || !(0, _hot_updater_plugin_core.isUUIDv7)(row.id) || [...Object.values(row), ...require_eventRow.isRecord(row.metadata) ? Object.values(row.metadata) : []].some((value) => typeof value === "string" && !isWellFormedText(value))) throw new _hot_updater_plugin_core.DatabaseAdapterInputError("invalid-data");
+	} catch (error) {
+		if (result) throw new _hot_updater_plugin_core.DatabaseAdapterInputError("invalid-result");
+		throw error;
+	}
+};
+/** Throws `invalid-data` unless `row` is a complete, well-formed bundle event row. */
+const assertBundleEventRow = (row) => validateRow("bundle_events", row);
+/** Downloads, applies, recoveries, and failed updates belong in installation history. */
+const isInsightsMovementEvent = (event) => event.type === "UPDATE_DOWNLOADED" || event.type === "UPDATE_APPLIED" || event.type === "RECOVERED" || event.type === "UPDATE_FAILED";
+const matchesInsightsEventFilter = (event, filter) => {
+	if (filter.kind === "all") return true;
+	if (filter.kind === "installationMovement") return event.install_id === filter.installId && isInsightsMovementEvent(event);
+	return event.type === filter.type && event.platform === filter.platform && event.channel === filter.channel && (filter.type === "RECOVERED" ? event.from_bundle_id === filter.fromBundleId : event.to_bundle_id === filter.toBundleId && event.metadata.failure?.stage !== "check");
+};
+const invalidQuery = () => {
+	throw new _hot_updater_plugin_core.DatabaseAdapterInputError("invalid-query");
+};
+const invalidResult = () => {
+	throw new _hot_updater_plugin_core.DatabaseAdapterInputError("invalid-result");
+};
+const validateCount = (count) => isTimestamp(count) ? count : invalidResult();
+const isTimeRange = (value) => require_eventRow.isRecord(value) && hasOnlyKeys(value, ["start", "end"]) && isTimestamp(value.start) && isTimestamp(value.end) && value.start < value.end;
+const isReleaseReference = (value) => require_eventRow.isRecord(value) && hasOnlyKeys(value, [
+	"releaseId",
+	"platform",
+	"channel"
+]) && isIdentity(value.releaseId) && hasScope(value);
+const validateAggregateResult = (value) => {
+	const result = require_eventRow.isRecord(value) ? value : invalidResult();
+	if (!isTimestamp(result.measuredAtMs)) invalidResult();
+	const coverage = result.coverage;
+	if (!require_eventRow.isRecord(coverage) || coverage.kind !== "complete" && coverage.kind !== "partial" || coverage.sinceMs !== null && !isTimestamp(coverage.sinceMs)) invalidResult();
+};
+/** Validate custom and bundled providers at the same public boundary. */
+const createValidatedInsightsModel = (model) => ({
+	async recordEvent(input) {
+		if (!require_eventRow.isRecord(input) || !hasOnlyKeys(input, ["event"])) throw new _hot_updater_plugin_core.DatabaseAdapterInputError("invalid-data");
+		validateRow("bundle_events", input.event);
+		await model.recordEvent(input);
+	},
+	async listEvents(input) {
+		if (!require_eventRow.isRecord(input) || !hasOnlyKeys(input, [
+			"filter",
+			"sinceMs",
+			"beforeReceivedAtMs",
+			"after",
+			"limit"
+		]) || !isEventFilter(input.filter) || !isLimit(input.limit) || !isTimestamp(input.beforeReceivedAtMs) || input.sinceMs !== void 0 && !isTimestamp(input.sinceMs)) invalidQuery();
+		const sinceMs = input.sinceMs ?? 0;
+		if (sinceMs > input.beforeReceivedAtMs || input.after !== void 0 && (!require_eventRow.isRecord(input.after) || !hasOnlyKeys(input.after, ["receivedAtMs", "id"]) || !isTimestamp(input.after.receivedAtMs) || typeof input.after.id !== "string" || !(0, _hot_updater_plugin_core.isUUIDv7)(input.after.id) || input.after.receivedAtMs < sinceMs || input.after.receivedAtMs >= input.beforeReceivedAtMs)) invalidQuery();
+		const rows = await model.listEvents(input);
+		if (!Array.isArray(rows) || rows.length > input.limit) invalidResult();
+		let previous = input.after;
+		for (const row of rows) {
+			validateRow("bundle_events", row, true);
+			if (row.received_at_ms < sinceMs || row.received_at_ms >= input.beforeReceivedAtMs || !matchesInsightsEventFilter(row, input.filter) || previous !== void 0 && (row.received_at_ms > previous.receivedAtMs || row.received_at_ms === previous.receivedAtMs && row.id >= previous.id)) invalidResult();
+			previous = {
+				receivedAtMs: row.received_at_ms,
+				id: row.id
+			};
+		}
+		return rows;
+	},
+	async findLatestEvents(input) {
+		if (!require_eventRow.isRecord(input)) invalidQuery();
+		if ("installId" in input) {
+			if (!hasOnlyKeys(input, ["installId"]) || !isIdentity(input.installId)) invalidQuery();
+		} else if (!hasOnlyKeys(input, [
+			"userId",
+			"afterInstallId",
+			"limit"
+		]) || !isIdentity(input.userId) || !isLimit(input.limit) || input.afterInstallId !== void 0 && !isIdentity(input.afterInstallId)) invalidQuery();
+		const rows = await model.findLatestEvents(input);
+		if (!Array.isArray(rows) || rows.length > ("installId" in input ? 1 : input.limit)) invalidResult();
+		let previous = "installId" in input ? void 0 : input.afterInstallId;
+		for (const row of rows) {
+			validateRow("bundle_events", row, true);
+			if ("installId" in input ? row.install_id !== input.installId : row.user_id !== input.userId || previous !== void 0 && compareInsightsText(row.install_id, previous) <= 0) invalidResult();
+			previous = row.install_id;
+		}
+		return rows;
+	},
+	async countLatestEvents(input) {
+		if (!require_eventRow.isRecord(input) || !hasOnlyKeys(input, [
+			"platform",
+			"channel",
+			"sinceMs",
+			"bundle"
+		]) || !hasScope(input) || !isTimestamp(input.sinceMs) || input.bundle !== void 0 && (!Array.isArray(input.bundle) || input.bundle.length < 1 || input.bundle.length > 2 || input.bundle.some((bundle) => !require_eventRow.isRecord(bundle) || !hasOnlyKeys(bundle, [
+			"field",
+			"value",
+			"types"
+		]) || bundle.field !== "from_bundle_id" && bundle.field !== "to_bundle_id" || !isText(bundle.value) || !Array.isArray(bundle.types) || bundle.types.length === 0 || bundle.types.some((type) => ![
+			"UNCHANGED",
+			"UPDATE_DOWNLOADED",
+			"UPDATE_APPLIED",
+			"RECOVERED"
+		].includes(type))))) invalidQuery();
+		return validateCount(await model.countLatestEvents(input));
+	},
+	async countEvents(input) {
+		if (!require_eventRow.isRecord(input) || !hasOnlyKeys(input, [
+			"filter",
+			"sinceMs",
+			"beforeReceivedAtMs"
+		]) || !isBundleFilter(input.filter) || !isTimestamp(input.sinceMs) || !isTimestamp(input.beforeReceivedAtMs) || input.sinceMs > input.beforeReceivedAtMs) invalidQuery();
+		return validateCount(await model.countEvents(input));
+	},
+	async getReleaseActivity(input) {
+		if (!require_eventRow.isRecord(input) || !hasOnlyKeys(input, [
+			"releases",
+			"scope",
+			"timeRange"
+		])) invalidQuery();
+		const releases = input.releases;
+		const scope = input.scope;
+		const timeRange = input.timeRange;
+		const releaseQuery = Array.isArray(releases) && releases.length > 0 && releases.length <= 100 && releases.every(isReleaseReference) && scope === void 0 && (timeRange === void 0 || isTimeRange(timeRange));
+		const scopeQuery = releases === void 0 && require_eventRow.isRecord(scope) && hasOnlyKeys(scope, ["platform", "channel"]) && hasScope(scope) && isTimeRange(timeRange);
+		if (!releaseQuery && !scopeQuery) invalidQuery();
+		const result = await model.getReleaseActivity(input);
+		validateAggregateResult(result);
+		if (!Array.isArray(result.data)) invalidResult();
+		return result;
+	},
+	async getAppUsage(input) {
+		if (!require_eventRow.isRecord(input) || !hasOnlyKeys(input, [
+			"channel",
+			"platform",
+			"appVersion",
+			"timeRange",
+			"intervalMs"
+		]) || !isText(input.channel) || ![
+			"all",
+			"ios",
+			"android"
+		].includes(input.platform) || input.appVersion !== void 0 && !isText(input.appVersion) || !isTimeRange(input.timeRange) || !isTimestamp(input.intervalMs) || input.intervalMs < 36e5) invalidQuery();
+		const result = await model.getAppUsage(input);
+		validateAggregateResult(result);
+		if (!isTimestamp(result.activeInstallations) || !Array.isArray(result.points) || !Array.isArray(result.appVersions) || !Array.isArray(result.versions) || !Array.isArray(result.platforms) || !Array.isArray(result.bundleDistribution)) invalidResult();
+		return result;
+	}
+});
+//#endregion
+exports.assertBundleEventRow = assertBundleEventRow;
+exports.compareInsightsText = compareInsightsText;
+exports.createValidatedInsightsModel = createValidatedInsightsModel;
+exports.isInsightsMovementEvent = isInsightsMovementEvent;
+exports.matchesInsightsEventFilter = matchesInsightsEventFilter;

package/dist/server/contract.mjs

@@ -0,0 +1,189 @@
+import { isRecord, validateBundleEventFields } from "./eventRow.mjs";
+import { DatabaseAdapterInputError, isUUIDv7 } from "@hot-updater/plugin-core";
+//#region src/server/contract.ts
+const encoder = new TextEncoder();
+/** Exact UTF-8 byte ordering, without case folding or Unicode normalization. */
+const compareInsightsText = (left, right) => {
+	const a = encoder.encode(left);
+	const b = encoder.encode(right);
+	for (let index = 0; index < Math.min(a.length, b.length); index += 1) if (a[index] !== b[index]) return a[index] - b[index];
+	return a.length - b.length;
+};
+const isWellFormedText = (value) => {
+	for (const character of value) {
+		const point = character.codePointAt(0);
+		if (point >= 55296 && point <= 57343) return false;
+	}
+	return true;
+};
+const isIdentity = (value) => typeof value === "string" && value.length > 0 && value.length <= 255 && isWellFormedText(value);
+const isText = (value) => typeof value === "string" && value.length > 0 && isWellFormedText(value);
+const isTimestamp = (value) => typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+const isLimit = (value) => isTimestamp(value) && value >= 1 && value <= 101;
+const hasOnlyKeys = (value, keys) => Object.keys(value).every((key) => keys.includes(key));
+const hasScope = (value) => (value.platform === "ios" || value.platform === "android") && isText(value.channel);
+const isBundleFilter = (value, withKind = false) => {
+	if (!isRecord(value) || !hasScope(value)) return false;
+	const keys = [
+		"platform",
+		"channel",
+		"type",
+		...withKind ? ["kind"] : []
+	];
+	return value.type === "RECOVERED" ? isText(value.fromBundleId) && hasOnlyKeys(value, [...keys, "fromBundleId"]) : (value.type === "UPDATE_DOWNLOADED" || value.type === "UPDATE_APPLIED" || value.type === "UPDATE_FAILED") && isText(value.toBundleId) && hasOnlyKeys(value, [...keys, "toBundleId"]);
+};
+const isEventFilter = (value) => {
+	if (!isRecord(value)) return false;
+	if (value.kind === "all") return hasOnlyKeys(value, ["kind"]);
+	if (value.kind === "installationMovement") return isIdentity(value.installId) && hasOnlyKeys(value, ["kind", "installId"]);
+	return value.kind === "bundle" && isBundleFilter(value, true);
+};
+const validateRow = (model, row, result = false) => {
+	try {
+		validateBundleEventFields(row);
+		if (!isRecord(row) || typeof row.id !== "string" || !isUUIDv7(row.id) || [...Object.values(row), ...isRecord(row.metadata) ? Object.values(row.metadata) : []].some((value) => typeof value === "string" && !isWellFormedText(value))) throw new DatabaseAdapterInputError("invalid-data");
+	} catch (error) {
+		if (result) throw new DatabaseAdapterInputError("invalid-result");
+		throw error;
+	}
+};
+/** Throws `invalid-data` unless `row` is a complete, well-formed bundle event row. */
+const assertBundleEventRow = (row) => validateRow("bundle_events", row);
+/** Downloads, applies, recoveries, and failed updates belong in installation history. */
+const isInsightsMovementEvent = (event) => event.type === "UPDATE_DOWNLOADED" || event.type === "UPDATE_APPLIED" || event.type === "RECOVERED" || event.type === "UPDATE_FAILED";
+const matchesInsightsEventFilter = (event, filter) => {
+	if (filter.kind === "all") return true;
+	if (filter.kind === "installationMovement") return event.install_id === filter.installId && isInsightsMovementEvent(event);
+	return event.type === filter.type && event.platform === filter.platform && event.channel === filter.channel && (filter.type === "RECOVERED" ? event.from_bundle_id === filter.fromBundleId : event.to_bundle_id === filter.toBundleId && event.metadata.failure?.stage !== "check");
+};
+const invalidQuery = () => {
+	throw new DatabaseAdapterInputError("invalid-query");
+};
+const invalidResult = () => {
+	throw new DatabaseAdapterInputError("invalid-result");
+};
+const validateCount = (count) => isTimestamp(count) ? count : invalidResult();
+const isTimeRange = (value) => isRecord(value) && hasOnlyKeys(value, ["start", "end"]) && isTimestamp(value.start) && isTimestamp(value.end) && value.start < value.end;
+const isReleaseReference = (value) => isRecord(value) && hasOnlyKeys(value, [
+	"releaseId",
+	"platform",
+	"channel"
+]) && isIdentity(value.releaseId) && hasScope(value);
+const validateAggregateResult = (value) => {
+	const result = isRecord(value) ? value : invalidResult();
+	if (!isTimestamp(result.measuredAtMs)) invalidResult();
+	const coverage = result.coverage;
+	if (!isRecord(coverage) || coverage.kind !== "complete" && coverage.kind !== "partial" || coverage.sinceMs !== null && !isTimestamp(coverage.sinceMs)) invalidResult();
+};
+/** Validate custom and bundled providers at the same public boundary. */
+const createValidatedInsightsModel = (model) => ({
+	async recordEvent(input) {
+		if (!isRecord(input) || !hasOnlyKeys(input, ["event"])) throw new DatabaseAdapterInputError("invalid-data");
+		validateRow("bundle_events", input.event);
+		await model.recordEvent(input);
+	},
+	async listEvents(input) {
+		if (!isRecord(input) || !hasOnlyKeys(input, [
+			"filter",
+			"sinceMs",
+			"beforeReceivedAtMs",
+			"after",
+			"limit"
+		]) || !isEventFilter(input.filter) || !isLimit(input.limit) || !isTimestamp(input.beforeReceivedAtMs) || input.sinceMs !== void 0 && !isTimestamp(input.sinceMs)) invalidQuery();
+		const sinceMs = input.sinceMs ?? 0;
+		if (sinceMs > input.beforeReceivedAtMs || input.after !== void 0 && (!isRecord(input.after) || !hasOnlyKeys(input.after, ["receivedAtMs", "id"]) || !isTimestamp(input.after.receivedAtMs) || typeof input.after.id !== "string" || !isUUIDv7(input.after.id) || input.after.receivedAtMs < sinceMs || input.after.receivedAtMs >= input.beforeReceivedAtMs)) invalidQuery();
+		const rows = await model.listEvents(input);
+		if (!Array.isArray(rows) || rows.length > input.limit) invalidResult();
+		let previous = input.after;
+		for (const row of rows) {
+			validateRow("bundle_events", row, true);
+			if (row.received_at_ms < sinceMs || row.received_at_ms >= input.beforeReceivedAtMs || !matchesInsightsEventFilter(row, input.filter) || previous !== void 0 && (row.received_at_ms > previous.receivedAtMs || row.received_at_ms === previous.receivedAtMs && row.id >= previous.id)) invalidResult();
+			previous = {
+				receivedAtMs: row.received_at_ms,
+				id: row.id
+			};
+		}
+		return rows;
+	},
+	async findLatestEvents(input) {
+		if (!isRecord(input)) invalidQuery();
+		if ("installId" in input) {
+			if (!hasOnlyKeys(input, ["installId"]) || !isIdentity(input.installId)) invalidQuery();
+		} else if (!hasOnlyKeys(input, [
+			"userId",
+			"afterInstallId",
+			"limit"
+		]) || !isIdentity(input.userId) || !isLimit(input.limit) || input.afterInstallId !== void 0 && !isIdentity(input.afterInstallId)) invalidQuery();
+		const rows = await model.findLatestEvents(input);
+		if (!Array.isArray(rows) || rows.length > ("installId" in input ? 1 : input.limit)) invalidResult();
+		let previous = "installId" in input ? void 0 : input.afterInstallId;
+		for (const row of rows) {
+			validateRow("bundle_events", row, true);
+			if ("installId" in input ? row.install_id !== input.installId : row.user_id !== input.userId || previous !== void 0 && compareInsightsText(row.install_id, previous) <= 0) invalidResult();
+			previous = row.install_id;
+		}
+		return rows;
+	},
+	async countLatestEvents(input) {
+		if (!isRecord(input) || !hasOnlyKeys(input, [
+			"platform",
+			"channel",
+			"sinceMs",
+			"bundle"
+		]) || !hasScope(input) || !isTimestamp(input.sinceMs) || input.bundle !== void 0 && (!Array.isArray(input.bundle) || input.bundle.length < 1 || input.bundle.length > 2 || input.bundle.some((bundle) => !isRecord(bundle) || !hasOnlyKeys(bundle, [
+			"field",
+			"value",
+			"types"
+		]) || bundle.field !== "from_bundle_id" && bundle.field !== "to_bundle_id" || !isText(bundle.value) || !Array.isArray(bundle.types) || bundle.types.length === 0 || bundle.types.some((type) => ![
+			"UNCHANGED",
+			"UPDATE_DOWNLOADED",
+			"UPDATE_APPLIED",
+			"RECOVERED"
+		].includes(type))))) invalidQuery();
+		return validateCount(await model.countLatestEvents(input));
+	},
+	async countEvents(input) {
+		if (!isRecord(input) || !hasOnlyKeys(input, [
+			"filter",
+			"sinceMs",
+			"beforeReceivedAtMs"
+		]) || !isBundleFilter(input.filter) || !isTimestamp(input.sinceMs) || !isTimestamp(input.beforeReceivedAtMs) || input.sinceMs > input.beforeReceivedAtMs) invalidQuery();
+		return validateCount(await model.countEvents(input));
+	},
+	async getReleaseActivity(input) {
+		if (!isRecord(input) || !hasOnlyKeys(input, [
+			"releases",
+			"scope",
+			"timeRange"
+		])) invalidQuery();
+		const releases = input.releases;
+		const scope = input.scope;
+		const timeRange = input.timeRange;
+		const releaseQuery = Array.isArray(releases) && releases.length > 0 && releases.length <= 100 && releases.every(isReleaseReference) && scope === void 0 && (timeRange === void 0 || isTimeRange(timeRange));
+		const scopeQuery = releases === void 0 && isRecord(scope) && hasOnlyKeys(scope, ["platform", "channel"]) && hasScope(scope) && isTimeRange(timeRange);
+		if (!releaseQuery && !scopeQuery) invalidQuery();
+		const result = await model.getReleaseActivity(input);
+		validateAggregateResult(result);
+		if (!Array.isArray(result.data)) invalidResult();
+		return result;
+	},
+	async getAppUsage(input) {
+		if (!isRecord(input) || !hasOnlyKeys(input, [
+			"channel",
+			"platform",
+			"appVersion",
+			"timeRange",
+			"intervalMs"
+		]) || !isText(input.channel) || ![
+			"all",
+			"ios",
+			"android"
+		].includes(input.platform) || input.appVersion !== void 0 && !isText(input.appVersion) || !isTimeRange(input.timeRange) || !isTimestamp(input.intervalMs) || input.intervalMs < 36e5) invalidQuery();
+		const result = await model.getAppUsage(input);
+		validateAggregateResult(result);
+		if (!isTimestamp(result.activeInstallations) || !Array.isArray(result.points) || !Array.isArray(result.appVersions) || !Array.isArray(result.versions) || !Array.isArray(result.platforms) || !Array.isArray(result.bundleDistribution)) invalidResult();
+		return result;
+	}
+});
+//#endregion
+export { assertBundleEventRow, compareInsightsText, createValidatedInsightsModel, isInsightsMovementEvent, matchesInsightsEventFilter };