@yume-chan/adb 0.0.24 → 1.0.0

package/src/commands/sync/list.ts

@@ -1,4 +1,5 @@
-import Struct from "@yume-chan/struct";
+import type { StructValue } from "@yume-chan/struct";
+import { string, struct, u32 } from "@yume-chan/struct";
 
 import { AdbSyncRequestId, adbSyncWriteRequest } from "./request.js";
 import { AdbSyncResponseId, adbSyncReadResponses } from "./response.js";
@@ -14,21 +15,27 @@ export interface AdbSyncEntry extends AdbSyncStat {
     name: string;
 }
 
-export const AdbSyncEntryResponse = new Struct({ littleEndian: true })
-    .concat(AdbSyncLstatResponse)
-    .uint32("nameLength")
-    .string("name", { lengthField: "nameLength" });
+export const AdbSyncEntryResponse = /* #__PURE__ */ (() =>
+    struct(
+        {
+            ...AdbSyncLstatResponse.fields,
+            name: string(u32),
+        },
+        { littleEndian: true, extra: AdbSyncLstatResponse.extra },
+    ))();
 
-export type AdbSyncEntryResponse =
-    (typeof AdbSyncEntryResponse)["TDeserializeResult"];
+export type AdbSyncEntryResponse = StructValue<typeof AdbSyncEntryResponse>;
 
-export const AdbSyncEntry2Response = new Struct({ littleEndian: true })
-    .concat(AdbSyncStatResponse)
-    .uint32("nameLength")
-    .string("name", { lengthField: "nameLength" });
+export const AdbSyncEntry2Response = /* #__PURE__ */ (() =>
+    struct(
+        {
+            ...AdbSyncStatResponse.fields,
+            name: string(u32),
+        },
+        { littleEndian: true, extra: AdbSyncStatResponse.extra },
+    ))();
 
