@mtkruto/browser 0.6.1 → 0.119.0

package/esm/types/4_gift.d.ts

@@ -0,0 +1,100 @@
+/**
+ * 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 { GiftValue } from "./0_gift_value.js";
+import type { ChatP, PeerGetter } from "./1_chat_p.js";
+import { type Sticker } from "./1_sticker.js";
+import { type GiftUpgradedComponent } from "./3_gift_upgraded_component.js";
+/**
+ * An non-upgraded gift.
+ *
+ * @unlisted
+ */
+export interface GiftNonUpgraded {
+    /** @discriminator */
+    type: "nonupgraded";
+    /** The identifier of the gift. */
+    id: string;
+    /** The sticker that represents the gift. */
+    sticker: Sticker;
+    /** The price of the sticker in Telegram Stars. */
+    price: number;
+    /** Whether the supply of this gift is limited. */
+    isLimited: boolean;
+    /** The remaining supply of the gift if limited. */
+    remaining?: number;
+    /** The total supply of the gift if limited. */
+    total?: number;
+    /** Whether the gift is sold out if limited. */
+    soldOut?: boolean;
+    /** Whether the gift is dedicated to birthdays. */
+    isBirthday: boolean;
+    /** The amount of Telegram Stars that the gift can be swapped with. */
+    conversionPrice: number;
+    /** The date of the first sale of the gift if sold out. */
+    firstSaleDate?: number;
+    /** The date of the last sale of the gift if sold out. */
+    lastSaleDate?: number;
+    /** The amount of stars required to upgrade the gift. */
+    upgradePrice?: number;
+}
+/**
+ * An upgraded gift.
+ *
+ * @unlisted
+ */
+export interface GiftUpgraded {
+    /** @discriminator */
+    type: "upgraded";
+    /** The identifier of the gift. */
+    id: string;
+    /** The title of the gift. */
+    title: string;
+    /** The unique index of the gift among others of the same type. */
+    index: number;
+    /** The name of the user that owns the gift. */
+    ownerName?: string;
+    /** The address of the TON wallet that owns the gift. */
+    ownerAddress?: string;
+    /** The user or chat that owns the gift. */
+    owner?: ChatP;
+    /** The count of the amount of upgraded gifts of the same type. */
+    currentUpgrades: number;
+    /** The maximum count of gifts of the same type that can be upgraded. */
+    maxUpgrades: number;
+    /** The components of the gift. */
+    components: GiftUpgradedComponent[];
+    /** The address of the gift in TON blockchain. */
+    address?: string;
+    /** The amount of stars that can be used to buy the gift.  */
+    price?: number;
+    /** The amount of TON that can be used to buy the gift.  */
+    priceTon?: number;
+    /** Whether the gift can be bought only using TON. */
+    isTonOnly?: boolean;
+    /** The value of the gift. */
+    value?: GiftValue;
+}
+/** A gift. */
+export type Gift = GiftNonUpgraded | GiftUpgraded;
+export declare function constructGift(gift: Api.StarGift, getPeer: PeerGetter): Gift;
+export declare function constructGiftUpgraded(gift: Api.starGiftUnique, getPeer: PeerGetter): GiftUpgraded;
+export declare function constructGiftNonUpgraded(gift: Api.starGift): GiftNonUpgraded;
+//# sourceMappingURL=4_gift.d.ts.map

package/esm/types/4_gift.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"4_gift.d.ts","sourceRoot":"","sources":["../../src/types/4_gift.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAEjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAqB,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAkC,KAAK,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAE5G;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,qBAAqB;IACrB,IAAI,EAAE,aAAa,CAAC;IACpB,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,4CAA4C;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,SAAS,EAAE,OAAO,CAAC;IACnB,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kDAAkD;IAClD,UAAU,EAAE,OAAO,CAAC;IACpB,sEAAsE;IACtE,eAAe,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,qBAAqB;IACrB,IAAI,EAAE,UAAU,CAAC;IACjB,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,kEAAkE;IAClE,eAAe,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,UAAU,EAAE,qBAAqB,EAAE,CAAC;IACpC,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6BAA6B;IAC7B,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,cAAc;AACd,MAAM,MAAM,IAAI,GAAG,eAAe,GAAG,YAAY,CAAC;AAElD,wBAAgB,aAAa,CAAC,IAAI,EAAE,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI,CAM3E;AACD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,GAAG,CAAC,cAAc,EAAE,OAAO,EAAE,UAAU,GAAG,YAAY,CA0CjG;AACD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,GAAG,CAAC,QAAQ,GAAG,eAAe,CAqC5E"}

