appium-adb 14.0.2 → 14.0.4

package/build/lib/tools/system-calls.d.ts

@@ -1,326 +1,268 @@
+import { SubProcess } from 'teen_process';
+import _ from 'lodash';
+import type { ADB } from '../adb.js';
+import type { ConnectedDevicesOptions, Device, AvdLaunchOptions, Version, RootResult, ShellExecOptions, SpecialAdbExecOptions, TFullOutputOption, ExecResult } from './types.js';
+/**
+ * Retrieve full binary name for the current operating system.
+ *
+ * @param binaryName - The name of the binary
+ * @returns The binary name with appropriate extension for the current OS
+ */
+declare function _getBinaryNameForOS(binaryName: string): string;
 /**
  * Retrieve full path to the given binary.
  *
- * @this {import('../adb.js').ADB}
- * @param {string} binaryName - The name of the binary.
- * @return {Promise<string>} Full path to the given binary including current SDK root.
+ * @param binaryName - The name of the binary
+ * @returns The full path to the binary
  */
-export function getSdkBinaryPath(this: import("../adb.js").ADB, binaryName: string): Promise<string>;
+export declare function getSdkBinaryPath(this: ADB, binaryName: string): Promise<string>;
+export declare const getBinaryNameForOS: typeof _getBinaryNameForOS & _.MemoizedFunction;
 /**
  * Retrieve full path to the given binary and caches it into `binaries`
  * property of the current ADB instance.
  *
- * @this {import('../adb.js').ADB}
- * @param {string} binaryName - Simple name of a binary file.
- * @return {Promise<string>} Full path to the given binary. The method tries
- *                  to enumerate all the known locations where the binary
- *                  might be located and stops the search as soon as the first
- *                  match is found on the local file system.
- * @throws {Error} If the binary with given name is not present at any
- *                 of known locations or Android SDK is not installed on the
- *                 local file system.
+ * @param binaryName - The name of the binary
+ * @returns The full path to the binary
+ * @throws {Error} If SDK root is not set or binary cannot be found
  */
-export function getBinaryFromSdkRoot(this: import("../adb.js").ADB, binaryName: string): Promise<string>;
+export declare function getBinaryFromSdkRoot(this: ADB, binaryName: string): Promise<string>;
 /**
  * Retrieve full path to the given binary.
  * This method does not have cache.
  *
- * @param {string} binaryName - Simple name of a binary file.
- *                              e.g. 'adb', 'android'
- * @return {Promise<string>} Full path to the given binary. The method tries
- *                  to enumerate all the known locations where the binary
- *                  might be located and stops the search as soon as the first
- *                  match is found on the local file system.
- *                  e.g. '/Path/To/Android/sdk/platform-tools/adb'
- * @throws {Error} If the binary with given name is not present at any
- *                 of known locations or Android SDK is not installed on the
- *                 local file system.
+ * @param binaryName - The name of the binary
+ * @returns The full path to the binary
+ * @throws {Error} If binary cannot be found in the Android SDK
  */
-export function getAndroidBinaryPath(binaryName: string): Promise<string>;
+export declare function getAndroidBinaryPath(binaryName: string): Promise<string>;
 /**
  * Retrieve full path to a binary file using the standard system lookup tool.
  *
- * @this {import('../adb.js').ADB}
- * @param {string} binaryName - The name of the binary.
- * @return {Promise<string>} Full path to the binary received from 'which'/'where'
- *                  output.
- * @throws {Error} If lookup tool returns non-zero return code.
+ * @param binaryName - The name of the binary
+ * @returns The full path to the binary
+ * @throws {Error} If binary cannot be found in PATH
  */
-export function getBinaryFromPath(this: import("../adb.js").ADB, binaryName: string): Promise<string>;
+export declare function getBinaryFromPath(this: ADB, binaryName: string): Promise<string>;
 /**
  * Retrieve the list of devices visible to adb.
  *
- * @this {import('../adb.js').ADB}
- * @param {import('./types').ConnectedDevicesOptions} [opts={}] - Additional options mapping.
- * @return {Promise<import('./types').Device[]>} The list of devices or an empty list if
- *                          no devices are connected.
- * @throws {Error} If there was an error while listing devices.
+ * @param opts - Options for device retrieval
+ * @returns Array of connected devices
+ * @throws {Error} If adb devices command fails or returns unexpected output
  */
