@mtkruto/node 0.14.0 → 0.15.0

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

@@ -0,0 +1,95 @@
+/**
+ * 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 { MessageEntity } from "./0_message_entity.js";
+import { Sticker } from "./1_sticker.js";
+/**
+ * The model of an upgraded gift.
+ *
+ * @unlisted
+ */
+export interface GiftUpgradedComponentModel {
+    /** @discriminator */
+    type: "model";
+    /** The name of the model. */
+    name: string;
+    /** The sticker belonging to the model. */
+    sticker: Sticker;
+    /** A number determining how rare this type of model is out of a thousand of others. */
+    rarityLevel: number;
+}
+/**
+ * The pattern of an upgraded gift.
+ *
+ * @unlisted
+ */
+export interface GiftUpgradedComponentPattern {
+    /** @discriminator */
+    type: "pattern";
+    /** The name of the pattern. */
+    name: string;
+    /** The sticker belonging to the pattern. */
+    sticker: Sticker;
+    /** A number determining how rare this type of pattern is out of a thousand of others. */
+    rarityLevel: number;
+}
+/**
+ * The backdrop of an upgraded gift.
+ *
+ * @unlisted
+ */
+export interface GiftUpgradedComponentBackdrop {
+    /** @discriminator */
+    type: "backdrop";
+    /** The name of the backdrop. */
+    name: string;
+    /** The center color of the backdrop. */
+    centerColor: number;
+    /** The edge color of the backdrop. */
+    edgeColor: number;
+    /** The pattern color of the backdrop. */
+    patternColor: number;
+    /** The text color of the backdrop. */
+    textColor: number;
+    /** A number determining how rare this type of backdrop is out of a thousand of others. */
+    rarityLevel: number;
+}
+/**
+ * The original details of an upgraded gift.
+ *
+ * @unlisted
+ */
+export interface GiftUpgradedComponentOriginalDetails {
+    /** @discriminator */
+    type: "originalDetails";
+    senderId?: number;
+    recipientId: number;
+    date: Date;
+    message?: string;
+    entities?: MessageEntity[];
+}
+/**
+ * A component of an upgraded gift.
+ *
+ * @unlisted
+ */
+export type GiftUpgradedComponent = GiftUpgradedComponentModel | GiftUpgradedComponentPattern | GiftUpgradedComponentBackdrop | GiftUpgradedComponentOriginalDetails;
+export declare function constructGiftUpgradedComponent(attribute: Api.StarGiftAttribute): GiftUpgradedComponent;
+//# sourceMappingURL=2_gift_upgraded_component.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"2_gift_upgraded_component.d.ts","sourceRoot":"","sources":["../../src/types/2_gift_upgraded_component.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,EAAE,GAAG,EAAM,MAAM,YAAY,CAAC;AAErC,OAAO,EAA0B,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAqB,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE5D;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,qBAAqB;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,uFAAuF;IACvF,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C,qBAAqB;IACrB,IAAI,EAAE,SAAS,CAAC;IAChB,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,yFAAyF;IACzF,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,6BAA6B;IAC5C,qBAAqB;IACrB,IAAI,EAAE,UAAU,CAAC;IACjB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,0FAA0F;IAC1F,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,oCAAoC;IACnD,qBAAqB;IACrB,IAAI,EAAE,iBAAiB,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,0BAA0B,GAAG,4BAA4B,GAAG,6BAA6B,GAAG,oCAAoC,CAAC;AAErK,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,GAAG,CAAC,iBAAiB,GAAG,qBAAqB,CA+DtG"}

package/esm/types/2_gift_upgraded_component.js

