@yume-chan/adb 0.0.0-20240714132542

package/CHANGELOG.md

@@ -0,0 +1,178 @@
+# Change Log - @yume-chan/adb
+
+## 0.0.0-20240714132542
+
+### Patch Changes
+
+-   Switch to PNPM workspace and changesets
+-   Updated dependencies
+    -   @yume-chan/no-data-view@0.0.0-20240714132542
+    -   @yume-chan/stream-extra@0.0.0-20240714132542
+    -   @yume-chan/struct@0.0.0-20240714132542
+    -   @yume-chan/event@0.0.0-20240714132542
+
+This log was last generated on Tue, 18 Jun 2024 02:49:43 GMT and should not be manually modified.
+
+## 0.0.24
+
+Tue, 18 Jun 2024 02:49:43 GMT
+
+### Updates
+
+-   Allow streams to accept both `Uint8Array` and `Consumable<Uint8Array>` as inputs
+-   Rename `AdbDaemonTransport`'s `debugSlowRead` option to `readTimeLimit`. Allow users to specify a custom timeout for read operations. It's still disabled by default.
+-   Include unauthorized devices in `AdbServerClient#getDevices()` and `AdbServerClient#trackDevices()`. You need to filter them out if you don't need them.
+-   Add more methods to `AdbServerClient`
+-   Group `AdbServerClient`-relating types into namespace. In future, more types will be moved to namespaces.
+-   Fix `Adb#reverse#list()` returning an extra empty object.
+-   Fix reverse tunnel handler not invoked.
+-   Fix too many event listener warning in Node.js.
+
+## 0.0.23
+
+Thu, 21 Mar 2024 03:15:10 GMT
+
+### Updates
+
+-   Refactor `AdbSubprocessShellProtocol` (this shouldn't affect usage)
+-   Add `AdbServerClient.trackDevices`, which runs a callback function whenever device list changes
+-   Add support for delayed ack on Android 14
+
+## 0.0.22
+
+Wed, 13 Dec 2023 05:57:27 GMT
+
+### Updates
+
+-   Add `getListenAddresses` method to `AdbTcpIpCommand` class for retrieving current ADB over WiFi state
+-   Add `debugSlowRead` option to `AdbDaemonTransport` that throws an error when an ADB socket is stalled for 5 seconds
+-   Fix `AdbSync#read` stuck when there is an error
+-   Fix TypeScript build when using `AdbSubprocessNoneProtocol` without installing `web-streams-polyfill` package
+
+## 0.0.21
+
+Fri, 25 Aug 2023 14:05:18 GMT
+
+### Updates
+
+-   Change `AdbSync` to throws `AdbSyncError` for errors returned by ADB Daemon
+-   Add name for public keys
+-   Add typed errors for `framebuffer` command when current app disables screen capture
+-   Change `AdbDaemonTransport` class to automatically close the connection, unless the new `preserveConnection` option is `true`
+-   Add `recursive` and `force` options to `rm` method, allow deleting folders
+
+## 0.0.20
+
+Mon, 05 Jun 2023 02:51:41 GMT
+
+### Updates
+
+-   Use ECMAScript private class fields syntax (supported by Chrome 74, Firefox 90, Safari 14.1 and Node.js 12.0.0).
+-   Refactor `AdbSubprocessShellProtocol` class, this should improve some performance.
+-   Split `mode` parameter in `AdbSync#write()` into `type` and `permission` for ease of use.
+-   Add `AdbReverseCommand#addExternal()`. This only register the reverse tunnel to the device, the handler should already exists (for example you are adding a reverse tunnel for an external program that's already listening on the port). In ADB direct connection, this should do nothing, because the reverse tunnel is handled by this library and there is no mean of "external" handler.
+-   Change `AdbTcpIpCommand#setPort` and `AdbTcpIpCommand#disable` to return or throw the response text. This can be displayed to the user to know what's wrong.
+-   Add support for connecting to ADB servers. Because a USB device can only be used by one process at a time, the ADB server is the process that manages all connected devices. The server proxies and multiplexes connections from ADB clients so multiple adb commands can be executed on one device at the same time. The `Adb` class is no longer responsible for connecting and authenticating with ADB daemons. The `AdbTransport` interface and its two implementations `AdbDaemonTransport` and `AdbServerTransport` was added to connect to either ADB daemons or servers in compatible environments. Read the PR for details, migration paths, and examples. ([#549](https://github.com/yume-chan/ya-webadb/pull/549))
+-   Add `serial` field to `Adb` class.
+-   Group `product`, `model`, `device` and `features` fields on `Adb` class to the `banner` field with type of `AdbBanner`.
+
+## 0.0.19
+
+Sun, 09 Apr 2023 05:55:33 GMT
+
+### Updates
+
+-   Remove `Adb#install` in favor of `PackageManager#install` from `@yume-chan/android-bin` package
+-   Change `AdbSync#write` to take a `ReadableStream<Uint8Array>` instead of returning a `WritableStream<Uint8Array>`
+-   Add buffering in sync module to improve transfer speed
+-   Add `AdbReverseError` and `AdbReverseNotSupportedError` for better error handling in reverse tunnel command.
+
+## 0.0.18
+
+Wed, 25 Jan 2023 21:33:49 GMT
+
+_Version update only_
+
+## 0.0.17
+
+Tue, 18 Oct 2022 09:32:30 GMT
+
+### Updates
+
+-   Move stream utils to separate package
+
+## 0.0.16
+
+Sat, 28 May 2022 03:56:37 GMT
+
+### Updates
+
+-   Upgrade TypeScript to 4.7.2 to enable Node.js ESM
+-   Upgrade web-streams-polyfill to 4.0.0-beta.3, fix an issue where `Adb#close()` doesn't release the connection.
+-   Fix an issue where `AdbSocket#readable#cancel()` stalls the connection.
+-   Improve performance of `BufferedStream` by up to 100%.
+
+## 0.0.15
+
+Mon, 02 May 2022 04:18:01 GMT
+
+### Updates
+
+-   Add support for old protocol of `reverse:forward` command before Android 8
+-   Improve connection lifecycle handling
+-   Update `reverse.add` to accept any string local address
+-   Fix an issue where `reverse` commands doesn't parse error message correctly
+
+## 0.0.14
+
+Sat, 30 Apr 2022 14:05:48 GMT
+
+### Updates
+
+-   Fix an issue where `subprocess.spawn` doesn't work on Android 6
+-   Add an `Adb#close()` method to gracefully shutdown a connection
+
+## 0.0.13
+
+Thu, 28 Apr 2022 01:23:53 GMT
+
+### Updates
+
+-   Add support for raw shell mode
+-   Add support for LIS2 command in Sync protocol
+-   Add workaround for the push_mkdir issue in Android 9
+
+## 0.0.12
+
+Sun, 03 Apr 2022 11:18:47 GMT
+
+_Version update only_
+
+## 0.0.11
+
+Sun, 03 Apr 2022 10:54:15 GMT
+
+### Patches
+
+-   Update to use Web Streams API
+-   Improve compatibility with Node.js 12 ESM format
+
+### Updates
+
+-   Add power related API
+-   Update compatibility matrix
+-   Update license year
+
+## 0.0.10
+
+Sun, 09 Jan 2022 15:52:20 GMT
+
+### Updates
+
+-   Remove `encodeUtf8()` and `decodeUtf8()` from `AdbBackend`
+
+## 0.0.9
+
+Sun, 09 Jan 2022 15:50:20 GMT
+
+_Initial release_

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020-2024 Simon Chan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,49 @@
+<p align="center">
+    <img alt="Tango" src="https://raw.githubusercontent.com/yume-chan/ya-webadb/main/.github/logo.svg" width="200">
+</p>
+
+<h1 align="center">@yume-chan/adb</h1>
+
+<p align="center">
+    TypeScript implementation of Android Debug Bridge (ADB) protocol.
+</p>
+
+<p align="center">
+    <a href="https://github.com/yume-chan/ya-webadb/blob/main/LICENSE">
+        <img alt="MIT License" src="https://img.shields.io/github/license/yume-chan/ya-webadb">
+    </a>
+    <a href="https://github.com/yume-chan/ya-webadb/releases">
+        <img alt="GitHub release" src="https://img.shields.io/github/v/release/yume-chan/ya-webadb?logo=github">
+    </a>
+    <a href="https://bundlephobia.com/package/@yume-chan/adb">
+        <img alt="Package Size" src="https://img.shields.io/bundlephobia/minzip/%40yume-chan%2Fadb">
+    </a>
+    <a href="https://www.npmjs.com/package/@yume-chan/adb">
+        <img alt="npm" src="https://img.shields.io/npm/dm/%40yume-chan/adb?logo=npm">
+    </a>
+    <a href="https://discord.gg/26k3ttC2PN">
+        <img alt="Discord" src="https://img.shields.io/discord/1120215514732564502?logo=discord&logoColor=%23ffffff&label=Discord">
+    </a>
+</p>
+
+This package is part of [Tango ADB](https://github.com/yume-chan/ya-webadb). Generally you need multiple packages to build a complete ADB client that can run on Web browsers and Node.js. Read the documentation for more information.
+
+## Documentation
+
+Check the latest documentation at https://docs.tangoapp.dev/
+
+## Sponsors
+
+[Become a backer](https://opencollective.com/ya-webadb) and get your image on our README on Github with a link to your site.
+
+<a href="https://opencollective.com/ya-webadb/backer/0/website?requireActive=false" target="_blank"><img src="https://opencollective.com/ya-webadb/backer/0/avatar.svg?requireActive=false"></a>
+<a href="https://opencollective.com/ya-webadb/backer/1/website?requireActive=false" target="_blank"><img src="https://opencollective.com/ya-webadb/backer/1/avatar.svg?requireActive=false"></a>
+<a href="https://opencollective.com/ya-webadb/backer/2/website?requireActive=false" target="_blank"><img src="https://opencollective.com/ya-webadb/backer/2/avatar.svg?requireActive=false"></a>
+<a href="https://opencollective.com/ya-webadb/backer/3/website?requireActive=false" target="_blank"><img src="https://opencollective.com/ya-webadb/backer/3/avatar.svg?requireActive=false"></a>
+<a href="https://opencollective.com/ya-webadb/backer/4/website?requireActive=false" target="_blank"><img src="https://opencollective.com/ya-webadb/backer/4/avatar.svg?requireActive=false"></a>
+<a href="https://opencollective.com/ya-webadb/backer/5/website?requireActive=false" target="_blank"><img src="https://opencollective.com/ya-webadb/backer/5/avatar.svg?requireActive=false"></a>
+<a href="https://opencollective.com/ya-webadb/backer/6/website?requireActive=false" target="_blank"><img src="https://opencollective.com/ya-webadb/backer/6/avatar.svg?requireActive=false"></a>
+<a href="https://opencollective.com/ya-webadb/backer/7/website?requireActive=false" target="_blank"><img src="https://opencollective.com/ya-webadb/backer/7/avatar.svg?requireActive=false"></a>
+<a href="https://opencollective.com/ya-webadb/backer/8/website?requireActive=false" target="_blank"><img src="https://opencollective.com/ya-webadb/backer/8/avatar.svg?requireActive=false"></a>
+<a href="https://opencollective.com/ya-webadb/backer/9/website?requireActive=false" target="_blank"><img src="https://opencollective.com/ya-webadb/backer/9/avatar.svg?requireActive=false"></a>
+<a href="https://opencollective.com/ya-webadb/backer/10/website?requireActive=false" target="_blank"><img src="https://opencollective.com/ya-webadb/backer/10/avatar.svg?requireActive=false"></a>

package/esm/adb.d.ts

@@ -0,0 +1,51 @@
+import type { MaybeConsumable, ReadableWritablePair } from "@yume-chan/stream-extra";
+import type { ValueOrPromise } from "@yume-chan/struct";
+import type { AdbBanner } from "./banner.js";
+import type { AdbFrameBuffer } from "./commands/index.js";
+import { AdbPower, AdbReverseCommand, AdbSubprocess, AdbSync, AdbTcpIpCommand } from "./commands/index.js";
+import type { AdbFeature } from "./features.js";
+export interface Closeable {
+    close(): ValueOrPromise<void>;
+}
+export interface AdbSocket extends ReadableWritablePair<Uint8Array, MaybeConsumable<Uint8Array>>, Closeable {
+    get service(): string;
+    get closed(): Promise<void>;
+}
+export type AdbIncomingSocketHandler = (socket: AdbSocket) => ValueOrPromise<void>;
+export interface AdbTransport extends Closeable {
+    readonly serial: string;
+    readonly maxPayloadSize: number;
+    readonly banner: AdbBanner;
+    readonly disconnected: Promise<void>;
+    readonly clientFeatures: readonly AdbFeature[];
+    connect(service: string): ValueOrPromise<AdbSocket>;
+    addReverseTunnel(handler: AdbIncomingSocketHandler, address?: string): ValueOrPromise<string>;
+    removeReverseTunnel(address: string): ValueOrPromise<void>;
+    clearReverseTunnels(): ValueOrPromise<void>;
+}
+export declare class Adb implements Closeable {
+    readonly transport: AdbTransport;
+    get serial(): string;
+    get maxPayloadSize(): number;
+    get banner(): AdbBanner;
+    get disconnected(): Promise<void>;
+    get clientFeatures(): readonly AdbFeature[];
+    get deviceFeatures(): AdbFeature[];
+    readonly subprocess: AdbSubprocess;
+    readonly power: AdbPower;
+    readonly reverse: AdbReverseCommand;
+    readonly tcpip: AdbTcpIpCommand;
+    constructor(transport: AdbTransport);
+    canUseFeature(feature: AdbFeature): boolean;
+    createSocket(service: string): Promise<AdbSocket>;
+    createSocketAndWait(service: string): Promise<string>;
+    getProp(key: string): Promise<string>;
+    rm(filenames: string | string[], options?: {
+        recursive?: boolean;
+        force?: boolean;
+    }): Promise<string>;
+    sync(): Promise<AdbSync>;
+    framebuffer(): Promise<AdbFrameBuffer>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=adb.d.ts.map

package/esm/adb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adb.d.ts","sourceRoot":"","sources":["../src/adb.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,eAAe,EACf,oBAAoB,EACvB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EACH,QAAQ,EACR,iBAAiB,EACjB,aAAa,EACb,OAAO,EACP,eAAe,EAGlB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,WAAW,SAAS;IACtB,KAAK,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,SACb,SAAQ,oBAAoB,CAAC,UAAU,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC,EACjE,SAAS;IACb,IAAI,OAAO,IAAI,MAAM,CAAC;IAEtB,IAAI,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED,MAAM,MAAM,wBAAwB,GAAG,CACnC,MAAM,EAAE,SAAS,KAChB,cAAc,CAAC,IAAI,CAAC,CAAC;AAE1B,MAAM,WAAW,YAAa,SAAQ,SAAS;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEhC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAE3B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAErC,QAAQ,CAAC,cAAc,EAAE,SAAS,UAAU,EAAE,CAAC;IAE/C,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IAEpD,gBAAgB,CACZ,OAAO,EAAE,wBAAwB,EACjC,OAAO,CAAC,EAAE,MAAM,GACjB,cAAc,CAAC,MAAM,CAAC,CAAC;IAE1B,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAE3D,mBAAmB,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED,qBAAa,GAAI,YAAW,SAAS;IACjC,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IAEjC,IAAI,MAAM,WAET;IAED,IAAI,cAAc,WAEjB;IAED,IAAI,MAAM,cAET;IAED,IAAI,YAAY,kBAEf;IAED,IAAW,cAAc,0BAExB;IAED,IAAW,cAAc,iBAExB;IAED,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;gBAEpB,SAAS,EAAE,YAAY;IASnC,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO;IAOrC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAIjD,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAOrD,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQrC,EAAE,CACJ,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,EAC5B,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GACnD,OAAO,CAAC,MAAM,CAAC;IAqBZ,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAKxB,WAAW,IAAI,OAAO,CAAC,cAAc,CAAC;IAItC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B"}

package/esm/adb.js

@@ -0,0 +1,86 @@
+import { ConcatStringStream, TextDecoderStream } from "@yume-chan/stream-extra";
+import { AdbPower, AdbReverseCommand, AdbSubprocess, AdbSync, AdbTcpIpCommand, escapeArg, framebuffer, } from "./commands/index.js";
+export class Adb {
+    transport;
+    get serial() {
+        return this.transport.serial;
+    }
+    get maxPayloadSize() {
+        return this.transport.maxPayloadSize;
+    }
+    get banner() {
+        return this.transport.banner;
+    }
+    get disconnected() {
+        return this.transport.disconnected;
+    }
+    get clientFeatures() {
+        return this.transport.clientFeatures;
+    }
+    get deviceFeatures() {
+        return this.banner.features;
+    }
+    subprocess;
+    power;
+    reverse;
+    tcpip;
+    constructor(transport) {
+        this.transport = transport;
+        this.subprocess = new AdbSubprocess(this);
+        this.power = new AdbPower(this);
+        this.reverse = new AdbReverseCommand(this);
+        this.tcpip = new AdbTcpIpCommand(this);
+    }
+    canUseFeature(feature) {
+        return (this.clientFeatures.includes(feature) &&
+            this.deviceFeatures.includes(feature));
+    }
+    async createSocket(service) {
+        return this.transport.connect(service);
+    }
+    async createSocketAndWait(service) {
+        const socket = await this.createSocket(service);
+        return await socket.readable
+            .pipeThrough(new TextDecoderStream())
+            .pipeThrough(new ConcatStringStream());
+    }
+    async getProp(key) {
+        const stdout = await this.subprocess.spawnAndWaitLegacy([
+            "getprop",
+            key,
+        ]);
+        return stdout.trim();
+    }
+    async rm(filenames, options) {
+        const args = ["rm"];
+        if (options?.recursive) {
+            args.push("-r");
+        }
+        if (options?.force) {
+            args.push("-f");
+        }
+        if (Array.isArray(filenames)) {
+            for (const filename of filenames) {
+                args.push(escapeArg(filename));
+            }
+        }
+        else {
+            args.push(escapeArg(filenames));
+        }
+        // https://android.googlesource.com/platform/packages/modules/adb/+/1a0fb8846d4e6b671c8aa7f137a8c21d7b248716/client/adb_install.cpp#984
+        args.push("</dev/null");
+        const stdout = await this.subprocess.spawnAndWaitLegacy(args);
+        return stdout;
+    }
+    async sync() {
+        const socket = await this.createSocket("sync:");
+        return new AdbSync(this, socket);
+    }
+    async framebuffer() {
+        return framebuffer(this);
+    }
+    async close() {
+        await this.transport.close();
+    }
+}
+//# sourceMappingURL=adb.js.map

package/esm/adb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adb.js","sourceRoot":"","sources":["../src/adb.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAKhF,OAAO,EACH,QAAQ,EACR,iBAAiB,EACjB,aAAa,EACb,OAAO,EACP,eAAe,EACf,SAAS,EACT,WAAW,GACd,MAAM,qBAAqB,CAAC;AA0C7B,MAAM,OAAO,GAAG;IACH,SAAS,CAAe;IAEjC,IAAI,MAAM;QACN,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;IACjC,CAAC;IAED,IAAI,cAAc;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC;IACzC,CAAC;IAED,IAAI,MAAM;QACN,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;IACjC,CAAC;IAED,IAAI,YAAY;QACZ,OAAO,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC;IACvC,CAAC;IAED,IAAW,cAAc;QACrB,OAAO,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC;IACzC,CAAC;IAED,IAAW,cAAc;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;IAChC,CAAC;IAEQ,UAAU,CAAgB;IAC1B,KAAK,CAAW;IAChB,OAAO,CAAoB;IAC3B,KAAK,CAAkB;IAEhC,YAAY,SAAuB;QAC/B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAE3B,IAAI,CAAC,UAAU,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,KAAK,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,OAAO,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;IAED,aAAa,CAAC,OAAmB;QAC7B,OAAO,CACH,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC;YACrC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,CACxC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,OAAe;QAC9B,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,OAAe;QACrC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAChD,OAAO,MAAM,MAAM,CAAC,QAAQ;aACvB,WAAW,CAAC,IAAI,iBAAiB,EAAE,CAAC;aACpC,WAAW,CAAC,IAAI,kBAAkB,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAW;QACrB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC;YACpD,SAAS;YACT,GAAG;SACN,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,EAAE,CACJ,SAA4B,EAC5B,OAAkD;QAElD,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;QACpB,IAAI,OAAO,EAAE,SAAS,EAAE,CAAC;YACrB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;QACD,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC;YACjB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;gBAC/B,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;YACnC,CAAC;QACL,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;QACpC,CAAC;QACD,uIAAuI;QACvI,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACxB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAC9D,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,IAAI;QACN,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAChD,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,WAAW;QACb,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,KAAK;QACP,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACjC,CAAC;CACJ"}

package/esm/banner.d.ts

@@ -0,0 +1,17 @@
+import type { AdbFeature } from "./features.js";
+export declare enum AdbBannerKey {
+    Product = "ro.product.name",
+    Model = "ro.product.model",
+    Device = "ro.product.device",
+    Features = "features"
+}
+export declare class AdbBanner {
+    #private;
+    static parse(banner: string): AdbBanner;
+    get product(): string | undefined;
+    get model(): string | undefined;
+    get device(): string | undefined;
+    get features(): AdbFeature[];
+    constructor(product: string | undefined, model: string | undefined, device: string | undefined, features: AdbFeature[]);
+}
+//# sourceMappingURL=banner.d.ts.map

package/esm/banner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.d.ts","sourceRoot":"","sources":["../src/banner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,oBAAY,YAAY;IACpB,OAAO,oBAAoB;IAC3B,KAAK,qBAAqB;IAC1B,MAAM,sBAAsB;IAC5B,QAAQ,aAAa;CACxB;AAED,qBAAa,SAAS;;IAClB,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM;IA0C3B,IAAI,OAAO,uBAEV;IAGD,IAAI,KAAK,uBAER;IAGD,IAAI,MAAM,uBAET;IAGD,IAAI,QAAQ,iBAEX;gBAGG,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,QAAQ,EAAE,UAAU,EAAE;CAO7B"}

package/esm/banner.js

@@ -0,0 +1,68 @@
+export var AdbBannerKey;
+(function (AdbBannerKey) {
+    AdbBannerKey["Product"] = "ro.product.name";
+    AdbBannerKey["Model"] = "ro.product.model";
+    AdbBannerKey["Device"] = "ro.product.device";
+    AdbBannerKey["Features"] = "features";
+})(AdbBannerKey || (AdbBannerKey = {}));
+export class AdbBanner {
+    static parse(banner) {
+        let product;
+        let model;
+        let device;
+        let features = [];
+        const pieces = banner.split("::");
+        if (pieces.length > 1) {
+            const props = pieces[1];
+            for (const prop of props.split(";")) {
+                // istanbul ignore if
+                if (!prop) {
+                    continue;
+                }
+                const keyValue = prop.split("=");
+                if (keyValue.length !== 2) {
+                    continue;
+                }
+                const [key, value] = keyValue;
+                switch (key) {
+                    case AdbBannerKey.Product:
+                        product = value;
+                        break;
+                    case AdbBannerKey.Model:
+                        model = value;
+                        break;
+                    case AdbBannerKey.Device:
+                        device = value;
+                        break;
+                    case AdbBannerKey.Features:
+                        features = value.split(",");
+                        break;
+                }
+            }
+        }
+        return new AdbBanner(product, model, device, features);
+    }
+    #product;
+    get product() {
+        return this.#product;
+    }
+    #model;
+    get model() {
+        return this.#model;
+    }
+    #device;
+    get device() {
+        return this.#device;
+    }
+    #features = [];
+    get features() {
+        return this.#features;
+    }
+    constructor(product, model, device, features) {
+        this.#product = product;
+        this.#model = model;
+        this.#device = device;
+        this.#features = features;
+    }
+}
+//# sourceMappingURL=banner.js.map

package/esm/banner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.js","sourceRoot":"","sources":["../src/banner.ts"],"names":[],"mappings":"AAEA,MAAM,CAAN,IAAY,YAKX;AALD,WAAY,YAAY;IACpB,2CAA2B,CAAA;IAC3B,0CAA0B,CAAA;IAC1B,4CAA4B,CAAA;IAC5B,qCAAqB,CAAA;AACzB,CAAC,EALW,YAAY,KAAZ,YAAY,QAKvB;AAED,MAAM,OAAO,SAAS;IAClB,MAAM,CAAC,KAAK,CAAC,MAAc;QACvB,IAAI,OAA2B,CAAC;QAChC,IAAI,KAAyB,CAAC;QAC9B,IAAI,MAA0B,CAAC;QAC/B,IAAI,QAAQ,GAAiB,EAAE,CAAC;QAEhC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;YACzB,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClC,qBAAqB;gBACrB,IAAI,CAAC,IAAI,EAAE,CAAC;oBACR,SAAS;gBACb,CAAC;gBAED,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBACjC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACxB,SAAS;gBACb,CAAC;gBAED,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,QAAQ,CAAC;gBAC9B,QAAQ,GAAG,EAAE,CAAC;oBACV,KAAK,YAAY,CAAC,OAAO;wBACrB,OAAO,GAAG,KAAK,CAAC;wBAChB,MAAM;oBACV,KAAK,YAAY,CAAC,KAAK;wBACnB,KAAK,GAAG,KAAK,CAAC;wBACd,MAAM;oBACV,KAAK,YAAY,CAAC,MAAM;wBACpB,MAAM,GAAG,KAAK,CAAC;wBACf,MAAM;oBACV,KAAK,YAAY,CAAC,QAAQ;wBACtB,QAAQ,GAAG,KAAM,CAAC,KAAK,CAAC,GAAG,CAAiB,CAAC;wBAC7C,MAAM;gBACd,CAAC;YACL,CAAC;QACL,CAAC;QAED,OAAO,IAAI,SAAS,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC3D,CAAC;IAED,QAAQ,CAAqB;IAC7B,IAAI,OAAO;QACP,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED,MAAM,CAAqB;IAC3B,IAAI,KAAK;QACL,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,OAAO,CAAqB;IAC5B,IAAI,MAAM;QACN,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,SAAS,GAAiB,EAAE,CAAC;IAC7B,IAAI,QAAQ;QACR,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED,YACI,OAA2B,EAC3B,KAAyB,EACzB,MAA0B,EAC1B,QAAsB;QAEtB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC9B,CAAC;CACJ"}

package/esm/commands/base.d.ts

@@ -0,0 +1,7 @@
+import { AutoDisposable } from "@yume-chan/event";
+import type { Adb } from "../adb.js";
+export declare class AdbCommandBase extends AutoDisposable {
+    protected adb: Adb;
+    constructor(adb: Adb);
+}
+//# sourceMappingURL=base.d.ts.map

package/esm/commands/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/commands/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAErC,qBAAa,cAAe,SAAQ,cAAc;IAC9C,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC;gBAEP,GAAG,EAAE,GAAG;CAIvB"}

package/esm/commands/base.js

@@ -0,0 +1,9 @@
+import { AutoDisposable } from "@yume-chan/event";
+export class AdbCommandBase extends AutoDisposable {
+    adb;
+    constructor(adb) {
+        super();
+        this.adb = adb;
+    }
+}
+//# sourceMappingURL=base.js.map

package/esm/commands/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/commands/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIlD,MAAM,OAAO,cAAe,SAAQ,cAAc;IACpC,GAAG,CAAM;IAEnB,YAAY,GAAQ;QAChB,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACnB,CAAC;CACJ"}

package/esm/commands/framebuffer.d.ts

@@ -0,0 +1,63 @@
+import Struct from "@yume-chan/struct";
+import type { Adb } from "../adb.js";
+export declare const AdbFrameBufferV1: Struct<{
+    bpp: number;
+    size: number;
+    width: number;
+    height: number;
+    red_offset: number;
+    red_length: number;
+    blue_offset: number;
+    blue_length: number;
+    green_offset: number;
+    green_length: number;
+    alpha_offset: number;
+    alpha_length: number;
+    data: Uint8Array;
+}, "size", Record<never, never>, undefined>;
+export type AdbFrameBufferV1 = (typeof AdbFrameBufferV1)["TDeserializeResult"];
+export declare const AdbFrameBufferV2: Struct<{
+    bpp: number;
+    colorSpace: number;
+    size: number;
+    width: number;
+    height: number;
+    red_offset: number;
+    red_length: number;
+    blue_offset: number;
+    blue_length: number;
+    green_offset: number;
+    green_length: number;
+    alpha_offset: number;
+    alpha_length: number;
+    data: Uint8Array;
+}, "size", Record<never, never>, undefined>;
+export type AdbFrameBufferV2 = (typeof AdbFrameBufferV2)["TDeserializeResult"];
+/**
+ * ADB uses 8 int32 fields to describe bit depths
+ *
+ * The only combination I have seen is RGBA8888, which is
+ *
+ *   red_offset:   0
+ *   red_length:   8
+ *   blue_offset:  16
+ *   blue_length:  8
+ *   green_offset: 8
+ *   green_length: 8
+ *   alpha_offset: 24
+ *   alpha_length: 8
+ *
+ * But it doesn't mean that other combinations are not possible.
+ */
+export type AdbFrameBuffer = AdbFrameBufferV1 | AdbFrameBufferV2;
+export declare abstract class AdbFrameBufferError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare class AdbFrameBufferUnsupportedVersionError extends AdbFrameBufferError {
+    constructor(version: number);
+}
+export declare class AdbFrameBufferForbiddenError extends AdbFrameBufferError {
+    constructor();
+}
+export declare function framebuffer(adb: Adb): Promise<AdbFrameBuffer>;
+//# sourceMappingURL=framebuffer.d.ts.map

package/esm/commands/framebuffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framebuffer.d.ts","sourceRoot":"","sources":["../../src/commands/framebuffer.ts"],"names":[],"mappings":"AACA,OAAO,MAA4B,MAAM,mBAAmB,CAAC;AAE7D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAIrC,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;2CAamB,CAAC;AAEjD,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,oBAAoB,CAAC,CAAC;AAE/E,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;2CAcmB,CAAC;AAEjD,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,oBAAoB,CAAC,CAAC;AAE/E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,cAAc,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;AAEjE,8BAAsB,mBAAoB,SAAQ,KAAK;gBACvC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAGtD;AAED,qBAAa,qCAAsC,SAAQ,mBAAmB;gBAC9D,OAAO,EAAE,MAAM;CAG9B;AAED,qBAAa,4BAA6B,SAAQ,mBAAmB;;CAIpE;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,cAAc,CAAC,CAuBnE"}

package/esm/commands/framebuffer.js

@@ -0,0 +1,71 @@
+import { BufferedReadableStream } from "@yume-chan/stream-extra";
+import Struct, { StructEmptyError } from "@yume-chan/struct";
+const Version = new Struct({ littleEndian: true }).uint32("version");
+export const AdbFrameBufferV1 = new Struct({ littleEndian: true })
+    .uint32("bpp")
+    .uint32("size")
+    .uint32("width")
+    .uint32("height")
+    .uint32("red_offset")
+    .uint32("red_length")
+    .uint32("blue_offset")
+    .uint32("blue_length")
+    .uint32("green_offset")
+    .uint32("green_length")
+    .uint32("alpha_offset")
+    .uint32("alpha_length")
+    .uint8Array("data", { lengthField: "size" });
+export const AdbFrameBufferV2 = new Struct({ littleEndian: true })
+    .uint32("bpp")
+    .uint32("colorSpace")
+    .uint32("size")
+    .uint32("width")
+    .uint32("height")
+    .uint32("red_offset")
+    .uint32("red_length")
+    .uint32("blue_offset")
+    .uint32("blue_length")
+    .uint32("green_offset")
+    .uint32("green_length")
+    .uint32("alpha_offset")
+    .uint32("alpha_length")
+    .uint8Array("data", { lengthField: "size" });
+export class AdbFrameBufferError extends Error {
+    constructor(message, options) {
+        super(message, options);
+    }
+}
+export class AdbFrameBufferUnsupportedVersionError extends AdbFrameBufferError {
+    constructor(version) {
+        super(`Unsupported FrameBuffer version ${version}`);
+    }
+}
+export class AdbFrameBufferForbiddenError extends AdbFrameBufferError {
+    constructor() {
+        super("FrameBuffer is disabled by current app");
+    }
+}
+export async function framebuffer(adb) {
+    const socket = await adb.createSocket("framebuffer:");
+    const stream = new BufferedReadableStream(socket.readable);
+    let version;
+    try {
+        ({ version } = await Version.deserialize(stream));
+    }
+    catch (e) {
+        if (e instanceof StructEmptyError) {
+            throw new AdbFrameBufferForbiddenError();
+        }
+        throw e;
+    }
+    switch (version) {
+        case 1:
+            // TODO: AdbFrameBuffer: does all v1 responses uses the same color space? Add it so the command returns same format for all versions.
+            return AdbFrameBufferV1.deserialize(stream);
+        case 2:
+            return AdbFrameBufferV2.deserialize(stream);
+        default:
+            throw new AdbFrameBufferUnsupportedVersionError(version);
+    }
+}
+//# sourceMappingURL=framebuffer.js.map