@mtkruto/node 0.68.0 → 0.70.0

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

@@ -0,0 +1,55 @@
+/**
+ * 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";
+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-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 { 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,35 @@
+/**
+ * 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 { ID } from "./0_id.js";
+import type { ReplyQuote } from "./3_reply_quote.js";
+/** @unlisted */
+export interface ReplyToMessage {
+    /** @discriminator */
+    messageId: number;
+    quote?: ReplyQuote;
+}
+/** @unlisted */
+export interface ReplyToStory {
+    chatId: ID;
+    /** @discriminator */
+    storyId: number;
+}
+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,gBAAgB;AAChB,MAAM,WAAW,cAAc;IAC7B,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,gBAAgB;AAChB,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,EAAE,CAAC;IACX,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,OAAO,GAAG,cAAc,GAAG,YAAY,CAAC"}

package/esm/types/5_claimed_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 { 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. */
+    public: 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. */
+    convertionStars?: 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;AAIH,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACjC,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,MAAM,EAAE,OAAO,CAAC;IAChB,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,CAsBlJ"}

package/esm/types/5_claimed_gift.js

@@ -0,0 +1,48 @@
+/**
+ * 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 { 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) {
+    if (fromPeer && !Api.isOneOf(["user", "chat", "channel"], fromPeer)) {
+        unreachable();
+    }
+    const gift = constructGift(savedStarGift.gift, getPeer);
+    const date = savedStarGift.date;
+    const public_ = !!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;
+    return cleanObject({
+        date,
+        gift,
+        public: public_,
+        sender,
+        message,
+        entities,
+        messageId,
+        conversionStars,
+    });
+}

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

@@ -0,0 +1,188 @@
+/**
+ * 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 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. */
+    disable?: boolean;
+    /** The URL of the preview. */
+    url?: string;
+    /** Wether the media is to be shown in a small size. */
+    smallMedia?: boolean;
+    /** Whether the media is to be shown in a large size. */
+    largeMedia?: boolean;
+    /** Whether the preview is to be shown above the message's text. */
+    aboveText?: boolean;
+}
+/**
+ * A link preview.
+ * @unlisted
+ */
+export interface _LinkPreviewBase {
+    /** The ID of the link preview. */
+    id: string;
+    /** Wether the media is to be shown in a small size. */
+    smallMedia: boolean;
+    /** Whether the media is to be shown in a large size. */
+    largeMedia: boolean;
+    /** Whether the preview is to be shown above the message's text. */
+    aboveText: 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;
+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,218 @@
+/**
+ * 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 { 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 smallMedia = !!media.force_small_media;
+    const largeMedia = !!media.force_large_media;
+    const aboveText = !!invert;
+    switch (media.webpage._) {
+        case "webPagePending":
+            return cleanObject({
+                type: "loading",
+                id,
+                date: media.webpage.date,
+                url: media.webpage.url,
+                smallMedia,
+                largeMedia,
+                aboveText,
+            });
+        case "webPageEmpty":
+            return cleanObject({
+                type: "notLoaded",
+                id,
+                url: media.webpage.url,
+                smallMedia,
+                largeMedia,
+                aboveText,
+            });
+    }
+    const url = media.webpage.url;
+    let linkPreview = {
+        type: "unknown",
+        id,
+        url,
+        smallMedia,
+        largeMedia,
+        aboveText,
+    };
+    switch (media.webpage.type) {
+        case "video":
+            if (media.webpage.embed_type === "iframe") {
+                linkPreview = {
+                    type: "embeddedVideo",
+                    id,
+                    url,
+                    smallMedia,
+                    largeMedia,
+                    aboveText,
+                    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,
+                    smallMedia,
+                    largeMedia,
+                    aboveText,
+                    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,
+                    smallMedia,
+                    largeMedia,
+                    aboveText,
+                    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,
+                    smallMedia,
+                    largeMedia,
+                    aboveText,
+                    photo: constructPhoto(Api.as("photo", media.webpage.photo)),
+                };
+                break;
+            }
+        /* falls through */
+        case "audio":
+            if (media.webpage.embed_type === "iframe") {
+                linkPreview = {
+                    type: "embeddedAudio",
+                    id,
+                    url,
+                    smallMedia,
+                    largeMedia,
+                    aboveText,
+                    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,
+                    smallMedia,
+                    largeMedia,
+                    aboveText,
+                    audio: constructAudio(document, audio, serializeFileId(fileId), toUniqueFileId(fileId)),
+                };
+                break;
+            }
+            else if (media.webpage.embed_url) {
+                linkPreview = {
+                    type: "externalAudio",
+                    id,
+                    url,
+                    smallMedia,
+                    largeMedia,
+                    aboveText,
+                    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,
+                    smallMedia,
+                    largeMedia,
+                    aboveText,
+                    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,
+                    smallMedia,
+                    largeMedia,
+                    aboveText,
+                    gift: constructGift(gift, getPeer),
+                };
+                break;
+            }
+        }
+    }
+    return cleanObject(linkPreview);
+}