@yume-chan/adb 0.0.8 → 0.0.11

package/esm/commands/reverse.js

@@ -1,7 +1,8 @@
-import { __awaiter } from "tslib";
+// cspell: ignore killforward
 import { AutoDisposable } from '@yume-chan/event';
 import Struct from '@yume-chan/struct';
-import { AdbBufferedStream } from '../stream';
+import { AdbBufferedStream } from '../stream/index.js';
+import { decodeUtf8 } from "../utils/index.js";
 const AdbReverseStringResponse = new Struct({ littleEndian: true })
     .string('length', { length: 4 })
     .string('content', { lengthField: 'length', lengthFieldBase: 16 });
@@ -11,11 +12,12 @@ const AdbReverseErrorResponse = new Struct({ littleEndian: true })
     throw new Error(value.content);
 });
 export class AdbReverseCommand extends AutoDisposable {
+    localPortToHandler = new Map();
+    deviceAddressToLocalPort = new Map();
+    dispatcher;
+    listening = false;
     constructor(dispatcher) {
         super();
-        this.localPortToHandler = new Map();
-        this.deviceAddressToLocalPort = new Map();
-        this.listening = false;
         this.dispatcher = dispatcher;
         this.addDisposable(this.dispatcher.onIncomingSocket(this.handleIncomingSocket, this));
     }
@@ -23,40 +25,34 @@ export class AdbReverseCommand extends AutoDisposable {
         if (e.handled) {
             return;
         }
-        const address = this.dispatcher.backend.decodeUtf8(e.packet.payload);
-        // tcp:1234\0
+        const address = decodeUtf8(e.packet.payload);
+        // Address format: `tcp:12345\0`
         const port = Number.parseInt(address.substring(4));
         if (this.localPortToHandler.has(port)) {
             this.localPortToHandler.get(port).onSocket(e.packet, e.socket);
             e.handled = true;
         }
     }
-    createBufferedStream(service) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const socket = yield this.dispatcher.createSocket(service);
-            return new AdbBufferedStream(socket);
-        });
+    async createBufferedStream(service) {
+        const socket = await this.dispatcher.createSocket(service);
+        return new AdbBufferedStream(socket);
     }
-    sendRequest(service) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const stream = yield this.createBufferedStream(service);
-            const success = this.dispatcher.backend.decodeUtf8(yield stream.read(4)) === 'OKAY';
-            if (!success) {
-                yield AdbReverseErrorResponse.deserialize(stream);
-            }
-            return stream;
-        });
+    async sendRequest(service) {
+        const stream = await this.createBufferedStream(service);
+        const success = decodeUtf8(await stream.read(4)) === 'OKAY';
+        if (!success) {
+            await AdbReverseErrorResponse.deserialize(stream);
+        }
+        return stream;
     }
-    list() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const stream = yield this.createBufferedStream('reverse:list-forward');
-            const response = yield AdbReverseStringResponse.deserialize(stream);
-            return response.content.split('\n').map(line => {
-                const [deviceSerial, localName, remoteName] = line.split(' ');
-                return { deviceSerial, localName, remoteName };
-            });
-            // No need to close the stream, device will close it
+    async list() {
+        const stream = await this.createBufferedStream('reverse:list-forward');
+        const response = await AdbReverseStringResponse.deserialize(stream);
+        return response.content.split('\n').map(line => {
+            const [deviceSerial, localName, remoteName] = line.split(' ');
+            return { deviceSerial, localName, remoteName };
         });
+        // No need to close the stream, device will close it
     }
     /**
      * @param deviceAddress The address adbd on device is listening on. Can be `tcp:0` to let adbd choose an available TCP port by itself.
@@ -64,38 +60,32 @@ export class AdbReverseCommand extends AutoDisposable {
      * @param handler A callback to handle incoming connections
      * @returns If `deviceAddress` is `tcp:0`, return `tcp:{ACTUAL_LISTENING_PORT}`; otherwise, return `deviceAddress`.
      */
