@mtkruto/browser 0.6.1 → 0.119.1

package/esm/types/5_gift_non_upgraded_information.js

@@ -0,0 +1,69 @@
+/**
+ * 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 { constructMessageEntity } from "./2_message_entity.js";
+import { constructGiftNonUpgraded } from "./4_gift.js";
+export function constructGiftNonUpgradedInformation(action, getPeer) {
+    const isNameHidden = action.name_hidden ? true : false;
+    const isSaved = action.saved ? true : false;
+    const isConverted = action.converted ? true : false;
+    const isUpgraded = action.upgraded ? true : false;
+    const isRefunded = action.refunded ? true : false;
+    const isUpgradable = action.can_upgrade ? true : false;
+    const isPrepaidUpgrade = action.prepaid_upgrade ? true : false;
+    const isUpgradedSeparately = action.upgrade_separate ? true : false;
+    const gift = constructGiftNonUpgraded(Api.as("starGift", action.gift));
+    const message = action.message?.text;
+    const messageEntities = action.message?.entities.map((v) => constructMessageEntity(v)).filter((v) => v !== null);
+    const conversionPrice = action.convert_stars ? Number(action.convert_stars) : undefined;
+    const upgradeMessageId = action.upgrade_msg_id;
+    const upgradePrice = action.upgrade_stars ? Number(action.upgrade_stars) : undefined;
+    const from = action.from_id ? getPeer(action.from_id)?.[0] : undefined;
+    const to = action.to_id ? getPeer(action.to_id)?.[0] : undefined;
+    const inputId = action.saved_id ? String(action.saved_id) : undefined;
+    const prepaidUpgradeHash = action.prepaid_upgrade_hash;
+    const giftMessageId = action.gift_msg_id;
+    if ((action.from_id && !from) || (action.to_id && !to)) {
+        unreachable();
+    }
+    return cleanObject({
+        isNameHidden,
+        isSaved,
+        isConverted,
+        isUpgraded,
+        isRefunded,
+        isUpgradable,
+        isPrepaidUpgrade,
+        isUpgradedSeparately,
+        gift,
+        message,
+        messageEntities,
+        conversionPrice,
+        upgradeMessageId,
+        upgradePrice,
+        from,
+        to,
+        inputId,
+        prepaidUpgradeHash,
+        giftMessageId,
+    });
+}

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

@@ -0,0 +1,41 @@
+/**
+ * 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 GiftUpgraded } from "./4_gift.js";
+/** Information on an upgraded gift. */
+export interface GiftUpgradedInformation {
+    isUpgraded: boolean;
+    isTransferred: boolean;
+    isSaved: boolean;
+    isRefunded: boolean;
+    isPrepaidUpgrade: boolean;
+    gift: GiftUpgraded;
+    exportableAt?: number;
+    transferPrice?: number;
+    from?: ChatP;
+    to?: ChatP;
+    inputId?: string;
+    resalePrice?: number;
+    transferrableAt?: number;
+    resellableAt?: number;
+}
+export declare function constructGiftUpgradedInformation(action: Api.messageActionStarGiftUnique, getPeer: PeerGetter): GiftUpgradedInformation;
+//# sourceMappingURL=5_gift_upgraded_information.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"5_gift_upgraded_information.d.ts","sourceRoot":"","sources":["../../src/types/5_gift_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,EAAyB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEvE,uCAAuC;AACvC,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,IAAI,EAAE,YAAY,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,EAAE,CAAC,EAAE,KAAK,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,GAAG,CAAC,2BAA2B,EAAE,OAAO,EAAE,UAAU,GAAG,uBAAuB,CAoCtI"}

package/esm/types/5_gift_upgraded_information.js

