@mtcute/core 0.5.0 → 0.7.0

package/cjs/highlevel/types/media/input-media.js

@@ -0,0 +1,254 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InputMedia = void 0;
+// eslint-disable-next-line @typescript-eslint/no-namespace
+var InputMedia;
+(function (InputMedia) {
+    /**
+     * Create an animation to be sent
+     *
+     * @param file  Animation
+     * @param params  Additional parameters
+     */
+    function animation(file, params = {}) {
+        const ret = params;
+        ret.type = 'video';
+        ret.file = file;
+        ret.isAnimated = true;
+        return ret;
+    }
+    InputMedia.animation = animation;
+    /**
+     * Create an audio to be sent
+     *
+     * @param file  Audio file
+     * @param params  Additional parameters
+     */
+    function audio(file, params = {}) {
+        const ret = params;
+        ret.type = 'audio';
+        ret.file = file;
+        return ret;
+    }
+    InputMedia.audio = audio;
+    /**
+     * Create an document to be sent
+     *
+     * @param file  Document
+     * @param params  Additional parameters
+     */
+    function document(file, params = {}) {
+        const ret = params;
+        ret.type = 'document';
+        ret.file = file;
+        return ret;
+    }
+    InputMedia.document = document;
+    /**
+     * Create an photo to be sent
+     *
+     * @param file  Photo
+     * @param params  Additional parameters
+     */
+    function photo(file, params = {}) {
+        const ret = params;
+        ret.type = 'photo';
+        ret.file = file;
+        return ret;
+    }
+    InputMedia.photo = photo;
+    /**
+     * Create an video to be sent
+     *
+     * @param file  Video
+     * @param params  Additional parameters
+     */
+    function video(file, params = {}) {
+        const ret = params;
+        ret.type = 'video';
+        ret.file = file;
+        return ret;
+    }
+    InputMedia.video = video;
+    /**
+     * Create a voice note to be sent
+     *
+     * @param file  Voice note
+     * @param params  Additional parameters
+     */
+    function voice(file, params = {}) {
+        const ret = params;
+        ret.type = 'voice';
+        ret.file = file;
+        return ret;
+    }
+    InputMedia.voice = voice;
+    /**
+     * Create a sticker to be sent
+     *
+     * @param file  Sticker
+     * @param params  Additional parameters
+     */
+    function sticker(file, params = {}) {
+        const ret = params;
+        ret.type = 'sticker';
+        ret.file = file;
+        return ret;
+    }
+    InputMedia.sticker = sticker;
+    /**
+     * Create a venue to be sent
+     *
+     * @param params  Venue parameters
+     */
+    function venue(params) {
+        const ret = params;
+        ret.type = 'venue';
+        return ret;
+    }
+    InputMedia.venue = venue;
+    /**
+     * Create a geolocation to be sent
+     *
+     * @param latitude  Latitude of the location
+     * @param longitude  Longitude of the location
+     * @param params  Additional parameters
+     */
+    function geo(latitude, longitude, params = {}) {
+        const ret = params;
+        ret.type = 'geo';
+        ret.latitude = latitude;
+        ret.longitude = longitude;
+        return ret;
+    }
+    InputMedia.geo = geo;
+    /**
+     * Create a live geolocation to be sent
+     *
+     * @param latitude  Latitude of the current location
+     * @param longitude  Longitude of the current location
+     * @param params  Additional parameters
+     */
+    function geoLive(latitude, longitude, params = {}) {
+        const ret = params;
+        ret.type = 'geo_live';
+        ret.latitude = latitude;
+        ret.longitude = longitude;
+        return ret;
+    }
+    InputMedia.geoLive = geoLive;
+    /**
+     * Create a dice to be sent
+     *
+     * For convenience, known dice emojis are available
+     * as static members of {@link Dice}.
+     *
+     * @param emoji  Emoji representing the dice
+     * @param params  Additional parameters
+     */
+    function dice(emoji, params) {
+        const ret = params;
+        ret.type = 'dice';
+        return ret;
+    }
+    InputMedia.dice = dice;
+    /**
+     * Create a contact to be sent
+     *
+     * @param params  Contact parameters
+     */
+    function contact(params) {
+        const ret = params;
+        ret.type = 'contact';
+        return ret;
+    }
+    InputMedia.contact = contact;
+    /**
+     * Create a game to be sent
+     *
+     * @param game  Game short name or TL object representing one
+     */
+    function game(game) {
+        return {
+            type: 'game',
+            game,
+        };
+    }
+    InputMedia.game = game;
+    /**
+     * Create an invoice to be sent
+     *
+     * @param params  Invoice parameters
+     */
+    function invoice(params) {
+        const ret = params;
+        ret.type = 'invoice';
+        return ret;
+    }
+    InputMedia.invoice = invoice;
+    /**
+     * Create a poll to be sent
+     *
+     * @param params  Poll parameters
+     */
+    function poll(params) {
+        const ret = params;
+        ret.type = 'poll';
+        return ret;
+    }
+    InputMedia.poll = poll;
+    /**
+     * Create a quiz to be sent
+     *
+     * @param params  Quiz parameters
+     */
+    function quiz(params) {
+        const ret = params;
+        ret.type = 'quiz';
+        return ret;
+    }
+    InputMedia.quiz = quiz;
+    /**
+     * Create a story to be sent
+     *
+     * @param params  Story parameters
+     */
+    function story(params) {
+        const ret = params;
+        ret.type = 'story';
+        return ret;
+    }
+    InputMedia.story = story;
+    /**
+     * Create a webpage to be sent
+     *
+     * @param url  Webpage URL
+     * @param params  Additional parameters
+     */
+    function webpage(url, params = {}) {
+        const ret = params;
+        ret.type = 'webpage';
+        ret.url = url;
+        return ret;
+    }
+    InputMedia.webpage = webpage;
+    /**
+     * Create a document to be sent, which subtype
+     * is inferred automatically by file contents.
+     *
+     * Photo type is only inferred for reused files,
+     * newly uploaded photos with `auto` will be
+     * uploaded as a document
+     *
+     * @param file  The media file
+     * @param params  Additional parameters
+     */
+    function auto(file, params = {}) {
+        const ret = params;
+        ret.type = 'auto';
+        ret.file = file;
+        return ret;
+    }
+    InputMedia.auto = auto;
+})(InputMedia || (exports.InputMedia = InputMedia = {}));
+//# sourceMappingURL=input-media.js.map

