@ceraph/react-native-mcp 0.3.2 → 0.4.5

package/dist/signal-listener.d.ts

@@ -1,27 +0,0 @@
-import type { RNManager } from "./expo-manager.js";
-export interface SignalListenerOptions {
-    port?: number;
-    host?: string;
-}
-export interface SignalListenerStartResult {
-    ok: boolean;
-    port: number;
-    error?: string;
-    errorCode?: string;
-}
-export declare class SignalListener {
-    private rnManager;
-    private server;
-    private port;
-    private hostOverride;
-    constructor(rnManager: Pick<RNManager, "appendShimSignal">, opts?: SignalListenerOptions);
-    start(): Promise<SignalListenerStartResult>;
-    stop(): Promise<void>;
-    handleForTesting(payload: unknown): Promise<{
-        ok: boolean;
-        error?: string;
-    }>;
-    private handle;
-    private appendIfValid;
-    private readBody;
-}

package/dist/signal-listener.js

@@ -1,135 +0,0 @@
-import { createServer } from "node:http";
-const DEFAULT_PORT = 8101;
-const MAX_BODY_BYTES = 64 * 1024;
-const KNOWN_KINDS = new Set([
-    "metro-error",
-    "js-error",
-    "unhandled-rejection",
-    "network-error",
-    "network-4xx",
-]);
-const DEFAULT_HOST = "127.0.0.1";
-export class SignalListener {
-    rnManager;
-    server = null;
-    port;
-    hostOverride;
-    constructor(rnManager, opts = {}) {
-        this.rnManager = rnManager;
-        this.port = opts.port ?? DEFAULT_PORT;
-        this.hostOverride = opts.host ?? null;
-    }
-    async start() {
-        const host = this.hostOverride ?? process.env.CERAPH_SIGNAL_HOST ?? DEFAULT_HOST;
-        return new Promise((resolve) => {
-            const server = createServer((req, res) => this.handle(req, res));
-            server.once("error", (err) => {
-                resolve({
-                    ok: false,
-                    port: this.port,
-                    error: err.message ?? err.code ?? "listen failed",
-                    errorCode: err.code,
-                });
-            });
-            server.listen(this.port, host, () => {
-                this.server = server;
-                resolve({ ok: true, port: this.port });
-            });
-        });
-    }
-    async stop() {
-        const server = this.server;
-        if (!server)
-            return;
-        this.server = null;
-        await new Promise((resolve) => server.close(() => resolve()));
-    }
-    async handleForTesting(payload) {
-        return this.appendIfValid(payload);
-    }
-    async handle(req, res) {
-        if (req.method !== "POST" || req.url !== "/signal") {
-            res.statusCode = 404;
-            res.end();
-            return;
-        }
-        const body = await this.readBody(req).catch((err) => ({
-            tooLarge: false,
-            err: err,
-        }));
-        if ("err" in body) {
-            res.statusCode = 400;
-            res.end(JSON.stringify({ ok: false, error: body.err.message }));
-            return;
-        }
-        if (body.tooLarge) {
-            res.statusCode = 413;
-            res.end(JSON.stringify({ ok: false, error: "payload too large" }));
-            return;
-        }
-        let parsed;
-        try {
-            parsed = JSON.parse(body.text);
-        }
-        catch (err) {
-            res.statusCode = 400;
-            res.end(JSON.stringify({ ok: false, error: err.message }));
-            return;
-        }
-        const outcome = await this.appendIfValid(parsed);
-        if (!outcome.ok) {
-            res.statusCode = 400;
-            res.end(JSON.stringify(outcome));
-            return;
-        }
-        res.statusCode = 204;
-        res.end();
-    }
-    async appendIfValid(payload) {
-        if (!payload || typeof payload !== "object") {
-            return { ok: false, error: "payload must be an object" };
-        }
-        const p = payload;
-        if (typeof p.message !== "string" || p.message.length === 0) {
-            return { ok: false, error: "message is required" };
-        }
-        if (typeof p.kind !== "string" || !KNOWN_KINDS.has(p.kind)) {
-            return { ok: false, error: `unknown kind: ${String(p.kind)}` };
-        }
-        const timestamp = typeof p.timestampMs === "number" && Number.isFinite(p.timestampMs)
-            ? new Date(p.timestampMs).toISOString()
-            : new Date().toISOString();
-        await this.rnManager.appendShimSignal({
-            message: p.message,
-            stack: typeof p.stack === "string" ? p.stack : "",
-            timestamp,
-            kind: p.kind,
-            url: typeof p.url === "string" ? p.url : undefined,
-            status: typeof p.status === "number" ? p.status : undefined,
-            method: typeof p.method === "string" ? p.method : undefined,
-            durationMs: typeof p.durationMs === "number" ? p.durationMs : undefined,
-        });
-        return { ok: true };
-    }
-    readBody(req) {
-        return new Promise((resolve, reject) => {
-            let received = 0;
-            const chunks = [];
-            req.on("data", (chunk) => {
-                received += chunk.length;
-                if (received > MAX_BODY_BYTES) {
-                    chunks.length = 0;
-                    resolve({ text: "", tooLarge: true });
-                    req.removeAllListeners("data");
-                    req.removeAllListeners("end");
-                    req.on("data", () => undefined);
-                    req.on("end", () => undefined);
-                    return;
-                }
-                chunks.push(chunk);
-            });
-            req.on("end", () => resolve({ text: Buffer.concat(chunks).toString("utf-8"), tooLarge: false }));
-            req.on("error", reject);
-        });
-    }
-}