-export function getConnectedDevices(this: import("../adb.js").ADB, opts?: import("./types").ConnectedDevicesOptions): Promise<import("./types").Device[]>;
+export declare function getConnectedDevices(this: ADB, opts?: ConnectedDevicesOptions): Promise<Device[]>;
 /**
  * Retrieve the list of devices visible to adb within the given timeout.
  *
- * @this {import('../adb.js').ADB}
- * @param {number} timeoutMs - The maximum number of milliseconds to get at least
- *                             one list item.
- * @return {Promise<import('./types').Device[]>} The list of connected devices.
- * @throws {Error} If no connected devices can be detected within the given timeout.
+ * @param timeoutMs - Maximum time to wait for devices (default: 20000ms)
+ * @returns Array of connected devices
+ * @throws {Error} If no devices are found within the timeout period
  */
-export function getDevicesWithRetry(this: import("../adb.js").ADB, timeoutMs?: number): Promise<import("./types").Device[]>;
+export declare function getDevicesWithRetry(this: ADB, timeoutMs?: number): Promise<Device[]>;
 /**
  * Kick current connection from host/device side and make it reconnect
  *
- * @this {import('../adb.js').ADB}
- * @param {string} [target=offline] One of possible targets to reconnect:
- * offline, device or null
- * Providing `null` will cause reconnection to happen from the host side.
- *
- * @throws {Error} If either ADB version is too old and does not support this
- * command or there was a failure during reconnect.
+ * @param target - The target to reconnect (default: 'offline')
+ * @throws {Error} If reconnect command fails
  */
-export function reconnect(this: import("../adb.js").ADB, target?: string): Promise<void>;
+export declare function reconnect(this: ADB, target?: string | null): Promise<void>;
 /**
  * Restart adb server, unless _this.suppressKillServer_ property is true.
- *
- * @this {import('../adb.js').ADB}
  */
-export function restartAdb(this: import("../adb.js").ADB): Promise<void>;
+export declare function restartAdb(this: ADB): Promise<void>;
 /**
  * Kill adb server.
- * @this {import('../adb.js').ADB}
  */
-export function killServer(this: import("../adb.js").ADB): Promise<void>;
+export declare function killServer(this: ADB): Promise<void>;
+/**
+ * Reset Telnet authentication token.
+ * @see {@link http://tools.android.com/recent/emulator2516releasenotes} for more details.
+ *
+ * @returns True if token was reset successfully, false otherwise
+ */
+export declare const resetTelnetAuthToken: (() => Promise<boolean>) & _.MemoizedFunction;
 /**
  * Execute the given emulator command using _adb emu_ tool.
  *
- * @this {import('../adb.js').ADB}
- * @param {string[]} cmd - The array of rest command line parameters.
+ * @param cmd - Array of command arguments
+ * @throws {Error} If emulator is not connected or command execution fails
  */
