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

package/dist/client/errorDetails.cjs

@@ -31,4 +31,5 @@ const readErrorDetails = (error) => {
 	};
 };
 //#endregion
+exports.boundedText = boundedText;
 exports.readErrorDetails = readErrorDetails;

package/dist/client/errorDetails.mjs

@@ -31,4 +31,4 @@ const readErrorDetails = (error) => {
 	};
 };
 //#endregion
-export { readErrorDetails };
+export { boundedText, readErrorDetails };

package/dist/client/index.cjs

@@ -46,8 +46,13 @@ const insights = (options = {}) => {
 		const now = context.now();
 		const installId = context.installId;
 		const userId = state.readUserId();
+		const response = state.readHttpResponse(movement.channel, appVersion);
 		const body = {
 			...movement,
+			...response ? { metadata: {
+				...movement.metadata,
+				httpResponse: response
+			} } : {},
 			eventId: eventId?.(now, installId) ?? require_eventId.createUUIDv7(),
 			installId,
 			...userId === null ? {} : { userId },
@@ -176,6 +181,17 @@ const insights = (options = {}) => {
 			failureKey
 		});
 	};
+	const onHttpResponse = (response) => {
+		if (context === null || state === null || context.appVersion === null) return;
+		const body = response.body === null ? null : require_errorDetails.boundedText(response.body, 4096);
+		state.recordHttpResponse(context.getChannel(), context.appVersion, {
+			...response,
+			path: require_errorDetails.boundedText(response.path, 1024),
+			body,
+			bodyTruncated: response.bodyTruncated || body !== response.body,
+			receivedAtMs: context.now()
+		});
+	};
 	const admit = (body) => {
 		const event = pending.get(body);
 		if (event === void 0 || state === null || context === null) return false;
@@ -220,7 +236,8 @@ const insights = (options = {}) => {
 				onAppReady,
 				onUpdateCheck,
 				onBundleDownloaded,
-				onUpdateError
+				onUpdateError,
+				onHttpResponse
 			};
 		},
 		setUser(user) {

package/dist/client/index.mjs

@@ -1,4 +1,4 @@
-import { readErrorDetails } from "./errorDetails.mjs";
+import { boundedText, readErrorDetails } from "./errorDetails.mjs";
 import { createKeyedUUIDv7, createUUIDv7 } from "./eventId.mjs";
 import { createInsightsEventSender } from "./sender.mjs";
 import { createInsightsState, utcDay, utcDayStart } from "./state.mjs";
@@ -45,8 +45,13 @@ const insights = (options = {}) => {
 		const now = context.now();
 		const installId = context.installId;
 		const userId = state.readUserId();
+		const response = state.readHttpResponse(movement.channel, appVersion);
 		const body = {
 			...movement,
+			...response ? { metadata: {
+				...movement.metadata,
+				httpResponse: response
+			} } : {},
 			eventId: eventId?.(now, installId) ?? createUUIDv7(),
 			installId,
 			...userId === null ? {} : { userId },
@@ -175,6 +180,17 @@ const insights = (options = {}) => {
 			failureKey
 		});
 	};
+	const onHttpResponse = (response) => {
+		if (context === null || state === null || context.appVersion === null) return;
+		const body = response.body === null ? null : boundedText(response.body, 4096);
+		state.recordHttpResponse(context.getChannel(), context.appVersion, {
+			...response,
+			path: boundedText(response.path, 1024),
+			body,
+			bodyTruncated: response.bodyTruncated || body !== response.body,
+			receivedAtMs: context.now()
+		});
+	};
 	const admit = (body) => {
 		const event = pending.get(body);
 		if (event === void 0 || state === null || context === null) return false;
@@ -219,7 +235,8 @@ const insights = (options = {}) => {
 				onAppReady,
 				onUpdateCheck,
 				onBundleDownloaded,
-				onUpdateError
+				onUpdateError,
+				onHttpResponse
 			};
 		},
 		setUser(user) {

package/dist/client/state.cjs

@@ -102,6 +102,24 @@ const createInsightsState = (storage) => {
 				keys: [...keys, key].slice(-32)
 			}));
 		},