@@ -0,0 +1,88 @@
+/**
+ * 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, fromUnixTimestamp } from "../1_utilities.js";
+import { is } from "../2_tl.js";
+import { FileType, serializeFileId, toUniqueFileId } from "./_file_id.js";
+import { constructMessageEntity } from "./0_message_entity.js";
+import { constructSticker2 } from "./1_sticker.js";
+export function constructGiftUpgradedComponent(attribute) {
+    const name = "name" in attribute ? attribute.name : "";
+    const rarityLevel = "rarity_permille" in attribute ? attribute.rarity_permille : 0;
+    switch (attribute._) {
+        case "starGiftAttributeModel": {
+            if (!is("document", attribute.document)) {
+                unreachable();
+            }
+            const fileId = {
+                type: FileType.Sticker,
+                dcId: attribute.document.dc_id,
+                fileReference: attribute.document.file_reference,
+                location: { type: "common", id: attribute.document.id, accessHash: attribute.document.access_hash },
+            };
+            const sticker = constructSticker2(attribute.document, serializeFileId(fileId), toUniqueFileId(fileId), undefined, "");
+            return {
+                type: "model",
+                name,
+                sticker,
+                rarityLevel,
+            };
+        }
+        case "starGiftAttributePattern": {
+            if (!is("document", attribute.document)) {
+                unreachable();
+            }
+            const fileId = {
+                type: FileType.Sticker,
+                dcId: attribute.document.dc_id,
+                fileReference: attribute.document.file_reference,
+                location: { type: "common", id: attribute.document.id, accessHash: attribute.document.access_hash },
+            };
+            const sticker = constructSticker2(attribute.document, serializeFileId(fileId), toUniqueFileId(fileId), undefined, "");
+            return {
+                type: "pattern",
+                name,
+                sticker,
+                rarityLevel,
+            };
+        }
+        case "starGiftAttributeBackdrop":
+            return {
+                type: "backdrop",
+                name,
+                centerColor: attribute.center_color,
+                edgeColor: attribute.edge_color,
+                patternColor: attribute.pattern_color,
+                textColor: attribute.text_color,
+                rarityLevel,
+            };
+        case "starGiftAttributeOriginalDetails":
+            return cleanObject({
+                type: "originalDetails",
+                senderId: attribute.sender_id ? Number(attribute.sender_id) : undefined,
+                recipientId: Number(attribute.recipient_id),
+                date: fromUnixTimestamp(attribute.date),
+                message: attribute.message?.text,
+                entities: attribute.message ? attribute.message.entities.map(constructMessageEntity).filter((v) => !!v) : undefined,
+            });
+        default:
+            unreachable();
+    }
+}

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

@@ -0,0 +1,82 @@
+/**
+ * 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 { Sticker } from "./1_sticker.js";
+import { GiftUpgradedComponent } from "./2_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?: Date;
+    /** The date of the last sale of the gift if sold out. */
+    lastSaleDate?: Date;
+}
+/**
+ * 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 identifier of the user that owns the gift. */
+    ownerId: number;
+    /** 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[];
+}
+/** A gift. */
+export type Gift = GiftNonUpgraded | GiftUpgraded;
+export declare function constructGift(gift: Api.StarGift): Gift;
+export declare function constructGiftUpgraded(gift: Api.starGiftUnique): GiftUpgraded;
+export declare function constructGiftNonUpgraded(gift: Api.starGift): Gift;
+//# sourceMappingURL=3_gift.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"3_gift.d.ts","sourceRoot":"","sources":["../../src/types/3_gift.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,EAAE,GAAG,EAAM,MAAM,YAAY,CAAC;AAErC,OAAO,EAAqB,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAkC,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAEvG;;;;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,IAAI,CAAC;IACrB,yDAAyD;IACzD,YAAY,CAAC,EAAE,IAAI,CAAC;CACrB;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,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,eAAe,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,UAAU,EAAE,qBAAqB,EAAE,CAAC;CACrC;AAED,cAAc;AACd,MAAM,MAAM,IAAI,GAAG,eAAe,GAAG,YAAY,CAAC;AAElD,wBAAgB,aAAa,CAAC,IAAI,EAAE,GAAG,CAAC,QAAQ,GAAG,IAAI,CAMtD;AACD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,GAAG,CAAC,cAAc,GAAG,YAAY,CAkB5E;AACD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,GAAG,CAAC,QAAQ,GAAG,IAAI,CAmCjE"}

