Add attach / detach commands (DeviceFarmer#534) from YishaiYosifov

Author: UrielCh

src/adb/DeviceClient.ts

@@ -14,6 +14,8 @@ import ProcStat from './proc/stat.js';
 import { HostTransportCommand } from './command/host/index.js';
 import * as hostCmd from './command/host-transport/index.js';
 import {
+  AttachCommand,
+  DetachCommand,
   ForwardCommand,
   GetDevicePathCommand,
   GetSerialNoCommand,
@@ -1046,6 +1048,26 @@ export default class DeviceClient {
     return new WaitForDeviceCommand(conn).execute(this.serial);
   }
 
+  /**
+   * Reattaches ADB to the device's ADB USB interface. This re-enables communication between ADB and device, reversing `client.detach()`.
+   *
+   * @returns true
+   */
+  public async attach(): Promise<boolean> {
+    const conn = await this.connection();
+    return new AttachCommand(conn).execute(this.serial);
+  }
+
+  /**
+   * Detaches ADB's USB interface from ADB. This releases the device from ADB control, allowing other processes to use it.
+   *
+   * @returns true
+   */
+  public async detach(): Promise<boolean> {
+    const conn = await this.connection();
+    return new DetachCommand(conn).execute(this.serial);
+  }
+
   /**
    * prepare a Scrcpy server
    * this server must be started with the start() method

src/adb/command/host-serial/attach.ts

@@ -0,0 +1,9 @@
+import Command from '../../command.js';
+
+export default class AttachCommand extends Command<boolean> {
+  async execute(serial: string): Promise<boolean> {
+    await this._send(`host-serial:${serial}:attach`);
+    await this.readOKAY();
+    return true;
+  }
+}

src/adb/command/host-serial/detach.ts

@@ -0,0 +1,9 @@
+import Command from '../../command.js';
+
+export default class DetachCommand extends Command<boolean> {
+  async execute(serial: string): Promise<boolean> {
+    await this._send(`host-serial:${serial}:detach`);
+    await this.readOKAY();
+    return true;
+  }
+}

src/adb/command/host-serial/index.ts

@@ -1,3 +1,5 @@
+export { default as AttachCommand } from './attach.js';
+export { default as DetachCommand } from './detach.js';
 export { default as ForwardCommand } from './forward.js';
 export { default as KillForwardCommand } from './killForward.js';
 export { default as GetDevicePathCommand } from './getdevicepath.js';

src/models/Device.ts

@@ -1,6 +1,6 @@
 import DeviceClient from "../adb/DeviceClient.js";
 
-const deviceTypes = ['emulator', 'device', 'offline', 'unauthorized', 'recovery'] as const;
+const deviceTypes = ['emulator', 'device', 'offline', 'unauthorized', 'recovery', 'unknown'] as const;
 /**
  * adb device starts
  */