package/esm/types/4_gift.js

@@ -0,0 +1,112 @@
+/**
+ * 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 { FileType, serializeFileId, toUniqueFileId } from "./_file_id.js";
+import { constructSticker2 } from "./1_sticker.js";
+import { constructGiftUpgradedComponent } from "./3_gift_upgraded_component.js";
+export function constructGift(gift, getPeer) {
+    if (Api.is("starGiftUnique", gift)) {
+        return constructGiftUpgraded(gift, getPeer);
+    }
+    else {
+        return constructGiftNonUpgraded(gift);
+    }
+}
+export function constructGiftUpgraded(gift, getPeer) {
+    const id = String(gift.id);
+    const title = gift.title;
+    const index = gift.num;
+    let owner;
+    if (gift.owner_id) {
+        const peer = getPeer(gift.owner_id);
+        if (peer) {
+            owner = peer[0];
+        }
+    }
+    const starsAmount_ = gift.resell_amount?.find((v) => v._ === "starsAmount");
+    const starsTonAmount_ = gift.resell_amount?.find((v) => v._ === "starsTonAmount");
+    const ownerName = gift.owner_name;
+    const ownerAddress = gift.owner_address;
+    const currentUpgrades = gift.availability_issued;
+    const maxUpgrades = gift.availability_total;
+    const components = gift.attributes.map(constructGiftUpgradedComponent);
+    const address = gift.gift_address;
+    const price = starsAmount_ ? Number(starsAmount_.amount) : undefined;
+    const priceTon = starsTonAmount_ ? Number(starsTonAmount_.amount / 10000000n) / 100 : undefined;
+    const tonOnly = (price || priceTon) ? !!gift.resale_ton_only : undefined;
+    const value = gift.value_amount ? { amount: Number(gift.value_amount), currency: gift.value_currency ?? "" } : undefined;
+    return cleanObject({
+        type: "upgraded",
+        id,
+        title,
+        index,
+        ownerName,
+        ownerAddress,
+        owner,
+        currentUpgrades,
+        maxUpgrades,
+        components,
+        address,
+        price,
+        priceTon,
+        tonOnly,
+        value,
+    });
+}
+export function constructGiftNonUpgraded(gift) {
+    if (!Api.is("document", gift.sticker)) {
+        unreachable();
+    }
+    const id = String(gift.id);
+    const fileId = {
+        type: FileType.Sticker,
+        dcId: gift.sticker.dc_id,
+        fileReference: gift.sticker.file_reference,
+        location: { type: "common", id: gift.sticker.id, accessHash: gift.sticker.access_hash },
+    };
+    const sticker = constructSticker2(gift.sticker, serializeFileId(fileId), toUniqueFileId(fileId), undefined, "");
+    const price = Number(gift.stars);
+    const isLimited = !!gift.limited;
+    const isRemaining = isLimited ? gift.availability_remains ?? 0 : undefined;
+    const total = isLimited ? gift.availability_total ?? 0 : undefined;
+    const isSoldOut = isLimited ? !!gift.sold_out : undefined;
+    const isBirthday = !!gift.birthday;
+    const conversionPrice = Number(gift.convert_stars);
+    const firstSaleDate = isLimited ? gift.first_sale_date ? gift.first_sale_date : undefined : undefined;
+    const lastSaleDate = isLimited ? gift.last_sale_date ? gift.last_sale_date : undefined : undefined;
+    const upgradePrice = gift.upgrade_stars ? Number(gift.upgrade_stars) : undefined;
+    return cleanObject({
+        type: "nonupgraded",
+        id,
+        sticker,
+        price,
+        isLimited,
+        isRemaining,
+        total,
+        isSoldOut,
+        isBirthday,
+        conversionPrice,
+        firstSaleDate,
+        lastSaleDate,
+        upgradePrice,
+    });
+}

package/esm/types/4_join_request.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 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 { ChatP, PeerGetter } from "./1_chat_p.js";
+import { type User } from "./2_user.js";
+import { type InviteLink } from "./3_invite_link.js";
+/** A join request. */
+export interface JoinRequest {
+    /** The chat that the user requested to join. */
+    chat: ChatP;
+    /** The user who made the join request. */
+    from: User;
+    /** The point in time in which the join request was made. */
+    date: number;
+    /** The bio of the user who made the join request. Bot-only. */
+    bio?: string;
+    /** The invite link that the user used to make the join request. Bot-only. */
+    inviteLink?: InviteLink;
+}
+export declare function constructJoinRequest(update: Api.updateBotChatInviteRequester, getPeer: PeerGetter): JoinRequest;
+export declare function constructJoinRequest2(peer: Api.Peer, inviteImporter: Api.ChatInviteImporter, getPeer: PeerGetter): JoinRequest;
+//# sourceMappingURL=4_join_request.d.ts.map