package/esm/types/3_gift.js

@@ -0,0 +1,88 @@
+/**
+ * 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, fromUnixTimestamp } from "../1_utilities.js";
+import { is } from "../2_tl.js";
+import { FileType, serializeFileId, toUniqueFileId } from "./_file_id.js";
+import { constructSticker2 } from "./1_sticker.js";
+import { constructGiftUpgradedComponent } from "./2_gift_upgraded_component.js";
+export function constructGift(gift) {
+    if (is("starGiftUnique", gift)) {
+        return constructGiftUpgraded(gift);
+    }
+    else {
+        return constructGiftNonUpgraded(gift);
+    }
+}
+export function constructGiftUpgraded(gift) {
+    const id = String(gift.id);
+    const title = gift.title;
+    const index = gift.num;
+    const ownerId = Number(gift.owner_id);
+    const currentUpgrades = gift.availability_issued;
+    const maxUpgrades = gift.availability_total;
+    const components = gift.attributes.map(constructGiftUpgradedComponent);
+    return {
+        type: "upgraded",
+        id,
+        title,
+        index,
+        ownerId,
+        currentUpgrades,
+        maxUpgrades,
+        components,
+    };
+}
+export function constructGiftNonUpgraded(gift) {
+    if (!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 ? fromUnixTimestamp(gift.first_sale_date) : undefined : undefined;
+    const lastSaleDate = limited ? gift.last_sale_date ? fromUnixTimestamp(gift.last_sale_date) : undefined : undefined;
+    return cleanObject({
+        type: "nonupgraded",
+        id,
+        sticker,
+        price,
+        limited,
+        remaining,
+        total,
+        soldOut,
+        birthday,
+        conversionPrice,
+        firstSaleDate,
+        lastSaleDate,
+    });
+}

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

@@ -0,0 +1,44 @@
+/**
+ * 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 { MessageEntity } from "./0_message_entity.js";
+import { User } from "./1_user.js";
+import { Gift } from "./3_gift.js";
+/** A gift claimed by a user. */
+export interface UserGift {
+    /** The time when the gift was claimed. */
+    date: Date;
+    /** The gift. */
+    gift: Gift;
+    /** Whether the gift is publicly visible. */
+    public: boolean;
+    /** The user who sent the gift. */
+    fromUser?: User;
+    /** 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. */
+    convertionStars?: number;
+}
+export declare function constructUserGift(userGift: Api.UserStarGift, user?: Api.user): UserGift;
+//# sourceMappingURL=4_user_gift.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"4_user_gift.d.ts","sourceRoot":"","sources":["../../src/types/4_user_gift.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,EAA0B,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAiB,IAAI,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAiB,IAAI,EAAE,MAAM,aAAa,CAAC;AAElD,gCAAgC;AAChC,MAAM,WAAW,QAAQ;IACvB,0CAA0C;IAC1C,IAAI,EAAE,IAAI,CAAC;IACX,gBAAgB;IAChB,IAAI,EAAE,IAAI,CAAC;IACX,4CAA4C;IAC5C,MAAM,EAAE,OAAO,CAAC;IAChB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,+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,iBAAiB,CAAC,QAAQ,EAAE,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,EAAE,GAAG,CAAC,IAAI,GAAG,QAAQ,CAmBvF"}

package/esm/types/4_user_gift.js