package/cjs/highlevel/types/media/input-media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-media.js","sourceRoot":"","sources":["../../../../../src/highlevel/types/media/input-media.ts"],"names":[],"mappings":"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","sourcesContent":["import { tl } from '@mtcute/tl'\n\nimport { MaybeArray } from '../../../types/utils.js'\nimport { InputText } from '../../types/misc/entities.js'\nimport { InputFileLike } from '../files/index.js'\nimport { InputPeerLike } from '../peers/index.js'\nimport { VenueSource } from './venue.js'\n\nexport interface CaptionMixin {\n    /**\n     * Caption of the media\n     */\n    caption?: InputText\n}\n\nexport interface FileMixin {\n    /**\n     * File to be sent\n     */\n    file: InputFileLike\n\n    /**\n     * Override file name for the file.\n     *\n     * Only applicable to newly uploaded files.\n     */\n    fileName?: string\n\n    /**\n     * Override MIME type for the file\n     *\n     * Only applicable to newly uploaded files.\n     */\n    fileMime?: string\n\n    /**\n     * Override file size for the file\n     *\n     * Only applicable to newly uploaded files.\n     */\n    fileSize?: number\n\n    /**\n     * TTL for the media in seconds.\n     *\n     * Only applicable to some media types\n     */\n    ttlSeconds?: number\n}\n\n/**\n * Automatically detect media type based on file contents.\n *\n * Photo type is only inferred for reused files,\n * newly uploaded photos with `auto` will be\n * uploaded as a document\n */\nexport interface InputMediaAuto extends FileMixin, CaptionMixin {\n    type: 'auto'\n}\n\n/**\n * An audio file or voice message to be sent\n */\nexport interface InputMediaAudio extends FileMixin, CaptionMixin {\n    type: 'audio'\n\n    /**\n     * Thumbnail of the audio file album cover.\n     *\n     * The thumbnail should be in JPEG format and less than 200 KB in size.\n     * A thumbnail's width and height should not exceed 320 pixels.\n     * Thumbnails can't be reused and can be only uploaded as a new file.\n     *\n     * Only applicable to newly uploaded files.\n     */\n    thumb?: InputFileLike\n\n    /**\n     * Duration of the audio in seconds\n     *\n     * Only applicable to newly uploaded files.\n     */\n    duration?: number\n\n    /**\n     * Performer of the audio\n     *\n     * Only applicable to newly uploaded files.\n     */\n    performer?: string\n\n    /**\n     * Title of the audio\n     *\n     * Only applicable to newly uploaded files.\n     */\n    title?: string\n}\n\n/**\n * Voice message to be sent\n */\nexport interface InputMediaVoice extends FileMixin, CaptionMixin {\n    type: 'voice'\n\n    /**\n     * Duration of the voice message in seconds\n     *\n     * Only applicable to newly uploaded files.\n     */\n    duration?: number\n\n    /**\n     * Waveform of the voice message.\n     *\n     * Represented with integers in range [0, 31],\n     * usually has length of 100.\n     * Generated by the server if omitted.\n     *\n     * Only applicable to newly uploaded files.\n     */\n    waveform?: number[]\n}\n\n/**\n * A generic file to be sent\n */\nexport interface InputMediaDocument extends FileMixin, CaptionMixin {\n    type: 'document'\n\n    /**\n     * Thumbnail of the document.\n     *\n     * The thumbnail should be in JPEG format and less than 200 KB in size.\n     * A thumbnail's width and height should not exceed 320 pixels.\n     * Thumbnails can't be reused and can be only uploaded as a new file.\n     *\n     * Only applicable to newly uploaded files.\n     */\n    thumb?: InputFileLike\n}\n\n/**\n * A photo to be sent\n */\nexport interface InputMediaPhoto extends FileMixin, CaptionMixin {\n    type: 'photo'\n\n    /**\n     * Whether this photo should be hidden with a spoiler\n     */\n    spoiler?: boolean\n}\n\n/**\n * A sticker to be sent\n */\nexport interface InputMediaSticker extends FileMixin, CaptionMixin {\n    type: 'sticker'\n\n    /**\n     * Whether this sticker is animated?\n     *\n     * Note that animated stickers must be in TGS\n     * format, which is Lottie JSON compressed using GZip\n     *\n     * Only applicable to newly uploaded files.\n     *\n     * @default  false\n     */\n    isAnimated?: boolean\n\n    /**\n     * An emoji representing this sticker\n     *\n     * Only applicable to newly uploaded files,\n     * for some reason doesn't work with animated stickers.\n     */\n    alt?: string\n}\n\n/**\n * A video to be sent\n */\nexport interface InputMediaVideo extends FileMixin, CaptionMixin {\n    type: 'video'\n\n    /**\n     * Thumbnail of the video.\n     *\n     * The thumbnail should be in JPEG format and less than 200 KB in size.\n     * A thumbnail's width and height should not exceed 320 pixels.\n     * Thumbnails can't be reused and can be only uploaded as a new file.\n     *\n     * Only applicable to newly uploaded files.\n     */\n    thumb?: InputFileLike\n\n    /**\n     * Width of the video in pixels\n     *\n     * Only applicable to newly uploaded files.\n     */\n    width?: number\n\n    /**\n     * Height of the video in pixels\n     *\n     * Only applicable to newly uploaded files.\n     */\n    height?: number\n\n    /**\n     * Duration of the video in seconds\n     *\n     * Only applicable to newly uploaded files.\n     */\n    duration?: number\n\n    /**\n     * Whether the video is suitable for streaming\n     *\n     * Only applicable to newly uploaded files.\n     */\n    supportsStreaming?: boolean\n\n    /**\n     * Whether this video is an animated GIF\n     *\n     * Only applicable to newly uploaded files.\n     */\n    isAnimated?: boolean\n\n    /**\n     * Whether this video is a round message (aka video note)\n     *\n     * Only applicable to newly uploaded files.\n     */\n    isRound?: boolean\n\n    /**\n     * Whether this video should be hidden with a spoiler\n     */\n    spoiler?: boolean\n}\n\n/**\n * A geolocation to be sent\n */\nexport interface InputMediaGeo extends CaptionMixin {\n    type: 'geo'\n\n    /**\n     * Latitude of the geolocation\n     */\n    latitude: number\n\n    /**\n     * Longitude of the geolocation\n     */\n    longitude: number\n\n    /**\n     * The estimated horizontal accuracy of the\n     * geolocation, in meters (0-1500)\n     */\n    accuracy?: number\n}\n\n/**\n * A live geolocation to be sent\n */\nexport interface InputMediaGeoLive extends Omit<InputMediaGeo, 'type'> {\n    type: 'geo_live'\n\n    /**\n     * Whether sending of the geolocation has stopped\n     */\n    stopped?: boolean\n\n    /**\n     * Direction in which the location moves, in degrees (1-360)\n     */\n    heading?: number\n\n    /**\n     * Validity period of the live location\n     */\n    period?: number\n\n    /**\n     * Maximum distance to another chat member for proximity\n     * alerts, in meters (0-100000)\n     */\n    proximityNotificationRadius?: number\n}\n\n/**\n * An animated dice with a random value to be sent\n *\n * For convenience, known dice emojis are available\n * as static members of {@link Dice}.\n *\n * Note that dice result value is generated randomly on the server,\n * you can't influence it in any way!\n */\nexport interface InputMediaDice extends CaptionMixin {\n    type: 'dice'\n\n    /**\n     * Emoji representing a dice\n     */\n    emoji: string\n}\n\n/**\n * A venue to be sent\n */\nexport interface InputMediaVenue extends CaptionMixin {\n    type: 'venue'\n\n    /**\n     * Latitude of the geolocation\n     */\n    latitude: number\n\n    /**\n     * Longitude of the geolocation\n     */\n    longitude: number\n\n    /**\n     * Venue name\n     */\n    title: string\n\n    /**\n     * Venue address\n     */\n    address: string\n\n    /**\n     * When available, source from where this venue was acquired\n     */\n    source?: VenueSource\n}\n\n/**\n * A contact to be sent\n */\nexport interface InputMediaContact extends CaptionMixin {\n    type: 'contact'\n\n    /**\n     * Contact's phone number\n     */\n    phone: string\n\n    /**\n     * Contact's first name\n     */\n    firstName: string\n\n    /**\n     * Contact's last name\n     */\n    lastName?: string\n\n    /**\n     * Additional data about the contact\n     * as a vCard (0-2048 bytes)\n     */\n    vcard?: string\n}\n\n/**\n * A game to be sent\n */\nexport interface InputMediaGame extends CaptionMixin {\n    type: 'game'\n\n    /**\n     * Game's short name, or a TL object with an input game\n     */\n    game: string | tl.TypeInputGame\n}\n\n/**\n * An invoice to be sent (see https://core.telegram.org/bots/payments)\n */\nexport interface InputMediaInvoice extends CaptionMixin {\n    type: 'invoice'\n\n    /**\n     * Product name (1-32 chars)\n     */\n    title: string\n\n    /**\n     * Product description (1-255 chars)\n     */\n    description: string\n\n    /**\n     * The invoice itself\n     */\n    invoice: tl.TypeInvoice\n\n    /**\n     * Bot-defined invoice payload (1-128 bytes).\n     *\n     * Will not be displayed to the user and can be used\n     * for internal processes\n     */\n    payload: Uint8Array\n\n    /**\n     * Payments provider token, obtained from\n     * [@BotFather](//t.me/botfather)\n     */\n    token: string\n\n    /**\n     * Data about the invoice as a plain JS object, which\n     * will be shared with the payment provider. A detailed\n     * description of required fields should be provided by\n     * the payment provider.\n     */\n    providerData: unknown\n\n    /**\n     * Start parameter for the bot\n     */\n    startParam: string\n\n    /**\n     * Product photo. Can be a photo of the goods or a marketing image for a service.\n     *\n     * Can be a URL, or a TL object with input web document\n     */\n    photo?: string | tl.TypeInputWebDocument\n\n    /**\n     * Extended media (i.e. media that will be available once the invoice is paid)\n     */\n    extendedMedia?: InputMediaLike\n}\n\n/**\n * A simple poll to be sent\n *\n * > **Note**: when using user account,\n * > the poll can't be sent to PMs, only to channels/groups,\n * > otherwise there will be `MEDIA_INVALID` error.\n */\nexport interface InputMediaPoll extends CaptionMixin {\n    type: 'poll'\n\n    /**\n     * Question of the poll (1-255 chars for users, 1-300 chars for bots)\n     */\n    question: string\n\n    /**\n     * Answers of the poll.\n     *\n     * You can either provide a string, or a\n     * TL object representing an answer.\n     * Strings will be transformed to TL\n     * objects, with a single=byte incrementing\n     * `option` value.\n     */\n    answers: (string | tl.TypePollAnswer)[]\n\n    /**\n     * Whether this is poll is closed\n     * (i.e. nobody can vote anymore)\n     */\n    closed?: boolean\n\n    /**\n     * Whether this is a public poll\n     * (i.e. users who have voted are visible to everyone)\n     */\n    public?: boolean\n\n    /**\n     * Whether users can select multiple answers\n     * as an answer\n     */\n    multiple?: boolean\n\n    /**\n     * Amount of time in seconds the poll will be active after creation (5-600).\n     *\n     * Can't be used together with `closeDate`.\n     */\n    closePeriod?: number\n\n    /**\n     * Point in time when the poll will be automatically closed.\n     *\n     * Must be at least 5 and no more than 600 seconds in the future,\n     * can't be used together with `closePeriod`.\n     *\n     * When `number` is used, UNIX time in ms is expected\n     */\n    closeDate?: number | Date\n}\n\n/**\n * A quiz to be sent.\n *\n * Quiz is an extended version of a poll, but quizzes have\n * correct answers, and votes can't be retracted from them\n */\nexport interface InputMediaQuiz extends Omit<InputMediaPoll, 'type'> {\n    type: 'quiz'\n\n    /**\n     * Correct answer ID(s) or index(es).\n     *\n     * > **Note**: even though quizzes can actually\n     * > only have exactly one correct answer,\n     * > the API itself has the possibility to pass\n     * > multiple or zero correct answers,\n     * > but that would result in `QUIZ_CORRECT_ANSWERS_TOO_MUCH`\n     * > and `QUIZ_CORRECT_ANSWERS_EMPTY` errors respectively.\n     * >\n     * > But since the API has that option, we also provide it,\n     * > maybe to future-proof this :shrug:\n     */\n    correct: MaybeArray<number | Uint8Array>\n\n    /**\n     * Explanation of the quiz solution\n     */\n    solution?: InputText\n}\n\n/**\n * A story to be sent\n */\nexport interface InputMediaStory extends CaptionMixin {\n    type: 'story'\n\n    /**\n     * Owner of the story\n     */\n    peer: InputPeerLike\n\n    /**\n     * ID of the story\n     */\n    id: number\n}\n\n/** A webpage to be sent */\nexport interface InputMediaWebpage extends CaptionMixin {\n    type: 'webpage'\n\n    /**\n     * Whether the link must be present in the message\n     * for the preview to appear\n     */\n    required?: boolean\n\n    /**\n     * By default, size of the media in the preview\n     * is determined based on content type.\n     *\n     * You can override this behaviour by passing the wanted size here\n     */\n    size?: 'large' | 'small'\n\n    /** Webpage URL */\n    url: string\n}\n\n/**\n * Input media that can be sent somewhere.\n *\n * Note that meta-fields (like `duration`) are only\n * applicable if `file` is {@link UploadFileLike},\n * otherwise they are ignored.\n *\n * @link InputMedia\n */\nexport type InputMediaLike =\n    | InputMediaAudio\n    | InputMediaVoice\n    | InputMediaDocument\n    | InputMediaPhoto\n    | InputMediaVideo\n    | InputMediaAuto\n    | InputMediaSticker\n    | InputMediaVenue\n    | InputMediaGeo\n    | InputMediaGeoLive\n    | InputMediaDice\n    | InputMediaContact\n    | InputMediaGame\n    | InputMediaInvoice\n    | InputMediaPoll\n    | InputMediaQuiz\n    | InputMediaStory\n    | InputMediaWebpage\n    | tl.TypeInputMedia\n\n// eslint-disable-next-line @typescript-eslint/no-namespace\nexport namespace InputMedia {\n    /** Omit `type` and `file` from the given type */\n    export type OmitTypeAndFile<T extends InputMediaLike, K extends keyof T = never> = Omit<T, 'type' | 'file' | K>\n\n    /**\n     * Create an animation to be sent\n     *\n     * @param file  Animation\n     * @param params  Additional parameters\n     */\n    export function animation(file: InputFileLike, params: OmitTypeAndFile<InputMediaVideo> = {}): InputMediaVideo {\n        const ret = params as tl.Mutable<InputMediaVideo>\n        ret.type = 'video'\n        ret.file = file\n        ret.isAnimated = true\n\n        return ret\n    }\n\n    /**\n     * Create an audio to be sent\n     *\n     * @param file  Audio file\n     * @param params  Additional parameters\n     */\n    export function audio(file: InputFileLike, params: OmitTypeAndFile<InputMediaAudio> = {}): InputMediaAudio {\n        const ret = params as tl.Mutable<InputMediaAudio>\n        ret.type = 'audio'\n        ret.file = file\n\n        return ret\n    }\n\n    /**\n     * Create an document to be sent\n     *\n     * @param file  Document\n     * @param params  Additional parameters\n     */\n    export function document(\n        file: InputFileLike,\n        params: OmitTypeAndFile<InputMediaDocument> = {},\n    ): InputMediaDocument {\n        const ret = params as tl.Mutable<InputMediaDocument>\n        ret.type = 'document'\n        ret.file = file\n\n        return ret\n    }\n\n    /**\n     * Create an photo to be sent\n     *\n     * @param file  Photo\n     * @param params  Additional parameters\n     */\n    export function photo(file: InputFileLike, params: OmitTypeAndFile<InputMediaPhoto> = {}): InputMediaPhoto {\n        const ret = params as tl.Mutable<InputMediaPhoto>\n        ret.type = 'photo'\n        ret.file = file\n\n        return ret\n    }\n\n    /**\n     * Create an video to be sent\n     *\n     * @param file  Video\n     * @param params  Additional parameters\n     */\n    export function video(file: InputFileLike, params: OmitTypeAndFile<InputMediaVideo> = {}): InputMediaVideo {\n        const ret = params as tl.Mutable<InputMediaVideo>\n        ret.type = 'video'\n        ret.file = file\n\n        return ret\n    }\n\n    /**\n     * Create a voice note to be sent\n     *\n     * @param file  Voice note\n     * @param params  Additional parameters\n     */\n    export function voice(file: InputFileLike, params: OmitTypeAndFile<InputMediaVoice> = {}): InputMediaVoice {\n        const ret = params as tl.Mutable<InputMediaVoice>\n        ret.type = 'voice'\n        ret.file = file\n\n        return ret\n    }\n\n    /**\n     * Create a sticker to be sent\n     *\n     * @param file  Sticker\n     * @param params  Additional parameters\n     */\n    export function sticker(file: InputFileLike, params: OmitTypeAndFile<InputMediaSticker> = {}): InputMediaSticker {\n        const ret = params as tl.Mutable<InputMediaSticker>\n        ret.type = 'sticker'\n        ret.file = file\n\n        return ret\n    }\n\n    /**\n     * Create a venue to be sent\n     *\n     * @param params  Venue parameters\n     */\n    export function venue(params: OmitTypeAndFile<InputMediaVenue>): InputMediaVenue {\n        const ret = params as tl.Mutable<InputMediaVenue>\n        ret.type = 'venue'\n\n        return ret\n    }\n\n    /**\n     * Create a geolocation to be sent\n     *\n     * @param latitude  Latitude of the location\n     * @param longitude  Longitude of the location\n     * @param params  Additional parameters\n     */\n    export function geo(\n        latitude: number,\n        longitude: number,\n        params: OmitTypeAndFile<InputMediaGeo, 'latitude' | 'longitude'> = {},\n    ): InputMediaGeo {\n        const ret = params as tl.Mutable<InputMediaGeo>\n        ret.type = 'geo'\n        ret.latitude = latitude\n        ret.longitude = longitude\n\n        return ret\n    }\n\n    /**\n     * Create a live geolocation to be sent\n     *\n     * @param latitude  Latitude of the current location\n     * @param longitude  Longitude of the current location\n     * @param params  Additional parameters\n     */\n    export function geoLive(\n        latitude: number,\n        longitude: number,\n        params: OmitTypeAndFile<InputMediaGeoLive, 'latitude' | 'longitude'> = {},\n    ): InputMediaGeoLive {\n        const ret = params as tl.Mutable<InputMediaGeoLive>\n        ret.type = 'geo_live'\n        ret.latitude = latitude\n        ret.longitude = longitude\n\n        return ret\n    }\n\n    /**\n     * Create a dice to be sent\n     *\n     * For convenience, known dice emojis are available\n     * as static members of {@link Dice}.\n     *\n     * @param emoji  Emoji representing the dice\n     * @param params  Additional parameters\n     */\n    export function dice(emoji: string, params: CaptionMixin): InputMediaDice {\n        const ret = params as tl.Mutable<InputMediaDice>\n        ret.type = 'dice'\n\n        return ret\n    }\n\n    /**\n     * Create a contact to be sent\n     *\n     * @param params  Contact parameters\n     */\n    export function contact(params: OmitTypeAndFile<InputMediaContact>): InputMediaContact {\n        const ret = params as tl.Mutable<InputMediaContact>\n        ret.type = 'contact'\n\n        return ret\n    }\n\n    /**\n     * Create a game to be sent\n     *\n     * @param game  Game short name or TL object representing one\n     */\n    export function game(game: string | tl.TypeInputGame): InputMediaGame {\n        return {\n            type: 'game',\n            game,\n        }\n    }\n\n    /**\n     * Create an invoice to be sent\n     *\n     * @param params  Invoice parameters\n     */\n    export function invoice(params: OmitTypeAndFile<InputMediaInvoice>): InputMediaInvoice {\n        const ret = params as tl.Mutable<InputMediaInvoice>\n        ret.type = 'invoice'\n\n        return ret\n    }\n\n    /**\n     * Create a poll to be sent\n     *\n     * @param params  Poll parameters\n     */\n    export function poll(params: OmitTypeAndFile<InputMediaPoll>): InputMediaPoll {\n        const ret = params as tl.Mutable<InputMediaPoll>\n        ret.type = 'poll'\n\n        return ret\n    }\n\n    /**\n     * Create a quiz to be sent\n     *\n     * @param params  Quiz parameters\n     */\n    export function quiz(params: OmitTypeAndFile<InputMediaQuiz>): InputMediaQuiz {\n        const ret = params as tl.Mutable<InputMediaQuiz>\n        ret.type = 'quiz'\n\n        return ret\n    }\n\n    /**\n     * Create a story to be sent\n     *\n     * @param params  Story parameters\n     */\n    export function story(params: OmitTypeAndFile<InputMediaStory>): InputMediaStory {\n        const ret = params as tl.Mutable<InputMediaStory>\n        ret.type = 'story'\n\n        return ret\n    }\n\n    /**\n     * Create a webpage to be sent\n     *\n     * @param url  Webpage URL\n     * @param params  Additional parameters\n     */\n    export function webpage(url: string, params: OmitTypeAndFile<InputMediaWebpage, 'url'> = {}): InputMediaWebpage {\n        const ret = params as tl.Mutable<InputMediaWebpage>\n        ret.type = 'webpage'\n        ret.url = url\n\n        return ret\n    }\n\n    /**\n     * Create a document to be sent, which subtype\n     * is inferred automatically by file contents.\n     *\n     * Photo type is only inferred for reused files,\n     * newly uploaded photos with `auto` will be\n     * uploaded as a document\n     *\n     * @param file  The media file\n     * @param params  Additional parameters\n     */\n    export function auto(file: InputFileLike, params: OmitTypeAndFile<InputMediaAuto> = {}): InputMediaAuto {\n        const ret = params as tl.Mutable<InputMediaAuto>\n        ret.type = 'auto'\n        ret.file = file\n\n        return ret\n    }\n}\n"]}

