@hot-updater/plugin-insights 1.0.0-rc.36 → 1.0.0-rc.37

package/dist/server/contract.cjs

@@ -1,4 +1,5 @@
 const require_eventRow = require("./eventRow.cjs");
+const require_schema = require("./schema.cjs");
 let _hot_updater_plugin_core = require("@hot-updater/plugin-core");
 //#region src/server/contract.ts
 const encoder = new TextEncoder();
@@ -30,7 +31,7 @@ const isBundleFilter = (value, withKind = false) => {
 		"type",
 		...withKind ? ["kind"] : []
 	];
-	return value.type === "RECOVERED" ? isText(value.fromBundleId) && hasOnlyKeys(value, [...keys, "fromBundleId"]) : (value.type === "UPDATE_DOWNLOADED" || value.type === "UPDATE_APPLIED" || value.type === "UPDATE_FAILED") && isText(value.toBundleId) && hasOnlyKeys(value, [...keys, "toBundleId"]);
+	return value.type === "RECOVERED" ? isText(value.fromBundleId) && hasOnlyKeys(value, [...keys, "fromBundleId"]) : (value.type === "UPDATE_DOWNLOADED" || value.type === "UPDATE_APPLIED" || value.type === "UPDATE_FAILED" || value.type === "UNCHANGED") && isText(value.toBundleId) && hasOnlyKeys(value, [...keys, "toBundleId"]);
 };
 const isEventFilter = (value) => {
 	if (!require_eventRow.isRecord(value)) return false;
@@ -49,12 +50,15 @@ const validateRow = (model, row, result = false) => {
 };
 /** Throws `invalid-data` unless `row` is a complete, well-formed bundle event row. */
 const assertBundleEventRow = (row) => validateRow("bundle_events", row);
-/** Downloads, applies, recoveries, and failed updates belong in installation history. */
-const isInsightsMovementEvent = (event) => event.type === "UPDATE_DOWNLOADED" || event.type === "UPDATE_APPLIED" || event.type === "RECOVERED" || event.type === "UPDATE_FAILED";
+/**
+* Downloads, applies, recoveries, failed updates, and the UNCHANGED rows
+* kept for a change belong in installation history.
+*/
+const isInsightsMovementEvent = (event) => event.type === "UPDATE_DOWNLOADED" || event.type === "UPDATE_APPLIED" || event.type === "RECOVERED" || event.type === "UPDATE_FAILED" || event.type === "UNCHANGED";
 const matchesInsightsEventFilter = (event, filter) => {
 	if (filter.kind === "all") return true;
 	if (filter.kind === "installationMovement") return event.install_id === filter.installId && isInsightsMovementEvent(event);
-	return event.type === filter.type && event.platform === filter.platform && event.channel === filter.channel && (filter.type === "RECOVERED" ? event.from_bundle_id === filter.fromBundleId : event.to_bundle_id === filter.toBundleId && event.metadata.failure?.stage !== "check");
+	return event.type === filter.type && event.platform === filter.platform && event.channel === filter.channel && require_schema.bundleRefsOf(event).includes(require_schema.bundleRefOfFilter(filter));
 };
 const invalidQuery = () => {
 	throw new _hot_updater_plugin_core.DatabaseAdapterInputError("invalid-query");

package/dist/server/contract.mjs

@@ -1,4 +1,5 @@
 import { isRecord, validateBundleEventFields } from "./eventRow.mjs";
+import { bundleRefOfFilter, bundleRefsOf } from "./schema.mjs";
 import { DatabaseAdapterInputError, isUUIDv7 } from "@hot-updater/plugin-core";
 //#region src/server/contract.ts
 const encoder = new TextEncoder();
@@ -30,7 +31,7 @@ const isBundleFilter = (value, withKind = false) => {
 		"type",
 		...withKind ? ["kind"] : []
 	];
-	return value.type === "RECOVERED" ? isText(value.fromBundleId) && hasOnlyKeys(value, [...keys, "fromBundleId"]) : (value.type === "UPDATE_DOWNLOADED" || value.type === "UPDATE_APPLIED" || value.type === "UPDATE_FAILED") && isText(value.toBundleId) && hasOnlyKeys(value, [...keys, "toBundleId"]);
+	return value.type === "RECOVERED" ? isText(value.fromBundleId) && hasOnlyKeys(value, [...keys, "fromBundleId"]) : (value.type === "UPDATE_DOWNLOADED" || value.type === "UPDATE_APPLIED" || value.type === "UPDATE_FAILED" || value.type === "UNCHANGED") && isText(value.toBundleId) && hasOnlyKeys(value, [...keys, "toBundleId"]);
 };
 const isEventFilter = (value) => {
 	if (!isRecord(value)) return false;
@@ -49,12 +50,15 @@ const validateRow = (model, row, result = false) => {
 };
 /** Throws `invalid-data` unless `row` is a complete, well-formed bundle event row. */
 const assertBundleEventRow = (row) => validateRow("bundle_events", row);
-/** Downloads, applies, recoveries, and failed updates belong in installation history. */
-const isInsightsMovementEvent = (event) => event.type === "UPDATE_DOWNLOADED" || event.type === "UPDATE_APPLIED" || event.type === "RECOVERED" || event.type === "UPDATE_FAILED";
+/**
+* Downloads, applies, recoveries, failed updates, and the UNCHANGED rows
+* kept for a change belong in installation history.
+*/
+const isInsightsMovementEvent = (event) => event.type === "UPDATE_DOWNLOADED" || event.type === "UPDATE_APPLIED" || event.type === "RECOVERED" || event.type === "UPDATE_FAILED" || event.type === "UNCHANGED";
 const matchesInsightsEventFilter = (event, filter) => {
 	if (filter.kind === "all") return true;
 	if (filter.kind === "installationMovement") return event.install_id === filter.installId && isInsightsMovementEvent(event);
-	return event.type === filter.type && event.platform === filter.platform && event.channel === filter.channel && (filter.type === "RECOVERED" ? event.from_bundle_id === filter.fromBundleId : event.to_bundle_id === filter.toBundleId && event.metadata.failure?.stage !== "check");
+	return event.type === filter.type && event.platform === filter.platform && event.channel === filter.channel && bundleRefsOf(event).includes(bundleRefOfFilter(filter));
 };
 const invalidQuery = () => {
 	throw new DatabaseAdapterInputError("invalid-query");

package/dist/server/domain.d.cts

@@ -1,4 +1,4 @@
-import { BundleEventFailure, BundleEventFailureReason, BundleEventFailureStage, DatabaseBundleEventMetadata } from "./eventRow.cjs";
+import { BundleEventChangeKind, BundleEventFailure, BundleEventFailureReason, BundleEventFailureStage, DatabaseBundleEventMetadata } from "./eventRow.cjs";
 import { InsightsScope } from "./modelTypes.cjs";
 import { UpdateHttpResponse } from "@hot-updater/protocol";
 //#region src/server/domain.d.ts
@@ -82,6 +82,22 @@ type CreateBundleEventRequest = (Movement & {
   readonly updateStrategy: null;
 });
 type ActiveInstallationWindow = "24h" | "7d" | "30d";
+/**
+ * What a kept UNCHANGED report changed against its installation's previous
+ * report: the running bundle or release, the app version, or the channel,
+ * with the previous values; `first_seen` alone for an installation's first
+ * report to this server.
+ */
+type EventHistoryChange = {
+  readonly kinds: readonly BundleEventChangeKind[];
+  readonly previous?: {
+    readonly bundleId: string;
+    readonly releaseId: string | null;
+    readonly appVersion: string;
+    readonly channel: string;
+    readonly minBundleId?: string;
+  };
+};
 type EventHistoryRow = {
   readonly toReleaseId?: string;
   readonly sdkVersion?: string;
@@ -105,11 +121,21 @@ type EventHistoryRow = {
   readonly delivery?: NonNullable<DatabaseBundleEventMetadata["delivery"]>;
   /** `UPDATE_DOWNLOADED`: a patch failed, and the files or the archive came instead. */
   readonly patchFallback?: true;
+  /** `UNCHANGED`: what the report changed, the reason it was kept. */
+  readonly change?: EventHistoryChange;
+  /** A download or apply that arrived after its target already ran: it counted nothing. */
+  readonly late?: true;
+  /** A launch or crash whose download report never arrived, counted with it. */
+  readonly impliedDownload?: true;
 };
-type InstallationHistoryRow = EventHistoryRow & {
+type InstallationHistoryRow = EventHistoryRow & ({
   readonly type: "UPDATE_DOWNLOADED" | "UPDATE_APPLIED" | "RECOVERED" | "UPDATE_FAILED";
   readonly fromBundleId: string;
-};
+} | {
+  readonly type: "UNCHANGED";
+  readonly fromBundleId: null;
+  readonly change: EventHistoryChange;
+});
 type InsightsHttpResponse = UpdateHttpResponse & {
   readonly receivedAtMs: number;
 };
@@ -160,4 +186,4 @@ type ReportingOverview = InsightsScope & {
   };
 };
 //#endregion
-export { ActiveInstallationWindow, BundleEventFailureInput, CreateBundleEventRequest, CreateBundleEventRequestBase, CursorPage, EventCursorPage, EventHistoryRow, InsightsBundleSelection, InsightsCountMeasurement, InsightsHttpResponse, InstallationHistoryRow, InstallationRow, ReportingOverview };
+export { ActiveInstallationWindow, BundleEventFailureInput, CreateBundleEventRequest, CreateBundleEventRequestBase, CursorPage, EventCursorPage, EventHistoryChange, EventHistoryRow, InsightsBundleSelection, InsightsCountMeasurement, InsightsHttpResponse, InstallationHistoryRow, InstallationRow, ReportingOverview };

package/dist/server/domain.d.mts

@@ -1,4 +1,4 @@
-import { BundleEventFailure, BundleEventFailureReason, BundleEventFailureStage, DatabaseBundleEventMetadata } from "./eventRow.mjs";
+import { BundleEventChangeKind, BundleEventFailure, BundleEventFailureReason, BundleEventFailureStage, DatabaseBundleEventMetadata } from "./eventRow.mjs";
 import { InsightsScope } from "./modelTypes.mjs";
 import { UpdateHttpResponse } from "@hot-updater/protocol";
 //#region src/server/domain.d.ts
@@ -82,6 +82,22 @@ type CreateBundleEventRequest = (Movement & {
   readonly updateStrategy: null;
 });
 type ActiveInstallationWindow = "24h" | "7d" | "30d";
+/**
+ * What a kept UNCHANGED report changed against its installation's previous
+ * report: the running bundle or release, the app version, or the channel,
+ * with the previous values; `first_seen` alone for an installation's first
+ * report to this server.
+ */
+type EventHistoryChange = {
+  readonly kinds: readonly BundleEventChangeKind[];
+  readonly previous?: {
+    readonly bundleId: string;
+    readonly releaseId: string | null;
+    readonly appVersion: string;
+    readonly channel: string;
+    readonly minBundleId?: string;
+  };
+};
 type EventHistoryRow = {
   readonly toReleaseId?: string;
   readonly sdkVersion?: string;
@@ -105,11 +121,21 @@ type EventHistoryRow = {
   readonly delivery?: NonNullable<DatabaseBundleEventMetadata["delivery"]>;
   /** `UPDATE_DOWNLOADED`: a patch failed, and the files or the archive came instead. */
   readonly patchFallback?: true;
+  /** `UNCHANGED`: what the report changed, the reason it was kept. */
+  readonly change?: EventHistoryChange;
+  /** A download or apply that arrived after its target already ran: it counted nothing. */
+  readonly late?: true;
+  /** A launch or crash whose download report never arrived, counted with it. */
+  readonly impliedDownload?: true;
 };
-type InstallationHistoryRow = EventHistoryRow & {
+type InstallationHistoryRow = EventHistoryRow & ({
   readonly type: "UPDATE_DOWNLOADED" | "UPDATE_APPLIED" | "RECOVERED" | "UPDATE_FAILED";
   readonly fromBundleId: string;
-};
+} | {
+  readonly type: "UNCHANGED";
+  readonly fromBundleId: null;
+  readonly change: EventHistoryChange;
+});
 type InsightsHttpResponse = UpdateHttpResponse & {
   readonly receivedAtMs: number;
 };
@@ -160,4 +186,4 @@ type ReportingOverview = InsightsScope & {
   };
 };
 //#endregion
-export { ActiveInstallationWindow, BundleEventFailureInput, CreateBundleEventRequest, CreateBundleEventRequestBase, CursorPage, EventCursorPage, EventHistoryRow, InsightsBundleSelection, InsightsCountMeasurement, InsightsHttpResponse, InstallationHistoryRow, InstallationRow, ReportingOverview };
+export { ActiveInstallationWindow, BundleEventFailureInput, CreateBundleEventRequest, CreateBundleEventRequestBase, CursorPage, EventCursorPage, EventHistoryChange, EventHistoryRow, InsightsBundleSelection, InsightsCountMeasurement, InsightsHttpResponse, InstallationHistoryRow, InstallationRow, ReportingOverview };

package/dist/server/eventRow.cjs

@@ -1,11 +1,20 @@
 let _hot_updater_plugin_core = require("@hot-updater/plugin-core");
 //#region src/server/eventRow.ts
+const CHANGE_KINDS = /* @__PURE__ */ new Set([
+	"first_seen",
+	"bundle",
+	"release",
+	"app_version",
+	"channel",
+	"native_build"
+]);
+const isBundleEventChange = (value) => (0, _hot_updater_plugin_core.isDatabaseJsonObject)(value) && Array.isArray(value.kinds) && value.kinds.length > 0 && value.kinds.every((kind) => CHANGE_KINDS.has(kind)) && (value.previous === null || (0, _hot_updater_plugin_core.isDatabaseJsonObject)(value.previous) && typeof value.previous.bundle_id === "string" && (value.previous.release_id === null || typeof value.previous.release_id === "string") && typeof value.previous.app_version === "string" && typeof value.previous.channel === "string" && isOptional(value.previous, "min_bundle_id", isString));
 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);
-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, "min_bundle_id", isString) && isOptional(value, "failure", isDatabaseBundleEventFailure) && isOptional(value, "http_response", isDatabaseHttpResponse) && isOptional(value, "delivery", isString) && isOptional(value, "patch_fallback", (flag) => typeof flag === "boolean");
+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, "min_bundle_id", isString) && isOptional(value, "failure", isDatabaseBundleEventFailure) && isOptional(value, "http_response", isDatabaseHttpResponse) && isOptional(value, "delivery", isString) && isOptional(value, "patch_fallback", (flag) => typeof flag === "boolean") && isOptional(value, "change", isBundleEventChange) && isOptional(value, "late", (flag) => flag === true) && isOptional(value, "implied_download", (flag) => flag === true);
 const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 /**
 * The built-in bundle a report says its installation runs: the running
@@ -36,13 +45,14 @@ const BUNDLE_EVENT_FIELDS = {
 	metadata: isDatabaseBundleEventMetadata,
 	received_at_ms: (value) => typeof value === "number" && Number.isSafeInteger(value) && value >= 0
 };
+const hasMetadata = (row, key) => isRecord(row.metadata) && Object.hasOwn(row.metadata, key);
 const updateStrategyOf = (row) => isRecord(row.metadata) ? row.metadata.update_strategy : void 0;
 /**
 * A movement, or a failed update, names the bundle it left and how the
 * device updates, and a failed update says what failed; an unchanged report
 * names neither.
 */