-export function adbExecEmu(this: import("../adb.js").ADB, cmd: string[]): Promise<void>;
+export declare function adbExecEmu(this: ADB, cmd: string[]): Promise<void>;
+export declare const EXEC_OUTPUT_FORMAT: {
+    readonly STDOUT: "stdout";
+    readonly FULL: "full";
+};
 /**
  * Execute the given adb command.
  *
- * @template {import('teen_process').TeenProcessExecOptions & import('./types').ShellExecOptions & import('./types').SpecialAdbExecOptions} TExecOpts
- * @this {import('../adb.js').ADB}
- * @param {string|string[]} cmd - The array of rest command line parameters
- *                      or a single string parameter.
- * @param {TExecOpts} [opts] Additional options mapping. See
- * {@link https://github.com/appium/node-teen_process}
- * for more details.
- * You can also set the additional `exclusive` param
- * to `true` that assures no other parallel adb commands
- * are going to be executed while the current one is running
- * You can set the `outputFormat` param to `stdout` to receive just the stdout
- * output (default) or `full` to receive the stdout and stderr response from a
- * command with a zero exit code
- * @return {Promise<TExecOpts extends import('./types').TFullOutputOption ? import('teen_process').TeenProcessExecResult : string>}
- * Command's stdout or an object containing stdout and stderr.
- * @throws {Error} If the command returned non-zero exit code.
- */
-export function adbExec<TExecOpts extends import("teen_process").TeenProcessExecOptions & import("./types").ShellExecOptions & import("./types").SpecialAdbExecOptions>(this: import("../adb.js").ADB, cmd: string | string[], opts?: TExecOpts): Promise<TExecOpts extends import("./types").TFullOutputOption ? import("teen_process").TeenProcessExecResult<any> : string>;
+ * @param cmd - Command string or array of command arguments
+ * @param opts - Execution options
+ * @returns Command output (string or ExecResult depending on outputFormat)
+ * @throws {Error} If command execution fails or timeout is exceeded
+ */
+export declare function adbExec<TExecOpts extends ShellExecOptions & SpecialAdbExecOptions = ShellExecOptions & SpecialAdbExecOptions>(this: ADB, cmd: string | string[], opts?: TExecOpts): Promise<TExecOpts extends TFullOutputOption ? ExecResult : string>;
 /**
  * Execute the given command using _adb shell_ prefix.
  *
- * @this {import('../adb.js').ADB}
- * @template {import('./types').ShellExecOptions} TShellExecOpts
- * @param {string|string[]} cmd - The array of rest command line parameters or a single
- *                                      string parameter.
- * @param {TShellExecOpts} [opts] - Additional options mapping.
- * @return {Promise<TShellExecOpts extends import('./types').TFullOutputOption ? import('teen_process').TeenProcessExecResult : string>}
- * Command's stdout.
- * @throws {Error} If the command returned non-zero exit code.
+ * @param cmd - Command string or array of command arguments
+ * @param opts - Execution options
+ * @returns Command output (string or ExecResult depending on outputFormat)
+ * @throws {Error} If command execution fails
  */
-export function shell<TShellExecOpts extends import("./types").ShellExecOptions>(this: import("../adb.js").ADB, cmd: string | string[], opts?: TShellExecOpts): Promise<TShellExecOpts extends import("./types").TFullOutputOption ? import("teen_process").TeenProcessExecResult<any> : string>;
+export declare function shell<TShellExecOpts extends ShellExecOptions = ShellExecOptions>(this: ADB, cmd: string | string[], opts?: TShellExecOpts): Promise<TShellExecOpts extends TFullOutputOption ? ExecResult : string>;
 /**
+ * Create a new ADB subprocess with the given arguments
  *
- * @this {import('../adb.js').ADB}
- * @param {string[]} [args=[]]
- * @returns {import('teen_process').SubProcess}
+ * @param args - Array of command arguments (default: empty array)
+ * @returns A SubProcess instance
  */
-export function createSubProcess(this: import("../adb.js").ADB, args?: string[]): import("teen_process").SubProcess;
+export declare function createSubProcess(this: ADB, args?: string[]): SubProcess;
 /**
  * Retrieve the current adb port.
  * @todo can probably deprecate this now that the logic is just to read this.adbPort
+ * @deprecated Use this.adbPort instead
  *
- * @this {import('../adb.js').ADB}
- * @return {number} The current adb port number.
+ * @returns The ADB server port number
  */
-export function getAdbServerPort(this: import("../adb.js").ADB): number;
+export declare function getAdbServerPort(this: ADB): number;
 /**
- * Retrieve the current emulator port from _adb devives_ output.
+ * Retrieve the current emulator port from _adb devices_ output.
  *
- * @this {import('../adb.js').ADB}
- * @return {Promise<number>} The current emulator port.
- * @throws {Error} If there are no connected devices.
+ * @returns The emulator port number
+ * @throws {Error} If no devices are connected or emulator port cannot be found
  */
-export function getEmulatorPort(this: import("../adb.js").ADB): Promise<number>;
+export declare function getEmulatorPort(this: ADB): Promise<number>;
 /**
  * Retrieve the current emulator port by parsing emulator name string.
  *
- * @this {import('../adb.js').ADB}
- * @param {string} emStr - Emulator name string.
- * @return {number|false} Either the current emulator port or
- * _false_ if port number cannot be parsed.
+ * @param emStr - The emulator string (e.g., 'emulator-5554')
+ * @returns The port number if found, false otherwise
  */
