@mtcute/core 0.16.13 → 0.17.0

package/chunks/cjs/{chPq0GcA.js → CSfUPcui.js}

@@ -1224,6 +1224,13 @@ function requestPeer(text2, buttonId, params) {
     maxQuantity: params.count ?? 1
   };
 }
+function copy(params) {
+  return {
+    _: "keyboardButtonCopy",
+    text: params.text,
+    copyText: params?.copyText ?? params.text
+  };
+}
 function findButton(buttons, predicate) {
   if (typeof predicate === "string") {
     const text2 = predicate;
@@ -1301,6 +1308,7 @@ const factories$2 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineP
   _rowsTo2d,
   builder,
   callback,
+  copy,
   findButton,
   forceReply,
   game: game$2,
@@ -3154,945 +3162,1044 @@ class Photo extends FileLocation$1 {
 }
 const Photo$1 = /* @__PURE__ */ memoizeGetters(Photo, ["thumbnails", "fileId", "uniqueFileId"]);
 const Photo$2 = /* @__PURE__ */ conditionVariable.makeInspectable(Photo$1, ["fileSize", "dcId", "width", "height"], ["inputMedia", "inputPhoto"]);
-function _messageActionFromTl(act) {
-  switch (act._) {
-    case "messageActionChatCreate":
-      return {
-        type: "chat_created",
-        title: act.title,
-        users: act.users
-      };
-    case "messageActionChannelCreate":
-      return {
-        type: "channel_created",
-        title: act.title
-      };
-    case "messageActionChatMigrateTo":
-      return {
-        type: "chat_migrate_to",
-        id: act.channelId
-      };
-    case "messageActionChannelMigrateFrom":
-      return {
-        type: "channel_migrate_from",
-        id: act.chatId,
-        title: act.title
-      };
-    case "messageActionPinMessage":
-      return {
-        type: "message_pinned"
-      };
-    case "messageActionHistoryClear":
-      return {
-        type: "history_cleared"
-      };
-    case "messageActionGameScore":
-      return {
-        type: "game_score",
-        gameId: act.gameId,
-        score: act.score
-      };
-    case "messageActionContactSignUp":
-      return {
-        type: "contact_joined"
-      };
-    case "messageActionChatEditTitle":
-      return {
-        type: "title_changed",
-        title: act.title
-      };
-    case "messageActionChatEditPhoto":
-      return {
-        type: "photo_changed",
-        photo: new Photo$2(act.photo)
-      };
-    case "messageActionChatDeletePhoto":
-      return {
-        type: "photo_deleted"
-      };
-    case "messageActionChatAddUser":
-      return {
-        type: "users_added",
-        users: act.users
-      };
-    case "messageActionChatDeleteUser":
-      if (this.raw.fromId?._ === "peerUser" && act.userId === this.raw.fromId.userId) {
-        return {
-          type: "user_left"
-        };
-      }
-      return {
-        type: "user_removed",
-        user: act.userId
-      };
-    case "messageActionChatJoinedByLink":
-      return {
-        type: "user_joined_link",
-        inviter: act.inviterId
-      };
-    case "messageActionPaymentSentMe":
-      return {
-        type: "payment_received",
-        currency: act.currency,
-        amount: act.totalAmount,
-        payload: act.payload,
-        info: act.info,
-        shippingOptionId: act.shippingOptionId,
-        charge: act.charge
-      };
-    case "messageActionPaymentSent":
-      return {
-        type: "payment_sent",
-        currency: act.currency,
-        amount: act.totalAmount
-      };
-    case "messageActionPhoneCall":
-      return {
-        type: "call",
-        id: act.callId,
-        isVideo: Boolean(act.video),
-        reason: act.reason ? _callDiscardReasonFromTl(act.reason) : void 0,
-        duration: act.duration ?? 0
-      };
-    case "messageActionScreenshotTaken":
-      return {
-        type: "screenshot_taken"
-      };
-    case "messageActionBotAllowed":
-      return {
-        type: "bot_allowed",
-        domain: act.domain
-      };
-    case "messageActionGeoProximityReached":
-      if (act.fromId._ !== "peerUser" || act.toId._ !== "peerUser") {
-        return null;
+class RawDocument extends FileLocation$1 {
+  constructor(raw) {
+    super(
+      {
+        _: "inputDocumentFileLocation",
+        id: raw.id,
+        fileReference: raw.fileReference,
+        accessHash: raw.accessHash,
+        thumbSize: ""
+      },
+      raw.size,
+      raw.dcId
+    );
+    this.raw = raw;
+    this.raw = raw;
+  }
+  /**
+   * Original file name, extracted from the document
+   * attributes.
+   */
+  get fileName() {
+    const attr = this.raw.attributes.find((it) => it._ === "documentAttributeFilename");
+    return attr?.fileName ?? null;
+  }
+  /**
+   * File MIME type, as defined by the sender.
+   */
+  get mimeType() {
+    return this.raw.mimeType;
+  }
+  /**
+   * Date the document was sent
+   */
+  get date() {
+    return new Date(this.raw.date * 1e3);
+  }
+  /**
+   * Available thumbnails, if any.
+   *
+   * If there are no thumbnails, the array will be empty.
+   */
+  get thumbnails() {
+    const arr = [];
+    this.raw.thumbs?.forEach((sz) => arr.push(new Thumbnail$2(this.raw, sz)));
+    this.raw.videoThumbs?.forEach((sz) => arr.push(new Thumbnail$2(this.raw, sz)));
+    return arr;
+  }
+  /**
+   * Get a thumbnail by its type.
+   *
+   * Thumbnail types are described in the
+   * [Telegram docs](https://core.telegram.org/api/files#image-thumbnail-types),
+   * and are also available as static members of {@link Thumbnail} for convenience.
+   *
+   * @param type  Thumbnail type
+   */
+  getThumbnail(type) {
+    return this.thumbnails.find((it) => {
+      if (it.raw._ === "videoSizeEmojiMarkup" || it.raw._ === "videoSizeStickerMarkup") {
+        return false;
       }
-      return {
-        type: "geo_proximity",
-        targetId: act.toId.userId,
-        userId: act.fromId.userId,
-        distance: act.distance
-      };
-    case "messageActionGroupCall":
-      if (act.duration) {
-        return {
-          type: "group_call_ended",
-          call: act.call,
-          duration: act.duration
-        };
+      return it.raw.type === type;
+    }) ?? null;
+  }
+  /**
+   * Input document TL object generated from this object,
+   * to be used with methods that use it
+   */
+  get inputDocument() {
+    return {
+      _: "inputDocument",
+      id: this.raw.id,
+      accessHash: this.raw.accessHash,
+      fileReference: this.raw.fileReference
+    };
+  }
+  /**
+   * Input media TL object generated from this object,
+   * to be used inside {@link InputMediaLike} and
+   * {@link TelegramClient.sendMedia}
+   */
+  get inputMedia() {
+    return {
+      _: "inputMediaDocument",
+      id: this.inputDocument
+    };
+  }
+  _fileIdType() {
+    return fileId.tdFileId.FileType.Document;
+  }
+  /**
+   * Get TDLib and Bot API compatible File ID
+   * representing this document.
+   */
+  get fileId() {
+    return fileId.toFileId(platform.getPlatform(), {
+      type: this._fileIdType(),
+      dcId: this.raw.dcId,
+      fileReference: this.raw.fileReference,
+      location: {
+        _: "common",
+        id: this.raw.id,
+        accessHash: this.raw.accessHash
       }
-      return {
-        type: "group_call_started",
-        call: act.call
-      };
-    case "messageActionGroupCallScheduled":
-      return {
-        type: "group_call_scheduled",
-        call: act.call,
-        date: new Date(act.scheduleDate * 1e3)
-      };
-    case "messageActionInviteToGroupCall":
-      return {
-        type: "group_call_invite",
-        call: act.call,
-        userIds: act.users
-      };
-    case "messageActionSetMessagesTTL":
-      return {
-        type: "ttl_changed",
-        period: act.period
-      };
-    case "messageActionTopicCreate":
-      return {
-        type: "topic_created",
-        title: act.title,
-        iconColor: act.iconColor,
-        iconCustomEmoji: act.iconEmojiId
-      };
-    case "messageActionTopicEdit":
-      return {
-        type: "topic_edited",
-        title: act.title,
-        iconCustomEmoji: act.iconEmojiId,
-        closed: act.closed,
-        hidden: act.hidden
-      };
-    case "messageActionCustomAction":
-      return {
-        type: "custom",
-        action: act.message
-      };
-    case "messageActionSetChatTheme":
-      return {
-        type: "theme_changed",
-        emoji: act.emoticon
-      };
-    case "messageActionChatJoinedByRequest":
-      return {
-        type: "user_joined_approved"
-      };
-    case "messageActionWebViewDataSent":
-      return {
-        type: "webview_sent",
-        text: act.text
-      };
-    case "messageActionWebViewDataSentMe":
-      return {
-        type: "webview_received",
-        text: act.text,
-        data: act.data
-      };
-    case "messageActionGiftPremium":
-      return {
-        type: "premium_gifted",
-        currency: act.currency,
-        amount: act.amount.toNumber(),
-        months: act.months,
-        crypto: act.cryptoAmount ? {
-          currency: act.cryptoCurrency,
-          amount: act.cryptoAmount.toNumber()
-        } : void 0
-      };
-    case "messageActionSuggestProfilePhoto":
-      return {
-        type: "photo_suggested",
-        photo: new Photo$2(act.photo)
-      };
-    case "messageActionRequestedPeerSentMe":
-      return {
-        type: "peer_sent",
-        buttonId: act.buttonId,
-        peers: act.peers
-      };
-    case "messageActionRequestedPeer":
-      return {
-        type: "peer_chosen",
-        buttonId: act.buttonId,
-        peers: act.peers.map((it) => parsePeer(it, this._peers))
-      };
-    case "messageActionSetChatWallPaper":
-      return {
-        type: "wallpaper_changed",
-        same: act.same,
-        forBoth: act.forBoth,
-        wallpaper: act.wallpaper
-      };
-    case "messageActionGiftCode":
-      return {
-        type: "gift_code",
-        raw: act
-      };
-    case "messageActionGiveawayLaunch":
-      return {
-        type: "giveaway_started"
-      };
-    case "messageActionGiveawayResults":
-      return {
-        type: "giveaway_ended",
-        winners: act.winnersCount,
-        undistributed: act.unclaimedCount
-      };
-    case "messageActionBoostApply":
-      return {
-        type: "boost_apply",
-        count: act.boosts
-      };
-    case "messageActionPaymentRefunded":
-      return {
-        type: "payment_refunded",
-        currency: act.currency,
-        peerId: conditionVariable.getMarkedPeerId(act.peer),
-        amount: act.totalAmount,
-        payload: act.payload,
-        charge: act.charge
-      };
-    case "messageActionGiftStars":
-      return {
-        type: "stars_gifted",
-        isCrypto: Boolean(act.cryptoCurrency),
-        currency: act.cryptoCurrency ?? act.currency,
-        amount: act.cryptoAmount ?? act.amount,
-        stars: act.stars,
-        transactionId: act.transactionId
-      };
-    case "messageActionPrizeStars":
-      return {
-        type: "stars_prize",
-        claimed: !act.unclaimed,
-        stars: act.stars,
-        transactionId: act.transactionId,
-        boostPeer: parsePeer(act.boostPeer, this._peers),
-        giveawayMessageId: act.giveawayMsgId
-      };
-    default:
-      return null;
-  }
-}
-class MessageForwardInfo {
-  constructor(raw, _peers) {
-    this.raw = raw;
-    this._peers = _peers;
+    });
   }
   /**
-   * Date the original message was sent
+   * Get a unique File ID representing this document.
    */
-  get date() {
-    return new Date(this.raw.date * 1e3);
+  get uniqueFileId() {
+    return fileId.toUniqueFileId(platform.getPlatform(), fileId.tdFileId.FileType.Document, {
+      _: "common",
+      id: this.raw.id
+    });
   }
-  /**
-   * Sender of the original message (either user or a channel)
-   * or their name (for users with private forwards)
-   */
-  get sender() {
-    if (this.raw.fromName) {
-      return {
-        type: "anonymous",
-        displayName: this.raw.fromName
-      };
-    }
-    if (this.raw.fromId) {
-      return parsePeer(this.raw.fromId, this._peers);
-    }
-    throw new platform.MtTypeAssertionError("MessageForwardInfo", "to have fromId or fromName", "neither");
+}
+class Document extends RawDocument {
+  type = "document";
+}
+const Document$1 = /* @__PURE__ */ memoizeGetters(Document, ["fileName", "thumbnails", "fileId", "uniqueFileId"]);
+const Document$2 = /* @__PURE__ */ conditionVariable.makeInspectable(Document$1, ["fileSize", "dcId"], ["inputMedia", "inputDocument"]);
+class Audio extends RawDocument {
+  constructor(doc, attr) {
+    super(doc);
+    this.attr = attr;
+  }
+  /** Type of the media (for use in a tagged union) */
+  type = "audio";
+  /** Type of the file for File ID generation */
+  _fileIdType() {
+    return fileId.tdFileId.FileType.Audio;
   }
   /**
-   * For "saved" messages (i.e. messages forwarded to yourself,
-   * "Saved Messages"), the peer where the message was originally sent
+   * Duration of the audio in seconds.
+   *
+   * May not be accurate since provided by the sender.
    */
-  fromChat() {
-    if (!this.raw.savedFromPeer) return null;
-    return Chat$2._parseFromPeer(this.raw.savedFromPeer, this._peers);
+  get duration() {
+    return this.attr.duration;
   }
   /**
-   * For messages forwarded from channels,
-   * identifier of the original message in the channel
+   * Performer of the audio track.
    */
-  get fromMessageId() {
-    return this.raw.savedFromMsgId ?? null;
+  get performer() {
+    return this.attr.performer ?? null;
   }
   /**
-   * For messages forwarded from channels,
-   * signature of the post author (if present)
+   * Title of the audio track.
    */
-  get signature() {
-    return this.raw.postAuthor ?? null;
+  get title() {
+    return this.attr.title ?? null;
   }
 }
-const MessageForwardInfo$1 = /* @__PURE__ */ memoizeGetters(MessageForwardInfo, ["sender", "fromChat"]);
-const MessageForwardInfo$2 = /* @__PURE__ */ conditionVariable.makeInspectable(MessageForwardInfo$1);
-class Contact {
-  constructor(obj) {
-    this.obj = obj;
+const Audio$1 = /* @__PURE__ */ memoizeGetters(Audio, ["fileName", "thumbnails", "fileId", "uniqueFileId"]);
+const Audio$2 = /* @__PURE__ */ conditionVariable.makeInspectable(Audio$1, ["fileSize", "dcId"], ["inputMedia", "inputDocument"]);
+const MASK_POSITION_POINT_TO_TL = {
+  forehead: 0,
+  eyes: 1,
+  mouth: 2,
+  chin: 3
+};
+const MASK_POS = ["forehead", "eyes", "mouth", "chin"];
+class Sticker extends RawDocument {
+  constructor(doc, attr, attr2) {
+    super(doc);
+    this.attr = attr;
+    this.attr2 = attr2;
   }
-  type = "contact";
-  /**
-   * Contact's phone number
-   */
-  get phoneNumber() {
-    return this.obj.phoneNumber;
+  type = "sticker";
+  _fileIdType() {
+    return fileId.tdFileId.FileType.Sticker;
   }
   /**
-   * Contact's first name
+   * Sticker width in pixels
    */
-  get firstName() {
-    return this.obj.firstName;
+  get width() {
+    return this.attr2?.w ?? 512;
   }
   /**
-   * Contact's last name
+   * Sticker height in pixels
    */
-  get lastName() {
-    return this.obj.lastName;
+  get height() {
+    return this.attr2?.h ?? 512;
   }
   /**
-   * Contact's user ID in Telegram or `0` if not available
+   * Whether this sticker is a premium sticker
+   * (has premium fullscreen animation)
    */
-  get userId() {
-    return this.obj.userId;
+  get isPremiumSticker() {
+    return Boolean(this.raw.videoThumbs?.some((s) => s._ === "videoSize" && s.type === "f"));
   }
   /**
-   * Input media TL object generated from this object,
-   * to be used inside {@link InputMediaLike} and
-   * {@link TelegramClient.sendMedia}
+   * Whether this sticker is a valid sticker.
+   *
+   * If it is not, then this is probably a WEBP photo
+   * that Telegram treats as a sticker.
    */
-  get inputMedia() {
-    return {
-      ...this.obj,
-      _: "inputMediaContact"
-    };
+  get isValidSticker() {
+    return this.attr2 !== void 0 && (this.attr2.w === 512 || this.attr2.h === 512);
   }
-}
-const Contact$1 = /* @__PURE__ */ conditionVariable.makeInspectable(Contact, void 0, ["inputMedia"]);
-class Dice {
-  constructor(obj) {
-    this.obj = obj;
-  }
-  type = "dice";
   /**
-   * A simple 6-sided dice.
+   * Primary emoji associated with this sticker,
+   * that is displayed in dialogs list.
    *
-   * {@link value} represents its value (1-6)
-   */
-  static TYPE_DICE = "🎲";
-  /**
-   * A dart. Telegram dart has 4 rings and middle.
+   * If there is none, empty string is returned.
    *
-   * {@link value} represents the position of the dart:
-   * ![Dart position graph](https://i.imgur.com/iPBm7HG.png)
+   * **Note:** This only contains at most one emoji.
+   * Some stickers have multiple associated emojis,
+   * but only one is returned here. This is Telegram's
+   * limitation! Use {@link getAllEmojis} instead.
+   *
+   * For custom emojis, this alt should be used as a fallback
+   * text that will be "behind" the custom emoji entity.
    */
-  static TYPE_DART = "🎯";
+  get emoji() {
+    return this.attr.alt;
+  }
   /**
-   * A basketball thrown into a hoop.
+   * Whether this custom emoji can be used by non-premium users.
+   * `false` if this is not a custom emoji.
    *
-   * {@link value} represents the motion of the ball:
-   *  - 1: simple miss (ball hits right part, bounces to the left)
-   *  - 2: first hit the ring, then miss
-   *  - 3: ball gets stuck between the ring and the base
-   *  - 4: first hit the ring, then score
-   *  - 5: direct score
+   * > Not sure if there are any such stickers currently.
    */
-  static TYPE_BASKETBALL = "🏀";
+  get customEmojiFree() {
+    return this.attr._ === "documentAttributeCustomEmoji" ? this.attr.free ?? false : false;
+  }
   /**
-   * A football thrown to the gate.
-   *
-   * {@link value} represents the motion of the ball:
-   *  - 1: flies above the top barbell
-   *  - 2: hits right barbell, then miss
-   *  - 3: direct score in the middle
-   *  - 4: hits left barbell, then score, then hits right barbell
-   *  - 5: score in the top-right corner
+   * If this is a custom emoji, its unique ID
+   * that can be used in {@link TelegramClient#getCustomEmojis}
    */
-  static TYPE_FOOTBALL = "⚽️";
+  get customEmojiId() {
+    if (this.attr._ !== "documentAttributeCustomEmoji") {
+      throw new platform.MtArgumentError("This is not a custom emoji");
+    }
+    return this.raw.id;
+  }
   /**
-   * A bowling ball thrown to pins.
-   *
-   * Assuming the following identifiers for the pins:
-   * ```
-   * 4 5 6
-   *  2 3
-   *   1
-   * ```
-   *
-   * {@link value} represents the motion of the ball and pins:
-   *  - 1: the ball touched 6th pin, none are down
-   *  - 2: the ball hit 4th pin, only 4th pin is down.
-   *  - 3: the ball hit 1st pin, pins 1, 2, 5 are down, leaving pins 3, 4, 6
-   *  - 4: the ball hit 1st pin on the right side, all the pins except 2nd and 6th are down
-   *  - 5: the ball hit 3rd pin and all the pins except 2nd are down.
-   *  - 6: the ball hit 1st pin and all pins are down
+   * Type of the sticker
    */
-  static TYPE_BOWLING = "🎳";
+  get stickerType() {
+    if (this.attr._ === "documentAttributeSticker") {
+      return this.attr.mask ? "mask" : "sticker";
+    } else if (this.attr._ === "documentAttributeCustomEmoji") {
+      return "emoji";
+    }
+    return "sticker";
+  }
   /**
-   * A slot machine.
-   *
-   * {@link value} represents the result of the machine.
-   * Value itself is an integer in range `[1, 64]`,
-   * and is composed out of several parts.
-   *
-   * > **Note**: The following information is based on the TDesktop
-   * > implementation. These are the relevant files:
-   * >  - [`chat_helpers/stickers_dice_pack.cpp`](https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/chat_helpers/stickers_dice_pack.cpp)
-   * >  - [`history/view/media/history_view_slot_machine.cpp`](https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/history/view/media/history_view_slot_machine.cpp)
-   *
-   * Unlike other animated dices, this does not have
-   * all the possible combinations in the sticker set.
-   * Instead, `value` is a specially encoded integer that contains
-   * the information about the indexes.
-   *
-   * There are some base parts of the animations:
-   *  - 0th sticker is the base background of the machine
-   *  - 1st sticker is the background of the machine for the "winning" state (i.e. `777`)
-   *  - 2nd sticker is the frame of the machine, including the handle
-   *  - 8th sticker is the "idle" state for the left slot
-   *  - 14th sticker is the "idle" state for the middle slot
-   *  - 20th sticker is the "idle" state for the right slot
-   *
-   * The machine result is encoded as 3 concatenated two-bit integers,
-   * and the resulting integer is incremented by one.
-   *
-   * So, to decode the value to its parts, you can use this code:
-   * ```typescript
-   * const computePartValue = (val: number, idx: number) => ((val - 1) >> (idx * 2)) & 0x03; // 0..3
-   * const parts = [
-   *   computePartValue(msg.media.value, 0),
-   *   computePartValue(msg.media.value, 1),
-   *   computePartValue(msg.media.value, 2),
-   * ]
-   * ```
-   *
-   * Each part of the value corresponds to a particular slot (i.e. part 0 is left slot,
-   * part 1 is middle, part 2 is right). The slot values are as follows:
-   *  - 0: BAR (displayed as a *BAR* sign on a black background)
-   *  - 1: BERRIES (displayed as berries, similar to emoji 🍇)
-   *  - 2: LEMON (displayed as a lemon, similar to emoji 🍋)
-   *  - 3: SEVEN (displayed as a red digit 7)
-   *
-   * Therefore, the winning value (i.e. `777`) is represented as `(3 << 4 | 3 << 2 | 3 << 0) + 1 = 64`
-   *
-   * To determine the needed animation parts, you'll need to apply some shifts.
-   * These are the offsets for the individual symbols:
-   *  - WIN_SEVEN: 0
-   *  - SEVEN: 1
-   *  - BAR: 2
-   *  - BERRIES: 3
-   *  - LEMON: 4
-   *
-   * And these are the shifts for each slot:
-   *  - LEFT: 3
-   *  - MIDDLE: 9
-   *  - RIGHT: 15
-   *
-   * > WIN_SEVEN is the same as SEVEN, but only used if the machine result is `777` (i.e. `value = 64`),
-   * > as it contains additional "blinking" animation.
-   *
-   * The sticker index is computed as follows: `SHIFTS[SLOT] + OFFSETS[SYM]`.
-   * For example, berries for the middle slot would be: `SHIFTS[MIDDLE] + OFFSETS[BERRIES] = 9 + 3 = 12`
-   *
-   * Currently, this sticker set is used for the machine: [SlotMachineAnimated](https://t.me/addstickers/SlotMachineAnimated)
+   * Type of the file representing the sticker
    */
-  static TYPE_SLOTS = "🎰";
+  get sourceType() {
+    if (this.attr2?._ === "documentAttributeVideo") {
+      return "video";
+    }
+    return this.mimeType === "application/x-tgsticker" ? "animated" : "static";
+  }
   /**
-   * An emoji which was originally sent.
-   *
-   * See static members of {@link Dice} for a list
-   * of possible values
+   * Whether this sticker has an associated public sticker set.
    */
-  get emoji() {
-    return this.obj.emoticon;
+  get hasStickerSet() {
+    return this.attr.stickerset._ === "inputStickerSetID";
   }
   /**
-   * Emoji's interactive value.
-   *
-   * See what this value represents in the corresponding
-   * type's documentation (in {@link Dice} static fields)
+   * Input sticker set that it associated with this sticker, if available.
    */
-  get value() {
-    return this.obj.value;
+  get inputStickerSet() {
+    return this.attr.stickerset._ === "inputStickerSetEmpty" ? null : this.attr.stickerset;
   }
   /**
-   * Input media TL object generated from this object,
-   * to be used inside {@link InputMediaLike} and
-   * {@link TelegramClient.sendMedia}
-   *
-   * Note that when you use this media, a new `value`
-   * will be generated!
+   * Position where this mask should be placed
    */
-  get inputMedia() {
+  get maskPosition() {
+    if (this.attr._ !== "documentAttributeSticker" || !this.attr.maskCoords) {
+      return null;
+    }
+    const raw = this.attr.maskCoords;
     return {
-      _: "inputMediaDice",
-      emoticon: this.obj.emoticon
+      point: MASK_POS[raw.n],
+      x: raw.x,
+      y: raw.y,
+      scale: raw.zoom
     };
   }
 }
-const Dice$1 = /* @__PURE__ */ conditionVariable.makeInspectable(Dice, void 0, ["inputMedia"]);
-class RawDocument extends FileLocation$1 {
-  constructor(raw) {
-    super(
-      {
-        _: "inputDocumentFileLocation",
-        id: raw.id,
-        fileReference: raw.fileReference,
-        accessHash: raw.accessHash,
-        thumbSize: ""
-      },
-      raw.size,
-      raw.dcId
-    );
-    this.raw = raw;
-    this.raw = raw;
+const Sticker$1 = /* @__PURE__ */ memoizeGetters(Sticker, ["fileName", "thumbnails", "fileId", "uniqueFileId", "maskPosition"]);
+const Sticker$2 = /* @__PURE__ */ conditionVariable.makeInspectable(Sticker$1, ["fileSize", "dcId"], ["inputMedia", "inputDocument"]);
+class Video extends RawDocument {
+  constructor(doc, attr, media2) {
+    super(doc);
+    this.attr = attr;
+    this.media = media2;
+  }
+  type = "video";
+  _fileIdType() {
+    if (this.isRound) return fileId.tdFileId.FileType.VideoNote;
+    if (this.isAnimation) return fileId.tdFileId.FileType.Animation;
+    return fileId.tdFileId.FileType.Video;
   }
   /**
-   * Original file name, extracted from the document
-   * attributes.
+   * Video width in pixels
    */
-  get fileName() {
-    const attr = this.raw.attributes.find((it) => it._ === "documentAttributeFilename");
-    return attr?.fileName ?? null;
+  get width() {
+    return this.attr.w;
   }
   /**
-   * File MIME type, as defined by the sender.
+   * Video height in pixels
    */
-  get mimeType() {
-    return this.raw.mimeType;
+  get height() {
+    return this.attr.h;
   }
   /**
-   * Date the document was sent
+   * Video duration in seconds.
+   *
+   * `0` for legacy GIFs
    */
-  get date() {
-    return new Date(this.raw.date * 1e3);
+  get duration() {
+    return this.attr._ === "documentAttributeVideo" ? this.attr.duration : 0;
   }
   /**
-   * Available thumbnails, if any.
-   *
-   * If there are no thumbnails, the array will be empty.
+   * Whether this video is an animated GIF
+   * (represented either by actual GIF or a silent MP4 video)
    */
-  get thumbnails() {
-    const arr = [];
-    this.raw.thumbs?.forEach((sz) => arr.push(new Thumbnail$2(this.raw, sz)));
-    this.raw.videoThumbs?.forEach((sz) => arr.push(new Thumbnail$2(this.raw, sz)));
-    return arr;
+  get isAnimation() {
+    return this.attr._ === "documentAttributeImageSize" || this.raw.attributes.some((it) => it._ === "documentAttributeAnimated");
   }
   /**
-   * Get a thumbnail by its type.
-   *
-   * Thumbnail types are described in the
-   * [Telegram docs](https://core.telegram.org/api/files#image-thumbnail-types),
-   * and are also available as static members of {@link Thumbnail} for convenience.
-   *
-   * @param type  Thumbnail type
+   * Whether this video is a round video message (aka video note)
    */
-  getThumbnail(type) {
-    return this.thumbnails.find((it) => {
-      if (it.raw._ === "videoSizeEmojiMarkup" || it.raw._ === "videoSizeStickerMarkup") {
-        return false;
-      }
-      return it.raw.type === type;
-    }) ?? null;
+  get isRound() {
+    return this.attr._ === "documentAttributeVideo" && Boolean(this.attr.roundMessage);
   }
   /**
-   * Input document TL object generated from this object,
-   * to be used with methods that use it
+   * Whether this video is a legacy GIF (i.e. its MIME is `image/gif`)
    */
-  get inputDocument() {
-    return {
-      _: "inputDocument",
-      id: this.raw.id,
-      accessHash: this.raw.accessHash,
-      fileReference: this.raw.fileReference
-    };
+  get isLegacyGif() {
+    return this.attr._ === "documentAttributeImageSize";
   }
-  /**
-   * Input media TL object generated from this object,
-   * to be used inside {@link InputMediaLike} and
-   * {@link TelegramClient.sendMedia}
-   */
-  get inputMedia() {
-    return {
-      _: "inputMediaDocument",
-      id: this.inputDocument
-    };
+  /** Whether this video is hidden with a spoiler */
+  get hasSpoiler() {
+    return this.media?.spoiler ?? false;
   }
-  _fileIdType() {
-    return fileId.tdFileId.FileType.Document;
+  /** For self-destructing videos, TTL in seconds */
+  get ttlSeconds() {
+    return this.media?.ttlSeconds ?? null;
   }
-  /**
-   * Get TDLib and Bot API compatible File ID
-   * representing this document.
-   */
-  get fileId() {
-    return fileId.toFileId(platform.getPlatform(), {
-      type: this._fileIdType(),
-      dcId: this.raw.dcId,
-      fileReference: this.raw.fileReference,
-      location: {
-        _: "common",
-        id: this.raw.id,
-        accessHash: this.raw.accessHash
-      }
-    });
+  get videoStartTs() {
+    return this.attr._ === "documentAttributeVideo" ? this.attr.videoStartTs ?? null : null;
   }
-  /**
-   * Get a unique File ID representing this document.
-   */
-  get uniqueFileId() {
-    return fileId.toUniqueFileId(platform.getPlatform(), fileId.tdFileId.FileType.Document, {
-      _: "common",
-      id: this.raw.id
-    });
+  get codec() {
+    return this.attr._ === "documentAttributeVideo" ? this.attr.videoCodec ?? null : null;
   }
 }
-class Document extends RawDocument {
-  type = "document";
-}
-const Document$1 = /* @__PURE__ */ memoizeGetters(Document, ["fileName", "thumbnails", "fileId", "uniqueFileId"]);
-const Document$2 = /* @__PURE__ */ conditionVariable.makeInspectable(Document$1, ["fileSize", "dcId"], ["inputMedia", "inputDocument"]);
-class Audio extends RawDocument {
+const Video$1 = /* @__PURE__ */ memoizeGetters(Video, ["fileName", "thumbnails", "fileId", "uniqueFileId", "isAnimation"]);
+const Video$2 = /* @__PURE__ */ conditionVariable.makeInspectable(Video$1, ["fileSize", "dcId"], ["inputMedia", "inputDocument"]);
+class Voice extends RawDocument {
   constructor(doc, attr) {
     super(doc);
     this.attr = attr;
   }
-  /** Type of the media (for use in a tagged union) */
-  type = "audio";
-  /** Type of the file for File ID generation */
+  type = "voice";
   _fileIdType() {
-    return fileId.tdFileId.FileType.Audio;
+    return fileId.tdFileId.FileType.VoiceNote;
   }
   /**
-   * Duration of the audio in seconds.
-   *
-   * May not be accurate since provided by the sender.
+   * Duration of the voice note in seconds.
    */
   get duration() {
     return this.attr.duration;
   }
   /**
-   * Performer of the audio track.
+   * Voice note's waveform
+   *
+   * Represented with integers in range [0, 31],
+   * usually has length of 100
    */
-  get performer() {
-    return this.attr.performer ?? null;
+  get waveform() {
+    return conditionVariable.decodeWaveform(this.attr.waveform);
+  }
+}
+const Voice$1 = /* @__PURE__ */ memoizeGetters(Voice, ["fileName", "thumbnails", "fileId", "uniqueFileId", "waveform"]);
+const Voice$2 = /* @__PURE__ */ conditionVariable.makeInspectable(Voice$1, ["fileSize", "dcId"], ["inputMedia", "inputDocument", "waveform"]);
+function parseSticker(doc) {
+  const stickerAttr = doc.attributes.find(
+    (a) => a._ === "documentAttributeSticker" || a._ === "documentAttributeCustomEmoji"
+  );
+  if (stickerAttr) {
+    const sz = doc.attributes.find(
+      (it) => it._ === "documentAttributeImageSize" || it._ === "documentAttributeVideo"
+    );
+    return new Sticker$2(doc, stickerAttr, sz);
+  }
+}
+function parseDocument(doc, media2) {
+  const sticker2 = parseSticker(doc);
+  if (sticker2) return sticker2;
+  for (const attr of doc.attributes) {
+    switch (attr._) {
+      case "documentAttributeAudio":
+        if (attr.voice) {
+          return new Voice$2(doc, attr);
+        }
+        return new Audio$2(doc, attr);
+      case "documentAttributeVideo":
+        return new Video$2(doc, attr, media2);
+      case "documentAttributeImageSize":
+        if (doc.mimeType === "image/gif") {
+          return new Video$2(doc, attr, media2);
+        }
+    }
+  }
+  return new Document$2(doc);
+}
+class StarGift {
+  constructor(raw) {
+    this.raw = raw;
+  }
+  /** ID of the gift */
+  get id() {
+    return this.raw.id;
+  }
+  /** Sticker associated with the gift */
+  get sticker() {
+    controllablePromise.assertTypeIs("StarGift#sticker", this.raw.sticker, "document");
+    const parsed = parseDocument(this.raw.sticker);
+    if (parsed.type !== "sticker") {
+      throw new platform.MtTypeAssertionError("StarGift#sticker", "sticker", parsed.type);
+    }
+    return parsed;
+  }
+  /** Amount of stars the gift was purchased for */
+  get purchaseStars() {
+    return this.raw.stars;
   }
   /**
-   * Title of the audio track.
+   * Amount of stars the gift can be converted to by the recipient
    */
-  get title() {
-    return this.attr.title ?? null;
+  get convertStars() {
+    return this.raw.convertStars;
+  }
+  /**
+   * For limited availability gifts,
+   * the number of remaining and total gifts available
+   */
+  get availability() {
+    if (!this.raw.availabilityRemains || !this.raw.availabilityTotal) {
+      return null;
+    }
+    return {
+      remains: this.raw.availabilityRemains,
+      total: this.raw.availabilityTotal
+    };
+  }
+}
+const StarGift$1 = /* @__PURE__ */ conditionVariable.makeInspectable(StarGift);
+const StarGift$2 = /* @__PURE__ */ memoizeGetters(StarGift$1, ["sticker"]);
+class UserStarGift {
+  constructor(raw, peers) {
+    this.raw = raw;
+    this.peers = peers;
+  }
+  /** Whether the sender chose to appear anonymously */
+  get nameHidden() {
+    return this.raw.nameHidden;
+  }
+  /** Whether this gift is not visible on the recipient's profile */
+  get hidden() {
+    return this.raw.unsaved;
+  }
+  /** Sender of the gift, if available */
+  get sender() {
+    return this.raw.fromId ? new User$2(this.peers.user(this.raw.fromId)) : null;
+  }
+  /** Message ID where the gift was sent, if available */
+  get messageId() {
+    return this.raw.msgId ?? null;
+  }
+  /** Date the gift was sent */
+  get date() {
+    return new Date(this.raw.date * 1e3);
+  }
+  /** The gift itself */
+  get gift() {
+    return new StarGift(this.raw.gift);
+  }
+  /** Text attached to the gift */
+  get text() {
+    return this.raw.message ?? null;
+  }
+  /**
+   * If the gift was converted to stars, the amount of stars
+   * it was converted to
+   */
+  get convertStars() {
+    return this.raw.convertStars ?? null;
+  }
+}
+const UserStarGift$1 = /* @__PURE__ */ conditionVariable.makeInspectable(UserStarGift);
+const UserStarGift$2 = /* @__PURE__ */ memoizeGetters(UserStarGift$1, ["sender", "gift"]);
+function _messageActionFromTl(act) {
+  switch (act._) {
+    case "messageActionChatCreate":
+      return {
+        type: "chat_created",
+        title: act.title,
+        users: act.users
+      };
+    case "messageActionChannelCreate":
+      return {
+        type: "channel_created",
+        title: act.title
+      };
+    case "messageActionChatMigrateTo":
+      return {
+        type: "chat_migrate_to",
+        id: act.channelId
+      };
+    case "messageActionChannelMigrateFrom":
+      return {
+        type: "channel_migrate_from",
+        id: act.chatId,
+        title: act.title
+      };
+    case "messageActionPinMessage":
+      return {
+        type: "message_pinned"
+      };
+    case "messageActionHistoryClear":
+      return {
+        type: "history_cleared"
+      };
+    case "messageActionGameScore":
+      return {
+        type: "game_score",
+        gameId: act.gameId,
+        score: act.score
+      };
+    case "messageActionContactSignUp":
+      return {
+        type: "contact_joined"
+      };
+    case "messageActionChatEditTitle":
+      return {
+        type: "title_changed",
+        title: act.title
+      };
+    case "messageActionChatEditPhoto":
+      return {
+        type: "photo_changed",
+        photo: new Photo$2(act.photo)
+      };
+    case "messageActionChatDeletePhoto":
+      return {
+        type: "photo_deleted"
+      };
+    case "messageActionChatAddUser":
+      return {
+        type: "users_added",
+        users: act.users
+      };
+    case "messageActionChatDeleteUser":
+      if (this.raw.fromId?._ === "peerUser" && act.userId === this.raw.fromId.userId) {
+        return {
+          type: "user_left"
+        };
+      }
+      return {
+        type: "user_removed",
+        user: act.userId
+      };
+    case "messageActionChatJoinedByLink":
+      return {
+        type: "user_joined_link",
+        inviter: act.inviterId
+      };
+    case "messageActionPaymentSentMe":
+      return {
+        type: "payment_received",
+        currency: act.currency,
+        amount: act.totalAmount,
+        payload: act.payload,
+        info: act.info,
+        shippingOptionId: act.shippingOptionId,
+        charge: act.charge
+      };
+    case "messageActionPaymentSent":
+      return {
+        type: "payment_sent",
+        currency: act.currency,
+        amount: act.totalAmount
+      };
+    case "messageActionPhoneCall":
+      return {
+        type: "call",
+        id: act.callId,
+        isVideo: Boolean(act.video),
+        reason: act.reason ? _callDiscardReasonFromTl(act.reason) : void 0,
+        duration: act.duration ?? 0
+      };
+    case "messageActionScreenshotTaken":
+      return {
+        type: "screenshot_taken"
+      };
+    case "messageActionBotAllowed":
+      return {
+        type: "bot_allowed",
+        domain: act.domain
+      };
+    case "messageActionGeoProximityReached":
+      if (act.fromId._ !== "peerUser" || act.toId._ !== "peerUser") {
+        return null;
+      }
+      return {
+        type: "geo_proximity",
+        targetId: act.toId.userId,
+        userId: act.fromId.userId,
+        distance: act.distance
+      };
+    case "messageActionGroupCall":
+      if (act.duration) {
+        return {
+          type: "group_call_ended",
+          call: act.call,
+          duration: act.duration
+        };
+      }
+      return {
+        type: "group_call_started",
+        call: act.call
+      };
+    case "messageActionGroupCallScheduled":
+      return {
+        type: "group_call_scheduled",
+        call: act.call,
+        date: new Date(act.scheduleDate * 1e3)
+      };
+    case "messageActionInviteToGroupCall":
+      return {
+        type: "group_call_invite",
+        call: act.call,
+        userIds: act.users
+      };
+    case "messageActionSetMessagesTTL":
+      return {
+        type: "ttl_changed",
+        period: act.period
+      };
+    case "messageActionTopicCreate":
+      return {
+        type: "topic_created",
+        title: act.title,
+        iconColor: act.iconColor,
+        iconCustomEmoji: act.iconEmojiId
+      };
+    case "messageActionTopicEdit":
+      return {
+        type: "topic_edited",
+        title: act.title,
+        iconCustomEmoji: act.iconEmojiId,
+        closed: act.closed,
+        hidden: act.hidden
+      };
+    case "messageActionCustomAction":
+      return {
+        type: "custom",
+        action: act.message
+      };
+    case "messageActionSetChatTheme":
+      return {
+        type: "theme_changed",
+        emoji: act.emoticon
+      };
+    case "messageActionChatJoinedByRequest":
+      return {
+        type: "user_joined_approved"
+      };
+    case "messageActionWebViewDataSent":
+      return {
+        type: "webview_sent",
+        text: act.text
+      };
+    case "messageActionWebViewDataSentMe":
+      return {
+        type: "webview_received",
+        text: act.text,
+        data: act.data
+      };
+    case "messageActionGiftPremium":
+      return {
+        type: "premium_gifted",
+        currency: act.currency,
+        amount: act.amount.toNumber(),
+        months: act.months,
+        crypto: act.cryptoAmount ? {
+          currency: act.cryptoCurrency,
+          amount: act.cryptoAmount.toNumber()
+        } : void 0
+      };
+    case "messageActionSuggestProfilePhoto":
+      return {
+        type: "photo_suggested",
+        photo: new Photo$2(act.photo)
+      };
+    case "messageActionRequestedPeerSentMe":
+      return {
+        type: "peer_sent",
+        buttonId: act.buttonId,
+        peers: act.peers
+      };
+    case "messageActionRequestedPeer":
+      return {
+        type: "peer_chosen",
+        buttonId: act.buttonId,
+        peers: act.peers.map((it) => parsePeer(it, this._peers))
+      };
+    case "messageActionSetChatWallPaper":
+      return {
+        type: "wallpaper_changed",
+        same: act.same,
+        forBoth: act.forBoth,
+        wallpaper: act.wallpaper
+      };
+    case "messageActionGiftCode":
+      return {
+        type: "gift_code",
+        raw: act
+      };
+    case "messageActionGiveawayLaunch":
+      return {
+        type: "giveaway_started"
+      };
+    case "messageActionGiveawayResults":
+      return {
+        type: "giveaway_ended",
+        winners: act.winnersCount,
+        undistributed: act.unclaimedCount
+      };
+    case "messageActionBoostApply":
+      return {
+        type: "boost_apply",
+        count: act.boosts
+      };
+    case "messageActionPaymentRefunded":
+      return {
+        type: "payment_refunded",
+        currency: act.currency,
+        peerId: conditionVariable.getMarkedPeerId(act.peer),
+        amount: act.totalAmount,
+        payload: act.payload,
+        charge: act.charge
+      };
+    case "messageActionGiftStars":
+      return {
+        type: "stars_gifted",
+        isCrypto: Boolean(act.cryptoCurrency),
+        currency: act.cryptoCurrency ?? act.currency,
+        amount: act.cryptoAmount ?? act.amount,
+        stars: act.stars,
+        transactionId: act.transactionId
+      };
+    case "messageActionPrizeStars":
+      return {
+        type: "stars_prize",
+        claimed: !act.unclaimed,
+        stars: act.stars,
+        transactionId: act.transactionId,
+        boostPeer: parsePeer(act.boostPeer, this._peers),
+        giveawayMessageId: act.giveawayMsgId
+      };
+    case "messageActionStarGift":
+      return {
+        type: "stars_gift",
+        nameHidden: act.nameHidden,
+        saved: act.saved,
+        converted: act.converted,
+        convertStars: act.convertStars,
+        gift: new StarGift$2(act.gift),
+        message: act.message ?? null
+      };
+    default:
+      return null;
   }
 }
-const Audio$1 = /* @__PURE__ */ memoizeGetters(Audio, ["fileName", "thumbnails", "fileId", "uniqueFileId"]);
-const Audio$2 = /* @__PURE__ */ conditionVariable.makeInspectable(Audio$1, ["fileSize", "dcId"], ["inputMedia", "inputDocument"]);
-const MASK_POSITION_POINT_TO_TL = {
-  forehead: 0,
-  eyes: 1,
-  mouth: 2,
-  chin: 3
-};
-const MASK_POS = ["forehead", "eyes", "mouth", "chin"];
-class Sticker extends RawDocument {
-  constructor(doc, attr, attr2) {
-    super(doc);
-    this.attr = attr;
-    this.attr2 = attr2;
-  }
-  type = "sticker";
-  _fileIdType() {
-    return fileId.tdFileId.FileType.Sticker;
-  }
-  /**
-   * Sticker width in pixels
-   */
-  get width() {
-    return this.attr2?.w ?? 512;
+class MessageForwardInfo {
+  constructor(raw, _peers) {
+    this.raw = raw;
+    this._peers = _peers;
   }
   /**
-   * Sticker height in pixels
+   * Date the original message was sent
    */
-  get height() {
-    return this.attr2?.h ?? 512;
+  get date() {
+    return new Date(this.raw.date * 1e3);
   }
   /**
-   * Whether this sticker is a premium sticker
-   * (has premium fullscreen animation)
+   * Sender of the original message (either user or a channel)
+   * or their name (for users with private forwards)
    */
-  get isPremiumSticker() {
-    return Boolean(this.raw.videoThumbs?.some((s) => s._ === "videoSize" && s.type === "f"));
+  get sender() {
+    if (this.raw.fromName) {
+      return {
+        type: "anonymous",
+        displayName: this.raw.fromName
+      };
+    }
+    if (this.raw.fromId) {
+      return parsePeer(this.raw.fromId, this._peers);
+    }
+    throw new platform.MtTypeAssertionError("MessageForwardInfo", "to have fromId or fromName", "neither");
   }
   /**
-   * Whether this sticker is a valid sticker.
-   *
-   * If it is not, then this is probably a WEBP photo
-   * that Telegram treats as a sticker.
+   * For "saved" messages (i.e. messages forwarded to yourself,
+   * "Saved Messages"), the peer where the message was originally sent
    */
-  get isValidSticker() {
-    return this.attr2 !== void 0 && (this.attr2.w === 512 || this.attr2.h === 512);
+  fromChat() {
+    if (!this.raw.savedFromPeer) return null;
+    return Chat$2._parseFromPeer(this.raw.savedFromPeer, this._peers);
   }
   /**
-   * Primary emoji associated with this sticker,
-   * that is displayed in dialogs list.
-   *
-   * If there is none, empty string is returned.
-   *
-   * **Note:** This only contains at most one emoji.
-   * Some stickers have multiple associated emojis,
-   * but only one is returned here. This is Telegram's
-   * limitation! Use {@link getAllEmojis} instead.
-   *
-   * For custom emojis, this alt should be used as a fallback
-   * text that will be "behind" the custom emoji entity.
+   * For messages forwarded from channels,
+   * identifier of the original message in the channel
    */
-  get emoji() {
-    return this.attr.alt;
+  get fromMessageId() {
+    return this.raw.savedFromMsgId ?? null;
   }
   /**
-   * Whether this custom emoji can be used by non-premium users.
-   * `false` if this is not a custom emoji.
-   *
-   * > Not sure if there are any such stickers currently.
+   * For messages forwarded from channels,
+   * signature of the post author (if present)
    */
-  get customEmojiFree() {
-    return this.attr._ === "documentAttributeCustomEmoji" ? this.attr.free ?? false : false;
+  get signature() {
+    return this.raw.postAuthor ?? null;
   }
-  /**
-   * If this is a custom emoji, its unique ID
-   * that can be used in {@link TelegramClient#getCustomEmojis}
-   */
-  get customEmojiId() {
-    if (this.attr._ !== "documentAttributeCustomEmoji") {
-      throw new platform.MtArgumentError("This is not a custom emoji");
-    }
-    return this.raw.id;
+}
+const MessageForwardInfo$1 = /* @__PURE__ */ memoizeGetters(MessageForwardInfo, ["sender", "fromChat"]);
+const MessageForwardInfo$2 = /* @__PURE__ */ conditionVariable.makeInspectable(MessageForwardInfo$1);
+class Contact {
+  constructor(obj) {
+    this.obj = obj;
   }
+  type = "contact";
   /**
-   * Type of the sticker
+   * Contact's phone number
    */
-  get stickerType() {
-    if (this.attr._ === "documentAttributeSticker") {
-      return this.attr.mask ? "mask" : "sticker";
-    } else if (this.attr._ === "documentAttributeCustomEmoji") {
-      return "emoji";
-    }
-    return "sticker";
+  get phoneNumber() {
+    return this.obj.phoneNumber;
   }
   /**
-   * Type of the file representing the sticker
+   * Contact's first name
    */
-  get sourceType() {
-    if (this.attr2?._ === "documentAttributeVideo") {
-      return "video";
-    }
-    return this.mimeType === "application/x-tgsticker" ? "animated" : "static";
+  get firstName() {
+    return this.obj.firstName;
   }
   /**
-   * Whether this sticker has an associated public sticker set.
+   * Contact's last name
    */
-  get hasStickerSet() {
-    return this.attr.stickerset._ === "inputStickerSetID";
+  get lastName() {
+    return this.obj.lastName;
   }
   /**
-   * Input sticker set that it associated with this sticker, if available.
+   * Contact's user ID in Telegram or `0` if not available
    */
-  get inputStickerSet() {
-    return this.attr.stickerset._ === "inputStickerSetEmpty" ? null : this.attr.stickerset;
+  get userId() {
+    return this.obj.userId;
   }
   /**
-   * Position where this mask should be placed
+   * Input media TL object generated from this object,
+   * to be used inside {@link InputMediaLike} and
+   * {@link TelegramClient.sendMedia}
    */
-  get maskPosition() {
-    if (this.attr._ !== "documentAttributeSticker" || !this.attr.maskCoords) {
-      return null;
-    }
-    const raw = this.attr.maskCoords;
+  get inputMedia() {
     return {
-      point: MASK_POS[raw.n],
-      x: raw.x,
-      y: raw.y,
-      scale: raw.zoom
+      ...this.obj,
+      _: "inputMediaContact"
     };
   }
 }
-const Sticker$1 = /* @__PURE__ */ memoizeGetters(Sticker, ["fileName", "thumbnails", "fileId", "uniqueFileId", "maskPosition"]);
-const Sticker$2 = /* @__PURE__ */ conditionVariable.makeInspectable(Sticker$1, ["fileSize", "dcId"], ["inputMedia", "inputDocument"]);
-class Video extends RawDocument {
-  constructor(doc, attr, media2) {
-    super(doc);
-    this.attr = attr;
-    this.media = media2;
-  }
-  type = "video";
-  _fileIdType() {
-    if (this.isRound) return fileId.tdFileId.FileType.VideoNote;
-    if (this.isAnimation) return fileId.tdFileId.FileType.Animation;
-    return fileId.tdFileId.FileType.Video;
+const Contact$1 = /* @__PURE__ */ conditionVariable.makeInspectable(Contact, void 0, ["inputMedia"]);
+class Dice {
+  constructor(obj) {
+    this.obj = obj;
   }
+  type = "dice";
   /**
-   * Video width in pixels
+   * A simple 6-sided dice.
+   *
+   * {@link value} represents its value (1-6)
    */
-  get width() {
-    return this.attr.w;
-  }
+  static TYPE_DICE = "🎲";
   /**
-   * Video height in pixels
+   * A dart. Telegram dart has 4 rings and middle.
+   *
+   * {@link value} represents the position of the dart:
+   * ![Dart position graph](https://i.imgur.com/iPBm7HG.png)
    */
-  get height() {
-    return this.attr.h;
-  }
+  static TYPE_DART = "🎯";
   /**
-   * Video duration in seconds.
+   * A basketball thrown into a hoop.
    *
-   * `0` for legacy GIFs
+   * {@link value} represents the motion of the ball:
+   *  - 1: simple miss (ball hits right part, bounces to the left)
+   *  - 2: first hit the ring, then miss
+   *  - 3: ball gets stuck between the ring and the base
+   *  - 4: first hit the ring, then score
+   *  - 5: direct score
    */
-  get duration() {
-    return this.attr._ === "documentAttributeVideo" ? this.attr.duration : 0;
-  }
+  static TYPE_BASKETBALL = "🏀";
   /**
-   * Whether this video is an animated GIF
-   * (represented either by actual GIF or a silent MP4 video)
+   * A football thrown to the gate.
+   *
+   * {@link value} represents the motion of the ball:
+   *  - 1: flies above the top barbell
+   *  - 2: hits right barbell, then miss
+   *  - 3: direct score in the middle
+   *  - 4: hits left barbell, then score, then hits right barbell
+   *  - 5: score in the top-right corner
    */
-  get isAnimation() {
-    return this.attr._ === "documentAttributeImageSize" || this.raw.attributes.some((it) => it._ === "documentAttributeAnimated");
-  }
+  static TYPE_FOOTBALL = "⚽️";
   /**
-   * Whether this video is a round video message (aka video note)
+   * A bowling ball thrown to pins.
+   *
+   * Assuming the following identifiers for the pins:
+   * ```
+   * 4 5 6
+   *  2 3
+   *   1
+   * ```
+   *
+   * {@link value} represents the motion of the ball and pins:
+   *  - 1: the ball touched 6th pin, none are down
+   *  - 2: the ball hit 4th pin, only 4th pin is down.
+   *  - 3: the ball hit 1st pin, pins 1, 2, 5 are down, leaving pins 3, 4, 6
+   *  - 4: the ball hit 1st pin on the right side, all the pins except 2nd and 6th are down
+   *  - 5: the ball hit 3rd pin and all the pins except 2nd are down.
+   *  - 6: the ball hit 1st pin and all pins are down
    */
-  get isRound() {
-    return this.attr._ === "documentAttributeVideo" && Boolean(this.attr.roundMessage);
-  }
+  static TYPE_BOWLING = "🎳";
   /**
-   * Whether this video is a legacy GIF (i.e. its MIME is `image/gif`)
+   * A slot machine.
+   *
+   * {@link value} represents the result of the machine.
+   * Value itself is an integer in range `[1, 64]`,
+   * and is composed out of several parts.
+   *
+   * > **Note**: The following information is based on the TDesktop
+   * > implementation. These are the relevant files:
+   * >  - [`chat_helpers/stickers_dice_pack.cpp`](https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/chat_helpers/stickers_dice_pack.cpp)
+   * >  - [`history/view/media/history_view_slot_machine.cpp`](https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/history/view/media/history_view_slot_machine.cpp)
+   *
+   * Unlike other animated dices, this does not have
+   * all the possible combinations in the sticker set.
+   * Instead, `value` is a specially encoded integer that contains
+   * the information about the indexes.
+   *
+   * There are some base parts of the animations:
+   *  - 0th sticker is the base background of the machine
+   *  - 1st sticker is the background of the machine for the "winning" state (i.e. `777`)
+   *  - 2nd sticker is the frame of the machine, including the handle
+   *  - 8th sticker is the "idle" state for the left slot
+   *  - 14th sticker is the "idle" state for the middle slot
+   *  - 20th sticker is the "idle" state for the right slot
+   *
+   * The machine result is encoded as 3 concatenated two-bit integers,
+   * and the resulting integer is incremented by one.
+   *
+   * So, to decode the value to its parts, you can use this code:
+   * ```typescript
+   * const computePartValue = (val: number, idx: number) => ((val - 1) >> (idx * 2)) & 0x03; // 0..3
+   * const parts = [
+   *   computePartValue(msg.media.value, 0),
+   *   computePartValue(msg.media.value, 1),
+   *   computePartValue(msg.media.value, 2),
+   * ]
+   * ```
+   *
+   * Each part of the value corresponds to a particular slot (i.e. part 0 is left slot,
+   * part 1 is middle, part 2 is right). The slot values are as follows:
+   *  - 0: BAR (displayed as a *BAR* sign on a black background)
+   *  - 1: BERRIES (displayed as berries, similar to emoji 🍇)
+   *  - 2: LEMON (displayed as a lemon, similar to emoji 🍋)
+   *  - 3: SEVEN (displayed as a red digit 7)
+   *
+   * Therefore, the winning value (i.e. `777`) is represented as `(3 << 4 | 3 << 2 | 3 << 0) + 1 = 64`
+   *
+   * To determine the needed animation parts, you'll need to apply some shifts.
+   * These are the offsets for the individual symbols:
+   *  - WIN_SEVEN: 0
+   *  - SEVEN: 1
+   *  - BAR: 2
+   *  - BERRIES: 3
+   *  - LEMON: 4
+   *
+   * And these are the shifts for each slot:
+   *  - LEFT: 3
+   *  - MIDDLE: 9
+   *  - RIGHT: 15
+   *
+   * > WIN_SEVEN is the same as SEVEN, but only used if the machine result is `777` (i.e. `value = 64`),
+   * > as it contains additional "blinking" animation.
+   *
+   * The sticker index is computed as follows: `SHIFTS[SLOT] + OFFSETS[SYM]`.
+   * For example, berries for the middle slot would be: `SHIFTS[MIDDLE] + OFFSETS[BERRIES] = 9 + 3 = 12`
+   *
+   * Currently, this sticker set is used for the machine: [SlotMachineAnimated](https://t.me/addstickers/SlotMachineAnimated)
    */
-  get isLegacyGif() {
-    return this.attr._ === "documentAttributeImageSize";
-  }
-  /** Whether this video is hidden with a spoiler */
-  get hasSpoiler() {
-    return this.media?.spoiler ?? false;
-  }
-  /** For self-destructing videos, TTL in seconds */
-  get ttlSeconds() {
-    return this.media?.ttlSeconds ?? null;
-  }
-  get videoStartTs() {
-    return this.attr._ === "documentAttributeVideo" ? this.attr.videoStartTs ?? null : null;
-  }
-}
-const Video$1 = /* @__PURE__ */ memoizeGetters(Video, ["fileName", "thumbnails", "fileId", "uniqueFileId", "isAnimation"]);
-const Video$2 = /* @__PURE__ */ conditionVariable.makeInspectable(Video$1, ["fileSize", "dcId"], ["inputMedia", "inputDocument"]);
-class Voice extends RawDocument {
-  constructor(doc, attr) {
-    super(doc);
-    this.attr = attr;
-  }
-  type = "voice";
-  _fileIdType() {
-    return fileId.tdFileId.FileType.VoiceNote;
-  }
+  static TYPE_SLOTS = "🎰";
   /**
-   * Duration of the voice note in seconds.
+   * An emoji which was originally sent.
+   *
+   * See static members of {@link Dice} for a list
+   * of possible values
    */
-  get duration() {
-    return this.attr.duration;
+  get emoji() {
+    return this.obj.emoticon;
   }
   /**
-   * Voice note's waveform
+   * Emoji's interactive value.
    *
-   * Represented with integers in range [0, 31],
-   * usually has length of 100
+   * See what this value represents in the corresponding
+   * type's documentation (in {@link Dice} static fields)
    */
-  get waveform() {
-    return conditionVariable.decodeWaveform(this.attr.waveform);
-  }
-}
-const Voice$1 = /* @__PURE__ */ memoizeGetters(Voice, ["fileName", "thumbnails", "fileId", "uniqueFileId", "waveform"]);
-const Voice$2 = /* @__PURE__ */ conditionVariable.makeInspectable(Voice$1, ["fileSize", "dcId"], ["inputMedia", "inputDocument", "waveform"]);
-function parseSticker(doc) {
-  const stickerAttr = doc.attributes.find(
-    (a) => a._ === "documentAttributeSticker" || a._ === "documentAttributeCustomEmoji"
-  );
-  if (stickerAttr) {
-    const sz = doc.attributes.find(
-      (it) => it._ === "documentAttributeImageSize" || it._ === "documentAttributeVideo"
-    );
-    return new Sticker$2(doc, stickerAttr, sz);
+  get value() {
+    return this.obj.value;
   }
-}
-function parseDocument(doc, media2) {
-  const sticker2 = parseSticker(doc);
-  if (sticker2) return sticker2;
-  for (const attr of doc.attributes) {
-    switch (attr._) {
-      case "documentAttributeAudio":
-        if (attr.voice) {
-          return new Voice$2(doc, attr);
-        }
-        return new Audio$2(doc, attr);
-      case "documentAttributeVideo":
-        return new Video$2(doc, attr, media2);
-      case "documentAttributeImageSize":
-        if (doc.mimeType === "image/gif") {
-          return new Video$2(doc, attr, media2);
-        }
-    }
+  /**
+   * Input media TL object generated from this object,
+   * to be used inside {@link InputMediaLike} and
+   * {@link TelegramClient.sendMedia}
+   *
+   * Note that when you use this media, a new `value`
+   * will be generated!
+   */
+  get inputMedia() {
+    return {
+      _: "inputMediaDice",
+      emoticon: this.obj.emoticon
+    };
   }
-  return new Document$2(doc);
 }
+const Dice$1 = /* @__PURE__ */ conditionVariable.makeInspectable(Dice, void 0, ["inputMedia"]);
 class Game {
   constructor(game2) {
     this.game = game2;
@@ -6660,6 +6767,7 @@ async function uploadFile(client, params) {
   if (HAS_FILE && file2 instanceof File) {
     fileName = file2.name;
     fileSize = file2.size;
+    fileMime = file2.type;
     file2 = file2.stream();
   }
   if (HAS_URL && file2 instanceof URL) {
@@ -6789,6 +6897,18 @@ async function uploadFile(client, params) {
   if (fileName === void 0) {
     const ext = MIME_TO_EXTENSION[fileMime];
     fileName = ext ? `${DEFAULT_FILE_NAME}.${ext}` : DEFAULT_FILE_NAME;
+  } else if (params.requireExtension) {
+    const extFromMime = MIME_TO_EXTENSION[fileMime];
+    const idx2 = fileName.lastIndexOf(".");
+    const extFromName = idx2 === -1 ? void 0 : fileName.slice(idx2 + 1);
+    if (!extFromName) {
+      if (!extFromMime) {
+        throw new platform.MtArgumentError(`File name does not have an extension, and we cannot guess it from the mime type (${fileMime})`);
+      }
+      fileName = `${fileName}.${extFromMime}`;
+    } else if (extFromMime && extFromName !== extFromMime) {
+      throw new platform.MtArgumentError(`File name has ${extFromName} extension (${fileName}), but the mime type (${fileMime}) expects it to be ${extFromMime}`);
+    }
   }
   let inputFile;
   if (isBig) {
@@ -7028,7 +7148,8 @@ async function _normalizeInputMedia(client, media2, params = {}, uploadMedia = f
       fileName: media2.fileName,
       fileMime: sendMime,
       fileSize: media2.fileSize,
-      requireFileSize: media2.type === "photo"
+      requireFileSize: media2.type === "photo",
+      requireExtension: media2.type === "photo"
     });
     inputFile = uploaded.inputFile;
     mime = uploaded.mime;
@@ -8233,18 +8354,6 @@ class StickerSet {
     }
     return "sticker";
   }
-  /**
-   * Source file type of the stickers in this set
-   */
-  get sourceType() {
-    if (this.brief.animated) {
-      return "animated";
-    }
-    if (this.brief.videos) {
-      return "video";
-    }
-    return "static";
-  }
   /**
    * Date when this sticker set was installed
    */
@@ -9782,6 +9891,13 @@ class StarsTransaction {
             messageId: this.raw.giveawayPostId
           };
         }
+        if (this.raw.stargift) {
+          return {
+            type: "star_gift",
+            peer,
+            gift: new StarGift$2(this.raw.stargift)
+          };
+        }
         if (this.raw.msgId) {
           if (this.raw.reaction) {
             return {
@@ -10100,6 +10216,7 @@ exports.ReactionCount$1 = ReactionCount$1;
 exports.RepliedMessageInfo$2 = RepliedMessageInfo$2;
 exports.SearchFilters = SearchFilters;
 exports.SentCode$1 = SentCode$1;
+exports.StarGift$2 = StarGift$2;
 exports.StarsStatus$2 = StarsStatus$2;
 exports.StarsTransaction$2 = StarsTransaction$2;
 exports.Sticker$2 = Sticker$2;
@@ -10119,6 +10236,7 @@ exports.StoryViewersList$2 = StoryViewersList$2;
 exports.TakeoutSession$1 = TakeoutSession$1;
 exports.Thumbnail$2 = Thumbnail$2;
 exports.User$2 = User$2;
+exports.UserStarGift$2 = UserStarGift$2;
 exports.Venue$2 = Venue$2;
 exports.Video$2 = Video$2;
 exports.Voice$2 = Voice$2;