-const hasEventInvariants = (row) => (row.type === "UPDATE_DOWNLOADED" || row.type === "UPDATE_APPLIED" || row.type === "RECOVERED" || row.type === "UPDATE_FAILED") && typeof row.from_bundle_id === "string" && (updateStrategyOf(row) === "fingerprint" || updateStrategyOf(row) === "appVersion") && (row.type !== "UPDATE_FAILED" || isRecord(row.metadata) && isRecord(row.metadata.failure)) || row.type === "UNCHANGED" && row.from_bundle_id === null && updateStrategyOf(row) === null;
+const hasEventInvariants = (row) => (row.type === "UPDATE_DOWNLOADED" || row.type === "UPDATE_APPLIED" || row.type === "RECOVERED" || row.type === "UPDATE_FAILED") && typeof row.from_bundle_id === "string" && (updateStrategyOf(row) === "fingerprint" || updateStrategyOf(row) === "appVersion") && (row.type !== "UPDATE_FAILED" || isRecord(row.metadata) && isRecord(row.metadata.failure)) && !hasMetadata(row, "change") && (!hasMetadata(row, "late") || row.type === "UPDATE_DOWNLOADED" || row.type === "UPDATE_APPLIED") && (!hasMetadata(row, "implied_download") || row.type === "UPDATE_APPLIED" || row.type === "RECOVERED") || row.type === "UNCHANGED" && !hasMetadata(row, "late") && row.from_bundle_id === null && updateStrategyOf(row) === null;
 /**
 * Throws unless `row` has exactly the bundle event fields, each of its type,
 * and the invariants of its event type: `invalid-field` for an unknown field,

package/dist/server/eventRow.d.cts

@@ -25,6 +25,25 @@ type DatabaseHttpResponse = DatabaseJsonObject & {
   readonly body_truncated: boolean;
   readonly received_at_ms: number;
 };
+/** What a kept UNCHANGED row changed against its installation's head. */
+type BundleEventChangeKind = "first_seen" | "bundle" | "release" | "app_version" | "channel" | "native_build";
+/**
+ * An UNCHANGED report the server keeps: what it changed against its
+ * installation's head, and the running values the head held before it. A
+ * report from an installation without a head is `first_seen` alone, with no
+ * previous values: the installation is new to this server, not necessarily
+ * to its device.
+ */
+type BundleEventChange = DatabaseJsonObject & {
+  readonly kinds: BundleEventChangeKind[];
+  readonly previous: (DatabaseJsonObject & {
+    readonly bundle_id: string;
+    readonly release_id: string | null;
+    readonly app_version: string;
+    readonly channel: string;
+    readonly min_bundle_id?: string;
+  }) | null;
+};
 /** Ancillary report data; queryable identity and lifecycle fields stay on the row. */
 type DatabaseBundleEventMetadata = DatabaseJsonObject & {
   readonly cohort: string;
@@ -40,6 +59,19 @@ type DatabaseBundleEventMetadata = DatabaseJsonObject & {
   readonly delivery?: "patch" | "manifest" | "archive" | "unknown";
   /** `UPDATE_DOWNLOADED`: a patch failed and the full files came instead. */
   readonly patch_fallback?: boolean;
+  /** A kept `UNCHANGED` row: what it changed, which the server sets. */
+  readonly change?: BundleEventChange;
+  /**
+   * A download or apply that arrived after its installation already ran its
+   * target, as when a reload cut the first runtime's report short: the
+   * server keeps it in history, but it moves and counts nothing.
+   */
+  readonly late?: true;
+  /**
+   * A launch or crash of a bundle whose download report never arrived: the
+   * server counted that download with it.
+   */
+  readonly implied_download?: true;
 };
 type BundleEventRowBase = {
   readonly id: string;
@@ -70,4 +102,4 @@ type BundleEventRow = BundleEventRowBase & ({
   readonly from_bundle_id: null;
 });
 //#endregion
-export { BundleEventFailure, BundleEventFailureReason, BundleEventFailureStage, BundleEventRow, BundleEventRowBase, DatabaseBundleEventMetadata, DatabaseHttpResponse };
+export { BundleEventChange, BundleEventChangeKind, BundleEventFailure, BundleEventFailureReason, BundleEventFailureStage, BundleEventRow, BundleEventRowBase, DatabaseBundleEventMetadata, DatabaseHttpResponse };

package/dist/server/eventRow.d.mts

@@ -25,6 +25,25 @@ type DatabaseHttpResponse = DatabaseJsonObject & {
   readonly body_truncated: boolean;
   readonly received_at_ms: number;
 };
+/** What a kept UNCHANGED row changed against its installation's head. */
+type BundleEventChangeKind = "first_seen" | "bundle" | "release" | "app_version" | "channel" | "native_build";
+/**
+ * An UNCHANGED report the server keeps: what it changed against its
+ * installation's head, and the running values the head held before it. A
+ * report from an installation without a head is `first_seen` alone, with no
+ * previous values: the installation is new to this server, not necessarily
+ * to its device.
+ */
+type BundleEventChange = DatabaseJsonObject & {
+  readonly kinds: BundleEventChangeKind[];
+  readonly previous: (DatabaseJsonObject & {
+    readonly bundle_id: string;
+    readonly release_id: string | null;
+    readonly app_version: string;
+    readonly channel: string;
+    readonly min_bundle_id?: string;
+  }) | null;
+};
 /** Ancillary report data; queryable identity and lifecycle fields stay on the row. */
 type DatabaseBundleEventMetadata = DatabaseJsonObject & {
   readonly cohort: string;
@@ -40,6 +59,19 @@ type DatabaseBundleEventMetadata = DatabaseJsonObject & {
   readonly delivery?: "patch" | "manifest" | "archive" | "unknown";
   /** `UPDATE_DOWNLOADED`: a patch failed and the full files came instead. */
   readonly patch_fallback?: boolean;
+  /** A kept `UNCHANGED` row: what it changed, which the server sets. */
+  readonly change?: BundleEventChange;
+  /**
+   * A download or apply that arrived after its installation already ran its
+   * target, as when a reload cut the first runtime's report short: the
+   * server keeps it in history, but it moves and counts nothing.
+   */
+  readonly late?: true;
+  /**
+   * A launch or crash of a bundle whose download report never arrived: the
+   * server counted that download with it.
+   */
+  readonly implied_download?: true;
 };
 type BundleEventRowBase = {
   readonly id: string;
@@ -70,4 +102,4 @@ type BundleEventRow = BundleEventRowBase & ({
   readonly from_bundle_id: null;
 });
 //#endregion
-export { BundleEventFailure, BundleEventFailureReason, BundleEventFailureStage, BundleEventRow, BundleEventRowBase, DatabaseBundleEventMetadata, DatabaseHttpResponse };
+export { BundleEventChange, BundleEventChangeKind, BundleEventFailure, BundleEventFailureReason, BundleEventFailureStage, BundleEventRow, BundleEventRowBase, DatabaseBundleEventMetadata, DatabaseHttpResponse };

package/dist/server/eventRow.mjs

@@ -1,11 +1,20 @@
 import { DatabaseAdapterInputError, isDatabaseJsonObject } from "@hot-updater/plugin-core";
 //#region src/server/eventRow.ts
+const CHANGE_KINDS = /* @__PURE__ */ new Set([
+	"first_seen",
+	"bundle",
+	"release",
+	"app_version",
+	"channel",
+	"native_build"
+]);
+const isBundleEventChange = (value) => isDatabaseJsonObject(value) && Array.isArray(value.kinds) && value.kinds.length > 0 && value.kinds.every((kind) => CHANGE_KINDS.has(kind)) && (value.previous === null || isDatabaseJsonObject(value.previous) && typeof value.previous.bundle_id === "string" && (value.previous.release_id === null || typeof value.previous.release_id === "string") && typeof value.previous.app_version === "string" && typeof value.previous.channel === "string" && isOptional(value.previous, "min_bundle_id", isString));
 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);
-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, "min_bundle_id", isString) && isOptional(value, "failure", isDatabaseBundleEventFailure) && isOptional(value, "http_response", isDatabaseHttpResponse) && isOptional(value, "delivery", isString) && isOptional(value, "patch_fallback", (flag) => typeof flag === "boolean");
+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, "min_bundle_id", isString) && isOptional(value, "failure", isDatabaseBundleEventFailure) && isOptional(value, "http_response", isDatabaseHttpResponse) && isOptional(value, "delivery", isString) && isOptional(value, "patch_fallback", (flag) => typeof flag === "boolean") && isOptional(value, "change", isBundleEventChange) && isOptional(value, "late", (flag) => flag === true) && isOptional(value, "implied_download", (flag) => flag === true);
 const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 /**
 * The built-in bundle a report says its installation runs: the running
@@ -36,13 +45,14 @@ const BUNDLE_EVENT_FIELDS = {
 	metadata: isDatabaseBundleEventMetadata,
 	received_at_ms: (value) => typeof value === "number" && Number.isSafeInteger(value) && value >= 0
 };
+const hasMetadata = (row, key) => isRecord(row.metadata) && Object.hasOwn(row.metadata, key);
 const updateStrategyOf = (row) => isRecord(row.metadata) ? row.metadata.update_strategy : void 0;
 /**
 * A movement, or a failed update, names the bundle it left and how the
 * device updates, and a failed update says what failed; an unchanged report
 * names neither.
 */
-const hasEventInvariants = (row) => (row.type === "UPDATE_DOWNLOADED" || row.type === "UPDATE_APPLIED" || row.type === "RECOVERED" || row.type === "UPDATE_FAILED") && typeof row.from_bundle_id === "string" && (updateStrategyOf(row) === "fingerprint" || updateStrategyOf(row) === "appVersion") && (row.type !== "UPDATE_FAILED" || isRecord(row.metadata) && isRecord(row.metadata.failure)) || row.type === "UNCHANGED" && row.from_bundle_id === null && updateStrategyOf(row) === null;
+const hasEventInvariants = (row) => (row.type === "UPDATE_DOWNLOADED" || row.type === "UPDATE_APPLIED" || row.type === "RECOVERED" || row.type === "UPDATE_FAILED") && typeof row.from_bundle_id === "string" && (updateStrategyOf(row) === "fingerprint" || updateStrategyOf(row) === "appVersion") && (row.type !== "UPDATE_FAILED" || isRecord(row.metadata) && isRecord(row.metadata.failure)) && !hasMetadata(row, "change") && (!hasMetadata(row, "late") || row.type === "UPDATE_DOWNLOADED" || row.type === "UPDATE_APPLIED") && (!hasMetadata(row, "implied_download") || row.type === "UPDATE_APPLIED" || row.type === "RECOVERED") || row.type === "UNCHANGED" && !hasMetadata(row, "late") && row.from_bundle_id === null && updateStrategyOf(row) === null;
 /**
 * Throws unless `row` has exactly the bundle event fields, each of its type,
 * and the invariants of its event type: `invalid-field` for an unknown field,

package/dist/server/index.cjs

@@ -1,9 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_schema = require("./schema.cjs");
 const require_model = require("./model.cjs");
 const require_official = require("./official.cjs");
 const require_errors = require("./errors.cjs");
 const require_provider = require("./provider.cjs");
-const require_schema = require("./schema.cjs");
 const require_recordEvent = require("./recordEvent.cjs");
 const require_reads = require("./reads.cjs");
 const require_routes = require("./routes.cjs");

package/dist/server/index.d.cts

@@ -2,7 +2,7 @@ import { BundleEventFailure, BundleEventFailureReason, BundleEventFailureStage,
 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";
+import { ActiveInstallationWindow, BundleEventFailureInput, CreateBundleEventRequest, CreateBundleEventRequestBase, CursorPage, EventCursorPage, EventHistoryChange, EventHistoryRow, InsightsBundleSelection, InsightsCountMeasurement, InsightsHttpResponse, InstallationHistoryRow, InstallationRow, ReportingOverview } from "./domain.cjs";
 import { InsightsBadRequestError } from "./errors.cjs";
 import { createInsightsModel } from "./model.cjs";
 import { InsightsEventPageInput, InsightsInstallationEventPageInput, InsightsProvider, InsightsUserInstallationPageInput } from "./types.cjs";
@@ -422,4 +422,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 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 };
+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 EventHistoryChange, 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

@@ -2,7 +2,7 @@ import { BundleEventFailure, BundleEventFailureReason, BundleEventFailureStage,
 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";
+import { ActiveInstallationWindow, BundleEventFailureInput, CreateBundleEventRequest, CreateBundleEventRequestBase, CursorPage, EventCursorPage, EventHistoryChange, EventHistoryRow, InsightsBundleSelection, InsightsCountMeasurement, InsightsHttpResponse, InstallationHistoryRow, InstallationRow, ReportingOverview } from "./domain.mjs";
 import { InsightsBadRequestError } from "./errors.mjs";
 import { createInsightsModel } from "./model.mjs";
 import { InsightsEventPageInput, InsightsInstallationEventPageInput, InsightsProvider, InsightsUserInstallationPageInput } from "./types.mjs";
@@ -422,4 +422,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 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 };
+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 EventHistoryChange, 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

@@ -1,8 +1,8 @@
+import { DEFAULT_INSIGHTS_RETENTION, createInsightsSchema, insightsSchema } from "./schema.mjs";
 import { createInsightsModel } from "./model.mjs";
 import { markOfficial } from "./official.mjs";
 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 { countEventSeries, countEvents, countLatestEvents, findLatestEvents, getAppUsage, getReleaseActivity, getUpdateFailures, listEvents } from "./reads.mjs";
 import { INSIGHTS_ROUTES, createInsightsRouteHandlers } from "./routes.mjs";

package/dist/server/modelTypes.d.cts

@@ -10,13 +10,14 @@ interface InsightsScope {
 }
 /**
  * Raw event predicates; recovery is attributed to the source bundle. An
- * UNCHANGED report is kept as no event, so no filter names it.
+ * UNCHANGED filter matches the kept rows that moved an installation to the
+ * bundle without an apply report.
  */
 type InsightsBundleEventFilter = InsightsScope & ({
   readonly type: "RECOVERED";
   readonly fromBundleId: string;
 } | {
-  readonly type: "UPDATE_DOWNLOADED" | "UPDATE_APPLIED" | "UPDATE_FAILED";
+  readonly type: "UPDATE_DOWNLOADED" | "UPDATE_APPLIED" | "UPDATE_FAILED" | "UNCHANGED";
   readonly toBundleId: string;
 });
 type InsightsEventFilter = {

package/dist/server/modelTypes.d.mts

@@ -10,13 +10,14 @@ interface InsightsScope {
 }
 /**
  * Raw event predicates; recovery is attributed to the source bundle. An
- * UNCHANGED report is kept as no event, so no filter names it.
+ * UNCHANGED filter matches the kept rows that moved an installation to the
+ * bundle without an apply report.
  */
 type InsightsBundleEventFilter = InsightsScope & ({
   readonly type: "RECOVERED";
   readonly fromBundleId: string;
 } | {
-  readonly type: "UPDATE_DOWNLOADED" | "UPDATE_APPLIED" | "UPDATE_FAILED";
+  readonly type: "UPDATE_DOWNLOADED" | "UPDATE_APPLIED" | "UPDATE_FAILED" | "UNCHANGED";
   readonly toBundleId: string;
 });
 type InsightsEventFilter = {

package/dist/server/overview.cjs

@@ -1,3 +1,4 @@
+const require_schema = require("./schema.cjs");
 //#region src/server/overview.ts
 const encodeIdentity = (identity) => [
 	identity.scopeKind,
@@ -64,18 +65,19 @@ const insightsOverviewDeltas = (event) => {
 			bucketStartMs
 		}, windowed);
 	};
-	if (event.type === "UPDATE_DOWNLOADED") metric(event.to_release_id, {
+	const implied = event.metadata.implied_download === true ? 1 : 0;
+	if (!require_schema.isLateEvent(event) && event.type === "UPDATE_DOWNLOADED") metric(event.to_release_id, {
 		downloads: 1,
 		applies: 0,
 		failedLaunches: 0
 	});
-	else if (event.type === "UPDATE_APPLIED") metric(event.to_release_id, {
-		downloads: 0,
+	else if (!require_schema.isLateEvent(event) && require_schema.isLaunch(event)) metric(event.to_release_id, {
+		downloads: implied,
 		applies: 1,
 		failedLaunches: 0
 	});
-	else if (event.type === "RECOVERED") metric(event.from_release_id, {
-		downloads: 0,
+	else if (!require_schema.isLateEvent(event) && event.type === "RECOVERED") metric(event.from_release_id, {
+		downloads: implied,
 		applies: 0,
 		failedLaunches: 1
 	});

package/dist/server/overview.mjs

@@ -1,3 +1,4 @@
+import { isLateEvent, isLaunch } from "./schema.mjs";
 //#region src/server/overview.ts
 const encodeIdentity = (identity) => [
 	identity.scopeKind,
@@ -64,18 +65,19 @@ const insightsOverviewDeltas = (event) => {
 			bucketStartMs
 		}, windowed);
 	};
-	if (event.type === "UPDATE_DOWNLOADED") metric(event.to_release_id, {
+	const implied = event.metadata.implied_download === true ? 1 : 0;
+	if (!isLateEvent(event) && event.type === "UPDATE_DOWNLOADED") metric(event.to_release_id, {
 		downloads: 1,
 		applies: 0,
 		failedLaunches: 0
 	});
-	else if (event.type === "UPDATE_APPLIED") metric(event.to_release_id, {
-		downloads: 0,
+	else if (!isLateEvent(event) && isLaunch(event)) metric(event.to_release_id, {
+		downloads: implied,
 		applies: 1,
 		failedLaunches: 0
 	});
-	else if (event.type === "RECOVERED") metric(event.from_release_id, {
-		downloads: 0,
+	else if (!isLateEvent(event) && event.type === "RECOVERED") metric(event.from_release_id, {
+		downloads: implied,
 		applies: 0,
 		failedLaunches: 1
 	});

package/dist/server/provider.cjs

@@ -166,7 +166,19 @@ const eventDetails = ({ type, metadata }) => ({
 	} } : {},
 	...type === "UPDATE_FAILED" && metadata.failure !== void 0 ? { failure: toFailure(metadata.failure) } : {},
 	...type === "UPDATE_DOWNLOADED" && metadata.delivery !== void 0 ? { delivery: metadata.delivery } : {},
-	...type === "UPDATE_DOWNLOADED" && metadata.patch_fallback === true ? { patchFallback: true } : {}
+	...type === "UPDATE_DOWNLOADED" && metadata.patch_fallback === true ? { patchFallback: true } : {},
+	...type === "UNCHANGED" && metadata.change !== void 0 ? { change: {
+		kinds: metadata.change.kinds,
+		...metadata.change.previous === null ? {} : { previous: {
+			bundleId: metadata.change.previous.bundle_id,
+			releaseId: metadata.change.previous.release_id,
+			appVersion: metadata.change.previous.app_version,
+			channel: metadata.change.previous.channel,
+			...metadata.change.previous.min_bundle_id === void 0 ? {} : { minBundleId: metadata.change.previous.min_bundle_id }
+		} }
+	} } : {},
+	...metadata.late === true ? { late: true } : {},
+	...metadata.implied_download === true ? { impliedDownload: true } : {}
 });
 const toEventHistoryRow = (row) => ({
 	...row.to_release_id == null ? {} : { toReleaseId: row.to_release_id },

package/dist/server/provider.mjs

@@ -166,7 +166,19 @@ const eventDetails = ({ type, metadata }) => ({
 	} } : {},
 	...type === "UPDATE_FAILED" && metadata.failure !== void 0 ? { failure: toFailure(metadata.failure) } : {},
 	...type === "UPDATE_DOWNLOADED" && metadata.delivery !== void 0 ? { delivery: metadata.delivery } : {},
-	...type === "UPDATE_DOWNLOADED" && metadata.patch_fallback === true ? { patchFallback: true } : {}
+	...type === "UPDATE_DOWNLOADED" && metadata.patch_fallback === true ? { patchFallback: true } : {},
+	...type === "UNCHANGED" && metadata.change !== void 0 ? { change: {
+		kinds: metadata.change.kinds,
+		...metadata.change.previous === null ? {} : { previous: {
+			bundleId: metadata.change.previous.bundle_id,
+			releaseId: metadata.change.previous.release_id,
+			appVersion: metadata.change.previous.app_version,
+			channel: metadata.change.previous.channel,
+			...metadata.change.previous.min_bundle_id === void 0 ? {} : { minBundleId: metadata.change.previous.min_bundle_id }
+		} }
+	} } : {},
+	...metadata.late === true ? { late: true } : {},
+	...metadata.implied_download === true ? { impliedDownload: true } : {}
 });
 const toEventHistoryRow = (row) => ({
 	...row.to_release_id == null ? {} : { toReleaseId: row.to_release_id },

package/dist/server/reads.cjs

@@ -1,5 +1,5 @@
-require("./provider.cjs");
 const require_schema = require("./schema.cjs");
+require("./provider.cjs");
 const require_recordEvent = require("./recordEvent.cjs");
 let _hot_updater_plugin_core = require("@hot-updater/plugin-core");
 //#region src/server/reads.ts
@@ -36,12 +36,11 @@ const EVENT_FIELDS = [
 ];
 /** A stored event or head, as the event row it holds. */
 const toEvent = (row) => Object.fromEntries(EVENT_FIELDS.map((field) => [field, row[field]]));
-const bundleRef = (filter) => filter.type === "RECOVERED" ? `from:${filter.fromBundleId}` : `to:${filter.toBundleId}`;
 const scopeOf = (filter) => ({
 	platform: filter.platform,
 	channel: filter.channel,
 	type: filter.type,
-	bundle_ref: bundleRef(filter)
+	bundle_ref: require_schema.bundleRefOfFilter(filter)
 });
 /** One UTC day of a global or bundle list, newest first. */
 const eventsOfDay = (db, filter, day, range, limit) => filter.kind === "all" ? db.findMany("bundle_events", {

package/dist/server/reads.mjs

@@ -1,5 +1,5 @@
+import { DAILY_EVENTS, DAY_MS, HOUR_MS, bundleRefOfFilter } from "./schema.mjs";
 import "./provider.mjs";
-import { DAILY_EVENTS, DAY_MS, HOUR_MS } from "./schema.mjs";
 import { PAIR_FIELD, bundlePairKey, insightsIdentity } from "./recordEvent.mjs";
 import { DatabaseAdapterInputError, compareUtf8, countDistinct, mergeDistinct } from "@hot-updater/plugin-core";
 //#region src/server/reads.ts
@@ -36,12 +36,11 @@ const EVENT_FIELDS = [
 ];
 /** A stored event or head, as the event row it holds. */
 const toEvent = (row) => Object.fromEntries(EVENT_FIELDS.map((field) => [field, row[field]]));
-const bundleRef = (filter) => filter.type === "RECOVERED" ? `from:${filter.fromBundleId}` : `to:${filter.toBundleId}`;
 const scopeOf = (filter) => ({
 	platform: filter.platform,
 	channel: filter.channel,
 	type: filter.type,
-	bundle_ref: bundleRef(filter)
+	bundle_ref: bundleRefOfFilter(filter)
 });
 /** One UTC day of a global or bundle list, newest first. */
 const eventsOfDay = (db, filter, day, range, limit) => filter.kind === "all" ? db.findMany("bundle_events", {

package/dist/server/recordEvent.cjs

@@ -1,7 +1,7 @@
 const require_eventRow = require("./eventRow.cjs");
+const require_schema = require("./schema.cjs");
 const require_contract = require("./contract.cjs");
 const require_overview = require("./overview.cjs");
-const require_schema = require("./schema.cjs");
 let _hot_updater_plugin_core = require("@hot-updater/plugin-core");
 //#region src/server/recordEvent.ts
 const hourOf = (ms) => ms - ms % require_schema.HOUR_MS;
@@ -136,16 +136,16 @@ const countEvent = (tx, event) => {
 	}
 };
 /**
-* A stored event's outcome rows: its bundle filter's hour, which a failed
-* check has none of, and every stored event's UTC day.
+* A stored event's outcome rows: its bundle filter's hour, when it has one
+* (`bundleRefsOf`), and every stored event's UTC day.
 */
 const countOutcome = (tx, event) => {
 	const shardBy = event.install_id;
-	if (!require_schema.isFailedCheck(event)) tx.aggregate("insights_outcomes", {
+	for (const bundleRef of require_schema.bundleRefsOf(event)) tx.aggregate("insights_outcomes", {
 		platform: event.platform,
 		channel: event.channel,
 		type: event.type,
-		bundle_ref: event.type === "RECOVERED" ? `from:${event.from_bundle_id}` : `to:${event.to_bundle_id}`,
+		bundle_ref: bundleRef,
 		bucket_start_ms: hourOf(event.received_at_ms)
 	}, { events: 1 }, { shardBy });
 	tx.aggregate("insights_outcomes", {
@@ -249,6 +249,126 @@ const countFailure = (tx, event) => {
 	}, { events: 1 }, { shardBy });
 };
 const isNewer = (event, head) => event.received_at_ms !== head.received_at_ms ? event.received_at_ms > head.received_at_ms : (0, _hot_updater_plugin_core.compareUtf8)(event.id, head.id) > 0;
+/** What a head says its installation runs: a download leaves it at the source. */
+const runningOf = (head) => head.type === "UPDATE_DOWNLOADED" ? {
+	bundle_id: head.from_bundle_id,
+	release_id: head.from_release_id
+} : {
+	bundle_id: head.to_bundle_id,
+	release_id: head.to_release_id
+};
+/** The native build a report or head came from, when its SDK says. */
+const minBundleIdOf = (row) => row.metadata?.min_bundle_id;
+/** When the client made a report, from the UUIDv7 it gave it. */
+const madeAt = (id) => (0, _hot_updater_plugin_core.isUUIDv7)(id) ? (0, _hot_updater_plugin_core.extractTimestampFromUUIDv7)(id) : null;
+/**
+* A report that arrived after its installation moved past it: a download or
+* an apply of the bundle the head already runs, or an UNCHANGED report of the
+* bundle an apply head left, made before that apply. A reload can cut one
+* runtime's report short and deliver it after the next runtime's. It stays
+* in history but moves and counts nothing.
+*/
+const isLate = (event, head) => {
+	if (head === null) return false;
+	if (event.type === "UPDATE_DOWNLOADED" || event.type === "UPDATE_APPLIED") return event.to_bundle_id === runningOf(head).bundle_id;
+	if (event.type === "UNCHANGED" && head.type === "UPDATE_APPLIED" && event.to_bundle_id === head.from_bundle_id) {
+		const made = madeAt(event.id);
+		const applied = madeAt(head.id);
+		return made !== null && applied !== null && made < applied;
+	}
+	return false;
+};
+/**
+* What an UNCHANGED report changes against its installation's head: the
+* running bundle or release, the app version, the channel, or the native
+* build (when both name it), with the head's values before it; `first_seen`
+* when the installation has no head. A report the head already answers, one
+* older than the head, a user switch and any other event type change
+* nothing, so no row keeps them.
+*/
+const changeOf = (event, head) => {
+	if (event.type !== "UNCHANGED") return null;
+	if (head === null) return {
+		kinds: ["first_seen"],
+		previous: null
+	};
+	if (!isNewer(event, head)) return null;
+	const running = runningOf(head);
+	const build = minBundleIdOf(event);
+	const headBuild = minBundleIdOf(head);
+	const kinds = [];
+	if (event.to_bundle_id !== running.bundle_id) kinds.push("bundle");
+	if (event.to_release_id !== running.release_id) kinds.push("release");
+	if (event.app_version !== head.app_version) kinds.push("app_version");
+	if (event.channel !== head.channel) kinds.push("channel");
+	if (build !== void 0 && headBuild !== void 0 && build !== headBuild) kinds.push("native_build");
+	return kinds.length === 0 ? null : {
+		kinds,
+		previous: {
+			bundle_id: running.bundle_id,
+			release_id: running.release_id,
+			app_version: head.app_version,
+			channel: head.channel,
+			...headBuild === void 0 ? {} : { min_bundle_id: headBuild }
+		}
+	};
+};
+/**
+* Whether a launch or a crash comes with no download report for its target:
+* its head shows neither that download nor the target already running. The
+* native build's built-in bundle is never downloaded, and without a head the
+* server knows nothing of the installation's past, so it implies nothing.
+*/
+const impliesDownload = (event, head) => {
+	const target = event.type === "RECOVERED" ? {
+		bundle: event.from_bundle_id,
+		release: event.from_release_id
+	} : require_schema.isLaunch(event) ? {
+		bundle: event.to_bundle_id,
+		release: event.to_release_id
+	} : null;
+	if (target === null || target.release === null || target.bundle === minBundleIdOf(event)) return false;
+	if (head === null) return false;
+	if (head.type === "UPDATE_DOWNLOADED" && head.to_bundle_id === target.bundle) return false;
+	return runningOf(head).bundle_id !== target.bundle;
+};
+/**
+* The event as recorded, with what only the server sets: what a kept
+* UNCHANGED report changed, a late report's flag, and a download its launch
+* or crash implied.
+*/
+const recordedOf = (event, head) => {
+	const { change: _change, late: _late, implied_download: _implied, ...metadata } = event.metadata;
+	const reported = {
+		...event,
+		metadata
+	};
+	const late = isLate(reported, head);
+	const change = late ? null : changeOf(reported, head);
+	const withChange = change === null ? reported : {
+		...reported,
+		metadata: {
+			...metadata,
+			change
+		}
+	};
+	return {
+		recorded: late && reported.type !== "UNCHANGED" ? {
+			...reported,
+			metadata: {
+				...metadata,
+				late: true
+			}
+		} : !late && impliesDownload(withChange, head) ? {
+			...withChange,
+			metadata: {
+				...withChange.metadata,
+				implied_download: true
+			}
+		} : withChange,
+		late
+	};
+};
 /** What an UNCHANGED report must share with its installation's head to repeat it. */
 const REPEATED_FIELDS = [
 	"channel",
@@ -283,23 +403,24 @@ const recordEvent = (db, event) => {
 		const [existing, previous] = await Promise.all([tx.findOne("bundle_events", { id: event.id }), tx.findOne("bundle_event_heads", { install_id: event.install_id })]);
 		if (existing !== null || previous?.id === event.id) return;
 		if (previous !== null && repeatsHead(event, previous)) return;
-		if (event.type !== "UNCHANGED") {
-			tx.create("bundle_events", event);
-			countOutcome(tx, event);
+		const { recorded, late } = recordedOf(event, previous);
+		if (recorded.type !== "UNCHANGED" || recorded.metadata.change !== void 0 && !late) {
+			tx.create("bundle_events", recorded);
+			countOutcome(tx, recorded);
 		}
-		if (event.type === "UPDATE_FAILED") {
-			countFailure(tx, event);
+		if (recorded.type === "UPDATE_FAILED") {
+			countFailure(tx, recorded);
 			return;
 		}
-		countEvent(tx, event);
-		if (previous !== null && !isNewer(event, previous)) return;
-		if (previous === null) tx.create("bundle_event_heads", event);
+		countEvent(tx, recorded);
+		if (previous !== null && (late || !isNewer(recorded, previous))) return;
+		if (previous === null) tx.create("bundle_event_heads", recorded);
 		else {
-			const { install_id: _, ...fields } = event;
+			const { install_id: _, ...fields } = recorded;
 			countHead(tx, previous, -1);
 			tx.update("bundle_event_heads", previous, fields);
 		}
-		countHead(tx, event, 1);
+		countHead(tx, recorded, 1);
 	});
 };
 //#endregion

package/dist/server/recordEvent.mjs

@@ -1,8 +1,8 @@
 import { runningBuiltinBundleId } from "./eventRow.mjs";
+import { DAILY_EVENTS, DAY_MS, HOUR_MS, bundleRefsOf, isLaunch } from "./schema.mjs";
 import { assertBundleEventRow } from "./contract.mjs";
 import { insightsKey, insightsOverviewDeltas, insightsOverviewId } from "./overview.mjs";
-import { DAILY_EVENTS, DAY_MS, HOUR_MS, isFailedCheck } from "./schema.mjs";
-import { addDistinct, compareUtf8 } from "@hot-updater/plugin-core";
+import { addDistinct, compareUtf8, extractTimestampFromUUIDv7, isUUIDv7 } from "@hot-updater/plugin-core";
 //#region src/server/recordEvent.ts
 const hourOf = (ms) => ms - ms % HOUR_MS;
 const dayOf = (ms) => ms - ms % DAY_MS;
@@ -136,16 +136,16 @@ const countEvent = (tx, event) => {
 	}
 };
 /**
-* A stored event's outcome rows: its bundle filter's hour, which a failed
-* check has none of, and every stored event's UTC day.
+* A stored event's outcome rows: its bundle filter's hour, when it has one
+* (`bundleRefsOf`), and every stored event's UTC day.
 */
 const countOutcome = (tx, event) => {
 	const shardBy = event.install_id;
-	if (!isFailedCheck(event)) tx.aggregate("insights_outcomes", {
+	for (const bundleRef of bundleRefsOf(event)) tx.aggregate("insights_outcomes", {
 		platform: event.platform,
 		channel: event.channel,
 		type: event.type,
-		bundle_ref: event.type === "RECOVERED" ? `from:${event.from_bundle_id}` : `to:${event.to_bundle_id}`,
+		bundle_ref: bundleRef,
 		bucket_start_ms: hourOf(event.received_at_ms)
 	}, { events: 1 }, { shardBy });
 	tx.aggregate("insights_outcomes", {
@@ -249,6 +249,126 @@ const countFailure = (tx, event) => {
 	}, { events: 1 }, { shardBy });
 };
 const isNewer = (event, head) => event.received_at_ms !== head.received_at_ms ? event.received_at_ms > head.received_at_ms : compareUtf8(event.id, head.id) > 0;
+/** What a head says its installation runs: a download leaves it at the source. */
+const runningOf = (head) => head.type === "UPDATE_DOWNLOADED" ? {
+	bundle_id: head.from_bundle_id,
+	release_id: head.from_release_id
+} : {
+	bundle_id: head.to_bundle_id,
+	release_id: head.to_release_id
+};
+/** The native build a report or head came from, when its SDK says. */
+const minBundleIdOf = (row) => row.metadata?.min_bundle_id;
+/** When the client made a report, from the UUIDv7 it gave it. */
+const madeAt = (id) => isUUIDv7(id) ? extractTimestampFromUUIDv7(id) : null;
+/**
+* A report that arrived after its installation moved past it: a download or
+* an apply of the bundle the head already runs, or an UNCHANGED report of the
+* bundle an apply head left, made before that apply. A reload can cut one
+* runtime's report short and deliver it after the next runtime's. It stays
+* in history but moves and counts nothing.
+*/
+const isLate = (event, head) => {
+	if (head === null) return false;
+	if (event.type === "UPDATE_DOWNLOADED" || event.type === "UPDATE_APPLIED") return event.to_bundle_id === runningOf(head).bundle_id;
+	if (event.type === "UNCHANGED" && head.type === "UPDATE_APPLIED" && event.to_bundle_id === head.from_bundle_id) {
+		const made = madeAt(event.id);
+		const applied = madeAt(head.id);
+		return made !== null && applied !== null && made < applied;
+	}
+	return false;
+};
+/**
+* What an UNCHANGED report changes against its installation's head: the
+* running bundle or release, the app version, the channel, or the native
+* build (when both name it), with the head's values before it; `first_seen`
+* when the installation has no head. A report the head already answers, one
+* older than the head, a user switch and any other event type change
+* nothing, so no row keeps them.
+*/
+const changeOf = (event, head) => {
+	if (event.type !== "UNCHANGED") return null;
+	if (head === null) return {
+		kinds: ["first_seen"],
+		previous: null
+	};
+	if (!isNewer(event, head)) return null;
+	const running = runningOf(head);
+	const build = minBundleIdOf(event);
+	const headBuild = minBundleIdOf(head);
+	const kinds = [];
+	if (event.to_bundle_id !== running.bundle_id) kinds.push("bundle");
+	if (event.to_release_id !== running.release_id) kinds.push("release");
+	if (event.app_version !== head.app_version) kinds.push("app_version");
+	if (event.channel !== head.channel) kinds.push("channel");
+	if (build !== void 0 && headBuild !== void 0 && build !== headBuild) kinds.push("native_build");
+	return kinds.length === 0 ? null : {
+		kinds,
+		previous: {
+			bundle_id: running.bundle_id,
+			release_id: running.release_id,
+			app_version: head.app_version,
+			channel: head.channel,
+			...headBuild === void 0 ? {} : { min_bundle_id: headBuild }
+		}
+	};
+};
+/**
+* Whether a launch or a crash comes with no download report for its target:
+* its head shows neither that download nor the target already running. The
+* native build's built-in bundle is never downloaded, and without a head the
+* server knows nothing of the installation's past, so it implies nothing.
+*/
+const impliesDownload = (event, head) => {
+	const target = event.type === "RECOVERED" ? {
+		bundle: event.from_bundle_id,
+		release: event.from_release_id
+	} : isLaunch(event) ? {
+		bundle: event.to_bundle_id,
+		release: event.to_release_id
+	} : null;
+	if (target === null || target.release === null || target.bundle === minBundleIdOf(event)) return false;
+	if (head === null) return false;
+	if (head.type === "UPDATE_DOWNLOADED" && head.to_bundle_id === target.bundle) return false;
+	return runningOf(head).bundle_id !== target.bundle;
+};
+/**
+* The event as recorded, with what only the server sets: what a kept
+* UNCHANGED report changed, a late report's flag, and a download its launch
+* or crash implied.
+*/
+const recordedOf = (event, head) => {
+	const { change: _change, late: _late, implied_download: _implied, ...metadata } = event.metadata;
+	const reported = {
+		...event,
+		metadata
+	};
+	const late = isLate(reported, head);
+	const change = late ? null : changeOf(reported, head);
+	const withChange = change === null ? reported : {
+		...reported,
+		metadata: {
+			...metadata,
+			change
+		}
+	};
+	return {
+		recorded: late && reported.type !== "UNCHANGED" ? {
+			...reported,
+			metadata: {
+				...metadata,
+				late: true
+			}
+		} : !late && impliesDownload(withChange, head) ? {
+			...withChange,
+			metadata: {
+				...withChange.metadata,
+				implied_download: true
+			}
+		} : withChange,
+		late
+	};
+};
 /** What an UNCHANGED report must share with its installation's head to repeat it. */
 const REPEATED_FIELDS = [
 	"channel",
@@ -283,23 +403,24 @@ const recordEvent = (db, event) => {
 		const [existing, previous] = await Promise.all([tx.findOne("bundle_events", { id: event.id }), tx.findOne("bundle_event_heads", { install_id: event.install_id })]);
 		if (existing !== null || previous?.id === event.id) return;
 		if (previous !== null && repeatsHead(event, previous)) return;
-		if (event.type !== "UNCHANGED") {
-			tx.create("bundle_events", event);
-			countOutcome(tx, event);
+		const { recorded, late } = recordedOf(event, previous);
+		if (recorded.type !== "UNCHANGED" || recorded.metadata.change !== void 0 && !late) {
+			tx.create("bundle_events", recorded);
+			countOutcome(tx, recorded);
 		}
-		if (event.type === "UPDATE_FAILED") {
-			countFailure(tx, event);
+		if (recorded.type === "UPDATE_FAILED") {
+			countFailure(tx, recorded);
 			return;
 		}
-		countEvent(tx, event);
-		if (previous !== null && !isNewer(event, previous)) return;
-		if (previous === null) tx.create("bundle_event_heads", event);
+		countEvent(tx, recorded);
+		if (previous !== null && (late || !isNewer(recorded, previous))) return;
+		if (previous === null) tx.create("bundle_event_heads", recorded);
 		else {
-			const { install_id: _, ...fields } = event;
+			const { install_id: _, ...fields } = recorded;
 			countHead(tx, previous, -1);
 			tx.update("bundle_event_heads", previous, fields);
 		}
-		countHead(tx, event, 1);
+		countHead(tx, recorded, 1);
 	});
 };
 //#endregion

package/dist/server/schema.cjs

@@ -10,18 +10,53 @@ const bucketRetention = (days) => ({
 	field: "bucket_start_ms",
 	days
 });
+/** Every kind of row the table keeps belongs in installation history. */
 const MOVEMENTS = /* @__PURE__ */ new Set([
 	"UPDATE_DOWNLOADED",
 	"UPDATE_APPLIED",
 	"RECOVERED",
-	"UPDATE_FAILED"
+	"UPDATE_FAILED",
+	"UNCHANGED"
 ]);
 /** A failed update check: it names no target bundle, so no bundle list shows it. */
 const isFailedCheck = (row) => row.type === "UPDATE_FAILED" && row.metadata?.failure?.stage === "check";
+const metadataOf = (row) => row.metadata ?? {};
+/** A download or apply that arrived after its target ran: it counts nothing. */
+const isLateEvent = (row) => metadataOf(row).late === true;
 /**
-* Downloads, applies, recoveries, and update failures, whole. An UNCHANGED
-* report counts as a launch and moves its installation's head, but no list
-* shows it, so no row keeps it.
+* Whether a stored row launched its installation into a bundle release: an
+* apply, or a kept UNCHANGED row that moved the installation to another
+* bundle of a release, as when the apply report never arrived or a rollback
+* to the built-in bundle took it there. A first report, a release change of
+* the bundle already running, and a late row launch nothing.
+*/
+const isLaunch = (row) => {
+	if (isLateEvent(row)) return false;
+	if (row.type === "UPDATE_APPLIED") return true;
+	if (row.type !== "UNCHANGED") return false;
+	const kinds = metadataOf(row).change?.kinds ?? [];
+	return kinds.includes("bundle") && !kinds.includes("first_seen") && row.to_release_id !== null;
+};
+/**
+* The bundle a stored row's bundle filter matches: `from:<bundle>` for a
+* recovery; `to:<bundle>` for a download, an apply, and an update failure;
+* `on:<bundle>` for an UNCHANGED row that launched a bundle (`isLaunch`), a
+* key no other row uses. None for a failed check, which targets no bundle, a
+* late row, or any other UNCHANGED row.
+*/
+const bundleRefsOf = (row) => {
+	if (isFailedCheck(row) || isLateEvent(row)) return [];
+	if (row.type === "RECOVERED") return [`from:${row.from_bundle_id}`];
+	if (row.type === "UNCHANGED") return isLaunch(row) ? [`on:${row.to_bundle_id}`] : [];
+	return [`to:${row.to_bundle_id}`];
+};
+/** The key a bundle filter reads, as `bundleRefsOf` writes it. */
+const bundleRefOfFilter = (filter) => filter.type === "RECOVERED" ? `from:${filter.fromBundleId}` : filter.type === "UNCHANGED" ? `on:${filter.toBundleId}` : `to:${filter.toBundleId}`;
+/**
+* Downloads, applies, recoveries, update failures, and the UNCHANGED
+* reports that changed what their installation runs, whole. An UNCHANGED
+* report that changes nothing counts as a launch and moves its
+* installation's head, but no row keeps it.
 */
 const bundleEvents = (days) => (0, _hot_updater_plugin_core.defineTable)({
 	id: {
@@ -76,19 +111,16 @@ const bundleEvents = (days) => (0, _hot_updater_plugin_core.defineTable)({
 			type: "integer",
 			compute: (row) => row.received_at_ms - row.received_at_ms % DAY_MS
 		},
-		/** Set only for events that belong in installation history. */
+		/** Every stored event belongs in installation history. */
 		movement_install_id: {
 			type: "string",
 			compute: (row) => MOVEMENTS.has(row.type) ? row.install_id : null
 		},
-		/**
-		* The bundle a bundle filter matches: `from:<bundle>` for RECOVERED,
-		* none for a failed check, else `to:<bundle>`.
-		*/
+		/** The bundle a bundle filter matches (`bundleRefsOf`). */
 		bundle_ref: {
 			type: "string",
 			multi: true,
-			compute: (row) => isFailedCheck(row) ? [] : [row.type === "RECOVERED" && row.from_bundle_id !== null ? `from:${row.from_bundle_id}` : `to:${row.to_bundle_id}`]
+			compute: (row) => bundleRefsOf(row)
 		}
 	},
 	indexes: {
@@ -534,6 +566,10 @@ exports.DAILY_EVENTS = DAILY_EVENTS;
 exports.DAY_MS = DAY_MS;
 exports.DEFAULT_INSIGHTS_RETENTION = DEFAULT_INSIGHTS_RETENTION;
 exports.HOUR_MS = HOUR_MS;
+exports.bundleRefOfFilter = bundleRefOfFilter;
+exports.bundleRefsOf = bundleRefsOf;
 exports.createInsightsSchema = createInsightsSchema;
 exports.insightsSchema = insightsSchema;
 exports.isFailedCheck = isFailedCheck;
+exports.isLateEvent = isLateEvent;
+exports.isLaunch = isLaunch;

package/dist/server/schema.mjs

@@ -10,18 +10,53 @@ const bucketRetention = (days) => ({
 	field: "bucket_start_ms",
 	days
 });
+/** Every kind of row the table keeps belongs in installation history. */
 const MOVEMENTS = /* @__PURE__ */ new Set([
 	"UPDATE_DOWNLOADED",
 	"UPDATE_APPLIED",
 	"RECOVERED",
-	"UPDATE_FAILED"
+	"UPDATE_FAILED",
+	"UNCHANGED"
 ]);
 /** A failed update check: it names no target bundle, so no bundle list shows it. */
 const isFailedCheck = (row) => row.type === "UPDATE_FAILED" && row.metadata?.failure?.stage === "check";
+const metadataOf = (row) => row.metadata ?? {};
+/** A download or apply that arrived after its target ran: it counts nothing. */
+const isLateEvent = (row) => metadataOf(row).late === true;
 /**
-* Downloads, applies, recoveries, and update failures, whole. An UNCHANGED
-* report counts as a launch and moves its installation's head, but no list
-* shows it, so no row keeps it.
+* Whether a stored row launched its installation into a bundle release: an
+* apply, or a kept UNCHANGED row that moved the installation to another
+* bundle of a release, as when the apply report never arrived or a rollback
+* to the built-in bundle took it there. A first report, a release change of
+* the bundle already running, and a late row launch nothing.
+*/
+const isLaunch = (row) => {
+	if (isLateEvent(row)) return false;
+	if (row.type === "UPDATE_APPLIED") return true;
+	if (row.type !== "UNCHANGED") return false;
+	const kinds = metadataOf(row).change?.kinds ?? [];
+	return kinds.includes("bundle") && !kinds.includes("first_seen") && row.to_release_id !== null;
+};
+/**
+* The bundle a stored row's bundle filter matches: `from:<bundle>` for a
+* recovery; `to:<bundle>` for a download, an apply, and an update failure;
+* `on:<bundle>` for an UNCHANGED row that launched a bundle (`isLaunch`), a
+* key no other row uses. None for a failed check, which targets no bundle, a
+* late row, or any other UNCHANGED row.
+*/
+const bundleRefsOf = (row) => {
+	if (isFailedCheck(row) || isLateEvent(row)) return [];
+	if (row.type === "RECOVERED") return [`from:${row.from_bundle_id}`];
+	if (row.type === "UNCHANGED") return isLaunch(row) ? [`on:${row.to_bundle_id}`] : [];
+	return [`to:${row.to_bundle_id}`];
+};
+/** The key a bundle filter reads, as `bundleRefsOf` writes it. */
+const bundleRefOfFilter = (filter) => filter.type === "RECOVERED" ? `from:${filter.fromBundleId}` : filter.type === "UNCHANGED" ? `on:${filter.toBundleId}` : `to:${filter.toBundleId}`;
+/**
+* Downloads, applies, recoveries, update failures, and the UNCHANGED
+* reports that changed what their installation runs, whole. An UNCHANGED
+* report that changes nothing counts as a launch and moves its
+* installation's head, but no row keeps it.
 */
 const bundleEvents = (days) => defineTable({
 	id: {
@@ -76,19 +111,16 @@ const bundleEvents = (days) => defineTable({
 			type: "integer",
 			compute: (row) => row.received_at_ms - row.received_at_ms % DAY_MS
 		},
-		/** Set only for events that belong in installation history. */
+		/** Every stored event belongs in installation history. */
 		movement_install_id: {
 			type: "string",
 			compute: (row) => MOVEMENTS.has(row.type) ? row.install_id : null
 		},
-		/**
-		* The bundle a bundle filter matches: `from:<bundle>` for RECOVERED,
-		* none for a failed check, else `to:<bundle>`.
-		*/
+		/** The bundle a bundle filter matches (`bundleRefsOf`). */
 		bundle_ref: {
 			type: "string",
 			multi: true,
-			compute: (row) => isFailedCheck(row) ? [] : [row.type === "RECOVERED" && row.from_bundle_id !== null ? `from:${row.from_bundle_id}` : `to:${row.to_bundle_id}`]
+			compute: (row) => bundleRefsOf(row)
 		}
 	},
 	indexes: {
@@ -530,4 +562,4 @@ const createInsightsSchema = ({ rawDays, dailyDays } = DEFAULT_INSIGHTS_RETENTIO
 };
 const insightsSchema = createInsightsSchema();
 //#endregion
-export { DAILY_EVENTS, DAY_MS, DEFAULT_INSIGHTS_RETENTION, HOUR_MS, createInsightsSchema, insightsSchema, isFailedCheck };
+export { DAILY_EVENTS, DAY_MS, DEFAULT_INSIGHTS_RETENTION, HOUR_MS, bundleRefOfFilter, bundleRefsOf, createInsightsSchema, insightsSchema, isFailedCheck, isLateEvent, isLaunch };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hot-updater/plugin-insights",
   "type": "module",
-  "version": "1.0.0-rc.36",
+  "version": "1.0.0-rc.37",
   "description": "Hot Updater's Insights plugin: launch, download, and update failure events, for the server and the React Native app",
   "exports": {
     "./client": {
@@ -33,10 +33,10 @@
     "package.json"
   ],
   "dependencies": {
-    "@hot-updater/protocol": "1.0.0-rc.36"
+    "@hot-updater/protocol": "1.0.0-rc.37"
   },
   "peerDependencies": {
-    "@hot-updater/plugin-core": "^1.0.0-rc.36"
+    "@hot-updater/plugin-core": "^1.0.0-rc.37"
   },
   "peerDependenciesMeta": {
     "@hot-updater/plugin-core": {
@@ -46,8 +46,8 @@
   "devDependencies": {
     "@types/node": "^20",
     "vitest": "4.1.4",
-    "@hot-updater/plugin-core": "1.0.0-rc.36",
-    "@hot-updater/test-utils": "1.0.0-rc.36"
+    "@hot-updater/test-utils": "1.0.0-rc.37",
+    "@hot-updater/plugin-core": "1.0.0-rc.37"
   },
   "nx": {
     "implicitDependencies": [