stim 1.2.0 → 1.3.0

package/dist/cli.mjs

@@ -3,19 +3,19 @@ import { readFileSync } from "node:fs";
 import { Command } from "commander";
 //#region bin/cli.ts
 const commands = /* @__PURE__ */ new Map([
-	["doctor", () => import("./doctor-D_CX7ib5.mjs")],
-	["worktree", () => import("./worktree-BPTbI-LN.mjs")],
-	["start", () => import("./start-BrY4EuIg.mjs")],
-	["stop", () => import("./stop-B7DR4awK.mjs")],
-	["ios", () => import("./ios-B7KLgIp5.mjs")],
-	["android", () => import("./android-Bcmev2s2.mjs")],
-	["reload", () => import("./reload-Z8nKifAk.mjs")],
-	["device", () => import("./device-CoCPmazS.mjs")],
-	["logs", () => import("./logs-DcX9AvRF.mjs")],
-	["status", () => import("./status-DFI1Hfpg.mjs")],
-	["stats", () => import("./stats-BsF15Bti.mjs")],
-	["gc", () => import("./gc-B7KkDinF.mjs")],
-	["guide", () => import("./guide-BS2Xc24o.mjs")]
+	["doctor", () => import("./doctor-fAMXC4vl.mjs")],
+	["worktree", () => import("./worktree-DxTgN1CJ.mjs")],
+	["start", () => import("./start-mObjQH2W.mjs")],
+	["stop", () => import("./stop-CrHGcjrV.mjs")],
+	["ios", () => import("./ios-BSXFeO5H.mjs")],
+	["android", () => import("./android-CqcW1hrP.mjs")],
+	["reload", () => import("./reload-DazHDSFA.mjs")],
+	["device", () => import("./device-BkiW-gkk.mjs")],
+	["logs", () => import("./logs-DPNF4C9s.mjs")],
+	["status", () => import("./status-BxQNqu9t.mjs")],
+	["stats", () => import("./stats-CaaQr4yN.mjs")],
+	["gc", () => import("./gc-GGu-8ULN.mjs")],
+	["guide", () => import("./guide-92CPA21s.mjs")]
 ]);
 const pkg = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf-8"));
 const program = new Command();

package/dist/collector-run.d.mts

