80% working adb-based interception & cert injection

This allows automated setup on emulators, or other devices without
QR code readers, and automatically does *system* certificate
injection into any root-ish devices (rooted devices, plus the official
emulators that only allow su from an adb shell).

Author: pimterry

custom-typings/adbkit.d.ts

@@ -0,0 +1,42 @@
+declare module 'adbkit' {
+    import * as stream from 'stream';
+    import * as events from 'events';
+
+    export interface Device {
+        id: string;
+        type: string;
+    }
+
+    export interface AdbClient {
+        listDevices(): Promise<Device[]>;
+        isInstalled(id: string, pkg: string): Promise<boolean>;
+        install(id: string, apk: string | stream.Readable): Promise<true>;
+        startActivity(
+            id: string,
+            options: {
+                debug?: boolean;
+                wait?: boolean;
+                action?: string;
+                data?: string;
+            }
+        ): Promise<true>;
+        push(
+            id: string,
+            contents: string | stream.Readable,
+            path: string,
+            mode?: number
+        ): Promise<events.EventEmitter>
+        shell(id: string, cmd: string | string[]): Promise<stream.Readable>;
+        root(id: string): Promise<true>;
+    }
+
+    export function createClient(options?: {
+        port?: number,
+        host?: string,
+        bin?: string
+    }): AdbClient;
+
+    export namespace util {
+        export function readAll(stream: stream.Readable): Promise<Buffer>;
+    }
+}