-export function getPortFromEmulatorString(this: import("../adb.js").ADB, emStr: string): number | false;
+export declare function getPortFromEmulatorString(this: ADB, emStr: string): number | false;
 /**
  * Retrieve the list of currently connected emulators.
  *
- * @this {import('../adb.js').ADB}
- * @param {import('./types').ConnectedDevicesOptions} [opts={}] - Additional options mapping.
- * @return {Promise<import('./types').Device[]>} The list of connected devices.
+ * @param opts - Options for device retrieval
+ * @returns Array of connected emulator devices
+ * @throws {Error} If error occurs while getting emulators
  */
-export function getConnectedEmulators(this: import("../adb.js").ADB, opts?: import("./types").ConnectedDevicesOptions): Promise<import("./types").Device[]>;
+export declare function getConnectedEmulators(this: ADB, opts?: ConnectedDevicesOptions): Promise<Device[]>;
 /**
  * Set _emulatorPort_ property of the current class.
  *
- * @this {import('../adb.js').ADB}
- * @param {number} emPort - The emulator port to be set.
- */
-export function setEmulatorPort(this: import("../adb.js").ADB, emPort: number): void;
-export class setEmulatorPort {
-    /**
-     * Set _emulatorPort_ property of the current class.
-     *
-     * @this {import('../adb.js').ADB}
-     * @param {number} emPort - The emulator port to be set.
-     */
-    constructor(this: import("../adb.js").ADB, emPort: number);
-    emulatorPort: number;
-}
+ * @param emPort - The emulator port number
+ */
+export declare function setEmulatorPort(this: ADB, emPort: number): void;
 /**
  * Set the identifier of the current device (_this.curDeviceId_).
  *
- * @this {import('../adb.js').ADB}
- * @param {string} deviceId - The device identifier.
+ * @param deviceId - The device identifier
  */
-export function setDeviceId(this: import("../adb.js").ADB, deviceId: string): void;
-export class setDeviceId {
-    /**
-     * Set the identifier of the current device (_this.curDeviceId_).
-     *
-     * @this {import('../adb.js').ADB}
-     * @param {string} deviceId - The device identifier.
-     */
-    constructor(this: import("../adb.js").ADB, deviceId: string);
-    curDeviceId: string;
-}
+export declare function setDeviceId(this: ADB, deviceId: string): void;
 /**
- * Set the the current device object.
+ * Set the current device object.
  *
- * @this {import('../adb.js').ADB}
- * @param {import('./types').Device} deviceObj - The device object to be set.
+ * @param deviceObj - The device object containing udid and other properties
  */
-export function setDevice(this: import("../adb.js").ADB, deviceObj: import("./types").Device): void;
+export declare function setDevice(this: ADB, deviceObj: Device): void;
 /**
  * Get the object for the currently running emulator.
  * !!! This method has a side effect - it implicitly changes the
  * `deviceId` (only if AVD with a matching name is found)
  * and `emulatorPort` instance properties.
  *
- * @this {import('../adb.js').ADB}
- * @param {string} avdName - Emulator name.
- * @return {Promise<import('./types').Device|null>} Currently running emulator or _null_.
+ * @param avdName - The name of the AVD to find
+ * @returns The device object if found, null otherwise
+ * @throws {Error} If error occurs while getting AVD
  */
-export function getRunningAVD(this: import("../adb.js").ADB, avdName: string): Promise<import("./types").Device | null>;
+export declare function getRunningAVD(this: ADB, avdName: string): Promise<Device | null>;
 /**
- * Get the object for the currently running emulator.
+ * Get the object for the currently running emulator with retry.
  *
- * @this {import('../adb.js').ADB}
- * @param {string} avdName - Emulator name.
- * @param {number} [timeoutMs=20000] - The maximum number of milliseconds
- *                                     to wait until at least one running AVD object
- *                                     is detected.
- * @return {Promise<import('./types').Device|null>} Currently running emulator or _null_.
- * @throws {Error} If no device has been detected within the timeout.
+ * @param avdName - The name of the AVD to find
+ * @param timeoutMs - Maximum time to wait (default: 20000ms)
+ * @returns The device object if found, null otherwise
+ * @throws {Error} If error occurs while getting AVD with retry
  */
