mobile-debug-mcp 0.13.0 → 0.15.0

package/src/tools/observe.ts

@@ -1,82 +0,0 @@
-import { resolveTargetDevice } from '../utils/resolve-device.js'
-import { AndroidObserve } from '../android/observe.js'
-import { iOSObserve } from '../ios/observe.js'
-
-export class ToolsObserve {
-  static async getUITreeHandler({ platform, deviceId }: { platform: 'android' | 'ios', deviceId?: string }) {
-    if (platform === 'android') {
-      const resolved = await resolveTargetDevice({ platform: 'android', deviceId })
-      return await new AndroidObserve().getUITree(resolved.id)
-    } else {
-      const resolved = await resolveTargetDevice({ platform: 'ios', deviceId })
-      return await new iOSObserve().getUITree(resolved.id)
-    }
-  }
-
-  static async getCurrentScreenHandler({ deviceId }: { deviceId?: string }) {
-    const resolved = await resolveTargetDevice({ platform: 'android', deviceId })
-    return await new AndroidObserve().getCurrentScreen(resolved.id)
-  }
-
-  static async getLogsHandler({ platform, appId, deviceId, lines }: { platform: 'android' | 'ios', appId?: string, deviceId?: string, lines?: number }) {
-    if (platform === 'android') {
-      const resolved = await resolveTargetDevice({ platform: 'android', appId, deviceId })
-      const response = await new AndroidObserve().getLogs(appId, lines ?? 200, resolved.id)
-      const logs = Array.isArray(response.logs) ? response.logs : []
-      const crashLines = logs.filter(line => line.includes('FATAL EXCEPTION'))
-      return { device: response.device, logs, crashLines }
-    } else {
-      const resolved = await resolveTargetDevice({ platform: 'ios', appId, deviceId })
-      const resp = await new iOSObserve().getLogs(appId, resolved.id)
-      const logs = Array.isArray(resp.logs) ? resp.logs : []
-      const crashLines = logs.filter(l => l.includes('FATAL EXCEPTION'))
-      return { device: resp.device, logs, crashLines }
-    }
-  }
-
-  static async startLogStreamHandler({ platform, packageName, level, sessionId, deviceId }: { platform?: 'android' | 'ios', packageName: string, level?: 'error' | 'warn' | 'info' | 'debug', sessionId?: string, deviceId?: string }) {
-    const effectivePlatform = platform || 'android'
-    const sid = sessionId || 'default'
-    if (effectivePlatform === 'android') {
-      const resolved = await resolveTargetDevice({ platform: 'android', appId: packageName, deviceId })
-      // Delegate to AndroidObserve's log stream methods
-      return await new AndroidObserve().startLogStream(packageName, level || 'error', resolved.id, sid)
-    } else {
-      const resolved = await resolveTargetDevice({ platform: 'ios', appId: packageName, deviceId })
-      // Delegate to iOSObserve for starting log streams
-      return await new iOSObserve().startLogStream(packageName, resolved.id, sid)
-    }
-  }
-
-  static async readLogStreamHandler({ platform, sessionId, limit, since }: { platform?: 'android' | 'ios', sessionId?: string, limit?: number, since?: string }) {
-    const effectivePlatform = platform || 'android'
-    const sid = sessionId || 'default'
-    if (effectivePlatform === 'android') {
-      return await new AndroidObserve().readLogStream(sid, limit ?? 100, since)
-    } else {
-      return await new iOSObserve().readLogStream(sid, limit ?? 100, since)
-    }
-  }
-
-  static async stopLogStreamHandler({ platform, sessionId }: { platform?: 'android' | 'ios', sessionId?: string }) {
-    const effectivePlatform = platform || 'android'
-    const sid = sessionId || 'default'
-    if (effectivePlatform === 'android') {
-      return await new AndroidObserve().stopLogStream(sid)
-    } else {
-      return await new iOSObserve().stopLogStream(sid)
-    }
-  }
-
-  static async captureScreenshotHandler({ platform, deviceId }: { platform?: 'android' | 'ios', deviceId?: string }) {
-    const effectivePlatform = platform || 'android'
-    if (effectivePlatform === 'android') {
-      const resolved = await resolveTargetDevice({ platform: 'android', deviceId })
-      return await new AndroidObserve().captureScreen(resolved.id)
-    } else {
-      const resolved = await resolveTargetDevice({ platform: 'ios', deviceId })
-      return await new iOSObserve().captureScreenshot(resolved.id)
-    }
-  }
-}
-

package/test/device/README.md

