@yume-chan/adb 1.1.0 → 2.0.1

package/esm/commands/subprocess/command.js

@@ -1,89 +0,0 @@
-import { ConcatStringStream, TextDecoderStream } from "@yume-chan/stream-extra";
-import { AdbCommandBase } from "../base.js";
-import { AdbSubprocessNoneProtocol, AdbSubprocessShellProtocol, } from "./protocols/index.js";
-const DEFAULT_OPTIONS = {
-    protocols: [AdbSubprocessShellProtocol, AdbSubprocessNoneProtocol],
-};
-export class AdbSubprocess extends AdbCommandBase {
-    async #createProtocol(mode, command, options) {
-        const { protocols } = { ...DEFAULT_OPTIONS, ...options };
-        let Constructor;
-        for (const item of protocols) {
-            // It's async so can't use `Array#find`
-            if (await item.isSupported(this.adb)) {
-                Constructor = item;
-                break;
-            }
-        }
-        if (!Constructor) {
-            throw new Error("No specified protocol is supported by the device");
-        }
-        if (Array.isArray(command)) {
-            command = command.join(" ");
-        }
-        else if (command === undefined) {
-            // spawn the default shell
-            command = "";
-        }
-        return await Constructor[mode](this.adb, command);
-    }
-    /**
-     * Spawns an executable in PTY mode.
-     *
-     * Redirection mode is enough for most simple commands, but PTY mode is required for
-     * commands that manipulate the terminal, such as `vi` and `less`.
-     * @param command The command to run. If omitted, the default shell will be spawned.
-     * @param options The options for creating the `AdbSubprocessProtocol`
-     * @returns A new `AdbSubprocessProtocol` instance connecting to the spawned process.
-     */
-    shell(command, options) {
-        return this.#createProtocol("pty", command, options);
-    }
-    /**
-     * Spawns an executable and redirect the standard input/output stream.
-     *
-     * Redirection mode is enough for most simple commands, but PTY mode is required for
-     * commands that manipulate the terminal, such as `vi` and `less`.
-     * @param command The command to run, or an array of strings containing both command and args.
-     * @param options The options for creating the `AdbSubprocessProtocol`
-     * @returns A new `AdbSubprocessProtocol` instance connecting to the spawned process.
-     */
-    spawn(command, options) {
-        return this.#createProtocol("raw", 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 `AdbSubprocessProtocol`
-     * @returns The entire output of the command
-     */
-    async spawnAndWait(command, options) {
-        const process = await this.spawn(command, options);
-        const [stdout, stderr, exitCode] = await Promise.all([
-            process.stdout
-                .pipeThrough(new TextDecoderStream())
-                .pipeThrough(new ConcatStringStream()),
-            process.stderr
-                .pipeThrough(new TextDecoderStream())
-                .pipeThrough(new ConcatStringStream()),
-            process.exit,
-        ]);
-        return {
-            stdout,
-            stderr,
-            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: [AdbSubprocessNoneProtocol],
-        });
-        return stdout;
-    }
-}
-//# sourceMappingURL=command.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"command.js","sourceRoot":"","sources":["../../../src/commands/subprocess/command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEhF,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAM5C,OAAO,EACH,yBAAyB,EACzB,0BAA0B,GAC7B,MAAM,sBAAsB,CAAC;AAiB9B,MAAM,eAAe,GAAyB;IAC1C,SAAS,EAAE,CAAC,0BAA0B,EAAE,yBAAyB,CAAC;CACrE,CAAC;AAQF,MAAM,OAAO,aAAc,SAAQ,cAAc;IAC7C,KAAK,CAAC,eAAe,CACjB,IAAmB,EACnB,OAA2B,EAC3B,OAAuC;QAEvC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,eAAe,EAAE,GAAG,OAAO,EAAE,CAAC;QAEzD,IAAI,WAAyD,CAAC;QAC9D,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC3B,uCAAuC;YACvC,IAAI,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBACnC,WAAW,GAAG,IAAI,CAAC;gBACnB,MAAM;YACV,CAAC;QACL,CAAC;QAED,IAAI,CAAC,WAAW,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACxE,CAAC;QAED,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACzB,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChC,CAAC;aAAM,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC/B,0BAA0B;YAC1B,OAAO,GAAG,EAAE,CAAC;QACjB,CAAC;QACD,OAAO,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CACD,OAA2B,EAC3B,OAAuC;QAEvC,OAAO,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CACD,OAA0B,EAC1B,OAAuC;QAEvC,OAAO,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,YAAY,CACd,OAA0B,EAC1B,OAAuC;QAEvC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAEnD,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACjD,OAAO,CAAC,MAAM;iBACT,WAAW,CAAC,IAAI,iBAAiB,EAAE,CAAC;iBACpC,WAAW,CAAC,IAAI,kBAAkB,EAAE,CAAC;YAC1C,OAAO,CAAC,MAAM;iBACT,WAAW,CAAC,IAAI,iBAAiB,EAAE,CAAC;iBACpC,WAAW,CAAC,IAAI,kBAAkB,EAAE,CAAC;YAC1C,OAAO,CAAC,IAAI;SACf,CAAC,CAAC;QAEH,OAAO;YACH,MAAM;YACN,MAAM;YACN,QAAQ;SACX,CAAC;IACN,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,kBAAkB,CAAC,OAA0B;QAC/C,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE;YAChD,SAAS,EAAE,CAAC,yBAAyB,CAAC;SACzC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAClB,CAAC;CACJ"}

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

