@mtkruto/node 0.68.0 → 0.70.0

package/esm/types/3_poll_option.js

@@ -0,0 +1,29 @@
+/**
+ * MTKruto - Cross-runtime JavaScript library for building Telegram clients
+ * Copyright (C) 2023-2025 Roj <https://roj.im/>
+ *
+ * This file is part of MTKruto.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+import { constructMessageEntity } from "./2_message_entity.js";
+export function constructPollOption(option, results) {
+    const result = results.find((v) => v.option.every((v, i) => option.option[i] === v));
+    return {
+        text: option.text.text,
+        entities: option.text.entities?.map(constructMessageEntity).filter((v) => v !== null),
+        voterCount: result?.voters ?? 0,
+        chosen: result?.chosen ?? false,
+    };
+}

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

@@ -0,0 +1,34 @@
+/**
+ * MTKruto - Cross-runtime JavaScript library for building Telegram clients
+ * Copyright (C) 2023-2025 Roj <https://roj.im/>
+ *
+ * This file is part of MTKruto.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+import type { Api } from "../2_tl.js";
+import type { PeerGetter } from "./1_chat_p.js";
+import { type OrderInfo } from "./1_order_info.js";
+import { type User } from "./2_user.js";
+export interface PreCheckoutQuery {
+    id: string;
+    from: User;
+    currency: string;
+    totalAmount: number;
+    invoicePayload: string;
+    shippingOptionId?: string;
+    orderInfo?: OrderInfo;
+}
+export declare function constructPreCheckoutQuery(query: Api.updateBotPrecheckoutQuery, getPeer: PeerGetter): PreCheckoutQuery;
+//# sourceMappingURL=3_pre_checkout_query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"3_pre_checkout_query.d.ts","sourceRoot":"","sources":["../../src/types/3_pre_checkout_query.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAkB,KAAK,IAAI,EAAE,MAAM,aAAa,CAAC;AAExD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,GAAG,CAAC,yBAAyB,EAAE,OAAO,EAAE,UAAU,GAAG,gBAAgB,CAerH"}

package/esm/types/3_pre_checkout_query.js

@@ -0,0 +1,39 @@
+/**
+ * MTKruto - Cross-runtime JavaScript library for building Telegram clients
+ * Copyright (C) 2023-2025 Roj <https://roj.im/>
+ *
+ * This file is part of MTKruto.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+import { unreachable } from "../0_deps.js";
+import { cleanObject, decodeText } from "../1_utilities.js";
+import { constructOrderInfo } from "./1_order_info.js";
+import { constructUser2 } from "./2_user.js";
+export function constructPreCheckoutQuery(query, getPeer) {
+    const peer = getPeer({ _: "peerUser", user_id: query.user_id });
+    if (!peer) {
+        unreachable();
+    }
+    const from = constructUser2(peer[0]);
+    return cleanObject({
+        id: String(query.query_id),
+        from,
+        currency: query.currency,
+        totalAmount: Number(query.total_amount),
+        invoicePayload: decodeText(query.payload),
+        shippingOptionId: query.shipping_option_id,
+        orderInfo: query.info ? constructOrderInfo(query.info) : undefined,
+    });
+}

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

@@ -0,0 +1,32 @@
+/**
+ * MTKruto - Cross-runtime JavaScript library for building Telegram clients
+ * Copyright (C) 2023-2025 Roj <https://roj.im/>
+ *
+ * This file is part of MTKruto.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+import type { Api } from "../2_tl.js";
+import { type MessageEntity } from "./2_message_entity.js";
+/** A reference to a specific part of a message that is being replied to. */
+export interface ReplyQuote {
+    /** The byte offset of the quoted text. */
+    offset: number;
+    /** The quoted text. */
+    text: string;
+    /** The entities of the quoted text. */
+    entities: MessageEntity[];
+}
+export declare function constructReplyQuote(quoteText: string | undefined, quoteOffset: number | undefined, quoteEntities: Api.MessageEntity[] | undefined): ReplyQuote;
+//# sourceMappingURL=3_reply_quote.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"3_reply_quote.d.ts","sourceRoot":"","sources":["../../src/types/3_reply_quote.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAA0B,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEnF,4EAA4E;AAC5E,MAAM,WAAW,UAAU;IACzB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,aAAa,EAAE,GAAG,CAAC,aAAa,EAAE,GAAG,SAAS,GAAG,UAAU,CAS9J"}

