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

package/dist/server/schema.d.cts

@@ -259,6 +259,38 @@ declare const createInsightsSchema: ({ rawDays, dailyDays }?: InsightsRetention)
       readonly sort: readonly ["bucket_start_ms"];
     };
   }, never, readonly ["channel", "platform", "app_version", "release_id", "bucket_start_ms"]>;
+  readonly insights_builtin_distribution: import("@hot-updater/plugin-core").AggregateDefinition<{
+    readonly channel: {
+      readonly type: "string";
+    };
+    readonly platform: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly app_version: {
+      readonly type: "string";
+    };
+    readonly release_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+    };
+    readonly builtin_bundle_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+    };
+    readonly bucket_start_ms: {
+      readonly type: "integer";
+    };
+  }, "latest_installations", {
+    readonly byScope: {
+      readonly eq: readonly ["channel", "platform"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+    readonly byVersion: {
+      readonly eq: readonly ["channel", "platform", "app_version"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+  }, never, readonly ["channel", "platform", "app_version", "release_id", "builtin_bundle_id", "bucket_start_ms"]>;
   readonly insights_latest_by_bundle: import("@hot-updater/plugin-core").AggregateDefinition<{
     readonly platform: {
       readonly type: "string";
@@ -594,6 +626,38 @@ declare const insightsSchema: {
       readonly sort: readonly ["bucket_start_ms"];
     };
   }, never, readonly ["channel", "platform", "app_version", "release_id", "bucket_start_ms"]>;
+  readonly insights_builtin_distribution: import("@hot-updater/plugin-core").AggregateDefinition<{
+    readonly channel: {
+      readonly type: "string";
+    };
+    readonly platform: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly app_version: {
+      readonly type: "string";
+    };
+    readonly release_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+    };
+    readonly builtin_bundle_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+    };
+    readonly bucket_start_ms: {
+      readonly type: "integer";
+    };
+  }, "latest_installations", {
+    readonly byScope: {
+      readonly eq: readonly ["channel", "platform"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+    readonly byVersion: {
+      readonly eq: readonly ["channel", "platform", "app_version"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+  }, never, readonly ["channel", "platform", "app_version", "release_id", "builtin_bundle_id", "bucket_start_ms"]>;
   readonly insights_latest_by_bundle: import("@hot-updater/plugin-core").AggregateDefinition<{
     readonly platform: {
       readonly type: "string";

package/dist/server/schema.d.mts

@@ -259,6 +259,38 @@ declare const createInsightsSchema: ({ rawDays, dailyDays }?: InsightsRetention)
       readonly sort: readonly ["bucket_start_ms"];
     };
   }, never, readonly ["channel", "platform", "app_version", "release_id", "bucket_start_ms"]>;
+  readonly insights_builtin_distribution: import("@hot-updater/plugin-core").AggregateDefinition<{
+    readonly channel: {
+      readonly type: "string";
+    };
+    readonly platform: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly app_version: {
+      readonly type: "string";
+    };
+    readonly release_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+    };
+    readonly builtin_bundle_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+    };
+    readonly bucket_start_ms: {
+      readonly type: "integer";
+    };
+  }, "latest_installations", {
+    readonly byScope: {
+      readonly eq: readonly ["channel", "platform"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+    readonly byVersion: {
+      readonly eq: readonly ["channel", "platform", "app_version"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+  }, never, readonly ["channel", "platform", "app_version", "release_id", "builtin_bundle_id", "bucket_start_ms"]>;
   readonly insights_latest_by_bundle: import("@hot-updater/plugin-core").AggregateDefinition<{
     readonly platform: {
       readonly type: "string";
@@ -594,6 +626,38 @@ declare const insightsSchema: {
       readonly sort: readonly ["bucket_start_ms"];
     };
   }, never, readonly ["channel", "platform", "app_version", "release_id", "bucket_start_ms"]>;
+  readonly insights_builtin_distribution: import("@hot-updater/plugin-core").AggregateDefinition<{
+    readonly channel: {
+      readonly type: "string";
+    };
+    readonly platform: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly app_version: {
+      readonly type: "string";
+    };
+    readonly release_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+    };
+    readonly builtin_bundle_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+    };
+    readonly bucket_start_ms: {
+      readonly type: "integer";
+    };
+  }, "latest_installations", {
+    readonly byScope: {
+      readonly eq: readonly ["channel", "platform"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+    readonly byVersion: {
+      readonly eq: readonly ["channel", "platform", "app_version"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+  }, never, readonly ["channel", "platform", "app_version", "release_id", "builtin_bundle_id", "bucket_start_ms"]>;
   readonly insights_latest_by_bundle: import("@hot-updater/plugin-core").AggregateDefinition<{
     readonly platform: {
       readonly type: "string";

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: {
@@ -354,6 +386,55 @@ const insightsDistribution = (retention) => defineAggregate({
 	},
 	retention
 });
+/**
+* The installations of `insights_distribution` that run their native build's
+* built-in bundle, by its ID (`builtin_bundle_id`), within the same rows:
+* reads move them out of the row of their release, or of no release.
+*/
+const insightsBuiltinDistribution = (retention) => defineAggregate({
+	channel: { type: "string" },
+	platform: {
+		type: "string",
+		maxLength: 16
+	},
+	app_version: { type: "string" },
+	release_id: {
+		type: "string",
+		maxLength: 36
+	},
+	builtin_bundle_id: {
+		type: "string",
+		maxLength: 36
+	},
+	bucket_start_ms: { type: "integer" }
+}, {
+	key: [
+		"channel",
+		"platform",
+		"app_version",
+		"release_id",
+		"builtin_bundle_id",
+		"bucket_start_ms"
+	],
+	gauges: ["latest_installations"],
+	shards: GAUGE_SHARDS,
+	batched: true,
+	indexes: {
+		byScope: {
+			eq: ["channel", "platform"],
+			sort: ["bucket_start_ms"]
+		},
+		byVersion: {
+			eq: [
+				"channel",
+				"platform",
+				"app_version"
+			],
+			sort: ["bucket_start_ms"]
+		}
+	},
+	retention
+});
 /** Latest events by the bundle they came from or went to, bucketed like the distribution. */
 const insightsLatestByBundle = (retention) => defineAggregate({
 	platform: {
@@ -473,6 +554,7 @@ const createInsightsSchema = ({ rawDays, dailyDays } = DEFAULT_INSIGHTS_RETENTIO
 		insights_overview_lifetime: lifetimeCounters(),
 		insights_sketches_lifetime: lifetimeSketches(),
 		insights_distribution: insightsDistribution(daily),
+		insights_builtin_distribution: insightsBuiltinDistribution(daily),
 		insights_latest_by_bundle: insightsLatestByBundle(daily),
 		insights_outcomes: insightsOutcomes(hourly),
 		insights_failures: insightsFailures(hourly)
@@ -480,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.35",
+  "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.35"
+    "@hot-updater/protocol": "1.0.0-rc.37"
   },
   "peerDependencies": {
-    "@hot-updater/plugin-core": "^1.0.0-rc.35"
+    "@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/test-utils": "1.0.0-rc.35",
-    "@hot-updater/plugin-core": "1.0.0-rc.35"
+    "@hot-updater/test-utils": "1.0.0-rc.37",
+    "@hot-updater/plugin-core": "1.0.0-rc.37"
   },
   "nx": {
     "implicitDependencies": [