@mtkruto/browser 0.6.1 → 0.119.1

package/esm/deps/jsr.io/@std/path/1.1.4/windows/normalize.js

@@ -0,0 +1,135 @@
+// Copyright 2018-2025 the Deno authors. MIT license.
+// This module is browser compatible.
+import { assertArg } from "../_common/normalize.js";
+import { CHAR_COLON } from "../_common/constants.js";
+import { normalizeString } from "../_common/normalize_string.js";
+import { isPathSeparator, isWindowsDeviceRoot } from "./_util.js";
+import { fromFileUrl } from "./from_file_url.js";
+/**
+ * Normalize the `path`, resolving `'..'` and `'.'` segments.
+ * Note that resolving these segments does not necessarily mean that all will be eliminated.
+ * A `'..'` at the top-level will be preserved, and an empty path is canonically `'.'`.
+ *
+ * @example Usage
+ * ```ts
+ * import { normalize } from "@std/path/windows/normalize";
+ * import { assertEquals } from "@std/assert";
+ *
+ * assertEquals(normalize("C:\\foo\\..\\bar"), "C:\\bar");
+ * assertEquals(normalize(new URL("file:///C:/foo/../bar")), "C:\\bar");
+ * ```
+ *
+ * @param path The path to normalize
+ * @returns The normalized path
+ */
+export function normalize(path) {
+    if (path instanceof URL) {
+        path = fromFileUrl(path);
+    }
+    assertArg(path);
+    const len = path.length;
+    let rootEnd = 0;
+    let device;
+    let isAbsolute = false;
+    const code = path.charCodeAt(0);
+    // Try to match a root
+    if (len > 1) {
+        if (isPathSeparator(code)) {
+            // Possible UNC root
+            // If we started with a separator, we know we at least have an absolute
+            // path of some kind (UNC or otherwise)
+            isAbsolute = true;
+            if (isPathSeparator(path.charCodeAt(1))) {
+                // Matched double path separator at beginning
+                let j = 2;
+                let last = j;
+                // Match 1 or more non-path separators
+                for (; j < len; ++j) {
+                    if (isPathSeparator(path.charCodeAt(j)))
+                        break;
+                }
+                if (j < len && j !== last) {
+                    const firstPart = path.slice(last, j);
+                    // Matched!
+                    last = j;
+                    // Match 1 or more path separators
+                    for (; j < len; ++j) {
+                        if (!isPathSeparator(path.charCodeAt(j)))
+                            break;
+                    }
+                    if (j < len && j !== last) {
+                        // Matched!
+                        last = j;
+                        // Match 1 or more non-path separators
+                        for (; j < len; ++j) {
+                            if (isPathSeparator(path.charCodeAt(j)))
+                                break;
+                        }
+                        if (j === len) {
+                            // We matched a UNC root only
+                            // Return the normalized version of the UNC root since there
+                            // is nothing left to process
+                            return `\\\\${firstPart}\\${path.slice(last)}\\`;
+                        }
+                        else if (j !== last) {
+                            // We matched a UNC root with leftovers
+                            device = `\\\\${firstPart}\\${path.slice(last, j)}`;
+                            rootEnd = j;
+                        }
+                    }
+                }
+            }
+            else {
+                rootEnd = 1;
+            }
+        }
+        else if (isWindowsDeviceRoot(code)) {
+            // Possible device root
+            if (path.charCodeAt(1) === CHAR_COLON) {
+                device = path.slice(0, 2);
+                rootEnd = 2;
+                if (len > 2) {
+                    if (isPathSeparator(path.charCodeAt(2))) {
+                        // Treat separator following drive name as an absolute path
+                        // indicator
+                        isAbsolute = true;
+                        rootEnd = 3;
+                    }
+                }
+            }
+        }
+    }
+    else if (isPathSeparator(code)) {
+        // `path` contains just a path separator, exit early to avoid unnecessary
+        // work
+        return "\\";
+    }
+    let tail;
+    if (rootEnd < len) {
+        tail = normalizeString(path.slice(rootEnd), !isAbsolute, "\\", isPathSeparator);
+    }
+    else {
+        tail = "";
+    }
+    if (tail.length === 0 && !isAbsolute)
+        tail = ".";
+    if (tail.length > 0 && isPathSeparator(path.charCodeAt(len - 1))) {
+        tail += "\\";
+    }
+    if (device === undefined) {
+        if (isAbsolute) {
+            if (tail.length > 0)
+                return `\\${tail}`;
+            else
+                return "\\";
+        }
+        return tail;
+    }
+    else if (isAbsolute) {
+        if (tail.length > 0)
+            return `${device}\\${tail}`;
+        else
+            return `${device}\\`;
+    }
+    return device + tail;
+}