-    add(deviceAddress, localPort, handler) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const stream = yield this.sendRequest(`reverse:forward:${deviceAddress};tcp:${localPort}`);
-            // `tcp:0` tells the device to pick an available port.
-            // However, device will response with the selected port for all `tcp:` requests.
-            if (deviceAddress.startsWith('tcp:')) {
-                const response = yield AdbReverseStringResponse.deserialize(stream);
-                deviceAddress = `tcp:${Number.parseInt(response.content, 10)}`;
-            }
-            this.localPortToHandler.set(localPort, handler);
-            this.deviceAddressToLocalPort.set(deviceAddress, localPort);
-            return deviceAddress;
-            // No need to close the stream, device will close it
-        });
+    async add(deviceAddress, localPort, handler) {
+        const stream = await this.sendRequest(`reverse:forward:${deviceAddress};tcp:${localPort}`);
+        // `tcp:0` tells the device to pick an available port.
+        // However, device will response with the selected port for all `tcp:` requests.
+        if (deviceAddress.startsWith('tcp:')) {
+            const response = await AdbReverseStringResponse.deserialize(stream);
+            deviceAddress = `tcp:${Number.parseInt(response.content, 10)}`;
+        }
+        this.localPortToHandler.set(localPort, handler);
+        this.deviceAddressToLocalPort.set(deviceAddress, localPort);
+        return deviceAddress;
+        // No need to close the stream, device will close it
     }