+		readHttpResponse(channel, appVersion) {
+			try {
+				const saved = JSON.parse(read("httpResponse") ?? "null");
+				if (!isRecord(saved) || saved.channel !== channel || saved.appVersion !== appVersion || !isRecord(saved.response)) return void 0;
+				const response = saved.response;
+				if (response.resource !== "catalog" && response.resource !== "artifact" || typeof response.path !== "string" || response.path.length > 1024 || typeof response.status !== "number" || !Number.isInteger(response.status) || response.status < 100 || response.status > 599 || !isNullableString(response.body) || JSON.stringify(response.body).length > 4096 || typeof response.bodyTruncated !== "boolean" || typeof response.receivedAtMs !== "number" || !Number.isSafeInteger(response.receivedAtMs) || response.receivedAtMs < 0) return void 0;
+				return response;
+			} catch {
+				return;
+			}
+		},
+		recordHttpResponse(channel, appVersion, response) {
+			write("httpResponse", JSON.stringify({
+				channel,
+				appVersion,
+				response
+			}));
+		},
 		readUserId() {
 			try {
 				const user = JSON.parse(read("user") ?? "null");

package/dist/client/state.mjs

@@ -102,6 +102,24 @@ const createInsightsState = (storage) => {
 				keys: [...keys, key].slice(-32)
 			}));
 		},
