@spec app_pid(String.t(), String.t()) ::
  {:ok, String.t()} | {:error, String.t()} | :app_dead

Gets the PID of an app on an Android device.

@spec auto_detect_device() :: String.t() | nil

Auto-detects a connected Android device.

@spec available?() :: boolean()

Checks if ADB is available.

@spec battery_level(String.t()) :: {:ok, non_neg_integer()} | {:error, String.t()}

Gets the battery level from an Android device.

@spec check_app_installed(String.t(), String.t()) ::
  {:ok, String.t()} | {:error, String.t()}

Checks if an app is installed on an Android device.

@spec check_device(String.t() | nil) :: {:ok, String.t()} | {:error, String.t()}

Checks if ADB is available and a device is reachable.

Returns {:ok, serial} if a device is found, {:error, reason} otherwise.

@spec device_ok?(String.t()) :: boolean()

Checks if a device is reachable via ADB.

@spec enable_wifi_adb(String.t()) :: :ok | {:error, String.t()}

Enables WiFi ADB for a device.

@spec ensure_local_dist() :: :ok

Ensures local Erlang distribution is started.

@spec run(String.t(), [String.t()]) :: {:ok, String.t()} | {:error, String.t()}

Runs an ADB command and returns the output.

@spec run_raw(String.t(), [String.t()]) :: String.t()

Runs an ADB command and returns the raw output (including stderr).

@spec setup_tunnels(String.t()) :: :ok

Sets up ADB tunnels for device communication.

@spec wifi_ip(String.t()) :: {:ok, String.t()} | {:error, String.t()}

Gets the WiFi IP for a device.