@@ -1,4 +0,0 @@
-export * from "./none.js";
-export * from "./shell.js";
-export * from "./types.js";
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/subprocess/protocols/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

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

@@ -1,4 +0,0 @@
-export * from "./none.js";
-export * from "./shell.js";
-export * from "./types.js";
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/commands/subprocess/protocols/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/esm/commands/subprocess/protocols/none.d.ts

@@ -1,32 +0,0 @@
-import type { MaybeConsumable, WritableStream } from "@yume-chan/stream-extra";
-import { ReadableStream } from "@yume-chan/stream-extra";
-import type { Adb, AdbSocket } from "../../../adb.js";
-import type { AdbSubprocessProtocol } from "./types.js";
-/**
- * The legacy shell
- *
- * Features:
- * * `stderr`: No
- * * `exit` exit code: No
- * * `resize`: No
- */
-export declare class AdbSubprocessNoneProtocol implements AdbSubprocessProtocol {
-    #private;
-    static isSupported(): boolean;
-    static pty(adb: Adb, command: string): Promise<AdbSubprocessNoneProtocol>;
-    static raw(adb: Adb, command: string): Promise<AdbSubprocessNoneProtocol>;
-    get stdin(): WritableStream<MaybeConsumable<Uint8Array>>;
-    /**
-     * Legacy shell mixes stdout and stderr.
-     */
-    get stdout(): ReadableStream<Uint8Array>;
-    /**
-     * `stderr` will always be empty.
-     */
-    get stderr(): ReadableStream<Uint8Array>;
-    get exit(): Promise<number>;
-    constructor(socket: AdbSocket);
-    resize(): void;
-    kill(): Promise<void>;
-}
-//# sourceMappingURL=none.d.ts.map

package/esm/commands/subprocess/protocols/none.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"none.d.ts","sourceRoot":"","sources":["../../../../src/commands/subprocess/protocols/none.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD;;;;;;;GAOG;AACH,qBAAa,yBAA0B,YAAW,qBAAqB;;IACnE,MAAM,CAAC,WAAW;WAIL,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM;WAM7B,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM;IAW1C,IAAI,KAAK,IAAI,cAAc,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,CAEvD;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,cAAc,CAAC,UAAU,CAAC,CAEvC;IAGD;;OAEG;IACH,IAAI,MAAM,IAAI,cAAc,CAAC,UAAU,CAAC,CAEvC;IAGD,IAAI,IAAI,oBAEP;gBAEW,MAAM,EAAE,SAAS;IAY7B,MAAM;IAIA,IAAI;CAGb"}

package/esm/commands/subprocess/protocols/none.js