package/esm/types/3_reply_quote.js

@@ -0,0 +1,30 @@
+/**
+ * MTKruto - Cross-runtime JavaScript library for building Telegram clients
+ * Copyright (C) 2023-2025 Roj <https://roj.im/>
+ *
+ * This file is part of MTKruto.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+import { constructMessageEntity } from "./2_message_entity.js";
+export function constructReplyQuote(quoteText, quoteOffset, quoteEntities) {
+    quoteText ??= "";
+    quoteOffset ??= 0;
+    quoteEntities ??= [];
+    return {
+        offset: quoteOffset,
+        text: quoteText,
+        entities: quoteEntities.map(constructMessageEntity).filter((v) => !!v),
+    };
+}

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

@@ -17,14 +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 { Api } from "../2_tl.js";
-import { EntityGetter } from "./_getters.js";
-import { MessageEntity } from "./0_message_entity.js";
-import { ChatP } from "./1_chat_p.js";
-import { StoryPrivacy } from "./1_story_privacy.js";
-import { StoryContent } from "./2_story_content.js";
-import { StoryInteractions } from "./2_story_interactions.js";
-import { StoryInteractiveArea } from "./2_story_interactive_area.js";
+import type { Api } from "../2_tl.js";
+import type { ChatP, PeerGetter } from "./1_chat_p.js";
+import { type MessageEntity } from "./2_message_entity.js";
+import { type StoryContent } from "./2_story_content.js";
+import { type StoryInteractions } from "./2_story_interactions.js";
+import { type StoryInteractiveArea } from "./2_story_interactive_area.js";
+import { type StoryPrivacy } from "./2_story_privacy.js";
 /** A story. */
 export interface Story {
     out: boolean;
@@ -40,5 +39,5 @@ export interface Story {
     caption?: string;
     captionEntities?: MessageEntity[];
 }
-export declare function constructStory(story: Api.storyItem, peer: Api.peerUser | Api.peerChat | Api.peerChannel, getEntity: EntityGetter): Promise<Story>;
+export declare function constructStory(story: Api.storyItem, peer: Api.peerUser | Api.peerChat | Api.peerChannel, getPeer: PeerGetter): Story;
 //# sourceMappingURL=3_story.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"3_story.d.ts","sourceRoot":"","sources":["../../src/types/3_story.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAA0B,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,KAAK,EAAkB,MAAM,eAAe,CAAC;AACtD,OAAO,EAAyB,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAyB,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAA8B,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC1F,OAAO,EAAiC,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAEpG,eAAe;AACf,MAAM,WAAW,KAAK;IACpB,GAAG,EAAE,OAAO,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,KAAK,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,YAAY,CAAC;IACtB,gBAAgB,EAAE,oBAAoB,EAAE,CAAC;IACzC,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,aAAa,EAAE,CAAC;CACnC;AAED,wBAAsB,cAAc,CAAC,KAAK,EAAE,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAE,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,CA8BvJ"}
+{"version":3,"file":"3_story.d.ts","sourceRoot":"","sources":["../../src/types/3_story.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAA0B,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,EAAyB,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAA8B,KAAK,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC/F,OAAO,EAAiC,KAAK,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACzG,OAAO,EAAyB,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEhF,eAAe;AACf,MAAM,WAAW,KAAK;IACpB,GAAG,EAAE,OAAO,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,KAAK,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,YAAY,CAAC;IACtB,gBAAgB,EAAE,oBAAoB,EAAE,CAAC;IACzC,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,aAAa,EAAE,CAAC;CACnC;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAE,OAAO,EAAE,UAAU,GAAG,KAAK,CA8BpI"}

package/esm/types/3_story.js

@@ -19,19 +19,18 @@
  */
 import { unreachable } from "../0_deps.js";
 import { cleanObject } from "../1_utilities.js";
-import { constructMessageEntity } from "./0_message_entity.js";
-import { constructChatP } from "./1_chat_p.js";
-import { constructStoryPrivacy } from "./1_story_privacy.js";
+import { constructMessageEntity } from "./2_message_entity.js";
 import { constructStoryContent } from "./2_story_content.js";
 import { constructStoryInteractions } from "./2_story_interactions.js";
 import { constructStoryInteractiveArea } from "./2_story_interactive_area.js";
-export async function constructStory(story, peer, getEntity) {
+import { constructStoryPrivacy } from "./2_story_privacy.js";
+export function constructStory(story, peer, getPeer) {
     const id = story.id;
-    const entity = await getEntity(peer);
-    if (!entity) {
+    const peer_ = getPeer(peer);
+    if (!peer_) {
         unreachable();
     }
-    const chat = constructChatP(entity);
+    const chat = peer_[0];
     const date = story.date;
     const interactiveAreas = (story.media_areas ?? []).map(constructStoryInteractiveArea);
     const highlighted = story.pinned ? true : false;

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

@@ -0,0 +1,43 @@
+/**
+ * MTKruto - Cross-runtime JavaScript library for building Telegram clients
+ * Copyright (C) 2023-2025 Roj <https://roj.im/>
+ *
+ * This file is part of MTKruto.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+import { Api } from "../2_tl.js";
+import type { ChatP, PeerGetter } from "./1_chat_p.js";
+import { type User } from "./2_user.js";
+import { type ChatMember } from "./3_chat_member.js";
+import { type InviteLink } from "./3_invite_link.js";
+/** Changes made to a chat member. */
+export interface ChatMemberUpdated {
+    /** The chat in which the change was made. */
+    chat: ChatP;
+    /** The one who made the change. */
+    from: User;
+    /** The point in time in which the chat member's status was changed. */
+    date: number;
+    /** The old status of the chat member. */
+    oldChatMember: ChatMember;
+    /** The new status of the chat member. */
+    newChatMember: ChatMember;
+    /** The invite link used to join. */
+    inviteLink?: InviteLink;
+    /** Whether the user joined from a shared folder. */
+    viaSharedFolder?: boolean;
+}
+export declare function constructChatMemberUpdated(update: Api.updateChannelParticipant | Api.updateChatParticipant, getPeer: PeerGetter): ChatMemberUpdated;
+//# sourceMappingURL=4_chat_member_updated.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"4_chat_member_updated.d.ts","sourceRoot":"","sources":["../../src/types/4_chat_member_updated.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,EAAE,KAAK,UAAU,EAAuB,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAuB,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE1E,qCAAqC;AACrC,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,IAAI,EAAE,KAAK,CAAC;IACZ,mCAAmC;IACnC,IAAI,EAAE,IAAI,CAAC;IACX,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,aAAa,EAAE,UAAU,CAAC;IAC1B,yCAAyC;IACzC,aAAa,EAAE,UAAU,CAAC;IAC1B,oCAAoC;IACpC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,oDAAoD;IACpD,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,GAAG,CAAC,wBAAwB,GAAG,GAAG,CAAC,qBAAqB,EAAE,OAAO,EAAE,UAAU,GAAG,iBAAiB,CA0BnJ"}

package/esm/types/4_chat_member_updated.js

@@ -0,0 +1,52 @@
+/**
+ * MTKruto - Cross-runtime JavaScript library for building Telegram clients
+ * Copyright (C) 2023-2025 Roj <https://roj.im/>
+ *
+ * This file is part of MTKruto.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+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 { constructChatMember } from "./3_chat_member.js";
+import { constructInviteLink } from "./3_invite_link.js";
+export function constructChatMemberUpdated(update, getPeer) {
+    if (!update.prev_participant && !update.new_participant) {
+        unreachable();
+    }
+    const peer = getPeer("channel_id" in update ? { channel_id: update.channel_id, _: "peerChannel" } : { chat_id: update.chat_id, _: "peerChat" });
+    const userPeer = getPeer({ _: "peerUser", user_id: update.actor_id });
+    if (!peer || !userPeer) {
+        unreachable();
+    }
+    const chat = peer[0];
+    const from = constructUser2(userPeer[0]);
+    const date = update.date;
+    // TODO
+    const oldChatMember = constructChatMember(update.prev_participant ?? ({ _: "channelParticipantLeft", peer: userPeer }), getPeer);
+    const newChatMember = constructChatMember(update.new_participant ?? ({ _: "channelParticipantLeft", peer: userPeer }), getPeer);
+    const viaSharedFolder = "via_chatlist" in update ? update.via_chatlist ? true : update.invite ? false : undefined : undefined;
+    const inviteLink = (update.invite && Api.is("chatInviteExported", update.invite)) ? constructInviteLink(update.invite, getPeer) : undefined;
+    return cleanObject({
+        chat,
+        from,
+        date,
+        oldChatMember,
+        newChatMember,
+        viaSharedFolder,
+        inviteLink,
+    });
+}

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

@@ -0,0 +1,94 @@
+/**
+ * MTKruto - Cross-runtime JavaScript library for building Telegram clients
+ * Copyright (C) 2023-2025 Roj <https://roj.im/>
+ *
+ * This file is part of MTKruto.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+import { Api } from "../2_tl.js";
+import type { PeerGetter } from "./1_chat_p.js";
+import { type Sticker } from "./1_sticker.js";
+import { type User } from "./2_user.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. */
+    limited: 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. */
+    birthday: 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 that owns the gift. */
+    owner?: User;
+    /** 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;
+}
+/** 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): Gift;
+//# 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,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAqB,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAiB,KAAK,IAAI,EAAE,MAAM,aAAa,CAAC;AACvD,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,OAAO,EAAE,OAAO,CAAC;IACjB,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,QAAQ,EAAE,OAAO,CAAC;IAClB,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,mCAAmC;IACnC,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,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;CAChB;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,CAgCjG;AACD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,GAAG,CAAC,QAAQ,GAAG,IAAI,CAqCjE"}

package/esm/types/4_gift.js

@@ -0,0 +1,105 @@
+/**
+ * MTKruto - Cross-runtime JavaScript library for building Telegram clients
+ * Copyright (C) 2023-2025 Roj <https://roj.im/>
+ *
+ * This file is part of MTKruto.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+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 { constructUser } from "./2_user.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 entity = getPeer(gift.owner_id);
+        if (Api.is("user", entity)) {
+            owner = constructUser(entity);
+        }
+    }
+    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 = gift.resell_amount !== undefined ? Number(gift.resell_amount) : undefined;
+    return cleanObject({
+        type: "upgraded",
+        id,
+        title,
+        index,
+        ownerName,
+        ownerAddress,
+        owner,
+        currentUpgrades,
+        maxUpgrades,
+        components,
+        address,
+        price,
+    });
+}
+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 limited = !!gift.limited;
+    const remaining = limited ? gift.availability_remains ?? 0 : undefined;
+    const total = limited ? gift.availability_total ?? 0 : undefined;
+    const soldOut = limited ? !!gift.sold_out : undefined;
+    const birthday = !!gift.birthday;
+    const conversionPrice = Number(gift.convert_stars);
+    const firstSaleDate = limited ? gift.first_sale_date ? gift.first_sale_date : undefined : undefined;
+    const lastSaleDate = limited ? 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,
+        limited,
+        remaining,
+        total,
+        soldOut,
+        birthday,
+        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-2025 Roj <https://roj.im/>
+ *
+ * This file is part of MTKruto.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+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-2025 Roj <https://roj.im/>
+ *
+ * This file is part of MTKruto.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+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,
+    });
+}