package/esm/types/4_join_request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"4_join_request.d.ts","sourceRoot":"","sources":["../../src/types/4_join_request.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAkB,KAAK,IAAI,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAuB,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE1E,sBAAsB;AACtB,MAAM,WAAW,WAAW;IAC1B,gDAAgD;IAChD,IAAI,EAAE,KAAK,CAAC;IACZ,0CAA0C;IAC1C,IAAI,EAAE,IAAI,CAAC;IACX,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,GAAG,CAAC,4BAA4B,EAAE,OAAO,EAAE,UAAU,GAAG,WAAW,CAmB/G;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,CAAC,kBAAkB,EAAE,OAAO,EAAE,UAAU,GAAG,WAAW,CAiB9H"}

package/esm/types/4_join_request.js

@@ -0,0 +1,62 @@
+/**
+ * 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 { constructUser2 } from "./2_user.js";
+import { constructInviteLink } from "./3_invite_link.js";
+export function constructJoinRequest(update, getPeer) {
+    const peer = getPeer(update.peer);
+    if (!peer) {
+        unreachable();
+    }
+    const chat = peer[0];
+    const userPeer = getPeer({ _: "peerUser", user_id: update.user_id });
+    if (!userPeer) {
+        unreachable();
+    }
+    const from = constructUser2(userPeer[0]);
+    const inviteLink = update.invite && Api.is("chatInviteExported", update.invite) ? constructInviteLink(update.invite, getPeer) : undefined;
+    return cleanObject({
+        chat,
+        from,
+        date: update.date,
+        bio: update.about,
+        inviteLink,
+    });
+}
+export function constructJoinRequest2(peer, inviteImporter, getPeer) {
+    const peer_ = getPeer(peer);
+    if (!peer_) {
+        unreachable();
+    }
+    const chat = peer_[0];
+    const userPeer = getPeer({ _: "peerUser", user_id: inviteImporter.user_id });
+    if (!userPeer) {
+        unreachable();
+    }
+    const from = constructUser2(userPeer[0]);
+    return cleanObject({
+        chat,
+        from,
+        date: inviteImporter.date,
+        bio: inviteImporter.about,
+    });
+}

package/esm/types/4_poll.d.ts

@@ -0,0 +1,55 @@
+/**
+ * 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 MessageEntity } from "./2_message_entity.js";
+import { type PollOption } from "./3_poll_option.js";
+/** A poll. */
+export interface Poll {
+    /** The identifier of the poll. */
+    id: string;
+    /** The poll's question. */
+    question: string;
+    /** The entities of the poll's question. */
+    questionEntities: MessageEntity[];
+    /** The poll's options. */
+    options: PollOption[];
+    /** The number of users who have participated in the poll. */
+    totalVoterCount: number;
+    /** Whether the poll is closed. */
+    isClosed: boolean;
+    /** Whether the poll is anonymous. */
+    isAnonymous: boolean;
+    /** The type of the poll. */
+    type: "regular" | "quiz";
+    /** Whether the poll allows multiple answers. */
+    allowMultipleAnswers?: boolean;
+    /** Index of the correct option. */
+    correctOptionIndex?: number;
+    /** A text that is shown to the user when the poll is answered. */
+    explanation?: string;
+    /** The explanation's entities. */
+    explanationEntities?: MessageEntity[];
+    /** Duration of the poll in seconds. */
+    openPeriod?: number;
+    /** The time in which the poll will be closed. */
+    closeDate?: number;
+}
+export declare function constructPoll(media_: Api.messageMediaPoll): Poll;
+//# sourceMappingURL=4_poll.d.ts.map

