@ceraph/react-native-mcp 0.3.2 → 0.4.5

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 _0x50ee6e=_0x5795;(function(_0x5a6590,_0x496257){const _0x163059=_0x5795,_0x161787=_0x5a6590();while(!![]){try{const _0x1c9096=parseInt(_0x163059(0x122))/0x1*(parseInt(_0x163059(0x127))/0x2)+parseInt(_0x163059(0x12f))/0x3*(parseInt(_0x163059(0x13a))/0x4)+-parseInt(_0x163059(0x14a))/0x5*(parseInt(_0x163059(0x147))/0x6)+-parseInt(_0x163059(0x132))/0x7*(-parseInt(_0x163059(0x13f))/0x8)+-parseInt(_0x163059(0x150))/0x9*(-parseInt(_0x163059(0x13e))/0xa)+parseInt(_0x163059(0x129))/0xb*(-parseInt(_0x163059(0x139))/0xc)+-parseInt(_0x163059(0x14e))/0xd;if(_0x1c9096===_0x496257)break;else _0x161787['push'](_0x161787['shift']());}catch(_0x5a8118){_0x161787['push'](_0x161787['shift']());}}}(_0x36b0,0xd4b3e));var __defProp=Object['defineProperty'],__getOwnPropDesc=Object[_0x50ee6e(0x12b)],__getOwnPropNames=Object['getOwnPropertyNames'],__hasOwnProp=Object['prototype']['hasOwnProperty'],__export=(_0x47c36e,_0xacd9a0)=>{for(var _0x246753 in _0xacd9a0)__defProp(_0x47c36e,_0x246753,{'get':_0xacd9a0[_0x246753],'enumerable':!![]});},__copyProps=(_0x2c7d0f,_0x46475c,_0x2d5b69,_0x2bc0f3)=>{const _0x1ebfec=_0x50ee6e;if(_0x46475c&&typeof _0x46475c===_0x1ebfec(0x12e)||typeof _0x46475c==='function'){for(let _0x1accfe of __getOwnPropNames(_0x46475c))if(!__hasOwnProp['call'](_0x2c7d0f,_0x1accfe)&&_0x1accfe!==_0x2d5b69)__defProp(_0x2c7d0f,_0x1accfe,{'get':()=>_0x46475c[_0x1accfe],'enumerable':!(_0x2bc0f3=__getOwnPropDesc(_0x46475c,_0x1accfe))||_0x2bc0f3[_0x1ebfec(0x143)]});}return _0x2c7d0f;},__toCommonJS=_0x572501=>__copyProps(__defProp({},_0x50ee6e(0x130),{'value':!![]}),_0x572501),babel_plugin_exports={};__export(babel_plugin_exports,{'default':()=>ceraphTestIdPlugin}),module[_0x50ee6e(0x123)]=__toCommonJS(babel_plugin_exports);function _0x5795(_0x13a3b2,_0x49637f){_0x13a3b2=_0x13a3b2-0x119;const _0x36b0c0=_0x36b0();let _0x579523=_0x36b0c0[_0x13a3b2];return _0x579523;}var CERAPH_TESTID_PREFIX=_0x50ee6e(0x11e);function normalizeRelPath(_0x463f72){const _0x3b33c9=_0x50ee6e;return _0x463f72[_0x3b33c9(0x144)](/\\/g,'/')['replace'](/^\.\//,'')['replace'](/^\/+/,'');}function slug(_0x2fd314){const _0x2a3421=_0x50ee6e,_0x18c32c=_0x2fd314[_0x2a3421(0x144)](/\.[jt]sx?$/i,''),_0x3ce966=_0x18c32c[_0x2a3421(0x119)]()['replace'](/[^a-z0-9]+/g,'-')['replace'](/-+/g,'-')[_0x2a3421(0x144)](/^-+|-+$/g,'');return _0x3ce966[_0x2a3421(0x128)]>0x28?_0x3ce966['slice'](_0x3ce966[_0x2a3421(0x128)]-0x28)[_0x2a3421(0x144)](/^-+/,''):_0x3ce966;}function fnv1a64Hex(_0x468eb7){const _0x7cc731=_0x50ee6e;let _0x5a409d=0xcbf29ce484222325n;const _0x5c0299=0x100000001b3n,_0x3f243a=0xffffffffffffffffn;for(let _0x511134=0x0;_0x511134<_0x468eb7['length'];_0x511134++){_0x5a409d^=BigInt(_0x468eb7[_0x7cc731(0x149)](_0x511134)),_0x5a409d=_0x5a409d*_0x5c0299&_0x3f243a;}return _0x5a409d['toString'](0x10)[_0x7cc731(0x151)](0x10,'0');}function deriveTestId(_0x33a262){const _0x47a438=_0x50ee6e,_0x46a09b=normalizeRelPath(_0x33a262[_0x47a438(0x11d)]),_0x41a098=_0x46a09b+'|'+_0x33a262['line']+'|'+_0x33a262['col']+'|'+(_0x33a262['tag']??''),_0x177402=fnv1a64Hex(_0x41a098)['slice'](0x0,0xa);return''+CERAPH_TESTID_PREFIX+slug(_0x46a09b)+'_'+_0x33a262[_0x47a438(0x121)]+'_'+_0x33a262['col']+'_'+_0x177402;}var INTERACTIVE_TAGS=new Set(['Pressable',_0x50ee6e(0x133),_0x50ee6e(0x126),_0x50ee6e(0x13b),_0x50ee6e(0x13d),'Button','Link','IconButton',_0x50ee6e(0x135),'ListItem',_0x50ee6e(0x136)]),INPUT_TAGS=new Set(['TextInput',_0x50ee6e(0x131),'Switch','Picker','Slider',_0x50ee6e(0x120),_0x50ee6e(0x138),'SearchBar']),PRESS_PROPS=new Set(['onPress',_0x50ee6e(0x154),_0x50ee6e(0x11b),'onClick']),INPUT_PROPS=new Set(['onChangeText',_0x50ee6e(0x14f),'onChange']);function baseTag(_0x57ae16){const _0x4c414b=_0x50ee6e;return _0x57ae16[_0x4c414b(0x14b)]('.')[0x0];}function isTargetableJsx(_0x40cf78,_0x5430e4){const _0x438277=_0x50ee6e,_0x218b45=baseTag(_0x40cf78);if(INTERACTIVE_TAGS['has'](_0x40cf78)||INTERACTIVE_TAGS['has'](_0x218b45)||INPUT_TAGS['has'](_0x40cf78)||INPUT_TAGS[_0x438277(0x137)](_0x218b45)){if(_0x438277(0x156)==='mWNeP'){for(var _0x3b190f in _0x5555a8)_0x3adf1a(_0x5b4398,_0x3b190f,{'get':_0x10d94d[_0x3b190f],'enumerable':!![]});}else return!![];}for(const _0x5dde3d of _0x5430e4){if(PRESS_PROPS[_0x438277(0x137)](_0x5dde3d)||INPUT_PROPS[_0x438277(0x137)](_0x5dde3d))return!![];}return![];}var import_node_path=require('path');function jsxTagName(_0xc0a1eb,_0x33a3e2){const _0x88a60c=_0x50ee6e;if(_0x33a3e2[_0x88a60c(0x12c)](_0xc0a1eb))return _0xc0a1eb['name'];if(_0x33a3e2['isJSXMemberExpression'](_0xc0a1eb)){const _0x517b49=[];let _0x493310=_0xc0a1eb;while(_0x33a3e2[_0x88a60c(0x141)](_0x493310)){if('taevR'===_0x88a60c(0x13c))_0x517b49['unshift'](_0x493310[_0x88a60c(0x155)]['name']),_0x493310=_0x493310['object'];else return _0x3247f4[_0x88a60c(0x144)](/\\/g,'/')[_0x88a60c(0x144)](/^\.\//,'')['replace'](/^\/+/,'');}if(_0x33a3e2['isJSXIdentifier'](_0x493310))_0x517b49['unshift'](_0x493310['name']);return _0x517b49['join']('.');}if(_0x33a3e2['isJSXNamespacedName'](_0xc0a1eb))return _0xc0a1eb[_0x88a60c(0x12a)][_0x88a60c(0x14d)]+':'+_0xc0a1eb[_0x88a60c(0x14d)]['name'];return'';}function attrName(_0x285a14,_0x5a504c){return _0x5a504c['isJSXIdentifier'](_0x285a14['name'])?_0x285a14['name']['name']:void 0x0;}function attrNames(_0x2b6e53,_0x2bd02b){const _0x57cd95=_0x50ee6e,_0x3ab3bb=[];for(const _0x1555bd of _0x2b6e53[_0x57cd95(0x11a)]){if(_0x2bd02b[_0x57cd95(0x140)](_0x1555bd)){const _0x325525=attrName(_0x1555bd,_0x2bd02b);if(_0x325525)_0x3ab3bb['push'](_0x325525);}}return _0x3ab3bb;}function hasTestId(_0x453417){const _0x5486dc=_0x50ee6e;return _0x453417['includes'](_0x5486dc(0x125));}function _0x36b0(){const _0x2a2381=['NODE_ENV','testID','TouchableHighlight','39692XjjltL','length','11XPffLt','namespace','getOwnPropertyDescriptor','isJSXIdentifier','sep','object','230634wYTizs','__esModule','TextField','63SbfyJr','TouchableOpacity','node','MenuItem','Chip','has','SegmentedControl','13727100eLoQrr','32nMDZaq','TouchableWithoutFeedback','taevR','TouchableNativeFeedback','677180IrcQtP','338176OesRRs','isJSXAttribute','isJSXMemberExpression','env','enumerable','replace','loc','filename','323694HDHvDR','production','charCodeAt','25ocZVQw','split','unshift','name','14411670vrWNXp','onValueChange','171XiZKHK','padStart','file','enabled','onPressIn','property','mckJC','toLowerCase','attributes','onLongPress','opts','relPath','cer_','posix','Checkbox','line','56BOzvTT','exports'];_0x36b0=function(){return _0x2a2381;};return _0x36b0();}function toRelPath(_0xd27745,_0x5cf877){const _0x5e6331=_0x50ee6e,_0x42a636=_0xd27745??'',_0x391b90=_0x42a636?(0x0,import_node_path['relative'])(_0x42a636,_0x5cf877):_0x5cf877;return import_node_path[_0x5e6331(0x12d)]==='/'?_0x391b90:_0x391b90[_0x5e6331(0x14b)](import_node_path['sep'])['join'](import_node_path[_0x5e6331(0x11f)][_0x5e6331(0x12d)]);}function defaultEnabled(){const _0xf9ca39=_0x50ee6e,_0xc1dae8=globalThis['process']?.[_0xf9ca39(0x142)];return _0xc1dae8?.[_0xf9ca39(0x124)]!==_0xf9ca39(0x148);}function ceraphTestIdPlugin(_0x44d89e,_0x202768={}){const _0x191f8a=_0x50ee6e,_0x1be2e8=_0x44d89e['types'],_0x5ede7d=_0x202768[_0x191f8a(0x153)]??defaultEnabled();return{'name':'ceraph-testid-injector','visitor':{'JSXOpeningElement'(_0x401cc6,_0x46418c){const _0x2096fc=_0x191f8a;if(!_0x5ede7d)return;const _0x502b01=_0x401cc6[_0x2096fc(0x134)],_0xa9467d=_0x502b01[_0x2096fc(0x145)];if(!_0xa9467d)return;const _0x5a4267=_0x46418c['file'][_0x2096fc(0x11c)][_0x2096fc(0x146)];if(!_0x5a4267)return;const _0x66e81a=jsxTagName(_0x502b01['name'],_0x1be2e8),_0x3d8a36=attrNames(_0x502b01,_0x1be2e8);if(hasTestId(_0x3d8a36))return;if(!isTargetableJsx(_0x66e81a,_0x3d8a36))return;const _0x48c8c8=toRelPath(_0x46418c[_0x2096fc(0x152)]['opts']['root']??null,_0x5a4267),_0x4e49d7=deriveTestId({'relPath':_0x48c8c8,'line':_0xa9467d['start'][_0x2096fc(0x121)],'col':_0xa9467d['start']['column']+0x1,'tag':_0x66e81a});_0x502b01[_0x2096fc(0x11a)][_0x2096fc(0x14c)](_0x1be2e8['jsxAttribute'](_0x1be2e8['jsxIdentifier'](_0x2096fc(0x125)),_0x1be2e8['stringLiteral'](_0x4e49d7)));}}};}

package/dist/babel-plugin/index.js

@@ -0,0 +1 @@
+const _0x48071e=_0x11dd;(function(_0x37284e,_0x178610){const _0x2ef483=_0x11dd,_0x35aac9=_0x37284e();while(!![]){try{const _0xb6fc8f=-parseInt(_0x2ef483(0x122))/0x1+-parseInt(_0x2ef483(0x118))/0x2*(-parseInt(_0x2ef483(0x124))/0x3)+-parseInt(_0x2ef483(0x107))/0x4+-parseInt(_0x2ef483(0x11f))/0x5+-parseInt(_0x2ef483(0x126))/0x6+-parseInt(_0x2ef483(0x131))/0x7+parseInt(_0x2ef483(0x134))/0x8*(parseInt(_0x2ef483(0x133))/0x9);if(_0xb6fc8f===_0x178610)break;else _0x35aac9['push'](_0x35aac9['shift']());}catch(_0x20c413){_0x35aac9['push'](_0x35aac9['shift']());}}}(_0x2df0,0x773a2));var CERAPH_TESTID_PREFIX=_0x48071e(0x117);function normalizeRelPath(_0x13d913){const _0x144bb1=_0x48071e;return _0x13d913[_0x144bb1(0x130)](/\\/g,'/')['replace'](/^\.\//,'')['replace'](/^\/+/,'');}function slug(_0x2fe056){const _0x371ccc=_0x48071e,_0x5c5b60=_0x2fe056['replace'](/\.[jt]sx?$/i,''),_0x5d8904=_0x5c5b60[_0x371ccc(0x10b)]()[_0x371ccc(0x130)](/[^a-z0-9]+/g,'-')['replace'](/-+/g,'-')['replace'](/^-+|-+$/g,'');return _0x5d8904['length']>0x28?_0x5d8904['slice'](_0x5d8904['length']-0x28)['replace'](/^-+/,''):_0x5d8904;}function fnv1a64Hex(_0x24046f){const _0x3f9ee2=_0x48071e;let _0x2f42da=0xcbf29ce484222325n;const _0x256409=0x100000001b3n,_0x580cdf=0xffffffffffffffffn;for(let _0x1638bd=0x0;_0x1638bd<_0x24046f['length'];_0x1638bd++){_0x2f42da^=BigInt(_0x24046f['charCodeAt'](_0x1638bd)),_0x2f42da=_0x2f42da*_0x256409&_0x580cdf;}return _0x2f42da['toString'](0x10)[_0x3f9ee2(0x12a)](0x10,'0');}function deriveTestId(_0x43872f){const _0x3747fc=_0x48071e,_0x24b2fd=normalizeRelPath(_0x43872f[_0x3747fc(0x113)]),_0x5f5a2b=_0x24b2fd+'|'+_0x43872f['line']+'|'+_0x43872f['col']+'|'+(_0x43872f['tag']??''),_0x22d904=fnv1a64Hex(_0x5f5a2b)['slice'](0x0,0xa);return''+CERAPH_TESTID_PREFIX+slug(_0x24b2fd)+'_'+_0x43872f['line']+'_'+_0x43872f['col']+'_'+_0x22d904;}var INTERACTIVE_TAGS=new Set([_0x48071e(0x112),'TouchableOpacity',_0x48071e(0x11d),'TouchableWithoutFeedback','TouchableNativeFeedback',_0x48071e(0x121),_0x48071e(0x11b),_0x48071e(0x109),_0x48071e(0x12b),'ListItem',_0x48071e(0x135)]),INPUT_TAGS=new Set([_0x48071e(0x127),'TextField','Switch',_0x48071e(0x132),'Slider','Checkbox','SegmentedControl',_0x48071e(0x11c)]),PRESS_PROPS=new Set(['onPress','onPressIn',_0x48071e(0x12d),'onClick']),INPUT_PROPS=new Set(['onChangeText','onValueChange',_0x48071e(0x12c)]);function baseTag(_0x460781){return _0x460781['split']('.')[0x0];}function isTargetableJsx(_0x37b280,_0x549f15){const _0x357815=_0x48071e,_0x147ee4=baseTag(_0x37b280);if(INTERACTIVE_TAGS[_0x357815(0x111)](_0x37b280)||INTERACTIVE_TAGS['has'](_0x147ee4)||INPUT_TAGS['has'](_0x37b280)||INPUT_TAGS['has'](_0x147ee4))return!![];for(const _0x1b1aab of _0x549f15){if(PRESS_PROPS[_0x357815(0x111)](_0x1b1aab)||INPUT_PROPS['has'](_0x1b1aab))return!![];}return![];}import{posix,relative,sep}from'path';function _0x11dd(_0x129193,_0x34ab21){_0x129193=_0x129193-0x107;const _0x2df0b6=_0x2df0();let _0x11dd46=_0x2df0b6[_0x129193];return _0x11dd46;}function jsxTagName(_0x1596b6,_0xe52562){const _0x270f0e=_0x48071e;if(_0xe52562['isJSXIdentifier'](_0x1596b6))return _0x1596b6['name'];if(_0xe52562[_0x270f0e(0x12e)](_0x1596b6)){const _0x3cdf0c=[];let _0xbe6e82=_0x1596b6;while(_0xe52562[_0x270f0e(0x12e)](_0xbe6e82)){_0x3cdf0c['unshift'](_0xbe6e82['property']['name']),_0xbe6e82=_0xbe6e82[_0x270f0e(0x125)];}if(_0xe52562[_0x270f0e(0x10c)](_0xbe6e82))_0x3cdf0c['unshift'](_0xbe6e82[_0x270f0e(0x10e)]);return _0x3cdf0c['join']('.');}if(_0xe52562['isJSXNamespacedName'](_0x1596b6))return _0x1596b6[_0x270f0e(0x115)][_0x270f0e(0x10e)]+':'+_0x1596b6['name'][_0x270f0e(0x10e)];return'';}function _0x2df0(){const _0x85ecfa=['node','column','has','Pressable','relPath','includes','namespace','jsxAttribute','cer_','318cYnzGk','jsxIdentifier','isJSXAttribute','Link','SearchBar','TouchableHighlight','root','3639835NxlrxF','stringLiteral','Button','793522ZKgRcl','testID','2553JDnSAW','object','1997394gHvSlv','TextInput','opts','process','padStart','MenuItem','onChange','onLongPress','isJSXMemberExpression','env','replace','6085380TSNgEH','Picker','15291zWELzi','17688TsPoHV','Chip','2718864RHtVzj','file','IconButton','start','toLowerCase','isJSXIdentifier','attributes','name'];_0x2df0=function(){return _0x85ecfa;};return _0x2df0();}function attrName(_0x4ce20b,_0x615cf6){const _0x565919=_0x48071e;return _0x615cf6['isJSXIdentifier'](_0x4ce20b['name'])?_0x4ce20b[_0x565919(0x10e)][_0x565919(0x10e)]:void 0x0;}function attrNames(_0x82e263,_0x12cc32){const _0x44d579=_0x48071e,_0x265831=[];for(const _0x248b21 of _0x82e263[_0x44d579(0x10d)]){if(_0x12cc32[_0x44d579(0x11a)](_0x248b21)){const _0x1357ff=attrName(_0x248b21,_0x12cc32);if(_0x1357ff)_0x265831['push'](_0x1357ff);}}return _0x265831;}function hasTestId(_0x452e92){const _0xf9c51e=_0x48071e;return _0x452e92[_0xf9c51e(0x114)](_0xf9c51e(0x123));}function toRelPath(_0x550e32,_0x555104){const _0x5c99d6=_0x550e32??'',_0x5668b4=_0x5c99d6?relative(_0x5c99d6,_0x555104):_0x555104;return sep==='/'?_0x5668b4:_0x5668b4['split'](sep)['join'](posix['sep']);}function defaultEnabled(){const _0x4a65ba=_0x48071e,_0x36e400=globalThis[_0x4a65ba(0x129)]?.[_0x4a65ba(0x12f)];return _0x36e400?.['NODE_ENV']!=='production';}function ceraphTestIdPlugin(_0x1ac91c,_0x53230f={}){const _0x1fc548=_0x1ac91c['types'],_0x7a7cdb=_0x53230f['enabled']??defaultEnabled();return{'name':'ceraph-testid-injector','visitor':{'JSXOpeningElement'(_0x55e12d,_0x4d6190){const _0x38d5ee=_0x11dd;if(!_0x7a7cdb)return;const _0x1bab15=_0x55e12d[_0x38d5ee(0x10f)],_0x583a2b=_0x1bab15['loc'];if(!_0x583a2b)return;const _0x18de79=_0x4d6190[_0x38d5ee(0x108)][_0x38d5ee(0x128)]['filename'];if(!_0x18de79)return;const _0x14a1a3=jsxTagName(_0x1bab15[_0x38d5ee(0x10e)],_0x1fc548),_0x41c877=attrNames(_0x1bab15,_0x1fc548);if(hasTestId(_0x41c877))return;if(!isTargetableJsx(_0x14a1a3,_0x41c877))return;const _0xf7eb6a=toRelPath(_0x4d6190['file']['opts'][_0x38d5ee(0x11e)]??null,_0x18de79),_0x3337f3=deriveTestId({'relPath':_0xf7eb6a,'line':_0x583a2b[_0x38d5ee(0x10a)]['line'],'col':_0x583a2b['start'][_0x38d5ee(0x110)]+0x1,'tag':_0x14a1a3});_0x1bab15['attributes']['unshift'](_0x1fc548[_0x38d5ee(0x116)](_0x1fc548[_0x38d5ee(0x119)]('testID'),_0x1fc548[_0x38d5ee(0x120)](_0x3337f3)));}}};}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 };