@hot-updater/server 1.0.0-rc.18 → 1.0.0-rc.21

package/dist/plugins/insights/recordEvent.cjs

@@ -1,319 +0,0 @@
-const require_contract = require("./contract.cjs");
-const require_overview = require("./overview.cjs");
-const require_schema = require("./schema.cjs");
-let _hot_updater_plugin_core_internal = require("@hot-updater/plugin-core/internal");
-//#region src/plugins/insights/recordEvent.ts
-const hourOf = (ms) => ms - ms % require_schema.HOUR_MS;
-const dayOf = (ms) => ms - ms % require_schema.DAY_MS;
-/** The `identity` of an overview or sketch row: its scope and period, hashed. */
-const insightsIdentity = (identity) => require_overview.insightsOverviewId({
-	...identity,
-	scopeKind: identity.scopeKind,
-	periodKind: identity.periodKind,
-	bucketStartMs: 0
-});
-/**
-* The bucket a head's gauges count it in, the UTC day of its event, and the
-* release its distribution row names: the one it runs, which a download
-* leaves at its source.
-*/
-const gaugeSlot = (head) => ({
-	bucket: dayOf(head.received_at_ms),
-	releaseId: head.type === "UPDATE_DOWNLOADED" ? head.from_release_id : head.to_release_id
-});
-/**
-* The `insights_latest_by_bundle` field of a head's (from, to) pair. A head
-* matches a `from` and a `to` predicate of one type at once only through its
-* pair, so this gauge is what a count subtracts to count it once.
-*/
-const PAIR_FIELD = "from_to";
-/** The pair gauge's `bundle_id`: a hash of the two bundle ids, which fit no single 36-character column. */
-const bundlePairKey = (from, to) => require_overview.insightsKey(`${from.length}:${from}${to.length}:${to}`);
-/**
-* Moves a head's gauges: the distribution row, one row per bundle it
-* references, and its pair; -1 takes back the head an event replaces.
-*/
-const countHead = (tx, head, delta) => {
-	const { bucket, releaseId } = gaugeSlot(head);
-	const shardBy = head.install_id;
-	tx.aggregate("insights_distribution", {
-		channel: head.channel,
-		platform: head.platform,
-		app_version: head.app_version,
-		release_id: releaseId ?? "",
-		bucket_start_ms: bucket
-	}, { latest_installations: delta }, { shardBy });
-	for (const field of ["from_bundle_id", "to_bundle_id"]) {
-		const bundleId = head[field];
-		if (bundleId === null) continue;
-		tx.aggregate("insights_latest_by_bundle", {
-			platform: head.platform,
-			channel: head.channel,
-			bundle_field: field,
-			bundle_id: bundleId,
-			type: head.type,
-			bucket_start_ms: bucket
-		}, { installations: delta }, { shardBy });
-	}
-	if (head.from_bundle_id !== null) tx.aggregate("insights_latest_by_bundle", {
-		platform: head.platform,
-		channel: head.channel,
-		bundle_field: PAIR_FIELD,
-		bundle_id: bundlePairKey(head.from_bundle_id, head.to_bundle_id),
-		type: head.type,
-		bucket_start_ms: bucket
-	}, { installations: delta }, { shardBy });
-};
-/**
-* Where each period's rows go, each with its retention: hours for 90 days,
-* days for 13 months, and a release's lifetime counters kept.
-*/
-const PERIOD_MODELS = {
-	hour: {
-		counters: "insights_overview",
-		sketches: "insights_sketches"
-	},
-	day: {
-		counters: "insights_overview_daily",
-		sketches: "insights_sketches_daily"
-	},
-	lifetime: {
-		counters: "insights_overview_lifetime",
-		sketches: void 0
-	}
-};
-/** A download's patch counters: a patch delivered it, or it fell back from one. */
-const patchCounters = (event) => event.type !== "UPDATE_DOWNLOADED" ? {} : {
-	...event.metadata.delivery === "patch" ? { patch_downloads: 1 } : {},
-	...event.metadata.patch_fallback === true ? { patch_fallbacks: 1 } : {}
-};
-/**
-* Counters and sketches for one event: release, channel, and usage rows, with
-* day rollups for channel and usage. Usage rows are written for the event's
-* platform only, since a read for every platform merges the ios and android
-* sketches; a channel's active installations come from its usage rows, so
-* channel rows keep no sketch of their own. A download's patch counters go
-* in the rows that count it.
-*/
-const countEvent = (tx, event) => {
-	const shardBy = event.install_id;
-	for (const delta of require_overview.insightsOverviewDeltas(event)) {
-		if (delta.identity.platform === "all") continue;
-		const { bucketStartMs, ...parts } = delta.identity;
-		const periods = parts.scopeKind === "channel" || parts.scopeKind === "usage" ? [["hour", bucketStartMs], ["day", dayOf(event.received_at_ms)]] : [[parts.periodKind, bucketStartMs]];
-		for (const [periodKind, bucket] of periods) {
-			const models = PERIOD_MODELS[periodKind];
-			const key = {
-				identity: insightsIdentity({
-					...parts,
-					periodKind
-				}),
-				bucket_start_ms: bucket
-			};
-			const counters = {
-				...Object.fromEntries([
-					["downloads", delta.downloads],
-					["launches", delta.launches],
-					["failed_launches", delta.failedLaunches]
-				].filter(([, value]) => value !== 0)),
-				...delta.downloads === 0 ? {} : patchCounters(event)
-			};
-			if (Object.keys(counters).length > 0) tx.aggregate(models.counters, key, counters, { shardBy });
-			const sketches = {
-				...delta.launchIdentity === void 0 || parts.scopeKind === "channel" ? {} : { launch_users: (0, _hot_updater_plugin_core_internal.addDistinct)(null, delta.launchIdentity) },
-				...delta.activityIdentity === void 0 ? {} : { activity_users: (0, _hot_updater_plugin_core_internal.addDistinct)(null, delta.activityIdentity) }
-			};
-			if (models.sketches !== void 0 && Object.keys(sketches).length > 0) tx.aggregate(models.sketches, key, sketches, { shardBy });
-		}
-	}
-};
-/**
-* A stored event's outcome rows: its bundle filter's hour, which a failed
-* check has none of, and every stored event's UTC day.
-*/
-const countOutcome = (tx, event) => {
-	const shardBy = event.install_id;
-	if (!require_schema.isFailedCheck(event)) tx.aggregate("insights_outcomes", {
-		platform: event.platform,
-		channel: event.channel,
-		type: event.type,
-		bundle_ref: event.type === "RECOVERED" ? `from:${event.from_bundle_id}` : `to:${event.to_bundle_id}`,
-		bucket_start_ms: hourOf(event.received_at_ms)
-	}, { events: 1 }, { shardBy });
-	tx.aggregate("insights_outcomes", {
-		...require_schema.DAILY_EVENTS,
-		bucket_start_ms: dayOf(event.received_at_ms)
-	}, { events: 1 }, { shardBy });
-};
-/** The row check requires an UPDATE_FAILED row's failure; its type leaves it optional. */
-const UNKNOWN_FAILURE = {
-	stage: "unknown",
-	reason: "unknown"
-};
-/** A failure's `detail`: what else the client knew, as a JSON array. */
-const failureDetail = (failure) => JSON.stringify([
-	failure.resource ?? null,
-	failure.http_status ?? null,
-	failure.origin_code ?? null,
-	failure.transport ?? null
-]);
-/**
-* An update failure's sketches, breakdown row, and lifetime counter. Its
-* hourly breakdown row is what windowed reads sum, so no hourly or daily
-* counter repeats it. A failed check counts for its channel, in the `check`
-* sketch of installations. Any other failure counts in the channel's
-* `failure` sketch, and for its target release, when it names one, in the
-* release's hourly and lifetime `failure` sketches and its lifetime
-* `failed_updates`, which the bundle detail reads. A failure is no launch
-* and no activity: the installation reports its launch that day.
-*/
-const countFailure = (tx, event) => {
-	const shardBy = event.install_id;
-	const failure = event.metadata.failure ?? UNKNOWN_FAILURE;
-	const check = failure.stage === "check";
-	const hour = hourOf(event.received_at_ms);
-	const scope = {
-		channel: event.channel,
-		platform: event.platform,
-		appVersionKind: "all",
-		appVersion: ""
-	};
-	const channel = {
-		...scope,
-		releaseKind: "all",
-		releaseId: ""
-	};
-	const users = { failed_users: (0, _hot_updater_plugin_core_internal.addDistinct)(null, event.install_id) };
-	for (const [periodKind, bucket] of [["hour", hour], ["day", dayOf(event.received_at_ms)]]) {
-		const identity = insightsIdentity({
-			...channel,
-			scopeKind: check ? "check" : "failure",
-			periodKind
-		});
-		tx.aggregate(PERIOD_MODELS[periodKind].sketches, {
-			identity,
-			bucket_start_ms: bucket
-		}, users, { shardBy });
-	}
-	const releaseId = check ? null : event.to_release_id;
-	if (releaseId !== null) {
-		const release = {
-			...scope,
-			releaseKind: "specific",
-			releaseId
-		};
-		for (const [periodKind, bucket, sketches] of [[
-			"hour",
-			hour,
-			"insights_sketches"
-		], [
-			"lifetime",
-			0,
-			"insights_sketches_lifetime"
-		]]) {
-			const key = (scopeKind) => ({
-				identity: insightsIdentity({
-					...release,
-					scopeKind,
-					periodKind
-				}),
-				bucket_start_ms: bucket
-			});
-			tx.aggregate(sketches, key("failure"), users, { shardBy });
-		}
-		tx.aggregate("insights_overview_lifetime", {
-			identity: insightsIdentity({
-				...release,
-				scopeKind: "release",
-				periodKind: "lifetime"
-			}),
-			bucket_start_ms: 0
-		}, { failed_updates: 1 }, { shardBy });
-	}
-	tx.aggregate("insights_failures", {
-		platform: event.platform,
-		channel: event.channel,
-		bucket_start_ms: hour,
-		release_id: releaseId ?? "",
-		stage: failure.stage,
-		reason: failure.reason,
-		detail: failureDetail(failure)
-	}, { events: 1 }, { shardBy });
-};
-/**
-* A recovery's exit reason, which Android 11+ reports, in the breakdown of
-* the release whose launch failed: stage `launch`, the reason as its reason.
-*/
-const countExit = (tx, event) => {
-	const exit = event.metadata.previous_process_exit;
-	if (event.type !== "RECOVERED" || exit === void 0) return;
-	tx.aggregate("insights_failures", {
-		platform: event.platform,
-		channel: event.channel,
-		bucket_start_ms: hourOf(event.received_at_ms),
-		release_id: event.from_release_id ?? "",
-		stage: "launch",
-		reason: exit,
-		detail: ""
-	}, { events: 1 }, { shardBy: event.install_id });
-};
-const isNewer = (event, head) => event.received_at_ms !== head.received_at_ms ? event.received_at_ms > head.received_at_ms : (0, _hot_updater_plugin_core_internal.compareUtf8)(event.id, head.id) > 0;
-/** What an UNCHANGED report must share with its installation's head to repeat it. */
-const REPEATED_FIELDS = [
-	"channel",
-	"platform",
-	"app_version",
-	"to_bundle_id",
-	"to_release_id",
-	"user_id"
-];
-/**
-* An UNCHANGED report that repeats its installation's head from the same UTC
-* day: the installation already counts as active that day, on that bundle,
-* so the report records nothing. A download's head does not count, because
-* its installation still ran the bundle it downloaded from.
-*/
-const repeatsHead = (event, head) => event.type === "UNCHANGED" && head.type !== "UPDATE_DOWNLOADED" && dayOf(event.received_at_ms) === dayOf(head.received_at_ms) && REPEATED_FIELDS.every((field) => event[field] === head[field]);
-/**
-* Records one event in one transaction: one batch read of the event and its
-* installation's head, one of the gauge and sketch rows it changes, then one
-* write. On a database that batches aggregates (DynamoDB, Firestore), the
-* write holds the event's rows and one log row instead, and a compaction
-* reads and writes the aggregate rows. A stored event's id changes nothing
-* when repeated, whichever installation sends it, and neither does the id
-* of the installation's head. An UNCHANGED report that repeats its head on
-* the same UTC day writes nothing at all. An older event still counts in its
-* own hour but never replaces the head. An update failure is stored and
-* counted, but changes what no installation runs, so it moves no head.
-*/
-const recordEvent = (db, event) => {
-	require_contract.assertBundleEventRow(event);
-	return db.transaction(async (tx) => {
-		const [existing, previous] = await Promise.all([tx.findOne("bundle_events", { id: event.id }), tx.findOne("bundle_event_heads", { install_id: event.install_id })]);
-		if (existing !== null || previous?.id === event.id) return;
-		if (previous !== null && repeatsHead(event, previous)) return;
-		if (event.type !== "UNCHANGED") {
-			tx.create("bundle_events", event);
-			countOutcome(tx, event);
-		}
-		if (event.type === "UPDATE_FAILED") {
-			countFailure(tx, event);
-			return;
-		}
-		countEvent(tx, event);
-		countExit(tx, event);
-		if (previous !== null && !isNewer(event, previous)) return;
-		if (previous === null) tx.create("bundle_event_heads", event);
-		else {
-			const { install_id: _, ...fields } = event;
-			countHead(tx, previous, -1);
-			tx.update("bundle_event_heads", previous, fields);
-		}
-		countHead(tx, event, 1);
-	});
-};
-//#endregion
-exports.PAIR_FIELD = PAIR_FIELD;
-exports.bundlePairKey = bundlePairKey;
-exports.insightsIdentity = insightsIdentity;
-exports.recordEvent = recordEvent;

