@hot-updater/test-utils 1.0.0-rc.35 → 1.0.0-rc.37

package/dist/index.mjs

@@ -2902,10 +2902,11 @@ const storage = {
 	resolveFileUrl: async (storageUri) => `https://storage.example.com/${encodeURIComponent(storageUri)}`
 };
 /**
-* Core's bundles, releases, channels, and a client API key, and 25 Insights
+* Core's bundles, releases, channels, and a client API key, and 26 Insights
 * events: installs 1–24 ten minutes apart from T0, then install 1 again two
-* days later; and the day of history before T0, as a production database
-* holds, so a read that scans beyond its window examines more rows.
+* days later, back on bundle-a and then on bundle-b; and the day of history
+* before T0, as a production database holds, so a read that scans beyond its
+* window examines more rows.
 */
 const seed = async (database) => {
 	const core = database.core;
@@ -2951,8 +2952,17 @@ const seed = async (database) => {
 	for (let n = 1; n <= 24; n += 1) await api.insights.recordEvent(eventOf(n));
 	await api.insights.recordEvent(eventOf(25, {
 		install_id: "install-1",
+		from_release_id: "release-b",
+		from_bundle_id: "bundle-b",
+		to_release_id: "release-a",
+		to_bundle_id: "bundle-a",
 		received_at_ms: T0 + 2 * DAY
 	}));
+	await api.insights.recordEvent(eventOf(26, {
+		install_id: "install-1",
+		user_id: "user-odd",
+		received_at_ms: T0 + 2 * DAY + 6e5
+	}));
 	for (let n = 1; n <= 72; n += 1) await api.insights.recordEvent(historyOf(n));
 	await api.insights.recordEvent(failureOf(1, 3));
 	await api.insights.recordEvent(failureOf(2, 5));
@@ -3277,9 +3287,9 @@ const READ_BUDGETS = [
 			},
 			intervalMs: DAY
 		}),
