@devicefarmer/adbkit 2.11.3 → 3.2.2

package/dist/src/adb/DeviceClient.js

@@ -0,0 +1,517 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const adbkit_monkey_1 = __importDefault(require("@devicefarmer/adbkit-monkey"));
+const adbkit_logcat_1 = __importDefault(require("@devicefarmer/adbkit-logcat"));
+const sync_1 = __importDefault(require("./sync"));
+const parser_1 = __importDefault(require("./parser"));
+const stat_1 = __importDefault(require("./proc/stat"));
+const host_1 = require("./command/host");
+const host_transport_1 = require("./command/host-transport");
+const host_serial_1 = require("./command/host-serial");
+const debug_1 = __importDefault(require("debug"));
+const bluebird_1 = __importDefault(require("bluebird"));
+const debug = (0, debug_1.default)('adb:client');
+const NoUserOptionError = (err) => err.message.indexOf('--user') !== -1;
+class DeviceClient {
+    constructor(client, serial) {
+        this.client = client;
+        this.serial = serial;
+        // no code
+    }
+    /**
+     * Gets the serial number of the device identified by the given serial number. With our API this doesn't really make much sense, but it has been implemented for completeness. _FYI: in the raw ADB protocol you can specify a device in other ways, too._
+     *
+     * @returns The serial number of the device.
+     */
+    getSerialNo() {
+        return this.connection().then((conn) => new host_serial_1.GetSerialNoCommand(conn).execute(this.serial));
+    }
+    /**
+     * Gets the device path of the device identified by the given serial number.
+     * @returns The device path. This corresponds to the device path in `client.listDevicesWithPaths()`.
+     */
+    getDevicePath() {
+        return this.connection().then((conn) => new host_serial_1.GetDevicePathCommand(conn).execute(this.serial));
+    }
+    /**
+     * Gets the state of the device identified by the given serial number.
+     *
+     * @returns The device state. This corresponds to the device type in `client.listDevices()`.
+     */
+    getState() {
+        return this.connection().then((conn) => new host_serial_1.GetStateCommand(conn).execute(this.serial));
+    }
+    /**
+     * Retrieves the properties of the device identified by the given serial number. This is analogous to `adb shell getprop`.
+     *
+     * @returns An object of device properties. Each key corresponds to a device property. Convenient for accessing things like `'ro.product.model'`.
+     */
+    getProperties() {
+        return this.transport().then((transport) => new host_transport_1.GetPropertiesCommand(transport).execute());
+    }
+    /**
+     * Retrieves the features of the device identified by the given serial number. This is analogous to `adb shell pm list features`. Useful for checking whether hardware features such as NFC are available (you'd check for `'android.hardware.nfc'`).
+     * @param [flags] Flags to pass to the `pm list packages` command to filter the list
+     * ```
+     * -d: filter to only show disabled packages
+     * -e: filter to only show enabled packages
+     * -s: filter to only show system packages
+     * -3: filter to only show third party packages
+     * ```
+     * @returns An object of device features. Each key corresponds to a device feature, with the value being either `true` for a boolean feature, or the feature value as a string (e.g. `'0x20000'` for `reqGlEsVersion`).
+     */
+    getFeatures() {
+        return this.transport().then((transport) => new host_transport_1.GetFeaturesCommand(transport).execute());
+    }
+    /**
+     * Retrieves the list of packages present on the device. This is analogous to `adb shell pm list packages`. If you just want to see if something's installed, consider using `client.isInstalled()` instead.
+     *
+     * @param flags TODO
+     * @returns An object of device features. Each key corresponds to a device feature, with the value being either `true` for a boolean feature, or the feature value as a string (e.g. `'0x20000'` for `reqGlEsVersion`)
+     */
+    getPackages(flags) {
+        return this.transport().then((transport) => new host_transport_1.GetPackagesCommand(transport).execute(flags));
+    }
+    /**
+     * Attemps to retrieve the IP address of the device. Roughly analogous to `adb shell getprop dhcp.<iface>.ipaddress`.
+     *
+     * @param [iface] The network interface. Defaults to `'wlan0'`.
+     *
+     * @returns The IP address as a `String`.
+     */
+    getDHCPIpAddress(iface = 'wlan0') {
+        return this.getProperties().then((properties) => {
+            const ip = properties[`dhcp.${iface}.ipaddress`];
+            if (ip) {
+                return ip;
+            }
+            throw Error(`Unable to find ipaddress for '${iface}'`);
+        });
+    }
+    /**
+     * Forwards socket connections from the ADB server host (local) to the device (remote). This is analogous to `adb forward <local> <remote>`. It's important to note that if you are connected to a remote ADB server, the forward will be created on that host.
+     *
+     * @param local A string representing the local endpoint on the ADB host. At time of writing, can be one of:
+     * -   `tcp:<port>`
+     * -   `localabstract:<unix domain socket name>`
+     * -   `localreserved:<unix domain socket name>`
+     * -   `localfilesystem:<unix domain socket name>`
+     * -   `dev:<character device name>`
+     * @param remote A string representing the remote endpoint on the device. At time of writing, can be one of:
+     *   Any value accepted by the `local` argument
+     *   `jdwp:<process pid>`
+     * @returns true
+     */
+    forward(local, remote) {
+        return this.connection().then((conn) => new host_serial_1.ForwardCommand(conn).execute(this.serial, local, remote));
+    }
+    /**
+     * Lists forwarded connections on the device. This is analogous to `adb forward --list`.
+     *
+     * @returns An array of forward objects with the following properties:
+     *   -   **serial** The device serial.
+     *   -   **local** The local endpoint. Same format as `client.forward()`'s `local` argument.
+     *   -   **remote** The remote endpoint on the device. Same format as `client.forward()`'s `remote` argument.
+     */
+    listForwards() {
+        return this.connection().then((conn) => new host_serial_1.ListForwardsCommand(conn).execute(this.serial));
+    }
+    /**
+     * Reverses socket connections from the device (remote) to the ADB server host (local). This is analogous to `adb reverse <remote> <local>`. It's important to note that if you are connected to a remote ADB server, the reverse will be created on that host.
+     * @param remote A string representing the remote endpoint on the device. At time of writing, can be one of:
+     * -   `tcp:<port>`
+     * -   `localabstract:<unix domain socket name>`
+     * -   `localreserved:<unix domain socket name>`
+     * -   `localfilesystem:<unix domain socket name>`
+     * @param local A string representing the local endpoint on the ADB host. At time of writing, can be any value accepted by the `remote` argument.
+     */
+    reverse(remote, local) {
+        return this.transport().then((transport) => new host_transport_1.ReverseCommand(transport).execute(remote, local));
+    }
+    /**
+     * Lists forwarded connections on the device. This is analogous to `adb reverse --list`.
+     *
+     * @returns An array of Reverse objects with the following properties:
+     *  -   **remote** The remote endpoint on the device. Same format as `client.reverse()`'s `remote` argument.
+     *  -   **local** The local endpoint on the host. Same format as `client.reverse()`'s `local` argument.
+     */
+    listReverses() {
+        return this.transport().then((transport) => new host_transport_1.ListReversesCommand(transport).execute());
+    }
+    /**
+     * return a new connection to ADB.
+     */
+    connection() {
+        return this.client.connection();
+    }
+    /**
+     * return a new connextion to the current Host devices
+     */
+    transport() {
+        return this.connection().then((conn) => new host_1.HostTransportCommand(conn).execute(this.serial).return(conn));
+    }
+    /**
+     * Runs a shell command on the device. Note that you'll be limited to the permissions of the `shell` user, which ADB uses.
+     *
+     * @param command The shell command to execute. When `String`, the command is run as-is. When `Array`, the elements will be rudimentarily escaped (for convenience, not security) and joined to form a command.
+     *
+     * @returns A readable stream (`Socket` actually) containing the progressive `stdout` of the command. Use with `adb.util.readAll` to get a readable String from it.
+     */
+    shell(command) {
+        return this.transport().then((transport) => new host_transport_1.ShellCommand(transport).execute(command));
+    }
+    /**
+     * Puts the device into root mode which may be needed by certain shell commands. A remount is generally required after a successful root call. **Note that this will only work if your device supports this feature. Production devices almost never do.**
+     *
+     * @return true
+     */
+    reboot() {
+        return this.transport().then((transport) => new host_transport_1.RebootCommand(transport).execute());
+    }
+    /**
+     * Attempts to remount the `/system` partition in read-write mode. This will usually only work on emulators and developer devices.
+     *
+     * @returns true
+     */
+    remount() {
+        return this.transport().then((transport) => new host_transport_1.RemountCommand(transport).execute());
+    }
+    /**
+     * Puts the device into root mode which may be needed by certain shell commands. A remount is generally required after a successful root call. **Note that this will only work if your device supports this feature. Production devices almost never do.**
+     *
+     * @return true
+     */
+    root() {
+        return this.transport().then((transport) => new host_transport_1.RootCommand(transport).execute());
+    }
+    /**
+     * Starts a JDWP tracker for the given device.
+     *
+     * Note that as the tracker will keep a connection open, you must call `tracker.end()` if you wish to stop tracking JDWP processes.
+     *
+     * @returns The JDWP tracker, which is an [`EventEmitter`][node-events]. The following events are available:
+     *  -   **add** **(pid)** Emitted when a new JDWP process becomes available, once per pid.
+     *  -   **remove** **(pid)** Emitted when a JDWP process becomes unavailable, once per pid.
+     *  -   **changeSet** **(changes, pids)** All changes in a single event.
+     *    -   **changes** An object with the following properties always present:
+     *      -   **added** An array of pids that were added. Empty if none.
+     *      -   **removed** An array of pids that were removed. Empty if none.
+     *    -   **pids** All currently active pids (including pids from previous runs).
+     *  -   **end** Emitted when the underlying connection ends.
+     *  -   **error** **(err)** Emitted if there's an error.
+     */
+    trackJdwp() {
+        return this.transport().then((transport) => new host_transport_1.TrackJdwpCommand(transport).execute());
+    }
+    /**
+     * Fetches the current **raw** framebuffer (i.e. what is visible on the screen) from the device, and optionally converts it into something more usable by using [GraphicsMagick][graphicsmagick]'s `gm` command, which must be available in `$PATH` if conversion is desired. Note that we don't bother supporting really old framebuffer formats such as RGB_565. If for some mysterious reason you happen to run into a `>=2.3` device that uses RGB_565, let us know.
+     *
+     * Note that high-resolution devices can have quite massive framebuffers. For example, a device with a resolution of 1920x1080 and 32 bit colors would have a roughly 8MB (`1920*1080*4` byte) RGBA framebuffer. Empirical tests point to about 5MB/s bandwidth limit for the ADB USB connection, which means that it can take ~1.6 seconds for the raw data to arrive, or even more if the USB connection is already congested. Using a conversion will further slow down completion.
+     *
+     * @param format The desired output format. Any output format supported by [GraphicsMagick][graphicsmagick] (such as `'png'`) is supported. Defaults to `'raw'` for raw framebuffer data.
+     *
+     * @returns The possibly converted framebuffer stream. The stream also has a `meta`.:
+     */
+    framebuffer(format = 'raw') {
+        return this.transport().then((transport) => new host_transport_1.FrameBufferCommand(transport).execute(format));
+    }
+    /**
+     * Takes a screenshot in PNG format using the built-in `screencap` utility. This is analogous to `adb shell screencap -p`. Sadly, the utility is not available on most Android `<=2.3` devices, but a silent fallback to the `client.framebuffer()` command in PNG mode is attempted, so you should have its dependencies installed just in case.
+     *
+     * Generating the PNG on the device naturally requires considerably more processing time on that side. However, as the data transferred over USB easily decreases by ~95%, and no conversion being required on the host, this method is usually several times faster than using the framebuffer. Naturally, this benefit does not apply if we're forced to fall back to the framebuffer.
+     *
+     * For convenience purposes, if the screencap command fails (e.g. because it doesn't exist on older Androids), we fall back to `client.framebuffer(serial, 'png')`, which is slower and has additional installation requirements.
+     *
+     * @return The PNG stream.
+     */
+    screencap() {
+        return this.transport().then((transport) => new host_transport_1.ScreencapCommand(transport).execute().catch((err) => {
+            debug(`Emulating screencap command due to '${err}'`);
+            return this.framebuffer('png');
+        }));
+    }
+    /**
+     * Opens a direct connection to a unix domain socket in the given path.
+     *
+     * @param path The path to the socket. Prefixed with `'localfilesystem:'` by default, include another prefix (e.g. `'localabstract:'`) in the path to override.
+     *
+     * @returns The connection (i.e. [`net.Socket`][node-net]). Read and write as you please. Call `conn.end()` to end the connection.
+     */
+    openLocal(path) {
+        return this.transport().then((transport) => new host_transport_1.LocalCommand(transport).execute(path));
+    }
+    /**
+     * Opens a direct connection to a binary log file, providing access to the raw log data. Note that it is usually much more convenient to use the `client.openLogcat()` method, described separately.
+     *
+     * @param name The name of the log. Available logs include `'main'`, `'system'`, `'radio'` and `'events'`.
+     *
+     * @returns The binary log stream. Call `log.end()` when you wish to stop receiving data.
+     */
+    openLog(name) {
+        return this.transport().then((transport) => new host_transport_1.LogCommand(transport).execute(name));
+    }
+    /**
+       * Opens a direct TCP connection to a port on the device, without any port forwarding required.
+  
+       * @param port The port number to connect to.
+       * @param host Optional. The host to connect to. Allegedly this is supposed to establish a connection to the given host from the device, but we have not been able to get it to work at all. Skip the host and everything works great.
+       *
+       * @returns The TCP connection (i.e. [`net.Socket`][node-net]). Read and write as you please. Call `conn.end()` to end the connection.
+       */
+    openTcp(port, host) {
+        return this.transport().then((transport) => new host_transport_1.TcpCommand(transport).execute(port, host));
+    }
+    /**
+     * Starts the built-in `monkey` utility on the device, connects to it using `client.openTcp()` and hands the connection to [adbkit-monkey][adbkit-monkey], a pure Node.js Monkey client. This allows you to create touch and key events, among other things.
+     *
+     * For more information, check out the [adbkit-monkey][adbkit-monkey] documentation.
+     *
+     * @param port Optional. The device port where you'd like Monkey to run at. Defaults to `1080`.
+     *
+     * @returns The Monkey client. Please see the [adbkit-monkey][adbkit-monkey] documentation for details.
+     */
+    openMonkey(port = 1080) {
+        const tryConnect = (times) => {
+            return this.openTcp(port)
+                .then((stream) => adbkit_monkey_1.default.connectStream(stream))
+                .catch((err) => {
+                if ((times -= 1)) {
+                    debug(`Monkey can't be reached, trying ${times} more times`);
+                    return bluebird_1.default.delay(100).then(() => tryConnect(times));
+                }
+                else {
+                    throw err;
+                }
+            });
+        };
+        return tryConnect(1).catch(() => {
+            return this.transport()
+                .then((transport) => new host_transport_1.MonkeyCommand(transport).execute(port))
+                .then((out) => tryConnect(20).then((monkey) => monkey.once('end', () => out.end())));
+        });
+    }
+    /**
+     * Calls the `logcat` utility on the device and hands off the connection to [adbkit-logcat][adbkit-logcat], a pure Node.js Logcat client. This is analogous to `adb logcat -B`, but the event stream will be parsed for you and a separate event will be emitted for every log entry, allowing for easy processing.
+     *
+     * For more information, check out the [adbkit-logcat][adbkit-logcat] documentation.
+     *
+     * @param options Optional. The following options are supported:
+     * -   **clear** When `true`, clears logcat before opening the reader. Not set by default.
+     *
+     * @returns The Logcat client. Please see the [adbkit-logcat][adbkit-logcat] documentation for details.
+     */
+    openLogcat(options = {}) {
+        return this.transport()
+            .then((transport) => new host_transport_1.LogcatCommand(transport).execute(options))
+            .then((stream) => adbkit_logcat_1.default.readStream(stream, { fixLineFeeds: false }));
+    }
+    /**
+     * Tracks `/proc/stat` and emits useful information, such as CPU load. A single sync service instance is used to download the `/proc/stat` file for processing. While doing this does consume some resources, it is very light and should not be a problem.
+     *
+     * @returns The `/proc/stat` tracker, which is an [`EventEmitter`][node-events]. Call `stat.end()` to stop tracking. The following events are available:
+     *   -   **load** **(loads)** Emitted when a CPU load calculation is available.
+     *   -   **loads** CPU loads of **online** CPUs. Each key is a CPU id (e.g. `'cpu0'`, `'cpu1'`) and the value an object with the following properties:
+     *     -   **user** Percentage (0-100) of ticks spent on user programs.
+     *     -   **nice** Percentage (0-100) of ticks spent on `nice`d user programs.
+     *     -   **system** Percentage (0-100) of ticks spent on system programs.
+     *     -   **idle** Percentage (0-100) of ticks spent idling.
+     *     -   **iowait** Percentage (0-100) of ticks spent waiting for IO.
+     *     -   **irq** Percentage (0-100) of ticks spent on hardware interrupts.
+     *     -   **softirq** Percentage (0-100) of ticks spent on software interrupts.
+     *     -   **steal** Percentage (0-100) of ticks stolen by others.
+     *     -   **guest** Percentage (0-100) of ticks spent by a guest.
+     *     -   **guestnice** Percentage (0-100) of ticks spent by a `nice`d guest.
+     *     -   **total** Total. Always 100.
+     */
+    openProcStat() {
+        return this.syncService().then((sync) => new stat_1.default(sync));
+    }
+    /**
+     * Deletes all data associated with a package from the device. This is roughly analogous to `adb shell pm clear <pkg>`.
+     *
+     * @param pkg The package name. This is NOT the APK.
+     *
+     * @returns true
+     */
+    clear(pkg) {
+        return this.transport().then((transport) => new host_transport_1.ClearCommand(transport).execute(pkg));
+    }
+    /**
+     * Installs the APK on the device, replacing any previously installed version. This is roughly analogous to `adb install -r <apk>`.
+     *
+     * Note that if the call seems to stall, you may have to accept a dialog on the phone first.
+     *
+     * @param apk When `String`, interpreted as a path to an APK file. When [`Stream`][node-stream], installs directly from the stream, which must be a valid APK.
+     * @returns true
+     */
+    install(apk) {
+        const temp = sync_1.default.temp(typeof apk === 'string' ? apk : '_stream.apk');
+        return this.push(apk, temp).then((transfer) => {
+            let endListener;
+            let errorListener;
+            return new bluebird_1.default((resolve, reject) => {
+                errorListener = (err) => reject(err);
+                endListener = () => this.installRemote(temp).then((value) => resolve(value));
+                transfer.on('error', errorListener);
+                transfer.on('end', endListener);
+            }).finally(() => {
+                transfer.removeListener('error', errorListener);
+                transfer.removeListener('end', endListener);
+            });
+        });
+    }
+    /**
+     * Installs an APK file which must already be located on the device file system, and replaces any previously installed version. Useful if you've previously pushed the file to the device for some reason (perhaps to have direct access to `client.push()`'s transfer stats). This is roughly analogous to `adb shell pm install -r <apk>` followed by `adb shell rm -f <apk>`.
+     *
+     * Note that if the call seems to stall, you may have to accept a dialog on the phone first.
+     *
+     * @param apk The path to the APK file on the device. The file will be removed when the command completes.
+     * @returns true
+     */
+    installRemote(apk) {
+        return this.transport().then((transport) => {
+            return new host_transport_1.InstallCommand(transport)
+                .execute(apk)
+                .then(() => this.shell(['rm', '-f', apk]))
+                .then((stream) => new parser_1.default(stream).readAll())
+                .then(() => true);
+        });
+    }
+    /**
+     * Uninstalls the package from the device. This is roughly analogous to `adb uninstall <pkg>`.
+     *
+     * @param pkg The package name. This is NOT the APK.
+     * @returns true
+     */
+    uninstall(pkg) {
+        return this.transport().then((transport) => new host_transport_1.UninstallCommand(transport).execute(pkg));
+    }
+    /**
+     * Tells you if the specific package is installed or not. This is analogous to `adb shell pm path <pkg>` and some output parsing.
+     *
+     * @param pkg The package name. This is NOT the APK.
+     *
+     * @returns `true` if the package is installed, `false` otherwise.
+     */
+    isInstalled(pkg) {
+        return this.transport().then((transport) => new host_transport_1.IsInstalledCommand(transport).execute(pkg));
+    }
+    /**
+     * Starts the configured activity on the device. Roughly analogous to `adb shell am start <options>`.
+     *
+     * @param options The activity configuration.
+     */
+    startActivity(options) {
+        return this.transport()
+            .then((transport) => new host_transport_1.StartActivityCommand(transport).execute(options))
+            .catch(NoUserOptionError, () => {
+            options.user = undefined;
+            return this.startActivity(options);
+        });
+    }
+    /**
+     * Starts the configured service on the device. Roughly analogous to `adb shell am startservice <options>`.
+     * @param options The activity configuration.
+     */
+    startService(options) {
+        return this.transport()
+            .then((transport) => {
+            if (!(options.user || options.user === null)) {
+                options.user = 0;
+            }
+            return new host_transport_1.StartServiceCommand(transport).execute(options);
+        })
+            .catch(NoUserOptionError, () => {
+            options.user = undefined;
+            return this.startService(options);
+        });
+    }
+    /**
+     * Establishes a new Sync connection that can be used to push and pull files. This method provides the most freedom and the best performance for repeated use, but can be a bit cumbersome to use. For simple use cases, consider using `client.stat()`, `client.push()` and `client.pull()`.
+     *
+     * @returns The Sync client. See below for details. Call `sync.end()` when done.
+     */
+    syncService() {
+        return this.transport().then((transport) => new host_transport_1.SyncCommand(transport).execute());
+    }
+    /**
+       * Retrieves information about the given path.
+       *
+       * @param path The path.
+       *
+       * @returns An [`fs.Stats`][node-fs-stats] instance. While the `stats.is*` methods are available, only the following properties are supported:
+          -   **mode** The raw mode.
+          -   **size** The file size.
+          -   **mtime** The time of last modification as a `Date`.
+       */
+    stat(path) {
+        return this.syncService().then((sync) => sync.stat(path).finally(() => sync.end()));
+    }
+    /**
+     * A convenience shortcut for `sync.readdir()`, mainly for one-off use cases. The connection cannot be reused, resulting in poorer performance over multiple calls. However, the Sync client will be closed automatically for you, so that's one less thing to worry about.
+     *
+     * @param path See `sync.readdir()` for details.
+     * @returns Files Lists
+     */
+    readdir(path) {
+        return this.syncService().then((sync) => sync.readdir(path).finally(() => sync.end()));
+    }
+    /**
+     * A convenience shortcut for `sync.pull()`, mainly for one-off use cases. The connection cannot be reused, resulting in poorer performance over multiple calls. However, the Sync client will be closed automatically for you, so that's one less thing to worry about.
+     *
+     * @param path See `sync.pull()` for details.
+     *
+     * @returns A `PullTransfer` instance.
+     */
+    pull(path) {
+        return this.syncService().then((sync) => sync.pull(path).on('end', () => sync.end()));
+    }
+    /**
+     * A convenience shortcut for `sync.push()`, mainly for one-off use cases. The connection cannot be reused, resulting in poorer performance over multiple calls. However, the Sync client will be closed automatically for you, so that's one less thing to worry about.
+     *
+     * @param contents See `sync.push()` for details.
+     * @param path See `sync.push()` for details.
+     * @param mode See `sync.push()` for details.
+     */
+    push(contents, path, mode) {
+        return this.syncService().then((sync) => sync.push(contents, path, mode).on('end', () => sync.end()));
+    }
+    /**
+     * Puts the device's ADB daemon into tcp mode, allowing you to use `adb connect` or `client.connect()` to connect to it. Note that the device will still be visible to ADB as a regular USB-connected device until you unplug it. Same as `adb tcpip <port>`.
+     *
+     * @param port Optional. The port the device should listen on. Defaults to `5555`.
+     * @returns The port the device started listening on.
+     */
+    tcpip(port = 5555) {
+        return this.transport().then((transport) => new host_transport_1.TcpIpCommand(transport).execute(port));
+    }
+    /**
+     * Puts the device's ADB daemon back into USB mode. Reverses `client.tcpip()`. Same as `adb usb`.
+     *
+     * @returns true
+     */
+    usb() {
+        return this.transport().then((transport) => new host_transport_1.UsbCommand(transport).execute());
+    }
+    /**
+     * Waits until the device has finished booting. Note that the device must already be seen by ADB. This is roughly analogous to periodically checking `adb shell getprop sys.boot_completed`.
+     *
+     * @returns true
+     */
+    waitBootComplete() {
+        return this.transport().then((transport) => new host_transport_1.WaitBootCompleteCommand(transport).execute());
+    }
+    /**
+     * Waits until ADB can see the device. Note that you must know the serial in advance. Other than that, works like `adb -s serial wait-for-device`. If you're planning on reacting to random devices being plugged in and out, consider using `client.trackDevices()` instead.
+     *
+     * @returns The device ID. Can be useful for chaining.
+     */
+    waitForDevice() {
+        return this.connection().then((conn) => new host_serial_1.WaitForDeviceCommand(conn).execute(this.serial));
+    }
+}
+exports.default = DeviceClient;
+//# sourceMappingURL=DeviceClient.js.map

