@yume-chan/adb 3.0.0-beta.0 → 3.0.0-beta.2

package/esm/service/sync/request/push.js

@@ -1,83 +1,199 @@
-import { AbortController, DistributionStream, MaybeConsumable, } from "@yume-chan/stream-extra";
+import { PromiseResolver } from "@yume-chan/async";
+import { DistributionStream, MaybeConsumable } from "@yume-chan/stream-extra";
 import { struct, u32 } from "@yume-chan/struct";
-import { NOOP } from "../../../utils/index.js";
+import { NOOP } from "../../../utils/no-op.js";
 import { LinuxFileType } from "../android.js";
 import { Compression } from "../compression/index.js";
 import { RequestId, ResponseId } from "../id/index.js";
 import { Error as AdbSyncError } from "../socket.js";
+import { SyncFlag } from "./flag.js";
 export const MaxPacketSize = 64 * 1024;
 export const OkResponse = struct({ unused: u32 }, { littleEndian: true });
-// eslint-disable-next-line @typescript-eslint/max-params
-async function pipeFileData(socket, file, packetSize, mtime, compression) {
-    if (compression !== Compression.Format.None) {
-        const stream = Compression.createCompressionStream(compression);
-        void file
-            .pipeTo(new MaybeConsumable.WrapWritableStream(stream.writable))
-            .catch(NOOP);
-        file = stream.readable;
+class SendWritableStream extends MaybeConsumable.WritableStream {
+    #pool;
+    #socket;
+    #resolver = new PromiseResolver();
+    #controller;
+    #bytesWritten = 0;
+    get bytesWritten() {
+        return this.#bytesWritten;
     }
-    // Read and write in parallel,
-    // allow error response to abort the write.
-    const abortController = new AbortController();
-    file.pipeThrough(new DistributionStream(packetSize, true))
-        .pipeTo(new MaybeConsumable.WritableStream({
-        write(chunk) {
-            return socket.writeRequest(RequestId.Data, chunk);
-        },
-    }), { signal: abortController.signal })
-        .then(async () => {
-        await socket.writeRequest(RequestId.Done, mtime);
-        await socket.flush();
-    }, NOOP);
+    constructor(pool, socket, mtime) {
+        let controller;
+        super({
+            start: (controller_) => {
+                controller = controller_;
+                // Start reading response immediately,
+                // the server can send error response before the whole file is sent.
+                socket.readResponse(ResponseId.Ok, OkResponse).then(() => this.#finish(), (e) => this.#finish(e));
+            },
+            write: async (chunk) => {
+                try {
+                    this.#bytesWritten += chunk.length;
+                    await socket.writeRequest(RequestId.Data, chunk);
+                }
+                catch (e) {
+                    await this.#finish(e);
+                }
+            },
+            close: async () => {
+                try {
+                    await socket.writeRequest(RequestId.Done, mtime);
+                    await socket.flush();
+                }
+                catch (e) {
+                    await this.#finish(e);
+                    return;
+                }
+                await this.#resolver.promise;
+            },
+            abort: async (reason) => {
+                // Write anything other than `Data` or `Done`
+                // will cause the server to delete the file.
+                await socket.writeRequest(ResponseId.Fail, 0);
+                // Socket not reusable after aborting, so discard it.
+                await this.#finish(reason);
+            },
+        });
+        this.#pool = pool;
+        this.#socket = socket;
+        this.#controller = controller;
+        // Suppress unhandled rejection warning when the promise is not awaited.
+        this.#resolver.promise.catch(NOOP);
+    }
+    #trySetError(reason) {
+        try {
+            this.#controller.error(reason);
+        }
+        catch {
+            // Ignore if controller is already closed or errored
+        }
+    }
+    async #finish(error) {
+        try {
+            await this.#pool.release(this.#socket, !(error instanceof AdbSyncError));
+            if (error) {
+                this.#trySetError(error);
+                this.#resolver.reject(error);
+            }
+            else {
+                this.#resolver.resolve();
+            }
+        }
+        catch (e) {
+            // TOOD: use `SuppressedError` when universally supported
+            this.#trySetError(e);
+            this.#resolver.reject(e);
+        }
+    }
+}
+export async function sendV1({ pool, path, type = LinuxFileType.File, permission = 0o666, mtime = (Date.now() / 1000) | 0, packetSize = MaxPacketSize, }) {
+    const mode = (type << 12) | permission;
+    const request = path + "," + mode;
+    const socket = await pool.acquire();
     try {
-        await socket.readResponse(ResponseId.Ok, OkResponse);
+        await socket.writeRequest(RequestId.Send, request);
     }
     catch (e) {
-        abortController.abort(e);
+        await pool.release(socket, !(e instanceof AdbSyncError));
         throw e;
     }
+    const distributeStream = new DistributionStream(packetSize, true);
+    const sendStream = new SendWritableStream(pool, socket, mtime);
+    void distributeStream.readable.pipeTo(sendStream).catch(NOOP);
+    return {
+        writable: distributeStream.writable,
+        get bytesWritten() {
+            return sendStream.bytesWritten;
+        },
+        get bytesCompressed() {
+            return sendStream.bytesWritten;
+        },
+    };
 }
-export function sendV1({ pool, filename, file, type = LinuxFileType.File, permission = 0o666, mtime = (Date.now() / 1000) | 0, packetSize = MaxPacketSize, }) {
-    return pool.withSocket(async (socket) => {
-        const mode = (type << 12) | permission;
-        const pathAndMode = `${filename},${mode.toString()}`;
-        await socket.writeRequest(RequestId.Send, pathAndMode);
-        await pipeFileData(socket, file, packetSize, mtime, Compression.Format.None);
-    });
-}
-export const SendV2Flags = {
-    None: 0,
-    Brotli: 1,
-    Lz4: 2,
-    Zstd: 4,
-    DryRun: 0x80000000,
-};
 export const SendV2Request = struct({ id: u32, mode: u32, flags: u32 }, { littleEndian: true });
-export function sendV2({ pool, filename, file, type = LinuxFileType.File, permission = 0o666, mtime = (Date.now() / 1000) | 0, packetSize = MaxPacketSize, compression = Compression.Format.None, dryRun = false, }) {
-    return pool.withSocket(async (socket) => {
-        let flags = SendV2Flags.None;
-        switch (compression) {
-            case Compression.Format.Brotli:
-                flags |= SendV2Flags.Brotli;
-                break;
-            case Compression.Format.Lz4:
-                flags |= SendV2Flags.Lz4;
-                break;
-            case Compression.Format.Zstd:
-                flags |= SendV2Flags.Zstd;
-                break;
-        }
-        if (dryRun) {
-            flags |= SendV2Flags.DryRun;
-        }
-        await socket.writeRequest(RequestId.SendV2, filename);
+export async function sendV2({ pool, path, type = LinuxFileType.File, permission = 0o666, mtime = (Date.now() / 1000) | 0, packetSize = MaxPacketSize, compression = Compression.Format.None, dryRun = false, }) {
+    let flags = SyncFlag.None;
+    let compressStream;
+    // Validate `compression` before acquiring the socket
+    switch (compression) {
+        case Compression.Format.Brotli:
+            flags |= SyncFlag.Brotli;
+            compressStream = Compression.createCompressionStream(Compression.Format.Brotli);
+            break;
+        case Compression.Format.Lz4:
+            flags |= SyncFlag.Lz4;
+            compressStream = Compression.createCompressionStream(Compression.Format.Lz4);
+            break;
+        case Compression.Format.Zstd:
+            flags |= SyncFlag.Zstd;
+            compressStream = Compression.createCompressionStream(Compression.Format.Zstd);
+            break;
+    }
+    if (dryRun) {
+        flags |= SyncFlag.DryRun;
+    }
+    const socket = await pool.acquire();
+    try {
+        await socket.writeRequest(RequestId.SendV2, path);
         await socket.write(SendV2Request.serialize({
             id: RequestId.SendV2,
             mode: (type << 12) | permission,
             flags,
         }));
-        await pipeFileData(socket, file, packetSize, mtime, compression);
-    });
+    }
+    catch (e) {
+        await pool.release(socket, !(e instanceof AdbSyncError));
+        throw e;
+    }
+    const distributeStream = new DistributionStream(packetSize, true);
+    const sendStream = new SendWritableStream(pool, socket, mtime);
+    if (!compressStream) {
+        const pipe = distributeStream.readable.pipeTo(sendStream);
+        const writer = distributeStream.writable.getWriter();
+        return {
+            writable: new MaybeConsumable.WritableStream({
+                write(chunk) {
+                    return writer.write(chunk);
+                },
+                async close() {
+                    await writer.close();
+                    await pipe;
+                },
+            }),
+            get bytesWritten() {
+                return sendStream.bytesWritten;
+            },
+            compression: Compression.Format.None,
+            get bytesCompressed() {
+                return sendStream.bytesWritten;
+            },
+        };
+    }
+    const pipe = compressStream.readable
+        .pipeThrough(distributeStream)
+        .pipeTo(sendStream);
+    const writer = compressStream.writable.getWriter();
+    let bytesWritten = 0;
+    return {
+        writable: new MaybeConsumable.WritableStream({
+            write(chunk) {
+                bytesWritten += chunk.length;
+                return writer.write(chunk);
+            },
+            async close() {
+                await writer.close();
+                await pipe;
+            },
+        }),
+        get bytesWritten() {
+            return bytesWritten;
+        },
+        compression,
+        get bytesCompressed() {
+            return sendStream.bytesWritten;
+        },
+    };
 }
 export function send(options) {
     if (options.version === 2) {

package/esm/service/sync/request/push.js.map

@@ -1 +1 @@
-{"version":3,"file":"push.js","sourceRoot":"","sources":["../../../../src/service/sync/request/push.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"push.js","sourceRoot":"","sources":["../../../../src/service/sync/request/push.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAMnD,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGvD,OAAO,EAAE,KAAK,IAAI,YAAY,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,GAAG,IAAI,CAAC;AAEvC,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;AAwB1E,MAAM,kBAAmB,SAAQ,eAAe,CAAC,cAA0B;IACvE,KAAK,CAAa;IAClB,OAAO,CAAS;IAEhB,SAAS,GAAG,IAAI,eAAe,EAAQ,CAAC;IACxC,WAAW,CAAkC;IAE7C,aAAa,GAAG,CAAC,CAAC;IAClB,IAAI,YAAY;QACZ,OAAO,IAAI,CAAC,aAAa,CAAC;IAC9B,CAAC;IAED,YAAY,IAAgB,EAAE,MAAc,EAAE,KAAa;QACvD,IAAI,UAA4C,CAAC;QAEjD,KAAK,CAAC;YACF,KAAK,EAAE,CAAC,WAAW,EAAE,EAAE;gBACnB,UAAU,GAAG,WAAW,CAAC;gBAEzB,sCAAsC;gBACtC,oEAAoE;gBACpE,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC,IAAI,CAC/C,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,EACpB,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CACzB,CAAC;YACN,CAAC;YACD,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBACnB,IAAI,CAAC;oBACD,IAAI,CAAC,aAAa,IAAI,KAAK,CAAC,MAAM,CAAC;oBACnC,MAAM,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBACrD,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACT,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBAC1B,CAAC;YACL,CAAC;YACD,KAAK,EAAE,KAAK,IAAI,EAAE;gBACd,IAAI,CAAC;oBACD,MAAM,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;oBACjD,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;gBACzB,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACT,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;oBACtB,OAAO;gBACX,CAAC;gBACD,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YACjC,CAAC;YACD,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;gBACpB,6CAA6C;gBAC7C,4CAA4C;gBAC5C,MAAM,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;gBAE9C,qDAAqD;gBACrD,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC/B,CAAC;SACJ,CAAC,CAAC;QAEH,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QAEtB,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,wEAAwE;QACxE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,YAAY,CAAC,MAAe;QACxB,IAAI,CAAC;YACD,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACL,oDAAoD;QACxD,CAAC;IACL,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAe;QACzB,IAAI,CAAC;YACD,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CACpB,IAAI,CAAC,OAAO,EACZ,CAAC,CAAC,KAAK,YAAY,YAAY,CAAC,CACnC,CAAC;YACF,IAAI,KAAK,EAAE,CAAC;gBACR,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;gBACzB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACjC,CAAC;iBAAM,CAAC;gBACJ,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;YAC7B,CAAC;QACL,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,yDAAyD;YACzD,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YACrB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;IACL,CAAC;CACJ;AAWD,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,EACzB,IAAI,EACJ,IAAI,EACJ,IAAI,GAAG,aAAa,CAAC,IAAI,EACzB,UAAU,GAAG,KAAK,EAClB,KAAK,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAC/B,UAAU,GAAG,aAAa,GACd;IACZ,MAAM,IAAI,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,GAAG,UAAU,CAAC;IACvC,MAAM,OAAO,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC;IAElC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;IACpC,IAAI,CAAC;QACD,MAAM,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,YAAY,YAAY,CAAC,CAAC,CAAC;QACzD,MAAM,CAAC,CAAC;IACZ,CAAC;IAED,MAAM,gBAAgB,GAAG,IAAI,kBAAkB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAClE,MAAM,UAAU,GAAG,IAAI,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC/D,KAAK,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE9D,OAAO;QACH,QAAQ,EAAE,gBAAgB,CAAC,QAAQ;QACnC,IAAI,YAAY;YACZ,OAAO,UAAU,CAAC,YAAY,CAAC;QACnC,CAAC;QACD,IAAI,eAAe;YACf,OAAO,UAAU,CAAC,YAAY,CAAC;QACnC,CAAC;KACJ,CAAC;AACN,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAC/B,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,EAClC,EAAE,YAAY,EAAE,IAAI,EAAE,CACzB,CAAC;AAwBF,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,EACzB,IAAI,EACJ,IAAI,EACJ,IAAI,GAAG,aAAa,CAAC,IAAI,EACzB,UAAU,GAAG,KAAK,EAClB,KAAK,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAC/B,UAAU,GAAG,aAAa,EAC1B,WAAW,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,EACrC,MAAM,GAAG,KAAK,GACF;IACZ,IAAI,KAAK,GAAa,QAAQ,CAAC,IAAI,CAAC;IACpC,IAAI,cAAmE,CAAC;IAExE,qDAAqD;IACrD,QAAQ,WAAW,EAAE,CAAC;QAClB,KAAK,WAAW,CAAC,MAAM,CAAC,MAAM;YAC1B,KAAK,IAAI,QAAQ,CAAC,MAAM,CAAC;YACzB,cAAc,GAAG,WAAW,CAAC,uBAAuB,CAChD,WAAW,CAAC,MAAM,CAAC,MAAM,CAC5B,CAAC;YACF,MAAM;QACV,KAAK,WAAW,CAAC,MAAM,CAAC,GAAG;YACvB,KAAK,IAAI,QAAQ,CAAC,GAAG,CAAC;YACtB,cAAc,GAAG,WAAW,CAAC,uBAAuB,CAChD,WAAW,CAAC,MAAM,CAAC,GAAG,CACzB,CAAC;YACF,MAAM;QACV,KAAK,WAAW,CAAC,MAAM,CAAC,IAAI;YACxB,KAAK,IAAI,QAAQ,CAAC,IAAI,CAAC;YACvB,cAAc,GAAG,WAAW,CAAC,uBAAuB,CAChD,WAAW,CAAC,MAAM,CAAC,IAAI,CAC1B,CAAC;YACF,MAAM;IACd,CAAC;IACD,IAAI,MAAM,EAAE,CAAC;QACT,KAAK,IAAI,QAAQ,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;IACpC,IAAI,CAAC;QACD,MAAM,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAClD,MAAM,MAAM,CAAC,KAAK,CACd,aAAa,CAAC,SAAS,CAAC;YACpB,EAAE,EAAE,SAAS,CAAC,MAAM;YACpB,IAAI,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,GAAG,UAAU;YAC/B,KAAK;SACR,CAAC,CACL,CAAC;IACN,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,YAAY,YAAY,CAAC,CAAC,CAAC;QACzD,MAAM,CAAC,CAAC;IACZ,CAAC;IAED,MAAM,gBAAgB,GAAG,IAAI,kBAAkB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAClE,MAAM,UAAU,GAAG,IAAI,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAE/D,IAAI,CAAC,cAAc,EAAE,CAAC;QAClB,MAAM,IAAI,GAAG,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAE1D,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;QACrD,OAAO;YACH,QAAQ,EAAE,IAAI,eAAe,CAAC,cAAc,CAAC;gBACzC,KAAK,CAAC,KAAK;oBACP,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAC/B,CAAC;gBACD,KAAK,CAAC,KAAK;oBACP,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;oBACrB,MAAM,IAAI,CAAC;gBACf,CAAC;aACJ,CAAC;YACF,IAAI,YAAY;gBACZ,OAAO,UAAU,CAAC,YAAY,CAAC;YACnC,CAAC;YACD,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,IAAI;YACpC,IAAI,eAAe;gBACf,OAAO,UAAU,CAAC,YAAY,CAAC;YACnC,CAAC;SACJ,CAAC;IACN,CAAC;IAED,MAAM,IAAI,GAAG,cAAc,CAAC,QAAQ;SAC/B,WAAW,CAAC,gBAAgB,CAAC;SAC7B,MAAM,CAAC,UAAU,CAAC,CAAC;IAExB,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;IACnD,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,OAAO;QACH,QAAQ,EAAE,IAAI,eAAe,CAAC,cAAc,CAAC;YACzC,KAAK,CAAC,KAAK;gBACP,YAAY,IAAI,KAAK,CAAC,MAAM,CAAC;gBAC7B,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC/B,CAAC;YACD,KAAK,CAAC,KAAK;gBACP,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;gBACrB,MAAM,IAAI,CAAC;YACf,CAAC;SACJ,CAAC;QACF,IAAI,YAAY;YACZ,OAAO,YAAY,CAAC;QACxB,CAAC;QACD,WAAW;QACX,IAAI,eAAe;YACf,OAAO,UAAU,CAAC,YAAY,CAAC;QACnC,CAAC;KACJ,CAAC;AACN,CAAC;AAMD,MAAM,UAAU,IAAI,CAAC,OAAoB;IACrC,IAAI,OAAO,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACjB,MAAM,IAAI,YAAY,CAAC,+BAA+B,CAAC,CAAC;IAC5D,CAAC;IAED,IACI,OAAO,CAAC,WAAW,KAAK,SAAS;QACjC,OAAO,CAAC,WAAW,KAAK,WAAW,CAAC,MAAM,CAAC,IAAI,EACjD,CAAC;QACC,MAAM,IAAI,YAAY,CAAC,oCAAoC,CAAC,CAAC;IACjE,CAAC;IAED,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;AAC3B,CAAC"}

package/esm/service/sync/service.d.ts

@@ -1,8 +1,9 @@
-import type { AbortSignal, MaybeConsumable, ReadableStream } from "@yume-chan/stream-extra";
+import type { AbortSignal, ReadableStream } from "@yume-chan/stream-extra";
+import { MaybeConsumable } from "@yume-chan/stream-extra";
 import type { Adb } from "../../adb.js";
 import type { LinuxFileType } from "./android.js";
 import { Compression } from "./compression/index.js";
-import { OpenDir, Stat } from "./request/index.js";
+import { OpenDir, Receive, Send, Stat } from "./request/index.js";
 import type { Socket } from "./socket.js";
 export interface ServiceOptions {
     /**
@@ -29,20 +30,20 @@ export interface ServiceOptions {
  */
 export declare function dirname(path: string): string;
 export interface WriteOptions {
-    filename: string;
-    file: ReadableStream<MaybeConsumable<Uint8Array>>;
+    path: string;
     type?: LinuxFileType | undefined;
     permission?: number | undefined;
     mtime?: number | undefined;
     /**
      * The format to compress the file stream for sending.
      *
-     * If the device doesn't support compressed sending, it will be ignored.
+     * If the device doesn't support compressed sending, the value will be ignored.
      *
-     * If the device or current runtime doesn't support the specified format,
+     * Otherwise, if the device or current runtime doesn't support the specified format,
      * an Error will be thrown.
-     * {@link Compression.canUseFormat} can be used to check if
-     * the device and current runtime both supports the format.
+     *
+     * If `undefined` is specified, automatically choose the best format
+     * supported by both device and current runtime.
      */
     compression?: Compression.Format | undefined;
     dryRun?: boolean | undefined;
@@ -107,17 +108,32 @@ export declare class Service {
     opendir(path: string): AsyncGenerator<OpenDir.Entry, void, void>;
     readdir(path: string): Promise<OpenDir.Entry[]>;
     /**
-     * Reads the content of a file on device.
-     *
-     * @param filename The full path of the file on device to read.
-     * @returns A `ReadableStream` that contains the file content.
+     * Creates a readable stream to read the content of a file on device.
+     * @param path The full path of the file on device to read.
+     * @param compression The compression format to use for reading the file. If the device doesn't support compressed reading, the value will be ignored.
+     * @returns A {@link Receive.ReceiveSession} object that contains a readable stream to read the file content.
      */
-    read(filename: string): ReadableStream<Uint8Array>;
+    createReadable(path: string, compression?: Compression.Format): Receive.ReceiveSession;
     /**
-     * Writes a file on device. If the file name already exists, it will be overwritten.
+     * Creates a readable stream to read the content of a file on device.
      *
-     * @param options The content and options of the file to write.
+     * @param path The full path of the file on device to read.
+     * @returns A readable stream to read the file content.
+     */
+    read(path: string): ReadableStream<Uint8Array>;
+    /**
+     * Creates a writable stream to write a file
+     * @param options The options for writing the file, including the path, type, permission, mtime, and compression format.
+     * @returns A {@link SendSession} object that contains a writable stream to write the file content.
+     */
+    createWritable(options: WriteOptions): Promise<Send.SendSession>;
+    /**
+     * Writes a file to the device using a readable stream.
+     * @param options The options for writing the file, including the path, type, permission, mtime, compression format, and a readable stream to read the file content.
+     * @returns An object that contains the number of bytes written, the compression format used (if any), and the size of the compressed data written (if any).
      */
-    write(options: WriteOptions): Promise<void>;
+    write(options: WriteOptions & {
+        readable: ReadableStream<MaybeConsumable<Uint8Array>>;
+    }): Promise<Omit<Send.SendSession, "writable">>;
 }
 //# sourceMappingURL=service.d.ts.map

package/esm/service/sync/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/service/sync/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,WAAW,EACX,eAAe,EACf,cAAc,EACjB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAIxC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAiB,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAElE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,MAAM,WAAW,cAAc;IAC3B;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEjC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEjC;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CACpC;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAS5C;AAED,MAAM,WAAW,YAAY;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,cAAc,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC;IAClD,IAAI,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B;;;;;;;;;OASG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,SAAS,CAAC;IAC7C,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAChC;AAED,qBAAa,OAAO;;IAChB,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC;IASpB,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED,IAAI,oBAAoB,IAAI,OAAO,CAElC;IAED,IAAI,uBAAuB,IAAI,OAAO,CAErC;gBAEW,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,cAAc;IAsB9C;;;;;;OAMG;IACG,aAAa;IAInB;;;;;OAKG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,UAAQ;IAInD;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;IAMvC;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM;;;;;;;;;;;;;;;;IAQjB;;;;OAIG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAajD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC;IAM1D,OAAO,CAAC,IAAI,EAAE,MAAM;IAS1B;;;;;OAKG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAAC,UAAU,CAAC;IAIlD;;;;OAIG;IACG,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;CAmCpD"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/service/sync/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAIxC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAElE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,MAAM,WAAW,cAAc;IAC3B;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEjC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEjC;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CACpC;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAS5C;AAED,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B;;;;;;;;;;OAUG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,SAAS,CAAC;IAC7C,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAChC;AAED,qBAAa,OAAO;;IAChB,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC;IASpB,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED,IAAI,oBAAoB,IAAI,OAAO,CAElC;IAED,IAAI,uBAAuB,IAAI,OAAO,CAErC;gBAEW,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,cAAc;IAsB9C;;;;;;OAMG;IACG,aAAa;IAInB;;;;;OAKG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,UAAQ;IAInD;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;IAMvC;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM;;;;;;;;;;;;;;;;IAQjB;;;;OAIG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAajD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC;IAM1D,OAAO,CAAC,IAAI,EAAE,MAAM;IAS1B;;;;;OAKG;IACH,cAAc,CACV,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,GACjC,OAAO,CAAC,cAAc;IAwBzB;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC,UAAU,CAAC;IAK9C;;;;OAIG;IACG,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC;IA4CtE;;;;OAIG;IACG,KAAK,CACP,OAAO,EAAE,YAAY,GAAG;QACpB,QAAQ,EAAE,cAAc,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC;KACzD,GACF,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;CAWjD"}

package/esm/service/sync/service.js

@@ -1,3 +1,4 @@
+import { MaybeConsumable } from "@yume-chan/stream-extra";
 import { AdbFeature } from "../../features.js";
 import { escapeArg } from "../subprocess/index.js";
 import { Compression } from "./compression/index.js";
@@ -130,41 +131,85 @@ export class Service {
         return results;
     }
     /**
-     * Reads the content of a file on device.
-     *
-     * @param filename The full path of the file on device to read.
-     * @returns A `ReadableStream` that contains the file content.
+     * Creates a readable stream to read the content of a file on device.
+     * @param path The full path of the file on device to read.
+     * @param compression The compression format to use for reading the file. If the device doesn't support compressed reading, the value will be ignored.
+     * @returns A {@link Receive.ReceiveSession} object that contains a readable stream to read the file content.
      */
-    read(filename) {
-        return Receive.stream(this.#socketPool, filename);
+    createReadable(path, compression) {
+        if (this.#supportsSendReceive2) {
+            if (compression === undefined) {
+                compression = Compression.chooseFormat(this._adb, Compression.Mode.Decompress);
+            }
+            else if (!Compression.canUseFormat(this._adb, compression, Compression.Mode.Decompress)) {
+                throw new Error(`Compression type ${Compression.FormatNameMap[compression]} is not supported`);
+            }
+            return Receive.receiveV2(this.#socketPool, path, compression);
+        }
+        else {
+            return Receive.receiveV1(this.#socketPool, path);
+        }
     }
     /**
-     * Writes a file on device. If the file name already exists, it will be overwritten.
+     * Creates a readable stream to read the content of a file on device.
      *
-     * @param options The content and options of the file to write.
+     * @param path The full path of the file on device to read.
+     * @returns A readable stream to read the file content.
      */
-    async write(options) {
+    read(path) {
+        const session = this.createReadable(path);
+        return session.readable;
+    }
+    /**
+     * Creates a writable stream to write a file
+     * @param options The options for writing the file, including the path, type, permission, mtime, and compression format.
+     * @returns A {@link SendSession} object that contains a writable stream to write the file content.
+     */
+    async createWritable(options) {
         if (this.needPushMkdirWorkaround) {
             // It may fail if `filename` already exists.
             // Ignore the result.
             // TODO: sync: test push mkdir workaround (need an Android 8 device)
             await this._adb.subprocess.noneProtocol
-                .spawn(["mkdir", "-p", escapeArg(dirname(options.filename))])
+                .spawn(["mkdir", "-p", escapeArg(dirname(options.path))])
                 .wait();
         }
         if (this.supportsSendReceive2) {
             if (options.compression === undefined) {
-                options.compression = Compression.chooseFormat(this._adb, Compression.Mode.Compress);
+                options = {
+                    ...options,
+                    compression: Compression.chooseFormat(this._adb, Compression.Mode.Compress),
+                };
             }
             else if (!Compression.canUseFormat(this._adb, options.compression, Compression.Mode.Compress)) {
-                throw new Error(`Compression type ${options.compression} is not supported`);
+                throw new Error(`Compression type ${Compression.FormatNameMap[options.compression]} is not supported`);
             }
         }
-        await Send.send({
+        else {
+            options = {
+                ...options,
+                compression: undefined,
+            };
+        }
+        return await Send.send({
             version: this.supportsSendReceive2 ? 2 : 1,
             pool: this.#socketPool,
             ...options,
         });
     }
+    /**
+     * Writes a file to the device using a readable stream.
+     * @param options The options for writing the file, including the path, type, permission, mtime, compression format, and a readable stream to read the file content.
+     * @returns An object that contains the number of bytes written, the compression format used (if any), and the size of the compressed data written (if any).
+     */
+    async write(options) {
+        const session = await this.createWritable(options);
+        await options.readable.pipeTo(new MaybeConsumable.WrapWritableStream(session.writable));
+        return {
+            bytesWritten: session.bytesWritten,
+            compression: session.compression,
+            bytesCompressed: session.bytesCompressed,
+        };
+    }
 }
 //# sourceMappingURL=service.js.map

package/esm/service/sync/service.js.map

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

package/esm/service/sync/socket-pool.d.ts

@@ -5,6 +5,7 @@ export declare class SocketPool {
     constructor(adb: Adb, maxSize?: number, idleTimeout?: number);
     acquire(): Promise<Socket>;
     withSocket<T>(fn: (socket: Socket) => Promise<T>): Promise<T>;
+    withSocketGenerator<T>(fn: (socket: Socket) => AsyncGenerator<T, void, void>): AsyncGenerator<T, void, void>;
     release(socket: Socket, discard?: boolean): Promise<void>;
     dispose(): Promise<void>;
 }

package/esm/service/sync/socket-pool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"socket-pool.d.ts","sourceRoot":"","sources":["../../../src/service/sync/socket-pool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAExC,OAAO,EAAyB,MAAM,EAAE,MAAM,aAAa,CAAC;AAE5D,qBAAa,UAAU;;gBAQP,GAAG,EAAE,GAAG,EAAE,OAAO,SAAI,EAAE,WAAW,SAAQ;IAMhD,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAwB1B,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAY7D,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBvD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAiBjC"}
+{"version":3,"file":"socket-pool.d.ts","sourceRoot":"","sources":["../../../src/service/sync/socket-pool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAGxC,OAAO,EAAyB,MAAM,EAAE,MAAM,aAAa,CAAC;AAE5D,qBAAa,UAAU;;gBASP,GAAG,EAAE,GAAG,EAAE,OAAO,SAAI,EAAE,WAAW,SAAQ;IAMhD,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAsC1B,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAY5D,mBAAmB,CAAC,CAAC,EACxB,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,GACtD,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC;IAkB1B,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BvD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAkBjC"}

package/esm/service/sync/socket-pool.js

@@ -1,3 +1,4 @@
+import { Ref } from "../../utils/ref.js";
 import { Error as AdbSyncError, Socket } from "./socket.js";
 export class SocketPool {
     #adb;
@@ -5,6 +6,7 @@ export class SocketPool {
     #idleTimeout;
     #availableSockets = [];
     #inUseSockets = new Set();
+    #ref = new Ref({ unref: true });
     #closed = false;
     constructor(adb, maxSize = 4, idleTimeout = 60000) {
         this.#adb = adb;
@@ -21,17 +23,28 @@ export class SocketPool {
             // Clear the idle timeout
             socket.clearIdleTimer();
             this.#inUseSockets.add(socket);
+            this.#ref.ref();
             return socket;
         }
-        // Create a new socket
-        const adbSocket = await this.#adb.createSocket("sync:");
-        if (this.#closed) {
-            await adbSocket.close();
-            throw new Error("SocketPool is closed");
+        try {
+            // Add ref early to keep the process alive while initializing the new socket
+            this.#ref.ref();
+            // Create a new socket
+            const adbSocket = await this.#adb.createSocket("sync:", {
+                unref: true,
+            });
+            if (this.#closed) {
+                await adbSocket.close();
+                throw new Error("SocketPool is closed");
+            }
+            const socket = new Socket(adbSocket, this.#adb.maxPayloadSize);
+            this.#inUseSockets.add(socket);
+            return socket;
+        }
+        catch (e) {
+            this.#ref.unref();
+            throw e;
         }
-        const socket = new Socket(adbSocket, this.#adb.maxPayloadSize);
-        this.#inUseSockets.add(socket);
-        return socket;
     }
     async withSocket(fn) {
         const socket = await this.acquire();
@@ -45,8 +58,30 @@ export class SocketPool {
             throw e;
         }
     }
+    async *withSocketGenerator(fn) {
+        const socket = await this.acquire();
+        let discard = true;
+        try {
+            for await (const value of fn(socket)) {
+                yield value;
+            }
+            discard = false;
+        }
+        catch (e) {
+            discard = !(e instanceof AdbSyncError);
+            throw e;
+        }
+        finally {
+            // When the generator is retuned early, `discard` will have the default value of `true`,
+            // the socket needs to be closed, so the server will stop sending data.
+            await this.release(socket, discard);
+        }
+    }
     async release(socket, discard = false) {
-        this.#inUseSockets.delete(socket);
+        if (!this.#inUseSockets.delete(socket)) {
+            return;
+        }
+        this.#ref.unref();
         // If discarding or we already have enough sockets in the pool, close this socket
         if (discard || this.#availableSockets.length >= this.#maxSize) {
             await socket.close();
@@ -74,6 +109,7 @@ export class SocketPool {
         // Force close all in-use sockets immediately
         const inUseClosePromises = Array.from(this.#inUseSockets).map((socket) => socket.close());
         this.#inUseSockets.clear();
+        this.#ref.dispose();
         await Promise.all([...closePromises, ...inUseClosePromises]);
     }
 }