stim 1.1.0 → 1.3.0

package/dist/android-cas-compiler.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as getExecutor } from "./exec-bsN9MJXb.mjs";
+import { t as getExecutor } from "./exec-CyylIdq9.mjs";
 import { appendFileSync, existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 import { createHash, randomUUID } from "node:crypto";
 import { join } from "node:path";

package/dist/{app-install-oZIQRbdD.mjs → app-install-DIp9riNx.mjs}

@@ -1,8 +1,8 @@
-import { t as getExecutor } from "./exec-bsN9MJXb.mjs";
-import { o as parseNdjsonText } from "./ndjson-DcAtEx_K.mjs";
-import { t as DEV_MENU_LAUNCH_ARGS } from "./ios-device-CYbuRNXR.mjs";
+import { t as getExecutor } from "./exec-CyylIdq9.mjs";
+import { o as parseNdjsonText } from "./ndjson-BZwI1NBv.mjs";
+import { t as DEV_MENU_LAUNCH_ARGS } from "./ios-device-D3pzTKQE.mjs";
 import { s as isAppLaunchError } from "./command-output-8wHMEde0.mjs";
-import { C as uninstallIosApp, f as listUserApps } from "./ios-BZxKPuqP.mjs";
+import { l as iosSimulatorFailureAdvice, p as listUserApps, w as uninstallIosApp } from "./ios-Deh5js5V.mjs";
 import { closeSync, lstatSync, openSync, readFileSync, readSync, readdirSync } from "node:fs";
 import { createHash } from "node:crypto";
 import { join } from "node:path";
@@ -157,6 +157,10 @@ const IOS_DEV_MENU_OFF_KEYS = ["EXDevMenuShowsAtLaunch", "EXDevMenuShowFloatingA
 const DEV_CLIENT_ONBOARDING_QUERY = "disableOnboarding=1";
 const DEV_CLIENT_DISABLE_FAB_QUERY = "disableFab=1";
 const ANDROID_DISABLE_AUTO_LAUNCH_EXTRA = "EXDevMenuDisableAutoLaunch";
+function describeIosSimulatorFailure(error, exec) {
+	const detail = describe(error);
+	return error?.code === "ETIMEDOUT" ? `${detail}. ${iosSimulatorFailureAdvice(exec)}` : detail;
+}
 function installIosApp({ udid, appPath, bundleId = null, devClientScheme = null, proveInstalled = true }, { exec = null, now = null } = {}) {
 	const e = exec || getExecutor();
 	const artifactStartedAt = now?.();
@@ -171,12 +175,15 @@ function installIosApp({ udid, appPath, bundleId = null, devClientScheme = null,
 			"install",
 			udid,
 			appPath
-		]);
+		], {
+			timeoutMs: 3e5,
+			killSignal: "SIGKILL"
+		});
 	} catch (err) {
 		return {
 			failed: true,
 			code: INSTALL_ERROR,
-			reason: `simctl install failed for ${appPath}: ${describe(err)}`
+			reason: `simctl install failed for ${appPath}: ${describeIosSimulatorFailure(err, e)}`
 		};
 	}
 	const artifactFinishedAt = now?.();
@@ -193,7 +200,7 @@ function installIosApp({ udid, appPath, bundleId = null, devClientScheme = null,
 			key,
 			"-bool",
 			"false"
-		]);
+		], { timeoutMs: 6e4 });
 		for (const key of iosSchemeApprovalKeys(bundleId, devClientScheme)) e.runFile("xcrun", [
 			"simctl",
 			"spawn",
@@ -204,12 +211,12 @@ function installIosApp({ udid, appPath, bundleId = null, devClientScheme = null,
 			key,
 			"-string",
 			bundleId
-		]);
+		], { timeoutMs: 6e4 });
 	} catch (err) {
 		return {
 			failed: true,
 			code: INSTALL_ERROR,
-			reason: `Installed ${bundleId}, but could not prepare the dev client: ${describe(err)}`
+			reason: `Installed ${bundleId}, but could not prepare the dev client: ${describeIosSimulatorFailure(err, e)}`
 		};
 	}
 	const devClientPreparationDurationMs = now && preparationStartedAt !== void 0 ? now() - preparationStartedAt : void 0;
