@hot-updater/test-utils 1.1.4 → 1.2.0-rc.1

package/dist/index.d.mts

@@ -64,8 +64,10 @@ declare const setupBundleMethodsTestSuite: (options: {
 //#region src/setupCoreAdminTestSuite.d.ts
 /**
  * Core's operations through admin API protocol 2 that the bundle and catalog
- * suites leave out: channels, deploy refusals, promotion, preflights, and a
- * bundle's patch children. Each test deletes what it wrote.
+ * suites leave out: channels, deploy refusals, promotion, preflights, a
+ * bundle's patch children, and the native build registry. Each test deletes
+ * what it wrote, except a native build, which the registry keeps: its IDs
+ * and channel are the test's own.
  */
 declare const setupCoreAdminTestSuite: (options: {
   readonly getClient: () => HttpTestClient;

package/dist/index.mjs

@@ -237,8 +237,10 @@ const setupBundleMethodsTestSuite = (options) => {
 //#region src/setupCoreAdminTestSuite.ts
 /**
 * Core's operations through admin API protocol 2 that the bundle and catalog
-* suites leave out: channels, deploy refusals, promotion, preflights, and a
-* bundle's patch children. Each test deletes what it wrote.
+* suites leave out: channels, deploy refusals, promotion, preflights, a
+* bundle's patch children, and the native build registry. Each test deletes
+* what it wrote, except a native build, which the registry keeps: its IDs
+* and channel are the test's own.
 */
 const setupCoreAdminTestSuite = (options) => {
 	describe("Core admin API", () => {
@@ -352,6 +354,107 @@ const setupCoreAdminTestSuite = (options) => {
 			expect(await adminJson(catalogPath)).toEqual(before);
 			expect((await adminJson(`/releases/${release.id}`)).data).toEqual(release);
 		});
+		it("registers native builds, finds the newest of a scope, and keeps their built-in bundles", async () => {
+			const channel = `native-${namespace}`;
+			const registration = (suffix, id = bundleRow(`8${suffix}`).id, buildKey = null) => {
+				const builtIn = bundleRow(suffix);
+				return admin("/native-builds", jsonRequest("POST", {
+					id,
+					platform: "ios",
+					channel,
+					fingerprintHash: "native-fingerprint",
+					appVersion: null,
+					minBundleId: builtIn.id,
+					gitCommitHash: null,
+					buildKey,
+					buildNumber: suffix,
+					artifact: {
+						kind: "ipa",
+						storageUri: `storage://native-builds/ios/${suffix}/App.ipa`,
+						byteSize: 1e3
+					},
+					embeddedBundle: {
+						manifestStorageUri: builtIn.manifest_storage_uri,
+						manifestFileHash: builtIn.manifest_file_hash,
+						assetBaseStorageUri: builtIn.asset_base_storage_uri
+					}
+				}));
+			};
+			const register = async (suffix, buildKey) => {
+				const response = await registration(suffix, bundleRow(`8${suffix}`).id, buildKey);
+				expect(response.status).toBe(201);
+				return (await response.json()).data;
+			};
+			const scope = (query) => `/native-builds/latest?platform=ios&channel=${encodeURIComponent(channel)}&${query}`;
+			const before = await adminJson("/bundles?limit=1&total=true");
+			const keyed = `nbk1:${"a".repeat(64)}`;
+			const keyedBuild = await register("60", keyed);
+			const newest = await register("61");
+			const again = await registration("61", bundleRow("862").id);
+			const refusedDelete = await admin("/bundles/delete", jsonRequest("POST", { ids: [bundleRow("61").id] }));
+			expect((await adminJson(scope("fingerprintHash=native-fingerprint"))).data).toEqual(newest);
+			expect((await adminJson(scope("appVersion=1.0.0"))).data).toBeNull();
+			expect(keyedBuild.build_key).toBe(keyed);
+			expect(newest.build_key).toBeNull();
+			expect(newest.build_number).toBe("61");
+			expect((await adminJson(scope(`fingerprintHash=native-fingerprint&buildKey=${keyed}`))).data).toEqual(keyedBuild);
+			expect((await adminJson(scope(`fingerprintHash=native-fingerprint&buildKey=nbk1:${"b".repeat(64)}`))).data).toBeNull();
+			const badKey = await admin(scope("fingerprintHash=native-fingerprint&buildKey=not-a-key"));
+			expect(badKey.status).toBe(400);
+			await badKey.text();
+			expect((await adminJson(`/native-builds/${newest.id}`)).data).toEqual(newest);
+			expect((await adminJson(`/native-builds/${bundleRow("863").id}`)).data).toBeNull();
+			const channelRow = (await adminJson(`/channels?name=${encodeURIComponent(channel)}`)).data;
+			const ofChannel = (channelId, query = "") => adminJson(`/native-builds?channelId=${encodeURIComponent(channelId)}&order=desc&${query}`);
+			const firstPage = await ofChannel(channelRow.id, "limit=1");
+			expect(firstPage).toEqual({
+				data: [newest],
+				next: newest.id
+			});
+			expect(await ofChannel(channelRow.id, `limit=1&cursor=${newest.id}`)).toEqual({
+				data: [keyedBuild],
+				next: keyedBuild.id
+			});
+			expect((await ofChannel(channelRow.id, "limit=10")).data).toEqual([newest, keyedBuild]);
+			const other = await api.ensureChannel(`native-other-${namespace}`);
+			expect((await ofChannel(other.id, "limit=10")).data).toEqual([]);
+			await adminJson(`/channels/${other.id}`, jsonRequest("DELETE"));
+			expect((await ofChannel(other.id, "limit=10")).data).toEqual([]);
+			const submitted = await adminJson(`/native-builds/${newest.id}/submission`, jsonRequest("POST", {
+				destination: "testflight",
+				version: "1.0.0 (7)"
+			}));
+			expect(submitted.data).toMatchObject({
+				id: newest.id,
+				submitted_to: "testflight",
+				submitted_version: "1.0.0 (7)"
+			});
+			expect((await adminJson(`/native-builds/${newest.id}`)).data).toEqual(submitted.data);
+			expect((await adminJson(`/native-builds/${bundleRow("863").id}/submission`, jsonRequest("POST", {
+				destination: "testflight",
+				version: "1.0.0 (7)"
+			}))).data).toBeNull();
+			const wrongStore = await admin(`/native-builds/${newest.id}/submission`, jsonRequest("POST", {
+				destination: "play-internal",
+				version: "1.0.0 (7)"
+			}));
+			expect(wrongStore.status).toBe(400);
+			await wrongStore.text();
+			expect(again.status).toBe(409);
+			expect(await again.json()).toMatchObject({ code: "NATIVE_BUILD_EXISTS" });
+			expect(refusedDelete.status).toBe(409);
+			await refusedDelete.text();
+			expect((await adminJson(`/bundles/${bundleRow("61").id}`)).data).toEqual({
+				bundle: {
+					...bundleRow("61"),
+					metadata: {}
+				},
+				patches: [],
+				childCount: 0
+			});
+			const after = await adminJson("/bundles?limit=1&total=true");
+			expect(after.total).toBe(before.total);
+		});
 		it("lists the patches that start from a bundle", async () => {
 			const base = bundleRow("50");
 			const target = bundleRow("51");
@@ -2919,6 +3022,14 @@ const scopeKey = createReleaseCatalogScopeKey({
 	platform: "ios",
 	strategy: "APP_VERSION"
 });
+const nativeBuildScope = {
+	platform: "ios",
+	channel: "production",
+	fingerprintHash: "native-fingerprint",
+	appVersion: null
+};
+/** The native build key the older of the two native builds is registered with. */
+const nativeBuildKey = `nbk1:${"0".repeat(64)}`;
 const bundleEvents = {
 	kind: "bundle",
 	platform: "ios",
@@ -2935,7 +3046,7 @@ const storage = {
 	resolveFileUrl: async (storageUri) => `https://storage.example.com/${encodeURIComponent(storageUri)}`
 };
 /**
-* Core's bundles, releases, channels, and a client API key, and 26 Insights
+* Core's bundles, releases, channels, a client API key, and 26 Insights
 * events: installs 1–24 ten minutes apart from T0, then install 1 again two
 * 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
@@ -2981,6 +3092,23 @@ const seed = async (database) => {
 	await deploy(bundleOf("202", "android"));
 	await deploy(bundleOf("091"), "staging");
 	await deploy(bundleOf("092"), "staging");
+	for (const suffix of ["011", "012"]) await core.registerNativeBuild({
+		...nativeBuildScope,
+		id: createBundleFixture(`8${suffix}`).id,
+		minBundleId: createBundleFixture(suffix).id,
+		gitCommitHash: null,
+		buildKey: suffix === "011" ? nativeBuildKey : null,
+		artifact: {
+			kind: "ipa",
+			storageUri: `storage://read-budgets/native-builds/${suffix}/App.ipa`,
+			byteSize: 1e3
+		},
+		embeddedBundle: {
+			manifestStorageUri: `storage://bundles/${suffix}/manifest.json`,
+			manifestFileHash: `manifest-hash-${suffix}`,
+			assetBaseStorageUri: "storage://read-budgets/assets"
+		}
+	});
 	const { apiKey } = await api.apiKeys.create({ name: "Read budgets" });
 	for (let n = 1; n <= 24; n += 1) await api.insights.recordEvent(eventOf(n));
 	await api.insights.recordEvent(eventOf(25, {
@@ -3208,6 +3336,66 @@ const READ_BUDGETS = [
 			rows: 1
 		}
 	}),
+	budget({
+		api: "native build by ID: 1 point read",
+		read: ({ core }) => core.getNativeBuild(createBundleFixture("8012").id),
+		adapter: reads(1, 1, 0, 0),
+		engine: {
+			calls: 1,
+			rows: 1
+		},
+		check: (build) => expect(build).toMatchObject({ min_bundle_id: createBundleFixture("012").id })
+	}),
+	budget({
+		api: "native build by scope: byScope descending, limit 1",
+		read: ({ core }) => core.findNativeBuild(nativeBuildScope),
+		adapter: reads(0, 0, 1, 1),
+		engine: {
+			calls: 1,
+			rows: 1
+		},
+		check: (build) => expect(build).toMatchObject({ min_bundle_id: createBundleFixture("012").id })
+	}),
+	budget({
+		api: "native build by key: byBuildKey descending, limit 1",
+		read: ({ core }) => core.findNativeBuild(nativeBuildScope, { buildKey: nativeBuildKey }),
+		adapter: reads(0, 0, 1, 1),
+		engine: {
+			calls: 1,
+			rows: 1
+		},
+		check: (build) => expect(build).toMatchObject({
+			min_bundle_id: createBundleFixture("011").id,
+			build_key: nativeBuildKey
+		})
+	}),
+	budget({
+		api: "native build list: all descending, limit rows",
+		read: ({ core }) => core.listNativeBuilds({
+			order: "desc",
+			limit: 2
+		}),
+		adapter: reads(0, 0, 1, 2),
+		engine: {
+			calls: 1,
+			rows: 2
+		},
+		check: (builds) => expect(builds.map(({ min_bundle_id }) => min_bundle_id)).toEqual(["012", "011"].map((suffix) => createBundleFixture(suffix).id))
+	}),
+	budget({
+		api: "native build list of a channel: byChannel descending, limit rows",
+		read: ({ core, productionId }) => core.listNativeBuilds({
+			channelId: productionId,
+			order: "desc",
+			limit: 1
+		}),
+		adapter: reads(0, 0, 1, 1),
+		engine: {
+			calls: 1,
+			rows: 1
+		},
+		check: (builds) => expect(builds).toMatchObject([{ min_bundle_id: createBundleFixture("012").id }])
+	}),
 	budget({
 		api: "channel by name: 1 read",
 		read: ({ core }) => core.findChannelByName("staging"),
@@ -3476,15 +3664,47 @@ const READ_BUDGETS = [
 		writes: 1
 	}),
 	budget({
-		api: "channel delete: 1 read and 1 write",
+		api: "channel delete: the channel, its native builds under it, and 1 write",
 		read: ({ core, nightlyId }) => core.deleteChannel(nightlyId),
+		adapter: reads(2, 2, 1, 0),
+		engine: {
+			calls: 3,
+			rows: 2
+		},
+		writes: 1,
+		check: (result) => expect(result).toEqual({ deleted: true })
+	}),
+	budget({
+		api: "native build submission: the build and 1 write",
+		read: ({ core }) => core.recordNativeBuildSubmission(createBundleFixture("8012").id, {
+			destination: "testflight",
+			version: "1.0.0 (12)"
+		}),
 		adapter: reads(1, 1, 0, 0),
 		engine: {
 			calls: 1,
 			rows: 1
 		},
 		writes: 1,
-		check: (result) => expect(result).toEqual({ deleted: true })
+		check: (build) => expect(build).toMatchObject({
+			min_bundle_id: createBundleFixture("012").id,
+			submitted_to: "testflight",
+			submitted_version: "1.0.0 (12)"
+		})
+	}),
+	budget({
+		api: "native build delete: the build, its built-in bundle, and 1 write",
+		read: ({ core }) => core.deleteNativeBuild(createBundleFixture("8011").id),
+		adapter: reads(2, 2, 0, 0),
+		engine: {
+			calls: 2,
+			rows: 2
+		},
+		writes: 1,
+		check: (result) => expect(result).toMatchObject({
+			deleted: true,
+			nativeBuild: { min_bundle_id: createBundleFixture("011").id }
+		})
 	}),
 	budget({
 		api: "record an insights event: 2 dependent rounds of batch gets and 1 write",

package/package.json

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