-		adapter: reads(0, 0, 4, 30),
+		adapter: reads(0, 0, 6, 30),
 		engine: {
-			calls: 4,
+			calls: 6,
 			rows: 4
 		},
 		check: ({ versions }) => expect(versions).toEqual([{
@@ -3386,11 +3396,16 @@ const READ_BUDGETS = [
 	}),
 	budget({
 		api: "record an insights event: 2 dependent rounds of batch gets and 1 write",
-		read: ({ insights }) => insights.recordEvent(eventOf(26, {
+		read: ({ insights }) => insights.recordEvent(eventOf(27, {
 			install_id: "install-2",
+			user_id: "user-even",
+			from_release_id: "release-b",
+			from_bundle_id: "bundle-b",
+			to_release_id: "release-c",
+			to_bundle_id: "bundle-c",
 			received_at_ms: T0 + 3 * HOUR
 		})),
-		adapter: reads(4, 6, 0, 0),
+		adapter: reads(6, 14, 0, 0),
 		engine: {
 			calls: 2,
 			rows: 1
@@ -4261,20 +4276,31 @@ const registerInsightsModelTests = (state) => {
 					limit: 1
 				}), [expected]);
 			}
-			await expect(model.findLatestEvents({ installId: unchanged.install_id })).resolves.toEqual([unchanged]);
+			const firstSeen = {
+				...unchanged,
+				metadata: {
+					...unchanged.metadata,
+					change: {
+						kinds: ["first_seen"],
+						previous: null
+					}
+				}
+			};
+			await expect(model.findLatestEvents({ installId: unchanged.install_id })).resolves.toEqual([firstSeen]);
 			await expectInsightsIndex(() => model.listEvents({
 				filter: { kind: "all" },
 				sinceMs: 100,
 				beforeReceivedAtMs: 200,
 				limit: 10
 			}), [
+				firstSeen,
 				excluded[4],
 				recovered,
 				excluded[3],
 				excluded[2],
 				applied
 			]);
-			await expect(model.countEvents({
+			await expectInsightsIndex(() => model.countEvents({
 				filter: {
 					platform: "ios",
 					channel: "production",
@@ -4283,7 +4309,7 @@ const registerInsightsModelTests = (state) => {
 				},
 				sinceMs: 100,
 				beforeReceivedAtMs: 200
-			})).rejects.toThrow();
+			}), 0);
 			await expectInsightsIndex(() => model.countLatestEvents({
 				platform: "ios",
 				channel: "production",
@@ -4444,7 +4470,9 @@ const registerInsightsModelTests = (state) => {
 				id: createBundleEventRowFixture("9804", 3e3).id,
 				type: "RECOVERED",
 				from_release_id: releaseB,
+				from_bundle_id: base.to_bundle_id,
 				to_release_id: releaseA,
+				to_bundle_id: base.from_bundle_id,
 				received_at_ms: 3e3
 			};
 			for (const event of [
@@ -4497,7 +4525,7 @@ const registerInsightsModelTests = (state) => {
 			await expectInsightsIndex(() => hourly({
 				...scope,
 				type: "RECOVERED",
-				fromBundleId: base.from_bundle_id
+				fromBundleId: base.to_bundle_id
 			}), points(1, 0, 0));
 			const usage = await model.getAppUsage({
 				channel: "production",
@@ -4517,14 +4545,62 @@ const registerInsightsModelTests = (state) => {
 				appVersion: "1.0.0",
 				platform: "ios",
 				releaseId: releaseA,
+				builtinBundleId: null,
 				installations: 1
 			}, {
 				appVersion: "1.0.0",
 				platform: "ios",
 				releaseId: releaseB,
+				builtinBundleId: null,
 				installations: 1
 			}]));
 		});
+		it("distributes installations on their native build's built-in bundle by its ID", async () => {
+			const model = state.getDatabase();
+			const channel = "builtin-distribution";
+			const launch = (suffix, bundleId, minBundleId) => {
+				const base = createBundleEventRowFixture(suffix, 1e3);
+				return {
+					...base,
+					type: "UNCHANGED",
+					channel,
+					from_bundle_id: null,
+					to_bundle_id: bundleId,
+					metadata: {
+						...base.metadata,
+						update_strategy: null,
+						min_bundle_id: minBundleId
+					}
+				};
+			};
+			const builtin = createBundleEventRowFixture("9901", 0).id;
+			await record(model, launch("9902", builtin, builtin));
+			await record(model, launch("9903", builtin, builtin));
+			await record(model, launch("9904", createBundleEventRowFixture("9905", 0).id, builtin));
+			const usage = await model.getAppUsage({
+				channel,
+				platform: "ios",
+				timeRange: {
+					start: 0,
+					end: 36e5
+				},
+				intervalMs: 36e5
+			});
+			expect(usage.bundleDistribution).toEqual(expect.arrayContaining([{
+				appVersion: "1.0.0",
+				platform: "ios",
+				releaseId: null,
+				builtinBundleId: builtin,
+				installations: 2
+			}, {
+				appVersion: "1.0.0",
+				platform: "ios",
+				releaseId: null,
+				builtinBundleId: null,
+				installations: 1
+			}]));
+			expect(usage.bundleDistribution).toHaveLength(2);
+		});
 		it("pages insights events newest first with a stable cursor", async () => {
 			const model = state.getDatabase();
 			const first = createBundleEventRowFixture("701", 100);
@@ -4555,24 +4631,26 @@ const registerInsightsModelTests = (state) => {
 		});
 		it("filters installation movements before applying the page limit", async () => {
 			const model = state.getDatabase();
+			const unrelated = createMovementEvent("712", 250, "UPDATE_APPLIED", "install-other");
+			const applied = createMovementEvent("713", 200, "UPDATE_APPLIED", "install-target");
+			const recovered = createMovementEvent("714", 100, "RECOVERED", "install-target");
 			const unchanged = {
-				...createBundleEventRowFixture("711", 300),
+				...applied,
+				id: createBundleEventRowFixture("711", 300).id,
 				type: "UNCHANGED",
-				install_id: "install-target",
 				from_bundle_id: null,
+				from_release_id: null,
 				metadata: {
-					...createBundleEventRowFixture("711", 300).metadata,
+					...applied.metadata,
 					update_strategy: null
-				}
+				},
+				received_at_ms: 300
 			};
-			const unrelated = createMovementEvent("712", 250, "UPDATE_APPLIED", "install-other");
-			const applied = createMovementEvent("713", 200, "UPDATE_APPLIED", "install-target");
-			const recovered = createMovementEvent("714", 100, "RECOVERED", "install-target");
 			for (const row of [
-				unchanged,
+				recovered,
 				unrelated,
 				applied,
-				recovered
+				unchanged
 			]) await model.recordEvent({ event: row });
 			await expectInsightsIndex(() => model.listEvents({
 				filter: {
@@ -4595,6 +4673,200 @@ const registerInsightsModelTests = (state) => {
 				limit: 1
 			}), [recovered]);
 		});
+		it("keeps an UNCHANGED report only when it changes what its installation runs, and counts the release it launched", async () => {
+			const model = state.getDatabase();
+			const day = 864e5;
+			const releaseA = "00000000-0000-7000-8000-000000009a01";
+			const releaseB = "00000000-0000-7000-8000-000000009a02";
+			const base = createBundleEventRowFixture("9910", 1e3);
+			const launch = (suffix, receivedAtMs, fields = {}) => ({
+				...base,
+				id: createBundleEventRowFixture(suffix, receivedAtMs).id,
+				type: "UNCHANGED",
+				install_id: "install-kept",
+				from_bundle_id: null,
+				from_release_id: null,
+				to_bundle_id: base.from_bundle_id,
+				to_release_id: releaseA,
+				metadata: {
+					...base.metadata,
+					update_strategy: null
+				},
+				received_at_ms: receivedAtMs,
+				...fields
+			});
+			const first = launch("9911", 1e3);
+			const same = launch("9912", 86401e3);
+			const moved = launch("9913", 86402e3, {
+				to_bundle_id: base.to_bundle_id,
+				to_release_id: releaseB
+			});
+			for (const row of [
+				first,
+				same,
+				moved
+			]) await record(model, row);
+			await expectInsightsIndex(() => model.listEvents({
+				filter: {
+					kind: "installationMovement",
+					installId: "install-kept"
+				},
+				beforeReceivedAtMs: 2 * day,
+				limit: 10
+			}), [{
+				...moved,
+				metadata: {
+					...moved.metadata,
+					implied_download: true,
+					change: {
+						kinds: ["bundle", "release"],
+						previous: {
+							bundle_id: base.from_bundle_id,
+							release_id: releaseA,
+							app_version: base.app_version,
+							channel: base.channel
+						}
+					}
+				}
+			}, {
+				...first,
+				metadata: {
+					...first.metadata,
+					change: {
+						kinds: ["first_seen"],
+						previous: null
+					}
+				}
+			}]);
+			await expectInsightsIndex(() => model.countEvents({
+				filter: {
+					platform: "ios",
+					channel: "production",
+					type: "UNCHANGED",
+					toBundleId: base.to_bundle_id
+				},
+				sinceMs: 0,
+				beforeReceivedAtMs: 2 * day
+			}), 1);
+			const activity = await model.getReleaseActivity({ releases: [{
+				releaseId: releaseA,
+				platform: "ios",
+				channel: "production"
+			}, {
+				releaseId: releaseB,
+				platform: "ios",
+				channel: "production"
+			}] });
+			expect(activity.data.map(({ metrics }) => metrics)).toEqual([{
+				downloads: 0,
+				applies: 0,
+				failedLaunches: 0
+			}, {
+				downloads: 1,
+				applies: 1,
+				failedLaunches: 0
+			}]);
+		});
+		it("counts each launch and download once, so a bundle's launches match its release and its downloads cover launches and crashes", async () => {
+			const model = state.getDatabase();
+			const day = 864e5;
+			const releaseA = "00000000-0000-7000-8000-000000009b01";
+			const releaseB = "00000000-0000-7000-8000-000000009b02";
+			const base = createBundleEventRowFixture("9920", 1e3);
+			const bundleA = base.from_bundle_id;
+			const bundleB = base.to_bundle_id;
+			let sequence = 9920;
+			const report = (install, receivedAtMs, fields) => {
+				sequence += 1;
+				return {
+					...base,
+					id: createBundleEventRowFixture(String(sequence), receivedAtMs).id,
+					install_id: install,
+					from_release_id: releaseA,
+					to_release_id: releaseB,
+					received_at_ms: receivedAtMs,
+					...fields
+				};
+			};
+			const launch = (install, at, bundle) => report(install, at, {
+				type: "UNCHANGED",
+				from_bundle_id: null,
+				from_release_id: null,
+				to_bundle_id: bundle,
+				to_release_id: bundle === bundleA ? releaseA : releaseB,
+				metadata: {
+					...base.metadata,
+					update_strategy: null
+				}
+			});
+			const download = (install, at) => report(install, at, { type: "UPDATE_DOWNLOADED" });
+			const apply = (install, at) => report(install, at, { type: "UPDATE_APPLIED" });
+			const rows = [
+				launch("i1", 1e3, bundleA),
+				download("i1", 2e3),
+				apply("i1", 3e3),
+				launch("i2", 1e3, bundleA),
+				launch("i2", 86401e3, bundleB),
+				launch("i3", 1e3, bundleA),
+				download("i3", 2e3),
+				launch("i3", 86402e3, bundleB),
+				launch("i4", 1e3, bundleA),
+				apply("i4", 3e3),
+				download("i4", 4e3),
+				launch("i5", 1e3, bundleA),
+				download("i5", 2e3),
+				report("i5", 3e3, {
+					type: "RECOVERED",
+					from_release_id: releaseB,
+					from_bundle_id: bundleB,
+					to_release_id: releaseA,
+					to_bundle_id: bundleA
+				})
+			];
+			for (const row of rows) await record(model, row);
+			const scope = {
+				platform: "ios",
+				channel: "production"
+			};
+			const range = {
+				sinceMs: 0,
+				beforeReceivedAtMs: 2 * day
+			};
+			const count = (filter) => model.countEvents({
+				filter,
+				...range
+			});
+			const [{ metrics }] = (await model.getReleaseActivity({ releases: [{
+				releaseId: releaseB,
+				...scope
+			}] })).data;
+			expect(metrics).toEqual({
+				downloads: 5,
+				applies: 4,
+				failedLaunches: 1
+			});
+			await expectInsightsIndex(async () => await count({
+				...scope,
+				type: "UPDATE_APPLIED",
+				toBundleId: bundleB
+			}) + await count({
+				...scope,
+				type: "UNCHANGED",
+				toBundleId: bundleB
+			}), metrics.applies);
+			const implied = (await model.listEvents({
+				filter: { kind: "all" },
+				...range,
+				limit: 100
+			})).filter(({ metadata }) => metadata.implied_download === true).length;
+			await expectInsightsIndex(() => count({
+				...scope,
+				type: "UPDATE_DOWNLOADED",
+				toBundleId: bundleB
+			}), metrics.downloads - implied);
+			expect(implied).toBe(2);
+			expect(metrics.downloads).toBeGreaterThanOrEqual(metrics.applies + metrics.failedLaunches);
+		});
 		it("lists an update failure where its target's list and installation history read it, and a failed check in no bundle list, moving no latest event", async () => {
 			const model = state.getDatabase();
 			const applied = createMovementEvent("721", 100, "UPDATE_APPLIED", "install-failing");
@@ -4806,10 +5078,11 @@ const setupInsightsHttpTestSuite = (options) => {
 				httpResponse
 			});
 			const data = (await (await client.admin(`/installations/${encodeURIComponent(installId)}/events`)).json()).data;
-			expect(data).toHaveLength(type === "UNCHANGED" ? 0 : 1);
-			if (type !== "UNCHANGED") expect(data[0]).toMatchObject({
+			expect(data).toHaveLength(1);
+			expect(data[0]).toMatchObject({
 				type,
-				httpResponse
+				httpResponse,
+				...type === "UNCHANGED" ? { change: { kinds: ["first_seen"] } } : {}
 			});
 		});
 		it("records an update failure in installation history and the failures read", async () => {

package/dist/react-native.cjs

@@ -127,6 +127,7 @@ const setupClientPlugins = (plugins, options = {}) => {
 		sdkVersion: options.sdkVersion ?? "0.0.0-test",
 		getInstallId: () => read(options.installId ?? "00000000-0000-4000-8000-000000000000"),
 		getAppVersion: () => read(options.appVersion === void 0 ? "1.0.0" : options.appVersion),
+		getMinBundleId: () => options.minBundleId ?? "00000000-0000-0000-0000-000000000000",
 		getBundleId: () => read(options.bundleId ?? "00000000-0000-0000-0000-000000000000"),
 		getChannel: () => read(options.channel ?? "production"),
 		getCohort: () => read(options.cohort ?? "1"),

package/dist/react-native.d.cts

@@ -26,6 +26,12 @@ interface ClientPluginTestOptions {
   readonly isDebugBuild?: boolean;
   /** The running bundle. Default: `00000000-0000-0000-0000-000000000000`. */
   readonly bundleId?: TestValue<string>;
+  /**
+   * The native build's built-in bundle. Default:
+   * `00000000-0000-0000-0000-000000000000`, so the default bundle is the
+   * built-in one.
+   */
+  readonly minBundleId?: string;
   /** Default: `production`. */
   readonly channel?: TestValue<string>;
   /** Default: `1`. */

package/dist/react-native.d.mts

@@ -26,6 +26,12 @@ interface ClientPluginTestOptions {
   readonly isDebugBuild?: boolean;
   /** The running bundle. Default: `00000000-0000-0000-0000-000000000000`. */
   readonly bundleId?: TestValue<string>;
+  /**
+   * The native build's built-in bundle. Default:
+   * `00000000-0000-0000-0000-000000000000`, so the default bundle is the
+   * built-in one.
+   */
+  readonly minBundleId?: string;
   /** Default: `production`. */
   readonly channel?: TestValue<string>;
   /** Default: `1`. */

package/dist/react-native.mjs

@@ -126,6 +126,7 @@ const setupClientPlugins = (plugins, options = {}) => {
 		sdkVersion: options.sdkVersion ?? "0.0.0-test",
 		getInstallId: () => read(options.installId ?? "00000000-0000-4000-8000-000000000000"),
 		getAppVersion: () => read(options.appVersion === void 0 ? "1.0.0" : options.appVersion),
+		getMinBundleId: () => options.minBundleId ?? "00000000-0000-0000-0000-000000000000",
 		getBundleId: () => read(options.bundleId ?? "00000000-0000-0000-0000-000000000000"),
 		getChannel: () => read(options.channel ?? "production"),
 		getCohort: () => read(options.cohort ?? "1"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hot-updater/test-utils",
-  "version": "1.0.0-rc.35",
+  "version": "1.0.0-rc.37",
   "type": "module",
   "description": "Test utilities for Hot Updater packages",
   "sideEffects": false,
@@ -50,10 +50,10 @@
     "mysql2": "*",
     "pg": "*",
     "vitest": "^4.0.0",
-    "@hot-updater/plugin-insights": "^1.0.0-rc.35",
-    "@hot-updater/server": "^1.0.0-rc.35",
-    "@hot-updater/plugin-core": "^1.0.0-rc.35",
-    "@hot-updater/protocol": "^1.0.0-rc.35"
+    "@hot-updater/plugin-insights": "^1.0.0-rc.37",
+    "@hot-updater/plugin-core": "^1.0.0-rc.37",
+    "@hot-updater/protocol": "^1.0.0-rc.37",
+    "@hot-updater/server": "^1.0.0-rc.37"
   },
   "peerDependenciesMeta": {
     "@electric-sql/pglite": {
@@ -83,11 +83,11 @@
     "typescript": "npm:@typescript/typescript6@6.0.2",
     "vitest": "4.1.4",
     "workspace-tools": "^0.41.7",
-    "@hot-updater/plugin-insights": "1.0.0-rc.35",
-    "@hot-updater/protocol": "1.0.0-rc.35",
-    "@hot-updater/js": "1.0.0-rc.35",
-    "@hot-updater/server": "1.0.0-rc.35",
-    "@hot-updater/plugin-core": "1.0.0-rc.35"
+    "@hot-updater/plugin-insights": "1.0.0-rc.37",
+    "@hot-updater/protocol": "1.0.0-rc.37",
+    "@hot-updater/js": "1.0.0-rc.37",
+    "@hot-updater/plugin-core": "1.0.0-rc.37",
+    "@hot-updater/server": "1.0.0-rc.37"
   },
   "inlinedDependencies": {
     "@nodelib/fs.scandir": "2.1.5",