package/cjs/highlevel/types/media/invoice.d.ts

@@ -0,0 +1,107 @@
+import { tl } from '@mtcute/tl';
+import { WebDocument } from '../files/web-document.js';
+import type { MessageMedia } from '../messages/message-media.js';
+import { Thumbnail } from './thumbnail.js';
+/**
+ * Information about invoice's extended media.
+ *  - `none`: there is no extended media in this invoice
+ *  - `preview`: there is only a preview of this invoice's media ({@link Invoice.extendedMediaPreview})
+ *  - `full`: there is a full version of this invoice's media available ({@link Invoice.extendedMedia})
+ */
+export type InvoiceExtendedMediaState = 'none' | 'preview' | 'full';
+export declare class InvoiceExtendedMediaPreview {
+    readonly raw: tl.RawMessageExtendedMediaPreview;
+    constructor(raw: tl.RawMessageExtendedMediaPreview);
+    /**
+     * Width of the preview, in pixels (if available, else 0)
+     */
+    get width(): number;
+    /**
+     * Height of the preview, in pixels (if available, else 0)
+     */
+    get height(): number;
+    get thumbnail(): Thumbnail | null;
+    /**
+     * If this is a video, the duration of the video,
+     * in seconds (if available, else 0)
+     */
+    get videoDuration(): number;
+}
+/**
+ * An invoice
+ */
+export declare class Invoice {
+    readonly raw: tl.RawMessageMediaInvoice;
+    private readonly _extendedMedia?;
+    readonly type: "invoice";
+    constructor(raw: tl.RawMessageMediaInvoice, _extendedMedia?: MessageMedia | undefined);
+    /**
+     * Whether the shipping address was requested
+     */
+    isShippingAddressRequested(): boolean;
+    /**
+     * Whether this is an example (test) invoice
+     */
+    isTest(): boolean;
+    /**
+     * Product name, 1-32 characters
+     */
+    get title(): string;
+    /**
+     * Product description, 1-255 characters
+     */
+    get description(): string;
+    /**
+     * URL of the product photo for the invoice
+     */
+    get photo(): WebDocument | null;
+    /**
+     * Message ID of receipt
+     */
+    get receiptMessageId(): number | null;
+    /**
+     * Three-letter ISO 4217 currency code
+     */
+    get currency(): string;
+    /**
+     * Total price in the smallest units of the currency
+     * (integer, not float/double). For example, for a price
+     * of `US$ 1.45` `amount = 145`.
+     *
+     * See the exp parameter in [currencies.json](https://core.telegram.org/bots/payments/currencies.json),
+     * it shows the number of digits past the decimal point
+     * for each currency (2 for the majority of currencies).
+     */
+    get amount(): tl.Long;
+    /**
+     * Unique bot deep-linking parameter that can be used to generate this invoice
+     */
+    get startParam(): string;
+    /**
+     * If this invoice has extended media
+     */
+    get extendedMediaState(): InvoiceExtendedMediaState;
+    /**
+     * Get the invoice's extended media preview.
+     * Only available if {@link extendedMediaState} is `preview`.
+     * Otherwise, throws an error.
+     */
+    get extendedMediaPreview(): InvoiceExtendedMediaPreview;
+    /**
+     * Get the invoice's extended media.
+     * Only available if {@link extendedMediaState} is `full`.
+     * Otherwise, throws an error.
+     */
+    get extendedMedia(): MessageMedia;
+    /**
+     * Input media TL object generated from this object,
+     * to be used inside {@link InputMediaLike} and
+     * {@link TelegramClient.sendMedia}.
+     *
+     * Invoice can't provide an input media, since some
+     * of the data is not available to the user,
+     * which is required to send it. This getter
+     * is only provided to allow using `msg.media.inputMedia`
+     */
+    get inputMedia(): tl.TypeInputMedia;
+}