-export function getRunningAVDWithRetry(this: import("../adb.js").ADB, avdName: string, timeoutMs?: number): Promise<import("./types").Device | null>;
+export declare function getRunningAVDWithRetry(this: ADB, avdName: string, timeoutMs?: number): Promise<Device | null>;
 /**
  * Shutdown all running emulators by killing their processes.
  *
- * @this {import('../adb.js').ADB}
- * @throws {Error} If killing tool returned non-zero return code.
+ * @throws {Error} If error occurs while killing emulators
  */
-export function killAllEmulators(this: import("../adb.js").ADB): Promise<void>;
+export declare function killAllEmulators(this: ADB): Promise<void>;
 /**
  * Kill emulator with the given name. No error
- * is thrown is given avd does not exist/is not running.
+ * is thrown if given avd does not exist/is not running.
  *
- * @this {import('../adb.js').ADB}
- * @param {string?} [avdName=null] - The name of the emulator to be killed. If empty,
- *                            the current emulator will be killed.
- * @param {number} [timeout=60000] - The amount of time to wait before throwing
- *                                    an exception about unsuccessful killing
- * @return {Promise<boolean>} - True if the emulator was killed, false otherwise.
- * @throws {Error} if there was a failure by killing the emulator
+ * @param avdName - The name of the AVD to kill (null to kill current AVD)
+ * @param timeout - Maximum time to wait for emulator to be killed (default: 60000ms)
+ * @returns True if emulator was killed, false if it was not running
+ * @throws {Error} If emulator is still running after timeout
  */
-export function killEmulator(this: import("../adb.js").ADB, avdName?: string | null, timeout?: number): Promise<boolean>;
+export declare function killEmulator(this: ADB, avdName?: string | null, timeout?: number): Promise<boolean>;
 /**
  * Start an emulator with given parameters and wait until it is fully started.
  *
- * @this {import('../adb.js').ADB}
- * @param {string} avdName - The name of an existing emulator.
- * @param {import('./types').AvdLaunchOptions} [opts={}]
- * @returns {Promise<SubProcess>} Emulator subprocess instance
- * @throws {Error} If the emulator fails to start within the given timeout.
+ * @param avdName - The name of the AVD to launch
+ * @param opts - Launch options
+ * @returns The SubProcess instance for the launched emulator
+ * @throws {Error} If emulator fails to launch or boot
  */
-export function launchAVD(this: import("../adb.js").ADB, avdName: string, opts?: import("./types").AvdLaunchOptions): Promise<SubProcess>;
+export declare function launchAVD(this: ADB, avdName: string, opts?: AvdLaunchOptions): Promise<SubProcess>;
+/**
+ * Get the adb version. The result of this method is cached.
+ *
+ * @returns Version information object
+ * @throws {Error} If error occurs while getting adb version
+ */
+export declare const getVersion: ((this: ADB) => Promise<Version>) & _.MemoizedFunction;
 /**
  * Check if the current emulator is ready to accept further commands (booting completed).
  *
- * @this {import('../adb.js').ADB}
- * @param {number} [timeoutMs=20000] - The maximum number of milliseconds to wait.
- * @returns {Promise<void>}
- * @throws {Error} If the emulator is not ready within the given timeout.
+ * @param timeoutMs - Maximum time to wait (default: 20000ms)
+ * @throws {Error} If emulator is not ready within the timeout period
  */
-export function waitForEmulatorReady(this: import("../adb.js").ADB, timeoutMs?: number): Promise<void>;
+export declare function waitForEmulatorReady(this: ADB, timeoutMs?: number): Promise<void>;
 /**
  * Check if the current device is ready to accept further commands (booting completed).
  *
- * @this {import('../adb.js').ADB}
- * @param {number} [appDeviceReadyTimeout=30] - The maximum number of seconds to wait.
- * @throws {Error} If the device is not ready within the given timeout.
+ * @param appDeviceReadyTimeout - Timeout in seconds (default: 30)
+ * @throws {Error} If device is not ready within the timeout period
  */
