@expo/serve-sim 0.11.0 → 0.12.0

package/README.md

@@ -402,6 +402,30 @@ http://localhost:8081/_expo/plugins/expo-device-hub
 
 No other configuration needed.
 
+## Restrict a session to one simulator
+
+```sh
+npx @expo/serve-sim --single-device <simulator-udid>
+```
+
+This boots and locks the preview to that exact simulator. The device sidebar
+and its toggle are removed. HTTP routes, helper sockets, and control actions
+reject other device targets, including `all` and `booted`. The same simulator
+can reboot or reconnect without changing the session's device. This option
+requires the preview server and cannot be combined with `--detach`, `--orphan`,
+`--no-preview`, `--list`, or `--kill`. It can accompany `--adopt` when its UDID
+matches the prepared server's startup device. The private handoff applies the
+restriction before reporting success; it does not boot another Simulator.
+
+Embedded hosts can set `simMiddleware({ singleDevice: udid })`. This also enables
+same-origin helper proxies; forward WebSocket upgrades as described below.
+WebKit DevTools is disabled because the bridge cannot reliably associate its
+targets with a simulator UDID. The restriction applies to this server's routes;
+it does not prevent host tools or separately running servers from using devices.
+Path-based `file.readBase64` and `app.infoPlist` actions remain host-scoped within
+their existing allowed roots. They can read files belonging to another Simulator;
+single-device mode is not a filesystem sandbox.
+
 ## Embed in your dev server
 
 `@expo/serve-sim/middleware` is a **fetch-style** middleware. `simMiddleware(options)` returns a Web-standard request handler with a `.handleWebSocket` hook, so it mounts in any server that speaks `Request`/`Response` (Bun, Deno, Hono, a Node adapter, …). Run `serve-sim --detach` once to start the streaming helper, then wire the two entry points: