@mtkruto/node 0.76.0 → 0.77.0

package/esm/tl/1_tl_reader.js

@@ -18,59 +18,59 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 // deno-lint-ignore-file no-explicit-any
-import { bigIntFromBuffer, decodeText } from "../1_utilities.js";
-import { analyzeOptionalParam, BOOL_FALSE, BOOL_TRUE, getOptionalParamInnerType, getVectorItemType, isOptionalParam, VECTOR, X } from "./0_utilities.js";
-export class TLError extends Error {
-}
+import { decodeText, intFromBytes } from "../1_utilities.js";
+import { TLError } from "../0_errors.js";
+import { analyzeOptionalParam, BOOL_FALSE, BOOL_TRUE, constructorIdToHex, getOptionalParamInnerType, getVectorItemType, isOptionalParam, VECTOR, X } from "./0_utilities.js";
 export class TLReader {
     _buffer;
+    #path = new Array();
     constructor(_buffer) {
         this._buffer = _buffer;
     }
     get buffer() {
         return this._buffer;
     }
-    read(count) {
-        if (this._buffer.length < count) {
-            throw new TLError("No data remaining");
+    read(byteCount) {
+        if (this._buffer.byteLength < byteCount) {
+            throw new TLError("No data remaining", this.#path);
         }
-        const buffer = this._buffer.slice(0, count);
-        this._buffer = this._buffer.subarray(count);
+        const buffer = this._buffer.slice(0, byteCount);
+        this._buffer = this._buffer.subarray(byteCount);
         return buffer;
     }
     unread(count) {
         const newOffest = this._buffer.byteOffset - count;
         if (newOffest < 0) {
-            throw new TLError("No data has been read");
+            throw new TLError("No data has been read", this.#path);
         }
         this._buffer = new Uint8Array(this._buffer.buffer, newOffest);
     }
-    readInt24(signed = true) {
+    readInt24(isSigned = true) {
         const buffer = this.read(24 / 8);
-        return Number(bigIntFromBuffer(buffer, true, signed));
+        return Number(intFromBytes(buffer, { isSigned }));
     }
-    readInt32(signed = true) {
+    readInt32(isSigned = true) {
         const buffer = this.read(32 / 8);
-        return Number(bigIntFromBuffer(buffer, true, signed));
+        return Number(intFromBytes(buffer, { isSigned }));
     }
     unreadInt32() {
         this.unread(32 / 8);
     }
-    readInt64(signed = true) {
+    readInt64(isSigned = true) {
         const buffer = this.read(64 / 8);
-        return bigIntFromBuffer(buffer, true, signed);
+        return intFromBytes(buffer, { isSigned });
     }
     readDouble() {
         const buffer = this.read(8);
         return new DataView(buffer.buffer, buffer.byteOffset, buffer.byteLength).getFloat64(0, true);
     }
-    readInt128(signed = true) {
+    readInt128(isSigned = true) {
         const buffer = this.read(128 / 8);
-        return bigIntFromBuffer(buffer, true, signed);
+        return intFromBytes(buffer, { isSigned });
     }
-    readInt256(signed = true) {
+    readInt256(isSigned = true) {
         const buffer = this.read(256 / 8);
-        return bigIntFromBuffer(buffer, true, signed);
+        return intFromBytes(buffer, { isSigned });
     }
     readBytes() {
         let L = this.read(1)[0];
@@ -104,7 +104,7 @@ export class TLReader {
         if (name === X) {
             const typeName = schema.identifierToName[id];
             if (!typeName) {
-                throw new TLError(`Unknown constructor: ${id.toString(16)}`);
+                throw new TLError(`Unknown constructor ID: ${constructorIdToHex(id)}`, this.#path);
             }
             this.unreadInt32();
             return await this.readType(typeName, schema);
@@ -120,7 +120,7 @@ export class TLReader {
         if (deserializedEnum !== undefined) {
             return deserializedEnum;
         }
-        throw new TLError(`Unknown type: ${name} ID ${id}`);
+        throw new TLError(`Unknown type: ${name}#${constructorIdToHex(id)}`, this.#path);
     }
     async #deserializeEnum(type, id, schema) {
         const name = schema.identifierToName[id];
@@ -135,23 +135,32 @@ export class TLReader {
     }
     async #deserializeType(type, desc, id, schema) {
         if (desc[0] !== id) {
-            throw new TLError(`Expected constructor ${desc[0].toString(16)} but got ${id}`);
+            throw new TLError(`Expected constructor with ID ${constructorIdToHex(desc[0])} but received ${constructorIdToHex(id)}`, this.#path);
         }
+        let isFirstPathElementExisting = false;
         const type_ = { _: type };
         const flagFields = {};
-        for (const [name, type] of desc[1]) {
-            if (isOptionalParam(type)) {
-                const { flagField, bitIndex } = analyzeOptionalParam(type);
+        for (const [name, fieldType] of desc[1]) {
+            if (isOptionalParam(fieldType)) {
+                const { flagField, bitIndex } = analyzeOptionalParam(fieldType);
                 const bits = flagFields[flagField];
                 if ((bits & (1 << bitIndex)) === 0) {
                     continue;
                 }
             }
-            if (type === "#") {
+            if (fieldType === "#") {
                 flagFields[name] = this.readInt32();
                 continue;
             }
-            const value = await this.readType(type, schema);
+            const pathElement = `[${type}.]${name}`;
+            if (isFirstPathElementExisting) {
+                this.#path[this.#path.length - 1] = pathElement;
+            }
+            else {
+                this.#path.push(pathElement);
+                isFirstPathElementExisting = true;
+            }
+            const value = await this.readType(fieldType, schema);
             if (typeof value !== "boolean" || value) {
                 type_[name] = value;
             }
@@ -161,7 +170,7 @@ export class TLReader {
     async #deserializeVector(type, schema) {
         const itemType = getVectorItemType(type);
         if (!itemType) {
-            throw new TLError(`Expected Vector but received ${type}`);
+            throw new TLError(`Expected Vector but received ${type}`, this.#path);
         }
         const size = this.readInt32();
         const array = new Array();
@@ -195,7 +204,7 @@ export class TLReader {
                     return false;
                 }
                 else {
-                    throw new TLError(`Expected boolTrue or boolFalse but got ${id}`);
+                    throw new TLError(`Expected boolTrue or boolFalse but received ${constructorIdToHex(id)}`, this.#path);
                 }
             }
             case "string":

package/esm/tl/1_tl_writer.d.ts

@@ -24,12 +24,12 @@ export declare class TLWriter {
     constructor();
     get buffer(): Uint8Array<ArrayBuffer>;
     write(buffer: Uint8Array): typeof this;
-    writeInt24(int: number, signed?: boolean): typeof this;
-    writeInt32(int: number, signed?: boolean): typeof this;
-    writeInt64(int: bigint, signed?: boolean): typeof this;
+    writeInt24(int: number, isSigned?: boolean): typeof this;
+    writeInt32(int: number, isSigned?: boolean): typeof this;
+    writeInt64(int: bigint, isSigned?: boolean): typeof this;
     writeDouble(double: number): typeof this;
-    writeInt128(int: bigint, signed?: boolean): typeof this;
-    writeInt256(int: bigint, signed?: boolean): typeof this;
+    writeInt128(int: bigint, isSigned?: boolean): typeof this;
+    writeInt256(int: bigint, isSigned?: boolean): typeof this;
     writeBytes(bytes: Uint8Array): typeof this;
     writeString(string: string): typeof this;
     writeObject(value: any, schema: Schema): typeof this;

package/esm/tl/1_tl_writer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"1_tl_writer.d.ts","sourceRoot":"","sources":["../../src/tl/1_tl_writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAI3C,qBAAa,QAAQ;;IACnB,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC,CAAoB;;IAK9D,IAAI,MAAM,IAAI,UAAU,CAAC,WAAW,CAAC,CAEpC;IAED,KAAK,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,IAAI;IAKtC,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,UAAO,GAAG,OAAO,IAAI;IAKnD,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,UAAO,GAAG,OAAO,IAAI;IAKnD,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,UAAO,GAAG,OAAO,IAAI;IAKnD,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,IAAI;IAOxC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,UAAO,GAAG,OAAO,IAAI;IAKpD,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,UAAO,GAAG,OAAO,IAAI;IAKpD,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,IAAI;IAkB1C,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,IAAI;IAKxC,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,IAAI;CAkLrD"}
+{"version":3,"file":"1_tl_writer.d.ts","sourceRoot":"","sources":["../../src/tl/1_tl_writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAI3C,qBAAa,QAAQ;;IACnB,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC,CAAoB;;IAM9D,IAAI,MAAM,IAAI,UAAU,CAAC,WAAW,CAAC,CAEpC;IAED,KAAK,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,IAAI;IAKtC,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,UAAO,GAAG,OAAO,IAAI;IAKrD,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,UAAO,GAAG,OAAO,IAAI;IAKrD,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,UAAO,GAAG,OAAO,IAAI;IAKrD,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,IAAI;IAOxC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,UAAO,GAAG,OAAO,IAAI;IAKtD,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,UAAO,GAAG,OAAO,IAAI;IAKtD,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,IAAI;IAkB1C,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,IAAI;IAKxC,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,IAAI;CAyLrD"}

package/esm/tl/1_tl_writer.js

@@ -19,12 +19,13 @@
  */
 // deno-lint-ignore-file no-explicit-any
 import { concat } from "../0_deps.js";
-import { TLError } from "./0_tl_error.js";
+import { TLError } from "../0_errors.js";
 import { analyzeOptionalParam, BOOL_FALSE, BOOL_TRUE, getOptionalParamInnerType, getVectorItemType, isOptionalParam, repr, VECTOR } from "./0_utilities.js";
-import { bufferFromBigInt } from "../utilities/0_buffer.js";
+import { intToBytes } from "../utilities/0_int.js";
 import { encodeText } from "../1_utilities.js";
 export class TLWriter {
     _buffer = new Uint8Array();
+    #path = new Array();
     constructor() {
     }
     get buffer() {
@@ -34,16 +35,16 @@ export class TLWriter {
         this._buffer = concat([this._buffer, buffer]);
         return this;
     }
-    writeInt24(int, signed = true) {
-        this.write(bufferFromBigInt(int, 24 / 8, true, signed));
+    writeInt24(int, isSigned = true) {
+        this.write(intToBytes(int, 24 / 8, { isSigned, path: this.#path }));
         return this;
     }
-    writeInt32(int, signed = true) {
-        this.write(bufferFromBigInt(int, 32 / 8, true, signed));
+    writeInt32(int, isSigned = true) {
+        this.write(intToBytes(int, 32 / 8, { isSigned, path: this.#path }));
         return this;
     }
-    writeInt64(int, signed = true) {
-        this.write(bufferFromBigInt(int, 64 / 8, true, signed));
+    writeInt64(int, isSigned = true) {
+        this.write(intToBytes(int, 64 / 8, { isSigned, path: this.#path }));
         return this;
     }
     writeDouble(double) {
@@ -52,12 +53,12 @@ export class TLWriter {
         this.write(buffer);
         return this;
     }
-    writeInt128(int, signed = true) {
-        this.write(bufferFromBigInt(int, 128 / 8, true, signed));
+    writeInt128(int, isSigned = true) {
+        this.write(intToBytes(int, 128 / 8, { isSigned, path: this.#path }));
         return this;
     }
-    writeInt256(int, signed = true) {
-        this.write(bufferFromBigInt(int, 256 / 8, true, signed));
+    writeInt256(int, isSigned = true) {
+        this.write(intToBytes(int, 256 / 8, { isSigned, path: this.#path }));
         return this;
     }
     writeBytes(bytes) {
@@ -83,31 +84,31 @@ export class TLWriter {
         return this;
     }
     writeObject(value, schema) {
-        this.#serialize(value._, value, "", schema);
+        this.#serialize(value._, value, schema);
         return this;
     }
-    #serialize(type, value, debugInfo, schema) {
-        if (this.#serializePrimitive(type, value, debugInfo)) {
+    #serialize(type, value, schema) {
+        if (this.#serializePrimitive(type, value)) {
             return;
         }
-        if (this.#serializeVector(type, value, debugInfo, schema)) {
+        if (this.#serializeVector(type, value, schema)) {
             return;
         }
         const maybeDefinition = schema.definitions[value._];
         if (!maybeDefinition) {
-            throw new TLError(`Unknown type: ${value._}`);
+            throw new TLError(`Unknown constructor: ${value._}`, this.#path);
         }
         if (type !== "!X" && !this.#isTypeValid(type, value, schema)) {
-            throw new TLError(`Expected ${type} but got ${value._}`);
+            throw new TLError(`Expected ${type} but instead got ${value._}`, this.#path);
         }
         const type__ = value;
         const [id, parameters_] = maybeDefinition;
         this.writeInt32(id, false);
-        for (let [i, [name, type]] of parameters_.entries()) {
+        let isFirstPathElementExisting = false;
+        for (let [name, type] of parameters_.values()) {
             if (isOptionalParam(type) && type__[name] === undefined) {
                 continue;
             }
-            const debugInfo = ` [0x${id.toString(16).toUpperCase()}::${i}]`;
             if (type === "#") {
                 let flags = 0;
                 const flagField_ = name;
@@ -124,32 +125,40 @@ export class TLWriter {
                 this.writeInt32(flags);
                 continue;
             }
+            const pathElement = `[${value._}.]${name}`;
+            if (isFirstPathElementExisting) {
+                this.#path[this.#path.length - 1] = pathElement;
+            }
+            else {
+                this.#path.push(pathElement);
+                isFirstPathElementExisting = true;
+            }
             if (type__[name] === undefined && !isOptionalParam(type)) {
-                throw new Error(`Missing required parameter: ${name}`);
+                throw new TLError("Missing required field", this.#path);
             }
             if (isOptionalParam(type)) {
                 type = getOptionalParamInnerType(type);
             }
-            this.#serialize(type, type__[name], debugInfo, schema);
+            this.#serialize(type, type__[name], schema);
         }
         return;
     }
-    #serializeVector(type, value, debugInfo, schema) {
+    #serializeVector(type, value, schema) {
         const itemType = getVectorItemType(type);
         if (!itemType) {
             return false;
         }
         if (!Array.isArray(value)) {
-            throw new TypeError(`Expected array but received ${repr(value)}${debugInfo}`);
+            throw new TLError(`Expected an array but received ${repr(value)}`, this.#path);
         }
         this.writeInt32(VECTOR, false);
         this.writeInt32(value.length);
         for (const item of value) {
-            this.#serialize(itemType, item, debugInfo, schema);
+            this.#serialize(itemType, item, schema);
         }
         return true;
     }
-    #serializePrimitive(type, value, debugInfo) {
+    #serializePrimitive(type, value) {
         const valueRepr = repr(value);
         switch (type) {
             case "bytes":
@@ -157,7 +166,7 @@ export class TLWriter {
                     this.writeBytes(value);
                 }
                 else {
-                    throw new TLError(`Expected Uint8Array but received ${valueRepr}${debugInfo}`);
+                    throw new TLError(`Expected Uint8Array but received ${valueRepr}`, this.#path);
                 }
                 return true;
             case "int128":
@@ -165,7 +174,7 @@ export class TLWriter {
                     this.writeInt128(value);
                 }
                 else {
-                    throw new TLError(`Expected bigint but received ${valueRepr}${debugInfo}`);
+                    throw new TLError(`Expected bigint but received ${valueRepr}`, this.#path);
                 }
                 return true;
             case "int256":
@@ -173,7 +182,7 @@ export class TLWriter {
                     this.writeInt256(value);
                 }
                 else {
-                    throw new TLError(`Expected bigint but received ${valueRepr}${debugInfo}`);
+                    throw new TLError(`Expected bigint but received ${valueRepr}`, this.#path);
                 }
                 return true;
             case "long":
@@ -181,7 +190,7 @@ export class TLWriter {
                     this.writeInt64(value);
                 }
                 else {
-                    throw new TLError(`Expected bigint but received ${valueRepr}${debugInfo}`);
+                    throw new TLError(`Expected bigint but received ${valueRepr}`, this.#path);
                 }
                 return true;
             case "Bool":
@@ -194,7 +203,7 @@ export class TLWriter {
                     }
                 }
                 else {
-                    throw new TLError(`Expected boolean but received ${valueRepr}${debugInfo}`);
+                    throw new TLError(`Expected boolean but received ${valueRepr}`, this.#path);
                 }
                 return true;
             case "int":
@@ -204,10 +213,15 @@ export class TLWriter {
                 }
                 //
                 if (typeof value === "number") {
-                    this.writeInt32(value);
+                    if (value % 1 === 0) {
+                        this.writeInt32(value);
+                    }
+                    else {
+                        throw new TLError("Expected an integer value but received a floating point", this.#path);
+                    }
                 }
                 else {
-                    throw new TLError(`Expected number but received ${valueRepr}${debugInfo}`);
+                    throw new TLError(`Expected number but received ${valueRepr}`, this.#path);
                 }
                 return true;
             case "double":
@@ -220,7 +234,7 @@ export class TLWriter {
                     this.writeDouble(value);
                 }
                 else {
-                    throw new TLError(`Expected number but received ${valueRepr}${debugInfo}`);
+                    throw new TLError(`Expected number but received ${valueRepr}`, this.#path);
                 }
                 return true;
             case "string":
@@ -239,7 +253,7 @@ export class TLWriter {
                 return true;
             case "true":
                 if (value !== true) {
-                    throw new TLError(`Expected true but received ${valueRepr}${debugInfo}`);
+                    throw new TLError(`Expected \`true\` but received ${valueRepr}`, this.#path);
                 }
                 return true;
             default:

package/esm/transport/0_obfuscation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"0_obfuscation.d.ts","sourceRoot":"","sources":["../../src/transport/0_obfuscation.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAoB,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,wBAAsB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU;;;GA0CtF"}
+{"version":3,"file":"0_obfuscation.d.ts","sourceRoot":"","sources":["../../src/transport/0_obfuscation.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,GAAG,EAAc,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,wBAAsB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU;;;GA0CtF"}

package/esm/transport/0_obfuscation.js

@@ -19,11 +19,11 @@
  */
 import * as dntShim from "../_dnt.shims.js";
 import { concat } from "../0_deps.js";
-import { bufferFromBigInt, CTR } from "../1_utilities.js";
+import { CTR, intToBytes } from "../1_utilities.js";
 export async function getObfuscationParameters(protocol, connection) {
     let init;
     while (true) {
-        init = concat([dntShim.crypto.getRandomValues(new Uint8Array(56)), bufferFromBigInt(protocol, 4, false), dntShim.crypto.getRandomValues(new Uint8Array(4))]);
+        init = concat([dntShim.crypto.getRandomValues(new Uint8Array(56)), intToBytes(protocol, 4, { byteOrder: "big", isSigned: false }), dntShim.crypto.getRandomValues(new Uint8Array(4))]);
         if (init[0] === 0xEF) {
             continue;
         }

package/esm/transport/1_transport_abridged.js

@@ -18,7 +18,7 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 import { concat } from "../0_deps.js";
-import { bigIntFromBuffer, bufferFromBigInt } from "../1_utilities.js";
+import { intFromBytes, intToBytes } from "../1_utilities.js";
 import { getObfuscationParameters } from "./0_obfuscation.js";
 import { Transport } from "./0_transport.js";
 export class TransportAbridged extends Transport {
@@ -50,7 +50,7 @@ export class TransportAbridged extends Transport {
                 let buffer = new Uint8Array(3);
                 await this.#connection.read(buffer);
                 buffer = await this.decrypt(buffer);
-                length = Number(bigIntFromBuffer(buffer));
+                length = Number(intFromBytes(buffer, { isSigned: false }));
             }
         }
         length *= 4;
@@ -61,7 +61,7 @@ export class TransportAbridged extends Transport {
     async send(buffer) {
         const bufferLength = buffer.length / 4;
         const header = new Uint8Array([bufferLength >= 0x7F ? 0x7F : bufferLength]);
-        const length = bufferLength >= 0x7F ? bufferFromBigInt(bufferLength, 3) : new Uint8Array();
+        const length = bufferLength >= 0x7F ? intToBytes(bufferLength, 3, { isSigned: false }) : new Uint8Array();
         const data = concat([header, length, buffer]);
         await this.#connection.write(await this.encrypt(data));
     }

package/esm/transport/1_transport_intermediate.js

@@ -18,7 +18,7 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 import { concat } from "../0_deps.js";
-import { bufferFromBigInt } from "../1_utilities.js";
+import { intToBytes } from "../1_utilities.js";
 import { getObfuscationParameters } from "./0_obfuscation.js";
 import { Transport } from "./0_transport.js";
 export class TransportIntermediate extends Transport {
@@ -51,7 +51,7 @@ export class TransportIntermediate extends Transport {
         return await this.decrypt(buffer);
     }
     async send(buffer) {
-        const length = bufferFromBigInt(buffer.length, 4);
+        const length = intToBytes(buffer.length, 4);
         const data = concat([length, buffer]);
         await this.#connection.write(await this.encrypt(data));
     }

package/esm/types/0_link_preview_media_size.d.ts

@@ -1,2 +1,21 @@
+/**
+ * MTKruto - Cross-runtime JavaScript library for building Telegram clients
+ * Copyright (C) 2023-2025 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 type LinkPreviewMediaSize = "small" | "large";
 //# sourceMappingURL=0_link_preview_media_size.d.ts.map

package/esm/types/0_link_preview_media_size.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"0_link_preview_media_size.d.ts","sourceRoot":"","sources":["../../src/types/0_link_preview_media_size.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,OAAO,CAAC"}
+{"version":3,"file":"0_link_preview_media_size.d.ts","sourceRoot":"","sources":["../../src/types/0_link_preview_media_size.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,OAAO,CAAC"}

package/esm/types/0_link_preview_media_size.js

@@ -1 +1,20 @@
+/**
+ * MTKruto - Cross-runtime JavaScript library for building Telegram clients
+ * Copyright (C) 2023-2025 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 {};

package/esm/types/1_inline_keyboard_button.js

@@ -89,7 +89,7 @@ export async function inlineKeyboardButtonToTlObject(button, usernameResolver) {
         const peerTypes = new Array();
         const { allowUsers, allowBots, allowGroups, allowChannels } = button.switchInlineQueryChosenChats;
         if (!allowUsers && !allowBots && !allowGroups && !allowChannels) {
-            throw new InputError("switchInlineQueryChosenChats: At least one chat type must be allowed");
+            throw new InputError("switchInlineQueryChosenChats: At least one chat type must be allowed.");
         }
         if (allowUsers) {
             peerTypes.push({ _: "inlineQueryPeerTypeBotPM" });

package/esm/types/7_saved_chat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"7_saved_chat.d.ts","sourceRoot":"","sources":["../../src/types/7_saved_chat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,KAAK,KAAK,EAAkB,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAoB,KAAK,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGpF,mCAAmC;AACnC,MAAM,WAAW,SAAS;IACxB,gBAAgB;IAChB,IAAI,EAAE,KAAK,CAAC;IACZ,qCAAqC;IACrC,WAAW,EAAE,OAAO,CAAC;IACrB,kCAAkC;IAClC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,CAAC,qBAAqB,GAAG,GAAG,CAAC,0BAA0B,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,CAAC,CAkB7O"}
+{"version":3,"file":"7_saved_chat.d.ts","sourceRoot":"","sources":["../../src/types/7_saved_chat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,KAAK,KAAK,EAAkB,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAoB,KAAK,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpF,mCAAmC;AACnC,MAAM,WAAW,SAAS;IACxB,gBAAgB;IAChB,IAAI,EAAE,KAAK,CAAC;IACZ,qCAAqC;IACrC,WAAW,EAAE,OAAO,CAAC;IACrB,kCAAkC;IAClC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,CAAC,qBAAqB,GAAG,GAAG,CAAC,0BAA0B,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,CAAC,CAkB7O"}

package/esm/types/7_saved_chat.js

@@ -17,10 +17,10 @@
  * 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 { unreachable } from "../0_deps.js";
 import { peerToChatId } from "../tl/2_telegram.js";
 import { constructChatP } from "./1_chat_p.js";
 import { constructMessage } from "./6_message.js";
-import { unreachable } from "../deps/jsr.io/@std/assert/1.0.13/unreachable.js";
 export async function constructSavedChat(dialog, result, getPeer, getMessage, getStickerSetName) {
     const message = result.messages.find((v) => v.id === dialog.top_message);
     if (message === undefined) {

package/esm/utilities/0_int.d.ts

@@ -0,0 +1,52 @@
+export type ByteOrder = "little" | "big";
+export declare function modExp(a: bigint, b: bigint, n: bigint): bigint;
+export declare function mod(n: bigint, m: bigint): bigint;
+export declare function mod(n: number, m: number): number;
+/**
+ * Additional parameters for { @link intFromBytes }.
+ */
+export interface IntFromBytesParams {
+    /** The byte order of the representation. Defaults to `little`. */
+    byteOrder?: ByteOrder;
+    /** Whether the integer is a signed one. Defaults to `true`. */
+    isSigned?: boolean;
+}
+/**
+ * Creates an integer from its byte representation.
+ *
+ * @param bytes The byte representation of the integer.
+ * @param params Additional parameters.
+ */
+export declare function intFromBytes(bytes: Uint8Array, { byteOrder, isSigned }?: IntFromBytesParams): bigint;
+/**
+ * Generates a random integer of an arbitrary size.
+ *
+ * @param isSigned Whether to allow signed integers. Defaults to `true`.
+ */
+export declare function getRandomInt(byteLength: number, isSigned?: boolean): bigint;
+/**
+ * Generates a random ID. Useful when interacting with the Telegram API.
+ *
+ * @param isNumber Whether the ID should be of the type number instead of a bigint.
+ */
+export declare function getRandomId(isNumber: true): number;
+export declare function getRandomId(): bigint;
+export declare function gcd(a: bigint, b: bigint): bigint;
+/** Additional parameters for { @link intToBuffer }. */
+export interface BufferFromBigintParams {
+    /** The byte order to use for the representation. Defaults to `little`. */
+    byteOrder?: ByteOrder;
+    /** Whether the integer is a signed one. Defaults to `true`. */
+    isSigned?: boolean;
+    /** The path to the integer in the TL schema. Unspecified by default. */
+    path?: string[];
+}
+/**
+ * Converts an integer to its byte representation.
+ *
+ * @param int The integer to convert.
+ * @param byteCount The expected size of the integer in bytes.
+ * @param params Additional parameters.
+ */
+export declare function intToBytes(int: bigint | number, byteCount: number, { byteOrder, isSigned, path, }?: BufferFromBigintParams): Uint8Array<ArrayBuffer>;
+//# sourceMappingURL=0_int.d.ts.map

package/esm/utilities/0_int.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"0_int.d.ts","sourceRoot":"","sources":["../../src/utilities/0_int.ts"],"names":[],"mappings":"AAwBA,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEzC,wBAAgB,MAAM,CACpB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,UAgBV;AAED,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;AAClD,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;AAOlD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,kEAAkE;IAClE,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,SAAoB,EAAE,QAAe,EAAE,GAAE,kBAAuB,UAcjH;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,UAAO,UAI/D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,IAAI,GAAG,MAAM,CAAC;AACpD,wBAAgB,WAAW,IAAI,MAAM,CAAC;AAStC,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,UAwBvC;AAID,uDAAuD;AACvD,MAAM,WAAW,sBAAsB;IACrC,0EAA0E;IAC1E,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAClE,SAAoB,EACpB,QAAe,EACf,IAAS,GACV,GAAE,sBAA2B,GAAG,UAAU,CAAC,WAAW,CAAC,CAoCvD"}