package/esm/deps/jsr.io/@std/path/1.1.4/windows/to_file_url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to_file_url.d.ts","sourceRoot":"","sources":["../../../../../../../src/deps/jsr.io/@std/path/1.1.4/windows/to_file_url.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAgB3C"}

package/esm/deps/jsr.io/@std/path/1.1.4/windows/to_file_url.js

@@ -0,0 +1,34 @@
+// Copyright 2018-2025 the Deno authors. MIT license.
+// This module is browser compatible.
+import { encodeWhitespace } from "../_common/to_file_url.js";
+import { isAbsolute } from "./is_absolute.js";
+/**
+ * Converts a path string to a file URL.
+ *
+ * @example Usage
+ * ```ts
+ * import { toFileUrl } from "@std/path/windows/to-file-url";
+ * import { assertEquals } from "@std/assert";
+ *
+ * assertEquals(toFileUrl("\\home\\foo"), new URL("file:///home/foo"));
+ * assertEquals(toFileUrl("C:\\Users\\foo"), new URL("file:///C:/Users/foo"));
+ * assertEquals(toFileUrl("\\\\127.0.0.1\\home\\foo"), new URL("file://127.0.0.1/home/foo"));
+ * ```
+ * @param path The path to convert.
+ * @returns The file URL.
+ */
+export function toFileUrl(path) {
+    if (!isAbsolute(path)) {
+        throw new TypeError(`Path must be absolute: received "${path}"`);
+    }
+    const [, hostname, pathname] = path.match(/^(?:[/\\]{2}([^/\\]+)(?=[/\\](?:[^/\\]|$)))?(.*)/);
+    const url = new URL("file:///");
+    url.pathname = encodeWhitespace(pathname.replace(/%/g, "%25"));
+    if (hostname !== undefined && hostname !== "localhost") {
+        url.hostname = hostname;
+        if (!url.hostname) {
+            throw new TypeError(`Invalid hostname: "${url.hostname}"`);
+        }
+    }
+    return url;
+}

package/esm/deps/jsr.io/@std/streams/1.0.17/to_array_buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to_array_buffer.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/streams/1.0.17/to_array_buffer.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,aAAa,CACjC,cAAc,EAAE,cAAc,CAAC,UAAU,CAAC,GACzC,OAAO,CAAC,WAAW,CAAC,CAetB"}

package/esm/deps/jsr.io/@std/streams/1.0.17/to_array_buffer.js

@@ -0,0 +1,35 @@
+// Copyright 2018-2026 the Deno authors. MIT license.
+// This module is browser compatible.
+import { concat } from "../../bytes/1.0.6/concat.js";
+/**
+ * Converts a {@linkcode ReadableStream} of {@linkcode Uint8Array}s to an
+ * {@linkcode ArrayBuffer}. Works the same as {@linkcode Response.arrayBuffer}.
+ *
+ * @param readableStream A `ReadableStream` of `Uint8Array`s to convert into an `ArrayBuffer`.
+ * @returns A promise that resolves with the `ArrayBuffer` containing all the data from the stream.
+ *
+ * @example Basic usage
+ * ```ts
+ * import { toArrayBuffer } from "@std/streams/to-array-buffer";
+ * import { assertEquals } from "@std/assert";
+ *
+ * const stream = ReadableStream.from([
+ *   new Uint8Array([1, 2]),
+ *   new Uint8Array([3, 4, 5]),
+ * ]);
+ * const buf = await toArrayBuffer(stream);
+ * assertEquals(buf.byteLength, 5);
+ * ```
+ */
+export async function toArrayBuffer(readableStream) {
+    const reader = readableStream.getReader();
+    const chunks = [];
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done) {
+            break;
+        }
+        chunks.push(value);
+    }
+    return concat(chunks).buffer;
+}

package/esm/mod.d.ts