package/dist/simulator-boot.d.ts

@@ -1,52 +0,0 @@
-export interface BootSimulatorOpts {
-    udid?: string;
-    deviceType?: string;
-    bootTimeoutMs?: number;
-}
-export type BootSimulatorResult = {
-    udid: string;
-    deviceType: string;
-    alreadyBooted: boolean;
-    booted: true;
-    runtime: string;
-    durationMs: number;
-};
-export interface SimctlDeviceEntry {
-    udid: string;
-    name: string;
-    state: string;
-    runtime?: string;
-    isAvailable?: boolean;
-}
-export interface SimctlListResult {
-    devices: Record<string, SimctlDeviceEntry[]>;
-}
-export interface CommandResult {
-    code: number;
-    stdout: string;
-    stderr: string;
-}
-export interface BootSimulatorDeps {
-    runner: (cmd: string, args: string[], timeoutMs?: number) => Promise<CommandResult>;
-}
-export declare function runXcrun(cmd: string, args: string[], timeoutMs?: number): Promise<CommandResult>;
-export declare const defaultBootSimulatorDeps: BootSimulatorDeps;
-export declare function parseIosRuntimeVersion(runtimeKey: string): {
-    major: number;
-    minor: number;
-    label: string;
-} | null;
-export declare function pickBestSimulator(list: SimctlListResult, deviceType?: string): {
-    udid: string;
-    name: string;
-    runtimeLabel: string;
-    state: string;
-} | null;
-export declare function findSimulatorByUdid(list: SimctlListResult, udid: string): {
-    udid: string;
-    name: string;
-    runtimeLabel: string;
-    state: string;
-} | null;
-export declare function isAlreadyBootedError(stderr: string): boolean;
-export declare function bootSimulator(opts?: BootSimulatorOpts, deps?: BootSimulatorDeps): Promise<BootSimulatorResult>;

package/dist/simulator-boot.js