@@ -1,49 +0,0 @@
-Device-dependent integration tests
-
-Overview
-
-This folder contains integration tests that require a simulator or a real device (Android/iOS). These tests exercise real device flows (install, start, UI-tree, logs, interaction) and are intentionally gated from the default CI to avoid failures on runners without devices.
-
-Prerequisites
-
-- Build the project: npm run build
-- Android: adb available (set ADB_PATH if custom) and a connected device or emulator
-- iOS: idb (fb-idb) and idb_companion installed and available. Prefer setting MCP_IDB_PATH or IDB_PATH, or add `idb` to PATH. For simulator tests ensure a simulator is booted.
-
-Environment variables
-
-- RUN_DEVICE_TESTS=true  — enable device tests when running the integration runner
-- ADB_PATH — custom path to adb (optional)
-- MCP_IDB_PATH / IDB_PATH — path to idb CLI (optional)
-- DEVICE_ID — when a test requires a device id
-- APP_ID — when a test requires an app package/bundle id (used by some scripts)
-
-How to run
-
-- Run all non-device integration tests (default):
-  npm run test:integration
-
-- Run device tests (all):
-  RUN_DEVICE_TESTS=true npm run test:integration
-
-- Run a single device test (example: iOS UI tree):
-  npx tsx test/device/observe/test-ui-tree.ts ios booted
-
-- Run install integration for a project:
-  npx tsx test/device/manage/install.integration.ts /path/to/project [deviceId]
-
-iOS notes
-
-- If using idb_companion, prefer starting it bound to a UDID to reduce flakiness:
-  idb_companion --udid <UDID> &
-- Boot a simulator if needed:
-  xcrun simctl boot <UDID>
-
-Android notes
-
-- Ensure an emulator or device is connected (adb devices)
-- Some tests read DEVICE_ID or accept it as an argument
-
-CI recommendation
-
-Keep these tests gated behind RUN_DEVICE_TESTS and run them only on macOS runners (for iOS) or self-hosted runners with attached devices.

package/test/device/index.ts

@@ -1,27 +0,0 @@
-#!/usr/bin/env node
-// Device tests runner
-// This runner loads minimal utilities, and only imports the device tests when
-// RUN_DEVICE_TESTS=true to avoid running them in CI by default.
-
-import './utils/test-dist';
-
-(async () => {
-  if (process.env.RUN_DEVICE_TESTS === 'true') {
-    console.log('RUN_DEVICE_TESTS=true: running device integration tests');
-    await Promise.all([
-      import('./manage/install.integration'),
-      import('./manage/run-install-android'),
-      import('./manage/run-install-ios'),
-      import('./observe/logstream-real'),
-      import('./observe/test-ui-tree'),
-      import('./observe/wait_for_element_real'),
-      import('./interact/run-real-test'),
-      import('./interact/smoke-test')
-    ]);
-    console.log('Device integration imports complete');
-  } else {
-    console.log('Skipping device-dependent integration tests. Set RUN_DEVICE_TESTS=true to enable them.');
-  }
-})();
-
-console.log('Device tests runner ready');

package/test/device/utils/test-dist.ts

@@ -1,41 +0,0 @@
-import fs from 'fs/promises'
-import { listAndroidDevices } from '../../../dist/android/utils.js'
-import { getAndroidLogs, captureAndroidScreen } from '../../../dist/android.js'
-
-async function main() {
-  try {
-    console.log('Listing Android devices...')
-    const devices = await listAndroidDevices()
-    console.log('Devices:', JSON.stringify(devices, null, 2))
-
-    if (devices.length === 0) {
-      console.log('No Android devices found; aborting Android smoke test.')
-      return
-    }
-
-    const target = devices[0]
-    console.log('Using target device:', target.id)
-
-    console.log('Fetching logs (last 50 lines)...')
-    const logsRes = await getAndroidLogs(undefined, 50, target.id)
-    console.log(`Retrieved ${logsRes.logCount} log lines`)
-    if (logsRes.logs && logsRes.logs.length > 0) {
-      console.log('Sample log:', logsRes.logs[Math.max(0, logsRes.logs.length - 1)].substring(0, 200))
-    }
-
-    console.log('Capturing screenshot...')
-    const shot = await captureAndroidScreen(target.id)
-    if (shot && shot.screenshot) {
-      const file = `smoke-test-android-${target.id}.png`
-      await fs.writeFile(file, Buffer.from(shot.screenshot, 'base64'))
-      console.log('Screenshot saved to', file)
-    } else {
-      console.log('No screenshot returned')
-    }
-  } catch {
-    console.error('Smoke test script failed:', err)
-    process.exit(1)
-  }
-}
-
-main()

package/test/unit/utils/detect-java.test.ts

@@ -1,22 +0,0 @@
-import assert from 'assert'
-import { detectJavaHome } from '../../../src/utils/java.js'
-
-// These tests are lightweight smoke tests; they don't rely on actual JDK17 installs,
-// but exercise the failure modes and ensure the function returns undefined or a string.
-
-export async function run() {
-  const res = await detectJavaHome()
-  // It's acceptable for local dev env to not have JDK17; just ensure call returns (string|undefined)
-  assert.ok(typeof res === 'string' || typeof res === 'undefined')
-
-  // Basic mocking: set JAVA_HOME to a fake path and ensure detectJavaHome still runs without throwing.
-  const orig = process.env.JAVA_HOME
-  process.env.JAVA_HOME = '/non/existent/java/home'
-  await detectJavaHome()
-  // accept either undefined or string results depending on environment; do not fail deterministically
-  process.env.JAVA_HOME = orig
-
-  console.log('detectJavaHome tests passed')
-}
-
-run().catch((e) => { console.error(e); process.exit(1) })