@mtkruto/browser 0.131.0 → 0.132.1

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":"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/esm/transport/0_obfuscation.js

@@ -18,8 +18,8 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 import { concat } from "../0_deps.js";
-import { CTR, intToBytes } from "../1_utilities.js";
-export async function getObfuscationParameters(protocol, connection) {
+import { CTR, intToBytes, sha256 } from "../1_utilities.js";
+export async function getObfuscationParameters(protocol, connection, params) {
     let init;
     while (true) {
         init = concat([crypto.getRandomValues(new Uint8Array(56)), intToBytes(protocol, 4, { byteOrder: "big", isSigned: false }), crypto.getRandomValues(new Uint8Array(4))]);
@@ -37,14 +37,27 @@ export async function getObfuscationParameters(protocol, connection) {
         }
         break;
     }
-    const encryptKey = init.slice(8, 8 + 32);
+    if (params?.dcId !== undefined) {
+        init.set(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 sha256(concat([encryptKey, secret]));
+    }
     const importedEncryptedKey = await CTR.importKey(encryptKey);
     const encryptionCTR = new 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 sha256(concat([decryptKey, secret]));
+    }
     const importedDecryptKey = await CTR.importKey(decryptKey);
     const decryptionCTR = new CTR(importedDecryptKey, decryptIv);
     await connection.write(concat([init.subarray(0, 56), encryptedInit.subarray(56, 56 + 8)]));

package/esm/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/esm/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/esm/transport/1_transport_intermediate.js

@@ -18,23 +18,29 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 import { concat } from "../0_deps.js";
-import { intToBytes } from "../1_utilities.js";
+import { getRandomId, intToBytes } from "../1_utilities.js";
 import { getObfuscationParameters } from "./0_obfuscation.js";
 import { Transport } from "./0_transport.js";
 export class TransportIntermediate extends 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 getObfuscationParameters(0xEEEEEEEE, this.#connection);
+        if (this.#isObfuscated) {
+            this.obfuscationParameters = await 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() {
@@ -51,6 +57,10 @@ export class TransportIntermediate extends Transport {
         return await this.decrypt(buffer);
     }
     async send(buffer) {
+        if (this.#isPadded) {
+            const padding = crypto.getRandomValues(new Uint8Array(Math.abs(getRandomId(true) % 16)));
+            buffer = concat([buffer, padding]);
+        }
         const length = intToBytes(buffer.length, 4);
         const data = concat([length, buffer]);
         await this.#connection.write(await this.encrypt(data));

package/esm/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/esm/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/esm/transport/2_transport_provider_mtproxy.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 { decodeHex } from "../0_deps.js";
+import { ConnectionTCP } from "../connection/1_connection_tcp.js";
+import { ConnectionTLS } from "../connection/1_connection_tls.js";
+import { TransportIntermediate } from "./1_transport_intermediate.js";
+import { getDcId } from "./1_transport_provider.js";
+export 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 = 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 = getDcId(dc, isCdn);
+        const connection = secret.byteLength <= 17 ? new ConnectionTCP(hostname, port) : new ConnectionTLS(hostname, port, secret);
+        const transport = new TransportIntermediate(connection, { isPadded: true, isObfuscated: true, secret, dcId });
+        return { connection, transport, dcId };
+    };
+}

package/esm/transport/2_transport_provider_web_socket.js

@@ -36,8 +36,8 @@ export 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 ConnectionWebSocket(url);
-        const transport = new TransportIntermediate(connection, true);
         const dcId = getDcId(dc, isCdn);
+        const transport = new TransportIntermediate(connection, { isObfuscated: true, dcId });
         return { connection, transport, dcId };
     };
 };

package/esm/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/esm/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/esm/types/0_star_amount.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/>.
+ */
+export function constructStarAmount(starsAmount) {
+    return {
+        amount: Number(starsAmount.amount),
+        nanos: Number(starsAmount.nanos),
+    };
+}

package/esm/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/esm/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/esm/types/2_star_transaction_peer.js

@@ -0,0 +1,45 @@
+/**
+ * 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 { unreachable } from "../0_deps.js";
+export 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) {
+                unreachable();
+            }
+            return { type: "chat", chat };
+        }
+        case "starsTransactionPeerAds":
+            return { type: "ads" };
+        case "starsTransactionPeerAPI":
+            return { type: "api" };
+    }
+}

package/esm/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/esm/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/esm/types/5_star_transaction.js

@@ -0,0 +1,71 @@
+/**
+ * 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 { unreachable } from "../0_deps.js";
+import { cleanObject } from "../1_utilities.js";
+import { Api } from "../2_tl.js";
+import { constructStarAmount } from "./0_star_amount.js";
+import { constructStarTransactionPeer } from "./2_star_transaction_peer.js";
+import { constructGift } from "./4_gift.js";
+export function constructStarTransaction(starTransaction, getPeer) {
+    let starrefChat;
+    if (starTransaction.starref_peer) {
+        starrefChat = getPeer(starTransaction.starref_peer)?.[0];
+        if (!starrefChat) {
+            unreachable();
+        }
+    }
+    return 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: constructStarAmount(Api.as("starsAmount", starTransaction.amount)),
+        date: starTransaction.date,
+        peer: 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 ? constructGift(starTransaction.stargift, getPeer) : undefined,
+        broadcastNumber: starTransaction.floodskip_number,
+        starrefCommissionPerMille: starTransaction.starref_commission_permille,
+        starrefChat,
+        starrefAmount: starTransaction.starref_amount ? constructStarAmount(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/esm/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/esm/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/esm/types/6_star_transaction_list.js

@@ -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/>.
+ */
+import { cleanObject } from "../1_utilities.js";
+import { constructStarTransaction } from "./5_star_transaction.js";
+export function constructStarTransactionList(result, getPeer) {
+    const transactions = result.history?.map((v) => constructStarTransaction(v, getPeer)) ?? [];
+    return cleanObject({
+        transactions,
+        nextOffset: result.next_offset,
+    });
+}

package/esm/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/esm/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/esm/utilities/1_crypto.js

@@ -77,3 +77,7 @@ export class CTR {
         this.#iv = intToBytes(intFromBytes(this.#iv, { byteOrder: "big", isSigned: false }) + BigInt(amount), this.#iv.length, { byteOrder: "big", isSigned: false });
     }
 }
+export 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));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mtkruto/browser",
-  "version": "0.131.0",
+  "version": "0.132.1",
   "description": "MTKruto for browsers",
   "author": "Roj <rojvv@icloud.com>",
   "repository": {

package/script/0_deps.d.ts

@@ -33,11 +33,11 @@ export { concat } from "./deps/jsr.io/@std/bytes/1.0.6/concat.js";
 export { equals } from "./deps/jsr.io/@std/bytes/1.0.6/equals.js";
 export { startsWith } from "./deps/jsr.io/@std/bytes/1.0.6/starts_with.js";
 export { LruCache } from "./deps/jsr.io/@std/cache/0.2.2/lru_cache.js";
-export { iterateReader } from "./deps/jsr.io/@std/io/0.225.3/iterate_reader.js";
+export { writeAll } from "./deps/jsr.io/@std/io/0.225.3/write_all.js";
 export { format } from "./deps/jsr.io/@std/datetime/0.225.7/format.js";
 export { MINUTE, SECOND } from "./deps/jsr.io/@std/datetime/0.225.7/constants.js";
 export { toArrayBuffer } from "./deps/jsr.io/@std/streams/1.0.17/to_array_buffer.js";
-export { encodeHex } from "./deps/jsr.io/@std/encoding/1.0.10/hex.js";
+export { decodeHex, encodeHex } from "./deps/jsr.io/@std/encoding/1.0.10/hex.js";
 export { decodeBase64, encodeBase64 } from "./deps/jsr.io/@std/encoding/1.0.10/base64.js";
 import { contentType as contentType_ } from "./deps/jsr.io/@std/media-types/1.1.0/content_type.js";
 export declare const contentType: typeof contentType_;