hot-updater 0.30.12 → 0.31.0

package/dist/index.mjs

@@ -25,8 +25,11 @@ import { finished } from "node:stream/promises";
 import { Duplex, PassThrough, Readable, Transform, Writable, getDefaultHighWaterMark } from "node:stream";
 import { Buffer as Buffer$1 } from "node:buffer";
 import { SourceSkips, createFingerprintAsync, diffFingerprintChangesAsync } from "@expo/fingerprint";
+import { brotliCompress, constants as constants$1 } from "zlib";
+import { assertNodeStoragePlugin } from "@hot-updater/plugin-core";
+import { createBundleDiff } from "@hot-updater/server";
 import net from "node:net";
-import fs$3, { constants as constants$1 } from "node:fs/promises";
+import fs$3, { constants as constants$2 } from "node:fs/promises";
 import crypto$1 from "node:crypto";
 import { Kysely, MysqlDialect, PostgresDialect, SqliteDialect } from "kysely";
 import { format } from "sql-formatter";
@@ -47497,7 +47500,7 @@ const getWslDrivesMountPoint = (() => {
 		const configFilePath = "/etc/wsl.conf";
 		let isConfigFileExists = false;
 		try {
-			await fs$3.access(configFilePath, constants$1.F_OK);
+			await fs$3.access(configFilePath, constants$2.F_OK);
 			isConfigFileExists = true;
 		} catch {}
 		if (!isConfigFileExists) return defaultMountPoint;
@@ -47599,7 +47602,7 @@ const baseOpen = async (options) => {
 			const isBundled = !__dirname || __dirname === "/";
 			let exeLocalXdgOpen = false;
 			try {
-				await fs$3.access(localXdgOpenPath, constants$1.X_OK);
+				await fs$3.access(localXdgOpenPath, constants$2.X_OK);
 				exeLocalXdgOpen = true;
 			} catch {}
 			command = process$1.versions.electron ?? (platform$1 === "android" || isBundled || !exeLocalXdgOpen) ? "xdg-open" : localXdgOpenPath;
@@ -47759,15 +47762,23 @@ const getFileHashFromFile = async (filepath) => {
 };
 //#endregion
 //#region src/utils/bundleManifest.ts
-const createBundleManifest = async ({ bundleId, targetFiles }) => {
+const createBundleManifest = async ({ bundleId, signFileHash, targetFiles }) => {
 	return {
 		bundleId,
-		assets: Object.fromEntries(await Promise.all([...targetFiles].sort((left, right) => left.name.localeCompare(right.name)).map(async (target) => [target.name, { fileHash: await getFileHashFromFile(target.path) }])))
+		assets: Object.fromEntries(await Promise.all([...targetFiles].sort((left, right) => left.name.localeCompare(right.name)).map(async (target) => {
+			const fileHash = await getFileHashFromFile(target.path);
+			const signature = signFileHash ? await signFileHash(fileHash) : void 0;
+			return [target.name, {
+				fileHash,
+				...signature ? { signature } : {}
+			}];
+		})))
 	};
 };
-const writeBundleManifest = async ({ buildPath, bundleId, targetFiles }) => {
+const writeBundleManifest = async ({ buildPath, bundleId, signFileHash, targetFiles }) => {
 	const manifest = await createBundleManifest({
 		bundleId,
+		signFileHash,
 		targetFiles
 	});
 	const manifestPath = path$1.join(buildPath, "manifest.json");
@@ -48035,6 +48046,7 @@ const getDefaultTargetAppVersion = async (platform) => {
 };
 //#endregion
 //#region src/commands/deploy.ts
+const compressBrotli = promisify(brotliCompress);
 const normalizeRolloutPercentage = (rollout) => {
 	if (rollout === void 0) return 100;
 	const parsedRollout = typeof rollout === "number" ? rollout : Number(rollout);
@@ -48044,6 +48056,64 @@ const normalizeRolloutPercentage = (rollout) => {
 const getRolloutCohortCountFromPercentage = (rolloutPercentage) => {
 	return rolloutPercentage * 10;
 };
+const normalizePatchMaxBaseBundles = (maxBaseBundles) => {
+	if (maxBaseBundles === void 0) return 3;
+	if (!Number.isInteger(maxBaseBundles) || maxBaseBundles < 1) throw new Error("Patch maxBaseBundles must be a positive integer");
+	return maxBaseBundles;
+};
+const getPatchBaseBundles = async ({ bundleId, channel, databasePlugin, maxBaseBundles, platform, target }) => {
+	const where = {
+		channel,
+		enabled: true,
+		id: { lt: bundleId },
+		platform,
+		...target.fingerprintHash ? { fingerprintHash: target.fingerprintHash } : {
+			targetAppVersion: target.appVersion,
+			targetAppVersionNotNull: true
+		}
+	};
+	const { data } = await databasePlugin.getBundles({
+		limit: maxBaseBundles,
+		orderBy: {
+			direction: "desc",
+			field: "id"
+		},
+		where
+	});
+	return data.filter((bundle) => bundle.id !== bundleId).slice(0, maxBaseBundles);
+};
+const createAutoPatches = async ({ bundleId, channel, databasePlugin, maxBaseBundles, platform, storagePlugin, target }) => {
+	const baseBundles = await getPatchBaseBundles({
+		bundleId,
+		channel,
+		databasePlugin,
+		maxBaseBundles,
+		platform,
+		target
+	});
+	const failures = [];
+	let createdCount = 0;
+	for (const baseBundle of baseBundles) try {
+		await createBundleDiff({
+			baseBundleId: baseBundle.id,
+			bundleId
+		}, {
+			databasePlugin,
+			storagePlugin
+		}, { makePrimary: createdCount === 0 });
+		createdCount += 1;
+	} catch (error) {
+		failures.push({
+			baseBundleId: baseBundle.id,
+			message: error instanceof Error ? error.message : "Unknown patch error"
+		});
+	}
+	return {
+		candidateCount: baseBundles.length,
+		createdCount,
+		failures
+	};
+};
 const getExtensionFromCompressStrategy = (compressStrategy) => {
 	switch (compressStrategy) {
 		case "tar.br": return ".tar.br";
@@ -48052,6 +48122,33 @@ const getExtensionFromCompressStrategy = (compressStrategy) => {
 		default: throw new Error(`Unsupported compress strategy: ${compressStrategy}`);
 	}
 };
+const getRelativeStorageDir = (relativePath) => {
+	const normalized = relativePath.replace(/\\/g, "/");
+	const dirname = path$1.posix.dirname(normalized);
+	return dirname === "." ? "" : dirname;
+};
+const isBrotliManifestBundleAsset = (relativePath) => /(^|\/)index\.[^/]+\.bundle$/.test(relativePath.replace(/\\/g, "/"));
+const replaceStorageUriLeaf = (storageUri, nextLeaf) => {
+	const storageUrl = new URL(storageUri);
+	const normalizedPath = storageUrl.pathname.replace(/\/+$/, "");
+	const lastSlashIndex = normalizedPath.lastIndexOf("/");
+	storageUrl.pathname = `${lastSlashIndex >= 0 ? normalizedPath.slice(0, lastSlashIndex) : ""}/${nextLeaf}`;
+	return storageUrl.toString();
+};
+const ensureUploadSourcePath = async ({ outputPath, targetFile }) => {
+	const uploadName = isBrotliManifestBundleAsset(targetFile.name) ? `${targetFile.name}.br` : targetFile.name;
+	const expectedFilename = path$1.posix.basename(uploadName);
+	const actualFilename = path$1.basename(targetFile.path);
+	if (uploadName === targetFile.name && expectedFilename === actualFilename) return targetFile.path;
+	const aliasDir = path$1.join(outputPath, "upload-artifacts", getRelativeStorageDir(uploadName));
+	await fs$2.promises.mkdir(aliasDir, { recursive: true });
+	const aliasPath = path$1.join(aliasDir, expectedFilename);
+	if (uploadName !== targetFile.name) {
+		const source = await fs$2.promises.readFile(targetFile.path);
+		await fs$2.promises.writeFile(aliasPath, await compressBrotli(source, { params: { [constants$1.BROTLI_PARAM_QUALITY]: 11 } }));
+	} else await fs$2.promises.copyFile(targetFile.path, aliasPath);
+	return aliasPath;
+};
 const getPlatformName = (platform) => platform === "ios" ? "iOS" : "Android";
 const getDeployPlatforms = async (options) => {
 	if (options.platform) return [options.platform];
@@ -48099,6 +48196,7 @@ const deployPlatform = async ({ options, platform, platformIndex, platformCount
 		console.error("No config found. Please run `hot-updater init` first.");
 		process.exit(1);
 	}
+	const maxPatchBaseBundles = config.patch.enabled ? normalizePatchMaxBaseBundles(config.patch.maxBaseBundles) : 0;
 	const signingValidation = await validateSigningConfig(config);
 	if (signingValidation.issues.length > 0) {
 		const errors = signingValidation.issues.filter((i) => i.type === "error");
@@ -48180,6 +48278,7 @@ const deployPlatform = async ({ options, platform, platformIndex, platformCount
 	const outputPath = options.bundleOutputPath ?? HotUpdateDirUtil.getDefaultOutputPath({ cwd });
 	let bundleId = null;
 	let fileHash;
+	let manifestFileHash = null;
 	const platformName = getPlatformName(platform);
 	const outputRoot = getBundleOutputRoot({
 		cwd,
@@ -48204,9 +48303,14 @@ const deployPlatform = async ({ options, platform, platformIndex, platformCount
 		config.storage(),
 		config.database()
 	]);
+	assertNodeStoragePlugin(storagePlugin);
 	try {
 		const taskRef = {
 			buildResult: null,
+			targetFiles: [],
+			manifestPath: null,
+			manifestStorageUri: null,
+			assetBaseStorageUri: null,
 			storageUri: null
 		};
 		await p.tasks([{
@@ -48222,12 +48326,15 @@ const deployPlatform = async ({ options, platform, platformIndex, platformCount
 				const { manifestPath } = await writeBundleManifest({
 					buildPath,
 					bundleId: currentBundleId,
+					signFileHash: config.signing?.enabled && config.signing.privateKeyPath ? (assetFileHash) => signBundle(assetFileHash, config.signing.privateKeyPath) : void 0,
 					targetFiles
 				});
 				const bundleTargetFiles = [...targetFiles, {
 					path: manifestPath,
 					name: "manifest.json"
 				}];
+				taskRef.targetFiles = targetFiles;
+				taskRef.manifestPath = manifestPath;
 				switch (compressStrategy) {
 					case "tar.br":
 						await createTarBrTargetFiles({
@@ -48260,6 +48367,11 @@ const deployPlatform = async ({ options, platform, platformIndex, platformCount
 						throw error;
 					}
 				}
+				manifestFileHash = await getFileHashFromFile(manifestPath);
+				if (config.signing?.enabled) {
+					if (!config.signing.privateKeyPath) throw new Error("privateKeyPath is required when signing is enabled. Please provide a valid path to your RSA private key in hot-updater.config.ts");
+					manifestFileHash = createSignedFileHash(await signBundle(manifestFileHash, config.signing.privateKeyPath));
+				}
 				return `✅ Build Complete (${buildPlugin.name})`;
 			}
 		}]);
@@ -48270,8 +48382,25 @@ const deployPlatform = async ({ options, platform, platformIndex, platformCount
 			task: async () => {
 				if (!bundleId) throw new Error("Bundle ID not found");
 				try {
-					const { storageUri } = await storagePlugin.upload(bundleId, bundlePath);
+					const { storageUri } = await storagePlugin.profiles.node.upload(bundleId, bundlePath);
 					taskRef.storageUri = storageUri;
+					if (!taskRef.manifestPath) throw new Error("Manifest path not found");
+					const manifestUpload = await storagePlugin.profiles.node.upload(bundleId, taskRef.manifestPath);
+					taskRef.manifestStorageUri = manifestUpload.storageUri;
+					taskRef.assetBaseStorageUri = replaceStorageUriLeaf(manifestUpload.storageUri, "files");
+					await Promise.all(taskRef.targetFiles.map(async (targetFile) => {
+						const relativeDir = getRelativeStorageDir(isBrotliManifestBundleAsset(targetFile.name) ? `${targetFile.name}.br` : targetFile.name);
+						const uploadKey = [
+							bundleId,
+							"files",
+							relativeDir
+						].filter(Boolean).join("/");
+						const uploadSourcePath = await ensureUploadSourcePath({
+							outputPath: outputRoot,
+							targetFile
+						});
+						return storagePlugin.profiles.node.upload(uploadKey, uploadSourcePath);
+					}));
 				} catch (e) {
 					if (e instanceof Error) p.log.error(e.message);
 					throw new Error("Failed to upload bundle to storage");
@@ -48283,6 +48412,7 @@ const deployPlatform = async ({ options, platform, platformIndex, platformCount
 			task: async () => {
 				if (!bundleId) throw new Error("Bundle ID not found");
 				if (!taskRef.storageUri) throw new Error("Storage URI not found");
+				if (!manifestFileHash) throw new Error("Manifest file hash not found");
 				const appVersion = await getNativeAppVersion(platform);
 				try {
 					await databasePlugin.appendBundle({
@@ -48298,6 +48428,9 @@ const deployPlatform = async ({ options, platform, platformIndex, platformCount
 						fingerprintHash: target.fingerprintHash,
 						storageUri: taskRef.storageUri,
 						metadata: appVersion ? { app_version: appVersion } : {},
+						assetBaseStorageUri: taskRef.assetBaseStorageUri,
+						manifestFileHash,
+						manifestStorageUri: taskRef.manifestStorageUri,
 						rolloutCohortCount
 					});
 					await databasePlugin.commitBundle();
@@ -48305,18 +48438,53 @@ const deployPlatform = async ({ options, platform, platformIndex, platformCount
 					if (e instanceof Error) p.log.error(e.message);
 					throw e;
 				}
-				await databasePlugin.onUnmount?.();
 				return `✅ Update Complete (${databasePlugin.name})`;
 			}
 		}]);
 		if (!bundleId) throw new Error("Bundle ID not found");
+		const confirmedBundleId = bundleId;
+		if (config.patch.enabled) {
+			let patchSummary = {
+				candidateCount: 0,
+				createdCount: 0,
+				failures: []
+			};
+			await p.tasks([{
+				title: "⚡ Optimizing Delivery",
+				task: async () => {
+					try {
+						patchSummary = await createAutoPatches({
+							bundleId: confirmedBundleId,
+							channel,
+							databasePlugin,
+							maxBaseBundles: maxPatchBaseBundles,
+							platform,
+							storagePlugin,
+							target
+						});
+					} catch (error) {
+						const message = error instanceof Error ? error.message : "Unknown patch optimization error";
+						p.log.warn(`Partial updates unavailable: ${message}`);
+						patchSummary = {
+							candidateCount: 0,
+							createdCount: 0,
+							failures: []
+						};
+					}
+					if (!patchSummary.candidateCount) return "Skipped (no compatible base bundles)";
+					if (!patchSummary.createdCount) return "Skipped (no patch artifacts created)";
+					return `✅ Prepared ${patchSummary.createdCount} partial update path(s)`;
+				}
+			}]);
+			for (const failure of patchSummary.failures) p.log.warn(`Partial update skipped for ${failure.baseBundleId.slice(0, 8)}: ${failure.message}`);
+		}
 		if (options.interactive) {
 			const port = await getConsolePort(config);
 			const isConsoleOpen = await isPortReachable(port, { host: "localhost" });
 			const openUrl = new URL(`http://localhost:${port}`);
 			openUrl.searchParams.set("channel", channel);
 			openUrl.searchParams.set("platform", platform);
-			openUrl.searchParams.set("bundleId", bundleId);
+			openUrl.searchParams.set("bundleId", confirmedBundleId);
 			const url = openUrl.toString();
 			const note = `Console: ${url}`;
 			if (!isConsoleOpen) {
@@ -48331,15 +48499,15 @@ const deployPlatform = async ({ options, platform, platformIndex, platformCount
 			p.note(note);
 		}
 		if (multiPlatform) {
-			p.log.success(`✅ ${platformName} Deployment Successful (${bundleId})`);
+			p.log.success(`✅ ${platformName} Deployment Successful (${confirmedBundleId})`);
 			return {
-				bundleId,
+				bundleId: confirmedBundleId,
 				platform
 			};
 		}
-		p.outro(`🚀 Deployment Successful (${bundleId})`);
+		p.outro(`🚀 Deployment Successful (${confirmedBundleId})`);
 		return {
-			bundleId,
+			bundleId: confirmedBundleId,
 			platform
 		};
 	} catch (e) {
@@ -48512,6 +48680,43 @@ const init = async () => {
 	] })) p.log.info(".gitignore has been modified to include hot-updater entries");
 };
 //#endregion
+//#region src/commands/patch.ts
+const createPatch = async (options) => {
+	printBanner$1();
+	const platform = options.platform ?? (options.interactive ? await getPlatform("Which platform does this patch target?") : null);
+	if (p.isCancel(platform)) return;
+	if (!platform) {
+		p.log.error("Platform not found. -p <ios | android> or --platform <ios | android>");
+		return;
+	}
+	const config = await loadConfig({
+		channel: options.channel,
+		platform
+	});
+	const [databasePlugin, storagePlugin] = await Promise.all([config.database(), config.storage()]);
+	try {
+		p.note([
+			`Channel: ${options.channel}`,
+			`Platform: ${platform === "ios" ? "iOS" : "Android"}`,
+			`Base bundle: ${options.baseBundleId}`,
+			`Target bundle: ${options.bundleId}`
+		].join("\n"), "Patch");
+		const updatedBundle = await createBundleDiff({
+			baseBundleId: options.baseBundleId,
+			bundleId: options.bundleId
+		}, {
+			databasePlugin,
+			storagePlugin
+		}, { makePrimary: true });
+		p.outro(`⚡ Patch Ready (${updatedBundle.id})`);
+	} catch (error) {
+		console.error(error);
+		process.exit(1);
+	} finally {
+		await databasePlugin.onUnmount?.();
+	}
+};
+//#endregion
 //#region src/commands/runNative.ts
 const runNativeInternal = async ({ options, platform }) => {
 	printBanner$1();
@@ -48695,6 +48900,10 @@ const formatBundleSummary = (bundle, nextEnabled) => {
 	].filter((line) => line !== null);
 	return ui.block("Bundle", lines);
 };
+const parseTargetCohorts = (value) => {
+	if (value === void 0) return null;
+	return value.split(",").map((cohort) => cohort.trim()).filter(Boolean);
+};
 const refuseNonInteractiveMutation = (action) => {
 	p.log.error(`Cannot ${action} a bundle without confirmation in a non-interactive shell. Re-run with -y, or use a TTY.`);
 	process.exit(1);
@@ -48723,6 +48932,24 @@ const handleBundleList = async (options = {}) => {
 		await safeOnUnmount$2(databasePlugin);
 	}
 };
+const handleBundleShow = async (bundleId, options = {}) => {
+	if (!options.json) printBanner$1();
+	const databasePlugin = await (await loadConfig(null)).database();
+	try {
+		const bundle = await databasePlugin.getBundleById(bundleId);
+		if (!bundle) {
+			p.log.error(`No bundle with id ${bundleId}.`);
+			process.exit(1);
+		}
+		if (options.json) {
+			console.log(JSON.stringify(bundle, null, 2));
+			return;
+		}
+		p.log.message(formatBundleSummary(bundle));
+	} finally {
+		await safeOnUnmount$2(databasePlugin);
+	}
+};
 const handleBundleSetEnabled = async (bundleId, nextEnabled, options = {}) => {
 	const action = nextEnabled ? "enable" : "disable";
 	printBanner$1();
@@ -48764,6 +48991,87 @@ const handleBundleSetEnabled = async (bundleId, nextEnabled, options = {}) => {
 		await safeOnUnmount$2(databasePlugin);
 	}
 };
+const handleBundleUpdate = async (bundleId, options = {}) => {
+	if (!options.json) printBanner$1();
+	const targetCohorts = parseTargetCohorts(options.targetCohorts);
+	const patch = {};
+	if (options.rolloutCohortCount !== void 0) patch.rolloutCohortCount = options.rolloutCohortCount;
+	if (options.forceUpdate !== void 0) patch.shouldForceUpdate = options.forceUpdate;
+	if (targetCohorts !== null) patch.targetCohorts = targetCohorts;
+	else if (options.clearTargetCohorts) patch.targetCohorts = null;
+	if (Object.keys(patch).length === 0) {
+		p.log.error("No bundle update fields were provided.");
+		process.exit(1);
+	}
+	const databasePlugin = await (await loadConfig(null)).database();
+	try {
+		const bundle = await databasePlugin.getBundleById(bundleId);
+		if (!bundle) {
+			p.log.error(`No bundle with id ${bundleId}.`);
+			process.exit(1);
+		}
+		if (!options.json) p.log.message(formatBundleSummary(bundle));
+		if (!options.yes) {
+			if (!process.stdin.isTTY) refuseNonInteractiveMutation("update");
+			const confirmed = await p.confirm({
+				message: "Update this bundle?",
+				initialValue: false
+			});
+			if (p.isCancel(confirmed) || !confirmed) {
+				p.log.info("Aborted.");
+				process.exit(2);
+			}
+		}
+		await databasePlugin.updateBundle(bundleId, patch);
+		await databasePlugin.commitBundle();
+		const refetched = await databasePlugin.getBundleById(bundleId);
+		if (!refetched) {
+			p.log.error(`Verification failed: ${bundleId} is missing after update.`);
+			process.exit(1);
+		}
+		if (options.json) {
+			console.log(JSON.stringify(refetched, null, 2));
+			return;
+		}
+		p.log.success("Updated bundle.");
+		p.log.info(`  ${ui.id(bundleId)}`);
+	} finally {
+		await safeOnUnmount$2(databasePlugin);
+	}
+};
+const handleBundleDelete = async (bundleId, options = {}) => {
+	printBanner$1();
+	const databasePlugin = await (await loadConfig(null)).database();
+	try {
+		const bundle = await databasePlugin.getBundleById(bundleId);
+		if (!bundle) {
+			p.log.info(`No bundle with id ${bundleId}. No changes.`);
+			return;
+		}
+		p.log.message(formatBundleSummary(bundle));
+		if (!options.yes) {
+			if (!process.stdin.isTTY) refuseNonInteractiveMutation("delete");
+			const confirmed = await p.confirm({
+				message: "Delete this bundle record?",
+				initialValue: false
+			});
+			if (p.isCancel(confirmed) || !confirmed) {
+				p.log.info("Aborted.");
+				process.exit(2);
+			}
+		}
+		await databasePlugin.deleteBundle(bundle);
+		await databasePlugin.commitBundle();
+		if (await databasePlugin.getBundleById(bundleId)) {
+			p.log.error(`Verification failed: ${bundleId} still exists.`);
+			process.exit(1);
+		}
+		p.log.success("Deleted bundle record.");
+		p.log.info(`  ${ui.id(bundleId)}`);
+	} finally {
+		await safeOnUnmount$2(databasePlugin);
+	}
+};
 //#endregion
 //#region ../../node_modules/.pnpm/es-toolkit@1.32.0/node_modules/es-toolkit/dist/predicate/isPlainObject.mjs
 function isPlainObject(value) {
@@ -49402,6 +49710,11 @@ var import_semver = /* @__PURE__ */ __toESM((/* @__PURE__ */ __commonJSMin(((exp
 		rcompareIdentifiers: identifiers.rcompareIdentifiers
 	};
 })))(), 1);
+const INFRASTRUCTURE_RECOVERY_COMMANDS = [
+	"hot-updater init",
+	"hot-updater db migrate",
+	"hot-updater db generate"
+];
 const INFRASTRUCTURE_UPDATE_TARGETS = [
 	{
 		version: "0.13.0",
@@ -49422,6 +49735,10 @@ const INFRASTRUCTURE_UPDATE_TARGETS = [
 	{
 		version: "0.30.0",
 		note: "Target cohort rollout behavior"
+	},
+	{
+		version: "0.31.0",
+		note: "Bundle artifact storage fields"
 	}
 ];
 const getInfrastructureTargetVersionAt = (index) => {
@@ -49463,6 +49780,7 @@ function resolveVersionEndpoint(serverBaseUrl) {
 	url.pathname = `${pathname}/version`;
 	return url.toString();
 }
+const createInfrastructureRemediation = () => ({ commands: [...INFRASTRUCTURE_RECOVERY_COMMANDS] });
 async function checkInfrastructureStatus({ serverBaseUrl, fetchImpl = fetch, requiredVersion = getRequiredInfrastructureVersion() }) {
 	const versionEndpoint = resolveVersionEndpoint(serverBaseUrl);
 	const baseUrl = serverBaseUrl.trim();
@@ -49546,11 +49864,14 @@ async function doctor(options = {}) {
 			packageJsonPath,
 			installedHotUpdaterPackages: hotUpdaterPackages
 		};
-		if (serverBaseUrl) details.infrastructure = await checkInfrastructureStatus({
-			serverBaseUrl,
-			fetchImpl,
-			requiredVersion: getRequiredInfrastructureVersion(hotUpdaterVersion)
-		});
+		if (serverBaseUrl) {
+			details.infrastructure = await checkInfrastructureStatus({
+				serverBaseUrl,
+				fetchImpl,
+				requiredVersion: getRequiredInfrastructureVersion(hotUpdaterVersion)
+			});
+			if (details.infrastructure.error !== void 0 || details.infrastructure.needsUpdate === true) details.infrastructure.remediation = createInfrastructureRemediation();
+		}
 		if (versionMismatches.length > 0) details.versionMismatches = versionMismatches;
 		const hasInfrastructureIssue = details.infrastructure?.error !== void 0 || details.infrastructure?.needsUpdate === true;
 		if (versionMismatches.length > 0 || hasInfrastructureIssue) return {
@@ -49620,6 +49941,12 @@ const handleDoctor = async ({ serverBaseUrl } = {}) => {
 			if (infrastructure.updateReason) p.log.info(`Reason: ${infrastructure.updateReason}`);
 		} else if (infrastructure.error) p.log.error(`Infrastructure check failed: ${infrastructure.error}`);
 		else p.log.success("Infrastructure is up to date.");
+		if (infrastructure.remediation) p.log.message(ui.block("Recovery", [ui.kv("Managed", ui.command("hot-updater init")), ui.kv("@hot-updater/server (self-hosted)", ui.line([
+			ui.command("hot-updater db generate"),
+			"or",
+			ui.command("hot-updater db migrate"),
+			"then redeploy server"
+		]))]));
 	}
 	if (details?.versionMismatches && details.versionMismatches.length > 0) {
 		p.log.warn("Version mismatches found:");
@@ -50209,12 +50536,11 @@ async function generateStandaloneSQL(options) {
 		const s = p.spinner();
 		s.start("Generating SQL from database schema");
 		const db = new Kysely({ dialect: createDialect(dbType) });
-		const [{ HotUpdaterDB }, { kyselyAdapter }] = await Promise.all([import("@hot-updater/server"), import("@hot-updater/server/adapters/kysely")]);
-		const adapter = kyselyAdapter({
+		const [{ createHotUpdater }, { kyselyAdapter }] = await Promise.all([import("@hot-updater/server"), import("@hot-updater/server/adapters/kysely")]);
+		const result = await createHotUpdater({ database: kyselyAdapter({
 			db,
 			provider: dbType
-		});
-		const result = await HotUpdaterDB.client(adapter).createMigrator().migrateToLatest({
+		}) }).createMigrator().migrateToLatest({
 			mode: "from-schema",
 			updateSettings: false
 		});
@@ -50734,6 +51060,7 @@ const handlePromote = async (bundleId, options) => {
 	let storagePlugin = null;
 	try {
 		storagePlugin = await config.storage();
+		assertNodeStoragePlugin(storagePlugin);
 	} catch {
 		storagePlugin = null;
 	}
@@ -50910,6 +51237,16 @@ const handleRollback = async (channel, options = {}) => {
 //#endregion
 //#region src/index.ts
 const DEFAULT_CHANNEL = "production";
+const parseBooleanOption = (value) => {
+	if (value === "true") return true;
+	if (value === "false") return false;
+	throw new InvalidArgumentError("must be true or false");
+};
+const parseRolloutCohortCount = (value) => {
+	const count = Number.parseInt(value, 10);
+	if (!Number.isInteger(count) || count < 0 || count > 1e3) throw new InvalidArgumentError("must be an integer between 0 and 1000");
+	return count;
+};
 const program = new Command();
 program.name("hot-updater").description(banner(version)).version(version);
 program.command("init").description("Initialize Hot Updater").action(init);
@@ -50926,8 +51263,11 @@ bundleCommand.command("list").description("List bundles, most recent first").opt
 	if (!Number.isInteger(n) || n <= 0) throw new InvalidArgumentError("must be a positive integer");
 	return n;
 }, 20).action(handleBundleList);
+bundleCommand.command("show").description("Show one bundle by id").argument("<bundle-id>", "the bundle id to show").option("--json", "output raw bundle data as JSON").action((bundleId, options) => handleBundleShow(bundleId, options));
 bundleCommand.command("disable").description("Disable a bundle by id").argument("<bundle-id>", "the id of the bundle to disable").option("-y, --yes", "skip confirmation prompt").action((bundleId, options) => handleBundleSetEnabled(bundleId, false, options));
 bundleCommand.command("enable").description("Re-enable a previously disabled bundle by id").argument("<bundle-id>", "the id of the bundle to enable").option("-y, --yes", "skip confirmation prompt").action((bundleId, options) => handleBundleSetEnabled(bundleId, true, options));
+bundleCommand.command("update").description("Update bundle rollout and targeting metadata").argument("<bundle-id>", "the bundle id to update").option("--rollout-cohort-count <count>", "rollout cohort count from 0 to 1000", parseRolloutCohortCount).option("--force-update <value>", "set force update flag (true or false)", parseBooleanOption).option("--target-cohorts <cohorts>", "comma-separated target cohorts").option("--clear-target-cohorts", "clear target cohorts").option("--json", "output the updated bundle as JSON").option("-y, --yes", "skip confirmation prompt").action(handleBundleUpdate);
+bundleCommand.command("delete").description("Delete a bundle record by id").argument("<bundle-id>", "the bundle id to delete").option("-y, --yes", "skip confirmation prompt").action((bundleId, options) => handleBundleDelete(bundleId, options));
 bundleCommand.command("promote").description("Move or copy a bundle to a different channel").argument("<bundle-id>", "the id of the bundle to promote").requiredOption("-t, --target <channel>", "channel to promote the bundle to").addOption(new Option("-a, --action <action>", "promote action (copy creates a new bundle id; move keeps the id)").choices(["copy", "move"]).default("copy")).option("-y, --yes", "skip confirmation prompt").action((bundleId, options) => handlePromote(bundleId, options));
 const keysCommand = program.command("keys").description("Code signing key management");
 keysCommand.command("generate").description("Generate RSA key pair for code signing").option("-o, --output <dir>", "output directory for keys", "./keys").option("-k, --key-size <size>", "key size (2048 or 4096)", (value) => {
@@ -50954,6 +51294,9 @@ program.command("deploy").description("deploy a new version").addOption(platform
 		process.exit(1);
 	}
 }).default(100)).addOption(interactiveCommandOption).addOption(new Option("-c, --channel <channel>", "specify the channel to deploy").default(DEFAULT_CHANNEL)).addOption(new Option("-m, --message <message>", "Specify a custom message for this deployment. If not provided, the latest git commit message will be used as the deployment message")).action(async (options) => deploy(options));
+program.command("patch").description("create patch artifacts for a deployed bundle").requiredOption("-b, --bundle-id <bundleId>", "target bundle id that should receive the patch artifact").requiredOption("--base-bundle-id <baseBundleId>", "older bundle id to use as the patch base").addOption(platformCommandOption).addOption(interactiveCommandOption).addOption(new Option("-c, --channel <channel>", "specify the channel used to load config").default(DEFAULT_CHANNEL)).action(async (options) => {
+	await createPatch(options);
+});
 program.command("rollback").description("Disable the most recent enabled bundle on a channel").argument("<channel>", "the channel to roll back").addOption(platformCommandOption).option("-y, --yes", "skip confirmation prompt").option("--target <bundle-id>", "scope rollback to exactly this bundle id (use to retry a failed rollback)").action((channel, options) => handleRollback(channel, options));
 program.command("console").description("open the console").action(async () => {
 	printBanner$1();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "hot-updater",
   "type": "module",
-  "version": "0.30.12",
+  "version": "0.31.0",
   "engines": {
     "node": ">=20.19.0"
   },
@@ -49,13 +49,13 @@
     "jiti": "2.6.1",
     "kysely": "0.28.16",
     "sql-formatter": "15.6.10",
-    "@hot-updater/cli-tools": "0.30.12",
-    "@hot-updater/apple-helper": "0.30.12",
-    "@hot-updater/console": "0.30.12",
-    "@hot-updater/core": "0.30.12",
-    "@hot-updater/android-helper": "0.30.12",
-    "@hot-updater/plugin-core": "0.30.12",
-    "@hot-updater/server": "0.30.12"
+    "@hot-updater/cli-tools": "0.31.0",
+    "@hot-updater/android-helper": "0.31.0",
+    "@hot-updater/console": "0.31.0",
+    "@hot-updater/core": "0.31.0",
+    "@hot-updater/plugin-core": "0.31.0",
+    "@hot-updater/apple-helper": "0.31.0",
+    "@hot-updater/server": "0.31.0"
   },
   "devDependencies": {
     "@bacons/xcode": "1.0.0-alpha.24",
@@ -74,12 +74,12 @@
     "plist": "^3.1.0",
     "semver": "^7.6.3",
     "typescript": "6.0.2",
-    "@hot-updater/aws": "0.30.12",
-    "@hot-updater/firebase": "0.30.12",
-    "@hot-updater/server": "0.30.12",
-    "@hot-updater/test-utils": "0.30.12",
-    "@hot-updater/cloudflare": "0.30.12",
-    "@hot-updater/supabase": "0.30.12"
+    "@hot-updater/aws": "0.31.0",
+    "@hot-updater/cloudflare": "0.31.0",
+    "@hot-updater/firebase": "0.31.0",
+    "@hot-updater/server": "0.31.0",
+    "@hot-updater/supabase": "0.31.0",
+    "@hot-updater/test-utils": "0.31.0"
   },
   "peerDependencies": {
     "@hot-updater/aws": "*",