-    remove(deviceAddress) {
-        return __awaiter(this, void 0, void 0, function* () {
-            yield this.sendRequest(`reverse:killforward:${deviceAddress}`);
-            if (this.deviceAddressToLocalPort.has(deviceAddress)) {
-                this.localPortToHandler.delete(this.deviceAddressToLocalPort.get(deviceAddress));
-                this.deviceAddressToLocalPort.delete(deviceAddress);
-            }
-            // No need to close the stream, device will close it
-        });
+    async remove(deviceAddress) {
+        await this.sendRequest(`reverse:killforward:${deviceAddress}`);
+        if (this.deviceAddressToLocalPort.has(deviceAddress)) {
+            this.localPortToHandler.delete(this.deviceAddressToLocalPort.get(deviceAddress));
+            this.deviceAddressToLocalPort.delete(deviceAddress);
+        }
+        // No need to close the stream, device will close it
     }
-    removeAll() {
-        return __awaiter(this, void 0, void 0, function* () {
-            yield this.sendRequest(`reverse:killforward-all`);
-            this.deviceAddressToLocalPort.clear();
-            this.localPortToHandler.clear();
-            // No need to close the stream, device will close it
-        });
+    async removeAll() {
+        await this.sendRequest(`reverse:killforward-all`);
+        this.deviceAddressToLocalPort.clear();
+        this.localPortToHandler.clear();
+        // No need to close the stream, device will close it
     }
 }
 //# sourceMappingURL=reverse.js.map

package/esm/commands/reverse.js.map

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

package/esm/commands/subprocess/index.d.ts

@@ -0,0 +1,57 @@
+import type { Adb } from '../../adb.js';
+import type { AdbSubprocessProtocol, AdbSubprocessProtocolConstructor } from './types.js';
+export * from './legacy.js';
+export * from './protocol.js';
+export * from './types.js';
+export * from './utils.js';
+export interface AdbSubprocessOptions {
+    /**
+     * A list of `AdbShellConstructor`s to be used.
+     *
+     * Different `AdbShell` has different capabilities, thus requires specific adaptations.
+     * Check each `AdbShell`'s documentation for details.
+     *
+     * The first one whose `isSupported` returns `true` will be used.
+     * If no `AdbShell` is supported, an error will be thrown.
+     *
+     * The default value is `[AdbShellProtocol, AdbLegacyShell]`.
+     */
+    protocols: AdbSubprocessProtocolConstructor[];
+}
+export interface SubprocessResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export declare class AdbSubprocess {
+    readonly adb: Adb;
+    constructor(adb: Adb);
+    private createProtocol;
+    /**
+     * Spawns the default shell in interactive mode.
+     * @param options The options for creating the `AdbShell`
+     * @returns A new `AdbShell` instance connecting to the spawned shell process.
+     */
+    shell(options?: Partial<AdbSubprocessOptions>): Promise<AdbSubprocessProtocol>;
+    /**
+     * Spawns a new process using the given `command`.
+     * @param command The command to run, or an array of strings containing both command and args.
+     * @param options The options for creating the `AdbShell`
+     * @returns A new `AdbShell` instance connecting to the spawned process.
+     */
+    spawn(command: string | string[], options?: Partial<AdbSubprocessOptions>): Promise<AdbSubprocessProtocol>;
+    /**
+     * Spawns a new process, waits until it exits, and returns the entire output.
+     * @param command The command to run
+     * @param options The options for creating the `AdbShell`
+     * @returns The entire output of the command
+     */
+    spawnAndWait(command: string | string[], options?: Partial<AdbSubprocessOptions>): Promise<SubprocessResult>;
+    /**
+     * Spawns a new process, waits until it exits, and returns the entire output.
+     * @param command The command to run
+     * @returns The entire output of the command
+     */
+    spawnAndWaitLegacy(command: string | string[]): Promise<string>;
+}
+//# sourceMappingURL=index.d.ts.map

package/esm/commands/subprocess/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/subprocess/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAIxC,OAAO,KAAK,EAAE,qBAAqB,EAAE,gCAAgC,EAAE,MAAM,YAAY,CAAC;AAE1F,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAE3B,MAAM,WAAW,oBAAoB;IACjC;;;;;;;;;;OAUG;IACH,SAAS,EAAE,gCAAgC,EAAE,CAAC;CACjD;AAMD,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,aAAa;IACtB,SAAgB,GAAG,EAAE,GAAG,CAAC;gBAEN,GAAG,EAAE,GAAG;YAIb,cAAc;IAkB5B;;;;OAIG;IACI,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAIrF;;;;;OAKG;IACI,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAOjH;;;;;OAKG;IACU,YAAY,CACrB,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,EAC1B,OAAO,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GACxC,OAAO,CAAC,gBAAgB,CAAC;IAsB5B;;;;OAIG;IACU,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CAI/E"}

package/esm/commands/subprocess/index.js

@@ -0,0 +1,83 @@
+import { DecodeUtf8Stream, GatherStringStream } from "../../stream/index.js";
+import { AdbNoneSubprocessProtocol } from './legacy.js';
+import { AdbShellSubprocessProtocol } from './protocol.js';
+export * from './legacy.js';
+export * from './protocol.js';
+export * from './types.js';
+export * from './utils.js';
+const DefaultOptions = {
+    protocols: [AdbShellSubprocessProtocol, AdbNoneSubprocessProtocol],
+};
+export class AdbSubprocess {
+    adb;
+    constructor(adb) {
+        this.adb = adb;
+    }
+    async createProtocol(command, options) {
+        let { protocols } = { ...DefaultOptions, ...options };
+        let Constructor;
+        for (const item of protocols) {
+            if (await item.isSupported(this.adb)) {
+                Constructor = item;
+                break;
+            }
+        }
+        if (!Constructor) {
+            throw new Error('No specified protocol is supported by the device');
+        }
+        return await Constructor.spawn(this.adb, command);
+    }
+    /**
+     * Spawns the default shell in interactive mode.
+     * @param options The options for creating the `AdbShell`
+     * @returns A new `AdbShell` instance connecting to the spawned shell process.
+     */
+    shell(options) {
+        return this.createProtocol('', options);
+    }
+    /**
+     * Spawns a new process using the given `command`.
+     * @param command The command to run, or an array of strings containing both command and args.
+     * @param options The options for creating the `AdbShell`
+     * @returns A new `AdbShell` instance connecting to the spawned process.
+     */
+    spawn(command, options) {
+        if (Array.isArray(command)) {
+            command = command.join(' ');
+        }
+        return this.createProtocol(command, options);
+    }
+    /**
+     * Spawns a new process, waits until it exits, and returns the entire output.
+     * @param command The command to run
+     * @param options The options for creating the `AdbShell`
+     * @returns The entire output of the command
+     */
+    async spawnAndWait(command, options) {
+        const shell = await this.spawn(command, options);
+        const stdout = new GatherStringStream();
+        shell.stdout
+            .pipeThrough(new DecodeUtf8Stream())
+            .pipeThrough(stdout);
+        const stderr = new GatherStringStream();
+        shell.stderr
+            .pipeThrough(new DecodeUtf8Stream())
+            .pipeThrough(stderr);
+        const exitCode = await shell.exit;
+        return {
+            stdout: stdout.result,
+            stderr: stderr.result,
+            exitCode,
+        };
+    }
+    /**
+     * Spawns a new process, waits until it exits, and returns the entire output.
+     * @param command The command to run
+     * @returns The entire output of the command
+     */
+    async spawnAndWaitLegacy(command) {
+        const { stdout } = await this.spawnAndWait(command, { protocols: [AdbNoneSubprocessProtocol] });
+        return stdout;
+    }
+}
+//# sourceMappingURL=index.js.map

package/esm/commands/subprocess/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/subprocess/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAG3D,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAiB3B,MAAM,cAAc,GAAyB;IACzC,SAAS,EAAE,CAAC,0BAA0B,EAAE,yBAAyB,CAAC;CACrE,CAAC;AAQF,MAAM,OAAO,aAAa;IACN,GAAG,CAAM;IAEzB,YAAmB,GAAQ;QACvB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACnB,CAAC;IAEO,KAAK,CAAC,cAAc,CAAC,OAAe,EAAE,OAAuC;QACjF,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,OAAO,EAAE,CAAC;QAEtD,IAAI,WAAyD,CAAC;QAC9D,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE;YAC1B,IAAI,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;gBAClC,WAAW,GAAG,IAAI,CAAC;gBACnB,MAAM;aACT;SACJ;QAED,IAAI,CAAC,WAAW,EAAE;YACd,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;SACvE;QAED,OAAO,MAAM,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,OAAuC;QAChD,OAAO,IAAI,CAAC,cAAc,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,OAA0B,EAAE,OAAuC;QAC5E,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;YACxB,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;SAC/B;QACD,OAAO,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,YAAY,CACrB,OAA0B,EAC1B,OAAuC;QAEvC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAEjD,MAAM,MAAM,GAAG,IAAI,kBAAkB,EAAE,CAAC;QACxC,KAAK,CAAC,MAAM;aACP,WAAW,CAAC,IAAI,gBAAgB,EAAE,CAAC;aACnC,WAAW,CAAC,MAAM,CAAC,CAAC;QAEzB,MAAM,MAAM,GAAG,IAAI,kBAAkB,EAAE,CAAC;QACxC,KAAK,CAAC,MAAM;aACP,WAAW,CAAC,IAAI,gBAAgB,EAAE,CAAC;aACnC,WAAW,CAAC,MAAM,CAAC,CAAC;QAEzB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC;QAElC,OAAO;YACH,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ;SACX,CAAC;IACN,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,kBAAkB,CAAC,OAA0B;QACtD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,CAAC,yBAAyB,CAAC,EAAE,CAAC,CAAC;QAChG,OAAO,MAAM,CAAC;IAClB,CAAC;CACJ"}

package/esm/commands/subprocess/legacy.d.ts

@@ -0,0 +1,28 @@
+import type { Adb } from "../../adb.js";
+import type { AdbSocket } from "../../socket/index.js";
+import { type ReadableStream } from "../../stream/index.js";
+import type { AdbSubprocessProtocol } from "./types.js";
+/**
+ * The legacy shell
+ *
+ * Features:
+ * * `stderr`: No
+ * * `exit` exit code: No
+ * * `resize`: No
+ */
+export declare class AdbNoneSubprocessProtocol implements AdbSubprocessProtocol {
+    static isSupported(): boolean;
+    static spawn(adb: Adb, command: string): Promise<AdbNoneSubprocessProtocol>;
+    private readonly socket;
+    get stdin(): import("web-streams-polyfill").WritableStream<Uint8Array>;
+    private _stdout;
+    get stdout(): ReadableStream<Uint8Array>;
+    private _stderr;
+    get stderr(): ReadableStream<Uint8Array>;
+    private _exit;
+    get exit(): Promise<number>;
+    constructor(socket: AdbSocket);
+    resize(): void;
+    kill(): Promise<void>;
+}
+//# sourceMappingURL=legacy.d.ts.map

package/esm/commands/subprocess/legacy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy.d.ts","sourceRoot":"","sources":["../../../src/commands/subprocess/legacy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD;;;;;;;GAOG;AACH,qBAAa,yBAA0B,YAAW,qBAAqB;WACrD,WAAW;WAEL,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM;IAInD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IAGnC,IAAW,KAAK,8DAAmC;IAEnD,OAAO,CAAC,OAAO,CAA6B;IAE5C,IAAW,MAAM,+BAA2B;IAG5C,OAAO,CAAC,OAAO,CAA6B;IAC5C,IAAW,MAAM,+BAA2B;IAE5C,OAAO,CAAC,KAAK,CAAkB;IAC/B,IAAW,IAAI,oBAAyB;gBAErB,MAAM,EAAE,SAAS;IAc7B,MAAM;IAIN,IAAI;CAGd"}

package/esm/commands/subprocess/legacy.js

@@ -0,0 +1,44 @@
+import { DuplexStreamFactory } from "../../stream/index.js";
+/**
+ * The legacy shell
+ *
+ * Features:
+ * * `stderr`: No
+ * * `exit` exit code: No
+ * * `resize`: No
+ */
+export class AdbNoneSubprocessProtocol {
+    static isSupported() { return true; }
+    static async spawn(adb, command) {
+        return new AdbNoneSubprocessProtocol(await adb.createSocket(`shell:${command}`));
+    }
+    socket;
+    // Legacy shell forwards all data to stdin.
+    get stdin() { return this.socket.writable; }
+    _stdout;
+    // Legacy shell doesn't support splitting output streams.
+    get stdout() { return this._stdout; }
+    // `stderr` of Legacy shell is always empty.
+    _stderr;
+    get stderr() { return this._stderr; }
+    _exit;
+    get exit() { return this._exit; }
+    constructor(socket) {
+        this.socket = socket;
+        const factory = new DuplexStreamFactory({
+            close: async () => {
+                await this.socket.close();
+            },
+        });
+        this._stdout = factory.createWrapReadable(this.socket.readable);
+        this._stderr = factory.createReadable();
+        this._exit = factory.closed.then(() => 0);
+    }
+    resize() {
+        // Not supported
+    }
+    kill() {
+        return this.socket.close();
+    }
+}
+//# sourceMappingURL=legacy.js.map

package/esm/commands/subprocess/legacy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy.js","sourceRoot":"","sources":["../../../src/commands/subprocess/legacy.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAuB,MAAM,uBAAuB,CAAC;AAGjF;;;;;;;GAOG;AACH,MAAM,OAAO,yBAAyB;IAC3B,MAAM,CAAC,WAAW,KAAK,OAAO,IAAI,CAAC,CAAC,CAAC;IAErC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,GAAQ,EAAE,OAAe;QAC/C,OAAO,IAAI,yBAAyB,CAAC,MAAM,GAAG,CAAC,YAAY,CAAC,SAAS,OAAO,EAAE,CAAC,CAAC,CAAC;IACrF,CAAC;IAEgB,MAAM,CAAY;IAEnC,2CAA2C;IAC3C,IAAW,KAAK,KAAK,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE3C,OAAO,CAA6B;IAC5C,yDAAyD;IACzD,IAAW,MAAM,KAAK,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAE5C,4CAA4C;IACpC,OAAO,CAA6B;IAC5C,IAAW,MAAM,KAAK,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAEpC,KAAK,CAAkB;IAC/B,IAAW,IAAI,KAAK,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAExC,YAAmB,MAAiB;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,MAAM,OAAO,GAAG,IAAI,mBAAmB,CAAyB;YAC5D,KAAK,EAAE,KAAK,IAAI,EAAE;gBACd,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAC9B,CAAC;SACJ,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAChE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;QACxC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;IAEM,MAAM;QACT,gBAAgB;IACpB,CAAC;IAEM,IAAI;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;CACJ"}

package/esm/commands/subprocess/protocol.d.ts

@@ -0,0 +1,38 @@
+import type { Adb } from "../../adb.js";
+import type { AdbSocket } from "../../socket/index.js";
+import { ReadableStream, WritableStream } from "../../stream/index.js";
+import type { AdbSubprocessProtocol } from "./types.js";
+export declare enum AdbShellProtocolId {
+    Stdin = 0,
+    Stdout = 1,
+    Stderr = 2,
+    Exit = 3,
+    CloseStdin = 4,
+    WindowSizeChange = 5
+}
+/**
+ * Shell v2 a.k.a Shell Protocol
+ *
+ * Features:
+ * * `stderr`: Yes
+ * * `exit` exit code: Yes
+ * * `resize`: Yes
+ */
+export declare class AdbShellSubprocessProtocol implements AdbSubprocessProtocol {
+    static isSupported(adb: Adb): boolean;
+    static spawn(adb: Adb, command: string): Promise<AdbShellSubprocessProtocol>;
+    private readonly _socket;
+    private _socketWriter;
+    private _stdin;
+    get stdin(): WritableStream<Uint8Array>;
+    private _stdout;
+    get stdout(): ReadableStream<Uint8Array>;
+    private _stderr;
+    get stderr(): ReadableStream<Uint8Array>;
+    private readonly _exit;
+    get exit(): Promise<number>;
+    constructor(socket: AdbSocket);
+    resize(rows: number, cols: number): Promise<void>;
+    kill(): Promise<void>;
+}
+//# sourceMappingURL=protocol.d.ts.map

package/esm/commands/subprocess/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../src/commands/subprocess/protocol.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAExC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAsB,cAAc,EAAmE,cAAc,EAAkE,MAAM,uBAAuB,CAAC;AAE5N,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,oBAAY,kBAAkB;IAC1B,KAAK,IAAA;IACL,MAAM,IAAA;IACN,MAAM,IAAA;IACN,IAAI,IAAA;IACJ,UAAU,IAAA;IACV,gBAAgB,IAAA;CACnB;AA6ED;;;;;;;GAOG;AACH,qBAAa,0BAA2B,YAAW,qBAAqB;WACtD,WAAW,CAAC,GAAG,EAAE,GAAG;WAId,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM;IAMnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAY;IACpC,OAAO,CAAC,aAAa,CAA0D;IAE/E,OAAO,CAAC,MAAM,CAA6B;IAC3C,IAAW,KAAK,+BAA0B;IAE1C,OAAO,CAAC,OAAO,CAA6B;IAC5C,IAAW,MAAM,+BAA2B;IAE5C,OAAO,CAAC,OAAO,CAA6B;IAC5C,IAAW,MAAM,+BAA2B;IAE5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IACvD,IAAW,IAAI,oBAAiC;gBAE7B,MAAM,EAAE,SAAS;IA0CvB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAYvC,IAAI;CAGd"}

package/esm/commands/subprocess/protocol.js

@@ -0,0 +1,155 @@
+import { PromiseResolver } from "@yume-chan/async";
+import Struct, { placeholder } from "@yume-chan/struct";
+import { AdbFeatures } from "../../features.js";
+import { PushReadableStream, StructDeserializeStream, StructSerializeStream, TransformStream, WritableStream } from "../../stream/index.js";
+import { encodeUtf8 } from "../../utils/index.js";
+export var AdbShellProtocolId;
+(function (AdbShellProtocolId) {
+    AdbShellProtocolId[AdbShellProtocolId["Stdin"] = 0] = "Stdin";
+    AdbShellProtocolId[AdbShellProtocolId["Stdout"] = 1] = "Stdout";
+    AdbShellProtocolId[AdbShellProtocolId["Stderr"] = 2] = "Stderr";
+    AdbShellProtocolId[AdbShellProtocolId["Exit"] = 3] = "Exit";
+    AdbShellProtocolId[AdbShellProtocolId["CloseStdin"] = 4] = "CloseStdin";
+    AdbShellProtocolId[AdbShellProtocolId["WindowSizeChange"] = 5] = "WindowSizeChange";
+})(AdbShellProtocolId = AdbShellProtocolId || (AdbShellProtocolId = {}));
+// This packet format is used in both direction.
+const AdbShellProtocolPacket = new Struct({ littleEndian: true })
+    .uint8('id', placeholder())
+    .uint32('length')
+    .uint8Array('data', { lengthField: 'length' });
+class StdinSerializeStream extends TransformStream {
+    constructor() {
+        super({
+            transform(chunk, controller) {
+                controller.enqueue({
+                    id: AdbShellProtocolId.Stdin,
+                    data: chunk,
+                });
+            },
+            flush() {
+                // TODO: AdbShellSubprocessProtocol: support closing stdin
+            }
+        });
+    }
+}
+class StdoutDeserializeStream extends TransformStream {
+    constructor(type) {
+        super({
+            transform(chunk, controller) {
+                if (chunk.id === type) {
+                    controller.enqueue(chunk.data);
+                }
+            },
+        });
+    }
+}
+class MultiplexStream {
+    _readable;
+    _readableController;
+    get readable() { return this._readable; }
+    _activeCount = 0;
+    constructor() {
+        this._readable = new PushReadableStream(controller => {
+            this._readableController = controller;
+        });
+    }
+    createWriteable() {
+        return new WritableStream({
+            start: () => {
+                this._activeCount += 1;
+            },
+            write: async (chunk) => {
+                await this._readableController.enqueue(chunk);
+            },
+            abort: async (e) => {
+                this._activeCount -= 1;
+                if (this._activeCount === 0) {
+                    this._readableController.close();
+                }
+            },
+            close: async () => {
+                this._activeCount -= 1;
+                if (this._activeCount === 0) {
+                    this._readableController.close();
+                }
+            },
+        });
+    }
+}
+/**
+ * Shell v2 a.k.a Shell Protocol
+ *
+ * Features:
+ * * `stderr`: Yes
+ * * `exit` exit code: Yes
+ * * `resize`: Yes
+ */
+export class AdbShellSubprocessProtocol {
+    static isSupported(adb) {
+        return adb.features.includes(AdbFeatures.ShellV2);
+    }
+    static async spawn(adb, command) {
+        // TODO: AdbShellSubprocessProtocol: Support raw mode
+        // TODO: AdbShellSubprocessProtocol: Support setting `XTERM` environment variable
+        return new AdbShellSubprocessProtocol(await adb.createSocket(`shell,v2,pty:${command}`));
+    }
+    _socket;
+    _socketWriter;
+    _stdin;
+    get stdin() { return this._stdin; }
+    _stdout;
+    get stdout() { return this._stdout; }
+    _stderr;
+    get stderr() { return this._stderr; }
+    _exit = new PromiseResolver();
+    get exit() { return this._exit.promise; }
+    constructor(socket) {
+        this._socket = socket;
+        // Check this image to help you understand the stream graph
+        // cspell: disable-next-line
+        // https://www.plantuml.com/plantuml/png/bL91QiCm4Bpx5SAdv90lb1JISmiw5XzaQKf5PIkiLZIqzEyLSg8ks13gYtOykpFhiOw93N6UGjVDqK7rZsxKqNw0U_NTgVAy4empOy2mm4_olC0VEVEE47GUpnGjKdgXoD76q4GIEpyFhOwP_m28hW0NNzxNUig1_JdW0bA7muFIJDco1daJ_1SAX9bgvoPJPyIkSekhNYctvIGXrCH6tIsPL5fs-s6J5yc9BpWXhKtNdF2LgVYPGM_6GlMwfhWUsIt4lbScANrwlgVVUifPSVi__t44qStnwPvZwobdSmHHlL57p2vFuHS0
+        // TODO: AdbShellSubprocessProtocol: Optimize stream graph
+        const [stdout, stderr] = socket.readable
+            .pipeThrough(new StructDeserializeStream(AdbShellProtocolPacket))
+            .pipeThrough(new TransformStream({
+            transform: (chunk, controller) => {
+                if (chunk.id === AdbShellProtocolId.Exit) {
+                    this._exit.resolve(new Uint8Array(chunk.data)[0]);
+                    // We can let `StdoutTransformStream` to process `AdbShellProtocolId.Exit`,
+                    // but since we need this `TransformStream` to capture the exit code anyway,
+                    // terminating child streams here is killing two birds with one stone.
+                    controller.terminate();
+                    return;
+                }
+                controller.enqueue(chunk);
+            }
+        }))
+            .tee();
+        this._stdout = stdout
+            .pipeThrough(new StdoutDeserializeStream(AdbShellProtocolId.Stdout));
+        this._stderr = stderr
+            .pipeThrough(new StdoutDeserializeStream(AdbShellProtocolId.Stderr));
+        const multiplexer = new MultiplexStream();
+        multiplexer.readable
+            .pipeThrough(new StructSerializeStream(AdbShellProtocolPacket))
+            .pipeTo(socket.writable);
+        const { readable, writable } = new StdinSerializeStream();
+        this._stdin = writable;
+        readable.pipeTo(multiplexer.createWriteable());
+        this._socketWriter = multiplexer.createWriteable().getWriter();
+    }
+    async resize(rows, cols) {
+        await this._socketWriter.write({
+            id: AdbShellProtocolId.WindowSizeChange,
+            data: encodeUtf8(
+            // The "correct" format is `${rows}x${cols},${x_pixels}x${y_pixels}`
+            // However, according to https://linux.die.net/man/4/tty_ioctl
+            // `x_pixels` and `y_pixels` are not used, so always passing `0` is fine.
+            `${rows}x${cols},0x0\0`),
+        });
+    }
+    kill() {
+        return this._socket.close();
+    }
+}
+//# sourceMappingURL=protocol.js.map

package/esm/commands/subprocess/protocol.js.map

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