stim 1.0.0 → 1.2.0

package/dist/dev-client-RpvXxCXV.mjs

@@ -0,0 +1,620 @@
+import { t as getExecutor } from "./exec-CyylIdq9.mjs";
+import { y as ensureWorkspaceStorage } from "./state-CZ-ER-8d.mjs";
+import { C as removeTemporaryEntry, S as makeTemporaryDirectory } from "./worktree-C79xx_kM.mjs";
+import { i as detectIsExpo, o as isPackageResolvable } from "./project-BBTVABUz.mjs";
+import { n as stripAnsi, r as waitForChild, t as createLineReader } from "./process-output-C7IlIzd7.mjs";
+import { t as NOT_OURS_FOREIGN_CWD } from "./metro-COslRK_F.mjs";
+import { i as LAUNCH_BUNDLING, s as LAUNCH_UNVERIFIED } from "./app-install-NFxUahnH.mjs";
+import { f as startBuildHeartbeat, p as tailLines, r as HEARTBEAT_INTERVAL_MS } from "./xcode-DeKCribl.mjs";
+import { i as expoBinRefusal, r as expoBinPath, t as cleanLine } from "./server-expo-C3ktAwUG.mjs";
+import { existsSync, mkdirSync, readFileSync, readdirSync } from "node:fs";
+import { basename, join } from "node:path";
+import chalk from "chalk";
+import { request } from "node:http";
+//#region src/engine/metro-warmup.ts
+const WARMUP_TIMEOUT_MS = 6e4;
+async function requestLocal(url, platform, prefetch) {
+	return new Promise((resolve) => {
+		const req = request(url, { headers: {
+			accept: "application/json",
+			"expo-platform": platform,
+			...prefetch ? { "x-stim-metro-warmup": "1" } : {}
+		} });
+		const timer = setTimeout(() => req.destroy(), WARMUP_TIMEOUT_MS);
+		timer.unref();
+		req.on("socket", (socket) => socket.unref());
+		req.on("error", () => resolve(null));
+		req.on("close", () => {
+			clearTimeout(timer);
+			resolve(null);
+		});
+		req.on("response", (res) => {
+			let body = "";
+			res.setEncoding("utf8");
+			res.on("data", (chunk) => {
+				if (!prefetch) body += chunk;
+			});
+			res.on("error", () => resolve(null));
+			res.on("end", () => resolve(res.statusCode === 200 ? body : null));
+		});
+		req.end();
+	});
+}
+async function warmMetro({ port, platform, isExpo, appId, bundleUrl }) {
+	try {
+		const origin = `http://127.0.0.1:${port}`;
+		if (await requestLocal(new URL("/_stim/metro-warmup", origin), platform, false) !== "ready") return;
+		const url = new URL("/index.bundle", origin);
+		url.search = new URLSearchParams({
+			platform,
+			dev: "true",
+			lazy: "true",
+			minify: "false",
+			...platform === "ios" ? { inlineSourceMap: "false" } : {},
+			modulesOnly: "false",
+			runModule: "true",
+			excludeSource: "true",
+			sourcePaths: "url-server",
+			...appId ? { app: appId } : {}
+		}).toString();
+		if (!bundleUrl && isExpo) {
+			const body = await requestLocal(new URL(origin), platform, false);
+			if (body === null) return;
+			const manifest = JSON.parse(body);
+			bundleUrl = manifest.launchAsset?.url ?? manifest.bundleUrl;
+			if (typeof bundleUrl !== "string") return;
+		}
+		if (bundleUrl) {
+			const bundle = new URL(bundleUrl, origin);
+			url.pathname = bundle.pathname;
+			url.search = bundle.search;
+		}
+		await requestLocal(url, platform, true);
+	} catch {}
+}
+//#endregion
+//#region src/commands/native-runtime.ts
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+const GATE_RETRY_DELAYS_MS = [
+	3e3,
+	7e3,
+	1e4
+];
+function gateShouldRetry(resolution) {
+	if (resolution?.metro) return false;
+	return resolution?.kind !== NOT_OURS_FOREIGN_CWD;
+}
+async function resolveMetroWithRetry(resolve, port, root, { delays = GATE_RETRY_DELAYS_MS, sleep: wait = sleep, onRetry = (_info) => {} } = {}) {
+	let resolution = await resolve(port, root);
+	for (let i = 0; i < delays.length && gateShouldRetry(resolution); i++) {
+		const delayMs = delays[i];
+		if (delayMs === void 0) break;
+		onRetry({
+			attempt: i + 1,
+			delayMs,
+			resolution
+		});
+		await wait(delayMs);
+		resolution = await resolve(port, root);
+	}
+	return resolution;
+}
+function noMetroMessage({ port, resolution, supervisor, supervisorAlive }) {
+	const foreign = resolution?.notOurs;
+	if (supervisor && supervisor.port === port && supervisorAlive) {
+		const mode = supervisor.mode ? `${supervisor.mode} ` : "";
+		return `A supervisor record exists for port ${port} (pid ${supervisor.pid}, ${mode}dev server) but it did not verify as this workspace's Metro${foreign ? `: ${foreign}` : " -- nothing answered /status"}. Metro may still be indexing this project (a monorepo file-map crawl blocks its event loop for ~20s after the port opens).`;
+	}
+	if (foreign) return `Port ${port} is in use but is NOT this workspace's dev server: ${foreign}.`;
+	return `Nothing is serving this workspace's dev server on port ${port}.`;
+}
+function noMetroRemedy({ port, supervisor, supervisorAlive }) {
+	if (supervisor && supervisor.port === port && supervisorAlive) return "Re-run `stim ios` in a few seconds, or give the dev server longer to verify with `stim start --wait <seconds>`.";
+	return "Run `stim start` first, or pass --no-metro-check.";
+}
+async function ensureWorkspaceStorageSafely(root, { note = (_line) => {} } = {}) {
+	try {
+		return ensureWorkspaceStorage(root);
+	} catch (err) {
+		note(chalk.dim(`Could not prepare this workspace's Stim state: ${err?.message || err}`));
+		throw err;
+	}
+}
+function launchOutcomeRecord({ launchState, release, bundleId, configuration, metroPort }) {
+	const unverified = launchState === LAUNCH_UNVERIFIED;
+	const bundling = launchState === LAUNCH_BUNDLING;
+	let msg;
+	if (release) msg = unverified ? `${bundleId} could not be verified as running after its ${configuration} launch` : `${bundleId} is running its embedded ${configuration} bundle`;
+	else if (unverified) msg = `no bundle request from ${bundleId} reached this workspace's Metro on port ${metroPort}`;
+	else if (bundling) msg = `${bundleId} requested a bundle from this workspace's Metro on port ${metroPort}; it was still being built when the launch check ended`;
+	else msg = `${bundleId} fetched a bundle from this workspace's Metro on port ${metroPort}`;
+	return {
+		src: "build",
+		level: unverified ? "warn" : "info",
+		event: unverified ? "launch_unverified" : bundling ? "launch_bundling" : "launch_verified",
+		msg
+	};
+}
+//#endregion
+//#region src/engine/prebuild.ts
+const PREBUILD_ERROR = "STIM_PREBUILD_FAILED";
+const LAST_LINES$1 = 20;
+function nativeDirName(platform) {
+	return platform === "android" ? "android" : "ios";
+}
+function nativeDir(root, platform) {
+	return join(root, nativeDirName(platform));
+}
+function shouldPrebuild({ isExpo, nativeDirExists }) {
+	return Boolean(isExpo) && !nativeDirExists;
+}
+function needsPrebuild(root, platform, isExpo) {
+	return shouldPrebuild({
+		isExpo,
+		nativeDirExists: existsSync(nativeDir(root, platform))
+	});
+}
+function prebuildRefusal({ isExpo, platform, nativeDirExists }) {
+	if (nativeDirExists || isExpo) return null;
+	const dir = nativeDirName(platform);
+	return {
+		code: PREBUILD_ERROR,
+		message: `This project has no ${dir}/ directory and is not an Expo (CNG) project, so Stim cannot generate one.`,
+		remedy: `Check out or generate the native project (\`npx @react-native-community/cli init\` produced one originally), or add \`expo\` to the project so \`expo prebuild\` can create ${dir}/.`
+	};
+}
+function prebuildFailure(logWriter, result) {
+	logWriter?.write?.({
+		src: "build",
+		level: "error",
+		msg: result.reason || "Expo prebuild failed.",
+		event: "prebuild_failed"
+	});
+	return result;
+}
+async function runPrebuild(root, platform, logWriter, { spawnFn = null, now = Date.now, isExpo = null } = {}) {
+	const dirExists = existsSync(nativeDir(root, platform));
+	const refusal = prebuildRefusal({
+		isExpo: isExpo === null ? detectIsExpo(root) : isExpo,
+		platform,
+		nativeDirExists: dirExists
+	});
+	if (refusal) return prebuildFailure(logWriter, {
+		failed: true,
+		code: refusal.code,
+		reason: refusal.message,
+		remedy: refusal.remedy,
+		error: refusal,
+		lastLines: []
+	});
+	const bin = expoBinPath(root);
+	if (!bin) {
+		const binRefusal = expoBinRefusal(root, "prebuild");
+		return prebuildFailure(logWriter, {
+			failed: true,
+			code: PREBUILD_ERROR,
+			reason: binRefusal.message,
+			remedy: binRefusal.remedy,
+			lastLines: []
+		});
+	}
+	const spawn = spawnFn || ((cmd, args, opts) => getExecutor().spawn(cmd, args, opts));
+	const startedAt = now();
+	const tail = [];
+	const push = (line) => {
+		const msg = stripAnsi(String(line)).trimEnd();
+		if (!msg.trim()) return;
+		tail.push(msg);
+		if (tail.length > LAST_LINES$1) tail.shift();
+		logWriter?.write?.({
+			src: "build",
+			level: "debug",
+			msg,
+			raw: true,
+			event: "prebuild"
+		});
+	};
+	let child;
+	try {
+		child = spawn(bin, [
+			"prebuild",
+			"-p",
+			platform,
+			"--no-install"
+		], {
+			cwd: root,
+			stdio: [
+				"ignore",
+				"pipe",
+				"pipe"
+			],
+			env: {
+				...process.env,
+				FORCE_COLOR: "0",
+				CI: "1"
+			}
+		});
+	} catch (err) {
+		return prebuildFailure(logWriter, {
+			failed: true,
+			code: PREBUILD_ERROR,
+			reason: `Could not run \`expo prebuild\`: ${err?.message || err}`,
+			lastLines: []
+		});
+	}
+	const outReader = createLineReader(push);
+	const errReader = createLineReader(push);
+	child.stdout?.setEncoding?.("utf-8");
+	child.stderr?.setEncoding?.("utf-8");
+	child.stdout?.on("data", (chunk) => outReader.push(chunk));
+	child.stderr?.on("data", (chunk) => errReader.push(chunk));
+	const result = await waitForChild(child);
+	outReader.flush();
+	errReader.flush();
+	const durationMs = now() - startedAt;
+	if (result.error) return prebuildFailure(logWriter, {
+		failed: true,
+		code: PREBUILD_ERROR,
+		reason: `Could not run \`expo prebuild\`: ${result.error?.message || result.error}`,
+		lastLines: tail.slice(),
+		durationMs
+	});
+	if (result.code !== 0) {
+		const how = result.signal ? `signal ${result.signal}` : `exit code ${result.code}`;
+		return prebuildFailure(logWriter, {
+			failed: true,
+			code: PREBUILD_ERROR,
+			reason: `\`expo prebuild -p ${platform}\` failed (${how}).`,
+			lastLines: tail.slice(),
+			durationMs
+		});
+	}
+	if (!existsSync(nativeDir(root, platform))) return prebuildFailure(logWriter, {
+		failed: true,
+		code: PREBUILD_ERROR,
+		reason: `\`expo prebuild -p ${platform}\` succeeded but did not create ${nativeDirName(platform)}/.`,
+		lastLines: tail.slice(),
+		durationMs
+	});
+	return {
+		ok: true,
+		durationMs,
+		nativeDir: nativeDir(root, platform)
+	};
+}
+//#endregion
+//#region src/engine/js-swap.ts
+const JS_BUNDLE_NAME = "main.jsbundle";
+const LAST_LINES = 5;
+function hermesEnabledFromProperties(text) {
+	if (typeof text !== "string") return true;
+	let data;
+	try {
+		data = JSON.parse(text);
+	} catch {
+		return true;
+	}
+	if (!data || typeof data !== "object") return true;
+	const raw = data.hermesEnabled;
+	return raw !== "false" && raw !== false;
+}
+function readHermesEnabled(root) {
+	try {
+		return hermesEnabledFromProperties(readFileSync(join(root, "ios", "Podfile.properties.json"), "utf-8"));
+	} catch {
+		return true;
+	}
+}
+const ENTRY_CANDIDATES = [
+	"index.js",
+	"index.ts",
+	"index.tsx",
+	"index.jsx"
+];
+function pickEntryFile(entries) {
+	const names = new Set((Array.isArray(entries) ? entries : []).filter((e) => typeof e === "string"));
+	return ENTRY_CANDIDATES.find((c) => names.has(c)) ?? "index.js";
+}
+function detectEntryFile(root) {
+	let entries;
+	try {
+		entries = readdirSync(root);
+	} catch {
+		return "index.js";
+	}
+	return pickEntryFile(entries);
+}
+function bundleCommand({ isExpo, entryFile, bundleOutput, assetsDest }) {
+	if (isExpo) return {
+		file: "npx",
+		args: [
+			"expo",
+			"export:embed",
+			"--platform",
+			"ios",
+			"--dev",
+			"false",
+			"--bundle-output",
+			bundleOutput,
+			"--assets-dest",
+			assetsDest
+		]
+	};
+	return {
+		file: "npx",
+		args: [
+			"react-native",
+			"bundle",
+			"--platform",
+			"ios",
+			"--dev",
+			"false",
+			"--entry-file",
+			entryFile,
+			"--bundle-output",
+			bundleOutput,
+			"--assets-dest",
+			assetsDest
+		]
+	};
+}
+function hermescPath(root, { exists = existsSync } = {}) {
+	const candidates = [
+		join(root, "node_modules", "hermes-compiler", "hermesc", "osx-bin", "hermesc"),
+		join(root, "ios", "Pods", "hermes-engine", "destroot", "bin", "hermesc"),
+		join(root, "node_modules", "react-native", "sdks", "hermesc", "osx-bin", "hermesc")
+	];
+	return candidates.find(exists) ?? candidates[candidates.length - 1];
+}
+function hermescArgs({ bundle, out }) {
+	return [
+		"-emit-binary",
+		"-out",
+		out,
+		bundle
+	];
+}
+async function swapJsBundle({ root, isExpo, cachedAppPath, logWriter = null, exec = null, spawnFn = null, mkdtemp = () => makeTemporaryDirectory(cachedAppPath, "stim-js-swap-"), exists = existsSync, hermesEnabled = null, now = Date.now, heartbeatMs = HEARTBEAT_INTERVAL_MS, onHeartbeat = (line) => console.error(line) }) {
+	const e = exec || getExecutor();
+	const startedAt = now();
+	const elapsed = () => now() - startedAt;
+	let tmp;
+	const fail = (step, reason, lastLines = []) => {
+		logWriter?.write?.({
+			src: "build",
+			level: "error",
+			msg: `JS swap failed at ${step}: ${reason}`,
+			event: "js_swap"
+		});
+		if (tmp) removeTemporaryEntry(tmp);
+		return {
+			failed: true,
+			step,
+			reason,
+			lastLines,
+			durationMs: elapsed()
+		};
+	};
+	let appCopy;
+	try {
+		tmp = mkdtemp();
+		appCopy = join(tmp, basename(cachedAppPath));
+		try {
+			e.runFile("cp", [
+				"-c",
+				"-R",
+				cachedAppPath,
+				appCopy
+			]);
+		} catch {
+			e.runFile("cp", [
+				"-R",
+				cachedAppPath,
+				appCopy
+			]);
+		}
+	} catch (err) {
+		return fail("copy", `could not copy ${cachedAppPath} aside: ${describe(err)}`);
+	}
+	const bundleOutput = join(tmp, JS_BUNDLE_NAME);
+	const assetsDest = join(tmp, "assets");
+	const command = bundleCommand({
+		isExpo,
+		entryFile: isExpo ? "index.js" : detectEntryFile(root),
+		bundleOutput,
+		assetsDest
+	});
+	try {
+		mkdirSync(assetsDest, { recursive: true });
+	} catch (err) {
+		return fail("bundle", `could not create ${assetsDest}: ${describe(err)}`);
+	}
+	logWriter?.write?.({
+		src: "build",
+		level: "info",
+		msg: `${command.file} ${command.args.join(" ")}`,
+		event: "js_swap"
+	});
+	const spawn = spawnFn || ((cmd, args, opts) => e.spawn(cmd, args, opts));
+	const transcript = [];
+	const push = (line) => {
+		const msg = cleanLine(line);
+		if (msg.trim() === "") return;
+		transcript.push(msg);
+		logWriter?.write?.({
+			src: "build",
+			level: "debug",
+			msg,
+			raw: true,
+			event: "js_swap"
+		});
+	};
+	let child;
+	try {
+		child = spawn(command.file, command.args, {
+			cwd: root,
+			stdio: [
+				"ignore",
+				"pipe",
+				"pipe"
+			],
+			env: {
+				...process.env,
+				FORCE_COLOR: "0"
+			}
+		});
+	} catch (err) {
+		return fail("bundle", `could not run ${command.file} ${command.args[0]}: ${describe(err)}`);
+	}
+	const reader = {
+		out: createLineReader(push),
+		err: createLineReader(push)
+	};
+	child.stdout?.setEncoding?.("utf-8");
+	child.stderr?.setEncoding?.("utf-8");
+	child.stdout?.on("data", (chunk) => reader.out.push(chunk));
+	child.stderr?.on("data", (chunk) => reader.err.push(chunk));
+	const stopHeartbeat = startBuildHeartbeat({
+		intervalMs: heartbeatMs,
+		elapsed,
+		emit: onHeartbeat,
+		label: "swap"
+	});
+	let outcome;
+	try {
+		outcome = await waitForChild(child);
+	} finally {
+		stopHeartbeat();
+	}
+	reader.out.flush();
+	reader.err.flush();
+	if (outcome.error) return fail("bundle", `could not run ${command.file} ${command.args[0]}: ${describe(outcome.error)}`);
+	if (outcome.code !== 0) {
+		const how = outcome.signal ? `signal ${outcome.signal}` : `exit code ${outcome.code}`;
+		return fail("bundle", `\`${command.args.slice(0, 2).join(" ")}\` failed (${how})`, tailLines(transcript, LAST_LINES));
+	}
+	if (!exists(bundleOutput)) return fail("bundle", `the bundle command exited 0 but wrote no ${JS_BUNDLE_NAME} at ${bundleOutput}`);
+	let hermes = false;
+	let note;
+	if (hermesEnabled ?? readHermesEnabled(root)) {
+		const hermesc = hermescPath(root);
+		if (!exists(hermesc)) note = `hermesc not found at ${hermesc}; embedding the plain JS bundle instead of Hermes bytecode`;
+		else {
+			const hbc = join(tmp, `${JS_BUNDLE_NAME}.hbc`);
+			try {
+				e.runFile(hermesc, hermescArgs({
+					bundle: bundleOutput,
+					out: hbc
+				}));
+				e.runFile("mv", [hbc, bundleOutput]);
+				hermes = true;
+			} catch (err) {
+				return fail("hermesc", `hermesc failed on ${bundleOutput}: ${describe(err)}`);
+			}
+		}
+	}
+	try {
+		e.runFile("cp", [bundleOutput, join(appCopy, JS_BUNDLE_NAME)]);
+		e.runFile("cp", [
+			"-R",
+			`${assetsDest}/.`,
+			`${appCopy}/`
+		]);
+	} catch (err) {
+		return fail("replace", `could not replace the JS bundle inside ${appCopy}: ${describe(err)}`);
+	}
+	try {
+		e.runFile("codesign", [
+			"--force",
+			"--sign",
+			"-",
+			appCopy
+		]);
+	} catch (err) {
+		return fail("codesign", `codesign --force --sign - ${appCopy} failed: ${describe(err)}`);
+	}
+	logWriter?.write?.({
+		src: "build",
+		level: "info",
+		msg: `JS swap done: ${hermes ? "hermes bytecode" : "plain JS"} into ${appCopy} in ${elapsed()}ms`,
+		event: "js_swap"
+	});
+	const result = {
+		ok: true,
+		appPath: appCopy,
+		tmpDir: tmp,
+		hermes,
+		durationMs: elapsed()
+	};
+	if (note) result.note = note;
+	return result;
+}
+function describe(err) {
+	return String(err?.message || err);
+}
+//#endregion
+//#region src/commands/dev-client.ts
+function devClientScheme(root, appPath = null, { exec = null } = {}) {
+	if (!hasDevClient(root)) return void 0;
+	const fromBundle = pickDevClientScheme(readBundleSchemes(appPath, { exec }));
+	if (fromBundle) return fromBundle;
+	const app = readJson(join(root, "app.json"));
+	const raw = app?.expo?.scheme ?? app?.scheme ?? null;
+	const scheme = Array.isArray(raw) ? raw.find((s) => typeof s === "string" && s.trim() !== "") : raw;
+	if (typeof scheme !== "string" || scheme.trim() === "") return void 0;
+	return scheme.trim();
+}
+function schemesFromInfoPlist(plist) {
+	const types = plist?.CFBundleURLTypes;
+	if (!Array.isArray(types)) return [];
+	const out = [];
+	for (const type of types) {
+		const schemes = type?.CFBundleURLSchemes;
+		if (Array.isArray(schemes)) out.push(...schemes.filter((s) => typeof s === "string" && s.trim() !== ""));
+	}
+	return out;
+}
+function readBundleSchemes(appPath, { exec = null } = {}) {
+	if (typeof appPath !== "string" || appPath.trim() === "") return [];
+	const e = exec || getExecutor();
+	let out;
+	try {
+		out = e.runFile("plutil", [
+			"-convert",
+			"json",
+			"-o",
+			"-",
+			join(appPath, "Info.plist")
+		]);
+	} catch {
+		return [];
+	}
+	try {
+		return schemesFromInfoPlist(JSON.parse(String(out)));
+	} catch {
+		return [];
+	}
+}
+const THIRD_PARTY_SCHEME = /^(?:fb\d+|com\.googleusercontent\.apps\.|msauth\.|msauthv2|twitterkit-|db-[a-z0-9]+$|spotify|snapchat|com\.facebook)/i;
+function pickDevClientScheme(schemes) {
+	const all = (Array.isArray(schemes) ? schemes : []).filter((s) => typeof s === "string" && s.trim() !== "").map((s) => s.trim()).filter((s) => !/^(?:https?|mailto|tel|sms|itms(?:-apps)?)$/i.test(s));
+	const expo = all.filter((s) => s.startsWith("exp+"));
+	return (expo.length ? expo : all.filter((s) => !THIRD_PARTY_SCHEME.test(s))).toSorted((a, b) => b.length - a.length)[0] ?? null;
+}
+function hasDevClient(root) {
+	const pkg = readJson(join(root, "package.json"));
+	if ("expo-dev-client" in {
+		...pkg?.dependencies,
+		...pkg?.devDependencies
+	}) return true;
+	return isPackageResolvable(root, "expo-dev-client");
+}
+function readJson(file) {
+	try {
+		return JSON.parse(readFileSync(file, "utf-8"));
+	} catch {
+		return null;
+	}
+}
+//#endregion
+export { swapJsBundle as a, ensureWorkspaceStorageSafely as c, noMetroMessage as d, noMetroRemedy as f, warmMetro as h, detectEntryFile as i, gateShouldRetry as l, sleep as m, pickDevClientScheme as n, needsPrebuild as o, resolveMetroWithRetry as p, schemesFromInfoPlist as r, runPrebuild as s, devClientScheme as t, launchOutcomeRecord as u };