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

package/dist/server/domain.d.cts

@@ -123,7 +123,7 @@ type EventHistoryRow = {
   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. */
+  /** A download or apply of a target already run or already downloaded: it counted nothing. */
   readonly late?: true;
   /** A launch or crash whose download report never arrived, counted with it. */
   readonly impliedDownload?: true;
@@ -179,6 +179,10 @@ type ReportingOverview = InsightsScope & {
   readonly bundle?: {
     readonly bundleId: string;
     readonly reportingInstallations: InsightsCountMeasurement;
+    /**
+     * Download reports of the bundle, and in whole hours the downloads a
+     * launch or crash implied when its download report never arrived.
+     */
     readonly downloadedReports: InsightsCountMeasurement;
     readonly appliedReports: InsightsCountMeasurement;
     readonly recoveredReports: InsightsCountMeasurement;

package/dist/server/domain.d.mts

@@ -123,7 +123,7 @@ type EventHistoryRow = {
   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. */
+  /** A download or apply of a target already run or already downloaded: it counted nothing. */
   readonly late?: true;
   /** A launch or crash whose download report never arrived, counted with it. */
   readonly impliedDownload?: true;
@@ -179,6 +179,10 @@ type ReportingOverview = InsightsScope & {
   readonly bundle?: {
     readonly bundleId: string;
     readonly reportingInstallations: InsightsCountMeasurement;
+    /**
+     * Download reports of the bundle, and in whole hours the downloads a
+     * launch or crash implied when its download report never arrived.
+     */
     readonly downloadedReports: InsightsCountMeasurement;
     readonly appliedReports: InsightsCountMeasurement;
     readonly recoveredReports: InsightsCountMeasurement;

package/dist/server/eventRow.d.cts

@@ -62,9 +62,10 @@ type DatabaseBundleEventMetadata = DatabaseJsonObject & {
   /** 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.
+   * A download or apply of a target its installation already ran, as when
+   * a reload cut the first runtime's report short, or a download that
+   * repeats the pending one: the server keeps it in history, but it moves
+   * and counts nothing.
    */
   readonly late?: true;
   /**

package/dist/server/eventRow.d.mts

@@ -62,9 +62,10 @@ type DatabaseBundleEventMetadata = DatabaseJsonObject & {
   /** 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.
+   * A download or apply of a target its installation already ran, as when
+   * a reload cut the first runtime's report short, or a download that
+   * repeats the pending one: the server keeps it in history, but it moves
+   * and counts nothing.
    */
   readonly late?: true;
   /**

package/dist/server/reads.cjs

@@ -152,7 +152,11 @@ const countRaw = async (db, filter, from, to) => {
 	}
 	return total;
 };
-/** Whole hours from outcome counters; the partial hours at either edge from raw events. */
+/**
+* Whole hours from outcome counters; the partial hours at either edge from
+* raw events. A download filter's whole hours count the downloads a launch
+* or crash implied too, which its raw events do not hold.
+*/
 const countEvents = async (db, input) => {
 	const { filter, sinceMs, beforeReceivedAtMs } = input;
 	const start = hourCeil(sinceMs);
@@ -171,8 +175,9 @@ const countEvents = async (db, input) => {
 	return await countRaw(db, filter, sinceMs, start) + hours.reduce((sum, row) => sum + row.events, 0) + await countRaw(db, filter, end, beforeReceivedAtMs);
 };
 /**
-* A bundle filter's stored events in each interval of whole hours: one read
-* of its hourly counts, every interval present.
+* A bundle filter's stored events in each interval of whole hours, and for a
+* download filter the downloads a launch or crash implied: one read of its
+* hourly counts, every interval present.
 */
 const countEventSeries = async (db, input) => {
 	const { filter, intervalMs } = input;

package/dist/server/reads.mjs

@@ -152,7 +152,11 @@ const countRaw = async (db, filter, from, to) => {
 	}
 	return total;
 };
-/** Whole hours from outcome counters; the partial hours at either edge from raw events. */
+/**
+* Whole hours from outcome counters; the partial hours at either edge from
+* raw events. A download filter's whole hours count the downloads a launch
+* or crash implied too, which its raw events do not hold.
+*/
 const countEvents = async (db, input) => {
 	const { filter, sinceMs, beforeReceivedAtMs } = input;
 	const start = hourCeil(sinceMs);
@@ -171,8 +175,9 @@ const countEvents = async (db, input) => {
 	return await countRaw(db, filter, sinceMs, start) + hours.reduce((sum, row) => sum + row.events, 0) + await countRaw(db, filter, end, beforeReceivedAtMs);
 };
 /**
-* A bundle filter's stored events in each interval of whole hours: one read
-* of its hourly counts, every interval present.
+* A bundle filter's stored events in each interval of whole hours, and for a
+* download filter the downloads a launch or crash implied: one read of its
+* hourly counts, every interval present.
 */
 const countEventSeries = async (db, input) => {
 	const { filter, intervalMs } = input;

package/dist/server/recordEvent.cjs

@@ -137,17 +137,25 @@ const countEvent = (tx, event) => {
 };
 /**
 * A stored event's outcome rows: its bundle filter's hour, when it has one
-* (`bundleRefsOf`), and every stored event's UTC day.
+* (`bundleRefsOf`), and every stored event's UTC day. A download that a
+* launch or crash implied counts in its bundle's download hour too, in the
+* hour of that launch or crash, so the download series covers what the
+* release's downloads count; the launch or crash is its row.
 */
 const countOutcome = (tx, event) => {
 	const shardBy = event.install_id;
-	for (const bundleRef of require_schema.bundleRefsOf(event)) tx.aggregate("insights_outcomes", {
+	const hour = (type, bundleRef) => tx.aggregate("insights_outcomes", {
 		platform: event.platform,
 		channel: event.channel,
-		type: event.type,
+		type,
 		bundle_ref: bundleRef,
 		bucket_start_ms: hourOf(event.received_at_ms)
 	}, { events: 1 }, { shardBy });
+	for (const bundleRef of require_schema.bundleRefsOf(event)) hour(event.type, bundleRef);
+	if (event.metadata.implied_download === true) hour("UPDATE_DOWNLOADED", require_schema.bundleRefOfFilter({
+		type: "UPDATE_DOWNLOADED",
+		toBundleId: event.type === "RECOVERED" ? event.from_bundle_id : event.to_bundle_id
+	}));
 	tx.aggregate("insights_outcomes", {
 		...require_schema.DAILY_EVENTS,
 		bucket_start_ms: dayOf(event.received_at_ms)
@@ -262,19 +270,25 @@ 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.
+* A report its installation already moved past, which stays in history but
+* moves and counts nothing:
+* - a download or an apply of the bundle the head already runs, or a
+*   download that repeats the head's pending one, from the same bundle to
+*   the same bundle: the installation's download or launch already counted;
+* - an UNCHANGED report made, by its UUIDv7, before the head's report, even
+*   after a later report replaced the apply it preceded: a reload can cut
+*   one runtime's report short and deliver it after the next runtime's.
+*
+* Report IDs are made on the device, so a device whose clock jumps back has
+* its launch reports judged late until its clock passes its latest report.
 */
 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) {
+	if (event.type === "UPDATE_DOWNLOADED" || event.type === "UPDATE_APPLIED") return event.to_bundle_id === runningOf(head).bundle_id || event.type === "UPDATE_DOWNLOADED" && head.type === "UPDATE_DOWNLOADED" && event.from_bundle_id === head.from_bundle_id && event.to_bundle_id === head.to_bundle_id;
+	if (event.type === "UNCHANGED") {
 		const made = madeAt(event.id);
-		const applied = madeAt(head.id);
-		return made !== null && applied !== null && made < applied;
+		const latest = madeAt(head.id);
+		return made !== null && latest !== null && made < latest;
 	}
 	return false;
 };

package/dist/server/recordEvent.mjs

@@ -1,5 +1,5 @@
 import { runningBuiltinBundleId } from "./eventRow.mjs";
-import { DAILY_EVENTS, DAY_MS, HOUR_MS, bundleRefsOf, isLaunch } from "./schema.mjs";
+import { DAILY_EVENTS, DAY_MS, HOUR_MS, bundleRefOfFilter, bundleRefsOf, isLaunch } from "./schema.mjs";
 import { assertBundleEventRow } from "./contract.mjs";
 import { insightsKey, insightsOverviewDeltas, insightsOverviewId } from "./overview.mjs";
 import { addDistinct, compareUtf8, extractTimestampFromUUIDv7, isUUIDv7 } from "@hot-updater/plugin-core";
@@ -137,17 +137,25 @@ const countEvent = (tx, event) => {
 };
 /**
 * A stored event's outcome rows: its bundle filter's hour, when it has one
-* (`bundleRefsOf`), and every stored event's UTC day.
+* (`bundleRefsOf`), and every stored event's UTC day. A download that a
+* launch or crash implied counts in its bundle's download hour too, in the
+* hour of that launch or crash, so the download series covers what the
+* release's downloads count; the launch or crash is its row.
 */
 const countOutcome = (tx, event) => {
 	const shardBy = event.install_id;
-	for (const bundleRef of bundleRefsOf(event)) tx.aggregate("insights_outcomes", {
+	const hour = (type, bundleRef) => tx.aggregate("insights_outcomes", {
 		platform: event.platform,
 		channel: event.channel,
-		type: event.type,
+		type,
 		bundle_ref: bundleRef,
 		bucket_start_ms: hourOf(event.received_at_ms)
 	}, { events: 1 }, { shardBy });
+	for (const bundleRef of bundleRefsOf(event)) hour(event.type, bundleRef);
+	if (event.metadata.implied_download === true) hour("UPDATE_DOWNLOADED", bundleRefOfFilter({
+		type: "UPDATE_DOWNLOADED",
+		toBundleId: event.type === "RECOVERED" ? event.from_bundle_id : event.to_bundle_id
+	}));
 	tx.aggregate("insights_outcomes", {
 		...DAILY_EVENTS,
 		bucket_start_ms: dayOf(event.received_at_ms)
@@ -262,19 +270,25 @@ 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.
+* A report its installation already moved past, which stays in history but
+* moves and counts nothing:
+* - a download or an apply of the bundle the head already runs, or a
+*   download that repeats the head's pending one, from the same bundle to
+*   the same bundle: the installation's download or launch already counted;
+* - an UNCHANGED report made, by its UUIDv7, before the head's report, even
+*   after a later report replaced the apply it preceded: a reload can cut
+*   one runtime's report short and deliver it after the next runtime's.
+*
+* Report IDs are made on the device, so a device whose clock jumps back has
+* its launch reports judged late until its clock passes its latest report.
 */
 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) {
+	if (event.type === "UPDATE_DOWNLOADED" || event.type === "UPDATE_APPLIED") return event.to_bundle_id === runningOf(head).bundle_id || event.type === "UPDATE_DOWNLOADED" && head.type === "UPDATE_DOWNLOADED" && event.from_bundle_id === head.from_bundle_id && event.to_bundle_id === head.to_bundle_id;
+	if (event.type === "UNCHANGED") {
 		const made = madeAt(event.id);
-		const applied = madeAt(head.id);
-		return made !== null && applied !== null && made < applied;
+		const latest = madeAt(head.id);
+		return made !== null && latest !== null && made < latest;
 	}
 	return false;
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hot-updater/plugin-insights",
   "type": "module",
-  "version": "1.0.0-rc.37",
+  "version": "1.0.0-rc.39",
   "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.37"
+    "@hot-updater/protocol": "1.0.0-rc.39"
   },
   "peerDependencies": {
-    "@hot-updater/plugin-core": "^1.0.0-rc.37"
+    "@hot-updater/plugin-core": "^1.0.0-rc.39"
   },
   "peerDependenciesMeta": {
     "@hot-updater/plugin-core": {
@@ -46,8 +46,8 @@
   "devDependencies": {
     "@types/node": "^20",
     "vitest": "4.1.4",
-    "@hot-updater/test-utils": "1.0.0-rc.37",
-    "@hot-updater/plugin-core": "1.0.0-rc.37"
+    "@hot-updater/plugin-core": "1.0.0-rc.39",
+    "@hot-updater/test-utils": "1.0.0-rc.39"
   },
   "nx": {
     "implicitDependencies": [