@@ -0,0 +1,58 @@
+/**
+ * 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 { constructGiftUpgraded } from "./4_gift.js";
+export function constructGiftUpgradedInformation(action, getPeer) {
+    const isUpgraded = action.upgrade ? true : false;
+    const isTransferred = action.transferred ? true : false;
+    const isSaved = action.saved ? true : false;
+    const isRefunded = action.refunded ? true : false;
+    const isPrepaidUpgrade = action.prepaid_upgrade ? true : false;
+    const gift = constructGiftUpgraded(Api.as("starGiftUnique", action.gift), getPeer);
+    const exportableAt = action.can_export_at;
+    const transferPrice = action.transfer_stars ? Number(action.transfer_stars) : undefined;
+    const from = action.from_id ? getPeer(action.from_id)?.[0] : undefined;
+    const to = action.peer ? getPeer(action.peer)?.[0] : undefined;
+    const inputId = action.saved_id ? String(action.saved_id) : undefined;
+    const resalePrice = action.resale_amount ? Number(action.resale_amount) : undefined;
+    const transferrableAt = action.can_transfer_at;
+    const resellableAt = action.can_resell_at;
+    if ((action.from_id && !from) || (action.peer && !to)) {
+        unreachable();
+    }
+    return cleanObject({
+        isUpgraded,
+        isTransferred,
+        isSaved,
+        isRefunded,
+        isPrepaidUpgrade,
+        gift,
+        exportableAt,
+        transferPrice,
+        from,
+        to,
+        inputId,
+        resalePrice,
+        transferrableAt,
+        resellableAt,
+    });
+}

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

@@ -0,0 +1,186 @@
+/**
+ * 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 { LinkPreviewMediaSize } from "./0_link_preview_media_size.js";
+import { type Audio } from "./1_audio.js";
+import type { PeerGetter } from "./1_chat_p.js";
+import { type Document } from "./1_document.js";
+import { type Photo } from "./1_photo.js";
+import { type Gift } from "./4_gift.js";
+/**
+ * A link preview to be passed as an input.
+ * @unlisted
+ */
+export interface InputLinkPreview {
+    /** @discriminator */
+    type: "input";
+    /** Whether link preview is disabled. */
+    isDisabled?: boolean;
+    /** The URL of the preview. */
+    url?: string;
+    /** The size of the media that will potentially be shown. */
+    mediaSize?: LinkPreviewMediaSize;
+    /** Whether the preview is to be shown above the message's text. */
+    isAboveText?: boolean;
+}
+/**
+ * A link preview.
+ * @unlisted
+ */
+export interface _LinkPreviewBase {
+    /** The ID of the link preview. */
+    id: string;
+    /** The size in which the media is expected to be displayed in. */
+    mediaSize: LinkPreviewMediaSize;
+    /** Whether the preview is to be shown above the message's text. */
+    isAboveText: boolean;
+}
+/**
+ * A link preview that is being loaded.
+ * @unlisted
+ */
+export interface LinkPreviewLoading extends _LinkPreviewBase {
+    /** @discriminator */
+    type: "loading";
+    /** The URL of the link preview. */
+    url?: string;
+    /** The point in time in which the link preview started to load. */
+    date: number;
+}
+/**
+ * A link preview that was not loaded.
+ * @unlisted
+ */
+export interface LinkPreviewNotLoaded extends _LinkPreviewBase {
+    /** @discriminator */
+    type: "notLoaded";
+    /** The URL of the link preview. */
+    url?: string;
+}
+/** @unlisted */
+export interface _LinkPreviewLoadedBase extends _LinkPreviewBase {
+    /** The URL of the link preview. */
+    url: string;
+}
+/**
+ * A link preview of an unknown type.
+ * @unlisted
+ */
+export interface LinkPreviewUnknown extends _LinkPreviewLoadedBase {
+    /** @discriminator */
+    type: "unknown";
+}
+/**
+ * An embedded video link preview.
+ * @unlisted
+ */
+export interface LinkPreviewPhoto extends _LinkPreviewLoadedBase {
+    /** @discriminator */
+    type: "photo";
+    photo: Photo;
+}
+/** An embedded video link preview.
+ * @unlisted
+ */
+export interface _LinkPreviewEmbeddedBase extends _LinkPreviewLoadedBase {
+    embedUrl: string;
+    width: number;
+    height: number;
+    duration: number;
+}
+/**
+ *  An embedded video link preview.
+ * @unlisted
+ */
+export interface LinkPreviewEmbeddedVideo extends _LinkPreviewEmbeddedBase {
+    /** @discriminator */
+    type: "embeddedVideo";
+    thumbnail?: Photo;
+}
+/**
+ * An embedded video link preview.
+ * @unlisted
+ */
+export interface LinkPreviewExternalVideo extends _LinkPreviewEmbeddedBase {
+    /** @discriminator */
+    type: "externalVideo";
+    mimeType: string;
+    width: number;
+    height: number;
+    duration: number;
+}
+/** A video link preview.
+ * @unlisted
+ */
+export interface LinkPreviewVideo extends _LinkPreviewLoadedBase {
+    /** @discriminator */
+    type: "video";
+    video: Document;
+    startTimestamp?: number;
+    thumbnail?: Photo;
+}
+/**
+ * An embedded audio link preview.
+ * @unlisted
+ */
+export interface LinkPreviewEmbeddedAudio extends _LinkPreviewEmbeddedBase {
+    /** @discriminator */
+    type: "embeddedAudio";
+    duration: number;
+    width: number;
+    height: number;
+}
+/**
+ * An external audio link preview.
+ * @unlisted
+ */
+export interface LinkPreviewExternalAudio extends _LinkPreviewEmbeddedBase {
+    /** @discriminator */
+    type: "externalAudio";
+    mimeType: string;
+    duration: number;
+}
+/**
+ * An audio link preview.
+ * @unlisted
+ */
+export interface LinkPreviewAudio extends _LinkPreviewLoadedBase {
+    /** @discriminator */
+    type: "audio";
+    audio: Audio;
+}
+/**
+ * An gift link preview.
+ * @unlisted
+ */
+export interface LinkPreviewGift extends _LinkPreviewLoadedBase {
+    /** @discriminator */
+    type: "gift";
+    gift: Gift;
+}
+/**
+ * A link preview that was loaded.
+ * @unlisted
+ */
+export type LinkPreviewLoaded = LinkPreviewUnknown | LinkPreviewPhoto | LinkPreviewEmbeddedVideo | LinkPreviewExternalVideo | LinkPreviewVideo | LinkPreviewEmbeddedAudio | LinkPreviewExternalAudio | LinkPreviewAudio | LinkPreviewGift;
+/** A link preview. */
+export type LinkPreview = InputLinkPreview | LinkPreviewLoading | LinkPreviewNotLoaded | LinkPreviewLoaded;
+export declare function constructLinkPreview(media: Api.messageMediaWebPage, invert: boolean | undefined, getPeer: PeerGetter): LinkPreview;
+//# sourceMappingURL=5_link_preview.d.ts.map

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

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