@@ -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 { cleanObject, fromUnixTimestamp } from "../1_utilities.js";
+import { constructMessageEntity } from "./0_message_entity.js";
+import { constructUser } from "./1_user.js";
+import { constructGift } from "./3_gift.js";
+export function constructUserGift(userGift, user) {
+    const gift = constructGift(userGift.gift);
+    const date = fromUnixTimestamp(userGift.date);
+    const public_ = !!userGift.unsaved;
+    const fromUser = user ? constructUser(user) : undefined;
+    const message = userGift.message?.text;
+    const entities = userGift.message ? userGift.message.entities.map(constructMessageEntity).filter((v) => !!v) : undefined;
+    const messageId = userGift.msg_id;
+    const conversionStars = userGift.convert_stars;
+    return cleanObject({
+        date,
+        gift,
+        public: public_,
+        fromUser,
+        message,
+        entities,
+        messageId,
+        conversionStars,
+    });
+}

package/esm/types/5_user_gifts.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 { Api } from "../2_tl.js";
+import { UserGift } from "./4_user_gift.js";
+/** Gifts claimed by a user. */
+export interface UserGifts {
+    /** The number of all gifts claimed by the user. */
+    all: number;
+    /** Offset of the results. */
+    offset?: string;
+    /** Gifts claimed by the user. */
+    gifts: UserGift[];
+}
+export declare function constructUserGifts(userGifts: Api.payments_UserStarGifts): UserGifts;
+//# sourceMappingURL=5_user_gifts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"5_user_gifts.d.ts","sourceRoot":"","sources":["../../src/types/5_user_gifts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,GAAG,EAAM,MAAM,YAAY,CAAC;AACrC,OAAO,EAAqB,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE/D,+BAA+B;AAC/B,MAAM,WAAW,SAAS;IACxB,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,GAAG,CAAC,sBAAsB,GAAG,SAAS,CAMnF"}