-export function waitForDevice(this: import("../adb.js").ADB, appDeviceReadyTimeout?: number): Promise<void>;
+export declare function waitForDevice(this: ADB, appDeviceReadyTimeout?: number): Promise<void>;
 /**
  * Reboot the current device and wait until it is completed.
  *
- * @this {import('../adb.js').ADB}
- * @param {number} [retries=DEFAULT_ADB_REBOOT_RETRIES] - The maximum number of reboot retries.
- * @throws {Error} If the device failed to reboot and number of retries is exceeded.
+ * @param retries - Number of retry attempts (default: 90)
+ * @throws {Error} If reboot fails or device is not ready after reboot
  */
-export function reboot(this: import("../adb.js").ADB, retries?: number): Promise<void>;
+export declare function reboot(this: ADB, retries?: number): Promise<void>;
 /**
  * Switch adb server root privileges.
  *
- * @this {import('../adb.js').ADB}
- * @param {boolean} isElevated - Should we elevate to to root or unroot? (default true)
- * @return {Promise<import('./types').RootResult>}
+ * @param isElevated - True to enable root, false to disable
+ * @returns Result object indicating success and whether device was already rooted
  */
-export function changeUserPrivileges(this: import("../adb.js").ADB, isElevated: boolean): Promise<import("./types").RootResult>;
+export declare function changeUserPrivileges(this: ADB, isElevated: boolean): Promise<RootResult>;
 /**
  * Switch adb server to root mode
  *
- * @this {import('../adb.js').ADB}
- * @return {Promise<import('./types').RootResult>}
+ * @returns Result object indicating success and whether device was already rooted
  */
-export function root(this: import("../adb.js").ADB): Promise<import("./types").RootResult>;
+export declare function root(this: ADB): Promise<RootResult>;
 /**
  * Switch adb server to non-root mode.
  *
- * @this {import('../adb.js').ADB}
- * @return {Promise<import('./types').RootResult>}
+ * @returns Result object indicating success and whether device was already rooted
  */
-export function unroot(this: import("../adb.js").ADB): Promise<import("./types").RootResult>;
+export declare function unroot(this: ADB): Promise<RootResult>;
 /**
  * Checks whether the current user is root
  *
- * @this {import('../adb.js').ADB}
- * @return {Promise<boolean>} True if the user is root
- * @throws {Error} if there was an error while identifying
- * the user.
+ * @returns True if current user is root, false otherwise
  */
-export function isRoot(this: import("../adb.js").ADB): Promise<boolean>;
+export declare function isRoot(this: ADB): Promise<boolean>;
 /**
  * Installs the given certificate on a rooted real device or
  * an emulator. The emulator must be executed with `-writable-system`
@@ -330,97 +272,45 @@ export function isRoot(this: import("../adb.js").ADB): Promise<boolean>;
  * Read https://github.com/appium/appium/issues/10964
  * for more details on this topic
  *
- * @this {import('../adb.js').ADB}
- * @param {Buffer|string} cert - base64-decoded content of the actual certificate
- * represented as a string or a buffer
- * @throws {Error} If openssl tool is not available on the destination system
- * or if there was an error while installing the certificate
+ * @param cert - Certificate as Buffer or base64-encoded string
+ * @throws {Error} If certificate installation fails
  */
-export function installMitmCertificate(this: import("../adb.js").ADB, cert: Buffer | string): Promise<void>;
+export declare function installMitmCertificate(this: ADB, cert: Buffer | string): Promise<void>;
 /**
  * Verifies if the given root certificate is already installed on the device.
  *
- * @this {import('../adb.js').ADB}
- * @param {Buffer|string} cert - base64-decoded content of the actual certificate
- * represented as a string or a buffer
- * @throws {Error} If openssl tool is not available on the destination system
- * or if there was an error while checking the certificate
- * @returns {Promise<boolean>} true if the given certificate is already installed
+ * @param cert - Certificate as Buffer or base64-encoded string
+ * @returns True if certificate is installed, false otherwise
+ * @throws {Error} If certificate hash cannot be retrieved
  */
