rnxsim 0.1.455 → 0.1.457

package/dist-lib/index.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.455 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.457 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;
@@ -56,6 +56,514 @@ __export(src_exports, {
 });
 module.exports = __toCommonJS(src_exports);
 
+// cli/cloud-client.ts
+var import_node_crypto = require("node:crypto");
+
+// ../sootsim-engine/src/metro-fingerprint-registry-client.ts
+var import_metro_fingerprint_registry = require("rnxsim/metro-fingerprint-registry");
+
+// ../sootsim-engine/src/metro-fingerprint.ts
+var import_metro_production_bundle = require("rnxsim/metro-production-bundle");
+var import_react_native_host_modules = require("rnxsim/react-native-host-modules");
+
+// src/backend-origin.ts
+function normalizeHostname(hostname) {
+  return hostname.replace(/^\[|\]$/g, "").toLowerCase();
+}
+function isLoopbackHost(hostname) {
+  const normalized = normalizeHostname(hostname);
+  return normalized === "localhost" || normalized.endsWith(".localhost") || normalized === "0.0.0.0" || normalized === "::1" || /^127(?:\.\d{1,3}){3}$/.test(normalized);
+}
+
+// src/cloud-contract.ts
+var RNX_CLOUD_MAX_ARTIFACT_BYTES = 20 * 1024 * 1024;
+var RNX_CLOUD_DESIGN_MAX_STORAGE_BYTES = 1024 * 1024;
+var RNX_CLOUD_COMMAND_TYPES = Object.freeze([
+  "state",
+  "query",
+  "resolve",
+  "perform",
+  "waitFor",
+  "reset",
+  "screenshot",
+  "capture",
+  "captureRegions",
+  "settle",
+  "setAppearance",
+  "openUrl",
+  "tree",
+  "tap",
+  "longPress",
+  "memory",
+  "diagnostics"
+]);
+var RNX_CLOUD_COMMAND_TYPE_SET = new Set(RNX_CLOUD_COMMAND_TYPES);
+function isRnxCloudCommandType(value) {
+  return RNX_CLOUD_COMMAND_TYPE_SET.has(value);
+}
+
+// src/metro-production-bundle.ts
+var RNXSIM_METRO_MODULE_PATHS_PREFIX = "globalThis.__sootsimModulePaths=";
+var RNX_METRO_MODULE_IDENTITY_VERSION = 2;
+var RNXSIM_METRO_SOURCE_MAP_COMMENT = "//# sourceMappingURL=";
+function detachRNXMetroSourceMapUrl(bundleText) {
+  const trimmedEnd = bundleText.replace(/\s+$/, "");
+  const commentStart = trimmedEnd.lastIndexOf(`
+${RNXSIM_METRO_SOURCE_MAP_COMMENT}`);
+  if (commentStart < 0) return { source: bundleText, sourceMappingUrl: null };
+  const url = trimmedEnd.slice(commentStart + 1 + RNXSIM_METRO_SOURCE_MAP_COMMENT.length);
+  if (url.includes("\n")) return { source: bundleText, sourceMappingUrl: null };
+  return { source: trimmedEnd.slice(0, commentStart), sourceMappingUrl: url };
+}
+function createRNXMetroModuleIdentityFooter(identity) {
+  const payload = JSON.stringify(identity).replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029").replace(/<\//g, "<\\/");
+  return `
+${RNXSIM_METRO_MODULE_PATHS_PREFIX}${payload};`;
+}
+function appendRNXMetroModuleIdentityFooter(bundleText, identity) {
+  const footer = createRNXMetroModuleIdentityFooter(identity);
+  const detached = detachRNXMetroSourceMapUrl(bundleText);
+  return detached.sourceMappingUrl === null ? bundleText + footer : `${detached.source}${footer}
+${RNXSIM_METRO_SOURCE_MAP_COMMENT}${detached.sourceMappingUrl}`;
+}
+
+// src/public-brand.ts
+var name = "rnx";
+var rnxPublicBrand = Object.freeze({
+  name,
+  packageName: "rnxsim",
+  commandName: "rnx",
+  domain: "rnxsim.com",
+  origin: "https://rnxsim.com"
+});
+
+// src/home-paths.ts
+var import_node_fs = __toESM(require("node:fs"), 1);
+var import_node_os = require("node:os");
+var import_node_path = __toESM(require("node:path"), 1);
+var RNX_HOME_ENV = "RNX_HOME";
+var ACTIVE_RUNTIME_FILE = "active";
+var DAEMON_LOCKFILE = "daemon.json";
+var DEV_BRIDGES_DIR = "dev-bridges";
+var DAEMON_HEARTBEAT_STALE_MS = 3e4;
+function rnxHomeDir() {
+  const override = process.env[RNX_HOME_ENV];
+  if (override && override.length > 0) return import_node_path.default.resolve(override);
+  return import_node_path.default.join((0, import_node_os.homedir)(), ".rnx");
+}
+function runtimesDir() {
+  return import_node_path.default.join(rnxHomeDir(), "runtimes");
+}
+function runtimeDir(version) {
+  return import_node_path.default.join(runtimesDir(), version);
+}
+function activeRuntimeFile() {
+  return import_node_path.default.join(runtimesDir(), ACTIVE_RUNTIME_FILE);
+}
+function daemonLockfilePath() {
+  return import_node_path.default.join(rnxHomeDir(), DAEMON_LOCKFILE);
+}
+function devBridgesDir() {
+  return import_node_path.default.join(rnxHomeDir(), DEV_BRIDGES_DIR);
+}
+function readActiveRuntime() {
+  try {
+    const value = import_node_fs.default.readFileSync(activeRuntimeFile(), "utf8").trim();
+    return value.length > 0 ? value : null;
+  } catch {
+    return null;
+  }
+}
+var DAEMON_LOCKFILE_MAX_BYTES = 16 * 1024;
+function readDaemonLockfile() {
+  try {
+    const fd = import_node_fs.default.openSync(daemonLockfilePath(), "r");
+    try {
+      const buf = Buffer.alloc(DAEMON_LOCKFILE_MAX_BYTES);
+      const bytesRead = import_node_fs.default.readSync(fd, buf, 0, DAEMON_LOCKFILE_MAX_BYTES, 0);
+      const raw = buf.subarray(0, bytesRead).toString("utf8");
+      const parsed = JSON.parse(raw);
+      if (parsed && parsed.schema === 1 && typeof parsed.pid === "number" && typeof parsed.bridgePort === "number" && typeof parsed.runtimePort === "number" && typeof parsed.startedAt === "number" && typeof parsed.heartbeatAt === "number" && (parsed.servedRuntimes === void 0 || Array.isArray(parsed.servedRuntimes) && parsed.servedRuntimes.every((version) => typeof version === "string"))) {
+        return parsed;
+      }
+      return null;
+    } finally {
+      import_node_fs.default.closeSync(fd);
+    }
+  } catch {
+    return null;
+  }
+}
+function parseDevBridgeLockfile(raw) {
+  try {
+    const parsed = JSON.parse(raw);
+    if (parsed && parsed.schema === 1 && parsed.source === "vite-dev" && typeof parsed.pid === "number" && typeof parsed.bridgePort === "number" && typeof parsed.runtimePort === "number" && typeof parsed.cwd === "string" && typeof parsed.startedAt === "number" && typeof parsed.heartbeatAt === "number" && (parsed.shellPort === void 0 || typeof parsed.shellPort === "number") && (parsed.servedRuntimes === void 0 || Array.isArray(parsed.servedRuntimes) && parsed.servedRuntimes.every((version) => typeof version === "string"))) {
+      return parsed;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+function readDevBridgeLockfiles() {
+  let entries;
+  try {
+    entries = import_node_fs.default.readdirSync(devBridgesDir(), { withFileTypes: true });
+  } catch {
+    return [];
+  }
+  const lockfiles = [];
+  for (const entry of entries) {
+    if (!entry.isFile() || !/^\d+\.json$/.test(entry.name)) continue;
+    try {
+      const filePath = import_node_path.default.join(devBridgesDir(), entry.name);
+      const fd = import_node_fs.default.openSync(filePath, "r");
+      try {
+        const buf = Buffer.alloc(DAEMON_LOCKFILE_MAX_BYTES);
+        const bytesRead = import_node_fs.default.readSync(fd, buf, 0, DAEMON_LOCKFILE_MAX_BYTES, 0);
+        const lockfile = parseDevBridgeLockfile(
+          buf.subarray(0, bytesRead).toString("utf8")
+        );
+        if (lockfile && entry.name === `${lockfile.bridgePort}.json`) {
+          lockfiles.push(lockfile);
+        }
+      } finally {
+        import_node_fs.default.closeSync(fd);
+      }
+    } catch {
+    }
+  }
+  return lockfiles.sort((left, right) => left.bridgePort - right.bridgePort);
+}
+function isDaemonLockfileFresh(lock, now = Date.now()) {
+  if (!lock) return false;
+  if (now - lock.heartbeatAt > DAEMON_HEARTBEAT_STALE_MS) return false;
+  try {
+    process.kill(lock.pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function isDevBridgeLockfileFresh(lock, now = Date.now()) {
+  if (!lock) return false;
+  if (now - lock.heartbeatAt > DAEMON_HEARTBEAT_STALE_MS) return false;
+  try {
+    process.kill(lock.pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// cli/run-rnx.ts
+var import_node_async_hooks = require("node:async_hooks");
+var sinks = new import_node_async_hooks.AsyncLocalStorage();
+
+// cli/auth.ts
+var CHOOSE_ACCOUNT_HINT = "this sign-in belongs to several accounts; run `rnx login --account <name>` to choose the one to bill";
+
+// cli/cloud-session.ts
+var CLOUD_SESSION_VERSION = 3;
+var MAX_ENCODED_SESSION_BYTES = 32 * 1024;
+var RNX_CLOUD_SESSION_ENV = "RNX_CLOUD_SESSION";
+var RNX_SHELL_UPDATE_PREFIX = "__RNX_SHELL_UPDATE_V1__";
+var RNX_SHELL_UPDATE_SET_PREFIX = `${RNX_SHELL_UPDATE_PREFIX}set:`;
+var RNX_SHELL_UPDATE_UNSET = `${RNX_SHELL_UPDATE_PREFIX}unset`;
+function isRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function normalizeCloudOrigin(source) {
+  let parsed;
+  try {
+    parsed = new URL(source);
+  } catch {
+    throw new Error(`invalid remote simulator origin: ${source}`);
+  }
+  if (parsed.protocol !== "https:" && parsed.protocol !== "http:" || parsed.username || parsed.password || parsed.pathname !== "/" || parsed.search || parsed.hash) {
+    throw new Error(`remote simulator origin must be an HTTP(S) origin: ${source}`);
+  }
+  if (parsed.protocol === "http:" && !isLoopbackHost(parsed.hostname)) {
+    throw new Error(`remote simulator origin requires HTTPS outside loopback: ${source}`);
+  }
+  return parsed.origin;
+}
+function createCloudSession(input) {
+  const session = {
+    version: CLOUD_SESSION_VERSION,
+    service: "sim",
+    boxId: input.boxId.trim(),
+    boxToken: input.boxToken,
+    simId: input.simId.trim(),
+    apiOrigin: normalizeCloudOrigin(input.apiOrigin.trim()),
+    claimId: input.claimId.trim(),
+    token: input.token
+  };
+  if (!session.boxId || !session.boxToken || !session.simId || !session.claimId || !session.token) {
+    throw new Error("cloud session requires box, simulator, origin, claim, and tokens");
+  }
+  return session;
+}
+function createCloudBoxSession(input) {
+  const session = {
+    version: CLOUD_SESSION_VERSION,
+    service: "box",
+    boxId: input.boxId.trim(),
+    boxToken: input.boxToken,
+    apiOrigin: normalizeCloudOrigin(input.apiOrigin.trim())
+  };
+  if (!session.boxId || !session.boxToken) {
+    throw new Error("cloud box session requires a box, an origin, and a box token");
+  }
+  return session;
+}
+function parseCloudSession(encoded) {
+  const value = encoded.trim();
+  if (!value || value.length > MAX_ENCODED_SESSION_BYTES || !/^[A-Za-z0-9_-]+$/.test(value)) {
+    throw new Error(`${RNX_CLOUD_SESSION_ENV} is invalid`);
+  }
+  let parsed;
+  try {
+    const bytes = Buffer.from(value, "base64url");
+    if (bytes.toString("base64url") !== value) {
+      throw new Error("non-canonical cloud session");
+    }
+    parsed = JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(bytes));
+  } catch {
+    throw new Error(`${RNX_CLOUD_SESSION_ENV} is invalid`);
+  }
+  if (!isRecord(parsed) || parsed.version !== CLOUD_SESSION_VERSION) {
+    throw new Error(`${RNX_CLOUD_SESSION_ENV} is invalid`);
+  }
+  const boxId = parsed.boxId;
+  const boxToken = parsed.boxToken;
+  const apiOrigin = parsed.apiOrigin;
+  if (typeof boxId !== "string" || typeof boxToken !== "string" || typeof apiOrigin !== "string") {
+    throw new Error(`${RNX_CLOUD_SESSION_ENV} is invalid`);
+  }
+  try {
+    if (parsed.service === "box") {
+      return createCloudBoxSession({ boxId, boxToken, apiOrigin });
+    }
+    const simId = parsed.simId;
+    const claimId = parsed.claimId;
+    const token = parsed.token;
+    if (parsed.service !== "sim" || typeof simId !== "string" || typeof claimId !== "string" || typeof token !== "string") {
+      throw new Error("unreadable cloud session");
+    }
+    return createCloudSession({ boxId, boxToken, simId, apiOrigin, claimId, token });
+  } catch {
+    throw new Error(`${RNX_CLOUD_SESSION_ENV} is invalid`);
+  }
+}
+function readCloudSession(environment = process.env) {
+  const encoded = environment[RNX_CLOUD_SESSION_ENV];
+  return encoded?.trim() ? parseCloudSession(encoded) : null;
+}
+
+// cli/cloud-client.ts
+var DEFAULT_RNX_CLOUD_ORIGIN = rnxPublicBrand.origin;
+function isRecord2(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function failureSentence(text) {
+  let parsed;
+  try {
+    parsed = JSON.parse(text);
+  } catch {
+    return null;
+  }
+  if (!isRecord2(parsed)) return null;
+  if (isRecord2(parsed.error) && typeof parsed.error.message === "string") {
+    return parsed.error.message;
+  }
+  if (typeof parsed.message === "string") return parsed.message;
+  if (typeof parsed.error === "string") return parsed.error;
+  return null;
+}
+var ACCOUNT_CHOICE_REFUSALS = /* @__PURE__ */ new Set([
+  "accountId is required",
+  "you do not have access to this account"
+]);
+function responseError(status, text) {
+  const parsed = text ? failureSentence(text) : null;
+  const sentence = parsed && ACCOUNT_CHOICE_REFUSALS.has(parsed) ? CHOOSE_ACCOUNT_HINT : parsed;
+  return new Error(
+    `remote simulator request failed (${status})${sentence ? `: ${sentence}` : text.trim() ? `: ${text.trim()}` : ""}`
+  );
+}
+function resolveCloudSessionForParsed(parsed) {
+  const session = readCloudSession();
+  if (!session) return null;
+  if (session.service === "box") {
+    if (parsed.simIdSource === "flag" && parsed.simId !== session.boxId) {
+      throw new Error(
+        `this shell is connected to box ${session.boxId}; ${parsed.simId ? `--sim ${parsed.simId}` : "the requested simulator"} is not available in this shell`
+      );
+    }
+    return session;
+  }
+  if (parsed.simIdSource === "flag" && parsed.simId !== session.simId) {
+    throw new Error(
+      `this shell is connected to remote simulator ${session.simId}; ${parsed.simId ? `--sim ${parsed.simId}` : "the requested simulator"} is not available in this shell`
+    );
+  }
+  return session;
+}
+function cloudCommand(command) {
+  const clean = {};
+  for (const [key, value] of Object.entries(command)) {
+    if (key !== "id" && key !== "simId") clean[key] = value;
+  }
+  if (isRnxCloudCommandType(command.type)) return clean;
+  throw new Error(
+    `a remote simulator does not support bridge command type ${command.type}`
+  );
+}
+var CloudBridge = class {
+  constructor(session) {
+    this.session = session;
+  }
+  plane = "cloud";
+  async send(command, options) {
+    const body = {
+      id: (0, import_node_crypto.randomUUID)(),
+      claimId: this.session.claimId,
+      command: cloudCommand(command)
+    };
+    let response;
+    try {
+      response = await fetch(
+        `${this.session.apiOrigin}/v1/sims/${encodeURIComponent(this.session.simId)}/commands`,
+        {
+          method: "POST",
+          headers: {
+            authorization: `Bearer ${this.session.token}`,
+            "content-type": "application/json"
+          },
+          body: JSON.stringify(body),
+          ...options?.timeoutMs ? { signal: AbortSignal.timeout(options.timeoutMs) } : {}
+        }
+      );
+    } catch (error) {
+      throw new Error(
+        `could not reach the remote simulator at ${this.session.apiOrigin}: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+    const text = await response.text();
+    if (!response.ok) throw responseError(response.status, text);
+    let parsed;
+    try {
+      parsed = JSON.parse(text);
+    } catch {
+      throw new Error("remote simulator command returned unreadable JSON");
+    }
+    if (!isRecord2(parsed) || parsed.id !== body.id) {
+      throw new Error("remote simulator command returned an invalid command receipt");
+    }
+    if (typeof parsed.error === "string" && parsed.error) throw new Error(parsed.error);
+    if (!Object.hasOwn(parsed, "result")) {
+      throw new Error("remote simulator command receipt has no result");
+    }
+    return parsed.result;
+  }
+  listSims() {
+    return Promise.reject(
+      new Error("a remote simulator does not expose a local simulator list")
+    );
+  }
+  focusSim() {
+    return Promise.reject(new Error("remote simulators have no browser window to focus"));
+  }
+  resolveReloadedSim() {
+    return Promise.resolve(null);
+  }
+  closeSim() {
+    return Promise.reject(
+      new Error("remote simulator close uses the simulator DELETE route")
+    );
+  }
+  claim() {
+    return Promise.reject(
+      new Error("remote simulator claim uses the simulator claim route")
+    );
+  }
+  close() {
+  }
+};
+var CloudBoxBridge = class {
+  constructor(session) {
+    this.session = session;
+  }
+  plane = "cloud";
+  async send(command, options) {
+    const id = (0, import_node_crypto.randomUUID)();
+    const payload = {};
+    for (const [key, value] of Object.entries(command)) {
+      if (key !== "id" && key !== "simId") payload[key] = value;
+    }
+    let response;
+    try {
+      response = await fetch(
+        `${this.session.apiOrigin}/v1/boxes/${encodeURIComponent(this.session.boxId)}/commands`,
+        {
+          method: "POST",
+          headers: {
+            authorization: `Bearer ${this.session.boxToken}`,
+            "content-type": "application/json"
+          },
+          body: JSON.stringify({ id, command: payload }),
+          ...options?.timeoutMs ? { signal: AbortSignal.timeout(options.timeoutMs) } : {}
+        }
+      );
+    } catch (error) {
+      throw new Error(
+        `could not reach box ${this.session.boxId} at ${this.session.apiOrigin}: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+    const text = await response.text();
+    if (!response.ok) throw responseError(response.status, text);
+    let parsed;
+    try {
+      parsed = JSON.parse(text);
+    } catch {
+      throw new Error("box command returned unreadable JSON");
+    }
+    if (!isRecord2(parsed) || parsed.id !== id) {
+      throw new Error("box command returned an invalid command receipt");
+    }
+    if (typeof parsed.error === "string" && parsed.error) throw new Error(parsed.error);
+    if (!Object.hasOwn(parsed, "result")) {
+      throw new Error("box command receipt has no result");
+    }
+    return parsed.result;
+  }
+  listSims() {
+    return Promise.reject(new Error("a box does not expose a local simulator list"));
+  }
+  focusSim() {
+    return Promise.reject(new Error("a box simulator has no browser window to focus"));
+  }
+  resolveReloadedSim() {
+    return Promise.resolve(null);
+  }
+  closeSim() {
+    return Promise.reject(new Error("close a box simulator with rnx box stop"));
+  }
+  claim() {
+    return Promise.reject(
+      new Error("a box simulator is held by its Box page and has nothing to claim")
+    );
+  }
+  close() {
+  }
+};
+function createCloudBridgeForParsed(parsed) {
+  const session = resolveCloudSessionForParsed(parsed);
+  if (!session) return null;
+  return session.service === "box" ? new CloudBoxBridge(session) : new CloudBridge(session);
+}
+
 // cli/current-sim.ts
 var import_fs2 = require("fs");
 var import_os = require("os");
@@ -215,25 +723,25 @@ function tryBuildDarwinCommFfi() {
 }
 
 // cli/secure-file.ts
-var import_node_crypto = require("node:crypto");
-var import_node_fs = require("node:fs");
-var import_node_path = require("node:path");
+var import_node_crypto2 = require("node:crypto");
+var import_node_fs2 = require("node:fs");
+var import_node_path2 = require("node:path");
 function writeSecureJsonAtomic(filepath, value) {
-  (0, import_node_fs.mkdirSync)((0, import_node_path.dirname)(filepath), { recursive: true });
-  const temporary = `${filepath}.tmp-${process.pid}-${(0, import_node_crypto.randomUUID)()}`;
+  (0, import_node_fs2.mkdirSync)((0, import_node_path2.dirname)(filepath), { recursive: true });
+  const temporary = `${filepath}.tmp-${process.pid}-${(0, import_node_crypto2.randomUUID)()}`;
   let descriptor = null;
   try {
-    descriptor = (0, import_node_fs.openSync)(temporary, "wx", 384);
-    (0, import_node_fs.fchmodSync)(descriptor, 384);
-    (0, import_node_fs.writeFileSync)(descriptor, `${JSON.stringify(value, null, 2)}
+    descriptor = (0, import_node_fs2.openSync)(temporary, "wx", 384);
+    (0, import_node_fs2.fchmodSync)(descriptor, 384);
+    (0, import_node_fs2.writeFileSync)(descriptor, `${JSON.stringify(value, null, 2)}
 `);
-    (0, import_node_fs.fsyncSync)(descriptor);
-    (0, import_node_fs.closeSync)(descriptor);
+    (0, import_node_fs2.fsyncSync)(descriptor);
+    (0, import_node_fs2.closeSync)(descriptor);
     descriptor = null;
-    (0, import_node_fs.renameSync)(temporary, filepath);
+    (0, import_node_fs2.renameSync)(temporary, filepath);
   } catch (error) {
-    if (descriptor !== null) (0, import_node_fs.closeSync)(descriptor);
-    (0, import_node_fs.rmSync)(temporary, { force: true });
+    if (descriptor !== null) (0, import_node_fs2.closeSync)(descriptor);
+    (0, import_node_fs2.rmSync)(temporary, { force: true });
     throw error;
   }
 }
@@ -394,213 +902,6 @@ function resolveSootsimBridgePort(input = {}) {
 // src/cli-constants.ts
 var DEFAULT_SOOTSIM_SHELL_URL = "http://localhost:5173/";
 
-// src/home-paths.ts
-var import_node_fs2 = __toESM(require("node:fs"), 1);
-var import_node_os = require("node:os");
-var import_node_path2 = __toESM(require("node:path"), 1);
-var RNX_HOME_ENV = "RNX_HOME";
-var ACTIVE_RUNTIME_FILE = "active";
-var DAEMON_LOCKFILE = "daemon.json";
-var DEV_BRIDGES_DIR = "dev-bridges";
-var DAEMON_HEARTBEAT_STALE_MS = 3e4;
-function rnxHomeDir() {
-  const override = process.env[RNX_HOME_ENV];
-  if (override && override.length > 0) return import_node_path2.default.resolve(override);
-  return import_node_path2.default.join((0, import_node_os.homedir)(), ".rnx");
-}
-function runtimesDir() {
-  return import_node_path2.default.join(rnxHomeDir(), "runtimes");
-}
-function runtimeDir(version) {
-  return import_node_path2.default.join(runtimesDir(), version);
-}
-function activeRuntimeFile() {
-  return import_node_path2.default.join(runtimesDir(), ACTIVE_RUNTIME_FILE);
-}
-function daemonLockfilePath() {
-  return import_node_path2.default.join(rnxHomeDir(), DAEMON_LOCKFILE);
-}
-function devBridgesDir() {
-  return import_node_path2.default.join(rnxHomeDir(), DEV_BRIDGES_DIR);
-}
-function readActiveRuntime() {
-  try {
-    const value = import_node_fs2.default.readFileSync(activeRuntimeFile(), "utf8").trim();
-    return value.length > 0 ? value : null;
-  } catch {
-    return null;
-  }
-}
-var DAEMON_LOCKFILE_MAX_BYTES = 16 * 1024;
-function readDaemonLockfile() {
-  try {
-    const fd = import_node_fs2.default.openSync(daemonLockfilePath(), "r");
-    try {
-      const buf = Buffer.alloc(DAEMON_LOCKFILE_MAX_BYTES);
-      const bytesRead = import_node_fs2.default.readSync(fd, buf, 0, DAEMON_LOCKFILE_MAX_BYTES, 0);
-      const raw = buf.subarray(0, bytesRead).toString("utf8");
-      const parsed = JSON.parse(raw);
-      if (parsed && parsed.schema === 1 && typeof parsed.pid === "number" && typeof parsed.bridgePort === "number" && typeof parsed.runtimePort === "number" && typeof parsed.startedAt === "number" && typeof parsed.heartbeatAt === "number" && (parsed.servedRuntimes === void 0 || Array.isArray(parsed.servedRuntimes) && parsed.servedRuntimes.every((version) => typeof version === "string"))) {
-        return parsed;
-      }
-      return null;
-    } finally {
-      import_node_fs2.default.closeSync(fd);
-    }
-  } catch {
-    return null;
-  }
-}
-function parseDevBridgeLockfile(raw) {
-  try {
-    const parsed = JSON.parse(raw);
-    if (parsed && parsed.schema === 1 && parsed.source === "vite-dev" && typeof parsed.pid === "number" && typeof parsed.bridgePort === "number" && typeof parsed.runtimePort === "number" && typeof parsed.cwd === "string" && typeof parsed.startedAt === "number" && typeof parsed.heartbeatAt === "number" && (parsed.shellPort === void 0 || typeof parsed.shellPort === "number") && (parsed.servedRuntimes === void 0 || Array.isArray(parsed.servedRuntimes) && parsed.servedRuntimes.every((version) => typeof version === "string"))) {
-      return parsed;
-    }
-    return null;
-  } catch {
-    return null;
-  }
-}
-function readDevBridgeLockfiles() {
-  let entries;
-  try {
-    entries = import_node_fs2.default.readdirSync(devBridgesDir(), { withFileTypes: true });
-  } catch {
-    return [];
-  }
-  const lockfiles = [];
-  for (const entry of entries) {
-    if (!entry.isFile() || !/^\d+\.json$/.test(entry.name)) continue;
-    try {
-      const filePath = import_node_path2.default.join(devBridgesDir(), entry.name);
-      const fd = import_node_fs2.default.openSync(filePath, "r");
-      try {
-        const buf = Buffer.alloc(DAEMON_LOCKFILE_MAX_BYTES);
-        const bytesRead = import_node_fs2.default.readSync(fd, buf, 0, DAEMON_LOCKFILE_MAX_BYTES, 0);
-        const lockfile = parseDevBridgeLockfile(
-          buf.subarray(0, bytesRead).toString("utf8")
-        );
-        if (lockfile && entry.name === `${lockfile.bridgePort}.json`) {
-          lockfiles.push(lockfile);
-        }
-      } finally {
-        import_node_fs2.default.closeSync(fd);
-      }
-    } catch {
-    }
-  }
-  return lockfiles.sort((left, right) => left.bridgePort - right.bridgePort);
-}
-function isDaemonLockfileFresh(lock, now = Date.now()) {
-  if (!lock) return false;
-  if (now - lock.heartbeatAt > DAEMON_HEARTBEAT_STALE_MS) return false;
-  try {
-    process.kill(lock.pid, 0);
-    return true;
-  } catch {
-    return false;
-  }
-}
-function isDevBridgeLockfileFresh(lock, now = Date.now()) {
-  if (!lock) return false;
-  if (now - lock.heartbeatAt > DAEMON_HEARTBEAT_STALE_MS) return false;
-  try {
-    process.kill(lock.pid, 0);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-// ../sootsim-engine/src/metro-fingerprint-registry-client.ts
-var import_metro_fingerprint_registry = require("rnxsim/metro-fingerprint-registry");
-
-// ../sootsim-engine/src/metro-fingerprint.ts
-var import_metro_production_bundle = require("rnxsim/metro-production-bundle");
-var import_react_native_host_modules = require("rnxsim/react-native-host-modules");
-
-// src/backend-origin.ts
-function normalizeHostname(hostname) {
-  return hostname.replace(/^\[|\]$/g, "").toLowerCase();
-}
-function isLoopbackHost(hostname) {
-  const normalized = normalizeHostname(hostname);
-  return normalized === "localhost" || normalized.endsWith(".localhost") || normalized === "0.0.0.0" || normalized === "::1" || /^127(?:\.\d{1,3}){3}$/.test(normalized);
-}
-
-// src/cloud-contract.ts
-var RNX_CLOUD_MAX_ARTIFACT_BYTES = 20 * 1024 * 1024;
-var RNX_CLOUD_DESIGN_MAX_STORAGE_BYTES = 1024 * 1024;
-var RNX_CLOUD_COMMAND_TYPES = Object.freeze([
-  "state",
-  "query",
-  "resolve",
-  "perform",
-  "waitFor",
-  "reset",
-  "screenshot",
-  "capture",
-  "captureRegions",
-  "settle",
-  "setAppearance",
-  "openUrl",
-  "tree",
-  "tap",
-  "longPress",
-  "memory",
-  "diagnostics"
-]);
-var RNX_CLOUD_COMMAND_TYPE_SET = new Set(RNX_CLOUD_COMMAND_TYPES);
-
-// src/metro-production-bundle.ts
-var RNXSIM_METRO_MODULE_PATHS_PREFIX = "globalThis.__sootsimModulePaths=";
-var RNX_METRO_MODULE_IDENTITY_VERSION = 2;
-var RNXSIM_METRO_SOURCE_MAP_COMMENT = "//# sourceMappingURL=";
-function detachRNXMetroSourceMapUrl(bundleText) {
-  const trimmedEnd = bundleText.replace(/\s+$/, "");
-  const commentStart = trimmedEnd.lastIndexOf(`
-${RNXSIM_METRO_SOURCE_MAP_COMMENT}`);
-  if (commentStart < 0) return { source: bundleText, sourceMappingUrl: null };
-  const url = trimmedEnd.slice(commentStart + 1 + RNXSIM_METRO_SOURCE_MAP_COMMENT.length);
-  if (url.includes("\n")) return { source: bundleText, sourceMappingUrl: null };
-  return { source: trimmedEnd.slice(0, commentStart), sourceMappingUrl: url };
-}
-function createRNXMetroModuleIdentityFooter(identity) {
-  const payload = JSON.stringify(identity).replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029").replace(/<\//g, "<\\/");
-  return `
-${RNXSIM_METRO_MODULE_PATHS_PREFIX}${payload};`;
-}
-function appendRNXMetroModuleIdentityFooter(bundleText, identity) {
-  const footer = createRNXMetroModuleIdentityFooter(identity);
-  const detached = detachRNXMetroSourceMapUrl(bundleText);
-  return detached.sourceMappingUrl === null ? bundleText + footer : `${detached.source}${footer}
-${RNXSIM_METRO_SOURCE_MAP_COMMENT}${detached.sourceMappingUrl}`;
-}
-
-// src/public-brand.ts
-var name = "rnx";
-var rnxPublicBrand = Object.freeze({
-  name,
-  packageName: "rnxsim",
-  commandName: "rnx",
-  domain: "rnxsim.com",
-  origin: "https://rnxsim.com"
-});
-
-// cli/run-rnx.ts
-var import_node_async_hooks = require("node:async_hooks");
-var sinks = new import_node_async_hooks.AsyncLocalStorage();
-
-// cli/cloud-session.ts
-var MAX_ENCODED_SESSION_BYTES = 32 * 1024;
-var RNX_SHELL_UPDATE_PREFIX = "__RNX_SHELL_UPDATE_V1__";
-var RNX_SHELL_UPDATE_SET_PREFIX = `${RNX_SHELL_UPDATE_PREFIX}set:`;
-var RNX_SHELL_UPDATE_UNSET = `${RNX_SHELL_UPDATE_PREFIX}unset`;
-
-// cli/cloud-client.ts
-var DEFAULT_RNX_CLOUD_ORIGIN = rnxPublicBrand.origin;
-
 // cli/ws-bridge.ts
 function bridgeWsUrl(wsPort) {
   return `ws://localhost:${wsPort}`;
@@ -1913,8 +2214,15 @@ async function tapResolvedTarget(bridge, args) {
   let attempts = 0;
   let lastPayload = null;
   let lastResult = null;
-  const canWaitForIdle = bridge.plane !== "cloud" && timing.initialWaitMs > 0;
-  if (canWaitForIdle) {
+  const settleCloud = async () => {
+    try {
+      await bridge.send({ type: "settle" });
+    } catch {
+    }
+  };
+  if (bridge.plane === "cloud") {
+    await settleCloud();
+  } else if (timing.initialWaitMs > 0) {
     try {
       await waitForSootsimIdle({
         bridge,
@@ -1954,34 +2262,45 @@ async function tapResolvedTarget(bridge, args) {
         lastOffscreenAt = null;
         const requestedTarget = tapTargetFromPayload(payload, args.textFallback);
         const { tree } = await inspectTree(bridge, 50);
+        let moved = false;
         if (Array.isArray(tree) && tree.length > 0) {
           const hit = hitTestSemanticTree(tree, payload.cx, payload.cy);
           const matched = hit !== null && (nodeMatchesRequested(hit.node, requestedTarget) || hit.ancestors.some(
             (ancestor) => nodeMatchesRequested(ancestor, requestedTarget)
           ));
-          if (hit && !matched) {
+          const blocks = hit !== null && (hit.node.type === "text" || hit.node.pressable === true || hit.ancestors.some((ancestor) => ancestor.pressable === true));
+          if (hit && !matched && blocks) {
+            moved = subtreeMatchesRequested(hit.node, requestedTarget);
             lastResult = {
               hit: false,
-              reason: "target-covered",
+              reason: moved ? "target-moved" : "target-covered",
               requestedTarget,
               coordinateTarget: coveringNodeSummary(hit.node)
             };
-            return { payload, result: lastResult, attempts, failure: "missed" };
+            if (!moved)
+              return { payload, result: lastResult, attempts, failure: "missed" };
           }
         }
-        const result = await tapCoordinates(
-          bridge,
-          payload.cx,
-          payload.cy,
-          requestedTarget
-        );
-        lastResult = result;
-        if (isTapSuccess(result)) return { payload, result, attempts };
+        if (!moved) {
+          const result = await tapCoordinates(
+            bridge,
+            payload.cx,
+            payload.cy,
+            requestedTarget
+          );
+          lastResult = result;
+          if (isTapSuccess(result)) return { payload, result, attempts };
+        }
       }
     }
     const remaining = deadline - Date.now();
     if (remaining <= 0) break;
-    if (bridge.plane === "cloud" || timing.retryWaitMs <= 0) break;
+    if (bridge.plane === "cloud") {
+      if (lastResult?.reason !== "target-moved" || attempts >= 3) break;
+      await settleCloud();
+      continue;
+    }
+    if (timing.retryWaitMs <= 0) break;
     try {
       await waitForSootsimIdle({
         bridge,
@@ -2000,6 +2319,13 @@ async function tapResolvedTarget(bridge, args) {
     failure: lastPayload && typeof lastPayload.cx === "number" ? "missed" : "not-found"
   };
 }
+function subtreeMatchesRequested(node, requested) {
+  for (const child of node.children ?? []) {
+    if (nodeMatchesRequested(child, requested) || subtreeMatchesRequested(child, requested))
+      return true;
+  }
+  return false;
+}
 async function tapCoordinates(bridge, x, y, target) {
   return bridge.send({
     type: "tap",
@@ -2298,6 +2624,9 @@ var SimClient = class {
     this.bridge = bridge;
     this.simId = simId;
   }
+  get plane() {
+    return this.bridge.plane;
+  }
   // --- transport (WsBridge/InspectBridge) ---
   send(cmd, opts) {
     if (this.closed) {
@@ -2675,6 +3004,19 @@ function pickSim(sims, wanted, port) {
   return primary;
 }
 async function connect(options = {}) {
+  const target = {
+    simId: options.sim,
+    simIdSource: options.sim ? "flag" : "none"
+  };
+  const cloud = resolveCloudSessionForParsed(target);
+  if (cloud) {
+    const bridge2 = createCloudBridgeForParsed(target);
+    if (!bridge2)
+      throw new SimConnectError("remote simulator session disappeared while connecting");
+    return new SimClient(bridge2, cloud.service === "box" ? cloud.boxId : cloud.simId, {
+      commandTimeoutMs: options.timeoutMs ?? 15e3
+    });
+  }
   const port = options.port ?? resolveBridgeWorld().bridgePort;
   const commandTimeoutMs = options.timeoutMs ?? 15e3;
   const discovery = createBridge(port, { commandTimeoutMs, cliLabel: "sdk" });
@@ -2880,12 +3222,12 @@ function isRnxCaptureRegionAtlas(value) {
 
 // src/vite-plugin-one.ts
 var import_fs4 = __toESM(require("fs"), 1);
-var import_node_crypto3 = require("node:crypto");
+var import_node_crypto4 = require("node:crypto");
 var import_path3 = __toESM(require("path"), 1);
 
 // src/dev-server-open.ts
 var import_node_child_process = require("node:child_process");
-var import_node_crypto2 = require("node:crypto");
+var import_node_crypto3 = require("node:crypto");
 var import_node_fs4 = __toESM(require("node:fs"), 1);
 var import_node_path4 = __toESM(require("node:path"), 1);
 var import_node_url = require("node:url");
@@ -2911,7 +3253,7 @@ function tagRnxBundleForPlugin(bundleUrl, replacementOrigin, replacementToken, p
     url.searchParams.set("rnxAppName", appName);
     url.searchParams.set(
       "rnxProjectId",
-      (0, import_node_crypto2.createHash)("sha256").update(import_node_fs4.default.realpathSync(projectRoot)).digest("hex").slice(0, 32)
+      (0, import_node_crypto3.createHash)("sha256").update(import_node_fs4.default.realpathSync(projectRoot)).digest("hex").slice(0, 32)
     );
   }
   url.searchParams.set("rnxReplacementOrigin", replacementOrigin);
@@ -3531,7 +3873,7 @@ function rnxPlugin(options = {}) {
       if (options.enabled === false) return;
       const bundleUrl = options.bundleUrl || "/node_modules/one/metro-entry.bundle?platform=ios&dev=true&minify=false";
       const appName = resolveRnxDesktopAppName(options.open, server.config.root);
-      const replacementToken = (0, import_node_crypto3.randomUUID)();
+      const replacementToken = (0, import_node_crypto4.randomUUID)();
       const configuredPort = server.config.server.port || 8081;
       const listeningPort = () => {
         const address = server.httpServer?.address();
@@ -3656,7 +3998,7 @@ function rnxPlugin(options = {}) {
 // src/metro-plugin.ts
 var import_fs5 = __toESM(require("fs"), 1);
 var import_module2 = require("module");
-var import_node_crypto4 = require("node:crypto");
+var import_node_crypto5 = require("node:crypto");
 var import_path4 = __toESM(require("path"), 1);
 var prefix = "/__soot";
 function readCallableMetroExport(moduleValue, label) {
@@ -3731,7 +4073,7 @@ function withRNX(config) {
   const configuredBundleUrl = "/index.bundle?platform=ios&dev=true&hot=true&minify=false";
   const cfgServer = config.server;
   const port = resolveMetroPort(cfgServer);
-  const metroServerId = (0, import_node_crypto4.randomUUID)();
+  const metroServerId = (0, import_node_crypto5.randomUUID)();
   const bundleUrl = tagRnxBundleForPlugin(
     configuredBundleUrl,
     `http://localhost:${port}`,