@@ -55,6 +55,7 @@ declare function readCollectors(root: string): Record<string, unknown>;
 //#region src/collector/run.d.ts
 declare const PLATFORMS: string[];
 interface ParsedCollectorArgs {
+  slot?: string;
   platform?: string;
   root?: string;
   udid?: string;
@@ -69,6 +70,7 @@ interface ParsedCollectorArgs {
 }
 declare function parseArgs(argv: string[]): ParsedCollectorArgs;
 interface RunCollectorOptions {
+  slot?: string;
   platform: string;
   root: string;
   udid?: string | null;
@@ -114,7 +116,7 @@ interface RunCollectorHandle {
   startedAt: string;
   pid: number | null;
 }
-declare function runCollector({ platform, root, udid, appName, appExecutable, bundleId, serial, packageName, physical, payloadUrl, startStream, resolvePid, pidTimeoutMs, pidOf, pidWatchMs, watchPid, resolveClockOffset, now, onExit, attachSignals, stderr }: RunCollectorOptions): Promise<RunCollectorHandle | null>;
+declare function runCollector({ slot, platform, root, udid, appName, appExecutable, bundleId, serial, packageName, physical, payloadUrl, startStream, resolvePid, pidTimeoutMs, pidOf, pidWatchMs, watchPid, resolveClockOffset, now, onExit, attachSignals, stderr }: RunCollectorOptions): Promise<RunCollectorHandle | null>;
 declare function main(argv?: string[]): Promise<void>;
 //#endregion
 export { PLATFORMS, ParsedCollectorArgs, RunCollectorHandle, RunCollectorOptions, main, parseArgs, readCollectors, registerCollector, runCollector, unregisterCollector };

package/dist/collector-run.mjs

@@ -1,10 +1,10 @@
 import { t as getExecutor } from "./exec-CyylIdq9.mjs";
-import { T as captureProcessToken } from "./config-CMtIaTk9.mjs";
-import { r as createNdjsonWriter } from "./ndjson-DcAtEx_K.mjs";
-import { D as workspaceLogsDir } from "./state-CZ-ER-8d.mjs";
+import { I as deviceSlotKey, T as captureProcessToken, V as validateDeviceSlot } from "./config-CcefMY2Q.mjs";
+import { r as createNdjsonWriter } from "./ndjson-BZwI1NBv.mjs";
+import { D as workspaceLogsDir } from "./state-B3XA2wp2.mjs";
 import { t as createLineReader } from "./process-output-C7IlIzd7.mjs";
 import { i as startIosDeviceConsole, r as parseDeviceConsoleLine } from "./ios-device-D3pzTKQE.mjs";
-import { a as unregisterCollector, i as registerCollector, r as readCollectors, t as collectorProcessTitle } from "./ownership-CGPart6T.mjs";
+import { a as unregisterCollector, i as registerCollector, r as readCollectors, t as collectorProcessTitle } from "./ownership-8O073GIC.mjs";
 import { a as watchAppPid, i as waitForAppPid, n as parseLogcatLine, r as startAndroidLogcat, t as androidClockOffset } from "./android-BW8i_YxU.mjs";
 import { existsSync } from "node:fs";
 import { isAbsolute, join, resolve } from "node:path";
@@ -193,6 +193,7 @@ function startIosLogStream({ udid, appName, executableName = null, spawnFn = nul
 //#region src/collector/run.ts
 const PLATFORMS = ["ios", "android"];
 function parseArgs(argv) {
+	let slot;
 	let platform;
 	let root;
 	let udid;
@@ -205,6 +206,16 @@ function parseArgs(argv) {
 	let payloadUrl = null;
 	for (let i = 0; i < argv.length; i++) {
 		const arg = argv[i];
+		if (arg === "--slot") {
+			slot = argv[++i];
+			if (!slot) return { error: "--slot needs a name." };
+			try {
+				validateDeviceSlot(slot);
+			} catch (error) {
+				return { error: String(error.message) };
+			}
+			continue;
+		}
 		if (arg === "--platform") {
 			platform = argv[++i];
 			continue;
@@ -272,7 +283,8 @@ function parseArgs(argv) {
 		serial,
 		packageName,
 		physical,
-		payloadUrl
+		payloadUrl,
+		...slot ? { slot } : {}
 	};
 }
 const noopFlush = () => {};
@@ -281,7 +293,12 @@ function startMessage({ platform, physical, pid, appName, bundleId, udid, packag
 	if (!physical) return `device log collector pid ${pid} streaming ${appName} on ${udid}`;
 	return `device log collector pid ${pid} launching ${bundleId} on device ${udid} and streaming its console; subsystem, category and severity are not carried on hardware -- see \`stim guide logs\``;
 }
-async function runCollector({ platform, root, udid = null, appName = null, appExecutable = null, bundleId = null, serial = null, packageName = null, physical = false, payloadUrl = null, startStream = null, resolvePid = null, pidTimeoutMs = 3e4, pidOf = null, pidWatchMs = null, watchPid = watchAppPid, resolveClockOffset = androidClockOffset, now = Date.now, onExit = (code) => process.exit(code), attachSignals = true, stderr = (line) => console.error(line) }) {
+async function runCollector({ slot = "default", platform, root, udid = null, appName = null, appExecutable = null, bundleId = null, serial = null, packageName = null, physical = false, payloadUrl = null, startStream = null, resolvePid = null, pidTimeoutMs = 3e4, pidOf = null, pidWatchMs = null, watchPid = watchAppPid, resolveClockOffset = androidClockOffset, now = Date.now, onExit = (code) => process.exit(code), attachSignals = true, stderr = (line) => console.error(line) }) {
+	const key = deviceSlotKey(platform, slot);
+	const attribution = slot === "default" ? {} : {
+		slot,
+		deviceId: udid ?? serial
+	};
 	const writer = createNdjsonWriter(join(workspaceLogsDir(root), "device.ndjson"));
 	const startedAt = new Date(now()).toISOString();
 	const processToken = captureProcessToken(process.pid);
@@ -299,6 +316,7 @@ async function runCollector({ platform, root, udid = null, appName = null, appEx
 		finished = true;
 		watcher?.stop();
 		if (physical && captured === 0 && !signalled) writer.write({
+			...attribution,
 			src: "device",
 			platform,
 			level: "warn",
@@ -306,6 +324,7 @@ async function runCollector({ platform, root, udid = null, appName = null, appEx
 			msg: `the device console produced no output for ${bundleId}; devicectl only connects the app's streams when it starts the app, and os_log below the info level never reaches them`
 		});
 		writer.write({
+			...attribution,
 			src: "device",
 			platform,
 			level,
@@ -313,7 +332,7 @@ async function runCollector({ platform, root, udid = null, appName = null, appEx
 			msg
 		});
 		try {
-			unregisterCollector(root, platform, process.pid, processToken);
+			unregisterCollector(root, key, process.pid, processToken);
 		} catch {}
 		const closed = writer.close();
 		if (closed.dropped > 0) stderr(`Stim collector: dropped ${closed.dropped} record(s); last error: ${describe(closed.lastError)}`);
@@ -327,7 +346,8 @@ async function runCollector({ platform, root, udid = null, appName = null, appEx
 		finish(0, "info", `device log collector received ${signal}; detaching`, "collector_stopped", { signalled: true });
 	});
 	try {
-		registerCollector(root, platform, {
+		registerCollector(root, key, {
+			...attribution,
 			pid: process.pid,
 			processToken,
 			startedAt
@@ -355,6 +375,7 @@ async function runCollector({ platform, root, udid = null, appName = null, appEx
 		pid = resolved.pid ?? null;
 	}
 	writer.write({
+		...attribution,
 		src: "device",
 		platform,
 		level: "info",
@@ -375,6 +396,7 @@ async function runCollector({ platform, root, udid = null, appName = null, appEx
 	const attach = (streamPid) => {
 		const clockOffsetMs = platform === "android" ? resolveClockOffset(serial, { now }) : null;
 		if (platform === "android") writer.write({
+			...attribution,
 			src: "device",
 			platform,
 			level: clockOffsetMs === null ? "warn" : "debug",
@@ -390,6 +412,7 @@ async function runCollector({ platform, root, udid = null, appName = null, appEx
 			if (!record) return;
 			captured++;
 			writer.write({
+				...attribution,
 				...record,
 				platform
 			});
@@ -420,6 +443,7 @@ async function runCollector({ platform, root, udid = null, appName = null, appEx
 		const errReader = createLineReader(physical ? onLine : (line) => {
 			const text = String(line).trimEnd();
 			if (text.trim()) writer.write({
+				...attribution,
 				src: "device",
 				platform,
 				level: "debug",
@@ -464,6 +488,7 @@ async function runCollector({ platform, root, udid = null, appName = null, appEx
 		killChild(child);
 		child = null;
 		writer.write({
+			...attribution,
 			src: "device",
 			platform,
 			level: "info",

package/dist/{config-CMtIaTk9.mjs → config-CcefMY2Q.mjs}

@@ -4,6 +4,85 @@ import { homedir } from "os";
 import { dirname, isAbsolute, join, normalize } from "path";
 import { withDirLock } from "@stim-cli/core";
 import { capture, check, decode } from "unique-pid";
+//#region src/device-slots.ts
+const DEFAULT_DEVICE_SLOT = "default";
+function validateDeviceSlot(slot = "default") {
+	if (!/^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$/.test(slot) || [
+		"constructor",
+		"prototype",
+		"__proto__"
+	].includes(slot)) {
+		const error = /* @__PURE__ */ new Error("A device slot must be 1-64 letters, digits, underscores or hyphens, starting with a letter or digit.");
+		Object.assign(error, { code: "STIM_BAD_ARG" });
+		throw error;
+	}
+	return slot;
+}
+function deviceSlotPlatforms(project, slot = DEFAULT_DEVICE_SLOT) {
+	validateDeviceSlot(slot);
+	if (slot === DEFAULT_DEVICE_SLOT) return project?.platforms;
+	return project?.deviceSlots && Object.hasOwn(project.deviceSlots, slot) ? project.deviceSlots[slot] : void 0;
+}
+function projectDeviceSlots(project) {
+	const slots = [{
+		slot: DEFAULT_DEVICE_SLOT,
+		platforms: project?.platforms ?? {}
+	}];
+	for (const [slot, platforms] of Object.entries(project?.deviceSlots ?? {})) {
+		validateDeviceSlot(slot);
+		if (slot === DEFAULT_DEVICE_SLOT) throw new Error("The default device slot must use the existing platforms record.");
+		if (!platforms || typeof platforms !== "object" || Array.isArray(platforms)) throw new Error(`Invalid device slot record: ${slot}`);
+		slots.push({
+			slot,
+			platforms
+		});
+	}
+	return slots;
+}
+function assignSlotDevice(project, platform, device, slot = DEFAULT_DEVICE_SLOT) {
+	validateDeviceSlot(slot);
+	if (platform !== "ios" && platform !== "android") throw new Error(`Unknown device platform: ${platform}`);
+	if (slot === DEFAULT_DEVICE_SLOT) project.platforms = {
+		...project.platforms,
+		[platform]: device
+	};
+	else project.deviceSlots = {
+		...project.deviceSlots,
+		[slot]: {
+			...deviceSlotPlatforms(project, slot),
+			[platform]: device
+		}
+	};
+}
+function removeSlotDevice(project, platform, slot = DEFAULT_DEVICE_SLOT) {
+	const platforms = deviceSlotPlatforms(project, slot);
+	if (!platforms) return;
+	delete platforms[platform];
+	if (slot !== DEFAULT_DEVICE_SLOT && Object.keys(platforms).length === 0) {
+		delete project.deviceSlots[slot];
+		if (Object.keys(project.deviceSlots).length === 0) delete project.deviceSlots;
+	}
+}
+function deviceSlotKey(platform, slot = "default") {
+	validateDeviceSlot(slot);
+	if (platform !== "ios" && platform !== "android") throw new Error(`Unknown device platform: ${platform}`);
+	return slot === "default" ? platform : `${platform}:${slot}`;
+}
+function parseDeviceSlotKey(key) {
+	const [platform, slot = "default", extra] = key.split(":");
+	if (platform !== "ios" && platform !== "android" || extra !== void 0) return null;
+	try {
+		validateDeviceSlot(slot);
+	} catch {
+		return null;
+	}
+	if (key !== deviceSlotKey(platform, slot)) return null;
+	return {
+		platform,
+		slot
+	};
+}
+//#endregion
 //#region src/fs-util.ts
 function volumeRootFor(path) {
 	const m = normalize(String(path)).match(/^\/volumes\/([^/]+)/i);
@@ -266,31 +345,31 @@ function claimMetroPort(projectPath, port) {
 		return port;
 	});
 }
-function setDevice(projectPath, platform, deviceFields) {
+function setDevice(projectPath, platform, deviceFields, slot = "default") {
 	requireAbsoluteProjectPath(projectPath);
 	withConfigLock(() => {
 		const cfg = ensureConfig();
 		if (!cfg.projects[projectPath]) throw new Error(`Project not registered: ${projectPath}`);
-		cfg.projects[projectPath].platforms = cfg.projects[projectPath].platforms || {};
-		cfg.projects[projectPath].platforms[platform] = deviceFields;
+		assignSlotDevice(cfg.projects[projectPath], platform, deviceFields, slot);
 		saveConfig(cfg);
 	});
 }
-function releaseAndroidConsolePort(projectPath, consolePort) {
+function releaseAndroidConsolePort(projectPath, consolePort, slot = "default") {
 	return withConfigLock(() => {
 		const cfg = loadConfig();
-		const android = cfg?.projects?.[projectPath]?.platforms?.android;
+		const android = deviceSlotPlatforms(cfg?.projects?.[projectPath], slot)?.android;
 		if (!cfg || !android || android.consolePort !== consolePort) return false;
 		delete android.consolePort;
 		saveConfig(cfg);
 		return true;
 	});
 }
-function clearDevice(projectPath, platform) {
+function clearDevice(projectPath, platform, slot = "default") {
 	withConfigLock(() => {
 		const cfg = loadConfig();
-		if (!cfg?.projects?.[projectPath]?.platforms) return;
-		delete cfg.projects[projectPath].platforms[platform];
+		const project = cfg?.projects?.[projectPath];
+		if (!cfg || !project) return;
+		removeSlotDevice(project, platform, slot);
 		saveConfig(cfg);
 	});
 }
@@ -371,11 +450,13 @@ function allConsolePortsAndSerials({ isMounted = isOnMountedVolume } = {}) {
 	if (!cfg) return result;
 	for (const [path, proj] of Object.entries(cfg.projects || {})) {
 		if (!existsSync(path) && isMounted(path)) continue;
-		const android = proj.platforms?.android;
-		if (typeof android?.consolePort === "number") result.androidConsolePorts.push(android.consolePort);
-		if (android?.serial && !android.avdName) result.androidPhysicalSerials.push(android.serial);
+		for (const { platforms } of projectDeviceSlots(proj)) {
+			const android = platforms.android;
+			if (typeof android?.consolePort === "number") result.androidConsolePorts.push(android.consolePort);
+			if (android?.serial && !android.avdName) result.androidPhysicalSerials.push(android.serial);
+		}
 	}
 	return result;
 }
 //#endregion
-export { directorySize as A, withConfigLock as C, sameProcessRecord as D, inspectProcessIdentity as E, isOnMountedVolume as M, listMountedVolumes as N, waitForProcessExit as O, volumeRootFor as P, upsertProject as S, captureProcessToken as T, releaseAndroidConsolePort as _, clearSupervisor as a, setDevice as b, findEnclosingWorktreeRoot as c, getConfigPath as d, getProject as f, loadConfig as g, isPathPrefix as h, clearDevice as i, formatBytes as j, withDirLock as k, getConcurrencyLimits as l, getRepoSettings as m, allMetroPorts as n, configCorruptRepair as o, getProjectSettings as p, claimMetroPort as r, ensureConfig as s, allConsolePortsAndSerials as t, getConfigDir as u, removeProject as v, captureProcessIdentity as w, setSupervisor as x, saveConfig as y };
+export { directorySize as A, removeSlotDevice as B, withConfigLock as C, sameProcessRecord as D, inspectProcessIdentity as E, assignSlotDevice as F, deviceSlotKey as I, deviceSlotPlatforms as L, isOnMountedVolume as M, listMountedVolumes as N, waitForProcessExit as O, volumeRootFor as P, parseDeviceSlotKey as R, upsertProject as S, captureProcessToken as T, validateDeviceSlot as V, releaseAndroidConsolePort as _, clearSupervisor as a, setDevice as b, findEnclosingWorktreeRoot as c, getConfigPath as d, getProject as f, loadConfig as g, isPathPrefix as h, clearDevice as i, formatBytes as j, withDirLock as k, getConcurrencyLimits as l, getRepoSettings as m, allMetroPorts as n, configCorruptRepair as o, getProjectSettings as p, claimMetroPort as r, ensureConfig as s, allConsolePortsAndSerials as t, getConfigDir as u, removeProject as v, captureProcessIdentity as w, setSupervisor as x, saveConfig as y, projectDeviceSlots as z };

package/dist/{deps-BLBsTNDS.mjs → deps-Spz8ozgo.mjs}

@@ -1,6 +1,6 @@
 import { t as getExecutor } from "./exec-CyylIdq9.mjs";
 import { n as stripAnsi, r as waitForChild, t as createLineReader } from "./process-output-C7IlIzd7.mjs";
-import { f as startBuildHeartbeat, h as bundlerPin, r as HEARTBEAT_INTERVAL_MS } from "./xcode-DeKCribl.mjs";
+import { f as startBuildHeartbeat, h as bundlerPin, r as HEARTBEAT_INTERVAL_MS } from "./xcode-D7sAp-Zy.mjs";
 import { existsSync, readFileSync } from "node:fs";
 import { dirname, join, relative, resolve, sep } from "node:path";
 import { homedir } from "node:os";

package/dist/{dev-client-RpvXxCXV.mjs → dev-client-BjisHDB5.mjs}

@@ -1,16 +1,190 @@
 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 { y as ensureWorkspaceStorage } from "./state-B3XA2wp2.mjs";
+import { C as removeTemporaryEntry, S as makeTemporaryDirectory } from "./worktree-Eq6TLH8N.mjs";
+import { i as detectIsExpo, o as isPackageResolvable } from "./project-fKmuIaMI.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 { t as NOT_OURS_FOREIGN_CWD } from "./metro-CORqXyTL.mjs";
+import { r as claimFailure } from "./ownership-claim-Bf2CAfw3.mjs";
+import { V as releaseBuildLock, z as acquireBuildLock } from "./android-BqVIJoG7.mjs";
+import { i as expoBinRefusal, r as expoBinPath, t as cleanLine } from "./server-expo-DizT4OMk.mjs";
+import { x as resolveEasCliBin } from "./teardown-ClFp1Aax.mjs";
+import { i as LAUNCH_BUNDLING, s as LAUNCH_UNVERIFIED } from "./app-install-DIp9riNx.mjs";
+import { f as startBuildHeartbeat, p as tailLines, r as HEARTBEAT_INTERVAL_MS } from "./xcode-D7sAp-Zy.mjs";
+import { existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, statSync } from "node:fs";
+import { createHash } from "node:crypto";
 import { basename, join } from "node:path";
 import chalk from "chalk";
 import { request } from "node:http";
+//#region src/engine/eas-build.ts
+function isEasBuildFailure(result) {
+	return result?.ok === false;
+}
+function easOptionRefusal({ profile, isExpo, buildSelector, buildCache }) {
+	if (profile === void 0) return null;
+	if (profile.trim() && isExpo && buildSelector === void 0 && buildCache !== false) return null;
+	return {
+		code: "STIM_BAD_ARG",
+		message: "--eas-profile requires an Expo project and a non-empty development profile.",
+		remedy: "Use --eas-profile <name> without --scheme, --configuration, --variant, or --no-build-cache."
+	};
+}
+function object(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function shellArg(value) {
+	return /^[a-zA-Z0-9_.-]+$/.test(value) ? value : `'${value.replaceAll("'", "'\\''")}'`;
+}
+function easDeviceBuildRemedy(profile) {
+	return `If the device is not registered, run npx eas-cli device:create. With approval for cloud build costs and signing changes, run npx eas-cli build --platform ios --profile ${shellArg(profile)} to produce a build with a valid profile for this device, then retry the same Stim command.`;
+}
+var EasFailure = class extends Error {
+	code;
+	remedy;
+	constructor(code, message, remedy) {
+		super(message);
+		this.code = code;
+		this.remedy = remedy;
+	}
+};
+function selectEasBuild(builds, { platform, profile, fingerprint, projectId, physical = false }) {
+	if (!Array.isArray(builds)) throw new Error("EAS build:list did not return an array.");
+	for (const value of builds) {
+		const build = object(value);
+		if (typeof build.id === "string" && build.id.length > 0 && build.status === "FINISHED" && build.platform === platform.toUpperCase() && build.buildProfile === profile && object(build.fingerprint).hash === fingerprint && object(build.project).id === projectId && (platform !== "ios" || build.isForIosSimulator === !physical) && build.distribution === "INTERNAL" && typeof object(build.artifacts).applicationArchiveUrl === "string") return build.id;
+	}
+	return null;
+}
+async function resolveEasDevelopmentBuild({ root, platform, profile, note, isExpo = true, physical = false, selectors = [], buildCache }) {
+	if (profile === void 0) return null;
+	const refusal = easOptionRefusal({
+		profile,
+		isExpo,
+		buildSelector: selectors.find((value) => value != null) ?? void 0,
+		buildCache
+	});
+	if (refusal) return {
+		ok: false,
+		...refusal
+	};
+	const retry = "the same Stim command";
+	const buildCommand = `npx eas-cli build --platform ${platform} --profile ${shellArg(profile)}`;
+	let lock = null;
+	try {
+		const cli = resolveEasCliBin(root);
+		if (!cli) throw new EasFailure("STIM_EAS_UNAVAILABLE", "EAS CLI is not installed.", "Install eas-cli, run eas login, then retry.");
+		let profileEnv = {};
+		const run = (args, timeoutMs = 12e4) => {
+			try {
+				return JSON.parse(getExecutor().runFile(cli.file, [
+					...args,
+					"--json",
+					"--non-interactive"
+				], {
+					cwd: root,
+					timeoutMs,
+					env: profileEnv
+				}));
+			} catch {
+				throw new EasFailure("STIM_EAS_UNAVAILABLE", `EAS ${args[0]} failed or returned invalid JSON.`, `Run npx eas-cli ${args.map(shellArg).join(" ")} to inspect the error, then retry ${retry}.`);
+			}
+		};
+		note(`eas   resolving profile ${profile}`);
+		const config = object(run([
+			"config",
+			"--platform",
+			platform,
+			"--profile",
+			profile
+		]));
+		const buildProfile = object(config.buildProfile);
+		profileEnv = object(buildProfile.env);
+		const projectId = object(object(object(config.appConfig).extra).eas).projectId;
+		if (buildProfile.developmentClient !== true || buildProfile.distribution !== "internal" || platform === "ios" && buildProfile.simulator === true !== !physical) throw new EasFailure("STIM_BAD_ARG", `EAS profile ${profile} is not an internal development build for this ${platform} target.`, `Set developmentClient: true and distribution: internal${platform === "ios" ? `, with ios.simulator: ${!physical}` : ""} in that eas.json profile.`);
+		if (typeof projectId !== "string" || !projectId) throw new EasFailure("STIM_BAD_ARG", "The Expo app is not linked to an EAS project.", "Link the intended EAS project with eas init, then retry.");
+		if (platform === "ios" ? buildProfile.buildConfiguration !== void 0 && buildProfile.buildConfiguration !== "Debug" : buildProfile.gradleCommand !== void 0 && (typeof buildProfile.gradleCommand !== "string" || !/^:app:assemble\w*Debug$/.test(buildProfile.gradleCommand))) throw new EasFailure("STIM_BAD_ARG", `EAS profile ${profile} overrides the development build configuration.`, "Use ios.buildConfiguration: Debug or an android.gradleCommand that assembles a single Debug APK, or remove the override.");
+		note(`eas   fingerprinting ${platform} with profile ${profile}`);
+		const fingerprint = object(run([
+			"fingerprint:generate",
+			"--platform",
+			platform,
+			"--build-profile",
+			profile
+		])).hash;
+		if (typeof fingerprint !== "string" || !/^[a-f0-9]{40,64}$/.test(fingerprint)) throw new EasFailure("STIM_EAS_UNAVAILABLE", "EAS returned no valid native fingerprint.", `Run npx eas-cli fingerprint:generate --platform ${platform} --build-profile ${shellArg(profile)} to inspect the result.`);
+		note(`eas   looking for ${fingerprint.slice(0, 8)}`);
+		const buildId = selectEasBuild(run([
+			"build:list",
+			"--platform",
+			platform,
+			"--build-profile",
+			profile,
+			"--fingerprint-hash",
+			fingerprint,
+			"--status",
+			"finished",
+			...platform === "ios" && !physical ? ["--simulator"] : ["--distribution", "internal"],
+			"--limit",
+			"1"
+		]), {
+			platform,
+			profile,
+			fingerprint,
+			projectId,
+			physical
+		});
+		if (!buildId) throw new EasFailure("STIM_EAS_BUILD_MISSING", `No compatible EAS ${platform} build exists for profile ${profile} and fingerprint ${fingerprint}.`, `A cloud build may incur charges. With approval to run it, use ${buildCommand}, then retry ${retry}.`);
+		const cacheKey = `eas-${createHash("sha256").update(JSON.stringify({
+			projectId,
+			buildId
+		})).digest("hex")}-debug-${physical && platform === "ios" ? "device" : "sim"}`;
+		lock = acquireBuildLock({
+			platform,
+			key: cacheKey,
+			root
+		});
+		if (!lock.acquired) throw new EasFailure("STIM_EAS_UNAVAILABLE", `Another run holds the EAS artifact claim at ${lock.path}.`, `Wait for that run to finish, then retry ${retry}.`);
+		note(`eas   resolving artifact for build ${buildId}`);
+		const result = object(run([
+			"build:download",
+			"--build-id",
+			buildId
+		], 6e5));
+		if (typeof result.path !== "string" || !existsSync(result.path)) throw new Error("EAS returned no downloaded artifact.");
+		const path = realpathSync(result.path);
+		if (platform === "ios" ? !path.endsWith(".app") || !statSync(path).isDirectory() : !path.endsWith(".apk") || !statSync(path).isFile()) throw new Error("EAS returned an unexpected artifact path or type.");
+		note(`eas   artifact ready ${fingerprint.slice(0, 8)}`);
+		return {
+			ok: true,
+			path,
+			fingerprint,
+			cacheKey,
+			cacheHit: "remote"
+		};
+	} catch (error) {
+		const claim = claimFailure(error, null);
+		if (claim) return {
+			ok: false,
+			code: claim.code,
+			message: claim.message,
+			remedy: claim.remedy
+		};
+		if (error instanceof EasFailure) return {
+			ok: false,
+			code: error.code,
+			message: error.message,
+			remedy: error.remedy
+		};
+		return {
+			ok: false,
+			code: "STIM_EAS_UNAVAILABLE",
+			message: `Could not resolve the EAS development build: ${error.message}`,
+			remedy: `Retry ${retry}. No cloud build was started.`
+		};
+	} finally {
+		releaseBuildLock(lock);
+	}
+}
+//#endregion
 //#region src/engine/metro-warmup.ts
 const WARMUP_TIMEOUT_MS = 6e4;
 async function requestLocal(url, platform, prefetch) {
@@ -135,6 +309,9 @@ function launchOutcomeRecord({ launchState, release, bundleId, configuration, me
 		msg
 	};
 }
+function isPhysicalDeviceRequest(flag) {
+	return flag !== null && flag !== void 0 && flag !== false;
+}
 //#endregion
 //#region src/engine/prebuild.ts
 const PREBUILD_ERROR = "STIM_PREBUILD_FAILED";
@@ -617,4 +794,4 @@ function readJson(file) {
 	}
 }
 //#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 };
+export { easDeviceBuildRemedy as _, swapJsBundle as a, ensureWorkspaceStorageSafely as c, launchOutcomeRecord as d, noMetroMessage as f, warmMetro as g, sleep as h, detectEntryFile as i, gateShouldRetry as l, resolveMetroWithRetry as m, pickDevClientScheme as n, needsPrebuild as o, noMetroRemedy as p, schemesFromInfoPlist as r, runPrebuild as s, devClientScheme as t, isPhysicalDeviceRequest as u, isEasBuildFailure as v, resolveEasDevelopmentBuild as y };

package/dist/{device-CoCPmazS.mjs → device-BkiW-gkk.mjs}

@@ -1,9 +1,10 @@
-import { a as findProjectRoot } from "./project-BBTVABUz.mjs";
+import { V as validateDeviceSlot } from "./config-CcefMY2Q.mjs";
+import { a as findProjectRoot } from "./project-fKmuIaMI.mjs";
 import { r as clockTime } from "./command-output-8wHMEde0.mjs";
-import { f as takeLease, l as releaseWorkspaceLeases, n as fileLeaseIo, o as parseLeaseDuration } from "./device-lease-Dpik41RY.mjs";
-import { d as waitForDevice, s as parseDeviceWait, t as selectFromPool } from "./device-pool-B5pEVa3t.mjs";
-import { C as memoizeEmulatorProbe, P as resolvePhysicalDevice, i as androidPoolNoCandidatesRefusal, j as probeEmulatorSerial, k as physicalDeviceModel, r as androidPoolCandidates, y as listAdbDevices } from "./android-K63_0UfF.mjs";
-import { c as listIosDevices, o as iosPoolCandidates, s as iosPoolNoCandidatesRefusal, u as resolveIosPhysicalDevice } from "./ios-device-xNt0Lg6v.mjs";
+import { C as memoizeEmulatorProbe, P as resolvePhysicalDevice, i as androidPoolNoCandidatesRefusal, j as probeEmulatorSerial, k as physicalDeviceModel, r as androidPoolCandidates, y as listAdbDevices } from "./android-BqVIJoG7.mjs";
+import { f as takeLease, l as releaseWorkspaceLeases, n as fileLeaseIo, o as parseLeaseDuration } from "./device-lease-BJYybF-2.mjs";
+import { d as waitForDevice, s as parseDeviceWait, t as selectFromPool } from "./device-pool-CPbLGfrB.mjs";
+import { c as listIosDevices, o as iosPoolCandidates, s as iosPoolNoCandidatesRefusal, u as resolveIosPhysicalDevice } from "./ios-device-CWOM_S44.mjs";
 import chalk from "chalk";
 //#region src/commands/device.ts
 const DEFAULT_FOR = "5m";
@@ -24,7 +25,7 @@ const DEFAULT_DEPS = {
 	note: (line) => console.error(line)
 };
 function grantLine(facts, durationText) {
-	return `locked ${facts.deviceName ? `${facts.deviceName} (${facts.id})` : facts.id} for ${facts.holder} until ${clockTime(facts.expiresAt)} (${durationText}). Renew: stim device lock ${facts.platform} --for ${durationText}. Release: stim device unlock.`;
+	return `locked ${facts.deviceName ? `${facts.deviceName} (${facts.id})` : facts.id} for ${facts.holder} until ${clockTime(facts.expiresAt)} (${durationText}). Renew: stim device lock ${facts.platform}${facts.slot ? ` --slot ${facts.slot}` : ""} --for ${durationText}. Release: stim device unlock${facts.slot ? ` --slot ${facts.slot}` : ""}.`;
 }
 function releasedLine(lease) {
 	return `unlocked ${lease.deviceName ? `${lease.deviceName} (${lease.id})` : lease.id} -- the ${lease.platform} lease ran until ${clockTime(lease.expiresAt)}.`;
@@ -59,9 +60,10 @@ function resolveDevice(platform, requested, d) {
 function isFailure(value) {
 	return "code" in value;
 }
-async function poolDevice(platform, idLabel, waitSeconds, deadline, root, d) {
+async function poolDevice(platform, idLabel, waitSeconds, deadline, root, d, slot) {
 	const isEmulator = memoizeEmulatorProbe(d.probeEmulatorSerial);
 	const pooled = await d.selectFromPool({
+		...slot ? { slot } : {},
 		root,
 		platform,
 		idLabel,
@@ -140,10 +142,11 @@ async function runLock(platformArg, idArg, opts = {}, overrides = {}) {
 	const idLabel = platform === "ios" ? "udid" : "serial";
 	const deadline = d.now() + wait.seconds * 1e3;
 	const lastLine = { at: null };
-	const device = idArg ? resolveDevice(platform, idArg, d) : await poolDevice(platform, idLabel, wait.seconds, deadline, root, d);
+	const device = idArg ? resolveDevice(platform, idArg, d) : await poolDevice(platform, idLabel, wait.seconds, deadline, root, d, opts.slot);
 	if (isFailure(device)) return report(device);
 	for (;;) {
 		const outcome = await d.waitForDevice({
+			...opts.slot ? { slot: opts.slot } : {},
 			root,
 			platform,
 			id: device.id,
@@ -161,6 +164,7 @@ async function runLock(platformArg, idArg, opts = {}, overrides = {}) {
 			lease: outcome.refusal.lease
 		});
 		const taken = d.takeLease({
+			...opts.slot ? { slot: opts.slot } : {},
 			root,
 			platform,
 			id: device.id,
@@ -182,6 +186,7 @@ async function runLock(platformArg, idArg, opts = {}, overrides = {}) {
 		});
 		if (taken.status === "held") continue;
 		const facts = {
+			...taken.lease.slot ? { slot: taken.lease.slot } : {},
 			platform,
 			id: taken.lease.id,
 			deviceName: taken.lease.deviceName,
@@ -224,7 +229,10 @@ async function runUnlock(platformArg, opts = {}, overrides = {}) {
 		message: "Not in a React Native project (no package.json found).",
 		remedy: "Run this from the app directory -- the one holding package.json."
 	});
-	const released = d.releaseLeases(root, { platform }, d.io);
+	const released = d.releaseLeases(root, {
+		platform,
+		...opts.slot ? { slot: opts.slot } : {}
+	}, d.io);
 	if (released.length === 0) d.note(chalk.dim(`No ${platform ? `${platform} ` : ""}device lease to release for ${root}. \`stim status\` lists every lease on this machine.`));
 	if (json) d.out(JSON.stringify(released.map((lease) => ({
 		...lease,
@@ -235,10 +243,10 @@ async function runUnlock(platformArg, opts = {}, overrides = {}) {
 }
 function registerDevice(program, deps = {}) {
 	const device = program.command("device").description("Lease a connected physical device to this workspace, and give it back");
-	device.command("lock").argument("<platform>", "ios or android").argument("[id]", "the UDID or serial to lease; without one, the first free connected device is used").description("Lease a connected physical device to this workspace for a declared time, so another workspace's `--device` run waits instead of installing over it. Nothing but this command and a `--device` run moves the expiry.").option("--for <duration>", `How long to hold it: a whole number of seconds or minutes from 10s to 30m (default ${DEFAULT_FOR})`).option("--wait <seconds>", "How long to wait for a device another workspace holds, before refusing with STIM_DEVICE_BUSY (default 60, 0 refuses at once)").option("--json", "print the lease as JSON on stdout").action(async (platform, id, opts) => {
+	device.command("lock").argument("<platform>", "ios or android").argument("[id]", "the UDID or serial to lease; without one, the first free connected device is used").description("Lease a connected physical device to this workspace for a declared time, so another workspace's `--device` run waits instead of installing over it. Nothing but this command and a `--device` run moves the expiry.").option("--for <duration>", `How long to hold it: a whole number of seconds or minutes from 10s to 30m (default ${DEFAULT_FOR})`).option("--wait <seconds>", "How long to wait for a device another workspace holds, before refusing with STIM_DEVICE_BUSY (default 60, 0 refuses at once)").option("--slot <name>", "Use this workspace device slot", validateDeviceSlot).option("--json", "print the lease as JSON on stdout").action(async (platform, id, opts) => {
 		if ("code" in await runLock(platform, id, opts, deps)) process.exit(1);
 	});
-	device.command("unlock").argument("[platform]", "ios or android; without one, every lease this workspace holds is released").description("Release the device lease or leases this workspace holds. Releasing nothing is not an error.").option("--json", "print the released leases as JSON on stdout").action(async (platform, opts) => {
+	device.command("unlock").argument("[platform]", "ios or android; without one, every lease this workspace holds is released").description("Release the device lease or leases this workspace holds. Releasing nothing is not an error.").option("--slot <name>", "Use this workspace device slot", validateDeviceSlot).option("--json", "print the released leases as JSON on stdout").action(async (platform, opts) => {
 		const result = await runUnlock(platform, opts, deps);
 		if (!Array.isArray(result)) process.exit(1);
 	});