package/esm/types/5_link_preview.js

@@ -0,0 +1,205 @@
+/**
+ * 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 { constructAudio } from "./1_audio.js";
+import { constructDocument } from "./1_document.js";
+import { constructPhoto } from "./1_photo.js";
+import { constructGift } from "./4_gift.js";
+export function constructLinkPreview(media, invert, getPeer) {
+    if (Api.is("webPageNotModified", media.webpage)) {
+        unreachable();
+    }
+    const id = String(media.webpage.id);
+    const mediaSize = media.force_large_media ? "large" : "small";
+    const isAboveText = !!invert;
+    switch (media.webpage._) {
+        case "webPagePending":
+            return cleanObject({
+                type: "loading",
+                id,
+                date: media.webpage.date,
+                url: media.webpage.url,
+                mediaSize,
+                isAboveText,
+            });
+        case "webPageEmpty":
+            return cleanObject({
+                type: "notLoaded",
+                id,
+                url: media.webpage.url,
+                mediaSize,
+                isAboveText,
+            });
+    }
+    const url = media.webpage.url;
+    let linkPreview = {
+        type: "unknown",
+        id,
+        url,
+        mediaSize,
+        isAboveText,
+    };
+    switch (media.webpage.type) {
+        case "video":
+            if (media.webpage.embed_type === "iframe") {
+                linkPreview = {
+                    type: "embeddedVideo",
+                    id,
+                    url,
+                    mediaSize,
+                    isAboveText,
+                    embedUrl: media.webpage.embed_url ?? "",
+                    width: media.webpage.embed_width ?? 0,
+                    height: media.webpage.embed_height ?? 0,
+                    duration: media.webpage.duration ?? 0,
+                    thumbnail: media.webpage.photo ? constructPhoto(Api.as("photo", media.webpage.photo)) : undefined,
+                };
+                break;
+            }
+            else if (media.webpage.document) {
+                const document = Api.as("document", media.webpage.document);
+                const fileId = {
+                    type: FileType.Video,
+                    dcId: document.dc_id,
+                    fileReference: document.file_reference,
+                    location: { type: "common", id: document.id, accessHash: document.access_hash },
+                };
+                const startTimestamp = Number(new URL(media.webpage.url).searchParams.get("t")) || undefined;
+                const fileName = document.attributes.find((v) => Api.is("documentAttributeFilename", v));
+                linkPreview = {
+                    type: "video",
+                    id,
+                    url,
+                    mediaSize,
+                    isAboveText,
+                    video: constructDocument(document, fileName ?? { _: "documentAttributeFilename", file_name: "Unknown" }, serializeFileId(fileId), toUniqueFileId(fileId)),
+                    startTimestamp,
+                    thumbnail: media.webpage.video_cover_photo ? media.webpage.photo ? constructPhoto(Api.as("photo", media.webpage.photo)) : undefined : undefined,
+                };
+                break;
+            }
+            else if (media.webpage.embed_url) {
+                linkPreview = {
+                    type: "externalVideo",
+                    id,
+                    url,
+                    mediaSize,
+                    isAboveText,
+                    embedUrl: media.webpage.embed_url ?? "",
+                    mimeType: media.webpage.embed_type ?? "",
+                    width: media.webpage.embed_width ?? 0,
+                    height: media.webpage.embed_height ?? 0,
+                    duration: media.webpage.duration ?? 0,
+                };
+                break;
+            }
+            else if (media.webpage.photo) {
+                linkPreview = {
+                    type: "photo",
+                    id,
+                    url,
+                    mediaSize,
+                    isAboveText,
+                    photo: constructPhoto(Api.as("photo", media.webpage.photo)),
+                };
+                break;
+            }
+        /* falls through */
+        case "audio":
+            if (media.webpage.embed_type === "iframe") {
+                linkPreview = {
+                    type: "embeddedAudio",
+                    id,
+                    url,
+                    mediaSize,
+                    isAboveText,
+                    embedUrl: media.webpage.embed_url ?? "",
+                    width: media.webpage.embed_width ?? 0,
+                    height: media.webpage.embed_height ?? 0,
+                    duration: media.webpage.duration ?? 0,
+                };
+                break;
+            }
+            else if (media.webpage.document) {
+                const document = Api.as("document", media.webpage.document);
+                const fileId = {
+                    type: FileType.Audio,
+                    dcId: document.dc_id,
+                    fileReference: document.file_reference,
+                    location: { type: "common", id: document.id, accessHash: document.access_hash },
+                };
+                const audio = document.attributes.find((v) => Api.is("documentAttributeAudio", v));
+                linkPreview = {
+                    type: "audio",
+                    id,
+                    url,
+                    mediaSize,
+                    isAboveText,
+                    audio: constructAudio(document, audio, serializeFileId(fileId), toUniqueFileId(fileId)),
+                };
+                break;
+            }
+            else if (media.webpage.embed_url) {
+                linkPreview = {
+                    type: "externalAudio",
+                    id,
+                    url,
+                    mediaSize,
+                    isAboveText,
+                    embedUrl: media.webpage.embed_url,
+                    mimeType: media.webpage.embed_type ?? "",
+                    width: media.webpage.embed_width ?? 0,
+                    height: media.webpage.embed_height ?? 0,
+                    duration: media.webpage.duration ?? 0,
+                };
+                break;
+            }
+            else if (media.webpage.photo) {
+                linkPreview = {
+                    type: "photo",
+                    id,
+                    url,
+                    mediaSize,
+                    isAboveText,
+                    photo: constructPhoto(Api.as("photo", media.webpage.photo)),
+                };
+                break;
+            }
+            break;
+        case "telegram_nft": {
+            const gift = media.webpage.attributes?.find((v) => Api.is("webPageAttributeUniqueStarGift", v))?.gift;
+            if (gift) {
+                linkPreview = {
+                    type: "gift",
+                    id,
+                    url,
+                    mediaSize,
+                    isAboveText,
+                    gift: constructGift(gift, getPeer),
+                };
+                break;
+            }
+        }
+    }
+    return cleanObject(linkPreview);
+}