-export type AdbSyncEntry2Response =
-    (typeof AdbSyncEntry2Response)["TDeserializeResult"];
+export type AdbSyncEntry2Response = StructValue<typeof AdbSyncEntry2Response>;
 
 export async function* adbSyncOpenDirV2(
     socket: AdbSyncSocket,

package/src/commands/sync/pull.ts

@@ -1,17 +1,18 @@
 import type { ReadableStream } from "@yume-chan/stream-extra";
 import { PushReadableStream } from "@yume-chan/stream-extra";
-import Struct from "@yume-chan/struct";
+import type { StructValue } from "@yume-chan/struct";
+import { buffer, struct, u32 } from "@yume-chan/struct";
 
 import { AdbSyncRequestId, adbSyncWriteRequest } from "./request.js";
-import { AdbSyncResponseId, adbSyncReadResponses } from "./response.js";
+import { adbSyncReadResponses, AdbSyncResponseId } from "./response.js";
 import type { AdbSyncSocket } from "./socket.js";
 
-export const AdbSyncDataResponse = new Struct({ littleEndian: true })
-    .uint32("dataLength")
-    .uint8Array("data", { lengthField: "dataLength" });
+export const AdbSyncDataResponse = struct(
+    { data: buffer(u32) },
+    { littleEndian: true },
+);
 
-export type AdbSyncDataResponse =
-    (typeof AdbSyncDataResponse)["TDeserializeResult"];
+export type AdbSyncDataResponse = StructValue<typeof AdbSyncDataResponse>;
 
 export async function* adbSyncPullGenerator(
     socket: AdbSyncSocket,

package/src/commands/sync/push.ts

@@ -4,7 +4,7 @@ import {
     DistributionStream,
     MaybeConsumable,
 } from "@yume-chan/stream-extra";
-import Struct, { placeholder } from "@yume-chan/struct";
+import { struct, u32 } from "@yume-chan/struct";
 
 import { NOOP } from "../../utils/index.js";
 
@@ -25,8 +25,9 @@ export interface AdbSyncPushV1Options {
     packetSize?: number;
 }
 
-export const AdbSyncOkResponse = new Struct({ littleEndian: true }).uint32(
-    "unused",
+export const AdbSyncOkResponse = struct(
+    { unused: u32 },
+    { littleEndian: true },
 );
 
 async function pipeFileData(
@@ -41,8 +42,8 @@ async function pipeFileData(
     file.pipeThrough(new DistributionStream(packetSize, true))
         .pipeTo(
             new MaybeConsumable.WritableStream({
-                write: async (chunk) => {
-                    await adbSyncWriteRequest(
+                write(chunk) {
+                    return adbSyncWriteRequest(
                         locked,
                         AdbSyncRequestId.Data,
                         chunk,
@@ -86,19 +87,22 @@ export async function adbSyncPushV1({
     }
 }
 
-export enum AdbSyncSendV2Flags {
-    None = 0,
-    Brotli = 1,
+export const AdbSyncSendV2Flags = {
+    None: 0,
+    Brotli: 1,
     /**
      * 2
      */
-    Lz4 = 1 << 1,
+    Lz4: 1 << 1,
     /**
      * 4
      */
-    Zstd = 1 << 2,
-    DryRun = 0x80000000,
-}
+    Zstd: 1 << 2,
+    DryRun: 0x80000000,
+} as const;
+
+export type AdbSyncSendV2Flags =
+    (typeof AdbSyncSendV2Flags)[keyof typeof AdbSyncSendV2Flags];
 
 export interface AdbSyncPushV2Options extends AdbSyncPushV1Options {
     /**
@@ -110,10 +114,10 @@ export interface AdbSyncPushV2Options extends AdbSyncPushV1Options {
     dryRun?: boolean;
 }
 
-export const AdbSyncSendV2Request = new Struct({ littleEndian: true })
-    .uint32("id")
-    .uint32("mode")
-    .uint32("flags", placeholder<AdbSyncSendV2Flags>());
+export const AdbSyncSendV2Request = struct(
+    { id: u32, mode: u32, flags: u32<AdbSyncSendV2Flags>() },
+    { littleEndian: true },
+);
 
 export async function adbSyncPushV2({
     socket,

package/src/commands/sync/request.ts

@@ -1,25 +1,24 @@
-import Struct from "@yume-chan/struct";
-
-import { encodeUtf8 } from "../../utils/index.js";
+import { encodeUtf8, struct, u32 } from "@yume-chan/struct";
 
 import { adbSyncEncodeId } from "./response.js";
 
-export namespace AdbSyncRequestId {
-    export const List = adbSyncEncodeId("LIST");
-    export const ListV2 = adbSyncEncodeId("LIS2");
-    export const Send = adbSyncEncodeId("SEND");
-    export const SendV2 = adbSyncEncodeId("SND2");
-    export const Lstat = adbSyncEncodeId("STAT");
-    export const Stat = adbSyncEncodeId("STA2");
-    export const LstatV2 = adbSyncEncodeId("LST2");
-    export const Data = adbSyncEncodeId("DATA");
-    export const Done = adbSyncEncodeId("DONE");
-    export const Receive = adbSyncEncodeId("RECV");
-}
-
-export const AdbSyncNumberRequest = new Struct({ littleEndian: true })
-    .uint32("id")
-    .uint32("arg");
+export const AdbSyncRequestId = {
+    List: adbSyncEncodeId("LIST"),
+    ListV2: adbSyncEncodeId("LIS2"),
+    Send: adbSyncEncodeId("SEND"),
+    SendV2: adbSyncEncodeId("SND2"),
+    Lstat: adbSyncEncodeId("STAT"),
+    Stat: adbSyncEncodeId("STA2"),
+    LstatV2: adbSyncEncodeId("LST2"),
+    Data: adbSyncEncodeId("DATA"),
+    Done: adbSyncEncodeId("DONE"),
+    Receive: adbSyncEncodeId("RECV"),
+} as const;
+
+export const AdbSyncNumberRequest = struct(
+    { id: u32, arg: u32 },
+    { littleEndian: true },
+);
 
 export interface AdbSyncWritable {
     write(buffer: Uint8Array): Promise<void>;

package/src/commands/sync/response.ts

@@ -1,10 +1,6 @@
 import { getUint32LittleEndian } from "@yume-chan/no-data-view";
-import type {
-    AsyncExactReadable,
-    StructLike,
-    StructValueType,
-} from "@yume-chan/struct";
-import Struct, { decodeUtf8 } from "@yume-chan/struct";
+import type { AsyncExactReadable, StructLike } from "@yume-chan/struct";
+import { decodeUtf8, string, struct, u32 } from "@yume-chan/struct";
 
 function encodeAsciiUnchecked(value: string): Uint8Array {
     const result = new Uint8Array(value.length);
@@ -18,32 +14,37 @@ function encodeAsciiUnchecked(value: string): Uint8Array {
  * Encode ID to numbers for faster comparison
  * @param value A 4-character string
  * @returns A 32-bit integer by encoding the string as little-endian
+ *
+ * #__NO_SIDE_EFFECTS__
  */
 export function adbSyncEncodeId(value: string): number {
     const buffer = encodeAsciiUnchecked(value);
     return getUint32LittleEndian(buffer, 0);
 }
 
-export namespace AdbSyncResponseId {
-    export const Entry = adbSyncEncodeId("DENT");
-    export const Entry2 = adbSyncEncodeId("DNT2");
-    export const Lstat = adbSyncEncodeId("STAT");
-    export const Stat = adbSyncEncodeId("STA2");
-    export const Lstat2 = adbSyncEncodeId("LST2");
-    export const Done = adbSyncEncodeId("DONE");
-    export const Data = adbSyncEncodeId("DATA");
-    export const Ok = adbSyncEncodeId("OKAY");
-    export const Fail = adbSyncEncodeId("FAIL");
-}
+export const AdbSyncResponseId = {
+    Entry: adbSyncEncodeId("DENT"),
+    Entry2: adbSyncEncodeId("DNT2"),
+    Lstat: adbSyncEncodeId("STAT"),
+    Stat: adbSyncEncodeId("STA2"),
+    Lstat2: adbSyncEncodeId("LST2"),
+    Done: adbSyncEncodeId("DONE"),
+    Data: adbSyncEncodeId("DATA"),
+    Ok: adbSyncEncodeId("OKAY"),
+    Fail: adbSyncEncodeId("FAIL"),
+};
 
 export class AdbSyncError extends Error {}
 
-export const AdbSyncFailResponse = new Struct({ littleEndian: true })
-    .uint32("messageLength")
-    .string("message", { lengthField: "messageLength" })
-    .postDeserialize((object) => {
-        throw new AdbSyncError(object.message);
-    });
+export const AdbSyncFailResponse = struct(
+    { message: string(u32) },
+    {
+        littleEndian: true,
+        postDeserialize(value) {
+            throw new AdbSyncError(value.message);
+        },
+    },
+);
 
 export async function adbSyncReadResponse<T>(
     stream: AsyncExactReadable,
@@ -68,13 +69,11 @@ export async function adbSyncReadResponse<T>(
     }
 }
 
-export async function* adbSyncReadResponses<
-    T extends Struct<object, PropertyKey, object, unknown>,
->(
+export async function* adbSyncReadResponses<T>(
     stream: AsyncExactReadable,
     id: number | string,
-    type: T,
-): AsyncGenerator<StructValueType<T>, void, void> {
+    type: StructLike<T>,
+): AsyncGenerator<T, void, void> {
     if (typeof id === "string") {
         id = adbSyncEncodeId(id);
     }
@@ -93,7 +92,7 @@ export async function* adbSyncReadResponses<
                 await stream.readExactly(type.size);
                 return;
             case id:
-                yield (await type.deserialize(stream)) as StructValueType<T>;
+                yield await type.deserialize(stream);
                 break;
             default:
                 throw new Error(

package/src/commands/sync/socket.ts

@@ -35,9 +35,9 @@ export class AdbSyncSocketLocked implements AsyncExactReadable {
         this.#combiner = new BufferCombiner(bufferSize);
     }
 
-    async #write(buffer: Uint8Array) {
+    #write(buffer: Uint8Array) {
         // `#combiner` will reuse the buffer, so we need to use the Consumable pattern
-        await Consumable.WritableStream.write(this.#writer, buffer);
+        return Consumable.WritableStream.write(this.#writer, buffer);
     }
 
     async flush() {

package/src/commands/sync/stat.ts

@@ -1,15 +1,18 @@
-import Struct, { placeholder } from "@yume-chan/struct";
+import type { StructValue } from "@yume-chan/struct";
+import { struct, u32, u64 } from "@yume-chan/struct";
 
 import { AdbSyncRequestId, adbSyncWriteRequest } from "./request.js";
 import { AdbSyncResponseId, adbSyncReadResponse } from "./response.js";
 import type { AdbSyncSocket } from "./socket.js";
 
 // https://github.com/python/cpython/blob/4e581d64b8aff3e2eda99b12f080c877bb78dfca/Lib/stat.py#L36
-export enum LinuxFileType {
-    Directory = 0o04,
-    File = 0o10,
-    Link = 0o12,
-}
+export const LinuxFileType = {
+    Directory: 0o04,
+    File: 0o10,
+    Link: 0o12,
+} as const;
+
+export type LinuxFileType = (typeof LinuxFileType)[keyof typeof LinuxFileType];
 
 export interface AdbSyncStat {
     mode: number;
@@ -24,79 +27,98 @@ export interface AdbSyncStat {
     ctime?: bigint;
 }
 
-export const AdbSyncLstatResponse = new Struct({ littleEndian: true })
-    .int32("mode")
-    .int32("size")
-    .int32("mtime")
-    .extra({
-        get type() {
-            return (this.mode >> 12) as LinuxFileType;
+export const AdbSyncLstatResponse = struct(
+    { mode: u32, size: u32, mtime: u32 },
+    {
+        littleEndian: true,
+        extra: {
+            get type(): LinuxFileType {
+                return (this.mode >> 12) as LinuxFileType;
+            },
+            get permission(): number {
+                return this.mode & 0b00001111_11111111;
+            },
         },
-        get permission() {
-            return this.mode & 0b00001111_11111111;
+        postDeserialize(value) {
+            if (value.mode === 0 && value.size === 0 && value.mtime === 0) {
+                throw new Error("lstat error");
+            }
+            return value;
         },
-    })
-    .postDeserialize((object) => {
-        if (object.mode === 0 && object.size === 0 && object.mtime === 0) {
-            throw new Error("lstat error");
-        }
-    });
+    },
+);
 
-export type AdbSyncLstatResponse =
-    (typeof AdbSyncLstatResponse)["TDeserializeResult"];
+export type AdbSyncLstatResponse = StructValue<typeof AdbSyncLstatResponse>;
 
-export enum AdbSyncStatErrorCode {
-    SUCCESS = 0,
-    EACCES = 13,
-    EEXIST = 17,
-    EFAULT = 14,
-    EFBIG = 27,
-    EINTR = 4,
-    EINVAL = 22,
-    EIO = 5,
-    EISDIR = 21,
-    ELOOP = 40,
-    EMFILE = 24,
-    ENAMETOOLONG = 36,
-    ENFILE = 23,
-    ENOENT = 2,
-    ENOMEM = 12,
-    ENOSPC = 28,
-    ENOTDIR = 20,
-    EOVERFLOW = 75,
-    EPERM = 1,
-    EROFS = 30,
-    ETXTBSY = 26,
-}
+export const AdbSyncStatErrorCode = {
+    SUCCESS: 0,
+    EACCES: 13,
+    EEXIST: 17,
+    EFAULT: 14,
+    EFBIG: 27,
+    EINTR: 4,
+    EINVAL: 22,
+    EIO: 5,
+    EISDIR: 21,
+    ELOOP: 40,
+    EMFILE: 24,
+    ENAMETOOLONG: 36,
+    ENFILE: 23,
+    ENOENT: 2,
+    ENOMEM: 12,
+    ENOSPC: 28,
+    ENOTDIR: 20,
+    EOVERFLOW: 75,
+    EPERM: 1,
+    EROFS: 30,
+    ETXTBSY: 26,
+} as const;
 
-export const AdbSyncStatResponse = new Struct({ littleEndian: true })
-    .uint32("error", placeholder<AdbSyncStatErrorCode>())
-    .uint64("dev")
-    .uint64("ino")
-    .uint32("mode")
-    .uint32("nlink")
-    .uint32("uid")
-    .uint32("gid")
-    .uint64("size")
-    .uint64("atime")
-    .uint64("mtime")
-    .uint64("ctime")
-    .extra({
-        get type() {
-            return (this.mode >> 12) as LinuxFileType;
+export type AdbSyncStatErrorCode =
+    (typeof AdbSyncStatErrorCode)[keyof typeof AdbSyncStatErrorCode];
+
+const AdbSyncStatErrorName = /* #__PURE__ */ (() =>
+    Object.fromEntries(
+        Object.entries(AdbSyncStatErrorCode).map(([key, value]) => [
+            value,
+            key,
+        ]),
+    ))();
+
+export const AdbSyncStatResponse = struct(
+    {
+        error: u32<AdbSyncStatErrorCode>(),
+        dev: u64,
+        ino: u64,
+        mode: u32,
+        nlink: u32,
+        uid: u32,
+        gid: u32,
+        size: u64,
+        atime: u64,
+        mtime: u64,
+        ctime: u64,
+    },
+    {
+        littleEndian: true,
+        extra: {
+            get type(): LinuxFileType {
+                return (this.mode >> 12) as LinuxFileType;
+            },
+            get permission(): number {
+                return this.mode & 0b00001111_11111111;
+            },
         },
-        get permission() {
-            return this.mode & 0b00001111_11111111;
+        postDeserialize(value) {
+            if (value.error) {
+                throw new Error(AdbSyncStatErrorName[value.error]);
+            }
+            return value;
         },
-    })
-    .postDeserialize((object) => {
-        if (object.error) {
-            throw new Error(AdbSyncStatErrorCode[object.error]);
-        }
-    });
+    },
+);
 
-export type AdbSyncStatResponse =
-    (typeof AdbSyncStatResponse)["TDeserializeResult"];
+export type AdbSyncStatResponse = StructValue<typeof AdbSyncStatResponse>;
 
 export async function adbSyncLstat(
     socket: AdbSyncSocket,

package/src/commands/sync/sync.ts

@@ -1,4 +1,3 @@
-import { AutoDisposable } from "@yume-chan/event";
 import type { MaybeConsumable, ReadableStream } from "@yume-chan/stream-extra";
 
 import type { Adb, AdbSocket } from "../../adb.js";
@@ -39,7 +38,7 @@ export interface AdbSyncWriteOptions {
     dryRun?: boolean;
 }
 
-export class AdbSync extends AutoDisposable {
+export class AdbSync {
     protected _adb: Adb;
     protected _socket: AdbSyncSocket;
 
@@ -70,8 +69,6 @@ export class AdbSync extends AutoDisposable {
     }
 
     constructor(adb: Adb, socket: AdbSocket) {
-        super();
-
         this._adb = adb;
         this._socket = new AdbSyncSocket(socket, adb.maxPayloadSize);
 
@@ -117,7 +114,7 @@ export class AdbSync extends AutoDisposable {
         try {
             await this.lstat(path + "/");
             return true;
-        } catch (e) {
+        } catch {
             return false;
         }
     }
@@ -172,8 +169,7 @@ export class AdbSync extends AutoDisposable {
         return this._socket.lock();
     }
 
-    override async dispose() {
-        super.dispose();
-        await this._socket.close();
+    dispose() {
+        return this._socket.close();
     }
 }

package/src/commands/tcpip.ts

@@ -20,14 +20,14 @@ export interface AdbTcpIpListenAddresses {
     persistPort: number | undefined;
 }
 
-export class AdbTcpIpCommand extends AdbCommandBase {
-    #parsePort(value: string): number | undefined {
-        if (!value || value === "0") {
-            return undefined;
-        }
-        return Number.parseInt(value, 10);
+function parsePort(value: string): number | undefined {
+    if (!value || value === "0") {
+        return undefined;
     }
+    return Number.parseInt(value, 10);
+}
 
+export class AdbTcpIpCommand extends AdbCommandBase {
     async getListenAddresses(): Promise<AdbTcpIpListenAddresses> {
         const serviceListenAddresses = await this.adb.getProp(
             "service.adb.listen_addrs",
@@ -40,8 +40,8 @@ export class AdbTcpIpCommand extends AdbCommandBase {
                 serviceListenAddresses != ""
                     ? serviceListenAddresses.split(",")
                     : [],
-            servicePort: this.#parsePort(servicePort),
-            persistPort: this.#parsePort(persistPort),
+            servicePort: parsePort(servicePort),
+            persistPort: parsePort(persistPort),
         };
     }
 

package/src/daemon/auth.ts

@@ -1,7 +1,7 @@
+import type { MaybePromiseLike } from "@yume-chan/async";
 import { PromiseResolver } from "@yume-chan/async";
 import type { Disposable } from "@yume-chan/event";
-import type { ValueOrPromise } from "@yume-chan/struct";
-import { EMPTY_UINT8_ARRAY } from "@yume-chan/struct";
+import { EmptyUint8Array } from "@yume-chan/struct";
 
 import {
     calculateBase64EncodedLength,
@@ -33,7 +33,7 @@ export interface AdbCredentialStore {
     /**
      * Generates and stores a RSA private key with modulus length `2048` and public exponent `65537`.
      */
-    generateKey(): ValueOrPromise<AdbPrivateKey>;
+    generateKey(): MaybePromiseLike<AdbPrivateKey>;
 
     /**
      * Synchronously or asynchronously iterates through all stored RSA private keys.
@@ -43,11 +43,13 @@ export interface AdbCredentialStore {
     iterateKeys(): AdbKeyIterable;
 }
 
-export enum AdbAuthType {
-    Token = 1,
-    Signature = 2,
-    PublicKey = 3,
-}
+export const AdbAuthType = {
+    Token: 1,
+    Signature: 2,
+    PublicKey: 3,
+} as const;
+
+export type AdbAuthType = (typeof AdbAuthType)[keyof typeof AdbAuthType];
 
 export interface AdbAuthenticator {
     /**
@@ -114,7 +116,7 @@ export const AdbPublicKeyAuthenticator: AdbAuthenticator = async function* (
 
     const nameBuffer = privateKey.name?.length
         ? encodeUtf8(privateKey.name)
-        : EMPTY_UINT8_ARRAY;
+        : EmptyUint8Array;
     const publicKeyBuffer = new Uint8Array(
         publicKeyBase64Length +
             (nameBuffer.length ? nameBuffer.length + 1 : 0) + // Space character + name

package/src/daemon/crypto.ts

@@ -38,6 +38,8 @@ export function getBigUint(
  * @param littleEndian If `false` or `undefined`, a big-endian value should be written,
  * otherwise a little-endian value should be written.
  */
+
+// eslint-disable-next-line @typescript-eslint/max-params
 export function setBigUint(
     array: Uint8Array,
     byteOffset: number,

package/src/daemon/device.ts

@@ -1,5 +1,5 @@
+import type { MaybePromiseLike } from "@yume-chan/async";
 import type { Consumable, ReadableWritablePair } from "@yume-chan/stream-extra";
-import type { ValueOrPromise } from "@yume-chan/struct";
 
 import type { AdbPacketData, AdbPacketInit } from "./packet.js";
 
@@ -8,7 +8,7 @@ export interface AdbDaemonDevice {
 
     readonly name: string | undefined;
 
-    connect(): ValueOrPromise<
+    connect(): MaybePromiseLike<
         ReadableWritablePair<AdbPacketData, Consumable<AdbPacketInit>>
     >;
 }