package/cjs/highlevel/types/media/invoice.js

@@ -0,0 +1,163 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Invoice = exports.InvoiceExtendedMediaPreview = void 0;
+const errors_js_1 = require("../../../types/errors.js");
+const index_js_1 = require("../../utils/index.js");
+const memoize_js_1 = require("../../utils/memoize.js");
+const web_document_js_1 = require("../files/web-document.js");
+const thumbnail_js_1 = require("./thumbnail.js");
+class InvoiceExtendedMediaPreview {
+    constructor(raw) {
+        this.raw = raw;
+    }
+    /**
+     * Width of the preview, in pixels (if available, else 0)
+     */
+    get width() {
+        return this.raw.w ?? 0;
+    }
+    /**
+     * Height of the preview, in pixels (if available, else 0)
+     */
+    get height() {
+        return this.raw.h ?? 0;
+    }
+    get thumbnail() {
+        if (!this.raw.thumb) {
+            return null;
+        }
+        return new thumbnail_js_1.Thumbnail(this.raw, this.raw.thumb);
+    }
+    /**
+     * If this is a video, the duration of the video,
+     * in seconds (if available, else 0)
+     */
+    get videoDuration() {
+        return this.raw.videoDuration ?? 0;
+    }
+}
+exports.InvoiceExtendedMediaPreview = InvoiceExtendedMediaPreview;
+(0, memoize_js_1.memoizeGetters)(InvoiceExtendedMediaPreview, ['thumbnail']);
+(0, index_js_1.makeInspectable)(InvoiceExtendedMediaPreview);
+/**
+ * An invoice
+ */
+class Invoice {
+    constructor(raw, _extendedMedia) {
+        this.raw = raw;
+        this._extendedMedia = _extendedMedia;
+        this.type = 'invoice';
+    }
+    /**
+     * Whether the shipping address was requested
+     */
+    isShippingAddressRequested() {
+        return this.raw.shippingAddressRequested;
+    }
+    /**
+     * Whether this is an example (test) invoice
+     */
+    isTest() {
+        return this.raw.test;
+    }
+    /**
+     * Product name, 1-32 characters
+     */
+    get title() {
+        return this.raw.title;
+    }
+    /**
+     * Product description, 1-255 characters
+     */
+    get description() {
+        return this.raw.description;
+    }
+    /**
+     * URL of the product photo for the invoice
+     */
+    get photo() {
+        if (!this.raw.photo)
+            return null;
+        return new web_document_js_1.WebDocument(this.raw.photo);
+    }
+    /**
+     * Message ID of receipt
+     */
+    get receiptMessageId() {
+        return this.raw.receiptMsgId ?? null;
+    }
+    /**
+     * Three-letter ISO 4217 currency code
+     */
+    get currency() {
+        return this.raw.currency;
+    }
+    /**
+     * Total price in the smallest units of the currency
+     * (integer, not float/double). For example, for a price
+     * of `US$ 1.45` `amount = 145`.
+     *
+     * See the exp parameter in [currencies.json](https://core.telegram.org/bots/payments/currencies.json),
+     * it shows the number of digits past the decimal point
+     * for each currency (2 for the majority of currencies).
+     */
+    get amount() {
+        return this.raw.totalAmount;
+    }
+    /**
+     * Unique bot deep-linking parameter that can be used to generate this invoice
+     */
+    get startParam() {
+        return this.raw.startParam;
+    }
+    /**
+     * If this invoice has extended media
+     */
+    get extendedMediaState() {
+        if (!this.raw.extendedMedia)
+            return 'none';
+        if (this.raw.extendedMedia._ === 'messageExtendedMediaPreview') {
+            return 'preview';
+        }
+        return 'full';
+    }
+    /**
+     * Get the invoice's extended media preview.
+     * Only available if {@link extendedMediaState} is `preview`.
+     * Otherwise, throws an error.
+     */
+    get extendedMediaPreview() {
+        if (this.raw.extendedMedia?._ !== 'messageExtendedMediaPreview') {
+            throw new errors_js_1.MtArgumentError('No extended media preview available');
+        }
+        return new InvoiceExtendedMediaPreview(this.raw.extendedMedia);
+    }
+    /**
+     * Get the invoice's extended media.
+     * Only available if {@link extendedMediaState} is `full`.
+     * Otherwise, throws an error.
+     */
+    get extendedMedia() {
+        if (!this._extendedMedia) {
+            throw new errors_js_1.MtArgumentError('No extended media available');
+        }
+        return this._extendedMedia;
+    }
+    /**
+     * Input media TL object generated from this object,
+     * to be used inside {@link InputMediaLike} and
+     * {@link TelegramClient.sendMedia}.
+     *
+     * Invoice can't provide an input media, since some
+     * of the data is not available to the user,
+     * which is required to send it. This getter
+     * is only provided to allow using `msg.media.inputMedia`
+     */
+    get inputMedia() {
+        throw new errors_js_1.MtArgumentError('Invoice cannot provide an InputMedia');
+    }
+}
+exports.Invoice = Invoice;
+(0, memoize_js_1.memoizeGetters)(Invoice, ['extendedMediaPreview', 'photo']);
+(0, index_js_1.makeInspectable)(Invoice, undefined, ['inputMedia']);
+//# sourceMappingURL=invoice.js.map

