hot-updater 0.31.0 → 0.31.1

package/dist/index.mjs

@@ -49715,6 +49715,9 @@ const INFRASTRUCTURE_RECOVERY_COMMANDS = [
 	"hot-updater db migrate",
 	"hot-updater db generate"
 ];
+const FINGERPRINT_RECOVERY_COMMANDS = ["npx hot-updater fingerprint create"];
+const EXPORT_PUBLIC_KEY_COMMANDS = ["npx hot-updater keys export-public"];
+const REMOVE_PUBLIC_KEY_COMMANDS = ["npx hot-updater keys remove"];
 const INFRASTRUCTURE_UPDATE_TARGETS = [
 	{
 		version: "0.13.0",
@@ -49780,7 +49783,267 @@ function resolveVersionEndpoint(serverBaseUrl) {
 	url.pathname = `${pathname}/version`;
 	return url.toString();
 }
-const createInfrastructureRemediation = () => ({ commands: [...INFRASTRUCTURE_RECOVERY_COMMANDS] });
+const createInfrastructureRemediation = () => ({
+	fixability: "blocked",
+	reason: "Server infrastructure changes usually need provider credentials, environment variables, and redeploy access.",
+	commands: [...INFRASTRUCTURE_RECOVERY_COMMANDS]
+});
+const toRelativePath = (cwd, filePath) => path$1.relative(cwd, filePath);
+const resolveProjectPath = (cwd, filePath) => path$1.isAbsolute(filePath) ? filePath : path$1.join(cwd, filePath);
+const findNativeFiles = ({ cwd, platform, pattern }) => {
+	const platformRoot = path$1.join(cwd, platform);
+	if (!fs$2.existsSync(platformRoot)) return [];
+	return import_out.default.sync(pattern, {
+		cwd: platformRoot,
+		absolute: true,
+		onlyFiles: true,
+		ignore: [
+			"**/Pods/**",
+			"**/build/**",
+			"**/Build/**",
+			"**/*.app/**",
+			"**/*.xcarchive/**"
+		]
+	}).map((filePath) => toRelativePath(cwd, filePath)).sort();
+};
+const findFirstMatchingFile = async ({ cwd, files, patterns }) => {
+	for (const filePath of files) {
+		const absolutePath = resolveProjectPath(cwd, filePath);
+		const content = await fs$2.promises.readFile(absolutePath, "utf-8");
+		if (patterns.some((pattern) => pattern.test(content))) return filePath;
+	}
+	return null;
+};
+const readLocalFingerprintFile = async (cwd) => {
+	const fingerprintJsonPath = path$1.join(cwd, "fingerprint.json");
+	try {
+		const content = await fs$2.promises.readFile(fingerprintJsonPath, "utf-8");
+		return {
+			path: "fingerprint.json",
+			value: JSON.parse(content)
+		};
+	} catch {
+		return null;
+	}
+};
+const checkIosNativeStatus = async ({ cwd, config, requireFingerprint, expectedFingerprintHash }) => {
+	const configuredPaths = config.platform.ios.infoPlistPaths;
+	if (!(fs$2.existsSync(path$1.join(cwd, "ios")) || configuredPaths.length > 0)) return { issues: [] };
+	const iosParser = new IosConfigParser(configuredPaths);
+	const files = configuredPaths.filter((filePath) => fs$2.existsSync(resolveProjectPath(cwd, filePath)));
+	const issues = [];
+	if (!await iosParser.exists()) issues.push({
+		type: "error",
+		platform: "ios",
+		code: "NATIVE_FILES_NOT_FOUND",
+		message: "iOS Info.plist files were not found.",
+		resolution: "Check platform.ios.infoPlistPaths in hot-updater.config.ts or run iOS prebuild first.",
+		fixability: "auto",
+		paths: configuredPaths
+	});
+	const channel = await iosParser.get("HOT_UPDATER_CHANNEL");
+	const fingerprintHash = requireFingerprint ? await iosParser.get("HOT_UPDATER_FINGERPRINT_HASH") : void 0;
+	if (requireFingerprint && !fingerprintHash?.value) issues.push({
+		type: "error",
+		platform: "ios",
+		code: "MISSING_FINGERPRINT_HASH",
+		message: "HOT_UPDATER_FINGERPRINT_HASH is missing from Info.plist.",
+		resolution: "Run `npx hot-updater fingerprint create` or rebuild through the Expo config plugin.",
+		fixability: "command",
+		commands: [...FINGERPRINT_RECOVERY_COMMANDS],
+		paths: fingerprintHash?.paths.length ? fingerprintHash.paths : files
+	});
+	else if (requireFingerprint && expectedFingerprintHash && fingerprintHash?.value !== expectedFingerprintHash) issues.push({
+		type: "error",
+		platform: "ios",
+		code: "FINGERPRINT_HASH_MISMATCH",
+		message: "HOT_UPDATER_FINGERPRINT_HASH does not match fingerprint.json.",
+		resolution: "Run `npx hot-updater fingerprint create` and rebuild your iOS app.",
+		fixability: "command",
+		commands: [...FINGERPRINT_RECOVERY_COMMANDS],
+		paths: fingerprintHash?.paths ?? files
+	});
+	const appDelegateFiles = findNativeFiles({
+		cwd,
+		platform: "ios",
+		pattern: "**/AppDelegate.{swift,mm,m}"
+	});
+	let bundleProviderConfigured = false;
+	if (appDelegateFiles.length === 0) issues.push({
+		type: "error",
+		platform: "ios",
+		code: "APP_DELEGATE_NOT_FOUND",
+		message: "iOS AppDelegate file was not found.",
+		resolution: "Add HotUpdater.bundleURL() to the app's iOS bundleURL provider.",
+		fixability: "auto"
+	});
+	else {
+		bundleProviderConfigured = await findFirstMatchingFile({
+			cwd,
+			files: appDelegateFiles,
+			patterns: [/HotUpdater\.bundleURL\s*\(/, /\[HotUpdater\s+bundleURL(?:WithBundle)?:?/]
+		}) !== null;
+		if (!bundleProviderConfigured) issues.push({
+			type: "error",
+			platform: "ios",
+			code: "MISSING_IOS_BUNDLE_PROVIDER",
+			message: "iOS AppDelegate does not use HotUpdater.bundleURL().",
+			resolution: "Replace the release JS bundle URL provider with HotUpdater.bundleURL().",
+			fixability: "auto",
+			paths: appDelegateFiles
+		});
+	}
+	return {
+		status: {
+			detected: true,
+			files: [...files, ...appDelegateFiles],
+			channel: channel.value ?? void 0,
+			fingerprintHash: fingerprintHash?.value ?? void 0,
+			bundleProviderConfigured
+		},
+		issues
+	};
+};
+const checkAndroidNativeStatus = async ({ cwd, config, requireFingerprint, expectedFingerprintHash }) => {
+	const configuredPaths = config.platform.android.stringResourcePaths;
+	if (!(fs$2.existsSync(path$1.join(cwd, "android")) || configuredPaths.length > 0)) return { issues: [] };
+	const androidParser = new AndroidConfigParser(configuredPaths);
+	const files = configuredPaths.filter((filePath) => fs$2.existsSync(resolveProjectPath(cwd, filePath)));
+	const issues = [];
+	if (!await androidParser.exists()) issues.push({
+		type: "error",
+		platform: "android",
+		code: "NATIVE_FILES_NOT_FOUND",
+		message: "Android strings.xml files were not found.",
+		resolution: "Check platform.android.stringResourcePaths in hot-updater.config.ts or run Android prebuild first.",
+		fixability: "auto",
+		paths: configuredPaths
+	});
+	const channel = await androidParser.get("hot_updater_channel");
+	const fingerprintHash = requireFingerprint ? await androidParser.get("hot_updater_fingerprint_hash") : void 0;
+	if (requireFingerprint && !fingerprintHash?.value) issues.push({
+		type: "error",
+		platform: "android",
+		code: "MISSING_FINGERPRINT_HASH",
+		message: "hot_updater_fingerprint_hash is missing from strings.xml.",
+		resolution: "Run `npx hot-updater fingerprint create` or rebuild through the Expo config plugin.",
+		fixability: "command",
+		commands: [...FINGERPRINT_RECOVERY_COMMANDS],
+		paths: fingerprintHash?.paths.length ? fingerprintHash.paths : files
+	});
+	else if (requireFingerprint && expectedFingerprintHash && fingerprintHash?.value !== expectedFingerprintHash) issues.push({
+		type: "error",
+		platform: "android",
+		code: "FINGERPRINT_HASH_MISMATCH",
+		message: "hot_updater_fingerprint_hash does not match fingerprint.json.",
+		resolution: "Run `npx hot-updater fingerprint create` and rebuild your Android app.",
+		fixability: "command",
+		commands: [...FINGERPRINT_RECOVERY_COMMANDS],
+		paths: fingerprintHash?.paths ?? files
+	});
+	const mainApplicationFiles = findNativeFiles({
+		cwd,
+		platform: "android",
+		pattern: "**/MainApplication.{kt,java}"
+	});
+	let bundleProviderConfigured = false;
+	if (mainApplicationFiles.length === 0) issues.push({
+		type: "error",
+		platform: "android",
+		code: "MAIN_APPLICATION_NOT_FOUND",
+		message: "Android MainApplication file was not found.",
+		resolution: "Add HotUpdater.getJSBundleFile(applicationContext) to the Android host configuration.",
+		fixability: "auto"
+	});
+	else {
+		bundleProviderConfigured = await findFirstMatchingFile({
+			cwd,
+			files: mainApplicationFiles,
+			patterns: [/HotUpdater\s*(?:\.\s*Companion\s*)?\.\s*getJSBundleFile\s*\(/]
+		}) !== null;
+		if (!bundleProviderConfigured) issues.push({
+			type: "error",
+			platform: "android",
+			code: "MISSING_ANDROID_BUNDLE_PROVIDER",
+			message: "Android MainApplication does not use HotUpdater.getJSBundleFile().",
+			resolution: "Pass HotUpdater.getJSBundleFile(applicationContext) to React Native's JS bundle provider.",
+			fixability: "auto",
+			paths: mainApplicationFiles
+		});
+	}
+	return {
+		status: {
+			detected: true,
+			files: [...files, ...mainApplicationFiles],
+			channel: channel.value ?? void 0,
+			fingerprintHash: fingerprintHash?.value ?? void 0,
+			bundleProviderConfigured
+		},
+		issues
+	};
+};
+const toNativeIssue = (issue) => {
+	if (issue.code === "NATIVE_FILES_NOT_FOUND") return {
+		type: issue.type,
+		platform: issue.platform,
+		code: issue.code,
+		message: issue.message,
+		resolution: issue.resolution,
+		fixability: "auto"
+	};
+	return {
+		type: issue.type,
+		platform: issue.platform,
+		code: issue.code,
+		message: issue.message,
+		resolution: issue.resolution,
+		fixability: "command",
+		commands: issue.code === "ORPHAN_PUBLIC_KEY" ? [...REMOVE_PUBLIC_KEY_COMMANDS] : [...EXPORT_PUBLIC_KEY_COMMANDS]
+	};
+};
+async function checkNativeStatus({ cwd }) {
+	if (!(fs$2.existsSync(path$1.join(cwd, "ios")) || fs$2.existsSync(path$1.join(cwd, "android")))) return;
+	const config = await loadConfig(null);
+	const localFingerprint = await readLocalFingerprintFile(cwd);
+	const requireFingerprint = config.updateStrategy === "fingerprint";
+	const [ios, android, signing] = await Promise.all([
+		checkIosNativeStatus({
+			cwd,
+			config,
+			requireFingerprint,
+			expectedFingerprintHash: localFingerprint?.value.ios?.hash
+		}),
+		checkAndroidNativeStatus({
+			cwd,
+			config,
+			requireFingerprint,
+			expectedFingerprintHash: localFingerprint?.value.android?.hash
+		}),
+		validateSigningConfig(config)
+	]);
+	const issues = [
+		...ios.issues,
+		...android.issues,
+		...signing.issues.map(toNativeIssue)
+	];
+	if (requireFingerprint && !localFingerprint) issues.push({
+		type: "error",
+		platform: "project",
+		code: "MISSING_FINGERPRINT_JSON",
+		message: "fingerprint.json is missing for fingerprint update strategy.",
+		resolution: "Run `npx hot-updater fingerprint create`.",
+		fixability: "command",
+		commands: [...FINGERPRINT_RECOVERY_COMMANDS],
+		paths: ["fingerprint.json"]
+	});
+	return {
+		updateStrategy: config.updateStrategy,
+		fingerprintJsonPath: localFingerprint?.path,
+		ios: ios.status,
+		android: android.status,
+		issues
+	};
+}
 async function checkInfrastructureStatus({ serverBaseUrl, fetchImpl = fetch, requiredVersion = getRequiredInfrastructureVersion() }) {
 	const versionEndpoint = resolveVersionEndpoint(serverBaseUrl);
 	const baseUrl = serverBaseUrl.trim();
@@ -49850,6 +50113,7 @@ async function doctor(options = {}) {
 			error: "hot-updater CLI not found. Please install it first."
 		};
 		const hotUpdaterPackages = Object.keys(allDependencies).filter((key) => key.startsWith("@hot-updater/"));
+		const hasReactNativePackage = allDependencies["@hot-updater/react-native"] !== void 0;
 		const versionMismatches = [];
 		for (const packageName of hotUpdaterPackages) {
 			const currentVersion = allDependencies[packageName];
@@ -49872,9 +50136,11 @@ async function doctor(options = {}) {
 			});
 			if (details.infrastructure.error !== void 0 || details.infrastructure.needsUpdate === true) details.infrastructure.remediation = createInfrastructureRemediation();
 		}
+		if (hasReactNativePackage) details.native = await checkNativeStatus({ cwd });
 		if (versionMismatches.length > 0) details.versionMismatches = versionMismatches;
 		const hasInfrastructureIssue = details.infrastructure?.error !== void 0 || details.infrastructure?.needsUpdate === true;
-		if (versionMismatches.length > 0 || hasInfrastructureIssue) return {
+		const hasNativeIssue = details.native?.issues.some((issue) => issue.type === "error") === true;
+		if (versionMismatches.length > 0 || hasInfrastructureIssue || hasNativeIssue) return {
 			success: false,
 			details
 		};
@@ -49882,6 +50148,10 @@ async function doctor(options = {}) {
 			success: true,
 			details
 		};
+		if (details.native) return {
+			success: true,
+			details
+		};
 		return true;
 	} catch (error) {
 		return {
@@ -49890,6 +50160,10 @@ async function doctor(options = {}) {
 		};
 	}
 }
+const normalizeDoctorResult = (result) => {
+	if (result === true) return { success: true };
+	return result;
+};
 const promptServerBaseUrl = async () => {
 	if (!process.stdin.isTTY || !process.stdout.isTTY) return;
 	const serverBaseUrl = await p.text({
@@ -49912,7 +50186,13 @@ const promptServerBaseUrl = async () => {
 	const trimmed = serverBaseUrl.trim();
 	return trimmed ? trimmed : void 0;
 };
-const handleDoctor = async ({ serverBaseUrl } = {}) => {
+const handleDoctor = async ({ serverBaseUrl, json = false } = {}) => {
+	if (json) {
+		const result = normalizeDoctorResult(await doctor({ serverBaseUrl }));
+		console.log(JSON.stringify(result, null, 2));
+		if (!result.success) process.exit(1);
+		return;
+	}
 	p.intro("Hot Updater doctor");
 	const result = await doctor({ serverBaseUrl: serverBaseUrl ?? await promptServerBaseUrl() });
 	if (result === true) {
@@ -49948,6 +50228,25 @@ const handleDoctor = async ({ serverBaseUrl } = {}) => {
 			"then redeploy server"
 		]))]));
 	}
+	if (details?.native) {
+		const native = details.native;
+		const lines = [ui.kv("Strategy", native.updateStrategy)];
+		if (native.ios?.detected) {
+			lines.push(ui.kv("iOS", native.ios.bundleProviderConfigured ? ui.status(true) : ui.status(false)));
+			if (native.ios.channel) lines.push(ui.kv("iOS channel", ui.channel(native.ios.channel)));
+		}
+		if (native.android?.detected) {
+			lines.push(ui.kv("Android", native.android.bundleProviderConfigured ? ui.status(true) : ui.status(false)));
+			if (native.android.channel) lines.push(ui.kv("Android channel", ui.channel(native.android.channel)));
+		}
+		p.log.message(ui.block("Native", lines));
+		for (const issue of native.issues) {
+			const message = `${issue.platform}: ${issue.message}`;
+			if (issue.type === "error") p.log.error(message);
+			else p.log.warn(message);
+			p.log.info(issue.resolution);
+		}
+	}
 	if (details?.versionMismatches && details.versionMismatches.length > 0) {
 		p.log.warn("Version mismatches found:");
 		for (const mismatch of details.versionMismatches) p.log.error(`${mismatch.packageName}: ${mismatch.currentVersion} (expected ${mismatch.expectedVersion})`);
@@ -51250,7 +51549,7 @@ const parseRolloutCohortCount = (value) => {
 const program = new Command();
 program.name("hot-updater").description(banner(version)).version(version);
 program.command("init").description("Initialize Hot Updater").action(init);
-program.command("doctor").description("Check the health of Hot Updater").option("--server-base-url <url>", "server base URL used by update checks (doctor appends /version)").action(handleDoctor);
+program.command("doctor").description("Check the health of Hot Updater").option("--server-base-url <url>", "server base URL used by update checks (doctor appends /version)").option("--json", "output machine-readable doctor result").action(handleDoctor);
 const fingerprintCommand = program.command("fingerprint").description("Generate fingerprint");
 fingerprintCommand.action(handleFingerprint);
 fingerprintCommand.command("create").description("Create fingerprint").action(handleCreateFingerprint);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "hot-updater",
   "type": "module",
-  "version": "0.31.0",
+  "version": "0.31.1",
   "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.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"
+    "@hot-updater/android-helper": "0.31.1",
+    "@hot-updater/apple-helper": "0.31.1",
+    "@hot-updater/cli-tools": "0.31.1",
+    "@hot-updater/plugin-core": "0.31.1",
+    "@hot-updater/core": "0.31.1",
+    "@hot-updater/console": "0.31.1",
+    "@hot-updater/server": "0.31.1"
   },
   "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.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"
+    "@hot-updater/aws": "0.31.1",
+    "@hot-updater/cloudflare": "0.31.1",
+    "@hot-updater/firebase": "0.31.1",
+    "@hot-updater/server": "0.31.1",
+    "@hot-updater/supabase": "0.31.1",
+    "@hot-updater/test-utils": "0.31.1"
   },
   "peerDependencies": {
     "@hot-updater/aws": "*",