@@ -1,61 +0,0 @@
-import { ReadableStream } from "@yume-chan/stream-extra";
-/**
- * The legacy shell
- *
- * Features:
- * * `stderr`: No
- * * `exit` exit code: No
- * * `resize`: No
- */
-export class AdbSubprocessNoneProtocol {
-    static isSupported() {
-        return true;
-    }
-    static async pty(adb, command) {
-        return new AdbSubprocessNoneProtocol(await adb.createSocket(`shell:${command}`));
-    }
-    static async raw(adb, command) {
-        // `shell,raw:${command}` also triggers raw mode,
-        // But is not supported on Android version <7.
-        return new AdbSubprocessNoneProtocol(await adb.createSocket(`exec:${command}`));
-    }
-    #socket;
-    // Legacy shell forwards all data to stdin.
-    get stdin() {
-        return this.#socket.writable;
-    }
-    /**
-     * Legacy shell mixes stdout and stderr.
-     */
-    get stdout() {
-        return this.#socket.readable;
-    }
-    #stderr;
-    /**
-     * `stderr` will always be empty.
-     */
-    get stderr() {
-        return this.#stderr;
-    }
-    #exit;
-    get exit() {
-        return this.#exit;
-    }
-    constructor(socket) {
-        this.#socket = socket;
-        this.#stderr = new ReadableStream({
-            start: async (controller) => {
-                await this.#socket.closed;
-                controller.close();
-            },
-        });
-        this.#exit = socket.closed.then(() => 0);
-    }
-    resize() {
-        // Not supported, but don't throw.
-    }
-    async kill() {
-        await this.#socket.close();
-    }
-}
-//# sourceMappingURL=none.js.map

package/esm/commands/subprocess/protocols/none.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"none.js","sourceRoot":"","sources":["../../../../src/commands/subprocess/protocols/none.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAMzD;;;;;;;GAOG;AACH,MAAM,OAAO,yBAAyB;IAClC,MAAM,CAAC,WAAW;QACd,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,GAAQ,EAAE,OAAe;QACtC,OAAO,IAAI,yBAAyB,CAChC,MAAM,GAAG,CAAC,YAAY,CAAC,SAAS,OAAO,EAAE,CAAC,CAC7C,CAAC;IACN,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,GAAQ,EAAE,OAAe;QACtC,iDAAiD;QACjD,8CAA8C;QAC9C,OAAO,IAAI,yBAAyB,CAChC,MAAM,GAAG,CAAC,YAAY,CAAC,QAAQ,OAAO,EAAE,CAAC,CAC5C,CAAC;IACN,CAAC;IAEQ,OAAO,CAAY;IAE5B,2CAA2C;IAC3C,IAAI,KAAK;QACL,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,IAAI,MAAM;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;IACjC,CAAC;IAED,OAAO,CAA6B;IACpC;;OAEG;IACH,IAAI,MAAM;QACN,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,KAAK,CAAkB;IACvB,IAAI,IAAI;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,YAAY,MAAiB;QACzB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QAEtB,IAAI,CAAC,OAAO,GAAG,IAAI,cAAc,CAAC;YAC9B,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE;gBACxB,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;gBAC1B,UAAU,CAAC,KAAK,EAAE,CAAC;YACvB,CAAC;SACJ,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM;QACF,kCAAkC;IACtC,CAAC;IAED,KAAK,CAAC,IAAI;QACN,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;CACJ"}

package/esm/commands/subprocess/protocols/shell.d.ts