package/cjs/highlevel/types/media/invoice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice.js","sourceRoot":"","sources":["../../../../../src/highlevel/types/media/invoice.ts"],"names":[],"mappings":"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","sourcesContent":["import { tl } from '@mtcute/tl'\n\nimport { MtArgumentError } from '../../../types/errors.js'\nimport { makeInspectable } from '../../utils/index.js'\nimport { memoizeGetters } from '../../utils/memoize.js'\nimport { WebDocument } from '../files/web-document.js'\nimport type { MessageMedia } from '../messages/message-media.js'\nimport { Thumbnail } from './thumbnail.js'\n\n/**\n * Information about invoice's extended media.\n *  - `none`: there is no extended media in this invoice\n *  - `preview`: there is only a preview of this invoice's media ({@link Invoice.extendedMediaPreview})\n *  - `full`: there is a full version of this invoice's media available ({@link Invoice.extendedMedia})\n */\nexport type InvoiceExtendedMediaState = 'none' | 'preview' | 'full'\n\nexport class InvoiceExtendedMediaPreview {\n    constructor(public readonly raw: tl.RawMessageExtendedMediaPreview) {}\n\n    /**\n     * Width of the preview, in pixels (if available, else 0)\n     */\n    get width(): number {\n        return this.raw.w ?? 0\n    }\n\n    /**\n     * Height of the preview, in pixels (if available, else 0)\n     */\n    get height(): number {\n        return this.raw.h ?? 0\n    }\n\n    get thumbnail(): Thumbnail | null {\n        if (!this.raw.thumb) {\n            return null\n        }\n\n        return new Thumbnail(this.raw, this.raw.thumb)\n    }\n\n    /**\n     * If this is a video, the duration of the video,\n     * in seconds (if available, else 0)\n     */\n    get videoDuration(): number {\n        return this.raw.videoDuration ?? 0\n    }\n}\n\nmemoizeGetters(InvoiceExtendedMediaPreview, ['thumbnail'])\nmakeInspectable(InvoiceExtendedMediaPreview)\n\n/**\n * An invoice\n */\nexport class Invoice {\n    readonly type = 'invoice' as const\n\n    constructor(\n        readonly raw: tl.RawMessageMediaInvoice,\n        private readonly _extendedMedia?: MessageMedia,\n    ) {}\n\n    /**\n     * Whether the shipping address was requested\n     */\n    isShippingAddressRequested(): boolean {\n        return this.raw.shippingAddressRequested!\n    }\n\n    /**\n     * Whether this is an example (test) invoice\n     */\n    isTest(): boolean {\n        return this.raw.test!\n    }\n\n    /**\n     * Product name, 1-32 characters\n     */\n    get title(): string {\n        return this.raw.title\n    }\n\n    /**\n     * Product description, 1-255 characters\n     */\n    get description(): string {\n        return this.raw.description\n    }\n\n    /**\n     * URL of the product photo for the invoice\n     */\n    get photo(): WebDocument | null {\n        if (!this.raw.photo) return null\n\n        return new WebDocument(this.raw.photo)\n    }\n\n    /**\n     * Message ID of receipt\n     */\n    get receiptMessageId(): number | null {\n        return this.raw.receiptMsgId ?? null\n    }\n\n    /**\n     * Three-letter ISO 4217 currency code\n     */\n    get currency(): string {\n        return this.raw.currency\n    }\n\n    /**\n     * Total price in the smallest units of the currency\n     * (integer, not float/double). For example, for a price\n     * of `US$ 1.45` `amount = 145`.\n     *\n     * See the exp parameter in [currencies.json](https://core.telegram.org/bots/payments/currencies.json),\n     * it shows the number of digits past the decimal point\n     * for each currency (2 for the majority of currencies).\n     */\n    get amount(): tl.Long {\n        return this.raw.totalAmount\n    }\n\n    /**\n     * Unique bot deep-linking parameter that can be used to generate this invoice\n     */\n    get startParam(): string {\n        return this.raw.startParam\n    }\n\n    /**\n     * If this invoice has extended media\n     */\n    get extendedMediaState(): InvoiceExtendedMediaState {\n        if (!this.raw.extendedMedia) return 'none'\n\n        if (this.raw.extendedMedia._ === 'messageExtendedMediaPreview') {\n            return 'preview'\n        }\n\n        return 'full'\n    }\n\n    /**\n     * Get the invoice's extended media preview.\n     * Only available if {@link extendedMediaState} is `preview`.\n     * Otherwise, throws an error.\n     */\n    get extendedMediaPreview(): InvoiceExtendedMediaPreview {\n        if (this.raw.extendedMedia?._ !== 'messageExtendedMediaPreview') {\n            throw new MtArgumentError('No extended media preview available')\n        }\n\n        return new InvoiceExtendedMediaPreview(this.raw.extendedMedia)\n    }\n\n    /**\n     * Get the invoice's extended media.\n     * Only available if {@link extendedMediaState} is `full`.\n     * Otherwise, throws an error.\n     */\n    get extendedMedia(): MessageMedia {\n        if (!this._extendedMedia) {\n            throw new MtArgumentError('No extended media available')\n        }\n\n        return this._extendedMedia\n    }\n\n    /**\n     * Input media TL object generated from this object,\n     * to be used inside {@link InputMediaLike} and\n     * {@link TelegramClient.sendMedia}.\n     *\n     * Invoice can't provide an input media, since some\n     * of the data is not available to the user,\n     * which is required to send it. This getter\n     * is only provided to allow using `msg.media.inputMedia`\n     */\n    get inputMedia(): tl.TypeInputMedia {\n        throw new MtArgumentError('Invoice cannot provide an InputMedia')\n    }\n}\n\nmemoizeGetters(Invoice, ['extendedMediaPreview', 'photo'])\nmakeInspectable(Invoice, undefined, ['inputMedia'])\n"]}

