@ceraph/react-native-mcp 0.3.3 → 0.4.6

package/README.md

@@ -1,46 +1,140 @@
 # @ceraph/react-native-mcp
 
-MCP server for React Native and Expo development. Automatic build error capture, console monitoring, reliable screen interactions, prebuild detection, and iOS Simulator support.
+MCP server for React Native and Expo development. Automatic build error capture, console monitoring, reliable screen interactions, and prebuild detection.
 
 Works with any MCP client: Claude Code, Cursor, Codex, Windsurf, and others.
 
 > ⚠️ **Ignore the `npm i` line above.** Run this once instead:
 >
 > ```bash
-> npx @ceraph/react-native-mcp init
+> npx @ceraph/react-native-mcp@latest init
 > ```
 
+## Platform support
+
+This MCP is **iOS-only**. Both a real iOS device (the original supported configuration) and a booted iOS Simulator now work. The runtime path (devicectl / idb / WebDriverAgent / simctl) is Apple-specific.
+
+| | Status | Notes |
+|---|---|---|
+| iOS device (USB) | Supported | WebDriverAgent installs through Xcode (one-time); WDA is reached at `localhost:8100`. Default — no env var needed. |
+| iOS Simulator | Supported | `ceraph_start` installs the optional `appium-webdriveragent` dep and builds + launches the WDA automatically the first time you target a simulator. See [Simulator setup](#simulator-setup) below. |
+| Android (device or emulator) | Not supported | |
+| Linux / Windows host | Not supported | |
+| Expo Go | Not supported | Needs dev client or prebuilt app. |
+
+If you don't have a Mac with Xcode, stop here — nothing in this package will work for you yet.
+
+### Choosing device vs simulator
+
+By default the MCP auto-detects: if a real device is connected, it uses the device; otherwise it uses a booted simulator. Override explicitly:
+
+```bash
+export CERAPH_TARGET=device     # always use real device
+export CERAPH_TARGET=simulator  # always use simulator
+export CERAPH_TARGET=auto       # default behavior (also: unset)
+```
+
+The `rn_target_status` tool reports which target is currently active and the resolved WDA base URL.
+
 ## Requirements
 
 - macOS with Xcode 14+ (Command Line Tools installed)
-- iOS 16+ device on USB **OR** a booted iOS Simulator
+- iOS 16+ device connected to the Mac over USB and unlocked **OR** a booted iOS Simulator
 - Node.js 18+
-- [`mobile-mcp`](https://github.com/mobile-next/mobile-mcp) for screenshots, swipe, and device management
+- [WebDriverAgent](https://github.com/appium/WebDriverAgent) running and reachable. On a real device, this is `localhost:8100` (port-forwarded from the device by Xcode / `iproxy`). On a simulator, the port is captured at runtime from `rn_wda_start` — see [Simulator setup](#simulator-setup).
 - Expo dev client or prebuilt app (Expo Go is not supported)
 
-iOS-only. Android, Linux, and Windows hosts are not supported.
+> **Multi-developer Macs:** The runtime signal listener binds to `localhost:8101` (WDA uses 8100, Metro uses 8081). Only one developer on a given Mac can run the MCP at a time without a port collision. If you share a Mac and need parallel sessions, override the port via `CERAPH_SIGNAL_PORT` when starting the MCP server.
+
+### Environment variables
+
+| Variable | Default | Purpose |
+|---|---|---|
+| `CERAPH_SIGNAL_HOST` | auto-detected | Optional override for the host the on-device signal capture posts to. It auto-discovers the Mac's address from the Metro dev-server URL at runtime (`SourceCode.scriptURL` — `localhost` on a simulator, the LAN IP on a real device), and the MCP server re-detects the LAN IP at startup for its own listener binding. You only set this for unusual network setups where the dev-server host isn't reachable for the signal channel (e.g. `192.168.1.x`). Leave it unset for normal use. |
+| `CERAPH_SIGNAL_PORT` | `8101` | Port the signal listener binds to on the Mac. Change when 8101 is taken. |
+| `CERAPH_TARGET` | `auto` | Which iOS runtime to drive. `device` forces the real-device path even if a simulator is booted; `simulator` forces simctl/sim-WDA even if a device is connected; `auto` prefers device when both are available. |
+
+## Simulator setup
+
+On a simulator, the WDA needs the optional `appium-webdriveragent` package — `ceraph_start` (and `rn_wda_start`) install it automatically the first time you target a simulator, then build and launch the WDA for you. The first build is a one-time ~1 minute; later runs reuse the cache at `<project>/.ceraph/wda-derived/`. It's an optional dep, so device-only setups skip the ~200 MB download.
+
+Boot any iPhone simulator (iOS ≥ 16) and run `ceraph_start`:
+
+```bash
+open -a Simulator
+# or: xcrun simctl boot <UDID>
+```
+
+`xcrun simctl list devices booted` shows what's currently up.
+
+Once WDA is up, every `screen_*`, `app_*`, and `rn_test_*` tool routes to the simulator automatically. Call `rn_wda_stop` to tear it down (or just exit the MCP — shutdown stops the xcodebuild child cleanly).
+
+**Concurrent device + simulator:** The auto-detection prefers a connected device. To test on the simulator while a phone is plugged in, set `CERAPH_TARGET=simulator` in the MCP process environment.
 
 ## Quick Setup
 
 Run this from your project root:
 
 ```bash
-npx @ceraph/react-native-mcp init
+npx @ceraph/react-native-mcp@latest init
 ```
 
-For testing on a simulator, also run `npm i -D appium-webdriveragent` and call `rn_wda_start` once from your MCP client (first WDA build takes 60–120s and may need an Xcode signing prompt; subsequent starts are ~5–10s via cache).
+This automatically:
+- Configures MCP servers for all detected clients (Claude Code, Cursor, Codex, VS Code, Windsurf, Antigravity)
+- Installs a Claude Code hook that injects runtime errors into your conversation automatically
+- Adds `.rn-errors.json` to your `.gitignore`
+- Signs you in (browser OAuth) so the autonomous flow tools can reach the Ceraph server
 
-## Uninstalling
+## Uninstalling Ceraph
 
 ```bash
 npx @ceraph/react-native-mcp uninstall
 ```
 
-Flags: `--yes` (skip prompts), `--purge-images` (also delete `.ceraph/`), `--global` (also delete `~/.ceraph/auth.json`), `--dry-run` (preview only).
+Non-destructive by default: it reverses what `init` did and reports a per-step status, leaving your camera test images and OAuth token in place so you can re-install without losing state. Only `@ceraph/react-native-mcp` is removed from `package.json`.
+
+### Flags
+
+| Flag | Effect |
+| --- | --- |
+| `-y`, `--yes` | Skip confirmation prompts. |
+| `--purge-images` | Also delete `.ceraph/` (camera images, design snapshots, run artefacts). |
+| `--global` | Also delete `~/.ceraph/auth.json`, signing you out of every Ceraph install on the machine. |
+| `--dry-run` | Preview the step list without writing anything. |
+| `--project-dir <path>` | Operate against a specific subpackage. Required when a monorepo has more than one React Native app. |
+
+Or have your assistant drive `ceraph_uninstall_status` / `ceraph_uninstall_run` — call with `dryRun: true` first to preview.
+
+### Not auto-reverted
+
+A few mutations are hand-edits the uninstaller can't safely make for you. Each surfaces as a `manual` step with the exact lines to remove:
+
+- **Bare React Native `Info.plist` and `AndroidManifest.xml` scheme entries.**
+- **Expo dynamic config (`app.config.js` / `app.config.ts`)** — the file path and scheme value to remove.
+- **`useEffect` that contains `installCeraph()` alongside your own statements** — the file and line to edit.
+
+## Automatic auto-lock (optional)
+
+If your consumer app has `expo-keep-awake` (Expo SDK installs it by default) or `react-native-keep-awake`, Ceraph activates it in `__DEV__` so your iPhone screen stays awake during Ceraph runs. It subscribes to `AppState` and releases the keep-awake when the app backgrounds, then re-acquires on foreground. Production builds tree-shake the entire path.
+
+To add the optional dep to an Expo app:
+
+```bash
+npx expo install expo-keep-awake
+```
+
+### USB bridge (real-device only)
+
+Real iOS devices reach WebDriverAgent through `iproxy 8100 8100 -u <udid>` (libimobiledevice). The MCP's doctor auto-spawns this when:
+
+1. WDA at `localhost:8100` is unreachable, AND
+2. A real iOS device is connected (detected via `xcrun devicectl`)
+
+If `iproxy` isn't installed, doctor surfaces the remediation: `brew install libimobiledevice`. The auto-spawned child is killed cleanly on MCP server SIGINT / SIGTERM, so it doesn't hang around between sessions. Already-running iproxy (from Xcode's automatic forwarding, or a prior session) is detected and reused, not re-launched.
 
 ## Manual Setup
 
-If you prefer to configure manually:
+If you prefer to configure manually, follow the instructions for your client below.
 
 ### Claude Code
 
@@ -49,34 +143,34 @@ Add to `.mcp.json` in your project root:
 ```json
 {
   "mcpServers": {
-    "mobile-mcp": { "command": "npx", "args": ["-y", "@mobilenext/mobile-mcp@latest"] },
-    "react-native-mcp": { "command": "npx", "args": ["-y", "@ceraph/react-native-mcp@latest"] }
+    "react-native-mcp": {
+      "command": "npx",
+      "args": ["-y", "@ceraph/react-native-mcp@latest"]
+    }
   }
 }
 ```
 
 ### Cursor
 
-Add to `.cursor/mcp.json`:
+Add to `.cursor/mcp.json` in your project root:
 
 ```json
 {
   "mcpServers": {
-    "mobile-mcp": { "command": "npx", "args": ["-y", "@mobilenext/mobile-mcp@latest"] },
-    "react-native-mcp": { "command": "npx", "args": ["-y", "@ceraph/react-native-mcp@latest"] }
+    "react-native-mcp": {
+      "command": "npx",
+      "args": ["-y", "@ceraph/react-native-mcp@latest"]
+    }
   }
 }
 ```
 
 ### Codex
 
-Add to `.codex/config.toml`:
+Add to `.codex/config.toml` in your project root:
 
 ```toml
-[mcp_servers.mobile-mcp]
-command = "npx"
-args = ["-y", "@mobilenext/mobile-mcp@latest"]
-
 [mcp_servers.react-native-mcp]
 command = "npx"
 args = ["-y", "@ceraph/react-native-mcp@latest"]
@@ -84,13 +178,15 @@ args = ["-y", "@ceraph/react-native-mcp@latest"]
 
 ### VS Code / Copilot
 
-Add to `.vscode/mcp.json`:
+Add to `.vscode/mcp.json` in your project root:
 
 ```json
 {
   "mcpServers": {
-    "mobile-mcp": { "command": "npx", "args": ["-y", "@mobilenext/mobile-mcp@latest"] },
-    "react-native-mcp": { "command": "npx", "args": ["-y", "@ceraph/react-native-mcp@latest"] }
+    "react-native-mcp": {
+      "command": "npx",
+      "args": ["-y", "@ceraph/react-native-mcp@latest"]
+    }
   }
 }
 ```
@@ -102,42 +198,49 @@ Add to `~/.codeium/windsurf/mcp_config.json` (or Settings → Advanced Settings
 ```json
 {
   "mcpServers": {
-    "mobile-mcp": { "command": "npx", "args": ["-y", "@mobilenext/mobile-mcp@latest"] },
-    "react-native-mcp": { "command": "npx", "args": ["-y", "@ceraph/react-native-mcp@latest"] }
+    "react-native-mcp": {
+      "command": "npx",
+      "args": ["-y", "@ceraph/react-native-mcp@latest"]
+    }
   }
 }
 ```
 
 ### Antigravity
 
-Add to `~/.gemini/antigravity/mcp_config.json`:
+Add to `~/.gemini/antigravity/mcp_config.json` (or Manage MCP Servers → View raw config):
 
 ```json
 {
   "mcpServers": {
-    "mobile-mcp": { "command": "npx", "args": ["-y", "@mobilenext/mobile-mcp@latest"] },
-    "react-native-mcp": { "command": "npx", "args": ["-y", "@ceraph/react-native-mcp@latest"] }
+    "react-native-mcp": {
+      "command": "npx",
+      "args": ["-y", "@ceraph/react-native-mcp@latest"]
+    }
   }
 }
 ```
 
 ### Cline / Roo Code (VS Code extensions)
 
-VS Code Settings → Extensions → Cline (or Roo Code) → MCP Servers:
+Open VS Code Settings → Extensions → Cline (or Roo Code) → MCP Servers, then add:
 
 ```json
 {
-  "mobile-mcp": { "command": "npx", "args": ["-y", "@mobilenext/mobile-mcp@latest"] },
-  "react-native-mcp": { "command": "npx", "args": ["-y", "@ceraph/react-native-mcp@latest"] }
+  "react-native-mcp": {
+    "command": "npx",
+    "args": ["-y", "@ceraph/react-native-mcp@latest"]
+  }
 }
 ```
 
 ### JetBrains IDEs
 
-Settings → Tools → MCP Servers → Add:
+Settings → Tools → MCP Servers → Add, then enter:
 
-- **Name:** `react-native-mcp` — **Command:** `npx` — **Args:** `-y @ceraph/react-native-mcp@latest`
-- Repeat for `mobile-mcp` with args `-y @mobilenext/mobile-mcp@latest`.
+- **Name:** `react-native-mcp`
+- **Command:** `npx`
+- **Args:** `-y @ceraph/react-native-mcp@latest`
 
 ## Tools
 
@@ -145,59 +248,223 @@ Settings → Tools → MCP Servers → Add:
 
 | Tool | Description |
 |---|---|
-| `rn_build_ios` | Build with `expo run:ios`. Returns structured Xcode errors (file, line, message). Optionally runs `prebuild --clean` first. |
-| `rn_start` | Start Metro. Monitors stdout for runtime errors, JS exceptions, and red screens. |
-| `rn_get_errors` | Return all captured build and runtime errors. |
-| `rn_get_console` | Return recent Metro console output. |
-| `rn_check_prebuild` | Detect if `prebuild --clean` is needed (diffs `package.json`, `app.json`, `Podfile.lock`). |
+| `ceraph_start` | **Call this first.** Brings a connected iPhone to ready-to-test in one call: Metro, then build/install + foreground the app (keep-awake shim) and start WebDriverAgent concurrently, then verify on-device automation. Runs only what's missing, stops at the first failed gate with its remediation. Real device only. |
+| `ceraph_doctor` | Diagnose readiness before flows run: WDA reachable, device connected + awake, app installed, required env vars present, plus camera-shim setup (unwrapped `<CameraView>`, missing or orphaned `imageKey`). Returns structured failing checks with their remediation. `ceraph_start` runs it automatically as its final verify stage. |
+| `rn_build_ios` | Build the app with `expo run:ios`. Captures Xcode output and returns structured errors (file, line, message, type). Optionally runs `prebuild --clean` first. |
+| `rn_start` | Start Metro dev server. Monitors console output for runtime errors, JS exceptions, and red screens. |
+| `rn_get_errors` | Return all captured build and runtime errors without re-running anything. |
+| `rn_get_console` | Return recent Metro console output, filtered by log level. |
+| `rn_check_prebuild` | Detect if `prebuild --clean` is needed by diffing `package.json`, `app.json`, and `Podfile.lock` against the last successful build. |
 | `rn_stop` | Kill all managed React Native processes. |
-| `rn_reload` | Trigger a JS bundle reload via `DevSettings.reload()` on the running app. |
 
 ### Target & Simulator
 
 | Tool | Description |
 |---|---|
-| `rn_target_status` | Report current target (device vs simulator), WDA base URL, simulator session status. |
-| `rn_wda_start` | Build + launch WebDriverAgent on a booted iOS Simulator. Idempotent. Real-device users don't need this. |
-| `rn_wda_stop` | Stop the simulator WDA session. Idempotent. |
-| `rn_boot_simulator` | Boot a simulator (defaults to newest available iPhone runtime). |
-| `rn_wait_for_device` | Wait for a real iOS device to appear over USB (event-driven via usbmuxd, no timeout). |
+| `rn_target_status` | Report which iOS target (device vs simulator) is currently selected, the resolved WDA base URL, and whether a simulator WDA session is running. |
+| `rn_wda_start` | Build + launch WebDriverAgent against a booted iOS simulator (requires the optional `appium-webdriveragent` dep). Captures the WDA port and routes every subsequent `screen_*` / `app_*` / `rn_test_*` tool to the simulator automatically. Idempotent — re-calling returns the existing session. Real-device users don't need this tool. |
+| `rn_wda_stop` | Stop the simulator WDA session started by `rn_wda_start`. Idempotent. Real-device WDA is unaffected. |
 
 ### Screen Interaction
 
 | Tool | Description |
 |---|---|
-| `screen_tap` | Tap at coordinates with automatic pixel-ratio correction. |
-| `screen_find_and_tap` | Find by text, accessibility label, or type, then tap. |
-| `screen_swipe` | Swipe up / down / left / right. |
-| `screen_scroll_to` | Repeatedly swipe until an element appears. |
-| `screen_long_press` | Long-press a matched element. |
-| `screen_type` | Send text to the focused element. |
-| `screen_clear_text` | Focus a field and clear it. |
-| `screen_press_key` | Press `home`, `volumeUp`, `volumeDown`, or `lock`. |
-| `screen_screenshot` | Base64 PNG screenshot. |
-| `screen_get_source` | WDA accessibility tree as JSON. |
-| `screen_wait_for` | Poll the source tree until an element appears or disappears. |
-| `screen_assert_visible` | One-shot visibility check (`invert: true` for assert-not-visible). |
+| `screen_tap` | Tap at coordinates with automatic pixel ratio correction. Screenshot coordinates are divided by the device pixel ratio (2x/3x) so taps land where you expect. |
+| `screen_tap_and_verify` | Find an element by text/label/type, tap its center, and optionally assert a follow-up selector is visible — resolved against one accessibility snapshot in a single W3C action. The reliable way to tap: no coordinate guessing. |
+| `screen_tap_chain` | Tap a sequence of elements as one W3C action, all resolved against a single snapshot (zero gestures sent if any query fails). |
+| `screen_type_into_field` | Focus an input (by text/label/type) and type into it in one W3C action. Set `clearFirst: true` to clear the field before typing. |
+| `screen_swipe` | Swipe up/down/left/right. Defaults to a 60%-of-axis swipe from screen center. |
+| `screen_scroll_to` | Repeatedly swipe until a matching element appears in the accessibility tree (no tap). |
+| `screen_long_press` | Long-press a matched element for a configurable duration. |
+| `screen_press_key` | Press a hardware/system button: `home`, `volumeUp`, `volumeDown`, `lock`. |
+| `screen_open_url` | Open a URL / deep link (e.g. `myapp://product/42`) to jump straight to a screen — useful for testing your app's deep-link routes. |
+| `screen_screenshot` | Capture a screenshot of the current screen. Returns a viewable image block. |
+| `screen_wait_for` | Poll the source tree until an element appears (or disappears). Pass `timeoutMs: 0` for a one-shot visible / not-visible check. |
 
 ### App Lifecycle & Device
 
 | Tool | Description |
 |---|---|
-| `app_launch` | Launch by bundle ID (`xcrun devicectl`, falls back to `idb` / `simctl`). |
-| `app_terminate` | Terminate by bundle ID. |
-| `app_activate` | Foreground an app via WDA without a cold restart. |
-| `app_list_installed` | List installed apps (cached 30s). |
-| `app_active` | Foreground app's bundleId, pid, and name. |
-| `device_ensure_awake` | Wake + unlock prompt. |
-| `device_lock_state` | `unlocked` / `locked` / `screen-off` / `unknown`. |
-| `device_set_orientation` | Portrait or landscape. |
+| `app_launch` | Launch an app by bundle ID. Uses `xcrun devicectl` (Xcode 15+) on a real device, falls back to `idb`, then `simctl`. Terminates any existing instance first. |
+| `app_terminate` | Terminate an app by bundle ID. |
+| `app_activate` | Bring an app to foreground via WDA without a cold restart. |
+| `app_list_installed` | List installed apps on the connected device (cached 30s). |
+| `app_active` | Report the foreground app's bundleId, pid, and name. |
+| `rn_reset_state` | Reset the running app's persisted state — `AsyncStorage.clear` plus any registered cleanup hooks — without a rebuild. Requires `installCeraph` active in the app; dev-only (no-ops in production). |
+| `rn_reload` | Reload the app's JS bundle, wait for it to come back, then capture a screenshot. Requires `installCeraph` active in the app; dev-only. |
+| `device_ensure_awake` | Ensure the device is awake and unlocked. Returns structured remediation when locked. |
+| `device_set_orientation` | Set portrait or landscape. |
+
+### Autonomous Flows
+
+Server-planned tools that ask Ceraph which flows are relevant, then execute each one locally against the connected iOS device. These three require sign-in (`npx @ceraph/react-native-mcp@latest init` — the token is shared with your Ceraph account) and an active Pro subscription; non-Pro callers get a clear upgrade message pointing to the pricing page.
+
+| Tool | Use when |
+|---|---|
+| `rn_list_flows` | You want to preview which flows your working-tree diff (or specific files via `filePaths`) affects, without executing. Each row carries a `flowId` — the handle you pass to `rn_test_flows`. The order rows are returned in isn't significant; pass the `flowId`s you want. `totalCount` is the true matched count — rows are only ever clipped past a high bound, flagged with `truncated: true` plus a hint. The first step for "test my changes". |
+| `rn_find_flows` | You want to find flows app-wide by describing them in natural language ("user logs in") — not scoped to a diff. Returns candidate flows with their `flowId`s; each match's `reason` carries the relevance. |
+| `rn_test_flows` | You have one or more `flowId`s (from `rn_list_flows` / `rn_find_flows`) and want to execute exactly those flows — pass every preview `flowId` for comprehensive verification, batching across calls above the ~10-flowId-per-call cap. Related flows run in one device session. Returns screenshots of the moments that matter — errors, server failures, and the steps your change touches — as viewable `image` blocks, plus any runtime errors. Auth-gated app flows are handled with no credentials from you — Ceraph provisions the managed test users they require automatically. |
+
+#### Example: test your uncommitted edits
+
+```jsonc
+// 1. Preview the affected flows
+{
+  "name": "rn_list_flows",
+  "arguments": { "base": "main" }
+}
+// → { "flows": [ { "flowId": "login.home.a1b2c3", "name": "Login", ... } ], ... }
+
+// 2. Execute the selection (all rows = comprehensive verification)
+{
+  "name": "rn_test_flows",
+  "arguments": { "flowIds": ["login.home.a1b2c3"] }
+}
+
+// Result shape (JSON summary block)
+{
+  "runId": "run_01HX...",
+  "status": "planned",
+  "results": [
+    {
+      "flow": "Login",
+      "flowId": "login.home.a1b2c3",
+      "success": true,
+      "totalDurationMs": 8421,
+      "steps": [ /* per-step success + status, no base64 */ ],
+      "runtimeErrors": []
+    }
+  ]
+}
+```
+
+Each result entry carries the same shape produced by the underlying flow runner — per-step `success`, status, and any new runtime errors that surfaced during that step's window. The captured screenshots do **not** ride inside this JSON: they come back as separate viewable `image` content blocks (the base64 is stripped out of the summary text to save tokens). Execution stops at the first failed flow and `failedAt` is the index of the flow that broke; surviving flows are not run. When the server has nothing to plan (clean tree, unknown file, missing flow), the result is `{ status: "no-flows", results: [], hint: "..." }`.
+
+#### Testing a pull request
+
+There is no dedicated PR tool — a PR is just a diff against a base branch, which `rn_list_flows({ base })` already expresses. Compose Ceraph with a GitHub MCP server (or the `gh` CLI) instead:
+
+1. **Check out the PR** — `gh pr checkout <N>` (or the GitHub MCP equivalent). This puts the PR's code in your working tree; note its base branch.
+2. **Rebuild and relaunch** — `rn_build_ios`, then `rn_start`, so the device runs the PR's code. Ceraph drives the *running app*, not source on disk: a JS-only change may hot-reload, but a native or dependency change needs a real rebuild before the run reflects the PR.
+3. **Preview, then run** — `rn_list_flows({ base: "<pr-target-branch>" })` lists the flows the PR's changes affect; `rn_test_flows({ flowIds })` runs them (pass every id for full PR coverage, or a subset).
+4. **Report back (optional)** — post the pass/fail summary as a PR comment through the GitHub MCP.
+
+### Test users
+
+Auth-gated flows are provisioned **automatically** — when `rn_test_flows` hits a login wall, Ceraph mints a managed test user against your auth provider (Clerk / Auth0 / Supabase / Firebase / Cognito) for that run, with no credentials from you. The tools below are for **on-demand** test users — when you want to provision or inspect one yourself (Pro tier):
+
+| Tool | Description |
+|---|---|
+| `ceraph_test_data_provision` | Mint a managed test user on demand. Returns email + password (+ a session token when the provider exposes one); 24-hour TTL; optional `tag` to label it. |
+| `ceraph_test_data_list` | List active on-demand test users for the project (excludes the one-run users auto-provisioned during a flow). |
+| `ceraph_test_data_cleanup` | Delete on-demand test users by `id`, or `all: true` to wipe them. |
+
+## Camera testing
+
+iOS blocks external processes from injecting camera frames, so Ceraph ships a `__DEV__`-gated shim that returns a pre-configured image instead. It's a subpath import of this package, so testing camera-heavy RN flows takes two lines of code.
+
+### Installation
+
+Nothing extra. The shim ships in the same package — it is exposed via the `@ceraph/react-native-mcp/shim` subpath. `react`, `react-native`, and `expo-camera` are optional peer dependencies; bring whichever versions your app already uses.
+
+### Setup
+
+**1. Drop test images into `.ceraph/camera-images/`** in your repo root, one file per scenario, with descriptive lowercase filenames. The filename without the extension IS the `imageKey` you reference in code:
+
+```
+.ceraph/camera-images/profile.jpg       → imageKey="profile"
+.ceraph/camera-images/id-card.png       → imageKey="id-card"
+.ceraph/camera-images/product.jpg       → imageKey="product"
+```
+
+Supported extensions: `.jpg`, `.jpeg`, `.png`, `.webp`, `.heic`. On collision the order above is the priority. These images are committed to your repo by default so test runs are reproducible across machines and CI.
+
+**2. Generate the static registry.** Call the MCP tool `rn_sync_camera_registry` — it scans `.ceraph/camera-images/` and writes `_registry.ts` next to your images with one `require()` per file (Metro requires statically analysable paths, hence the codegen step). `ceraph_doctor` also runs this automatically, so you usually never have to call it by hand.
+
+**3. Apply the registry at app boot, gated behind `__DEV__`:**
+
+```tsx
+// App.tsx
+import { applyCameraImageRegistry } from "./.ceraph/camera-images/_registry";
+
+if (__DEV__) {
+  applyCameraImageRegistry();
+}
+```
+
+You no longer call `configureTestImage` by hand — the generated registry handles it. The 1-arg `configureTestImage(require(...))` form still works for back-compat, but the recommended workflow is the codegen above.
+
+**4. Replace `<CameraView>` with `<CeraphCamera>` and set `imageKey` per screen:**
+
+```tsx
+import { CeraphCamera } from "@ceraph/react-native-mcp/shim";
+
+export function ScanProfileScreen() {
+  return (
+    <CeraphCamera
+      imageKey="profile"
+      style={{ flex: 1 }}
+      facing="front"
+      ref={cameraRef}
+    />
+  );
+}
+```
+
+The `imageKey` prop selects which image the shim returns when the shutter is triggered. The AI tool consuming the MCP picks the right key per screen at code-write time, based on what that camera screen captures conceptually (face → `"profile"`, ID document → `"id-card"`, etc.). `<CeraphCamera>` takes the same prop shape as `expo-camera`'s `CameraView` and forwards every other prop verbatim. In production builds, `__DEV__` is `false`, `applyCameraImageRegistry` is dead-stripped, the `imageKey` prop is a no-op, and `<CeraphCamera>` lazily requires `expo-camera` and renders the real `<CameraView>` — zero overhead.
+
+### Adding test images via MCP
+
+Typical loop: the dev pastes an image into chat and says "use this for the handwriting screen." The AI assistant calls `ceraph_add_camera_image` to write the bytes into `.ceraph/camera-images/` and regenerate `_registry.ts` in one step — no manual `cp`, no follow-up call to `rn_sync_camera_registry`.
+
+```jsonc
+// Tool call
+{
+  "name": "ceraph_add_camera_image",
+  "arguments": {
+    "imageKey": "handwriting-sample",
+    "imageBase64": "iVBORw0KGgoAAAANSUhEUgAA...",
+    "contentType": "image/png"   // optional hint
+  }
+}
+
+// Result shape
+{
+  "written": ".ceraph/camera-images/handwriting-sample.png",
+  "registry": ".ceraph/camera-images/_registry.ts",
+  "registered": ["handwriting-sample", "id-card", "profile"],
+  "detectedContentType": "image/png",
+  "detectedExt": "png",
+  "replaced": false,
+  "bytes": 48213,
+  "registryState": "written",
+  "warnings": []
+}
+```
+
+Errors return `{ error, message, remediation }` with `isError: true` — e.g. an existing imageKey without `overwrite: true`, a payload over the 5 MB cap, or a stem that doesn't match the `[a-z0-9]+(?:-[a-z0-9]+)*` convention (same rule documented in [Setup](#setup) — the stem IS the `imageKey`).
+
+Notes:
+
+- The declared `contentType` is a hint only. The extension is chosen from magic-byte detection of JPEG/PNG/WebP/HEIC; on mismatch the tool writes using the detected type and surfaces a `content-type-mismatch` warning.
+- `imageKey` and `subDir` are validated against a strict lowercase-hyphen regex (no `..`, no slashes, no NUL), and the resolved path is re-checked to stay under `.ceraph/camera-images/` — path traversal is blocked by construction.
+- `overwrite: true` is required to replace an existing imageKey; if the new extension differs (e.g. `profile.jpg` → `profile.png`), the stale sibling is removed and reported as `removedSiblingPath`.
+- `data:image/...;base64,...` URI prefixes are accepted and stripped automatically.
+
+### Resolution order at runtime
+
+When `<CeraphCamera>` renders in dev/test mode, the active test image is chosen in this order:
 
-## Why both MCPs?
+1. If the component received an `imageKey` prop, that key is selected.
+2. Otherwise, the key previously selected via `selectTestImageKey` is used.
+3. Otherwise, the `"default"` key is used (only when something registered it).
+4. Otherwise, the shim falls through to the real `<CameraView>`.
 
-`mobile-mcp` handles low-level device interaction (screenshots, swipe, app lifecycle).
+### Production safety
 
-`@ceraph/react-native-mcp` adds the development workflow layer: structured error capture, console monitoring, pixel-ratio-corrected taps, prebuild detection, and simulator lifecycle. Both talk to WebDriverAgent independently — they don't depend on each other, they complement each other.
+- `__DEV__` is `false` in any production build, so `configureTestImage` is never called and the shim always falls through to the real camera.
+- The configured test image is referenced inside the `__DEV__` branch only — Metro tree-shakes the `require` out of the production bundle, so the image is never shipped to end users.
+- `expo-camera` is imported lazily via `require()` inside the production branch. Apps that do not yet use `expo-camera` can still install the shim without a missing-module error.
 
 ## License
 

package/dist/babel-plugin/index.cjs

@@ -0,0 +1 @@
+'use strict';const _0x21f2ef=_0x4906;(function(_0x5b2516,_0x552fd5){const _0x5e2d8b=_0x4906,_0x26527b=_0x5b2516();while(!![]){try{const _0x166e35=parseInt(_0x5e2d8b(0x204))/0x1*(parseInt(_0x5e2d8b(0x20b))/0x2)+-parseInt(_0x5e2d8b(0x1f7))/0x3+parseInt(_0x5e2d8b(0x1ef))/0x4*(-parseInt(_0x5e2d8b(0x20f))/0x5)+parseInt(_0x5e2d8b(0x1ff))/0x6+-parseInt(_0x5e2d8b(0x218))/0x7+-parseInt(_0x5e2d8b(0x1f5))/0x8*(parseInt(_0x5e2d8b(0x1fd))/0x9)+parseInt(_0x5e2d8b(0x201))/0xa;if(_0x166e35===_0x552fd5)break;else _0x26527b['push'](_0x26527b['shift']());}catch(_0x29fdf5){_0x26527b['push'](_0x26527b['shift']());}}}(_0x59ce,0xc82a3));var __defProp=Object['defineProperty'],__getOwnPropDesc=Object['getOwnPropertyDescriptor'],__getOwnPropNames=Object['getOwnPropertyNames'],__hasOwnProp=Object['prototype'][_0x21f2ef(0x1e9)],__export=(_0x1b2d97,_0x2c33d2)=>{for(var _0x4851f9 in _0x2c33d2)__defProp(_0x1b2d97,_0x4851f9,{'get':_0x2c33d2[_0x4851f9],'enumerable':!![]});},__copyProps=(_0x1f8637,_0x9277c,_0x35b760,_0x44b3bd)=>{const _0x1a5beb=_0x21f2ef;if(_0x9277c&&typeof _0x9277c===_0x1a5beb(0x216)||typeof _0x9277c===_0x1a5beb(0x1f2)){for(let _0x1c7567 of __getOwnPropNames(_0x9277c))if(!__hasOwnProp[_0x1a5beb(0x1eb)](_0x1f8637,_0x1c7567)&&_0x1c7567!==_0x35b760)__defProp(_0x1f8637,_0x1c7567,{'get':()=>_0x9277c[_0x1c7567],'enumerable':!(_0x44b3bd=__getOwnPropDesc(_0x9277c,_0x1c7567))||_0x44b3bd[_0x1a5beb(0x1f1)]});}return _0x1f8637;},__toCommonJS=_0x448aa8=>__copyProps(__defProp({},'__esModule',{'value':!![]}),_0x448aa8),babel_plugin_exports={};__export(babel_plugin_exports,{'default':()=>ceraphTestIdPlugin}),module[_0x21f2ef(0x200)]=__toCommonJS(babel_plugin_exports);var CERAPH_TESTID_PREFIX=_0x21f2ef(0x203);function normalizeRelPath(_0x1d6c1f){const _0x3def1b=_0x21f2ef;return _0x1d6c1f['replace'](/\\/g,'/')[_0x3def1b(0x1e7)](/^\.\//,'')['replace'](/^\/+/,'');}function slug(_0x3607d1){const _0x1b8d8a=_0x21f2ef,_0x1adca6=_0x3607d1[_0x1b8d8a(0x1e7)](/\.[jt]sx?$/i,''),_0x12aea3=_0x1adca6['toLowerCase']()['replace'](/[^a-z0-9]+/g,'-')['replace'](/-+/g,'-')[_0x1b8d8a(0x1e7)](/^-+|-+$/g,'');return _0x12aea3['length']>0x28?_0x12aea3[_0x1b8d8a(0x1ed)](_0x12aea3[_0x1b8d8a(0x1f3)]-0x28)[_0x1b8d8a(0x1e7)](/^-+/,''):_0x12aea3;}function fnv1a64Hex(_0x49cf15){const _0x50f366=_0x21f2ef;let _0x4f2b91=0xcbf29ce484222325n;const _0x5e65c1=0x100000001b3n,_0x20b9c7=0xffffffffffffffffn;for(let _0x462f41=0x0;_0x462f41<_0x49cf15[_0x50f366(0x1f3)];_0x462f41++){_0x4f2b91^=BigInt(_0x49cf15['charCodeAt'](_0x462f41)),_0x4f2b91=_0x4f2b91*_0x5e65c1&_0x20b9c7;}return _0x4f2b91['toString'](0x10)[_0x50f366(0x1e3)](0x10,'0');}function deriveTestId(_0x4d2c68){const _0x14b3f0=_0x21f2ef,_0x43f433=normalizeRelPath(_0x4d2c68['relPath']),_0x3ca73a=_0x43f433+'|'+_0x4d2c68[_0x14b3f0(0x206)]+'|'+_0x4d2c68[_0x14b3f0(0x1f6)]+'|'+(_0x4d2c68[_0x14b3f0(0x1f8)]??''),_0x552f81=fnv1a64Hex(_0x3ca73a)['slice'](0x0,0xa);return''+CERAPH_TESTID_PREFIX+slug(_0x43f433)+'_'+_0x4d2c68[_0x14b3f0(0x206)]+'_'+_0x4d2c68[_0x14b3f0(0x1f6)]+'_'+_0x552f81;}var INTERACTIVE_TAGS=new Set([_0x21f2ef(0x209),_0x21f2ef(0x1fe),'TouchableHighlight','TouchableWithoutFeedback',_0x21f2ef(0x214),_0x21f2ef(0x1f4),_0x21f2ef(0x1fb),'IconButton','MenuItem',_0x21f2ef(0x1f0),'Chip']),INPUT_TAGS=new Set(['TextInput','TextField',_0x21f2ef(0x20a),'Picker',_0x21f2ef(0x1f9),_0x21f2ef(0x20c),'SegmentedControl','SearchBar']),PRESS_PROPS=new Set(['onPress','onPressIn','onLongPress','onClick']),INPUT_PROPS=new Set(['onChangeText','onValueChange','onChange']);function baseTag(_0x815ba0){return _0x815ba0['split']('.')[0x0];}function _0x4906(_0x27ed9b,_0x41ff15){_0x27ed9b=_0x27ed9b-0x1e2;const _0x59ce4e=_0x59ce();let _0x4906d2=_0x59ce4e[_0x27ed9b];return _0x4906d2;}function _0x59ce(){const _0x2ec0c3=['isJSXMemberExpression','25895nCPeLy','env','column','file','namespace','TouchableNativeFeedback','unshift','object','sep','10986549zWceKj','NODE_ENV','padStart','split','has','testID','replace','push','hasOwnProperty','start','call','attributes','slice','isJSXAttribute','340wpFjTs','ListItem','enumerable','function','length','Button','8mdSeOc','col','2007636NGLfDP','tag','Slider','loc','Link','name','134163UIhRZO','TouchableOpacity','7762398gWElfZ','exports','14262200EAISuY','filename','cer_','41777wjRViV','opts','line','enabled','property','Pressable','Switch','38PxUITV','Checkbox','ceraph-testid-injector'];_0x59ce=function(){return _0x2ec0c3;};return _0x59ce();}function isTargetableJsx(_0x4492b2,_0x1c0059){const _0x4300fc=_0x21f2ef,_0x261e51=baseTag(_0x4492b2);if(INTERACTIVE_TAGS[_0x4300fc(0x1e5)](_0x4492b2)||INTERACTIVE_TAGS['has'](_0x261e51)||INPUT_TAGS[_0x4300fc(0x1e5)](_0x4492b2)||INPUT_TAGS['has'](_0x261e51))return!![];for(const _0x140184 of _0x1c0059){if(PRESS_PROPS[_0x4300fc(0x1e5)](_0x140184)||INPUT_PROPS[_0x4300fc(0x1e5)](_0x140184))return!![];}return![];}var import_node_path=require('path');function jsxTagName(_0x4eed95,_0x1c1631){const _0x4f21b8=_0x21f2ef;if(_0x1c1631['isJSXIdentifier'](_0x4eed95))return _0x4eed95[_0x4f21b8(0x1fc)];if(_0x1c1631[_0x4f21b8(0x20e)](_0x4eed95)){const _0x269421=[];let _0x298a88=_0x4eed95;while(_0x1c1631['isJSXMemberExpression'](_0x298a88)){_0x269421['unshift'](_0x298a88[_0x4f21b8(0x208)][_0x4f21b8(0x1fc)]),_0x298a88=_0x298a88[_0x4f21b8(0x216)];}if(_0x1c1631['isJSXIdentifier'](_0x298a88))_0x269421[_0x4f21b8(0x215)](_0x298a88[_0x4f21b8(0x1fc)]);return _0x269421['join']('.');}if(_0x1c1631['isJSXNamespacedName'](_0x4eed95))return _0x4eed95[_0x4f21b8(0x213)][_0x4f21b8(0x1fc)]+':'+_0x4eed95[_0x4f21b8(0x1fc)]['name'];return'';}function attrName(_0x25658f,_0x3cf082){const _0x592f5b=_0x21f2ef;return _0x3cf082['isJSXIdentifier'](_0x25658f['name'])?_0x25658f[_0x592f5b(0x1fc)][_0x592f5b(0x1fc)]:void 0x0;}function attrNames(_0x4f7d83,_0x5cd44b){const _0x2c548b=_0x21f2ef,_0x1c5401=[];for(const _0x483c21 of _0x4f7d83['attributes']){if(_0x5cd44b[_0x2c548b(0x1ee)](_0x483c21)){const _0x5a4f89=attrName(_0x483c21,_0x5cd44b);if(_0x5a4f89)_0x1c5401[_0x2c548b(0x1e8)](_0x5a4f89);}}return _0x1c5401;}function hasTestId(_0x31257d){const _0x3d5255=_0x21f2ef;return _0x31257d['includes'](_0x3d5255(0x1e6));}function toRelPath(_0x3d6ac7,_0x2c19db){const _0x56330d=_0x21f2ef,_0x88ed96=_0x3d6ac7??'',_0xc7f6d2=_0x88ed96?(0x0,import_node_path['relative'])(_0x88ed96,_0x2c19db):_0x2c19db;return import_node_path[_0x56330d(0x217)]==='/'?_0xc7f6d2:_0xc7f6d2[_0x56330d(0x1e4)](import_node_path['sep'])['join'](import_node_path['posix'][_0x56330d(0x217)]);}function defaultEnabled(){const _0x3ba803=_0x21f2ef,_0x28271e=globalThis['process']?.[_0x3ba803(0x210)];return _0x28271e?.[_0x3ba803(0x1e2)]!=='production';}function ceraphTestIdPlugin(_0x425062,_0x300af5={}){const _0x42372f=_0x21f2ef,_0x3c7664=_0x425062['types'],_0x4b4d5c=_0x300af5[_0x42372f(0x207)]??defaultEnabled();return{'name':_0x42372f(0x20d),'visitor':{'JSXOpeningElement'(_0x1b3be3,_0x2003df){const _0x437728=_0x42372f;if(!_0x4b4d5c)return;const _0x145895=_0x1b3be3['node'],_0x15a4f5=_0x145895[_0x437728(0x1fa)];if(!_0x15a4f5)return;const _0x372d5a=_0x2003df[_0x437728(0x212)][_0x437728(0x205)][_0x437728(0x202)];if(!_0x372d5a)return;const _0x46d4bb=jsxTagName(_0x145895['name'],_0x3c7664),_0x40e2fb=attrNames(_0x145895,_0x3c7664);if(hasTestId(_0x40e2fb))return;if(!isTargetableJsx(_0x46d4bb,_0x40e2fb))return;const _0x5458a9=toRelPath(_0x2003df[_0x437728(0x212)]['opts']['root']??null,_0x372d5a),_0x29cfae=deriveTestId({'relPath':_0x5458a9,'line':_0x15a4f5['start'][_0x437728(0x206)],'col':_0x15a4f5[_0x437728(0x1ea)][_0x437728(0x211)]+0x1,'tag':_0x46d4bb});_0x145895[_0x437728(0x1ec)]['unshift'](_0x3c7664['jsxAttribute'](_0x3c7664['jsxIdentifier']('testID'),_0x3c7664['stringLiteral'](_0x29cfae)));}}};}

package/dist/babel-plugin/index.js

@@ -0,0 +1 @@
+const _0x20ecbd=_0x57cf;(function(_0x58d4d1,_0x100f73){const _0x5ae4c7=_0x57cf,_0x482b8f=_0x58d4d1();while(!![]){try{const _0x1b0909=-parseInt(_0x5ae4c7(0x133))/0x1+-parseInt(_0x5ae4c7(0x11a))/0x2+parseInt(_0x5ae4c7(0x137))/0x3+parseInt(_0x5ae4c7(0x115))/0x4*(parseInt(_0x5ae4c7(0x113))/0x5)+-parseInt(_0x5ae4c7(0x142))/0x6+parseInt(_0x5ae4c7(0x12d))/0x7*(parseInt(_0x5ae4c7(0x13a))/0x8)+-parseInt(_0x5ae4c7(0x13f))/0x9*(parseInt(_0x5ae4c7(0x11c))/0xa);if(_0x1b0909===_0x100f73)break;else _0x482b8f['push'](_0x482b8f['shift']());}catch(_0x4af8b1){_0x482b8f['push'](_0x482b8f['shift']());}}}(_0x45cd,0xdd4cc));var CERAPH_TESTID_PREFIX='cer_';function normalizeRelPath(_0x591053){const _0x4c2032=_0x57cf;return _0x591053['replace'](/\\/g,'/')['replace'](/^\.\//,'')[_0x4c2032(0x141)](/^\/+/,'');}function slug(_0x412217){const _0x4c46a4=_0x57cf,_0xf05090=_0x412217[_0x4c46a4(0x141)](/\.[jt]sx?$/i,''),_0x535b71=_0xf05090[_0x4c46a4(0x130)]()[_0x4c46a4(0x141)](/[^a-z0-9]+/g,'-')[_0x4c46a4(0x141)](/-+/g,'-')['replace'](/^-+|-+$/g,'');return _0x535b71['length']>0x28?_0x535b71['slice'](_0x535b71['length']-0x28)['replace'](/^-+/,''):_0x535b71;}function fnv1a64Hex(_0x65a5de){const _0x58598a=_0x57cf;let _0x13ecdb=0xcbf29ce484222325n;const _0x510bbf=0x100000001b3n,_0x19125e=0xffffffffffffffffn;for(let _0x368b81=0x0;_0x368b81<_0x65a5de[_0x58598a(0x126)];_0x368b81++){_0x13ecdb^=BigInt(_0x65a5de[_0x58598a(0x112)](_0x368b81)),_0x13ecdb=_0x13ecdb*_0x510bbf&_0x19125e;}return _0x13ecdb[_0x58598a(0x12b)](0x10)['padStart'](0x10,'0');}function deriveTestId(_0x4a8c41){const _0x142077=_0x57cf,_0x50a983=normalizeRelPath(_0x4a8c41['relPath']),_0x3467e9=_0x50a983+'|'+_0x4a8c41['line']+'|'+_0x4a8c41[_0x142077(0x125)]+'|'+(_0x4a8c41[_0x142077(0x123)]??''),_0x9bace7=fnv1a64Hex(_0x3467e9)['slice'](0x0,0xa);return''+CERAPH_TESTID_PREFIX+slug(_0x50a983)+'_'+_0x4a8c41['line']+'_'+_0x4a8c41[_0x142077(0x125)]+'_'+_0x9bace7;}var INTERACTIVE_TAGS=new Set(['Pressable',_0x20ecbd(0x116),_0x20ecbd(0x13d),'TouchableWithoutFeedback',_0x20ecbd(0x13b),'Button','Link',_0x20ecbd(0x119),_0x20ecbd(0x127),_0x20ecbd(0x124),'Chip']),INPUT_TAGS=new Set(['TextInput',_0x20ecbd(0x121),'Switch','Picker','Slider','Checkbox',_0x20ecbd(0x12c),'SearchBar']),PRESS_PROPS=new Set([_0x20ecbd(0x144),_0x20ecbd(0x11d),_0x20ecbd(0x114),_0x20ecbd(0x131)]),INPUT_PROPS=new Set([_0x20ecbd(0x140),_0x20ecbd(0x110),'onChange']);function baseTag(_0x3402c1){const _0x577ce7=_0x20ecbd;return _0x3402c1[_0x577ce7(0x128)]('.')[0x0];}function isTargetableJsx(_0x50be75,_0x61e4e7){const _0xa5a4ad=_0x20ecbd,_0x497df3=baseTag(_0x50be75);if(INTERACTIVE_TAGS[_0xa5a4ad(0x12a)](_0x50be75)||INTERACTIVE_TAGS['has'](_0x497df3)||INPUT_TAGS[_0xa5a4ad(0x12a)](_0x50be75)||INPUT_TAGS[_0xa5a4ad(0x12a)](_0x497df3))return!![];for(const _0x2d36ee of _0x61e4e7){if(PRESS_PROPS[_0xa5a4ad(0x12a)](_0x2d36ee)||INPUT_PROPS[_0xa5a4ad(0x12a)](_0x2d36ee))return!![];}return![];}import{posix,relative,sep}from'path';function jsxTagName(_0x2f22f0,_0x3c9cc4){const _0x3da31f=_0x20ecbd;if(_0x3c9cc4['isJSXIdentifier'](_0x2f22f0))return _0x2f22f0[_0x3da31f(0x135)];if(_0x3c9cc4[_0x3da31f(0x13e)](_0x2f22f0)){const _0x2948ad=[];let _0x302206=_0x2f22f0;while(_0x3c9cc4['isJSXMemberExpression'](_0x302206)){_0x2948ad[_0x3da31f(0x118)](_0x302206['property']['name']),_0x302206=_0x302206['object'];}if(_0x3c9cc4['isJSXIdentifier'](_0x302206))_0x2948ad['unshift'](_0x302206['name']);return _0x2948ad['join']('.');}if(_0x3c9cc4[_0x3da31f(0x139)](_0x2f22f0))return _0x2f22f0[_0x3da31f(0x11b)]['name']+':'+_0x2f22f0['name'][_0x3da31f(0x135)];return'';}function attrName(_0x33ca7d,_0x33b513){const _0x302411=_0x20ecbd;return _0x33b513[_0x302411(0x13c)](_0x33ca7d[_0x302411(0x135)])?_0x33ca7d['name']['name']:void 0x0;}function attrNames(_0x32b27d,_0x480f03){const _0x567b71=_0x20ecbd,_0x32ddfa=[];for(const _0x30c394 of _0x32b27d['attributes']){if(_0x567b71(0x129)!=='Cinml'){if(_0x480f03['isJSXAttribute'](_0x30c394)){const _0x170a09=attrName(_0x30c394,_0x480f03);if(_0x170a09)_0x32ddfa['push'](_0x170a09);}}else{const _0x8dba6c=[];for(const _0x366806 of _0x21d7e2['attributes']){if(_0x15e480[_0x567b71(0x12f)](_0x366806)){const _0x1af027=_0xd6fc94(_0x366806,_0x553278);if(_0x1af027)_0x8dba6c[_0x567b71(0x120)](_0x1af027);}}return _0x8dba6c;}}return _0x32ddfa;}function hasTestId(_0x5a9b05){return _0x5a9b05['includes']('testID');}function toRelPath(_0x2e313c,_0x588d72){const _0x1d3488=_0x20ecbd,_0x3af1d2=_0x2e313c??'',_0x33c012=_0x3af1d2?relative(_0x3af1d2,_0x588d72):_0x588d72;return sep==='/'?_0x33c012:_0x33c012[_0x1d3488(0x128)](sep)[_0x1d3488(0x136)](posix[_0x1d3488(0x111)]);}function _0x57cf(_0x1ba854,_0x2e3cf){_0x1ba854=_0x1ba854-0x10f;const _0x45cd08=_0x45cd();let _0x57cf4b=_0x45cd08[_0x1ba854];return _0x57cf4b;}function defaultEnabled(){const _0xc7a9f0=_0x20ecbd,_0x242457=globalThis[_0xc7a9f0(0x122)]?.['env'];return _0x242457?.['NODE_ENV']!==_0xc7a9f0(0x132);}function _0x45cd(){const _0x1cb0f9=['toLowerCase','onClick','production','1106456VeTTua','jsxAttribute','name','join','4697955vtTOED','start','isJSXNamespacedName','8728pABMYS','TouchableNativeFeedback','isJSXIdentifier','TouchableHighlight','isJSXMemberExpression','3983076PDLsbV','onChangeText','replace','10462344VbTsmX','loc','onPress','testID','filename','onValueChange','sep','charCodeAt','590FHuEsU','onLongPress','60776KqAfwZ','TouchableOpacity','jsxIdentifier','unshift','IconButton','1459276wWjUsC','namespace','10QaFasf','onPressIn','file','ceraph-testid-injector','push','TextField','process','tag','ListItem','col','length','MenuItem','split','igClQ','has','toString','SegmentedControl','10073jdbbbN','column','isJSXAttribute'];_0x45cd=function(){return _0x1cb0f9;};return _0x45cd();}function ceraphTestIdPlugin(_0xa92e70,_0x44b4ff={}){const _0x506e0a=_0x20ecbd,_0x16ec2f=_0xa92e70['types'],_0x3e138c=_0x44b4ff['enabled']??defaultEnabled();return{'name':_0x506e0a(0x11f),'visitor':{'JSXOpeningElement'(_0x1f6aae,_0x4ec0a5){const _0x592d0e=_0x506e0a;if(!_0x3e138c)return;const _0x32dfdf=_0x1f6aae['node'],_0x4c3c46=_0x32dfdf[_0x592d0e(0x143)];if(!_0x4c3c46)return;const _0x34b816=_0x4ec0a5[_0x592d0e(0x11e)]['opts'][_0x592d0e(0x10f)];if(!_0x34b816)return;const _0x36ab19=jsxTagName(_0x32dfdf['name'],_0x16ec2f),_0x3cb592=attrNames(_0x32dfdf,_0x16ec2f);if(hasTestId(_0x3cb592))return;if(!isTargetableJsx(_0x36ab19,_0x3cb592))return;const _0x3a342b=toRelPath(_0x4ec0a5['file']['opts']['root']??null,_0x34b816),_0x38f103=deriveTestId({'relPath':_0x3a342b,'line':_0x4c3c46[_0x592d0e(0x138)]['line'],'col':_0x4c3c46[_0x592d0e(0x138)][_0x592d0e(0x12e)]+0x1,'tag':_0x36ab19});_0x32dfdf['attributes'][_0x592d0e(0x118)](_0x16ec2f[_0x592d0e(0x134)](_0x16ec2f[_0x592d0e(0x117)](_0x592d0e(0x145)),_0x16ec2f['stringLiteral'](_0x38f103)));}}};}export{ceraphTestIdPlugin as default};

package/dist/cli.d.ts

@@ -1,2 +1,4 @@
 #!/usr/bin/env node
-export {};
+declare function parseTierFlag(args: readonly string[]): "pro" | "starter" | undefined;
+
+export { parseTierFlag };