@hot-updater/firebase 1.0.0-rc.30 → 1.0.0-rc.31

package/dist/firebase/functions/index.cjs

@@ -4524,7 +4524,7 @@ const createKvAdapter = ({ store, tablePrefix = "" }) => {
 };
 //#endregion
 //#region ../../packages/server/dist/version.mjs
-const HOT_UPDATER_SERVER_VERSION = "1.0.0-rc.30";
+const HOT_UPDATER_SERVER_VERSION = "1.0.0-rc.31";
 //#endregion
 //#region ../../packages/server/dist/handlerVersionRoutes.mjs
 /**
@@ -7876,42 +7876,23 @@ const createValidatedInsightsModel = (model) => ({
 		]) || !isBundleFilter(input.filter) || !isTimestamp(input.sinceMs) || !isTimestamp(input.beforeReceivedAtMs) || input.sinceMs > input.beforeReceivedAtMs) invalidQuery();
 		return validateCount(await model.countEvents(input));
 	},
-	async getReleaseActivity(input) {
+	async countEventSeries(input) {
 		if (!isRecord$2(input) || !hasOnlyKeys(input, [
-			"releases",
-			"scope",
+			"filter",
 			"timeRange",
 			"intervalMs"
-		])) invalidQuery();
-		const releases = input.releases;
-		const scope = input.scope;
-		const timeRange = input.timeRange;
-		const intervalMs = input.intervalMs;
-		const releaseQuery = Array.isArray(releases) && releases.length > 0 && releases.length <= 100 && releases.every(isReleaseReference) && scope === void 0 && (timeRange === void 0 ? intervalMs === void 0 : isTimeRange(timeRange) && (intervalMs === void 0 || isTimestamp(intervalMs) && intervalMs > 0 && intervalMs % 36e5 === 0 && (timeRange.end - timeRange.start) / intervalMs <= 8784));
-		const scopeQuery = releases === void 0 && intervalMs === void 0 && isRecord$2(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;
+		]) || !isBundleFilter(input.filter) || !isTimeRange(input.timeRange) || !isTimestamp(input.intervalMs)) invalidQuery();
+		const { start, end } = input.timeRange;
+		const { intervalMs } = input;
+		if (intervalMs === 0 || intervalMs % 36e5 !== 0 || start % 36e5 !== 0 || (end - start) % intervalMs !== 0 || end - start > 7776e6) invalidQuery();
+		const points = await model.countEventSeries(input);
+		if (!Array.isArray(points) || points.length !== (end - start) / intervalMs || points.some((point, index) => !isRecord$2(point) || !hasOnlyKeys(point, ["startMs", "events"]) || point.startMs !== start + index * intervalMs || !isTimestamp(point.events))) invalidResult();
+		return points;
 	},
-	async getDistributionHistory(input) {
-		if (!isRecord$2(input) || !hasOnlyKeys(input, [
-			"channel",
-			"platform",
-			"timeRange"
-		]) || !hasScope(input) || !isTimeRange(input.timeRange) || input.timeRange.start % 864e5 !== 0 || input.timeRange.end % 864e5 !== 0 || input.timeRange.end - input.timeRange.start > 26784e5) invalidQuery();
-		const result = await model.getDistributionHistory(input);
-		validateAggregateResult(result);
-		if (!Array.isArray(result.points)) invalidResult();
-		for (const point of result.points) {
-			if (!isTimestamp(point.startMs) || !Array.isArray(point.bundles)) invalidResult();
-			for (const bundle of point.bundles) if (!isText$1(bundle.appVersion) || bundle.releaseId !== null && !isText$1(bundle.releaseId) || ![
-				"release",
-				"builtin",
-				"unknown"
-			].includes(bundle.bundleKind) || !isTimestamp(bundle.installations)) invalidResult();
-		}
+	async getReleaseActivity(input) {
+		if (!isRecord$2(input) || !hasOnlyKeys(input, ["releases"]) || !Array.isArray(input.releases) || input.releases.length < 1 || input.releases.length > 100 || !input.releases.every(isReleaseReference)) invalidQuery();
+		const result = await model.getReleaseActivity(input);
+		if (!isRecord$2(result) || !isTimestamp(result.measuredAtMs) || !Array.isArray(result.data) || result.data.some((item) => !isRecord$2(item) || !isReleaseReference(item.release) || !isRecord$2(item.metrics) || !isTimestamp(item.metrics.downloads) || !isTimestamp(item.metrics.launches) || !isTimestamp(item.metrics.failedLaunches))) invalidResult();
 		return result;
 	},
 	async getAppUsage(input) {
@@ -7944,9 +7925,9 @@ const createInsightsModel = (api) => createValidatedInsightsModel({
 	findLatestEvents: api.findLatestEvents,
 	countLatestEvents: api.countLatestEvents,
 	countEvents: api.countEvents,
+	countEventSeries: api.countEventSeries,
 	getReleaseActivity: api.getReleaseActivity,
-	getAppUsage: api.getAppUsage,
-	getDistributionHistory: api.getDistributionHistory
+	getAppUsage: api.getAppUsage
 });
 //#endregion
 //#region ../insights/dist/server/official.mjs
@@ -8766,14 +8747,6 @@ const bundleEvents = (days) => defineTable({
 		}
 	},
 	indexes: {
-		recent: {
-			eq: [
-				"channel",
-				"platform",
-				"day"
-			],
-			sort: ["received_at_ms"]
-		},
 		movementsByInstall: {
 			eq: ["movement_install_id"],
 			sort: ["received_at_ms"]
@@ -8890,10 +8863,11 @@ const window = {
 };
 /**
 * Counters of one period kind: hourly, daily, or lifetime at bucket 0. A
-* release or channel row counts downloads, launches, and failed launches,
-* and downloads a patch delivered and those that fell back from one. A
-* release's lifetime row counts its failed updates (`failed_updates`), since
-* no breakdown row outlives the raw period; windowed reads sum
+* release or channel row counts downloads and failed launches, and downloads
+* a patch delivered and those that fell back from one. Only a release's
+* lifetime row counts launches, which the bundle list reads and no windowed
+* read sums. It also counts the release's failed updates (`failed_updates`),
+* since no breakdown row outlives the raw period; windowed reads sum
 * `insights_failures` instead.
 */
 const counters = (retention) => defineAggregate(identityFields, {
@@ -8912,17 +8886,13 @@ const counters = (retention) => defineAggregate(identityFields, {
 	...retention === void 0 ? {} : { retention }
 });
 /**
-* Unique-installation sketches of one period kind. Rows of a failure
-* identity (`failure` and `check` scopes) keep only `failed_users`, so a
-* release's launch rows never grow by a failure's registers.
+* Unique-installation sketches of one period kind: a usage row's active
+* installations (`activity_users`), and a `failure` or `check` row's
+* installations whose update or update check failed (`failed_users`).
 */
 const sketches = (retention) => defineAggregate(identityFields, {
 	key: ["identity", "bucket_start_ms"],
-	distinct: [
-		"launch_users",
-		"activity_users",
-		"failed_users"
-	],
+	distinct: ["activity_users", "failed_users"],
 	shards: SKETCH_SHARDS,
 	batched: true,
 	indexes: { window },
@@ -9028,71 +8998,6 @@ const insightsDistribution = (retention) => defineAggregate({
 	},
 	retention
 });
-/** The last running bundle observed per installation and UTC day. */
-const bundleDailyHeads = (retention) => defineTable({
-	install_id: {
-		type: "string",
-		maxLength: 255
-	},
-	bucket_start_ms: { type: "integer" },
-	id: {
-		type: "string",
-		maxLength: 36
-	},
-	received_at_ms: { type: "integer" },
-	channel: { type: "string" },
-	platform: {
-		type: "string",
-		maxLength: 16
-	},
-	app_version: { type: "string" },
-	release_id: {
-		type: "string",
-		maxLength: 36
-	},
-	bundle_kind: {
-		type: "string",
-		maxLength: 16
-	}
-}, {
-	key: ["install_id", "bucket_start_ms"],
-	retention
-});
-/** Daily observations stay in their day when an installation reports again. */
-const insightsDistributionHistory = (retention) => defineAggregate({
-	channel: { type: "string" },
-	platform: {
-		type: "string",
-		maxLength: 16
-	},
-	app_version: { type: "string" },
-	release_id: {
-		type: "string",
-		maxLength: 36
-	},
-	bundle_kind: {
-		type: "string",
-		maxLength: 16
-	},
-	bucket_start_ms: { type: "integer" }
-}, {
-	key: [
-		"channel",
-		"platform",
-		"app_version",
-		"release_id",
-		"bundle_kind",
-		"bucket_start_ms"
-	],
-	gauges: ["installations"],
-	shards: GAUGE_SHARDS,
-	batched: true,
-	indexes: { byScope: {
-		eq: ["channel", "platform"],
-		sort: ["bucket_start_ms"]
-	} },
-	retention
-});
 /** Latest events by the bundle they came from or went to, bucketed like the distribution. */
 const insightsLatestByBundle = (retention) => defineAggregate({
 	platform: {
@@ -9212,8 +9117,6 @@ const createInsightsSchema = ({ rawDays, dailyDays } = DEFAULT_INSIGHTS_RETENTIO
 		insights_overview_lifetime: counters(),
 		insights_sketches_lifetime: lifetimeSketches(),
 		insights_distribution: insightsDistribution(daily),
-		bundle_daily_heads: bundleDailyHeads(daily),
-		insights_distribution_history: insightsDistributionHistory(daily),
 		insights_latest_by_bundle: insightsLatestByBundle(daily),
 		insights_outcomes: insightsOutcomes(hourly),
 		insights_failures: insightsFailures(hourly)
@@ -9256,12 +9159,14 @@ const insightsOverviewDeltas = (event) => {
 			downloads: (previous?.downloads ?? 0) + values.downloads,
 			launches: (previous?.launches ?? 0) + values.launches,
 			failedLaunches: (previous?.failedLaunches ?? 0) + values.failedLaunches,
-			launchIdentity: previous?.launchIdentity ?? values.launchIdentity,
 			activityIdentity: previous?.activityIdentity ?? values.activityIdentity
 		});
 	};
 	const metric = (releaseId, values) => {
-		const launchIdentity = values.launches > 0 ? event.install_id : void 0;
+		const windowed = {
+			...values,
+			launches: 0
+		};
 		if (releaseId !== null) for (const [periodKind, start] of [["lifetime", 0], ["hour", bucketStartMs]]) append({
 			scopeKind: "release",
 			releaseKind: "specific",
@@ -9272,10 +9177,7 @@ const insightsOverviewDeltas = (event) => {
 			appVersion: "",
 			periodKind,
 			bucketStartMs: start
-		}, {
-			...values,
-			...periodKind === "hour" ? { launchIdentity } : {}
-		});
+		}, periodKind === "lifetime" ? values : windowed);
 		append({
 			scopeKind: "channel",
 			releaseKind: "all",
@@ -9286,10 +9188,7 @@ const insightsOverviewDeltas = (event) => {
 			appVersion: "",
 			periodKind: "hour",
 			bucketStartMs
-		}, {
-			...values,
-			launchIdentity
-		});
+		}, windowed);
 	};
 	if (event.type === "UPDATE_DOWNLOADED") metric(event.to_release_id, {
 		downloads: 1,
@@ -9414,11 +9313,10 @@ const patchCounters = (event) => event.type !== "UPDATE_DOWNLOADED" ? {} : {
 };
 /**
 * 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.
+* day rollups for channel and usage. Only usage rows keep a sketch, of active
+* installations, and only for the event's platform, since a read for every
+* platform merges the ios and android sketches. A download's patch counters
+* go in the rows that count it.
 */
 const countEvent = (tx, event) => {
 	const shardBy = event.install_id;
@@ -9444,11 +9342,7 @@ const countEvent = (tx, event) => {
 				...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 });
+			if (models.sketches !== void 0 && delta.activityIdentity !== void 0) tx.aggregate(models.sketches, key, { activity_users: addDistinct(null, delta.activityIdentity) }, { shardBy });
 		}
 	}
 };
@@ -9601,66 +9495,21 @@ const REPEATED_FIELDS = [
 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 latest and daily heads, then the gauge and sketch rows it
-* changes and one
+* 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 only advances its daily observation. An older event counts in its
+* 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 dailyKey = {
-			install_id: event.install_id,
-			bucket_start_ms: dayOf(event.received_at_ms)
-		};
-		const [existing, previous, daily] = await Promise.all([
-			tx.findOne("bundle_events", { id: event.id }),
-			tx.findOne("bundle_event_heads", { install_id: event.install_id }),
-			event.type === "UPDATE_FAILED" ? null : tx.findOne("bundle_daily_heads", dailyKey)
-		]);
-		if (existing !== null || previous?.id === event.id || daily?.id === event.id) return;
-		if (event.type !== "UPDATE_FAILED" && (daily === null || isNewer(event, daily))) {
-			const downloaded = event.type === "UPDATE_DOWNLOADED";
-			const releaseId = downloaded ? event.from_release_id : event.to_release_id;
-			const bundleId = downloaded ? event.from_bundle_id : event.to_bundle_id;
-			const next = {
-				...dailyKey,
-				id: event.id,
-				received_at_ms: event.received_at_ms,
-				channel: event.channel,
-				platform: event.platform,
-				app_version: event.app_version,
-				release_id: releaseId ?? "",
-				bundle_kind: bundleId === "00000000-0000-0000-0000-000000000000" ? "builtin" : releaseId === null ? "unknown" : "release"
-			};
-			const count = (head, delta) => {
-				tx.aggregate("insights_distribution_history", {
-					channel: head.channel,
-					platform: head.platform,
-					app_version: head.app_version,
-					release_id: head.release_id,
-					bundle_kind: head.bundle_kind,
-					bucket_start_ms: head.bucket_start_ms
-				}, { installations: delta }, { shardBy: head.install_id });
-			};
-			if (daily !== null) {
-				if (daily.channel !== next.channel || daily.platform !== next.platform || daily.app_version !== next.app_version || daily.release_id !== next.release_id || daily.bundle_kind !== next.bundle_kind) {
-					count(daily, -1);
-					count(next, 1);
-				}
-				const { install_id: _, bucket_start_ms: __, ...fields } = next;
-				tx.update("bundle_daily_heads", daily, fields);
-			} else {
-				tx.create("bundle_daily_heads", next);
-				count(next, 1);
-			}
-		}
+		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);
@@ -9852,6 +9701,30 @@ const countEvents = async (db, input) => {
 	}));
 	return await countRaw(db, filter, sinceMs, start) + hours.reduce((sum, row) => sum + row.events, 0) + await countRaw(db, filter, end, beforeReceivedAtMs);
 };
