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

package/dist/server/contract.cjs

@@ -150,42 +150,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 (!require_eventRow.isRecord(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 && 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;
+		]) || !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) => !require_eventRow.isRecord(point) || !hasOnlyKeys(point, ["startMs", "events"]) || point.startMs !== start + index * intervalMs || !isTimestamp(point.events))) invalidResult();
+		return points;
 	},
-	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();
-		}
+	async getReleaseActivity(input) {
+		if (!require_eventRow.isRecord(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 (!require_eventRow.isRecord(result) || !isTimestamp(result.measuredAtMs) || !Array.isArray(result.data) || result.data.some((item) => !require_eventRow.isRecord(item) || !isReleaseReference(item.release) || !require_eventRow.isRecord(item.metrics) || !isTimestamp(item.metrics.downloads) || !isTimestamp(item.metrics.launches) || !isTimestamp(item.metrics.failedLaunches))) invalidResult();
 		return result;
 	},
 	async getAppUsage(input) {

package/dist/server/contract.mjs

@@ -150,42 +150,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(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(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(point) || !hasOnlyKeys(point, ["startMs", "events"]) || point.startMs !== start + index * intervalMs || !isTimestamp(point.events))) invalidResult();
+		return points;
 	},
-	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();
-		}
+	async getReleaseActivity(input) {
+		if (!isRecord(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(result) || !isTimestamp(result.measuredAtMs) || !Array.isArray(result.data) || result.data.some((item) => !isRecord(item) || !isReleaseReference(item.release) || !isRecord(item.metrics) || !isTimestamp(item.metrics.downloads) || !isTimestamp(item.metrics.launches) || !isTimestamp(item.metrics.failedLaunches))) invalidResult();
 		return result;
 	},
 	async getAppUsage(input) {

package/dist/server/index.cjs

@@ -18,8 +18,8 @@ const createInsightsApi = (db, now, retention) => ({
 	findLatestEvents: (input) => require_reads.findLatestEvents(db, input),
 	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),
+	countEventSeries: (input) => require_reads.countEventSeries(db, input),
+	getReleaseActivity: (input) => require_reads.getReleaseActivity(db, input, now),
 	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)
@@ -88,7 +88,7 @@ const insights = (options = {}) => {
 	const plugin = (0, _hot_updater_plugin_core.definePlugin)({
 		id: "insights",
 		namespace: false,
-		schemaVersion: "1.3.0",
+		schemaVersion: "1.2.0",
 		schema: require_schema.createInsightsSchema(retention),
 		init: ({ db, now }) => {
 			const api = createInsightsApi(db, now, retention);
@@ -103,32 +103,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 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",

package/dist/server/index.d.cts

@@ -1,5 +1,5 @@
 import { BundleEventFailure, BundleEventFailureReason, BundleEventFailureStage, BundleEventRow, BundleEventRowBase, DatabaseBundleEventMetadata } from "./eventRow.cjs";
-import { InsightsBundleEventFilter, InsightsCountEventsInput, InsightsCountLatestEventsInput, InsightsCoverage, InsightsEventCursor, InsightsEventFilter, InsightsFindLatestEventsInput, InsightsGetAppUsageInput, InsightsGetAppUsageResult, InsightsGetDistributionHistoryInput, InsightsGetDistributionHistoryResult, InsightsGetReleaseActivityInput, InsightsGetReleaseActivityResult, InsightsListEventsInput, InsightsModel, InsightsRecordEventInput, InsightsScope, InsightsTimeRange, ReleaseActivityMetrics, ReleaseReference } from "./modelTypes.cjs";
+import { InsightsBundleEventFilter, InsightsCountEventSeriesInput, InsightsCountEventsInput, InsightsCountLatestEventsInput, InsightsCoverage, InsightsEventCursor, InsightsEventFilter, InsightsEventSeriesPoint, InsightsFindLatestEventsInput, InsightsGetAppUsageInput, InsightsGetAppUsageResult, InsightsGetReleaseActivityInput, InsightsGetReleaseActivityResult, InsightsListEventsInput, InsightsModel, InsightsRecordEventInput, InsightsScope, InsightsTimeRange, ReleaseActivityMetrics, ReleaseReference } from "./modelTypes.cjs";
 import { DEFAULT_INSIGHTS_RETENTION, InsightsRetention, InsightsSchema, createInsightsSchema, insightsSchema } from "./schema.cjs";
 import { InsightsFailureBreakdown, InsightsUpdateFailures, InsightsUpdateFailuresInput } from "./reads.cjs";
 import { ActiveInstallationWindow, BundleEventFailureInput, CreateBundleEventRequest, CreateBundleEventRequestBase, CursorPage, EventCursorPage, EventHistoryRow, InsightsBundleSelection, InsightsCountMeasurement, InsightsHttpResponse, InstallationHistoryRow, InstallationRow, ReportingOverview } from "./domain.cjs";
@@ -19,8 +19,8 @@ declare const createInsightsApi: (db: HotUpdaterDatabase<InsightsSchema>, now: (
   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>;
   /** A release's or a channel's update failures, and their breakdown over a time range. */
   getUpdateFailures: (input: InsightsUpdateFailuresInput) => Promise<InsightsUpdateFailures>;
@@ -100,10 +100,6 @@ declare const insights: (options?: InsightsOptions) => import("@hot-updater/plug
     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"];
@@ -203,7 +199,7 @@ declare const insights: (options?: InsightsOptions) => import("@hot-updater/plug
       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";
@@ -231,7 +227,7 @@ declare const insights: (options?: InsightsOptions) => import("@hot-updater/plug
       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";
@@ -288,68 +284,6 @@ declare const insights: (options?: InsightsOptions) => import("@hot-updater/plug
       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";
@@ -447,8 +381,8 @@ declare const insights: (options?: InsightsOptions) => import("@hot-updater/plug
     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>;
     /** A release's or a channel's update failures, and their breakdown over a time range. */
     getUpdateFailures: (input: InsightsUpdateFailuresInput) => Promise<InsightsUpdateFailures>;
@@ -456,4 +390,4 @@ declare const insights: (options?: InsightsOptions) => import("@hot-updater/plug
   endpoints: PluginEndpoint[];
 }, {}>;
 //#endregion
-export { type ActiveInstallationWindow, type BundleEventFailure, type BundleEventFailureInput, type BundleEventFailureReason, type BundleEventFailureStage, type BundleEventRow, type BundleEventRowBase, type CreateBundleEventRequest, type CreateBundleEventRequestBase, type CursorPage, DEFAULT_INSIGHTS_RETENTION, type DatabaseBundleEventMetadata, type EventCursorPage, type EventHistoryRow, InsightsApi, InsightsBadRequestError, type InsightsBundleEventFilter, type InsightsBundleSelection, type InsightsCountEventsInput, type InsightsCountLatestEventsInput, type InsightsCountMeasurement, type InsightsCoverage, type InsightsEventCursor, type InsightsEventFilter, type InsightsEventPageInput, type InsightsFailureBreakdown, type InsightsFindLatestEventsInput, type InsightsGetAppUsageInput, type InsightsGetAppUsageResult, type InsightsGetDistributionHistoryInput, type InsightsGetDistributionHistoryResult, type InsightsGetReleaseActivityInput, type InsightsGetReleaseActivityResult, type InsightsHttpResponse, type InsightsIdentityParts, type InsightsInstallationEventPageInput, type InsightsListEventsInput, type InsightsModel, InsightsOptions, type InsightsProvider, type InsightsRecordEventInput, type InsightsRetention, type InsightsSchema, type InsightsScope, type InsightsTimeRange, type InsightsUpdateFailures, type InsightsUpdateFailuresInput, type InsightsUserInstallationPageInput, type InstallationHistoryRow, type InstallationRow, type ReleaseActivityMetrics, type ReleaseReference, type ReportingOverview, createInsightsModel, createInsightsProvider, createInsightsSchema, insights, insightsIdentity, insightsSchema };
+export { type ActiveInstallationWindow, type BundleEventFailure, type BundleEventFailureInput, type BundleEventFailureReason, type BundleEventFailureStage, type BundleEventRow, type BundleEventRowBase, type CreateBundleEventRequest, type CreateBundleEventRequestBase, type CursorPage, DEFAULT_INSIGHTS_RETENTION, type DatabaseBundleEventMetadata, type EventCursorPage, type EventHistoryRow, InsightsApi, InsightsBadRequestError, type InsightsBundleEventFilter, type InsightsBundleSelection, type InsightsCountEventSeriesInput, type InsightsCountEventsInput, type InsightsCountLatestEventsInput, type InsightsCountMeasurement, type InsightsCoverage, type InsightsEventCursor, type InsightsEventFilter, type InsightsEventPageInput, type InsightsEventSeriesPoint, type InsightsFailureBreakdown, type InsightsFindLatestEventsInput, type InsightsGetAppUsageInput, type InsightsGetAppUsageResult, type InsightsGetReleaseActivityInput, type InsightsGetReleaseActivityResult, type InsightsHttpResponse, type InsightsIdentityParts, type InsightsInstallationEventPageInput, type InsightsListEventsInput, type InsightsModel, InsightsOptions, type InsightsProvider, type InsightsRecordEventInput, type InsightsRetention, type InsightsSchema, type InsightsScope, type InsightsTimeRange, type InsightsUpdateFailures, type InsightsUpdateFailuresInput, type InsightsUserInstallationPageInput, type InstallationHistoryRow, type InstallationRow, type ReleaseActivityMetrics, type ReleaseReference, type ReportingOverview, createInsightsModel, createInsightsProvider, createInsightsSchema, insights, insightsIdentity, insightsSchema };

package/dist/server/index.d.mts

@@ -1,5 +1,5 @@
 import { BundleEventFailure, BundleEventFailureReason, BundleEventFailureStage, BundleEventRow, BundleEventRowBase, DatabaseBundleEventMetadata } from "./eventRow.mjs";
-import { InsightsBundleEventFilter, InsightsCountEventsInput, InsightsCountLatestEventsInput, InsightsCoverage, InsightsEventCursor, InsightsEventFilter, InsightsFindLatestEventsInput, InsightsGetAppUsageInput, InsightsGetAppUsageResult, InsightsGetDistributionHistoryInput, InsightsGetDistributionHistoryResult, InsightsGetReleaseActivityInput, InsightsGetReleaseActivityResult, InsightsListEventsInput, InsightsModel, InsightsRecordEventInput, InsightsScope, InsightsTimeRange, ReleaseActivityMetrics, ReleaseReference } from "./modelTypes.mjs";
+import { InsightsBundleEventFilter, InsightsCountEventSeriesInput, InsightsCountEventsInput, InsightsCountLatestEventsInput, InsightsCoverage, InsightsEventCursor, InsightsEventFilter, InsightsEventSeriesPoint, InsightsFindLatestEventsInput, InsightsGetAppUsageInput, InsightsGetAppUsageResult, InsightsGetReleaseActivityInput, InsightsGetReleaseActivityResult, InsightsListEventsInput, InsightsModel, InsightsRecordEventInput, InsightsScope, InsightsTimeRange, ReleaseActivityMetrics, ReleaseReference } from "./modelTypes.mjs";
 import { DEFAULT_INSIGHTS_RETENTION, InsightsRetention, InsightsSchema, createInsightsSchema, insightsSchema } from "./schema.mjs";
 import { InsightsFailureBreakdown, InsightsUpdateFailures, InsightsUpdateFailuresInput } from "./reads.mjs";
 import { ActiveInstallationWindow, BundleEventFailureInput, CreateBundleEventRequest, CreateBundleEventRequestBase, CursorPage, EventCursorPage, EventHistoryRow, InsightsBundleSelection, InsightsCountMeasurement, InsightsHttpResponse, InstallationHistoryRow, InstallationRow, ReportingOverview } from "./domain.mjs";
@@ -19,8 +19,8 @@ declare const createInsightsApi: (db: HotUpdaterDatabase<InsightsSchema>, now: (
   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>;
   /** A release's or a channel's update failures, and their breakdown over a time range. */
   getUpdateFailures: (input: InsightsUpdateFailuresInput) => Promise<InsightsUpdateFailures>;
@@ -100,10 +100,6 @@ declare const insights: (options?: InsightsOptions) => import("@hot-updater/plug
     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"];
@@ -203,7 +199,7 @@ declare const insights: (options?: InsightsOptions) => import("@hot-updater/plug
       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";
@@ -231,7 +227,7 @@ declare const insights: (options?: InsightsOptions) => import("@hot-updater/plug
       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";
@@ -288,68 +284,6 @@ declare const insights: (options?: InsightsOptions) => import("@hot-updater/plug
       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";
@@ -447,8 +381,8 @@ declare const insights: (options?: InsightsOptions) => import("@hot-updater/plug
     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>;
     /** A release's or a channel's update failures, and their breakdown over a time range. */
     getUpdateFailures: (input: InsightsUpdateFailuresInput) => Promise<InsightsUpdateFailures>;
@@ -456,4 +390,4 @@ declare const insights: (options?: InsightsOptions) => import("@hot-updater/plug
   endpoints: PluginEndpoint[];
 }, {}>;
 //#endregion
-export { type ActiveInstallationWindow, type BundleEventFailure, type BundleEventFailureInput, type BundleEventFailureReason, type BundleEventFailureStage, type BundleEventRow, type BundleEventRowBase, type CreateBundleEventRequest, type CreateBundleEventRequestBase, type CursorPage, DEFAULT_INSIGHTS_RETENTION, type DatabaseBundleEventMetadata, type EventCursorPage, type EventHistoryRow, InsightsApi, InsightsBadRequestError, type InsightsBundleEventFilter, type InsightsBundleSelection, type InsightsCountEventsInput, type InsightsCountLatestEventsInput, type InsightsCountMeasurement, type InsightsCoverage, type InsightsEventCursor, type InsightsEventFilter, type InsightsEventPageInput, type InsightsFailureBreakdown, type InsightsFindLatestEventsInput, type InsightsGetAppUsageInput, type InsightsGetAppUsageResult, type InsightsGetDistributionHistoryInput, type InsightsGetDistributionHistoryResult, type InsightsGetReleaseActivityInput, type InsightsGetReleaseActivityResult, type InsightsHttpResponse, type InsightsIdentityParts, type InsightsInstallationEventPageInput, type InsightsListEventsInput, type InsightsModel, InsightsOptions, type InsightsProvider, type InsightsRecordEventInput, type InsightsRetention, type InsightsSchema, type InsightsScope, type InsightsTimeRange, type InsightsUpdateFailures, type InsightsUpdateFailuresInput, type InsightsUserInstallationPageInput, type InstallationHistoryRow, type InstallationRow, type ReleaseActivityMetrics, type ReleaseReference, type ReportingOverview, createInsightsModel, createInsightsProvider, createInsightsSchema, insights, insightsIdentity, insightsSchema };
+export { type ActiveInstallationWindow, type BundleEventFailure, type BundleEventFailureInput, type BundleEventFailureReason, type BundleEventFailureStage, type BundleEventRow, type BundleEventRowBase, type CreateBundleEventRequest, type CreateBundleEventRequestBase, type CursorPage, DEFAULT_INSIGHTS_RETENTION, type DatabaseBundleEventMetadata, type EventCursorPage, type EventHistoryRow, InsightsApi, InsightsBadRequestError, type InsightsBundleEventFilter, type InsightsBundleSelection, type InsightsCountEventSeriesInput, type InsightsCountEventsInput, type InsightsCountLatestEventsInput, type InsightsCountMeasurement, type InsightsCoverage, type InsightsEventCursor, type InsightsEventFilter, type InsightsEventPageInput, type InsightsEventSeriesPoint, type InsightsFailureBreakdown, type InsightsFindLatestEventsInput, type InsightsGetAppUsageInput, type InsightsGetAppUsageResult, type InsightsGetReleaseActivityInput, type InsightsGetReleaseActivityResult, type InsightsHttpResponse, type InsightsIdentityParts, type InsightsInstallationEventPageInput, type InsightsListEventsInput, type InsightsModel, InsightsOptions, type InsightsProvider, type InsightsRecordEventInput, type InsightsRetention, type InsightsSchema, type InsightsScope, type InsightsTimeRange, type InsightsUpdateFailures, type InsightsUpdateFailuresInput, type InsightsUserInstallationPageInput, type InstallationHistoryRow, type InstallationRow, type ReleaseActivityMetrics, type ReleaseReference, type ReportingOverview, createInsightsModel, createInsightsProvider, createInsightsSchema, insights, insightsIdentity, insightsSchema };

package/dist/server/index.mjs

@@ -4,7 +4,7 @@ import { InsightsBadRequestError } from "./errors.mjs";
 import { createInsightsProvider } from "./provider.mjs";
 import { DEFAULT_INSIGHTS_RETENTION, createInsightsSchema, insightsSchema } from "./schema.mjs";
 import { insightsIdentity, recordEvent } from "./recordEvent.mjs";
-import { countEvents, countLatestEvents, findLatestEvents, getAppUsage, getDistributionHistory, getReleaseActivity, getUpdateFailures, listEvents } from "./reads.mjs";
+import { countEventSeries, countEvents, countLatestEvents, findLatestEvents, getAppUsage, getReleaseActivity, getUpdateFailures, listEvents } from "./reads.mjs";
 import { INSIGHTS_ROUTES, createInsightsRouteHandlers } from "./routes.mjs";
 import { DatabaseAdapterInputError, HotUpdaterConfigError, definePlugin, isDatabaseBusyError } from "@hot-updater/plugin-core";
 //#region src/server/index.ts
@@ -17,8 +17,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)
@@ -87,7 +87,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);
@@ -102,32 +102,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/server/model.cjs

@@ -10,9 +10,9 @@ const createInsightsModel = (api) => require_contract.createValidatedInsightsMod
 	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
 exports.createInsightsModel = createInsightsModel;

package/dist/server/model.mjs

@@ -10,9 +10,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
 export { createInsightsModel };

package/dist/server/modelTypes.d.cts

@@ -59,6 +59,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";
@@ -77,44 +90,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;
@@ -150,23 +141,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;
-    }[];
-  }[];
-}
 interface InsightsModel {
   /**
    * Persist the immutable event once. A private latest-event index, if used,
@@ -195,12 +169,15 @@ interface InsightsModel {
   countLatestEvents(input: InsightsCountLatestEventsInput): Promise<number>;
   /** Count accepted reports in [sinceMs, beforeReceivedAtMs), across all pages. */
   countEvents(input: InsightsCountEventsInput): Promise<number>;
-  /** Read maintained release/scope summaries without scanning raw events. */
+  /**
+   * A bundle filter's stored events in each interval, every interval
+   * present in order, from the hourly counts that `countEvents` reads.
+   */
+  countEventSeries(input: InsightsCountEventSeriesInput): Promise<readonly InsightsEventSeriesPoint[]>;
+  /** Releases' lifetime counters, without scanning raw events. */
   getReleaseActivity(input: InsightsGetReleaseActivityInput): Promise<InsightsGetReleaseActivityResult>;
-  /** Daily last-observed running bundles, one per reporting installation. No historical backfill. */
-  getDistributionHistory(input: InsightsGetDistributionHistoryInput): Promise<InsightsGetDistributionHistoryResult>;
   /** Read maintained App usage summaries and latest-report distribution. */
   getAppUsage(input: InsightsGetAppUsageInput): Promise<InsightsGetAppUsageResult>;
 }
 //#endregion
-export { InsightsBundleEventFilter, InsightsCountEventsInput, InsightsCountLatestEventsInput, InsightsCoverage, InsightsEventCursor, InsightsEventFilter, InsightsFindLatestEventsInput, InsightsGetAppUsageInput, InsightsGetAppUsageResult, InsightsGetDistributionHistoryInput, InsightsGetDistributionHistoryResult, InsightsGetReleaseActivityInput, InsightsGetReleaseActivityResult, InsightsListEventsInput, InsightsModel, InsightsRecordEventInput, InsightsScope, InsightsTimeRange, ReleaseActivityMetrics, ReleaseReference };
+export { InsightsBundleEventFilter, InsightsCountEventSeriesInput, InsightsCountEventsInput, InsightsCountLatestEventsInput, InsightsCoverage, InsightsEventCursor, InsightsEventFilter, InsightsEventSeriesPoint, InsightsFindLatestEventsInput, InsightsGetAppUsageInput, InsightsGetAppUsageResult, InsightsGetReleaseActivityInput, InsightsGetReleaseActivityResult, InsightsListEventsInput, InsightsModel, InsightsRecordEventInput, InsightsScope, InsightsTimeRange, ReleaseActivityMetrics, ReleaseReference };