@@ -1,42 +0,0 @@
-import type { ReadableStream } from "@yume-chan/stream-extra";
-import { MaybeConsumable, WritableStream } from "@yume-chan/stream-extra";
-import type { Adb, AdbSocket } from "../../../adb.js";
-import type { AdbSubprocessProtocol } from "./types.js";
-export declare const AdbShellProtocolId: {
-    readonly Stdin: 0;
-    readonly Stdout: 1;
-    readonly Stderr: 2;
-    readonly Exit: 3;
-    readonly CloseStdin: 4;
-    readonly WindowSizeChange: 5;
-};
-export type AdbShellProtocolId = (typeof AdbShellProtocolId)[keyof typeof AdbShellProtocolId];
-export declare const AdbShellProtocolPacket: import("@yume-chan/struct").Struct<{
-    id: import("@yume-chan/struct").Field<AdbShellProtocolId, never, never>;
-    data: import("@yume-chan/struct").Field<Uint8Array<ArrayBufferLike>, never, never>;
-}, {}, import("@yume-chan/struct").FieldsType<{
-    id: import("@yume-chan/struct").Field<AdbShellProtocolId, never, never>;
-    data: import("@yume-chan/struct").Field<Uint8Array<ArrayBufferLike>, never, never>;
-}>>;
-/**
- * Shell v2 a.k.a Shell Protocol
- *
- * Features:
- * * `stderr`: Yes
- * * `exit` exit code: Yes
- * * `resize`: Yes
- */
-export declare class AdbSubprocessShellProtocol implements AdbSubprocessProtocol {
-    #private;
-    static isSupported(adb: Adb): boolean;
-    static pty(adb: Adb, command: string): Promise<AdbSubprocessShellProtocol>;
-    static raw(adb: Adb, command: string): Promise<AdbSubprocessShellProtocol>;
-    get stdin(): WritableStream<MaybeConsumable<Uint8Array<ArrayBufferLike>>>;
-    get stdout(): ReadableStream<Uint8Array<ArrayBufferLike>>;
-    get stderr(): ReadableStream<Uint8Array<ArrayBufferLike>>;
-    get exit(): Promise<number>;
-    constructor(socket: AdbSocket);
-    resize(rows: number, cols: number): Promise<void>;
-    kill(): import("@yume-chan/async").MaybePromiseLike<void>;
-}
-//# sourceMappingURL=shell.d.ts.map

package/esm/commands/subprocess/protocols/shell.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../../../src/commands/subprocess/protocols/shell.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAER,cAAc,EAEjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACH,eAAe,EAGf,cAAc,EACjB,MAAM,yBAAyB,CAAC;AAIjC,OAAO,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAItD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,eAAO,MAAM,kBAAkB;;;;;;;CAOrB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAC1B,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAGjE,eAAO,MAAM,sBAAsB;;;;;;GAMlC,CAAC;AAIF;;;;;;;GAOG;AACH,qBAAa,0BAA2B,YAAW,qBAAqB;;IACpE,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG;WAId,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM;WAO7B,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM;IAU1C,IAAI,KAAK,iEAER;IAGD,IAAI,MAAM,gDAET;IAGD,IAAI,MAAM,gDAET;IAGD,IAAI,IAAI,oBAEP;gBAEW,MAAM,EAAE,SAAS;IA8DvB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAYvC,IAAI;CAGP"}

package/esm/commands/subprocess/protocols/shell.js.map

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

package/esm/commands/subprocess/protocols/types.d.ts

@@ -1,49 +0,0 @@
-import type { MaybePromiseLike } from "@yume-chan/async";
-import type { MaybeConsumable, ReadableStream, WritableStream } from "@yume-chan/stream-extra";
-import type { Adb, AdbSocket } from "../../../adb.js";
-export interface AdbSubprocessProtocol {
-    /**
-     * A WritableStream that writes to the `stdin` stream.
-     */
-    readonly stdin: WritableStream<MaybeConsumable<Uint8Array>>;
-    /**
-     * The `stdout` stream of the process.
-     */
-    readonly stdout: ReadableStream<Uint8Array>;
-    /**
-     * The `stderr` stream of the process.
-     *
-     * Note: Some `AdbSubprocessProtocol` doesn't separate `stdout` and `stderr`,
-     * All output will be sent to `stdout`.
-     */
-    readonly stderr: ReadableStream<Uint8Array>;
-    /**
-     * A `Promise` that resolves to the exit code of the process.
-     *
-     * Note: Some `AdbSubprocessProtocol` doesn't support exit code,
-     * They will always resolve it with `0`.
-     */
-    readonly exit: Promise<number>;
-    /**
-     * Resizes the current shell.
-     *
-     * Some `AdbSubprocessProtocol`s may not support resizing
-     * and will ignore calls to this method.
-     */
-    resize(rows: number, cols: number): MaybePromiseLike<void>;
-    /**
-     * Kills the current process.
-     */
-    kill(): MaybePromiseLike<void>;
-}
-export interface AdbSubprocessProtocolConstructor {
-    /** Returns `true` if the `adb` instance supports this shell */
-    isSupported(adb: Adb): MaybePromiseLike<boolean>;
-    /** Spawns an executable in PTY (interactive) mode. */
-    pty(adb: Adb, command: string): MaybePromiseLike<AdbSubprocessProtocol>;
-    /** Spawns an executable and pipe the output. */
-    raw(adb: Adb, command: string): MaybePromiseLike<AdbSubprocessProtocol>;
-    /** Creates a new `AdbShell` by attaching to an exist `AdbSocket` */
-    new (socket: AdbSocket): AdbSubprocessProtocol;
-}
-//# sourceMappingURL=types.d.ts.map

