@yume-chan/adb 0.0.9 → 0.0.10

package/CHANGELOG.json

@@ -0,0 +1,23 @@
+{
+  "name": "@yume-chan/adb",
+  "entries": [
+    {
+      "version": "0.0.10",
+      "tag": "@yume-chan/adb_v0.0.10",
+      "date": "Sun, 09 Jan 2022 15:52:20 GMT",
+      "comments": {
+        "none": [
+          {
+            "comment": "Remove `encodeUtf8()` and `decodeUtf8()` from `AdbBackend`"
+          }
+        ]
+      }
+    },
+    {
+      "version": "0.0.9",
+      "tag": "@yume-chan/adb_v0.0.9",
+      "date": "Sun, 09 Jan 2022 15:50:20 GMT",
+      "comments": {}
+    }
+  ]
+}

package/CHANGELOG.md

@@ -0,0 +1,16 @@
+# Change Log - @yume-chan/adb
+
+This log was last generated on Sun, 09 Jan 2022 15:52:20 GMT and should not be manually modified.
+
+## 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

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2020 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.
+MIT License
+
+Copyright (c) 2020 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

@@ -1,257 +1,227 @@
-# @yume-chan/adb
-
-TypeScript implementation of Android Debug Bridge (ADB) protocol.
-
-- [Compatibility](#compatibility)
-- [Connection](#connection)
-  - [Backend](#backend)
-    - [`read`](#read)
-    - [`write`](#write)
-- [Authenticate](#authenticate)
-  - [Public key authentication](#public-key-authentication)
-    - [Backend](#backend-1)
-      - [`generateKey`](#generatekey)
-  - [Token authentication](#token-authentication)
-    - [Backend](#backend-2)
-      - [`iterateKeys`](#iteratekeys)
-- [Stream multiplex](#stream-multiplex)
-  - [Backend](#backend-3)
-    - [`encodeUtf8`](#encodeutf8)
-    - [`decodeUtf8`](#decodeutf8)
-- [Commands](#commands)
-  - [shell](#shell)
-    - [PTY mode](#pty-mode)
-    - [ADB shell protocol](#adb-shell-protocol)
-    - [Raw mode](#raw-mode)
-  - [usb](#usb)
-  - [tcpip](#tcpip)
-  - [sync](#sync)
-    - [LIST](#list)
-    - [LIS2](#lis2)
-    - [STAT](#stat)
-    - [LST2](#lst2)
-    - [STA2](#sta2)
-    - [RECV](#recv)
-    - [RCV2](#rcv2)
-    - [SEND](#send)
-    - [SND2](#snd2)
-- [Useful links](#useful-links)
-
-## Compatibility
-
-The main limiting factor of compatibility is [@yume-chan/struct](https://www.npmjs.com/package/@yume-chan/struct).
-
-This library doesn't use any DOM or Node.js API.
-
-|                 | Chrome | Edge | Firefox | Internet Explorer | Safari         | Node.js |
-| --------------- | ------ | ---- | ------- | ----------------- | -------------- | ------- |
-| **Basic usage** | 68     | 79   | 68      | No                | 14<sup>1</sup> | 10.4    |
-
-<sup>1</sup> Requires a polyfill for [`DataView#getBigUint64`][MDN_DataView_getBigUint64] and [`DataView#setBigUint64`][MDN_DataView_setBigUint64]
-
-[MDN_DataView_getBigUint64]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DataView/getBigUint64
-[MDN_DataView_setBigUint64]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DataView/setBigUint64
-
-## Connection
-
-This library doesn't tie with a specific transportation method.
-
-Instead, a `Backend` is responsible for transferring packets in its own way (USB, WebSocket, etc).
-
-### Backend
-
-#### `read`
-
-```ts
-read(length: number): ArrayBuffer | Promise<ArrayBuffer>
-```
-
-Read the specified amount of data from the underlying connection.
-
-The backend should return only the data written by another endpoint in a single operation. That meas, it should never concatenate multiple write operations to fulfill the requested `length`. Here is the reason:
-
-In normal working condition the client always knows how much data it should read and the server will always send exactly such amount of data in a single operation.
-
-One exception is that for stateless connections (including USB and TCP), if one client sent a request and died without reading the response, the data will sit in an operating system's internal buffer. When the next client, reusing the connection, want to read a response to its request, it may get that buffered response instead.
-
-The native ADB implementation tries to detect such a situation by checking length and content of the response data, so do this library. So the backend should not return such a response if possible, or follow this behavior if it can't distinguish.
-
-#### `write`
-
-```ts
-write(buffer: ArrayBuffer): void | Promise<void>
-```
-
-Write data to the underlying connection.
-
-## Authenticate
-
-ADB supports two authentication methods:
-
-### Public key authentication
-
-1. Client (this library) generates a RSA private key and save it.
-2. Client generates an ADB public key (not RSA public key) based on the RSA private key.
-3. Client transfers the ADB public key to server (device).
-4. Server may ask its user to accept the public key, it will save the public key if accepted.
-
-#### Backend
-
-##### `generateKey`
-
-```ts
-generateKey(): ArrayBuffer | Promise<ArrayBuffer>
-```
-
-Generate and store a RSA private key with modulus length 2048 and public exponent 65537.
-
-The returned `ArrayBuffer` is the private key in PKCS #8 format.
-
-### Token authentication
-
-1. Server transfers a 20 bytes token to client.
-2. Client RSA encrypts the token with its RSA private key.
-3. Client transfers the encrypted token to server.
-4. Server tries to decrypt the received data with all saved public keys. If any decryption succeed, the authentication succeed.
-
-#### Backend
-
-##### `iterateKeys`
-
-```ts
-generateKey(): Iterator<ArrayBuffer> | AsyncIterator<ArrayBuffer>
-```
-
-Synchronously or asynchronously iterate through all stored RSA private keys.
-
-Each call to `iterateKeys` must returns a different iterator that iterate through all stored keys.
-
-## Stream multiplex
-
-ADB commands are all based on streams. Multiple streams can send and receive at the same time in one connection.
-
-1. Client sends an `OPEN` packet to create a stream.
-2. Server responds with `OKAY` or `FAIL`.
-3. Client and server read/write on the stream.
-4. Client/server sends a `CLSE` to close the stream.
-
-The `Backend` is responsible for encoding and decoding UTF-8 strings.
-
-### Backend
-
-#### `encodeUtf8`
-
-```ts
-encodeUtf8(input: string): ArrayBuffer
-```
-
-Encode `input` into an `ArrayBuffer` with UTF-8 encoding.
-
-#### `decodeUtf8`
-
-```ts
-decodeUtf8(buffer: ArrayBuffer): string
-```
-
-Decode `buffer` into a string with UTF-8 encoding.
-
-## Commands
-
-### shell
-
-#### PTY mode
-
-Basic mode, supported on all devices.
-
-#### ADB shell protocol
-
-*(Not Implemented)*
-
-Supported on devices with `shell_v2` feature.
-
-Supports window size changing event.
-
-Supports returning process exit code.
-
-#### Raw mode
-
-*(Not Implemented)*
-
-Must be used with ADB shell protocol.
-
-Supports splitting stdout and stderr.
-
-### usb
-
-Disable ADB over WiFi.
-
-### tcpip
-
-Enable ADB over WiFi.
-
-### sync
-
-Client and server will communicate with another protocol on the opened stream.
-
-#### LIST
-
-Request server to list the content of a folder.
-
-#### LIS2
-
-*(Not Implemented)*
-
-Version 2 of the LIST command, contains more information.
-
-Supported on devices with `ls_v2` feature.
-
-#### STAT
-
-Request server to return the information of a file.
-
-If path is a symbolic link, the returned information is about the link itself.
-
-So it's actually the [`lstat`](https://linux.die.net/man/2/lstat) system call.
-
-#### LST2
-
-Version 2 of the STAT command, contains more information.
-
-Supported on devices with `stat_v2` feature.
-
-#### STA2
-
-Basically identical to LST2, but if path is a symbolic link, the information is about the file it refers to.
-
-Supported on devices with `stat_v2` feature.
-
-#### RECV
-
-Request server to send the content of a file.
-
-#### RCV2
-
-*(Not Implemented)*
-
-Version 2 of the RECV command.
-
-Supported on devices with `sendrecv_v2` feature.
-
-#### SEND
-
-*(Not Implemented)*
-
-Send a file onto server's file system.
-
-#### SND2
-
-*(Not Implemented)*
-
-Version 2 of the SEND command.
-
-Supported on devices with `sendrecv_v2` feature.
-
-## Useful links
-
-* [ADB protocol overview](https://android.googlesource.com/platform/packages/modules/adb/+/2fd69306184634c6d90db3ed3be5349e71dcc471/OVERVIEW.TXT)
-* [ADB commands](https://android.googlesource.com/platform/packages/modules/adb/+/2fd69306184634c6d90db3ed3be5349e71dcc471/SERVICES.TXT#145)
+# @yume-chan/adb
+
+TypeScript implementation of Android Debug Bridge (ADB) protocol.
+
+**WARNING:** The public API is UNSTABLE. If you have any questions, please open an issue.
+
+- [Compatibility](#compatibility)
+- [Connection](#connection)
+  - [Backend](#backend)
+    - [`connect`](#connect)
+    - [`read`](#read)
+    - [`write`](#write)
+- [Authentication](#authentication)
+    - [AdbCredentialStore](#adbcredentialstore)
+      - [`generateKey`](#generatekey)
+      - [`iterateKeys`](#iteratekeys)
+      - [Implementations](#implementations)
+    - [AdbAuthenticator](#adbauthenticator)
+- [Stream multiplex](#stream-multiplex)
+  - [Backend](#backend-1)
+- [Commands](#commands)
+  - [childProcess](#childprocess)
+  - [usb](#usb)
+  - [tcpip](#tcpip)
+  - [sync](#sync)
+    - [LIST](#list)
+    - [LIS2](#lis2)
+    - [STAT](#stat)
+    - [LST2](#lst2)
+    - [STA2](#sta2)
+    - [RECV](#recv)
+    - [RCV2](#rcv2)
+    - [SEND](#send)
+    - [SND2](#snd2)
+- [Useful links](#useful-links)
+
+## Compatibility
+
+The main limiting factor of compatibility is [@yume-chan/struct](https://www.npmjs.com/package/@yume-chan/struct).
+
+This library doesn't use any DOM or Node.js API.
+
+|                 | Chrome | Edge | Firefox | Internet Explorer | Safari         | Node.js |
+| --------------- | ------ | ---- | ------- | ----------------- | -------------- | ------- |
+| **Basic usage** | 68     | 79   | 68      | No                | 14<sup>1</sup> | 10.4    |
+
+<sup>1</sup> Requires a polyfill for [`DataView#getBigUint64`][MDN_DataView_getBigUint64] and [`DataView#setBigUint64`][MDN_DataView_setBigUint64]
+
+[MDN_DataView_getBigUint64]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DataView/getBigUint64
+[MDN_DataView_setBigUint64]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DataView/setBigUint64
+
+## Connection
+
+This library doesn't tie to a specific transportation method.
+
+Instead, a `Backend` is responsible for transferring data in its own way (USB, WebSocket, etc).
+
+### Backend
+
+#### `connect`
+
+Establishes a connection with the device.
+
+If a backend doesn't have extra steps to establish the connection, it can omit the `connect` method implementation.
+
+#### `read`
+
+```ts
+read(length: number): ArrayBuffer | Promise<ArrayBuffer>
+```
+
+Reads the specified amount of data from the underlying connection.
+
+The returned `ArrayBuffer` may have more or less data than the `length` parameter specified, if there is some residual data in the connection buffer. The client will automatically call `read` again with the same `length`.
+
+#### `write`
+
+```ts
+write(buffer: ArrayBuffer): void | Promise<void>
+```
+
+Writes data to the underlying connection.
+
+## Authentication
+
+For how does ADB authentication work, see https://chensi.moe/blog/2020/09/30/webadb-part2-connection/#auth.
+
+In this library, authentication comes in two parts:
+
+* `AdbCredentialStore`: because JavaScript has no unified method to generate, store and iterate crypto keys, an implementation of `AdbCredentialStore` is required for the two built-in authenticators.
+* `AdbAuthenticator`: can be used to implement custom authentication modes.
+
+Custom `AdbCredentialStore`s and `AdbAuthenticator`s can be specified in the `Adb#connect` method.
+
+#### AdbCredentialStore
+
+##### `generateKey`
+
+```ts
+generateKey(): ArrayBuffer | Promise<ArrayBuffer>
+```
+
+Generate and store a RSA private key with modulus length `2048` and public exponent `65537`.
+
+The returned `ArrayBuffer` is the private key in PKCS #8 format.
+
+##### `iterateKeys`
+
+```ts
+iterateKeys(): Iterator<ArrayBuffer> | AsyncIterator<ArrayBuffer>
+```
+
+Synchronously or asynchronously iterate through all stored RSA private keys.
+
+Each call to `iterateKeys` must return a different iterator that iterate through all stored keys.
+
+##### Implementations
+
+The `@yume-chan/adb-backend-webusb` package contains a `AdbWebCredentialStore` implementation using Web Crypto API to generating keys and Web Storage API to storing keys.
+
+#### AdbAuthenticator
+
+An `AdbAuthenticator` generates `AUTH` responses for each `AUTH` request from server.
+
+This package contains `AdbSignatureAuthenticator` and `AdbPublicKeyAuthenticator`, the two basic modes.
+
+## Stream multiplex
+
+ADB commands are all based on streams. Multiple streams can send and receive at the same time in one connection.
+
+1. Client sends an `OPEN` packet to create a stream.
+2. Server responds with `OKAY` or `FAIL`.
+3. Client and server read/write on the stream.
+4. Client/server sends a `CLSE` to close the stream.
+
+The `Backend` is responsible for reading and writing data from underlying source.
+
+### Backend
+
+## Commands
+
+### childProcess
+
+Spawns child process on server. ADB has two shell modes:
+
+|                             | Legacy mode      | Shell Protocol     |
+| --------------------------- | ---------------- | ------------------ |
+| Feature flag                | -                | `shell_v2`         |
+| Implementation              | `AdbLegacyShell` | `AdbShellProtocol` |
+| Splitting stdout and stderr | No               | Yes                |
+| Returning exit code         | No               | Yes                |
+| Resizing window             | No               | Yes                |
+
+The `Adb#childProcess#shell` and `Adb#childProcess#spawn` methods accepts a list of implementations, and will use the first supported one.
+
+### usb
+
+Disable ADB over WiFi.
+
+### tcpip
+
+Enable ADB over WiFi.
+
+### sync
+
+Client and server will communicate with another protocol on the opened stream.
+
+#### LIST
+
+Request server to list the content of a folder.
+
+#### LIS2
+
+Version 2 of the LIST command, contains more information.
+
+Supported on devices with `ls_v2` feature.
+
+#### STAT
+
+Request server to return the information of a file.
+
+If path is a symbolic link, the returned information is about the link itself.
+
+So it's actually the [`lstat`](https://linux.die.net/man/2/lstat) system call.
+
+#### LST2
+
+Version 2 of the STAT command, contains more information.
+
+Supported on devices with `stat_v2` feature.
+
+#### STA2
+
+Basically identical to LST2, but if path is a symbolic link, the information is about the file it refers to.
+
+Supported on devices with `stat_v2` feature.
+
+#### RECV
+
+Request server to send the content of a file.
+
+#### RCV2
+
+*(Not Implemented)*
+
+Version 2 of the RECV command.
+
+Supported on devices with `sendrecv_v2` feature.
+
+#### SEND
+
+*(Not Implemented)*
+
+Send a file onto server's file system.
+
+#### SND2
+
+*(Not Implemented)*
+
+Version 2 of the SEND command.
+
+Supported on devices with `sendrecv_v2` feature.
+
+## Useful links
+
+* [ADB protocol overview](https://android.googlesource.com/platform/packages/modules/adb/+/2fd69306184634c6d90db3ed3be5349e71dcc471/OVERVIEW.TXT)
+* [ADB commands](https://android.googlesource.com/platform/packages/modules/adb/+/2fd69306184634c6d90db3ed3be5349e71dcc471/SERVICES.TXT#145)

package/dts/adb.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adb.d.ts","sourceRoot":"","sources":["../src/adb.ts"],"names":[],"mappings":"AAEA,OAAO,EAA4B,kBAAkB,EAA4B,MAAM,QAAQ,CAAC;AAChG,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,iBAAiB,EAAE,OAAO,EAAE,eAAe,EAAmC,MAAM,YAAY,CAAC;AACxJ,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EAAE,SAAS,EAAuB,SAAS,EAAE,MAAM,UAAU,CAAC;AAErE,oBAAY,UAAU;IAClB,OAAO,oBAAoB;IAC3B,KAAK,qBAAqB;IAC1B,MAAM,sBAAsB;IAC5B,QAAQ,aAAa;CACxB;AAED,qBAAa,GAAG;IACZ,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAa;IAEtC,IAAW,OAAO,IAAI,UAAU,CAA0B;IAE1D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAsB;IAEvD,IAAW,cAAc,oDAA0C;IAEnE,OAAO,CAAC,UAAU,CAAS;IAC3B,IAAW,SAAS,YAA8B;IAElD,IAAW,IAAI,uBAAgC;IAE/C,OAAO,CAAC,gBAAgB,CAAqB;IAC7C,IAAW,eAAe,uBAAoC;IAE9D,OAAO,CAAC,QAAQ,CAAqB;IACrC,IAAW,OAAO,uBAA4B;IAE9C,OAAO,CAAC,MAAM,CAAqB;IACnC,IAAW,KAAK,uBAA0B;IAE1C,OAAO,CAAC,OAAO,CAAqB;IACpC,IAAW,MAAM,uBAA2B;IAE5C,OAAO,CAAC,SAAS,CAA4B;IAC7C,IAAW,QAAQ,8BAA6B;IAEhD,SAAgB,KAAK,EAAE,eAAe,CAAC;IAEvC,SAAgB,OAAO,EAAE,iBAAiB,CAAC;IAE3C,SAAgB,QAAQ,EAAE,WAAW,CAAC;IAEtC,SAAgB,YAAY,EAAE,eAAe,CAAC;gBAE3B,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,SAAS;IAY7C,OAAO,CAChB,eAAe,EAAE,kBAAkB,EACnC,cAAc,sCAA2B,GAC1C,OAAO,CAAC,IAAI,CAAC;IA8FhB,OAAO,CAAC,WAAW;IAmCN,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKrC,EAAE,CAAC,GAAG,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAI3C,OAAO,CAChB,GAAG,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,eAAe,GAAG,aAAa,CAAC,WAAW,CAAC,EACrE,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GACxC,OAAO,CAAC,IAAI,CAAC;IAIH,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAKxB,WAAW,IAAI,OAAO,CAAC,cAAc,CAAC;IAItC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAIjD,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAWxD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAIxC"}
+{"version":3,"file":"adb.d.ts","sourceRoot":"","sources":["../src/adb.ts"],"names":[],"mappings":"AAEA,OAAO,EAA4B,kBAAkB,EAA4B,MAAM,QAAQ,CAAC;AAChG,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,iBAAiB,EAAE,OAAO,EAAE,eAAe,EAAmC,MAAM,YAAY,CAAC;AACxJ,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EAAE,SAAS,EAAuB,SAAS,EAAE,MAAM,UAAU,CAAC;AAGrE,oBAAY,UAAU;IAClB,OAAO,oBAAoB;IAC3B,KAAK,qBAAqB;IAC1B,MAAM,sBAAsB;IAC5B,QAAQ,aAAa;CACxB;AAED,qBAAa,GAAG;IACZ,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAa;IAEtC,IAAW,OAAO,IAAI,UAAU,CAA0B;IAE1D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAsB;IAEvD,IAAW,cAAc,oDAA0C;IAEnE,OAAO,CAAC,UAAU,CAAS;IAC3B,IAAW,SAAS,YAA8B;IAElD,IAAW,IAAI,uBAAgC;IAE/C,OAAO,CAAC,gBAAgB,CAAqB;IAC7C,IAAW,eAAe,uBAAoC;IAE9D,OAAO,CAAC,QAAQ,CAAqB;IACrC,IAAW,OAAO,uBAA4B;IAE9C,OAAO,CAAC,MAAM,CAAqB;IACnC,IAAW,KAAK,uBAA0B;IAE1C,OAAO,CAAC,OAAO,CAAqB;IACpC,IAAW,MAAM,uBAA2B;IAE5C,OAAO,CAAC,SAAS,CAA4B;IAC7C,IAAW,QAAQ,8BAA6B;IAEhD,SAAgB,KAAK,EAAE,eAAe,CAAC;IAEvC,SAAgB,OAAO,EAAE,iBAAiB,CAAC;IAE3C,SAAgB,QAAQ,EAAE,WAAW,CAAC;IAEtC,SAAgB,YAAY,EAAE,eAAe,CAAC;gBAE3B,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,SAAS;IAY7C,OAAO,CAChB,eAAe,EAAE,kBAAkB,EACnC,cAAc,sCAA2B,GAC1C,OAAO,CAAC,IAAI,CAAC;IA8FhB,OAAO,CAAC,WAAW;IAmCN,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKrC,EAAE,CAAC,GAAG,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAI3C,OAAO,CAChB,GAAG,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,eAAe,GAAG,aAAa,CAAC,WAAW,CAAC,EACrE,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GACxC,OAAO,CAAC,IAAI,CAAC;IAIH,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAKxB,WAAW,IAAI,OAAO,CAAC,cAAc,CAAC;IAItC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAIjD,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAWxD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAIxC"}

package/dts/auth.d.ts

@@ -3,8 +3,18 @@ import { ValueOrPromise } from '@yume-chan/struct';
 import { AdbPacket, AdbPacketInit } from './packet';
 export declare type AdbKeyIterable = Iterable<ArrayBuffer> | AsyncIterable<ArrayBuffer>;
 export interface AdbCredentialStore {
-    iterateKeys(): AdbKeyIterable;
+    /**
+     * Generate and store a RSA private key with modulus length `2048` and public exponent `65537`.
+     *
+     * The returned `ArrayBuffer` is the private key in PKCS #8 format.
+     */
     generateKey(): ValueOrPromise<ArrayBuffer>;
+    /**
+     * Synchronously or asynchronously iterate through all stored RSA private keys.
+     *
+     * Each call to `iterateKeys` must return a different iterator that iterate through all stored keys.
+     */
+    iterateKeys(): AdbKeyIterable;
 }
 export declare enum AdbAuthType {
     Token = 1,

package/dts/auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAc,SAAS,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGhE,oBAAY,cAAc,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;AAEhF,MAAM,WAAW,kBAAkB;IAC/B,WAAW,IAAI,cAAc,CAAC;IAE9B,WAAW,IAAI,cAAc,CAAC,WAAW,CAAC,CAAC;CAC9C;AAED,oBAAY,WAAW;IACnB,KAAK,IAAI;IACT,SAAS,IAAI;IACb,SAAS,IAAI;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC7B;;;;;;;;;;OAUG;IACH,CACI,eAAe,EAAE,kBAAkB,EACnC,cAAc,EAAE,MAAM,OAAO,CAAC,SAAS,CAAC,GACzC,aAAa,CAAC,aAAa,CAAC,CAAC;CACnC;AAED,eAAO,MAAM,yBAAyB,EAAE,gBAmBvC,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,gBAoCvC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,gBAAgB,EAGtD,CAAC;AAEF,qBAAa,wBAAyB,YAAW,UAAU;IACvD,SAAgB,cAAc,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAE5D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IAErD,OAAO,CAAC,cAAc,CAAoC;IAE1D,OAAO,CAAC,QAAQ,CAA2C;gBAGvD,cAAc,EAAE,SAAS,gBAAgB,EAAE,EAC3C,eAAe,EAAE,kBAAkB;IAMvC,OAAO,CAAC,cAAc,CAEpB;YAEa,gBAAgB;IAkBlB,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC;IAUvD,OAAO;CAGjB"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAc,SAAS,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGhE,oBAAY,cAAc,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;AAEhF,MAAM,WAAW,kBAAkB;IAC/B;;;;OAIG;IACH,WAAW,IAAI,cAAc,CAAC,WAAW,CAAC,CAAC;IAE3C;;;;OAIG;IACH,WAAW,IAAI,cAAc,CAAC;CACjC;AAED,oBAAY,WAAW;IACnB,KAAK,IAAI;IACT,SAAS,IAAI;IACb,SAAS,IAAI;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC7B;;;;;;;;;;OAUG;IACH,CACI,eAAe,EAAE,kBAAkB,EACnC,cAAc,EAAE,MAAM,OAAO,CAAC,SAAS,CAAC,GACzC,aAAa,CAAC,aAAa,CAAC,CAAC;CACnC;AAED,eAAO,MAAM,yBAAyB,EAAE,gBAmBvC,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,gBAoCvC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,gBAAgB,EAGtD,CAAC;AAEF,qBAAa,wBAAyB,YAAW,UAAU;IACvD,SAAgB,cAAc,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAE5D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IAErD,OAAO,CAAC,cAAc,CAAoC;IAE1D,OAAO,CAAC,QAAQ,CAA2C;gBAGvD,cAAc,EAAE,SAAS,gBAAgB,EAAE,EAC3C,eAAe,EAAE,kBAAkB;IAMvC,OAAO,CAAC,cAAc,CAEpB;YAEa,gBAAgB;IAkBlB,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC;IAUvD,OAAO;CAGjB"}

package/dts/backend.d.ts

@@ -1,15 +1,13 @@
-import { Event } from '@yume-chan/event';
-import { ValueOrPromise } from '@yume-chan/struct';
+import type { Event } from '@yume-chan/event';
+import type { ValueOrPromise } from '@yume-chan/struct';
 export interface AdbBackend {
     readonly serial: string;
     readonly name: string | undefined;
     readonly connected: boolean;
     readonly onDisconnected: Event<void>;
     connect?(): ValueOrPromise<void>;
-    encodeUtf8(input: string): ArrayBuffer;
-    decodeUtf8(buffer: ArrayBuffer): string;
-    write(buffer: ArrayBuffer): ValueOrPromise<void>;
     read(length: number): ValueOrPromise<ArrayBuffer>;
+    write(buffer: ArrayBuffer): ValueOrPromise<void>;
     dispose(): ValueOrPromise<void>;
 }
 //# sourceMappingURL=backend.d.ts.map

package/dts/backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,WAAW,UAAU;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAElC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B,QAAQ,CAAC,cAAc,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAErC,OAAO,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;IAEjC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAAC;IAEvC,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC;IAExC,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAEjD,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IAElD,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;CACnC"}
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,WAAW,UAAU;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAElC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B,QAAQ,CAAC,cAAc,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAErC,OAAO,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;IAEjC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IAElD,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAEjD,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;CACnC"}