package/dist/src/adb/DeviceClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeviceClient.js","sourceRoot":"","sources":["../../../src/adb/DeviceClient.ts"],"names":[],"mappings":"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"}

package/dist/src/adb/auth.d.ts

@@ -0,0 +1,8 @@
+import ExtendedPublicKey from '../ExtendedPublicKey';
+import Bluebird from 'bluebird';
+export default class Auth {
+    private static RE;
+    static parsePublicKey(buffer: string): Bluebird<ExtendedPublicKey>;
+    private static readPublicKeyFromStruct;
+}
+//# sourceMappingURL=auth.d.ts.map

package/dist/src/adb/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/adb/auth.ts"],"names":[],"mappings":"AAiBA,OAAO,iBAAiB,MAAM,sBAAsB,CAAC;AACrD,OAAO,QAAQ,MAAM,UAAU,CAAC;AAIhC,MAAM,CAAC,OAAO,OAAO,IAAI;IACvB,OAAO,CAAC,MAAM,CAAC,EAAE,CAAuF;WAC1F,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,iBAAiB,CAAC;IAazE,OAAO,CAAC,MAAM,CAAC,uBAAuB;CAgDvC"}

package/dist/src/adb/auth.js

@@ -0,0 +1,87 @@
+"use strict";
+/*
+The stucture of an ADB RSAPublicKey is as follows:
+
+    #define RSANUMBYTES 256           // 2048 bit key length
+    #define RSANUMWORDS (RSANUMBYTES / sizeof(uint32_t))
+
+    typedef struct RSAPublicKey {
+        int len;                  // Length of n[] in number of uint32_t
+        uint32_t n0inv;           // -1 / n[0] mod 2^32
+        uint32_t n[RSANUMWORDS];  // modulus as little endian array
+        uint32_t rr[RSANUMWORDS]; // R^2 as little endian array
+        int exponent;             // 3 or 65537
+    } RSAPublicKey;
+
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_forge_1 = __importDefault(require("node-forge"));
+const bluebird_1 = __importDefault(require("bluebird"));
+const BigInteger = node_forge_1.default.jsbn.BigInteger;
+class Auth {
+    static parsePublicKey(buffer) {
+        return new bluebird_1.default(function (resolve, reject) {
+            const match = Auth.RE.exec(buffer);
+            if (match) {
+                const struct = Buffer.from(match[1], 'base64');
+                const comment = match[2].trim();
+                return resolve(Auth.readPublicKeyFromStruct(struct, comment));
+            }
+            else {
+                return reject(new Error('Unrecognizable public key format'));
+            }
+        });
+    }
+    static readPublicKeyFromStruct(struct, comment) {
+        if (!struct.length) {
+            throw new Error('Invalid public key');
+        }
+        // Keep track of what we've read already
+        let offset = 0;
+        // Get len
+        const len = struct.readUInt32LE(offset) * 4;
+        offset += 4;
+        if (struct.length !== 4 + 4 + len + len + 4) {
+            throw new Error('Invalid public key');
+        }
+        // Skip n0inv, we don't need it
+        offset += 4;
+        // Get n
+        const n = Buffer.alloc(len);
+        struct.copy(n, 0, offset, offset + len);
+        [].reverse.call(n);
+        offset += len;
+        // Skip rr, we don't need it
+        offset += len;
+        // Get e
+        const e = struct.readUInt32LE(offset);
+        if (!(e === 3 || e === 65537)) {
+            throw new Error(`Invalid exponent ${e}, only 3 and 65537 are supported`);
+        }
+        // FIXME: bug in @types/node-forge
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
+        const modulus = new BigInteger(n.toString('hex'), 16);
+        // FIXME: bug in @types/node-forge
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
+        const exponent = new BigInteger(e.toString(), 10);
+        // Restore the public key
+        const key = node_forge_1.default.pki.rsa.setPublicKey(modulus, exponent);
+        // It will be difficult to retrieve the fingerprint later as it's based
+        // on the complete struct data, so let's just extend the key with it.
+        const md = node_forge_1.default.md.md5.create();
+        md.update(struct.toString('binary'));
+        const extendedKey = key;
+        extendedKey.fingerprint = md.digest().toHex().match(/../g).join(':');
+        // Expose comment for the same reason
+        extendedKey.comment = comment;
+        return extendedKey;
+    }
+}
+exports.default = Auth;
+Auth.RE = /^((?:[A-Za-z0-9+\/]{4})*(?:[A-Za-z0-9+\/]{2}==|[A-Za-z0-9+\/]{3}=)?)\0?( .*|)\s*$/;
+//# sourceMappingURL=auth.js.map

package/dist/src/adb/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/adb/auth.ts"],"names":[],"mappings":"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"}