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

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;

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;

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/recordEvent.cjs

@@ -262,19 +262,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

@@ -262,19 +262,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.38",
   "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.38"
   },
   "peerDependencies": {
-    "@hot-updater/plugin-core": "^1.0.0-rc.37"
+    "@hot-updater/plugin-core": "^1.0.0-rc.38"
   },
   "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.38",
+    "@hot-updater/test-utils": "1.0.0-rc.38"
   },
   "nx": {
     "implicitDependencies": [