package/esm/types/4_poll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"4_poll.d.ts","sourceRoot":"","sources":["../../src/types/4_poll.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAA0B,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,EAAuB,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE1E,cAAc;AACd,MAAM,WAAW,IAAI;IACnB,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,gBAAgB,EAAE,aAAa,EAAE,CAAC;IAClC,0BAA0B;IAC1B,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,6DAA6D;IAC7D,eAAe,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,QAAQ,EAAE,OAAO,CAAC;IAClB,qCAAqC;IACrC,WAAW,EAAE,OAAO,CAAC;IACrB,4BAA4B;IAC5B,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC;IACzB,gDAAgD;IAChD,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,mCAAmC;IACnC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,mBAAmB,CAAC,EAAE,aAAa,EAAE,CAAC;IACtC,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,GAAG,CAAC,gBAAgB,GAAG,IAAI,CAoBhE"}

package/esm/types/4_poll.js

@@ -0,0 +1,43 @@
+/**
+ * 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 { constructMessageEntity } from "./2_message_entity.js";
+import { constructPollOption } from "./3_poll_option.js";
+export function constructPoll(media_) {
+    const poll = media_.poll;
+    const correctOption = media_.results.results?.find((v) => v.correct)?.option;
+    const correctOptionIndex = correctOption !== undefined ? poll.answers.findIndex((v) => v.option.every((v, i) => correctOption[i] === v)) : undefined;
+    return cleanObject({
+        id: String(poll.id),
+        question: poll.question.text,
+        questionEntities: poll.question.entities.map(constructMessageEntity).filter((v) => v !== null),
+        options: poll.answers.map((v) => constructPollOption(v, media_.results.results ?? [])),
+        totalVoterCount: media_.results.total_voters ?? 0,
+        isClosed: poll.closed || false,
+        isAnonymous: !poll.public_voters,
+        type: poll.quiz ? "quiz" : "regular",
+        allowMultipleAnswers: poll.quiz ? undefined : poll.multiple_choice || false,
+        correctOptionIndex,
+        explanation: media_.results.solution,
+        explanationEntities: media_.results.solution_entities?.map(constructMessageEntity).filter((v) => v !== null),
+        openPeriod: poll.close_period,
+        closeDate: poll.close_date,
+    });
+}

package/esm/types/4_reply_to.d.ts

@@ -0,0 +1,51 @@
+/**
+ * MTKruto - Cross-runtime JavaScript library for building Telegram clients
+ * Copyright (C) 2023-2026 Roj <https://roj.im/>
+ *
+ * This file is part of MTKruto.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+import type { ID } from "./0_id.js";
+import type { ReplyQuote } from "./3_reply_quote.js";
+/**
+ * Information on a message that another message is replying to.
+ * @unlisted */
+export interface ReplyToMessage {
+    /**
+     * The identifier of the message that is being replied to.
+     * @discriminator
+     */
+    messageId: number;
+    /**
+     * A quoted part of the message that is being replied to.
+     */
+    quote?: ReplyQuote;
+}
+/**
+ * Information on a story that a message is replying to.
+ * @unlisted
+ */
+export interface ReplyToStory {
+    /** The identifier of the chat that posted the story. */
+    chatId: ID;
+    /**
+     * The identifier of the story that is being replied to.
+     * @discriminator
+     */
+    storyId: number;
+}
+/** Information on what a message is replying to. */
+export type ReplyTo = ReplyToMessage | ReplyToStory;
+//# sourceMappingURL=4_reply_to.d.ts.map

package/esm/types/4_reply_to.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"4_reply_to.d.ts","sourceRoot":"","sources":["../../src/types/4_reply_to.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD;;eAEe;AACf,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,wDAAwD;IACxD,MAAM,EAAE,EAAE,CAAC;IACX;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,oDAAoD;AACpD,MAAM,MAAM,OAAO,GAAG,cAAc,GAAG,YAAY,CAAC"}

package/esm/types/4_reply_to.js