@@ -1,6 +1,6 @@
 /**
  * MTKruto - Cross-runtime JavaScript library for building Telegram clients
- * Copyright (C) 2023-2024 Roj <https://roj.im/>
+ * Copyright (C) 2023-2026 Roj <https://roj.im/>
  *
  * This file is part of MTKruto.
  *
@@ -25,7 +25,7 @@ export * from "./2_storage.js";
 export * from "./3_transport.js";
 export * from "./2_tl.js";
 export * from "./3_types.js";
-export { APP_VERSION, DEVICE_MODEL, INITIAL_DC, LANG_CODE, LANG_PACK, LAYER, SYSTEM_LANG_CODE, SYSTEM_VERSION } from "./4_constants.js";
+export { APP_VERSION, DEVICE_MODEL, INITIAL_DC, LANG_CODE, LANG_PACK, SYSTEM_LANG_CODE, SYSTEM_VERSION } from "./4_constants.js";
 export * as errors from "./4_errors.js";
 export * from "./5_client.js";
 //# sourceMappingURL=mod.d.ts.map

package/esm/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,qBAAqB,CAAC;AAG7B,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,WAAW,EAAE,KAAK,eAAe,EAAE,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC1J,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACxI,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,cAAc,eAAe,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,qBAAqB,CAAC;AAG7B,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,WAAW,EAAE,KAAK,eAAe,EAAE,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC1J,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACjI,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,cAAc,eAAe,CAAC"}

package/esm/mod.js

@@ -1,6 +1,6 @@
 /**
  * MTKruto - Cross-runtime JavaScript library for building Telegram clients
- * Copyright (C) 2023-2024 Roj <https://roj.im/>
+ * Copyright (C) 2023-2026 Roj <https://roj.im/>
  *
  * This file is part of MTKruto.
  *
@@ -25,6 +25,6 @@ export * from "./2_storage.js";
 export * from "./3_transport.js";
 export * from "./2_tl.js";
 export * from "./3_types.js";
-export { APP_VERSION, DEVICE_MODEL, INITIAL_DC, LANG_CODE, LANG_PACK, LAYER, SYSTEM_LANG_CODE, SYSTEM_VERSION } from "./4_constants.js";
+export { APP_VERSION, DEVICE_MODEL, INITIAL_DC, LANG_CODE, LANG_PACK, SYSTEM_LANG_CODE, SYSTEM_VERSION } from "./4_constants.js";
 export * as errors from "./4_errors.js";
 export * from "./5_client.js";

package/esm/session/0_session_error.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 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 { MtkrutoError } from "../0_errors.js";
+export declare class SessionError extends MtkrutoError {
+    constructor(message: string);
+}
+//# sourceMappingURL=0_session_error.d.ts.map

package/esm/session/0_session_error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"0_session_error.d.ts","sourceRoot":"","sources":["../../src/session/0_session_error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,qBAAa,YAAa,SAAQ,YAAY;gBAChC,OAAO,EAAE,MAAM;CAG5B"}

package/esm/session/0_session_error.js

@@ -0,0 +1,25 @@
+/**
+ * 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 { MtkrutoError } from "../0_errors.js";
+export class SessionError extends MtkrutoError {
+    constructor(message) {
+        super(message);
+    }
+}

package/esm/session/0_session_state.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 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/>.
+ */
+export declare class SessionState {
+    #private;
+    timeDifference: number;
+    serverSalt: bigint;
+    nextMessageId(): bigint;
+    nextSeqNo(contentRelated: boolean): number;
+    reset(): void;
+}
+//# sourceMappingURL=0_session_state.d.ts.map

package/esm/session/0_session_state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"0_session_state.d.ts","sourceRoot":"","sources":["../../src/session/0_session_state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,qBAAa,YAAY;;IACvB,cAAc,SAAK;IACnB,UAAU,SAAM;IAIhB,aAAa,IAAI,MAAM;IAYvB,SAAS,CAAC,cAAc,EAAE,OAAO,GAAG,MAAM;IAS1C,KAAK;CAKN"}

package/esm/session/0_session_state.js