@@ -1,227 +0,0 @@
-import { spawn } from "node:child_process";
-export async function runXcrun(cmd, args, timeoutMs = 30_000) {
-    return new Promise((resolve) => {
-        let stdout = "";
-        let stderr = "";
-        let child;
-        try {
-            child = spawn(cmd, args, { stdio: ["ignore", "pipe", "pipe"] });
-        }
-        catch (err) {
-            resolve({
-                code: 127,
-                stdout: "",
-                stderr: err instanceof Error ? err.message : String(err),
-            });
-            return;
-        }
-        const timer = setTimeout(() => {
-            try {
-                child.kill("SIGKILL");
-            }
-            catch {
-            }
-        }, timeoutMs);
-        child.stdout?.on("data", (d) => {
-            stdout += d.toString();
-        });
-        child.stderr?.on("data", (d) => {
-            stderr += d.toString();
-        });
-        let settled = false;
-        child.on("error", (err) => {
-            if (settled)
-                return;
-            settled = true;
-            clearTimeout(timer);
-            resolve({
-                code: 127,
-                stdout,
-                stderr: stderr + (err.message ?? String(err)),
-            });
-        });
-        child.on("exit", (code) => {
-            if (settled)
-                return;
-            settled = true;
-            clearTimeout(timer);
-            resolve({ code: code ?? 1, stdout, stderr });
-        });
-    });
-}
-export const defaultBootSimulatorDeps = {
-    runner: runXcrun,
-};
-export function parseIosRuntimeVersion(runtimeKey) {
-    const lower = runtimeKey.toLowerCase();
-    if (!lower.includes("ios") && !lower.includes("iphone"))
-        return null;
-    const re = /ios[-\s]?(\d+)(?:[-.](\d+))?/i;
-    const m = re.exec(runtimeKey);
-    if (!m)
-        return null;
-    const major = Number(m[1]);
-    const minor = m[2] ? Number(m[2]) : 0;
-    if (!Number.isFinite(major))
-        return null;
-    return { major, minor, label: `iOS ${major}${m[2] ? "." + minor : ""}` };
-}
-const VARIANT_MODIFIERS = ["pro", "max", "plus", "mini", "se", "air"];
-function parseModelNumber(name) {
-    const m = /\b(\d+)\b/.exec(name);
-    if (!m)
-        return 0;
-    const n = Number(m[1]);
-    return Number.isFinite(n) ? n : 0;
-}
-function countModifiers(name) {
-    const tokens = name.toLowerCase().split(/\s+/);
-    let count = 0;
-    for (const t of tokens) {
-        if (VARIANT_MODIFIERS.includes(t))
-            count++;
-    }
-    return count;
-}
-export function pickBestSimulator(list, deviceType) {
-    const wanted = (deviceType ?? "").trim().toLowerCase();
-    const candidates = [];
-    for (const [runtimeKey, devices] of Object.entries(list.devices ?? {})) {
-        const runtime = parseIosRuntimeVersion(runtimeKey);
-        if (!runtime)
-            continue;
-        if (!Array.isArray(devices))
-            continue;
-        for (const dev of devices) {
-            if (!dev.udid || !dev.name)
-                continue;
-            if (dev.isAvailable === false)
-                continue;
-            const lowerName = dev.name.toLowerCase();
-            if (wanted && !lowerName.includes(wanted))
-                continue;
-            candidates.push({
-                udid: dev.udid,
-                name: dev.name,
-                runtimeLabel: runtime.label,
-                state: dev.state ?? "Unknown",
-                major: runtime.major,
-                minor: runtime.minor,
-                modifiers: countModifiers(dev.name),
-                modelNumber: parseModelNumber(dev.name),
-            });
-        }
-    }
-    if (candidates.length === 0)
-        return null;
-    candidates.sort((a, b) => {
-        if (b.major !== a.major)
-            return b.major - a.major;
-        if (b.minor !== a.minor)
-            return b.minor - a.minor;
-        if (a.modifiers !== b.modifiers)
-            return a.modifiers - b.modifiers;
-        if (b.modelNumber !== a.modelNumber)
-            return b.modelNumber - a.modelNumber;
-        return a.name.localeCompare(b.name);
-    });
-    const top = candidates[0];
-    return {
-        udid: top.udid,
-        name: top.name,
-        runtimeLabel: top.runtimeLabel,
-        state: top.state,
-    };
-}
-export function findSimulatorByUdid(list, udid) {
-    for (const [runtimeKey, devices] of Object.entries(list.devices ?? {})) {
-        const runtime = parseIosRuntimeVersion(runtimeKey);
-        if (!runtime)
-            continue;
-        if (!Array.isArray(devices))
-            continue;
-        for (const dev of devices) {
-            if (dev.udid !== udid)
-                continue;
-            return {
-                udid: dev.udid,
-                name: dev.name ?? udid,
-                runtimeLabel: runtime.label,
-                state: dev.state ?? "Unknown",
-            };
-        }
-    }
-    return null;
-}
-export function isAlreadyBootedError(stderr) {
-    const s = stderr.toLowerCase();
-    return (s.includes("unable to boot device in current state") &&
-        s.includes("booted"));
-}
-export async function bootSimulator(opts = {}, deps = defaultBootSimulatorDeps) {
-    const bootTimeoutMs = opts.bootTimeoutMs ?? 120_000;
-    const runner = deps.runner;
-    let chosen;
-    const listResult = await runner("xcrun", ["simctl", "list", "devices", "--json"], 15_000);
-    if (listResult.code === 127) {
-        throw new Error("`xcrun` not found on PATH. Install Xcode Command Line Tools " +
-            "(`xcode-select --install`) and try again.");
-    }
-    if (listResult.code !== 0) {
-        throw new Error(`xcrun simctl list devices failed (exit ${listResult.code}): ${listResult.stderr || listResult.stdout || "no output"}`);
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(listResult.stdout);
-    }
-    catch (err) {
-        throw new Error(`Failed to parse simctl device list as JSON: ${err instanceof Error ? err.message : String(err)}`);
-    }
-    if (opts.udid) {
-        const found = findSimulatorByUdid(parsed, opts.udid);
-        if (!found) {
-            throw new Error(`No iOS simulator with udid ${opts.udid} found in the simctl ` +
-                "listing. Run `xcrun simctl list devices` to see available udids.");
-        }
-        chosen = found;
-    }
-    else {
-        const picked = pickBestSimulator(parsed, opts.deviceType);
-        if (!picked) {
-            throw new Error(opts.deviceType
-                ? `No iOS simulators matching "${opts.deviceType}" are available. ` +
-                    "Open Xcode → Settings → Platforms → install an iOS simulator " +
-                    "runtime, or pick a different deviceType."
-                : "No iOS simulators are available on this Mac. Open Xcode → " +
-                    "Settings → Platforms → install an iOS simulator runtime.");
-        }
-        chosen = picked;
-    }
-    if (chosen.state.toLowerCase() === "booted") {
-        return {
-            udid: chosen.udid,
-            deviceType: chosen.name,
-            alreadyBooted: true,
-            booted: true,
-            runtime: chosen.runtimeLabel,
-            durationMs: 0,
-        };
-    }
-    const start = Date.now();
-    const bootResult = await runner("xcrun", ["simctl", "boot", chosen.udid], 30_000);
-    if (bootResult.code !== 0 && !isAlreadyBootedError(bootResult.stderr)) {
-        throw new Error(`Failed to boot simulator ${chosen.name} (${chosen.udid}): ${bootResult.stderr || bootResult.stdout || "no output"}`);
-    }
-    const bootstatus = await runner("xcrun", ["simctl", "bootstatus", chosen.udid, "-b"], bootTimeoutMs + 5_000);
-    if (bootstatus.code !== 0) {
-        throw new Error(`simctl bootstatus failed for ${chosen.name} (${chosen.udid}): ${bootstatus.stderr || bootstatus.stdout || "no output"}`);
-    }
-    return {
-        udid: chosen.udid,
-        deviceType: chosen.name,
-        alreadyBooted: false,
-        booted: true,
-        runtime: chosen.runtimeLabel,
-        durationMs: Date.now() - start,
-    };
-}

