@hot-updater/aws 1.0.0-rc.29 → 1.0.0-rc.30

package/dist/index.d.cts

@@ -224,9 +224,13 @@ interface ReleaseActivityMetrics {
   readonly failedLaunches: number;
   /** Omitted for lifetime-only bundle-row reads. */
   readonly uniqueUsers?: number;
-  /** Daily points, present only for period reads. */
+  /**
+   * 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;
   }[];
@@ -234,10 +238,17 @@ interface ReleaseActivityMetrics {
 type InsightsGetReleaseActivityInput = {
   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 {
@@ -280,6 +291,23 @@ 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
@@ -621,6 +649,68 @@ 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";
@@ -717,6 +807,7 @@ declare const plugins: readonly [import("@hot-updater/plugin-core").HotUpdaterPl
     countLatestEvents: (input: InsightsCountLatestEventsInput) => Promise<number>;
     countEvents: (input: InsightsCountEventsInput) => Promise<number>;
     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

@@ -224,9 +224,13 @@ interface ReleaseActivityMetrics {
   readonly failedLaunches: number;
   /** Omitted for lifetime-only bundle-row reads. */
   readonly uniqueUsers?: number;
-  /** Daily points, present only for period reads. */
+  /**
+   * 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;
   }[];
@@ -234,10 +238,17 @@ interface ReleaseActivityMetrics {
 type InsightsGetReleaseActivityInput = {
   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 {
@@ -280,6 +291,23 @@ 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
@@ -621,6 +649,68 @@ 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";
@@ -717,6 +807,7 @@ declare const plugins: readonly [import("@hot-updater/plugin-core").HotUpdaterPl
     countLatestEvents: (input: InsightsCountLatestEventsInput) => Promise<number>;
     countEvents: (input: InsightsCountEventsInput) => Promise<number>;
     getReleaseActivity: (input: InsightsGetReleaseActivityInput) => Promise<InsightsGetReleaseActivityResult>;
+    getDistributionHistory: (input: InsightsGetDistributionHistoryInput) => Promise<InsightsGetDistributionHistoryResult>;
     getAppUsage: (input: InsightsGetAppUsageInput) => Promise<InsightsGetAppUsageResult>;
     getUpdateFailures: (input: InsightsUpdateFailuresInput) => Promise<InsightsUpdateFailures>;
   };

package/dist/lambda/index.cjs

@@ -4570,7 +4570,7 @@ const createKvAdapter = ({ store, tablePrefix = "" }) => {
 };
 //#endregion
 //#region ../../packages/server/dist/version.mjs
-const HOT_UPDATER_SERVER_VERSION = "1.0.0-rc.29";
+const HOT_UPDATER_SERVER_VERSION = "1.0.0-rc.30";
 //#endregion
 //#region ../../packages/server/dist/handlerVersionRoutes.mjs
 /**
@@ -9986,19 +9986,40 @@ const createValidatedInsightsModel = (model) => ({
 		if (!isRecord$2(input) || !hasOnlyKeys(input, [
 			"releases",
 			"scope",
-			"timeRange"
+			"timeRange",
+			"intervalMs"
 		])) 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$2(scope) && hasOnlyKeys(scope, ["platform", "channel"]) && hasScope(scope) && isTimeRange(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;
 	},
+	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();
+		}
+		return result;
+	},
 	async getAppUsage(input) {
 		if (!isRecord$2(input) || !hasOnlyKeys(input, [
 			"channel",
@@ -10030,7 +10051,8 @@ const createInsightsModel = (api) => createValidatedInsightsModel({
 	countLatestEvents: api.countLatestEvents,
 	countEvents: api.countEvents,
 	getReleaseActivity: api.getReleaseActivity,
-	getAppUsage: api.getAppUsage
+	getAppUsage: api.getAppUsage,
+	getDistributionHistory: api.getDistributionHistory
 });
 //#endregion
 //#region ../insights/dist/server/official.mjs
@@ -11112,6 +11134,71 @@ 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: {
@@ -11231,6 +11318,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)
@@ -11618,21 +11707,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 === "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);
+			}
+		}
 		if (previous !== null && repeatsHead(event, previous)) return;
 		if (event.type !== "UNCHANGED") {
 			tx.create("bundle_events", event);
@@ -11998,19 +12132,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 {
@@ -12056,7 +12201,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 {
@@ -12322,6 +12467,43 @@ 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;
@@ -12513,6 +12695,7 @@ const createInsightsApi = (db, now, retention) => ({
 	countLatestEvents: (input) => countLatestEvents(db, input),
 	countEvents: (input) => countEvents(db, input),
 	getReleaseActivity: (input) => getReleaseActivity(db, input, now, retention),
+	getDistributionHistory: (input) => getDistributionHistory(db, input, now, retention),
 	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)
@@ -12581,7 +12764,7 @@ const insights = (options = {}) => {
 	const plugin = definePlugin({
 		id: "insights",
 		namespace: false,
-		schemaVersion: "1.2.0",
+		schemaVersion: "1.3.0",
 		schema: createInsightsSchema(retention),
 		init: ({ db, now }) => {
 			const api = createInsightsApi(db, now, retention);
@@ -12596,6 +12779,32 @@ 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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hot-updater/aws",
   "type": "module",
-  "version": "1.0.0-rc.29",
+  "version": "1.0.0-rc.30",
   "description": "React Native OTA solution for self-hosted",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",
@@ -47,7 +47,7 @@
     "mime": "^4.0.4",
     "@hot-updater/protocol": "1.0.0-rc.28",
     "@hot-updater/mock": "1.0.0-rc.28",
-    "@hot-updater/test-utils": "1.0.0-rc.28"
+    "@hot-updater/test-utils": "1.0.0-rc.29"
   },
   "dependencies": {
     "@aws-sdk/client-cloudfront": "3.1066.0",
@@ -62,9 +62,9 @@
     "@aws-sdk/lib-storage": "3.1066.0",
     "@aws-sdk/lib-dynamodb": "3.1066.0",
     "hono": "4.12.34",
-    "@hot-updater/cli-tools": "1.0.0-rc.29",
+    "@hot-updater/cli-tools": "1.0.0-rc.30",
     "@hot-updater/plugin-core": "1.0.0-rc.28",
-    "@hot-updater/server": "1.0.0-rc.29"
+    "@hot-updater/server": "1.0.0-rc.30"
   },
   "scripts": {
     "build": "tsdown",