@mtkruto/browser 0.6.0 → 0.119.0

package/esm/types/2_story_interactive_area.d.ts

@@ -1,6 +1,6 @@
 /**
  * MTKruto - Cross-runtime JavaScript library for building Telegram clients
- * Copyright (C) 2023-2024 Roj <https://roj.im/>
+ * Copyright (C) 2023-2026 Roj <https://roj.im/>
  *
  * This file is part of MTKruto.
  *
@@ -18,11 +18,11 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 import { Api } from "../2_tl.js";
-import { EntityGetter } from "./_getters.js";
-import { Location } from "./0_location.js";
-import { MessageReference } from "./0_message_reference.js";
-import { Reaction } from "./0_reaction.js";
-import { Venue } from "./1_venue.js";
+import { type Location } from "./0_location.js";
+import type { MessageReference } from "./0_message_reference.js";
+import { type Reaction } from "./0_reaction.js";
+import type { PeerGetter } from "./1_chat_p.js";
+import { type Venue } from "./1_venue.js";
 /** @unlisted */
 export interface StoryInteractiveAreaPosition {
     xPercentage: number;
@@ -47,8 +47,8 @@ export interface StoryInteractiveAreaVenue extends _StoryInteractiveAreaPosition
 export interface StoryInteractiveAreaReaction extends _StoryInteractiveAreaPositionCommon {
     reaction: Reaction;
     count?: number;
-    dark?: boolean;
-    flipped?: boolean;
+    isDark?: boolean;
+    isFlipped?: boolean;
 }
 /** @unlisted */
 export interface StoryInteractiveAreaMessage extends _StoryInteractiveAreaPositionCommon {
@@ -57,5 +57,5 @@ export interface StoryInteractiveAreaMessage extends _StoryInteractiveAreaPositi
 /** A story's interactive area. */
 export type StoryInteractiveArea = StoryInteractiveAreaLocation | StoryInteractiveAreaVenue | StoryInteractiveAreaReaction | StoryInteractiveAreaMessage;
 export declare function constructStoryInteractiveArea(area: Api.MediaArea): StoryInteractiveArea;
-export declare function storyInteractiveAreaToTlObject(area: StoryInteractiveArea, getEntity: EntityGetter): Promise<Api.MediaArea>;
+export declare function storyInteractiveAreaToTlObject(area: StoryInteractiveArea, getPeer: PeerGetter): Api.MediaArea;
 //# sourceMappingURL=2_story_interactive_area.d.ts.map

package/esm/types/2_story_interactive_area.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"2_story_interactive_area.d.ts","sourceRoot":"","sources":["../../src/types/2_story_interactive_area.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,GAAG,EAAkC,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAqB,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAkB,KAAK,EAAE,MAAM,cAAc,CAAC;AAErD,gBAAgB;AAChB,MAAM,WAAW,4BAA4B;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,gBAAgB;AAChB,MAAM,WAAW,mCAAmC;IAClD,QAAQ,EAAE,4BAA4B,CAAC;CACxC;AAED,gBAAgB;AAChB,MAAM,WAAW,4BAA6B,SAAQ,mCAAmC;IACvF,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,gBAAgB;AAChB,MAAM,WAAW,yBAA0B,SAAQ,mCAAmC;IACpF,KAAK,EAAE,KAAK,CAAC;CACd;AAED,gBAAgB;AAChB,MAAM,WAAW,4BAA6B,SAAQ,mCAAmC;IACvF,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,gBAAgB;AAChB,MAAM,WAAW,2BAA4B,SAAQ,mCAAmC;IACtF,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AAED,kCAAkC;AAClC,MAAM,MAAM,oBAAoB,GAC5B,4BAA4B,GAC5B,yBAAyB,GACzB,4BAA4B,GAC5B,2BAA2B,CAAC;AAWhC,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,GAAG,CAAC,SAAS,GAAG,oBAAoB,CA+BvF;AAKD,wBAAsB,8BAA8B,CAAC,IAAI,EAAE,oBAAoB,EAAE,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CA8BhI"}
+{"version":3,"file":"2_story_interactive_area.d.ts","sourceRoot":"","sources":["../../src/types/2_story_interactive_area.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAEjC,OAAO,EAAqB,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAqB,KAAK,QAAQ,EAAsB,MAAM,iBAAiB,CAAC;AACvF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAkB,KAAK,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1D,gBAAgB;AAChB,MAAM,WAAW,4BAA4B;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,gBAAgB;AAChB,MAAM,WAAW,mCAAmC;IAClD,QAAQ,EAAE,4BAA4B,CAAC;CACxC;AAED,gBAAgB;AAChB,MAAM,WAAW,4BAA6B,SAAQ,mCAAmC;IACvF,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,gBAAgB;AAChB,MAAM,WAAW,yBAA0B,SAAQ,mCAAmC;IACpF,KAAK,EAAE,KAAK,CAAC;CACd;AAED,gBAAgB;AAChB,MAAM,WAAW,4BAA6B,SAAQ,mCAAmC;IACvF,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,gBAAgB;AAChB,MAAM,WAAW,2BAA4B,SAAQ,mCAAmC;IACtF,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AAED,kCAAkC;AAClC,MAAM,MAAM,oBAAoB,GAC5B,4BAA4B,GAC5B,yBAAyB,GACzB,4BAA4B,GAC5B,2BAA2B,CAAC;AAWhC,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,GAAG,CAAC,SAAS,GAAG,oBAAoB,CA+BvF;AAKD,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,UAAU,GAAG,GAAG,CAAC,SAAS,CA8B7G"}

package/esm/types/2_story_interactive_area.js

@@ -1,6 +1,6 @@
 /**
  * MTKruto - Cross-runtime JavaScript library for building Telegram clients
- * Copyright (C) 2023-2024 Roj <https://roj.im/>
+ * Copyright (C) 2023-2026 Roj <https://roj.im/>
  *
  * This file is part of MTKruto.
  *
@@ -18,7 +18,8 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 import { unreachable } from "../0_deps.js";
-import { chatIdToPeer, is, peerToChatId } from "../2_tl.js";
+import { Api } from "../2_tl.js";
+import { chatIdToPeerId } from "../tl/2_telegram.js";
 import { constructLocation } from "./0_location.js";
 import { constructReaction, reactionToTlObject } from "./0_reaction.js";
 import { constructVenue } from "./1_venue.js";
@@ -33,32 +34,32 @@ function constructStoryInteractiveAreaPosition(position) {
 }
 export function constructStoryInteractiveArea(area) {
     const position = constructStoryInteractiveAreaPosition(area.coordinates);
-    if (is("mediaAreaGeoPoint", area)) {
-        if (is("geoPointEmpty", area.geo)) {
+    if (Api.is("mediaAreaGeoPoint", area)) {
+        if (Api.is("geoPointEmpty", area.geo)) {
             unreachable(); // will this ever be empty?
         }
         const location = constructLocation(area.geo);
         return { position, location };
     }
-    else if (is("mediaAreaVenue", area)) {
+    else if (Api.is("mediaAreaVenue", area)) {
         const venue = constructVenue(area);
         return { position, venue };
     }
-    else if (is("mediaAreaSuggestedReaction", area)) {
+    else if (Api.is("mediaAreaSuggestedReaction", area)) {
         const reaction = constructReaction(area.reaction);
         return {
             position,
             reaction,
             count: 0, // TODO: count
-            flipped: area.flipped ? true : false,
-            dark: area.dark ? true : false,
+            isFlipped: area.flipped ? true : false,
+            isDark: area.dark ? true : false,
         };
     }
-    else if (is("mediaAreaChannelPost", area)) {
+    else if (Api.is("mediaAreaChannelPost", area)) {
         return {
             position,
             messageReference: {
-                chatId: peerToChatId(area),
+                chatId: Api.peerToChatId(area),
                 messageId: area.msg_id,
             },
         };
@@ -70,7 +71,7 @@ export function constructStoryInteractiveArea(area) {
 function storyInteractiveAreaPositionToTlObject(position) {
     return { _: "mediaAreaCoordinates", x: position.xPercentage, y: position.yPercentage, w: position.widthPercentage, h: position.heightPercentage, rotation: position.rotationAngle };
 }
-export async function storyInteractiveAreaToTlObject(area, getEntity) {
+export function storyInteractiveAreaToTlObject(area, getPeer) {
     const coordinates = storyInteractiveAreaPositionToTlObject(area.position);
     if ("location" in area) {
         const geo = { _: "geoPoint", lat: area.location.latitude, long: area.location.longitude, access_hash: 0n, accuracy_radius: area.location.horizontalAccuracy };
@@ -91,14 +92,14 @@ export async function storyInteractiveAreaToTlObject(area, getEntity) {
     }
     else if ("reaction" in area) {
         const reaction = reactionToTlObject(area.reaction);
-        return { _: "mediaAreaSuggestedReaction", coordinates, reaction, dark: area.dark ? true : undefined, flipped: area.flipped ? true : undefined };
+        return { _: "mediaAreaSuggestedReaction", coordinates, reaction, dark: area.isDark ? true : undefined, flipped: area.isFlipped ? true : undefined };
     }
     else if ("messageReference" in area) {
-        const entity = await getEntity(chatIdToPeer(area.messageReference.chatId));
-        if (!(is("channel", entity))) {
+        const peer = getPeer(Api.chatIdToPeer(area.messageReference.chatId));
+        if (!peer || peer[0].type !== "channel") {
             unreachable();
         }
-        const channel = { _: "inputChannel", channel_id: entity.id, access_hash: entity.access_hash ?? 0n };
+        const channel = { _: "inputChannel", channel_id: chatIdToPeerId(peer[0].id), access_hash: peer[1] };
         return { _: "inputMediaAreaChannelPost", coordinates, channel, msg_id: area.messageReference.messageId };
     }
     else {

package/esm/types/2_story_privacy.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 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 { PeerGetter } from "./1_chat_p.js";
+/** @unlisted */
+export interface StoryPrivacyEveryone {
+    /** @discriminator */
+    everyoneExcept: number[];
+}
+/** @unlisted */
+export interface StoryPrivacyConctacts {
+    /** @discriminator */
+    contactsExcept: number[];
+}
+/** @unlisted */
+export interface StoryPrivacyCloseFriends {
+    /** @discriminator */
+    closeFriends: true;
+}
+/** @unlisted */
+export interface StoryPrivacyOnly {
+    /** @discriminator */
+    only: number[];
+}
+/** A story's privacy choice. */
+export type StoryPrivacy = StoryPrivacyEveryone | StoryPrivacyConctacts | StoryPrivacyCloseFriends | StoryPrivacyOnly;
+export declare function storyPrivacyToTlObject(privacy: StoryPrivacy, getPeer: PeerGetter): Api.InputPrivacyRule[];
+export declare function constructStoryPrivacy(privacy: Api.PrivacyRule[]): StoryPrivacy;
+//# sourceMappingURL=2_story_privacy.d.ts.map

package/esm/types/2_story_privacy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"2_story_privacy.d.ts","sourceRoot":"","sources":["../../src/types/2_story_privacy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,gBAAgB;AAChB,MAAM,WAAW,oBAAoB;IACnC,qBAAqB;IACrB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,gBAAgB;AAChB,MAAM,WAAW,qBAAqB;IACpC,qBAAqB;IACrB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,gBAAgB;AAChB,MAAM,WAAW,wBAAwB;IACvC,qBAAqB;IACrB,YAAY,EAAE,IAAI,CAAC;CACpB;AAED,gBAAgB;AAChB,MAAM,WAAW,gBAAgB;IAC/B,qBAAqB;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,gCAAgC;AAChC,MAAM,MAAM,YAAY,GACpB,oBAAoB,GACpB,qBAAqB,GACrB,wBAAwB,GACxB,gBAAgB,CAAC;AAqBrB,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,GAAG,GAAG,CAAC,gBAAgB,EAAE,CAkBzG;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,GAAG,CAAC,WAAW,EAAE,GAAG,YAAY,CAY9E"}

package/esm/types/2_story_privacy.js

@@ -0,0 +1,76 @@
+/**
+ * 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 { Api } from "../2_tl.js";
+function resolveUsers(ids, getPeer) {
+    const users = new Array();
+    for (const id of ids) {
+        const peer = getPeer({ _: "peerUser", user_id: BigInt(id) });
+        if (!peer) {
+            unreachable();
+        }
+        else {
+            users.push({ _: "inputUser", user_id: BigInt(peer[0].id), access_hash: peer[1] });
+        }
+    }
+    return users;
+}
+function restrict(users_, rules, getPeer) {
+    if (users_.length) {
+        const users = resolveUsers(users_, getPeer);
+        rules.push({ _: "inputPrivacyValueDisallowUsers", users });
+    }
+}
+export function storyPrivacyToTlObject(privacy, getPeer) {
+    const rules = new Array();
+    if ("everyoneExcept" in privacy) {
+        restrict(privacy.everyoneExcept, rules, getPeer);
+        rules.push({ _: "inputPrivacyValueAllowAll" });
+    }
+    else if ("contactsExcept" in privacy) {
+        restrict(privacy.contactsExcept, rules, getPeer);
+        rules.push({ _: "inputPrivacyValueAllowContacts" });
+    }
+    else if ("closeFriends" in privacy) {
+        rules.push({ _: "inputPrivacyValueAllowCloseFriends" });
+    }
+    else if ("only" in privacy) {
+        if (!privacy.only.length) {
+            unreachable();
+        }
+        const users = resolveUsers(privacy.only, getPeer);
+        rules.push({ _: "inputPrivacyValueAllowUsers", users });
+    }
+    return rules;
+}
+export function constructStoryPrivacy(privacy) {
+    const except = privacy.find((v) => Api.is("privacyValueDisallowUsers", v))?.users?.map(Number) ?? [];
+    if (privacy.some((v) => Api.is("privacyValueAllowAll", v))) {
+        return { everyoneExcept: except };
+    }
+    else if (privacy.some((v) => Api.is("privacyValueAllowContacts", v))) {
+        return { contactsExcept: except };
+    }
+    else if (privacy.some((v) => Api.is("privacyValueAllowCloseFriends", v))) {
+        return { closeFriends: true };
+    }
+    const only = privacy.find((v) => Api.is("privacyValueAllowUsers", v))?.users?.map(Number) ?? [];
+    return { only };
+}

package/esm/types/2_successful_payment.d.ts

@@ -1,6 +1,6 @@
 /**
  * MTKruto - Cross-runtime JavaScript library for building Telegram clients
- * Copyright (C) 2023-2024 Roj <https://roj.im/>
+ * Copyright (C) 2023-2026 Roj <https://roj.im/>
  *
  * This file is part of MTKruto.
  *
@@ -17,15 +17,23 @@
  * 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 { OrderInfo } from "./1_order_info.js";
+import type { Api } from "../2_tl.js";
+import { type OrderInfo } from "./1_order_info.js";
+/** A successful payment. */
 export interface SuccessfulPayment {
+    /** The currency of the payment. */
     currency: string;
+    /** The total amount of the transaction. */
     totalAmount: number;
+    /** The payload of the payment's invoice. */
     invoicePayload: string;
+    /** Telegram payment charge ID. */
     telegramPaymentChargeId: string;
+    /** Provider payment charge ID. */
     providerPaymentChargeId: string;
+    /** The payment's shipping option ID. */
     shippingOptionId?: string;
+    /** The payment's order info. */
     orderInfo?: OrderInfo;
 }
 export declare function constructSuccessfulPayment(action: Api.messageActionPaymentSentMe): SuccessfulPayment;

package/esm/types/2_successful_payment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"2_successful_payment.d.ts","sourceRoot":"","sources":["../../src/types/2_successful_payment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,EAAsB,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAElE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,uBAAuB,EAAE,MAAM,CAAC;IAChC,uBAAuB,EAAE,MAAM,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,GAAG,CAAC,0BAA0B,GAAG,iBAAiB,CAUpG"}
+{"version":3,"file":"2_successful_payment.d.ts","sourceRoot":"","sources":["../../src/types/2_successful_payment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEvE,4BAA4B;AAC5B,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,cAAc,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,uBAAuB,EAAE,MAAM,CAAC;IAChC,kCAAkC;IAClC,uBAAuB,EAAE,MAAM,CAAC;IAChC,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gCAAgC;IAChC,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,GAAG,CAAC,0BAA0B,GAAG,iBAAiB,CAUpG"}

package/esm/types/2_successful_payment.js

@@ -1,6 +1,6 @@
 /**
  * MTKruto - Cross-runtime JavaScript library for building Telegram clients
- * Copyright (C) 2023-2024 Roj <https://roj.im/>
+ * Copyright (C) 2023-2026 Roj <https://roj.im/>
  *
  * This file is part of MTKruto.
  *
@@ -17,13 +17,13 @@
  * 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 { cleanObject, decodeText } from "../1_utilities.js";
 import { constructOrderInfo } from "./1_order_info.js";
 export function constructSuccessfulPayment(action) {
     return cleanObject({
         currency: action.currency,
         totalAmount: Number(action.total_amount),
-        invoicePayload: new TextDecoder().decode(action.payload),
+        invoicePayload: decodeText(action.payload),
         telegramPaymentChargeId: action.charge.id,
         providerPaymentChargeId: action.charge.provider_charge_id,
         shippingOptionId: action.shipping_option_id,

package/esm/types/2_user.d.ts

@@ -0,0 +1,73 @@
+/**
+ * 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 ChatPhoto } from "./0_chat_photo.js";
+import { type EmojiStatus } from "./0_emoji_status.js";
+import { type RestrictionReason } from "./0_restriction_reason.js";
+import { type UserStatus } from "./0_user_status.js";
+import type { ChatPPrivate } from "./1_chat_p.js";
+/** A user. */
+export interface User {
+    /** Unique identifier for this user or bot */
+    id: number;
+    /** Identifier of color that can be displayed instead of the user's photo. */
+    color: number;
+    /** Whether the user is a bot. */
+    isBot: boolean;
+    /** The first name of the user. */
+    firstName: string;
+    /** The last name of the user. */
+    lastName?: string;
+    /** The user’s main username. */
+    username?: string;
+    /** The user's phone number. */
+    phoneNumber?: string;
+    /** The user's additional usernames. */
+    also?: string[];
+    /** The user's status. */
+    status?: UserStatus;
+    /** The user's emoji status. */
+    emojiStatus?: EmojiStatus;
+    /** The user's profile photo. */
+    photo?: ChatPhoto;
+    /** The user's [IETF language tag](https://en.wikipedia.org/wiki/IETF_language_tag). */
+    languageCode?: string;
+    /** Whether the user has been identified as scam. */
+    isScam: boolean;
+    /** Whether the user has been identified as an impersonator. */
+    isFake: boolean;
+    /** Whether the user is subscribed to Telegram Premium. */
+    isPremium: boolean;
+    /** Whether the user has been verified. */
+    isVerified: boolean;
+    /** Whether the user is official support. */
+    isSupport: boolean;
+    /** Whether the user has been restricted. */
+    isRestricted: boolean;
+    /** The reason why the user has been restricted. */
+    restrictionReason?: RestrictionReason[];
+    /** Whether the user is a bot that has been added to the attachment menu by the current user. */
+    isAddedToAttachmentMenu?: boolean;
+    /** Whether the user is a bot that has a main mini app. */
+    hasMainMiniApp?: boolean;
+}
+export declare function constructUser(user_: Api.user): User;
+export declare function constructUser2(chatP: ChatPPrivate): User;
+//# sourceMappingURL=2_user.d.ts.map

package/esm/types/2_user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"2_user.d.ts","sourceRoot":"","sources":["../../src/types/2_user.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,EAAE,KAAK,SAAS,EAAsB,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAwB,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAA8B,KAAK,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC/F,OAAO,EAAuB,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,cAAc;AACd,MAAM,WAAW,IAAI;IACnB,6CAA6C;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,6EAA6E;IAC7E,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,KAAK,EAAE,OAAO,CAAC;IACf,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,yBAAyB;IACzB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,+BAA+B;IAC/B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,gCAAgC;IAChC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,uFAAuF;IACvF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,MAAM,EAAE,OAAO,CAAC;IAChB,+DAA+D;IAC/D,MAAM,EAAE,OAAO,CAAC;IAChB,0DAA0D;IAC1D,SAAS,EAAE,OAAO,CAAC;IACnB,0CAA0C;IAC1C,UAAU,EAAE,OAAO,CAAC;IACpB,4CAA4C;IAC5C,SAAS,EAAE,OAAO,CAAC;IACnB,4CAA4C;IAC5C,YAAY,EAAE,OAAO,CAAC;IACtB,mDAAmD;IACnD,iBAAiB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACxC,gGAAgG;IAChG,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,0DAA0D;IAC1D,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,GAAG,IAAI,CA+BnD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAyBxD"}

package/esm/types/2_user.js

@@ -0,0 +1,82 @@
+/**
+ * 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, getColorFromPeerId } from "../1_utilities.js";
+import { Api } from "../2_tl.js";
+import { constructChatPhoto } from "./0_chat_photo.js";
+import { constructEmojiStatus } from "./0_emoji_status.js";
+import { constructRestrictionReason } from "./0_restriction_reason.js";
+import { constructUserStatus } from "./0_user_status.js";
+export function constructUser(user_) {
+    const id = Number(user_.id);
+    const usernames = user_.usernames?.map((v) => v.username);
+    const username = user_.username ?? usernames?.shift();
+    const user = {
+        id,
+        color: Api.is("peerColor", user_.color) && user_.color.color !== undefined ? user_.color.color : getColorFromPeerId(id),
+        isBot: user_.bot || false,
+        firstName: user_.first_name || "",
+        lastName: user_.last_name,
+        username: username,
+        phoneNumber: user_.phone,
+        also: usernames?.filter((v) => v !== username),
+        status: user_.status ? constructUserStatus(user_.status) : undefined,
+        emojiStatus: user_.emoji_status ? constructEmojiStatus(user_.emoji_status) : undefined,
+        languageCode: user_.lang_code,
+        isScam: user_.scam || false,
+        isFake: user_.fake || false,
+        isPremium: user_.premium || false,
+        isVerified: user_.verified || false,
+        isSupport: user_.support || false,
+        isRestricted: user_.restricted || false,
+        restrictionReason: user_.restriction_reason?.map((v) => constructRestrictionReason(v)),
+        isAddedToAttachmentMenu: user_.bot ? user_.attach_menu_enabled || false : undefined,
+        hasMainMiniApp: user_.bot ? user_.bot_has_main_app || false : undefined,
+    };
+    if (Api.is("userProfilePhoto", user_.photo)) {
+        user.photo = constructChatPhoto(user_.photo, user.id, user_.access_hash ?? 0n);
+    }
+    return cleanObject(user);
+}
+export function constructUser2(chatP) {
+    const user = {
+        id: chatP.id,
+        color: chatP.color,
+        isBot: chatP.isBot,
+        firstName: chatP.firstName,
+        lastName: chatP.lastName,
+        username: chatP.username,
+        phoneNumber: chatP.phoneNumber,
+        also: chatP.also,
+        status: chatP.status,
+        emojiStatus: chatP.emojiStatus,
+        photo: chatP.photo,
+        languageCode: chatP.languageCode,
+        isScam: chatP.isScam,
+        isFake: chatP.isFake,
+        isPremium: chatP.isPremium,
+        isVerified: chatP.isVerified,
+        isSupport: chatP.isSupport,
+        isRestricted: chatP.isRestricted,
+        restrictionReason: chatP.restrictionReason,
+        isAddedToAttachmentMenu: chatP.isAddedToAttachmentMenu,
+        hasMainMiniApp: chatP.hasMainMiniApp,
+    };
+    return cleanObject(user);
+}

package/esm/types/3_business_connection.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 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 User } from "./2_user.js";
+/** A business connection. */
+export interface BusinessConnection {
+    /** The business connection's unique identifier. */
+    id: string;
+    /** The business account that the connection is made with. */
+    user: User;
+    /** The point in time in which the connection was recently updated. */
+    date: number;
+    /** Whether the bot can reply to older chats. */
+    canReply: boolean;
+    /** Whether the connection is active. */
+    isEnabled: boolean;
+}
+export declare function constructBusinessConnection(connection: Api.botBusinessConnection, getPeer: PeerGetter): BusinessConnection;
+//# sourceMappingURL=3_business_connection.d.ts.map

package/esm/types/3_business_connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"3_business_connection.d.ts","sourceRoot":"","sources":["../../src/types/3_business_connection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAkB,KAAK,IAAI,EAAE,MAAM,aAAa,CAAC;AAExD,6BAA6B;AAC7B,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,EAAE,EAAE,MAAM,CAAC;IACX,6DAA6D;IAC7D,IAAI,EAAE,IAAI,CAAC;IACX,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,QAAQ,EAAE,OAAO,CAAC;IAClB,wCAAwC;IACxC,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,GAAG,CAAC,qBAAqB,EAAE,OAAO,EAAE,UAAU,GAAG,kBAAkB,CAa1H"}

package/esm/types/3_business_connection.js

@@ -0,0 +1,36 @@
+/**
+ * MTKruto - Cross-runtime JavaScript library for building Telegram clients
+ * Copyright (C) 2023-2026 Roj <https://roj.im/>
+ *
+ * This file is part of MTKruto.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+import { unreachable } from "../0_deps.js";
+import { isChatPUser } from "./1_chat_p.js";
+import { constructUser2 } from "./2_user.js";
+export function constructBusinessConnection(connection, getPeer) {
+    const peer = getPeer({ ...connection, _: "peerUser" });
+    if (!peer || !isChatPUser(peer[0])) {
+        unreachable();
+    }
+    const user = constructUser2(peer[0]);
+    return {
+        id: connection.connection_id,
+        user,
+        date: connection.date,
+        canReply: !!connection.rights?.reply,
+        isEnabled: !connection.disabled,
+    };
+}

package/esm/types/3_chat_settings.d.ts

@@ -0,0 +1,47 @@
+/**
+ * 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 User } from "./2_user.js";
+/** A chat's settings. */
+export interface ChatSettings {
+    canReport: boolean;
+    canAddToContacts: boolean;
+    canBlock: boolean;
+    canShare: boolean;
+    isContactsException: boolean;
+    canReportLocation: boolean;
+    canUnarchive: boolean;
+    canInviteMembers: boolean;
+    channelJoinRequest: boolean;
+    isBusinessBotPaused: boolean;
+    businessBotCanReply: boolean;
+    distance?: number;
+    joinRequestChatTitle?: string;
+    joinRequestDate?: number;
+    businessBot?: User;
+    businessBotUrl?: string;
+    messagePrice?: number;
+    registrationMonth?: string;
+    phoneCountry?: string;
+    nameChangeDate?: number;
+    photoChangeDate?: number;
+}
+export declare function constructChatSettings(settings_: Api.messages_peerSettings): ChatSettings;
+//# sourceMappingURL=3_chat_settings.d.ts.map

package/esm/types/3_chat_settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"3_chat_settings.d.ts","sourceRoot":"","sources":["../../src/types/3_chat_settings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,EAAiB,KAAK,IAAI,EAAE,MAAM,aAAa,CAAC;AAEvD,yBAAyB;AACzB,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,YAAY,EAAE,OAAO,CAAC;IACtB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,GAAG,CAAC,qBAAqB,GAAG,YAAY,CA4BxF"}