package/dist/target.d.ts

@@ -1,48 +0,0 @@
-export type Target = "device" | "simulator";
-export type TargetPreference = Target | "auto";
-export interface TargetInfo {
-    target: Target;
-    udid: string | null;
-    baseUrl: string;
-    wdaReady: boolean;
-    reason: "env-override-device" | "env-override-simulator" | "auto-prefer-device" | "auto-only-simulator" | "auto-no-target-found";
-}
-export interface BootedSimulator {
-    udid: string;
-    name: string;
-    runtime?: string;
-}
-export interface AppLifecycleLike {
-    getUdid(): Promise<string | null>;
-}
-export declare function preferenceFromEnv(raw: string | undefined): TargetPreference;
-export declare function listBootedSimulators(): Promise<BootedSimulator[]>;
-export declare function parseWdaPort(stdout: string): number | null;
-export declare const DEFAULT_DEVICE_WDA_BASE_URL = "http://localhost:8100";
-export declare function simulatorWdaBaseUrl(port: number): string;
-export declare class TargetResolver {
-    private apps;
-    private readPreference;
-    private cached;
-    private cachedAt;
-    private readonly cacheTtlMs;
-    private inflight;
-    private stateVersion;
-    private simulatorWdaPort;
-    private simulatorWdaUdid;
-    constructor(opts?: {
-        apps?: AppLifecycleLike;
-        readPreference?: () => TargetPreference;
-        cacheTtlMs?: number;
-    });
-    setAppLifecycle(apps: AppLifecycleLike): void;
-    setSimulatorWdaPort(port: number, udid: string): void;
-    clearSimulatorWdaPort(): void;
-    getSimulatorWdaPort(): number | null;
-    getSimulatorWdaUdid(): string | null;
-    invalidate(): void;
-    getBaseUrl(): Promise<string>;
-    getTarget(): Promise<Target>;
-    resolve(): Promise<TargetInfo>;
-    reset(): void;
-}