@hot-updater/plugin-insights 1.0.0-rc.29 → 1.0.0-rc.30

package/dist/server/reads.cjs

@@ -345,19 +345,30 @@ const lifetimeMetrics = async (db, release) => {
 		failedLaunches: lifetime?.failed_launches ?? 0
 	};
 };
-/** Counters, unique users, and a per-UTC-day series over a window. */
-const rangedMetrics = async (db, parts, users, range, days, hour) => {
+/**
+* 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 day = dayFloor(row.bucket_start_ms);
-		const point = series.get(day) ?? {
+		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(day, point);
+		series.set(start, point);
 	}
 	const total = (field) => counters.reduce((sum, row) => sum + row[field], 0);
 	return {
@@ -403,7 +414,7 @@ const getReleaseActivity = async (db, input, now, retention) => {
 		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.timeRange, false, kept.hour, input.intervalMs)
 	})));
 	const oldest = kept[input.scope === void 0 ? "hour" : "day"];
 	return {
@@ -669,12 +680,50 @@ 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 += require_schema.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
 exports.UPDATE_FAILURES_RANGE_MS = UPDATE_FAILURES_RANGE_MS;
 exports.countEvents = countEvents;
 exports.countLatestEvents = countLatestEvents;
 exports.findLatestEvents = findLatestEvents;
 exports.getAppUsage = getAppUsage;
+exports.getDistributionHistory = getDistributionHistory;
 exports.getReleaseActivity = getReleaseActivity;
 exports.getUpdateFailures = getUpdateFailures;
 exports.listEvents = listEvents;

package/dist/server/reads.mjs

@@ -345,19 +345,30 @@ const lifetimeMetrics = async (db, release) => {
 		failedLaunches: lifetime?.failed_launches ?? 0
 	};
 };
-/** Counters, unique users, and a per-UTC-day series over a window. */
-const rangedMetrics = async (db, parts, users, range, days, hour) => {
+/**
+* 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 day = dayFloor(row.bucket_start_ms);
-		const point = series.get(day) ?? {
+		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(day, point);
+		series.set(start, point);
 	}
 	const total = (field) => counters.reduce((sum, row) => sum + row[field], 0);
 	return {
@@ -403,7 +414,7 @@ const getReleaseActivity = async (db, input, now, retention) => {
 		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.timeRange, false, kept.hour, input.intervalMs)
 	})));
 	const oldest = kept[input.scope === void 0 ? "hour" : "day"];
 	return {
@@ -669,5 +680,42 @@ 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
-export { UPDATE_FAILURES_RANGE_MS, countEvents, countLatestEvents, findLatestEvents, getAppUsage, getReleaseActivity, getUpdateFailures, listEvents };
+export { UPDATE_FAILURES_RANGE_MS, countEvents, countLatestEvents, findLatestEvents, getAppUsage, getDistributionHistory, getReleaseActivity, getUpdateFailures, listEvents };

package/dist/server/recordEvent.cjs

@@ -2,6 +2,7 @@ const require_contract = require("./contract.cjs");
 const require_overview = require("./overview.cjs");
 const require_schema = require("./schema.cjs");
 let _hot_updater_plugin_core = require("@hot-updater/plugin-core");
+let _hot_updater_protocol = require("@hot-updater/protocol");
 //#region src/server/recordEvent.ts
 const hourOf = (ms) => ms - ms % require_schema.HOUR_MS;
 const dayOf = (ms) => ms - ms % require_schema.DAY_MS;
@@ -276,21 +277,66 @@ 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 head, one of the gauge and sketch rows it changes, then one
+* installation's latest and daily heads, then the gauge and sketch rows it
+* changes and 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
+* the same UTC day only advances its daily observation. An older event 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;
+		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 === _hot_updater_protocol.NIL_UUID ? "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);
+			}
+		}
 		if (previous !== null && repeatsHead(event, previous)) return;
 		if (event.type !== "UNCHANGED") {
 			tx.create("bundle_events", event);

package/dist/server/recordEvent.mjs

@@ -2,6 +2,7 @@ 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";
+import { NIL_UUID } from "@hot-updater/protocol";
 //#region src/server/recordEvent.ts
 const hourOf = (ms) => ms - ms % HOUR_MS;
 const dayOf = (ms) => ms - ms % DAY_MS;
@@ -276,21 +277,66 @@ 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 head, one of the gauge and sketch rows it changes, then one
+* installation's latest and daily heads, then the gauge and sketch rows it
+* changes and 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
+* the same UTC day only advances its daily observation. An older event 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;
+		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 === NIL_UUID ? "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);
+			}
+		}
 		if (previous !== null && repeatsHead(event, previous)) return;
 		if (event.type !== "UNCHANGED") {
 			tx.create("bundle_events", event);

package/dist/server/schema.cjs

@@ -354,6 +354,71 @@ const insightsDistribution = (retention) => (0, _hot_updater_plugin_core.defineA
 	},
 	retention
 });
+/** The last running bundle observed per installation and UTC day. */
+const bundleDailyHeads = (retention) => (0, _hot_updater_plugin_core.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) => (0, _hot_updater_plugin_core.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) => (0, _hot_updater_plugin_core.defineAggregate)({
 	platform: {
@@ -473,6 +538,8 @@ 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)

package/dist/server/schema.d.cts

@@ -263,6 +263,68 @@ declare const createInsightsSchema: ({ rawDays, dailyDays }?: InsightsRetention)
       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";
@@ -602,6 +664,68 @@ declare const insightsSchema: {
       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";