@@ -318,12 +325,12 @@ function launchIosApp({ udid, bundleId, metroPort, devClientScheme = null, conso
 				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): ${describe(err)}`
+				reason: `Could not point ${bundleId} at Metro port ${metroPort} (defaults write RCT_jsLocation): ${describeIosSimulatorFailure(err, e)}`
 			};
 		}
 		if (devClientScheme) {
@@ -349,7 +356,7 @@ function launchIosApp({ udid, bundleId, metroPort, devClientScheme = null, conso
 					"openurl",
 					udid,
 					url
-				]);
+				], { timeoutMs: 6e4 });
 				return {
 					ok: true,
 					mode: "openurl",
@@ -360,7 +367,7 @@ function launchIosApp({ udid, bundleId, metroPort, devClientScheme = null, conso
 				return {
 					failed: true,
 					code: LAUNCH_ERROR,
-					reason: `simctl openurl ${url} failed: ${describe(err)}`
+					reason: `simctl openurl ${url} failed: ${describeIosSimulatorFailure(err, e)}`
 				};
 			}
 		}
@@ -377,7 +384,7 @@ function launchIosApp({ udid, bundleId, metroPort, devClientScheme = null, conso
 		return {
 			failed: true,
 			code: LAUNCH_ERROR,
-			reason: `simctl launch ${bundleId} failed: ${describe(err)}`
+			reason: `simctl launch ${bundleId} failed: ${describeIosSimulatorFailure(err, e)}`
 		};
 	}
 }
@@ -893,7 +900,7 @@ function nativeLaunchFailure({ readCrashes, since, platform, processAlive, mode,
 		waitedMs
 	} : null;
 }
-async function verifyLaunch({ logsDir, since, metroPort = null, platform = null, mode = null, timeoutMs = VERIFY_TIMEOUT_MS, stabilityMs = STABILITY_WINDOW_MS, pollMs = VERIFY_POLL_MS, readRecords = null, readDeviceRecords = null, readClientRecords = null, readNativeCrashes = null, processAlive = null, onReadinessPending = null, now = Date.now, sleep = (ms) => new Promise((r) => setTimeout(r, ms)) } = {}) {
+async function verifyLaunch({ slot, logsDir, since, metroPort = null, platform = null, mode = null, requireBundleResponse, timeoutMs = VERIFY_TIMEOUT_MS, stabilityMs = STABILITY_WINDOW_MS, pollMs = VERIFY_POLL_MS, readRecords = null, readDeviceRecords = null, readClientRecords = null, readNativeCrashes = null, processAlive = null, onReadinessPending = null, now = Date.now, sleep = (ms) => new Promise((r) => setTimeout(r, ms)) } = {}) {
 	const read = readRecords || (() => readMetroRecords(logsDir));
 	const readDevice = readDeviceRecords || (() => readNdjson(logsDir, "device.ndjson"));
 	const readClient = readClientRecords || (() => readNdjson(logsDir, "client.ndjson"));
@@ -908,9 +915,10 @@ async function verifyLaunch({ logsDir, since, metroPort = null, platform = null,
 	let runtimeStartedAt = null;
 	let nextCrashCheck = startedAt + 1e3;
 	while (true) {
-		const metroRecords = read().filter((record) => after(record, since));
-		const deviceRecords = readDevice().filter((record) => after(record, since));
-		const clientRecords = readClient().filter((record) => after(record, since));
+		const metroRecords = read().filter((record) => after(record, since) && (slot === void 0 || record.slot === slot));
+		const bundleRecords = metroRecords.filter((record) => !requireBundleResponse || String(record.event).startsWith("bundle_response_"));
+		const deviceRecords = readDevice().filter((record) => after(record, since) && (slot === void 0 || (record.slot ?? "default") === slot));
+		const clientRecords = readClient().filter((record) => after(record, since) && (slot === void 0 || record.slot === slot));
 		if (now() >= nextCrashCheck) {
 			nextCrashCheck = now() + 2e3;
 			const crash = nativeLaunchFailure({
@@ -924,14 +932,14 @@ async function verifyLaunch({ logsDir, since, metroPort = null, platform = null,
 			if (crash) return crash;
 		}
 		if (deliveryId === null) {
-			const request = metroRecords.find((record) => record.event === "bundle_response_started" && typeof record.requestId === "string" && isBundleProof(record, since, platform));
+			const request = bundleRecords.find((record) => record.event === "bundle_response_started" && typeof record.requestId === "string" && isBundleProof(record, since, platform));
 			if (request) {
 				deliveryId = request.requestId;
 				proof = null;
 				stabilityDeadline = null;
 			}
 		}
-		for (const record of metroRecords) {
+		for (const record of bundleRecords) {
 			if (isBundleProof(record, since, platform)) activity = record;
 			const completed = deliveryId === null ? isBundleReadyProof(record, since, platform) : record.event === "bundle_response_finished" && record.requestId === deliveryId && isBundleProof(record, since, platform);
 			if (!proof && completed) {
@@ -960,7 +968,7 @@ async function verifyLaunch({ logsDir, since, metroPort = null, platform = null,
 			}
 		}
 		const ready = pendingAt !== null && signals.some((record) => Number(record.ts) >= pendingAt && Number(record.ts) <= readinessDeadline && appReadinessSignal(record, platform) === "ready");
-		const bundleErrors = metroRecords.filter((record) => isFatalLaunchError(record, platform) || deliveryId !== null && record.event === "bundle_response_failed" && record.requestId === deliveryId && isBundleProof(record, since, platform));
+		const bundleErrors = bundleRecords.filter((record) => isFatalLaunchError(record, platform) || deliveryId !== null && record.event === "bundle_response_failed" && record.requestId === deliveryId && isBundleProof(record, since, platform));
 		if (bundleErrors.length) {
 			const alive = processAlive ? processAlive() : null;
 			const fatalRecord = bundleErrors[bundleErrors.length - 1];

package/dist/{build-slots-CgacA9zQ.mjs → build-slots-C3-R4XQr.mjs}

@@ -1,6 +1,6 @@
-import { u as getConfigDir } from "./config-D7uu8Gbq.mjs";
+import { u as getConfigDir } from "./config-CcefMY2Q.mjs";
 import { a as formatElapsed } from "./command-output-8wHMEde0.mjs";
-import { d as readClaimSet, f as releaseClaim, h as tryAcquireClaim, s as isClaimRefusal } from "./ownership-claim-CeJLEpjD.mjs";
+import { d as readClaimSet, f as releaseClaim, h as tryAcquireClaim, s as isClaimRefusal } from "./ownership-claim-Bf2CAfw3.mjs";
 import { readdirSync, statSync } from "node:fs";
 import { join } from "node:path";
 //#region src/engine/build-slots.ts
@@ -77,7 +77,7 @@ function tryAcquireBuildSlot({ max, root = null, logFile = null }) {
 	return null;
 }
 function slotWaitingLine({ max, elapsedMs }) {
-	return `${"build".padEnd(11)} waiting for a build slot (all ${max} in use, ${formatElapsed(elapsedMs)} elapsed)`;
+	return `${"build".padEnd(11)} waiting for a build slot (all ${max} in use, ${formatElapsed(elapsedMs)} elapsed) -- stim guide lifecycle concurrency`;
 }
 async function acquireBuildSlot({ max, root = null, logFile = null, now = Date.now, out = () => {}, sleep = sleepAsync, intervalMs = SLOT_POLL_MS, progressMs = SLOT_PROGRESS_MS, ceilingMs = SLOT_CEILING_MS }) {
 	if (!max || max <= 0) return {

package/dist/{cache-manifest-oeH18ERr.mjs → cache-manifest-CXR-Y8pH.mjs}

@@ -1,4 +1,4 @@
-import { u as getConfigDir } from "./config-D7uu8Gbq.mjs";
+import { u as getConfigDir } from "./config-CcefMY2Q.mjs";
 import { existsSync } from "fs";
 import { homedir } from "os";
 import { join, resolve } from "path";

package/dist/cache-manifest.mjs

@@ -1,2 +1,2 @@
-import { a as unregister, i as registeredCaches, n as readManifest, r as register, t as manifestPath } from "./cache-manifest-oeH18ERr.mjs";
+import { a as unregister, i as registeredCaches, n as readManifest, r as register, t as manifestPath } from "./cache-manifest-CXR-Y8pH.mjs";
 export { manifestPath, readManifest, register, registeredCaches, unregister };

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-BRF9aAJ3.mjs")],
-	["worktree", () => import("./worktree-DxEmUI_n.mjs")],
-	["start", () => import("./start-ByCylYtB.mjs")],
-	["stop", () => import("./stop-D6o5zAdm.mjs")],
-	["ios", () => import("./ios-CK1Vrk6Q.mjs")],
-	["android", () => import("./android-DnZlT3aU.mjs")],
-	["reload", () => import("./reload-DYZEBbZy.mjs")],
-	["device", () => import("./device-DJKv5Qej.mjs")],
-	["logs", () => import("./logs-Dxoy16Qv.mjs")],
-	["status", () => import("./status-Dia0XTqG.mjs")],
-	["stats", () => import("./stats-DZ4Q5J-7.mjs")],
-	["gc", () => import("./gc-DhXdgSdt.mjs")],
-	["guide", () => import("./guide-DrhrDBo5.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

@@ -4,6 +4,7 @@ import { ChildProcess as ChildProcess$1 } from "node:child_process";
 //#region src/exec.d.ts
 interface ExecOptions {
   timeoutMs?: number;
+  killSignal?: NodeJS.Signals;
   cwd?: string;
   env?: Record<string, string>;
   omitEnv?: readonly string[];
@@ -54,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;
@@ -68,6 +70,7 @@ interface ParsedCollectorArgs {
 }
 declare function parseArgs(argv: string[]): ParsedCollectorArgs;
 interface RunCollectorOptions {
+  slot?: string;
   platform: string;
   root: string;
   udid?: string | null;
@@ -113,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,11 +1,11 @@
-import { t as getExecutor } from "./exec-bsN9MJXb.mjs";
-import { T as captureProcessToken } from "./config-D7uu8Gbq.mjs";
-import { r as createNdjsonWriter } from "./ndjson-DcAtEx_K.mjs";
-import { D as workspaceLogsDir } from "./state-IYEY-zi8.mjs";
+import { t as getExecutor } from "./exec-CyylIdq9.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-CYbuRNXR.mjs";
-import { a as unregisterCollector, i as registerCollector, r as readCollectors, t as collectorProcessTitle } from "./ownership-D8HmSv2E.mjs";
-import { a as watchAppPid, i as waitForAppPid, n as parseLogcatLine, r as startAndroidLogcat, t as androidClockOffset } from "./android-CC5bUer7.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-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";
 import { fileURLToPath } from "node:url";
@@ -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-D7uu8Gbq.mjs → config-CcefMY2Q.mjs}

@@ -1,9 +1,88 @@
-import { t as getExecutor } from "./exec-bsN9MJXb.mjs";
+import { t as getExecutor } from "./exec-CyylIdq9.mjs";
 import { existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, readlinkSync, renameSync, statSync, unlinkSync, writeFileSync } from "fs";
 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-64wVnpZc.mjs → deps-Spz8ozgo.mjs}

@@ -1,6 +1,6 @@
-import { t as getExecutor } from "./exec-bsN9MJXb.mjs";
+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-CDB6fytw.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";