prompttest-mobile 1.5.1

package/dist/bin/server.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/constants/commands.d.ts

@@ -0,0 +1,125 @@
+/**
+ * @module commands
+ * @description Defines standard ADB (Android Debug Bridge) command arrays used throughout PromptTest.
+ * This centralizes all shell syntax, flags, and arguments required to control Android devices,
+ * preventing scattered string-building logic in the driver classes.
+ */
+/**
+ * A collection of constants and factory functions for constructing ADB commands.
+ * All commands are represented as string arrays compatible with child_process.spawn.
+ */
+export declare const ADB_COMMANDS: {
+    /** Command to list all attached devices and emulators. */
+    readonly DEVICES: readonly ["devices", "-l"];
+    /** Command to capture a raw PNG screenshot directly to standard output. */
+    readonly SCREENCAP: readonly ["exec-out", "screencap", "-p"];
+    /** Command to dump window manager state (used to extract screen dimensions and density). */
+    readonly FOREGROUND_APP: readonly ["shell", "dumpsys", "window"];
+    /** Command to dump activity state (used to identify the currently focused app package). */
+    readonly CURRENT_FOCUS: readonly ["shell", "dumpsys", "activity", "activities"];
+    /**
+     * Generates a command to forcefully terminate an application.
+     * @param pkg The Android package name to stop.
+     * @returns Array of ADB command arguments.
+     */
+    readonly FORCE_STOP: (pkg: string) => readonly string[];
+    /**
+     * Generates a command to clear all application data and cache.
+     * @param pkg The Android package name to clear.
+     * @returns Array of ADB command arguments.
+     */
+    readonly CLEAR_APP: (pkg: string) => readonly string[];
+    /**
+     * Generates a command to launch the main launcher activity of an app.
+     * @param pkg The Android package name to launch.
+     * @returns Array of ADB command arguments.
+     */
+    readonly LAUNCH_APP: (pkg: string) => readonly string[];
+    /** Command to dump the current UI Automator hierarchy as compressed XML to standard output. */
+    readonly UIAUTOMATOR_DUMP: readonly ["exec-out", "uiautomator", "dump", "--compressed", "/dev/tty"];
+    /**
+     * Generates a command to simulate a single tap event.
+     * @param x The X coordinate on the screen.
+     * @param y The Y coordinate on the screen.
+     * @returns Array of ADB command arguments.
+     */
+    readonly INPUT_TAP: (x: number, y: number) => readonly string[];
+    /**
+     * Generates a command to input text via the keyboard. Note: spaces and special chars must be escaped.
+     * @param escapedText The text to input, properly escaped for the Android shell.
+     * @returns Array of ADB command arguments.
+     */
+    readonly INPUT_TEXT: (escapedText: string) => readonly string[];
+    /**
+     * Generates a command to simulate a physical or logical key press (e.g., BACK=4, ENTER=66).
+     * @param keyCode The Android KeyEvent code number or name.
+     * @returns Array of ADB command arguments.
+     */
+    readonly INPUT_KEY: (keyCode: number | string) => readonly string[];
+    /**
+     * Generates a command to simulate a swipe gesture across the screen.
+     * @param x1 The starting X coordinate.
+     * @param y1 The starting Y coordinate.
+     * @param x2 The ending X coordinate.
+     * @param y2 The ending Y coordinate.
+     * @param durationMs The duration of the swipe in milliseconds (default: 300).
+     * @returns Array of ADB command arguments.
+     */
+    readonly INPUT_SWIPE: (x1: number, y1: number, x2: number, y2: number, durationMs?: number) => readonly string[];
+    /**
+     * Generates a command to extract the most recent AndroidRuntime crash logs for a package.
+     * @param pkg The Android package name (used by callers to filter the output if needed).
+     * @returns Array of ADB command arguments.
+     */
+    readonly LOGCAT_CRASH: (_pkg: string) => readonly string[];
+    /**
+     * Generates a command to clear the AndroidRuntime crash log buffer.
+     * @returns Array of ADB command arguments.
+     */
+    readonly CLEAR_CRASH_LOGS: () => readonly string[];
+    /**
+     * Generates a command to grant a runtime permission to an application.
+     * @param pkg The Android package name.
+     * @param perm The permission name (will automatically prepend 'android.permission.' if omitted).
+     * @returns Array of ADB command arguments.
+     */
+    readonly GRANT_PERMISSION: (pkg: string, perm: string) => readonly string[];
+    /**
+     * Generates a command to install an APK file on the device, replacing any existing version.
+     * @param path The path to the APK file on the host machine.
+     * @returns Array of ADB command arguments.
+     */
+    readonly INSTALL_APK: (path: string) => readonly string[];
+    /**
+     * Generates a command to completely uninstall an application from the device.
+     * @param pkg The Android package name to uninstall.
+     * @returns Array of ADB command arguments.
+     */
+    readonly UNINSTALL_APP: (pkg: string) => readonly string[];
+    /**
+     * Generates a command to trigger a specific URI intent (deep link) on the device.
+     * @param uri The deep link URI (e.g., 'myapp://settings').
+     * @returns Array of ADB command arguments.
+     */
+    readonly DEEP_LINK: (uri: string) => readonly string[];
+    /**
+     * Generates a command to restart the adbd daemon listening on TCP for wireless debugging.
+     * @param port The TCP port to listen on (default: 5555).
+     * @returns Array of ADB command arguments.
+     */
+    readonly TCPIP: (port?: number) => readonly string[];
+    /**
+     * Generates a command to connect to a device over TCP/IP.
+     * @param target The target IP and optional port (e.g., '192.168.1.100:5555').
+     * @returns Array of ADB command arguments.
+     */
+    readonly CONNECT: (target: string) => readonly string[];
+    /**
+     * Generates a command to disconnect from a specific TCP/IP device or all devices.
+     * @param target The optional target IP to disconnect from.
+     * @returns Array of ADB command arguments.
+     */
+    readonly DISCONNECT: (target?: string) => readonly string[];
+    /** Command to retrieve the device's WLAN IP address. */
+    readonly GET_WLAN_IP: readonly ["shell", "ip", "-f", "inet", "addr", "show", "wlan0"];
+};