package/esm/types/6_claimed_gifts.d.ts

@@ -0,0 +1,33 @@
+/**
+ * MTKruto - Cross-runtime JavaScript library for building Telegram clients
+ * Copyright (C) 2023-2026 Roj <https://roj.im/>
+ *
+ * This file is part of MTKruto.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+import { Api } from "../2_tl.js";
+import type { PeerGetter } from "./1_chat_p.js";
+import { type ClaimedGift } from "./5_claimed_gift.js";
+/** Gifts claimed by a user or a channel. */
+export interface ClaimedGifts {
+    /** The number of all gifts claimed by the user. */
+    all: number;
+    /** Offset of the results. */
+    offset?: string;
+    /** Gifts claimed by the user. */
+    gifts: ClaimedGift[];
+}
+export declare function constructClaimedGifts(savedStarGifts: Api.payments_SavedStarGifts, getPeer: PeerGetter): ClaimedGifts;
+//# sourceMappingURL=6_claimed_gifts.d.ts.map

package/esm/types/6_claimed_gifts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"6_claimed_gifts.d.ts","sourceRoot":"","sources":["../../src/types/6_claimed_gifts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,KAAK,WAAW,EAAwB,MAAM,qBAAqB,CAAC;AAE7E,4CAA4C;AAC5C,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED,wBAAgB,qBAAqB,CAAC,cAAc,EAAE,GAAG,CAAC,uBAAuB,EAAE,OAAO,EAAE,UAAU,GAAG,YAAY,CAiBpH"}

package/esm/types/6_claimed_gifts.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 { Api } from "../2_tl.js";
+import { constructClaimedGift } from "./5_claimed_gift.js";
+export function constructClaimedGifts(savedStarGifts, getPeer) {
+    return cleanObject({
+        all: savedStarGifts.count,
+        offset: savedStarGifts.next_offset,
+        gifts: savedStarGifts.gifts.map((v) => {
+            const fromId = v.from_id;
+            if (Api.is("peerUser", fromId)) {
+                return [v, savedStarGifts.users.find((u) => Api.is("user", u) && u.id === fromId.user_id)];
+            }
+            else if (Api.is("peerChat", fromId)) {
+                return [v, savedStarGifts.chats.find((u) => Api.is("chat", u) && u.id === fromId.chat_id)];
+            }
+            else if (fromId) {
+                return [v, savedStarGifts.chats.find((u) => Api.isOneOf(["channel", "channelForbidden"], u) && u.id === fromId.channel_id)];
+            }
+            else {
+                return [v, undefined];
+            }
+        }).map((v) => constructClaimedGift(v[0], v[1], getPeer)),
+    });
+}