package/dist/plugins/insights/recordEvent.d.cts

@@ -1,18 +0,0 @@
-import "../../database/database.cjs";
-import "./eventRow.cjs";
-import "./schema.cjs";
-import { InsightsOverviewIdentity } from "./overview.cjs";
-//#region src/plugins/insights/recordEvent.d.ts
-/**
- * An overview or sketch row's scope and period; day periods roll up channel
- * and usage rows. The `failure` and `check` scopes key the sketches of
- * installations whose update, or whose update check, failed.
- */
-type InsightsIdentityParts = Omit<InsightsOverviewIdentity, "bucketStartMs" | "periodKind" | "scopeKind"> & {
-  readonly scopeKind: InsightsOverviewIdentity["scopeKind"] | "failure" | "check";
-  readonly periodKind: InsightsOverviewIdentity["periodKind"] | "day";
-};
-/** The `identity` of an overview or sketch row: its scope and period, hashed. */
-declare const insightsIdentity: (identity: InsightsIdentityParts) => string;
-//#endregion
-export { InsightsIdentityParts, insightsIdentity };

package/dist/plugins/insights/recordEvent.d.mts

@@ -1,18 +0,0 @@
-import "../../database/database.mjs";
-import "./eventRow.mjs";
-import "./schema.mjs";
-import { InsightsOverviewIdentity } from "./overview.mjs";
-//#region src/plugins/insights/recordEvent.d.ts
-/**
- * An overview or sketch row's scope and period; day periods roll up channel
- * and usage rows. The `failure` and `check` scopes key the sketches of
- * installations whose update, or whose update check, failed.
- */
-type InsightsIdentityParts = Omit<InsightsOverviewIdentity, "bucketStartMs" | "periodKind" | "scopeKind"> & {
-  readonly scopeKind: InsightsOverviewIdentity["scopeKind"] | "failure" | "check";
-  readonly periodKind: InsightsOverviewIdentity["periodKind"] | "day";
-};
-/** The `identity` of an overview or sketch row: its scope and period, hashed. */
-declare const insightsIdentity: (identity: InsightsIdentityParts) => string;
-//#endregion
-export { InsightsIdentityParts, insightsIdentity };

