stim 1.20.2 → 1.21.0

package/dist/device-DuiPJQSn.mjs

@@ -1,290 +0,0 @@
-import { B as deviceSlotKey, U as parseDeviceSlotOption, W as projectDeviceSlots, p as getProject } from "./config-BYDxlMY3.mjs";
-import { n as fileLeaseIo, o as parseLeaseDuration, p as takeLease, u as releaseWorkspaceLeases } from "./device-lease-BX1sJQ2E.mjs";
-import { r as clockTime } from "./command-output-BTy8hZ0F.mjs";
-import { r as findProjectRoot, t as NO_PROJECT_REFUSAL } from "./project-_phNIJfs.mjs";
-import { E as getAvdNameForSerial, G as probeEmulatorSerial, N as memoizeEmulatorProbe, O as listAdbDevices, U as physicalDeviceModel, Y as resolvePhysicalDevice, c as androidPoolNoCandidatesRefusal, s as androidPoolCandidates } from "./android-Mz_Inn3w.mjs";
-import { l as parseDeviceWait, p as waitForDevice } from "./device-lease-run-Cw2M4z51.mjs";
-import { t as selectFromPool } from "./device-pool-Bf-pOhSw.mjs";
-import { a as iosPoolCandidates, c as isWirelessIosDevice, f as resolveIosPhysicalDevice, l as listIosDevices, o as iosPoolNoCandidatesRefusal } from "./ios-device-D7pi2Sca.mjs";
-import chalk from "chalk";
-//#region src/commands/device.ts
-const DEFAULT_FOR = "5m";
-const DEFAULT_DEPS = {
-	findProjectRoot,
-	getProject,
-	avdNameOf: getAvdNameForSerial,
-	listIosDevices,
-	listAdbDevices,
-	physicalDeviceModel,
-	probeEmulatorSerial,
-	takeLease,
-	releaseLeases: releaseWorkspaceLeases,
-	waitForDevice,
-	selectFromPool,
-	io: fileLeaseIo,
-	now: () => Date.now(),
-	sleep: (ms) => new Promise((r) => setTimeout(r, ms)),
-	out: (line) => console.log(line),
-	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}${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)}.`;
-}
-function readPlatform(value) {
-	return value === "ios" || value === "android" ? value : null;
-}
-function resolveDevice(platform, requested, d) {
-	if (platform === "ios") {
-		const resolved = resolveIosPhysicalDevice(requested, d.listIosDevices());
-		if (!resolved.udid) return {
-			code: "STIM_NO_DEVICE",
-			message: resolved.error,
-			remedy: resolved.remedy ?? null
-		};
-		return {
-			id: resolved.udid,
-			deviceName: resolved.name ?? resolved.udid
-		};
-	}
-	const resolved = resolvePhysicalDevice(requested, d.listAdbDevices(), d.probeEmulatorSerial);
-	if (!resolved.serial) return {
-		code: "STIM_NO_DEVICE",
-		message: resolved.error,
-		remedy: resolved.remedy ?? null
-	};
-	return {
-		id: resolved.serial,
-		deviceName: d.physicalDeviceModel(resolved.serial) ?? resolved.serial
-	};
-}
-function findOwnedVirtualDevice(project, platform, id, avdNameOf) {
-	let running;
-	for (const { slot, platforms } of projectDeviceSlots(project)) {
-		if (platform === "ios") {
-			const sim = platforms.ios;
-			if (sim?.owned && sim.deviceUdid && sim.deviceUdid.toLowerCase() === id.toLowerCase()) return {
-				id: sim.deviceUdid,
-				deviceName: sim.deviceName ?? null,
-				slot
-			};
-			continue;
-		}
-		const emulator = platforms.android;
-		if (!emulator?.owned || !emulator.avdName || !/^emulator-\d+$/.test(id)) continue;
-		running ??= { name: avdNameOf(id) };
-		if (running.name === emulator.avdName) return {
-			id,
-			deviceName: emulator.deviceName ?? emulator.avdName,
-			slot
-		};
-	}
-	return null;
-}
-function isFailure(value) {
-	return "code" in value;
-}
-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,
-		list: () => platform === "ios" ? iosPoolCandidates(d.listIosDevices()).map((entry) => ({
-			id: entry.udid,
-			name: entry.name,
-			fallback: isWirelessIosDevice(entry)
-		})) : androidPoolCandidates(d.listAdbDevices(), isEmulator).map((entry) => ({ id: entry.serial })),
-		noCandidates: () => {
-			const resolved = platform === "ios" ? iosPoolNoCandidatesRefusal(d.listIosDevices()) : androidPoolNoCandidatesRefusal(d.listAdbDevices(), isEmulator);
-			return {
-				message: resolved.error,
-				remedy: resolved.remedy
-			};
-		},
-		waitSeconds,
-		deadline,
-		now: d.now,
-		sleep: d.sleep,
-		warn: (line) => d.note(chalk.yellow(line)),
-		io: d.io
-	});
-	if (pooled.status === "refused") return {
-		code: pooled.refusal.code,
-		message: pooled.refusal.message,
-		remedy: pooled.refusal.remedy,
-		...pooled.refusal.lease === null ? {} : { lease: pooled.refusal.lease }
-	};
-	const name = pooled.candidate.name ?? (platform === "ios" ? pooled.candidate.id : d.physicalDeviceModel(pooled.candidate.id));
-	return {
-		id: pooled.candidate.id,
-		deviceName: name ?? pooled.candidate.id
-	};
-}
-async function runLock(platformArg, idArg, opts = {}, overrides = {}) {
-	const d = {
-		...DEFAULT_DEPS,
-		...overrides
-	};
-	const json = Boolean(opts.json);
-	const report = (failure) => {
-		d.note(chalk.red(`${failure.code}: ${failure.message}`));
-		if (failure.remedy) d.note(chalk.dim(failure.remedy));
-		if (json) d.out(JSON.stringify({
-			code: failure.code,
-			message: failure.message,
-			remedy: failure.remedy,
-			...failure.lease === void 0 ? {} : { lease: failure.lease }
-		}));
-		return failure;
-	};
-	const platform = readPlatform(platformArg);
-	if (!platform) return report({
-		code: "STIM_BAD_ARG",
-		message: `\`stim device lock\` takes ios or android, not ${JSON.stringify(platformArg)}.`,
-		remedy: "Run `stim device lock ios` or `stim device lock android`."
-	});
-	const root = d.findProjectRoot(process.cwd());
-	if (!root) return report(NO_PROJECT_REFUSAL);
-	const durationText = String(opts.for ?? DEFAULT_FOR).trim();
-	const duration = parseLeaseDuration(durationText);
-	if ("error" in duration) return report({
-		code: "STIM_BAD_ARG",
-		message: duration.error,
-		remedy: "Pass a whole number of seconds or minutes from 10s to 30m, e.g. --for 90s or --for 10m."
-	});
-	const wait = parseDeviceWait(opts.wait);
-	if ("error" in wait) return report({
-		code: "STIM_BAD_ARG",
-		message: wait.error,
-		remedy: "Pass a whole number of seconds, e.g. --wait 90. `--wait 0` refuses a leased device at once."
-	});
-	const idLabel = platform === "ios" ? "udid" : "serial";
-	const deadline = d.now() + wait.seconds * 1e3;
-	const lastLine = { at: null };
-	const owned = idArg ? findOwnedVirtualDevice(d.getProject(root), platform, idArg, d.avdNameOf) : null;
-	if (owned && opts.slot && opts.slot !== owned.slot) return report({
-		code: "STIM_BAD_ARG",
-		message: `${owned.id} is this workspace's ${platform} device in slot ${owned.slot}, not ${opts.slot}.`,
-		remedy: `Run \`stim device lock ${platform} ${owned.id}\` without --slot, or with --slot ${owned.slot}.`
-	});
-	const held = owned ? d.io.readHolder(root)[deviceSlotKey(platform, owned.slot)] : void 0;
-	if (owned && held && held.id !== owned.id) return report({
-		code: "STIM_DEVICE_BUSY",
-		message: `This workspace already leases ${held.id} for ${platform} in slot ${owned.slot}, and a workspace holds one lease per platform and slot.`,
-		remedy: `Release it with \`stim device unlock ${platform}${owned.slot === "default" ? "" : ` --slot ${owned.slot}`}\` once nothing depends on it, then lock ${owned.id}.`
-	});
-	const slot = owned ? owned.slot === "default" ? void 0 : owned.slot : opts.slot;
-	const device = owned ? owned : 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({
-			...slot ? { slot } : {},
-			root,
-			platform,
-			id: device.id,
-			idLabel,
-			waitSeconds: wait.seconds,
-			now: d.now,
-			sleep: d.sleep,
-			warn: (line) => d.note(chalk.yellow(line)),
-			io: d.io,
-			deadline,
-			lastLine
-		});
-		if (outcome.status === "refused") return report({
-			...outcome.refusal,
-			lease: outcome.refusal.lease
-		});
-		const taken = d.takeLease({
-			...slot ? { slot } : {},
-			root,
-			platform,
-			id: device.id,
-			deviceName: device.deviceName,
-			kind: "declared",
-			durationMs: duration.ms
-		}, d.io);
-		if (taken.status === "unreadable") return report({
-			code: "STIM_DEVICE_BUSY",
-			message: `The lease file at ${taken.path} does not parse, so Stim cannot tell who holds that device.`,
-			remedy: `Read ${taken.path} and, once you know no run depends on it, delete it. \`stim gc\` reports it on every run.`,
-			lease: {
-				platform: null,
-				id: null,
-				deviceName: null,
-				holder: null,
-				expiresAt: null
-			}
-		});
-		if (taken.status === "held") continue;
-		const facts = {
-			...taken.lease.slot ? { slot: taken.lease.slot } : {},
-			platform,
-			id: taken.lease.id,
-			deviceName: taken.lease.deviceName,
-			holder: taken.lease.holder,
-			kind: "declared",
-			grantedAt: taken.lease.grantedAt,
-			expiresAt: taken.lease.expiresAt,
-			leaseSeconds: Math.round(duration.ms / 1e3)
-		};
-		if (json) d.out(JSON.stringify(facts));
-		else d.out(chalk.green(grantLine(facts, durationText)));
-		return facts;
-	}
-}
-async function runUnlock(platformArg, opts = {}, overrides = {}) {
-	const d = {
-		...DEFAULT_DEPS,
-		...overrides
-	};
-	const json = Boolean(opts.json);
-	const report = (failure) => {
-		d.note(chalk.red(`${failure.code}: ${failure.message}`));
-		if (failure.remedy) d.note(chalk.dim(failure.remedy));
-		if (json) d.out(JSON.stringify({
-			code: failure.code,
-			message: failure.message,
-			remedy: failure.remedy
-		}));
-		return failure;
-	};
-	const platform = platformArg === void 0 ? null : readPlatform(platformArg);
-	if (platformArg !== void 0 && !platform) return report({
-		code: "STIM_BAD_ARG",
-		message: `\`stim device unlock\` takes ios or android, not ${JSON.stringify(platformArg)}.`,
-		remedy: "Run `stim device unlock` for every lease this workspace holds, or name one platform."
-	});
-	const root = d.findProjectRoot(process.cwd());
-	if (!root) return report(NO_PROJECT_REFUSAL);
-	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,
-		holder: root
-	}))));
-	else for (const lease of released) d.out(chalk.green(releasedLine(lease)));
-	return released;
-}
-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, a connected device or this workspace's own simulator or emulator; without one, the first free connected device is used").description("Lease a connected physical device, or this workspace's own simulator or emulator, to this workspace for a declared time, so another workspace's `--device` run waits and agents see the device as driven. 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", parseDeviceSlotOption).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("--slot <name>", "Use this workspace device slot", parseDeviceSlotOption).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);
-	});
-}
-function deviceCommand(program) {
-	registerDevice(program);
-}
-//#endregion
-export { deviceCommand as default, grantLine, registerDevice, releasedLine, runLock, runUnlock };