bleam 0.0.8 → 0.0.10

package/dist/cli.cjs

@@ -24,6 +24,7 @@ let yoctocolors = require("yoctocolors");
 yoctocolors = require_chunk.__toESM(yoctocolors);
 
 //#region src/cli.ts
+const localUpdateServiceUrl = "http://127.0.0.1:8787";
 const require$1 = (0, node_module.createRequire)(require("url").pathToFileURL(__filename).href);
 const packageRoot = node_path.default.dirname((0, node_url.fileURLToPath)(new URL("../package.json", require("url").pathToFileURL(__filename).href)));
 const packageJson = require$1("../package.json");
@@ -96,7 +97,7 @@ Commands:
                             Build and install a standalone macOS app
   publish ota [dir] [--service-url <url>]
                             Publish an OTA update to the local update service
-  publish platform [dir] [--service-url <url>]
+  publish platform [dir] [--service-url <url>] [--redeploy]
                             Build and publish a platform update locally
   doctor [dir]              Check the local Bleam environment
   typecheck [dir]           Typecheck project files
@@ -108,7 +109,7 @@ function parsePublishOtaOptions(argv) {
 	const root = invocationRoot();
 	let projectRoot = root;
 	let hasProjectRootArg = false;
-	let serviceUrl = process.env.BLEAM_UPDATE_SERVICE_URL ?? "http://127.0.0.1:8787";
+	let serviceUrl = process.env.BLEAM_UPDATE_SERVICE_URL ?? localUpdateServiceUrl;
 	for (let index = 0; index < argv.length; index += 1) {
 		const arg = argv[index];
 		if (arg === "--service-url") {
@@ -132,6 +133,13 @@ function parsePublishOtaOptions(argv) {
 		serviceUrl: url.origin
 	};
 }
+function parsePublishPlatformOptions(argv) {
+	const redeploy = argv.includes("--redeploy");
+	return {
+		...parsePublishOtaOptions(argv.filter((argument) => argument !== "--redeploy")),
+		redeploy
+	};
+}
 function invocationRoot() {
 	const pwd = process.env.PWD;
 	return pwd && node_path.default.isAbsolute(pwd) ? pwd : process.cwd();
@@ -479,7 +487,8 @@ function readProjectConfig(options) {
 		teamId: config.teamId,
 		appearance: config.appearance ?? normalizeAppearance(void 0),
 		runtimeVersion,
-		sdkVersion: runtimeVersion
+		sdkVersion: runtimeVersion,
+		iconPath: (0, node_fs.existsSync)(node_path.default.join(options.projectRoot, "icon.png")) ? node_path.default.join(options.projectRoot, "icon.png") : void 0
 	};
 }
 function slugFromName(name) {
@@ -635,8 +644,21 @@ function writeProjectRuntimeConfig(projectRoot, config, origin) {
 	}, null, 2)}\n`);
 	return projectConfigPath;
 }
-function nativeRuntimeTemplateRoot() {
-	return node_path.default.resolve(packageRoot, "..", "..", "app", "bleam");
+function nativeRuntimeTemplateRoot(root = packageRoot) {
+	const bundledTemplate = node_path.default.join(root, "templates", "native");
+	return (0, node_fs.existsSync)(bundledTemplate) ? bundledTemplate : node_path.default.resolve(root, "..", "..", "app", "bleam");
+}
+function localUpdateServiceRoot(root = packageRoot) {
+	const bundledService = node_path.default.join(root, "templates", "updates");
+	return (0, node_fs.existsSync)(bundledService) ? bundledService : node_path.default.resolve(root, "..", "..", "services", "updates");
+}
+function localUpdateServicePaths(home = node_os.default.homedir()) {
+	const root = node_path.default.join(home, "Library", "Caches", "bleam", "updates");
+	return {
+		root,
+		state: node_path.default.join(root, "state"),
+		log: node_path.default.join(root, "worker.log")
+	};
 }
 function safeArtifactName(name) {
 	return name.trim().replace(/[/:\\]/g, "-").replace(/\s+/g, " ") || "App";
@@ -672,11 +694,13 @@ function replaceOrInsertPlistStringArray(plist, key, values) {
 	return `${plist.slice(0, closingDictionary)}\t<key>${key}</key>\n\t<array>\n${plistStringArray(values)}\n\t</array>\n${plist.slice(closingDictionary)}`;
 }
 function writeGeneratedAppJson(nativeRoot, config) {
+	const icon = config.iconPath ? "./icon.png" : void 0;
 	(0, node_fs.writeFileSync)(node_path.default.join(nativeRoot, "app.json"), `${JSON.stringify({ expo: {
 		name: config.name,
 		slug: slugFromName(config.name),
 		version: config.version ?? "1.0.0",
 		platforms: ["ios"],
+		icon,
 		ios: {
 			appleTeamId: config.teamId,
 			buildNumber: config.buildNumber,
@@ -684,24 +708,65 @@ function writeGeneratedAppJson(nativeRoot, config) {
 		}
 	} }, null, 2)}\n`);
 }
+function prepareNativeIcon(nativeRoot, iconPath) {
+	const generatedIcon = node_path.default.join(nativeRoot, "icon.png");
+	const appIconRoot = node_path.default.join(nativeRoot, "ios", "Bleam", "Images.xcassets", "AppIcon.appiconset");
+	(0, node_fs.rmSync)(generatedIcon, { force: true });
+	(0, node_fs.rmSync)(node_path.default.join(appIconRoot, "AppIcon.png"), { force: true });
+	if (!iconPath) return;
+	(0, node_fs.cpSync)(iconPath, generatedIcon);
+	(0, node_fs.cpSync)(iconPath, node_path.default.join(appIconRoot, "AppIcon.png"));
+	(0, node_fs.writeFileSync)(node_path.default.join(appIconRoot, "Contents.json"), `${JSON.stringify({
+		images: [{
+			filename: "AppIcon.png",
+			idiom: "universal",
+			platform: "ios",
+			size: "1024x1024"
+		}],
+		info: {
+			version: 1,
+			author: "bleam"
+		}
+	}, null, 2)}\n`);
+}
+function platformInputFingerprint(config) {
+	const iconSha256 = config.iconPath ? sha256(config.iconPath) : null;
+	return (0, node_crypto.createHash)("sha256").update(JSON.stringify({
+		schemaVersion: 1,
+		bleamPlatformVersion: config.runtimeVersion,
+		name: config.name,
+		appVersion: config.version ?? "1.0.0",
+		buildNumber: config.buildNumber,
+		bundleIdentifier: config.bundleIdentifier,
+		teamIdentifier: config.teamId,
+		appGroups: config.appGroups,
+		appearance: config.appearance,
+		iconSha256,
+		updateServiceUrl: process.env.BLEAM_UPDATE_SERVICE_URL ?? localUpdateServiceUrl,
+		target: {
+			os: "macos",
+			architecture: "arm64",
+			minimumMacOSVersion: "14.0"
+		}
+	})).digest("hex");
+}
 function patchNativeProject(nativeRoot, config) {
 	const projectPath = node_path.default.join(nativeRoot, "ios", "Bleam.xcodeproj", "project.pbxproj");
 	const infoPlistPath = node_path.default.join(nativeRoot, "ios", "Bleam", "Info.plist");
 	const generationInfoPlistPath = node_path.default.join(nativeRoot, "ios", "GenerationService", "Info.plist");
-	const platformInfoPlistPath = node_path.default.join(nativeRoot, "ios", "PlatformHelper", "Info.plist");
 	const appEntitlementsPath = node_path.default.join(nativeRoot, "ios", "Bleam", "bleam.entitlements");
 	const generationEntitlementsPath = node_path.default.join(nativeRoot, "ios", "GenerationService", "GenerationService.entitlements");
 	const productName = xcodeSettingValue(config.name);
 	const bundleIdentifier = xcodeSettingValue(config.bundleIdentifier ?? "");
 	const generationBundleIdentifier = xcodeSettingValue(`${config.bundleIdentifier}.GenerationService`);
-	const platformBundleIdentifier = xcodeSettingValue(`${config.bundleIdentifier}.PlatformHelper`);
 	const teamId = xcodeSettingValue(config.teamId ?? "");
 	const version = xcodeSettingValue(config.version ?? "1.0.0");
 	const buildNumber = xcodeSettingValue(config.buildNumber);
 	const primaryAppGroup = config.appGroups[0];
+	const fingerprint = platformInputFingerprint(config);
 	let project = (0, node_fs.readFileSync)(projectPath, "utf8");
 	project = project.replace(/PRODUCT_BUNDLE_IDENTIFIER = ([^;]+);/g, (_, current) => {
-		return `PRODUCT_BUNDLE_IDENTIFIER = ${current.endsWith(".GenerationService") ? generationBundleIdentifier : current.endsWith(".PlatformHelper") ? platformBundleIdentifier : bundleIdentifier};`;
+		return `PRODUCT_BUNDLE_IDENTIFIER = ${current.endsWith(".GenerationService") ? generationBundleIdentifier : bundleIdentifier};`;
 	}).replace(/DEVELOPMENT_TEAM = [^;]+;/g, () => {
 		return `DEVELOPMENT_TEAM = ${teamId};`;
 	}).replace(/MARKETING_VERSION = [^;]+;/g, () => {
@@ -716,9 +781,10 @@ function patchNativeProject(nativeRoot, config) {
 	infoPlist = replacePlistString(infoPlist, "CFBundleDisplayName", config.name);
 	infoPlist = replacePlistString(infoPlist, "CFBundleShortVersionString", config.version ?? "1.0.0");
 	infoPlist = replaceOrInsertPlistString(infoPlist, "BleamRuntimeVersion", config.runtimeVersion);
+	infoPlist = replaceOrInsertPlistString(infoPlist, "BleamPlatformFingerprint", fingerprint);
 	infoPlist = replaceOrInsertPlistString(infoPlist, "BleamTeamIdentifier", config.teamId ?? "");
-	const updateServiceUrl = process.env.BLEAM_UPDATE_SERVICE_URL;
-	if (updateServiceUrl) infoPlist = replaceOrInsertPlistString(infoPlist, "BleamUpdateServiceURL", updateServiceUrl);
+	const updateServiceUrl = process.env.BLEAM_UPDATE_SERVICE_URL ?? localUpdateServiceUrl;
+	infoPlist = replaceOrInsertPlistString(infoPlist, "BleamUpdateServiceURL", updateServiceUrl);
 	infoPlist = replacePlistString(infoPlist, "CFBundleVersion", config.buildNumber);
 	if (primaryAppGroup) infoPlist = replaceOrInsertPlistString(infoPlist, "AppGroupIdentifier", primaryAppGroup);
 	(0, node_fs.writeFileSync)(infoPlistPath, infoPlist);
@@ -726,7 +792,6 @@ function patchNativeProject(nativeRoot, config) {
 		let generationInfoPlist = (0, node_fs.readFileSync)(generationInfoPlistPath, "utf8");
 		generationInfoPlist = replaceOrInsertPlistString(generationInfoPlist, "AppGroupIdentifier", primaryAppGroup);
 		(0, node_fs.writeFileSync)(generationInfoPlistPath, generationInfoPlist);
-		(0, node_fs.writeFileSync)(platformInfoPlistPath, replaceOrInsertPlistString((0, node_fs.readFileSync)(platformInfoPlistPath, "utf8"), "BleamPlatformVersion", config.runtimeVersion));
 		for (const entitlementsPath of [appEntitlementsPath, generationEntitlementsPath]) (0, node_fs.writeFileSync)(entitlementsPath, replaceOrInsertPlistStringArray((0, node_fs.readFileSync)(entitlementsPath, "utf8"), "com.apple.security.application-groups", config.appGroups));
 	}
 }
@@ -742,8 +807,10 @@ function createBuildNativeWorkspace(options, config) {
 		recursive: true,
 		verbatimSymlinks: true,
 		filter(source) {
-			return !node_path.default.relative(templateRoot, source).split(node_path.default.sep).some((part) => {
-				return part === "build" || part === "dist" || part === "node_modules" || part === ".expo" || part === "Pods" || part === ".xcode.env.local" || part === ".DS_Store" || part.endsWith(".xcworkspace");
+			const parts = node_path.default.relative(templateRoot, source).split(node_path.default.sep);
+			return !parts.some((part, index) => {
+				const frameworkBuildScript = part === "build" && index === 1 && parts[0] === "scripts";
+				return part === "build" && !frameworkBuildScript || part === "dist" || part === "node_modules" || part === ".expo" || part === "Pods" || part === ".xcode.env.local" || part === ".DS_Store" || part.endsWith(".xcworkspace");
 			});
 		}
 	});
@@ -757,6 +824,7 @@ function createBuildNativeWorkspace(options, config) {
 	(0, node_fs.writeFileSync)(node_path.default.join(nativeRoot, "index.ts"), `import { registerApp } from 'bleam/app'\nimport App from ${JSON.stringify(node_path.default.join(options.projectRoot, "app"))}\n\nregisterApp(App)\n`);
 	(0, node_fs.writeFileSync)(node_path.default.join(nativeRoot, "metro.config.js"), `const { getDefaultConfig } = require(${JSON.stringify(node_path.default.join(packageRoot, "metro-config.cjs"))})\n\nmodule.exports = getDefaultConfig(__dirname)\n`);
 	(0, node_fs.writeFileSync)(node_path.default.join(nativeRoot, "ios", ".xcode.env"), `export NODE_BINARY=$(command -v node)\nexport BLEAM_PROJECT_ROOT=${singleQuotedString(options.projectRoot)}\nexport BLEAM_DEV_PLATFORM=macos\n`);
+	prepareNativeIcon(nativeRoot, config.iconPath);
 	patchNativeProject(nativeRoot, config);
 	return nativeRoot;
 }
@@ -781,14 +849,27 @@ function runInheritedCommand(command, args, cwd) {
 }
 function installPods(nativeRoot) {
 	const iosRoot = node_path.default.join(nativeRoot, "ios");
-	const expectedStamp = podInstallInputStamp(iosRoot);
-	if (hasCurrentPodInstall(iosRoot, expectedStamp)) {
+	if (hasCurrentPodInstall(iosRoot, podInstallInputStamp(iosRoot))) {
 		console.log("Using cached native dependencies");
 		return;
 	}
 	console.log("Installing native dependencies...");
 	runInheritedCommand("pod", ["install"], iosRoot);
-	(0, node_fs.writeFileSync)(podInstallStampPath(iosRoot), `${expectedStamp}\n`);
+	(0, node_fs.writeFileSync)(podInstallStampPath(iosRoot), `${podInstallInputStamp(iosRoot)}\n`);
+}
+function ensureNativeFrameworks(nativeRoot) {
+	const frameworksRoot = node_path.default.join(nativeRoot, "ios", "Vendor", "MLXSwift", "0.31.6-macos");
+	if ([
+		"Cmlx",
+		"MLX",
+		"MLXNN",
+		"MLXOptimizers"
+	].every((name) => (0, node_fs.existsSync)(node_path.default.join(frameworksRoot, `${name}.framework`)))) {
+		console.log("Using cached native MLX frameworks");
+		return;
+	}
+	console.log("Preparing native MLX frameworks...");
+	runInheritedCommand(node_path.default.join(resolvedDependencyRoot(), ".bin", "tsx"), [node_path.default.join(nativeRoot, "scripts", "build", "mlx-frameworks.ts")], nativeRoot);
 }
 function podInstallInputStamp(iosRoot) {
 	const inputHash = (0, node_crypto.createHash)("sha256");
@@ -807,7 +888,9 @@ function podInstallStampPath(iosRoot) {
 }
 function hasCurrentPodInstall(iosRoot, expectedStamp) {
 	const stampPath = podInstallStampPath(iosRoot);
-	return (0, node_fs.existsSync)(node_path.default.join(iosRoot, "Bleam.xcworkspace")) && (0, node_fs.existsSync)(node_path.default.join(iosRoot, "Pods", "Manifest.lock")) && (0, node_fs.existsSync)(stampPath) && (0, node_fs.readFileSync)(stampPath, "utf8").trim() === expectedStamp;
+	const lockPath = node_path.default.join(iosRoot, "Podfile.lock");
+	const manifestPath = node_path.default.join(iosRoot, "Pods", "Manifest.lock");
+	return (0, node_fs.existsSync)(node_path.default.join(iosRoot, "Bleam.xcworkspace")) && (0, node_fs.existsSync)(lockPath) && (0, node_fs.existsSync)(manifestPath) && (0, node_fs.readFileSync)(lockPath, "utf8") === (0, node_fs.readFileSync)(manifestPath, "utf8") && (0, node_fs.existsSync)(stampPath) && (0, node_fs.readFileSync)(stampPath, "utf8").trim() === expectedStamp;
 }
 function nativeArchiveArgs(options) {
 	return [
@@ -866,6 +949,7 @@ async function buildNativeArchives(options) {
 	const config = readProjectConfig(options);
 	preflightBuild(options, config);
 	const nativeRoot = createBuildNativeWorkspace(options, config);
+	ensureNativeFrameworks(nativeRoot);
 	installPods(nativeRoot);
 	const archivePath = archiveNativeApp({
 		nativeRoot,
@@ -981,10 +1065,76 @@ async function publishOta(options) {
 	console.log(`Published OTA update ${releaseId}`);
 	console.log(`${options.serviceUrl}/v1/apps/${encodeURIComponent(config.bundleIdentifier)}/ota/${runtimeVersion}`);
 }
+function compareVersions(left, right) {
+	const parse = (value) => {
+		const match = /^(\d+)\.(\d+)\.(\d+)(?:-([^+]+))?(?:\+.*)?$/.exec(value);
+		if (!match) throw new Error(`Invalid Bleam platform version: ${value}`);
+		return {
+			core: match.slice(1, 4).map(Number),
+			prerelease: match[4]?.split(".")
+		};
+	};
+	const a = parse(left);
+	const b = parse(right);
+	for (let index = 0; index < a.core.length; index += 1) if (a.core[index] !== b.core[index]) return (a.core[index] ?? 0) < (b.core[index] ?? 0) ? -1 : 1;
+	if (!a.prerelease && !b.prerelease) return 0;
+	if (!a.prerelease) return 1;
+	if (!b.prerelease) return -1;
+	const length = Math.max(a.prerelease.length, b.prerelease.length);
+	for (let index = 0; index < length; index += 1) {
+		const aPart = a.prerelease[index];
+		const bPart = b.prerelease[index];
+		if (aPart === void 0) return -1;
+		if (bPart === void 0) return 1;
+		if (aPart === bPart) continue;
+		const aNumber = /^\d+$/.test(aPart) ? Number(aPart) : void 0;
+		const bNumber = /^\d+$/.test(bPart) ? Number(bPart) : void 0;
+		if (aNumber !== void 0 && bNumber !== void 0) return aNumber < bNumber ? -1 : 1;
+		if (aNumber !== void 0) return -1;
+		if (bNumber !== void 0) return 1;
+		return aPart < bPart ? -1 : 1;
+	}
+	return 0;
+}
+function platformPublicationReason(active, target, redeploy) {
+	if (active && compareVersions(target.bleamPlatformVersion, active.bleamPlatformVersion) < 0) throw new Error(`Cannot publish older Bleam platform ${target.bleamPlatformVersion} over ${active.bleamPlatformVersion}. Rollback requires a separate release operation.`);
+	const unchanged = active?.platformFingerprint === target.platformFingerprint;
+	if (unchanged && !redeploy) throw new Error("Platform inputs are unchanged. Developer code and ordinary assets must be published with bleam publish ota. Use --redeploy only to intentionally republish identical platform inputs.");
+	if (!unchanged && redeploy) throw new Error("--redeploy requires an existing release with the same platform fingerprint; publish normally because platform inputs changed.");
+	if (unchanged) return "redeploy";
+	if (!active) return "first-release";
+	if (!active.platformFingerprint) return "legacy-migration";
+	if (active.bleamPlatformVersion !== target.bleamPlatformVersion) return "runtime-upgrade";
+	return "signed-input-change";
+}
+async function activePlatformRelease(serviceUrl, config) {
+	const response = await fetch(`${serviceUrl}/v1/apps/${encodeURIComponent(config.bundleIdentifier ?? "")}/platform/macos-arm64`, { cache: "no-store" });
+	if (response.status === 404) return void 0;
+	if (!response.ok) throw new Error(`Could not resolve the active platform release: ${response.status} ${await response.text()}`);
+	const release = await response.json();
+	if (release.kind !== "platform" || release.bundleIdentifier !== config.bundleIdentifier || release.teamIdentifier !== config.teamId || typeof release.bleamPlatformVersion !== "string" || release.platformFingerprint !== void 0 && (typeof release.platformFingerprint !== "string" || !/^[a-f0-9]{64}$/.test(release.platformFingerprint))) throw new Error("The active platform release is invalid for this app");
+	return {
+		bleamPlatformVersion: release.bleamPlatformVersion,
+		platformFingerprint: release.platformFingerprint
+	};
+}
 async function publishPlatform(options) {
 	const config = readProjectConfig(options);
 	if (!config.bundleIdentifier) throw missingBuildFieldError("bundleIdentifier");
 	if (!config.teamId) throw missingBuildFieldError("teamId");
+	const fingerprint = platformInputFingerprint(config);
+	const active = await activePlatformRelease(options.serviceUrl, config);
+	console.log(`Bleam platform: ${active?.bleamPlatformVersion ?? "none"} -> ${config.runtimeVersion}`);
+	console.log(`Platform fingerprint: ${active?.platformFingerprint ?? "none"} -> ${fingerprint}`);
+	const reason = platformPublicationReason(active, {
+		bleamPlatformVersion: config.runtimeVersion,
+		platformFingerprint: fingerprint
+	}, options.redeploy);
+	if (reason === "redeploy") console.log("Redeploying unchanged platform inputs by explicit request");
+	else if (reason === "first-release") console.log("Publishing the first platform release for this app");
+	else if (reason === "legacy-migration") console.log("Migrating the active legacy release to platform fingerprints");
+	else if (reason === "runtime-upgrade") console.log("Publishing a Bleam platform runtime upgrade");
+	else console.log("Publishing changed signed app metadata or resources");
 	const archivePath = await buildNativeArchives({
 		projectRoot: options.projectRoot,
 		output: node_path.default.join(options.projectRoot, "dist"),
@@ -1013,7 +1163,7 @@ async function publishPlatform(options) {
 	const sizeBytes = (0, node_fs.readFileSync)(artifactPath).byteLength;
 	const digest = sha256(artifactPath);
 	const releaseId = `platform_${Date.now().toString(36)}_${digest.slice(0, 12)}`;
-	const release = platformRelease(config, releaseId, sizeBytes, digest);
+	const release = platformRelease(config, releaseId, sizeBytes, digest, options.redeploy);
 	const response = await fetch(`${options.serviceUrl}/v1/local/releases/platform`, {
 		method: "POST",
 		headers: { "content-type": "application/json" },
@@ -1026,7 +1176,7 @@ async function publishPlatform(options) {
 	console.log(`Published platform update ${releaseId}`);
 	console.log(`${options.serviceUrl}/v1/apps/${encodeURIComponent(config.bundleIdentifier)}/platform/macos-arm64`);
 }
-function platformRelease(config, releaseId, sizeBytes, digest) {
+function platformRelease(config, releaseId, sizeBytes, digest, redeploy = false) {
 	if (!config.bundleIdentifier) throw missingBuildFieldError("bundleIdentifier");
 	if (!config.teamId) throw missingBuildFieldError("teamId");
 	return {
@@ -1038,7 +1188,9 @@ function platformRelease(config, releaseId, sizeBytes, digest) {
 		releaseId,
 		appVersion: config.version ?? "1.0.0",
 		buildNumber: config.buildNumber,
-		bleamPlatformVersion: runtimeVersion,
+		bleamPlatformVersion: config.runtimeVersion,
+		platformFingerprint: platformInputFingerprint(config),
+		redeploy,
 		target: {
 			os: "macos",
 			architecture: "arm64",
@@ -1387,6 +1539,92 @@ async function launchRuntimeClient(appPath, projectConfigPath, manifest) {
 	quitRuntimeClient();
 	openRuntimeClient(appPath, projectConfigPath, manifest);
 }
+async function updateServiceHealthy(serviceUrl) {
+	try {
+		const response = await fetch(`${serviceUrl}/v1/health`, {
+			cache: "no-store",
+			signal: AbortSignal.timeout(1e3)
+		});
+		if (!response.ok) return false;
+		return (await response.json()).healthy === true;
+	} catch {
+		return false;
+	}
+}
+function updateServiceLogTail(logPath) {
+	if (!(0, node_fs.existsSync)(logPath)) return "";
+	return (0, node_fs.readFileSync)(logPath, "utf8").slice(-4e3).trim();
+}
+async function waitForUpdateService(child, serviceUrl, logPath, timeoutMs = 3e4) {
+	const startedAt = Date.now();
+	let startupError;
+	child.once("error", (error) => {
+		startupError = error;
+	});
+	while (Date.now() - startedAt < timeoutMs) {
+		if (startupError || child.exitCode !== null) break;
+		if (await updateServiceHealthy(serviceUrl)) return;
+		await new Promise((resolve) => setTimeout(resolve, 250));
+	}
+	const log = updateServiceLogTail(logPath);
+	const detail = log ? `\n\n${log}` : "";
+	throw new Error(`Local update Worker failed to start.\nLog: ${logPath}${detail}`, startupError ? { cause: startupError } : void 0);
+}
+async function startLocalUpdateService() {
+	const configuredUrl = process.env.BLEAM_UPDATE_SERVICE_URL ?? localUpdateServiceUrl;
+	const serviceUrl = new URL(configuredUrl).origin;
+	if (await updateServiceHealthy(serviceUrl)) {
+		console.log(`Using local update Worker at ${serviceUrl}`);
+		return {
+			child: void 0,
+			serviceUrl
+		};
+	}
+	if (serviceUrl !== localUpdateServiceUrl) throw new Error(`BLEAM_UPDATE_SERVICE_URL is not healthy: ${serviceUrl}/v1/health`);
+	const serviceRoot = localUpdateServiceRoot();
+	const configPath = node_path.default.join(serviceRoot, "wrangler.jsonc");
+	if (!(0, node_fs.existsSync)(configPath)) throw new Error(`Missing local update Worker: ${serviceRoot}`);
+	const wrangler = node_path.default.join(resolvedDependencyRoot(), ".bin", "wrangler");
+	if (!(0, node_fs.existsSync)(wrangler)) throw new Error("Missing Wrangler dependency for the local update Worker");
+	const paths = localUpdateServicePaths();
+	(0, node_fs.mkdirSync)(paths.state, { recursive: true });
+	const log = (0, node_fs.openSync)(paths.log, "a");
+	const child = (0, node_child_process.spawn)(wrangler, [
+		"dev",
+		"--config",
+		configPath,
+		"--local",
+		"--persist-to",
+		paths.state,
+		"--ip",
+		"127.0.0.1",
+		"--port",
+		"8787"
+	], {
+		cwd: serviceRoot,
+		stdio: [
+			"ignore",
+			log,
+			log
+		],
+		env: {
+			...process.env,
+			NO_COLOR: "1"
+		}
+	});
+	(0, node_fs.closeSync)(log);
+	try {
+		await waitForUpdateService(child, serviceUrl, paths.log);
+	} catch (error) {
+		child.kill("SIGTERM");
+		throw error;
+	}
+	console.log(`Local update Worker running at ${serviceUrl}`);
+	return {
+		child,
+		serviceUrl
+	};
+}
 function focusRuntimeClient() {
 	return (0, node_child_process.spawnSync)("osascript", ["-e", "tell application id \"dev.bleam.app\" to activate"], { stdio: "ignore" }).status === 0;
 }
@@ -1721,6 +1959,7 @@ async function startDevServer(options) {
 	const workspaceRoot = createDevWorkspace(options.projectRoot, config);
 	const origin = `http://localhost:${options.port}`;
 	const projectConfigPath = writeProjectRuntimeConfig(options.projectRoot, config, origin);
+	const updateService = await startLocalUpdateService();
 	const child = (0, node_child_process.spawn)(process.execPath, [
 		(0, node_url.fileURLToPath)(require("url").pathToFileURL(__filename).href),
 		"internal:metro",
@@ -1741,6 +1980,7 @@ async function startDevServer(options) {
 			BLEAM_DEV_PLATFORM: "macos",
 			BLEAM_DEV_RUNTIME_VERSION: config.runtimeVersion,
 			BLEAM_DEV_SDK_VERSION: config.sdkVersion,
+			BLEAM_UPDATE_SERVICE_URL: updateService.serviceUrl,
 			NODE_PATH: [
 				node_path.default.join(options.projectRoot, "node_modules"),
 				resolvedDependencyRoot(),
@@ -1760,6 +2000,7 @@ async function startDevServer(options) {
 		didCleanupDevSession = true;
 		cleanupInteractiveControls();
 		if (didLaunchRuntimeClient) quitRuntimeClient();
+		if (updateService.child?.exitCode === null) updateService.child.kill("SIGTERM");
 	};
 	const stop = (signal) => {
 		if (stopping) return;
@@ -1842,10 +2083,10 @@ async function main(argv = process.argv.slice(2)) {
 			return;
 		}
 		if (kind === "platform") {
-			await publishPlatform(parsePublishOtaOptions(publishArgs));
+			await publishPlatform(parsePublishPlatformOptions(publishArgs));
 			return;
 		}
-		throw new Error("Usage: bleam publish <ota|platform> [dir] [--service-url <url>]");
+		throw new Error("Usage: bleam publish <ota|platform> [dir] [--service-url <url>] [--redeploy]");
 	}
 	if (command === "doctor") {
 		runDoctor(parseDoctorOptions(args));
@@ -1883,10 +2124,16 @@ const __test = {
 	hasCurrentPodInstall,
 	installedAppPath,
 	installArchivedApp,
+	localUpdateServicePaths,
+	localUpdateServiceRoot,
+	nativeRuntimeTemplateRoot,
 	nativeArchiveArgs,
 	parseBuildOptions,
 	parseNewOptions,
 	parsePublishOtaOptions,
+	parsePublishPlatformOptions,
+	platformInputFingerprint,
+	platformPublicationReason,
 	platformRelease,
 	podInstallInputStamp,
 	replaceOrInsertPlistString

package/dist/cli.d.cts

@@ -13,6 +13,9 @@ interface PublishOtaOptions {
   projectRoot: string;
   serviceUrl: string;
 }
+interface PublishPlatformOptions extends PublishOtaOptions {
+  redeploy: boolean;
+}
 interface ProjectConfig {
   name: string;
   version?: string;
@@ -23,11 +26,13 @@ interface ProjectConfig {
   appearance: BleamAppearance;
   runtimeVersion: string;
   sdkVersion: string;
+  iconPath?: string;
 }
 declare function parsePublishOtaOptions(argv: string[]): PublishOtaOptions;
+declare function parsePublishPlatformOptions(argv: string[]): PublishPlatformOptions;
 declare function parseNewOptions(argv: string[]): {
   projectRoot: string;
-  template: "basic" | "state" | "foundation-models" | "image-generation";
+  template: "state" | "basic" | "foundation-models" | "image-generation";
 };
 declare const projectTemplates: readonly ["basic", "state", "foundation-models", "image-generation"];
 type ProjectTemplate = (typeof projectTemplates)[number];
@@ -36,7 +41,15 @@ declare function createProject(options: {
   projectRoot: string;
   template?: ProjectTemplate;
 }): void;
+declare function nativeRuntimeTemplateRoot(root?: string): string;
+declare function localUpdateServiceRoot(root?: string): string;
+declare function localUpdateServicePaths(home?: string): {
+  root: string;
+  state: string;
+  log: string;
+};
 declare function replaceOrInsertPlistString(plist: string, key: string, value: string): string;
+declare function platformInputFingerprint(config: ProjectConfig): string;
 declare function createBuildNativeWorkspace(options: BuildOptions, config: ProjectConfig): string;
 declare function podInstallInputStamp(iosRoot: string): string;
 declare function hasCurrentPodInstall(iosRoot: string, expectedStamp: string): boolean;
@@ -47,7 +60,16 @@ declare function nativeArchiveArgs(options: {
 }): string[];
 declare function installArchivedApp(archivePath: string, applications?: string): string;
 declare function installedAppPath(appName: string): string;
-declare function platformRelease(config: ProjectConfig, releaseId: string, sizeBytes: number, digest: string): {
+interface ActivePlatformRelease {
+  bleamPlatformVersion: string;
+  platformFingerprint?: string;
+}
+type PlatformPublicationReason = 'first-release' | 'legacy-migration' | 'runtime-upgrade' | 'signed-input-change' | 'redeploy';
+declare function platformPublicationReason(active: ActivePlatformRelease | undefined, target: {
+  bleamPlatformVersion: string;
+  platformFingerprint: string;
+}, redeploy: boolean): PlatformPublicationReason;
+declare function platformRelease(config: ProjectConfig, releaseId: string, sizeBytes: number, digest: string, redeploy?: boolean): {
   schemaVersion: number;
   kind: string;
   bundleIdentifier: string;
@@ -57,6 +79,8 @@ declare function platformRelease(config: ProjectConfig, releaseId: string, sizeB
   appVersion: string;
   buildNumber: string;
   bleamPlatformVersion: string;
+  platformFingerprint: string;
+  redeploy: boolean;
   target: {
     os: string;
     architecture: string;
@@ -77,10 +101,16 @@ declare const __test: {
   hasCurrentPodInstall: typeof hasCurrentPodInstall;
   installedAppPath: typeof installedAppPath;
   installArchivedApp: typeof installArchivedApp;
+  localUpdateServicePaths: typeof localUpdateServicePaths;
+  localUpdateServiceRoot: typeof localUpdateServiceRoot;
+  nativeRuntimeTemplateRoot: typeof nativeRuntimeTemplateRoot;
   nativeArchiveArgs: typeof nativeArchiveArgs;
   parseBuildOptions: typeof parseBuildOptions;
   parseNewOptions: typeof parseNewOptions;
   parsePublishOtaOptions: typeof parsePublishOtaOptions;
+  parsePublishPlatformOptions: typeof parsePublishPlatformOptions;
+  platformInputFingerprint: typeof platformInputFingerprint;
+  platformPublicationReason: typeof platformPublicationReason;
   platformRelease: typeof platformRelease;
   podInstallInputStamp: typeof podInstallInputStamp;
   replaceOrInsertPlistString: typeof replaceOrInsertPlistString;

package/dist/cli.d.ts

@@ -13,6 +13,9 @@ interface PublishOtaOptions {
   projectRoot: string;
   serviceUrl: string;
 }
+interface PublishPlatformOptions extends PublishOtaOptions {
+  redeploy: boolean;
+}
 interface ProjectConfig {
   name: string;
   version?: string;
@@ -23,11 +26,13 @@ interface ProjectConfig {
   appearance: BleamAppearance;
   runtimeVersion: string;
   sdkVersion: string;
+  iconPath?: string;
 }
 declare function parsePublishOtaOptions(argv: string[]): PublishOtaOptions;
+declare function parsePublishPlatformOptions(argv: string[]): PublishPlatformOptions;
 declare function parseNewOptions(argv: string[]): {
   projectRoot: string;
-  template: "basic" | "state" | "foundation-models" | "image-generation";
+  template: "state" | "basic" | "foundation-models" | "image-generation";
 };
 declare const projectTemplates: readonly ["basic", "state", "foundation-models", "image-generation"];
 type ProjectTemplate = (typeof projectTemplates)[number];
@@ -36,7 +41,15 @@ declare function createProject(options: {
   projectRoot: string;
   template?: ProjectTemplate;
 }): void;
+declare function nativeRuntimeTemplateRoot(root?: string): string;
+declare function localUpdateServiceRoot(root?: string): string;
+declare function localUpdateServicePaths(home?: string): {
+  root: string;
+  state: string;
+  log: string;
+};
 declare function replaceOrInsertPlistString(plist: string, key: string, value: string): string;
+declare function platformInputFingerprint(config: ProjectConfig): string;
 declare function createBuildNativeWorkspace(options: BuildOptions, config: ProjectConfig): string;
 declare function podInstallInputStamp(iosRoot: string): string;
 declare function hasCurrentPodInstall(iosRoot: string, expectedStamp: string): boolean;
@@ -47,7 +60,16 @@ declare function nativeArchiveArgs(options: {
 }): string[];
 declare function installArchivedApp(archivePath: string, applications?: string): string;
 declare function installedAppPath(appName: string): string;
-declare function platformRelease(config: ProjectConfig, releaseId: string, sizeBytes: number, digest: string): {
+interface ActivePlatformRelease {
+  bleamPlatformVersion: string;
+  platformFingerprint?: string;
+}
+type PlatformPublicationReason = 'first-release' | 'legacy-migration' | 'runtime-upgrade' | 'signed-input-change' | 'redeploy';
+declare function platformPublicationReason(active: ActivePlatformRelease | undefined, target: {
+  bleamPlatformVersion: string;
+  platformFingerprint: string;
+}, redeploy: boolean): PlatformPublicationReason;
+declare function platformRelease(config: ProjectConfig, releaseId: string, sizeBytes: number, digest: string, redeploy?: boolean): {
   schemaVersion: number;
   kind: string;
   bundleIdentifier: string;
@@ -57,6 +79,8 @@ declare function platformRelease(config: ProjectConfig, releaseId: string, sizeB
   appVersion: string;
   buildNumber: string;
   bleamPlatformVersion: string;
+  platformFingerprint: string;
+  redeploy: boolean;
   target: {
     os: string;
     architecture: string;
@@ -77,10 +101,16 @@ declare const __test: {
   hasCurrentPodInstall: typeof hasCurrentPodInstall;
   installedAppPath: typeof installedAppPath;
   installArchivedApp: typeof installArchivedApp;
+  localUpdateServicePaths: typeof localUpdateServicePaths;
+  localUpdateServiceRoot: typeof localUpdateServiceRoot;
+  nativeRuntimeTemplateRoot: typeof nativeRuntimeTemplateRoot;
   nativeArchiveArgs: typeof nativeArchiveArgs;
   parseBuildOptions: typeof parseBuildOptions;
   parseNewOptions: typeof parseNewOptions;
   parsePublishOtaOptions: typeof parsePublishOtaOptions;
+  parsePublishPlatformOptions: typeof parsePublishPlatformOptions;
+  platformInputFingerprint: typeof platformInputFingerprint;
+  platformPublicationReason: typeof platformPublicationReason;
   platformRelease: typeof platformRelease;
   podInstallInputStamp: typeof podInstallInputStamp;
   replaceOrInsertPlistString: typeof replaceOrInsertPlistString;