package/dist/plugins/insights/recordEvent.mjs

@@ -1,316 +0,0 @@
-import { assertBundleEventRow } from "./contract.mjs";
-import { insightsKey, insightsOverviewDeltas, insightsOverviewId } from "./overview.mjs";
-import { DAILY_EVENTS, DAY_MS, HOUR_MS, isFailedCheck } from "./schema.mjs";
-import { addDistinct, compareUtf8 } from "@hot-updater/plugin-core/internal";
-//#region src/plugins/insights/recordEvent.ts
-const hourOf = (ms) => ms - ms % HOUR_MS;
-const dayOf = (ms) => ms - ms % DAY_MS;
-/** The `identity` of an overview or sketch row: its scope and period, hashed. */
-const insightsIdentity = (identity) => insightsOverviewId({
-	...identity,
-	scopeKind: identity.scopeKind,
-	periodKind: identity.periodKind,
-	bucketStartMs: 0
-});
-/**
-* The bucket a head's gauges count it in, the UTC day of its event, and the
-* release its distribution row names: the one it runs, which a download
-* leaves at its source.
-*/
-const gaugeSlot = (head) => ({
-	bucket: dayOf(head.received_at_ms),
-	releaseId: head.type === "UPDATE_DOWNLOADED" ? head.from_release_id : head.to_release_id
-});
-/**
-* The `insights_latest_by_bundle` field of a head's (from, to) pair. A head
-* matches a `from` and a `to` predicate of one type at once only through its
-* pair, so this gauge is what a count subtracts to count it once.
-*/
-const PAIR_FIELD = "from_to";
-/** The pair gauge's `bundle_id`: a hash of the two bundle ids, which fit no single 36-character column. */
-const bundlePairKey = (from, to) => insightsKey(`${from.length}:${from}${to.length}:${to}`);
-/**
-* Moves a head's gauges: the distribution row, one row per bundle it
-* references, and its pair; -1 takes back the head an event replaces.
-*/
-const countHead = (tx, head, delta) => {
-	const { bucket, releaseId } = gaugeSlot(head);
-	const shardBy = head.install_id;
-	tx.aggregate("insights_distribution", {
-		channel: head.channel,
-		platform: head.platform,
-		app_version: head.app_version,
-		release_id: releaseId ?? "",
-		bucket_start_ms: bucket
-	}, { latest_installations: delta }, { shardBy });
-	for (const field of ["from_bundle_id", "to_bundle_id"]) {
-		const bundleId = head[field];
-		if (bundleId === null) continue;
-		tx.aggregate("insights_latest_by_bundle", {
-			platform: head.platform,
-			channel: head.channel,
-			bundle_field: field,
-			bundle_id: bundleId,
-			type: head.type,
-			bucket_start_ms: bucket
-		}, { installations: delta }, { shardBy });
-	}
-	if (head.from_bundle_id !== null) tx.aggregate("insights_latest_by_bundle", {
-		platform: head.platform,
-		channel: head.channel,
-		bundle_field: PAIR_FIELD,
-		bundle_id: bundlePairKey(head.from_bundle_id, head.to_bundle_id),
-		type: head.type,
-		bucket_start_ms: bucket
-	}, { installations: delta }, { shardBy });
-};
-/**
-* Where each period's rows go, each with its retention: hours for 90 days,
-* days for 13 months, and a release's lifetime counters kept.
-*/
-const PERIOD_MODELS = {
-	hour: {
-		counters: "insights_overview",
-		sketches: "insights_sketches"
-	},
-	day: {
-		counters: "insights_overview_daily",
-		sketches: "insights_sketches_daily"
-	},
-	lifetime: {
-		counters: "insights_overview_lifetime",
-		sketches: void 0
-	}
-};
-/** A download's patch counters: a patch delivered it, or it fell back from one. */
-const patchCounters = (event) => event.type !== "UPDATE_DOWNLOADED" ? {} : {
-	...event.metadata.delivery === "patch" ? { patch_downloads: 1 } : {},
-	...event.metadata.patch_fallback === true ? { patch_fallbacks: 1 } : {}
-};
-/**
-* Counters and sketches for one event: release, channel, and usage rows, with
-* day rollups for channel and usage. Usage rows are written for the event's
-* platform only, since a read for every platform merges the ios and android
-* sketches; a channel's active installations come from its usage rows, so
-* channel rows keep no sketch of their own. A download's patch counters go
-* in the rows that count it.
-*/
-const countEvent = (tx, event) => {
-	const shardBy = event.install_id;
-	for (const delta of insightsOverviewDeltas(event)) {
-		if (delta.identity.platform === "all") continue;
-		const { bucketStartMs, ...parts } = delta.identity;
-		const periods = parts.scopeKind === "channel" || parts.scopeKind === "usage" ? [["hour", bucketStartMs], ["day", dayOf(event.received_at_ms)]] : [[parts.periodKind, bucketStartMs]];
-		for (const [periodKind, bucket] of periods) {
-			const models = PERIOD_MODELS[periodKind];
-			const key = {
-				identity: insightsIdentity({
-					...parts,
-					periodKind
-				}),
-				bucket_start_ms: bucket
-			};
-			const counters = {
-				...Object.fromEntries([
-					["downloads", delta.downloads],
-					["launches", delta.launches],
-					["failed_launches", delta.failedLaunches]
-				].filter(([, value]) => value !== 0)),
-				...delta.downloads === 0 ? {} : patchCounters(event)
-			};
-			if (Object.keys(counters).length > 0) tx.aggregate(models.counters, key, counters, { shardBy });
-			const sketches = {
-				...delta.launchIdentity === void 0 || parts.scopeKind === "channel" ? {} : { launch_users: addDistinct(null, delta.launchIdentity) },
-				...delta.activityIdentity === void 0 ? {} : { activity_users: addDistinct(null, delta.activityIdentity) }
-			};
-			if (models.sketches !== void 0 && Object.keys(sketches).length > 0) tx.aggregate(models.sketches, key, sketches, { shardBy });
-		}
-	}
-};
-/**
-* A stored event's outcome rows: its bundle filter's hour, which a failed
-* check has none of, and every stored event's UTC day.
-*/
-const countOutcome = (tx, event) => {
-	const shardBy = event.install_id;
-	if (!isFailedCheck(event)) tx.aggregate("insights_outcomes", {
-		platform: event.platform,
-		channel: event.channel,
-		type: event.type,
-		bundle_ref: event.type === "RECOVERED" ? `from:${event.from_bundle_id}` : `to:${event.to_bundle_id}`,
-		bucket_start_ms: hourOf(event.received_at_ms)
-	}, { events: 1 }, { shardBy });
-	tx.aggregate("insights_outcomes", {
-		...DAILY_EVENTS,
-		bucket_start_ms: dayOf(event.received_at_ms)
-	}, { events: 1 }, { shardBy });
-};
-/** The row check requires an UPDATE_FAILED row's failure; its type leaves it optional. */
-const UNKNOWN_FAILURE = {
-	stage: "unknown",
-	reason: "unknown"
-};
-/** A failure's `detail`: what else the client knew, as a JSON array. */
-const failureDetail = (failure) => JSON.stringify([
-	failure.resource ?? null,
-	failure.http_status ?? null,
-	failure.origin_code ?? null,
-	failure.transport ?? null
-]);
-/**
-* An update failure's sketches, breakdown row, and lifetime counter. Its
-* hourly breakdown row is what windowed reads sum, so no hourly or daily
-* counter repeats it. A failed check counts for its channel, in the `check`
-* sketch of installations. Any other failure counts in the channel's
-* `failure` sketch, and for its target release, when it names one, in the
-* release's hourly and lifetime `failure` sketches and its lifetime
-* `failed_updates`, which the bundle detail reads. A failure is no launch
-* and no activity: the installation reports its launch that day.
-*/
-const countFailure = (tx, event) => {
-	const shardBy = event.install_id;
-	const failure = event.metadata.failure ?? UNKNOWN_FAILURE;
-	const check = failure.stage === "check";
-	const hour = hourOf(event.received_at_ms);
-	const scope = {
-		channel: event.channel,
-		platform: event.platform,
-		appVersionKind: "all",
-		appVersion: ""
-	};
-	const channel = {
-		...scope,
-		releaseKind: "all",
-		releaseId: ""
-	};
-	const users = { failed_users: addDistinct(null, event.install_id) };
-	for (const [periodKind, bucket] of [["hour", hour], ["day", dayOf(event.received_at_ms)]]) {
-		const identity = insightsIdentity({
-			...channel,
-			scopeKind: check ? "check" : "failure",
-			periodKind
-		});
-		tx.aggregate(PERIOD_MODELS[periodKind].sketches, {
-			identity,
-			bucket_start_ms: bucket
-		}, users, { shardBy });
-	}
-	const releaseId = check ? null : event.to_release_id;
-	if (releaseId !== null) {
-		const release = {
-			...scope,
-			releaseKind: "specific",
-			releaseId
-		};
-		for (const [periodKind, bucket, sketches] of [[
-			"hour",
-			hour,
-			"insights_sketches"
-		], [
-			"lifetime",
-			0,
-			"insights_sketches_lifetime"
-		]]) {
-			const key = (scopeKind) => ({
-				identity: insightsIdentity({
-					...release,
-					scopeKind,
-					periodKind
-				}),
-				bucket_start_ms: bucket
-			});
-			tx.aggregate(sketches, key("failure"), users, { shardBy });
-		}
-		tx.aggregate("insights_overview_lifetime", {
-			identity: insightsIdentity({
-				...release,
-				scopeKind: "release",
-				periodKind: "lifetime"
-			}),
-			bucket_start_ms: 0
-		}, { failed_updates: 1 }, { shardBy });
-	}
-	tx.aggregate("insights_failures", {
-		platform: event.platform,
-		channel: event.channel,
-		bucket_start_ms: hour,
-		release_id: releaseId ?? "",
-		stage: failure.stage,
-		reason: failure.reason,
-		detail: failureDetail(failure)
-	}, { events: 1 }, { shardBy });
-};
-/**
-* A recovery's exit reason, which Android 11+ reports, in the breakdown of
-* the release whose launch failed: stage `launch`, the reason as its reason.
-*/
-const countExit = (tx, event) => {
-	const exit = event.metadata.previous_process_exit;
-	if (event.type !== "RECOVERED" || exit === void 0) return;
-	tx.aggregate("insights_failures", {
-		platform: event.platform,
-		channel: event.channel,
-		bucket_start_ms: hourOf(event.received_at_ms),
-		release_id: event.from_release_id ?? "",
-		stage: "launch",
-		reason: exit,
-		detail: ""
-	}, { events: 1 }, { shardBy: event.install_id });
-};
-const isNewer = (event, head) => event.received_at_ms !== head.received_at_ms ? event.received_at_ms > head.received_at_ms : compareUtf8(event.id, head.id) > 0;
-/** What an UNCHANGED report must share with its installation's head to repeat it. */
-const REPEATED_FIELDS = [
-	"channel",
-	"platform",
-	"app_version",
-	"to_bundle_id",
-	"to_release_id",
-	"user_id"
-];
-/**
-* An UNCHANGED report that repeats its installation's head from the same UTC
-* day: the installation already counts as active that day, on that bundle,
-* so the report records nothing. A download's head does not count, because
-* its installation still ran the bundle it downloaded from.
-*/
-const repeatsHead = (event, head) => event.type === "UNCHANGED" && head.type !== "UPDATE_DOWNLOADED" && dayOf(event.received_at_ms) === dayOf(head.received_at_ms) && REPEATED_FIELDS.every((field) => event[field] === head[field]);
-/**
-* Records one event in one transaction: one batch read of the event and its
-* installation's head, one of the gauge and sketch rows it changes, then one
-* write. On a database that batches aggregates (DynamoDB, Firestore), the
-* write holds the event's rows and one log row instead, and a compaction
-* reads and writes the aggregate rows. A stored event's id changes nothing
-* when repeated, whichever installation sends it, and neither does the id
-* of the installation's head. An UNCHANGED report that repeats its head on
-* the same UTC day writes nothing at all. An older event still counts in its
-* own hour but never replaces the head. An update failure is stored and
-* counted, but changes what no installation runs, so it moves no head.
-*/
-const recordEvent = (db, event) => {
-	assertBundleEventRow(event);
-	return db.transaction(async (tx) => {
-		const [existing, previous] = await Promise.all([tx.findOne("bundle_events", { id: event.id }), tx.findOne("bundle_event_heads", { install_id: event.install_id })]);
-		if (existing !== null || previous?.id === event.id) return;
-		if (previous !== null && repeatsHead(event, previous)) return;
-		if (event.type !== "UNCHANGED") {
-			tx.create("bundle_events", event);
-			countOutcome(tx, event);
-		}
-		if (event.type === "UPDATE_FAILED") {
-			countFailure(tx, event);
-			return;
-		}
-		countEvent(tx, event);
-		countExit(tx, event);
-		if (previous !== null && !isNewer(event, previous)) return;
-		if (previous === null) tx.create("bundle_event_heads", event);
-		else {
-			const { install_id: _, ...fields } = event;
-			countHead(tx, previous, -1);
-			tx.update("bundle_event_heads", previous, fields);
-		}
-		countHead(tx, event, 1);
-	});
-};
-//#endregion
-export { PAIR_FIELD, bundlePairKey, insightsIdentity, recordEvent };