+		readHttpResponse(channel, appVersion) {
+			try {
+				const saved = JSON.parse(read("httpResponse") ?? "null");
+				if (!isRecord(saved) || saved.channel !== channel || saved.appVersion !== appVersion || !isRecord(saved.response)) return void 0;
+				const response = saved.response;
+				if (response.resource !== "catalog" && response.resource !== "artifact" || typeof response.path !== "string" || response.path.length > 1024 || typeof response.status !== "number" || !Number.isInteger(response.status) || response.status < 100 || response.status > 599 || !isNullableString(response.body) || JSON.stringify(response.body).length > 4096 || typeof response.bodyTruncated !== "boolean" || typeof response.receivedAtMs !== "number" || !Number.isSafeInteger(response.receivedAtMs) || response.receivedAtMs < 0) return void 0;
+				return response;
+			} catch {
+				return;
+			}
+		},
+		recordHttpResponse(channel, appVersion, response) {
+			write("httpResponse", JSON.stringify({
+				channel,
+				appVersion,
+				response
+			}));
+		},
 		readUserId() {
 			try {
 				const user = JSON.parse(read("user") ?? "null");

package/dist/server/contract.cjs

@@ -154,19 +154,40 @@ const createValidatedInsightsModel = (model) => ({
 		if (!require_eventRow.isRecord(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 && require_eventRow.isRecord(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 && require_eventRow.isRecord(scope) && hasOnlyKeys(scope, ["platform", "channel"]) && hasScope(scope) && isTimeRange(timeRange);
 		if (!releaseQuery && !scopeQuery) invalidQuery();
 		const result = await model.getReleaseActivity(input);
 		validateAggregateResult(result);
 		if (!Array.isArray(result.data)) invalidResult();
 		return result;
 	},
+	async getDistributionHistory(input) {
+		if (!require_eventRow.isRecord(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(bundle.appVersion) || bundle.releaseId !== null && !isText(bundle.releaseId) || ![
+				"release",
+				"builtin",
+				"unknown"
+			].includes(bundle.bundleKind) || !isTimestamp(bundle.installations)) invalidResult();
+		}
+		return result;
+	},
 	async getAppUsage(input) {
 		if (!require_eventRow.isRecord(input) || !hasOnlyKeys(input, [
 			"channel",

package/dist/server/contract.mjs

@@ -154,19 +154,40 @@ const createValidatedInsightsModel = (model) => ({
 		if (!isRecord(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(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(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(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(bundle.appVersion) || bundle.releaseId !== null && !isText(bundle.releaseId) || ![
+				"release",
+				"builtin",
+				"unknown"
+			].includes(bundle.bundleKind) || !isTimestamp(bundle.installations)) invalidResult();
+		}
+		return result;
+	},
 	async getAppUsage(input) {
 		if (!isRecord(input) || !hasOnlyKeys(input, [
 			"channel",

package/dist/server/domain.d.cts

@@ -1,5 +1,6 @@
 import { BundleEventFailure, BundleEventFailureReason, BundleEventFailureStage, DatabaseBundleEventMetadata } from "./eventRow.cjs";
 import { InsightsScope } from "./modelTypes.cjs";
+import { UpdateHttpResponse } from "@hot-updater/protocol";
 //#region src/server/domain.d.ts
 /**
  * Where an update failed and why, as a report carries it. Unknown values of
@@ -33,6 +34,9 @@ type CreateBundleEventRequestBase = {
    * server creates the ID, and a retry counts as another report.
    */
   readonly eventId?: string;
+  readonly metadata?: {
+    readonly httpResponse?: InsightsHttpResponse;
+  };
   readonly installId: string;
   readonly toBundleId: string;
   readonly userId?: string;
@@ -94,6 +98,7 @@ type EventHistoryRow = {
   readonly channel: string;
   readonly cohort: string;
   readonly receivedAtMs: number;
+  readonly httpResponse?: InsightsHttpResponse;
   /** `UPDATE_FAILED`: where the update failed and why. */
   readonly failure?: BundleEventFailureInput;
   /** `UPDATE_DOWNLOADED`: how the bundle arrived, when the client said. */
@@ -107,7 +112,11 @@ type InstallationHistoryRow = EventHistoryRow & {
   readonly type: "UPDATE_DOWNLOADED" | "UPDATE_APPLIED" | "RECOVERED" | "UPDATE_FAILED";
   readonly fromBundleId: string;
 };
+type InsightsHttpResponse = UpdateHttpResponse & {
+  readonly receivedAtMs: number;
+};
 type InstallationRow = {
+  readonly httpResponse?: InsightsHttpResponse;
   readonly installId: string;
   readonly userId: string | null;
   readonly lastKnownBundleId: string;
@@ -151,4 +160,4 @@ type ReportingOverview = InsightsScope & {
   };
 };
 //#endregion
-export { ActiveInstallationWindow, BundleEventFailureInput, CreateBundleEventRequest, CreateBundleEventRequestBase, CursorPage, EventCursorPage, EventHistoryRow, InsightsBundleSelection, InsightsCountMeasurement, InstallationHistoryRow, InstallationRow, ReportingOverview };
+export { ActiveInstallationWindow, BundleEventFailureInput, CreateBundleEventRequest, CreateBundleEventRequestBase, CursorPage, EventCursorPage, EventHistoryRow, InsightsBundleSelection, InsightsCountMeasurement, InsightsHttpResponse, InstallationHistoryRow, InstallationRow, ReportingOverview };

package/dist/server/domain.d.mts

@@ -1,5 +1,6 @@
 import { BundleEventFailure, BundleEventFailureReason, BundleEventFailureStage, DatabaseBundleEventMetadata } from "./eventRow.mjs";
 import { InsightsScope } from "./modelTypes.mjs";
+import { UpdateHttpResponse } from "@hot-updater/protocol";
 //#region src/server/domain.d.ts
 /**
  * Where an update failed and why, as a report carries it. Unknown values of
@@ -33,6 +34,9 @@ type CreateBundleEventRequestBase = {
    * server creates the ID, and a retry counts as another report.
    */
   readonly eventId?: string;
+  readonly metadata?: {
+    readonly httpResponse?: InsightsHttpResponse;
+  };
   readonly installId: string;
   readonly toBundleId: string;
   readonly userId?: string;
@@ -94,6 +98,7 @@ type EventHistoryRow = {
   readonly channel: string;
   readonly cohort: string;
   readonly receivedAtMs: number;
+  readonly httpResponse?: InsightsHttpResponse;
   /** `UPDATE_FAILED`: where the update failed and why. */
   readonly failure?: BundleEventFailureInput;
   /** `UPDATE_DOWNLOADED`: how the bundle arrived, when the client said. */
@@ -107,7 +112,11 @@ type InstallationHistoryRow = EventHistoryRow & {
   readonly type: "UPDATE_DOWNLOADED" | "UPDATE_APPLIED" | "RECOVERED" | "UPDATE_FAILED";
   readonly fromBundleId: string;
 };
+type InsightsHttpResponse = UpdateHttpResponse & {
+  readonly receivedAtMs: number;
+};
 type InstallationRow = {
+  readonly httpResponse?: InsightsHttpResponse;
   readonly installId: string;
   readonly userId: string | null;
   readonly lastKnownBundleId: string;
@@ -151,4 +160,4 @@ type ReportingOverview = InsightsScope & {
   };
 };
 //#endregion
-export { ActiveInstallationWindow, BundleEventFailureInput, CreateBundleEventRequest, CreateBundleEventRequestBase, CursorPage, EventCursorPage, EventHistoryRow, InsightsBundleSelection, InsightsCountMeasurement, InstallationHistoryRow, InstallationRow, ReportingOverview };
+export { ActiveInstallationWindow, BundleEventFailureInput, CreateBundleEventRequest, CreateBundleEventRequestBase, CursorPage, EventCursorPage, EventHistoryRow, InsightsBundleSelection, InsightsCountMeasurement, InsightsHttpResponse, InstallationHistoryRow, InstallationRow, ReportingOverview };

package/dist/server/eventInput.cjs

@@ -98,6 +98,17 @@ function readFailure(value) {
 		...previousProcessExit === void 0 ? {} : { previousProcessExit }
 	};
 }
+function readHttpResponse(value) {
+	if (!isRecord(value) || value.resource !== "catalog" && value.resource !== "artifact" || typeof value.path !== "string" || value.path.length > 1024 || !Number.isSafeInteger(value.status) || value.status < 100 || value.status > 599 || value.body !== null && (typeof value.body !== "string" || new TextEncoder().encode(JSON.stringify(value.body)).byteLength > 4096) || typeof value.bodyTruncated !== "boolean" || !Number.isSafeInteger(value.receivedAtMs) || value.receivedAtMs < 0) throw new require_errors.InsightsBadRequestError("Invalid HTTP response details");
+	return {
+		resource: value.resource,
+		path: value.path,
+		status: value.status,
+		body: value.body,
+		bodyTruncated: value.bodyTruncated,
+		receivedAtMs: value.receivedAtMs
+	};
+}
 async function readBoundedText(request) {
 	const contentLength = request.headers.get("content-length");
 	const declaredByteLength = Number(contentLength);
@@ -133,7 +144,10 @@ function requireEvent(payload) {
 	const platform = requireStringField(payload, "platform");
 	if (platform !== "ios" && platform !== "android") throw new require_errors.InsightsBadRequestError("Invalid event field: platform");
 	const eventId = readEventId(payload);
+	const metadata = readMetadata(payload);
+	const httpMetadata = metadata.httpResponse === void 0 ? {} : { httpResponse: readHttpResponse(metadata.httpResponse) };
 	const base = {
+		...metadata.httpResponse === void 0 ? {} : { metadata: httpMetadata },
 		...eventId === void 0 ? {} : { eventId },
 		installId: requireIdentityField(payload, "installId"),
 		toBundleId: requireStringField(payload, "toBundleId"),
@@ -157,11 +171,11 @@ function requireEvent(payload) {
 			updateStrategy
 		};
 	};
-	const metadata = readMetadata(payload);
 	switch (type) {
 		case "UPDATE_DOWNLOADED": {
 			const delivery = metadata.delivery;
 			const read = {
+				...httpMetadata,
 				...delivery == null ? {} : { delivery: oneOf(DELIVERIES, delivery) },
 				...metadata.patchFallback === true ? { patchFallback: true } : {}
 			};
@@ -180,13 +194,19 @@ function requireEvent(payload) {
 			return {
 				...movement(),
 				type,
-				...previousProcessExit === void 0 ? {} : { metadata: { previousProcessExit } }
+				...previousProcessExit === void 0 ? {} : { metadata: {
+					...httpMetadata,
+					previousProcessExit
+				} }
 			};
 		}
 		case "UPDATE_FAILED": return {
 			...movement(),
 			type,
-			metadata: { failure: readFailure(metadata.failure) }
+			metadata: {
+				...httpMetadata,
+				failure: readFailure(metadata.failure)
+			}
 		};
 		case "UNCHANGED":
 			if (payload.fromBundleId !== null || payload.updateStrategy !== null) throw new require_errors.InsightsBadRequestError("Invalid unchanged event shape");
@@ -216,7 +236,16 @@ function createBundleEventRow(input) {
 		to_release_id: input.toReleaseId,
 		user_id: input.userId ?? null
 	};
+	const response = input.metadata?.httpResponse;
 	const metadata = {
+		...response ? { http_response: {
+			resource: response.resource,
+			path: response.path,
+			status: response.status,
+			body: response.body,
+			body_truncated: response.bodyTruncated,
+			received_at_ms: response.receivedAtMs
+		} } : {},
 		cohort: input.cohort,
 		fingerprint_hash: input.fingerprintHash,
 		sdk_version: input.sdkVersion ?? null,

package/dist/server/eventInput.mjs

@@ -98,6 +98,17 @@ function readFailure(value) {
 		...previousProcessExit === void 0 ? {} : { previousProcessExit }
 	};
 }
+function readHttpResponse(value) {
+	if (!isRecord(value) || value.resource !== "catalog" && value.resource !== "artifact" || typeof value.path !== "string" || value.path.length > 1024 || !Number.isSafeInteger(value.status) || value.status < 100 || value.status > 599 || value.body !== null && (typeof value.body !== "string" || new TextEncoder().encode(JSON.stringify(value.body)).byteLength > 4096) || typeof value.bodyTruncated !== "boolean" || !Number.isSafeInteger(value.receivedAtMs) || value.receivedAtMs < 0) throw new InsightsBadRequestError("Invalid HTTP response details");
+	return {
+		resource: value.resource,
+		path: value.path,
+		status: value.status,
+		body: value.body,
+		bodyTruncated: value.bodyTruncated,
+		receivedAtMs: value.receivedAtMs
+	};
+}
 async function readBoundedText(request) {
 	const contentLength = request.headers.get("content-length");
 	const declaredByteLength = Number(contentLength);
@@ -133,7 +144,10 @@ function requireEvent(payload) {
 	const platform = requireStringField(payload, "platform");
 	if (platform !== "ios" && platform !== "android") throw new InsightsBadRequestError("Invalid event field: platform");
 	const eventId = readEventId(payload);
+	const metadata = readMetadata(payload);
+	const httpMetadata = metadata.httpResponse === void 0 ? {} : { httpResponse: readHttpResponse(metadata.httpResponse) };
 	const base = {
+		...metadata.httpResponse === void 0 ? {} : { metadata: httpMetadata },
 		...eventId === void 0 ? {} : { eventId },
 		installId: requireIdentityField(payload, "installId"),
 		toBundleId: requireStringField(payload, "toBundleId"),
@@ -157,11 +171,11 @@ function requireEvent(payload) {
 			updateStrategy
 		};
 	};
-	const metadata = readMetadata(payload);
 	switch (type) {
 		case "UPDATE_DOWNLOADED": {
 			const delivery = metadata.delivery;
 			const read = {
+				...httpMetadata,
 				...delivery == null ? {} : { delivery: oneOf(DELIVERIES, delivery) },
 				...metadata.patchFallback === true ? { patchFallback: true } : {}
 			};
@@ -180,13 +194,19 @@ function requireEvent(payload) {
 			return {
 				...movement(),
 				type,
-				...previousProcessExit === void 0 ? {} : { metadata: { previousProcessExit } }
+				...previousProcessExit === void 0 ? {} : { metadata: {
+					...httpMetadata,
+					previousProcessExit
+				} }
 			};
 		}
 		case "UPDATE_FAILED": return {
 			...movement(),
 			type,
-			metadata: { failure: readFailure(metadata.failure) }
+			metadata: {
+				...httpMetadata,
+				failure: readFailure(metadata.failure)
+			}
 		};
 		case "UNCHANGED":
 			if (payload.fromBundleId !== null || payload.updateStrategy !== null) throw new InsightsBadRequestError("Invalid unchanged event shape");
@@ -216,7 +236,16 @@ function createBundleEventRow(input) {
 		to_release_id: input.toReleaseId,
 		user_id: input.userId ?? null
 	};
+	const response = input.metadata?.httpResponse;
 	const metadata = {
+		...response ? { http_response: {
+			resource: response.resource,
+			path: response.path,
+			status: response.status,
+			body: response.body,
+			body_truncated: response.bodyTruncated,
+			received_at_ms: response.receivedAtMs
+		} } : {},
 		cohort: input.cohort,
 		fingerprint_hash: input.fingerprintHash,
 		sdk_version: input.sdkVersion ?? null,

package/dist/server/eventRow.cjs

@@ -2,9 +2,10 @@ let _hot_updater_plugin_core = require("@hot-updater/plugin-core");
 //#region src/server/eventRow.ts
 const isOptional = (value, key, valid) => !Object.hasOwn(value, key) || valid(value[key]);
 const isString = (value) => typeof value === "string";
+const isDatabaseHttpResponse = (value) => (0, _hot_updater_plugin_core.isDatabaseJsonObject)(value) && (value.resource === "catalog" || value.resource === "artifact") && isString(value.path) && Number.isSafeInteger(value.status) && (value.body === null || isString(value.body)) && typeof value.body_truncated === "boolean" && Number.isSafeInteger(value.received_at_ms);
 /** An `UPDATE_FAILED` report's stored failure: a stage and a reason, and what else the client knew. */
 const isDatabaseBundleEventFailure = (value) => (0, _hot_updater_plugin_core.isDatabaseJsonObject)(value) && isString(value.stage) && isString(value.reason) && isOptional(value, "resource", isString) && isOptional(value, "http_status", (status) => Number.isSafeInteger(status)) && isOptional(value, "transport", isString) && isOptional(value, "origin_code", isString) && isOptional(value, "error_message", isString) && isOptional(value, "error_stack", isString) && isOptional(value, "previous_process_exit", isString);
-const isDatabaseBundleEventMetadata = (value) => (0, _hot_updater_plugin_core.isDatabaseJsonObject)(value) && typeof value.cohort === "string" && (value.update_strategy === null || value.update_strategy === "fingerprint" || value.update_strategy === "appVersion") && (value.fingerprint_hash === null || typeof value.fingerprint_hash === "string") && (value.sdk_version === null || typeof value.sdk_version === "string") && isOptional(value, "failure", isDatabaseBundleEventFailure) && isOptional(value, "delivery", isString) && isOptional(value, "patch_fallback", (flag) => typeof flag === "boolean") && isOptional(value, "previous_process_exit", isString);
+const isDatabaseBundleEventMetadata = (value) => (0, _hot_updater_plugin_core.isDatabaseJsonObject)(value) && typeof value.cohort === "string" && (value.update_strategy === null || value.update_strategy === "fingerprint" || value.update_strategy === "appVersion") && (value.fingerprint_hash === null || typeof value.fingerprint_hash === "string") && (value.sdk_version === null || typeof value.sdk_version === "string") && isOptional(value, "failure", isDatabaseBundleEventFailure) && isOptional(value, "http_response", isDatabaseHttpResponse) && isOptional(value, "delivery", isString) && isOptional(value, "patch_fallback", (flag) => typeof flag === "boolean") && isOptional(value, "previous_process_exit", isString);
 const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 const isIdentity = (value) => typeof value === "string" && value.length > 0 && value.length <= 255;
 const isTextOrNull = (value) => value === null || typeof value === "string";

package/dist/server/eventRow.d.cts

@@ -19,6 +19,14 @@ type BundleEventFailure = DatabaseJsonObject & {
   /** Android's `ApplicationExitInfo` reason for the process before this one. */
   readonly previous_process_exit?: string;
 };
+type DatabaseHttpResponse = DatabaseJsonObject & {
+  readonly resource: "catalog" | "artifact";
+  readonly path: string;
+  readonly status: number;
+  readonly body: string | null;
+  readonly body_truncated: boolean;
+  readonly received_at_ms: number;
+};
 /** Ancillary report data; queryable identity and lifecycle fields stay on the row. */
 type DatabaseBundleEventMetadata = DatabaseJsonObject & {
   readonly cohort: string;
@@ -27,6 +35,7 @@ type DatabaseBundleEventMetadata = DatabaseJsonObject & {
   readonly sdk_version: string | null;
   /** `UPDATE_FAILED`: what failed. */
   readonly failure?: BundleEventFailure;
+  readonly http_response?: DatabaseHttpResponse;
   /** `UPDATE_DOWNLOADED`: how the bundle arrived. */
   readonly delivery?: "patch" | "manifest" | "archive" | "unknown";
   /** `UPDATE_DOWNLOADED`: a patch failed and the full files came instead. */
@@ -63,4 +72,4 @@ type BundleEventRow = BundleEventRowBase & ({
   readonly from_bundle_id: null;
 });
 //#endregion
-export { BundleEventFailure, BundleEventFailureReason, BundleEventFailureStage, BundleEventRow, BundleEventRowBase, DatabaseBundleEventMetadata };
+export { BundleEventFailure, BundleEventFailureReason, BundleEventFailureStage, BundleEventRow, BundleEventRowBase, DatabaseBundleEventMetadata, DatabaseHttpResponse };

package/dist/server/eventRow.d.mts

@@ -19,6 +19,14 @@ type BundleEventFailure = DatabaseJsonObject & {
   /** Android's `ApplicationExitInfo` reason for the process before this one. */
   readonly previous_process_exit?: string;
 };
+type DatabaseHttpResponse = DatabaseJsonObject & {
+  readonly resource: "catalog" | "artifact";
+  readonly path: string;
+  readonly status: number;
+  readonly body: string | null;
+  readonly body_truncated: boolean;
+  readonly received_at_ms: number;
+};
 /** Ancillary report data; queryable identity and lifecycle fields stay on the row. */
 type DatabaseBundleEventMetadata = DatabaseJsonObject & {
   readonly cohort: string;
@@ -27,6 +35,7 @@ type DatabaseBundleEventMetadata = DatabaseJsonObject & {
   readonly sdk_version: string | null;
   /** `UPDATE_FAILED`: what failed. */
   readonly failure?: BundleEventFailure;
+  readonly http_response?: DatabaseHttpResponse;
   /** `UPDATE_DOWNLOADED`: how the bundle arrived. */
   readonly delivery?: "patch" | "manifest" | "archive" | "unknown";
   /** `UPDATE_DOWNLOADED`: a patch failed and the full files came instead. */
@@ -63,4 +72,4 @@ type BundleEventRow = BundleEventRowBase & ({
   readonly from_bundle_id: null;
 });
 //#endregion
-export { BundleEventFailure, BundleEventFailureReason, BundleEventFailureStage, BundleEventRow, BundleEventRowBase, DatabaseBundleEventMetadata };
+export { BundleEventFailure, BundleEventFailureReason, BundleEventFailureStage, BundleEventRow, BundleEventRowBase, DatabaseBundleEventMetadata, DatabaseHttpResponse };

package/dist/server/eventRow.mjs

@@ -2,9 +2,10 @@ import { DatabaseAdapterInputError, isDatabaseJsonObject } from "@hot-updater/pl
 //#region src/server/eventRow.ts
 const isOptional = (value, key, valid) => !Object.hasOwn(value, key) || valid(value[key]);
 const isString = (value) => typeof value === "string";
+const isDatabaseHttpResponse = (value) => isDatabaseJsonObject(value) && (value.resource === "catalog" || value.resource === "artifact") && isString(value.path) && Number.isSafeInteger(value.status) && (value.body === null || isString(value.body)) && typeof value.body_truncated === "boolean" && Number.isSafeInteger(value.received_at_ms);
 /** An `UPDATE_FAILED` report's stored failure: a stage and a reason, and what else the client knew. */
 const isDatabaseBundleEventFailure = (value) => isDatabaseJsonObject(value) && isString(value.stage) && isString(value.reason) && isOptional(value, "resource", isString) && isOptional(value, "http_status", (status) => Number.isSafeInteger(status)) && isOptional(value, "transport", isString) && isOptional(value, "origin_code", isString) && isOptional(value, "error_message", isString) && isOptional(value, "error_stack", isString) && isOptional(value, "previous_process_exit", isString);
-const isDatabaseBundleEventMetadata = (value) => isDatabaseJsonObject(value) && typeof value.cohort === "string" && (value.update_strategy === null || value.update_strategy === "fingerprint" || value.update_strategy === "appVersion") && (value.fingerprint_hash === null || typeof value.fingerprint_hash === "string") && (value.sdk_version === null || typeof value.sdk_version === "string") && isOptional(value, "failure", isDatabaseBundleEventFailure) && isOptional(value, "delivery", isString) && isOptional(value, "patch_fallback", (flag) => typeof flag === "boolean") && isOptional(value, "previous_process_exit", isString);
+const isDatabaseBundleEventMetadata = (value) => isDatabaseJsonObject(value) && typeof value.cohort === "string" && (value.update_strategy === null || value.update_strategy === "fingerprint" || value.update_strategy === "appVersion") && (value.fingerprint_hash === null || typeof value.fingerprint_hash === "string") && (value.sdk_version === null || typeof value.sdk_version === "string") && isOptional(value, "failure", isDatabaseBundleEventFailure) && isOptional(value, "http_response", isDatabaseHttpResponse) && isOptional(value, "delivery", isString) && isOptional(value, "patch_fallback", (flag) => typeof flag === "boolean") && isOptional(value, "previous_process_exit", isString);
 const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 const isIdentity = (value) => typeof value === "string" && value.length > 0 && value.length <= 255;
 const isTextOrNull = (value) => value === null || typeof value === "string";

package/dist/server/index.cjs

@@ -19,6 +19,7 @@ const createInsightsApi = (db, now, retention) => ({
 	countLatestEvents: (input) => require_reads.countLatestEvents(db, input),
 	countEvents: (input) => require_reads.countEvents(db, input),
 	getReleaseActivity: (input) => require_reads.getReleaseActivity(db, input, now, retention),
+	getDistributionHistory: (input) => require_reads.getDistributionHistory(db, input, now, retention),
 	getAppUsage: (input) => require_reads.getAppUsage(db, input, now, retention),
 	/** A release's or a channel's update failures, and their breakdown over a time range. */
 	getUpdateFailures: (input) => require_reads.getUpdateFailures(db, input, now, retention)
@@ -87,7 +88,7 @@ const insights = (options = {}) => {
 	const plugin = (0, _hot_updater_plugin_core.definePlugin)({
 		id: "insights",
 		namespace: false,
-		schemaVersion: "1.2.0",
+		schemaVersion: "1.3.0",
 		schema: require_schema.createInsightsSchema(retention),
 		init: ({ db, now }) => {
 			const api = createInsightsApi(db, now, retention);
@@ -102,6 +103,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 require_model.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 _hot_updater_plugin_core.DatabaseAdapterInputError) return Response.json({ error: "Choose a platform, channel, and up to 31 whole UTC days." }, { status: 400 });
+								if (!(0, _hot_updater_plugin_core.isDatabaseBusyError)(error)) throw error;
+								return Response.json({ error: "Service unavailable" }, {
+									status: 503,
+									headers: { "retry-after": "5" }
+								});
+							}
+						}
+					},
 					{
 						access: "admin",
 						method: "GET",