stim 1.20.2 → 1.22.0

package/dist/app-install-BIKtMfPq.mjs

@@ -1,896 +0,0 @@
-import { r as debugLog, t as getExecutor } from "./exec-DqKo9GKJ.mjs";
-import { R as deviceHoldsApk, g as listUserApps, k as uninstallIosApp, u as iosSimulatorFailureAdvice, z as deviceHoldsBundle } from "./ios-RkW4pnQf.mjs";
-import { t as DEV_MENU_LAUNCH_ARGS } from "./ios-device-B5veSDDQ.mjs";
-import { join } from "node:path";
-//#region src/engine/app-schemes.ts
-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")
-		], { timeoutMs: 1e4 });
-	} 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 approvableSchemes(schemes) {
-	return (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) && !THIRD_PARTY_SCHEME.test(s));
-}
-function pickDevClientScheme(schemes) {
-	const all = approvableSchemes(schemes);
-	const expo = all.filter((s) => s.startsWith("exp+"));
-	return (expo.length ? expo : all).toSorted((a, b) => b.length - a.length)[0] ?? null;
-}
-//#endregion
-//#region src/engine/app-install.ts
-const INSTALL_ERROR = "STIM_INSTALL_FAILED";
-const LAUNCH_ERROR = "STIM_LAUNCH_FAILED";
-const DEFAULT_METRO_PORT = 8081;
-const IOS_SCHEME_APPROVAL_DOMAIN = "com.apple.launchservices.schemeapproval";
-const IOS_SCHEME_APPROVAL_OPENER = "com.apple.CoreSimulator.CoreSimulatorBridge";
-const IOS_DEV_MENU_OFF_KEYS = ["EXDevMenuShowsAtLaunch", "EXDevMenuShowFloatingActionButton"];
-const DEV_CLIENT_ONBOARDING_QUERY = "disableOnboarding=1";
-const DEV_CLIENT_DISABLE_FAB_QUERY = "disableFab=1";
-const DEV_CLIENT_DEV_MENU_OFF_QUERY = "disableFab=1&disableAutoLaunch=1";
-const DEV_CLIENT_RESERVED_DEV_MENU_OFF_QUERY = "__expo_disable_fab=1&__expo_disable_auto_launch=1";
-const ANDROID_DISABLE_AUTO_LAUNCH_EXTRA = "EXDevMenuDisableAutoLaunch";
-const IOS_DEV_MENU_OFF_DEFAULTS_PLIST = [
-	"<?xml version=\"1.0\" encoding=\"UTF-8\"?>",
-	"<!DOCTYPE plist PUBLIC \"-//Apple//DTD PLIST 1.0//EN\" \"http://www.apple.com/DTDs/PropertyList-1.0.dtd\">",
-	"<plist version=\"1.0\">",
-	"<dict>",
-	...IOS_DEV_MENU_OFF_KEYS.flatMap((key) => [`  <key>${key}</key>`, "  <false/>"]),
-	"</dict>",
-	"</plist>",
-	""
-].join("\n");
-function writeIosDevMenuOffDefaults(udid, bundleId, exec) {
-	for (const key of IOS_DEV_MENU_OFF_KEYS) exec.runFile("xcrun", [
-		"simctl",
-		"spawn",
-		udid,
-		"defaults",
-		"write",
-		bundleId,
-		key,
-		"-bool",
-		"false"
-	], { timeoutMs: 6e4 });
-}
-function describeIosSimulatorFailure(error, exec) {
-	const detail = describe(error);
-	return error?.code === "ETIMEDOUT" ? `${detail}. ${iosSimulatorFailureAdvice(exec)}` : detail;
-}
-function installIosApp({ udid, appPath, bundleId = null, devClientScheme = null, schemeApprovals = [], proveInstalled = true }, { exec = null, now = null } = {}) {
-	const e = exec || getExecutor();
-	const artifactStartedAt = now?.();
-	const skipped = bundleId && proveInstalled ? deviceHoldsBundle({
-		udid,
-		bundleId,
-		appPath
-	}, { exec: e }) : false;
-	if (!skipped) try {
-		e.runFile("xcrun", [
-			"simctl",
-			"install",
-			udid,
-			appPath
-		], {
-			timeoutMs: 3e5,
-			killSignal: "SIGKILL"
-		});
-	} catch (err) {
-		return {
-			failed: true,
-			code: INSTALL_ERROR,
-			reason: `simctl install failed for ${appPath}: ${describeIosSimulatorFailure(err, e)}`
-		};
-	}
-	const artifactFinishedAt = now?.();
-	const artifactDurationMs = artifactStartedAt !== void 0 && artifactFinishedAt !== void 0 ? artifactFinishedAt - artifactStartedAt : void 0;
-	const devMenuKeys = bundleId && devClientScheme && !skipped ? IOS_DEV_MENU_OFF_KEYS : [];
-	const missingApprovals = (bundleId ? iosSchemeApprovalKeys(bundleId, [...approvableSchemes(readBundleSchemes(appPath, { exec: e })), ...devClientScheme ? [devClientScheme] : []]) : []).filter((key) => !schemeApprovals.includes(`${key}=${bundleId}`));
-	const preparing = bundleId && (devMenuKeys.length > 0 || missingApprovals.length > 0);
-	const preparationStartedAt = preparing ? artifactFinishedAt : void 0;
-	if (bundleId && preparing) try {
-		if (devMenuKeys.length > 0) writeIosDevMenuOffDefaults(udid, bundleId, e);
-		for (const key of missingApprovals) e.runFile("xcrun", [
-			"simctl",
-			"spawn",
-			udid,
-			"defaults",
-			"write",
-			IOS_SCHEME_APPROVAL_DOMAIN,
-			key,
-			"-string",
-			bundleId
-		], { timeoutMs: 6e4 });
-	} catch (err) {
-		return {
-			failed: true,
-			code: INSTALL_ERROR,
-			reason: `Installed ${bundleId}, but could not prepare the dev client: ${describeIosSimulatorFailure(err, e)}`
-		};
-	}
-	const devClientPreparationDurationMs = now && preparationStartedAt !== void 0 ? now() - preparationStartedAt : void 0;
-	const timing = {
-		...artifactDurationMs === void 0 ? {} : { artifactDurationMs },
-		...devClientPreparationDurationMs === void 0 ? {} : { devClientPreparationDurationMs },
-		...missingApprovals.length > 0 ? { schemeApprovals: [...schemeApprovals, ...missingApprovals.map((key) => `${key}=${bundleId}`)] } : {}
-	};
-	return skipped ? {
-		ok: true,
-		appPath,
-		skipped: true,
-		...timing
-	} : {
-		ok: true,
-		appPath,
-		...timing
-	};
-}
-function clearOtherUserApps({ udid, keep }, { list = listUserApps, uninstall = uninstallIosApp } = {}) {
-	const removed = [];
-	const failed = [];
-	let installed;
-	try {
-		installed = list(udid);
-	} catch {
-		return {
-			listed: false,
-			kept: false,
-			removed,
-			failed
-		};
-	}
-	for (const bundleId of installed) {
-		if (bundleId === keep) continue;
-		try {
-			uninstall(udid, bundleId);
-			removed.push(bundleId);
-		} catch {
-			failed.push(bundleId);
-		}
-	}
-	return {
-		listed: true,
-		kept: keep ? installed.includes(keep) : false,
-		removed,
-		failed
-	};
-}
-function jsLocationValue(metroPort) {
-	return `localhost:${metroPort}`;
-}
-function devClientDeepLink(scheme, projectOrigin, { devMenuParams = false } = {}) {
-	const projectQuery = devMenuParams ? `${DEV_CLIENT_ONBOARDING_QUERY}&${DEV_CLIENT_DEV_MENU_OFF_QUERY}&${DEV_CLIENT_RESERVED_DEV_MENU_OFF_QUERY}` : DEV_CLIENT_ONBOARDING_QUERY;
-	const projectUrl = `${projectOrigin.replace(/\/+$/, "")}/?${projectQuery}`;
-	return `${scheme}://expo-development-client/?url=${encodeURIComponent(projectUrl)}&${devMenuParams ? DEV_CLIENT_DEV_MENU_OFF_QUERY : DEV_CLIENT_DISABLE_FAB_QUERY}`;
-}
-function devClientUrl(scheme, metroPort, host = "localhost", options = {}) {
-	return devClientDeepLink(scheme, `http://${host}:${metroPort}`, options);
-}
-function iosSchemeApprovalKeys(bundleId, schemes) {
-	return [.../* @__PURE__ */ new Set([bundleId, ...schemes])].map((target) => `${IOS_SCHEME_APPROVAL_OPENER}-->${target}`);
-}
-function restartedAppNote(restartedPid, lead = " ") {
-	return restartedPid ? `${lead}restarted running app (was pid ${restartedPid})` : "";
-}
-function parseLaunchedPid(text) {
-	if (typeof text !== "string") return null;
-	const match = text.trim().match(/:\s*(\d+)\s*$/);
-	if (!match) return null;
-	const pid = Number(match[1]);
-	return Number.isInteger(pid) && pid > 0 ? pid : null;
-}
-function appProcessFromPid(pid) {
-	return pid === null ? { state: "stopped" } : {
-		state: "running",
-		pid
-	};
-}
-function iosAppProcess(udid, bundleId, { exec = null } = {}) {
-	const e = exec || getExecutor();
-	const started = performance.now();
-	let probe = { state: "unknown" };
-	let failure = {};
-	try {
-		const out = e.runFile("xcrun", [
-			"simctl",
-			"spawn",
-			udid,
-			"launchctl",
-			"list"
-		], { timeoutMs: 2e3 });
-		const label = `UIKitApplication:${bundleId}[`;
-		probe = { state: "stopped" };
-		for (const line of out.split("\n")) {
-			if (!line.includes(label)) continue;
-			const candidate = Number(line.trim().split(/\s+/)[0]);
-			if (Number.isInteger(candidate) && candidate > 0) {
-				probe = {
-					state: "running",
-					pid: candidate
-				};
-				break;
-			}
-		}
-		return probe;
-	} catch (error) {
-		const { code, status } = error ?? {};
-		failure = {
-			...typeof code === "string" ? { code } : {},
-			...typeof status === "number" ? { exit: status } : {}
-		};
-		return probe;
-	} finally {
-		debugLog.log("ios.app-process", {
-			deviceId: udid,
-			bundleId,
-			state: probe.state === "stopped" ? "absent" : probe.state,
-			...probe.state === "running" ? { appPid: probe.pid } : {},
-			ms: Math.round(performance.now() - started),
-			...failure
-		});
-	}
-}
-function launchedIosAppAfterNoHandle(error, udid, bundleId, exec) {
-	const stderr = String(error?.stderr ?? "");
-	if (!stderr.includes("domain=NSPOSIXErrorDomain, code=3") || !stderr.includes(`Application launch for '${bundleId}' did not return a process handle nor launch error.`)) return null;
-	const probe = iosAppProcess(udid, bundleId, { exec });
-	return probe.state === "running" ? probe.pid : null;
-}
-function launchIosApp({ udid, bundleId, metroPort, devClientScheme = null, devMenuParams = false, consolePaths }, { exec = null } = {}) {
-	const e = exec || getExecutor();
-	const running = iosAppProcess(udid, bundleId, { exec: e });
-	const stateUnknown = running.state === "unknown";
-	const launchArgs = [
-		"simctl",
-		"launch",
-		...consolePaths ? [`--stdout=${consolePaths.stdout}`, `--stderr=${consolePaths.stderr}`] : [],
-		...stateUnknown ? ["--terminate-running-process"] : [],
-		udid,
-		bundleId
-	];
-	const restart = {};
-	if (running.state === "running") {
-		try {
-			e.runFile("xcrun", [
-				"simctl",
-				"terminate",
-				udid,
-				bundleId
-			], { timeoutMs: 3e4 });
-		} catch (err) {
-			return {
-				failed: true,
-				code: LAUNCH_ERROR,
-				reason: `simctl terminate ${bundleId} failed, so the running app (pid ${running.pid}) was not restarted: ${describeIosSimulatorFailure(err, e)}`
-			};
-		}
-		restart.restartedPid = running.pid;
-	}
-	if (metroPort !== null) {
-		try {
-			e.runFile("xcrun", [
-				"simctl",
-				"spawn",
-				udid,
-				"defaults",
-				"write",
-				bundleId,
-				"RCT_jsLocation",
-				jsLocationValue(metroPort)
-			], { timeoutMs: 6e4 });
-		} catch (err) {
-			return {
-				failed: true,
-				code: LAUNCH_ERROR,
-				reason: `Could not point ${bundleId} at Metro port ${metroPort} (defaults write RCT_jsLocation): ${describeIosSimulatorFailure(err, e)}`
-			};
-		}
-		if (devClientScheme) {
-			const url = devClientUrl(devClientScheme, metroPort, "localhost", { devMenuParams });
-			const viaInitialUrl = Boolean(consolePaths) || stateUnknown;
-			if (!viaInitialUrl) try {
-				writeIosDevMenuOffDefaults(udid, bundleId, e);
-			} catch (err) {
-				return {
-					failed: true,
-					code: LAUNCH_ERROR,
-					reason: `Could not turn off ${bundleId}'s dev menu before opening it (defaults write): ${describeIosSimulatorFailure(err, e)}`
-				};
-			}
-			let launchedWithInitialUrl = false;
-			try {
-				if (viaInitialUrl) {
-					const initialUrl = new URL(url).searchParams.get("url");
-					launchedWithInitialUrl = true;
-					const pid = parseLaunchedPid(e.runFile("xcrun", [
-						...launchArgs,
-						"--initialUrl",
-						initialUrl,
-						...DEV_MENU_LAUNCH_ARGS
-					], { timeoutMs: 6e4 }));
-					return {
-						ok: true,
-						mode: "launch",
-						url,
-						jsLocation: jsLocationValue(metroPort),
-						pid,
-						...restart
-					};
-				}
-				e.runFile("xcrun", [
-					"simctl",
-					"openurl",
-					udid,
-					url
-				], { timeoutMs: 6e4 });
-				return {
-					ok: true,
-					mode: "openurl",
-					url,
-					jsLocation: jsLocationValue(metroPort),
-					...restart
-				};
-			} catch (err) {
-				const pid = launchedWithInitialUrl && !stateUnknown ? launchedIosAppAfterNoHandle(err, udid, bundleId, e) : null;
-				if (pid && pid !== restart.restartedPid) return {
-					ok: true,
-					mode: "launch",
-					url,
-					jsLocation: jsLocationValue(metroPort),
-					pid,
-					...restart
-				};
-				return {
-					failed: true,
-					code: LAUNCH_ERROR,
-					reason: `simctl ${launchedWithInitialUrl ? `launch ${bundleId}` : `openurl ${url}`} failed: ${describeIosSimulatorFailure(err, e)}`
-				};
-			}
-		}
-	}
-	try {
-		const result = {
-			ok: true,
-			mode: "launch",
-			pid: parseLaunchedPid(e.runFile("xcrun", launchArgs, { timeoutMs: 6e4 })),
-			...restart
-		};
-		if (metroPort !== null) result.jsLocation = jsLocationValue(metroPort);
-		return result;
-	} catch (err) {
-		const pid = stateUnknown ? null : launchedIosAppAfterNoHandle(err, udid, bundleId, e);
-		if (pid && pid !== restart.restartedPid) {
-			const result = {
-				ok: true,
-				mode: "launch",
-				pid,
-				...restart
-			};
-			if (metroPort !== null) result.jsLocation = jsLocationValue(metroPort);
-			return result;
-		}
-		return {
-			failed: true,
-			code: LAUNCH_ERROR,
-			reason: `simctl launch ${bundleId} failed: ${describeIosSimulatorFailure(err, e)}`
-		};
-	}
-}
-function installConflictKind(text) {
-	const out = String(text ?? "");
-	if (/INSTALL_FAILED_UPDATE_INCOMPATIBLE|INSTALL_PARSE_FAILED_INCONSISTENT_CERTIFICATES|signatures do not match/i.test(out)) return "signature";
-	if (/INSTALL_FAILED_VERSION_DOWNGRADE/i.test(out)) return "downgrade";
-	return null;
-}
-const ADB_INSTALL_TIMEOUT_MS = 3e5;
-const ADB_UNINSTALL_TIMEOUT_MS = 12e4;
-const ADB_SHELL_OPTIONS = {
-	timeoutMs: 3e4,
-	killSignal: "SIGKILL"
-};
-function installAndroidApp({ serial, apkPath, packageName = null, allowUninstall = false }, { exec = null } = {}) {
-	const e = exec || getExecutor();
-	if (packageName && deviceHoldsApk({
-		serial,
-		packageName,
-		apkPath
-	}, { exec: e })) return {
-		ok: true,
-		apkPath,
-		skipped: true
-	};
-	const install = () => {
-		e.runFile("adb", [
-			"-s",
-			serial,
-			"install",
-			"-r",
-			apkPath
-		], { timeoutMs: ADB_INSTALL_TIMEOUT_MS });
-	};
-	try {
-		install();
-		return {
-			ok: true,
-			apkPath
-		};
-	} catch (err) {
-		const conflict = installConflictKind(describe(err));
-		if (!conflict || !allowUninstall || !packageName) return {
-			failed: true,
-			code: INSTALL_ERROR,
-			reason: `adb install failed for ${apkPath}: ${describe(err)}`
-		};
-		try {
-			e.runFile("adb", [
-				"-s",
-				serial,
-				"uninstall",
-				packageName
-			], {
-				timeoutMs: ADB_UNINSTALL_TIMEOUT_MS,
-				killSignal: "SIGKILL"
-			});
-		} catch (uninstallErr) {
-			return {
-				failed: true,
-				code: INSTALL_ERROR,
-				reason: `adb install failed for ${apkPath} (${conflict}) and ${packageName} could not be uninstalled: ` + describe(uninstallErr)
-			};
-		}
-		try {
-			install();
-		} catch (retryErr) {
-			return {
-				failed: true,
-				code: INSTALL_ERROR,
-				reason: `adb install failed for ${apkPath} even after uninstalling ${packageName}: ${describe(retryErr)}`
-			};
-		}
-		return {
-			ok: true,
-			apkPath,
-			uninstalled: true,
-			note: conflict === "signature" ? `${packageName} was already installed with a different signer, so it was uninstalled (its data went with it) before this APK could be installed` : `${packageName} was already installed at a higher versionCode, so it was uninstalled (its data went with it) before this APK could be installed`
-		};
-	}
-}
-function parseResolvedActivity(text) {
-	if (typeof text !== "string") return null;
-	for (const raw of text.split("\n")) {
-		const line = raw.trim();
-		if (!line) continue;
-		if (/^No activity found/i.test(line)) return null;
-		if (line.includes("=")) continue;
-		if (!line.includes("/")) continue;
-		return line;
-	}
-	return null;
-}
-function resolveLaunchActivity(serial, packageName, { exec = null } = {}) {
-	const e = exec || getExecutor();
-	try {
-		return parseResolvedActivity(e.runFile("adb", [
-			"-s",
-			serial,
-			"shell",
-			"cmd",
-			"package",
-			"resolve-activity",
-			"--brief",
-			"-c",
-			"android.intent.category.LAUNCHER",
-			packageName
-		], ADB_SHELL_OPTIONS));
-	} catch {
-		return null;
-	}
-}
-function reverseMetroPorts({ serial, metroPort, devicePorts = null }, { exec = null } = {}) {
-	const e = exec || getExecutor();
-	const pairs = (devicePorts ?? [metroPort]).map((device) => [device, metroPort]);
-	for (const [device, host] of pairs) try {
-		e.runFile("adb", [
-			"-s",
-			serial,
-			"reverse",
-			`tcp:${device}`,
-			`tcp:${host}`
-		], ADB_SHELL_OPTIONS);
-	} catch (err) {
-		return {
-			failed: true,
-			code: LAUNCH_ERROR,
-			reason: `adb reverse tcp:${device} tcp:${host} failed on ${serial}: ${describe(err)}`
-		};
-	}
-	return {
-		ok: true,
-		reversed: pairs.map(([device, host]) => `tcp:${device}->tcp:${host}`)
-	};
-}
-function hasMetroReverse(listing, metroPort) {
-	return String(listing ?? "").split("\n").some((line) => {
-		const cols = line.trim().split(/\s+/);
-		return cols[1] === `tcp:${metroPort}` && cols[2] === `tcp:${metroPort}`;
-	});
-}
-/** Re-applies the launch's `metroPort` reverse when the device no longer has it. */
-function ensureMetroReverse({ serial, metroPort }, { exec = null } = {}) {
-	const e = exec || getExecutor();
-	let listing;
-	try {
-		listing = e.runFile("adb", [
-			"-s",
-			serial,
-			"reverse",
-			"--list"
-		], ADB_SHELL_OPTIONS);
-	} catch {
-		return {
-			failed: true,
-			reason: `adb reverse --list failed on ${serial}`
-		};
-	}
-	if (hasMetroReverse(listing, metroPort)) return { restored: false };
-	const reversed = reverseMetroPorts({
-		serial,
-		metroPort
-	}, { exec: e });
-	return reversed.failed ? {
-		failed: true,
-		reason: reversed.reason ?? "adb reverse failed"
-	} : { restored: true };
-}
-const EMULATOR_HOST_LOOPBACK = "127.0.0.1";
-const PHYSICAL_HOST_LOOPBACK = "localhost";
-function androidMetroHost(physical) {
-	return physical ? PHYSICAL_HOST_LOOPBACK : EMULATOR_HOST_LOOPBACK;
-}
-function deviceShellArg(text) {
-	return `'${String(text).replace(/'/g, "'\\''")}'`;
-}
-function debugHttpHostScript({ packageName, host, dataDir = null }) {
-	const dir = dataDir || `/data/data/${packageName}`;
-	const prefs = `shared_prefs/${packageName}_preferences.xml`;
-	const tmp = `${prefs}.stim.tmp`;
-	return [
-		`cd ${dir} || exit 1`,
-		"mkdir -p shared_prefs || exit 1",
-		`printf '%s\\n' '<?xml version="1.0" encoding="utf-8" standalone="yes" ?>' '<map>' > ${tmp} || exit 1`,
-		`if [ -f ${prefs} ]; then grep -v 'debug_http_host' ${prefs} | grep -v '<?xml' | grep -v '<map' | grep -v '</map>' >> ${tmp}; fi`,
-		`printf '%s\\n' '    <string name="debug_http_host">${host}</string>' '</map>' >> ${tmp} || exit 1`,
-		`mv ${tmp} ${prefs} || exit 1`,
-		`grep -q '>${host}<' ${prefs} || exit 1`
-	].join("\n");
-}
-function writeDebugHttpHost({ serial, packageName, metroPort, physical = false }, { exec = null } = {}) {
-	const e = exec || getExecutor();
-	const host = `${androidMetroHost(physical)}:${metroPort}`;
-	const script = debugHttpHostScript({
-		packageName,
-		host
-	});
-	try {
-		e.runFile("adb", [
-			"-s",
-			serial,
-			"shell",
-			"run-as",
-			packageName,
-			"sh",
-			"-c",
-			deviceShellArg(script)
-		], ADB_SHELL_OPTIONS);
-		return {
-			ok: true,
-			host
-		};
-	} catch (err) {
-		return {
-			ok: false,
-			reason: `debug_http_host not written (${describe(err)}); relying on adb reverse`
-		};
-	}
-}
-function androidDevClientUrl(scheme, metroPort, physical = false) {
-	return devClientUrl(scheme, metroPort, androidMetroHost(physical));
-}
-function amStartError(text) {
-	const out = String(text ?? "");
-	for (const raw of out.split("\n")) {
-		const line = raw.trim();
-		if (/^Error:/i.test(line)) return line;
-	}
-	return null;
-}
-function openAndroidDevClientUrl({ serial, url, packageName, stopOnStart = false }, { exec = null } = {}) {
-	const e = exec || getExecutor();
-	let out;
-	try {
-		const args = [
-			"-s",
-			serial,
-			"shell",
-			"am",
-			"start",
-			...stopOnStart ? ["-S"] : [],
-			"-a",
-			"android.intent.action.VIEW",
-			"-d",
-			deviceShellArg(url),
-			...packageName ? ["-p", packageName] : [],
-			"--ez",
-			ANDROID_DISABLE_AUTO_LAUNCH_EXTRA,
-			"true"
-		];
-		out = e.runFile("adb", args, ADB_SHELL_OPTIONS);
-	} catch (err) {
-		return {
-			failed: true,
-			reason: `am start -d ${url} failed on ${serial}: ${describe(err)}`
-		};
-	}
-	const error = amStartError(out);
-	if (error) return {
-		failed: true,
-		reason: `am start -d ${url} did not start anything on ${serial}: ${error}`
-	};
-	return {
-		ok: true,
-		url
-	};
-}
-function stopRunningAndroidApp(serial, packageName, exec) {
-	const running = androidAppProcess(serial, packageName, { exec });
-	if (running.state === "stopped") return {};
-	if (running.state !== "running") return { stopOnStart: true };
-	try {
-		exec.runFile("adb", [
-			"-s",
-			serial,
-			"shell",
-			"am",
-			"force-stop",
-			packageName
-		], ADB_SHELL_OPTIONS);
-	} catch (err) {
-		return {
-			failed: true,
-			code: LAUNCH_ERROR,
-			reason: `am force-stop ${packageName} failed on ${serial}, so the running app (pid ${running.pid}) was not restarted: ${describe(err)}`
-		};
-	}
-	return { restartedPid: running.pid };
-}
-function launchAndroidWithMonkey(serial, packageName, stopOnStart, exec) {
-	if (stopOnStart) try {
-		exec.runFile("adb", [
-			"-s",
-			serial,
-			"shell",
-			"am",
-			"force-stop",
-			packageName
-		], ADB_SHELL_OPTIONS);
-	} catch {}
-	exec.runFile("adb", [
-		"-s",
-		serial,
-		"shell",
-		"monkey",
-		"-p",
-		packageName,
-		"1"
-	], ADB_SHELL_OPTIONS);
-}
-function launchAndroidApp({ serial, packageName, metroPort, devClientScheme = null, physical = false, bridgePort }, { exec = null } = {}) {
-	const e = exec || getExecutor();
-	const { stopOnStart = false, ...restart } = stopRunningAndroidApp(serial, packageName, e);
-	if (restart.failed) return restart;
-	const reversed = reverseMetroPorts({
-		serial,
-		metroPort: bridgePort ?? metroPort,
-		devicePorts: [metroPort]
-	}, { exec: e });
-	if (reversed.failed) return reversed;
-	const prefs = writeDebugHttpHost({
-		serial,
-		packageName,
-		metroPort,
-		physical
-	}, { exec: e });
-	let reversedPairs = reversed.reversed ?? [];
-	if (!prefs.ok && Number(metroPort) !== 8081) {
-		const fallback = reverseMetroPorts({
-			serial,
-			metroPort: bridgePort ?? metroPort,
-			devicePorts: [DEFAULT_METRO_PORT]
-		}, { exec: e });
-		if (fallback.failed) return fallback;
-		reversedPairs = [...reversedPairs, ...fallback.reversed ?? []];
-	}
-	const wiring = {
-		reversed: reversedPairs,
-		debugHttpHost: prefs.ok ? prefs.host : null,
-		debugHttpHostNote: prefs.ok ? null : prefs.reason,
-		...restart
-	};
-	let devClientNote = null;
-	if (devClientScheme) {
-		const url = androidDevClientUrl(devClientScheme, metroPort, physical);
-		const opened = openAndroidDevClientUrl({
-			serial,
-			url,
-			stopOnStart
-		}, { exec: e });
-		if (opened.ok) return {
-			ok: true,
-			mode: "deep-link",
-			devClientUrl: url,
-			...wiring
-		};
-		devClientNote = `${opened.reason}; fell back to the launcher activity`;
-	}
-	const component = resolveLaunchActivity(serial, packageName, { exec: e });
-	if (component) try {
-		e.runFile("adb", [
-			"-s",
-			serial,
-			"shell",
-			"am",
-			"start",
-			...stopOnStart ? ["-S"] : [],
-			"-n",
-			component
-		], ADB_SHELL_OPTIONS);
-		return {
-			ok: true,
-			mode: "am-start",
-			component,
-			devClientNote,
-			...wiring
-		};
-	} catch (err) {
-		return {
-			failed: true,
-			code: LAUNCH_ERROR,
-			reason: `am start -n ${component} failed on ${serial}: ${describe(err)}`
-		};
-	}
-	try {
-		launchAndroidWithMonkey(serial, packageName, stopOnStart, e);
-		return {
-			ok: true,
-			mode: "monkey",
-			devClientNote,
-			...wiring
-		};
-	} catch (err) {
-		return {
-			failed: true,
-			code: LAUNCH_ERROR,
-			reason: `Could not launch ${packageName} on ${serial}: no launcher activity resolved and monkey failed: ${describe(err)}`
-		};
-	}
-}
-function launchAndroidReleaseApp({ serial, packageName }, { exec = null } = {}) {
-	const e = exec || getExecutor();
-	const { stopOnStart = false, ...restart } = stopRunningAndroidApp(serial, packageName, e);
-	if (restart.failed) return restart;
-	const component = resolveLaunchActivity(serial, packageName, { exec: e });
-	if (component) try {
-		e.runFile("adb", [
-			"-s",
-			serial,
-			"shell",
-			"am",
-			"start",
-			...stopOnStart ? ["-S"] : [],
-			"-n",
-			component
-		], ADB_SHELL_OPTIONS);
-		return {
-			ok: true,
-			mode: "am-start",
-			component,
-			...restart
-		};
-	} catch (err) {
-		return {
-			failed: true,
-			code: LAUNCH_ERROR,
-			reason: `am start -n ${component} failed on ${serial}: ${describe(err)}`
-		};
-	}
-	try {
-		launchAndroidWithMonkey(serial, packageName, stopOnStart, e);
-		return {
-			ok: true,
-			mode: "monkey",
-			...restart
-		};
-	} catch (err) {
-		return {
-			failed: true,
-			code: LAUNCH_ERROR,
-			reason: `Could not launch ${packageName} on ${serial}: no launcher activity resolved and monkey failed: ${describe(err)}`
-		};
-	}
-}
-function describe(err) {
-	const e = err;
-	const stderr = e?.stderr ? String(e.stderr).trim() : "";
-	const message = e?.message ? String(e.message).trim() : String(err);
-	return stderr ? `${message}: ${stderr}` : message;
-}
-function parsePidof(text) {
-	const first = String(text ?? "").trim().split(/\s+/)[0];
-	const pid = Number(first);
-	return Number.isFinite(pid) && pid > 0 ? pid : null;
-}
-function parsePsPid(text, packageName) {
-	for (const raw of String(text ?? "").split("\n")) {
-		const cols = raw.trim().split(/\s+/);
-		if (cols.length < 2) continue;
-		if (cols[cols.length - 1] !== packageName) continue;
-		const pid = Number(cols[1]);
-		if (Number.isFinite(pid) && pid > 0) return pid;
-	}
-	return null;
-}
-function androidAppProcess(serial, packageName, { exec = null } = {}) {
-	const e = exec || getExecutor();
-	try {
-		const pid = parsePidof(e.runFile("adb", [
-			"-s",
-			serial,
-			"shell",
-			"pidof",
-			packageName
-		], ADB_SHELL_OPTIONS));
-		if (pid !== null) return {
-			state: "running",
-			pid
-		};
-	} catch {}
-	try {
-		return appProcessFromPid(parsePsPid(e.runFile("adb", [
-			"-s",
-			serial,
-			"shell",
-			"ps",
-			"-A"
-		], ADB_SHELL_OPTIONS), packageName));
-	} catch {
-		return { state: "unknown" };
-	}
-}
-//#endregion
-export { restartedAppNote as C, readBundleSchemes as D, pickDevClientScheme as E, schemesFromInfoPlist as O, launchIosApp as S, writeDebugHttpHost as T, installConflictKind as _, IOS_DEV_MENU_OFF_DEFAULTS_PLIST as a, launchAndroidApp as b, androidDevClientUrl as c, devClientDeepLink as d, devClientUrl as f, installAndroidApp as g, hasMetroReverse as h, INSTALL_ERROR as i, appProcessFromPid as l, ensureMetroReverse as m, ANDROID_DISABLE_AUTO_LAUNCH_EXTRA as n, LAUNCH_ERROR as o, deviceShellArg as p, DEFAULT_METRO_PORT as r, androidAppProcess as s, ADB_INSTALL_TIMEOUT_MS as t, clearOtherUserApps as u, installIosApp as v, reverseMetroPorts as w, launchAndroidReleaseApp as x, iosAppProcess as y };