@@ -0,0 +1,20 @@
+/**
+ * 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 {};

package/esm/types/5_claimed_gift.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 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, type PeerGetter } from "./1_chat_p.js";
+import { type MessageEntity } from "./2_message_entity.js";
+import { type Gift } from "./4_gift.js";
+/** A gift claimed by a user or a channel. */
+export interface ClaimedGift {
+    /** The time when the gift was claimed. */
+    date: number;
+    /** The gift. */
+    gift: Gift;
+    /** Whether the gift is publicly visible. */
+    isPublic: boolean;
+    /** The sender of the gift. */
+    sender?: ChatP;
+    /** A message shared when the gift was sent. */
+    message?: string;
+    /** The entities of the message. */
+    entities?: MessageEntity[];
+    /** The identifier of the service message announcing the receival of the gift. */
+    messageId?: number;
+    /** The amount of stars the gift would be worth. */
+    conversionStars?: number;
+}
+export declare function constructClaimedGift(savedStarGift: Api.SavedStarGift, fromPeer: Api.User | Api.Chat | undefined, getPeer: PeerGetter): ClaimedGift;
+//# sourceMappingURL=5_claimed_gift.d.ts.map

package/esm/types/5_claimed_gift.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"5_claimed_gift.d.ts","sourceRoot":"","sources":["../../src/types/5_claimed_gift.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,KAAK,KAAK,EAAkB,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAA0B,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,EAAiB,KAAK,IAAI,EAAE,MAAM,aAAa,CAAC;AAEvD,6CAA6C;AAC7C,MAAM,WAAW,WAAW;IAC1B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB;IAChB,IAAI,EAAE,IAAI,CAAC;IACX,4CAA4C;IAC5C,QAAQ,EAAE,OAAO,CAAC;IAClB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,GAAG,CAAC,aAAa,EAAE,QAAQ,EAAE,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,SAAS,EAAE,OAAO,EAAE,UAAU,GAAG,WAAW,CAmBlJ"}

package/esm/types/5_claimed_gift.js

@@ -0,0 +1,43 @@
+/**
+ * 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 { constructChatP } from "./1_chat_p.js";
+import { constructMessageEntity } from "./2_message_entity.js";
+import { constructGift } from "./4_gift.js";
+export function constructClaimedGift(savedStarGift, fromPeer, getPeer) {
+    const gift = constructGift(savedStarGift.gift, getPeer);
+    const date = savedStarGift.date;
+    const isPublic = !!savedStarGift.unsaved;
+    const sender = fromPeer ? constructChatP(fromPeer) : undefined;
+    const message = savedStarGift.message?.text;
+    const entities = savedStarGift.message ? savedStarGift.message.entities.map(constructMessageEntity).filter((v) => !!v) : undefined;
+    const messageId = savedStarGift.msg_id;
+    const conversionStars = savedStarGift.convert_stars ? Number(savedStarGift.convert_stars) : undefined;
+    return cleanObject({
+        date,
+        gift,
+        isPublic,
+        sender,
+        message,
+        entities,
+        messageId,
+        conversionStars,
+    });
+}

package/esm/types/5_gift_non_upgraded_information.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 { ChatP, PeerGetter } from "./1_chat_p.js";
+import { type MessageEntity } from "./2_message_entity.js";
+import { type GiftNonUpgraded } from "./4_gift.js";
+/** Information on a non-upgraded gift. */
+export interface GiftNonUpgradedInformation {
+    isNameHidden: boolean;
+    isSaved: boolean;
+    isConverted: boolean;
+    isUpgraded: boolean;
+    isRefunded: boolean;
+    isUpgradable: boolean;
+    isPrepaidUpgrade: boolean;
+    isUpgradedSeparately: boolean;
+    gift: GiftNonUpgraded;
+    message?: string;
+    messageEntities?: MessageEntity[];
+    conversionPrice?: number;
+    upgradeMessageId?: number;
+    upgradePrice?: number;
+    from?: ChatP;
+    to?: ChatP;
+    inputId?: string;
+    prepaidUpgradeHash?: string;
+    giftMessageId?: number;
+}
+export declare function constructGiftNonUpgradedInformation(action: Api.messageActionStarGift, getPeer: PeerGetter): GiftNonUpgradedInformation;
+//# sourceMappingURL=5_gift_non_upgraded_information.d.ts.map

package/esm/types/5_gift_non_upgraded_information.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"5_gift_non_upgraded_information.d.ts","sourceRoot":"","sources":["../../src/types/5_gift_non_upgraded_information.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAA0B,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,EAA4B,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAE7E,0CAA0C;AAC1C,MAAM,WAAW,0BAA0B;IACzC,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,aAAa,EAAE,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,EAAE,CAAC,EAAE,KAAK,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,mCAAmC,CAAC,MAAM,EAAE,GAAG,CAAC,qBAAqB,EAAE,OAAO,EAAE,UAAU,GAAG,0BAA0B,CA8CtI"}