@mtkruto/browser 0.132.1 → 0.134.0

package/esm/0_deps.d.ts

@@ -32,6 +32,7 @@ export { pooledMap } from "./deps/jsr.io/@std/async/1.2.0/pool.js";
 export { concat } from "./deps/jsr.io/@std/bytes/1.0.6/concat.js";
 export { equals } from "./deps/jsr.io/@std/bytes/1.0.6/equals.js";
 export { startsWith } from "./deps/jsr.io/@std/bytes/1.0.6/starts_with.js";
+export { isIPv4, isIPv6 } from "./deps/jsr.io/@std/net/1.0.6/unstable_ip.js";
 export { LruCache } from "./deps/jsr.io/@std/cache/0.2.2/lru_cache.js";
 export { writeAll } from "./deps/jsr.io/@std/io/0.225.3/write_all.js";
 export { format } from "./deps/jsr.io/@std/datetime/0.225.7/format.js";

package/esm/0_deps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"0_deps.d.ts","sourceRoot":"","sources":["../src/0_deps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,4CAA4C,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,iDAAiD,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,qDAAqD,CAAC;AAErF,OAAO,EAAE,IAAI,EAAE,MAAM,uCAAuC,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,0CAA0C,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,2CAA2C,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,8CAA8C,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,8CAA8C,CAAC;AAE1E,OAAO,EAAE,KAAK,EAAE,MAAM,yCAAyC,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AAEnE,OAAO,EAAE,MAAM,EAAE,MAAM,0CAA0C,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,0CAA0C,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,+CAA+C,CAAC;AAE3E,OAAO,EAAE,QAAQ,EAAE,MAAM,6CAA6C,CAAC;AAEvE,OAAO,EAAE,QAAQ,EAAE,MAAM,4CAA4C,CAAC;AAEtE,OAAO,EAAE,MAAM,EAAE,MAAM,+CAA+C,CAAC;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kDAAkD,CAAC;AAElF,OAAO,EAAE,aAAa,EAAE,MAAM,sDAAsD,CAAC;AAErF,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAC;AAE1F,OAAO,EAAE,WAAW,IAAI,YAAY,EAAE,MAAM,sDAAsD,CAAC;AACnG,eAAO,MAAM,WAAW,EAAE,OAAO,YAMhC,CAAC;AAEF,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,UAMzC;AAED,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,IAAI,IAAI,YAAY,EAAE,MAAM,+CAA+C,CAAC"}
+{"version":3,"file":"0_deps.d.ts","sourceRoot":"","sources":["../src/0_deps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,4CAA4C,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,iDAAiD,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,qDAAqD,CAAC;AAErF,OAAO,EAAE,IAAI,EAAE,MAAM,uCAAuC,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,0CAA0C,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,2CAA2C,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,8CAA8C,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,8CAA8C,CAAC;AAE1E,OAAO,EAAE,KAAK,EAAE,MAAM,yCAAyC,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AAEnE,OAAO,EAAE,MAAM,EAAE,MAAM,0CAA0C,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,0CAA0C,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,+CAA+C,CAAC;AAE3E,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,6CAA6C,CAAC;AAE7E,OAAO,EAAE,QAAQ,EAAE,MAAM,6CAA6C,CAAC;AAEvE,OAAO,EAAE,QAAQ,EAAE,MAAM,4CAA4C,CAAC;AAEtE,OAAO,EAAE,MAAM,EAAE,MAAM,+CAA+C,CAAC;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kDAAkD,CAAC;AAElF,OAAO,EAAE,aAAa,EAAE,MAAM,sDAAsD,CAAC;AAErF,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAC;AAE1F,OAAO,EAAE,WAAW,IAAI,YAAY,EAAE,MAAM,sDAAsD,CAAC;AACnG,eAAO,MAAM,WAAW,EAAE,OAAO,YAMhC,CAAC;AAEF,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,UAMzC;AAED,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,IAAI,IAAI,YAAY,EAAE,MAAM,+CAA+C,CAAC"}

package/esm/0_deps.js

@@ -32,6 +32,7 @@ export { pooledMap } from "./deps/jsr.io/@std/async/1.2.0/pool.js";
 export { concat } from "./deps/jsr.io/@std/bytes/1.0.6/concat.js";
 export { equals } from "./deps/jsr.io/@std/bytes/1.0.6/equals.js";
 export { startsWith } from "./deps/jsr.io/@std/bytes/1.0.6/starts_with.js";
+export { isIPv4, isIPv6 } from "./deps/jsr.io/@std/net/1.0.6/unstable_ip.js";
 export { LruCache } from "./deps/jsr.io/@std/cache/0.2.2/lru_cache.js";
 export { writeAll } from "./deps/jsr.io/@std/io/0.225.3/write_all.js";
 export { format } from "./deps/jsr.io/@std/datetime/0.225.7/format.js";

package/esm/1_utilities.d.ts

@@ -19,6 +19,7 @@
  */
 import "./_dnt.polyfills.js";
 export * from "./utilities/0_int.js";
+export * from "./utilities/0_ip.js";
 export * from "./utilities/0_color.js";
 export * from "./utilities/0_gzip.js";
 export * from "./utilities/0_hash.js";

package/esm/1_utilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"1_utilities.d.ts","sourceRoot":"","sources":["../src/1_utilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,qBAAqB,CAAC;AAG7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"1_utilities.d.ts","sourceRoot":"","sources":["../src/1_utilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,qBAAqB,CAAC;AAG7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC"}

package/esm/1_utilities.js

@@ -19,6 +19,7 @@
  */
 import "./_dnt.polyfills.js";
 export * from "./utilities/0_int.js";
+export * from "./utilities/0_ip.js";
 export * from "./utilities/0_color.js";
 export * from "./utilities/0_gzip.js";
 export * from "./utilities/0_hash.js";

package/esm/2_connection.d.ts

@@ -18,6 +18,7 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 export * from "./connection/0_connection.js";
+export * from "./connection/1_connection_socks5.js";
 export * from "./connection/1_connection_tcp.js";
 export * from "./connection/1_connection_tls.js";
 export * from "./connection/1_connection_web_socket.js";

package/esm/2_connection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"2_connection.d.ts","sourceRoot":"","sources":["../src/2_connection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,yCAAyC,CAAC"}
+{"version":3,"file":"2_connection.d.ts","sourceRoot":"","sources":["../src/2_connection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qCAAqC,CAAC;AACpD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,yCAAyC,CAAC"}

package/esm/2_connection.js

@@ -18,6 +18,7 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 export * from "./connection/0_connection.js";
+export * from "./connection/1_connection_socks5.js";
 export * from "./connection/1_connection_tcp.js";
 export * from "./connection/1_connection_tls.js";
 export * from "./connection/1_connection_web_socket.js";

package/esm/3_transport.d.ts

@@ -22,6 +22,7 @@ export * from "./transport/1_transport_abridged.js";
 export * from "./transport/1_transport_intermediate.js";
 export * from "./transport/1_transport_provider.js";
 export * from "./transport/2_transport_provider_mtproxy.js";
+export * from "./transport/2_transport_provider_socks5.js";
 export * from "./transport/2_transport_provider_tcp.js";
 export * from "./transport/2_transport_provider_web_socket.js";
 //# sourceMappingURL=3_transport.d.ts.map

package/esm/3_transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"3_transport.d.ts","sourceRoot":"","sources":["../src/3_transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qCAAqC,CAAC;AACpD,cAAc,yCAAyC,CAAC;AACxD,cAAc,qCAAqC,CAAC;AACpD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,yCAAyC,CAAC;AACxD,cAAc,gDAAgD,CAAC"}
+{"version":3,"file":"3_transport.d.ts","sourceRoot":"","sources":["../src/3_transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qCAAqC,CAAC;AACpD,cAAc,yCAAyC,CAAC;AACxD,cAAc,qCAAqC,CAAC;AACpD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,4CAA4C,CAAC;AAC3D,cAAc,yCAAyC,CAAC;AACxD,cAAc,gDAAgD,CAAC"}

package/esm/3_transport.js

@@ -22,5 +22,6 @@ export * from "./transport/1_transport_abridged.js";
 export * from "./transport/1_transport_intermediate.js";
 export * from "./transport/1_transport_provider.js";
 export * from "./transport/2_transport_provider_mtproxy.js";
+export * from "./transport/2_transport_provider_socks5.js";
 export * from "./transport/2_transport_provider_tcp.js";
 export * from "./transport/2_transport_provider_web_socket.js";

package/esm/connection/1_connection_socks5.d.ts

@@ -0,0 +1,36 @@
+/**
+ * MTKruto - Cross-runtime JavaScript library for building Telegram clients
+ * Copyright (C) 2023-2026 Roj <https://roj.im/>
+ *
+ * This file is part of MTKruto.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+import type { Connection } from "./0_connection.js";
+export interface ConnectionSocks5Params {
+    username: string;
+    password: string;
+}
+export declare class ConnectionSocks5 implements Connection {
+    #private;
+    stateChangeHandler?: Connection["stateChangeHandler"];
+    callback?: Connection["callback"];
+    constructor(hostname: string, port: number, socks5Hostname: string, socks5Port: number, params?: ConnectionSocks5Params);
+    get isConnected(): boolean;
+    open(): Promise<void>;
+    read(p: Uint8Array): Promise<void>;
+    write(p: Uint8Array): Promise<void>;
+    close(): void;
+}
+//# sourceMappingURL=1_connection_socks5.d.ts.map

package/esm/connection/1_connection_socks5.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"1_connection_socks5.d.ts","sourceRoot":"","sources":["../../src/connection/1_connection_socks5.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAiBpD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,gBAAiB,YAAW,UAAU;;IAYjD,kBAAkB,CAAC,EAAE,UAAU,CAAC,oBAAoB,CAAC,CAAC;IACtD,QAAQ,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;gBAEtB,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,sBAAsB;IAQvH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAQK,IAAI;IAuFJ,IAAI,CAAC,CAAC,EAAE,UAAU;IAyBlB,KAAK,CAAC,CAAC,EAAE,UAAU;IAsBzB,KAAK;CAMN"}

package/esm/connection/1_connection_socks5.js

@@ -0,0 +1,192 @@
+/**
+ * MTKruto - Cross-runtime JavaScript library for building Telegram clients
+ * Copyright (C) 2023-2026 Roj <https://roj.im/>
+ *
+ * This file is part of MTKruto.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+import { concat, isIPv4, isIPv6 } from "../0_deps.js";
+import { ConnectionError } from "../0_errors.js";
+import { encodeText, getLogger, ipv4ToBytes, ipv6ToBytes, Mutex } from "../1_utilities.js";
+const VERSION_SOCKS = 5;
+const VERSION_USERNAME_PASSWORD_AUTH = 1;
+const AUTH_MEHTOD_NONE = 0;
+const AUTH_METHOD_USERNAME_PASSWORD = 2;
+const RESULT_SUCCESS = 0;
+const COMMAND_CONNECT = 1;
+const ADDRESS_TYPE_4 = 1;
+const ADDRESS_TYPE_DOMAIN_NAME = 3;
+const ADDRESS_TYPE_6 = 4;
+const L = getLogger("ConnectionSocks5");
+export class ConnectionSocks5 {
+    #hostname;
+    #port;
+    #socks5Hostname;
+    #socks5Port;
+    #credentials;
+    #connection;
+    #rMutex = new Mutex();
+    #wMutex = new Mutex();
+    #canRead = false;
+    #canWrite = false;
+    stateChangeHandler;
+    callback;
+    constructor(hostname, port, socks5Hostname, socks5Port, params) {
+        this.#hostname = hostname.slice(0, 255);
+        this.#port = port;
+        this.#socks5Hostname = socks5Hostname;
+        this.#socks5Port = socks5Port;
+        this.#credentials = params?.username && params.password ? { username: params.username.slice(0, 255), password: params.password.slice(0, 255) } : undefined;
+    }
+    get isConnected() {
+        return !!this.#connection && this.#canRead && this.#canWrite;
+    }
+    #assertConnected() {
+        if (!this.isConnected) {
+            throw new ConnectionError("The connection is not open.");
+        }
+    }
+    async open() {
+        if (this.isConnected) {
+            return;
+        }
+        const connection = await Deno.connect({
+            hostname: this.#socks5Hostname,
+            port: this.#socks5Port,
+        });
+        connection.setNoDelay(true);
+        connection.setKeepAlive(true);
+        this.#canRead = this.#canWrite = true;
+        this.#connection = connection;
+        const header = new Uint8Array([VERSION_SOCKS, 2, AUTH_MEHTOD_NONE, AUTH_METHOD_USERNAME_PASSWORD]);
+        await this.write(header);
+        const negotiation = new Uint8Array(2);
+        await this.read(negotiation);
+        if (negotiation[0] !== VERSION_SOCKS || (negotiation[1] !== AUTH_MEHTOD_NONE && negotiation[1] !== AUTH_METHOD_USERNAME_PASSWORD)) {
+            throw new ConnectionError("Negotiation with SOCKS5 server failed.");
+        }
+        if (negotiation[1] === AUTH_METHOD_USERNAME_PASSWORD && !this.#credentials) {
+            throw new ConnectionError("Username and password are required for connecting to SOCKS5 server.");
+        }
+        else if (this.#credentials) {
+            await this.write(concat([new Uint8Array([VERSION_USERNAME_PASSWORD_AUTH, this.#credentials.username.length]), encodeText(this.#credentials.username), new Uint8Array([this.#credentials.password.length]), encodeText(this.#credentials.password)]));
+            const status = new Uint8Array(2);
+            await this.read(status);
+            if (status[0] !== VERSION_USERNAME_PASSWORD_AUTH || status[1] !== RESULT_SUCCESS) {
+                throw new ConnectionError("SOCKS5 username and password authentication failed.");
+            }
+        }
+        let hostnameType;
+        let hostname;
+        if (isIPv4(this.#hostname)) {
+            hostnameType = ADDRESS_TYPE_4;
+            hostname = new Uint8Array(ipv4ToBytes(this.#hostname));
+        }
+        else if (isIPv6(this.#hostname)) {
+            hostnameType = ADDRESS_TYPE_6;
+            hostname = new Uint8Array(ipv6ToBytes(this.#hostname));
+        }
+        else {
+            hostnameType = ADDRESS_TYPE_DOMAIN_NAME;
+            hostname = concat([new Uint8Array([this.#hostname.length]), encodeText(this.#hostname)]);
+        }
+        const address = concat([new Uint8Array([hostnameType]), hostname, new Uint8Array(2)]);
+        new DataView(address.buffer).setUint16(hostname.byteLength + 1, this.#port);
+        await this.write(concat([new Uint8Array([VERSION_SOCKS, COMMAND_CONNECT, 0]), address]));
+        const status = new Uint8Array(3);
+        await this.read(status);
+        if (status[0] !== VERSION_SOCKS || status[1] !== RESULT_SUCCESS) {
+            throw new ConnectionError("Connection with SOCKS5 server failed.");
+        }
+        const addressType = new Uint8Array(1);
+        await this.read(addressType);
+        switch (addressType[0]) {
+            case ADDRESS_TYPE_4: {
+                const ipv4 = new Uint8Array(4);
+                await this.read(ipv4);
+                break;
+            }
+            case ADDRESS_TYPE_6: {
+                const ipv4 = new Uint8Array(16);
+                await this.read(ipv4);
+                break;
+            }
+            case ADDRESS_TYPE_DOMAIN_NAME: {
+                const length = new Uint8Array(1);
+                await this.read(length);
+                const domainName = new Uint8Array(length[0]);
+                await this.read(domainName);
+                break;
+            }
+        }
+        const port = new Uint8Array(2);
+        await this.read(port);
+        this.stateChangeHandler?.(true);
+        L.debug("connected to", this.#hostname, "port", this.#port, "through socks5 server", this.#socks5Hostname, "port", this.#socks5Port);
+    }
+    async read(p) {
+        this.#assertConnected();
+        const unlock = await this.#rMutex.lock();
+        let offset = 0;
+        try {
+            do {
+                const read = await this.#connection.read(p.subarray(offset));
+                if (read === null) {
+                    this.#canRead = false;
+                    this.stateChangeHandler?.(false);
+                    throw new ConnectionError("The connection was closed.");
+                }
+                offset += read;
+            } while (offset < p.byteLength);
+        }
+        catch {
+            this.#canRead = false;
+            this.stateChangeHandler?.(false);
+            throw new ConnectionError("The connection was closed.");
+        }
+        finally {
+            unlock();
+        }
+    }
+    async write(p) {
+        this.#assertConnected();
+        const unlock = await this.#wMutex.lock();
+        try {
+            this.#assertConnected();
+            let written = 0;
+            while (written < p.byteLength) {
+                try {
+                    const wrote = await this.#connection.write(p.subarray(written));
+                    this.callback?.write(wrote);
+                    written += wrote;
+                }
+                catch {
+                    this.#canWrite = false;
+                    this.stateChangeHandler?.(false);
+                    throw new ConnectionError("The connection was closed.");
+                }
+            }
+        }
+        finally {
+            unlock();
+        }
+    }
+    close() {
+        this.#assertConnected();
+        this.#connection.close();
+        this.#canRead = this.#canWrite = false;
+        this.#connection = undefined;
+    }
+}

package/esm/connection/1_connection_socks5.node.d.ts

@@ -0,0 +1,35 @@
+/**
+ * MTKruto - Cross-runtime JavaScript library for building Telegram clients
+ * Copyright (C) 2023-2026 Roj <https://roj.im/>
+ *
+ * This file is part of MTKruto.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+import type { Connection } from "./0_connection.js";
+export interface ConnectionSocks5Params {
+    username: string;
+    password: string;
+}
+export declare class ConnectionSocks5 implements Connection {
+    #private;
+    stateChangeHandler?: Connection["stateChangeHandler"];
+    constructor(hostname: string, port: number, socks5Hostname: string, socks5Port: number, params?: ConnectionSocks5Params);
+    open(): Promise<void> | undefined;
+    get isConnected(): boolean;
+    read(p: Uint8Array): Promise<void>;
+    write(p: Uint8Array): Promise<void>;
+    close(): void;
+}
+//# sourceMappingURL=1_connection_socks5.node.d.ts.map

package/esm/connection/1_connection_socks5.node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"1_connection_socks5.node.d.ts","sourceRoot":"","sources":["../../src/connection/1_connection_socks5.node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAkBpD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,gBAAiB,YAAW,UAAU;;IAejD,kBAAkB,CAAC,EAAE,UAAU,CAAC,oBAAoB,CAAC,CAAC;gBAE1C,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,sBAAsB;IAevH,IAAI;IAoHJ,IAAI,WAAW,YAEd;IAQK,IAAI,CAAC,CAAC,EAAE,UAAU;IAclB,KAAK,CAAC,CAAC,EAAE,UAAU;IA0BzB,KAAK;CAKN"}

package/esm/connection/1_connection_socks5.node.js

@@ -0,0 +1,214 @@
+/**
+ * MTKruto - Cross-runtime JavaScript library for building Telegram clients
+ * Copyright (C) 2023-2026 Roj <https://roj.im/>
+ *
+ * This file is part of MTKruto.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+import { Socket } from "node:net";
+import { concat, isIPv4, isIPv6 } from "../0_deps.js";
+import { ConnectionError } from "../0_errors.js";
+import { encodeText, getLogger, ipv4ToBytes, ipv6ToBytes, Mutex } from "../1_utilities.js";
+const VERSION_SOCKS = 5;
+const VERSION_USERNAME_PASSWORD_AUTH = 1;
+const AUTH_MEHTOD_NONE = 0;
+const AUTH_METHOD_USERNAME_PASSWORD = 2;
+const RESULT_SUCCESS = 0;
+const COMMAND_CONNECT = 1;
+const ADDRESS_TYPE_4 = 1;
+const ADDRESS_TYPE_DOMAIN_NAME = 3;
+const ADDRESS_TYPE_6 = 4;
+const L = getLogger("ConnectionTCP");
+const errConnectionNotOpen = new ConnectionError("The connection is not open.");
+export class ConnectionSocks5 {
+    #hostname;
+    #port;
+    #socks5Hostname;
+    #socks5Port;
+    #credentials;
+    #socket;
+    #rMutex = new Mutex();
+    #wMutex = new Mutex();
+    #buffer = new Array();
+    #nextResolve = null;
+    stateChangeHandler;
+    constructor(hostname, port, socks5Hostname, socks5Port, params) {
+        this.#hostname = hostname.slice(0, 255);
+        this.#port = port;
+        this.#socks5Hostname = socks5Hostname;
+        this.#socks5Port = socks5Port;
+        this.#credentials = params?.username && params.password ? { username: params.username.slice(0, 255), password: params.password.slice(0, 255) } : undefined;
+    }
+    #rejectRead() {
+        if (this.#nextResolve !== null) {
+            this.#nextResolve[1].reject(errConnectionNotOpen);
+            this.#nextResolve = null;
+        }
+    }
+    open() {
+        if (this.isConnected) {
+            return;
+        }
+        this.#socket = new Socket();
+        this.#socket.on("close", () => {
+            this.#rejectRead();
+            this.stateChangeHandler?.(false);
+        });
+        this.#socket.on("data", (data) => {
+            if (typeof data === "string") {
+                return;
+            }
+            for (const byte of data) {
+                this.#buffer.push(byte);
+            }
+            if (this.#nextResolve !== null && this.#buffer.length >= this.#nextResolve[0]) {
+                const resolve = this.#nextResolve[1].resolve;
+                this.#nextResolve = null;
+                resolve();
+            }
+        });
+        return new Promise((resolve, reject) => {
+            this.#socket.connect(this.#socks5Port, this.#socks5Hostname);
+            this.#socket.once("error", reject);
+            this.#socket.once("connect", async () => {
+                this.#socket.off("error", reject);
+                try {
+                    const header = new Uint8Array([VERSION_SOCKS, 2, AUTH_MEHTOD_NONE, AUTH_METHOD_USERNAME_PASSWORD]);
+                    await this.write(header);
+                    const negotiation = new Uint8Array(2);
+                    await this.read(negotiation);
+                    if (negotiation[0] !== VERSION_SOCKS || (negotiation[1] !== AUTH_MEHTOD_NONE && negotiation[1] !== AUTH_METHOD_USERNAME_PASSWORD)) {
+                        throw new ConnectionError("Negotiation with SOCKS5 server failed.");
+                    }
+                    if (negotiation[1] === AUTH_METHOD_USERNAME_PASSWORD && !this.#credentials) {
+                        throw new ConnectionError("Username and password are required for connecting to SOCKS5 server.");
+                    }
+                    else if (this.#credentials) {
+                        await this.write(concat([new Uint8Array([VERSION_USERNAME_PASSWORD_AUTH, this.#credentials.username.length]), encodeText(this.#credentials.username), new Uint8Array([this.#credentials.password.length]), encodeText(this.#credentials.password)]));
+                        const status = new Uint8Array(2);
+                        await this.read(status);
+                        if (status[0] !== VERSION_USERNAME_PASSWORD_AUTH || status[1] !== RESULT_SUCCESS) {
+                            throw new ConnectionError("SOCKS5 username and password authentication failed.");
+                        }
+                    }
+                    let hostnameType;
+                    let hostname;
+                    if (isIPv4(this.#hostname)) {
+                        hostnameType = ADDRESS_TYPE_4;
+                        hostname = new Uint8Array(ipv4ToBytes(this.#hostname));
+                    }
+                    else if (isIPv6(this.#hostname)) {
+                        hostnameType = ADDRESS_TYPE_6;
+                        hostname = new Uint8Array(ipv6ToBytes(this.#hostname));
+                    }
+                    else {
+                        hostnameType = ADDRESS_TYPE_DOMAIN_NAME;
+                        hostname = concat([new Uint8Array([this.#hostname.length]), encodeText(this.#hostname)]);
+                    }
+                    const address = concat([new Uint8Array([hostnameType]), hostname, new Uint8Array(2)]);
+                    new DataView(address.buffer).setUint16(hostname.byteLength + 1, this.#port);
+                    await this.write(concat([new Uint8Array([VERSION_SOCKS, COMMAND_CONNECT, 0]), address]));
+                    const status = new Uint8Array(3);
+                    await this.read(status);
+                    if (status[0] !== VERSION_SOCKS || status[1] !== RESULT_SUCCESS) {
+                        throw new ConnectionError("Connection with SOCKS5 server failed.");
+                    }
+                    const addressType = new Uint8Array(1);
+                    await this.read(addressType);
+                    switch (addressType[0]) {
+                        case ADDRESS_TYPE_4: {
+                            const ipv4 = new Uint8Array(4);
+                            await this.read(ipv4);
+                            break;
+                        }
+                        case ADDRESS_TYPE_6: {
+                            const ipv4 = new Uint8Array(16);
+                            await this.read(ipv4);
+                            break;
+                        }
+                        case ADDRESS_TYPE_DOMAIN_NAME: {
+                            const length = new Uint8Array(1);
+                            await this.read(length);
+                            const domainName = new Uint8Array(length[0]);
+                            await this.read(domainName);
+                            break;
+                        }
+                    }
+                    const port = new Uint8Array(2);
+                    await this.read(port);
+                }
+                catch (err) {
+                    reject(err);
+                    return;
+                }
+                resolve();
+                this.stateChangeHandler?.(true);
+                L.debug("connected to", this.#hostname, "port", this.#port, "through socks5 server", this.#socks5Hostname, "port", this.#socks5Port);
+            });
+        });
+    }
+    get isConnected() {
+        return this.#socket?.readyState === "open";
+    }
+    #assertConnected() {
+        if (!this.isConnected) {
+            throw errConnectionNotOpen;
+        }
+    }
+    async read(p) {
+        this.#assertConnected();
+        const unlock = await this.#rMutex.lock();
+        try {
+            this.#assertConnected();
+            if (this.#buffer.length < p.length) {
+                await new Promise((resolve, reject) => this.#nextResolve = [p.length, { resolve, reject }]);
+            }
+            p.set(this.#buffer.splice(0, p.length));
+        }
+        finally {
+            unlock();
+        }
+    }
+    async write(p) {
+        this.#assertConnected();
+        const unlock = await this.#wMutex.lock();
+        try {
+            this.#assertConnected();
+            try {
+                await new Promise((resolve, reject) => {
+                    this.#socket.write(p, (err) => {
+                        (err === undefined || err === null) ? resolve() : reject(err);
+                    });
+                });
+            }
+            catch (err) {
+                if (!this.isConnected) {
+                    throw errConnectionNotOpen;
+                }
+                else {
+                    throw err;
+                }
+            }
+        }
+        finally {
+            unlock();
+        }
+    }
+    close() {
+        this.#assertConnected();
+        this.#socket.destroy();
+        this.#socket = undefined;
+    }
+}

package/esm/connection/1_connection_tcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"1_connection_tcp.d.ts","sourceRoot":"","sources":["../../src/connection/1_connection_tcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAIpD,qBAAa,aAAc,YAAW,UAAU;;IAQ9C,OAAO,EAAE,OAAO,IAAI,CAAC,OAAO,CAAgB;IAC5C,kBAAkB,CAAC,EAAE,UAAU,CAAC,oBAAoB,CAAC,CAAC;IACtD,QAAQ,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;gBAEtB,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAK1C,IAAI,WAAW,IAAI,OAAO,CAGzB;IAQK,IAAI;IAiBJ,IAAI,CAAC,CAAC,EAAE,UAAU;IAyBlB,KAAK,CAAC,CAAC,EAAE,UAAU;IAsBzB,KAAK;CAMN"}
+{"version":3,"file":"1_connection_tcp.d.ts","sourceRoot":"","sources":["../../src/connection/1_connection_tcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAIpD,qBAAa,aAAc,YAAW,UAAU;;IAQ9C,OAAO,EAAE,OAAO,IAAI,CAAC,OAAO,CAAgB;IAC5C,kBAAkB,CAAC,EAAE,UAAU,CAAC,oBAAoB,CAAC,CAAC;IACtD,QAAQ,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;gBAEtB,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAK1C,IAAI,WAAW,IAAI,OAAO,CAEzB;IAQK,IAAI;IAiBJ,IAAI,CAAC,CAAC,EAAE,UAAU;IAyBlB,KAAK,CAAC,CAAC,EAAE,UAAU;IAsBzB,KAAK;CAMN"}

package/esm/connection/1_connection_tcp.js

@@ -36,7 +36,6 @@ export class ConnectionTCP {
         this.#port = port;
     }
     get isConnected() {
-        Deno.errors.BrokenPipe;
         return !!this.#connection && this.#canRead && this.#canWrite;
     }
     #assertConnected() {

package/esm/connection/1_connection_tls.js

@@ -41,7 +41,7 @@ export class ConnectionTLS {
     constructor(hostname, port, secret) {
         this.#hostname = hostname;
         this.#port = port;
-        this.#secret = (secret[0] === 0xDD || secret[0] === 0xEE) ? secret.slice(1) : secret;
+        this.#secret = secret.byteLength > 16 ? secret.slice(1) : secret;
     }
     get isConnected() {
         return !!this.#connection && this.#canRead && this.#canWrite;