@mtkruto/browser 0.131.0 → 0.132.1

package/script/transport/0_obfuscation.d.ts

@@ -19,7 +19,11 @@
  */
 import { CTR } from "../1_utilities.js";
 import type { Connection } from "../2_connection.js";
-export declare function getObfuscationParameters(protocol: number, connection: Connection): Promise<{
+export interface GetObfuscationParametersParams {
+    dcId?: number;
+    secret?: Uint8Array;
+}
+export declare function getObfuscationParameters(protocol: number, connection: Connection, params?: GetObfuscationParametersParams): Promise<{
     encryptionCTR: CTR;
     decryptionCTR: CTR;
 }>;

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

@@ -1 +1 @@
-{"version":3,"file":"0_obfuscation.d.ts","sourceRoot":"","sources":["../../src/transport/0_obfuscation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,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"}
+{"version":3,"file":"0_obfuscation.d.ts","sourceRoot":"","sources":["../../src/transport/0_obfuscation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,GAAG,EAAsB,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,WAAW,8BAA8B;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,wBAAsB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,8BAA8B;;;GAyD/H"}

package/script/transport/0_obfuscation.js

@@ -22,7 +22,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getObfuscationParameters = getObfuscationParameters;
 const _0_deps_js_1 = require("../0_deps.js");
 const _1_utilities_js_1 = require("../1_utilities.js");
-async function getObfuscationParameters(protocol, connection) {
+async function getObfuscationParameters(protocol, connection, params) {
     let init;
     while (true) {
         init = (0, _0_deps_js_1.concat)([crypto.getRandomValues(new Uint8Array(56)), (0, _1_utilities_js_1.intToBytes)(protocol, 4, { byteOrder: "big", isSigned: false }), crypto.getRandomValues(new Uint8Array(4))]);
@@ -40,14 +40,27 @@ async function getObfuscationParameters(protocol, connection) {
         }
         break;
     }
-    const encryptKey = init.slice(8, 8 + 32);
+    if (params?.dcId !== undefined) {
+        init.set((0, _1_utilities_js_1.intToBytes)(params.dcId, 2, { byteOrder: "little" }), 60);
+    }
+    let secret = params?.secret;
+    if (secret !== undefined && secret.byteLength >= 17) {
+        secret = secret.subarray(1, 17);
+    }
+    let encryptKey = init.slice(8, 8 + 32);
     const encryptIv = init.slice(40, 40 + 16);
+    if (secret) {
+        encryptKey = await (0, _1_utilities_js_1.sha256)((0, _0_deps_js_1.concat)([encryptKey, secret]));
+    }
     const importedEncryptedKey = await _1_utilities_js_1.CTR.importKey(encryptKey);
     const encryptionCTR = new _1_utilities_js_1.CTR(importedEncryptedKey, encryptIv);
     const encryptedInit = await encryptionCTR.call(init);
     const initRev = new Uint8Array(init).reverse();
-    const decryptKey = initRev.slice(8, 8 + 32);
+    let decryptKey = initRev.slice(8, 8 + 32);
     const decryptIv = initRev.slice(40, 40 + 16);
+    if (secret) {
+        decryptKey = await (0, _1_utilities_js_1.sha256)((0, _0_deps_js_1.concat)([decryptKey, secret]));
+    }
     const importedDecryptKey = await _1_utilities_js_1.CTR.importKey(decryptKey);
     const decryptionCTR = new _1_utilities_js_1.CTR(importedDecryptKey, decryptIv);
     await connection.write((0, _0_deps_js_1.concat)([init.subarray(0, 56), encryptedInit.subarray(56, 56 + 8)]));

package/script/transport/1_transport_intermediate.d.ts

@@ -19,9 +19,15 @@
  */
 import type { Connection } from "../2_connection.js";
 import { Transport } from "./0_transport.js";
+export interface TransportIntermediateParams {
+    isObfuscated?: boolean;
+    isPadded?: boolean;
+    dcId?: number;
+    secret?: Uint8Array;
+}
 export declare class TransportIntermediate extends Transport implements Transport {
     #private;
-    constructor(connection: Connection, obfuscated?: boolean);
+    constructor(connection: Connection, params?: TransportIntermediateParams);
     initialize(): Promise<void>;
     receive(): Promise<Uint8Array>;
     send(buffer: Uint8Array): Promise<void>;

package/script/transport/1_transport_intermediate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"1_transport_intermediate.d.ts","sourceRoot":"","sources":["../../src/transport/1_transport_intermediate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,qBAAa,qBAAsB,SAAQ,SAAU,YAAW,SAAS;;gBAI3D,UAAU,EAAE,UAAU,EAAE,UAAU,UAAQ;IAMhD,UAAU;IAQV,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;IAiB9B,IAAI,CAAC,MAAM,EAAE,UAAU;CAM9B"}
+{"version":3,"file":"1_transport_intermediate.d.ts","sourceRoot":"","sources":["../../src/transport/1_transport_intermediate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,MAAM,WAAW,2BAA2B;IAC1C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,qBAAa,qBAAsB,SAAQ,SAAU,YAAW,SAAS;;gBAO3D,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,2BAA2B;IASlE,UAAU;IAYV,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;IAiB9B,IAAI,CAAC,MAAM,EAAE,UAAU;CAW9B"}

package/script/transport/1_transport_intermediate.js

@@ -26,18 +26,24 @@ const _0_obfuscation_js_1 = require("./0_obfuscation.js");
 const _0_transport_js_1 = require("./0_transport.js");
 class TransportIntermediate extends _0_transport_js_1.Transport {
     #connection;
-    #obfuscated;
-    constructor(connection, obfuscated = false) {
+    #isObfuscated;
+    #isPadded;
+    #dcId;
+    #secret;
+    constructor(connection, params) {
         super();
         this.#connection = connection;
-        this.#obfuscated = obfuscated;
+        this.#isObfuscated = params?.isObfuscated ?? false;
+        this.#isPadded = params?.isPadded ?? false;
+        this.#dcId = params?.dcId;
+        this.#secret = params?.secret;
     }
     async initialize() {
-        if (this.#obfuscated) {
-            this.obfuscationParameters = await (0, _0_obfuscation_js_1.getObfuscationParameters)(0xEEEEEEEE, this.#connection);
+        if (this.#isObfuscated) {
+            this.obfuscationParameters = await (0, _0_obfuscation_js_1.getObfuscationParameters)(this.#isPadded ? 0xDDDDDDDD : 0xEEEEEEEE, this.#connection, { dcId: this.#dcId, secret: this.#secret });
         }
         else {
-            await this.#connection.write(new Uint8Array([0xEE, 0xEE, 0xEE, 0xEE]));
+            await this.#connection.write(new Uint8Array(this.#isPadded ? [0xDD, 0xDD, 0xDD, 0xDD] : [0xEE, 0xEE, 0xEE, 0xEE]));
         }
     }
     async receive() {
@@ -54,6 +60,10 @@ class TransportIntermediate extends _0_transport_js_1.Transport {
         return await this.decrypt(buffer);
     }
     async send(buffer) {
+        if (this.#isPadded) {
+            const padding = crypto.getRandomValues(new Uint8Array(Math.abs((0, _1_utilities_js_1.getRandomId)(true) % 16)));
+            buffer = (0, _0_deps_js_1.concat)([buffer, padding]);
+        }
         const length = (0, _1_utilities_js_1.intToBytes)(buffer.length, 4);
         const data = (0, _0_deps_js_1.concat)([length, buffer]);
         await this.#connection.write(await this.encrypt(data));

package/script/transport/2_transport_provider_mtproxy.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 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 TransportProvider } from "./1_transport_provider.js";
+export declare function transportProviderMtproxy(link: string): TransportProvider;
+export declare function transportProviderMtproxy(hostname: string, port: number, secret: Uint8Array<ArrayBuffer>): TransportProvider;
+//# sourceMappingURL=2_transport_provider_mtproxy.d.ts.map

package/script/transport/2_transport_provider_mtproxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"2_transport_provider_mtproxy.d.ts","sourceRoot":"","sources":["../../src/transport/2_transport_provider_mtproxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,OAAO,EAAW,KAAK,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE5E,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAAC;AAC1E,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,WAAW,CAAC,GAAG,iBAAiB,CAAC"}

package/script/transport/2_transport_provider_mtproxy.js

@@ -0,0 +1,54 @@
+"use strict";
+/**
+ * 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/>.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transportProviderMtproxy = transportProviderMtproxy;
+const _0_deps_js_1 = require("../0_deps.js");
+const _1_connection_tcp_js_1 = require("../connection/1_connection_tcp.js");
+const _1_connection_tls_js_1 = require("../connection/1_connection_tls.js");
+const _1_transport_intermediate_js_1 = require("./1_transport_intermediate.js");
+const _1_transport_provider_js_1 = require("./1_transport_provider.js");
+function transportProviderMtproxy(hostnameOrLink, port, secret) {
+    let hostname = hostnameOrLink;
+    if (port === undefined && secret === undefined) {
+        const url = new URL(hostnameOrLink);
+        const hostname_ = url.searchParams.get("server");
+        const port_ = url.searchParams.get("port");
+        const secret_ = url.searchParams.get("secret");
+        if (!hostname_ || !port_ || !secret_) {
+            throw new TypeError("Invalid MTProxy link.");
+        }
+        hostname = hostname_;
+        port = parseInt(port_);
+        secret = (0, _0_deps_js_1.decodeHex)(secret_);
+        if (isNaN(port) || port < 0 || port > 0xFFFF) {
+            throw new TypeError("Server port is invalid.");
+        }
+        if (secret.byteLength < 16) {
+            throw new TypeError("Proxy secret must be at least 16 bytes.");
+        }
+    }
+    return ({ dc, isCdn }) => {
+        const dcId = (0, _1_transport_provider_js_1.getDcId)(dc, isCdn);
+        const connection = secret.byteLength <= 17 ? new _1_connection_tcp_js_1.ConnectionTCP(hostname, port) : new _1_connection_tls_js_1.ConnectionTLS(hostname, port, secret);
+        const transport = new _1_transport_intermediate_js_1.TransportIntermediate(connection, { isPadded: true, isObfuscated: true, secret, dcId });
+        return { connection, transport, dcId };
+    };
+}

package/script/transport/2_transport_provider_web_socket.js

@@ -39,8 +39,8 @@ const transportProviderWebSocket = (params) => {
         params.wss ??= typeof location !== "undefined" && location.protocol === "http:" && location.hostname !== "localhost" ? false : true;
         const url = `${params.wss ? "wss" : "ws"}://${dcToNameMap[dc]}${isCdn ? "-1" : ""}.web.telegram.org/${dc.endsWith("-test") ? "apiws_test" : "apiws"}`;
         const connection = new _2_connection_js_1.ConnectionWebSocket(url);
-        const transport = new _1_transport_intermediate_js_1.TransportIntermediate(connection, true);
         const dcId = (0, _1_transport_provider_js_1.getDcId)(dc, isCdn);
+        const transport = new _1_transport_intermediate_js_1.TransportIntermediate(connection, { isObfuscated: true, dcId });
         return { connection, transport, dcId };
     };
 };

package/script/types/0_star_amount.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 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 { Api } from "../2_tl.js";
+/** A star amount. */
+export interface StarAmount {
+    /** The amount of stars. */
+    amount: number;
+    /** The decimal star amount. */
+    nanos: number;
+}
+export declare function constructStarAmount(starsAmount: Api.starsAmount): StarAmount;
+//# sourceMappingURL=0_star_amount.d.ts.map

package/script/types/0_star_amount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"0_star_amount.d.ts","sourceRoot":"","sources":["../../src/types/0_star_amount.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAEtC,qBAAqB;AACrB,MAAM,WAAW,UAAU;IACzB,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,GAAG,CAAC,WAAW,GAAG,UAAU,CAK5E"}

package/script/types/0_star_amount.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * 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/>.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.constructStarAmount = constructStarAmount;
+function constructStarAmount(starsAmount) {
+    return {
+        amount: Number(starsAmount.amount),
+        nanos: Number(starsAmount.nanos),
+    };
+}

package/script/types/2_star_transaction_peer.d.ts

@@ -0,0 +1,66 @@
+/**
+ * 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 { Api } from "../2_tl.js";
+import type { ChatP, PeerGetter } from "./1_chat_p.js";
+/** @unlisted */
+export interface StarTransactionPeerUnsupported {
+    /** @discriminator */
+    type: "unsupported";
+}
+/** @unlisted */
+export interface StarTransactionPeerAppStore {
+    /** @discriminator */
+    type: "appStore";
+}
+/** @unlisted */
+export interface StarTransactionPeerPlayMarket {
+    /** @discriminator */
+    type: "playMarket";
+}
+/** @unlisted */
+export interface StarTransactionPeerPremiumBot {
+    /** @discriminator */
+    type: "premiumBot";
+}
+/** @unlisted */
+export interface StarTransactionPeerFragment {
+    /** @discriminator */
+    type: "fragment";
+}
+/** @unlisted */
+export interface StarTransactionPeerChat {
+    /** @discriminator */
+    type: "chat";
+    chat: ChatP;
+}
+/** @unlisted */
+export interface StarTransactionPeerAds {
+    /** @discriminator */
+    type: "ads";
+}
+/** @unlisted */
+export interface StarTransactionPeerApi {
+    /** @discriminator */
+    type: "api";
+}
+/** Any type of star transaction peer. */
+export type StarTransactionPeer = StarTransactionPeerUnsupported | StarTransactionPeerAppStore | StarTransactionPeerPlayMarket | StarTransactionPeerPremiumBot | StarTransactionPeerFragment | StarTransactionPeerChat | StarTransactionPeerAds | StarTransactionPeerApi;
+export declare function constructStarTransactionPeer(peer: Api.StarsTransactionPeer, getPeer: PeerGetter): StarTransactionPeer;
+//# sourceMappingURL=2_star_transaction_peer.d.ts.map

package/script/types/2_star_transaction_peer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"2_star_transaction_peer.d.ts","sourceRoot":"","sources":["../../src/types/2_star_transaction_peer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEvD,gBAAgB;AAChB,MAAM,WAAW,8BAA8B;IAC7C,qBAAqB;IACrB,IAAI,EAAE,aAAa,CAAC;CACrB;AAED,gBAAgB;AAChB,MAAM,WAAW,2BAA2B;IAC1C,qBAAqB;IACrB,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,gBAAgB;AAChB,MAAM,WAAW,6BAA6B;IAC5C,qBAAqB;IACrB,IAAI,EAAE,YAAY,CAAC;CACpB;AAED,gBAAgB;AAChB,MAAM,WAAW,6BAA6B;IAC5C,qBAAqB;IACrB,IAAI,EAAE,YAAY,CAAC;CACpB;AAED,gBAAgB;AAChB,MAAM,WAAW,2BAA2B;IAC1C,qBAAqB;IACrB,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,gBAAgB;AAChB,MAAM,WAAW,uBAAuB;IACtC,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,KAAK,CAAC;CACb;AAED,gBAAgB;AAChB,MAAM,WAAW,sBAAsB;IACrC,qBAAqB;IACrB,IAAI,EAAE,KAAK,CAAC;CACb;AAED,gBAAgB;AAChB,MAAM,WAAW,sBAAsB;IACrC,qBAAqB;IACrB,IAAI,EAAE,KAAK,CAAC;CACb;AAED,yCAAyC;AACzC,MAAM,MAAM,mBAAmB,GAAG,8BAA8B,GAAG,2BAA2B,GAAG,6BAA6B,GAAG,6BAA6B,GAAG,2BAA2B,GAAG,uBAAuB,GAAG,sBAAsB,GAAG,sBAAsB,CAAC;AAEzQ,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,GAAG,CAAC,oBAAoB,EAAE,OAAO,EAAE,UAAU,GAAG,mBAAmB,CAwBrH"}

package/script/types/2_star_transaction_peer.js

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * 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/>.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.constructStarTransactionPeer = constructStarTransactionPeer;
+const _0_deps_js_1 = require("../0_deps.js");
+function constructStarTransactionPeer(peer, getPeer) {
+    switch (peer._) {
+        case "starsTransactionPeerUnsupported":
+            return { type: "unsupported" };
+        case "starsTransactionPeerAppStore":
+            return { type: "appStore" };
+        case "starsTransactionPeerPlayMarket":
+            return { type: "playMarket" };
+        case "starsTransactionPeerPremiumBot":
+            return { type: "premiumBot" };
+        case "starsTransactionPeerFragment":
+            return { type: "fragment" };
+        case "starsTransactionPeer": {
+            const chat = getPeer(peer.peer)?.[0];
+            if (!chat) {
+                (0, _0_deps_js_1.unreachable)();
+            }
+            return { type: "chat", chat };
+        }
+        case "starsTransactionPeerAds":
+            return { type: "ads" };
+        case "starsTransactionPeerAPI":
+            return { type: "api" };
+    }
+}

package/script/types/5_star_transaction.d.ts

@@ -0,0 +1,64 @@
+/**
+ * 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 { Api } from "../2_tl.js";
+import { type StarAmount } from "./0_star_amount.js";
+import type { ChatP, PeerGetter } from "./1_chat_p.js";
+import { type StarTransactionPeer } from "./2_star_transaction_peer.js";
+import { type Gift } from "./4_gift.js";
+/** A star transaction. */
+export interface StarTransaction {
+    isRefund: boolean;
+    isPending: boolean;
+    isFailed: boolean;
+    isGift: boolean;
+    isReaction: boolean;
+    isGiftUpgrade: boolean;
+    isBusinessTransfer: boolean;
+    isGiftResale: boolean;
+    isPostSearch: boolean;
+    isGiftPrepaidUpgrade: boolean;
+    isGiftDetailDrop: boolean;
+    isPhoneGroupMessage: boolean;
+    isGiftAuctionBid: boolean;
+    isOffer: boolean;
+    id: string;
+    amount: StarAmount;
+    date: number;
+    peer: StarTransactionPeer;
+    title?: string;
+    description?: string;
+    transactionDate?: number;
+    transactionUrl?: string;
+    botPayload?: string;
+    messageId?: number;
+    subscriptionPeriod?: number;
+    giveawayMessageId?: number;
+    gift?: Gift;
+    broadcastNumber?: number;
+    starrefCommissionPerMille?: number;
+    starrefChat?: ChatP;
+    starrefAmount?: StarAmount;
+    paidMessages?: number;
+    premiumGiftMonthCount?: number;
+    adsProceedsFromDate?: number;
+    adsProceedsToDate?: number;
+}
+export declare function constructStarTransaction(starTransaction: Api.StarsTransaction, getPeer: PeerGetter): StarTransaction;
+//# sourceMappingURL=5_star_transaction.d.ts.map

package/script/types/5_star_transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"5_star_transaction.d.ts","sourceRoot":"","sources":["../../src/types/5_star_transaction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,EAAuB,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAgC,KAAK,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACtG,OAAO,EAAiB,KAAK,IAAI,EAAE,MAAM,aAAa,CAAC;AAEvD,0BAA0B;AAC1B,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;IACvB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,mBAAmB,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,WAAW,CAAC,EAAE,KAAK,CAAC;IACpB,aAAa,CAAC,EAAE,UAAU,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAgB,wBAAwB,CAAC,eAAe,EAAE,GAAG,CAAC,gBAAgB,EAAE,OAAO,EAAE,UAAU,GAAG,eAAe,CA8CpH"}

package/script/types/5_star_transaction.js

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * 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/>.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.constructStarTransaction = constructStarTransaction;
+const _0_deps_js_1 = require("../0_deps.js");
+const _1_utilities_js_1 = require("../1_utilities.js");
+const _2_tl_js_1 = require("../2_tl.js");
+const _0_star_amount_js_1 = require("./0_star_amount.js");
+const _2_star_transaction_peer_js_1 = require("./2_star_transaction_peer.js");
+const _4_gift_js_1 = require("./4_gift.js");
+function constructStarTransaction(starTransaction, getPeer) {
+    let starrefChat;
+    if (starTransaction.starref_peer) {
+        starrefChat = getPeer(starTransaction.starref_peer)?.[0];
+        if (!starrefChat) {
+            (0, _0_deps_js_1.unreachable)();
+        }
+    }
+    return (0, _1_utilities_js_1.cleanObject)({
+        isRefund: starTransaction.refund ?? false,
+        isPending: starTransaction.pending ?? false,
+        isFailed: starTransaction.failed ?? false,
+        isGift: starTransaction.gift ?? false,
+        isReaction: starTransaction.reaction ?? false,
+        isGiftUpgrade: starTransaction.stargift_upgrade ?? false,
+        isBusinessTransfer: starTransaction.business_transfer ?? false,
+        isGiftResale: starTransaction.stargift_resale ?? false,
+        isPostSearch: starTransaction.posts_search ?? false,
+        isGiftPrepaidUpgrade: starTransaction.stargift_prepaid_upgrade ?? false,
+        isGiftDetailDrop: starTransaction.stargift_drop_original_details ?? false,
+        isPhoneGroupMessage: starTransaction.phonegroup_message ?? false,
+        isGiftAuctionBid: starTransaction.stargift_auction_bid ?? false,
+        isOffer: starTransaction.offer ?? false,
+        id: starTransaction.id,
+        amount: (0, _0_star_amount_js_1.constructStarAmount)(_2_tl_js_1.Api.as("starsAmount", starTransaction.amount)),
+        date: starTransaction.date,
+        peer: (0, _2_star_transaction_peer_js_1.constructStarTransactionPeer)(starTransaction.peer, getPeer),
+        title: starTransaction.title,
+        description: starTransaction.description,
+        transactionDate: starTransaction.transaction_date,
+        transactionUrl: starTransaction.transaction_url,
+        botPayload: new TextDecoder().decode(starTransaction.bot_payload),
+        messageId: starTransaction.msg_id,
+        subscriptionPeriod: starTransaction.subscription_period,
+        giveawayMessageId: starTransaction.giveaway_post_id,
+        gift: starTransaction.stargift ? (0, _4_gift_js_1.constructGift)(starTransaction.stargift, getPeer) : undefined,
+        broadcastNumber: starTransaction.floodskip_number,
+        starrefCommissionPerMille: starTransaction.starref_commission_permille,
+        starrefChat,
+        starrefAmount: starTransaction.starref_amount ? (0, _0_star_amount_js_1.constructStarAmount)(_2_tl_js_1.Api.as("starsAmount", starTransaction.starref_amount)) : undefined,
+        paidMessages: starTransaction.paid_messages,
+        premiumGiftMonthCount: starTransaction.premium_gift_months,
+        adsProceedsFromDate: starTransaction.ads_proceeds_from_date,
+        adsProceedsToDate: starTransaction.ads_proceeds_to_date,
+    });
+}

package/script/types/6_star_transaction_list.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 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 { Api } from "../2_tl.js";
+import type { PeerGetter } from "./1_chat_p.js";
+import { type StarTransaction } from "./5_star_transaction.js";
+/** A list of star transactions. */
+export interface StarTransactionList {
+    /** The transactions included in this list. */
+    transactions: StarTransaction[];
+    /** Key to fetch further transactions. */
+    nextOffset?: string;
+}
+export declare function constructStarTransactionList(result: Api.payments_starsStatus, getPeer: PeerGetter): StarTransactionList;
+//# sourceMappingURL=6_star_transaction_list.d.ts.map

package/script/types/6_star_transaction_list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"6_star_transaction_list.d.ts","sourceRoot":"","sources":["../../src/types/6_star_transaction_list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAA4B,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAEzF,mCAAmC;AACnC,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,GAAG,CAAC,oBAAoB,EAAE,OAAO,EAAE,UAAU,GAAG,mBAAmB,CAMvH"}

package/script/types/6_star_transaction_list.js

@@ -0,0 +1,31 @@
+"use strict";
+/**
+ * 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/>.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.constructStarTransactionList = constructStarTransactionList;
+const _1_utilities_js_1 = require("../1_utilities.js");
+const _5_star_transaction_js_1 = require("./5_star_transaction.js");
+function constructStarTransactionList(result, getPeer) {
+    const transactions = result.history?.map((v) => (0, _5_star_transaction_js_1.constructStarTransaction)(v, getPeer)) ?? [];
+    return (0, _1_utilities_js_1.cleanObject)({
+        transactions,
+        nextOffset: result.next_offset,
+    });
+}

package/script/utilities/1_crypto.d.ts

@@ -27,4 +27,5 @@ export declare class CTR {
     static importKey(key: Uint8Array<ArrayBuffer>): Promise<CryptoKey>;
     call(data: Uint8Array<ArrayBuffer>): Promise<Uint8Array<ArrayBuffer>>;
 }
+export declare function hmacSha256(data: Uint8Array<ArrayBuffer>, secret: Uint8Array<ArrayBuffer>): Promise<Uint8Array<ArrayBuffer>>;
 //# sourceMappingURL=1_crypto.d.ts.map

package/script/utilities/1_crypto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"1_crypto.d.ts","sourceRoot":"","sources":["../../src/utilities/1_crypto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,qBAAa,GAAG;;IAMd,IAAI,MAAM,IAAI;QAAE,EAAE,EAAE,UAAU,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAE9C;gBAEW,GAAG,EAAE,SAAS,EAAE,EAAE,EAAE,UAAU;WAK7B,SAAS,CAAC,GAAG,EAAE,UAAU,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAIlE,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;CAkD5E"}
+{"version":3,"file":"1_crypto.d.ts","sourceRoot":"","sources":["../../src/utilities/1_crypto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,qBAAa,GAAG;;IAMd,IAAI,MAAM,IAAI;QAAE,EAAE,EAAE,UAAU,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAE9C;gBAEW,GAAG,EAAE,SAAS,EAAE,EAAE,EAAE,UAAU;WAK7B,SAAS,CAAC,GAAG,EAAE,UAAU,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAIlE,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;CAkD5E;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,WAAW,CAAC,oCAe9F"}

package/script/utilities/1_crypto.js

@@ -20,6 +20,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CTR = void 0;
+exports.hmacSha256 = hmacSha256;
 const _0_deps_js_1 = require("../0_deps.js");
 const _0_int_js_1 = require("./0_int.js");
 class CTR {
@@ -81,3 +82,7 @@ class CTR {
     }
 }
 exports.CTR = CTR;
+async function hmacSha256(data, secret) {
+    const key = await crypto.subtle.importKey("raw", secret, { name: "HMAC", hash: "SHA-256" }, false, ["sign"]);
+    return new Uint8Array(await crypto.subtle.sign("HMAC", key, data.buffer));
+}