@@ -0,0 +1,51 @@
+/**
+ * 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 { toUnixTimestamp } from "../1_utilities.js";
+export class SessionState {
+    timeDifference = 0;
+    serverSalt = 0n;
+    #seqNo = 0;
+    #messageId = 0n;
+    nextMessageId() {
+        const now = toUnixTimestamp(new Date()) + this.timeDifference;
+        const nanoseconds = Math.floor((now - Math.floor(now)) * 1e9);
+        const newMessageId = (BigInt(Math.floor(now)) << 32n) || (BigInt(nanoseconds) << 2n);
+        if (this.#messageId >= newMessageId) {
+            this.#messageId += 4n;
+        }
+        else {
+            this.#messageId = newMessageId;
+        }
+        return this.#messageId;
+    }
+    nextSeqNo(contentRelated) {
+        let seqNo = this.#seqNo * 2;
+        if (contentRelated) {
+            seqNo++;
+            this.#seqNo++;
+        }
+        return seqNo;
+    }
+    reset() {
+        this.serverSalt = 0n;
+        this.#seqNo = 0;
+        this.#messageId = 0n;
+    }
+}

package/esm/session/1_session.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 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, ConnectionCallback } from "../2_connection.js";
+import { type DC, type TransportProvider } from "../3_transport.js";
+import { SessionState } from "./0_session_state.js";
+export interface SessionParams {
+    /**
+     * The transport provider to use. Defaults to `webSocketTransportProvider` with its default options.
+     */
+    transportProvider?: TransportProvider;
+    /**
+     * Whether the connection is with a CDN server. Defaults to false.
+     */
+    isCdn?: boolean;
+}
+export declare abstract class Session {
+    #private;
+    protected state: SessionState;
+    protected transport: ReturnType<TransportProvider>;
+    constructor(dc: DC, params?: SessionParams);
+    set onConnectionStateChange(onConnectionStateChange: Connection["stateChangeHandler"]);
+    set connectionCallback(connectionCallback: ConnectionCallback | undefined);
+    get dc(): DC;
+    get isCdn(): boolean;
+    set serverSalt(serverSalt: bigint);
+    get serverSalt(): bigint;
+    get isConnected(): boolean;
+    connect(): Promise<void>;
+    protected waitUntilConnected(): Promise<void>;
+    get isDisconnected(): boolean;
+    disconnect(): void;
+    abstract send(body: Uint8Array): Promise<bigint>;
+}
+//# sourceMappingURL=1_session.d.ts.map

package/esm/session/1_session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"1_session.d.ts","sourceRoot":"","sources":["../../src/session/1_session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,iBAAiB,EAAoD,MAAM,mBAAmB,CAAC;AACtH,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAQpD,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,8BAAsB,OAAO;;IAG3B,SAAS,CAAC,KAAK,EAAE,YAAY,CAAsB;IACnD,SAAS,CAAC,SAAS,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC;gBAMvC,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,aAAa;IAc1C,IAAI,uBAAuB,CAAC,uBAAuB,EAAE,UAAU,CAAC,oBAAoB,CAAC,EAEpF;IAED,IAAI,kBAAkB,CAAC,kBAAkB,EAAE,kBAAkB,GAAG,SAAS,EAExE;IAED,IAAI,EAAE,IAAI,EAAE,CAEX;IAED,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED,IAAI,UAAU,CAAC,UAAU,EAAE,MAAM,EAEhC;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IA6BD,IAAI,WAAW,IAAI,OAAO,CAEzB;IAGK,OAAO;cAeG,kBAAkB;IAIlC,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED,UAAU;IAOV,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;CACjD"}

package/esm/session/1_session.js