package/cjs/highlevel/types/media/location.d.ts

@@ -0,0 +1,83 @@
+import { tl } from '@mtcute/tl';
+import { FileLocation } from '../files/index.js';
+/**
+ * A point on the map
+ */
+export declare class RawLocation {
+    readonly geo: tl.RawGeoPoint;
+    constructor(geo: tl.RawGeoPoint);
+    /**
+     * Geo point latitude
+     */
+    get latitude(): number;
+    /**
+     * Geo point longitude
+     */
+    get longitude(): number;
+    /**
+     * Accuracy radius in meters.
+     */
+    get radius(): number;
+    /**
+     * Create {@link FileLocation} containing
+     * server-generated image with the map preview
+     */
+    preview(params?: {
+        /**
+         * Map width in pixels before applying scale (16-1024)
+         *
+         * @default  `128`
+         */
+        width?: number;
+        /**
+         * Map height in pixels before applying scale (16-1024)
+         *
+         * @default  `128`
+         */
+        height?: number;
+        /**
+         * Map zoom level (13-20)
+         *
+         * @default  `15`
+         */
+        zoom?: number;
+        /**
+         * Map scale (1-3)
+         *
+         * @default  `1`
+         */
+        scale?: number;
+    }): FileLocation;
+    /**
+     * Input media TL object generated from this object,
+     * to be used inside {@link InputMediaLike} and
+     * {@link TelegramClient.sendMedia}
+     */
+    get inputMedia(): tl.TypeInputMedia;
+}
+export declare class Location extends RawLocation {
+    readonly type: "location";
+}
+export declare class LiveLocation extends RawLocation {
+    readonly live: tl.RawMessageMediaGeoLive;
+    readonly type: "live_location";
+    constructor(live: tl.RawMessageMediaGeoLive);
+    /**
+     * A direction in which the location moves, in degrees; 1-360
+     */
+    get heading(): number | null;
+    /**
+     * Validity period of provided geolocation
+     */
+    get period(): number;
+    /**
+     * Input media TL object generated from this object,
+     * to be used inside {@link InputMediaLike} and
+     * {@link TelegramClient.sendMedia}
+     *
+     * Note that using this will result in an
+     * independent live geolocation, which
+     * will not be auto-updated with the current
+     */
+    get inputMedia(): tl.TypeInputMedia;
+}