-export function isMitmCertificateInstalled(this: import("../adb.js").ADB, cert: Buffer | string): Promise<boolean>;
+export declare function isMitmCertificateInstalled(this: ADB, cert: Buffer | string): Promise<boolean>;
 /**
  * Creates chunks for the given arguments and executes them in `adb shell`.
  * This is faster than calling `adb shell` separately for each arg, however
  * there is a limit for a maximum length of a single adb command. that is why
  * we need all this complicated logic.
  *
- * @this {import('../adb.js').ADB}
- * @param {(x: string) => string[]} argTransformer A function, that receives single argument
- * from the `args` array and transforms it into a shell command. The result
- * of the function must be an array, where each item is a part of a single command.
- * The last item of the array could be ';'. If this is not a semicolon then it is going to
- * be added automatically.
- * @param {string[]} args Array of argument values to create chunks for
- * @throws {Error} If any of the chunks returns non-zero exit code after being executed
+ * @param argTransformer - Function to transform each argument into command array
+ * @param args - Array of arguments to process
+ * @throws {Error} If argument transformer returns invalid result or command execution fails
  */
-export function shellChunks(this: import("../adb.js").ADB, argTransformer: (x: string) => string[], args: string[]): Promise<void>;
+export declare function shellChunks(this: ADB, argTransformer: (x: string) => string[], args: string[]): Promise<void>;
 /**
  * Transforms the given language and country abbreviations
  * to AVD arguments array
  *
- * @param {?string} language Language name, for example 'fr'
- * @param {?string} country Country name, for example 'CA'
- * @returns {Array<string>} The generated arguments. The
- * resulting array might be empty if both arguments are empty
- */
-export function toAvdLocaleArgs(language: string | null, country: string | null): Array<string>;
-export const getBinaryNameForOS: typeof _getBinaryNameForOS & _.MemoizedFunction;
-/**
- * Reset Telnet authentication token.
- * @see {@link http://tools.android.com/recent/emulator2516releasenotes} for more details.
- *
- * @this {import('../adb.js').ADB}
- * @returns {Promise<boolean>} If token reset was successful.
+ * @param language - Language code (e.g., 'en', 'fr')
+ * @param country - Country code (e.g., 'US', 'FR')
+ * @returns Array of AVD locale arguments
  */
-export const resetTelnetAuthToken: (() => Promise<boolean>) & _.MemoizedFunction;
-/** @type {{STDOUT: 'stdout', FULL: 'full'}} */
-export const EXEC_OUTPUT_FORMAT: {
-    STDOUT: "stdout";
-    FULL: "full";
-};
-/**
- * Get the adb version. The result of this method is cached.
- *
- * @this {import('../adb.js').ADB}
- * @return {Promise<import('./types').Version>}
- * @throws {Error} If it is not possible to parse adb binary version.
- */
-export const getVersion: (() => Promise<{
-    binary: {
-        version: semver.SemVer | null;
-        build: number;
-    };
-    bridge: {
-        version: semver.SemVer | null;
-    };
-}>) & _.MemoizedFunction;
+export declare function toAvdLocaleArgs(language: string | null, country: string | null): string[];
 /**
  * Retrieves full paths to all 'build-tools' subfolders under the particular
  * SDK root folder
  *
- * @type {(sdkRoot: string) => Promise<string[]>}
+ * @param sdkRoot - The Android SDK root directory path
+ * @returns Array of build-tools directory paths (newest first)
  */
-export const getBuildToolsDirs: (sdkRoot: string) => Promise<string[]>;
-import { SubProcess } from 'teen_process';
-/**
- * Retrieve full binary name for the current operating system.
- *
- * @param {string} binaryName - simple binary name, for example 'android'.
- * @return {string} Formatted binary name depending on the current platform,
- *                  for example, 'android.bat' on Windows.
- */
-declare function _getBinaryNameForOS(binaryName: string): string;
-import _ from 'lodash';
-import * as semver from 'semver';
+export declare const getBuildToolsDirs: ((sdkRoot: string) => Promise<string[]>) & _.MemoizedFunction;
 export {};
 //# sourceMappingURL=system-calls.d.ts.map

package/build/lib/tools/system-calls.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system-calls.d.ts","sourceRoot":"","sources":["../../../lib/tools/system-calls.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"system-calls.d.ts","sourceRoot":"","sources":["../../../lib/tools/system-calls.ts"],"names":[],"mappings":"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"}