@@ -0,0 +1,124 @@
+/**
+ * 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 { delay, SECOND } from "../0_deps.js";
+import { drop, getLogger, Mutex } from "../1_utilities.js";
+import { transportProviderTcp, transportProviderWebSocket } from "../3_transport.js";
+import { SessionState } from "./0_session_state.js";
+// global Session ID counter for logs
+let id = 0;
+// @ts-ignore: lib
+const defaultTransportProvider = typeof Deno === "undefined" ? transportProviderWebSocket : transportProviderTcp;
+export class Session {
+    #dc;
+    #isCdn;
+    state = new SessionState();
+    transport;
+    #lastConnect;
+    #isDisconnected = true;
+    #L;
+    #onConnectionStateChange;
+    constructor(dc, params) {
+        this.#dc = dc;
+        this.#isCdn = params?.isCdn ?? false;
+        const transportProvider = params?.transportProvider ?? defaultTransportProvider();
+        this.transport = transportProvider({ dc: this.#dc, isCdn: this.#isCdn });
+        this.transport.connection.stateChangeHandler = (connected) => {
+            setTimeout(() => {
+                drop(this.#stateChangeHandler(connected));
+            });
+        };
+        this.#L = getLogger("Session").client(id++);
+    }
+    set onConnectionStateChange(onConnectionStateChange) {
+        this.#onConnectionStateChange = onConnectionStateChange;
+    }
+    set connectionCallback(connectionCallback) {
+        this.transport.connection.callback = connectionCallback;
+    }
+    get dc() {
+        return this.#dc;
+    }
+    get isCdn() {
+        return this.#isCdn;
+    }
+    set serverSalt(serverSalt) {
+        this.state.serverSalt = serverSalt;
+    }
+    get serverSalt() {
+        return this.state.serverSalt;
+    }
+    #lastState;
+    async #stateChangeHandler(isConnected) {
+        if (this.#lastState !== isConnected) {
+            setTimeout(() => {
+                this.#onConnectionStateChange?.(isConnected);
+            });
+        }
+        if (this.#lastState === isConnected) {
+            return;
+        }
+        this.#lastState = isConnected;
+        if (isConnected || this.#isDisconnected) {
+            if (this.#isDisconnected) {
+                this.#L.debug("not reconnecting because explicitly disconnected");
+            }
+            return;
+        }
+        if (this.#lastConnect && Date.now() - this.#lastConnect.getTime() <= 10 * SECOND) {
+            this.#L.debug("reconnecting after a delay");
+            await delay(3 * SECOND);
+        }
+        else {
+            this.#L.debug("reconnecting");
+        }
+        await this.connect();
+    }
+    get isConnected() {
+        return this.transport.connection.isConnected;
+    }
+    #connectMutex = new Mutex();
+    async connect() {
+        const unlock = await this.#connectMutex.lock();
+        try {
+            if (this.isConnected) {
+                return;
+            }
+            await this.transport.connection.open();
+            await this.transport.transport.initialize();
+            this.#lastConnect = new Date();
+            this.#isDisconnected = false;
+        }
+        finally {
+            unlock();
+        }
+    }
+    async waitUntilConnected() {
+        (await this.#connectMutex.lock())();
+    }
+    get isDisconnected() {
+        return this.#isDisconnected;
+    }
+    disconnect() {
+        this.#isDisconnected = true;
+        if (this.transport.connection.isConnected) {
+            this.transport.connection.close();
+        }
+    }
+}

package/esm/session/2_session_encrypted.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 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 { Mtproto } from "../2_tl.js";
+import type { DC } from "../3_transport.js";
+import { Session, type SessionParams } from "./1_session.js";
+export interface Handlers {
+    onUpdate?: (body: Uint8Array) => void;
+    onNewServerSalt?: (serverSalt: bigint) => void;
+    onMessageFailed?: (id: bigint, reason: unknown) => void;
+    onPong?: (pong: Mtproto.pong) => void;
+    onRpcError?: (id: bigint, error: Mtproto.rpc_error) => void;
+    onRpcResult?: (id: bigint, result: Uint8Array) => void;
+}
+export declare class SessionEncrypted extends Session implements Session {
+    #private;
+    handlers: Handlers;
+    constructor(dc: DC, params?: SessionParams);
+    setAuthKey(key: Uint8Array<ArrayBuffer>): Promise<void>;
+    get authKey(): Uint8Array<ArrayBuffer>;
+    connect(): Promise<void>;
+    disconnect(): void;
+    send(body: Uint8Array<ArrayBuffer>): Promise<bigint>;
+}
+//# sourceMappingURL=2_session_encrypted.d.ts.map

package/esm/session/2_session_encrypted.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"2_session_encrypted.d.ts","sourceRoot":"","sources":["../../src/session/2_session_encrypted.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,OAAO,EAAwD,OAAO,EAAuC,MAAM,YAAY,CAAC;AAChI,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,mBAAmB,CAAC;AAI5C,OAAO,EAAE,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAa7D,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;IACtC,eAAe,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C,eAAe,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IACxD,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC;IACtC,UAAU,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,SAAS,KAAK,IAAI,CAAC;IAC5D,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC;CACxD;AAED,qBAAa,gBAAiB,SAAQ,OAAQ,YAAW,OAAO;;IAI9D,QAAQ,EAAE,QAAQ,CAAM;gBAiBZ,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,aAAa;IAQpC,UAAU,CAAC,GAAG,EAAE,UAAU,CAAC,WAAW,CAAC;IAM7C,IAAI,OAAO,IAAI,UAAU,CAAC,WAAW,CAAC,CAErC;IAEc,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAe9B,UAAU,IAAI,IAAI;IA6ErB,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;CAwX3D"}