@ceraph/react-native-mcp 0.2.1 → 0.3.1

package/dist/wda-simulator.d.ts

@@ -0,0 +1,28 @@
+import { type ChildProcess } from "node:child_process";
+export interface WdaSimulatorSession {
+    port: number;
+    udid: string;
+    projectPath: string;
+    process: ChildProcess;
+    output: string[];
+    stop: () => Promise<void>;
+}
+export interface LaunchOpts {
+    udid: string;
+    projectDir?: string;
+    derivedDataPath?: string;
+    startupTimeoutMs?: number;
+    onChildSpawned?: (child: ChildProcess) => void;
+}
+export type LaunchResult = {
+    ok: true;
+    session: WdaSimulatorSession;
+} | {
+    ok: false;
+    reason: LaunchFailureReason;
+    error: string;
+    output?: string[];
+};
+export type LaunchFailureReason = "wda-package-missing" | "xcodebuild-missing" | "xcodebuild-spawn-failed" | "port-not-detected" | "xcodebuild-exited-early";
+export declare function resolveWdaProjectPath(projectDir?: string): string | null;
+export declare function launchSimulatorWda(opts: LaunchOpts): Promise<LaunchResult>;

package/dist/wda-simulator.js

@@ -0,0 +1,257 @@
+import { spawn } from "node:child_process";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+import { parseWdaPort } from "./target.js";
+export function resolveWdaProjectPath(projectDir) {
+    const tryResolve = (anchor) => {
+        try {
+            const require = createRequire(anchor);
+            const pkgJson = require.resolve("appium-webdriveragent/package.json");
+            const pkgDir = dirname(pkgJson);
+            return join(pkgDir, "WebDriverAgent.xcodeproj");
+        }
+        catch {
+            return null;
+        }
+    };
+    if (projectDir) {
+        const fromConsumer = tryResolve(new URL("package.json", `file://${projectDir.endsWith("/") ? projectDir : projectDir + "/"}`));
+        if (fromConsumer)
+            return fromConsumer;
+    }
+    return tryResolve(import.meta.url);
+}
+export async function launchSimulatorWda(opts) {
+    const project = resolveWdaProjectPath(opts.projectDir);
+    if (!project) {
+        return {
+            ok: false,
+            reason: "wda-package-missing",
+            error: "Simulator WDA requires the `appium-webdriveragent` package, " +
+                "but it isn't installed. Run `npm i -D appium-webdriveragent` " +
+                "(or `pnpm add -D appium-webdriveragent`) in your project, then " +
+                "call `rn_wda_start` again. This is an optional dep — device-" +
+                "only setups don't need it.",
+        };
+    }
+    const xcb = await commandExists("xcodebuild");
+    if (!xcb) {
+        return {
+            ok: false,
+            reason: "xcodebuild-missing",
+            error: "`xcodebuild` not found on PATH. Install Xcode (full app, not " +
+                "just Command Line Tools) and accept the license: " +
+                "`sudo xcodebuild -license accept`.",
+        };
+    }
+    const args = [
+        "test-without-building",
+        "-project",
+        project,
+        "-scheme",
+        "WebDriverAgentRunner",
+        "-destination",
+        `platform=iOS Simulator,id=${opts.udid}`,
+    ];
+    if (opts.derivedDataPath) {
+        args.push("-derivedDataPath", opts.derivedDataPath);
+    }
+    args.push("-quiet");
+    let child;
+    try {
+        child = spawn("xcodebuild", args, {
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+    }
+    catch (err) {
+        return {
+            ok: false,
+            reason: "xcodebuild-spawn-failed",
+            error: `Failed to spawn xcodebuild: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    try {
+        opts.onChildSpawned?.(child);
+    }
+    catch (err) {
+        try {
+            child.kill("SIGTERM");
+        }
+        catch {
+        }
+        return {
+            ok: false,
+            reason: "xcodebuild-spawn-failed",
+            error: `onChildSpawned callback threw: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    const output = [];
+    const pushLine = (chunk) => {
+        for (const line of chunk.split("\n")) {
+            if (!line.trim())
+                continue;
+            output.push(line);
+            if (output.length > 200)
+                output.shift();
+        }
+    };
+    let captured = null;
+    const checkPort = (chunk) => {
+        if (captured !== null)
+            return;
+        const port = parseWdaPort(output.join("\n") + "\n" + chunk);
+        if (port !== null)
+            captured = port;
+    };
+    child.stdout?.on("data", (d) => {
+        const text = d.toString();
+        pushLine(text);
+        checkPort(text);
+    });
+    child.stderr?.on("data", (d) => {
+        const text = d.toString();
+        pushLine(text);
+        checkPort(text);
+    });
+    let exited = false;
+    let exitCode = null;
+    child.on("exit", (code) => {
+        exited = true;
+        exitCode = code;
+    });
+    const startupTimeoutMs = opts.startupTimeoutMs ?? 120_000;
+    const pollIntervalMs = 250;
+    const start = Date.now();
+    while (Date.now() - start < startupTimeoutMs) {
+        if (captured !== null)
+            break;
+        if (exited)
+            break;
+        await new Promise((r) => setTimeout(r, pollIntervalMs));
+    }
+    if (captured !== null && !exited) {
+        const port = captured;
+        return {
+            ok: true,
+            session: buildSession({ port, udid: opts.udid, projectPath: project, child, output }),
+        };
+    }
+    if (captured !== null && exited) {
+        return {
+            ok: false,
+            reason: "xcodebuild-exited-early",
+            error: `xcodebuild printed the WDA port marker but then exited with ` +
+                `code ${exitCode} before the session could be handed off. ` +
+                "This usually means the test target crashed during boot " +
+                "(check the simulator logs) or the simulator was shut down " +
+                "mid-build. Last 20 lines of xcodebuild output below.",
+            output: output.slice(-20),
+        };
+    }
+    try {
+        child.kill("SIGTERM");
+    }
+    catch {
+    }
+    if (exited) {
+        return {
+            ok: false,
+            reason: "xcodebuild-exited-early",
+            error: `xcodebuild exited with code ${exitCode} before WDA reported a port. ` +
+                "Most common cause: WebDriverAgentRunner has no code-signing " +
+                "identity selected. Open the project in Xcode once " +
+                `(\`open "${project}"\`), set a Development Team on the ` +
+                "WebDriverAgentRunner target, build it manually for the simulator, " +
+                "then retry `rn_wda_start`. Last 20 lines of xcodebuild output " +
+                "below.",
+            output: output.slice(-20),
+        };
+    }
+    return {
+        ok: false,
+        reason: "port-not-detected",
+        error: `xcodebuild ran for ${startupTimeoutMs}ms without printing the ` +
+            "WDA `ServerURLHere->...<-ServerURLHere` marker. The first build " +
+            "after installing `appium-webdriveragent` is usually the culprit " +
+            "— it can take 90+ seconds AND may surface an Xcode signing " +
+            "prompt. Open the project in Xcode " +
+            `(\`open "${project}"\`), set a Development Team on the ` +
+            "WebDriverAgentRunner target, build it once, then retry. Last 20 " +
+            "lines of xcodebuild output below.",
+        output: output.slice(-20),
+    };
+}
+function buildSession(args) {
+    let stopped = false;
+    const stop = async () => {
+        if (stopped)
+            return;
+        stopped = true;
+        if (args.child.exitCode !== null)
+            return;
+        try {
+            args.child.kill("SIGTERM");
+        }
+        catch {
+            return;
+        }
+        await new Promise((resolve) => {
+            let resolved = false;
+            const onExit = () => {
+                if (resolved)
+                    return;
+                resolved = true;
+                resolve();
+            };
+            args.child.once("exit", onExit);
+            if (args.child.exitCode !== null) {
+                args.child.off("exit", onExit);
+                resolved = true;
+                resolve();
+                return;
+            }
+            setTimeout(() => {
+                if (resolved)
+                    return;
+                try {
+                    args.child.kill("SIGKILL");
+                }
+                catch {
+                }
+                setTimeout(() => {
+                    if (resolved)
+                        return;
+                    args.child.off("exit", onExit);
+                    resolved = true;
+                    resolve();
+                }, 2000);
+            }, 5000);
+        });
+    };
+    return {
+        port: args.port,
+        udid: args.udid,
+        projectPath: args.projectPath,
+        process: args.child,
+        output: args.output,
+        stop,
+    };
+}
+async function commandExists(cmd) {
+    return new Promise((resolve) => {
+        let child;
+        try {
+            child = spawn("which", [cmd], { stdio: ["ignore", "pipe", "pipe"] });
+        }
+        catch {
+            resolve(false);
+            return;
+        }
+        let out = "";
+        child.stdout?.on("data", (d) => {
+            out += d.toString();
+        });
+        child.on("error", () => resolve(false));
+        child.on("exit", (code) => resolve(code === 0 && out.trim().length > 0));
+    });
+}

package/package.json

@@ -1,7 +1,11 @@
 {
   "name": "@ceraph/react-native-mcp",
-  "version": "0.2.1",
+  "version": "0.3.1",
   "description": "MCP server for React Native and Expo development workflow",
+  "homepage": "https://ceraph.dev",
+  "bugs": {
+    "url": "https://x.com/intent/post?text=%40FounderIke%20"
+  },
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -12,23 +16,52 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./shim": {
+      "types": "./dist/shim/index.d.ts",
+      "import": "./dist/shim/index.js",
+      "react-native": "./dist/shim/index.js"
     }
   },
   "files": [
     "dist",
-    "README.md"
+    "assets",
+    "README.md",
+    "LICENSE"
   ],
   "scripts": {
-    "build": "tsc",
-    "typecheck": "tsc --noEmit",
+    "build": "tsc && tsc -p tsconfig.shim.json",
+    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.shim.json",
     "test": "vitest run --passWithNoTests"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
+    "plist": "^3.1.1",
+    "ts-morph": "^25",
     "zod": "^3.25.0"
   },
+  "optionalDependencies": {
+    "keytar": "^7.9.0"
+  },
+  "peerDependencies": {
+    "expo-camera": "*",
+    "react": "*",
+    "react-native": "*"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-native": {
+      "optional": true
+    },
+    "expo-camera": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@types/node": "^22",
+    "@types/plist": "^3.0.5",
     "typescript": "^5.7",
     "vitest": "^3"
   },
@@ -38,5 +71,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "license": "MIT"
+  "license": "SEE LICENSE IN LICENSE"
 }