+/**
+* A bundle filter's stored events in each interval of whole hours: one read
+* of its hourly counts, every interval present.
+*/
+const countEventSeries = async (db, input) => {
+	const { filter, intervalMs } = input;
+	const { start, end } = input.timeRange;
+	const events = Array.from({ length: (end - start) / intervalMs }, () => 0);
+	const hours = await drain((page) => db.findAggregates("insights_outcomes", {
+		index: "byRef",
+		where: scopeOf(filter),
+		range: {
+			gte: start,
+			lt: end
+		},
+		limit: PAGE,
+		...page
+	}));
+	for (const row of hours) events[Math.floor((row.bucket_start_ms - start) / intervalMs)] += row.events;
+	return events.map((count, index) => ({
+		startMs: start + index * intervalMs,
+		events: count
+	}));
+};
 /** A bundle filter's distinct (field, value, type) predicates. */
 const latestPredicates = (bundle) => {
 	if (bundle === void 0) return void 0;
@@ -9923,7 +9796,7 @@ const retained = (now, { rawDays, dailyDays }) => ({
 * Whether the rows a window reads still hold all of it; an older start is
 * partial from `oldest`, the first bucket its rows keep.
 */
-const coverageOf = (start, oldest) => start === void 0 || start >= oldest ? {
+const coverageOf = (start, oldest) => start >= oldest ? {
 	kind: "complete",
 	sinceMs: 0
 } : {
@@ -10026,43 +9899,6 @@ const lifetimeMetrics = async (db, release) => {
 		failedLaunches: lifetime?.failed_launches ?? 0
 	};
 };
-/**
-* Counters, unique users, and a series over a window: a point per UTC day
-* with rows, or, with `intervalMs`, every point of that span from the
-* window's start.
-*/
-const rangedMetrics = async (db, parts, users, range, days, hour, intervalMs) => {
-	const [counters, sketches] = await Promise.all([counterRows(db, parts, range, days, hour), sketchRows(db, users.parts, range, days, hour)]);
-	const series = /* @__PURE__ */ new Map();
-	if (intervalMs !== void 0) for (let start = range.start; start < range.end; start += intervalMs) series.set(start, {
-		downloads: 0,
-		launches: 0,
-		failedLaunches: 0
-	});
-	for (const row of counters) {
-		const start = intervalMs === void 0 ? dayFloor(row.bucket_start_ms) : row.bucket_start_ms - (row.bucket_start_ms - range.start) % intervalMs;
-		const point = series.get(start) ?? {
-			downloads: 0,
-			launches: 0,
-			failedLaunches: 0
-		};
-		point.downloads += row.downloads;
-		point.launches += row.launches;
-		point.failedLaunches += row.failed_launches;
-		series.set(start, point);
-	}
-	const total = (field) => counters.reduce((sum, row) => sum + row[field], 0);
-	return {
-		downloads: total("downloads"),
-		launches: total("launches"),
-		failedLaunches: total("failed_launches"),
-		uniqueUsers: countDistinct(mergeDistinct(sketches.map((row) => row[users.field]))),
-		series: [...series].sort(([left], [right]) => left - right).map(([startMs, point]) => ({
-			startMs,
-			...point
-		}))
-	};
-};
 /** A channel and platform's usage rows, of every app version or of one. */
 const usageParts = (channel, platform, appVersion) => ({
 	scopeKind: "usage",
@@ -10073,35 +9909,15 @@ const usageParts = (channel, platform, appVersion) => ({
 	appVersionKind: appVersion === void 0 ? "all" : "specific",
 	appVersion: appVersion ?? ""
 });
-const getReleaseActivity = async (db, input, now, retention) => {
-	const at = now();
-	const kept = retained(at, retention);
-	const data = input.scope !== void 0 ? [{
-		scope: input.scope,
-		metrics: await rangedMetrics(db, {
-			scopeKind: "channel",
-			releaseKind: "all",
-			releaseId: "",
-			channel: input.scope.channel,
-			platform: input.scope.platform,
-			appVersionKind: "all",
-			appVersion: ""
-		}, {
-			parts: usageParts(input.scope.channel, input.scope.platform),
-			field: "activity_users"
-		}, input.timeRange, true, kept.hour)
-	}] : await Promise.all(input.releases.map(async (release) => ({
-		release,
-		metrics: input.timeRange === void 0 ? await lifetimeMetrics(db, release) : await rangedMetrics(db, releaseParts(release), {
-			parts: releaseParts(release),
-			field: "launch_users"
-		}, input.timeRange, false, kept.hour, input.intervalMs)
-	})));
-	const oldest = kept[input.scope === void 0 ? "hour" : "day"];
+/** Each release's lifetime counters, which are kept: one logical row apiece. */
+const getReleaseActivity = async (db, input, now) => {
+	const measuredAtMs = now();
 	return {
-		coverage: coverageOf(input.timeRange?.start, oldest),
-		data,
-		measuredAtMs: at
+		data: await Promise.all(input.releases.map(async (release) => ({
+			release,
+			metrics: await lifetimeMetrics(db, release)
+		}))),
+		measuredAtMs
 	};
 };
 /**
@@ -10361,43 +10177,6 @@ const getUpdateFailures = async (db, input, now, retention) => {
 		}
 	};
 };
-/** Reads daily gauges, never raw events or mutable latest-state distribution. */
-const getDistributionHistory = async (db, input, now, retention) => {
-	const at = now();
-	const { start, end } = input.timeRange;
-	const points = /* @__PURE__ */ new Map();
-	for (let day = start; day < end; day += DAY_MS) points.set(day, []);
-	const rows = await drain((page) => db.findAggregates("insights_distribution_history", {
-		index: "byScope",
-		where: {
-			channel: input.channel,
-			platform: input.platform
-		},
-		range: {
-			gte: start,
-			lt: end
-		},
-		limit: PAGE,
-		...page
-	}));
-	for (const row of rows) {
-		if (row.installations <= 0) continue;
-		points.get(row.bucket_start_ms).push({
-			appVersion: row.app_version,
-			releaseId: row.release_id || null,
-			bundleKind: row.bundle_kind,
-			installations: row.installations
-		});
-	}
-	return {
-		coverage: coverageOf(start, retained(at, retention).day),
-		measuredAtMs: at,
-		points: [...points].map(([startMs, bundles]) => ({
-			startMs,
-			bundles
-		}))
-	};
-};
 //#endregion
 //#region ../insights/dist/server/queryInput.mjs
 const MAX_PAGE_LIMIT = 100;
@@ -10588,8 +10367,8 @@ const createInsightsApi = (db, now, retention) => ({
 	findLatestEvents: (input) => findLatestEvents(db, input),
 	countLatestEvents: (input) => countLatestEvents(db, input),
 	countEvents: (input) => countEvents(db, input),
-	getReleaseActivity: (input) => getReleaseActivity(db, input, now, retention),
-	getDistributionHistory: (input) => getDistributionHistory(db, input, now, retention),
+	countEventSeries: (input) => countEventSeries(db, input),
+	getReleaseActivity: (input) => getReleaseActivity(db, input, now),
 	getAppUsage: (input) => getAppUsage(db, input, now, retention),
 	/** A release's or a channel's update failures, and their breakdown over a time range. */
 	getUpdateFailures: (input) => getUpdateFailures(db, input, now, retention)
@@ -10658,7 +10437,7 @@ const insights = (options = {}) => {
 	const plugin = definePlugin({
 		id: "insights",
 		namespace: false,
-		schemaVersion: "1.3.0",
+		schemaVersion: "1.2.0",
 		schema: createInsightsSchema(retention),
 		init: ({ db, now }) => {
 			const api = createInsightsApi(db, now, retention);
@@ -10673,32 +10452,6 @@ const insights = (options = {}) => {
 						handler: (request, params) => routes[handler](params, request)
 					})),
 					failuresEndpoint(api),
-					{
-						access: "admin",
-						method: "GET",
-						path: "/distribution-history",
-						handler: async (request) => {
-							const query = new URL(request.url).searchParams;
-							try {
-								const result = await createInsightsModel(api).getDistributionHistory({
-									platform: query.get("platform"),
-									channel: query.get("channel") ?? "",
-									timeRange: {
-										start: Number(query.get("start") ?? NaN),
-										end: Number(query.get("end") ?? NaN)
-									}
-								});
-								return Response.json(result, { headers: { "cache-control": "private, no-store" } });
-							} catch (error) {
-								if (error instanceof DatabaseAdapterInputError) return Response.json({ error: "Choose a platform, channel, and up to 31 whole UTC days." }, { status: 400 });
-								if (!isDatabaseBusyError(error)) throw error;
-								return Response.json({ error: "Service unavailable" }, {
-									status: 503,
-									headers: { "retry-after": "5" }
-								});
-							}
-						}
-					},
 					{
 						access: "admin",
 						method: "GET",

package/dist/index.d.cts

@@ -167,6 +167,19 @@ interface InsightsCountEventsInput {
   readonly sinceMs: number;
   readonly beforeReceivedAtMs: number;
 }
+/** One bundle filter's stored events in each interval of a time range. */
+interface InsightsCountEventSeriesInput {
+  readonly filter: InsightsBundleEventFilter;
+  /** Whole UTC hours, at most 90 days, that a whole number of intervals fill. */
+  readonly timeRange: InsightsTimeRange;
+  /** Whole hours each point spans, from `timeRange.start`. */
+  readonly intervalMs: number;
+}
+/** Stored events in [startMs, startMs + intervalMs). */
+interface InsightsEventSeriesPoint {
+  readonly startMs: number;
+  readonly events: number;
+}
 interface ReleaseReference {
   readonly releaseId: string;
   readonly platform: "ios" | "android";
@@ -185,44 +198,22 @@ type InsightsCoverage = {
   readonly kind: "partial";
   readonly sinceMs: number | null;
 };
+/**
+ * A release's counts since its first report, from its lifetime counters,
+ * which are kept.
+ */
 interface ReleaseActivityMetrics {
   readonly downloads: number;
   readonly launches: number;
   readonly failedLaunches: number;
-  /** Omitted for lifetime-only bundle-row reads. */
-  readonly uniqueUsers?: number;
-  /**
-   * Points of each UTC day, or of each `intervalMs` from the period's start
-   * on a release read that asks for one; present only for period reads.
-   */
-  readonly series?: readonly {
-    readonly startMs: number;
-    readonly downloads: number;
-    readonly launches: number;
-    readonly failedLaunches: number;
-  }[];
 }
-type InsightsGetReleaseActivityInput = {
+interface InsightsGetReleaseActivityInput {
+  /** 1 to 100 releases. */
   readonly releases: readonly ReleaseReference[];
-  readonly timeRange?: InsightsTimeRange;
-  /**
-   * Whole hours each series point spans, from `timeRange.start`, with
-   * every point present; omitted, the series has a point per UTC day
-   * with reports. Only with a `timeRange`.
-   */
-  readonly intervalMs?: number;
-  readonly scope?: never;
-} | {
-  readonly scope: InsightsScope;
-  readonly timeRange: InsightsTimeRange;
-  readonly intervalMs?: never;
-  readonly releases?: never;
-};
+}
 interface InsightsGetReleaseActivityResult {
-  readonly coverage: InsightsCoverage;
   readonly data: readonly {
-    readonly release?: ReleaseReference;
-    readonly scope?: InsightsScope;
+    readonly release: ReleaseReference;
     readonly metrics: ReleaseActivityMetrics;
   }[];
   readonly measuredAtMs: number;
@@ -258,23 +249,6 @@ interface InsightsGetAppUsageResult {
   }[];
   readonly measuredAtMs: number;
 }
-/** Whole UTC days, at most 31, including the current unfinished day. */
-interface InsightsGetDistributionHistoryInput extends InsightsScope {
-  readonly timeRange: InsightsTimeRange;
-}
-interface InsightsGetDistributionHistoryResult {
-  readonly coverage: InsightsCoverage;
-  readonly measuredAtMs: number;
-  readonly points: readonly {
-    readonly startMs: number;
-    readonly bundles: readonly {
-      readonly appVersion: string;
-      readonly releaseId: string | null;
-      readonly bundleKind: "release" | "builtin" | "unknown";
-      readonly installations: number;
-    }[];
-  }[];
-}
 //#endregion
 //#region ../insights/dist/server/schema.d.mts
 //#region src/server/schema.d.ts
@@ -428,10 +402,6 @@ declare const plugins: readonly [import("@hot-updater/plugin-core").HotUpdaterPl
     movement_install_id: "string";
     bundle_ref: "string";
   }, {
-    readonly recent: {
-      readonly eq: readonly ["channel", "platform", "day"];
-      readonly sort: readonly ["received_at_ms"];
-    };
     readonly movementsByInstall: {
       readonly eq: readonly ["movement_install_id"];
       readonly sort: readonly ["received_at_ms"];
@@ -531,7 +501,7 @@ declare const plugins: readonly [import("@hot-updater/plugin-core").HotUpdaterPl
       readonly eq: readonly ["identity"];
       readonly sort: readonly ["bucket_start_ms"];
     };
-  }, "launch_users" | "activity_users" | "failed_users", readonly ["identity", "bucket_start_ms"]>;
+  }, "activity_users" | "failed_users", readonly ["identity", "bucket_start_ms"]>;
   readonly insights_overview_daily: import("@hot-updater/plugin-core").AggregateDefinition<{
     readonly identity: {
       readonly type: "string";
@@ -559,7 +529,7 @@ declare const plugins: readonly [import("@hot-updater/plugin-core").HotUpdaterPl
       readonly eq: readonly ["identity"];
       readonly sort: readonly ["bucket_start_ms"];
     };
-  }, "launch_users" | "activity_users" | "failed_users", readonly ["identity", "bucket_start_ms"]>;
+  }, "activity_users" | "failed_users", readonly ["identity", "bucket_start_ms"]>;
   readonly insights_overview_lifetime: import("@hot-updater/plugin-core").AggregateDefinition<{
     readonly identity: {
       readonly type: "string";
@@ -616,68 +586,6 @@ declare const plugins: readonly [import("@hot-updater/plugin-core").HotUpdaterPl
       readonly sort: readonly ["bucket_start_ms"];
     };
   }, never, readonly ["channel", "platform", "app_version", "release_id", "bucket_start_ms"]>;
-  readonly bundle_daily_heads: import("@hot-updater/plugin-core").TableDefinition<{
-    readonly install_id: {
-      readonly type: "string";
-      readonly maxLength: 255;
-    };
-    readonly bucket_start_ms: {
-      readonly type: "integer";
-    };
-    readonly id: {
-      readonly type: "string";
-      readonly maxLength: 36;
-    };
-    readonly received_at_ms: {
-      readonly type: "integer";
-    };
-    readonly channel: {
-      readonly type: "string";
-    };
-    readonly platform: {
-      readonly type: "string";
-      readonly maxLength: 16;
-    };
-    readonly app_version: {
-      readonly type: "string";
-    };
-    readonly release_id: {
-      readonly type: "string";
-      readonly maxLength: 36;
-    };
-    readonly bundle_kind: {
-      readonly type: "string";
-      readonly maxLength: 16;
-    };
-  }, Readonly<Record<string, import("@hot-updater/plugin-core").FieldType>>, {}, readonly ["install_id", "bucket_start_ms"]>;
-  readonly insights_distribution_history: import("@hot-updater/plugin-core").AggregateDefinition<{
-    readonly channel: {
-      readonly type: "string";
-    };
-    readonly platform: {
-      readonly type: "string";
-      readonly maxLength: 16;
-    };
-    readonly app_version: {
-      readonly type: "string";
-    };
-    readonly release_id: {
-      readonly type: "string";
-      readonly maxLength: 36;
-    };
-    readonly bundle_kind: {
-      readonly type: "string";
-      readonly maxLength: 16;
-    };
-    readonly bucket_start_ms: {
-      readonly type: "integer";
-    };
-  }, "installations", {
-    readonly byScope: {
-      readonly eq: readonly ["channel", "platform"];
-      readonly sort: readonly ["bucket_start_ms"];
-    };
-  }, never, readonly ["channel", "platform", "app_version", "release_id", "bundle_kind", "bucket_start_ms"]>;
   readonly insights_latest_by_bundle: import("@hot-updater/plugin-core").AggregateDefinition<{
     readonly platform: {
       readonly type: "string";
@@ -773,8 +681,8 @@ declare const plugins: readonly [import("@hot-updater/plugin-core").HotUpdaterPl
     findLatestEvents: (input: InsightsFindLatestEventsInput) => Promise<readonly BundleEventRow[]>;
     countLatestEvents: (input: InsightsCountLatestEventsInput) => Promise<number>;
     countEvents: (input: InsightsCountEventsInput) => Promise<number>;
+    countEventSeries: (input: InsightsCountEventSeriesInput) => Promise<readonly InsightsEventSeriesPoint[]>;
     getReleaseActivity: (input: InsightsGetReleaseActivityInput) => Promise<InsightsGetReleaseActivityResult>;
-    getDistributionHistory: (input: InsightsGetDistributionHistoryInput) => Promise<InsightsGetDistributionHistoryResult>;
     getAppUsage: (input: InsightsGetAppUsageInput) => Promise<InsightsGetAppUsageResult>;
     getUpdateFailures: (input: InsightsUpdateFailuresInput) => Promise<InsightsUpdateFailures>;
   };

package/dist/index.d.mts

@@ -167,6 +167,19 @@ interface InsightsCountEventsInput {
   readonly sinceMs: number;
   readonly beforeReceivedAtMs: number;
 }
+/** One bundle filter's stored events in each interval of a time range. */
+interface InsightsCountEventSeriesInput {
+  readonly filter: InsightsBundleEventFilter;
+  /** Whole UTC hours, at most 90 days, that a whole number of intervals fill. */
+  readonly timeRange: InsightsTimeRange;
+  /** Whole hours each point spans, from `timeRange.start`. */
+  readonly intervalMs: number;
+}
+/** Stored events in [startMs, startMs + intervalMs). */
+interface InsightsEventSeriesPoint {
+  readonly startMs: number;
+  readonly events: number;
+}
 interface ReleaseReference {
   readonly releaseId: string;
   readonly platform: "ios" | "android";
@@ -185,44 +198,22 @@ type InsightsCoverage = {
   readonly kind: "partial";
   readonly sinceMs: number | null;
 };
+/**
+ * A release's counts since its first report, from its lifetime counters,
+ * which are kept.
+ */
 interface ReleaseActivityMetrics {
   readonly downloads: number;
   readonly launches: number;
   readonly failedLaunches: number;
-  /** Omitted for lifetime-only bundle-row reads. */
-  readonly uniqueUsers?: number;
-  /**
-   * Points of each UTC day, or of each `intervalMs` from the period's start
-   * on a release read that asks for one; present only for period reads.
-   */
-  readonly series?: readonly {
-    readonly startMs: number;
-    readonly downloads: number;
-    readonly launches: number;
-    readonly failedLaunches: number;
-  }[];
 }
-type InsightsGetReleaseActivityInput = {
+interface InsightsGetReleaseActivityInput {
+  /** 1 to 100 releases. */
   readonly releases: readonly ReleaseReference[];
-  readonly timeRange?: InsightsTimeRange;
-  /**
-   * Whole hours each series point spans, from `timeRange.start`, with
-   * every point present; omitted, the series has a point per UTC day
-   * with reports. Only with a `timeRange`.
-   */
-  readonly intervalMs?: number;
-  readonly scope?: never;
-} | {
-  readonly scope: InsightsScope;
-  readonly timeRange: InsightsTimeRange;
-  readonly intervalMs?: never;
-  readonly releases?: never;
-};
+}
 interface InsightsGetReleaseActivityResult {
-  readonly coverage: InsightsCoverage;
   readonly data: readonly {
-    readonly release?: ReleaseReference;
-    readonly scope?: InsightsScope;
+    readonly release: ReleaseReference;
     readonly metrics: ReleaseActivityMetrics;
   }[];
   readonly measuredAtMs: number;
@@ -258,23 +249,6 @@ interface InsightsGetAppUsageResult {
   }[];
   readonly measuredAtMs: number;
 }
-/** Whole UTC days, at most 31, including the current unfinished day. */
-interface InsightsGetDistributionHistoryInput extends InsightsScope {
-  readonly timeRange: InsightsTimeRange;
-}
-interface InsightsGetDistributionHistoryResult {
-  readonly coverage: InsightsCoverage;
-  readonly measuredAtMs: number;
-  readonly points: readonly {
-    readonly startMs: number;
-    readonly bundles: readonly {
-      readonly appVersion: string;
-      readonly releaseId: string | null;
-      readonly bundleKind: "release" | "builtin" | "unknown";
-      readonly installations: number;
-    }[];
-  }[];
-}
 //#endregion
 //#region ../insights/dist/server/schema.d.mts
 //#region src/server/schema.d.ts
@@ -428,10 +402,6 @@ declare const plugins: readonly [import("@hot-updater/plugin-core").HotUpdaterPl
     movement_install_id: "string";
     bundle_ref: "string";
   }, {
-    readonly recent: {
-      readonly eq: readonly ["channel", "platform", "day"];
-      readonly sort: readonly ["received_at_ms"];
-    };
     readonly movementsByInstall: {
       readonly eq: readonly ["movement_install_id"];
       readonly sort: readonly ["received_at_ms"];
@@ -531,7 +501,7 @@ declare const plugins: readonly [import("@hot-updater/plugin-core").HotUpdaterPl
       readonly eq: readonly ["identity"];
       readonly sort: readonly ["bucket_start_ms"];
     };
-  }, "launch_users" | "activity_users" | "failed_users", readonly ["identity", "bucket_start_ms"]>;
+  }, "activity_users" | "failed_users", readonly ["identity", "bucket_start_ms"]>;
   readonly insights_overview_daily: import("@hot-updater/plugin-core").AggregateDefinition<{
     readonly identity: {
       readonly type: "string";
@@ -559,7 +529,7 @@ declare const plugins: readonly [import("@hot-updater/plugin-core").HotUpdaterPl
       readonly eq: readonly ["identity"];
       readonly sort: readonly ["bucket_start_ms"];
     };
-  }, "launch_users" | "activity_users" | "failed_users", readonly ["identity", "bucket_start_ms"]>;
+  }, "activity_users" | "failed_users", readonly ["identity", "bucket_start_ms"]>;
   readonly insights_overview_lifetime: import("@hot-updater/plugin-core").AggregateDefinition<{
     readonly identity: {
       readonly type: "string";
@@ -616,68 +586,6 @@ declare const plugins: readonly [import("@hot-updater/plugin-core").HotUpdaterPl
       readonly sort: readonly ["bucket_start_ms"];
     };
   }, never, readonly ["channel", "platform", "app_version", "release_id", "bucket_start_ms"]>;
-  readonly bundle_daily_heads: import("@hot-updater/plugin-core").TableDefinition<{
-    readonly install_id: {
-      readonly type: "string";
-      readonly maxLength: 255;
-    };
-    readonly bucket_start_ms: {
-      readonly type: "integer";
-    };
-    readonly id: {
-      readonly type: "string";
-      readonly maxLength: 36;
-    };
-    readonly received_at_ms: {
-      readonly type: "integer";
-    };
-    readonly channel: {
-      readonly type: "string";
-    };
-    readonly platform: {
-      readonly type: "string";
-      readonly maxLength: 16;
-    };
-    readonly app_version: {
-      readonly type: "string";
-    };
-    readonly release_id: {
-      readonly type: "string";
-      readonly maxLength: 36;
-    };
-    readonly bundle_kind: {
-      readonly type: "string";
-      readonly maxLength: 16;
-    };
-  }, Readonly<Record<string, import("@hot-updater/plugin-core").FieldType>>, {}, readonly ["install_id", "bucket_start_ms"]>;
-  readonly insights_distribution_history: import("@hot-updater/plugin-core").AggregateDefinition<{
-    readonly channel: {
-      readonly type: "string";
-    };
-    readonly platform: {
-      readonly type: "string";
-      readonly maxLength: 16;
-    };
-    readonly app_version: {
-      readonly type: "string";
-    };
-    readonly release_id: {
-      readonly type: "string";
-      readonly maxLength: 36;
-    };
-    readonly bundle_kind: {
-      readonly type: "string";
-      readonly maxLength: 16;
-    };
-    readonly bucket_start_ms: {
-      readonly type: "integer";
-    };
-  }, "installations", {
-    readonly byScope: {
-      readonly eq: readonly ["channel", "platform"];
-      readonly sort: readonly ["bucket_start_ms"];
-    };
-  }, never, readonly ["channel", "platform", "app_version", "release_id", "bundle_kind", "bucket_start_ms"]>;
   readonly insights_latest_by_bundle: import("@hot-updater/plugin-core").AggregateDefinition<{
     readonly platform: {
       readonly type: "string";
@@ -773,8 +681,8 @@ declare const plugins: readonly [import("@hot-updater/plugin-core").HotUpdaterPl
     findLatestEvents: (input: InsightsFindLatestEventsInput) => Promise<readonly BundleEventRow[]>;
     countLatestEvents: (input: InsightsCountLatestEventsInput) => Promise<number>;
     countEvents: (input: InsightsCountEventsInput) => Promise<number>;
+    countEventSeries: (input: InsightsCountEventSeriesInput) => Promise<readonly InsightsEventSeriesPoint[]>;
     getReleaseActivity: (input: InsightsGetReleaseActivityInput) => Promise<InsightsGetReleaseActivityResult>;
-    getDistributionHistory: (input: InsightsGetDistributionHistoryInput) => Promise<InsightsGetDistributionHistoryResult>;
     getAppUsage: (input: InsightsGetAppUsageInput) => Promise<InsightsGetAppUsageResult>;
     getUpdateFailures: (input: InsightsUpdateFailuresInput) => Promise<InsightsUpdateFailures>;
   };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hot-updater/firebase",
   "type": "module",
-  "version": "1.0.0-rc.30",
+  "version": "1.0.0-rc.31",
   "description": "React Native OTA solution for self-hosted",
   "main": "dist/index.cjs",
   "types": "dist/index.d.cts",
@@ -37,9 +37,9 @@
   ],
   "dependencies": {
     "hono": "4.12.34",
-    "@hot-updater/cli-tools": "1.0.0-rc.30",
+    "@hot-updater/cli-tools": "1.0.0-rc.31",
     "@hot-updater/plugin-core": "1.0.0-rc.28",
-    "@hot-updater/server": "1.0.0-rc.30",
+    "@hot-updater/server": "1.0.0-rc.31",
     "@hot-updater/protocol": "1.0.0-rc.28"
   },
   "publishConfig": {
@@ -55,8 +55,8 @@
     "firebase-tools": "15.29.0",
     "fkill": "^9.0.0",
     "mime": "^4.0.4",
-    "@hot-updater/test-utils": "1.0.0-rc.29",
-    "@hot-updater/mock": "1.0.0-rc.28"
+    "@hot-updater/mock": "1.0.0-rc.28",
+    "@hot-updater/test-utils": "1.0.0-rc.30"
   },
   "peerDependencies": {
     "firebase-admin": "*",