package/esm/commands/subprocess/protocols/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/commands/subprocess/protocols/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EACR,eAAe,EACf,cAAc,EACd,cAAc,EACjB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEtD,MAAM,WAAW,qBAAqB;IAClC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC;IAE5D;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IAE5C;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IAE5C;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAE/B;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAE3D;;OAEG;IACH,IAAI,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,gCAAgC;IAC7C,+DAA+D;IAC/D,WAAW,CAAC,GAAG,EAAE,GAAG,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAEjD,sDAAsD;IACtD,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAAC,qBAAqB,CAAC,CAAC;IAExE,gDAAgD;IAChD,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAAC,qBAAqB,CAAC,CAAC;IAExE,oEAAoE;IACpE,KAAK,MAAM,EAAE,SAAS,GAAG,qBAAqB,CAAC;CAClD"}

package/esm/commands/subprocess/protocols/types.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=types.js.map

package/esm/commands/subprocess/protocols/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/commands/subprocess/protocols/types.ts"],"names":[],"mappings":""}

package/src/commands/subprocess/command.ts

@@ -1,141 +0,0 @@
-import { ConcatStringStream, TextDecoderStream } from "@yume-chan/stream-extra";
-
-import { AdbCommandBase } from "../base.js";
-
-import type {
-    AdbSubprocessProtocol,
-    AdbSubprocessProtocolConstructor,
-} from "./protocols/index.js";
-import {
-    AdbSubprocessNoneProtocol,
-    AdbSubprocessShellProtocol,
-} from "./protocols/index.js";
-
-export interface AdbSubprocessOptions {
-    /**
-     * A list of `AdbSubprocessProtocolConstructor`s to be used.
-     *
-     * Different `AdbSubprocessProtocol` has different capabilities, thus requires specific adaptations.
-     * Check their documentations for details.
-     *
-     * The first protocol whose `isSupported` returns `true` will be used.
-     * If no `AdbSubprocessProtocol` is supported, an error will be thrown.
-     *
-     * @default [AdbSubprocessShellProtocol, AdbSubprocessNoneProtocol]
-     */
-    protocols: AdbSubprocessProtocolConstructor[];
-}
-
-const DEFAULT_OPTIONS: AdbSubprocessOptions = {
-    protocols: [AdbSubprocessShellProtocol, AdbSubprocessNoneProtocol],
-};
-
-export interface AdbSubprocessWaitResult {
-    stdout: string;
-    stderr: string;
-    exitCode: number;
-}
-
-export class AdbSubprocess extends AdbCommandBase {
-    async #createProtocol(
-        mode: "pty" | "raw",
-        command?: string | string[],
-        options?: Partial<AdbSubprocessOptions>,
-    ): Promise<AdbSubprocessProtocol> {
-        const { protocols } = { ...DEFAULT_OPTIONS, ...options };
-
-        let Constructor: AdbSubprocessProtocolConstructor | undefined;
-        for (const item of protocols) {
-            // It's async so can't use `Array#find`
-            if (await item.isSupported(this.adb)) {
-                Constructor = item;
-                break;
-            }
-        }
-
-        if (!Constructor) {
-            throw new Error("No specified protocol is supported by the device");
-        }
-
-        if (Array.isArray(command)) {
-            command = command.join(" ");
-        } else if (command === undefined) {
-            // spawn the default shell
-            command = "";
-        }
-        return await Constructor[mode](this.adb, command);
-    }
-
-    /**
-     * Spawns an executable in PTY mode.
-     *
-     * Redirection mode is enough for most simple commands, but PTY mode is required for
-     * commands that manipulate the terminal, such as `vi` and `less`.
-     * @param command The command to run. If omitted, the default shell will be spawned.
-     * @param options The options for creating the `AdbSubprocessProtocol`
-     * @returns A new `AdbSubprocessProtocol` instance connecting to the spawned process.
-     */
-    shell(
-        command?: string | string[],
-        options?: Partial<AdbSubprocessOptions>,
-    ): Promise<AdbSubprocessProtocol> {
-        return this.#createProtocol("pty", command, options);
-    }
-
-    /**
-     * Spawns an executable and redirect the standard input/output stream.
-     *
-     * Redirection mode is enough for most simple commands, but PTY mode is required for
-     * commands that manipulate the terminal, such as `vi` and `less`.
-     * @param command The command to run, or an array of strings containing both command and args.
-     * @param options The options for creating the `AdbSubprocessProtocol`
-     * @returns A new `AdbSubprocessProtocol` instance connecting to the spawned process.
-     */
-    spawn(
-        command: string | string[],
-        options?: Partial<AdbSubprocessOptions>,
-    ): Promise<AdbSubprocessProtocol> {
-        return this.#createProtocol("raw", 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 `AdbSubprocessProtocol`
-     * @returns The entire output of the command
-     */
-    async spawnAndWait(
-        command: string | string[],
-        options?: Partial<AdbSubprocessOptions>,
-    ): Promise<AdbSubprocessWaitResult> {
-        const process = await this.spawn(command, options);
-
-        const [stdout, stderr, exitCode] = await Promise.all([
-            process.stdout
-                .pipeThrough(new TextDecoderStream())
-                .pipeThrough(new ConcatStringStream()),
-            process.stderr
-                .pipeThrough(new TextDecoderStream())
-                .pipeThrough(new ConcatStringStream()),
-            process.exit,
-        ]);
-
-        return {
-            stdout,
-            stderr,
-            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: string | string[]): Promise<string> {
-        const { stdout } = await this.spawnAndWait(command, {
-            protocols: [AdbSubprocessNoneProtocol],
-        });
-        return stdout;
-    }
-}

package/src/commands/subprocess/protocols/index.ts

@@ -1,3 +0,0 @@
-export * from "./none.js";
-export * from "./shell.js";
-export * from "./types.js";

package/src/commands/subprocess/protocols/none.ts

@@ -1,81 +0,0 @@
-import type { MaybeConsumable, WritableStream } from "@yume-chan/stream-extra";
-import { ReadableStream } from "@yume-chan/stream-extra";
-
-import type { Adb, AdbSocket } from "../../../adb.js";
-
-import type { AdbSubprocessProtocol } from "./types.js";
-
-/**
- * The legacy shell
- *
- * Features:
- * * `stderr`: No
- * * `exit` exit code: No
- * * `resize`: No
- */
-export class AdbSubprocessNoneProtocol implements AdbSubprocessProtocol {
-    static isSupported() {
-        return true;
-    }
-
-    static async pty(adb: Adb, command: string) {
-        return new AdbSubprocessNoneProtocol(
-            await adb.createSocket(`shell:${command}`),
-        );
-    }
-
-    static async raw(adb: Adb, command: string) {
-        // `shell,raw:${command}` also triggers raw mode,
-        // But is not supported on Android version <7.
-        return new AdbSubprocessNoneProtocol(
-            await adb.createSocket(`exec:${command}`),
-        );
-    }
-
-    readonly #socket: AdbSocket;
-
-    // Legacy shell forwards all data to stdin.
-    get stdin(): WritableStream<MaybeConsumable<Uint8Array>> {
-        return this.#socket.writable;
-    }
-
-    /**
-     * Legacy shell mixes stdout and stderr.
-     */
-    get stdout(): ReadableStream<Uint8Array> {
-        return this.#socket.readable;
-    }
-
-    #stderr: ReadableStream<Uint8Array>;
-    /**
-     * `stderr` will always be empty.
-     */
-    get stderr(): ReadableStream<Uint8Array> {
-        return this.#stderr;
-    }
-
-    #exit: Promise<number>;
-    get exit() {
-        return this.#exit;
-    }
-
-    constructor(socket: AdbSocket) {
-        this.#socket = socket;
-
-        this.#stderr = new ReadableStream({
-            start: async (controller) => {
-                await this.#socket.closed;
-                controller.close();
-            },
-        });
-        this.#exit = socket.closed.then(() => 0);
-    }
-
-    resize() {
-        // Not supported, but don't throw.
-    }
-
-    async kill() {
-        await this.#socket.close();
-    }
-}