@hot-updater/server 1.2.0-rc.12 → 1.2.0-rc.13

package/dist/core/api.d.cts

@@ -13,6 +13,8 @@ declare const createCoreApi: (db: CoreDatabase, storage: CoreStorage, options?:
   getNativeBuild: (id: string) => Promise<import("@hot-updater/plugin-core").NativeBuildRow | null>;
   findNativeBuild: (scope: import("@hot-updater/plugin-core").NativeBuildScope, options?: {
     readonly buildKey?: string;
+    readonly storeBuild?: true;
+    readonly builtInOlderThan?: string;
   }) => Promise<import("@hot-updater/plugin-core").NativeBuildRow | null>;
   listNativeBuilds: (input: import("@hot-updater/plugin-core").KeysetInput & {
     readonly channelId?: string;
@@ -22,6 +24,9 @@ declare const createCoreApi: (db: CoreDatabase, storage: CoreStorage, options?:
     readonly destination: import("@hot-updater/plugin-core").NativeBuildSubmissionDestination;
     readonly version: string;
   }) => Promise<import("@hot-updater/plugin-core").NativeBuildRow | null>;
+  markNativeBuild: (id: string, mark: {
+    readonly storeBuild: boolean;
+  }) => Promise<import("@hot-updater/plugin-core").NativeBuildMarkResult | null>;
   deploy: (deployments: readonly import("@hot-updater/plugin-core").Deployment[]) => Promise<import("@hot-updater/plugin-core").ReleaseCatalogMutationResult[]>;
   updateReleasePolicy: (input: import("@hot-updater/plugin-core").ReleaseTarget & {
     readonly patch: import("@hot-updater/plugin-core").ReleasePolicyPatch;

package/dist/core/api.d.mts

@@ -13,6 +13,8 @@ declare const createCoreApi: (db: CoreDatabase, storage: CoreStorage, options?:
   getNativeBuild: (id: string) => Promise<import("@hot-updater/plugin-core").NativeBuildRow | null>;
   findNativeBuild: (scope: import("@hot-updater/plugin-core").NativeBuildScope, options?: {
     readonly buildKey?: string;
+    readonly storeBuild?: true;
+    readonly builtInOlderThan?: string;
   }) => Promise<import("@hot-updater/plugin-core").NativeBuildRow | null>;
   listNativeBuilds: (input: import("@hot-updater/plugin-core").KeysetInput & {
     readonly channelId?: string;
@@ -22,6 +24,9 @@ declare const createCoreApi: (db: CoreDatabase, storage: CoreStorage, options?:
     readonly destination: import("@hot-updater/plugin-core").NativeBuildSubmissionDestination;
     readonly version: string;
   }) => Promise<import("@hot-updater/plugin-core").NativeBuildRow | null>;
+  markNativeBuild: (id: string, mark: {
+    readonly storeBuild: boolean;
+  }) => Promise<import("@hot-updater/plugin-core").NativeBuildMarkResult | null>;
   deploy: (deployments: readonly import("@hot-updater/plugin-core").Deployment[]) => Promise<import("@hot-updater/plugin-core").ReleaseCatalogMutationResult[]>;
   updateReleasePolicy: (input: import("@hot-updater/plugin-core").ReleaseTarget & {
     readonly patch: import("@hot-updater/plugin-core").ReleasePolicyPatch;

package/dist/core/nativeBuilds.cjs

@@ -39,8 +39,22 @@ const pick = (row) => ({
 	build_number: row.build_number ?? null,
 	submitted_to: row.submitted_to ?? null,
 	submitted_at_ms: row.submitted_at_ms ?? null,
-	submitted_version: row.submitted_version ?? null
+	submitted_version: row.submitted_version ?? null,
+	store_build: row.store_build === true ? true : null
 });
+/**
+* The channels only sandbox builds register on, which no store sells: the
+* registry's convention, as `@hot-updater/protocol/native-artifact` checks it
+* for a build's artifact.
+*/
+const SANDBOX_CHANNEL_PREFIX = "sandbox-";
+/**
+* How many older builds of a scope one read takes, looking for one older than
+* a bundle when a build made after the bundle is the newest.
+*/
+const OLDER_BUILDS_PAGE = 20;
+/** How many times a mark runs again after losing its scope's mark to another. */
+const MARK_ATTEMPTS = 8;
 /** The store track each platform's builds are submitted to. */
 const SUBMISSION_DESTINATIONS = {
 	android: "play-internal",
@@ -117,7 +131,8 @@ const createNativeBuildApi = (db, { now = Date.now } = {}) => ({
 			build_number: registration.buildNumber ?? null,
 			submitted_to: null,
 			submitted_at_ms: null,
-			submitted_version: null
+			submitted_version: null,
+			store_build: null
 		};
 		for (let attempt = 1;; attempt += 1) {
 			await require_writes.insertChannel(db, {
@@ -155,21 +170,45 @@ const createNativeBuildApi = (db, { now = Date.now } = {}) => ({
 		const scopeKey = nativeBuildScopeKey(scope);
 		const buildKey = options?.buildKey;
 		if (buildKey !== void 0 && !BUILD_KEY.test(buildKey)) throw new NativeBuildInputError("Invalid native build key: it must be nbk1: and a SHA-256.");
-		const { rows } = buildKey === void 0 ? await db.findMany("native_builds", {
-			index: "byScope",
-			where: { scope_key: scopeKey },
-			order: "desc",
-			limit: 1
-		}) : await db.findMany("native_builds", {
-			index: "byBuildKey",
-			where: {
+		if (options?.storeBuild) {
+			const marked = await db.findOne("native_builds", {
 				scope_key: scopeKey,
-				build_key: buildKey
-			},
-			order: "desc",
-			limit: 1
-		});
-		return rows[0] === void 0 ? null : pick(rows[0]);
+				store_build: true
+			});
+			return marked === null ? null : pick(marked);
+		}
+		const read = (limit, before) => {
+			const page = {
+				order: "desc",
+				limit,
+				...before === void 0 ? {} : { range: { lt: before } }
+			};
+			return buildKey === void 0 ? db.findMany("native_builds", {
+				index: "byScope",
+				where: { scope_key: scopeKey },
+				...page
+			}) : db.findMany("native_builds", {
+				index: "byBuildKey",
+				where: {
+					scope_key: scopeKey,
+					build_key: buildKey
+				},
+				...page
+			});
+		};
+		const { rows } = await read(1);
+		const newest = rows[0];
+		if (newest === void 0) return null;
+		const bundleId = options?.builtInOlderThan;
+		if (bundleId === void 0 || newest.min_bundle_id < bundleId) return pick(newest);
+		for (let before = newest.id;;) {
+			const { rows: older } = await read(OLDER_BUILDS_PAGE, before);
+			const usable = older.find(({ min_bundle_id }) => min_bundle_id < bundleId);
+			if (usable !== void 0) return pick(usable);
+			const last = older.at(-1);
+			if (older.length < OLDER_BUILDS_PAGE || last === void 0) return null;
+			before = last.id;
+		}
 	},
 	async recordNativeBuildSubmission(id, { destination, version }) {
 		if (version.trim().length === 0 || version.length > SUBMITTED_VERSION_MAX_LENGTH) throw new NativeBuildInputError(`Invalid native build submission: version must be the store's label of the build, up to ${SUBMITTED_VERSION_MAX_LENGTH} characters.`);
@@ -190,6 +229,49 @@ const createNativeBuildApi = (db, { now = Date.now } = {}) => ({
 			};
 		});
 	},
+	async markNativeBuild(id, { storeBuild }) {
+		for (let attempt = 1;; attempt += 1) try {
+			return await db.transaction(async (tx) => {
+				const row = await tx.findOne("native_builds", { id });
+				if (row === null) return null;
+				const build = pick(row);
+				if (!storeBuild) {
+					if (build.store_build !== null) tx.update("native_builds", row, { store_build: null });
+					return {
+						nativeBuild: {
+							...build,
+							store_build: null
+						},
+						previous: null
+					};
+				}
+				if ((0, _hot_updater_protocol.decodeChannelKey)(build.channel_id.slice(8)).startsWith(SANDBOX_CHANNEL_PREFIX)) throw new NativeBuildInputError("A build on a sandbox channel can't be the store build.");
+				if (build.store_build !== null) return {
+					nativeBuild: build,
+					previous: null
+				};
+				const holder = await tx.findOne("native_builds", {
+					scope_key: build.scope_key,
+					store_build: true
+				});
+				if (holder !== null) tx.update("native_builds", holder, { store_build: null });
+				tx.update("native_builds", row, { store_build: true });
+				return {
+					nativeBuild: {
+						...build,
+						store_build: true
+					},
+					previous: holder === null ? null : {
+						...pick(holder),
+						store_build: null
+					}
+				};
+			});
+		} catch (error) {
+			if (attempt < MARK_ATTEMPTS && error instanceof _hot_updater_plugin_core.DatabaseConstraintError && error.reason === "unique") continue;
+			throw error;
+		}
+	},
 	async deleteNativeBuild(id) {
 		return db.transaction(async (tx) => {
 			const row = await tx.findOne("native_builds", { id });

package/dist/core/nativeBuilds.mjs

@@ -1,7 +1,7 @@
 import { after } from "./reads.mjs";
 import { insertChannel } from "./writes.mjs";
 import { DatabaseConstraintError, isUUIDv7 } from "@hot-updater/plugin-core";
-import { createReleaseCatalogScopeKey, encodeChannelKey } from "@hot-updater/protocol";
+import { createReleaseCatalogScopeKey, decodeChannelKey, encodeChannelKey } from "@hot-updater/protocol";
 //#region src/core/nativeBuilds.ts
 /** The artifacts each platform's build produces. */
 const ARTIFACT_KINDS = {
@@ -39,8 +39,22 @@ const pick = (row) => ({
 	build_number: row.build_number ?? null,
 	submitted_to: row.submitted_to ?? null,
 	submitted_at_ms: row.submitted_at_ms ?? null,
-	submitted_version: row.submitted_version ?? null
+	submitted_version: row.submitted_version ?? null,
+	store_build: row.store_build === true ? true : null
 });
+/**
+* The channels only sandbox builds register on, which no store sells: the
+* registry's convention, as `@hot-updater/protocol/native-artifact` checks it
+* for a build's artifact.
+*/
+const SANDBOX_CHANNEL_PREFIX = "sandbox-";
+/**
+* How many older builds of a scope one read takes, looking for one older than
+* a bundle when a build made after the bundle is the newest.
+*/
+const OLDER_BUILDS_PAGE = 20;
+/** How many times a mark runs again after losing its scope's mark to another. */
+const MARK_ATTEMPTS = 8;
 /** The store track each platform's builds are submitted to. */
 const SUBMISSION_DESTINATIONS = {
 	android: "play-internal",
@@ -117,7 +131,8 @@ const createNativeBuildApi = (db, { now = Date.now } = {}) => ({
 			build_number: registration.buildNumber ?? null,
 			submitted_to: null,
 			submitted_at_ms: null,
-			submitted_version: null
+			submitted_version: null,
+			store_build: null
 		};
 		for (let attempt = 1;; attempt += 1) {
 			await insertChannel(db, {
@@ -155,21 +170,45 @@ const createNativeBuildApi = (db, { now = Date.now } = {}) => ({
 		const scopeKey = nativeBuildScopeKey(scope);
 		const buildKey = options?.buildKey;
 		if (buildKey !== void 0 && !BUILD_KEY.test(buildKey)) throw new NativeBuildInputError("Invalid native build key: it must be nbk1: and a SHA-256.");
-		const { rows } = buildKey === void 0 ? await db.findMany("native_builds", {
-			index: "byScope",
-			where: { scope_key: scopeKey },
-			order: "desc",
-			limit: 1
-		}) : await db.findMany("native_builds", {
-			index: "byBuildKey",
-			where: {
+		if (options?.storeBuild) {
+			const marked = await db.findOne("native_builds", {
 				scope_key: scopeKey,
-				build_key: buildKey
-			},
-			order: "desc",
-			limit: 1
-		});
-		return rows[0] === void 0 ? null : pick(rows[0]);
+				store_build: true
+			});
+			return marked === null ? null : pick(marked);
+		}
+		const read = (limit, before) => {
+			const page = {
+				order: "desc",
+				limit,
+				...before === void 0 ? {} : { range: { lt: before } }
+			};
+			return buildKey === void 0 ? db.findMany("native_builds", {
+				index: "byScope",
+				where: { scope_key: scopeKey },
+				...page
+			}) : db.findMany("native_builds", {
+				index: "byBuildKey",
+				where: {
+					scope_key: scopeKey,
+					build_key: buildKey
+				},
+				...page
+			});
+		};
+		const { rows } = await read(1);
+		const newest = rows[0];
+		if (newest === void 0) return null;
+		const bundleId = options?.builtInOlderThan;
+		if (bundleId === void 0 || newest.min_bundle_id < bundleId) return pick(newest);
+		for (let before = newest.id;;) {
+			const { rows: older } = await read(OLDER_BUILDS_PAGE, before);
+			const usable = older.find(({ min_bundle_id }) => min_bundle_id < bundleId);
+			if (usable !== void 0) return pick(usable);
+			const last = older.at(-1);
+			if (older.length < OLDER_BUILDS_PAGE || last === void 0) return null;
+			before = last.id;
+		}
 	},
 	async recordNativeBuildSubmission(id, { destination, version }) {
 		if (version.trim().length === 0 || version.length > SUBMITTED_VERSION_MAX_LENGTH) throw new NativeBuildInputError(`Invalid native build submission: version must be the store's label of the build, up to ${SUBMITTED_VERSION_MAX_LENGTH} characters.`);
@@ -190,6 +229,49 @@ const createNativeBuildApi = (db, { now = Date.now } = {}) => ({
 			};
 		});
 	},
+	async markNativeBuild(id, { storeBuild }) {
+		for (let attempt = 1;; attempt += 1) try {
+			return await db.transaction(async (tx) => {
+				const row = await tx.findOne("native_builds", { id });
+				if (row === null) return null;
+				const build = pick(row);
+				if (!storeBuild) {
+					if (build.store_build !== null) tx.update("native_builds", row, { store_build: null });
+					return {
+						nativeBuild: {
+							...build,
+							store_build: null
+						},
+						previous: null
+					};
+				}
+				if (decodeChannelKey(build.channel_id.slice(8)).startsWith(SANDBOX_CHANNEL_PREFIX)) throw new NativeBuildInputError("A build on a sandbox channel can't be the store build.");
+				if (build.store_build !== null) return {
+					nativeBuild: build,
+					previous: null
+				};
+				const holder = await tx.findOne("native_builds", {
+					scope_key: build.scope_key,
+					store_build: true
+				});
+				if (holder !== null) tx.update("native_builds", holder, { store_build: null });
+				tx.update("native_builds", row, { store_build: true });
+				return {
+					nativeBuild: {
+						...build,
+						store_build: true
+					},
+					previous: holder === null ? null : {
+						...pick(holder),
+						store_build: null
+					}
+				};
+			});
+		} catch (error) {
+			if (attempt < MARK_ATTEMPTS && error instanceof DatabaseConstraintError && error.reason === "unique") continue;
+			throw error;
+		}
+	},
 	async deleteNativeBuild(id) {
 		return db.transaction(async (tx) => {
 			const row = await tx.findOne("native_builds", { id });

package/dist/createHotUpdaterCore.d.cts

@@ -42,10 +42,8 @@ type RuntimeHotUpdaterAPI<TPlugins extends readonly AnyHotUpdaterPlugin[] = read
   /** The database's name, which `hot-updater db` commands read. */
   readonly adapterName: string;
   /**
-   * Applies aggregate changes the database batches that are still pending:
-   * this process's buffer, and the log rows no compaction has merged yet.
-   * A long-lived server with `aggregateBatching: { mode: "memory" }` calls
-   * it before it exits.
+   * Applies the log rows of batched aggregates that no compaction has merged
+   * yet. Nothing waits on it: they are durable, and a read compacts first.
    */
   readonly flush: () => Promise<void>;
   /**

package/dist/createHotUpdaterCore.d.mts

@@ -42,10 +42,8 @@ type RuntimeHotUpdaterAPI<TPlugins extends readonly AnyHotUpdaterPlugin[] = read
   /** The database's name, which `hot-updater db` commands read. */
   readonly adapterName: string;
   /**
-   * Applies aggregate changes the database batches that are still pending:
-   * this process's buffer, and the log rows no compaction has merged yet.
-   * A long-lived server with `aggregateBatching: { mode: "memory" }` calls
-   * it before it exits.
+   * Applies the log rows of batched aggregates that no compaction has merged
+   * yet. Nothing waits on it: they are durable, and a read compacts first.
    */
   readonly flush: () => Promise<void>;
   /**

package/dist/handlerAdminRoutes.cjs

@@ -298,7 +298,13 @@ const createAdminRouteHandlers = () => ({
 		const url = new URL(request.url);
 		const scope = nativeBuildScopeOf(url);
 		const buildKey = url.searchParams.get("buildKey");
-		return json({ data: await refusingInvalid(() => buildKey === null ? core.findNativeBuild(scope) : core.findNativeBuild(scope, { buildKey })) });
+		const builtInOlderThan = url.searchParams.get("builtInOlderThan");
+		const options = {
+			...buildKey === null ? {} : { buildKey },
+			...url.searchParams.get("storeBuild") === "true" ? { storeBuild: true } : {},
+			...builtInOlderThan === null ? {} : { builtInOlderThan }
+		};
+		return json({ data: await refusingInvalid(() => Object.keys(options).length === 0 ? core.findNativeBuild(scope) : core.findNativeBuild(scope, options)) });
 	}),
 	getNativeBuild: onCore(async (core, _request, params) => json({ data: await core.getNativeBuild(require_handlerParameters.requireRouteParam(params, "id")) })),
 	listNativeBuilds: onCore(async (core, request) => {
@@ -319,6 +325,12 @@ const createAdminRouteHandlers = () => ({
 		};
 		return json({ data: await refusingInvalid(() => core.recordNativeBuildSubmission(require_handlerParameters.requireRouteParam(params, "id"), submission)) });
 	}),
+	markNativeBuild: onCore(async (core, request, params) => {
+		const input = await body(request);
+		if (!isRecord(input) || typeof input.storeBuild !== "boolean") throw new require_handlerErrors.HandlerBadRequestError("A native build's store build mark needs storeBuild, true or false.");
+		const mark = { storeBuild: input.storeBuild };
+		return json({ data: await refusingInvalid(() => core.markNativeBuild(require_handlerParameters.requireRouteParam(params, "id"), mark)) });
+	}),
 	deleteNativeBuild: onCore(async (core, _request, params) => json({ data: await core.deleteNativeBuild(require_handlerParameters.requireRouteParam(params, "id")) })),
 	deleteBundles: onCore(async (core, request) => {
 		const { ids } = await body(request);
@@ -464,6 +476,11 @@ const ADMIN_ROUTES = [
 		path: "/native-builds/:id/submission",
 		handler: "recordNativeBuildSubmission"
 	},
+	{
+		method: "POST",
+		path: "/native-builds/:id/store-build",
+		handler: "markNativeBuild"
+	},
 	{
 		method: "DELETE",
 		path: "/native-builds/:id",

package/dist/handlerAdminRoutes.mjs

@@ -298,7 +298,13 @@ const createAdminRouteHandlers = () => ({
 		const url = new URL(request.url);
 		const scope = nativeBuildScopeOf(url);
 		const buildKey = url.searchParams.get("buildKey");
-		return json({ data: await refusingInvalid(() => buildKey === null ? core.findNativeBuild(scope) : core.findNativeBuild(scope, { buildKey })) });
+		const builtInOlderThan = url.searchParams.get("builtInOlderThan");
+		const options = {
+			...buildKey === null ? {} : { buildKey },
+			...url.searchParams.get("storeBuild") === "true" ? { storeBuild: true } : {},
+			...builtInOlderThan === null ? {} : { builtInOlderThan }
+		};
+		return json({ data: await refusingInvalid(() => Object.keys(options).length === 0 ? core.findNativeBuild(scope) : core.findNativeBuild(scope, options)) });
 	}),
 	getNativeBuild: onCore(async (core, _request, params) => json({ data: await core.getNativeBuild(requireRouteParam(params, "id")) })),
 	listNativeBuilds: onCore(async (core, request) => {
@@ -319,6 +325,12 @@ const createAdminRouteHandlers = () => ({
 		};
 		return json({ data: await refusingInvalid(() => core.recordNativeBuildSubmission(requireRouteParam(params, "id"), submission)) });
 	}),
+	markNativeBuild: onCore(async (core, request, params) => {
+		const input = await body(request);
+		if (!isRecord(input) || typeof input.storeBuild !== "boolean") throw new HandlerBadRequestError("A native build's store build mark needs storeBuild, true or false.");
+		const mark = { storeBuild: input.storeBuild };
+		return json({ data: await refusingInvalid(() => core.markNativeBuild(requireRouteParam(params, "id"), mark)) });
+	}),
 	deleteNativeBuild: onCore(async (core, _request, params) => json({ data: await core.deleteNativeBuild(requireRouteParam(params, "id")) })),
 	deleteBundles: onCore(async (core, request) => {
 		const { ids } = await body(request);
@@ -464,6 +476,11 @@ const ADMIN_ROUTES = [
 		path: "/native-builds/:id/submission",
 		handler: "recordNativeBuildSubmission"
 	},
+	{
+		method: "POST",
+		path: "/native-builds/:id/store-build",
+		handler: "markNativeBuild"
+	},
 	{
 		method: "DELETE",
 		path: "/native-builds/:id",

package/dist/package.cjs

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "1.2.0-rc.12";
+var version = "1.2.0-rc.13";
 //#endregion
 Object.defineProperty(exports, "version", {
 	enumerable: true,

package/dist/package.mjs

@@ -1,4 +1,4 @@
 //#region package.json
-var version = "1.2.0-rc.12";
+var version = "1.2.0-rc.13";
 //#endregion
 export { version };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hot-updater/server",
-  "version": "1.2.0-rc.12",
+  "version": "1.2.0-rc.13",
   "type": "module",
   "description": "React Native OTA solution for self-hosted",
   "sideEffects": false,
@@ -50,11 +50,11 @@
   "dependencies": {
     "rou3": "0.7.9",
     "verkit": "0.4.0",
-    "@hot-updater/protocol": "1.2.0-rc.12",
-    "@hot-updater/plugin-core": "1.2.0-rc.12",
-    "@hot-updater/plugin-api-keys": "1.2.0-rc.12",
-    "@hot-updater/plugin-insights": "1.2.0-rc.12",
-    "@hot-updater/plugin-remote-config": "1.2.0-rc.12"
+    "@hot-updater/protocol": "1.2.0-rc.13",
+    "@hot-updater/plugin-insights": "1.2.0-rc.13",
+    "@hot-updater/plugin-core": "1.2.0-rc.13",
+    "@hot-updater/plugin-remote-config": "1.2.0-rc.13",
+    "@hot-updater/plugin-api-keys": "1.2.0-rc.13"
   },
   "peerDependencies": {
     "@prisma/client": "*",