package/esm/types/5_user_gifts.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 { cleanObject } from "../1_utilities.js";
+import { is } from "../2_tl.js";
+import { constructUserGift } from "./4_user_gift.js";
+export function constructUserGifts(userGifts) {
+    return cleanObject({
+        all: userGifts.count,
+        offset: userGifts.next_offset,
+        gifts: userGifts.gifts.map((v) => [v, v.from_id ? userGifts.users.find((u) => is("user", u) && u.id == v.from_id) : undefined]).map((v) => constructUserGift(v[0], v[1])),
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mtkruto/node",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "MTKruto for Node.js",
   "author": "Roj <rojvv@icloud.com>",
   "repository": {

package/script/3_types.d.ts

@@ -92,6 +92,7 @@ export * from "./types/2_chat_member.js";
 export * from "./types/2_chosen_inline_result.js";
 export * from "./types/2_forward_header.js";
 export * from "./types/2_game.js";
+export * from "./types/2_gift_upgraded_component.js";
 export * from "./types/2_inactive_chat.js";
 export * from "./types/2_inline_keyboard_button.js";
 export * from "./types/2_inline_query.js";
@@ -107,13 +108,16 @@ export * from "./types/2_story_interactions.js";
 export * from "./types/2_story_interactive_area.js";
 export * from "./types/2_successful_payment.js";
 export * from "./types/3_chat_member_updated.js";
+export * from "./types/3_gift.js";
 export * from "./types/3_join_request.js";
 export * from "./types/3_reply_markup.js";
 export * from "./types/3_story.js";
 export * from "./types/4_inline_query_result.js";
 export * from "./types/4_message.js";
+export * from "./types/4_user_gift.js";
 export * from "./types/5_callback_query.js";
 export * from "./types/5_chat_list_item.js";
 export * from "./types/5_inline_query_answer.js";
+export * from "./types/5_user_gifts.js";
 export * from "./types/6_update.js";
 //# sourceMappingURL=3_types.d.ts.map

package/script/3_types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"3_types.d.ts","sourceRoot":"","sources":["../src/3_types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"3_types.d.ts","sourceRoot":"","sources":["../src/3_types.ts"],"names":[],"mappings":"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"}

package/script/3_types.js

@@ -108,6 +108,7 @@ __exportStar(require("./types/2_chat_member.js"), exports);
 __exportStar(require("./types/2_chosen_inline_result.js"), exports);
 __exportStar(require("./types/2_forward_header.js"), exports);
 __exportStar(require("./types/2_game.js"), exports);
+__exportStar(require("./types/2_gift_upgraded_component.js"), exports);
 __exportStar(require("./types/2_inactive_chat.js"), exports);
 __exportStar(require("./types/2_inline_keyboard_button.js"), exports);
 __exportStar(require("./types/2_inline_query.js"), exports);
@@ -123,12 +124,15 @@ __exportStar(require("./types/2_story_interactions.js"), exports);
 __exportStar(require("./types/2_story_interactive_area.js"), exports);
 __exportStar(require("./types/2_successful_payment.js"), exports);
 __exportStar(require("./types/3_chat_member_updated.js"), exports);
+__exportStar(require("./types/3_gift.js"), exports);
 __exportStar(require("./types/3_join_request.js"), exports);
 __exportStar(require("./types/3_reply_markup.js"), exports);
 __exportStar(require("./types/3_story.js"), exports);
 __exportStar(require("./types/4_inline_query_result.js"), exports);
 __exportStar(require("./types/4_message.js"), exports);
+__exportStar(require("./types/4_user_gift.js"), exports);
 __exportStar(require("./types/5_callback_query.js"), exports);
 __exportStar(require("./types/5_chat_list_item.js"), exports);
 __exportStar(require("./types/5_inline_query_answer.js"), exports);
+__exportStar(require("./types/5_user_gifts.js"), exports);
 __exportStar(require("./types/6_update.js"), exports);

package/script/client/0_params.d.ts

@@ -81,7 +81,7 @@ export interface SendMessageParams extends _SendCommon, _ReplyMarkupCommon {
 export interface SendChatActionParams extends _BusinessConnectionIdCommon {
     messageThreadId?: number;
 }
-export interface EditMessageParams extends _BusinessConnectionIdCommon, _ReplyMarkupCommon {
+export interface _EditMessageTextCommon extends _ReplyMarkupCommon {
     /** The parse mode to use. if omitted, the default parse mode will be used. */
     parseMode?: ParseMode;
     /** The message's entities. */
@@ -89,7 +89,11 @@ export interface EditMessageParams extends _BusinessConnectionIdCommon, _ReplyMa
     /** The message's link preview. */
     linkPreview?: LinkPreview;
 }
-export interface EditMessageCaptionParams extends _BusinessConnectionIdCommon, _ReplyMarkupCommon {
+export interface EditMessageTextParams extends _BusinessConnectionIdCommon, _EditMessageTextCommon {
+}
+export interface EditInlineMessageTextParams extends _EditMessageTextCommon {
+}
+export interface _EditMessageCaptionCommon extends _ReplyMarkupCommon {
     /** The message's new caption. If omitted, the caption will be removed.  */
     caption?: string;
     /** The parse mode to use. If omitted, the default parse mode will be used. */
@@ -97,6 +101,10 @@ export interface EditMessageCaptionParams extends _BusinessConnectionIdCommon, _
     /** The caption's entities. */
     entities?: MessageEntity[];
 }
+export interface EditMessageCaptionParams extends _BusinessConnectionIdCommon, _EditMessageCaptionCommon {
+}
+export interface EditInlineMessageCaptionParams extends _EditMessageCaptionCommon {
+}
 export interface EditMessageReplyMarkupParams extends _BusinessConnectionIdCommon, _ReplyMarkupCommon {
 }
 export interface EditMessageMediaParams extends _BusinessConnectionIdCommon, _ReplyMarkupCommon {
@@ -512,4 +520,10 @@ export interface GetCommonChatsParams {
     /** The maximum number of results to return. Must be in the range of 1-100. Defaults to 100. */
     limit?: number;
 }
+export interface GetUserGiftsParams {
+    /** An offset key returned by a previous result. */
+    offset?: string;
+    /** The maximum number of results to return. */
+    limit?: number;
+}
 //# sourceMappingURL=0_params.d.ts.map